An IoT Runtime, Cloud Platform, Simulator, and Companion App
Build, test, and manage connected devices — without hardware dependencies.
📘 Master PRD • 🏗 Architecture • 📍 Roadmap
Status: Active Development (Alpha)
DeviceOS is an experimental IoT platform under active development. Core runtime, simulator, cloud backend, and dashboard are functional. Flutter companion app and real hardware support are in progress.
🎉 End-to-End Milestone Reached! (v0.2.0-beta)
The core infrastructure of DeviceOS is officially ALIVE! We have successfully engineered and verified the complete architecture: BLE Provisioning → Go Cloud Backend → WebSocket Streaming → Live Flutter Digital Twin. The Flutter App can mock ESP32 BLE provisioning to another phone, push telemetry via a Python edge simulator, and instantly render Live Digital Twin sparkline graphs.
Overall Completion: ~55-60%
| Phase | PRD Scope | Status | % |
|---|---|---|---|
| Phase 1: Foundation | HAL interfaces, BLE GATT provisioning, offline cache | ✅ HAL done, ✅ Offline cache done, |
~80% |
| Phase 2: Cloud Sync | Registry + Shadow API, state sync deltas, CLI commands | ✅ Registry/Shadow API done, ✅ State sync done, ✅ CLI commands implemented | ~85% |
| Phase 3: Rollouts & Management | Dual-partition OTA on ESP32, Next.js console, rules engine | ~50% | |
| Phase 4: Swarm & Matter | Matter/Thread, P2P mesh, edge AI warnings | ❌ 0% — Not started | 0% |
DeviceOS is a production-grade, hardware-independent IoT platform. It allows developers to design, simulate, provision, monitor, and manage connected devices before purchasing any physical hardware.
The platform is built around a core architectural principle:
Hardware is just another transport implementation.
Everything from the provisioning flow, device shadow, telemetry pipeline, and OTA engine runs identically whether backed by a software simulator today or an ESP32 tomorrow.
┌─────────────────────────────────────────────────┐
│ Flutter App │ (Companion)
└──────────────────────┬──────────────────────────┘
│ BLE GATT / HTTP (simulated)
┌──────────────────────▼──────────────────────────┐
│ ProvisioningTransport API │ (Abstraction Layer)
└──────────────────────┬──────────────────────────┘
│
┌─────────────┴─────────────┐
│ │
┌────────▼────────┐ ┌──────────▼──────────┐
│ Simulator │ │ ESP32 / Real HW │
│ (HTTP local) │ │ (BLE GATT) │
└────────┬────────┘ └──────────┬──────────┘
│ │
└─────────────┬─────────────┘
│ Wi-Fi / MQTT
┌──────────────────────▼──────────────────────────┐
│ Go Cloud Platform │
│ Device Registry · Shadow API · WebSocket Hub │
└──────────────────────┬──────────────────────────┘
│
┌──────────────────────▼──────────────────────────┐
│ Next.js Dashboard │
│ Fleet View · Provisioning · Live Telemetry │
└─────────────────────────────────────────────────┘
| Component | Technology | Status |
|---|---|---|
| C++ Runtime | C++17, CMake | ✅ Complete |
| Hardware Abstraction Layer | C++ Interfaces | ✅ Complete |
| Device Simulator | Go | ✅ Complete |
| Cloud Platform | Go, SQLite | ✅ Complete |
| Dashboard | Next.js 15, React | ✅ Complete |
| Provisioning Flow (E2E) | HTTP → State Machine | ✅ Complete |
| Device Shadow API | REST | ✅ Complete |
| OTA Engine (Core) | C++ | ✅ Complete |
| Automated Test Suite | Go test, Node.js | ✅ 18/18 passing |
| Flutter Companion App | Flutter 3 | 🚧 In Progress |
| CI/CD Pipeline | GitHub Actions | 🔜 Planned |
| Digital Twin | — | 🔜 Planned |
- Go 1.22+
- Node.js 20+
- CMake 3.20+ (for C++ runtime)
go run ./cloud/cmd/server
# → Listening on :8080cd dashboard
npm install
npm run dev
# → http://localhost:3000go run ./cli/cmd/deviceos simulate --devices 3
# → sim_dev_0001 advertising on port 9001
# → sim_dev_0002 advertising on port 9002
# → sim_dev_0003 advertising on port 9003Open http://localhost:3000 → BLE Provisioning → Enter port 9001 and credentials → Click Provision Device.
Watch the state machine execute:
BLE_ADVERTISING → PROVISIONING → [BLE OFF] → WIFI_CONNECTING
→ CLOUD_CONNECTING → SHADOW_SYNC → RUNNING
UNPROVISIONED
│
BLE_ADVERTISING ← HTTP server starts on port 900X (simulates BLE GATT)
│
PROVISIONING ← Waiting for Wi-Fi credentials from dashboard/app
│
[StopAdvertising] ← BLE intentionally shut down by FSM (not a crash)
│
WIFI_CONNECTING ← Simulates Wi-Fi join delay
│
CLOUD_CONNECTING ← Registers device with cloud registry
│
SHADOW_SYNC ← Pulls initial desired state
│
RUNNING ← Telemetry loop starts, publishes every 3-6s
Run the public end-to-end test suite:
# With all 3 services running:
node qa_test.jsResults: 18/18 tests passing
✅ Cloud :8080 reachable
✅ Dashboard :3000 serving
✅ Simulator ports 9001/9002/9003 listening
✅ CORS preflight returns correct headers
✅ Provision device → 200 OK
✅ Cloud shadow created after provisioning
✅ All 3 devices registered in cloud
✅ Wrong port → connection refused (expected)
✅ Invalid JSON → 400 (expected)
✅ Non-existent device → 404 (expected)
✅ Live telemetry: temperature changing between polls
DeviceOS has a private, multi-layer automated QA workflow running internally. This pipeline orchestrates:
- Layer 1 — Unit Tests: Go, Dart, and C++ unit tests run in isolation.
- Layer 2 — Integration Tests: Full stack spun up automatically; provisioning, shadow sync, and telemetry flows are tested end-to-end.
- Layer 3 — Regression Suite: BLE mock handshake, WebSocket live-stream, and device shadow delta verification run after every change.
- Layer 4 — Edge Simulation: A scripted Python agent simulates real ESP32 behavior and validates cloud responses.
The internal pipeline tooling and CI configuration are not open-sourced at this time. Contributors and collaborators may request access privately.
The simulator models realistic failure conditions:
| Failure | Behavior |
|---|---|
| Wi-Fi disconnect | Auto-reconnects via CLOUD_CONNECTING |
| Packet loss | Telemetry dropped, loop continues |
| Power cycle | Full reset to UNPROVISIONED |
| Cloud 409 (re-register) | Idempotent — INSERT OR IGNORE |
| Advertising timeout | Restart advertising cycle |
DeviceOS/
├── cloud/ # Go cloud platform (API, shadow, registry)
├── cli/ # Go CLI tool + simulator
│ └── simulator/ # State machine + BLE transport abstraction
├── dashboard/ # Next.js dashboard
├── runtime/ # C++ device runtime + HAL
├── sdk/ # C++ developer SDK
├── docs/ # Architecture Decision Records (ADRs)
└── tests/ # Integration tests
- v0.1.0-alpha — Simulation Platform MVP
- v0.2.0-beta — Flutter Companion App (BLE Provisioning + Live Digital Twin) 🎉
- v0.3.0 — Offline Rules Engine + Enterprise Dashboard
- v0.4.0 — Fleet Management + OTA Deployment Engine
- v1.0.0 — Real ESP32 Hardware Integration
MIT © 2026 Karan Chhunchha