title: 家庭开关  
date: 2025-09-23T11:06:21+08:00  
lastmod: 2026-05-31T17:03:00+08:00

家庭开关（HomeSwitch）

基于 CC2530 的 Zigbee 无线开关面板，支持 3 个独立按钮控制。

硬件特性

• 主控：CC2530

• 按键：3 个独立按钮

  • SW1 — P0_2（对应 Endpoint 1）
  • SW2 — P0_3（对应 Endpoint 2）
  • SW3 — P1_6（对应 Endpoint 3）

• 供电：电池供电（CR2032 / 2xAA / 2xAAA，或 LDO 稳压供电）

• 功耗：超低功耗设计，无 LED

功能

• 3 个独立 Endpoint，每个按钮对应一个，可独立绑定控制不同的 Zigbee 设备
• 短按发送 OnOff Toggle 命令（通过 Binding Table 间接寻址，无需协调器参与）
• 长按 5 秒启动 Network Steering 入网/恢复网络流程
• 上电不自动入网，已入网设备更换电池后通过 NV 自动恢复网络信息
• 动态轮询率省电策略：入网或长按触发 Network Steering 后，自动进入 1 秒 fast poll 维持 10 分钟（便于 zigbee2mqtt 面试和绑定），之后自动切换为 60 秒 slow poll 以降低功耗
• 入网延迟上报电池信息：设备加入网络后延迟 15 秒上报电池电压/百分比（等协调器 interview 完成后再上报），并同步上报 BatterySize、BatteryQuantity、BatteryRatedVoltage、BatteryPercentMinThres 配置
• 6 小时周期性电池检测与上报：上报 BatteryVoltage、BatteryPercentageRemaining、BatteryAlarmState
• 电池信息完全通过 ZCL 标准 Power Config Cluster 属性上报
• 支持 ZCL Write 配置电池型号、数量、额定电压及低电量报警阈值
• 低电量报警通过标准 BatteryAlarmState 属性暴露
• 软件版本自动暴露：ApplicationVersion / SWBuildID / DateCode

硬件图纸

PCB_PCB_iot_board_SwitchEndV3_2025-09-23.pdf

SCH_iot_board_SwitchEndV3_2025-09-23.pdf

固件下载

HomeSwitch.hex（EndDevice 节点，Flash 167.6 KB / RAM 5.5 KB）