跳转至

常见问题 - 2026-09-24

数据日期：2026-09-24

1. PCMA和PCMU编码对通话有影响吗？

解答： 结论：没有影响。PCMA 与 PCMU 是 G.711 的两套编码，音质和互通性基本一致，对通话没有实质影响。

说明：PCMA 是 G.711 A-law（payload type 8），PCMU 是 G.711 μ-law（payload type 0），两者都是 8 kHz 采样、64 kbps 的窄带语音编码，差别只在压扩律；exsip 扩展库只支持 PCMU 和 PCMA，通话时通过 SDP 协商用哪一种。因此选 PCMA 还是 PCMU 属于两端协商结果，不影响能否通话。

处理步骤：

  1. 确认两端 SDP 里都带有 PCMA/PCMU（8 kHz）编码。
  2. 一端只支持其中一种时，保持对端也支持该编码即可正常通话。
  3. 出现声音异常时优先排查网络丢包与音频通路，而不是先怀疑编码差异。

参考文档：exsip 扩展库 https://docs.openluat.com/osapi/ext/exsip/ 。

2. 通话时两边同时说话，一边声音会断/闪烁，是什么原因？

解答： 尚未解答

3. SIP主叫直接拨号提示空号，如何配置？

解答： 结论：在 config.lua 中配置 remote_sip_uri，target_phone_number 填自己手机号即可；若要直接呼叫 SIP 账号，直接拨对端用户名。

说明：SIP 主叫能否接通，取决于拨号时的 URI/号码能否被服务器解析到对应账号。合宙测试服务器的账号规则是：有 IMEI 的模组用 15 位 IMEI 末位加 0 或 1 表示两个账号。提示“空号”通常是拨出的号码格式与服务器上的注册账号对不上，而不是链路本身的问题。

处理步骤：

  1. 在 config.lua 中配置 remote_sip_uri，target_phone_number 填自己的手机号。
  2. 只在 SIP 内部互通时，直接拨对端用户名（sip_username）。
  3. 确认主叫与被叫账号不同，且都已在同一 SIP 服务器上注册成功（日志出现 register ok / 200 OK）。
  4. 可用 MicroSIP/Linphone 登录同一服务器做对照测试。

参考文档：SIP 通话演示 https://docs.openluat.com/air8000/luatos/app/multimedia/sip/ 。

4. 合宙SIP服务器支持录音吗？

解答： 结论：目前合宙 SIP 服务器不支持录音功能。

说明：合宙提供的 SIP 服务器（cc.luatos.com，端口 8910）承担的是注册管理、呼叫路由和认证；SIP 信令与媒体分离，语音由 RTP 在通话双方之间直传，服务器本身不落地录音。所以需要录音时，只能由业务侧自行实现，不能依赖合宙 SIP 服务器提供录音能力。

处理步骤：

  1. 需要录音时，在模组端用音频采集/录制能力自行保存，或由对端录制。
  2. 需要平台级录音落地的场景，改用支持录音的第三方 SIP/调度平台。
  3. 录音相关的合规要求，请按业务所在地自行评估。

参考文档：SIP 通话演示 https://docs.openluat.com/air8000/luatos/app/multimedia/sip/ 。

5. CC蜂窝手机端音频采样率711显示16000正常吗？

解答： 结论：正常。CC 蜂窝手机端音频采样率是 16 kHz，SIP 端 G.711 由模组转换为 8 kHz 传输，两端显示不一致属正常现象。

说明：G.711（PCMA/PCMU）的标准采样率是 8 kHz，而 CC 蜂窝手机端是 16 kHz，模组会在送入 SIP 通道前把音频转换为 8 kHz，所以手机端显示 711/16000 与 SIP 侧的 8000 并不矛盾。不同运营商的蜂窝语音采样率也可能不同，例如移动可能是 8 kHz，同样是正常差异。

处理步骤：

  1. 只要注册正常、通话能建立且有双向声音，采样率显示为 16 kHz 无需处理。
  2. 排查音质问题时，对比 SIP 侧 SDP 协商出的编码与采样率。
  3. 两端表现异常时，先统一到最新的 core 固件与 exsip 库再复测。

