Power

• Do not attempt to power the board using the 3V3 output pin. This pin is intended for powering 3.3V peripherals (generally around 400mA max) using Sonatino's onboard regulator. Connecting a power source to this pin may damage the board.
• The board can be powered from USB-C, DC power (VIN), or a 3.7V lithium battery. If USB-C and VIN are both connected (with VIN at 5V), the board will draw power from VIN. If a battery is also connected, USB-C or VIN will charge the battery while powering the board.
• VIN should normally be 5V. Due to some voltage drop in the board's power protection circuitry and tolerance of the regulators, you can supply 3.6V up to 6V, but please be careful not to exceed 6V as it is likely to damage to the board.
• Sonatino can draw significant current at times (depending on usage; can be 1A or more). If your power source cannot supply enough current, you may experience unexpected behavior.

Battery

• The charging circuit is configured to deliver up to 500mA of current to a rechargeable lithium battery. Please check that your battery can handle this charging rate, especially for batteries with less than 500mAh of capacity.
• When connecting a battery for the first time, you may need to briefly short the negative (-) battery pin to ground (GND) to enable operation. This is a known behavior of the battery protection chip. The battery charge status LED may also remain illuminated when no battery is connected; this is normal and does not indicate a problem with the board.
• Battery voltage can be monitored using GPIO 10. To enable this feature, solder the jumper pad labeled "JP2" on the bottom of the board (after doing that, GPIO 10 can only be used for battery monitoring). With JP2 bridged, GPIO 10 is connected to the battery through a voltage divider (a 150kΩ resistor to the battery and a 470kΩ resistor to ground). Using 12-bit ADC values from GPIO 10 (values 0-4095), battery voltage can be estimated using this formula:
  V_bat = ADC_READING ÷ 941
  For best accuracy, use the average from multiple readings.
• The PWR OFF pin (near the USB-C connector) can be used to shut down the board while still allowing the battery to charge. To shut down the board, connect the PWR OFF pin to ground (GND) using a jumper wire or a switch.
• A few ways to reduce power consumption and extend battery life:
  
  • Turn off wireless functions on the ESP32-S3 when not in use.
  • Configure the ESP32-S3 to use a lower CPU frequency or dynamic frequency scaling (DFS).
  • Set GPIO 48 to LOW: this shuts down the speaker amp, headphone amp, and microphone preamp.
  • Set GPIO 14 to LOW to mute the DAC.
  • Stop outputting a MCLK signal on the ESP32-S3's GPIO 0 (may require calling i2s_stop()). This will power down the ADC and DAC.
  • Put the ESP32-S3 into light sleep or deep sleep (esp_light_sleep_start() or esp_deep_sleep_start()). If you've shut down the amps by setting GPIO 48 to LOW, don't forget to call gpio_deep_sleep_hold_en() before sleeping to keep the pin held low.
  • Remove any microSD card if you aren't using it.
  • You can disable the green power LED by carefully cutting the trace between the two jumper pads of JP1 on the underside of the board.

Programming

• Sonatino can be programmed using a number of different software tools. While Arduino IDE is probably the easiest for getting started, PlatformIO and ESP-IDF offer some additional benefits for more advanced projects.
• When uploading code, Arduino IDE will usually take care of putting the board into flashing mode and then resetting the board when the upload is complete. If that doesn't work, check that the correct port and board is selected, then try again. Some development tools don't handle the flashing process correctly by default, so you may need to adjust your software's board settings.
• In rare cases, you may need to manually put the board into flashing mode. This can be done by holding down the boot button while pressing the reset button, then releasing both buttons.

Audio

• Some audio libraries disable the master clock (MCLK, also called MCK, mck_io_num, or main_clock) by default. Sonatino requires this to be enabled and set to GPIO 0 for the DAC and ADC to work. If you aren't hearing any output, please double-check that you've configured GPIO 0 as the master clock.
• Sonatino uses separate bit clock (BCLK) and word clock (LRCLK) lines for the DAC and ADC — as noted in the pinout. The ESP32-S3 supports two I²S ports, so you can configure and use the DAC and ADC simultaneously (technically they could share those lines, but Sonatino wires them separately for added flexibility).
• The 3.2W speaker amp has its own independent DAC and shares the same I²S lines as the main DAC. The speaker amp's DAC can operate up to 96kHz, so only the main DAC (via the 3.5mm jack) will work for higher sample rates (up to 192kHz).
• GPIO 18 and GPIO 21 are connected to FSAMPEN and IWL pins of the WM8782 (ADC), respectively. These pins are used to configure the ADC's sample rate and word length. See the WM8782 datasheet for more information.
• GPIO 46 and GPIO 47 are connected to GAIN1 and GAIN0 of the TPA6132A2 (Headphone Amp), respectively. The default state corresponds to 0 dB gain (GAIN0 is pulled HIGH and GAIN1 is pulled LOW), but can be set to -6 dB, 0dB, 3dB, or 6 dB based on pin state. See section 7.4.1 of the TPA6132A2 datasheet for more information.
• The SD pin (next to the speaker output) is connected with a 680kΩ resistor to GPIO 48 (amp shutdown), which in turn is normally pulled HIGH (to 3.3V) by a 10kΩ resistor. By default, this means the speaker amp is enabled and in left/2 + right/2 mode (it outputs an average of both stereo channels). When GPIO 48 is set to LOW (in software), this amp — along with the other amps — will be shut down. If you wish to ouput only the right channel, pull up the SD pin to 3.3V through a 330kΩ resistor. For the left channel only, connect it directly to 3.3V.
• The GAIN pin (next to the speaker output) is normally unconnected, corresponding to 9 dB of gain. Different levels of speaker gain can be selected by connecting the GAIN pin as described in the MAX98357A datasheet.
• Without properly setting volume/gain (in software and hardware), audio output from Sonatino can be very loud! It can also become distorted if the volume is set too high. Please protect your ears and be careful when testing audio output!
• Noise in the audio can be caused by a number of factors including noisy power supplies, antennas that are too close, interference from other devices, and ground loops. If you encounter noise, try to isolate the source of the problem by testing different configurations and settings. USB-C power from a computer can often introduce noise, so try using a different power source if you suspect this is the issue. If noise is only present during wireless communication, try moving the antenna, using a different antenna (or adding shielding between the antenna and board), or lowering the transmit power (esp_wifi_set_max_tx_power() or esp_ble_tx_power_set()).
• Crackling, stuttering, or choppy audio is most often caused by misconfigured settings (sample rate, word length, master clock, DMA buffer, etc.) or by delays in the audio processing pipeline. Double-check that all your settings are correct and that no time-consuming tasks are blocking the delivery of audio samples. You may need to use RTOS programming to take advantage of both cores of the ESP32-S3.

Cases / Enclosures

• Sonatino will fit into some cases designed for the Raspberry Pi Zero, but not all. Cases that are open around the edges of the board generally work without modification, but those with cutouts for ports on the Raspberry Pi Zero (including the official case sold by Raspberry Pi) won't match the ports on Sonatino. Those cases can sometimes be modified by expanding or cutting out new holes for Sonatino's ports.

Inter-IC Sound (I2S) — Espressif API reference for I²S audio on ESP32-S3

ESP-ADF — Espressif Audio Development Framework

ESP-Skainet — Voice assistant / speech recognition for ESP32-S3

ESP8266Audio — Arduino library for playing audio on ESP8266 and ESP32

pschatzmann/arduino-audio-tools — Arduino Audio Tools

esp32_basic_synth — ESP32 based simple synthesizer project