grimkriegor / alpakka_firmware

Alpakka Firmware

Alpakka controller reference firmware (for Raspberry Pi Pico)

Project links

• Alpakka Manual.
• Alpakka Firmware. (you are here)
• Alpakka PCB.
• Alpakka 3D-print.
• Input Labs Roadmap.

Supported developer operative systems

• GNU/Linux (and MacOS) - See Development in Linux.
• Windows - See Development in Windows.

System dependencies

With apt, rpm, pacman, brew, or the equivalent package manager of your system, install:

• gcc
• git
• cmake

Project dependencies

• make install: Download and configure dependencies automatically.

Development commands

• make: Build compilation environment and build executables.
• make rebuild: Build executables again using cache (faster).
• make load: Load built .uf2 file into the Pico (requires bootsel mode or active session).
• make reload: Do both rebuild and load commands (for dev convenience).
• make clean: Delete previous build files.
• make session: Connect to UART serial stdio, and display controller log.

While having an active session:

• make restart: Restart the controller.
• make bootsel: Put the controller in bootsel mode.
• make calibrate: Calibrate thumbstick and IMUs.
• make format: Format NVM sector and reset to initial values.
• make test: Start a semi-manual testing procedure for the buttons and axis.

Devkit button

• Single press: Restart the controller.
• Double press: Put the controller in bootsel mode.

Read the Alpakka developer manual for details about the devkit and more.