参考文档：exsip 扩展库 https://docs.openluat.com/osapi/ext/exsip/ 。

6. 通话和注册续期有竞态冲突吗？

解答： 结论：理论上没有冲突。若实际出现丢包导致异常，可以把出现丢包时间范围的 4gdiag 的 .bin 文件发出来，导出模组端网络包确认。

说明：SIP 注册有有效期，合宙测试服务器约 600 秒，客户端会在到期前（日志约 570 秒）发起续注册，底层还会按固定间隔发送 OPTIONS 保活；注册续期与 RTP 媒体流走的是不同消息、不同通道，exsip 内部按状态机串行处理，理论上不会互相打断，不构成竞态。

处理步骤：

  1. 用 Luatools 抓取通话全过程的底层日志，标出注册/续注册与丢包的时间点。
  2. 保留出现丢包时间范围的 4gdiag 的 .bin 文件，导出模组端网络包对照分析。
  3. 确认 core 固件与 exsip 库为同一最新正式版本后复测，仍复现再提交日志与最小脚本。

参考文档：SIP 通话演示 https://docs.openluat.com/air8000/luatos/app/multimedia/sip/ ，日志抓取 https://docs.openluat.com/common/howtouselog/ 。

7. 能加注册/呼叫重试机制吗？

解答： 结论：可以，改 Lua 脚本就能控制。

说明：exsip 通过 exsip.on() 回调上报 lifecycle（online/offline）、register、call 等事件，注册失败、呼叫失败都会以事件形式抛出；应用层可以据此在脚本里做重试与退避，不需要改动底层固件，也不需要服务器配合。

处理步骤：

  1. 在 exsip.on() 回调中监听 register/lifecycle/call 事件，判断失败原因。
  2. 失败时用 sys.timerStart/sys.timerLoopStart 定时重试，设置重试间隔与最大次数，避免高频重试。
  3. 掉网（lifecycle offline）时先等 IP_READY，再 exsip.stop()，延时 100~200ms 后 exsip.start() 重新启动服务。

参考文档：exsip 扩展库 https://docs.openluat.com/osapi/ext/exsip/ 。

8. Air780E/H 等模组的SIP功能CSDK支持吗？

解答： 结论：CSDK 不支持 SIP，只有 LuatOS 支持 SIP；SIP 服务器目前还没有收费标准。

说明：SIP 通话依赖 exsip 扩展库以及 LuatOS 的音频与 VoIP 能力，CSDK 开发流程里没有对应的 SIP 库和音频通话框架，因此 CSDK 方式无法使用 SIP 功能。合宙 SIP 服务器（cc.luatos.com）当前可免费用于测试，尚未公布收费标准。

处理步骤：

  1. 需要 SIP 功能时选用 LuatOS 二次开发，直接使用 exsip 库。
  2. 先在合宙 SIP 服务器上验证注册与呼入呼出，再切到自建 SIP 服务器。
  3. 服务器侧的开通、收费与用量，向合宙销售/FAE 确认。

参考文档：SIP 通话演示 https://docs.openluat.com/air8000/luatos/app/multimedia/sip/ ，exsip 扩展库 https://docs.openluat.com/osapi/ext/exsip/ 。

9. IoT平台固件上传后设备无法升级，提示key或权限问题怎么办？

解答： 结论：需要保证固件、升级项目、设备处在同一用户/同一项目下，脚本里的 key 也要与该项目一致。

说明：合宙 IoT 平台按“账号 + 项目”维度管理设备归属与固件，固件、设备和脚本中的 project_key（校验码）必须指向同一个项目，否则平台会因归属或权限不符而拒绝下发升级包，表现为设备无法升级、提示 key 或权限问题。

处理步骤：

  1. 在新账号下创建新项目，把设备从原账号移除后添加到新账号。
  2. 把固件也上传到新账号的同一项目下。
  3. 把代码里的 key 改成新项目的 key（校验码）。
  4. 设备归属的完整操作参考官方说明。

参考文档：合宙的设备如何归属到自己账号名下 https://docs.openluat.com/air780epm/product/attributioniot/ 。

10. 设备升级到1.0.1后无法升级到1.0.2，是什么原因？

解答： 结论：是旧版本固件未删除，设备优先检测到前面那个版本；删除旧版本或禁止旧版本升级即可。

