合宙的Air201模組，功耗低，品質穩定，購買樣品也方便，且資料全開放。

問題是：用合宙的Air201模組，直接開發OpenCPU的應用，夠方便嗎？

可以不用熟悉繁瑣的環境搭建嗎？

可以不用關注繁瑣的編譯選項嗎？

可以不用關心繁瑣的C語言陷阱嗎？

可以用寥寥幾行代碼，就完成模組對外設的控制，和服務器的通信嗎？

答案是：完全可以！

接下來，我將用手把手的教程，教會你怎么在合宙Air201模組里面，用腳本寫代碼，開發各種應用。

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

一、 Air201模組是什么

合宙Air201資產定位模組——是一個集成超低功耗4G通信、語音通話、超低功耗定位、計步、震動、Type-C、充電、放音、錄音等功能的超小PCBA。

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

二、hello world教程

本章節教你怎么用簡單的幾個步驟，就可以完成一個helloworld項目，讓合宙4G模組輕松打印hello world！

要達到這個目標，你只需要學會用一個名字叫做LuaTools的PC工具——往模組燒錄固件和腳本，并用這個同樣的LuaTools查看模組的打印日志。

一切就是這么的簡單！

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

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

這個項目的產品定義是：

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

要想達到這個目的，這里有必要先介紹一下LuatOS在合宙4G模組的運行原理：

- LuatOS在合宙4G模組的運行原理 -

合宙的4G模組，除了運行4G協議棧之外，還植入了5.3版本的Lua虛擬機，以及內置的一個腳本代碼區。

4G模組上電之后，虛擬機會去代碼區讀取腳本代碼的main入口， 并執行這個main入口函數。

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

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

在完成這個初始項目之前， 你還需要準備好一套合適的硬件。

合適的硬件是什么呢？

——是合宙的能運行LuatOS腳本的4G模組。

怎么知道合宙的哪些4G模組能運行LuatOS呢？

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

進入這個網址后，你看到如下以LuatOS開頭的代碼倉庫，就是可以支持LuatOS開發的型號：

如上圖，Air201、Air780E等，都是能夠運行LuatOS的模組型號。

你要想運行哪個模組的軟件，就在合宙官方淘寶店購買對應的模組開發板，然后進入對應的代碼倉庫，就可以開發了！

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

所以，我已經事先準備好了合宙Air201，你準備好了嗎？直接用Air201的PCBA調試，或用Air201整機調試都可以。

2.2 下載模組的示例代碼

下載示例代碼，到一個合適的項目目錄。

01）在Gitee注冊賬戶

https://gitee.com/signup

02）下載git，一路默認安裝

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

03）下載git管理工具TortoiseGit，一路默認安裝

https://tortoisegit.org/download/

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

04）下拉代碼

右擊鼠標克隆代碼

下載對應的倉庫 -
https://gitee.com/openLuat/LuatOS-Air201.git

下拉代碼成功

2.3 修改代碼

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

LuatOS-Air201/demo/hello_world/main.lua

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

打開main.lua， 是這個樣子的代碼：

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

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

然后保存，代碼修改工作就大功告成了！
是不是超級簡單？

2.4 燒錄代碼到硬件

燒錄代碼，需要進行如下幾步：

01）下載和安裝合宙調試工具LuaTools

要想燒錄代碼，先要下載合宙自研的功能強大的調試工具——LuaTools。如果你已經安裝使用過LuaTools（注：需要升級到最新版本），可以直接跳到下個小節：燒錄代碼。

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

- LuaTools主要功能 -

自動從合宙服務器獲取最新的合宙模組固件；

燒錄固件和腳本；

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

簡單的串口調試。

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

02）燒錄代碼

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

Core固件是代碼路徑下core文件夾的.soc文件，可以理解為運行環境，腳本會在Core上運行，所以兩個都要下載。

燒錄操作流程

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

使用帶有數據通信功能的數據線，不要使用僅有充電功能的數據線。

Step 2. 新建項目

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

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

LuaTools版本沒問題的話，點擊LuaTools右上角的“項目管理測試”按鈕。

如下圖所示：

這時，會彈出項目管理和燒錄管理的對話框。

如下圖所示：

下載過程如果出現找不到端口，注意看下數據線連接是否有問題：

Step 3. 開始燒錄

03）燒錄問題排查

如果你在燒錄過程中遇到了問題，請點擊如下鏈接，進行燒錄的問題排查。

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

2.5 驗證功能

燒錄完成后，會自動開機，此時電腦的設備管理器中會虛擬出三個端口表示正常開機：

LuaTools會自動抓取應用日志和系統日志，并且在主界面解析顯示應用日志。

如下圖所示（點擊放大查看）：

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

太棒了！你成功了！
下一期，我們一起來學習Air201的點燈…