Thingsboard--gateway--python版本的安装、配置和使用说明

TB-Gateway版本安装及使用说明----python版本一、安装指南从源代码安装ThingsBoardGateway，遵循以下步骤：1.Windows上安装python3，然后配置环境变量：2.从Github下载存储库：gitclone移至下载目录：cdthingsboard-gateway4.使用setup.py脚本安装python模块：python3setup.pyinstall5.创建“日志”文件夹：mkdirlogs6.配置网关使其与ThingsBoard平台实例一起使用，接下来会介绍配置文件。7.运行网关，检查安装结果：python3./thingsboard_gateway/tb_gateway.py二、配置文件配置文件的目录/etc/thingsboard-gateway/configtb_gateway.yaml-网关主配置文件logs.conf-日志配置文件modbus.json-MODBUS配置文档mqtt.json-MQTT配置文档ble.json-BLE配置文档opcua.json-OPC-UA配置文档主配置文件结构用于连接到ThingsBoard平台实例和启用/禁用连接器的主要配置文件。此配置指向ThingsBoard实例demo.thingsboard.io并使用配置为最多存储100,000条记录的内存文件存储。有4个不同的活动连接器。如果您只想使用其中之一-只需移除所有其他连接器即可。thingsboard:host:demo.thingsboard.io//mqttbrokeIP地址port:1883//mqttbroker端口号security:accessToken:PUT_YOUR_ACCESS_TOKEN_HERE//tb平台一个网关设备的tokenstorage:type:memoryread_records_count:100max_records_count:100000connectors:-name:MQTTBrokerConnectortype:mqttconfiguration:mqtt.json-name:ModbusConnectortype:modbusconfiguration:modbus.json-name:OPC-UAConnectortype:opcuaconfiguration:opcua.json-name:BLEConnectortype:bleconfiguration:ble.json三、MQTT连接器配置连接器配置：mqtt.json连接器配置是一个JSON文件，其中包含有关如何连接到外部MQTT代理，订阅数据馈送时使用哪些主题以及如何处理数据的信息。让我们使用以下示例来查看配置文件的格式。MQTT连接器配置文件示例。下面列出的示例将连接到IP192.168.1.100服务器上部署的本地网络中的MQTT代理。连接器将使用用户名和密码使用基本的MQTT身份验证。然后，连接器将使用“映射”部分中的主题过滤器订阅主题列表。在下面的说明中查看更多信息。{broker:{name:DefaultLocalBroker,host:192.168.1.100,port:1883,security:{type:basic,username:user,password:password}},mapping:[{topicFilter:/sensor/data,converter:{type:json,deviceNameJsonExpression:${serialNumber},deviceTypeJsonExpression:${sensorType},timeout:60000,attributes:[{type:string,key:model,value:${sensorModel}}],timeseries:[{type:double,key:temperature,value:${temp}},{type:double,key:humidity,value:${hum}}]}},{topicFilter:/sensor/+/data,converter:{type:json,deviceNameTopicExpression:(?=sensor\/)(.*?)(?=\/data),deviceTypeTopicExpression:Thermometer,timeout:60000,attributes:[{type:string,key:model,value:${sensorModel}}],timeseries:[{type:double,key:temperature,value:${temp}},{type:double,key:humidity,value:${hum}}]}},{topicFilter:/custom/sensors/+,converter:{type:custom,extension:CustomMqttUplinkConverter,extension-config:{temperatureBytes:2,humidityBytes:2,batteryLevelBytes:1}}}],connectRequests:[{topicFilter:sensor/connect,deviceNameJsonExpression:${SerialNumber}},{topicFilter:sensor/+/connect,deviceNameTopicExpression:(?=sensor\/)(.*?)(?=\/connect)}],disconnectRequests:[{topicFilter:sensor/disconnect,deviceNameJsonExpression:${SerialNumber}},{topicFilter:sensor/+/disconnect,deviceNameTopicExpression:(?=sensor\/)(.*?)(?=\/disconnect)}],attributeUpdates:[{deviceNameFilter:SmartMeter.*,attributeFilter:uploadFrequency,topicExpression:sensor/${deviceName}/${attributeKey},valueExpression:{\${attributeKey}\:\${attributeValue}\}}],serverSideRpc:[{deviceNameFilter:.*,methodFilter:echo,requestTopicExpression:sensor/${deviceName}/request/${methodName}/${requestId},responseTopicExpression:sensor/${deviceName}/response/${methodName}/${requestId},responseTimeout:10000,valueExpression:${params}},{deviceNameFilter:.*,methodFilter:no-reply,requestTopicExpression:sensor/${deviceName}/request/${methodName}/${requestId},valueExpression:${params}}]}Broker部分参数默认值描述nameDefaultBroker自定义名称hostlocalhostMqttbroker域名或IP.port1883Mqttport端口号.安全部分，一般选择Basic模式参数默认值描述typebasic授权类型.usernameusername用户名.passwordpassword密码.“映射”部分主题还支持特殊的符号如“#””+”,这样可以订阅更多的主题参数默认值描述主题过滤/sensor/data网关订阅的主题推送的数据结构例子名称主题主题过滤器数据包备注Example1/sensor/data/sensor/data{“serialNumber”:“SN-001”,“sensorType”:“Thermometer”,“sensorModel”:“T1000”,“temp”:42,“hum”:58}设备名称作为数据包的一部分Example2/sensor/SN-001/data/sensor/+/data{“sensorType”:“Thermometer”,“sensorModel”:“T1000”,“temp”:42,“hum”:58}设备名称作为主题一部分数据转化器参数默认值描述typejson提供给转换器的数据格式deviceNameJsonExpression${serialNumber}从json数据包中提取key为serialNumber的值，作为设备名称deviceTypeJsonExpression${sensorType}从json数据包中提取key为sensorType的值，作为设备类型timeout60000“设备断开连接”事件超时时间attributes设备属性…typestring属性数据类型…keymodel属性名称…value${sensorModel}从json数据包中提取key为sensorModel的值，作为属性值timeseries时序数据…typedouble时序数据的数据类型…keytemperature时序数据的key…value${temp}从json数据包中提取key为temp的值，作为时序值服务端发送rpc到设备端参数默认值描述设备名称过滤表达式.*正则表达式，用于标识设备名称方法名过滤器echo正则表达式方法名筛选器，用于确定要执行的函数。请求主题表达式sensor/${deviceName}/request/${methodName}/${requestId}JSON-PATH表达式，用于创建主题用以发送RPC请求。响应主题表达式sensor/${deviceName}/response/${methodName}/${requestId}JSON-PATH表达式，用于创建主题用以订阅响应消息。responseTimeout10000响应延时时间（以毫秒为单位），如果发送请求后在此期间内没有响应，则网关将从响应主题中取消订阅。valueExpression${params}JSON-PATH表达式，用于创建发送到代理的数据。您可以使用deviceNameFilter和methodFilter为不同的设备/方法应用不同的映射规则。一旦网关从服务器接收到设备的RPC请求，它将基于requestTopicExpression和valueExpression发布相应的消息。如果希望设备回复请求，还应指定responseTopicExpression和responseTimeout。网关将订阅“响应”主题并等待设备回复，直到检测到“响应超时”（以毫秒为单位）。例如：需要从服务器发送的RPC请求（RPCrequest.json）示例：{method:echo,params:{message:Hello!}}四、MODBUS连接器配置本指南将帮助您熟悉用于ThingsBoard物联网网关的Modbus连接器配置。使用常规配置启用此连接器。我们将在下面描述连接器配置文件。ModbusConnectorconfigfile{server:{name:ModbusDefaultServer,type:tcp,host:127.0.0.1,port:5020,timeout:35,method:rtu,devices:[{