{"id":24426135,"url":"https://github.com/oldrev/borneo","last_synced_at":"2025-04-12T08:33:58.301Z","repository":{"id":272400998,"uuid":"878313137","full_name":"oldrev/borneo","owner":"oldrev","description":"The ultimate open-source aquarium LED","archived":false,"fork":false,"pushed_at":"2025-03-21T15:36:54.000Z","size":27300,"stargazers_count":36,"open_issues_count":2,"forks_count":4,"subscribers_count":4,"default_branch":"master","last_synced_at":"2025-03-26T03:41:38.023Z","etag":null,"topics":["aquarium","aquarium-controller","clang","dart","electronics","embedded","esp-idf","esp32","flutter","open-hardware"],"latest_commit_sha":null,"homepage":"https://www.borneoiot.com","language":"Dart","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/oldrev.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":".github/CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":".github/CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-10-25T06:51:05.000Z","updated_at":"2025-03-21T15:36:59.000Z","dependencies_parsed_at":"2025-03-09T09:28:25.809Z","dependency_job_id":null,"html_url":"https://github.com/oldrev/borneo","commit_stats":null,"previous_names":["oldrev/borneo"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/oldrev%2Fborneo","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/oldrev%2Fborneo/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/oldrev%2Fborneo/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/oldrev%2Fborneo/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/oldrev","download_url":"https://codeload.github.com/oldrev/borneo/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248540678,"owners_count":21121399,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["aquarium","aquarium-controller","clang","dart","electronics","embedded","esp-idf","esp32","flutter","open-hardware"],"created_at":"2025-01-20T11:16:06.073Z","updated_at":"2025-04-12T08:33:58.294Z","avatar_url":"https://github.com/oldrev.png","language":"Dart","funding_links":["https://ko-fi.com/O5O2U4W4E'","https://www.paypal.me/oldrev"],"categories":[],"sub_categories":[],"readme":"# A Based Open Source WiFi Aquarium LED DIY Kit\n\n![Firmware Build Status](https://github.com/oldrev/borneo/actions/workflows/fw-ci.yml/badge.svg)\n![App Build Status](https://github.com/oldrev/borneo/actions/workflows/flutter-ci.yml/badge.svg)\n\n![BorneoIoT Banner](assets/borneo-repo-banner.jpg)\n\n\u003cp align=\"center\"\u003e\n    \u003ca href=\"https://www.borneoiot.com\"\u003e\u003cb\u003eWebsite\u003c/b\u003e\u003c/a\u003e •\n    \u003ca href=\"https://docs.borneoiot.com\"\u003e\u003cb\u003eDocumentation\u003c/b\u003e\u003c/a\u003e •\n    \u003ca href=\"https://github.com/oldrev/borneo/discussions\"\u003e\u003cb\u003eForum\u003c/b\u003e\u003c/a\u003e •\n    \u003ca href=\"https://discord.gg/EFJTm7PpEs\"\u003e\u003cb\u003eDiscord\u003c/b\u003e\u003c/a\u003e\n\u003c/p\u003e\n\n\n---\n\nThe Borneo-IoT Project offers cutting-edge, open-source, modular, and affordable hardware and software solutions for hobbyists and professionals to create aquarium LEDs and other smart aquatic devices.\n\n\nFor more information, please visit the project's website: [www.borneoiot.com](https://www.borneoiot.com).\n\nPDF versions of the hardware schematics, datasheets and BoM can be found in [`hw/datasheets`](hw/datasheets).\n\nIf you like this project, please don't forget to give it a star. Thank you!\n\nThe Buce (Model BLC06MK1) LED PWM dimmer in this project is an [OSHWA (Open Source Hardware Association)](https://www.oshwa.org) certificated open-hardware:\n\n[![BLC06MK1](assets/buce-oshwa.png)](https://certification.oshwa.org/cn000017.html)\n\n## Features\n\n- **Full Stack Open Source**\n    - PCB design (schematic and board layout) using [Horizon EDA](https://horizon-eda.org)\n    - Firmware based on [ESP-IDF](https://idf.espressif.com/) framework\n    - Flutter mobile app\n\n- **Modular Hardware Design**\n    - Compact core board (22×30mm) for easy integration\n    - Reference schematics for custom PCB implementations\n\n- **Component-based Firmware**\n    - Multi-ESP32 family support (ESP32/ESP32-C3/C5) via unified board definitions\n    - Zephyr RTOS-like driver architecture with hardware abstraction\n    - CoAP + CBOR protocol stack for multi-device support (lamps, pumps, sensors)\n\n- **Rich Functionality**\n    - 6-channel PWM dimmer with zero peripheral components\n    - Graphical sunrise/sunset dimming with soft-start\n    - SNTP time sync \u0026 PID-controlled cooling\n    - Python API client \u0026 demo scripts\n    - Optional INA139 current monitoring\n\n- **Cost-effective Solution**\n    - ESP32-C3/ESP32 MCUs with standard components\n    - Integrated driver for basic/PWM cooling fans\n    - Pin-header friendly for DIY integration\n\n- **Production-ready System**[^1]\n    - Wireless OTA firmware updates\n    - Automated production tools:\n        - Batch programming \u0026 QA testing\n        - Product parameter configuration\n\n- **Field-proven**\n    - The prototype of this dimmer and LED driver has been running stably on my own planted tank for years\n    - Extensible architecture (ongoing pump/pH monitor development)\n\n[^1]: The open-source project does not provide mass production-related fixtures and software.\n\n## Demo Pictures \u0026 Videos\n\n### Demo Short Video:\n\n[![YouTube](http://i.ytimg.com/vi/Z78nOzLQvq0/hqdefault.jpg)](https://www.youtube.com/watch?v=Z78nOzLQvq0)\n\n### Pictures\n\n| ![BLC06MK1](assets/blc06mk1-shot1.jpg) \u003cbr/\u003e LED Dimmer Module Appearance | ![BLC05MK3-SCH](assets/blc05mk3-sch.png) \u003cbr/\u003e LED LED Dimmer Module Schematic |\n|------------------------------------------|------------------------------------------ |\n| ![BLB08103 Board](assets/blc05mk3-old-prototype.jpg) \u003cbr/\u003e 5-Channel LED Dimmer - Obsoleted Prototype | ![BLB08103 Old Board](assets/blb08103-old-prototype.jpg) \u003cbr/\u003e Aluminum PCB - Obsoleted Prototype |\n| ![BLB08103 Board](assets/blb08103.jpg) \u003cbr/\u003e Aluminum PCB Appearance | ![BLB08103 Case](assets/blb08103-case.jpg) \u003cbr/\u003e Reference Design Lamp Appearance[^2] |\n\n\n[^2]: The enclosure was manually measured and modeled by me after purchasing it from a friend, therefore, I regret that the design cannot be made public. If there is significant interest, I can redesign it.\n\n## Project Status\n\n### Hardware \u0026 Firmware\n\n**Beta**：The firmware is full functionality and stability, but some minor features are still not quite perfect.\n\n### Mobile App\n\n**Pre-Beta**：All major functions have been completed and are operational, but minor functions such as setting the time zone still need to be implemented, and the stability also requires further polishing.\n\n## Roadmap\n\nCheckout the [milestones](https://github.com/oldrev/borneo/milestones) to get a glimpse of the upcoming features and milestones.\n\n## Directory Structure\n\n- `client/`: Mobile app source code\n- `borneopy/`: A open-source Python client library for the devices under the Borneo-IoT Project\n- `fw/`: Firmware source code\n    - `scripts`: Related Python scripts\n    - `cmake`: CMake scripts\n    - `components`: Common ESP-IDF component source code\n    - `lyfi`: LED dimmer firmware-related source code\n    - `doser`: Dosing pump firmware-related source code (under development)\n- `hw/`: Circuit design source files\n    - `blc06`: The board design of Buce, the 6-channel WiFi LED PWM dimmer\n    - `blb0657f`: 6-channel 57W LED lamp aluminum PCB design\n    - `bld6f`: 6-channel LED driver PCB design\n    - `blc05mk3`: 5-channel LED driver PCB design (*Obsoleted*)\n    - `blb08103`: 5-channel 63W LED lamp aluminum PCB design (*Obsoleted*)\n    - `3d-models`: STEP format 3D models\n    - `datasheets`: The hardware specifications in PDF format[^3]\n- `tools/`: Related scripts and tools\n\n[^3]: Since the datasheets are based on templates from my other products, the source file will not be provided in this repository.\n\n## Getting Started\n\nPlease check out the [online documentation](https://docs.borneoiot.com/getting-started).\n\n## Contribution\n\nPlease read [CONTRIBUTING.md](.github/CONTRIBUTING.md) for more details.\n\nIf you want to support the development of this project, you could consider buying me a beer.\n\n\u003ca href='https://ko-fi.com/O5O2U4W4E' target='_blank'\u003e\u003cimg height='36' style='border:0px;height:36px;' src='https://storage.ko-fi.com/cdn/kofi3.png?v=3' border='0' alt='Buy Me a Coffee at ko-fi.com' /\u003e\u003c/a\u003e\n\n[![Support via PayPal.me](assets/paypal_button.svg)](https://www.paypal.me/oldrev)\n\n## Issues, Feedback \u0026 Support\n\nWe welcome your feedback! If you encounter any issues or have suggestions, please open an [issue](https://github.com/oldrev/borneo/issues).\n\n- Website：[www.borneoiot.com](https://www.borneoiot.com)\n- Online documentation：[docs.borneoiot.com](https://docs.borneoiot.com)\n- GutHub Discussions: [github.com/oldrev/borneo/discussions](https://github.com/oldrev/borneo/discussions)\n- Author's e-mail: [oldrev@gmail.com](mailto:oldrev@gmail.com)\n- Borneo-IoT Discord Server: [discord.gg/EFJTm7PpEs](https://discord.gg/EFJTm7PpEs)\n\n## License\n\n\n### Software \u0026 Firmware\n\nThe software and firmware in this project is dual-licensed under the GNU General Public License version 3 or later (GPL-3.0+) and a proprietary license. You can find the full text of the GPL-3.0 license in the [LICENSE](LICENSE) file.\n\n### Hardware\n\nThe hardware design in this project is licensed under the CERN Open Hardware Licence Version 2 - Strongly Reciprocal (CERN-OHL-S-2.0). You can find the full text of the license in the [LICENSE-HARDWARE](LICENSE-HARDWARE) file.\n\n#### Proprietary Licensing\n\nIn addition to the GPL-3.0 license, I also offer proprietary licensing options for those who wish to use this software in proprietary products.\n\nIf you are interested in obtaining a proprietary license, please contact me at [oldrev@gmail.com](mailto:oldrev@gmail.com).\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Foldrev%2Fborneo","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Foldrev%2Fborneo","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Foldrev%2Fborneo/lists"}