Version Name

v<version>-<antenna type><audio output><station select><configuration location>

• version: version number - corresponds with firmware
• antennta type: O) onboard ESP32 antenna U) external antenna (following Espressif's convention)
• audio output: S) speakers L) line out
• station select: S) single station (no selector) M) multi station
• configuration location H) hardcoded R) remote

Overview

Connecting to the radio for programming and debugging

There are two ways to connect:

1. USB->Serial, using pads on the PCB
2. On board USB, via micro USB port on the PCB

USB->Serial appears to be the best for troubleshooting and development, as it is more verbose. To save money, this is achieved by connecting an extermal USB->Serial cable to pads on the PCB. This way one set of USB->Serial hardware can be used for multiple devices.

The ESP32 S3's onboard OTG USB does not appear to recieve the ESP32's debug messages, so it's not a solution for troubleshooting and development. However, it does provide a cheap way to make firmware updates more convenient.

Linux

Create a udev rule so that it is not necessary to set permissions with each connection, by creating this file /etc/udev/rules.d/99-esp32s3.rules and adding this lines:

ATTRS{idVendor}=="303a", ATTRS{idProduct}=="1001", MODE="0666", ENV{ID_MM_DEVICE_IGNORE}="1", ENV{ID_MM_PORT_IGNORE}="1"
ATTRS{idVendor}=="0403", ATTRS{idProduct}=="6001", MODE="0666", ENV{ID_MM_DEVICE_IGNORE}="1", ENV{ID_MM_PORT_IGNORE}="1"

Then restart udev:

sudo systemctl restart udev