Set up your computer

Install the compilers and tools, build a firmware, flash it.

Everything you need to build a firmware and flash it. It takes about ten minutes, most of it downloading.

What you need

  • A Valeton GP-5 and a USB cable.
  • One of these systems:
SystemInstall
macOSpython3, the Xcode command line tools (xcode-select --install), and Docker Desktop. The control processor’s compiler is a Linux program; it runs in a small container
Linux (x86_64)python3, curl, a C compiler (cc), and the 32-bit C library: sudo apt install libc6-i386 (Debian, Ubuntu), sudo pacman -S lib32-glibc (Arch), sudo dnf install glibc.i686 (Fedora)
WindowsWSL with Ubuntu, then as for Linux. Flash from Windows’ own Python, not WSL: WSL can’t see USB-MIDI devices
  • For flashing: pip install mido python-rtmidi, on the computer the pedal is plugged into.
  • Optional, for the checks on the computer: pip install pillow unicorn (the simulator’s screens as PNG, and the DSP emulator).

Get OpenGP5 and the compilers

git clone https://github.com/OpenGP5/OpenGP5.git
cd OpenGP5
release/setup-toolchain.sh

setup-toolchain.sh downloads both compilers (about 190 MB) from Andes’ and Arm’s own pages into fw-build/, checks their checksums, and installs nothing system-wide. The versions are pinned, so every computer builds the same bytes.

Build

platform/build_firmware.sh tremolo

This builds both halves of the tremolo and packs them into one image, build/GP-5_tremolo.bin. It holds only the two parts OpenGP5 replaces: the DSP firmware and the control processor’s app.

Try it on the computer

python3 tools/simulate.py tremolo

runs the whole firmware on your computer: the sound, the screen and scripted controls. See The simulator.

Flash

Plug the pedal in, then:

python3 tools/gp5tool.py status
python3 tools/gp5tool.py flash build/GP-5_tremolo.bin --sections all

status checks that the pedal is found. The flash takes about 40 seconds; the pedal restarts by itself. If it doesn’t come back, see Recovery.

Next

How a firmware works, then Your first effect. To keep your firmware in its own repository from the start, see Your own repository.