For the complete documentation index, see llms.txt. This page is also available as Markdown.

Bluetooth connection

Magic-Box supports Bluetooth connectivity for certain input devices, allowing for a wireless setup that reduces cable clutter. This guide explains how to connect Bluetooth devices and incorporate them into your control scheme.

Supported Bluetooth Devices

Magic-Box can work with one Bluetooth input device Head Tracker v2.2 More to come if needed.

Setting Up Bluetooth Connection

Every profile may use its on channels binding file and thus Bluetooth can be on or off depending on the selected profile. In your channels binding file add a section for ppm-inputs. If this section contains bth-mac then Magic-Box will try to connect to your head tracker. Section example:

ppm-input:
  bth-mac: F3:4C:9B:13:22:14 # your head tracker mac
  mapping:
    tilt-channel:
      on-off-switch: sld # slider switch to override channel 5 with input from ht
      source: bth # can be alos ppm (signal on 3.5mm cable)
      in: 5 # your head tracker channel selected in head tracker configuration app
      out: 5 # channel you want override, usualy assigned to knob 
    pan-channel:
      on-off-switch: sld
      source: bth
      in: 6
      out: 6

The mac address of Head Tracker can be found after connection to it via USB and using configuration software https://headtracker.gitbook.io/head-tracker-v2.2/settings/gui-settings/tilt-roll-pan Note that ppm input can be switched off with f.e. sld switch.

More about Head Tracker Bluetooth setup here.

Last updated