vesna-alhtools 1.0.6

简介

此软件包提供用于管理使用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>