deCONZ REST API 插件
deconz-rest-plugin
项目简介
deCONZ REST-API plugin to control ZigBee devices
deCONZ REST Plugin 是一个开源的 Zigbee 网关中间件，旨在为智能家居设备提供统一的 REST API 接口。它解决了不同品牌 Zigbee 设备之间互不兼容、需要各自独立网关的痛点，让用户能够通过一个统一的软件平台，集中管理和控制来自 Xiaomi Aqara、IKEA TRÅDFRI、Philips Hue、innr、Samsung 等众多厂商的 Zigbee 3.0、Zigbee Home Automation 和 Zigbee Light Link 协议设备，包括灯、开关和传感器。该项目的核心功能是作为 Zigbee 协调器（如 ConBee 或 RaspBee 系列硬件）与用户应用程序之间的桥梁。它通过 REST API 暴露设备状态和控制接口，使得任何支持 HTTP 请求的客户端（如自定义脚本、Home Assistant 等智能家居平台）都能轻松地与 Zigbee 设备交互。技术栈方面，插件基于 C++ 开发，深度集成了 Qt 框架，并使用了 ArduinoJSON 进行数据序列化、SQLite 进行本地数据持久化、Duktape 作为 JavaScript 引擎以支持设备描述文件（DDF）的灵活解析，以及 OpenSSL 保障通信安全。项目支持在 Raspberry Pi（运行 Raspbian）、Ubuntu、Windows 和 macOS 等多种平台上运行，并提供了 headless 模式，允许在无图形界面的 Linux 服务器上作为系统服务后台运行，非常适合需要稳定、低功耗、长期运行的智能家居服务器场景。配合其官方开发的 Phoscon App 网页界面，用户无需编程即可完成设备配对和基础控制，而开发者则可以充分利用其详尽的 API 文档进行深度集成和自动化场景开发。
标签
项目特点
技术规格
| 支持的 Zigbee 协议 | |
|---|---|
| 支持的平台 | |
| 支持的硬件 | |
| 编程语言 | |
| 依赖库 | |
| 许可证 |
项目资源
物料清单 (BOM)
| 物料名称 | 数量 | 参考价格 | 备注 |
|---|---|---|---|
| Raspberry Pi (1/2B/3B/3B+/4B) | 1 | — | 可选 |
| RaspBee / RaspBee II Zigbee 扩展板 | 1 | — | 用于 Raspberry Pi |
| ConBee / ConBee II / ConBee III USB 适配器 | 1 | — | 用于 PC 或 Raspberry Pi |
| deCONZ 应用程序 | 1 | — | 包含 REST 插件 |
| Phoscon App | 1 | — | Web 管理界面 |
所需工具
| 工具 | 用途 | 是否必需 |
|---|---|---|
| Raspberry Pi 或 PC | 运行 deCONZ 和插件 | ✅ 是 |
| Zigbee 适配器 (RaspBee/ConBee) | 与 Zigbee 设备通信 | ✅ 是 |
| 操作系统 | Raspbian/Ubuntu/Windows/macOS | ✅ 是 |
| 浏览器 | 访问 Phoscon App 管理界面 | ▢ 推荐 |