跳转至

常见问题 - 2026-11-11

数据日期:2026-11-11

1. Air8607能否做竖屏显示?

解答: 结论:可以,AirUI 提供 airui.set_rotation(),传 90 或 270 就是竖屏显示;但旋转要按整屏重画,帧率会明显下降。 说明:airui.set_rotation 与 lcd.init 的 direction 参数无关,只支持 0/90/180/270 四档。旋转 90/270 时逻辑分辨率的宽高互换,10 寸 1024×600 转过来就是 600×1024,触摸初始化的 w/h 必须跟着对调,否则点击位置和画面会错开一截。另外屏本身的时序参数仍是按物理分辨率配的,竖屏只改显示方向,不改屏的扫描方式。 处理步骤:① 确认屏与 RGB 时序按 1024×600 配好、能正常点屏;② airui.init 之后调用 airui.set_rotation(90);③ tp.init 的 w/h 改成 600/1024(90 度时对调);④ 观察刷新效果,竖屏下尽量少做整屏重绘和大图动画;⑤ 显示异常先查 50PIN 排线压接与背光,别一上来就怀疑旋转。 参考文档:https://docs.openluat.com/osapi/core/airui/ · https://docs.openluat.com/air8607/product/

2. PLCUI触摸没反应怎么处理?

解答: 结论:先查 plcui.device_bind_touch 有没有在 plcui.init 之后调用,再查点击位置是不是落在按钮的图片区域内。 说明:plcui 的按钮是「切图 + 触摸区」两部分:四种状态各一张图,命中判定看布局里 hit-x/y/w/h 定义的矩形,要求完整落在组件范围内;label 只是叠在图上的文字,不参与命中,所以点在文字上而没点在图上就没反应。真机上还必须先用 tp.init 拿到触摸句柄再绑给 plcui,顺序固定为 i2c.setup → tp.init → plcui.init → plcui.device_bind_touch。PC 模拟器用鼠标模拟触摸,不绑定也能点,容易让人误以为真机代码没问题。 处理步骤:① 打开日志看 device_bind_touch 的返回值,失败会带 code 与 message;② 确认 tp.init 的 port、w、h 与屏一致;③ 按 demo 逐项比对布局 XML 里的 hit 区域,别把触摸区做成图的一半;④ 仍不响应就按文档重新生成布局脚本再试;⑤ 注意 tp.init 一次上电只能调一次,重复调用返回 nil。 参考文档:https://docs.openluat.com/osapi/core/plcui/

3. 字库加载失败导致重启如何解决?

解答: 结论:把字库整包预载到 PSRAM(airui.font_load 里的 load_to_psram = true)后就不再复现;不预载也能画,但每字都要现查 ttf,慢到一定程度会触发看门狗超时重启。 说明:不预载时的取字顺序是「先查文字缓存,查不到再从 .ttf 文件里搜」,单字耗时可到十几毫秒;一屏几百个字叠加起来远超看门狗余量,表现就是「画着画着设备重启」。预载后每个字显示到屏幕约 1ms,代价是 PSRAM 占用(每字最大 100B),空间不够会初始化失败。所以这类重启本质是耗时问题,不是字库文件坏了。 处理步骤:① font_load 里加 load_to_psram = true;② 只加载实际用到的字号与字符集,别把整个字库全塞进去;③ 用 rtos.meminfo("psram") 看余量;④ 字号多就分页加载,切界面时换字库;⑤ 仍重启就抓 trace.txt,确认到底是取字太慢还是别的任务卡住。 参考文档:https://docs.openluat.com/osapi/core/airui/

4. Air8603做FOTA3升级时SOC死机怎么办?

解答: 结论:单次写入的数据长度不能超过 4K,超过就会出异常;同时先核对升级包与当前底层固件的版本、分区是否匹配。 说明:FOTA3 是边下载边写 flash,一次写太大就会跨 flash 页/扇区边界,写操作耗时被拉长,期间喂不上狗、或缓冲区被下一片覆盖,就会死机。升级包与设备当前固件的分区布局、版本对不上,同样会在写入阶段挂掉,表现为「下载完成、刷写时卡死」。 处理步骤:① 把每片写入长度压到 4K 以内(1024 / 2048 / 4096 逐档试);② 打印每片写入耗时,看是不是某一片特别长;③ 核对升级包与设备固件版本、分区编号;④ 死机后取 trace.txt 与 ramdump 一起分析;⑤ 写入放到独立任务里,并留足喂狗余量。 参考文档:https://docs.openluat.com/osapi/ext/libfota3/

5. LuatOS-SoC_V1030_Air1603_101.soc烧录后显示1031版本是否影响FOTA?

解答: 结论:不影响 FOTA,只是编译时版本号没改回去,运行时显示串和文件名的版本号对不上,功能是同一份固件。 说明:版本串是编译时打进固件的宏,而 FOTA 判断依据是升级包里的版本号与分区布局,不看运行时打印的那串字符,所以显示 1031 仍能正常升级。但对外交付时版本串不一致容易引起误会,登记型号版本应以发布包文件名和发布记录为准。 处理步骤:① 用 .soc 文件名与 CDN 发布记录登记版本;② 需要严格一致就向 FAE 索取版本串已修正的包;③ 升级前后各读一次版本号,确认确实变了;④ 现场排查问题时把「文件名版本」和「显示版本」分开记录,别混着报。 参考文档:https://docs.openluat.com/air1603/luatos/firmware/1603_version/

6. 设备选基站/驻留频段有没有顺序?