说明：平台按版本号判断是否需要下发升级包，如果同一项目/设备下旧的升级配置还留着，设备重启请求升级时会先匹配到前面的版本，于是表现为升到 1.0.1 之后升不上 1.0.2。新版本号还必须满足平台的升级规则：版本号写成 A.B.C 三段，新版本号要大于旧版本号，中间的 B 段无意义。

处理步骤：

  1. 登录 https://iot.openluat.com/ ，进入对应项目的固件列表，删除或停用旧版本（1.0.1）的固件/升级配置。
  2. 确认新固件版本号 1.0.2 满足 A.B.C 升级规则。
  3. 确认升级任务已配置目标 IMEI 或勾选了升级全部设备。
  4. 设备重启后重新检测升级（FOTA 非推送）。

参考文档：FOTA 远程升级 https://docs.openluat.com/air8000/luatos/app/ota/fota/ 。

11. Air1603邮票孔的尺寸和间距是多少？

解答： 结论：Air1603 邮票孔焊盘宽 0.7mm、孔径 0.5mm、净距 0.5mm（中心距 1.2mm）；Air780EX2 邮票孔宽 0.65mm、间距 0.45mm。

说明：Air1603 是四周 LCC 邮票孔封装，平面尺寸 22.6×22.6mm，共 64 个孔（每边 16 个），便于焊接与检查；Air780EX2 与 Air780EX 一样是邮票孔封装，方便手工焊接。做 PCB 封装时应按机械图核对焊盘尺寸与观察方向，避免镜像。

处理步骤：

  1. Air1603 按焊盘宽 0.7mm、孔径 0.5mm、净距 0.5mm、中心距 1.2mm 建封装。
  2. 按 PIN01~PIN64 定位物理管脚，不要与 GPIO 编号混用。
  3. Air780EX2 按 0.65mm/0.45mm 建封装，投板前可提交合宙免费评审。

参考文档：Air1603 硬件资料 https://docs.openluat.com/air1603/luatos/hardware/ ，Air780EX2 产品页 https://docs.openluat.com/air780ex2/product/ 。

12. Air820UG设备卡在OTA循环升级、大量消耗流量怎么处理？

解答： 尚未解答

13. Air780EGP/780EGH低功耗模式下通过CAN唤醒会随机触发看门狗重启，原因是什么？

解答： 尚未解答

解答： 结论：8601 开发板上 Air780ER2 的 Airlink 串口与正式固件不一致，需使用单独固件；8602 与正式固件一致，改串口后可正常使用。

说明：Air780ER2 出厂已烧录固件、不需要二次开发，通过 AirLink over UART 与 Air1601 主控通信。Air8601 开发板上搭载的 Air780ER2 只能烧录 Air8601 专用固件，不能烧 Air780ER2 默认（正式）固件，否则会出现 Airlink 配网失败；Air8602 的 Airlink 串口与正式固件一致，按板卡文档改串口后即可正常通信。

处理步骤：

  1. 8601：烧录 Air8601 专用的 Air780ER2 固件，不要烧默认固件。
  2. 8602：使用与正式固件一致的固件，按文档调整 Airlink 串口配置。
  3. 核对主控（Air1601）侧 AirLink 串口号、波特率与从机一致。

参考文档：Air8601 产品页 https://docs.openluat.com/air8601/product/ ，Air780ER2 产品页 https://docs.openluat.com/air780er2/product/ 。

15. LuaTools下载固件时连接断开、失败，如何解决？

解答： 结论：多数是下载端口不对、未正确进入下载模式，或 USB 线/供电不稳导致，按顺序排查即可。

说明：固件下载依赖 BOOT 模式与稳定的 USB 数据链路，端口选错、数据线只有充电线芯、线太长、供电不足都会表现为连接断开或下载失败。进入 BOOT 模式的标志是设备管理器中只出现 1 个下载口。

处理步骤：

  1. 检查下载端口是否正确，进入 BOOT 后设备管理器应只出现 1 个下载口。
  2. 换一根短一点的 USB 数据线（需含 D+/D-，长度小于 1 米）。
  3. 彻底断电后先拨到下载档再插 USB；必要时按住 BOOT 再上电，强制进入 Boot 烧录。
  4. 仍失败时保留 Luatools 完整日志，到官方企业微信群反馈。

