SolarOS

Supported hardware

Devices

Explore 22 SolarOS targets and their hardware capabilities.

Firmware flavors determine which apps, jobs, and services are available. Some targets are assembled configurations that require the listed external hardware.

Use the Flasher to find available firmware, or see Boards and hardware targets for build and custom-board instructions. On your device, run board to inspect its capabilities.

SolarTerm

Hardware capabilities
HardwareSolarTerm, built from the Waveshare ESP32-S3-RLCD-4.2
Display400×300 ST7305 reflective LCD.
Keyboard and controlsKEY button; attach an external keyboard for typing.
SoundES8311 audio output and ES7210 microphone capture.
StoragemicroSD over SDMMC.
ConnectivityWi-Fi, BLE, native USB CDC, and UART.
Battery and powerBattery voltage monitoring through ADC.
Sensors and peripheralsPCF85063 RTC; SHTC3 temperature and humidity sensor.
ExpansionI2C, SPI, UART, GPIO, ADC, PWM, and I2S; runtime SPI3 routing on GPIO1/GPIO2/GPIO3/GPIO17.
Targetsolar_term
PlatformIO environmentsolar_term

SolarWriter

Hardware capabilities
HardwareSolarWriter, built from the Elecrow CrowPanel 5.79-inch
Display792×272 dual-SSD1683 e-paper.
Keyboard and controlsRotary, menu, and exit controls; attach an external keyboard for typing.
SoundINMP441 microphone; shared PCM5102 line output and MAX98357 speaker output.
StoragemicroSD over SPI.
ConnectivityWi-Fi, BLE, and CH340 USB-to-UART console.
Battery and powerLC709203F fuel gauge.
Sensors and peripheralsDS3231 RTC.
ExpansionI2C, SPI, UART, GPIO, ADC, PWM, and I2S. GPIO21 is reserved for jack detection.
Requirements and notesAssembled SolarWriter configuration based on the Elecrow CrowPanel 5.79-inch; the listed audio, RTC, and fuel-gauge hardware must be fitted.
Targetsolar_writer
PlatformIO environmentsolar_writer

Freenove ESP32-S3 Display 4.0-inch (FNK0104S)

Hardware capabilities
HardwareFreenove ESP32-S3 Display 4.0-inch (FNK0104S)
Display480×320 ST7796 LCD with brightness control.
Keyboard and controlsFT6336 capacitive touch and KEY button; no built-in keyboard.
SoundES8311 speaker output and microphone capture.
StoragemicroSD over four-bit SDMMC.
ConnectivityWi-Fi, BLE, native USB CDC, and UART.
Battery and powerBattery voltage monitoring through ADC.
ExpansionUART, I2C, and GPIO expansion connectors.
Targetfreenove_esp32_s3_display_4_0
PlatformIO environmentfreenove_esp32_s3_display_4_0

QDtech ES3C28P 2.8-inch ESP32-S3 Touch Display

Hardware capabilities
HardwareQDtech ES3C28P 2.8-inch ESP32-S3 Touch Display
Display320×240 landscape ILI9341V LCD with brightness control.
Keyboard and controlsFT6336 capacitive touch and KEY button; no built-in keyboard.
SoundES8311 speaker output and microphone capture.
StoragemicroSD over four-bit SDMMC.
ConnectivityWi-Fi, BLE, native USB CDC, and UART.
Battery and powerBattery voltage monitoring through ADC.
ExpansionUART, I2C, and GPIO expansion connectors; one WS2812B RGB LED.
Targetqdtech_es3c28p
PlatformIO environmentqdtech_es3c28p

QDtech ES3N28P 2.8-inch ESP32-S3 Display

Hardware capabilities
HardwareQDtech ES3N28P 2.8-inch ESP32-S3 Display
Display320×240 landscape ILI9341V LCD with brightness control; no touch.
Keyboard and controlsKEY button; no built-in keyboard.
SoundES8311 speaker output and microphone capture.
StoragemicroSD over four-bit SDMMC.
ConnectivityWi-Fi, BLE, native USB CDC, and UART.
Battery and powerBattery voltage monitoring through ADC.
ExpansionUART, I2C, and GPIO expansion connectors; one WS2812B RGB LED.
Targetqdtech_es3n28p
PlatformIO environmentqdtech_es3n28p

Elecrow CrowPanel ESP32-S3 4.2-inch E-paper

