# soundbox firmware

This is the firmware for soundbox. It is based on the Zephyr real time
operating system [1].

## Get all source files

```
git submodule update --init
./update_espressif_blobs.py  # proprietary binary blobs
```

## Setup Python environment

```
python -m venv zephyrproject/.venv
source zephyrproject/.venv/bin/activate
pip install -r zephyrproject/requirements.txt
```

## Build

```
cmake -Bbuild -GNinja
ninja -C build
```

## Flash

```
esptool.py --chip auto write_flash 0x1000 build/zephyr/zephyr.bin
```

## Connect to shell

```
picocom -b 115200 /dev/ttyUSB0
```

## Scan for WLAN networks

```
wifi scan
```

## Connect to WLAN network

This uses WPA2-PSK (`-k 1`). See `wifi connect help` for other options.

```
wifi connect -s <ssid> -p <passphrase> -k 1
```

## Validate network connection

```
net ping 8.8.8.8  # Google DNS server
```

[1]: https://zephyrproject.org