电池设备的环境光传感器：IRQ、单次采样与低功耗取舍
在电池供电设备里，环境光传感器通常只需要偶尔提供一个 lux 值。此时“传感器带 IRQ”并不代表 IRQ 一定比定时读取省电。真正决定功耗的是：等待 IRQ 时传感器处于什么模式、转换期间 MCU 能否休眠，以及业务究竟需要周期数据还是实时阈值事件。 先确认 IRQ 的真实语义环境光传感器常见的 IRQ 至少有两种： Data Ready IRQ：一次转换完成后通知 MCU 读取结果； Threshold IRQ：光照超过...
Zigbee 第三方平台适配：ZHA、Z2M 与 SmartThings 的统一方法
同一台 Zigbee 设备在 ZHA、Zigbee2MQTT 和 SmartThings 中可能需要三套适配代码，但协议事实应该只有一份。高质量兼容工作的关键，是先建立产品中立的 Zigbee 行为矩阵，再把它映射到各平台的数据模型。 三个平台分别在做什么 平台 适配载体 主要语言 平台输出 ZHA Device Handler / Quirk Python Home Assistant Entity、De...
ZHA 第三方设备兼容：用 V2 Quirk 精确匹配和映射实体
ZHA Quirk 是 Zigpy 与 Home Assistant 之间的设备适配层。它适合修正非标准描述符、补充厂商 Cluster，或把已有 Zigbee 属性映射成正确的 Home Assistant Entity。 Quirk 的边界一个 Quirk 通常包含： Matcher：识别 Manufacturer、Model 和可选的设备条件； Cluster modification：增加、移除或替换 Cluster...
Zigbee2MQTT 第三方设备兼容：External Converter 开发与验证
Zigbee2MQTT 使用 zigbee-herdsman-converters 把 Zigbee 消息转换成 MQTT 状态和命令。External Converter 可以在不修改正式安装包的情况下开发和验证新设备支持。 开始前先做三件事 检查设备是否已在 Zigbee2MQTT 开发分支获得支持； 把日志级别设为 Debug； 完成设备 interview，并保存 Endpoint、Cluster 与 Basic 信息...
SmartThings Zigbee 第三方设备兼容：Edge Driver 的匹配、映射与测试
SmartThings Edge Driver 在 Hub 本地运行，用 Lua 把 Zigbee 设备行为转换成 SmartThings Capability。兼容工作的核心不是写很多 Handler，而是让 fingerprint、profile、默认处理和设备差异保持一致。 Driver 目录结构一个 Zigbee Edge Driver 通常包含： 1234567891011zigbee-example/├── con...
Zigbee 基础概念：从无线帧到 Endpoint 与 Cluster
理解 Zigbee 最有效的方法，不是先背命令，而是把“无线、组网、传输、设备管理、应用功能”分层。这样看日志或抓包时，才能知道一条成功信息究竟证明了哪一步。 协议栈分层1234567891011应用逻辑 │ZCL：Cluster、Attribute、Command │ZDO / ZDP：设备与服务发现、网络管理 │APS：应用数据传输、绑定、组寻址、应用层安全 │NWK：组网、路由、网络地址、网络层安全 │IEEE...
Zigbee 入网流程：从 Network Steering 到可用设备
“设备已经入网”经常被过早下结论。扫描到网络、拿到短地址、收到 Network Key、完成 Trust Center Link Key 交换和网关识别出应用能力，是不同阶段。 先区分三条路径 首次加入：Factory New 设备通过 Network Steering 寻找允许加入的网络； Rejoin：设备保留网络信息后重新连接，流程和安全条件不同； Touchlink：近距离发现和引导入网的另一套 commissioni...
Zigbee 各类 Key 的作用范围：不要把 Network Key 和 Link Key 混为一谈
Zigbee 排障中最常见的安全误区，是把所有 128-bit Key 都理解成同一种东西。Key 的长度相同，不代表作用层、通信对象、生命周期和泄露影响相同。 一张作用域表 Key 典型持有者 保护范围 主要用途 Network Key 网络内节点 整个 Zigbee 网络的 NWK 层 日常网络层帧保护 Trust Center Link Key 单个设备与 Trust Center 两个节点之间的 APS ...
Zigbee 集中式网络与分布式网络：差异主要在信任模型
“集中式”和“分布式”首先描述安全与网络管理模型，不是简单描述数据包是否经过 Coordinator。集中式 Zigbee 网络同样可以由 Router 之间直接多跳转发。 核心对比 维度 集中式安全网络 分布式安全网络 信任中心 有 Trust Center 没有中央 Trust Center 准入决策 由 Trust Center 控制 由分布式网络规则协同 Link Key 可建立设备唯一 TCLK 不...
Zigbee Touchlink 流程：近距离发现、识别与入网
Touchlink 是 Zigbee 的一种近距离 commissioning 机制，最初广泛用于照明设备。它不是普通的 Network Steering，也不是“按键后信号强就自动入网”这么简单。 两个角色 Initiator：发起 Touchlink 的控制设备； Target：被发现、识别、复位或加入网络的设备。 两者通过 Touchlink Commissioning Cluster 交互。是否支持某条命令、某种设备...