A firmware for hitbox controllers, supporting the GRAM slim and other RP2040 based controllers with the same pinout.
joybus-pio and haybox were heavily referenced in the implementation.
- Should support any RP204 board with the standard pinout. (currently only tested on the GRAM slim PCB)
- Supports gamecube (joybus) controller protocol.
- Implementation in rust makes it easier to tweak, build and flash changes
- Firmware level profiles for Project+ and Rivals 2
- KDL config file allows configuring per profile key remapping, SOCD mode etc.
- Cleanup the config file format
- Move kdl_config project into its own repo
- Move off rust nightly by helping move cargo bindep feature towards stabilization
- Profiles for other platform fighter games
- N64 support
- HID controller support
- HID keyboard support
- Support for non RP2040/pico boards
- If boards start using the RP2350 chip, or the RP2040 is in some other way seriously outdated I will consider moving to a new chip.
- Profiles for non platform fighter games
- Keep these in your own fork
- Bring your controller's PCB into flashing (bootsel) mode. On the GRAM this is done by holding down the start button while plugging it in via USB C <-> USB A cable.
- Download executable from latest github Releases
- Modify config.kdl in a text editor to set key maps etc. (Optional)
- Run downloaded flashing executable
On windows you must have winusb installed via zadig, if you use a GC adapter in wii U / switch mode you have already done this.
- First install rustup
git clone https://github.com/rukai/rukaibox_firmware- Make any changes to the firmware in
rukaibox_firmware/rukaibox_firmware - Make any changes to the config in config.kdl.
- Bring your controller's PCB into flashing (bootsel) mode. On the GRAM this is done by holding down the start button while plugging it in via USB C <-> USB A cable.
cargo run --release -p rukaibox_flash
On windows you must have winusb installed via zadig, if you use a GC adapter in wii U / switch mode you have already done this.