Technical documentation · Elyssa

Everything you need
to wire it up.

Do not guess, check. The schematic, the pinout, which pins are safe for what, and the power limits, straight from the board files and the open-source repository. Built to save you hours (and a few chips).

Header J12, top to bottom.

Names follow the silkscreen and work in sketches without any #include. IO0 to IO6 are GPIO1 to GPIO7. There is no A7 and no T7.

Elyssa board, top view, with header labels
  1. 01Gnd—Ground
  2. 02TxGPIO43UART TX
  3. 03RxGPIO44UART RX
  4. 04IO0GPIO1A0 · T0 · digital
  5. 05IO1GPIO2A1 · T1 · digital
  6. 06IO2GPIO3A2 · T2 · digital
  7. 07IO3GPIO4A3 · T3 · digital
  8. 08IO4GPIO5A4 · T4 · digital
  9. 09IO5GPIO6A5 · T5 · digital
  10. 10IO6GPIO7A6 · T6 · BAT_SENSE (JP3)
  11. 11+3.3—3.3 V rail
  12. 12Gnd—Ground
  13. 13PWM1GPIO14PWM · or touch T10
  14. 14PWM2GPIO47PWM
  15. 15PWM3GPIO48PWM
  16. 16MISOGPIO37SPI MISO
  17. 17CLKGPIO36SPI SCK
  18. 18MOSIGPIO35SPI MOSI
  19. 19CSGPIO34SPI SS
  20. 20SCLGPIO9I2C SCL · A9 · T9
  21. 21SDAGPIO8I2C SDA · A8 · T8
  22. 22Vin—5 V, wired to USB (see the power rules)
  • Power / ground
  • Analog · touch · digital
  • UART · SPI · I2C
  • PWM

Is this pin safe?

Type the name printed next to a pin to see what it does and whether it is safe to use. Want everything at once? Open the full table.

Type a pin, or tap one of the examples, to see everything about it.

All pins

Safe: use freely. Caution: shared or has a catch, read the note. Reserved: wired to something on the board, not on the header.

PinGPIOStatusUse it forNotes
IO0 – IO5IO0…IO5 · A0…A5 · T0…T51 – 6SafeAnalog (ADC1), touch, digital in/outADC1 keeps working while Wi-Fi is on. Best general-purpose pins on the board.
IO6IO6 · A6 · T6 · BAT_SENSE7CautionAnalog, touch, digital, or battery senseShared with BAT_SENSE. If solder jumper JP3 is bridged (open by default) the battery voltage is on this pin, so do not use IO6 for anything else.
SDA / SCLSDA · SCL (A8/A9, T8/T9)8 / 9CautionI2C on the header and the Qwiic connector4.7 kΩ pull-ups are already on the board. Avoid touch or other loads on these pins while I2C is in use.
Tx / RxTX · RX43 / 44SafeUART to external devicesThey also drive the TX and RX indicator LEDs (D16, D17) through 1.5 kΩ resistors, so you see data flowing. Serial Monitor uses native USB, so these pins are free for a second UART.
CS / MOSI / CLK / MISOSS(CS) · MOSI · SCK(CLK) · MISO34 / 35 / 36 / 37SafeSPI on the header (default SPI bus)Digital only: no analog input or touch on these pins. Separate from the microSD bus.
PWM1PWM1 · T1014CautionPWM output, or touchPWM1 and T10 are the same pin: use it for touch or PWM, never both. Its analog input is on ADC2, which cannot be used while Wi-Fi is on.
PWM2 / PWM3PWM2 · PWM347 / 48SafePWM, digital in/outDigital only: no analog input or touch on these pins.
BOOT buttonBOOT_BUTTON0ReservedReads LOW when pressedStrapping pin. Held LOW during reset it enters download mode. After boot it works as a normal input, but do not drive it externally at boot.
RGB LED red / green / blueLED_RED · LED_GREEN (LED_BUILTIN) · LED_BLUE39 / 38 / 33ReservedOn-board RGB LED (active high, 330 Ω)GPIO39 is also the JTAG clock: the red LED lights during uploads. This is normal.
microSD socketSD_CS · SD_MOSI · SD_SCK · SD_MISO10 / 11 / 12 / 13ReservedmicroSD on its own SPI busWired to the socket on the back of the board; not on the header.
IMU (LSM6DS3TR-C)SDA_gyro · SCL_gyro · INT_gyro17 / 18 / 21ReservedInternal I2C bus (Wire1), address 0x6AIf a sketch also uses Wire1, call Wire1.begin(SDA1, SCL1, 400000) before elyssa_imu_begin().
USB D− / D+(not exposed)19 / 20ReservedNative USB-CUsed by the USB port. Not routed to the header.

