物聯網設備要互動，Air780EP模塊是橋梁。

用AT指令告訴MQTT：“幫我把話帶給OneNET吧！”MQTT就忙著打包數據，像寄信一樣傳給OneNET。

OneNET收到后，處理、存著或再轉發。這過程，Air780EP和MQTT是最佳拍檔，讓設備互聯變得輕松又靠譜。

想不想試試這簡單又神奇的操作？

那就來吧！

本文詳細講解了基于合宙的Air80EP開發板，使用AT指令，通過MQTT接入OneNET平臺的教程。

OneNET Studio提供了強大的數據處理能力、靈活的設備接入方式以及豐富的API接口。

官網地址：OneNET - 中國移動物聯網開放平臺

一、材料準備

為了順利展開本次接入實踐，需要準備以下關鍵材料：

Air780EP開發板一套：

合宙Air780EP模組采用了微安級極致低功耗設計，長連接待機功耗（5分鐘心跳）低至450微安，該模組支持中國移動、電信、聯通三大運營商的4G網絡，實現了全網通覆蓋，采用LGA高集成封裝，多達109個SMT焊盤管腳。支持AT指令集、和LuatOS腳本開發，除了MQTT協議外，還支持TCP、UDP、HTTP、WebSocket、FTP、NTP等多種網絡協議。

USB線：作為連接開發板與PC電腦的重要紐帶，請選用質量可靠、傳輸速度穩定的USB線，以確保數據傳輸的順暢無阻。

PC電腦：請確保電腦系統穩定，已安裝必要的驅動程序和串口通信軟件，以便能夠順利與Air780EP(V)開發板進行交互。

串口工具：作為與Air780EP(V)開發板進行AT指令交互的必備軟件，串口工具將幫助您發送指令、接收響應，并實時監控設備狀態。

準備就緒后，您就可以按照本指南的步驟，逐步完成Air780EP開發板通過MQTT協議接入OneNET Studio的全過程。

二、在onenet上創建產品

打開OneNET官網，進入控制臺，進入Onenet Studio，選擇設備接入與管理，點擊產品管理

點擊添加產品

根據自己產品填寫，注意：節點類型選擇直連設備，接入協議選擇MQTT，點擊確定

點擊詳情

將右上角自動注冊打開

記住產品ID和產品key

三、創建設備

填入設備名，選擇產品，這里我使用的是模塊的imei來做設備名稱

四、查看onenet接入協議

MQTT設備連接_開發者文檔_OneNET (10086.cn))

可以看到，登入onenet時，mqtt的clientID、username和password都有指定

clientId即為剛才創建的設備名稱

username為創建的產品ID

password是需要經過加密計算得來的鑒權token

計算方法詳見如下文章，這篇文章測試時直接使用onenet提供的測試工具來計算鑒權密碼，鑒權計算測試工具下面連接中下載

接入安全認證_開發者文檔_OneNET (10086.cn)

五、連接onenet

1.查詢卡、網絡注冊狀態

具體交互流程如下所示

查詢SIM卡狀態 AT+CPIN? +CPIN: READY OK 查詢信號質量 AT+CSQ +CSQ: 16,0 OK 查詢網絡附著狀態 AT+CGATT? +CGATT: 1 OK AT+CGDCONT? +CGDCONT: 1,"IP","cmiot","10.126.200.230" OK

2.MQTT直連onenet

設備注冊參數如下：

mqttClientId: devicename mqttUsername: productID mqttPassword: token

下圖為工具計算出的token

AT+MCONFIG="868655072230313","Wf5IXIGcZn","version=2018-10-31&res=products%2FWf5IXIGcZn%2Fdevices%2F868655072230313&et=1721630715&method=md5&sign=DPqCcsPQAQok9Gt7mNPTbA%3D%3D" OK AT+MIPSTART="studio-mqtt.heclouds.com",1883 OK CONNECT OK AT+MCONNECT=1,120 OK CONNACK OK

可以從平臺上看到設備已經在線了

3.發布與訂閱消息

onenet studio有固定的通信TOPIC，可以到官網查看，這里演示下設備屬性上報與響應的主題

通信主題_開發者文檔_OneNET (10086.cn)

訂閱消息：

AT+MSUB="$sys/Wf5IXIGcZn/868655072230313/thing/property/post/reply",0 OK SUBACK

發布

向設備上報屬性的主題發布消息，消息攜帶設備的屬性，不同的產品具有不同的屬性，可以在設備物模型處查看

例如：在文章開始創建的產品具有如下圖所示的屬性

向上報屬性的主題發布一條payload格式錯誤的消息 AT+MPUB="$sys/q23GT8XVOu/868739055238251/thing/property/post",0,0,"{}" OK 平臺返回缺少參數 +MSUB: "$sys/q23GT8XVOu/868739055238251/thing/property/post/reply",47 byte,{"id":null,"code":2403,"msg":"required msg id"} 如下是正常流程 AT+MPUB="$sys/Wf5IXIGcZn/868655072230313/thing/property/post",0,0,"{\22id\22:\22123\22,\22params\22:{\22Capacity\22:{\22value\22:62}}}" OK 平臺返回成功 +MSUB: "$sys/Wf5IXIGcZn/868655072230313/thing/property/post/reply",39 byte,{"id":"123","code":200,"msg":"success"}

可以看到平臺已經有數據更新