<div style="border-top: none; border-right: none; border-left: none; border-image: initial; border-bottom: 1pt solid rgb(238, 238, 238); padding: 0cm 0cm 4pt; background-image: initial; background-position: initial; background-size: initial; background-repeat: initial; background-attachment: initial; background-origin: initial; background-clip: initial;">
本文描述了Air系列模块（2G和4G模块）Lua版本上通用串口、调试串口、USB口的特性和使用方法，先看一张对比图：
|
|
2G模块 |
4G模块 |
|
通用串口 |
Ø 有UART1和UART2两个通用串口 Ø 通用串口电平2.8V；如果要和3.3V的MCU通信，强烈建议加电平转换电路；如果要和5V的MCU通信，必须要加电平转换电路 Ø 不支持流控 |
Ø 有UART1和UART2两个通用串口 Ø 串口电平1.8V；如果要和3.3V/5V的MCU通信，必须要加电平转换电路 Ø 不支持流控 |
|
调试串口 |
Ø 主要用于烧录固件和抓取日志，波特率固定为921600 Ø 也可特殊处理实现通用串口的数据传输功能，但是不建议使用，因为调试串口数据传输不稳定，很容易丢失数据 |
不支持 |
|
USB口 |
不支持 |
Ø 主要用于烧录固件和抓取日志 Ø 也可通过枚举出来的ASR Modem |
若无特别说明，下文中描述的串口包括通用串口、调试串口、USB口三种，描述的串口通信的对端设备称作MCU
二、应用层数据收发原理
注意：默认状态下，在合适的时间点（此时间点不可预知），系统会自动进入休眠状态；串口数据收发之前，必须通过pm.wake(…)接口使系统持续处于唤醒状态，才能保证收发功能正常；收发结束后，可以通过pm.sleep(…)接口允许系统自动休眠
2.1、数据接收
在core中的应用层，有一个1460字节的缓冲区，串口驱动接收到的数据插入此缓冲区；脚本有轮询和中断两种方式，通过uart.read(…)接口读取缓冲区中的数据；
需要注意如下两点：
1、脚本读取的速度要大于数据插入的速度，否则会造成缓冲区溢出，数据出错
2、MCU一次性发送给模块的数据，调用uart.read接口，并不一定能够一次性读取完整，必须使用“循环读取数据”+“数据拼接判断完整性”的方案来处理；例如MCU一次性发送1460字节的数据，模块使用轮询或者中断第一次读取数据时，缓冲器里面可能才接收到10字节的数据
2.1.1、uart.read接口详解
|
uart.read(id, format) — 读取串口数据（此接口不会阻塞，立即返回） — @number id 串口ID — @string or number format 读取串口数据的格式，有如下几种 — number类型的数字：表示读取指定长度字节的数据 — — — — string类型的*l： 表示读取到换行符\n — — — — string类型的*n： 表示读取整型数据 — — — — string类型的*s： 表示读取到空格字符 — — — |
2.1.2、轮询方式读取数据
轮询方式比较简单，脚本定时调用uart.read接口读取数据、拼接数据、检查数据完整性、处理数据即可
详细代码参考uart的demo
2.1.3、中断方式读取数据
中断方式处理逻辑如下：
1、脚本调用uart.on(id,
“receive”, intFnc)注册中断处理函数intFnc
2、脚本接收到core中产生的数据中断消息后，执行intFnc
3、脚本在intFnc中循环调用uart.read接口读取数据、拼接数据、检查数据完整性、处理数据，直至没有数据可读
什么情况下，core中才会产生数据中断消息呢？当缓冲区为空时，收到数据才会插入缓冲区，然后产生数据中断消息；如果缓冲区不为空，收到数据时仅仅插入缓冲区，并不会产生数据中断消息。所以第3步要把缓冲区中的数据读完，这样才能保证以后收到的数据，可以产生中断消息，脚本可以及时处理
详细代码参考uart的demo
2.2、数据发送
脚本使用uart.write接口发送数据，一次性最多支持发送1460字节的数据
可以通过异步消息来通知脚本数据已经发送成功，参考uart的demo
三、常见问题
3.1、api文档在哪里
http://wiki.openluat.com/doc/luatApi/#uart
代码详见uart的demo
3.2、休眠、唤醒和功耗控制
默认状态下，在合适的时间点（此时间点不可预知），系统会自动进入休眠状态；串口数据收发之前，必须通过pm.wake(…)接口使系统持续处于唤醒状态，才能保证收发功能正常；收发结束后，可以通过pm.sleep(…)接口允许系统自动休眠
如果项目不要求低功耗，为了编程方便，可以调用pm.wake使系统一直处于唤醒状态
如果项目要求低功耗，除了动态控制休眠唤醒外，还要使用uart.close关闭串口，这样才能完全消除串口功能的功耗
3.3、2G模块的调试串口可以用来做普通数据传输使用吗
可以用来做普通数据传输，但是不建议使用，原因有如下两点：
1、调试串口数据传输不稳定，很容易丢失数据；必须在应用层之上增加重试和容错机制
2、调试串口主要用于烧写固件和输出日志，有一套专用协议，如果要用做普通数据传输，必须按照这套协议开发对端程序
有需要的话，参考hostUart的demo
3.4、4G模块的USB口可以和PC之间进行数据传输吗
USB在PC端映射出的ASR Modem Device AT口可以和PC进行数据传输
代码详见usbdata的demo
3.5、RS485通信的收发方向控制
可使用uart.set_rs485_oe接口配置此功能
参考：http://wiki.openluat.com/doc/luatApi/#uartset_rs485_oe
3.6、串口无法数据通信
检查一下串口电平是否匹配，波特率是否匹配，软件上是否进入了休眠
3.7、串口数据乱码
检查下模块板和主控板的参考地是否有电势差，曾经有一个客户的板子如下图设计 ，通过主控板给模块供电，然后只通过上图排插针通插座的方式连接主板串口，导致地连接的阻抗增加，在弱信号下大功率发射时，会导致模块板和主控板的参考地有电势差，导致串口通信异常
3.8、串口接收数据丢失
1. 接收数据前，必须保证系统处于唤醒状态，参考3.2章节
2. 检查下代码接收处理逻辑是否有问题，重点检查如下代码逻辑
|
local function read() —底层core中，串口收到数据时： —如果接收缓冲区为空，则会以中断方式通知Lua脚本收到了新数据； —如果接收缓冲器不为空，则不会通知Lua脚本 —所以Lua脚本中收到中断读串口数据时，每次都要把接收缓冲区中的数据全部读出，这样才能保证底层core中的新数据中断上来，此read函数中的while语句中就保证了这一点 end uart.on(UART_ID,”receive”,read) |
3. 参考demo\uart\v1\testUart.lua写一个简单demo，仅仅接收和打印数据，不做其他任何处理，看看数据是否有丢失
4. pc端通过sscom监控模块的rx管脚，对比看下sscom监控到的数据是否有丢失；同时用示波器监控rx管脚数据，确认下高电平和低电平电压是否正确
