SolarOS

SolarOS 4.18.2 manual · hardware

SenseCAP Watcher

Build the ESP32-S3 firmware with pio run -e seeed_sensecap_watcher. The target uses 32 MB QSPI flash, 8 MB octal PSRAM, and the full flavor. Its partition table provides two 7 MiB OTA slots and almost 18 MiB of internal FAT storage.

SolarOS starts its shell on the display. Use a paired BLE keyboard for typing; hold the wheel push button to start pairing.

Use the bottom USB-C programming port. The rear USB-C port supplies power only. The dual USB-to-UART bridge presents an ESP32 port and a separate Himax port; use the ESP32 port at 115200 baud. For an optional UART shell, run session create shell uart0 from the display shell.

Native USB starts off, leaving expansion GPIO19/20 free for GPIO, ADC, PWM, and runtime buses. With the USB package included, use usb mode device for native CDC on J2, usb mode host for USB peripherals, and usb mode off to release the pins again. Release any pin or cdc0 owner before switching. These native USB signals are separate from the USB-to-UART programming connector. See USB modes and wiring.

The panel is circular, with 412x412 addressable pixels. The default layout canvas is a centered 291x291 rectangle. Terminal and TUI content fits this rectangle; graphics may draw into the surrounding panel pixels using canvas coordinates. display canvas display0 reports both bounds, and display canvas display0 full temporarily uses a 412x412 layout canvas.

Identify the ESP32 port by its ESP-ROM:esp32s3 startup message. Serial-port numbering varies; the other interface belongs to Himax and runs at 921600 baud.

On Linux, disable hang-up-on-close on the identified ESP32 port before opening the terminal. For example, if that port is /dev/ttyACM1:

stty -F /dev/ttyACM1 -hupcl
pio device monitor -e seeed_sensecap_watcher -p /dev/ttyACM1

The Watcher environment keeps DTR and RTS asserted together. Both lines feed the hardware reset/boot circuit; changing them separately can reboot the ESP32. Keep hardware flow control disabled and close other monitors before connecting. The Linux hang-up setting must be applied again after reconnecting USB.

Board devices

These devices attach automatically with origin=board and reserve their wiring. Inspect them with expansion devices, board, io, and input status.

DeviceDriverWiring
gpiox0PCA9535i2c0, address 0x21, SDA47/SCL48
camera0Himax HX6538SPI2 shared with SD, CS21, ready gpiox0:6, reset gpiox0:7, power gpiox0:11
display0SPD2010SPI3 QSPI, CLK7, D0=9, D1=1, D2=14, D3=13, CS45, backlight8
touch0SPD2010 touchtouch-i2c, address 0x53, SDA39/SCL38, IRQ gpiox0:5
storage0SDSPISPI2, CLK4, MOSI5, MISO6, CS46, power gpiox0:8
audio0ES8311 + ES7243Ei2c0, DAC 0x18, ADC 0x14; I2S0 MCLK10/BCLK11/WS12/DIN15/DOUT16; amplifier gpiox0:12
battery0Battery ADCGPIO3, divider ratio 4.1; 400 mAh capacity
rtc0PCF8563i2c0, address 0x51
wheel0Rotary encoderLogical A42/B41; Up/Down detents
system-keySystem KEYActive-low wheel push button gpiox0:3; short press Enter, long press BLE pairing
pixels0One WS2812 RGB LEDGPIO40

The expander attaches first. It enables the system latch, SD, LCD, Grove, battery divider, and the factory AI power rail, while leaving the speaker amplifier disabled until audio output starts. Touch uses its own I2C bus.

The wheel push button uses the system KEY policy. Its default long-press threshold is 1.2 seconds; releasing a long press does not also send Enter. Change either action with power key short <action> or power key long <action>. The button also wakes software suspension, light sleep, deep sleep, and shutdown. The PCA9535's shared active-low interrupt output connects to ESP32 GPIO2, an RTC-capable wake input. Light sleep resumes the running session; deep sleep and shutdown wake into a fresh boot. Holding the wheel during wake does not also send Enter or start pairing. Other input changes on the same expander can also assert this shared wake line. The panel output and backlight turn off before sleep. Its shared touch supply stays enabled at shutdown to preserve a stable wake interrupt.

Some Watcher revisions fit ES7243 at 0x13 rather than ES7243E at 0x14. For those boards, change audio0 to driver = "es8311-es7243", addr = 0x13, and set SOLAR_OS_BOARD_AUDIO_CODEC_IN to "ES7243" in the board manifest. The ES8311 DAC remains at the 7-bit address 0x18 in either revision.

The Himax camera driver samples the OV5647 through the factory SSCMA firmware. Use camera resolutions to list its modes and camera capture /sample.jpg 416x416 to save a JPEG. The default is 240x240; 416x416, 480x480, and 640x480 are also available. Camera sampling preserves the Himax firmware and installed models. The camera driver supplies sampling; the included processor-himax provider supplies model management and inference pipelines.

Battery percentage is estimated from voltage. The standalone charger operates in hardware; this profile does not expose charging-current control.

Expansion connectors

Positions below are schematic pin numbers, not a guessed front/back view. J2 has pins 1..4 opposite pins 8..5. io displays the same connector map.

ConnectorPinSignal
J21GND
J223.3 V output
J23I2C SDA, GPIO47
J24GPIO19 / native USB D-
J25GPIO20 / native USB D+
J26I2C SCL, GPIO48
J275 V input
J28GND
J5 Grove1I2C SCL, GPIO48
J5 Grove2I2C SDA, GPIO47
J5 Grove3Switched 3.3 V output (gpiox0:14)
J5 Grove4GND

J2 and J5 share i2c0 with onboard devices. GPIO47/48 stay owned by that bus; attach I2C expansions through i2c=i2c0. GPIO19/20 are free 3.3 V GPIO, ADC, and PWM signals while native USB is off. Host/device mode claims both pins. USB host use requires suitable external peripheral power; J2's 5 V contact is a supply input, not a software-controlled VBUS output or GPIO.

Hardware references: Seeed's hardware overview and SenseCAP Watcher BSP.

Quick reference

Target: seeed_sensecap_watcher. Console: display with BLE keyboard input. Optional UART shell: session create shell uart0, bottom USB-C ESP32 port, 115200 baud. Display/touch: SPD2010, 412x412. I2C expansions: i2c0, SDA47, SCL48. Free header GPIOs at boot: 19 and 20. Native USB: usb mode off|device|host, default off. Camera: camera0, factory Himax JPEG sampling.