参考文档：烧录教程 https://docs.openluat.com/common/howtodown/ 。

16. Air780EGG是否支持通过UART1升级固件？

解答： 结论：不支持，固件升级需要用 USB。

说明：Air780EGG 属于 Air780EGH 系列（在 Air780EGH 基础上内置了 DA221 G-Sensor），固件下载走 USB/BOOT 通道——把 BOOT 拉到 1.8V（或与 VDD_EXT 短接）后上电即可进入下载模式；UART1 只用于业务通信，不能用来烧录底层固件。

处理步骤：

  1. 使用 USB 连接电脑，按 BOOT 方式进入下载模式，再用 Luatools 烧录。
  2. UART1 仅保留业务数据/AT/AirLink 通信用途。
  3. 新设计如需现场升级，预留 USB 下载口或 BOOT 测试点。

参考文档：Air780EGG/EGH 下载说明 https://docs.openluat.com/air780egh/luatos/common/download/ 。

17. Air8000W是否有USB虚拟网卡默认开启的固件？

解答： 结论：没有，可以自行关闭 USB；USB 虚拟网卡（RNDIS）由脚本按需开启。

说明：Air8000W 与其他 Air8000 系列型号共用同一套 LuatOS 固件，USB 以太网（RNDIS/ECM）并非出厂默认开启，需要脚本调用 mobile.config(mobile.CONF_USB_ETHERNET, …) 开启；同样也可以按业务关闭 USB。

处理步骤：

  1. 需要 USB 虚拟网卡时，参考 RNDIS 文档在脚本中开启。
  2. 不需要时保持关闭，或自行关闭 USB。
  3. 注意 Air8000 使用 CDC 驱动，USB 虚拟网卡需 Windows 10 及以上系统。

参考文档：RNDIS 使用说明 https://docs.openluat.com/air8000/luatos/app/common/rndis/ 。

18. Air820UG模块单片机不停复位会导致被基站封锁不能上网吗？

解答： 尚未解答

19. Air724UG下载程序通讯超时后无法刷机，只有ASR Modem Device端口，怎么办？

解答： 尚未解答

20. Air780EPM不能上网、信号强度隔一会儿变0，是什么原因？

解答： 尚未解答

21. Air724UG/Air780E支持FOTA差分包升级吗？只升级脚本需要勾选含core吗？

解答： 结论：支持。LuatOS 的 FOTA 中 core 走差分升级、脚本走全量覆盖升级；用 Luatools 做升级文件时，即使本次只升级脚本，也建议勾选“含 core”，因为 core 里带有 FOTA 标志位。

说明：远程升级可以只升脚本、只升 core，或 core+脚本一起升。core 为差分升级，要求新旧固件后缀一致（不同后缀固件不能互相升级）；脚本为全量覆盖，版本号写成 A.B.C 三段，新版本号需大于旧版本号，中间 B 段无意义。制作含 core 的差分包需 Luatools 3.0.9 及以上版本。

处理步骤：

  1. 在 Luatools 项目管理中，“升级文件包含 core”建议勾选，“升级文件包含脚本”直接勾选。
  2. 只升脚本得到纯脚本升级文件；含 core 升级则先各生成一次量产文件，再用差分工具做差分包。
  3. 上传到合宙 IoT 平台后配置目标 IMEI 或勾选升级全部设备。

参考文档：FOTA 远程升级 https://docs.openluat.com/common/fotaindexhh/ ，libfota2 https://docs.openluat.com/osapi/ext/libfota2/ 。

22. Air780EHN/EHU支持哪些海外认证？

解答： 结论：现有 CE、FCC、RoHS，可满足欧盟、美国基础准入，但不是全部海外认证；部分国家还需做当地强制认证或运营商认证。

说明：Air780EHN 为北美版、Air780EHU 为欧亚版，认证证书可在产品资料页下载（如 CE 证书、FCC 证书）。需要说明的是，合宙做的是模组级认证，客户终端使用合宙模组仍需再做终端认证；部分国家另有本地强制认证或运营商入网要求。

