資產(chǎn)定位 | 合宙Air201模組LuatOS快速入門01-hello world

合宙的Air201模組，功耗低，品質(zhì)穩(wěn)定，購買樣品也方便，且資料全開放。

問題是：用合宙的Air201模組，直接開發(fā)OpenCPU的應(yīng)用，夠方便嗎？

可以不用熟悉繁瑣的環(huán)境搭建嗎？

可以不用關(guān)注繁瑣的編譯選項(xiàng)嗎？

可以不用關(guān)心繁瑣的C語言陷阱嗎？

可以用寥寥幾行代碼，就完成模組對(duì)外設(shè)的控制，和服務(wù)器的通信嗎？

答案是：完全可以！

接下來，我將用手把手的教程，教會(huì)你怎么在合宙Air201模組里面，用腳本寫代碼，開發(fā)各種應(yīng)用。

篇幅原因，本期先講解基于LuatOS開發(fā)的hello world教程。

一、 Air201模組是什么

合宙Air201資產(chǎn)定位模組——是一個(gè)集成超低功耗4G通信、語音通話、超低功耗定位、計(jì)步、震動(dòng)、Type-C、充電、放音、錄音等功能的超小PCBA。

內(nèi)部集成高效、簡(jiǎn)單、可靠的LuatOS語言，旨在幫助客戶降低開發(fā)難度，降低研發(fā)成本，以及打造超小超低功耗的精品產(chǎn)品。

二、hello world教程

本章節(jié)教你怎么用簡(jiǎn)單的幾個(gè)步驟，就可以完成一個(gè)helloworld項(xiàng)目，讓合宙4G模組輕松打印hello world！

要達(dá)到這個(gè)目標(biāo)，你只需要學(xué)會(huì)用一個(gè)名字叫做LuaTools的PC工具——往模組燒錄固件和腳本，并用這個(gè)同樣的LuaTools查看模組的打印日志。

一切就是這么的簡(jiǎn)單！

2.1 必須先要告訴你的一些廢話

這里，先要告訴你一些前提條件，雖然聽著像是廢話，但是如果不知道的話，可能后面會(huì)比較懵逼，所以還是希望你能夠認(rèn)真看一看這一節(jié)。

這個(gè)項(xiàng)目的產(chǎn)品定義是：

模組每隔3秒，就往串口輸出一次“hello world”字符串。

要想達(dá)到這個(gè)目的，這里有必要先介紹一下LuatOS在合宙4G模組的運(yùn)行原理：

- LuatOS在合宙4G模組的運(yùn)行原理 -

合宙的4G模組，除了運(yùn)行4G協(xié)議棧之外，還植入了5.3版本的Lua虛擬機(jī)，以及內(nèi)置的一個(gè)腳本代碼區(qū)。

4G模組上電之后，虛擬機(jī)會(huì)去代碼區(qū)讀取腳本代碼的main入口， 并執(zhí)行這個(gè)main入口函數(shù)。

你只需要用Lua腳本改寫main入口函數(shù)，并把這個(gè)腳本燒錄到模組的正確位置，就可以正確運(yùn)行腳本的代碼。

幸運(yùn)的是，你只需要用合宙的LuaTools工具燒錄腳本，就一定能保證腳本燒錄到正確的位置。

在完成這個(gè)初始項(xiàng)目之前， 你還需要準(zhǔn)備好一套合適的硬件。

合適的硬件是什么呢？

——是合宙的能運(yùn)行LuatOS腳本的4G模組。

怎么知道合宙的哪些4G模組能運(yùn)行LuatOS呢？

打開這個(gè)代碼倉庫的網(wǎng)址，你會(huì)看到合宙公開的一系列代碼倉庫。合宙不僅僅公開了每個(gè)模組的示例代碼，還把缺陷跟蹤也公開了，真是絕對(duì)自信！

進(jìn)入這個(gè)網(wǎng)址后，你看到如下以LuatOS開頭的代碼倉庫，就是可以支持LuatOS開發(fā)的型號(hào)：

如上圖，Air201、Air780E等，都是能夠運(yùn)行LuatOS的模組型號(hào)。

你要想運(yùn)行哪個(gè)模組的軟件，就在合宙官方淘寶店購買對(duì)應(yīng)的模組開發(fā)板，然后進(jìn)入對(duì)應(yīng)的代碼倉庫，就可以開發(fā)了！

今天，我們用LuatOS-Air201這個(gè)倉庫作為例子。

所以，我已經(jīng)事先準(zhǔn)備好了合宙Air201，你準(zhǔn)備好了嗎？直接用Air201的PCBA調(diào)試，或用Air201整機(jī)調(diào)試都可以。

