资产定位 | 合宙Air201模组LuatOS快速入门01-hello world

随笔2个月前发布 勤能致富
37 0 0

合宙的Air201模组,功耗低,品质稳定,购买样品也方便,且资料全开放。

问题是:用合宙的Air201模组,直接开发OpenCPU的应用,够方便吗?

可以不用熟悉繁琐的环境搭建吗?

可以不用关注繁琐的编译选项吗?

可以不用关心繁琐的C语言陷阱吗?

可以用寥寥几行代码,就完成模组对外设的控制,和服务器的通信吗?

答案是:完全可以!

接下来,我将用手把手的教程,教会你怎么在合宙Air201模组里面,用脚本写代码,开发各种应用。

篇幅原因,本期先讲解基于LuatOS开发的hello world教程。

一、Air201模组是什么

资产定位 | 合宙Air201模组LuatOS快速入门01-hello world

合宙Air201资产定位模组——是一个集成超低功耗4G通信、语音通话、超低功耗定位、计步、震动、Type-C、充电、放音、录音等功能的超小PCBA。

内部集成高效、简单、可靠的LuatOS语言,旨在帮助客户降低开发难度,降低研发成本,以及打造超小超低功耗的精品产品。

合宙Air201最新资料下载链接:
www.hezhoudingwei.com

二、hello world教程

本章节教你怎么用简单的几个步骤,就可以完成一个helloworld项目,让合宙4G模组轻松打印hello world!

要达到这个目标,你只需要学会用一个名字叫做LuaTools的PC工具——往模组烧录固件和脚本,并用这个同样的LuaTools查看模组的打印日志。

一切就是这么的简单!

LuaTools工具最新版本的介绍和下载链接:
https://doc.openluat.com/wiki/52?wiki_page_id=5071

2.1 必须先要告诉你的一些废话

这里,先要告诉你一些前提条件,虽然听着像是废话,但是如果不知道的话,可能后面会比较懵逼,所以还是希望你能够认真看一看这一节。

这个项目的产品定义是:

模组每隔3秒,就往串口输出一次“hello world”字符串。

要想达到这个目的,这里有必要先介绍一下LuatOS在合宙4G模组的运行原理:

– LuatOS在合宙4G模组的运行原理 –

合宙的4G模组,除了运行4G协议栈之外,还植入了5.3版本的Lua虚拟机,以及内置的一个脚本代码区。

4G模组上电之后,虚拟机会去代码区读取脚本代码的main入口, 并执行这个main入口函数。

你只需要用Lua脚本改写main入口函数,并把这个脚本烧录到模组的正确位置,就可以正确运行脚本的代码。幸运的是,你只需要用合宙的LuaTools工具烧录脚本,就一定能保证脚本烧录到正确的位置。

在完成这个初始项目之前, 你还需要准备好一套合适的硬件。

合适的硬件是什么呢?

——是合宙的能运行LuatOS脚本的4G模组。

怎么知道合宙的哪些4G模组能运行LuatOS呢?

要想知道答案,你一定要记住一个网址:

https://gitee.com/openluat

打开这个代码仓库的网址,你会看到合宙公开的一系列代码仓库。合宙不仅仅公开了每个模组的示例代码,还把缺陷跟踪也公开了,真是绝对自信!

进入这个网址后,你看到如下以LuatOS开头的代码仓库,就是可以支持LuatOS开发的型号:

资产定位 | 合宙Air201模组LuatOS快速入门01-hello world

如上图,Air201、Air780E等,都是能够运行LuatOS的模组型号。

你要想运行哪个模组的软件,就在合宙官方淘宝店购买对应的模组开发板,然后进入对应的代码仓库,就可以开发了!

今天,我们用LuatOS-Air201这个仓库作为例子。

所以,我已经事先准备好了合宙Air201,你准备好了吗?

直接用Air201的PCBA调试,或用Air201整机调试都可以。

资产定位 | 合宙Air201模组LuatOS快速入门01-hello world

2.2 下载模组的示例代码