处理步骤：

  1. 在产品资料页“认证证书”栏目下载 CE/FCC 等证书。
  2. 按目标国家核对是否还需当地强制认证或运营商认证。
  3. 上市前在目标国家实地场测。

参考文档：Air780EHN/EHU 产品资料 https://docs.openluat.com/air780ehnehu/product/shouce/ ，认证指导 https://docs.openluat.com/air780ehv/product/renzheng/ 。

23. Air700ECP/ECT能否替代Air780E用于国内联网？

解答： 结论：Air700ECP/ECT（与 Air700ECH 同系列）只支持中国移动，用移动卡没问题。

说明：Air700ECP、Air700ECH、Air700ECT 三款模组产品定义追求极致小，仅支持中国移动物联网卡，不支持中国电信和中国联通，也不支持海外区域；Air780E 系列则是国内全网通（移动/电信/联通）。因此能否替代 Air780E，取决于你的卡与覆盖区域是否需要电信、联通。

处理步骤：

  1. 确认目标区域与项目只用移动网络。
  2. 用移动卡实测注网与业务，确认满足需求。
  3. 需要电信/联通或多运营商时，继续使用 Air780E 系列。

参考文档：Air700ECP/Air700ECH 说明 https://docs.openluat.com/air700ech/luatos/hardware/overview/ 。

24. Air780EEU如何写IMEI号？

解答： 结论：使用指令 AT+ECCGSN="IMEI","8640400651795XX" 写入 IMEI。

说明：该指令第一个参数为 IMEI，第二个参数为 15 位 IMEI 号；把示例号段替换为实际 IMEI 后发送即可，一般用于生产或维修环节。IMEI 是设备唯一标识，须使用合规申请的号段，不得随意编造或重复使用。

处理步骤：

  1. 打开串口工具，发送 AT+ECCGSN="IMEI","8640400651795XX"（号码换成实际 IMEI）。
  2. 确认模组返回正常应答。
  3. 重新读取 IMEI 核对写入结果。
  4. IMEI 号段需合规申请，禁止编造或重复。

参考文档：Air780EEU 产品页 https://docs.openluat.com/air780eeu/product/ 。

25. 780EPM/780EHM/780EHU/HV等模组USB没有引出，只接了UART1，可以用AT固件通过UART1升级吗？

解答： 结论：不支持通过 UART1 升级固件，固件升级需要用 USB；这种 AT 固件也不支持远程升级。

说明：这类模组的固件下载通道是 USB/BOOT，UART1 只做业务通信，不能用于烧录底层固件；相应地，USB 未引出、只接 UART1 的硬件形态下，远程升级（FOTA）同样不可用。若产品设计上确需升级能力，应在硬件阶段预留 USB 或 BOOT 接口。

处理步骤：

  1. 固件升级使用 USB 连接，按 BOOT 方式进入下载模式。
  2. UART1 仅保留业务通信用途。
  3. 新设计如需现场升级，预留 USB 下载口或 BOOT/测试点。

参考文档：Air780EPM 下载说明 https://docs.openluat.com/air780epm/luatos/common/download/ 。

26. 合宙模组支持TTS语音播报、DTMF检测、短信收发吗？

解答： 尚未解答

27. 监测设备震动应该用什么传感器？（配780）

解答： 结论：可用 DA221，Air780EGG 内置，合宙提供专门的扩展库 exvib 可以直接使用。

说明：DA221 是合宙模组内置的 G-Sensor（加速度传感器），目前 Air8000A/D/U/N/DB/AB 及 Air780EGG、Air780EGP 内置；若其他型号外接 DA221，建议与 Air780EGG 保持一致选用 I2C1 与 WAKEUP2。exvib 库提供微小震动检测（2g）、运动检测（4g）、跌倒检测（8g）三种模式，LuatOS 侧只支持运动检测这一类功能。

处理步骤：

  1. 板上已内置 DA221 的型号，直接使用 exvib 库。
  2. 外接 DA221 时按 I2C1 + WAKEUP2 接线，便于复用 exvib。
  3. 按业务选择震动/运动/跌倒模式，并实测调整阈值。

参考文档：exvib 扩展库 https://docs.openluat.com/osapi/ext/exvib/ 。