Hardware capabilities
HardwareElecrow CrowPanel ESP32-S3 4.2-inch E-paper
Display400×300 SSD1683 e-paper.
Keyboard and controlsRotary, menu, and exit controls; no built-in keyboard.
SoundNo built-in audio.
StoragemicroSD over SPI.
ConnectivityWi-Fi, BLE, and CH340C USB-to-UART console.
ExpansionI2C, SPI, UART, 1-Wire, GPIO, ADC, and PWM; status LED.
Targetelecrow_crowpanel_esp32_s3_4_2_epaper
PlatformIO environmentelecrow_crowpanel_esp32_s3_4_2_epaper

Elecrow CrowPanel ESP32-S3 5.79-inch E-paper

Hardware capabilities
HardwareElecrow CrowPanel ESP32-S3 5.79-inch E-paper
Display792×272 dual-SSD1683 e-paper.
Keyboard and controlsRotary, menu, and exit controls; no built-in keyboard.
SoundNo built-in audio.
StoragemicroSD over SPI.
ConnectivityWi-Fi, BLE, and CH340C USB-to-UART console.
ExpansionI2C, SPI, UART, 1-Wire, GPIO, ADC, and PWM; status LED.
Targetelecrow_crowpanel_esp32_s3_5_79_epaper
PlatformIO environmentelecrow_crowpanel_esp32_s3_5_79_epaper

Waveshare ESP32-S3-ePaper-3.97

Hardware capabilities
HardwareWaveshare ESP32-S3-ePaper-3.97
DisplaySSD1677 e-paper; defaults to 800×480 landscape.
Keyboard and controlsRotary navigation and board buttons; no built-in keyboard.
SoundES8311 speaker output and microphone capture.
StoragemicroSD over four-bit SDMMC.
ConnectivityWi-Fi, BLE, native USB CDC, and UART.
Battery and powerAXP2101 battery and charger monitoring.
Sensors and peripheralsPCF85063 RTC; SHTC3 temperature/humidity sensor; QMI8658 six-axis IMU.
ExpansionI2C and UART expansion.
Targetwaveshare_esp32_s3_epaper_3_97
PlatformIO environmentwaveshare_esp32_s3_epaper_3_97

Xteink X4 Pro

Hardware capabilities
HardwareXteink X4 Pro
Display800×480 landscape e-paper; SSD1677/UC8179/UC8279 controller identification; fixed-mix frontlight brightness.
Keyboard and controlsGT911 touch, Home pad, and navigation buttons; no built-in keyboard.
SoundNo built-in audio.
StoragemicroSD over one-bit SDMMC.
ConnectivityWi-Fi, BLE, native USB CDC, and UART0.
Battery and powerCW2017 battery gauge.
Sensors and peripheralsBM8563-compatible RTC.
Targetxteink_x4_pro
PlatformIO environmentxteink_x4_pro

CL-32

Hardware capabilities
HardwareCL-32
Display384×168 ST7305 reflective LCD.
Keyboard and controlsBuilt-in keyboard managed by the ATmega808 board controller.
SoundOnboard PWM buzzer.
StoragemicroSD over SPI.
ConnectivityWi-Fi, BLE, native USB CDC, and UART.
Battery and powerBattery monitoring through the ATmega808 board controller.
Sensors and peripheralsPCF85063 RTC.
ExpansionI2C, SPI, UART, GPIO, ADC, PWM, and I2S.
Targetcl_32
PlatformIO environmentcl_32

Hardkernel ODROID-GO

Hardware capabilities
HardwareHardkernel ODROID-GO
Display320×240 ILI9341 LCD with brightness control.
Keyboard and controlsGame buttons and ADC D-pad; no built-in keyboard.
SoundSpeaker through the ESP32 internal DAC on GPIO26; GPIO25 controls the amplifier.
StoragemicroSD over VSPI/SPI.
ConnectivityWi-Fi, BLE, and UART.
Battery and powerBattery voltage monitoring through ADC.
ExpansionI2C, SPI, UART, GPIO, and PWM; runtime GPIO4/GPIO15; status LED.
Targetodroid_go
PlatformIO environmentodroid_go

Freenove ESP32-WROVER v3.0

Hardware capabilities
HardwareFreenove ESP32-WROVER v3.0 (FNK0060)
Display384×288 monochrome PAL composite output on GPIO25; requires an external display.
Keyboard and controlsGPIO0 BOOT/KEY button; no built-in keyboard.
SoundNo board audio configured; GPIO25 is used for composite video.
StoragemicroSD over one-bit SDMMC.
ConnectivityWi-Fi, BLE, and CH340 USB-to-UART console.
ExpansionI2C, SPI, UART, GPIO, ADC, PWM, and I2S.
Targetfreenove_esp32_wrover_v3
PlatformIO environmentfreenove_esp32_wrover_v3

LilyGO TTGO VGA32 v1.4