下载示例代码,到一个合适的项目目录。

01)在Gitee注册账户

https://gitee.com/signup

02)下载git,一路默认安装

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

03)下载git管理工具TortoiseGit,一路默认安装

https://tortoisegit.org/download/

资产定位 | 合宙Air201模组LuatOS快速入门01-hello world

此处填写第一步在Gitee上注册的名称和Email。

04)下拉代码

右击鼠标克隆代码

资产定位 | 合宙Air201模组LuatOS快速入门01-hello world

下载对应的仓库 –
https://gitee.com/openLuat/LuatOS-Air201.git

资产定位 | 合宙Air201模组LuatOS快速入门01-hello world

下拉代码成功

资产定位 | 合宙Air201模组LuatOS快速入门01-hello world

2.3 修改代码

用编辑器打开你下载下来的main.lua文件:

LuatOS-Air201/demo/hello_world/main.lua

资产定位 | 合宙Air201模组LuatOS快速入门01-hello world

我是习惯用VSCode,也可以用记事本。如果你是用其他的编辑器,也差不多类似。

打开main.lua, 是这个样子的代码:

资产定位 | 合宙Air201模组LuatOS快速入门01-hello world

这个代码,第12行打印了 “hi, LuatOS”,而不是“hello world”,

这就给你留下了发挥的空间。

你把这段代码稍作修改后,改为这样:

资产定位 | 合宙Air201模组LuatOS快速入门01-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安装成功了:

资产定位 | 合宙Air201模组LuatOS快速入门01-hello world

02)烧录代码

首先要说明一点:脚本代码,要和Core文件一起烧录。

资产定位 | 合宙Air201模组LuatOS快速入门01-hello world

Core固件是代码路径下core文件夹的.soc文件,可以理解为运行环境,脚本会在Core上运行,所以两个都要下载。

####烧录操作流程

Step 1. 正确连接电脑和4G模组电路板

使用带有数据通信功能的数据线,不要使用仅有充电功能的数据线。

Step 2. 新建项目

首先,确保你的LuaTools的版本,大于3.0.0版本;在LuaTools的左上角有显示版本信息。

如下图所示【注意勾选4G模块USB打印】:
资产定位 | 合宙Air201模组LuatOS快速入门01-hello world

LuaTools版本没问题的话,点击LuaTools右上角的“项目管理测试”按钮。

如下图所示:
资产定位 | 合宙Air201模组LuatOS快速入门01-hello world

这时,会弹出项目管理和烧录管理的对话框。

如下图所示:

资产定位 | 合宙Air201模组LuatOS快速入门01-hello world

下载过程如果出现找不到端口,注意看下数据线连接是否有问题:

资产定位 | 合宙Air201模组LuatOS快速入门01-hello world

Step 3. 开始烧录

资产定位 | 合宙Air201模组LuatOS快速入门01-hello world

03)烧录问题排查

如果你在烧录过程中遇到了问题,请点击如下链接,进行烧录的问题排查。

详细的烧录操作步骤参考此处:
https://doc.openluat.com/wiki/52?wiki_page_id=5071#_23

2.5 验证功能

烧录完成后,会自动开机,此时电脑的设备管理器中会虚拟出三个端口表示正常开机:

资产定位 | 合宙Air201模组LuatOS快速入门01-hello world

LuaTools会自动抓取应用日志和系统日志,并且在主界面解析显示应用日志。

如下图所示(点击放大查看):

资产定位 | 合宙Air201模组LuatOS快速入门01-hello world

从打印的日志可以看到——这个4G开发板,在不断的打印hello world。

太棒了!你成功了!
下一期,我们一起来学习Air201的点灯…


 更多资料请点击:‍‌⁠​​⁠​​⁠​‌​⁠‬​​​​​​​⁠‍​‍​‬‍​‍‌‬⁠​​​‬‌‌​‌​​‍​‍​​Air201 4G资产定位模组 产品介绍

© 版权声明

相关文章

暂无评论

您必须登录才能参与评论!
立即登录
暂无评论...