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 实现，易于集成和扩展。
技术规格
| 编程语言 | |
|---|---|
| 协议标准 | |
| 支持的设备类型 | |
| OTA 更新 | |
| 支持的无线电库 | |
| 包管理 |
项目资源
物料清单 (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 等） |
所需工具
| 工具 | 用途 | 是否必需 |
|---|---|---|
| Python 3 环境 | 运行 zigpy 库 | ✅ 是 |
| USB 转串口适配器 | 连接 Zigbee 协调器（如需要） | ▢ 推荐 |
| 文本编辑器/IDE | 编写和修改代码 | ✅ 是 |
| Git | 版本控制和代码贡献 | ▢ 推荐 |
能力画像
记忆与知识检索
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 标准规范。