用于处理VESNA近似HTTP协议的工具
项目描述
简介
此软件包提供用于管理使用ALH协议的基于VESNA的无线传感器网络的实用程序和Python模块。
在典型设置中,VESNA节点参与基于ZigBee的无线网状网络。在此网状网络中,每个传感器节点都暴露一个类似HTTP的接口,支持两种类型的请求:GET用于无状态信息检索和POST用于更改状态的操作。
ZigBee网状网络由协调器建立。除了ZigBee接口之外,协调器通常还配备有以太网适配器。在启动时,它建立一个TCP/IP SSL隧道,并在其上暴露ALH服务。
通常,SSL隧道终止于基础设施服务器,该服务器在ALH和暴露在网页上的适当HTTP REST接口之间进行转换
+------+ | node | ALH - ZigBee mesh +------+ \ | SSL tunnel +------+ | +-------------+ +----------------+ | node | ALH -+- ALH | coordinator | ALH --- | infrastructure | HTTPS --> +------+ | +-------------+ +----------------+ | +------+ / | node | ALH - +------+
或者,协调器也可以通过串行线直接连接到客户端。这种设置通常用于开发或调试
+------+ | node | ALH - ZigBee mesh +------+ \ | serial line +------+ | +-------------+ | node | ALH -+- ALH | coordinator | ALH -------------------------------> +------+ | +-------------+ | +------+ / | node | ALH - +------+
这些工具透明地支持这两种操作模式。通常,要么给出HTTP REST端点的URL,要么给出串行线的字符设备。
安装
要从软件包索引安装系统范围内的软件,请运行
$ pip install vesna-alhtools
这应该也会自动安装VESNA频谱传感器应用程序所需的Python绑定。更多信息请参阅:https://github.com/avian2/vesna-spectrum-sensor
要从源代码安装系统范围内的软件,请运行
$ pip install .
要运行测试
$ tox
用法
安装后,以下工具可用
- alh-reprogram
执行协调器或传感器节点的空中重编程。
- alh-map
通过爬取ZigBee网状网络列出参与传感器网络的节点。
可用于使用Graphviz或网络监控(通过集成到Munin)可视化网络。
- alh-tx-test
信号发生器测试。
- alh-endpoint-server
简单的ALH到HTTP端点服务器,适用于测试。它可以替代适当的基础设施服务器。
运行每个程序时,只需将 --help 作为唯一参数,即可获取可用选项列表。
注意:如果API端点使用基本身份验证,您将在命令行中提示输入凭证。
您还可以将凭证保存到主目录中的 .alhrc 文件或当前目录中的 alhrc 文件中。文件的格式如下面的示例所示
Host example.com User <username> Password <password> # more Host, User, Password lines can follow
还安装了几个Python模块。有关如何使用它们的示例,请参阅demos/目录中的演示程序。类和方法带有docstring文档。其中一些可以在 https://vesna-alh-tools.readthedocs.io/en/latest/ 上在线访问
使用rftest.py进行远程测试
此库提供了一个与vesna-spectrum-sensor存储库中的RF测试实用程序兼容的DeviceUnderTest类。它允许使用生产固件(例如NodeSpectrumSensor应用程序)在完全组装的节点上测试无线电硬件(例如SNE-ISMTV),而无需额外布线。
测试设置如下所示
+----------+ coax +------+ zigbit +-------------+ SSL +----------------+ | R&S SMBV |----->| node |<-------| coordinator |<------| infrastructure | +----------+ +------+ ALH +-------------+ +----------------+ ^ ^ | usbtmc +--------+ HTTPS | +-----------| rftest |--------------------------------------+ +--------+
这样运行rftest
$ vesna-rftest -i foo -R vesna.alh.rftest.RemoteDeviceUnderTest -O,-Uhttps://...,-u...,-n1
许可证
版权(C)2017传感器实验室,约瑟夫·斯蒂芬研究院 http://sensorlab.ijs.si
此程序是免费软件:您可以在自由软件基金会发布的GNU通用公共许可证的条款下重新分发它和/或修改它,无论是许可证的第3版,还是(根据您的选择)任何较新版本。
此程序的分发是希望它将是有用的,但没有任何保证;甚至没有关于其适销性或适用于特定目的的暗示保证。有关详细信息,请参阅GNU通用公共许可证。
您应该已经随此程序收到了GNU通用公共许可证的一份副本。如果没有,请参见 <https://gnu.ac.cn/licenses/>。
作者:Tomaz Solc,<tomaz.solc@ijs.si>
项目详情
vesna-alhtools-1.0.6.tar.gz的散列
算法 | 散列摘要 | |
---|---|---|
SHA256 | 8c04561c760dd9e95d4183c13fdca5a22a3a06baebf5f88b95fea7621be92efa |
|
MD5 | c252d86aafd08d5b6049d7015e6a2775 |
|
BLAKE2b-256 | df03511817e52506302fd9decb19e9d4c2816cd3dfc34d51fef9fe7602356e05 |