thingsboard使用RPC

<think>嗯，用户正在询问ThingsBoard中如何使用RPC进行设备通信和控制，希望得到配置指南和具体示例。从用户提供的站内引用来看，ta应该是个物联网开发者或系统集成人员，正在研究ThingsBoard的设备控制方案。用户明确要求了"使用指南+示例+配置"，说明需要实操性强的指导。注意到用户引用的材料已经区分了两种RPC模式（客户端RPC和服务器端RPC），还提到具体的小部件和函数格式。不过第四篇引用讨论的是源码架构，可能不是用户当前需要的重点。用户上次的问题也与RPC相关，看来是在系统学习这个功能。需要把零散的引用内容组织成逻辑清晰的操作流程。首先应该明确RPC类型差异（这会影响实施方式），然后具体到：1)操作入口（界面路径）2)参数设置关键字段3)设备端配套实现4)调试要点。引用3中的PLC寄存器格式和函数码特别重要，这是工业场景的实际配置范例。用户没提设备具体协议，但引用3暴露了ModbusTCP需求（通过functionCode字段），所以PLC控制示例要保留。开关和旋钮小部件是最常用控件，必须包含。另外引用4提到WebSocket和集群部署，虽然用户没直接问，但在高并发场景下可能影响RPC实施，需要补充在注意事项里。代码示例方面，引用1的JavaScript片段和设备回调模板很实用，用户能直接复制使用。但要注意标注清楚服务端RPC和设备端RPC的参数差异——引用2特别强调过这点。最后考虑给个建议：当用户完成基础操作后，可以尝试自定义小部件或kafka集群配置（引用1和4的内容），为后续问题埋个伏笔。</think> 以下是ThingsBoard中RPC功能的完整使用指南，包含配置步骤、代码示例和实践场景： --- ### **一、RPC通信类型** 根据引用[2]的分类： 1. **客户端RPC**（设备主动请求） - 设备向平台发起指令请求（如获取配置） - 实现方式：设备订阅 `v1/devices/me/rpc/request/+` 主题 2. **服务器端RPC**（平台主动控制设备） - 平台向设备发送控制命令（如开关指令） - 实现方式：通过仪表板控件或API调用 --- ### **二、服务器端RPC操作指南** #### **场景：通过仪表板控制设备开关** 1. **创建RPC控件**（引用[1]） - 进入仪表板 → 添加部件 → 选择「开关控制」 - 关键配置： ```yaml 目标设备: {设备名称} RPC方法: setSwitchState # 自定义方法名 参数格式: {"enabled": <true/false>} # 设备端定义的参数 ``` - 效果：用户点击开关时发送`{ "method": "setSwitchState", "params": { "enabled": true } }` 2. **设备端实现**（引用[3]以Modbus设备为例） ```python # 订阅RPC请求主题 client.subscribe("v1/devices/me/rpc/request/+") def on_message(msg): if msg.topic == "setSwitchState": # 解析PLC寄存器操作指令 register = msg.json["params"]["address"] value = 1 if msg.json["params"]["enabled"] else 0 # 调用Modbus写入函数（引用[3]格式） modbus_write(register, value, function_code=6) ``` --- ### **三、客户端RPC操作指南** #### **场景：设备主动获取配置** 1. **设备端发起请求** ```python # 发布请求到平台 request_id = 1 client.publish("v1/devices/me/rpc/request/"+str(request_id), '{"method":"getConfig"}') ``` 2. **平台处理逻辑** - 在规则链中配置「RPC Call Reply」节点 - 脚本生成响应数据： ```javascript return { data: {"interval": 60, "threshold": 25.5} //返回设备配置 }; ``` 3. **设备接收响应** 监听`v1/devices/me/rpc/response/+`主题解析数据 --- ### **四、API直接调用RPC（引用[4]）** ```bash curl -X POST http://{tb-core}:9090/api/rpc/{deviceId} \ -H 'Content-Type: application/json' \ -d '{ "method": "adjustTemperature", "params": {"target": 22} }' #通过核心服务调用（需设备权限） ``` --- ### **五、调试与注意事项** 1. **权限验证** - 确保设备已添加「RPC」权限策略（参考访问令牌配置） 2. **参数格式** - PLC设备需遵循引用[3]的寄存器格式： `{"method":"write", "params": {"functionCode":16, "address":40001, "value":255}}` 3. **高可用部署** - 集群环境下引用[4]说明：通过Kafka分发RPC请求，确保目标设备所在节点处理消息 --- ### **示例仪表板效果** ```mermaid graph LR 用户点击开关 --> 平台发送RPC请求 --> 设备修改寄存器值 --> 更新状态回显到仪表板 ```