2.2 下載模組的示例代碼

下載示例代碼，到一個(gè)合適的項(xiàng)目目錄。

01）在Gitee注冊(cè)賬戶

https://gitee.com/signup

02）下載git，一路默認(rèn)安裝

https://git-scm.com/download/win

03）下載git管理工具TortoiseGit，一路默認(rèn)安裝

https://tortoisegit.org/download/

此處填寫第一步在Gitee上注冊(cè)的名稱和Email。

04）下拉代碼

右擊鼠標(biāo)克隆代碼

下載對(duì)應(yīng)的倉庫 -
https://gitee.com/openLuat/LuatOS-Air201.git

下拉代碼成功

2.3 修改代碼

用編輯器打開你下載下來的main.lua文件：

LuatOS-Air201/demo/hello_world/main.lua

我是習(xí)慣用VSCode，也可以用記事本。如果你是用其他的編輯器，也差不多類似。

打開main.lua， 是這個(gè)樣子的代碼：

這個(gè)代碼，第12行打印了 “hi, LuatOS”，而不是“hello world”，這就給你留下了發(fā)揮的空間。

你把這段代碼稍作修改后，改為這樣：

然后保存，代碼修改工作就大功告成了！
是不是超級(jí)簡(jiǎn)單？

2.4 燒錄代碼到硬件

燒錄代碼，需要進(jìn)行如下幾步：

01）下載和安裝合宙調(diào)試工具LuaTools

要想燒錄代碼，先要下載合宙自研的功能強(qiáng)大的調(diào)試工具——LuaTools。如果你已經(jīng)安裝使用過LuaTools（注：需要升級(jí)到最新版本），可以直接跳到下個(gè)小節(jié)：燒錄代碼。

LuaTools工具最新版本的介紹和下載鏈接：
https://doc.openluat.com/wiki/52?wiki_page_id=5071

- LuaTools主要功能 -

自動(dòng)從合宙服務(wù)器獲取最新的合宙模組固件；

燒錄固件和腳本；

查看和保存模組的串口輸出日志；

簡(jiǎn)單的串口調(diào)試。

LuaTools下載之后，無需安裝，解壓到你的硬盤，點(diǎn)擊Luatools_v2.exe運(yùn)行，出現(xiàn)如下界面，就代表LuaTools安裝成功了：

02）燒錄代碼

首先要說明一點(diǎn)：腳本代碼，要和Core文件一起燒錄。

Core固件是代碼路徑下core文件夾的.soc文件，可以理解為運(yùn)行環(huán)境，腳本會(huì)在Core上運(yùn)行，所以兩個(gè)都要下載。

燒錄操作流程

Step 1. 正確連接電腦和4G模組電路板

使用帶有數(shù)據(jù)通信功能的數(shù)據(jù)線，不要使用僅有充電功能的數(shù)據(jù)線。

Step 2. 新建項(xiàng)目

首先，確保你的LuaTools的版本，大于3.0.0版本；在LuaTools的左上角有顯示版本信息。

如下圖所示【注意勾選4G模塊USB打印】：

LuaTools版本沒問題的話，點(diǎn)擊LuaTools右上角的“項(xiàng)目管理測(cè)試”按鈕。

如下圖所示：

這時(shí)，會(huì)彈出項(xiàng)目管理和燒錄管理的對(duì)話框。

如下圖所示：

下載過程如果出現(xiàn)找不到端口，注意看下數(shù)據(jù)線連接是否有問題：

Step 3. 開始燒錄

03）燒錄問題排查

如果你在燒錄過程中遇到了問題，請(qǐng)點(diǎn)擊如下鏈接，進(jìn)行燒錄的問題排查。

詳細(xì)的燒錄操作步驟參考此處：
https://doc.openluat.com/wiki/52?wiki_page_id=5071#_23

2.5 驗(yàn)證功能

燒錄完成后，會(huì)自動(dòng)開機(jī)，此時(shí)電腦的設(shè)備管理器中會(huì)虛擬出三個(gè)端口表示正常開機(jī)：

LuaTools會(huì)自動(dòng)抓取應(yīng)用日志和系統(tǒng)日志，并且在主界面解析顯示應(yīng)用日志。

如下圖所示（點(diǎn)擊放大查看）：

從打印的日志可以看到——這個(gè)4G開發(fā)板，在不斷的打印hello world。

太棒了！你成功了！
下一期，我們一起來學(xué)習(xí)Air201的點(diǎn)燈…