Air780EP模塊 LuatOS開發(fā)-MQTT接入阿里云應用指南

• 本文簡單講述了利用LuatOS-Air進行二次開發(fā)，采用一型一密、一機一密兩種方式認證方式連接阿里云。整體結(jié)構(gòu)如圖

• 關聯(lián)文檔和使用工具：
• LuatOS庫
• 阿里云平臺

準備工作

1. Air780EP_全IO開發(fā)板一套，包括天線SIM卡，USB線

PC電腦，串口工具

準備設備證書及產(chǎn)品證書 注意：下方證書信息僅為本教程使用，用戶需要使用自己的證書信息

--設備證書 { "ProductKey": "k1hipglLdjU", "DeviceName": "868488076506128", "DeviceSecret": "fef32adf6dad46c2c7cbf335d3a7b021" } --產(chǎn)品證書 { "ProductSecret": "8LQwOYSZMwp3DFBd", "ProductKey": "k1hipglLdjU" } --公共實例ID { "InstanceId"："iot-06z00ipoepm2g97" }

阿里云介紹

物聯(lián)網(wǎng)平臺提供安全可靠的設備連接通信能力，支持設備數(shù)據(jù)采集上云，規(guī)則引擎流轉(zhuǎn)數(shù)據(jù)和云端數(shù)據(jù)下發(fā)設備端。此外，也提供方便快捷的設備管理能力，支持物模型定義，數(shù)據(jù)結(jié)構(gòu)化存儲，和遠程調(diào)試、監(jiān)控、運維。阿里云物聯(lián)網(wǎng)平臺為設備提供安全可靠的連接通信能力，向下連接海量設備，支撐設備數(shù)據(jù)采集上云；向上提供云端API，服務端通過調(diào)用云端API將指令下發(fā)至設備端，實現(xiàn)遠程控制。物聯(lián)網(wǎng)平臺消息通信流程圖如下。

API說明

詳細的API介紹請參見aLiYun章節(jié)

實現(xiàn)流程

注冊接入服務器結(jié)果回調(diào)函數(shù)

在收到true時表示連接成功，本demo中去發(fā)布一條QOS為1的消息給阿里云。

設置地域

配置為在阿里云創(chuàng)建項目時所用地區(qū)。每個地域完全獨立。每個可用區(qū)完全隔離，但同一個地域內(nèi)的可用區(qū)之間使用低時延鏈路相連。地域和可用區(qū)之間的關系如下圖所示。

阿里云操作

產(chǎn)品操作

打開阿里云平臺找到物聯(lián)網(wǎng)平臺，開通業(yè)務后進入控制臺。

點開設備管理的產(chǎn)品頁面，點擊新建產(chǎn)品。根據(jù)需求和圖示說明創(chuàng)建產(chǎn)品。

具體詳細介紹見阿里云頁面

設備操作

創(chuàng)建產(chǎn)品完成后就可以進入設備頁面添加設備，在對應產(chǎn)品頁面進入設備管理，按照提示添加設備

（在做正式產(chǎn)品時建議使用imei為devicename，方便后期維護）

阿里云設備創(chuàng)建

連接阿里云

LuatOS-Air方式連接概述

LuatOS-Air連接相比AT更為簡單，只需要簡單的配置即可連接，還可以靈活的對數(shù)據(jù)進行處理。需要從官網(wǎng)或者github下載aliyun的腳本包，或者使用luatoolsv2會自動下載腳本資源，在工具根目錄的\Luatools\resource\soc_script\v2024.06.25.16\demo\aliyun中腳本資源會隨官網(wǎng)同步更新，具體版本可能和本文不同，不過功能都是一致的。

文檔中用到的API接口見aLiYun API章節(jié)。

一機一密LuatOS-Air方式連接

一機一密需要提前按照文檔中阿里云操作章節(jié)事先建好產(chǎn)品并添加設備。

然后找到所使用的腳本版本進入demo目錄找到aliyun文件夾打開main.lua，根據(jù)下方圖示打開這三行的require（如果有被注釋掉，將注釋去掉），并將其他不相關的注釋掉。

接著打開testYjym.lua，根據(jù)后面的操作修改三元組信息（DeviceName、ProductKey、DeviceSecret）和InstanceId信息。

首先將testYjym.lua中的三元組信息（DeviceName、ProductKey、DeviceSecret）修改為自己項目中的三元組信息。通過下方圖示可找到自己項目中的三元組信息。

然后在實例詳情頁面，找到實例id并將其填寫到代碼中對應位置。

最后將代碼保存，通過Luatools軟件將固件+腳本燒錄進設備后，便能連接上阿里云了。這是燒錄教程。

一型一密LuatOS-Air方式連接（公共實例）

除了需要添加產(chǎn)品和設備外還需要在阿里云平臺中打開對應產(chǎn)品的動態(tài)注冊開關

先找到所使用的腳本版本進入demo目錄找到aliyun文件夾打開main.lua，根據(jù)下方圖示打開這兩行的require（如果有被注釋掉，將注釋去掉），并將其他不相關的注釋掉。

接著打開testYxym.lua，根據(jù)后面的操作修改DeviceName、ProductKey、ProductSecret和InstanceId信息。

其中DeviceName、ProductKey和InstanceId信息的位置在一機一密LuatOS-Air方式連接中已指出。下圖為ProductSecret信息的位置。

接著將DeviceName、ProductKey、ProductSecret和InstanceId信息填寫到testYxym.lua中對應位置。

最后將代碼保存，通過Luatools軟件將固件+腳本燒錄進設備后，便能連接上阿里云了。這是燒錄教程。 注意：第一次使用一型一密時，設備要處于未激活狀態(tài)。

發(fā)布與訂閱消息

發(fā)布消息

發(fā)布消息使用的是**aliyun.publish(topic,qos,payload,cbFnc,cbPara)**這個API。

在demo里**publishTest()**這個函數(shù)演示了接口的操作。無需修改即可實現(xiàn)每20s向阿里云推送一條消息。

--發(fā)布一條QOS為1的消息 function publishTest() --注意：在此處自己去控制payload的內(nèi)容編碼，aLiYun庫中不會對payload的內(nèi)容做任何編碼轉(zhuǎn)換 -- aliyun.publish(topic,qos,payload,cbFnc,cbPara) log.info("aliyun", "上行數(shù)據(jù)") aliyun.publish("/"..aliyun.opts.ProductKey.."/"..aliyun.opts.DeviceName.."/user/update",1,"LUATOS_CESHI",publishTestCb,"publishTest_"..publishCnt) end

訂閱消息

訂閱使用的是aLiYun.subscribe(topic, qos)

以下代碼為訂閱的操作，用戶可根據(jù)自己的項目需要訂閱主題。

--- 連接結(jié)果的處理函數(shù) -- @bool result，連接結(jié)果，true表示連接成功，false或者nil表示連接失敗 local function connectCbFnc(result) log.info("aliyun","連接結(jié)果", result) if result then sys.publish("aliyun_ready") log.info("aliyun", "連接成功") --訂閱主題 --根據(jù)自己的項目需要訂閱主題 -- aliyun.subscribe(topic,qos) -- aliyun.subscribe("/".. aliyun.opts.ProductKey.."/".. aliyun.opts.DeviceName.."/user/ceshi",1) --PUBLISH消息測試 publishTest() else log.warn("aliyun", "連接失敗") end end

OTA升級

1. 建立項目并接入阿里云
2. 制作差分升級文件包 生成差分包詳細步驟
3. 阿里云平臺上傳差分包

1. 升級包驗證

1. 平臺查看升級結(jié)果