解答: 结论:没有用户可配的「频段优先顺序」,模组按协议自动扫频段、按信号质量挑小区驻留。 说明:驻网是 3GPP 的小区选择流程:先按频段列表扫,找到满足 S 准则(RSRP/RSRQ 门限)的小区就驻留;重选周期里如果出现信号更好的小区会切过去,所以现场看到「先连某个频段、过一会儿换一个」是正常重选,不是故障。国内全网通型号支持 FDD B1/B3/B5/B8 加 TDD B34/B38/B39/B40/B41,只有多频段同时覆盖时才存在「选哪个」的问题。 处理步骤:① 用工程模式或 AT 查询看当前驻留频段与小区;② 判断是不是覆盖边缘(RSRP 偏低、频繁重选);③ 覆盖边缘优先改天线位置与增益,而不是折腾频段顺序;④ 确有固定频段需求属特殊场景,锁频能力要单独找 FAE 确认,不要指望应用层配置。 参考文档:https://docs.openluat.com/air780epm/luatos/hardware/sim/ · https://docs.openluat.com/air780epm/product/

7. 设备支持的频段范围是多少?

解答: 结论:国内全网通版本是 LTE-TDD B34/B38/B39/B40/B41 加 LTE-FDD B1/B3/B5/B8。 说明:这九个频段合起来才覆盖移动、电信、联通三家,缺一个就可能在局部基站搜不到网,这也是「国内全网通」的定义口径。海外型号频段不同,例如 Air8000U 欧亚版是 B1/B3/B5/B7/B8/B20/B28/B38/B40/B41,Air8000N 是北美版。频段由硬件决定,刷固件改不了。 处理步骤:① 先按丝印确认完整型号(含后缀);② 国内项目对照上面九个频段核对;③ 海外项目查对应型号的频段页,并按国家列表确认;④ 客户给出的当地运营商频段要逐条比对是否被覆盖,别只看「支持某个频段」就断言能用。 参考文档:https://docs.openluat.com/air780ehnehu/product/air780ehnfreq/ · https://docs.openluat.com/air780epm/product/

8. Air780系列AT模组能否用UART PPP拨号上网?

解答: 结论:可以,Air780 系列的 AT 型号支持 PPP 拨号,主机侧用标准 PPP 协议栈拨号上网。 说明:PPP 是 AT 模组把 4G 数据通道透给主机的标准做法,模组只做链路层,IP 栈跑在主机侧;与 RNDIS/ECM 走 USB 当网卡不同,PPP 通常走串口,主机拨 99# 建立会话。要注意 PPP 与 AT 指令共用同一路串口时要切到数据态,退出用 +++。 处理步骤:① 先确认型号功能表里 PPP 一栏是 Y(如 Air780ER 系列);② 串口按模组要求配波特率与流控,发 AT 确认通道正常;③ 主机侧建 PPP 会话拨 99#,看是否分到 IP;④ 拿不到 IP 依次查 APN、SIM 状态、是否专网卡;⑤ 调试阶段另开一路串口抓日志,别和 PPP 抢同一个口。 参考文档:https://docs.openluat.com/air780er/

9. Air724UG之后推荐用哪款模块?

解答: 结论:优先 Air780EPM(LuatOS 二次开发)或 Air780EHM;要用 AT 指令就选同平台的 AT 型号,例如 Air780EPT 这一组。 说明:Air724UG 属 Cat.1 早期平台,新项目不建议沿用。Air780EPM 与 Air780EHM 是同一平台同一套资料(产品手册同页、固件页同一份),走 ec7xx,LuatOS 生态完整、固件与文档都在持续更新;AT 与 LuatOS 是两套固件,认证也分开列,不能拿 LuatOS 型号当 AT 型号量产。 处理步骤:① 先定大类:需要写 Lua 就 LuatOS 型号,需要 AT 就 AT 型号;② 按封装与管脚核对改板工作量;③ 按频段与认证需求定国内还是海外版本;④ 用选型表把候选型号列出来逐项对比再定。 参考文档:https://docs.openluat.com/SelectionGuide/SelectionGuide/ · https://docs.openluat.com/air780epm/product/

10. 串口1数据透传到串口2,同时串口1数据通过4G透传到云平台,不改固件能否实现?

解答: 结论:能,用 iRTU 固件加后台「任务」功能做转发,不需要改固件、也不用重新编译。 说明:iRTU 后台把每个串口当成一路数据通道,任务里用 create.getDatalink(n) 判断某路通道是否在线,再把收到的数据 publish 到另一个通道:发服务器用 NET_SENT_RDY_n,发串口用 UART_SENT_RDY_uid。所以同一份串口数据可以「一份给串口 2、一份给服务器」,两边互不阻塞。注意后台配置是整组设备统一生效,单台要特殊配置得先把它挪到独立分组。 处理步骤:① 后台开启串口 1 与串口 2,波特率、数据位、校验位配一致;② 网络通道绑定串口 1(与服务器交互的那路);③ 新建任务:订阅串口 1 数据,分别 publish 到 UART_SENT_RDY_2 与 NET_SENT_RDY_1;④ 保存并提交后,设备重新开机才生效;⑤ 用两个串口助手加服务器侧日志对发验证。 参考文档:https://docs.openluat.com/value/irtu/docs/task/ · https://docs.openluat.com/value/irtu/docs/uart/

11. Air8783H支持WiFi吗?

