一个用于与zigpy通信的XBee无线电库
项目描述
zigpy-xbee
zigpy-xbee 是一个针对 Zigpy 项目的Python实现,用于实现基于 Digi 的 XBee 的 Zigbee 无线电设备。
Digi XBee 是 Digi International 公司一系列形式因素兼容的无线电模块的品牌名称。
XBee无线模块都可以使用最少的连接——电源(3.3 V)、地线、数据输入和数据输出(UART),其他推荐的线路包括复位和睡眠。[5] 此外,大多数XBee系列还内置了一些其他流控制、输入/输出(I/O)、模数转换器(A/D)和指示线。
使用与zigpy兼容的Zigbee无线库模块,可以连接许多现成的Zigbee适配器,实现对基于Zigbee的设备进行控制,包括用于基于Xbee的Zigbee无线模块的此zigpy-xbee库。
zigpy目前支持控制二进制传感器(例如,运动和门传感器)、传感器(例如,温度传感器)、灯泡、开关和风扇等Zigbee设备类型。zigbe在开源家庭自动化软件Home Assistant的ZHA组件中实现了工作版本。
兼容硬件
zigpy与独立的无线库兼容,这些库可以与多个USB和GPIO无线硬件适配器/模块通过不同的本地UART串行协议进行接口。这些无线库包括与基于Xbee的Zigbee无线模块通信的zigpy-xbee(与EZSP/EmberZNet无线模块通信的bellows),以及用于与Dresden-Elektronik的ConBee和RaspBee USB和GPIO无线模块通信的zigpy-deconz。还有一个用于与基于ZiGate的无线模块通信的实验性无线库zigpy-zigate。
已知适用于Zigpy的基于XBee的Zigbee无线模块
这些是基于XBee的Zigbee无线模块,已通过zigpy-xbee库进行测试
- Digi XBee Series 3 (xbee3-24)和Digi XBee Series S2C模块
- 注意!虽然不是必须的,但建议使用XCTU升级Xbee Series 3和S2C到最新固件。
- Digi XBee Series 2 (S2)模块(注意!首先需要刷入Zigbee协调器API固件)
端口配置
- 要配置您的XBee串行设备的USB端口路径,只需指定TTY(串行通信)端口,例如:
/dev/ttyACM0
注意!用户可以使用Digi的XCTU配置工具更改Digi XBee的UART波特率。使用XCTU工具启用API通信模式——ATAP2
,设置波特率为57600——ATBD6
,保存参数。
测试新版本
在Home Assistant发布之前测试zigpy-xbee库的新版本。
如果您使用的是Supervised Home Assistant(以前称为Hassio/Hass.io发行版)
- 将https://github.com/home-assistant/hassio-addons-development作为“附加组件”存储库添加
- 安装“自定义依赖部署”插件
- 更新配置如下
其中0.12.0是新版本pypi: - zigpy-xbee==0.12.0 apk: []
- 启动插件
如果您使用的是自定义Python安装的Home Assistant,则执行以下操作
- 激活您的python虚拟环境
- 使用
pip
更新包pip install zigpy-xbee==0.12.0
zigpy-xbee的PyPI发布
通过PyPI发布的标记版本的新包也通过“zigpy-xbee”项目发布
旧版本的标记版本仍然可在PyPI上的“zigpy-xbee-homeassistant”项目找到
如何贡献
如果您想为此项目做出贡献,我们建议您遵循以下指南中的步骤
- https://github.com/firstcontributions/first-contributions/blob/master/README.md
- https://github.com/firstcontributions/first-contributions/blob/master/github-desktop-tutorial.md
一些开发者可能对以Zigbee模块或设备等硬件形式接收捐款也感兴趣,尽管这种捐款通常是无附加条件的,但在许多情况下,它可以提高开发者的积极性,间接提高本项目的开发。
项目详情
下载文件
下载您平台对应的文件。如果您不确定选择哪个,请了解更多关于安装包的信息。
源代码发行版
构建发行版
zigpy_xbee-0.20.2.tar.gz的哈希值
算法 | 哈希摘要 | |
---|---|---|
SHA256 | cf751bbccd73725f15b9460bde3f299fee7b9aae22ec5329515bb2c10d11f3f6 |
|
MD5 | eb7fbdbace9ebcde802aab612e98dffc |
|
BLAKE2b-256 | f1061af74174ae83e6e10b51a347f1a64adc2045492c7a738cd0f25287351ed1 |
zigpy_xbee-0.20.2-py3-none-any.whl的哈希值
算法 | 哈希摘要 | |
---|---|---|
SHA256 | efcb2d653352d40860c005bae978451b8eccdbcd2b98234c9324fc54ae71fa54 |
|
MD5 | e71aaf883a09cbef789d89e6d7ae61d3 |
|
BLAKE2b-256 | c9eb20d865b40d344fa9d7b9a4213d60e322991ee1f597575ba7121a13c786f4 |