init: Air780EPM 官方 LuatOS 项目代码基线
- 来源: 合宙 LuatOS 官方仓库 air780epm 模块完整代码 - 路径: luatos/air780epm/module/Air780EPM/demo 含官方 demo(含 mqtt/mqtts/socket/uart 等) - 后续: 基于 demo 开发 UART<->MQTT 数据上报功能
This commit is contained in:
wangfq
@@ -0,0 +1,136 @@
|
||||
## 演示功能概述
|
||||
|
||||
本demo演示的核心功能为：
|
||||
|
||||
Air780EXX系列模组在常规模式、低功耗模式1、PSM+模式3下的功耗表现，通过下列九个项目示例代码进行介绍：
|
||||
|
||||
1、prj_0_tcp_long：常规模式下的tcp长连接项目（每5分钟发送一次数据到tcp server）
|
||||
|
||||
2、prj_3：PSM+模式3简单项目
|
||||
|
||||
3、prj_1：低功耗模式1简单项目
|
||||
|
||||
4、prj_0_1：常规模式0和低功耗模式1切换项目
|
||||
|
||||
5、prj_1_tcp_long：低功耗模式下的tcp长连接项目（每5分钟发送一次数据到tcp server）
|
||||
|
||||
6、prj_3_tcp_short：PSM+模式下的tcp短连接项目（每次开机，发送一次数据到tcp server，无论成功还是失败，然后进入PSM+模式，1小时后唤醒）
|
||||
|
||||
7、prj_1_mqtt_long：低功耗模式下的mqtt长连接项目（每5分钟发送一次数据到mqtt server）
|
||||
|
||||
8、prj_3_mqtt_short：PSM+模式下的mqtt短连接项目（每次开机，读取一次温湿度数据，然后发送到mqtt server，无论成功还是失败，然后进入PSM+模式，1小时后唤醒）
|
||||
|
||||
9、prj_1_uart_camera：低功耗模式+飞行模式下的上位机通过串口控制拍照以及照片回传项目（uart1 9600波特率接收上位机拍照指令，拍照后，通过115200波特率将照片回传给上位机）
|
||||
|
||||
|
||||
|
||||
简单说明：
|
||||
|
||||
1、Air780EXX系列模组目前包括Air780EPM/EHM/EHN/EHU/EHV/EGH/EGG/EGP；
|
||||
|
||||
2、Air780EGH/EGP/EGG模组内部包含有GNSS芯片，Air780EGP/EGG模组内部包含有Gsensor芯片，GPIO23作为GNSS芯片的供电使能引脚，一直保持高电平输出，此时会增加30uA左右的电流功耗，属于正常情况；
|
||||
|
||||
3、Air780EHV模组内部包含有Audio Codec芯片ES8311，GPIO20作为Audio Codec芯片ES8311的供电使能引脚，外部不需要进行额外配置；
|
||||
|
||||
4、Air780EPM/EHM没有引出此引脚，所以无法配置CHG_DET（WAKEUP6）功能；
|
||||
|
||||
## 模组及核心板/开发板资料
|
||||
|
||||
[Air780EPM/EHM模组及核心板/开发板资料](https://docs.openluat.com/air780epm/product/shouce/)
|
||||
|
||||
[Air780EHV模组及核心板/开发板资料](https://docs.openluat.com/air780ehv/product/shouce/)
|
||||
|
||||
[Air780EGH/EGG/EGP模组及核心板/开发板资料](https://docs.openluat.com/air780egh/product/shouce/)
|
||||
|
||||
[Air780EHN/EHU模组及核心板/开发板资料](https://docs.openluat.com/air780ehnehu/product/shouce/)
|
||||
|
||||
## 演示硬件环境
|
||||
|
||||
1、Air780EXX系列核心板（可通过[上海合宙LuatOS官方企业店](https://luat.taobao.com/)采购）
|
||||
|
||||
2、Air780EXX系列开发板（可通过[上海合宙LuatOS官方企业店](https://luat.taobao.com/)采购，用于prj_1_uart_camera项目演示）
|
||||
|
||||
3、AirSHT30_1000温湿度传感器配件板（可通过[上海合宙LuatOS官方企业店](https://luat.taobao.com/)采购，用于prj_3_mqtt_short项目演示）
|
||||
|
||||
4、AirCAMERA _1040摄像头模组（可通过[上海合宙LuatOS官方企业店](https://luat.taobao.com/)采购，用于prj_1_uart_camera项目演示）
|
||||
|
||||
5、支持两个UART端口及以上的串口板
|
||||
|
||||
6、物联网卡（需要自行联系卡商）
|
||||
|
||||
7、Air9000P合宙功耗分析仪（可通过[上海合宙LuatOS官方企业店](https://luat.taobao.com/)采购，用于外部供电）
|
||||
|
||||
|
||||
|
||||
Air9000P与Air780EXX系列核心板接线说明：
|
||||
|
||||
- 将Air9000P的‘+’、‘-’极分别连接到核心板的VBAT、GND排针上，在测试低功耗模式1、PSM+模式3时需要使用外部供电才行；
|
||||
- 将核心板USB旁边的拨码开关拨到OFF，断开USB供电；
|
||||
- 电脑打开“功耗分析仪”软件（使用说明请看[Air9000P使用说明](https://hezhouyibiao.com/)），连接Air9000P；
|
||||
|
||||
|
||||
|
||||
Air9000P与Air780EXX系列开发板接线说明：
|
||||
|
||||
- 将Air9000P的‘+’、‘-’极分别连接到开发板的4V、GND排针上，在测试低功耗模式1、PSM+模式3时需要使用外部供电才行；
|
||||
- 将开发板USB旁边的拨码开关拨到“外部供电”，断开USB供电；
|
||||
- 电脑打开“功耗分析仪”软件（使用说明请看[Air9000P使用说明](https://hezhouyibiao.com/)），连接Air9000P；
|
||||
|
||||
|
||||
|
||||
AirSHT30_1000与Air780EXX系列核心板接线说明：
|
||||
|
||||
| Air780EXX系列核心板 | AirSHT30_1000温湿度传感器配件板 |
|
||||
| ------------------- | ------------------------------- |
|
||||
| VDD_EXT | 3.3V |
|
||||
| GND | GND |
|
||||
| 66/I2C1SDA | SDA |
|
||||
| 67/I2C1SCL | SCL |
|
||||
|
||||
|
||||
|
||||
两个UART端口及以上的串口板与Air780EXX系列开发板接线说明：
|
||||
|
||||
1、使用两根usb转ttl串口线连接电脑和开发板，第一根线和开发板的uart1 tx相连（电脑上的串口工具配置为9600波特率），第二根线和开发板的uart1 rx相连（电脑上的串口工具配置为115200波特率）；
|
||||
|
||||
2、第一根线对应的电脑端串口工具下发A0001指令，就可以控制开发板拍照，拍照结束后，通过第二根线发给电脑端串口工具（每次接收到数据，可以单独保存为一个文件，修改文件名后缀为jpg，就能查看图片）
|
||||
|
||||
## 演示软件环境
|
||||
|
||||
1、烧录工具：LuaTools下载调试工具（可鼠标右键点击[此处](https://docs.openluat.com/air780epm/common/Luatools/)并左键打开此链接进行下载）；
|
||||
|
||||
2、内核固件：
|
||||
|
||||
- [Air780EPM/EHM最新版本内核固件](https://docs.openluat.com/air780epm/luatos/firmware/version/)
|
||||
- [Air780EHV最新版本内核固件](https://docs.openluat.com/air780ehv/luatos/firmware/version/)
|
||||
- [Air780EGH/EGG/EGP最新版本内核固件](https://docs.openluat.com/air780egh/luatos/firmware/version/#air780egg-luatos)
|
||||
- [Air780EHN/EHU最新版本内核固件](https://docs.openluat.com/air780ehnehu/luatos/firmware/version/)
|
||||
|
||||
3、脚本文件：[lowpower_new](https://gitee.com/openLuat/LuatOS/tree/master/module/Air780EPM/demo/lowpower_new)；
|
||||
|
||||
4、lib脚本文件：使用Luatools烧录时，勾选 添加默认lib 选项，使用默认lib脚本文件
|
||||
|
||||
准备好软件环境之后，接下来根据前面“模组及核心板/开发板资料”链接中各个模组核心板/开发板使用手册中的烧录说明，将本篇文章中演示使用的项目文件烧录到Air780EXX系列核心板/开发板中。
|
||||
|
||||
## 演示操作步骤
|
||||
|
||||
1、搭建好演示硬件环境；
|
||||
|
||||
- prj_3、prj_1、prj_0_1、prj_0_tcp_long、prj_1_tcp_long、prj_3_tcp_short、prj_1_mqtt_long这七个功能演示只需要使用Air780EXX系列核心板+物联网卡+Air9000P合宙功耗分析仪即可；
|
||||
- prj_3_mqtt_short这一个功能演示时还需要在前面的基础上连接AirSHT30_1000温湿度传感器配件板；
|
||||
- prj_1_uart_camera这一个功能演示时核心板无法演示，需要使用Air780EXX系列开发板，开发板上还需要接AirCAMERA _1040摄像头模组和两个UART端口及以上的串口板才行；
|
||||
- 在进行搭建硬件环境时请参考前面的“演示硬件环境”；
|
||||
|
||||
2、在 main.lua 代码文件中根据需要演示的项目功能，打开对应的代码；
|
||||
|
||||
- prj_3、prj_1、prj_0_1这三个功能演示时只需要打开对应的代码即可；
|
||||
- prj_0_tcp_long、prj_1_tcp_long、prj_3_tcp_short这两个功能演示时需要在app_tcp_main.lua代码文件中填写需要连接的TCP服务器地址和端口号；
|
||||
- prj_1_mqtt_long、prj_3_mqtt_short这三个功能演示时需要在app_mqtt_main.lua代码文件中填写需要连接的MQTT服务器地址和端口号，并且prj_3_mqtt_short功能演示时需要连接AirSHT30_1000温湿度传感器配件板，接线说明见前面的“演示硬件环境”章节；
|
||||
- prj_1_uart_camera这一个功能演示时需要使用开发板，开发板上需要接AirCAMERA _1040摄像头模组和两个UART端口及以上的串口板，接线说明见前面的“演示硬件环境”章节；
|
||||
|
||||
3、使用LuaTools工具烧录内核固件和修改后的demo脚本代码；
|
||||
|
||||
4、烧录成功后，自动开机运行，并使用Air9000P合宙功耗分析仪观察功耗表现；
|
||||
|
||||
- prj_3、prj_1、prj_0_1、prj_0_tcp_long、prj_1_tcp_long、prj_3_tcp_short、prj_1_mqtt_long、prj_3_mqtt_short这八个功能演示时是全自动运行的，用户无法进行额外操作（除非是需要修改功能配置项），只需观察功耗表现即可；
|
||||
- prj_1_uart_camera这一个功能演示还需要通过PC端串口工具与模组进行串口通信，详细说明见前面的“演示硬件环境”章节；
|
||||
Reference in New Issue
Block a user