解答: 结论:当前 Air8783H 硬件不带 WiFi 射频,WiFi 版本还在开发;配套的 SIP 桥接工程里已经带了 Wi-Fi STA 驱动,硬件具备时可直接切换。 说明:8783H 的定位是 4G 加 VoLTE/SIP 双工通话,联网默认用 4G 承载 SIP。SIP/CC 桥接工程里的 netdrv_wifi.lua 是按 2.4GHz STA 写的,切过去除了改 require,还要把 config.lua 的 adapter 从 socket.LWIP_GP 改成 socket.LWIP_STA,并补上 exnetif、dnsproxy、dhcpsrv、httpdns、udpsrv 这几个依赖;两种驱动只能启用一种,网卡与 adapter 必须一致。只改联网方式,蜂窝通话仍然要 SIM 卡与 VoLTE。 处理步骤:① 先确认手上样机的硬件与固件是否支持 WiFi;② 按需切换 netdrv_device.lua 的 require 与 adapter;③ 填 ssid/password,观察日志里的 IP_READY;④ 商用前找 FAE 确认 WiFi 型号的供货与认证状态。 参考文档:https://docs.openluat.com/air8783h/

12. Air8783H的DTMF/SIP语音延迟约2.7秒如何解决?

解答: 结论:换用新版底层固件(DTMF 输出已优化到几百毫秒),并改用 sip_cc_bridge_dtmf 这个专用工程,注意里面的三个 DTMF 参数。 说明:旧固件发 DTMF 是把整段按键音先生成好再送下去,延迟取决于缓冲深度,2.7 秒量级很常见;新固件把 DTMF 生成挪到近端实时合成,延迟降到几百毫秒。工程里 dtmf_delay_ms 是按键前的等待时间(0–60000)、dtmf_duration_ms 是单键时长、dtmf_ack_timeout_ms 是应答超时,都要按对端交换机的识别习惯调。 处理步骤:① 升级到含 cc.sendDtmf 的固件(工程里用 assert 检查,缺了会直接报错);② 用 sip_cc_bridge_dtmf,不要拿普通 SIP 或 PCM 桥接 demo 改;③ 按对端要求调 dtmf_delay_ms 与 dtmf_duration_ms;④ 顺手核对 codec 与 ptime(PCMA 默认 8kHz/20ms);⑤ 抓 SIP 信令确认 INFO/RFC4733 与按键时序对得上。 参考文档:https://docs.openluat.com/air8783h/ · https://gitee.com/openLuat/LuatOS/tree/master/module/Air8783H/project/sip_cc_bridge_dtmf

13. Air780E未接CTS/RTS时发AT+IFC=2,2后AT无应答怎么解决?

解答: 尚未解答

14. Air8000A自设计板使用有源陶瓷天线无法定位,无源FPC天线可以,是什么原因?

解答: 尚未解答

15. 使用锂电池驱动Air780EX2T,电压会降到3V,有没有完整的锂电池供电设计方案?

解答: 尚未解答

16. Air780EPM的netdrv.WG(WireGuard)常量在文档中有,但固件没有打开怎么办?

解答: 结论:文档里的 netdrv.WG 只是库里的网卡类型常量,能不能用取决于固件有没有把 WireGuard 编进去;780EPM 标准固件没开,需要申请临时固件。 说明:netdrv.setup 传的网卡类型只是声明「要用哪种网卡」,真正能不能建起来要看固件里有没有对应协议实现和内存配额。没编进去时表现为 setup 失败或返回 nil,而不是报常量不存在——这也是最容易误判的地方,看到文档有常量就以为固件支持。 处理步骤:① 先跑最小脚本试 netdrv.setup(socket.LWIP_USER0, netdrv.WG, {}),看返回值和日志;② 确认当前固件版本号,向 FAE 提交所需功能清单申请带 WG 的临时固件;③ 临时固件一般不含空中升级,只能测试用,不能量产;④ 量产方案要么等正式固件支持,要么在应用层用其它方式做隧道。 参考文档:https://docs.openluat.com/osapi/core/netdrv/

17. Air780EPM设备在IoT平台绑定项目后,设备列表仍显示在默认项目,如何转移?

解答: 结论:设备已经归属到你名下时,在 iot.openluat.com 里把设备从默认项目转移到目标项目就行。 说明:要区分两层关系——设备归属(在哪个账号名下)和项目归属(在哪个项目里)。归属错了(设备在别人账号下)只能在平台侧改,需要提供 IMEI 找技术支持核实;项目之间转移自己就能操作。设备在线时转移完成要重连一次才按新项目生效,项目 key 对不上时会报无权限。 处理步骤:① 登录 iot.openluat.com,在「我的设备」里确认设备在列表中;② 选中设备,选择转移到目标项目;③ 目标项目必须已存在且属于同一账号;④ 转移后让设备重连,观察是否按新项目上报;⑤ 设备根本不在你名下,先走归属流程再谈项目。 参考文档:https://docs.openluat.com/air780epm/product/attributioniot/

18. Luatools V3如何把本地lua脚本添加到项目中?

解答: 结论:Luatools V3 是「项目」式管理——先新建项目,把底层 core 选进项目,再把 main.lua 等脚本所在的目录加进去。 说明:V3 把固件(core)、脚本(项目目录)、lib 库分开管理。脚本目录选错最常见:选到上级目录会把别的 demo 的同名 main.lua、config.lua 一起带进来,出现「改了代码没生效」的假故障。烧录时还要勾「添加默认 lib」,否则 require 扩展库会提示缺 xxx.lua。 处理步骤:① 新建项目,选对应型号的 core;② 脚本目录精确选到自己的 code 子目录;③ 清掉项目里残留的同名旧条目;④ 勾选「添加默认 lib」;⑤ 只改脚本用「下载脚本」,动了固件才用「下载底层和脚本」。 参考文档:https://docs.openluat.com/common/Luatools/

19. Air8607接1024x600屏幕显示卡顿、颜色泛白是什么原因?

