Air780EP LuatOS固件版本
作者：沈园园 | 最后修改：2026-06-03
最新版本SDK&Demo
LuatOS固件版本下载地址
二次开发demo
LuatOS固件版本更新说明（最新V2026）
LuatOS-SoC_V2024_Air780EP版本更新说明 2026-02-28
- add: codec, codec.create支持设置channels以及sample_rate参数
- add: netdrv, ready函数支持获取netdrv整体状态
- add: netdrv, openvpn 添加重试参数
- add: httpsrv, 真实处理请求的headers,返回到lua层
- add: icmp, 添加ttl回调参数
- add: tp, tp.init接口添加direction参数配置
- add: tp, tp.init接口添加swap_xy参数配置
- change: icmp, 优化日志打印,把具体是哪个网络报错,展示出来
- change: http, 重写逻辑,在tcp关闭时,才上报http结果,解决多次上报的问题
- change: http, 调整event日志,并防御http_ctrl->netc为NULL的场景
- change: http, 隐藏idp日志
- change: http,fota, 在fota下载的时候加些打印，打印出长度
- change: net_lwip2, 默认填充的dns服务器,应该放在2/3位置,然后客户使用0和1, 在lua脚本的角度是1和2.
- fix: http, fota收到状态码不是200的时候,不应该直接上报报错,依然要等服务器断开链接
- fix: iperf, 有概率启动失败,原因是ctx是临时变量,tcpip_callback之后可能已经释放了
- fix: netdrv,napt, 对icmp的改写,当ETH->ETH,数据包依然再次给了lwip,那是不对的
- fix: netdrv,ch390, 修改中断为下降沿触发
- fix: audio, audio.config里的dacDelay单位正确应该是100ms
- fix: ftp, 修复ftp上传大小异常时候却返回为true的问题
- fix: pack, zbuff.pack对c的边界值处理,在部分bsp上有问题, 需要明确声明
- fix: mobile, mobile.flymode 返回值反了
- fix: mobile, sim卡pin解锁成功后，读不到卡
- fix: audio, record功能，在32bit数据情况下录音长度，时间计算不对 请使用LuaTools的资源下载器进行下载
历史版本SDK&Demo
LuatOS固件版本下载地址
LuatOS-SoC_V2024_Air780EP版本更新说明 2026-1-29
- add: audio,新增audio.finish()接口，在raw play模式下，写入最后一块数据后，通知多媒体通道已经没有更多数据需要播放了
- add:tp,添加tp.sleep接口，已适配的tp ic：GT911
- update: httpsrv,增加httpsrv.debug函数，修正空连接时死机的问题
- update: log,优化log输出，不会出现因软复位开机打印频繁，或者USB插拔（或枚举丢失又重连）太频繁都会触发的看门狗重启。
- fix: gpio,修复gpio.setup上拉后会触发上升沿中断
- fix: http,在下载chunked编码格式的文件时，会出现异常关闭链接的情况
- fix: http,兼容headers中匹配"Content-Length: xxx"格式不标准，导致底层获取不到正确长度
- fix: http,body数据接收完整之后,没有将检测完整的状态变量同步,导致下载文件结束后认为数据没有接收完,就把文件删除了
- fix: http,chunked下载文件，headers没有Content-Length时 文件下载失败
- fix: http,判断响应没有接收完整数据以及是否处于下载模式才会关闭文件并删除
- fix: can,修正64bit固件取id值出错的问题
LuatOS-SoC_V2022_Air780EP版本更新说明 2026-1-16
- add: crypto,gcm模式增加tag的输出和输入校验
- add: lf,little flash添加支持型号 nand flash: MX35LF512
- add: pm,添加新接口"pm.keep(role_id, on_off)"用于设置休眠投票机制
- add: pm,pm.lastReson增加一个返回值，用于指示具体哪些pad唤醒的
- add: sms,支持参考序号为2byte的长短信
- add: sms,添加PDU短信解包"sms.unpack"函数
- add: sms,添加debug函数
- change: sms,兼容更多pdu格式,启发式检测UDH头
- change: json,不再转义/字符
- change: httpsrv,优化代码实现,防御越界和非法的URL攻击
- change: multimedia,优化出现pop音的问题
- fix: crypto,mbedtls2.18下计算aes-128-gcm输出数据iv值不生效的问题
- fix: pack,pack函数对A格式字符的处理不正确
- fix: gpio,获取WAKEUP6和CHG_DET电平返回值不对
- fix: pm,修复HIB休眠模式下lpuart低功耗串口唤醒死机问题
- fix: sim,修复硬件设计双卡槽的情况下无法识别到sim卡2(sim1接口)
- fix: sms,修正处理长短信可能溢出的问题
- fix: sms,修正unpack函数无法解析出7bit短信息的问题
- fix: http,处理chunked编码格式时概率出现body数据接收不全的问题
- fix: http,fs,频繁进行fs操作的同时进行http下载,在出现下载失败可能出现竞态或在不安全上下文释放资源从而触发死机
LuatOS-SoC_V2018_Air780EP版本更新说明 2025-11-18
add: lvgl,添加支持外部加载bin字体文件
add: lcd,新增lcd.getStrWidth函数以获取字符串的像素宽度
add: mobile,通过频点查找频段，mobile.scell增加频段信息
add: rtos,version函数增加可选的第二个返回值,可获取数字固件的编号
add: errdump,支持自定义adapter参数
add: log,添加开机的调试打印，会把开机原因pm.lastReson的值打印出来
add: sms,短信添加发送结果回调消息"SMS_SENT"
add: netdrv,mreport,遥测添加可指定网络适配器的参数配置，以及更改上报参数
fix: tp,gt911触摸无反应
fix: lcd,drawLine若x1>x2,或者y1>y2时,会申请一个负数长度的内存块
fix: lcd,lvgl,解决jd9261屏幕触摸或者刷屏会出现花屏的现象
fix: netdrv,ch390,修复4g转wan以太网功能长时间挂测概率出现掉网问题
fix: httpsrv,当请求的数据长度大于mtu,出现分包时,会出现数据处理非常慢的情况
fix: os,修改clock实现,应返回的计数器是带小数,而不是直接返回整数
change: pins,自动加载json文件时,支持全小写的文件名
change: rtc,时间未同步前日期设置到2000/1/1 0:0:0
change: mobile,优化getBand接口total_num没有初始值，可能导致客户应用判断返回值出现问题
change: 去除一些底层调试性的打印
LuatOS-SoC_V2016_Air780EP版本更新说明 2025-10-10
change: log,重大调整,print/log输出字符串时,改成用单个空格,替代原本的tab
change: fs库合并至io库
change: sdk更新到最新patch
add: 添加支持pins库，功能替代旧的mcu.altfun接口
add: 短信支持pdu解析，发送pdu短信
add: 添加io.dexist函数，用于判断目录是否存在
add: gmssl,添加SM2密钥生成函数
add: 在处理dhcp包时，添加多条出现异常错误时的调试日志
add: fatfs库添加fatfs_config接口，可设置fatfs一些特殊参数，部分不能正常读写的卡，经过配置后可能能读写成功
add: 7添加websocket对连续帧的处理
add: pm库接口添加pm.chgcmd和pm.chginfo
fix: 修复无联网情况下，os.date()可能会死机
fix: 修复当lcd.image2raw解码失败且decode有buff分配时会出现死机的问题
fix: 修复当使用io.writeFile写入的文件不存在，又按追加模式打开时，会出现内存占满异常
fix: 修复有文件名（不包括.lua后缀）长度大于等于20时，Luatools烧录到模块设备中，运行必现重启
fix: 修复获取到网关提供的dns，解析时却总是使用默认网关
fix: 修复zbuff:query参数填错情况下无法转换成数值型
fix: 修复websocket的send函数总是返回false
fix: 修复audio初始化时少了对pa的gpio配置，导致pa有时不能拉高
fix: 修复http库下载文件,若文件无法创建会报lua内存不够的问题
二次开发demo
LuatOS固件版本更新说明（历史版本）
LuatOS-SoC_V2002_Air780EP 2024-11-18
请搭配 Luatools 3.0.11 以上版本!!!
新增功能
add: 支持设置最大发送功率,仅特殊客户使用
add: 支持关闭邻区测量用于功耗测试，非功耗测试情况下不要使用
add: 获取更详细的服务小区信息,支持mobile.scell()函数
add: 添加锁小区函数 mobile.lockCell()
add: mqtt加pong消息上报
add: 自定义apn列表，用于多个已知海外卡切换，需要用户提供相关APN信息
add: 打印一条自定义APN列表里的信息
更新功能
change: rtos.bsp() 在Air780EP/Air780EPS/air8201/Air780EQ/Air700EMQ/EAQ/ECQ的型号固件, 会返回具体模组的型号
update: 更新蚂蚁链底层库
update: 更新高通字库静态库
update: 优化full ota的下载速度控制，并且对https下载优化
update: 优化低功耗模式
update: luatos socket的端口号分布的更加均匀
update: tonumber可以输出到0xffffffff
change: pb编码应该使用固定顺序
change: http的部分错误状态强制打印出来
缺陷修复
fix: i2c在poll模式下，特殊硬件条件下遇到一直BUSY情况没有超时退出
fix: eink异步方式通信失败时，死机
fix: iotcloud库,onenet自动注册三元组生成异常
fix: UTF8编码输入的短信发不到70汉字
fix: libgnss.debug在gnss报文过长时，无法打印出来
core_V1003 2024-09-02
缺陷修复
1：spi table方式发送异常
2：libgnss.clear没有清理干净残留数据
3：gnss定位成功后，执行libgnss.clear，关闭再打开gnss芯片，如果一上电就定位成功，无GNSS_STATE消息
4：mqtt启用后，内存占用过大，导致其他业务逻辑申请不到可用内存
5：http 响应头分包，导致解析失败
6：修复FTP在PASV模式下接受少量数据可能会提示失败
新增功能
add：mqtt添加设置接收缓冲区大小的功能
add：fatfs卸载功能
add：mcu.hardfault新增死机处理模式参数
更新功能
update：限制uart.read单次最大读取量，一次性读取太多数据，容易死机
update：已经释放过的socket ctrl，不再允许其他操作，防止异常死机
update：兼容部分FTP服务器
update：RRC快速释放的优化选项
core_V1002 2024-07-04
兼容性变化
1：因功能变化较多，FLASH空间不足
(1)LuatOS-SoC_V1001_EC718PV无法远程升级到LuatOS-SoC_V1002_EC718PV
(2)LuatOS-SoC_V1002_EC718PV为正式发行的最后一版EPV固件，后续需要EPV固件请使用云编译或本地自行编译
缺陷修复
fix: 拍照的时候无法选择jpeg编码质量
fix：pwm在没有先close的情况下，既改周期，又改占空比，有可能死机的问题
fix：在使用uart485时，无法设置转向pin为GPIO16和GPIO17的问题
fix：otp功能异常
fix：ota时，在ota完成的最后一刻死机，会导致底层OTA成功，而脚本ota失败
fix：EPV固件，无法进入休眠
fix：socket主动关闭时，回调消息错误
fix：mqtt发送时，一次性将数据发出去，避免被打断
fix：mqttconnect报文长度超过256时，无法连接服务器
fix：ftp异常死机
fix：socket添加防护，防止已释放的资源再次使用
fix：防止可能的时间设置错误
fix：spi table方式发送异常
新增功能
add：audio库添加录音功能
add：agpio在深度休眠唤醒后，依然可以保持休眠前电平的能力
add：重置协议栈参数到默认
add：基站同步时间开关
add：深度休眠定时器回调消息
add：w5500添加DHCP超时消息
add：DHCP重试次数增加，应对运行速度慢的路由器
add：socket查询当前连接状态
add：http自定义header支持自定义大小
add：sfud互斥锁保护
add: 支持外部flash全量升级
add：支持配置codec的工作电压
add：mqtt添加设置缓冲区大小的功能
更新功能
update：当遇到无法解析的NMEA语句时，屏蔽打印
core_V1001 2024-03-08
第一次发布