
First custom joystick
This guide will walk you through the steps required to map your joystick axes to RC Link channels.
Step 1: Identify Your Joystick ID and Axes
Before creating configuration files, you need to know which axis IDs correspond to which joystick movements. You can skip that part if you own x56 or winwing F-16 stick.
Insert the SD card into Magic-Box
Connect your joystick
Power on Magic-Box using your LiPo battery
Press the A button to access the menu
Navigate to the Diagnostics option
Select Events from HOTAS from the sub-menu
Write down device ID (something like A-BCD-E)
Move your joystick to identify axis IDs:
Move the stick left to right and note the axis ID shown on screen — this will be your roll axis
Move the stick up and down and note the axis ID — this will be your pitch axis
Write down these axis IDs — you'll need them for your configuration file
Step 2: Back Up the SD Card
Before making any changes to your Magic-Box configuration, you MUST back up the SD card, especially the /magic-box partition. This contains all your configuration files and examples that you'll need as reference.
Shutdown your Magic-Box (Menu -> Shutdown System)
Remove the SD card from the device
Insert the SD card into your computer using a card reader
Make a complete copy of the
/magic-boxpartition to your computerPay special attention to the
/magic-box/configdirectory, as it contains valuable example configurations
If anything goes wrong during setup, you can restore this backup and return to a working state.
Step 3: Create Your First Profile
With your SD card backed up, it's time to create your first profile:
Navigate to the
/magic-box/config/profilesdirectoryCreate a new file named
my-profile.yaml(you can name it whatever you prefer)Add the following content to the file:
This profile configuration tells Magic-Box to use the name "My Test" and load joystick bindings from a file we'll create in the next step.
Step 4: Create Joystick Binding Configuration
Now we need to create the joystick binding file referenced in your profile, using the axis IDs you identified during diagnostics in First custom joystick:
Navigate to
/magic-box/config/binding/on your SD cardIMPORTANT: If the directory doesn't exist, create it
In this directory, create a new file named
my-joystick.yamlIMPORTANT: This filename must match what you specified in your profile
Add the following configuration, replacing the axis numbers with the ones you identified during your diagnostics session and use proper device-id or device-name-like property
Save the file
This basic configuration maps three essential axes:
roll (axis 0): controls left/right movement
pitch (axis 1): controls forward/backward movement (and is reversed)
The roll and pitch keys are now ready to be assigned to channels.
Step 4: Create Channel Mapping Configuration
Now you need to create a channel mapping file to define how your joystick axes correspond to RC transmitter channels:
Navigate to
/magic-box/config/channels/on your SD cardIMPORTANT: If the directory doesn't exist, create it
In this directory, create a new file named
my-channels.yamlIMPORTANT: This filename must match what will be referenced in your profile
Add the following configuration to map your joystick axes to RC channels:
Save the file
Step 5: Testing
Insert SD card into Magic-Box
Power Up Magic-Box:
Plug your USB controller (joystick) into Magic-Box
Connect your LiPo battery to Magic-Box via the XT60 connector
Verify the power LED illuminates
Wait to boot OS for 30 seconds
Select Your Profile:
Use the onboard screen and navigation buttons to select your newly created "My Test" profile
The Magic-Box will now load your joystick binding configuration
If you encounter any errors, check your configuration file syntax
Check on Channels screen if channels values change as expected


Next Steps
Once your basic setup is working, you might want to:
Connect your Radio to Magic-Box via PPM or SBUS
Fine-tune your controls (see Joystick Binding File)
Add more devices the same way as the main joystick (throttle or/and rudder)
Add a head tracker for enhanced FPV experience
Last updated