【ThingsBoard】基于HTTP协议 RPC API

【ThingsBoard】基于HTTP协议 RPC API

背景：

ThingsBoard允许你从服务端应用程序向设备发送远程RPC调用，你也可以将命令发送到设备并接收命令执行的结果。

同样你可以执行来自设备的请求，在后端应用进行某些计算或服务端逻辑处理然后将结果反馈到设备。

一、前提

ThingsBoard平台已经搭建

设备已经录入ThingsBoard平台

二、场景分析

1、场景一：设备端发送rpc命令到服务端，服务端接收到rpc命令进行业务逻辑处理，再发送响应给设备。见下图

2、场景二：服务端发送rpc命令到设备端，设备端接收到rpc命令进行业务逻辑处理。服务端发送rpc命令有两种方式：一种是无响应；一种是等待客户端响应。见下图

三、具体实现

1、客户端rpc（场景一）

假设有一个血压表设备，需要通过rpc命令获取服务端时间，进行显示。首先配置设备对应规则链，如下图

红框中是配置设备端发送rpc请求处理的链路

rest api call具体配置如下：

http://127.0.0.1:8087/apitest/thingsBoardTransport：是服务端接口，获取时间，返回时间给设备端，实现如下：

设备端发送rpc命令：

发送post请求到以下url:

http://host:port/api/v1/$ACCESS_TOKEN/rpc

host:port:是thingsboard平台地址端口

ACCESS_TOKEN：设备访问令牌

具体调用实现（postman模拟设备调用）

2、服务端rpc（场景二）

假设有一个血压表设备，服务端发送rpc命令测量血压，血压执行测量血压操作，并返回血压值给服务端。首先配置设备对应规则链，如下图

配置红框中内容即可。

服务端发送RPC请求使用下面URL执行HTTP POST请求：

http(s)://host:port/api/plugins/rpc/{callType}/{deviceId}

url说明：

callType 表示 oneway或者twoway

deviceId 表示设备ID

必填参数:

method - 表示json字符串格式的方法名

params - 表示json字符串格式的对象参数列表

实现如下：（postman模拟服务端发送命令）

设备端需要订阅以下url:

http://localhost:8080/api/v1/$ACCESS_TOKEN/rpc?timeout=20000

postman模拟如下：

收到请求后，使用一下post请求回复：

http://host:port/api/v1/$ACCESS_TOKEN/rpc/{$id}

postman模拟如下：

不明白的地方可以评论或私信