The configuration for hardware peripherals is defined in the file at:
The configuration defines the switches, pots, etc. connected, which MIDI CC message should be sent and other optional behaviors.
Some configuration can be overriden for a specific pedalboard by adding a file named “config.yml” to the pedalboard directory.
Required properties tagged with a * Properties which can be overriden per pedalboard are tagged with +
hardware - The top level object containing all user hardware configuration (always required)
midi - Defines global midi settings
footswitches - Defines a list of momentary switches (listed as an array) attached to the HSwitch header
Each footswitch definition member (denoted with a “-”) can have the following possible properties:
analog_controllers: (new for pi-Stomp Core). This object defines any analog inputs (listed as an array) which are attached to the HAnalog header. Do not define controllers which aren't actually attached as that will cause the ADC to poll for input that is likely floating and thus constantly changing, causing MIDI messages to be sent needlessly which consumes CPU cycles.
Each analog controler definition member (denoted with a “-”) can have the following possible properties:
# This file provides some default configuration for the system # Most of this configuration can be overriden by pedalboard specific configuration. To accomplish that, add # a file, named config.yml to the pedalboard directory (ie. /var/modep/pedalboards/<pedalboard-name>) — hardware:
# Hardware version (1.0 for original pi-Stomp, 2.0 for pi-Stomp Core) version: 2.0 # midi definition # channel: midi channel used for midi messages midi: channel: 14 # footswitches definition # bypass: relay(s) to toggle (LEFT, RIGHT or LEFT_RIGHT) # color: color to use for enable status halo on LCD # debounce_input: debounce chip pin to which switch is connected # disable: disable the switch # gpio_input: gpio pin if not using debounce # gpio_output: gpio pin used to drive indicator (LED, etc.) # id: integer identifier # midi_CC: msg to send (0 - 127 or None) # preset: change the preset (UP goes to next, DOWN goes to prev, fixed number selects the preset with that index) # footswitches: - id: 0 debounce_input: 0 gpio_output: 0 bypass: LEFT preset: UP - id: 1 debounce_input: 1 gpio_output: 13 midi_CC: 62 color: lime - id: 2 debounce_input: 2 gpio_output: 26 midi_CC: 63 color: blue # analog control definition # adc_input: adc chip pin to which control is connected # disable: disable the control # midi_CC: msg to send (0 - 127 or None) # threshold: minimum value change to trigger a midi msg (16 default, 1024 full scale) # type: control type (KNOB, EXPRESSION) # analog_controllers: - adc_input: 0 midi_CC: 70 type: KNOB - adc_input: 1 midi_CC: 71 type: KNOB - adc_input: 7 midi_CC: 77 type: EXPRESSION