Getting Started
This web application is designed to assemble FXCoreASM assembly code into machine instructions. Generated machine code may be saved locally for later use, or sent to a SandboxFX hardware target to hear the results.
- Enter FXCore source code into the editor area, or select a file or example. Press the Assemble button to verify and assemble the code into a HEX file
- Press the Download HEX to save the resulting HEX file to your local Downloads folder. Check the Build Results for success or error messages.
- Download C Headers outputs the assembled data in a C Header format for use with more advanced applications and is not used with SandboxFX hardware
- When satisfied with your source code, press the Save Source... button to download a local copy.
Connecting to Hardware
Connect your SandboxFX pedal to your computer using a suitable USB cable. A new removable drive labeled SANDBOX-FX should appear.
- Press the Connect button, then select the SandboxFX device from the list. You may need to allow this web app to access USB devices.
- Press the Run from RAM button to audition your assembled program on your SandboxFX
- Press Exit Run from RAM to return to normal operation when finished
- Open the Hardware Options panel and tap the Select Program Target to choose one of the 16 available program locations to write. This will save the assembled code to the slot and will persist even if the power is removed.
Troubleshooting
Errors and warnings will appear in the Build Results window and are often helpful for troubleshooting. Scroll up to the top to see previous messages
- Error information not helpful - use Editor Options - Show full build results to see more detailed info
- File transfer problems - ensure proper directory permissions
- Assembly errors - check syntax and register usage
- Connection issues - verify USB cable and HID device selection
What do these Options do?
These are some settings that change various editor and hardware settings
Editor Options
- Large editor window: Expands editor text area to show more instructions
- Show editor mini-map: Show a small navigation map in editor
- Show full build results: Show complete debug information in Build Results window
- Enable dark mode: Use dark colour theme, follows system theme
Hardware Options
- Select Hardware Mode: Toggles communication mode between USB-HID and USB Disk Mode
- File - Select Output Directory: Specify the folder location of your SandboxFX hardware (typically /SANDBOX-FX)
- File - Select Serial Port: Open SandboxFX serial port to allow hardware debugging information
- HID - FXCore address: Set I2C address of FXCore IC, defaults to 0x30
- Select Program Target: Press to select Run from RAM target or a program slot on SandboxFX hardware