跳转到主要内容

用于处理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 (32.7 KB 查看散列

由以下支持

AWS AWS 云计算和安全赞助商 Datadog Datadog 监控 Fastly Fastly CDN Google Google 下载分析 Microsoft Microsoft PSF赞助商 Pingdom Pingdom 监控 Sentry Sentry 错误日志 StatusPage StatusPage 状态页面