soundcube-firmware/README.md

# Soundcube Firmware

## Install new firmware

1. Go to [Releases](https://code.w4d.dev/W4D/soundcube-firmware/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
6. Copy the `soundcube-firmware.ino.uf2` file to the thumb drive and wait for the board to restart

## config.txt

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

```
{
    "edge": {
        "color":{
            "r":50,
            "g":0,
            "b":0
        }
    }
}
```

## click.wav (not played correctly)

Put a file called `click.wav` (not longer than a few seconds) in the root of the SD card and it will play when you press a button.


## Code something yourself

1. Download [Arduino IDE](https://www.arduino.cc/en/software/)
2. Install and open "Preferences"
3. Follow these [instructions](https://github.com/earlephilhower/arduino-pico?tab=readme-ov-file#installation)
	- No need to change checkboxes, only paste the URL and hit OK.
4. Install **Raspberry Pi Pico** boards ([HowTo install boards](https://support.arduino.cc/hc/en-us/articles/360016119519-Add-boards-to-Arduino-IDE))
5. Install libraries ([HowTo install libraries](https://docs.arduino.cc/software/ide-v2/tutorials/ide-v2-installing-a-library/)): 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)