Soundcube Firmware

Install new firmware

1. Go to Releases
2. Download latest soundcube-firmware.ino.uf2 file
3. On your Soundcube Board: Press and hold the outer most white button as seen from the USB-C socket
4. While holding the button press the inner most white button once
   • the board will go into bootloader mode and appear as USB thumb drive
5. Copy the soundcube-firmware.ino.uf2 file to the thumb drive and wait for the board to restart

SD Card contents

config.txt
sound/
  ├─ 1.wav
  ├─ 2.wav
  ├─ 3.wav
  ├─ 4.wav
  ├─ 5.wav
  ├─ 6.wav
  ├─ 7.wav
  ├─ 8.wav
ui/
  ├─ click.wav
  ├─ beep.wav

config.txt

Json formatted config file. For now only edge led color working.

{
    "boxid":"",
    "edge": {
        "color":{
            "idle":{
                "r":50,
                "g":0,
                "b":50
            },
            "active":{
                "r":0,
                "g":50,
                "b":50
            }
        }
    },
    "ring": {
        "color":{
            "idle":{
                "r":0,
                "g":50,
                "b":50
            },
            "active":{
                "r":0,
                "g":80,
                "b":50
            }
        }
    }
}

Sound

UI

There are two UI sounds - click.wav and beep.wav.

• click.wav is played when a button is pressed other than the select button
• beep.wav is played when the rotary encoder select button is pressed

Put these files in the subfolder ui on the SD card.

Wave File Format for UI Sounds

click.wav needs to be 22050Hz (22kHz) 16bit Mono

Audio Out or Speakers

Put all sounds into the /sound subfolder. Name them 1.wav, 2.wav, 3.wav...

Wave File Format for Audio Out and Speakers

Export all sounds as 48000Hz (48kHz) 16bit Stereo.

Audacity

You can use Audacity to export all soundfiles to WAV format.

Download it here Github

1. Load file into Audacity
2. Select Track
3. File -> Export Audio

Format options in Audacity

Audio Out

• WAV(Microsoft)
• Chanels: Stereo
• Samplerate: 48000Hz
• Encoding: Signed 16-bit PCM

UI

• WAV(Microsoft)
• Channels: Mono
• Samplerate: 22050Hz
• Encoding: Signed 16-bit PCM

---

Code something yourself

1. Download Arduino IDE
2. Install and open "Preferences"
3. Follow these instructions
   • No need to change checkboxes, only paste the URL and hit OK.
4. Install Raspberry Pi Pico boards (HowTo install boards)
5. Install libraries (HowTo install libraries): Adafruit Neopixel, AS5600 (Rob Tillaart), TCA9555 (Rob Tillaart)
6. Choose Generic RP2350 as board and the correct port (Mac: /dev/cu.usbmodemXXXX, PC: COMXX Serial Port)
7. Go to Tools -> Flash Size and choose 16MB (no FS)
8. Make your changes in the code
9. Hit Upload Button (Arduino IDE compiles and uploads it automatically)