因MQTT 协议基于发布/订阅的异步通信模式,服务器控制设备后,将无法同步感知设备的返回结果。为解决此问题,物联网通信平台利用 RRPC(Revert RPC)实现同步通信机制。
$rrpc/rxd/${productID}/${deviceName}/+
用于订阅云端下发(下行)的 RRPC 请求消息。$rrpc/rxd/${productID}/${deviceName}/${processID}
用于云端发布(下行)RRPC 请求消息。$rrpc/txd/${productID}/${deviceName}/${processID}
用于发布(上行)RRPC 应答消息。说明:
${productID}
:产品 ID。${deviceName}
:设备名称。${processID}
: 服务器生成的唯一的消息 ID,用来标识不同 RRPC 消息。可以通过 RRPC 应答消息中携带的 processID 找到对应的 RRPC 请求消息。
注意:RRPC 请求4s超时,即4s内设备端没有应答就认为请求超时。
流程示意图如下:
示例为基于 Linux 平台利用设备端 C-SDK 完成接入,并结合腾讯云 API Explorer 工具完成接口的调用,具体使用步骤如下。
请参考 设备互通 创建空调产品,并创建 airConditioner1 空调设备。
修改CMakeLists.txt
确保以下选项存在:
set(BUILD_TYPE "release")
set(COMPILE_TOOLS "gcc")
set(PLATFORM "linux")
set(FEATURE_MQTT_COMM_ENABLED ON)
set(FEATURE_RRPC_ENABLED ON)
set(FEATURE_AUTH_MODE "KEY")
set(FEATURE_AUTH_WITH_NOTLS OFF)
set(FEATURE_DEBUG_DEV_INFO_USED OFF)
执行脚本编译:
./cmake_build.sh
示例输出rrpc_sample
位于output/release/bin
文件夹中。
将上面创建的 airConditioner1 设备的设备信息填写到 JSON 文件aircond_device_info1.json
中:
{
"auth_mode":"KEY",
"productId":"KL4J2****8",
"deviceName":"airConditioner1",
"key_deviceinfo":{
"deviceSecret":"zOZXUaycuwleP****78dBA=="
}
}
rrpc_sample
示例程序可以看到设备airConditioner1订阅了RRPC消息,然后处于等待状态。
./rrpc_sample -c ./aircond_device_info1.json -l 1000
INF|2020-08-03 23:57:55|qcloud_iot_device.c|iot_device_info_set(50): SDK_Ver: 3.2.0, Product_ID: KL4J2****8, Device_Name: airConditioner1
DBG|2020-08-03 23:57:55|HAL_TLS_mbedtls.c|HAL_TLS_Connect(200): Setting up the SSL/TLS structure...
DBG|2020-08-03 23:57:55|HAL_TLS_mbedtls.c|HAL_TLS_Connect(242): Performing the SSL/TLS handshake...
DBG|2020-08-03 23:57:55|HAL_TLS_mbedtls.c|HAL_TLS_Connect(243): Connecting to /KL4J2****8.iotcloud.tencentdevices.com/8883...
INF|2020-08-03 23:57:55|HAL_TLS_mbedtls.c|HAL_TLS_Connect(265): connected with /KL4J2****8.iotcloud.tencentdevices.com/8883...
INF|2020-08-03 23:57:56|mqtt_client.c|IOT_MQTT_Construct(113): mqtt connect with id: 2**** success
INF|2020-08-03 23:57:56|rrpc_sample.c|main(206): Cloud Device Construct Success
DBG|2020-08-03 23:57:56|mqtt_client_subscribe.c|qcloud_iot_mqtt_subscribe(142): topicName=$rrpc/rxd/KL4J2****8/airConditioner1/+|packet_id=****
INF|2020-08-03 23:57:56|rrpc_sample.c|_mqtt_event_handler(49): subscribe success, packet-id=*****
DBG|2020-08-03 23:57:56|rrpc_client.c|_rrpc_event_callback(104): rrpc topic subscribe success
PublishRRPCMessage
发送 RRPC 请求消息打开腾讯云 API控制台,填写个人密钥和设备参数信息,选择在线调用并发送请求。
观察设备 airConditioner1 的打印输出,可以看到已经收到 RRPC 请求消息,process id
为***。
DBG|2020-08-04 00:07:36|rrpc_client.c|_rrpc_message_cb(85): topic=$rrpc/rxd/KL4J2****8/airConditioner1/***
INF|2020-08-04 00:07:36|rrpc_client.c|_rrpc_message_cb(86): len=6, topic_msg=closed
INF|2020-08-04 00:07:36|rrpc_client.c|_rrpc_get_process_id(76): len=3, process id=***
INF|2020-08-04 00:07:36|rrpc_sample.c|_rrpc_message_handler(137): rrpc message=closed
观察设备 airConditioner1 的打印输出,可以看到已经处理了 RRPC 请求消息,并回复了 RRPC 应答消息,process id
为***。
DBG|2020-08-04 00:07:36|mqtt_client_publish.c|qcloud_iot_mqtt_publish(340): publish packetID=0|topicName=$rrpc/txd/KL4J2****8/airConditioner1/***|payload=ok
观察服务器的响应结果,可以看到已经收到了 RRPC 应答消息。MessageId
为***,Payload
经过base64
编码后为****,其与客户端实际应答消息经过base64
编码后一致。可以确认收到了应答消息。
本页内容是否解决了您的问题?