Thingsboardgatewaypython版本的安装、配置和使用说明

1、TB-Gateway 版本安装及使用说明python 版本从源代码安装ThingsBoard Gateway ，遵循以下步骤：Windows 上安装 python3 ，然后配置环境变量：从 Github 下载存储库：git clone HYPERLINK /thingsboard/thingsboard-gateway.git /thingsboard/thingsboard-gateway.git移至下载目录：cd thingsboard-gateway使用 setup.py 脚本安装python 模块：python3 setup.py install5. 创建“日志”文件夹：mkdir l

2、ogs配置网关使其与ThingsBoard 平台实例一起使用，接下来会介绍配置文件。运行网关，检查安装结果： python3 ./thingsboard_gateway/tb_gateway.py配置文件的目录 /etc/thingsboard-gateway/config-网关主配置文件- 日志配置文件MODBUS 配置文档MQTT 配置文档BLE 配置文档OPC-UA 配置文档tb_gateway.yamllogs.confmodbus.jsonmqtt.jsonble.jsonopcua.json主配置文件结构用于连接到ThingsBoard 平台实例和启用/禁用连接器的主要配置文件。此

3、配置指向ThingsBoard 实例 demo.thingsboard.io 并使用配置为最多存储100,000 条记录的内存文件存储。有4 个不同的活动连接器。如果您只想使用其中之一- 只需移除所有其他连接器即可。thingsboard:host: demo.thingsboard.io/ mqtt brokeIP 地址port: 1883/ mqtt broker端口号security:accessToken: PUT_YOUR_ACCESS_TOKEN_HERE / tb 平台一个网关设备的tokenstorage:type: memoryread_records_count: 100m

4、ax_records_count: 100000connectors:-name: MQTT Broker Connectortype: mqttconfiguration: mqtt.json-name: Modbus Connectortype: modbusconfiguration: modbus.jsonname: OPC-UA Connectortype: opcuaconfiguration: opcua.json-name: BLE Connectortype: bleconfiguration: ble.jsonMQTT 连接器配置连接器配置：mqtt.json连接器配置是一

5、个JSON 文件，其中包含有关如何连接到外部MQTT 代理，订阅数据馈送时使用哪些主题以及如何处理数据的信息。让我们使用以下示例来查看配置文件的格式。MQTT 连接器配置文件示例。下面列出的示例将连接到IP 00 服务器上部署的本地网络中的MQTT 代理。连接器将使用用户名和密码使用基本的MQTT 身份验证。然后，连接器将使用“映射”部分中的主题过滤器订阅主题列表。在下面的说明中查看更多信息。broker: name:Default Local Broker,host:00,port:1883,security: type: basic,username: user,password: pas

6、sword,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:

7、 $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

8、,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,d

9、eviceNameTopicExpression: (?=sensor/)(.*?)(?=/connect) , disconnectRequests: topicFilter: sensor/disconnect,deviceNameJsonExpression: $SerialNumber,topicFilter: sensor/+/disconnect,deviceNameTopicExpression: (?=sensor/)(.*?)(?=/disconnect) ,attributeUpdates: deviceNameFilter: SmartMeter.*,attributeF

10、ilter: uploadFrequency,topicExpression: sensor/$deviceName/$attributeKey,valueExpression: $attributeKey:$attributeValue ,serverSideRpc: deviceNameFilter: .*,methodFilter: echo,requestTopicExpression:sensor/$deviceName/request/$methodName/$requestId, responseTopicExpression:sensor/$deviceName/respons

11、e/$methodName/$requestId,responseTimeout: 10000,valueExpression: $params,deviceNameFilter: .*,methodFilter: no-reply,requestTopicExpression:sensor/$deviceName/request/$methodName/$requestId, valueExpression: $paramsBroker 部分参数默认值描述nameDefault Broker自定义名称hostlocalhostMqtt broker 域名或IP.port1883Mqtt po

12、rt 端口号.安全部分，一般选择Basic 模式参数默认值描述typebasic授权类型.usernameusername用户名.passwordpassword密码 .“映射”部分主题还支持特殊的符号如“# ”+ ”,这样可以订阅更多的主题参数默认值描述主题过滤/sensor/data网关订阅的主题推送的数据结构例子名称主题主题过滤器数据包备注“ serialNumber ”: “ SN-001 ” ,Example 1/sensor/data/sensor/data“ sensorType ” : “ sensorModel ” :Thermometer ” ,“ T1000 ” , “

