ESP32 搭建 Zigbee 光照传感器Arduino 10分钟零基础上手【免费下载链接】arduino-esp32Arduino core for the ESP32 family of SoCs项目地址: https://gitcode.com/GitHub_Trending/ar/arduino-esp32把窗台上的小光敏元件变成智能家居里天黑自动开灯的判断依据。用 ESP32-C6/H2 配合 arduino-esp32 官方核心里的 Zigbee 库一个能自己找到网关、定期上报亮度的无线传感器就这么做出来——不用懂协议栈细节成品功耗低到电池能撑很久。先看成品一块会自己上报亮度的小节点做完后你得到什么一块上电就自动寻找 Zigbee 网络的终端设备End Device人话不占网络管理权、随时可以睡大觉的从属设备每秒采样一次环境光换算成行业通用的Zigbee 照度原始值上报给协调器Coordinator人话Zigbee 网络的网管通常就是家里那个网关按下 BOOT 键 3 秒可一键清除配网信息重来整件事需要的物料不超过 4 样熟练后 10 分钟内可烧录跑通。动手前准备物料清单与接线部件选什么为什么是它主控ESP32-C6 或 ESP32-H2 开发板这两颗芯片原生带 802.15.4 射频官方示例只认这两个目标传感器光敏电阻如 GL5528 10KΩ 电阻便宜、模拟输出阻值随光照变化分压后直接喂给 ADC供电MicroUSB 5V 线开发阶段最省事部署时再换电池方案网关任何 Zigbee 3.0 协调器传感器必须挂在一个已存在的网络里接线只有三根光敏电阻搭成分压结构3V3 ──┬── 光敏电阻 ──┬── GPIO6 GND ──┴── 10KΩ 电阻 ──┘GPIO6 读到的分压值随光照线性变化10KΩ 负责把信号拉回 3.3V 以内别省略。如何配置 Arduino IDE 并烧录固件首选项里追加开发板管理器网址然后在 Boards Manager 搜 esp32 安装。完成标志搜索框输入 esp32 后能看到 Espressif 的包如下所示工具菜单做四处选择开发板选 ESP32C6 Dev Module或 H2Zigbee mode 必须选Zigbee ED (end device)Partition Scheme 选Zigbee 4MB with spiffsUSB CDC On Boot 设 Enabled。完成标志编译不报错。模式选错时示例代码里有一道#error守卫编译会直接失败并提示未选择终端设备模式——这是好事它替你拦住了最常见的错配。打开 示例代码把illuminance_sensor_pin改成你实际接的引脚示例默认 6上传。完成标志串口115200出现Zigbee started successfully!接着刷出一串.说明栈起来了、正在找网。示例的完整说明在 README排错章节值得一读。三段要弄懂的代码设备初始化给光照端点上户口Zigbee 设备靠端点Endpoint对外暴露功能。不先把端点注册进核心再启动后面所有上报都无处安放所以顺序是配置属性 → addEndpoint → begin。zbIlluminanceSensor.setManufacturerAndModel(Espressif, IlluminanceSensor); zbIlluminanceSensor.setPowerSource(ZB_POWER_SOURCE_MAINS); zbIlluminanceSensor.setMinMaxValue(0, 50000); Zigbee.addEndpoint(zbIlluminanceSensor); Zigbee.begin();量程 0–50000 是照度测量集群的惯用区间begin()返回 false 时示例会直接重启自救。光照读取与照度转换12 位 ADC 读数是 0–4095和 Zigbee 照度量纲不是一回事中间要做一次映射int adc analogRead(6); int zbRaw map(adc, 0, 4095, 0, 50000); zbIlluminanceSensor.setIlluminance(zbRaw);注意上报的是zbRaw而不是 lux——ZCL 协议规定传原始值换算留给网关侧做。示例把这段包进一个 FreeRTOS 任务里每秒跑一次xTaskCreate那行就不展开了照抄即可。低功耗上报策略终端设备省功耗的核心是别废话zbIlluminanceSensor.setReporting(1, 0, 1000);含义值变化超过 1000 才允许上报且最快 1 秒一次、无周期上限。光线几乎不变时设备基本在安静地睡觉。另外示例里按住 BOOT 键 3 秒触发Zigbee.factoryReset()清干净再入网后面排错会用到。如何完成入网确认方法与 3 个高频故障确认成功的标准串口先打Zigbee started successfully!然后连打.正在搜网.停止、日志里出现加入网络成功的信息及设备短地址后开始周期性打印 raw analog value 与 lux 行——此时网关侧如 Zigbee2MQTT 控制台也应看到新设备注册。三个最常见的翻车点按出现频率排Zigbee 模式没选 ED——编译期就会被#error拦下改选项即可。协调器网络是关的——协调器重启后默认关闭入网需要在协调器侧开放网络反过来如果终端设备反复入网失败按 README 排错章节 的建议烧录前勾选Erase All Flash Before Sketch Upload清掉残留网络信息。供电或线材问题——串口毫无输出、板子 LED 不亮优先换一根带数据线的 USB 线再降一档串口速度重试。照度换算原理以及数据如何进家庭自动化网关拿到zbRaw后按 ZCL 规范换算成 lux。先给个直觉zbRaw 10000对应大约 9 lux正好是昏暗走廊的量级zbRaw 50000则逼近 10 万 lux接近正午直射阳光。背后的公式是lux 10 ^ (zbRaw / 10000) - 1指数型刻度是因为人眼对亮度本身就是对数感知。示例注释里还提了一嘴Zigbee2MQTT 实际用的是不带-1的版本两边数值会差 1自动化阈值不用纠结这个量级。接入平台最短路径跑一个 Zigbee2MQTT或 Home Assistant ZHA对接你的协调器设备入网后自动识别为 illuminance 实体在自动化里写lux 低于某阈值 → 开灯即可闭环。协议层细节可查 docs 里的照度端点文档。收尾收益与下一步 一块几块钱的板子 光敏电阻换来一个低功耗、可自组网、直接进家庭自动化的光照节点。接下来值得玩的方向抄 Zigbee_Temp_Hum_Sensor_Sleepy 的睡眠机制把上报间隔拉长吃满电池寿命换 BH1750 数字光传感器走 I2C摆脱分压校准的玄学用 espota.py 给设备加 OTA批量部署时不用一块块插线API 细节以 Zigbee.h 里的注释为准踩坑了翻官方示例目录比翻手册快。【免费下载链接】arduino-esp32Arduino core for the ESP32 family of SoCs项目地址: https://gitcode.com/GitHub_Trending/ar/arduino-esp32创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 ESP32 搭建 Zigbee 光照传感器：Arduino 10分钟零基础上手
ESP32 搭建 Zigbee 光照传感器Arduino 10分钟零基础上手【免费下载链接】arduino-esp32Arduino core for the ESP32 family of SoCs项目地址: https://gitcode.com/GitHub_Trending/ar/arduino-esp32把窗台上的小光敏元件变成智能家居里天黑自动开灯的判断依据。用 ESP32-C6/H2 配合 arduino-esp32 官方核心里的 Zigbee 库一个能自己找到网关、定期上报亮度的无线传感器就这么做出来——不用懂协议栈细节成品功耗低到电池能撑很久。先看成品一块会自己上报亮度的小节点做完后你得到什么一块上电就自动寻找 Zigbee 网络的终端设备End Device人话不占网络管理权、随时可以睡大觉的从属设备每秒采样一次环境光换算成行业通用的Zigbee 照度原始值上报给协调器Coordinator人话Zigbee 网络的网管通常就是家里那个网关按下 BOOT 键 3 秒可一键清除配网信息重来整件事需要的物料不超过 4 样熟练后 10 分钟内可烧录跑通。动手前准备物料清单与接线部件选什么为什么是它主控ESP32-C6 或 ESP32-H2 开发板这两颗芯片原生带 802.15.4 射频官方示例只认这两个目标传感器光敏电阻如 GL5528 10KΩ 电阻便宜、模拟输出阻值随光照变化分压后直接喂给 ADC供电MicroUSB 5V 线开发阶段最省事部署时再换电池方案网关任何 Zigbee 3.0 协调器传感器必须挂在一个已存在的网络里接线只有三根光敏电阻搭成分压结构3V3 ──┬── 光敏电阻 ──┬── GPIO6 GND ──┴── 10KΩ 电阻 ──┘GPIO6 读到的分压值随光照线性变化10KΩ 负责把信号拉回 3.3V 以内别省略。如何配置 Arduino IDE 并烧录固件首选项里追加开发板管理器网址然后在 Boards Manager 搜 esp32 安装。完成标志搜索框输入 esp32 后能看到 Espressif 的包如下所示工具菜单做四处选择开发板选 ESP32C6 Dev Module或 H2Zigbee mode 必须选Zigbee ED (end device)Partition Scheme 选Zigbee 4MB with spiffsUSB CDC On Boot 设 Enabled。完成标志编译不报错。模式选错时示例代码里有一道#error守卫编译会直接失败并提示未选择终端设备模式——这是好事它替你拦住了最常见的错配。打开 示例代码把illuminance_sensor_pin改成你实际接的引脚示例默认 6上传。完成标志串口115200出现Zigbee started successfully!接着刷出一串.说明栈起来了、正在找网。示例的完整说明在 README排错章节值得一读。三段要弄懂的代码设备初始化给光照端点上户口Zigbee 设备靠端点Endpoint对外暴露功能。不先把端点注册进核心再启动后面所有上报都无处安放所以顺序是配置属性 → addEndpoint → begin。zbIlluminanceSensor.setManufacturerAndModel(Espressif, IlluminanceSensor); zbIlluminanceSensor.setPowerSource(ZB_POWER_SOURCE_MAINS); zbIlluminanceSensor.setMinMaxValue(0, 50000); Zigbee.addEndpoint(zbIlluminanceSensor); Zigbee.begin();量程 0–50000 是照度测量集群的惯用区间begin()返回 false 时示例会直接重启自救。光照读取与照度转换12 位 ADC 读数是 0–4095和 Zigbee 照度量纲不是一回事中间要做一次映射int adc analogRead(6); int zbRaw map(adc, 0, 4095, 0, 50000); zbIlluminanceSensor.setIlluminance(zbRaw);注意上报的是zbRaw而不是 lux——ZCL 协议规定传原始值换算留给网关侧做。示例把这段包进一个 FreeRTOS 任务里每秒跑一次xTaskCreate那行就不展开了照抄即可。低功耗上报策略终端设备省功耗的核心是别废话zbIlluminanceSensor.setReporting(1, 0, 1000);含义值变化超过 1000 才允许上报且最快 1 秒一次、无周期上限。光线几乎不变时设备基本在安静地睡觉。另外示例里按住 BOOT 键 3 秒触发Zigbee.factoryReset()清干净再入网后面排错会用到。如何完成入网确认方法与 3 个高频故障确认成功的标准串口先打Zigbee started successfully!然后连打.正在搜网.停止、日志里出现加入网络成功的信息及设备短地址后开始周期性打印 raw analog value 与 lux 行——此时网关侧如 Zigbee2MQTT 控制台也应看到新设备注册。三个最常见的翻车点按出现频率排Zigbee 模式没选 ED——编译期就会被#error拦下改选项即可。协调器网络是关的——协调器重启后默认关闭入网需要在协调器侧开放网络反过来如果终端设备反复入网失败按 README 排错章节 的建议烧录前勾选Erase All Flash Before Sketch Upload清掉残留网络信息。供电或线材问题——串口毫无输出、板子 LED 不亮优先换一根带数据线的 USB 线再降一档串口速度重试。照度换算原理以及数据如何进家庭自动化网关拿到zbRaw后按 ZCL 规范换算成 lux。先给个直觉zbRaw 10000对应大约 9 lux正好是昏暗走廊的量级zbRaw 50000则逼近 10 万 lux接近正午直射阳光。背后的公式是lux 10 ^ (zbRaw / 10000) - 1指数型刻度是因为人眼对亮度本身就是对数感知。示例注释里还提了一嘴Zigbee2MQTT 实际用的是不带-1的版本两边数值会差 1自动化阈值不用纠结这个量级。接入平台最短路径跑一个 Zigbee2MQTT或 Home Assistant ZHA对接你的协调器设备入网后自动识别为 illuminance 实体在自动化里写lux 低于某阈值 → 开灯即可闭环。协议层细节可查 docs 里的照度端点文档。收尾收益与下一步 一块几块钱的板子 光敏电阻换来一个低功耗、可自组网、直接进家庭自动化的光照节点。接下来值得玩的方向抄 Zigbee_Temp_Hum_Sensor_Sleepy 的睡眠机制把上报间隔拉长吃满电池寿命换 BH1750 数字光传感器走 I2C摆脱分压校准的玄学用 espota.py 给设备加 OTA批量部署时不用一块块插线API 细节以 Zigbee.h 里的注释为准踩坑了翻官方示例目录比翻手册快。【免费下载链接】arduino-esp32Arduino core for the ESP32 family of SoCs项目地址: https://gitcode.com/GitHub_Trending/ar/arduino-esp32创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考