What each pin can do

Every digital pin can also be PWM, UART, SPI, I2C or I2S, because the ESP32-S3 lets you route them freely. Analog input and touch are the only things tied to specific pins.

Header pinGPIOAnalog inputTouch
Tx43––
Rx44––
IO01ADC1T0
IO12ADC1T1
IO23ADC1T2
IO34ADC1T3
IO45ADC1T4
IO56ADC1T5
IO67ADC1T6
PWM114ADC2T10
PWM247––
PWM348––
MISO37––
CLK36––
MOSI35––
CS34––
SCL9ADC1T9
SDA8ADC1T8

Power, regulation and limits.

Four rules to read before you plug anything in, then every number that matters.

  1. 01One power source on VinThe USB line is wired to the Vin pin. Never connect USB and an external supply to Vin at the same time: it can backfeed and damage your setup or your computer.
  2. 023.3 V logic onlyEvery GPIO works at 3.3 V and is not 5 V tolerant. Use a level shifter for 5 V signals.
  3. 03Go easy on the pinsKeep each GPIO under about 20 mA. For motors, relays and strips of LEDs, switch them with a transistor or driver.
  4. 04Single-cell batteries onlyThe charger is made for one 3.7 V Li-Ion or Li-Po cell, charged to 4.2 V. Never connect two cells or any other battery type.
ItemValueNotes
Main 3.3 V railUp to 2 AA TLV62569DBVR step-down (buck) regulator with a 2.2 µH inductor drives the 3.3 V rail: efficient, steady, and plenty of headroom for sensors and modules.
USB-C input5 VProgramming, serial monitor and power over one cable. Use a data cable.
Vin pin5 V, wired to USBTake 5 V out of this pin, or power the board from it when USB is unplugged. Never feed Vin while USB is connected.
Input protectionPMOS + Schottky diodeA power-OR stage protects the input and stops current flowing back between power sources.
LiPo chargerBQ24092 · about 540 mACharges one cell from the 5 V USB input. The 1 kΩ ISET resistor sets the current. There is no GPIO for it: the CHG output only drives the red charge LED.
Battery1S Li-Ion / Li-Po, 3.7 VCharged to 4.2 V. A 1500 to 2000 mAh cell is a good balance between charging time and battery stress.
Charger temperatureWarm, up to about 125 °CThe charger chip can get noticeably warm. Around 125 °C its thermal regulation lowers the charging current automatically.
Battery voltage readingVBAT / 2 on IO6 (GPIO7)Only after bridging solder jumper JP3. In a sketch: vbat = analogReadMilliVolts(BAT_SENSE) × 2 / 1000.
Logic level3.3 VGPIOs are not 5 V tolerant.
Current per GPIOUnder 20 mAUse a transistor or driver for anything heavier.
Analog inputs0 – 3.3 V, 12-bit (0 – 4095)ADC1 pins (IO0 to IO6, SDA, SCL) work with Wi-Fi on. PWM1 is on ADC2, which cannot be used while Wi-Fi is on. Use analogReadMilliVolts() for a calibrated reading.
RGB LED330 Ω per channelGreen looks brighter than red and blue. Balance mixed colours with setLedRGB().
I2C4.7 kΩ pull-ups to 3.3 VThe header and Qwiic share GPIO8 / GPIO9. The IMU runs on its own bus at 400 kHz.
Wi-Fi transmit power11 dBm by defaultSet by the board package for a reliable link. Above 12 dBm the connection can fail or slow down.
Bluetooth LE−12 to +20 dBmAdvertising power range available on Elyssa.
Disclaimer

Elyssa is an open-source development board, provided “as is”. Moovma is not responsible for any damage, loss or malfunction caused by using it, by connecting it incorrectly, or by going beyond the limits on this page. Always double-check your wiring and power before you plug anything in.

Still have a question?

Ask about pins, power or the pre-order. Send the form and we reply by email, or write to moovmabh@gmail.com.

Pre-order Elyssa