13、temp ” :设备名称作为数据 包的一部分42, “ hum ” : 58Example 2/sensor/SN-001/data/sensor/+/data “ sensorType ” : “ sensorModel ” : 42, “ hum ” : 58“ Thermometer ” ,“ T1000 ” , “ temp ” :设备名称作为主题 一部分数据转化器参数默认值描述typejson提供给转换器的数据格式deviceNameJsonExpression$serialNumber从 json 数据包中提取key 为 serialNumber 的值，作为设备名称deviceTy

14、peJsonExpression$sensorType从 json 数据包中提取key 为 sensorType 的值，作为设备类型timeout60000“设备断开连接”事件超时时间attributes设备属性 typestring属性数据类型 keymodel属性名称 value$sensorModel从 json 数据包中提取key 为 sensorModel 的值，作为属性值timeseries时序数据 typedouble时序数据的数据类型 keytemperature时序数据的key value$temp从 json 数据包中提取key 为 temp 的值，作为时序值服务端发送rp

15、c 到设备端参数默认值描述设备名称过滤表达式.*方法名过滤器echo请求主题表达式sensor/$deviceName/request/$methodName/$requestId响应主题表达式sensor/$deviceName/response/$methodName/$requestIdresponseTimeout10000valueExpression$params正则表达式，用于标识设备名称正则表达式方法名筛选器，用于确定要执行的函数。JSON-PATH 表达式，用于创建主题用以发送RPC 请求。JSON-PATH 表达式，用于创建主题用以订阅响应消息。响应延时时间（以毫秒为单位）

16、，如果发送请求后在此期间内没有响应， 则网关将从响应主题中取消订阅。JSON-PATH 表达式，用于创建发送到代理的数据。您可以使用deviceNameFilter 和 methodFilter 为不同的设备/方法应用不同的映射规则。一旦网关从服务器接收到设备的RPC 请求，它将基于requestTopicExpression 和valueExpression 发布相应的消息。如果希望设备回复请求，还应指定responseTopicExpression 和 responseTimeout 。网关将订阅“响应”主题并等待设备回复，直到检测到“响应超时”（以毫秒为单位）。例如：需要从服务器发送的R

17、PC 请求（ RPC request.json ）示例：method: echo ,params: message: Hello!MODBUS 连接器配置本指南将帮助您熟悉用于ThingsBoard 物联网网关的Modbus 连接器配置。使用常规配置启用此连接器。我们将在下面描述连接器配置文件。Modbus Connector config fileserver: name: Modbus Default Server ,type: tcp ,host: ,port: 5020 ,timeout: 35,method: rtu , devices: unitId: 1,deviceName:

18、Temp Sensor , attributesPollPeriod:5000 ,timeseriesPollPeriod:5000 ,sendDataOnlyOnChange:true,attributes: byteOrder: BIG , tag: test , type: long , functionCode: 4, registerCount: 1 , address: 0 , timeseries: byteOrder: BIG , tag: test , type: long , functionCode: 4, registerCount: 1 , address: 0 ,

19、rpc: turnLightOn: address: 4, bit: 2, value: true , turnLightOff: address: 4, bit: 2, value: false,getCPULoad: tag: Integer , value: 42 , functionCode: 16 , address: 0, unitId: 1, byteOrder: BIG , registerCount: 1Server 部分说明TCP/UDP 协议参数默认值描述nameModbus Default Server连接器名称typetcp连接类型，可以是：tcp , udp or

20、serial .hostModbus server的 IPport5020Modbus server的端口号参数默认值描述timeout35连接到Modbus 服务器超时（秒）时间methodsocket连接形式socket or rtu参数默认值描述nameModbus Default Server连接器名称typeserial连接类型，可以是：tcp , udp orport/dev/ttyUSB0设备串口名称timeout35连接到Modbus 服务器超时（秒）时间methodrtu数据单元类型rtu or asciiserial设备参数此配置部分提供设备连接和数据处理的配置。参数默认值

21、描述unitId1Modbus 当前设备的IddeviceNameTemp Sensor设备名称参数默认值描述attributesPollPeriod5000检查设备上属性的时间（毫秒）timeseriesPollPeriod5000检查设备上的遥测的时间（毫秒）。sendDataOnlyOnChangetrue仅在上次检查数据更改时发送设备属性本小节中的配置提供了在Modbus 服务器上处理数据的设置，这些设置将在ThingsBoard平台实例中解释为设备的属性参数默认值描述byteOrderBIG要读取的字节顺序tagtestTb 平台设备的标签域typelong属性数据类型(long , integer , string , double , bit )functionCode4Modbus 的功能码registerCount1要读取的寄存器计数address0寄存器起始地址。设备时序本小节中的配置提供了在Modbus 服务器上处理数据的设置，该设置将在ThingsBoard 平台实例中解释为设备遥测。参数默认值描述byteOrderBIG要读取的字节顺