解答: 结论:先把固件升到 1030 版本再测;仍然异常就按时序参数与颜色格式逐项排查。 说明:1024×600 是 50MHz 总线、RGB565,时序七组参数(hbp/hspw/hfp/vbp/vspw/vfp)与屏规格书不一致时,先表现为画面偏移、颜色发白或 RGB 位序错;卡顿则多与刷屏面积、是否整屏重绘、是否频繁重建大图有关。老固件在 PSRAM 分配和刷新调度上有已知问题,升级后很多现象直接消失。 处理步骤:① 升到 1030 固件复测,先排除固件因素;② 按屏规格书核对七组时序参数与总线频率;③ 检查 RGB/BGR 位序与 DE/HSYNC 模式;④ 界面上减少整屏重绘与动画;⑤ 用 rtos.meminfo 看 PSRAM 是否吃紧,必要时降色深或分块刷新。 参考文档:https://docs.openluat.com/air8607/product/ · https://docs.openluat.com/air8607/hardware/circuit/

20. Air8607下载提示ramrun下载失败、串口异常握手失败,如何处理?

解答: 结论:多数是串口被别的程序占用、Luatools 版本旧或供电不足,按「关占用 → 换工具 → 换线换口 → 加大供电」的顺序排除。 说明:8607 通过板载 CH343 转串口下载,ramrun 阶段对握手时序很敏感:串口助手、另一个 Luatools、虚拟串口只要占着同一个口,握手就会失败;电脑蓝牙、USB HUB 供电不足、只有充电线芯的劣质线也会造成时好时坏。烧录瞬间电压跌落,现象就是「识别到端口但握手失败」。 处理步骤:① 关掉所有可能占用 CH343 的程序,任务管理器逐个确认;② 更新到最新版 Luatools;③ 直插主机后置 USB 口,换原装短数据线;④ 关闭电脑蓝牙,去掉 HUB;⑤ 确认供电电压足够,必要时用外部稳压电源;⑥ 仍失败就短接 BOOT 再上电强制进下载模式复测。 参考文档:https://docs.openluat.com/air8607/software/debug/

21. Air8607的PLC_SVG素材能否放到Luatools资源下载目录供客户下载?

解答: 尚未解答

22. Air8603是否必须使用电容屏?能否支持电阻屏?

解答: 结论:现售 Air8603 标配 6PIN FPC 电容触摸(I2C1,gt9xx 等);电阻屏不是标配,但可以外加 NS2009 这类 I2C 电阻触摸 ADC 实现。 说明:8603 的触摸接口是 6PIN 电容触摸连接器 TP2,走 I2C1,含 TP_RST 与 WAKEUP;tp 库支持 gt9xx、gt911、gt1158、gt927、gt9157、jd9261t、cst820、cst816d、cst9220、ft3x68 等电容触摸 IC。电阻屏方案在仓库里已有整机 demo(Air8603 加 7 寸 800×480 屏加 NS2009),把电阻屏四线 XR/XL/YU/YD 接到 NS2009 的 XP/XN/YP/YN,触摸走 PIN43(TP_INT)、PIN42(SCL)、PIN41(SDA)。也就是说电阻屏技术上可行,但目前没有对应的标准型号与量产配置。 处理步骤:① 电容屏按 tp 库支持的型号直接选;② 电阻屏要外加 NS2009,按参考设计接线;③ 电阻屏必须做四点标定并持久化;④ 量产前评估结构、成本与供货,找 FAE 确认;⑤ 别按电容屏的时序去点电阻屏的屏线,两者是两套东西。 参考文档:https://docs.openluat.com/air8603/product/ · https://docs.openluat.com/osapi/core/tp/

23. 电阻屏未校准前坐标上下颠倒是否正常?

解答: 结论:正常。NS2009 未标定时默认原点在左下角、Y 轴向上,与屏幕逻辑坐标(左上原点)相反,看着就是上下颠倒。 说明:电阻屏本身只输出原始 ADC 值,屏幕坐标靠标定系数换算;未标定前方向和比例都处于「未知状态」。出厂应用会写一套默认标定值,所以成品机看着是正的;自己写应用不做标定就会颠倒,而且不只是上下反,比例也可能不准。新版 tp 库已经把标定收进核心库,不用自己算系数。 处理步骤:① 用 tp.calibration(dev, cb) 走四点标定,顺序固定为左上 → 右上 → 左下 → 右下;② 标定完用 tp.calibration(dev) 读回结果并存进 fskv;③ 上电时用 tp.calibration(dev, data) 回灌,避免每次开机重标;④ 存档损坏或结构不兼容要自动删除重标;⑤ 标定期间把界面主循环挂起,由核心库独占触摸。 参考文档:https://docs.openluat.com/osapi/core/tp/ · https://docs.openluat.com/air8603/product/

24. Air8301能否适配7寸屏幕?

解答: 结论:不能,Air8301 最大就是标配的 4.3 寸(480×272,SPI 屏 ST6201 加 GT911);要 7 寸得换 RGB 大屏方案。 说明:8301 的屏走 4 线 SPI,分辨率、时序、背光都按那条 4.3 寸屏配好,固件与结构也按这个尺寸设计;7 寸常见是 RGB565 接口,接口类型不同,不是改几个参数就能换。要 7 寸及以上,选 Air8603(40PIN/50PIN RGB)或 Air8607(50PIN RGB,7/9/10.1 寸)。 处理步骤:① 7 寸需求直接改选 Air8603 或 Air8607,别在 8301 上硬凑;② 只是想要更大可视区,可评估同 SPI 接口的更大尺寸屏,但要先确认驱动 IC 与固件支持;③ 选型时把接口类型、分辨率、触摸 IC 三项一起核对;④ 结构件与开孔要跟着改。 参考文档:https://docs.openluat.com/air8301/product/

25. Air8603可以接什么样的摄像头,最大分辨率是多少?

