OpenGND
Open Customizable Hardware
FIRMWARE & WEBOTA·10 min read·Updated 2026-11-17

SKU-01 Smart Clock: v1.3.0 Cable-Free Switcher, Unified 3-Key Dial & Battery Rescue

Complete v1.3.0 on-device cable-free firmware switcher (SW4 SETTINGS_MENU: 1.5s Dual-OTA Fast Swap + Wi-Fi HTTPS Cloud Pull), unified 3-key + rotary dial control matrix, 100% schematic-verified board_pins.h, and the Battery & Physical Rescue Standard (0V Cut, Soft Reboot, 120s-RWDT USB Download).

1. Schematic-Verified Hardware Architecture (OPENGND-2 & OPENGND-13)

SKU-01 runs directly on the unmodified retail HOTMIND Smart Clock (Amazon ASIN: B0H6KGC3N3). Hardware verification against the 6-sheet production schematic confirms a remarkably capable multimodal ESP32-S3 platform:

Unlike bare dev boards where USB 5V directly powers the 3.3V regulator, the retail mainboard routes both USB DC_5V and the internal Li-ion battery upstream of a high-side soft-power PMOS (Q1 AO3401A), with no external physical EN/RST switch populated. Plugging in USB Type-C alone does not turn on VDD_3V3 until either Knob Push (IO14) / Settings (SW4 IO18) pulls Q1 gate low OR firmware latches PWR_Control (IO7 / RTC_GPIO7) HIGH.

v1.3.0 Unified Controls, On-Device Switcher & Battery Rescue Standard

All v1.3.0 native SKU-01 firmwares lock GPIO_NUM_7 HIGH in ESP_SYSTEM_INIT_FN (priority 120) with gpio_hold_en(), run ognd_fw_switcher (short-press right SW4 IO18 for SETTINGS_MENU 1.5s Dual-OTA Fast Swap or Wi-Fi HTTPS Cloud Pull; left SW3 IO48 returns/closes or holds >=7s runtime / >=4s boot for Type-C USB Download Mode), and enforce ognd_pwr_sup + 2-stage silicon WDT_RWDT (15s RESET_SYSTEM -> +5s RESET_RTC) + 3.25V 3-strike UVLO.

2. Cable-Free Switching: On-Device SETTINGS_MENU (v1.3.0) & LAN WebOTA

