作为mqtt代理提供对物联网实验室实验的访问
iotlabmqtt的Python项目详细描述
作为mqtt代理提供对物联网实验室实验的访问。
协议文件 IoT-LAB-MQTT Documentation
发展于 ARMOUR European Union project
安装
在物联网实验室前端以服务器模式安装:
git clone https://github.com/iot-lab/iot-lab-mqtt.git cd iot-lab-mqtt pip install --user -e .[server]
在计算机上以客户端模式安装:
git clone https://github.com/iot-lab/iot-lab-mqtt.git cd iot-lab-mqtt pip install --user .
通过将python用户安装目录添加到PATH中 在~/.bashrc中追加以下行:
export PATH="${HOME}/.local/bin:${PATH}"
您可以使用:
echo 'export PATH="${HOME}/.local/bin:${PATH}"' >> ~/.bashrc # Reload configuration source ~/.bashrc
如果没有,则需要从 以"./"为前缀的存储库目录,例如 ./iotlab-mqtt-clients。
文档
可以使用以下命令生成文档:
pip install --user sphinx make -C doc html
上下文
服务器
要使用这些工具,您应该使用mqtt代理。 对于这个文档,我将使用iot.eclipse.org。 服务器和客户端代理都将通过这个集中服务器进行通信。
主题
mqtt基于url主题的发布/订阅。
为了防止冲突,我建议在url前面加上特定的前缀 你的实验和例子。 我想说:
my/experiment/on/blablabla/IOTLAB_USERNAME/IOTLAB_EXPERIMENT_ID
在工具上提供前缀使用--prefix选项。
更高级
请参见有关实现的文档
运行
在服务器上,您应该首先运行server代理:
iotlab-mqtt-serial [ARGUMENTS] iotlab-mqtt-radiosniffer [ARGUMENTS] iotlab-mqtt-node [ARGUMENTS] iotlab-mqtt-process [ARGUMENTS]
在客户机上,您应该运行您的客户机或提供的示例:
iotlab-mqtt-clients serial [ARGUMENTS] iotlab-mqtt-clients radiosniffer [ARGUMENTS] iotlab-mqtt-clients node [ARGUMENTS] iotlab-mqtt-clients process [ARGUMENTS] iotlab-mqtt-clients log [ARGUMENTS]
参数
您可以使用--help选项获取参数列表。
全局MQTT配置
代理地址,MQTT服务器的URL:
broker
Broker端口,默认为1883(当我编写时):
--broker-port BROKER_PORT
主题前缀,您的主题命名空间:
--prefix PREFIX
客户机MQTT配置
服务器代理站点名称,物联网实验室站点名称:
--site IOTLAB_SITE
物联网实验室API使用配置
使用IoT实验室API(^{TT9}$)的服务器的配置。 如果没有提供,工具将尝试从.iotlabrc和current中检测它们 运行实验。
物联网实验室API用户名:
--iotlab-user IOTLAB_USERNAME
物联网实验室API密码:
--iotlab-password IOTLAB_PASSWORD
要使用的物联网实验室实验标识:
--experiment-id EXPERIMENT_ID