解答: 结论:通过 USB HOST 接 UVC 摄像头,最大 200 万像素拍照、100 万像素录像,官方已适配多款摄像头配件。 说明:8603 的 J8(Type-A 母座)与 J14(5PIN 线束端子)共用同一路 USB 信号,供电由 UVC_EN 控制、标称 +5.5V,所以「能接几个」实际是「同时只能用一个」。人脸识别用的 AirCAMERA_1034 除了占 USB HOST,还要占 UART2;普通 UVC 摄像头只占 USB。 处理步骤:① 先定用途:普通 UVC 还是人脸识别(决定要不要占 UART2);② 核对摄像头供电需求与 J8/J14 的 +5.5V 能力;③ 拍照与录像按 200W/100W 档位选,别超规格;④ 具体可选型号清单以 ai.luatos.com 或 FAE 确认为准,不要按别家型号硬套;⑤ 枚举失败先查 UVC_EN 有没有拉高。 参考文档:https://docs.openluat.com/air8603/product/ · https://docs.openluat.com/air8603/hardware/circuit/

26. Air780EHM/Air780EPT做CTA认证时FDD B1测不出数据、功率偏低怎么办?

解答: 结论:认证必须烧专门的认证固件,不能拿量产 AT 固件或 LuatOS 固件送测。 说明:认证固件默认打开对应制式的发射能力(部分型号还默认打开 WiFi/BT/GNSS),与量产固件是两套东西;测不出数据、功率偏低,最常见原因就是烧错了包或没有按认证要求配置。型号与固件包是对应关系:Air780EPM/EGP/700ECP 用 718pm 认证包,Air780EHM/EHV/EGH/EGG/700ECH/8000D 用 718hm 认证包,Air8000A/AB 另有单独一份。 处理步骤:① 按送测型号下载对应的认证固件包(非量产版本);② 送测样机提前烧好再寄实验室,样机要能再烧录;③ 测 FDD B1 前确认仪表与呼叫配置正确;④ 认证通过后量产机刷回量产固件;⑤ 型号与包名对不上时先问 FAE,别自己试。 参考文档:https://docs.openluat.com/air780epm/product/renzheng/

27. Air780用powerkey开关机,关机后内部RTC还会走时吗?

解答: 结论:只要 VBAT(或 RTC 备份电源)不断电,用 powerkey 关机后 RTC 仍继续走时。 说明:RTC 是独立于主系统电源运行的计时单元,关机只停 CPU 与业务逻辑,RTC 域仍在计时。要注意 rtc.set/rtc.get 读写的是 UTC,不处理时区,时区靠 rtc.timezone 单独配;联网拿到 NTP 时间后建议直接用 os.date(),不要手工加减。 处理步骤:① 关机前用 rtc.set 写入 UTC 时间;② 上电后比对 rtc.get 与 os.time,偏差大说明备份电源掉过;③ 需要断电保时就外接纽扣电池到备份电源脚;④ 时区统一用 rtc.timezone 配,代码里别硬编偏差;⑤ 长期运行的项目定期用网络时间校正。 参考文档:https://docs.openluat.com/air780epm/luatos/app/common/rtc/

28. Air780EPM用IRTU固件,724上的NET_MODE和NET_STATUS在780上用哪两个管脚?

解答: 结论:780 上不再有固定的 NET_MODE/NET_STATUS 脚,iRTU 用可配置的 NETLED(默认 GPIO26)与 NETRDY(默认 GPIO27)代替。 说明:724 时代这两根是模组固定引出的状态脚;780 平台把它们做成软件可控的普通 GPIO,在 iRTU 后台的 GPIO 页选脚即可。电平定义:NETRDY 连上服务器为高电平、未连上为低电平;NETLED 未联网时 100ms 高/100ms 低快闪,连上服务器是亮 200ms、灭 1800ms,联网但没连上服务器是亮 500ms、灭 500ms。 处理步骤:① 后台开启 GPIO 功能;② NETLED 与 NETRDY 各选一个空闲 GPIO;③ 提交配置后让设备重新开机才生效;④ 用万用表或示波器量电平与闪烁节奏验证;⑤ VDD_EXT 默认 3.3V,外部指示电路按 3.3V 设计,别串 5V 负载。 参考文档:https://docs.openluat.com/value/irtu/docs/gpio/

29. Air724原理图上的1.8V在780上还用吗?

解答: 结论:不用。724 原理图上的 1.8V 在 780 上没有对应网络,780 的 IO 参考是 VDD_EXT,默认 3.3V。 说明:VDD_EXT 是模组内部 3.3V 电源引出,主要供给接口上拉,不是对外供电电源。1.8V 只在特定型号上出现(如 Air780EVT-1.8V 这类 IO 电平为 1.8V 的型号),普通 780 是 3.3V。直接把 724 的 1.8V 电路搬过来,会把上拉接到一个不存在的网络上,表现为上拉失效或电平不对。 处理步骤:① 原理图里凡接 724 的 1.8V,改成 VDD_EXT 或独立 3.3V 电源;② 逐个核对外设 IO 电平是否 3.3V 兼容;③ 必须用 1.8V 器件就外加电平转换;④ VDD_EXT 只做上拉,不要拿来带负载;⑤ 改完做一次全 IO 电平检查。 参考文档:https://docs.openluat.com/air780epm/luatos/hardware/

30. Air8607的CAN1/CAN2有没有可跑的程序?

