zigpy
zigpy
智能家居
3/5
🧩 软硬件结合
已发布
项目简介
Library implementing a Zigbee stack
zigpy 是一个基于 Python 3 开发的硬件无关的 Zigbee 协议栈集成库，旨在将 Zigbee 标准规范以纯 Python 的形式实现，为智能家居和物联网应用提供统一的 Zigbee 设备控制能力。它解决了不同品牌、不同芯片厂商的 Zigbee 协调器硬件与上层应用之间的兼容性问题，让开发者无需关心底层硬件的差异，就能通过一套通用的 API 控制各类 Zigbee 终端设备。
标签
项目特点
**硬件无关性**：zigpy 是一个硬件无关的 Zigbee 协议栈，支持多种不同制造商的 Zigbee 协调器硬件。
**多无线电库支持**：通过独立的无线电库（如 bellows、zigpy-deconz、zigpy-xbee 等）支持多种 Zigbee 无线电模块。
**ZCL 和 ZDO 实现**：包含完整的 Zigbee 集群库和 Zigbee 设备对象应用状态管理。
**OTA 更新**：支持 Zigbee 设备的空中固件更新（OTAU），可从在线或本地 OTA 提供源下载固件。
**广泛集成**：被 Home Assistant、Domoticz、Jeedom 等主流开源家庭自动化平台使用。
**Python 3 库**：纯 Python 实现，易于集成和扩展。
技术规格
| 编程语言 | Python 3 |
|---|---|
| 协议标准 | Zigbee（支持 Zigbee 3.0，取决于协调器硬件和固件） |
| 支持的设备类型 | 二进制传感器、传感器、灯、开关、按钮、窗帘、风扇、气候控制设备、锁、入侵报警系统 |
| OTA 更新 | 支持，内置 IKEA、Inovelli、LEDVANCE/OSRAM、SONOFF/ITEAD、ThirdReality 等 OTA 提供源 |
| 支持的无线电库 | bellows（Silicon Labs EmberZNet）、zigpy-deconz（Dresden Elektronik deCONZ）、zigpy-xbee（Digi XBee）、zigpy-zigate（ZiGate）、zigpy-znp（Texas Instruments Z-Stack ZNP） |
| 包管理 | 通过 PyPI 发布（zigpy、bellows、zigpy-cc、zigpy-deconz、zigpy-xbee、zigpy-zigate、zigpy-znp） |
项目资源
搜索资源
物料清单 (BOM)
| 物料名称 | 数量 | 参考价格 | 备注 |
|---|---|---|---|
| Zigbee 协调器适配器 | 1 | — | 需选择兼容的硬件（如 Silicon Labs、Texas Instruments、Digi XBee、Dresden Elektronik、ZiGate） |
| Zigbee 终端设备 | 若干 | — | 需控制的 Zigbee 设备（传感器、灯、开关等） |
| Python 3 | 1 | — | 运行 zigpy 所需 |
| 对应无线电库 | 1 | — | 根据协调器硬件选择（bellows、zigpy-deconz、zigpy-xbee、zigpy-zigate、zigpy-znp 等） |
能力画像
⚪ 记忆与知识检索: 2/5
🔵 逻辑推演: 4/5
⚪ 表达与交流: 2/5
⚪ 感知与观察: 2/5
🔵 数理与计算: 3/5
🔵 动手与操作: 3/5
🔵 狂热与坚持: 4/5
🔵 创造与创新: 4/5
项目图库
所需技能
🔧 **动手能力**：需要能够连接和配置 Zigbee 协调器硬件，可能涉及 USB 连接和固件升级。
💻 **编程能力**：需要 Python 3 编程经验，理解库的集成和使用，能够阅读和修改代码。
⚡ **电子电路**：了解 Zigbee 协议和无线通信基础知识，熟悉 Zigbee 设备类型和网络拓扑。
适用场景
**智能家居集成**：作为 Home Assistant、Domoticz、Jeedom 等平台的 Zigbee 后端，实现智能家居设备的统一控制。
**Zigbee 设备开发与测试**：用于开发和测试 Zigbee 设备，验证 ZCL 和 ZDO 实现。
**自定义 Zigbee 网络**：构建自定义的 Zigbee 网络，实现特定场景下的设备控制和自动化。
**Zigbee 协议研究**：学习和研究 Zigbee 协议栈的实现细节，理解 Zigbee 标准规范。