Website • Documentation • Forum • Discord
Borneo is a professional-grade, open-source ecosystem designed for aquarium enthusiasts and DIYers. It provides a complete end-to-end solution—from hardware schematics to embedded firmware and a modern mobile app—to build and control high-performance aquarium LED lighting systems.
This project delivers a full-stack solution for aquarium automation:
- 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.
- OSHWA Certified: Pro-grade designs (Model BLC06MK1) using Horizon EDA.
- High Performance: Optimized for ESP32/ESP32-C3/C5 with unified board definitions.
- Precision Dimming: 6-channel PWM with smooth 10-bit resolution and soft-start technology.
- Expandable: Reference designs for LED lamps, drivers, and even dosing pumps.
- Dynamic Control: Graphical sunrise/sunset curves with millisecond-smooth transitions.
- Reliable: SNTP time synchronization and PID-controlled active cooling system.
- Production Ready: Full support for over-the-air (OTA) updates and automated QA testing.1
- Extensible Architecture: Zephyr-inspired driver abstraction for easy porting and expansion.
- Cross-Platform: Modern UI built with Flutter for iOS, Android, and beyond.
- Unified Protocol: Uses CoAP + CBOR for efficient, low-latency device communication.
- Developer Friendly: Includes a Python API client for custom automation scripts.
| Directory | Content | Description |
|---|---|---|
hw/ |
Hardware | PCB designs (Horizon EDA), 3D models, and PDF schematics.2 |
fw/ |
Firmware | ESP-IDF source code for LED controllers and upcoming devices. |
client/ |
Mobile App | Flutter source code for the cross-platform mobile application. |
borneopy/ |
Python SDK | Python client library for desktop control and scripting. |
- New Users: Check out our Getting Started Guide.
- 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 | Beta | Full-featured and stable on my personal tanks for years. |
| Mobile App | Beta | Core functionality working. |
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.
The hardware, firmware, and App for this project were all created by: Wei Li（李维）.
