常见问题 - 2026-08-05
数据日期：2026-08-05
1. 语音通话中TTS文本较长且未播放完就挂断，再次拨打时TTS无声音或报busy，是什么原因？
解答： 原因是上一次通话的外部音源（TTS/音频文件）播放通道未正常释放，再次播放时通道被占用，导致无声音或返回busy。处理方法：每次播放前先不带参数调用 cc.extern_source() 清理上一次通话残留的播放状态，再调用 cc.extern_source(播放内容) 重新发起播放；播放应在收到 CC_IND 的 AUDIO_START 事件（音频通道已建立）后触发，通话挂断（HANGUP_CALL_DONE/DISCONNECTED）后状态会复位。另外注意：通话中播放TTS/音频需使用新音频框架，固件要求V2048及以上的13/113号固件，并确认 audio_drv.lua 中 audio_mode = "new"。官方demo module/Air8000/demo/cc/play_audio_during_cc.lua 已包含"播放前先清理状态"的完整写法，可直接参考。
2. Air8000模块在Luatools烧录时提示开始通信后下载失败，且USB端口消失，是什么原因？
解答： "开始通信"后下载失败且USB端口消失，通常是USB连接不稳定、驱动异常，或模组进入/未正确进入下载模式导致通信中断。按以下步骤排查：1、更换质量可靠的USB数据线，直连电脑USB口（不经过USB集线器），必要时更换电脑重装USB驱动；2、将Luatools更新到最新版本；3、使用强制下载方式：按住BOOT键（即USB_BOOT与VDD_EXT短接）再插入USB上电，Luatools提示检测到设备后再松开BOOT键，顺序不要乱；4、烧录时选用最新官方正式固件。若烧录完成后端口始终不出现，可在USB BOOT模式下重新烧录完整官方固件；仍无法恢复请携带烧录日志联系官方技术支持。烧录操作可参考固件烧录故障排查文档：https://docs.openluat.com/common/howtodown/
3. Air780EGP使用IRTU配置后GNSS/GPS一直无法定位成功怎么办？
解答： iRTU配置后无法定位，按以下顺序排查：1、iRTU配置后台修改参数后设备不会立即生效，设备每次开机时才与后台同步一次配置，修改后必须重启设备；2、GNSS定位必须在室外开阔无遮挡环境测试，室内、车窗内、高楼遮挡均无法定位，冷启动首次定位通常需要数分钟；3、确认GNSS有源天线供电和接线正确，天线供电脚需经电感（如47nH）馈电、信号脚接天线馈点，天线须支持GNSS频段，并核对iRTU中GNSS串口配置与硬件接线一致；4、用官方开发板烧录相同固件和iRTU配置做对比测试：开发板能定位则问题在底板硬件或天线，不能定位则为配置问题。iRTU GNSS配置可参考官方教程：https://docs.openluat.com/value/irtu/docs/gnss/
4. 模块进入低功耗模式（pm.power(pm.WORK_MODE, 1)）后USB断开，如何继续下载脚本？
解答： 这是正常现象：进入低功耗模式（pm.power(pm.WORK_MODE, 1)）后系统会关闭USB外设，否则无法真正进入低功耗，USB端口必然消失。需要重新下载脚本时，在上电前将模组的USB_BOOT引脚（Air780E系列为PIN82）上拉至VDD_EXT（3.3V），上电后模组即进入USB下载模式（Boot from USB），此时再用Luatools烧录；注意该引脚仅在需要USB下载时上电前短接，正常使用时不要短接，否则模组会等待约25秒无下载事件后才开机。建议同时将Luatools和模组固件更新到最新版本。参考BOOT引脚文档：https://docs.openluat.com/air780epm/luatos/hardware/boot/
5. air780egg/Air780EPM 支持定时唤醒吗？
解答： 支持。低功耗及PSM+深度休眠模式下均可定时唤醒：在进入休眠/PSM+前调用 pm.dtimerStart(id, timeout) 启动休眠定时器，该定时器由底层维持，在PSM+代码停跑状态下仍可工作，定时到期后自动唤醒模组；开机后用 pm.dtimerWkId() 判断唤醒源（返回定时器ID，非定时唤醒返回-1）并执行对应任务。Air780/Air700/Air8000系列最多支持6个休眠定时器（id 0-5），关机或断电后定时器失效。使用iRTU固件时，PSM+模式可在配置页面直接设置唤醒间隔（最大休眠时长约740小时）。参考PM库文档：https://docs.openluat.com/osapi/core/pm/ 及低功耗指南：https://docs.openluat.com/common/airpower/
6. 如何远程更换设备的服务器IP或域名？
解答： 建议业务服务器一律使用域名而非固定IP，更换服务器时只需修改域名解析，设备端无需改动。具体有两种方式：1、远程升级：通过FOTA升级脚本/固件，更新其中的服务器地址配置；2、使用合宙AirCloud云平台时，设备每次上线会调用getip调度接口，由平台根据负载和设备情况动态分配最优服务器节点，服务器迁移或容灾切换时平台侧自动下发新节点地址，设备固件无需硬编码IP（自建私有AirCloud服务器时可在 excloud.setup 中关闭getip并直接写入私有服务地址）。AirCloud协议说明参考：https://docs.openluat.com/protocols/aircloud/
7. HTTPS请求在更换服务器证书后失败，Air720G老设备对证书有什么要求？
解答： HTTPS单向认证时模组会校验服务器证书链：证书必须由模组内置CA库信任的CA签发、证书未过期、域名匹配，任一项不满足都会握手失败（MbedTLS报0x2700即证书验证失败）。服务器更换证书后请求失败，常见原因是新证书的签发CA不在老固件内置CA库中，或设备未做网络对时导致证书有效期校验失败。处理建议：1、确认设备已通过NTP/SNTP同步系统时间；2、在模组中内置新服务器证书链对应的根CA证书（CA证书与脚本一起烧录到文件系统，连接时指定CA路径）；3、若业务允许不校验证书，可关闭证书校验（传入nil/不配置CA，仅限可信内网环境，存在安全风险）；4、老型号TLS能力有限，建议升级到最新固件，长期产品推荐改用主推型号。证书排查可参考MQTT TLS文档：https://docs.openluat.com/luatos_lesson/003_luatos_mqtt/
8. 固件远程升级（FOTA）时，差分包太大是否会导致模组变砖？应该注意什么？
解答： 差分包大小必须与设备当前固件的FOTA分区容量匹配，超过分区可用空间的升级包无法正常刷写。主推型号FOTA分区普遍为192KB~768KB（多数固件为384KB，具体见FOTA分区表），制作升级包时务必确认大小在分区容量之内；跨度过大的版本之间差异数据多、差分包体积大且失败风险高。建议：1、升级包体积以FOTA分区实际可用空间为准，不要超容量制作；2、大跨度升级安排中间版本，逐版本差分升级，避免直接跨多个版本；3、升级流程使用libfota2库并处理回调错误码（0成功/1连接失败/2 URL错误/3服务器断开/4报文错误/5版本号格式错误）；4、保持设备固件为较新版本，新固件对升级异常有更好的校验保护。FOTA分区与升级流程参考：https://docs.openluat.com/luatos_lesson/009_luatos_fota/
9. Air780EPM 从2005版本FOTA升级到2046版本失败变砖，怎么办？
解答： V2005到V2046跨越多个固件版本，差异数据量大，差分包极易超过设备FOTA分区容量（主推型号FOTA分区多为192~768KB），是升级失败的主要原因。处理方法：1、不要跨大版本直接做差分升级，在两个版本之间选取一个中间固件版本，分两步（或多步）逐级差分升级；2、每一级升级包制作后确认大小不超过当前固件的FOTA分区可用空间；3、升级脚本中检查libfota2回调结果码，失败时记录错误码并保留现场；4、新项目统一升级到V2048等较新固件后再发布，新版固件升级校验机制更完善。已升级失败的设备可尝试USB BOOT模式烧录官方固件恢复。参考：https://docs.openluat.com/luatos_lesson/009_luatos_fota/
10. 使用软件I2C读取数据出现时钟暂停，硬件I2C对0x55从机地址支持不一致是什么原因？
解答： 软件I2C靠GPIO模拟时序，受中断调度影响可能出现时钟拉伸/暂停，稳定性弱于硬件I2C，生产场景应优先使用硬件I2C。硬件I2C使用注意：1、Air780EPM/EHM/EGH/EGG/EGP/EHV等型号的硬件I2C在每次通信结束后一定会发送STOP信号，若从设备要求传输过程中不能出现STOP，则只能改用软件I2C；2、I2C设备ID（iicid）以对应型号硬件手册为准（如i2c1的id为1），0x55等地址访问异常时，先将固件升级到最新版本（旧固件对部分地址处理存在缺陷），再用I2C总线扫描确认从设备应答地址，并核对上拉电阻、电平匹配和接线；3、速率可先降为100kHz（i2c.SLOW）验证。参考I2C库文档：https://docs.openluat.com/osapi/core/i2c/
11. AIR780E内置字库缺少生僻字，有什么办法显示？
解答： 固件内置矢量字库（MiSans-Demibold）仅覆盖GB2312一、二级汉字，不含生僻字，显示生僻字需加载外置TTF字体文件：将包含所需生僻字的TTF字体（建议用字体子集化工具裁剪，只保留用到的字符以减小体积）烧录到文件系统，通过 airui.font_load({type="hzfont", path="/luadb/xxx.ttf", size=字号, ...}) 加载，或用hzfont矢量字库方式加载后再显示；lcd核心库也支持通过 lcd.setFontFile() 加载bin点阵字体文件。注意文件系统空间有限（多数固件为168~192KB），字体文件必须裁剪。完整说明参考字体使用指南：https://docs.openluat.com/common/luatos_font_guide/
12. Luatools新版本下载脚本时提示错误或下载失败怎么办？
解答： 按以下顺序排查：1、将Luatools更新到官网最新版本；2、项目文件存放路径及Luatools安装路径不要包含中文、空格或特殊符号，尽量放在短英文路径下（如 D:\luat\）；3、关闭Luatools，删除其安装目录下的 _temp、log 缓存文件夹后重新打开；4、更换USB数据线、直连电脑USB口，必要时重装USB驱动或换电脑对比；5、仍失败时用USB BOOT强制下载模式（上电前短接USB_BOOT与VDD_EXT）重新烧录，并参考烧录故障排查文档逐项核对：https://docs.openluat.com/common/howtodown/
13. AIR780EPM 深度休眠时能否定时唤醒？
解答： 可以。深度休眠（PSM+）模式下代码停跑，但底层休眠定时器仍可工作：进入PSM+前调用 pm.dtimerStart(id, timeout) 配置定时唤醒，到期后模组自动唤醒，开机后用 pm.dtimerWkId() 返回值确认是否为休眠定时器唤醒（返回0~5为对应定时器ID，-1为其他唤醒源），再执行相应业务。Air780/Air700/Air8000系列最多支持6个休眠定时器；PSM+还支持UART数据（uart1 rx任意波特率）、Power-key、WAKEUP引脚等唤醒方式。使用iRTU固件时可在PSM+配置页直接填写唤醒间隔。参考低功耗文档：https://docs.openluat.com/air780epm/luatos/app/lowpower/sleep/ 及PM库：https://docs.openluat.com/osapi/core/pm/
14. Air724UG使用HTTP_GET整包下载OTA固件，MCU RAM太小无法整包缓存怎么办？
解答： 不要将固件整包缓存到MCU RAM。两种推荐做法：1、LuatOS二次开发：直接在模组侧调用libfota2库完成OTA（libfota2.request(cb) 自动完成版本检查、HTTP下载、校验），升级包由模组内部FOTA分区接收，MCU不参与数据缓存；2、AT指令方案：HTTP下载大文件使用断点续传方式（Range分段请求），模组支持将下载数据写入自身文件系统分段保存，再由MCU通过串口分段读取转发；模组HTTP可用缓冲区有限（约300KB），超过缓冲区的文件必须分段处理。参考HTTP断点续传：https://docs.openluat.com/atmozu/product/command/http/ 及FOTA教程：https://docs.openluat.com/luatos_lesson/009_luatos_fota/
15. 物联网卡连不上网且模组一直重启是什么原因？
解答： 模组反复重启多为"卡无法驻网"与"脚本异常重启"两类原因叠加。排查步骤：1、将该物联网卡插入手机测试能否正常上网，排除卡本身故障；2、联系卡商/运营商确认：卡是否已激活、流量是否用尽或欠费、是否有机卡绑定（IMEI绑定）、是否为专网卡需设置APN及白名单；3、检查脚本逻辑：确认是否存在"驻网失败/联网超时即rtos.reboot()"的处理，此类逻辑在卡或网络异常时会造成反复重启，应改为有限次重试+告警上报；4、升级到最新固件，旧版本存在断网后不重新驻网的问题。网络注册状态可通过 mobile.status() 及 SIM_IND 消息判断。参考：https://docs.openluat.com/osapi/core/mobile/
16. AIR780EPM含税批量价格是多少？有阶梯价吗？
解答： 模组价格随市场行情、采购数量和商务政策浮动，没有固定公开阶梯价表。Air780EPM为高性价比主推4G Cat.1 bis模组，批量价格请以合宙官方淘宝店（https://luat.taobao.com/ ）实时标价为准，大批量采购或框架协议价格请直接联系合宙商务获取正式报价。
17. Air780EPM/Air780EHV等型号如何查看CPU是否进入睡眠、低功耗电流如何测试？
解答： 判断CPU是否进入睡眠、测量低功耗电流的方法（万用表/功耗仪接线、测量点选择、各功耗模式电流参考值、睡眠判定依据）在合宙官方低功耗测量指南中有完整说明，直接对照操作即可：https://docs.openluat.com/value/drawcheck/ 。软件侧也可通过 pm.lastReson() 查询唤醒/复位原因，配合低功耗指南（https://docs.openluat.com/common/airpower/ ）确认模式配置。
18. Air8000的USB能否像U盘一样在电脑上显示TF卡内容？
解答： 不支持。Air8000的USB不提供U盘（USB Mass Storage）模式，电脑端无法像访问U盘一样直接看到TF卡/文件系统内容。USB可用于烧录调试及USB虚拟串口（VUART）数据转发（对应demo module/Air8000/demo/uart/usb_uart.lua）。如需在电脑端读写TF卡文件，可通过虚拟串口自定义协议传输，或由模组经网络（HTTP/FTP等）上传下载文件。
19. Air8000 SPI只有一路，又想扩展以太网又想扩展串口，是否可行？
解答： 可行。SPI是总线协议，一路SPI上可挂载多个外设，每个设备分配独立CS片选线分时复用（推荐用 spi.deviceSetup() 新接口，固件自动管理CS），合宙官方开发板即通过该方式在同一路SPI上同时挂载SD卡和CH390H以太网芯片。因此以太网（CH390/CH390H方案，可参考AirETH_1000配件板文档）和SPI转串口芯片可以共用同一SPI总线，只需各自占用一个CS引脚和对应中断引脚。若GPIO/中断资源仍不足，也可外挂Air1601/1602等MCU分担串口扩展。参考SPI文档：https://docs.openluat.com/air780epm/luatos/hardware/spi/
20. 780EHU和780EPM是否pin to pin兼容，硬件不用改？
解答： Air780EHU（海外频段）与Air780EPM（国内频段）同属Air780E系列，封装引脚设计兼容，PCB通常可以复用；但投板前必须以两款型号最新硬件设计手册逐脚核对（电源、SIM、天线、特殊功能引脚），并确认固件按对应型号烧录。天线不能直接沿用：两者支持的运营商频段不同，国内4G天线不保证覆盖海外目标频段，需按销售地区运营商频段重新选型并实测天线性能。硬件资料可在文档站对应型号产品页查阅：https://docs.openluat.com/air780epm/
21. QMC5883L停产了，可以用QMC5883P替代吗？
解答： QMC5883L的迭代型号为QMC5883P，可用于替代设计。LuatOS已提供两款传感器的扩展库：exs_qmc5883l 和 exs_qmc5883p（库文档 https://docs.openluat.com/osapi/ext/sensor/exs_qmc5883p/ ，demo见 module/对应型号/demo/sensor/qmc5883l）。迁移时注意：1、两款芯片的I2C从机地址、寄存器定义和初始化序列存在差异，软件需改用exs_qmc5883p库并按其API配置；2、硬件封装和外围电路（去耦电容、上拉电阻）以QMC5883P数据手册为准核对；3、芯片层面的参数差异建议以传感器原厂数据手册为最终依据。
22. 有没有支持VoLTE的4G模块中价格最低的型号？
解答： 合宙4G Cat.1系列模组普遍支持VoLTE语音通话。选型时请参考官方选型指南中"4G+语音二合一"章节，结合目标地区频段（国内/海外）、外设资源和供货状态选择主推型号（如Air780EHV、Air780EHM等语音增强型号），语音通话开发可参考cc库及通话demo。具体价格以官方淘宝店实时标价为准，批量价格联系合宙商务。选型指南：https://docs.openluat.com/SelectionGuide/SelectionGuide/
23. RAM dump文件（ramdump.bin）有没有工具可以分析？
解答： 量产设备建议接入errDump异常日志上报功能：系统崩溃、脚本错误、内存泄漏等异常会自动记录，异常重启后自动上报合宙IoT平台（需在平台手动打开debug开关）或用户自建UDP服务器，可先通过errDump日志初步定位，文档：https://docs.openluat.com/osapi/core/errDump/ 。本地排查ramdump/死机问题的有效方法是二分法：保留最小系统，逐项关闭功能模块（云连接、外设驱动、音频、UI等）压力测试，定位到触发死机的具体功能后单独复现验证；同时升级最新固件排除已知问题。仍无法解决时，提供最短可复现脚本、固件版本号和完整日志，联系官方技术支持分析底层。
24. Luatools更新到3.4.0后日志不打印、COM口消失是什么问题？
解答： 日志不打印、COM口消失通常是模组停留在USB BOOT下载模式（USB_BOOT引脚被上拉/VDD_EXT短接后上电会进入该模式，正常开机后才会枚举出虚拟串口）。处理：1、确认USB_BOOT引脚未被持续上拉，按正常方式重新上电（上电前不要短接BOOT）；2、更新Luatools到最新版本、更换USB线并重装USB驱动；3、Luatools界面显示异常（按钮/文字错位）与Windows显示缩放有关，可将系统缩放调为100%或拖动窗口边缘恢复布局，也可关闭软件后删除其目录下的ui缓存文件夹重新打开；4、参考烧录故障排查文档：https://docs.openluat.com/common/howtodown/
25. airtest.openluat.com服务是否异常？
解答： airtest.openluat.com是合宙提供的免费测试服务器（仅供开发测试，禁止商用），提供HTTP文件上传下载（:2900端口）、FTP（21端口，明文不加密）、MQTT测试（如:8888端口）等服务。遇到连接异常时：1、该服务器为免费共享资源，偶发维护或重启属正常现象，稍后重试，并确认使用的端口和协议与文档一致（如FTP必须用明文方式，加密连接会失败）；2、在电脑端用浏览器/工具直接访问对应服务地址，对比判断是服务器问题还是设备端网络问题；3、设备端排查SIM卡流量、信号、专网卡白名单（服务器IP/端口需加入白名单）；4、正式产品不要依赖该测试服务器，应搭建自有服务器。各测试服务说明见：https://docs.openluat.com/common/tools/http/ 和 https://docs.openluat.com/common/tools/ftp/ ；持续不可用可通过官方企业微信群反馈确认。
26. Air780EPM 从2044升级到2048没成功，如何排查？
解答： 按以下步骤排查：1、差分升级需要设备主动发起请求：脚本中必须调用 libfota2.request(cb) 主动向升级服务器发起HTTP版本检测，设备不会自动检测升级；2、确认升级包大小不超过当前固件FOTA分区可用空间（FOTA分区多为192~768KB）；3、记录回调结果码定位原因：1连接失败（检查URL、信号、SIM卡流量、专网卡白名单）、2 URL错误、3服务器断开、4报文错误、5版本号格式错误（使用合宙IoT平台时VERSION必须为xxx.yyy.zzz三段数字格式）；4、确认新旧固件的固件编号/分区布局一致（整包与差分不可混用）。仍无法定位可提供设备IMEI、固件版本号和回调错误码联系官方排查。参考：https://docs.openluat.com/luatos_lesson/009_luatos_fota/
27. FOTA升级同一台设备10分钟内只能升级一次吗？
解答： 是的，合宙IoT平台的FOTA升级服务对设备请求频率有限流策略（防止设备异常循环请求刷爆服务器），同一设备短时间内重复发起升级会被平台拒绝，量产设备表现为间隔约10分钟才允许再次升级。开发调试阶段可在IoT平台的FOTA项目设置中将调试设备加入白名单/调试设备列表（通常可添加少量设备，如最多3台），白名单设备不受该时间间隔限制，便于反复测试。具体限流规则和调试设备配置以IoT平台FOTA页面说明为准。
28. 如何把模块添加到自己的设备/项目里？
解答： 使用合宙IoT平台前，设备需先归属到自己账号的项目下：登录 iot.openluat.com，在"我的设备"中输入模组IMEI查询当前归属状态；未归属的设备可直接扫码/录入归属到本账号项目，已归属在其他账号的设备，淘宝店购买的联系客服提供IMEI和账号转移，线下采购的由原账号在平台执行设备转移，第三方采购的联系供货方协助转移。详细操作步骤见官方文档：https://docs.openluat.com/air780epm/product/attributioniot/
29. Air724UG的net_mode为低电平是什么意思？
解答： net_mode是模组的网络状态指示引脚（开漏输出，需外接上拉），低电平通常表示模组尚未注册上网络（未驻网/无服务），驻网成功后该引脚电平会按数据连接状态变化（常见定义为：未注册时常低或常高、注册成功后转为周期性电平翻转/呼吸指示，不同型号定义有差异）。建议：1、以Air724UG官方硬件设计手册中net_mode引脚的电平状态表为准确依据；2、软件侧用AT指令 AT+CGREG?/AT+CEREG? 查询注册状态（返回0,1为已注册本地网，0,5为漫游注册），与引脚电平交叉验证；3、若长期低电平不驻网，排查SIM卡、天线、信号和固件版本。Air724UG为AT指令模组，相关引脚定义可在文档站对应型号硬件手册中查阅。
30. 写程序后模块USB连不上，boot接地再通电也不行，如何解决？
解答： USB_BOOT引脚的正确用法是上电前上拉至VDD_EXT（3.3V），而不是接地：该引脚默认内部下拉，悬空/下拉时从Flash正常开机，上电前上拉至VDD_EXT才会进入USB下载模式（Boot from USB）。操作方法：先将USB_BOOT与VDD_EXT短接（开发板即按住BOOT键），再上电/插入USB，Luatools提示检测到设备后松开，即可重新烧录。注意该引脚只在下载时短接，正常工作时不可持续上拉，否则模组会等待约25秒无下载事件后才开机。参考：https://docs.openluat.com/air780epm/luatos/hardware/boot/
31. 有没有电池供电版的屏幕/开发板？
解答： 合宙带屏幕的开发板/核心板以常电供电（USB/外部电源）设计为主，屏幕背光和刷新功耗较高，不适合纯电池长期供电，因此没有专门面向电池长期供电的屏幕开发板版本。电池供电且需显示的低功耗场景，建议选用低功耗定位类模组方案（如Air8201系列），屏幕按需点亮、平时进入休眠，并参考低功耗指南（https://docs.openluat.com/common/airpower/ ）做电源设计。具体产品形态可咨询合宙商务。
32. Air780E的SPI接口能否外扩2G SPI NAND FLASH用于存储临时数据？
解答： 可以通过SPI外扩SPI NAND Flash。LuatOS的little_flash（lf）核心库支持驱动SPI NOR和SPI NAND Flash并挂载为littlefs文件系统（sfud库仅支持NOR Flash，NAND必须用lf库），官方已适配的SPI NAND型号包括W25N01GVZEIG（1Gbit）、W25N01KVZEIR、W25N02KVZEIR（2Gbit）、W25N04KVZEIR（4Gbit）；注意NAND Flash大多没有SFDP参数区，移植新型号时需手动填写芯片参数。硬件设计参考SPI NAND Flash应用章节。老款Air780E的SPI资源与固件支持情况建议先在官方文档对应型号页面确认，新项目推荐使用Air780EPM等主推型号验证。参考：https://docs.openluat.com/osapi/core/little_flash/ 及 https://docs.openluat.com/air780epm/luatos/hardware/spi/
33. 合宙是否有贴片SIM卡售卖？
解答： 有贴片SIM卡（eSIM/贴片卡形态）相关产品供应，采购可直接联系合宙商务，或在合宙官方淘宝店（https://luat.taobao.com/ ）咨询客服确认具体型号、封装和套餐形式。
34. 专网卡设置APN后一直报+CME ERROR: 302怎么办？
解答： +CME ERROR: 302表示无网络服务，专网卡场景多为APN参数配置不正确导致PDP激活失败。专网卡需向卡商获取APN名称、用户名、密码和鉴权方式，通过 AT+CPNETAPN=mode,"apnname","user","pwd",authmode 设置，注意APN名称、用户名、密码等字符串参数必须加英文双引号，无用户名/密码时对应参数保留为空双引号而不是留空，例如 AT+CPNETAPN=2,"CMMTMXYKJ.SN","","",0；设置后重启模组生效。公网SIM卡无需手动设置APN，模组自动查询。若仍报错：用其他厂家模组对比测试、确认专网卡已开通且定向IP/域名已加白名单、服务器侧抓包确认。参考专网卡配置：https://docs.openluat.com/atmozu/product/command/dncard/
35. 新卡注册状态一直为2（未激活）怎么办？
解答： 注册状态为2表示模组尚未在网络注册成功。排查步骤：1、确认SIM卡已在运营商/卡商后台激活，新卡或物联网卡可能存在开户延迟，未激活需联系运营商处理；2、公网卡无需手动设置APN（模组自动查询），专网卡必须按卡商提供的参数通过AT+CPNETAPN正确配置APN（字符串加双引号）；3、确认当地信号强度（AT+CSQ）、天线连接正常，换位置或换卡对比测试；4、确认机卡绑定/定向白名单已按设备IMEI配置；5、升级到最新固件。注册状态可通过AT+CEREG?/AT+CGREG?查询，LuatOS侧可通过 mobile.status() 和 SIM_IND 消息判断。参考：https://docs.openluat.com/osapi/core/mobile/
36. 4G模块时钟同步精度能到多少？有没有高精度时间同步的方法？
解答： 4G模组常规网络授时通过NTP/SNTP实现：调用 socket.sntp() 发起同步，成功后发布 NTP_UPDATE 事件；公网环境下NTP精度通常为几十毫秒，网络理想时可达数毫秒，第一次同步因未计算网络延迟可能有10~500ms偏差，建议至少同步两次（第二次携带时间戳做滑动平均延迟修正），毫秒级时间戳可用 socket.ntptm() 获取；此外基站授时会附带时区信息。对绝大多数物联网数据采集、定时任务场景该精度足够；若需要亚毫秒/微秒级高精度同步（如电力、工业同步采样），需采用专业授时方案（GNSS秒脉冲PPS、专用授时服务器等），不在普通NTP能力范围内。参考：https://docs.openluat.com/common/time_sync/ 及NTP教程：https://docs.openluat.com/air780epm/luatos/app/socket/ntp/
37. fskv中存储的数据能被读出来吗？如何加密？
解答： fskv是在模组片上Flash开辟的约64KB键值存储区（提供 fskv.init()/fskv.set()/fskv.get()/fskv.del() 接口，value最大4096字节），数据明文持久化存储，不应直接保存密码、密钥等敏感信息。fskv本身不提供加密接口，需要加密时在应用层完成：写入前先用crypto核心库（推荐AES对称加密）对数据加密，再 fskv.set() 存储；读取后 fskv.get() 取出密文再解密使用，密钥需妥善管理（避免硬编码明文）。参考fskv文档：https://docs.openluat.com/osapi/core/fskv/ 和crypto文档：https://docs.openluat.com/osapi/core/crypto/
38. AI使用中遇到回复错误或没有回复怎么办？
解答： 使用合宙AI助手（如ai.luatos.com）时，若提示"对话服务错误"或无响应，先重试几次并确认网络正常；问题持续时可到文档站 docs.openluat.com 查阅对应文档，或点击页面右下角在线咨询入口反馈。若发现AI回复的技术内容有误（如API名称、参数错误），请将问题原文和错误回复通过官方企业微信群或文档站反馈渠道提交给官方，以便修正知识库。官方支持渠道：文档站 https://docs.openluat.com/ 、代码仓库 https://gitee.com/openLuat/LuatOS/tree/master/module 。