Hardware capabilities
HardwareLilyGO TTGO VGA32 v1.4
DisplayExternal VGA through the onboard RGB222 resistor DAC; build-selectable 320×200 at 70 Hz, 320×240 at 60 Hz, 640×400 at 70 Hz, or 640×480 at 60 Hz.
Keyboard and controlsPS/2 keyboard attaches automatically when connected; requires an external keyboard.
SoundMono ESP32 DAC audio on GPIO25.
StoragemicroSD over HSPI using the v1.4 wiring.
ConnectivityWi-Fi and USB-to-UART console; BLE is disabled by default.
ExpansionTwo input-only expansion GPIOs.
Targetttgo_vga32_v14
PlatformIO environmentttgo_vga32_v14

Espressif ESP32-S3-DevKitC-1-N16R8

Hardware capabilities
HardwareEspressif ESP32-S3-DevKitC-1-N16R8
DisplayHeadless; graphics are available through attachable display targets.
Keyboard and controlsGPIO0 BOOT/KEY button; no built-in keyboard.
SoundNo built-in audio.
StorageNo onboard SD interface configured.
ConnectivityWi-Fi, BLE, native USB CDC, and UART.
Sensors and peripheralsNo onboard sensors configured.
ExpansionI2C, SPI, UART, GPIO, ADC, PWM, and I2S.
Targetesp32_s3_devkitc1_n16r8
PlatformIO environmentesp32_s3_devkitc1_n16r8

GOOUUU ESP32-S3CAM

Hardware capabilities
HardwareGOOUUU ESP32-S3CAM
DisplayHeadless; no primary display.
Keyboard and controlsBOOT/KEY button; no built-in keyboard.
SoundNo built-in audio.
StoragemicroSD over one-bit SDMMC.
ConnectivityWi-Fi, BLE, native USB CDC, and CH340 USB-to-UART console.
Sensors and peripheralsFixed DVP/SCCB camera wiring; OV2640 probing and QVGA/VGA JPEG capture. cam-webd provides single-client MJPEG streaming and JPEG snapshots with optional authentication.
ExpansionOne onboard WS2812 RGB LED; board-owned camera pins remain reserved.
Targetgoouuu_esp32_s3cam
PlatformIO environmentgoouuu_esp32_s3cam

Espressif ESP32-DevKitC V4 (WROVER)

Hardware capabilities
HardwareEspressif ESP32-DevKitC V4 with ESP32-WROVER-E
DisplayHeadless; graphics are available through attachable display targets.
Keyboard and controlsGPIO0 BOOT/KEY button; no built-in keyboard.
SoundNo built-in audio.
StorageNo onboard SD interface configured.
ConnectivityWi-Fi, BLE, and UART; no native USB CDC.
Sensors and peripheralsNo onboard sensors configured.
ExpansionI2C, SPI, UART, GPIO, ADC, PWM, and I2S.
Targetesp32_devkitc_v4_wrover
PlatformIO environmentesp32_devkitc_v4_wrover

ESP32-S3 DevKitC-1 E-paper Workbench

Hardware capabilities
HardwareESP32-S3 DevKitC-1 E-paper Workbench
DisplayFixed external 400×300 SSD1683 e-paper display.
Keyboard and controlsFixed external CardKB I2C keyboard.
SoundNo board audio configured.
StorageFixed external microSD attachment over SPI.
ConnectivityWi-Fi, BLE, native USB CDC, and UART.
Requirements and notesDevelopment configuration based on the ESP32-S3 DevKitC-1; requires the listed display, keyboard, and storage attachments.
Targetdevkitc1_epaper_workbench
PlatformIO environmentesp32_s3_devkitc1_n16r8 with SOLAR_OS_BOARD=devkitc1_epaper_workbench

LilyGO T-LoRa-Pager (SX1262)

Hardware capabilities
HardwareLilyGO T-LoRa-Pager (SX1262)
Display480×222 ST7796 LCD with brightness control.
Keyboard and controlsBuilt-in TCA8418 4×10 matrix keyboard and rotary encoder.
SoundES8311 audio output and microphone capture.
StoragemicroSD over SPI; SD power and its external pull-up start enabled.
ConnectivityWi-Fi, BLE, native USB CDC, and SX1262 LoRa radio.
Battery and powerBQ27220 battery gauge; BQ25896 charger with 704 mA initial fast-charge current; XL9555-controlled power rails.
Sensors and peripheralsPCF85063 RTC; MIA-M10Q GNSS; ST25R3916 NFC-A reader; BHI260AP IMU; DRV2605 haptics.
ExpansionI2C, SPI, UART, GPIO, ADC, and PWM.
Requirements and notesGNSS and NFC power start disabled; enable them with gnss power on and nfc power on. DRV2605 ROM effects 1–117 are available through haptic play EFFECT.
Targett_lora_pager
PlatformIO environmentt_lora_pager

