合宙Air780EP模塊Lua開發(fā)阿里云應(yīng)用指南

簡介

• 針對部分用戶在嘗試使用合宙Air780EP模塊連接阿里云時遇到的挑戰(zhàn)，今天我們就來詳細(xì)講解一下怎么利用LuatOS連接阿里云！超詳細(xì)的教程，讓你輕松上手！
• 關(guān)聯(lián)文檔和使用工具：
• LuatOS庫
• 阿里云平臺

我在本文簡單講述了利用LuatOS-Air進(jìn)行二次開發(fā)，采用一型一密、一機一密兩種方式認(rèn)證方式連接阿里云。

整體結(jié)構(gòu)如圖

一、準(zhǔn)備工作

1. Air780EP_全I(xiàn)O開發(fā)板一套，包括天線SIM卡，USB線

2.PC電腦，串口工具

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

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

阿里云介紹

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

二、API說明

三、實現(xiàn)流程

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

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

設(shè)置地域

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

四、阿里云操作

產(chǎn)品操作

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

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

設(shè)備操作

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

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

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

五、連接阿里云

LuatOS-Air方式連接概述

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

一機一密LuatOS-Air方式連接

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

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

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

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

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

最后將代碼保存，通過Luatools軟件將固件+腳本燒錄進(jìn)設(shè)備后，便能連接上阿里云了。

這是燒錄教程。

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

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

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

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

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

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

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

六、發(fā)布與訂閱消息

發(fā)布消息

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

--發(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. 制作差分升級文件包 生成差分包詳細(xì)步驟（https://doc.openluat.com/wiki/37?wiki_page_id=4578#__132）
3. 阿里云平臺上傳差分包

4.升級包驗證

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

總結(jié)

通過上面的步驟，現(xiàn)在的你應(yīng)該能夠成功使用LuatOS將合宙Air780EP模塊連接到阿里云IoT平臺了吧。
這不僅為您的物聯(lián)網(wǎng)項目提供了強大的云端支持，也為后續(xù)的數(shù)據(jù)處理、遠(yuǎn)程控制等功能奠定了堅實的基礎(chǔ)。
希望本文的詳細(xì)指導(dǎo)能夠幫助您順利解決連接問題，讓您的物聯(lián)網(wǎng)項目更加順暢地運行。

合宙支持LuatOS開發(fā)的模組型號，除本文介紹的Air780EP外， 還有Air780EPA、Air780E、Air780EX、Air201、Air780EPT、Air780EPS等型號， 本文介紹的接入阿里云的流程，同樣也適用于這些型號。