28. GPS定位出现飞点/漂移是什么原因？

解答： 结论：可能是静态漂移；建议记录 NMEA 日志定位，若对海拔准确性要求高可加气压计。

说明：GNSS 静止时会东飘西飘，地图上表现为无数个漂移点，属于无法完全根除的现象，原因是卫星信号传播误差（电离层、天气、遮挡）、多径反射，以及网络传输不稳定导致定位数据“飞跃”。官方给的抑制思路主要有两种：一是速度与位移一致性检查，用 exgnss.vtg() 的速度值判断位移是否合理，不合理则丢弃并沿用上次定位；二是基于 G-Sensor 的运动状态一致性检查，静止时维持上次可信定位。

处理步骤：

  1. 记录 NMEA 日志，先区分是静态漂移还是真跳变。
  2. 服务器端做速度/位移一致性过滤，丢弃不合理跳点。
  3. 启用内置 G-Sensor 运动检测，静止时沿用上次可信定位。
  4. 海拔精度要求高时加气压计（如 SPL06）。

参考文档：GNSS 应用说明 https://docs.openluat.com/air8000/luatos/app/gnss/gnss/ ，气压传感器 exs_spl06 https://docs.openluat.com/osapi/ext/sensor/exs_spl06/ 。

29. 焊接后模块信号弱、无法联网，是否虚焊问题？

解答： 结论：无法直接判定为虚焊，建议对调模块测试信号质量，或寄回工厂检查；GPS 芯片虚焊可开盖修复。

说明：焊接后信号弱、无法联网，可能是焊点虚焊，也可能是天线、供电或装配问题。判断方法是做对调测试：换一块同型号好模块到同一块板子上，若信号恢复正常，则原模块或焊点可疑；若换模块仍然弱，则问题更可能在板级、天线或供电。

处理步骤：

  1. 对调模块测试信号质量，对比 CSQ/RSRP 与注网情况。
  2. 检查焊盘锡量、有无连锡或偏移，按合宙 SMT 炉温曲线与 0.2mm 钢网重新回流。
  3. 仍怀疑模块本身时寄回工厂检查；GPS 芯片虚焊可开盖修复。
  4. 投板前把原理图/PCB 提交合宙免费评审。

参考文档：SMT 炉温曲线 https://docs.openluat.com/common/smt/ ，原理图 PCB 评审 https://docs.openluat.com/value/drawcheck/ 。

30. 合宙云平台“添加远程升级文件”选项不见了，怎么操作？

解答： 结论：在合宙云平台点上面的固件升级，选择 libfota/libfota2，就会出现固件列表。

说明：合宙 IoT 平台按所用 FOTA 库区分升级入口，切换到对应的库（libfota/libfota2）后即可看到固件列表和“创建固件”。创建固件时勾选“升级全部设备”，则项目下所有设备都会升级；不勾选则选择“指定设备”并填入 IMEI；两者都不选时该项目下设备都不会升级。

处理步骤：

  1. 登录 https://iot.openluat.com/ ，进入对应项目。
  2. 点击“固件升级”，选择 libfota/libfota2，进入固件列表。
  3. 创建固件并上传升级包，选择升级全部设备或指定 IMEI。

参考文档：FOTA 远程升级 https://docs.openluat.com/common/fotaindexhh/ 。

31. 8204录音工牌/录音板功耗和录音功能如何实现？

解答： 结论：录音时功耗需按具体场景实测，低功耗应在不工作时休眠；定制板子可联系合宙报定制费用。

说明：Air8204 是可直接量产的录音定位工牌 PCBA，通信定位基于 Air780EGH、录音基于顺芯 ES7243、运动检测基于 DA221，并支持锂电池充电管理。它没有单一固定功耗值，功耗会随是否在录音、是否联网、是否开 GNSS 与工作占空比变化，评估续航应按业务占空比实测平均电流。

处理步骤：

  1. 明确录音时长、上传频次、待机时长等占空比。
  2. 不工作时进入休眠以降低平均功耗，按实际流程测平均电流。
  3. 需要定制板卡时联系合宙评估并报价。

参考文档：Air8204 产品手册 https://docs.openluat.com/air8204/product/ 。

搜索