跳转至

常见问题 - 2026-08-09

数据日期：2026-08-09

1. 我用air8000实现ip通话，用了文档里的测试账号测试的，Linphone打不通，是欠费原因还是其他原因？

解答： SIP（IP）通话走数据流量，与手机话费无关，一般不是欠费问题；可先把流量卡插手机确认能正常驻网、流量未用尽。打不通的常见原因及排查步骤：

  1. 测试账号问题：文档SIP测试服务器上的通用测试账号（如100000、100001）仅用于注册联调，账号之间无法互拨，MicroSIP/LinPhone与模组互拨需使用单独开通的测试账号；
  2. 核对LinPhone与模组的SIP参数完全一致：服务器地址180.152.6.34、端口8910、域名180.152.6.34、传输方式TCP/UDP，并确认双方均注册成功（模组日志出现 exsip init completed / 注册成功提示）；
  3. 确认模组侧网络就绪：4G或WiFi已获取IP（收到IP_READY事件）后再发起注册；
  4. 检查音频通路：参照SIP demo完成音频设备初始化，确认麦克风/喇叭硬件正常。

参考文档：https://docs.openluat.com/air8000/luatos/app/multimedia/sip/

2. 16号固件库不支持内置HZFONT么？原来用的14号库时正常的，因为我要用到TTS，但是14号不支持TTS。

解答： 结论：这是固件功能裁剪差异，属于正常现象，可通过固件选型解决。各号固件核心库组合不同：

  • 14号固件：内置中文矢量字库（hzfont，12~255号GB2312字库），但不含audio音频库，因此无法使用TTS；
  • 15/16号固件：支持audio音频库和TTS，但不带内置矢量汉字库，而是自带16号中文灰度点阵字库——该点阵字库无需调用hzfont.init()初始化即可直接显示；若需要其他字号，可用hzfont模块加载ttf字体文件，但文件系统空间有限，字体文件需按需裁剪制作；
  • 19号固件：在14号固件功能基础上新增audio_v2新音频框架（支持TTS编解码），脚本区1MB、文件系统168KB，同时兼顾矢量字库与TTS能力，是"字库+TTS"需求的推荐选择。

建议直接改用19号固件，或16号固件配合自带16号点阵字库使用。固件核心库支持清单见：https://docs.openluat.com/air780egh/luatos/firmware/780egg&780egh_version/

3. 19号支持audio_v2是啥意思？

解答： audio_v2是LuatOS新一代音频框架，与旧版audio库并存。它提供统一的音频播放、录音、编解码和驱动管理能力，支持PCM、WAV、AMR-NB/AMR-WB、MP3及TTS文字转语音等编解码，支持I2S、DAC、ADC、USB声卡等驱动类型，并新增了往通话对端播放流式音频等能力。

"19号固件支持audio_v2"指：19/119号固件是在14号固件功能基础上新增了audio_v2框架（脚本区改为1MB、文件系统168KB）。开发时无需直接调用audio_v2底层API，请使用exaudio扩展库——它封装了旧audio与audio_v2两套框架的差异，在exaudio.setup()中将audio_mode配置为"new"即启用新框架。

固件版本说明：https://docs.openluat.com/air780egh/luatos/firmware/780egg&780egh_version/ ；exaudio库文档：https://docs.openluat.com/osapi/ext/exaudio/

4. hello do you have Luatools for Linux?

解答： LuaTools GUI is only released for Windows. For Linux (and macOS), please use the command-line tool luatos-cli to download and flash firmware/scripts. You can get it by searching "openLuat/luatos-cli" on gitee.com, or from the official LuaTools resources. Documentation: https://docs.openluat.com/

5. 我的用户名是邮箱号不是手机号，是否影响PC的模拟连接？

解答： 不影响。PC模拟器连接合宙IoT云平台（iot.openluat.com）时，校验的是账号能否正常登录以及模拟器所用设备ID是否已归属到您账号下的项目白名单，与用户名是邮箱还是手机号无关。