解答: 结论:Air1603 有 2 路 CAN FD(CAN1/CAN2,与 UART1/UART2 复用),但 8607 板上没有 CAN 收发器,要外加收发器和 5V 供电才能真正跑起来。 说明:CAN 是差分总线,SoC 只出 TX/RX 逻辑信号,必须有收发器才能上线;常见收发器如 CA-IF1051VS 要 5V 供电,不能直接用 VBAT 或 VDD_EXT。复用关系上,CAN1_TXD 与 UART1_RXD 同脚,占了 UART1 就不能同时用 CAN1,CAN2 与 UART2 同理;8607 的 50PIN 接口没引 CAN,需要飞线或改板。 处理步骤:① 先确定 CAN1/CAN2 与 UART 的占用取舍;② 外加收发器与 5V 供电,注意共地、120Ω 终端电阻;③ 用 can 库 demo 验证收发;④ 参照 Air8000 的 CAN 应用页配置参数与时序;⑤ 改板时把 CAN 引到对外端子,并留终端电阻位置。 参考文档:https://docs.openluat.com/air1603/luatos/hardware/ · https://docs.openluat.com/air8000/luatos/app/driver/can/

31. Air1603的VDD_EXT能否对外提供电流?

解答: 结论:不能当对外电源用,只能做接口上拉;外设要自己加 LDO 或 DC-DC。 说明:Air1603 的 VDD_EXT(PIN24)是内部 3.3V 参考电源引出,文档明确写了不能给 LCD、背光、摄像头、以太网芯片、音频功放供电,也不能用内部电源器件的额定电流去推「能带多少」。用 VDD_EXT 带负载,轻则外设工作不稳,重则把内部电源拉垮导致整机复位。 处理步骤:① 列出各外设的电流需求,分别配独立电源;② VDD_EXT 只接上拉电阻;③ 复核现有原理图,确认没有把外设 VCC 误接 VDD_EXT 或 VRTC;④ 5V 器件单独做 5V 支路;⑤ 上电时序按外设规格安排,避免同时冲击。 参考文档:https://docs.openluat.com/air1603/luatos/hardware/

32. Air8602/Air8203如何下载程序?提示按BOOT复位怎么操作?

解答: 结论:Air8203 板上没有 USB,走 5 针 DOWNLOAD 测试点加 USB 转 TTL,上电或复位前把 BOOT 与 VDD_EXT 短接;Air8602 用板载 CH343 转串口下载,DBG_UART 固定 6Mbps。 说明:BOOT 短接必须发生在上电或复位之前,上电后再短接无效;不短接则是正常开机进调试模式。8203 下载时其余串口不能有信号输入,否则会干扰握手。给模组 VBAT 直接供电时电压不能超过模组规格上限(780 系列 3.3~4.35V),不要把 USB 的 5V 直接接到 VBAT;8203 整机走 VIN 5~36V。 处理步骤:① 按原理图接好 DOWNLOAD 测试点上的 TXD/RXD/BOOT/GND;② 上电前短接 BOOT 与 VDD_EXT,再上电;③ Luatools 里选对应固件下载;④ 8602 先装好 CH343 驱动,并保证其它串口无信号;⑤ 找不到设备先查线序、电平与是否真的进了下载模式。 参考文档:https://docs.openluat.com/air8203/software/debug/ · https://docs.openluat.com/air1601/product/air860x/air8602/module/circuit/download/

33. 使用Air780EPT在户外场景,天线末端防雷TVS/ESD器件推荐什么型号?

解答: 尚未解答

34. 4G模组能否在只有3G信号的外蒙地区联网?

解答: 结论:合宙 4G Cat.1 模组只支持 LTE,没有 3G/2G 回落;外蒙只要有 LTE 覆盖就能用,型号选欧亚版。 说明:Air8000U 是欧亚版,覆盖欧洲与亚洲(日本除外),频段 B1/B3/B5/B7/B8/B20/B28/B38/B40/B41;Air8000N 是北美版。只覆盖 3G 的地方联网不了,这是制式差异,不是参数配错,也不存在「刷个固件就支持 3G」。 处理步骤:① 先确认当地运营商有 LTE,且频段落在支持列表内;② 选欧亚版型号,不要用国内版;③ 核对 SIM 卡的漫游状态与 APN;④ 覆盖弱就加大天线增益或改位置;⑤ 具体国家覆盖查海外版本页,必要时找 FAE 复核。 参考文档:https://docs.openluat.com/air8000/product/pinduan/

35. Air780EPM/Air780E是否都有现货,最少购买数量是多少?

解答: 结论:属商务事项,现货与起订量随库存和档期变化,需要按当天的报价与库存确认,文档里不给固定数字。 说明:Air780EPM 与 Air780E 都是常规在售型号,正常情况下有货;电商渠道会有起订量或限购限制,批量项目走线下商务更灵活。价格和库存是动态的,任何写死在文档里的数字都会过期,所以这类问题只能落到具体询价。 处理步骤:① 用完整型号(含丝印后缀)去询价,避免型号混淆;② 电商下单受起订量限制时,找对接销售走线下订单;③ 批量项目提前给用量预测,便于锁货;④ 有交期要求就写进合同,别只口头确认。 参考文档:无(属商务事项,请通过购买渠道或对接销售确认)。

36. 合宙淘宝店铺搜不到了怎么办?

解答: 结论:店铺地址是 luat.taobao.com,搜索不到属平台侧限制,直接用链接进店即可。 说明:店铺此前因引导客户加微信被平台处罚,搜索权重被降,所以关键词搜不到;店铺本身和商品链接不受影响,可以正常下单与售后。需要发票、批量价或定制的,走商务渠道更快。 处理步骤:① 直接在浏览器访问 luat.taobao.com;② 找不到某个具体商品,让对接人发商品链接;③ 批量、开票、定制走线下商务;④ 售后按淘宝订单流程处理,保留订单号与聊天记录。 参考文档:无(属商务事项,请通过店铺链接或对接销售确认)。

37. Air8607的排线端子是XH2.54还是PH2.0?