Elecrow ThinkNode M9

Hardware capabilities
HardwareElecrow ThinkNode M9
Display320×240 ST7789 LCD with brightness control.
Keyboard and controlsBuilt-in 37-key STC8H QWERTY keypad with backlight and a compose layer.
SoundPassive PWM buzzer.
StoragemicroSD over SPI.
ConnectivityWi-Fi, BLE, and CH340K USB-to-UART console. The onboard LR1110 LoRa radio has no SolarOS driver yet; its pins are reserved.
Battery and powerBattery voltage monitoring through ADC.
Sensors and peripheralsPCF8563 RTC; ATGM336H or BM72A GNSS over NMEA.
ExpansionI2C, SPI, UART, GPIO, ADC, and PWM.
Requirements and notesGNSS starts powered off; use gnss power on. The default profile uses the v1.0 active-low GNSS enable rail; v1.1 requires active = 1 on gnss0.
Targetthinknode_m9
PlatformIO environmentthinknode_m9

LilyGO T-Deck Plus

Hardware capabilities
HardwareLilyGO T-Deck Plus
Display320×240 ST7789 LCD with brightness control.
Keyboard and controlsBuilt-in I2C keyboard, five-way trackball, and GT911 capacitive touch.
SoundSeparate I2S speaker output and ES7210 microphone capture.
StoragemicroSD over SPI.
ConnectivityWi-Fi, BLE, native USB CDC, and SX1262 LoRa radio.
Battery and powerBattery voltage monitoring through ADC.
Sensors and peripheralsFactory L76K or MIA-M10Q GNSS receiver over NMEA UART; no onboard NFC reader.
ExpansionGrove connector; its GPIO43/GPIO44 UART signals are shared with onboard GNSS.
Requirements and notesThe GNSS receiver has no independent power control. Releasing its software UART claim does not electrically disconnect the receiver.
Targett_deck_plus
PlatformIO environmentt_deck_plus

Waveshare ESP32-S3-SIM7670G-4G V2.0

Hardware capabilities
HardwareWaveshare ESP32-S3-SIM7670G-4G V2.0
DisplayHeadless; no primary display.
Keyboard and controlsBOOT/KEY button; no built-in keyboard.
SoundNo board audio configured.
StoragemicroSD over one-bit SDMMC.
ConnectivityWi-Fi, BLE, CH343 USB-to-UART console, and SIM7670G AT/IPv4 PPP access over UART1.
Battery and powerMAX17048 battery gauge; software-controlled modem VBAT rail.
Sensors and peripheralsSIM7670G GNSS. Camera support is not included.
ExpansionGPIO, ADC, PWM, SPI, and I2S on available pins with CAM off; GPIO15/GPIO16 remain shared I2C and GPIO46 is blocked.
Requirements and notesSet DIP switches to CAM OFF, HUB ON, 4G OFF, USB OFF. The modem UART belongs exclusively to PPP while connected; disconnect PPP before AT or GNSS use.
Targetwaveshare_esp32_s3_sim7670g_4g
PlatformIO environmentwaveshare_esp32_s3_sim7670g_4g

Waveshare ESP32-S3-SIM7670G-4G E-paper

Hardware capabilities
HardwareWaveshare ESP32-S3-SIM7670G-4G E-paper workbench
DisplayFixed external 400×300 SSD1683 e-paper display on SPI2.
Keyboard and controlsFixed external M5Stack TAB5 I2C keyboard at address 0x6d, with interrupt on GPIO41.
SoundNo board audio configured.
StoragemicroSD over one-bit SDMMC.
ConnectivityWi-Fi, BLE, CH343 USB-to-UART console, and SIM7670G AT/IPv4 PPP access over UART1.
Battery and powerMAX17048 battery gauge; software-controlled modem VBAT rail.
Sensors and peripheralsSIM7670G GNSS. Camera support is not included.
ExpansionGPIO40 remains available; the display occupies GPIO3/GPIO7 through GPIO12.
Requirements and notesWorkbench configuration requiring the listed external display and keyboard. Set DIP switches to CAM OFF, HUB ON, 4G OFF, USB OFF. Disconnect PPP before AT or GNSS use.
Targetwaveshare_esp32_s3_sim7670g_4g_epaper
PlatformIO environmentwaveshare_esp32_s3_sim7670g_4g with SOLAR_OS_BOARD=waveshare_esp32_s3_sim7670g_4g_epaper