Socket连接器配置

本配置部分包含 socket 的设置，例如：

• Connection type（连接类型） - socket 类型，可为 TCP 或 UDP；
• Address（地址） - connector 绑定地址；
• Port（端口） - connector 绑定端口；
• Buffer size（缓冲区大小） - 接收数据块缓冲区大小。

本配置部分包含 socket 的设置，例如：

配置部分如下所示：

1
2
3
4
5
6
7
{
  "type": "TCP",
  "address": "127.0.0.1",
  "port": 50000,
  "bufferSize": 1024,
  ...
}

添加新设备时，点击“加号”图标：

在打开的模态窗口中填写以下字段：

• Address filter（地址过滤器） - 用于过滤允许连接到 connector 的 IP 地址。
• Device name（设备名称） - ThingsBoard 中的设备名称。
• Device profile（设备配置） - ThingsBoard 的 device profile，默认无此参数，可自行添加。
• Encoding（编码） - 将字符串数据写入存储时使用的编码。

示例：

1
2
3
4
5
6
{
  "address": "127.0.0.1:50001",
  "deviceName": "Device Example",
  "deviceType": "default",
  "encoding": "utf-8",
  ...

本 converter 面向二进制 payload。它直接解析二进制数据以获取 attribute 和 time series，使用特定字节位置进行数据提取。

添加新的 time series 或 attribute key 时，请按以下步骤操作：

• 点击“Attributes”部分的“铅笔”图标以添加新 attribute key；

• 在打开窗口中点击“Add attribute”；

• 输入 key 名称并填写 字节位置。点击“Apply”；

• 点击“Time series”部分的“铅笔”图标以添加新 time series key；

• 在打开窗口中点击“Add time series”；

• 输入 key 名称、填写 字节位置并点击“Apply”。

可为每个 time series 或 attribute 启用特定的上报策略。该策略定义数据发送到 ThingsBoard 服务器的频率。可用策略如下：

• On report period（按上报周期） - 在上报周期后向 ThingsBoard 发送数据；
• On value change（按值变化） - 值变化时向 ThingsBoard 发送数据；
• On value change or report period（按值变化或上报周期） - 值变化或到达上报周期时向 ThingsBoard 发送数据；
• On received（按接收） - 从设备接收数据后向 ThingsBoard 发送数据（默认策略）。

更多关于 report strategy 的信息请参见此处。

本 converter 面向二进制 payload。它直接解析二进制数据以获取 attribute 和 time series，使用特定字节位置进行数据提取。

attributes 部分使用与 telemetry 部分相同的参数。

示例：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
{
  "address": "127.0.0.1:50001",
  "deviceName": "Device Example",
  "deviceType": "default",
  "encoding": "utf-8",
  "telemetry": [
    {
      "key": "temp",
      "byteFrom": 0,
      "byteTo": -1
    },
    {
      "key": "hum",
      "byteFrom": 0,
      "byteTo": 2
    }
  ],
  "attributes": [
    {
      "key": "name",
      "byteFrom": 0,
      "byteTo": -1
    },
    {
      "key": "num",
      "byteFrom": 2,
      "byteTo": 4
    }
  ]
}

添加新 attribute request 时，请按以下步骤操作：

• 点击“Attribute requests”部分的“铅笔”图标以添加新 attribute request；

• 在打开窗口中点击“Add attribute request”；

• 选择 request 类型，输入 request 表达式和 attribute 名称表达式。点击“Apply”。

本小节配置如下所示：

1
2
3
4
5
6
7
"attributeRequests": [
  {
    "type": "shared",
    "requestExpression": "${[0:3]==atr}",
    "attributeNameExpression": "[3:]"
  }
]

此外，可一次请求多个 attribute。只需在 attributeNameExpression 参数中再添加一个切片表达式。例如，若要在一次 request 中请求两个 shared attribute，配置如下：

1
2
3
4
5
6
7
"attributeRequests": [
  {
    "type": "shared",
    "requestExpression": "${[0:3]==atr}",
    "attributeNameExpression": "[4:19][20:]"
  }
]

即需发送以下消息以请求两个 shared attribute： atr sharedAttribute sharedAttribute1

添加新 attribute update 时，请按以下步骤操作：

• 点击“Attribute updates”部分的“铅笔”图标以添加新 attribute update；

• 在打开窗口中点击“Add attribute update”；

• 选择 encoding 并填写“Attribute on platform”字段。点击“Apply”。

“attributeUpdates” 配置允许设置将发送到服务器的对应 attribute 数据格式。

配置文件中本小节如下所示：

1
2
3
4
5
6
"attributeUpdates": [
  {
    "encoding": "utf-16",
    "attributeOnThingsBoard": "sharedName"
  }
]

添加新 RPC 方法时，请按以下步骤操作：

• 点击“RPC methods”部分的“铅笔”图标以添加新 RPC；

• 在打开窗口中点击“Add method”；

• 填写“Method name”字段，选择 encoding，勾选/取消勾选“With Response”字段。点击“Apply”。

本部分的配置用于从 ThingsBoard 向设备发送 RPC 请求。

配置文件中本小节如下所示：

1
2
3
4
5
6
7
8
"serverSideRpc": [
  {
    "methodRPC": "rpcMethod1",
    "withResponse": true,
    "methodProcessing": "write",
    "encoding": "utf-8"
  }
]