解答: 结论:是 2.0mm 间距端子(PH2.0 系列),不是 2.54mm 的 XH2.54;LCD 本身另走 50PIN 排线连接器。 说明:8607 的显示是常规 50PIN RGB565 连接器,触摸单独走 FPC,板上对外的小间距插座与端子是 2.0mm。间距选错的表现是压不进、或者能插但接触不良,批量做线束前一定要先量针距。 处理步骤:① 用卡尺量实际针距(2.0 与 2.54 差得很明显);② 按 PH2.0 选端子和线材;③ 屏线按 50PIN 规格单独订;④ 插拔前断电,避免冲击背光与屏驱动;⑤ 线束做好后做一次拉拔与通断检查。 参考文档:https://docs.openluat.com/air8607/product/

38. Air8000/Air8607外壳的3D打印文件能否提供?

解答: 结论:外壳 3D 打印文件不随文档公开发布,需要向对接人要。 说明:外壳结构件属整机配件资料,是否提供、以什么格式提供由商务确认;已提供的以对接人给的版本为准,注意版本与批次要对得上,不同批次的接口位置可能有微调。 处理步骤:① 说明用途(打样验证还是结构评估)与需要的格式(step 或 stl);② 找对接销售或 FAE 索取;③ 拿到后核对版本号与实物尺寸;④ 量产结构件仍要按正式图纸与模具走,别直接拿打印件开模。 参考文档:无(属商务事项,请通过对接人确认)。

39. AirCloud云平台需要额外开通吗?收费和不收费有什么区别?

解答: 结论:不需要额外开通,注册合宙 IoT 账号就能用;收费按套餐分档,测试版与各档 VIP 的年费、设备数、消息量都不同。 说明:平台是「年费 + 设备数 + 每日上行消息量」三件事一起分档:测试版 59 元/年,3 台设备、每日上行 1000 条;VIP1 是 3000 元/年、600 台设备;VIP2 是 10000 元/年、2500 台;再往上还有 3 万、6 万、10 万档。设备数、每日消息量、二级用户、数据存储都能按扩容表加购(例如设备数扩容 100 台 500 元)。另外按 AirCloud 协议自己搭后台,合宙不收费。 处理步骤:① 先注册账号用测试版验证业务闭环;② 按设备数与日上行量选档,别只看设备数;③ 超出部分按扩容表加购,比跳档更划算时再跳档;④ 费率会调整,下单前以线上收费标准页的最新表格为准。 参考文档:https://docs.openluat.com/value/iot/

40. libfota2能否支持第三方升级平台,不绑定合宙平台?

解答: 结论:能。libfota 和 libfota2 都支持自建第三方 HTTP 升级服务器;libfota3 只对接合宙 IoT 平台,不支持自建。 说明:第三方服务器要满足约定(升级包可下载、返回 200/206、版本与包信息按约定给出),libfota2 用 request 的第二个参数传服务器地址与升级包信息。新项目对接自建服务器建议用 libfota2;另外 libfota2 需要应用层自己保证已联网、时间已同步,而 libfota3 内部会自动等网络与校时。 处理步骤:① 服务器按约定提供升级包与版本查询;② 用 libfota2.request(cb, opts) 传 url 等参数;③ 回调里按返回值判断(2 表示 url 错误等);④ 注意「返回 200 但报文 0 字节」也算失败;⑤ 需要平台侧的定时检测与升级上报,就换 libfota3 走合宙平台。 参考文档:https://docs.openluat.com/osapi/ext/libfota2/ · https://docs.openluat.com/osapi/ext/libfota3/

41. Air780EPM的WiFi/GNSS等库未开启,能否提供临时固件?

解答: 结论:可以申请临时测试固件,把 WiFi/GNSS 等未默认开启的库打开,但只能测试,不能量产——这类固件一般不含空中升级。 说明:标准固件按「通用够用」裁剪,冷门库默认不编进去以省空间;临时固件是按需求单独编的,功能在,但没走完测试与认证,也没有 OTA 通道,量产会卡在升级与认证上。另外 Air780EPM 自身没有 WiFi 射频,WiFi 相关库对应的是外挂 WiFi 模组的驱动能力,不是「打开就能连 WiFi」。 处理步骤:① 列清楚需要哪些库、分别什么用途;② 向 FAE 提申请,说明项目背景与时间要求;③ 拿到后先在样机验证功能,别直接上产线;④ 量产等正式固件,或改选默认就带这些库的型号;⑤ 临时固件版本号做好记录,便于后续对照。 参考文档:https://docs.openluat.com/air780epm/luatos/firmware/780ehm_version/

42. Air780EPM的GNSS定位请求AIRLBS不到,可能是什么原因?

解答: 结论:先确认用的是 airlbs(付费多基站加 WiFi 混合定位)而不是免费单基站的 lbsloc2,再确认请求发出时网络已就绪。 说明:airlbs 要 project_id 与 project_key,要上报多个基站(可选 wifi_info),由服务器做三角定位,精度比单基站高得多。拿不到结果常见于:网络还没 IP_READY 就发请求、key 或项目无效、请求次数超限、参数里基站信息为空。调试阶段不需要 CCED、WIFISCAN 这类命令,wifiscan 还会让 4G 天线短暂不可用。 处理步骤:① 打印请求参数与返回码,先排除参数问题;② 等 socket 的 IP_READY 再请求,PSM 唤醒后尤其要加等待与重试;③ 核对 project_id/project_key 与账号是否匹配;④ 去掉 wifiscan 相关调试代码再测;⑤ 仍失败把日志与返回码给 FAE 定位。 参考文档:https://docs.openluat.com/osapi/ext/airlbs/ · https://docs.openluat.com/air780egh/luatos/app/common/lbswifi/

