Website • Documentation • Forum • Discord
If you would like to support this project, please consider purchasing a ready-to-use, pre-tested, pre-loaded firmware product from PCBWay Store:
Production-grade open-source stack for aquarium LED dimmers. Hardware designs, embedded firmware, and mobile controls. Ready for weekend builds or product integration.
This project delivers a full-stack solution for smart aquarium LED:
- Hardware: Certified open-source PCB designs targeting the ESP32 family, featuring 6-channel PWM dimming and modular architecture.
- Firmware: A robust ESP-IDF based firmware implementing CoAP/CBOR protocols, sunrise/sunset simulation, and cooling control.
- Mobile App: A cross-platform Flutter application for intuitive real-time control, scheduling, and device management.
New users: Follow the step-by-step guide to flash firmware and connect your first device.
No toolchain required, flash directly from Chrome/Edge Browser:
- Connect ESP32/ESP32-C3/ESP32-C5 via USB
- Visit flasher.borneoiot.com
- Download the app and power on
- 6 or 10 PWM channels, 12-bit resolution (4096 steps), up to 19kHz
- Flicker-free, suitable for aquarium photography
- 22×30mm core module, fits slim LED fixtures
- ESP32-C3/C5 native, WiFi + Bluetooth LE
- Sunrise/sunset curves with millisecond-smooth transitions
- SNTP time sync: automatic, no manual adjustment
- Active cooling control: temperature-based fan/PWM throttling
- OTA updates: over-the-air firmware upgrades
- CoAP + CBOR protocol: efficient, low-latency device communication
- Cross-platform: iOS, Android, Windows, built with Flutter
- Real-time control: dimming, scheduling, scene presets
- Multi-device: group control, cloud-free local network
- Developer API: Python client for automation
| Directory | Contents | Entry Point |
|---|---|---|
hw/ |
PCB designs (Horizon EDA), Gerbers, 3D models | hw/README.md |
fw/ |
ESP-IDF firmware, CoAP protocol | fw/README.md |
client/ |
Flutter mobile app | client/README.md |
borneopy/ |
Python client library | borneopy/README.md |
- New Users: Check out our Quick Start Guide.
- If you are a new user looking to quickly experience our firmware, you can directly use our web firmware flasher to flash the latest version of the firmware to your ESP32 series development board: https://flasher.borneoiot.com/
- Hardware: Find schematics and BoM files in the
hw/directory. - Firmware: Compilation instructions are available in the
fw/folder.
| Component | Status | Details |
|---|---|---|
| Hardware | Stable | Production-ready, OSHWA certified. |
| Firmware | Nearly Perfect | Full-featured and stable on personal tanks for years. |
| Mobile App | Nearly Perfect | Core functionality complete and ready for everyday use. |
Check our milestones for the latest development updates and upcoming features.
- Website: www.borneoiot.com
- Documentation: docs.borneoiot.com
- Discussions: Join the Conversation
- Discord: Connect with Developers
- Email: info@binarystarstech.com
- Software/Firmware: Dual-licensed under GPL-3.0+ and Enterprise licenses.
- Hardware: Licensed under CERN-OHL-S-2.0.
Copyright © 2025-TODAY Yunnan BinaryStars Technologies, Co., Ltd. All rights reserved.
The hardware, firmware, and App for this project were all created by: Wei Li（李维）.