需要注意： 1. 合宙IoT平台新注册账号建议使用手机号注册（账户名建议为手机号）；若您的账号是邮箱注册但能正常登录 https://iot.openluat.com/cloud/main ，即可正常使用； 2. 若模拟器提示"没有进项目及白名单"，请先在合宙官方淘宝店（luatos.taobao.com）购买开发板，再通过合宙CRM系统（crm.luatos.com）将设备归属到自己账号下，并将模拟器脚本中的设备ID填写为该开发板的设备ID即可； 3. 登录相关说明可参考：https://docs.openluat.com/common/TCPUDP_Test/

6. 有没有傻瓜式的教程，主要实现PC模拟到lot云端的详细操作说明比如AIR780系列的？

解答： 有的，推荐按以下顺序学习（含图文和视频）：

  1. LuatOS入门系列教程（框架认知、烧录、网络、HTTP、云平台等，含文字与视频）：https://docs.openluat.com/luatos_lesson/
  2. PC模拟器专项教程（模拟器获取、脚本运行、连接云端全流程）：https://docs.openluat.com/common/LuatOS-pc/
  3. Air780系列上云可参考FOTA/云平台配置章节：https://docs.openluat.com/air780epm/luatos/app/ota/fota/

基本操作路径：安装Luatools→下载LuaOS的PC模拟器→注册登录合宙IoT平台（iot.openluat.com）→在账号项目下确认设备ID白名单→运行模拟器脚本联网上云。教程默认读者具备少量物联网与Lua脚本基础，零基础也可按章节逐步操作。

7. 未进项目及白名单，有详细的设置说明吗？

解答： "未进项目及白名单"表示当前设备ID不在您IoT账号名下的项目中。处理步骤：

  1. 登录合宙IoT平台 https://iot.openluat.com/cloud/main ，确认账号下已有项目及项目key；
  2. 在合宙官方淘宝店 https://luat.taobao.com/ 购买开发板（模组），采购后设备默认归属采购手机号账号；
  3. 通过合宙CRM系统 https://crm.luatos.com/ 登录（账号与IoT平台相同），将设备归属/转移到自己账号名下的项目中，设备归属操作说明见：https://docs.openluat.com/air780epm/product/attributioniot/
  4. 将模拟器或模组脚本中使用的设备ID填写为该开发板的设备ID，重新连接即可。

如账号下确实查不到对应IMEI/设备ID，可联系合宙销售协助添加到项目下。

8. 目前开发板8000A配套的物联网卡可以放到其他780EPG模组上测试吗，会不会锁卡？

解答： 物联网卡是否锁卡取决于卡商是否开通了机卡绑定（IMEI绑定）策略：未首次通电激活前，卡未绑定设备，可装入任意模组使用；一旦在某台设备上通电激活驻网，部分卡商会将该卡与首个设备的IMEI绑定，之后再换到其他设备就可能被判定为机卡分离而锁卡停机。

建议： 1. 用于Air8000A与Air780EGP等多台设备交叉测试的卡，先向卡商（或随卡说明）确认是否有机卡绑定规则，尽量选择未开启机卡绑定的测试卡； 2. 已激活且确认有绑定策略的卡，不要随意换机；如已锁卡，联系卡商解除绑定或更换新卡； 3. 换卡后仍异常时，可把卡插入手机确认能否驻网，并结合模组日志（SIM初始化、注网状态）进一步排查。

9. 我重新焊了个模块上去，也没有串口出来，能不能帮忙看看可能的原因呢？

解答： 重新焊接后无串口输出，焊接质量是首要怀疑点，但也可能是供电、复位、开机时序等硬件问题。请按以下步骤逐项排查：

  1. 焊接质量：用放大镜/显微镜检查模组引脚及底部焊盘是否连锡、虚焊、偏位（底部焊盘连锡会导致无串口、无法烧录，需重焊）；
  2. 供电测量：万用表量VBAT电压是否在3.3V~4.35V（建议3.6~4.2V），上电瞬间电流能否拉起，排查电源带载能力不足；
  3. 开机时序：PWRKEY需拉低足够时间（典型1.5s左右）开机；若PWRKEY悬空或上电电路不对，模组不会启动；
  4. 复位脚状态：确认RESET引脚未被持续拉低，正常应为高电平；
  5. 串口接线：日志输出在调试串口UART0（Air780EPM/EHM/EHU/EHN为PIN38/PIN39，Air780EGP/EGG/EGH等管脚见对应文档），确认TX/RX未接反、GND共地；也可直接用USB口连接Luatools查看日志；
  6. 最小系统验证：若条件允许，将VBAT、GND、PWRKEY、UART0及USB引出到测试点，确保最小系统完整。