43. Air8607运行约52分钟会重启,如何处理?

解答: 结论:52 分钟不是典型看门狗周期,先抓完整日志定位是应用层还是底层;也可以先用 102 号固件排除分区与文件系统问题。 说明:内部 wdt 默认 180 秒超时,外置 Air153D 是 STRAP 决定 10 分钟/60 分钟/12 小时/24 小时,而且 8607 出厂配置里并没有启用外置看门狗。「固定在一个较长周期重启」更像内存泄漏、文件系统写满、连接保活失败后反复重连把资源耗尽,或者某个定时逻辑把自己绕死。 处理步骤:① 取 Luatools log 目录里的 trace.txt,重点看重启前最后几十行;② 上电后定时打印 rtos.meminfo 的 lua/sys/psram,看是否单调下降;③ 换 102 号固件(脚本区 4MB、文件系统 1.5MB)复测,排除写满;④ 关掉非必要业务做二分定位;⑤ 日志与复现步骤一起给 FAE。 参考文档:https://docs.openluat.com/common/howtouselog/ · https://docs.openluat.com/air1603/luatos/firmware/1603_version/

44. Air8701的测试项是否完整?

解答: 结论:测试项已按当前版本写完,相关同事确认暂无补充;后续新增功能会同步更新。 说明:测试项覆盖度属项目内部交付物,具体清单不在对外文档逐条列出;如果需要用于客户验收,可向对接人索取当前版本的测试项与测试结论,按实际交付版本对齐。 处理步骤:① 明确验收范围(哪些接口、哪些场景);② 找对接人取当前版本的测试项与结论;③ 有补充测试需求按项目提出,不要只口头说;④ 版本升级后重新取一次,避免拿旧清单验收新固件。 参考文档:无(属项目内部交付物,请向对接人索取)。

45. Air8603/U盘HOST无法枚举,VBUS使能脚是GPIO12还是GPIO58?

解答: 结论:两个脚都出现过,但指的不是同一件事——Air8603 上 UVC_EN(J8/J14 的 +5.5V 使能)是 PIN58/GPIO58;GPIO12 是 USB HID 模块里 vbus_gpio 的缺省值,属另一套板级配置。 说明:J14 的 +5.5V 不是直供,由 U0022(JW5357S)产生、EN 接 UVC_EN,所以在 8603 上要让 U 盘枚举必须先把 GPIO58 拉高(若该脚被贴成 485_EN2,拉高只影响第二路 485)。另外切 HOST 的顺序不能错:先 pm.power(pm.USB,false),再 usb.mode(0, usb.HOST),注册 usb.on(0, cb),最后 pm.power(pm.USB,true);顺序错会漏掉第一个接入事件。切到 HOST 后 Type-C 那路 USB 串口日志可能消失,改走 UART 抓日志。 处理步骤:① 拉高 GPIO58 给 J14 供电;② 按上面顺序切 HOST 并注册回调;③ 用 1031 版 102 号固件加 sd_usb_transfer demo 复测(该版本号目前不在公开固件列表内,需向 FAE 索取);④ 收到 usb.MSC 且 event 为 EV_CONNECT 后调 fatfs.mount(fatfs.USB, "/udisk", app_id),失败等 300ms 重试;⑤ 枚举仍失败先量 J14 的 +5.5V 与 D+/D- 是否共用对。 参考文档:https://docs.openluat.com/air8603/software/debug/ · https://docs.openluat.com/osapi/core/usb/

46. Air1601临时固件缺少汉字字库报错如何处理?

解答: 结论:换 V1031_Air1601_101 号固件测;101 号把内置字库编进程序里,102 号是从固定 flash 地址读,临时固件若按 102 号构建而 flash 里没有字库区,就会报缺字库。注意 V1031 目前不在公开固件列表里,需要向 FAE 索取。 说明:Air1601/1602/1603 共用同一套固件编号与分区方案:101 号是脚本区 1MB 加文件系统 3MB、字库编进程序;102 号是脚本区 4MB 加文件系统 1.5MB、字库从固定地址读取并单留 1MB 给 TTS 数据。所以「缺汉字字库」本质是分区与资源位置不匹配,不是字库文件丢了。 处理步骤:① 先换 101 号固件验证;② 确认手上的临时固件是按哪个编号编译的;③ 必须用 102 号就把字库按固定地址烧进去;④ 也可以改用 font_load 加载外置 ttf 绕过内置字库;⑤ 版本号与分区对照固件页逐项核对。 参考文档:https://docs.openluat.com/air1601/luatos/firmware/1601_version/ · https://docs.openluat.com/osapi/core/airui/

47. Air8800/Air8784的通话回声抑制问题?

解答: 结论:Air8784 是 Air780EHM 加合宙自研的语音芯片 Air1103,回声抑制由 Air1103 完成,SIP 免提通话接近零回声;对比只用 ES8311 的方案,只能靠结构上隔离 mic 与喇叭。 说明:Air1103 与 780EHM 之间走 UART 而不是 I2S,芯片内部跑回声抑制算法,并以固件形式出厂烧好;它同时兼做 Audio Codec,所以省掉了 780EHV 上那颗 ES8311。Air1103 不单独对外出售,必须搭配合宙主控一起用;这套架构同样适用于 VoLTE 通话。 处理步骤:① 硬件按 8784 参考设计做,AEC 回采通路要接对;② 结构上仍要做好 mic 与喇叭的隔离与减震;③ 音量不要拉满,避免削顶把回声顶出来;④ 用 SIP 体验平台实测对讲效果;⑤ 自研板按 Air1103 手册核对电平、供电与串口协议。 参考文档:https://docs.openluat.com/air8784/product/air1103/ · https://docs.openluat.com/air8784/product/

搜索