BorneoIoT 专业水族照明平台 borneo

ESP32 1/5 已发布
borneo-iot 74 Stars GPL-3.0 BOM 完整度: 0/5 教程完整度: 0/5
BorneoIoT 专业水族照明平台

项目简介

The world's most advanced open-source aquarium LED PWM controller & mobile app.


BorneoIoT 是一个面向专业水族箱照明场景的开源全栈平台,旨在为 DIY 爱好者、小型厂商和水族玩家提供一套生产级的智能 LED 调光解决方案。该项目从硬件设计、嵌入式固件到移动端控制应用均完全开源,解决了传统水族灯具控制方式单一、缺乏自动化调度以及难以与智能家居生态整合的痛点。

标签

项目特点

**开源硬件**:OSHWA 认证的 PCB 设计,6 或 10 通道 PWM,12 位分辨率,无闪烁调光
**强大固件**:基于 ESP-IDF,支持日出日落平滑过渡、SNTP 自动时间同步、主动散热控制、OTA 升级
**跨平台 App**:Flutter 构建,支持 iOS、Android、Windows,提供实时控制、日程编排、场景预设
**高效协议**:CoAP + CBOR 通信,低延迟、高效率
**开发者友好**:提供 Python SDK(borneopy)用于自动化控制
**无需云服务**:本地网络控制,保护隐私

技术规格

PWM 通道数 6 或 10
PWM 分辨率 12-bit (4096 步)
PWM 频率 最高 19kHz
核心模块尺寸 22×30mm
主控芯片 ESP32-C3 / ESP32-C5
无线连接 WiFi + Bluetooth LE
通信协议 CoAP + CBOR
时间同步 SNTP(自动)
固件升级 OTA(空中升级)
移动端支持 iOS, Android, Windows
硬件认证 OSHWA CN000017

项目资源

物料清单 (BOM)

物料名称 数量 参考价格 备注
ESP32-C3 或 ESP32-C5 模组 1 核心模块
6/10 通道 PWM 调光板 1 见 hw/ 目录
12V/24V LED 驱动电源 1 根据 LED 灯珠规格选择
接线端子 若干 用于连接 LED 灯珠和电源
散热片/风扇 1 可选,用于主动散热
3D 打印外壳 1 可选,见 hw/ 目录中的 3D 模型

3D 模型

模型名称文件名文件
BLC06MK1R4-H BLC06MK1R4-H.step
BLC06MK1R4 BLC06MK1R4.step
BLC06MK1R4_no-pinheader BLC06MK1R4_no-pinheader.step
PinHeader_1x06_P2.54mm_Vertical PinHeader_1x06_P2.54mm_Vertical.step
SOIC-8_3.9x4.9mm_P1.27mm SOIC-8_3.9x4.9mm_P1.27mm.step
SOT-223 SOT-223.step
SOT-23 SOT-23.step
C_1206_3216Metric C_1206_3216Metric.step
R_1206_3216Metric R_1206_3216Metric.step
DC-001-A-2.1mm-R DC-001-A-2.1mm-R.STEP
WJ15EDGRM-3.81-06P WJ15EDGRM-3.81-06P.step
PhoenixContact_MC_1,5_3-G-3.81_1x03_P3.81mm_Horizontal PhoenixContact_MC_1,5_3-G-3.81_1x03_P3.81mm_Horizontal.step
SOIC-8_3.9x4.9mm_P1.27mm SOIC-8_3.9x4.9mm_P1.27mm.step
K2-1109SE-I4SW-04 K2-1109SE-I4SW-04.step
ESP32-C3-WROOM-02 ESP32-C3-WROOM-02.STEP
ESP32-C3-WROOM-02U ESP32-C3-WROOM-02U.step
D_SMA D_SMA.step
SOT-23-5 SOT-23-5.step
C_0603_1608Metric C_0603_1608Metric.step
C_1206_3216Metric C_1206_3216Metric.step
R_0805_2012Metric R_0805_2012Metric.step
R_1206_3216Metric R_1206_3216Metric.step
2510_4p_smd_horizontal 2510_4p_smd_horizontal.step
S2B-PH-SM4-TB_LF__SN_ S2B-PH-SM4-TB_LF__SN_.step
S4B-PH-SM4-TB_LF__SN_ S4B-PH-SM4-TB_LF__SN_.step
PinHeader_2x07_P2.54mm_Horizontal PinHeader_2x07_P2.54mm_Horizontal.step
2060-452_998-404 2060-452_998-404.step
TS34031 TS34031.step
SOT-89-5 SOT-89-5.step
SSOP-8_3.9x5.05mm_P1.27mm SSOP-8_3.9x5.05mm_P1.27mm.step
K2-1109SE-I4SW-04 K2-1109SE-I4SW-04.step
bld06-r1-3d-package bld06-r1-3d-package.step
LED_SMDLED_1W_3W_R8-3DModel LED_SMDLED_1W_3W_R8-3DModel.step
LED_SMDLED_RGB_3W-3DModel LED_SMDLED_RGB_3W-3DModel.step
C_0603_1608Metric-HD C_0603_1608Metric-HD.step
CP_Elec_6.3x7.7 CP_Elec_6.3x7.7.step
01550900M 01550900M.step
L_Changjiang_FNR4030S L_Changjiang_FNR4030S.step
L_TDK_SLF10145 L_TDK_SLF10145.step
Jump_0R0_8.2x1.5-Part Jump_0R0_8.2x1.5-Part.step
Jumper_0R0_10.2x1.5mm Jumper_0R0_10.2x1.5mm.step
D_SMA D_SMA.step
SOT-23-5 SOT-23-5.step
C_0603_1608Metric C_0603_1608Metric.step
C_1206_3216Metric C_1206_3216Metric.step
R_0402_1005Metric R_0402_1005Metric.step
R_0603_1608Metric R_0603_1608Metric.step
R_0805_2012Metric R_0805_2012Metric.step
R_1206_3216Metric R_1206_3216Metric.step
2510_4p_smd_horizontal 2510_4p_smd_horizontal.step
GitHub 仓库 master

能力画像

⚪ 记忆与知识检索: 1/5
🔵 逻辑推演: 2/5
⚪ 表达与交流: 1/5
⚪ 感知与观察: 2/5
🔵 数理与计算: 2/5
🔵 动手与操作: 3/5
⚪ 狂热与坚持: 2/5
⚪ 创造与创新: 2/5

所需技能

🔧 **动手能力**:需要基本的焊接和电子组装能力,能够连接 LED 灯珠、电源和 ESP32 模块 💻 **编程能力**:无需编程即可使用,但如需自定义固件或使用 Python SDK,需要一定的嵌入式或 Python 编程经验 ⚡ **电子电路**:需要理解 PWM 调光原理、LED 驱动电路和基本的电路调试知识

适用场景

水族箱 LED 照明智能控制,实现日出日落模拟
水族摄影无闪烁照明
多组 LED 灯珠独立调光,创造复杂光照场景
通过手机 App 远程控制水族箱灯光
作为开源 IoT 调光器平台进行二次开发或产品集成