功能原理

應用程序通過調用C Link SDK的API，基于CoAP的協(xié)議，與物聯(lián)網(wǎng)平臺建立的連接。

如下功能時序圖，以設備的應用程序./demos/coap_basic_demo.c為例，介紹應用程序實現(xiàn)該功能的流程。

CoAP接入API的更多信息，請參見aiot_coap_api.h。

使用限制

• 僅華東2（上海）、華北2（北京）、華南1（深圳）地域支持CoAP通信。

• 僅華東2（上海）地域支持設備使用CoAP短連接狀態(tài)接入物聯(lián)網(wǎng)平臺。使用CoAP短連接的設備，在物聯(lián)網(wǎng)平臺控制臺也有在線和離線狀態(tài)變化。您可通過AMQP服務端訂閱設備上下線狀態(tài)變化時通知的消息。

• 暫時不支持資源發(fā)現(xiàn)。

• 僅支持UDP協(xié)議，目前支持DTLS和對稱加密兩種安全模式。

• 設備身份注冊成功后，針對同一設備身份信息，只可選擇一種通信協(xié)議接入物聯(lián)網(wǎng)平臺，不可多種類型通信協(xié)議同時混用。

使用說明

• CoAP的URI資源和MQTT Topic保持一致，請參見MQTT協(xié)議規(guī)范。

• Topic規(guī)范與MQTT Topic規(guī)范一致，CoAP協(xié)議內coap://host:port/topic/${topic}接口中的${topic}可以復用MQTT Topic。

• 客戶端緩存認證返回的Token是請求的令牌。

• 傳輸?shù)臄?shù)據(jù)大小依賴于MTU的大小，建議在1 KB以內。

• 如果設備在10分鐘內使用CoAP協(xié)議上報過數(shù)據(jù)，則設備在物聯(lián)網(wǎng)平臺控制臺顯示為在線狀態(tài)。

使用示例

• CoAP接入功能的參考示例，請參見使用示例。

• CoAP接入功能相關錯誤碼，請參見aiot_coap_api.h中的狀態(tài)碼描述。