常见问题 - 2026-09-14
数据日期：2026-09-14
1. Air780EHV/Air8000播报TTS时对方接通电话会死机怎么解决？
解答： 结论：该问题需要修改底层固件才能解决，目前已移交研发处理；请配合提供死机时的日志以加速定位。
原理：TTS 播报过程中对方接通电话，相当于在同一时刻并发占用音频播放通道与 VoLTE 通话链路。这一类资源抢占发生在底层音频调度层面，脚本层无法通过加延时或改调用顺序彻底规避，因此必须由固件侧修复。
处理步骤：① 在 Luatools 中打开日志目录，找到 4gdiag 目录下的死机日志，连同模组型号、固件版本号、最小复现脚本一起整理；② 通过官方企业微信群提交给合宙技术支持，由其转交研发定位；③ 在拿到修复固件前，业务上尽量避免“TTS 外放中立即拨号”，改为等播报结束、音频通道释放后再发起呼叫，可降低复现概率。
参考文档：https://docs.openluat.com/
2. Air780EHV VoLTE通话接通后没有声音、19秒自动挂断是什么原因？
解答： 结论：这是音频 debug 开关未打开导致音频链路异常，先把 audio_v2.debug 打开，再用 exaudio 扩展重新抓取日志分析。
说明：VoLTE 通话的音频通道建立、编解码协商过程依赖底层音频框架，默认情况下相关过程日志不输出，一旦通道协商失败，外部表现就是接通后听不到声音并在超时后被挂断。打开 debug 后可以完整看到音频通道的申请、打开与异常返回，便于区分是固件参数问题还是硬件音频通路问题。
处理步骤：① 在脚本中打开 audio_v2.debug 开关，重新上电复现；② 用 exaudio 扩展抓取日志（注意 exaudio 库目前尚未适配该 debug 模式，需按官方说明配合基础音频日志一起看）；③ 把日志中音频通道申请失败的返回码、模组型号与固件版本提交官方技术支持确认；④ 同时确认麦克风、喇叭接线与功放供电正常，排除硬件因素。
参考文档：https://docs.openluat.com/
3. git clone https://devgit.luatos.com/openLuat/luatos-doc-pool.git 报错如何修复？
解答： 结论：报错是因为 HTTP 方式不支持断点续传，大仓库拉取中断后会失败，建议配置 SSH 密钥后改用 SSH 方式 clone。
原理：HTTP(S) 协议在传输中断时没有可靠的续传机制，文档仓库体量较大、文件数量多，网络稍有波动就会整包失败；SSH 方式配合 Git 自身的重传机制更适合此类仓库。
处理步骤：① 在本机生成 SSH 密钥对，把公钥添加到 devgit.luatos.com 的账号设置中；② 把远端地址改为 SSH 形式后重新 clone，例如将 https://devgit.luatos.com/... 换成 git@devgit.luatos.com:... 的对应写法；③ 若本地已有中断的目录，先删除残缺目录再重新拉取，避免残留物导致后续操作报错；④ 网络条件较差时可先浅克隆（--depth 1）再逐步拉全历史。
参考文档：https://docs.openluat.com/
4. 小程序/web端登录后没有业务菜单、移动端账号被踢，是什么原因？
解答： 结论：这是移动版在切换 oauth 登录时未与 web 版区分接口，导致小程序拿到的是 web 版菜单、却因权限不匹配访问不到业务菜单，并触发移动端账号被踢，该问题已修复。
原理：同一套后端同时服务 web 端与移动端时，需要按客户端类型区分登录接口与返回的菜单/权限集合。移动版复用 web 版接口后，返回的菜单项与移动端实际可用的业务权限不一致，用户看到的是“有菜单但点进去不可用”或“没有业务菜单”的现象，同时两端登录态互相顶号造成被踢下线。
处理步骤：① 确认所用小程序/web 端已更新到修复后的版本，必要时清理本地缓存后重新登录；② 若仍在自研前端上复现，检查前端在切换 oauth 时携带的客户端类型标识是否与后端约定一致；③ 登录后若菜单仍为空，核对当前账号在后台配置的角色与业务菜单授权；④ 仍有异常时提供账号、登录端类型、复现时间给合宙技术支持排查。
参考文档：https://docs.openluat.com/
5. NTP_UPDATE消息如何区分基站同步和NTP服务器同步？
解答： 结论：NTP_UPDATE 消息是带参数的，参数为 1 表示基站同步，参数为 0 表示 NTP 服务器同步，可按该参数区分；另外 NTP_UPDATE 与 NTP_ERROR 的文档描述需要更新到 docs。
说明：基站同步由网络侧直接下发时间，NTP 同步则由设备主动访问时间服务器获取，两条路径的成功事件复用了同一个消息名，只能依赖参数值区分来源。开发时若不分来源直接更新时间，可能在网络切换时被粗粒度时间覆盖。
处理步骤：① 在 sys.subscribe("NTP_UPDATE", ...) 回调中读取第二个参数，按 1/0 判断时间来源；② 对时间精度要求高的业务只采纳 NTP 服务器同步结果，基站时间可用于兜底；③ 同时订阅 NTP_ERROR 做失败统计与重试；④ 该两处消息的描述已列入文档更新计划，最终以官方文档最新说明为准。
参考文档：https://docs.openluat.com/
6. socket.ntptm()与os.date的时间来源不一致、存在两套时间怎么处理？
解答： 结论：NTP_UPDATE 消息确实存在基站同步与 NTP 服务器同步成功都发同一条消息、未区分来源的问题，后续版本会增加区分；当前可先只保留一套时间来源，或在两套时间差过大时重新校时。
原理：os.date 反映的是系统 RTC 时间，可能来自网络下发的基站时间；socket.ntptm() 则是通过 NTP 协议获取的网络时间。两者来源不同，基站时间粒度通常较粗，因此会出现同一时刻读到两个不同时间、且差值固定的现象。
处理步骤：① 选定一套权威时间来源，推荐以 NTP 校时结果为准，并统一用它更新系统时间，避免业务代码混用两套时间；② 在每次 NTP_UPDATE 回调中比较新时间与本地时间，差值超过阈值时直接重新设置系统时间；③ 对时间敏感的场景同时记录同步来源，便于事后核对；④ 升级到已区分来源的后续固件版本后，按新的事件参数调整逻辑。
参考文档：https://docs.openluat.com/
7. 64位固件如何获取毫秒级时间戳？
解答： 结论：可参考 socket.ntptm 接口获取毫秒级网络时间，见官方文档 https://docs.openluat.com/osapi/core/socket/#socketntptm ；如果不要求绝对时间，也可用 tick 计数与已知时间做换算得到毫秒时间戳。
说明：os.time() 一般只提供秒级精度，不满足毫秒需求。socket.ntptm 返回的是毫秒级 NTP 时间，适合需要高精度绝对时间的场景；而 tick 是系统启动后的毫秒计数，属于相对时间基准，不能直接当绝对时间使用。
处理步骤：① 需要绝对毫秒时间时，先完成一次 NTP 校时，再用 socket.ntptm() 取值；② 需要高频取时间戳时，用 tick 获取毫秒增量，再叠加一次校时基准，减少网络开销；③ 换算时注意单位（毫秒/秒）与溢出，避免 32 位计数回绕；④ 不同固件版本接口返回格式可能不同，以所用固件对应的 API 文档为准。
参考文档：https://docs.openluat.com/osapi/core/socket/
8. little_flash是否加锁，出现除0错误（speed变为0）导致系统崩溃怎么办？
解答： 结论：该崩溃的根因是 SPI 对象被提前释放，导致后续该地址被其他模块申请并写入 0（speed 变为 0），从而出现除零异常；lf.init 返回的 flash_device 内部并不持有 spi_device 的生命周期，需由业务侧保证其生命周期。
原理：little_flash 在初始化时会保存传入的 SPI 设备引用，之后每次读写都通过这个引用下发命令。如果业务在 lf 使用期间释放了 spi_device，该对象占用的内存可能被回收再分配给别的模块，SPI 对象的 speed 字段就可能被覆写成 0，底层在按 speed 计算分频时便出现除零，进而崩溃。
处理步骤：① 检查脚本中是否存在提前 spi.close() 或重复初始化 SPI 的代码，确保 SPI 设备的生命周期覆盖整个 little_flash 使用期；② 不要在 lf 使用过程中释放或重新创建同一 SPI 通道，需要切换时先关闭 lf 再操作 SPI；③ 建议到仓库提交 issue 说明该生命周期约定，并在文档中补充说明，避免其他用户踩坑；④ 复现时保留崩溃日志、脚本与固件版本，便于研发确认。
参考文档：https://docs.openluat.com/
9. luatools资源无法连接/老硬件（Air9000）上位机如何下载历史版本？
解答： 结论：老硬件只能使用与之配套的老版本上位机，新版本 LuatPower 不支持老硬件；历史版本可在 Luatools 的资源下载里获取。
说明：上位机与硬件之间存在通信协议与功能约定的对应关系，新版本上位机在功能重构后不再兼容早期硬件。若强行使用新版上位机连接老设备，通常表现为资源下载失败、连接不上或功能选项不可用。
处理步骤：① 确认手上硬件的具体型号与硬件版本，明确其对应的上位机版本区间；② 打开 Luatools，在资源下载列表中查找该硬件的配套上位机历史版本并下载安装；③ 安装老版本前先卸载新版本，避免两个版本的驱动与配置互相干扰；④ 若资源下载入口本身打不开，先检查本机网络与代理设置，或通过官方渠道获取历史版本安装包；⑤ 新老硬件混用时建议分开在两台电脑上维护，不要在同机反复升降级。
参考文档：https://docs.openluat.com/common/Luatools/
10. 功耗分析仪Air9000连接后1秒内自动断开、点击连接无反应怎么办？
解答： 结论：Air9000 是测量工具、本身没有输出能力，因此上位机在检测到不支持 PD 时会有相应提示，这是正常现象；连接后 1 秒内自动断开属于上位机与固件的兼容问题，需要升级工具或使用配套老版本上位机，研发正在跟进并会提供新固件。
说明：功耗分析仪的职责是给被测设备供电并采集电流曲线，不对外输出供电能力，所以“无输出”不是故障。连接中断则多发生在软件与设备固件版本不匹配时，握手完成后很快超时掉线。
处理步骤：① 确认使用与 Air9000 配套的上位机版本，必要时换回老版本上位机验证；② 更换 USB 数据线与 USB 口，排除线材与接口供电问题；③ 连接前先不要挂载被测负载，减少上电瞬间的电流冲击干扰握手；④ 记录上位机版本、设备固件版本与断开时间，提交官方技术支持，等待其提供的新固件后再升级验证。
参考文档：https://docs.openluat.com/
11. Air510W 3.3V供电电流近500mA发烫是什么原因？
解答： 结论：原理图中的 R1/R22 应为 33pF 电容（原文档误写成电阻/0 欧），把隔直电容错装成电阻后会失去隔直作用，导致功耗异常、发热；把 R22 改为 33pF 后即恢复正常。
原理：射频通路中的串联器件承担隔直（隔断直流、只让射频通过）的作用，必须用电容实现。若按错误文档焊成 0 欧电阻，直流分量会直接流入后级，造成静态电流大幅升高，器件持续发热，同时射频性能也会劣化。
处理步骤：① 对照修正后的硬件文档，把 R1、R22 位置由电阻更换为 33pF 电容；② 检查同批次已生产的板子是否存在相同错装，统一整改；③ 整改后重新测量 3.3V 供电电流与温度，确认恢复到正常水平；④ 以官方最新版硬件设计文档/原理图为准投产，投板前可将原理图提交合宙评审以避免同类笔误。
参考文档：https://docs.openluat.com/
12. $CFGAREPH主动请求星历配置的手册参数格式不对怎么解决？
解答： 结论：该指令手册中的参数格式存在错误，且该操作本身不支持“保存”，因为模组使用的是 ROM 固件、没有可写的配置区；该问题已确认并修正文档。
说明：星历相关配置在 ROM 固件下属于只读或会话级配置，掉电即恢复默认，因此手册中出现的“保存”类参数在实现上无法生效。手册参数格式与固件实际解析不一致时，按手册拼出的语句会被固件判定为非法或直接忽略。
处理步骤：① 先按修正后的参数格式重新下发 $CFGAREPH，确认固件有正常返回；② 不要再尝试保存配置，参数配置范围以本次会话为准，需要时每次开机重新下发；③ 若仍无响应，抓取指令下发的原始报文与模组返回，核对波特率、换行符与语句长度是否被截断；④ 以官方文档更新后的版本为准，避免继续沿用旧版手册参数。
参考文档：https://docs.openluat.com/
13. Air510W除$CFGMSG外有没有批量关闭输出语句的命令？$EPHABNORMAL能否关闭显示？
解答： 结论：目前没有批量关闭输出语句的命令，只能逐条分别关闭；$EPHABNORMAL 的关闭显示需求已由朱天华确认会处理。
说明：NMEA 输出语句是逐条使能/关闭的，固件没有提供一次性关闭全部语句的开关，因此减少串口输出只能通过逐条配置实现，这也是当前 GPS/星历类指令集的既定设计。
处理步骤：① 列出当前实际输出的语句类型，逐条用 $CFGMSG 关闭业务不需要的语句，例如只保留定位与时间相关的语句；② 减少输出后重新上电，确认串口带宽与解析负载明显下降；③ 对于 $EPHABNORMAL 是否支持关闭显示，按朱天华确认的处理结论执行，落地前先以官方文档/固件版本说明为准；④ 若业务上仍需要临时屏蔽，可在脚本解析层过滤关键字，不改动硬件与固件配置。
参考文档：https://docs.openluat.com/
14. 预烧LuatOS后可以保存多大的Lua脚本？
解答： 尚未解答
15. 8700H SPI接Air6205创建AP热点，手机连上无法获取IP如何排查？
解答： 结论：官方已提供该场景的可用 demo，按 demo 配置后手机可以正常连上 WiFi 热点，并通过热点进入配置文件页面，建议直接参考该 demo 实现。
说明：SPI 接口的 WiFi 方案中，热点创建、DHCP 服务、以及与 4G 侧的转发链路都需要按约定顺序初始化，缺少任一步骤都会表现为“手机能连上但拿不到 IP”。官方 demo 已把这些初始化顺序与配置写全，可作为基线。
处理步骤：① 先跑通官方 demo，不改动其初始化顺序，确认手机能获取到 IP；② 对比自研代码与 demo 的差异，重点检查 DHCP 服务是否随热点一起启动、IP 网段是否与 4G 侧网段冲突、SPI 引脚与速率配置是否一致；③ 手机端查看是否拿到的是 169.254 开头的自动地址，若是则说明 DHCP 未响应；④ 逐步把自己的业务代码合并进 demo，定位引入问题的改动点。
参考文档：https://docs.openluat.com/
16. Air780EGP固件只有103/104/105/109/110/111，109/110的说明在哪里？
解答： 结论：109 版本不支持 GNSS，可参考 Air780EPM 固件的说明，版本号相同的固件内容基本一致。
说明：Air780EGP 与 Air780EPM 属于相近平台，固件按版本号对应发布，但由于选配能力（是否带 GNSS）不同，同一版本号下 EGP 的 109 不带 GNSS 功能。因此在查阅 109/110 的功能说明时，直接对照 EPM 同版本号的发布说明即可，注意剔除 GNSS 相关内容。
处理步骤：① 按版本号在 Air780EPM 固件版本页查找对应版本的更新说明；② 把其中与 GNSS 相关的描述视为不适用于 EGP 的 109 版本；③ 选择固件时先明确业务是否需要 GNSS，不需要时可直接使用 109，需要时选带 GNSS 的版本；④ 升级后核对实际可用功能，避免仅凭版本号推断。
参考文档：https://docs.openluat.com/
17. Air8783固件收不到电信短信、无法自己获取手机号？
解答： 结论：使用最新固件 2050 版本，该版本已支持电信网络，可解决收不到电信短信、无法获取本机号码的问题。
说明：中国电信的短信与本机号码获取依赖网络侧对模组能力的支持，早期固件在电信网络下的短消息通道与号码读取流程存在兼容性不足，因此会出现只能上网、收不到短信或读不到号码的现象。新版本固件已针对电信网络补齐支持。
处理步骤：① 到 Air8783 对应的固件版本页下载 2050 版本，用 Luatools 烧录并核对版本号；② 使用已激活、未欠费的电信 SIM 卡，等待完整注网后再测试短信接收与号码读取；③ 若仍收不到短信，检查短信中心号码、卡是否开通短信功能、信号强度等网络侧因素；④ 使用定向卡时确认相关业务域名/短信通道未被限制，必要时联系运营商确认。
参考文档：https://docs.openluat.com/
18. Air780EPM从去年5月至今封装、焊盘大小有变化吗？开钢网有什么建议？
解答： 尚未解答
19. Air780EPM掉线概率比780E高很多怎么办？
解答： 结论：先升级到最新固件再对比测试，当前使用的 2016 版本较旧，建议参考 Air780EPM 固件版本页升级到最新正式版本。
说明：模组的驻网保持、弱网重连等网络行为都在固件中实现，早期版本在特定网络环境下的掉线概率偏高属于已知范围的兼容性问题，后续版本持续做了网络稳定性优化，因此“换固件再比”是排查此类问题的第一步。
处理步骤：① 到 Air780EPM 固件版本页下载最新正式固件，与脚本一起完整烧录，核对版本号确已更新；② 用同一张 SIM 卡、同一地点、同一脚本做前后对比测试，记录掉线次数与掉线时长；③ 排查业务侧因素：确认是否频繁重连、心跳是否过密、供电是否充足（发射瞬间电流不足会导致掉线）；④ 若最新固件下掉线率仍明显偏高，保留固件版本号、日志与复现条件，通过官方企业微信群提交研发分析。
参考文档：https://docs.openluat.com/
20. Air780EHM是否支持VoLTE高清通话？
解答： 结论：支持，Air780EHM 具备 VoLTE 高清通话能力。
说明：Air780EHM 属于带语音能力的型号，VoLTE 通话由模组侧协议栈完成，无需外挂语音芯片；实际能否建立通话还取决于所用 SIM 卡是否开通 VoLTE 业务以及当地运营商网络的支持情况。
处理步骤：① 使用已开通 VoLTE 的 SIM 卡，确认运营商网络支持该业务；② 使用与型号匹配的最新正式固件，音频相关库一并更新到同一版本；③ 依次验证拨出、呼入、双向语音与挂断，确认音频通道正常；④ 通话异常时抓取完整日志并记录固件版本，提交官方技术支持定位。
参考文档：https://docs.openluat.com/
21. Air8000U和Air8000A引脚是否兼容？
解答： 结论：引脚兼容。
说明：Air8000A 与 Air8000U 的主要差异在射频频段（面向不同地区/运营商），模组封装与管脚定义保持一致，因此在硬件上可以直接按同一套封装设计，不需要为换型号重新改板。
处理步骤：① 硬件设计可沿用同一套封装与管脚，但射频匹配、天线选型需按目标地区频段重新确认；② 软件上必须使用目标型号对应的固件与配套库，不要把 A 的底层固件烧到 U 上；③ 更换型号后建议先跑通用功能自检（注网、数据、通话等），再做目标国家/运营商的实测；④ 频段与国家对应关系以官方产品页的频段说明为准。
参考文档：https://docs.openluat.com/
22. Air8000W能否使用USB摄像头？没有USB口时用什么方案？
解答： 结论：Air8000W 无法使用 USB 摄像头；该平台不带 USB Host 能力，需要 USB 摄像头方案时应改用 Air1601 模组。
说明：USB 摄像头依赖主机侧的 USB Host 控制器与相应的 UVC 驱动支持，Air8000W 的定位是蜂窝通信模组，不具备这一硬件能力，脚本层也无法绕过。Air1601 定位为可外接摄像头的模组，是这类需求的替代选型。
处理步骤：① 明确业务需要的是拍照采集还是视频推流，以及分辨率与帧率要求；② 选用 Air1601 并按其官方摄像头 demo 接入摄像头，注意确认支持的像素上限；③ 结合联网方式规划整体架构，例如由 1601 完成采集与本地处理后经其他模组上行；④ 选型前把整机功能需求提交官方技术支持确认，避免二次改板。
参考文档：https://docs.openluat.com/
23. 合宙有没有支持夜视的摄像头？
解答： 结论：有，可关注 AirCAMERA_1034（支持补光）与 AirCAMERA_1032（夜视效果不错）。
说明：夜视能力主要取决于摄像头的感光能力与是否配置补光。部分摄像头在弱光下依靠自身高感光或红外补光仍能成像，另一部分则通过外部补光模块提升亮度，选型时需要结合现场照度决定。
处理步骤：① 明确使用场景的最低照度、是否需要红外补光、是否需要彩色夜视；② 对照 AirCAMERA_1034 与 AirCAMERA_1032 的规格确认接口（USB/DVP）与像素是否满足需求；③ 确认摄像头与主控型号匹配、供电与走线满足要求；④ 有条件时先用样机加官方 demo 在真实夜视场景下实测成像效果，再定型号。
参考文档：https://docs.openluat.com/
24. Air8000A的GPS auto_open配置如何使用？用TIMERORSUC开auto_open定位不了。
解答： 结论：默认情况下不用管 auto_open，先按默认配置做其他测试；若对配置差异有疑问，可直接询问 ai.luatos.com。
说明：auto_open 属于 GNSS 自动开启相关的配置项，涉及自动开启的触发条件与时序。在业务尚未验证基础定位链路之前就去调整它，容易把“定位失败”的根因误判到配置项上，反而掩盖真正问题（例如天线、供电、环境遮挡等）。
处理步骤：① 先保持默认配置不动，在室外开阔环境下冷启动测试，确认能否正常定位；② 定位正常后再评估是否需要 auto_open，并按官方 GNSS 文档与 demo 的用法配置触发方式；③ 排查时区分定位类型，确认拿到的是卫星定位还是辅助定位结果；④ 需要准确的配置说明时，通过 docs.openluat.com 或 ai.luatos.com 的 AI 问答入口咨询，并以官方文档结论为准。
参考文档：https://docs.openluat.com/
25. exaudio播放HTTP stream遇到重定向的URL播放不了怎么办？
解答： 结论：这不是固件 bug，把 http 换成 https 即可正常播放。
说明：很多音频源站会对裸 http 请求返回 301/302 重定向到 HTTPS 地址，而当前音频流播放链路没有实现自动跟随重定向，于是表现为打不开流或播放中断。改用 HTTPS 直接访问目标地址，就绕开了重定向这一环。
处理步骤：① 先在电脑浏览器中打开原 http 地址，确认它是否被重定向到 https 以及最终地址；② 把脚本中的播放地址直接替换为最终的 HTTPS 地址，重新测试播放；③ 若 HTTPS 地址仍播不动，检查是否依赖证书/端口特殊、是否需要鉴权参数；④ 用同一 URL 在官方音频 demo 下做对照验证，确认问题在地址而不在业务代码。
参考文档：https://docs.openluat.com/
26. LuatOS脚本require时不能带子文件夹的'.'如何处理？
解答： 结论：LuatOS 的 require 不支持子文件夹路径和点号，脚本刷入设备后会全部铺平到同一个目录，因此不能靠目录结构区分同名模块。
说明：脚本区是一个扁平的文件系统，Luatools 下载时会把工程内所有 Lua 文件放到同一层级。因此 require("a.b") 这类写法在设备上无法解析，电脑上看似正常的目录层级在设备侧并不存在。
处理步骤：① 电脑里可以按业务分目录存放便于维护，但 require 时只写模块文件名，不要带路径与点号；② 从源头避免重名，不同目录下的模块应使用不同的文件名，例如加业务前缀；③ 工程内文件名保持唯一，避免下载时互相覆盖导致加载到错误模块；④ 修改后先在本地确认所有 require 引用的文件都已加入下载列表，再烧录验证启动日志。
参考文档：https://docs.openluat.com/
27. Air780EHM和Air8000W的ETH和TF卡共用SPI，底层能否同时使用？
解答： 尚未解答
28. 8300/8210等能否支持PoE（PSE）供电？
解答： 结论：当前寄来的安卓板不支持 PoE 供电；PoE 方案会显著增加成本（光器件单项就超过 20 元，整体会增加大几十元），建议采用 DC 供电方案更为合适。
说明：PoE 需要在板端增加受电/供电控制电路与专用变压器等磁性器件，物料成本与布板面积都会明显上升，且需要配套的 PoE 交换机或供电设备。对于这类整机，DC 直供电在成本与可靠性上更有优势。
处理步骤：① 先明确供电距离与是否需要与网络同缆传输，只有在走线受限时才考虑 PoE；② 若确认需要 PoE，评估供电功率等级（PSE 输出能力、受电端功率）与整体成本，并确认硬件需要重新设计；③ 采用 DC 供电时按整机功耗选配合适的电源适配器，并确认电压范围与余量；④ 具体供电方案与改板可行性请通过官方企业微信群与技术支持确认。
参考文档：https://docs.openluat.com/
29. 485与摄像头等外设供电时，隔离485与非隔离485如何选择？
解答： 结论：如果 485 除了通信还要给外设供电，要么选用非隔离 485，要么在主控板侧额外加隔离电源模块；否则隔离 485 不仅无效，反而有害。
说明：隔离 485 的核心在于把 485 收发侧的电源域与主控侧完全隔开，从而切断地环路、提高抗干扰与安全性。一旦用隔离 485 的隔离侧电源去给外设供电，隔离电源的负载能力与隔离屏障就被破坏，两侧通过外设形成寄生回路，隔离作用失效，还可能引入干扰甚至损坏器件。
处理步骤：① 先梳理该 485 口是否需要对外供电，需要供电时优先选非隔离 485 方案；② 若必须保留隔离，则在主控板侧增加独立的隔离电源模块，把外设供电与隔离侧电源分开；③ 检查 485 侧的隔离电压等级、共模抑制与近端保护（TVS、限流）是否满足现场电磁环境；④ 布线时避免隔离两侧的地线跨接，保留爬电距离。
参考文档：https://docs.openluat.com/
30. 烧录时出现ack error code:236报错，多刷几次才成功是什么原因？
解答： 尚未解答
31. 8081/8101等使用新版本Luatools下载后不启动、无打印，怎么解决？
解答： 结论：先继续使用老版本 Luatools 完成下载，新版本 Luatools 在 8081/8101 上的问题研发正在排查。
说明：该现象是特定硬件平台与新版本下载工具之间的兼容问题，模组本身并未损坏，只是新工具生成的下载流程/配置与平台不匹配，导致下载完成后设备没有正常启动、也没有串口打印。使用已知可用的老版本工具可立即恢复生产。
处理步骤：① 换回原先可正常下载与启动的 Luatools 版本，重新完整烧录内核与脚本，核对版本号；② 记录新版本 Luatools 的版本号、8081/8101 的固件版本与完整日志，提交官方技术支持协助定位；③ 在新版本问题修复前，产线统一锁定老版本工具，避免版本漂移；④ 若必须使用新工具，先在一块样机上验证“下载→启动→打印”全流程通过再推广。
参考文档：https://docs.openluat.com/common/Luatools/
32. Air8201G开发板免BOOT下载不成功、没有boot和reset按钮怎么办？
解答： 结论：先关闭串口占用，然后在 Luatools 上方的一行选项中把型号选择为 4G；另外建议搭配串口小板进行下载，操作更方便、成功率也更高。
说明：免 BOOT 下载依赖工具通过已枚举的串口/USB 通道向模块下发重启进入下载模式的指令。若串口正被其他工具（串口助手、日志工具等）占用，指令下发失败就表现为无法免 BOOT 下载；而选错型号会让工具按错误的时序与参数操作。该开发板未引出实体 BOOT/Reset 按键，因此更依赖路径正确。
处理步骤：① 关闭所有可能占用该串口的软件，包括串口助手与正在记录日志的工具；② 在 Luatools 上方一行把型号选项选择为 4G；③ 使用质量可靠的 USB 数据线，必要时接串口小板辅助下载与观察打印；④ 免 BOOT 仍失败时按“先断电、再让工具进入下载等待、然后上电”的顺序重试，或改用强制下载方式。
参考文档：https://docs.openluat.com/common/howtodown/
33. 8201G没有BTB扩展口，刷固件应该接哪几个焊盘？
解答： 结论：可使用 8201G-BLMQ 开发套件进行烧录与调试，具体需要连接的焊盘请参考该硬件的管脚说明文档；有疑问也可向 ai.luatos.com 咨询。
说明：没有 BTB 扩展口意味着无法通过现成底板直接引线，必须依赖开发套件或直接从模组焊盘引出下载所需的电源、地、USB 数据与 BOOT 等信号。管脚定义以该型号硬件文档为准，不能凭经验推断。
处理步骤：① 优先使用 8201G-BLMQ 开发套件，按套件说明完成接线与下载，风险最低；② 需要自行引线时，打开对应硬件文档的管脚说明，逐一确认 VBAT、GND、USB D+/D-、BOOT 等信号的焊盘位置；③ 引线务必短且可靠，USB 差分线尽量等长并靠近模组，供电要满足发射瞬间电流需求；④ 首次烧录时内核与脚本一起下载，确认设备管理器中只出现一个下载口即表示进入了下载模式。
参考文档：https://docs.openluat.com/common/howtodown/
34. Air780EGH串口0打印日志波特率是多少？乱码怎么解决？
解答： 结论：Air780EGH 属于 4G 平台，日志打印走 4G 通道；出现乱码时可按抓底层日志的方式走 epat，并把波特率设置为 6000000。
说明：新平台的日志输出速率远高于传统调试串口，若仍按常规波特率接收，数据来不及解析就会显示为乱码。使用匹配的抓取工具与正确的超高波特率，才能完整获取底层日志。
处理步骤：① 使用支持该抓取方式的上位机/脚本走 epat 通道；② 将波特率设置为 6000000，并确认电脑串口与驱动支持该速率；③ 检查数据线质量与长度，高速率下劣质线材会直接导致误码；④ 抓到日志后核对时间戳与内容是否连续完整，若仍乱码再确认固件版本与抓取工具的配套关系。
参考文档：https://docs.openluat.com/
35. Air780EPM接Air6205A实现的WiFi热点功能怎么做？
解答： 结论：官方已提供该组合下可用的 demo 代码，直接参考并测试即可，测试结果正常。
说明：Air780EPM 提供蜂窝联网能力，Air6205A 提供 WiFi 能力，两者配合实现热点时，关键在于 SPI/接口通信的初始化顺序、DHCP 服务启动时机以及 4G 侧到 WiFi 侧的数据转发配置。官方 demo 已经把这套流程跑通，可作为基线直接用。
处理步骤：① 获取并跑通官方 demo，确认设备能创建热点、手机能连接到热点并获取 IP；② 在 demo 基础上逐步接入自己的业务逻辑，每次只改一处并回归，便于定位引入问题的改动；③ 确认 SPI 引脚与速率配置、供电与复位时序与官方方案一致；④ 自研硬件出现异常时对照官方 demo 的硬件连接方式逐一比对。
参考文档：https://docs.openluat.com/
36. e3zt58hesn上如何归属设备到项目？之前下载固件刷入后自动归档的方式失效了。
解答： 结论：该自动归档方式目前已不支持；需要归属设备到项目时，可直接向 AI 提问获取当前操作方法（docs.openluat.com 或 ai.luatos.com 右下角的 AI 问答机器人）。
说明：平台侧的设备归属/归档规则会随版本迭代调整，早期“下载固件刷入后自动归档到项目”的机制已经失效，继续按老流程操作不会生效，需要改用平台当前提供的绑定方式办理。
处理步骤：① 打开 docs.openluat.com 或 ai.luatos.com，使用页面右下角的 AI 问答机器人直接提问“如何归属设备到我们的项目中”，按最新回复的步骤操作；② 操作前准备好设备的完整 IMEI 与目标项目信息，避免归属到错误项目；③ 归属完成后在项目的设备列表中核对设备是否出现、上报是否正常；④ 若按最新说明仍无法归属，把 IMEI、项目信息和操作截图提交官方技术支持核查。
参考文档：https://docs.openluat.com/
37. Air724UG后续还会升级吗？
解答： 结论：Air724UG 没有升级计划；如果新产品有强需求，建议切换到其他型号。
说明：产品线的迭代资源会集中到在售主力型号上，Air724UG 属于较早的平台，后续不再安排功能升级。对于新立项的产品，继续选型老平台会在功能扩展、供货节奏与技术支持上受到限制。
处理步骤：① 新项目按功能需求从当前在售型号中重新选型，参考官方选型指南逐项比对通信制式、频段、语音、定位、外设与封装；② 已有老项目若需长期维护，建议提前规划替代型号并预留改板时间；③ 切换型号时注意固件与库需配套更新，业务脚本需回归测试；④ 具体替代型号与迁移可行性可通过官方企业微信群与销售、技术支持确认。
参考文档：https://docs.openluat.com/
38. Air780系列固件必须更新到最新，现有低固件设备有什么影响？
解答： 结论：只需把固件升级到不低于 v2036 的版本即可，功能不受影响；受影响的只是国庆之后新采购的设备，之前的设备都不受该要求影响。
说明：该要求来自特定批次/时间点之后的兼容性调整，属于“新设备需要满足最低版本”的规则，并不意味着所有存量设备都必须升到最新。已出厂并在用的低版本设备，只要业务运行正常，不需要为此强制升级。
处理步骤：① 新采购的设备确认固件版本不低于 v2036，低于该版本时升级后再投产；② 存量设备保持现状即可，不必因为该要求全量升级；③ 若存量设备本身存在网络异常需要升级，按固件版本页下载最新正式版本并完整烧录，注意保留回退手段；④ 批量升级前先在小批量设备上验证，确认业务功能正常后再推广。
参考文档：https://docs.openluat.com/
39. MQTT连接凌晨断连后不自动重连，怎么处理？
解答： 结论：把重连逻辑改为脚本侧处理，并配合网络业务逻辑看门狗，相关示例已在编写，预计第二天写好并发布。
说明：凌晨断连多与运营商网络侧的重置、心跳超时或长时间无业务流量被回收有关。依赖底层自动重连在部分场景下不够可靠，改为在脚本中显式检测连接状态并主动重连，同时用看门狗监控业务是否“假在线”，可以显著提升恢复能力。
处理步骤：① 订阅 MQTT 的连接/断开事件与网络状态事件，断开后按退避策略（如递增间隔、设置上限）重连，避免高频重连耗流量；② 增加业务层看门狗：在设定时间内没有收到心跳应答或业务数据交互，就主动断开并重建连接；③ 断连期间的上行业务数据按重要程度决定缓存或丢弃，避免无限堆积；④ 待官方示例发布后以其实现为参考，结合自身业务调整参数。
参考文档：https://docs.openluat.com/osapi/core/mqtt/
40. Air780EGH和Air780EHU的代码是否兼容？烧录时SOC需要按模组选择吗？
解答： 结论：应用层代码是通用的，但烧录时必须选择对应模组的型号编号，同时注意管脚复用与管脚配置文件是否一致。
说明：两个型号在同一平台上运行，LuatOS 的应用层 API 与业务逻辑基本可以直接复用。真正的差异在底层固件与管脚定义上：不同型号的可复用管脚、默认功能分配可能不同，若烧录时选错型号编号，会导致外设不工作甚至无法正常启动。
处理步骤：① 烧录时在 Luatools 中按目标模组选择对应的型号编号，不要沿用另一型号的选择；② 逐一核对两份管脚配置文件，确认业务用到的管脚在两个型号上功能一致；③ 若某管脚在目标型号上被复用为其他功能，需要在脚本中改到空闲管脚；④ 切换型号后完整回归外设与外网功能，必要时用最小脚本先验证启动与外设初始化。
参考文档：https://docs.openluat.com/
41. Air8000是否支持模拟DAC输出音频（从5/6脚输出）？
解答： 结论：Air780EQ 不支持模拟 DAC；Air780EVT 内部带有 8311 解码芯片，不需要外部再接；如果确实需要模拟输出，可使用 Air780E。
说明：是否具备模拟音频输出能力取决于模组内部的音频通路设计。部分型号把解码、功放集成在模组内，外部直接接喇叭即可；另一些型号则只提供数字音频接口，无法从引脚输出模拟信号，脚本层无法改变这一硬件特性。
处理步骤：① 先明确整机需要的是模拟输出（接功放/喇叭）还是数字音频；② 按需求对照各型号的音频规格选型，需要模拟输出时选用 Air780E，带板载解码的场合可选 Air780EVT，避免外挂重复的解码电路；③ 确认所选型号的音频接口引脚定义与功放匹配（阻抗、功率、是否差分）；④ 最终以对应型号的硬件手册音频章节为准。
参考文档：https://docs.openluat.com/
42. Air780EHV做定频测试有功率fail，能否通过固件降低功率？
解答： 结论：不能通过固件方式随意降低功率，需要把设备寄回重新校准，把功率校低一些。
说明：射频发射功率由校准数据决定，属于产测环节写入设备的参数。定频测试中功率超标说明当前校准值偏高，正确做法是重新执行校准流程，把该频段的功率校准到允许范围，而不是在应用固件里改发射功率。
处理步骤：① 记录 fail 的频点、测试功率值与所用测试仪表，整理成清单随设备一并寄回；② 按其指引寄回后重新校准，明确希望功率校准的目标值/余量；③ 校准返回后重新按原先的测试条件复测定频项目，确认通过；④ 后续量产时把该频段纳入产测项，避免同类问题再次流出。
参考文档：https://docs.openluat.com/
43. bl0942的软件调试是发给你们做还是你们写好我们自己加载？
解答： 结论：0939 的方案合宙已经写好，你们可以参考 0939 用 AI 尝试适配 0942；如果自己写不出来，可把设备寄回来由合宙调试。
说明：0939 与 0942 属于同一类计量器件，寄存器定义与通信流程相近但不完全相同，因此 0939 的既有实现是最好的参考起点。官方给出两条路径：先自行基于 0939 参考适配，或直接寄回由合宙完成调试。
处理步骤：① 拿到 0939 的实现作为参考，先对照 0942 的器件手册核对寄存器地址、数据格式与校表流程的差异；② 可用官方 AI 问答（docs.openluat.com 或 ai.luatos.com）辅助生成与排查代码；③ 适配过程中先打通读寄存器、再校表、最后验证计量精度，分步验证便于定位；④ 若自行调试困难，联系官方把设备寄回，由合宙侧完成调试后交付可用代码。
参考文档：https://docs.openluat.com/
44. AirUI默认字体太小，字库哪里有现成的？
解答： 结论：14 号固件里已经自带了字库，可以基于现有字库修改底层来调整字体。
说明：字体大小由所用字库决定，AirUI 的默认字体来自固件内置字库。直接把字号调大而字库中没有对应点阵，就无法正确显示，因此需要从字库层面解决，而不是单纯改脚本里的字号参数。
处理步骤：① 使用 14 号固件，确认其中已包含所需字库；② 在脚本中改用字库中实际提供的字号，避免使用未包含的尺寸；③ 若需要更大或更特殊的字体，按官方字库制作/替换的方式修改底层后重新烧录验证；④ 更换字库后注意脚本区/资源区容量是否足够，必要时精简其他资源。
参考文档：https://docs.openluat.com/
45. LuatOS-SoC_V2012_EC718HM下发的配置文件无法下发，AT固件AT_V2034_EC7XX可以，是什么原因？
解答： 尚未解答
46. Air780EPM/W8000A等量产品名称/开票/发票问题？
解答： 结论：可联系商务（邓燕妮、补玲芳、曾群）处理订单、合同盖章、发票与水单等相关事宜。
说明：产品名称对应、开票信息、发票类型与水单等属于商务流程事项，需要由商务对接到销售订单与财务系统处理，技术支持侧无法直接办理，因此应走商务渠道。
处理步骤：① 提前准备好需要的资料：订单号、公司开票信息（名称、税号、地址电话、开户行与账号）、发票类型与收件方式；② 联系商务（邓燕妮、补玲芳、曾群）并说明具体诉求，涉及合同盖章的同步说明用章类型与份数；③ 收到发票后核对发票上的产品名称与实际采购型号是否一致，不一致时及时反馈更正；④ 后续采购建议一次性把商务要求说明清楚，避免重复往返。
参考文档：https://docs.openluat.com/
47. Air780EPM/W8000A等是否有USB即插即用网卡（RNDIS）模组？
解答： 结论：有支持 RNDIS（USB 即插即用网卡）的模组，可加王城钧微信沟通具体项目需求。
说明：RNDIS 让模组在 USB 连接电脑后直接枚举为一张网卡，无需额外驱动与拨号即可上网，适合把 4G 网络共享给主机或工控设备的场景。不同型号在是否默认支持、是否需要特定固件以及枚举速度上都可能有差异。
处理步骤：① 先梳理项目需求：主控系统（Windows/Linux/Android）、是否需要免驱、USB 供电方式与整机功耗要求；② 加王城钧微信说明项目情况，确认推荐型号与所需固件；③ 拿到样品后先在目标主控上验证枚举、获取 IP 与上网连通性，再进入整机集成；④ 量产前确认所选型号的固件版本与 RNDIS 支持情况，避免批次差异。
参考文档：https://docs.openluat.com/
48. Air780EPM/W8000A批量价格、定制方案怎么咨询？
解答： 结论：批量价格可加江访微信咨询，定制方案可联系王棚嶙评估。
说明：批量价格与定制开发属于商务与技术评估范畴，需要结合实际数量、交期要求与定制内容（硬件改板、软件定制、认证等）来评估，公开页面无法给出统一结论，因此通过对应负责人一对一沟通获取。
处理步骤：① 联系批量价格：加江访微信，说明所需型号、数量与期望交期，获取报价；② 联系定制方案：与王棚嶙沟通，说明需要定制的部分（硬件、软件、功能裁剪）与量产规模，由其评估可行性与方案；③ 咨询前建议先整理一份需求说明，包含通信制式/频段、外设接口、工作环境、认证要求与预估年用量；④ 方案与报价以商务确认的最终结论为准。
参考文档：https://docs.openluat.com/
49. Air780系列GPS时间与系统时间有1-20毫秒抖动，如何精确获取时间？
解答： 结论：GPS 时间本身存在 1~20 毫秒的抖动，无法通过软件消除；如需精确时间，需要使用 PPS（秒脉冲）信号做硬件对齐。
说明：GPS 模块输出的时间信息是通过串口报文传输的，受报文发送时刻、串口传输时延与解析时机影响，天然存在毫秒级抖动，因此把报文中的时间直接作为精确基准会有误差。而 PPS 是模块在每个整秒时刻输出的硬件脉冲，边沿与实际秒时刻对齐，抖动远小于报文方式，适合作为高精度对时基准。
处理步骤：① 确认所选型号是否引出 PPS 信号，将其接到主控具有中断/捕获能力的引脚；② 用 PPS 上升沿作为整秒基准，对系统时间做对齐或校正，报文中的时间只用于确定年月日时分秒；③ 对时延敏感的场景，测量并补偿从 PPS 边沿到执行对时动作之间的固定延迟；④ 若仍需更高精度，需结合硬件定时器与时钟源的温漂做长期校准，具体实现以所用型号文档与官方 demo 为准。