OpenGND
Open Customizable Hardware
// DEVELOPER DOCUMENTATION · TECHNICAL MANUALS

Engineering Guides & Openness Specifications

Clear, reproducible reference docs covering cable-free Wireless WebOTA flashing, board_pins.h hardware abstraction, acoustic .STEP shell tolerances, and local LAN protocols.

Open Web Studio
DOC-01 // GETTING STARTED5 min read

OpenGND Quick Start: Silicon-Agnostic Open Hardware in 5 Minutes

Understand the OpenGND Common Ground philosophy, our silicon-agnostic customizable hardware model (ESP32-S3, BK7258, ESP32-C3), Apache-2.0/MIT firmware source archives, and zero-code browser customization.

SKU-01SKU-02SKU-08SKU-10
Read Manual
DOC-02 // FIRMWARE & WEBOTA10 min read

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).

SKU-01
Read Manual
DOC-03 // FIRMWARE & WEBOTA7 min read

SKU-01 Zero-Code Skin Studio (.gndskin v1.0) & OpenGND AgentHUD Setup Guide

Byte-level specification of the .gndskin v1.0 POSIX ustar container (OGS1 Big-Endian RGB565 sprites + 16kHz PCM WAV), <5s zero-reboot HTTP hot-reload, and pairing AI Buddy (ConvoAI) v1.1.0, PocketNote Standalone AI Recorder v2.0.0 (3 visual FX modes, local Whisper / BYOK live subtitles, SVG mindmap & Obsidian export), AgentHUD v2.4.1, and VoxDeck v1.1.1 with OpenGND Hub v3.0.4 (macOS & Windows).

SKU-01
Read Manual
DOC-04 // MECHANICAL & 3D CAD6 min read

SKU-02 Voice Base: Mechanical .STEP Datum, Acoustic Porting & .3MF Guide

Mechanical design rules for modeling custom 3D-printed shells around the OpenGND_BK7258_Core_Mount_v1.step acoustic module without degrading Hardware AEC voice barge-in.

SKU-02
Read Manual
DOC-05 // ARCHITECTURE & SPECS6 min read

Hardware Openness, Tier Classification & Ecosystem Compatibility Matrix

Transparent SKU-by-SKU breakdown of MCU architecture, openness boundary (Firmware Open vs. 3D Shell Open vs. Full-Stack Open), self-flashing interfaces, and smart-home integrations.

SKU-01SKU-02SKU-03SKU-04+6 more
Read Manual
DOC-06 // FIRMWARE & WEBOTA6 min read

Local LAN Protocols, BYOK AI Endpoints & Home Assistant Integration

Connect OpenGND devices to local Ollama instances, OpenAI-compatible gateways, and Home Assistant without routing voice or sensor data through third-party vendor clouds.

SKU-01SKU-02SKU-03SKU-05+1 more
Read Manual
DOC-07 // ARCHITECTURE & SPECS5 min read

Official Design & Color Token Specification (Light Default, Carbon Dark & Hardware CMF)

Unified OpenGND brand palette, dual-theme persistence (opengnd_theme_mode), [data-dark-lock="true"] hardware viewport lock, banned drift-color guardrails, and physical enclosure CMF material colors (#F2F0EB / #141518 / #FF5500).

SKU-01SKU-02SKU-08
Read Manual
DOC-08 // ARCHITECTURE & SPECS8 min read

Unified Device Config & Multi-Transport Sync Protocol (opengnd.device.config.v1)

Authoritative cross-client specification (V1.4.0) for opengnd.device.config.v1 across AgentHUD v2.4.1+ firmware (Stop completion voice trigger fix & 4 built-in neural voices/lang), OpenGND Cloud Relay, OpenGND Hub v3.0.4+, and Web (/configure & /console): covers 4 built-in neural voice presets (builtin:warm_female default), 3-tier Daily/Advanced/Developer UI grouping, 4-protocol transports, 5 rotary knob modes & 16-session newest-first 6-row windowed THREAD_LIST, ES8311 REG32 hardware dB volume calibration + 300ms live debounced sync, 8-language persona localization, 3-mode sound sources & per-scene rules, Cloud AI Sound/Voice Clone Studio, and OGND 4-bit IMA-ADPCM.

SKU-01
Read Manual