OpenGND preserves the factory 0x10000 partition boundary (keeping fctry calibration and NVS intact while reusing symmetric 7.31 MB dual OTA slots ota_0 @ 0x40000 & ota_1 @ 0x790000, plus the 1,024 KB emote_gen asset partition + /sdcard):

  • Step 1 — Install Partition-Safe Unlock Bridge (Once): Connect to 2.4GHz Wi-Fi and flash opengnd-clock-unlock-bridge.bin (v1.4.1) @ 0x40000 (clearing otadata @ 0x35000 if flashed over Type-C so boot deterministically starts on ota_0).
  • Step 2 — Scroll & Switch Across All 7 Firmwares via Right Key SW4: Short-press right Settings (SW4 IO18, 35..1200ms release) from any native firmware (auto-disarms Clock AI-KVM HID safely!) to open SETTINGS_MENU. Turn the top knob (IO47/21) across all 7 SKU-01 firmwares and press IO14 for 1.5s offline Dual-OTA Fast Swap (ota_0 <-> ota_1) or Wi-Fi HTTPS Cloud Self-OTA pull (NVS ota_base_url, defaults to https://test.opengnd.com -> https://opengnd.com fallback), or browse http://opengnd-clock.local/update.
  • Step 3 — Swap Any of the 7 Releases Safely: Switch seamlessly among opengnd-clock-agent-hud.bin (v2.4.1), opengnd-clock-voxdeck.bin (v1.1.1 · 6-pad macro + cursor voice dictation + PIN 2FA), opengnd-clock-recorder.bin (v1.1.1 · PocketNote TF + 1MB flash fallback recorder), opengnd-clock-ticker.bin (v2.1.1 · FlipTicker Braun clock + sparklines + Cha-Ching! + Homelab), opengnd-clock-byok.bin (v1.4.1), opengnd-clock-ai-kvm.bin (v1.4.0), opengnd-clock-unlock-bridge.bin (v1.4.1), Xiaozhi-ESP32 / Meta Muse BSPs (v1.2.0), ESPHome (v2026.11.3), or restore your esptool stock backup.

3. Schematic-Verified Pinout Excerpt (board_pins.h)

All peripheral pins in projects/sku-01-clock-esp32/hardware/board_pins.h have been 100% verified against the production schematic:

projects/sku-01-clock-esp32/hardware/board_pins.h (Verified OPENGND-2 & OPENGND-13)c
#pragma once
#define OPENGND_PINS_VERIFIED       1
#define BOARD_MCU_MODULE            "ESP32-S3-WROOM-1U-N16R8" /* 16MB QIO + 8MB Octal PSRAM */
#define BOARD_PWR_HOLD_PIN          7   /* RTC_GPIO7 -> Q3 MMBT3904 -> Q1 AO3401A PMOS */

/* 320x240 NV3031A IPS (SPI3 @ 80MHz, RGB565_BE) + CST226SE Touch (0x5A, shared RST IO9) */
#define BOARD_LCD_PIN_MOSI          13
#define BOARD_LCD_PIN_SCLK          10
#define BOARD_LCD_PIN_CS            12
#define BOARD_LCD_PIN_DC            11
#define BOARD_LCD_PIN_RST           9   /* Shared with CST226SE Touch! */
#define BOARD_LCD_PIN_TE            3
#define BOARD_LCD_PIN_BL            8

/* Shared I2C1 (SDA=2, SCL=1): ES8311 (0x18), ES7210 Dual-Mic AEC (0x40), CHT8325 (0x44)/AHT20 (0x38) */
#define BOARD_I2S_PIN_MCLK          42
#define BOARD_I2S_PIN_BCLK          40
#define BOARD_I2S_PIN_WS            39
#define BOARD_I2S_PIN_DOUT          41
#define BOARD_I2S_PIN_DIN           38
#define BOARD_PA_ENABLE_PIN         45  /* NS4150B Class-D Speaker PA */

/* Tactile Controls & SDMMC (/sdcard) */
#define BOARD_ENC_PIN_A             47
#define BOARD_ENC_PIN_B             21
#define BOARD_ENC_BTN_PIN           14  /* RE_Press: Q1 HW start | Confirm/E-Stop | SW3+IO14 >= 2.5s Reboot */
#define BOARD_BTN_PIN_SETTINGS      18  /* SW4 (Right): Short <1.2s SETTINGS_MENU | >= 4s or SW4+SW3 >= 2s 0V Off */
#define BOARD_BTN_PIN_RETURN        48  /* SW3 (Left): Short Return | 1.5s AP | 3..6.99s Reboot | >= 4s/7s USB DL */
#define BOARD_SDMMC_PIN_CLK         16
#define BOARD_SDMMC_PIN_CMD         15
#define BOARD_SDMMC_PIN_D0          17

4. v1.3.0 Unified Control Matrix & Physical Rescue (0V Cut, Reboot & 120s-RWDT USB Download)

Because internal SW1 (IO0) sits inside the plastic shell, SW2 (RST) is unpopulated, and the Li-ion battery remains wired upstream of Q1 even when USB is unplugged, OpenGND v1.3.0 combines release-based 3-key + 1-knob navigation with the five-layer battery/rescue escape matrix with zero screws removed:

  • v1.3.0 Unified 3-Key + Rotary Dial Controls: Short-press right Settings (SW4 IO18, 35..1200ms) to open/close SETTINGS_MENU (auto-disarms Clock AI-KVM if armed); short-press left Return (SW3 IO48) to close menu or run primary back/white-noise/audit-reset; spin IO47/21 & press IO14 to execute 1.5s Dual-OTA Fast Swap or Wi-Fi HTTPS Cloud Pull (/api/system/ota-{slots,swap,pull}).
  • True 0V Battery Cut (Safe Power-Off): Hold Settings (SW4 IO18) >= 4.0s, hold chord SW4 + SW3 >= 2.0s, or click WebUI Power Off (Cut Battery) (POST /api/system/poweroff). Firmware mutes IO45 speaker PA + IO8 backlight first, disarms RWDT, waits for IO14/IO18 release (+80ms), and releases RTC_GPIO7 to cut Q1 to 0V (or enters ext1 deep sleep if USB VBUS_5V stays plugged, waking on IO14/IO18).
  • Force Soft-Reboot: Hold chord SW3 (IO48) + Knob Push (IO14) >= 2.5s for immediate reboot, hold SW3 alone for 3.0s..6.99s and release, or call POST /api/reboot (preserves single short IO14 slap for AgentHUD / <5ms KVM E-Stop when menu is closed).
  • Hands-Free USB Download Mode (120s RWDT Anti-Drain Guard + 60ms SE0 Detach): Hold SW3 >= 7.0s at runtime, hold SW3 >= 4.0s during the 150ms early-boot window, or POST /api/system/usb-download. Latches RTC_GPIO7 HIGH, drives 60ms SE0 + clears RTC_CNTL_USB_CONF_REG so TinyUSB detaches cleanly back to USB_SERIAL_JTAG (0x303A:0x1001), and arms a 120s WDT_RWDT (RESET_RTC) guard. When flashing 0x40000 via Type-C after prior OTA slot swaps, erase otadata (0x35000 0x2000) so boot deterministically resumes from ota_0.
  • Dual-Stage Runtime WDT_RWDT & Safe-Mode AP / Blank-Flash: Runtime WDT_RWDT triggers Stage 0 = 15s (RESET_SYSTEM keeping IO7=1) and Stage 1 = +5s (RESET_RTC releasing IO7 to 0V on bad-image bootloops). Hold SW3 1.5–3.9s at boot for OpenGND-Rescue-XXXX AP (192.168.4.1/update), or hold IO14/SW4 continuously while flashing a completely blank Flash.