参考：Air780Exx下载接口与最小系统说明 https://docs.openluat.com/air780epm/product/air780exxpins/ ；UART管脚说明 https://docs.openluat.com/air780epm/luatos/hardware/uart/

10. Air8781P2这个有现货吗？现在要采购，淘宝上说只有20多片。

解答： 淘宝店铺显示的现货数量仅为线上零售库存，不代表整体备货。经核实该型号物料库存充足，可正常批量采购：请直接联系合宙商务下单，常规交货周期约一周。

联系方式：合宙官方淘宝店 https://luat.taobao.com/ 咨询客服或联系对接商务确认数量与交期；产品资料可在合宙文档中心 https://docs.openluat.com/ 查询。

11. 现在在画AIR780EPM的CAM接口，希望能有一份准确的FPC参考设计文件能够确保与合宙官方1040或1050的摄像头模组实物匹配。摄像头模组型号的话，GC032A匹配就行。

解答： GC032A对应的是合宙官方AirCAMERA_1040摄像头配件板（30万像素、SPI接口，驱动IC为KC6001-V2.0/GC032A）；AirCAMERA_1050为同规格但使用GC0310（驱动IC为KC6045-V1.2）。要保证FPC与官方摄像头实物匹配，请按以下资料设计：

  1. 硬件接口：Air780Exx系列SPI Camera接口为固定管脚PIN54/55/56/80/81，最高支持30万像素，已支持驱动IC包括GC0310/GC032A/BF30A2；
  2. 注意信号复用：Camera信号PIN80(CAM_BCLK)/PIN81(CAM_CS)/PIN55与SIM2的PIN63(RST)/PIN62(CLK)/PIN64(DATA)为物理同一信号的复用管脚，二者不可同时使用；
  3. 参考文档（含配件板硬件连接图、接线与实物照片）：
  4. AirCAMERA_1040（GC032A）：https://docs.openluat.com/air780epm/luatos/app/accessory/AirCAMERA_1040/
  5. AirCAMERA_1050（GC0310）：https://docs.openluat.com/air780epm/luatos/app/accessory/AirCAMERA_1050/
  6. Camera管脚与复用说明：https://docs.openluat.com/air780epm/product/air780exxpins/
  7. 拍照demo（excamera库）：https://docs.openluat.com/air780epm/luatos/app/multimedia/excamera/

设计建议：直接参照1040配件板的FPC座子线序与管脚定义绘制，排线座子、线序以官方配件板文档中的连接图为准，可保证与官方摄像头实物匹配。

12. 合宙只有air8000才能接入deepseek吗？

解答： 不是。DeepSeek等大模型均以云端HTTP推理服务形式提供（对外暴露HTTP接口，接收请求、返回结果），因此任何具备联网能力的LuatOS模组（Air780系列、Air8000系列等）都可以通过HTTP/HTTPS请求调用其API，不局限于Air8000。

实现要点： 1. 在模组上通过http库（或httpplus扩展库，支持任意header/body、鉴权URL识别）向DeepSeek的API地址发起POST请求，Header中携带Authorization鉴权（Bearer API-Key）与Content-Type: application/json，body按接口要求拼装model与messages字段； 2. 模组侧需确保已驻网并能访问外网（4G/WiFi/以太网均可）； 3. 参考资料：LuatOS HTTP教程 https://docs.openluat.com/luatos_lesson/004_luatos_http/ ；http/httpplus库用法可在LuatOS代码仓库 http demo 中查看（https://gitee.com/openLuat/LuatOS/tree/master/module ）。

注意：API-Key属于敏感信息，建议不要明文硬编码在发布脚本中，可通过服务端中转请求以避免密钥泄露。

搜索