常见问题 - 2026-09-12
数据日期：2026-09-12
1. Air1601 作为 TCP server 可以同时连接几个 client？
解答： 尚未解答
2. Air780EHU/Air780EHU 海外版设备在国外不能联网，是否需要开启漫游？APN 如何设置？
解答： 尚未解答
3. Air780EHU 海外版设备在国内可以升级，在国外不能远程升级，如何处理？
解答： 尚未解答
4. irtu 固件会请求更新，新项目中的默认参数会被更新到设备中吗？如何避免平台自动更改现场设备参数？
解答： 结论：会被更新。iRTU 设备开机时会向平台同步一次所属项目/分组的参数并覆盖生效，所以“把现场设备加进新项目”就等于接受新项目的默认参数，现场参数会被改掉。
避免办法（按风险从低到高）：
- 不要迁移现场设备：现场设备保持原项目不动，新项目只放新设备；这是最稳的做法。
- 必须迁移时，先在平台上把设备从原项目移除/删除，再在目标项目里添加，不要让两台项目同时“认领”同一 IMEI。
- 批量迁移前先迁 1 台做验证：确认迁过去之后设备参数、上报、连接是否符合预期，再批量搬剩下的。
- 别指望“自动更新开关”兜底：平台上的自动更新开关关掉并不能阻止开机同步这套逻辑，参数该覆盖还是会覆盖。
- 具体页面操作路径以 ai.luatos.com 的 AI 问答指引为准（不同版本后台菜单有调整）。
参考文档：iRTU 配置平台说明 https://docs.openluat.com/value/irtu/web/ ，设备归属与转移 https://docs.openluat.com/air780epm/product/attributioniot/ 。
5. 如何在 irtu 平台某个项目下删除某个设备？
解答： 尚未解答
6. 有适配过打印机或蓝牙标签打印模块吗？
解答： 结论：目前官方没有适配打印机或蓝牙标签打印模块，没有现成的库和 demo。
可以自己做的路线（按实现难度排序）：
- 串口/USB 热敏打印机：打印机绝大多数支持 ESC/POS 指令集，用模组的 UART 直接发指令与 GBK/点阵数据即可，只需在 Lua 层拼字节流，属于“自己实现”而非“官方适配”。串口用法见 https://docs.openluat.com/osapi/core/uart/ 。
- 蓝牙标签机：这类设备基本是 BLE 私有 GATT 协议，需要向厂商要到服务/特征值文档，再基于
ble库自己实现收发（https://docs.openluat.com/osapi/core/ble/ ）。合宙的 BLE 能力可以做客户端/服务端连接，但不含任何标签机协议。 - 需要官方出方案时：把打印机型号、协议文档、订单量提供给合宙商务，走定制评估。
- 选型提醒：需要 USB 主机模式接打印机时，要确认目标型号是否支持 USB Host；只支持从设备模式的型号接不了 USB 打印机。
7. LuatOS 的固件开发有相关文档吗？
解答： 结论：有，而且分几个入口，按需要去对应的那一份就行。
入口清单：
- 文档站首页（按型号组织）：https://docs.openluat.com/ ——每个型号下有“产品手册 / 硬件设计 / 固件和 demo / 应用教程”等分支。
- API 文档（核心库与扩展库）：https://docs.openluat.com/osapi/ ——
socket、mqtt、mobile、i2c、lcd等接口说明都在这里。 - 源码与 demo 仓库：https://gitee.com/openLuat/LuatOS ——
module/目录下按型号存放 demo，是最可靠的示例来源。 - 教程系列（入门到进阶）：https://docs.openluat.com/luatos_lesson/ ——烧录、GNSS、FOTA 等专题。
- AI 问答：https://ai.luatos.com/ ——文档里查不到的具体参数、报错可直接问。
建议顺序：先看对应型号的“固件和 demo”确认固件编号 → 跑通官方 demo → 再改业务代码；卡在具体 API 上时查 osapi。
8. Air780ER 是否适合自己写脚本、不用 AT 模式，通过串口与 MCU 通信？
解答： 结论：Air780ER 不合适。走“自己写脚本 + 串口与 MCU 通信”这条路，建议改用 Air8781P2，并购买官方开发板调试，官方可提供脚本层面的技术支持。
说明与建议：
- Air780ER 面向的是 AT 指令使用方式，不是给你跑自定义 Lua 业务脚本的型号；选型错了后面所有工作都会被卡住。
- Air8781P2 这类工业模组更适合“模组内跑脚本 + 串口和主控对接”的形态：若不想做二次开发，也可以先刷 iRTU 固件、用网页配置好串口透传与上报，把业务跑起来（https://docs.openluat.com/value/irtu/state/ ）。
- 一定要用官方开发板先调通（供电、串口电平、引脚复用都按官方板卡验证一遍），再上自己的板子，否则容易把软件问题和硬件问题混在一起。
- 选型确认：把“主控型号、串口波特率、数据量、是否要低功耗”发给官方企业微信群由合宙确认推荐型号。选型指南 https://docs.openluat.com/SelectionGuide/SelectionGuide/ 。
9. EVB_Air780EX 开发板用 Luatools V3.4.9 如何烧录程序？烧录失败怎么解决？
解答： 结论：Air780EX 属 EC618 平台，固件要选 EC618 对应型号的 soc（Luatools 的“资源下载”里就有），烧录时走“下载底层和脚本”。
烧录步骤：
- 打开 Luatools（建议升到最新版），在“资源下载”里下载 Air780EX 对应的 EC618 固件（soc） 与所需扩展库。
- 在“项目管理”里新建项目，选好刚下载的 soc。
- 把
main.lua及依赖的脚本、资源文件加入项目（与 main.lua 同目录或勾选加入）。 - 点击“下载底层和脚本”，按提示操作：按住 BOOT 键 → 点按一下 RST 键，让模组进入下载模式。
- 等待烧录完成，日志窗口会提示结果。
烧录失败的排查：
- 换一根短且确认带数据功能的 USB 线，直插主机 USB 口（不要用扩展坞）。
- 供电不稳也会导致失败，可用稳压电源给 VBAT 供 4V、限流 2A 再试。
- 仍失败时，把 Luatools 目录下
log里 tools 开头的日志发到官方企业微信群，这份日志能直接定位卡在哪一步。
参考文档：https://docs.openluat.com/common/howtodown/ ，工具教程 https://docs.openluat.com/common/Luatools/ 。
10. Air780EVT 的 SPK+/SPK- 没有波形输出、喇叭不播报，AT 指令是否正常？
解答： 结论：先分两步——硬件上确认功放（PA）通路是否做了，再用一组 AT 指令确认固件侧 TTS 是否正常。AT 型号的 SPK 脚一般不能直接推喇叭，需要外挂 PA。
第一步：硬件确认
- 确认板上是否加了音频 PA；多数 EVT 方案的 SPK+/SPK- 是走 PA 输出，没有 PA 就没有驱动能力，也就量不到波形。
- PA 的供电与使能要接对：把 PA 的
Net飞线到 VDD_EXT，确认使能脚在播报时被拉高。 - 用示波器在播报瞬间量 SPK+/SPK- 是否有差分波形，同时量 PA 输入脚是否有信号，可快速区分“模组没出声”还是“PA 没工作”。
第二步：用 AT 指令验证固件侧
- 先发
AT，确认模组有正常回显。 - 播报数字：
AT+CTTS=2,"1234567890"。 - 必要时设置 TTS 参数与音量：
AT+CTTSPARAM=80,2,50,50,0,2、AT+CRSL=10。 - 中文播报：
AT+CTTS=3,"你好，语音测试正常"；停止播报：AT+CTTS=0。
若 AT 指令正常发声而喇叭不响，问题在 PA 与喇叭；若 AT 指令无声音，检查固件是否为带 TTS/音频能力的编号，并确认音量参数没有被设成 0。
11. 合宙 WiFi 固件能降级吗？蓝牙串口卡顿如何对比测试？
解答： 结论：可以降级——固件都是本地烧录，用 Luatools 选目标版本的 soc 重新“下载底层和脚本”即可回退（若两版分区布局不同，烧录时勾选清除文件系统/KV 后整片重烧更干净）。
对比测试要点（要得出可信结论，必须控制变量）：
- 同一块板、同一天线、同一位置，手机/主机也固定用同一台、同一距离，避免环境变量污染结果。
- 同一份脚本和同一份数据量，只改固件版本这一个变量。
- 分别烧两版固件各跑 3 次以上，记录卡顿次数、丢包率、蓝牙串口吞吐，用 Luatools 抓日志留证。
- 若怀疑是 WiFi 侧问题，可同时比对 4G 侧吞吐作为对照（排除应用层逻辑导致）。
- 结论写到一起（版本号 + 现象 + 数据），再发到官方企业微信群确认是否为已知问题。
参考文档：Luatools 教程 https://docs.openluat.com/common/Luatools/ 。具体某型号的固件版本列表见其产品页“固件和 demo”栏目。
12. Air8000DB 读取不到数据，接线和上拉都正常怎么办？
解答： 尚未解答
13. Air780EHV 的 turnkey 源码要改代码，应该选哪个版本的底层固件和源码？
解答： 结论：选 Air780EHV 2050 版本的底层固件配套源码（后续会出 2052 等更新的版本，底层版本持续在升级）；具体版本对应关系以官方 Air780EHV turnkey 开发板文档为准，不确定的地方直接问 AI。
选择与改代码的建议：
- 固件与源码要配对：源码改动依赖对应的底层接口，选错版本会出现编译/接口不匹配。先确认手上开发板配套的固件版本，再取同版本的源码。
- 先跑通再改：烧官方固件 + 官方 demo 确认通话、音频、AirUI 等基础功能正常，再做本地修改，避免在未验证的环境上改代码。
- 改底层的边界：Lua 层能实现的优先在 Lua 层做；需要动 turnkey 源码/底层时的支持范围，建议在官方企业微信群确认后再投入。
- 版本更新信息见 https://docs.openluat.com/air780ehv/ 的固件与开发板文档。
14. Air8601 的 485 能改全双工吗？485 发送后不能自动接收返回怎么办？
解答： 结论：RS485 物理层本身就是半双工，不能“改成全双工”——收发共用一对差分线，同一时刻只能是发送或接收；要全双工需要 4 线制（RS422）或换成 RS232。
发送后收不到返回，按下面排查：
- 方向脚（DE/RE）时序：这是最常见原因。发送完后方向脚必须及时切回接收，切晚了对方的应答已经发完，切早了数据被截断。
- 用现成的自动控制实现：官方 demo 里已有自动控制 485 方向脚的 Lua 脚本，直接复用它的收发时序，不要自己用
sys.wait拍脑袋定时。 - 波特率/接线核对：A/B 是否接反、共地是否良好、终端电阻与线长是否匹配。
- 对方是否真的应答：用串口工具或示波器在 A/B 上抓一次完整报文，确认应答确实发出来了。
参考：demo 仓库 https://gitee.com/openLuat/LuatOS/tree/master/module ，串口用法 https://docs.openluat.com/osapi/core/uart/ 。
15. Air8000D 核心板 EVB_Air8000_BASE_V3 的 SPI0 管脚在哪里？
解答： 结论：该核心板没有引出 SPI0。
说明与替代：
- 核心板为了做小体积，只把常用外设（串口、USB、电源、部分 GPIO）引到排针/连接器上，SPI0 没有引出，所以在这块板上找不到对应引脚。
- 需要用 SPI0 时：①改用官方开发板（EVB），它把模组的 SPI 等接口都引出来了；②或在核心板上从模组焊盘飞线到 SPI0 对应管脚，管脚编号见该型号硬件手册的引脚复用表。
- 参考 Air8000 硬件文档：https://docs.openluat.com/air8000/luatos/hardware/ 。
16. Air8783 执行 AT+RNDISCALL=2 关闭 NAT 后模块起不来、USB 串口消失，是 bug 吗？
解答： 结论：从现象看是 bug——106、109 两个版本上都存在，执行 AT+RNDISCALL=2（关闭 NAT）后模组无法启动、USB 串口消失。
处理建议：
- 先别在现场用这条指令，尤其不要在已出货设备上做实验；当前版本该参数会把手里的板子搞到起不来。
- 恢复办法：按烧录流程强制进 Boot 模式重新烧写固件（参考 https://docs.openluat.com/common/howtodown/ ）。
- 反馈给研发：把固件版本号（106/109）、完整指令序列、复现步骤、现象（USB 串口消失的具体表现）和 Luatools 日志一起发到官方企业微信群或提 issue，便于研发复现和修复。
- 关注后续版本更新说明，确认该问题修复后再使用该指令。
17. 有 GPS 定位追踪的方案吗？
解答： 结论：有，按“要不要自己画板”分三条路：
- 免开发整机（最省事）：Air8202 / Air8202C——接电池就是完整的定位器，上电后可在官方位置服务里看位置与轨迹，不需要写代码、不需要画板。适合防丢器、车载定位这类只想快点出成品的场景。
- 自己做板、要外设与自定义逻辑：Air8201 系列（SoC + GNSS，LuatOS 二次开发）——可自己接传感器、喇叭、按键，经纬度自己通过 MQTT/HTTP 上报到自有服务器。
- 只想要定位数据、主控自己写业务：外挂 Air510W / Air530W 纯 GNSS 模组，从串口读 NMEA 数据自行解析。
选购与资料入口：选型指南 https://docs.openluat.com/SelectionGuide/SelectionGuide/ ，Air8202 资料 https://docs.openluat.com/air8202/product/ ，购买 https://luat.taobao.com/ 。选型前建议先确认：是否需要语音/屏幕、上报周期、电池续航与外壳形态。
18. Luatools 出现 setup failed 是什么情况？
解答： 尚未解答
19. Air780EHV/8602 喇叭声音小，最大音量 100 仍偏小怎么办？
解答： 结论：先别怀疑模组——音量已到 100 还偏小，通常是扬声器与声学结构的问题，不是软件音量没调满。可以换带腔体、8Ω/5W 的喇叭试，效果会明显好于裸喇叭；目前合宙没有输出功率更大的模块。
优化建议：
- 换带腔体的喇叭：裸喇叭没有背腔，低频和整体响度都会被压掉；有腔体的同规格喇叭响度高得多。规格上选 8Ω/5W 这类。
- 确认功放（PA）能力与供电：SPK 输出经过 PA 才有驱动能力，PA 供电电压不足会直接限制最大输出；用示波器看播报时输出幅度能确认是否已经削顶。
- 结构上做声学处理：喇叭开孔不要被外壳挡住、避免和小腔体共振，必要时加泄音孔。
- 提高源音频的音量：若播的是音频文件而不是 TTS，先确认源文件本身录得够响（归一化后再播），否则软件音量拉满也是在放大一个本来就小的信号。
- 确实需要更大声压级时，只能外挂更大功率的功放/换专门音频方案，需与合宙商务评估。
20. 写入数据失败，好多台设备都是这样，是什么原因？
解答： 尚未解答
21. AI 输入框被遮住、全屏按钮找不到的问题如何解决？
解答： 结论：把 Chrome 浏览器升级到最新版本即可解决——这是旧版 Chrome 的渲染问题，与页面缩放比例无关。
说明：先用最新版 Chrome（或 Edge）打开再试；若升级后仍有遮挡，清一次该站点缓存/Cookie 或用无痕窗口重开；换浏览器仍不行时，把浏览器版本号、操作系统版本和界面截图发到官方企业微信群或 AI 反馈入口，便于定位。