跳转至

常见问题 - 2026-10-07

数据日期：2026-10-07

1. 780EPM的CSDK是否支持TTS？

解答： 结论：支持。780EPM 的 CSDK 里有 TTS 开关，打开即可使用 TTS 播报。 说明：TTS 属于基带/固件侧的语音播报能力，通过 CSDK 的配置开关启用，走的是播报通路，不需要外挂音频 Codec。要把它与「音频播放／录音」这条通路区分开：后者需要 Mic/Speaker 与音频 Codec，按官方音频文档的分类，Air780EPM 属于 Flash/RAM 4MB 配置较低、不支持 Audio 音频功能的一档，而 Air780EHV 内置 ES8311、Air780EHM/Air780EGH/Air780EGG/Air700ECH/Air8000 系列支持外挂 ES8311（走 I2S），这些型号才具备完整音频通路。因此如果需求只是本地语音播报，780EPM 够用；如果要播放音频文件或做双向通话，请改选带音频通路的型号。

处理步骤：

  1. 在 CSDK 工程中打开 TTS 相关开关（宏/配置项），重新编译烧录。
  2. 参考 Air780EHM 等带音频型号的播报 demo 对照配置，确认播报通路已生效。
  3. 用串口日志确认 TTS 的发起与播报完成事件都有打印。
  4. 文档站未收录该 CSDK 开关的具体宏名，以最新 CSDK 代码与 sdk 说明为准；拿不准时找 FAE 确认。

参考文档：Air780EPM 音频说明（是否支持 Audio 功能的型号分类） https://docs.openluat.com/air780epm/luatos/hardware/audio/ 。

2. 从Air780EP切换到Air780EPM模组，应用接口是否一样、工程是否需要额外修改？

解答： 结论：接口一样，原 project 可以直接在 780EPM 里编译；780EP 与 780EPM 的 CSDK 库是共用的，升级到最新 CSDK 即可用于 780EPM。 说明：Air780EP 与 Air780EPM 同属 EC7xx 平台，CSDK 共用同一套库，所以应用层接口不需要改，迁移的主要工作是升级 CSDK 并在新平台上跑通编译。差异在硬件资源配置：Air780EPM 与 Air780EHM 硬件完全一致，属于 Flash/RAM 4MB 档，因此要逐一核对你用到的外设、GPIO 与管脚复用（Camera、I2C、UART 等复用关系）在目标型号上是否可用、是否与其它功能冲突。CSDK 升级后也建议做一轮基础功能回测，避免隐性差异。

处理步骤：

  1. 拉取最新 CSDK，切到 780EPM 对应的工程/板级配置。
  2. 用原 project 直接编译，处理因版本升级带来的编译告警或 API 变更。
  3. 对照官方 GPIO 复用表与 Luatools 管脚配置，核对你用到的每个管脚与复用功能。
  4. 编译通过后做一轮基础功能回测（串口、网络、低功耗、外设）再上量。

参考文档：Air780EPM/Air780EHM 产品手册 https://docs.openluat.com/air780epm/product/shouce/ ；Air780EPM 开机电路设计说明（含管脚说明） https://docs.openluat.com/air780epm/luatos/hardware/design/poweron/ 。

3. 780EPM的SDK是否有遗留bug？量产是否稳定？

解答： 结论：按技术支持口径，目前没有遗留 bug，780EPM 已量产近两年、批量表现稳定；量产前可提供专项技术支持，量产后有问题可以提 issue。 说明：这是技术支持给出的口径，不是文档里的量化承诺。「稳定」的前提是固件与 CSDK 版本匹配、电源与外围设计按硬件设计手册落地，并且在量产前把问题收敛完。建议的做法是：量产前冻结版本（固件 + CSDK + 脚本）并做小批量长稳/老化验证；量产后建立问题反馈通道，遇到异常时用最小复现脚本配合版本号与完整日志提 issue，便于原厂定位。

处理步骤：

  1. 量产前冻结固件、CSDK 与脚本版本，对冻结版本做小批量长稳测试。
  2. 需要支持时，通过对接销售或 FAE 申请量产前专项技术支持，明确支持范围。
  3. 量产后发现问题，整理「最小复现脚本 + 固件版本 + 日志 + 现象视频」提 issue。
  4. 关注固件更新说明，按需升级，不要在生产中随意换版本。

参考文档：LuatOS 仓库（issue 入口） https://gitee.com/openLuat/LuatOS/issues ；Air780EPM 固件版本 https://docs.openluat.com/air780epm/luatos/firmware/780epm_version/ 。

4. 780EPM是否支持通话（音频除TTS外的需求）？

解答： 结论：780EPM 不支持通话，只支持 TTS 播音；既需要 TTS 又需要通话（VoLTE）时可选 Air780EHM 或 Air780EHV。 说明：通话（VoLTE）需要完整的音频通路（麦克风、喇叭与音频 Codec），不是单靠脚本能开出来的功能。按官方音频文档的分类：Air780EHV 内置 ES8311；Air780EHM、Air780EGH、Air780EGG、Air700ECH 及 Air8000 全系列未内置 ES8311，但可外挂 ES8311 走 I2S 驱动；而 Air780EPM 这类 Flash/RAM 4MB 的配置较低型号无法支持 Audio 音频功能。官方 VoLTE 通话 demo 用的正是 Air780EHM/Air780EGH 核心板 + AirAUDIO_1010 音频配件板，可作参考。

处理步骤：

  1. 先明确需求是「TTS 单向播报」还是「双向通话」，这决定要不要换型号。
  2. 要通话就改用 Air780EHM 或 Air780EHV，并准备对应音频配件板（如 AirAUDIO_1010）。
  3. 参考 VoLTE 通话 demo 配置 ES8311 的电源时序与 I2S 通道，注意 PA 使能脚时序。
  4. 若选 Air780EHV，注意其 I2S（PIN26/30/31/32/33）、I2C0（PIN57/58）与 GPIO20/GPIO22 已被内部 Codec 占用，规划管脚时避开。

参考文档：Air780EPM 音频说明（支持 Audio 功能的型号分类与管脚占用） https://docs.openluat.com/air780epm/luatos/hardware/audio/ ；VoLTE 通话 demo https://docs.openluat.com/air780epm/luatos/app/volte/call/ 。

5. 合宙模组保持连接的低功耗可以做到多少？

解答： 结论：实时保持连接（在线长连接）状态下平均约 1~2mA；uA 级功耗只在个别信号良好的基站条件下进入 PSM+ 非联网（飞行模式）才能达到，并不是实时连接的实际值。 说明：按 Air780EXX 系列低功耗文档，模组有三种功耗模式：常规模式约 7~8mA（在线长连接、代码正常运行）、低功耗模式约 1.5~2mA（在线长连接、CPU 降频、RAM 保持供电、唤醒后保持原状态运行）、PSM+ 模式约 3~12uA（离线/飞行模式、RAM 掉电、代码停止运行、唤醒后从头开始跑）。三者的测试条件均为供电 3.8V、心跳间隔 5 分钟、TCP 协议、连接合宙服务器。所以「保持连接」对应的是低功耗模式的 1.5~2mA；PSM+ 最省电但不能联网，服务器主动下发的数据接收不到，只能靠 dtimer、WAKEUP 或低功耗串口唤醒后自己上报。

处理步骤：

  1. 先区分需求：要随时能被服务器唤醒，用低功耗模式；只要定时上报，用 PSM+。
  2. 按官方测试条件（3.8V、心跳 5 分钟、TCP）用高精度电流表复测，量程要能分辨 1uA 级。
  3. 排查板级外围的常漏电路径：LED、看门狗、上下拉电阻、电平转换、DC-DC 静态电流。
  4. 注意实网功耗与基站信号强相关，PSM+ 的 uA 级数值只在信号良好的基站出现，不能按最差值做电池预算。

参考文档：Air780EPM/EHM 系列低功耗文档（三种功耗模式与典型电流） https://docs.openluat.com/air780epm/luatos/app/lowpower/sleep/ 。

6. ESIM是否支持？

解答： 结论：支持——这里的「ESIM」指贴片 SIM 卡（芯片卡），功能与原理和插拔卡完全一致，合宙模组都支持；充电功能硬件上也支持，但当前版本存在已知小瑕疵，官方口径是下个版本改进。需要区分的是：贴片卡不等于虚拟卡，合宙模组不支持虚拟卡（vSIM/softSIM）。 说明：官方 SIM 接口文档写得很明确：贴片 SIM 卡有时也被叫做 ESIM 或芯片卡，其功能和原理与可插拔卡没有任何区别，只是一个长得像手机卡、一个长得像芯片，一个需要卡座、一个需要焊接，各有优缺点，但技术上合宙模组都支持。同时文档特别指出，贴片 SIM 卡与虚拟机（也叫 vSIM 或 softSIM）是两回事，合宙模组不支持虚拟卡——这一点在回答前必须区分清楚，否则容易答反。充电部分属于硬件设计与板级实现，具体以原理图与规格书为准；「下个版本改进」是当时的口径，文档不对版本与时间作承诺。

处理步骤：

  1. 先确认问的是贴片 SIM（芯片卡）还是虚拟卡（vSIM/softSIM）：前者支持，后者不支持。
  2. 贴片 SIM 按常规 SIM 接口设计即可，封装规格与供应商确认，注意焊接与防松动。
  3. 充电电路按原理图实现，注意当前版本的已知瑕疵，并在自研板上实测验证。
  4. 需要明确改进版本与时间时，通过对接 FAE 或销售确认，不要以本文作为交期依据。

参考文档：Air780EPM 双卡单待 SIM 接口说明（含贴片卡/ESIM 与虚拟卡说明） https://docs.openluat.com/air780epm/luatos/hardware/sim/ 。

7. FSKV的64KB用完了，但Flash总共200多KB还有剩余，剩下的Flash怎么读写？

解答： 结论：fskv 只固定占用片上 Flash 中单独开辟的一块 64KB 小文件系统区域，容量不能扩容，剩下的 Flash 空间无法通过 fskv 使用。原答口径是建议通过 ai.luatos.com 咨询——这个方向是对的，因为「剩余 Flash 怎么用」属于底层分区与文件系统层面，确实需要官方确认。 说明：fskv 文档写明：它在模组片上 Flash 单独开辟了一个总可用空间为 64K 的区域，跑了一个小文件系统，单独操作，只支持操作芯片自身的 Flash 文件系统，不支持操作通过 lf 核心库或 sfud 核心库挂载的文件系统；同时 value 最大 4096 字节、key 最大 63 字节。所以 64KB 用满就是 fskv 的边界，改用其它 Flash 空间不属于 fskv 的能力范围。若确实要在别的区域读写，需要走底层接口（io 核心库的 Flash 读写，或 little_flash/sfud 等），但片内 Flash 的剩余区域通常已被固件与脚本文件系统占用，随意擦写有覆盖固件/脚本导致不开机的风险。

处理步骤：

  1. 先确认 64KB 是否真的用满：检查是否有可清理或可归档的旧 key，以及是否有 value 超过 4096 字节。
  2. 能压缩就压缩、能拆分就拆分，把 fskv 留给配置类小数据（服务器地址、波特率、标定值等）。
  3. 确实需要额外空间时，通过 ai.luatos.com 或对接 FAE 确认该型号固件的 Flash 分区表与可安全读写的区间。
  4. 在未确认分区之前，绝对不要用底层 Flash 接口做大范围擦写，避免把设备刷成砖。

参考文档：fskv 核心库（64K 区域与数据长度限制） https://docs.openluat.com/osapi/core/fskv/ ；io 核心库 https://docs.openluat.com/osapi/core/io/ ；little_flash https://docs.openluat.com/osapi/core/little_flash/ 。

8. SIP可以实现群组通话吗（1对多的情况）？

解答： 结论：可以定制，当前官方应该还没做（未作为现成功能提供）。 说明：SIP 本身是信令协议，只负责会话的建立、修改与结束，不传输语音数据；标准的多方场景需要配合支持会议（conference）的 SIP 服务器或媒体服务器做混音。合宙的 exsip 扩展库面向的是点对点网络通话，是否支持一对多取决于服务端能力与固件定制，属于定制开发范畴，不在通用 demo 的覆盖范围内。需求定义上有本质区别：一对多单向播报对服务端压力小，多方互听的会议混音则需要 MCU 混音与更高带宽，两者的方案与成本差别很大，先定清楚再谈定制。

处理步骤：

  1. 先定义业务模型：一对多单向播报、多方会议，还是一主多从对讲。
  2. 确认 SIP 服务端能力：是否支持 conference 房间、是否有 MCU 混音、并发路数上限。
  3. 联系合宙评估定制范围与交付形式（固件 + demo），确认可提供的功能边界。
  4. 先做小规模（2~3 方）验证，再评估并发路数与带宽需求。

参考文档：exsip 网络通话扩展库 https://docs.openluat.com/osapi/ext/exsip/ ；Air8784 方案说明 https://docs.openluat.com/air8784/product/ 。

9. Air780EVT模块上电后状态灯不亮，测试点REF和VDD_EXT都没有3.3V电压，是模块本身的问题吗？

解答： 结论：按技术支持口径，模块本身几乎可以排除（100% 没有问题），绝大多数是贴片/焊接原因；建议让代工厂熟练的焊接工程师重新焊接后再继续分析。 说明：Air780EVT 与 Air780EHV 同类，都是内置 ES8311 的音频型号（EVT 为 AT 指令版本）。上电后状态灯不亮、VDD_EXT（IO 参考电压输出管脚）测不到 3.3V，说明模组很可能根本没启动起来。除焊接因素（虚焊、偏位、连锡、钢网与回流曲线不合适）外，还要排除开机条件不满足：PWRKEY 需被拉低触发开机、模组上电时 VBAT 起始电压须小于 0.5V、RESET_N 必须处于释放态、USB_BOOT 不能误被拉高（否则会误入下载模式而看似不开机）。定位时要把「有没有开机」和「有没有输出」分开验证。

处理步骤：

  1. 换一块官方核心板或已知良品做对照，先判断是板级/焊接问题还是设计问题。
  2. 检查焊接质量：显微镜或 X-Ray 看焊点，核对钢网与回流曲线，重焊一遍再上电量测。
  3. 量测开机条件：VBAT 是否在 3.3~4.3V、PWRKEY 是否被拉低、RESET_N 是否释放、USB_BOOT 是否悬空或拉低。
  4. 以上都排除后仍异常，保留原理图、焊接照片与量测数据，交给 FAE 与代工厂一起定位。

参考文档：Air780EPM 开机电路设计说明（开机必要条件与 VDD_EXT 说明） https://docs.openluat.com/air780epm/luatos/hardware/design/poweron/ ；PWRKEY 开机键 https://docs.openluat.com/air780epm/luatos/hardware/pwrkey/ 。

10. Air780EHV模块使用for延时指示灯不闪烁（约18秒后长亮，约54秒似重启），使用sys.wait延时正常，是什么原因？

解答： 结论：原因是 Lua 里用 for 空循环做延时属于「忙等」，不会让出 CPU，会长时间独占唯一在跑的协程；指示灯闪烁、看门狗喂狗等任务得不到调度，于是看起来不闪烁，随后看门狗超时触发复位。改用 sys.wait() 这类会挂起的等待即可。另外，原文里提到的咨询入口应为 docs.openluat.com（原写的 docs.luatos.com 现已不可用）。 说明：LuatOS 是用协程实现多任务的：同一时刻只可能有一个协程在运行，而且协程不能抢占——只有当它主动挂起（sys.wait、sys.waitUntil、sys.waitMsg 等）之后，调度器 sys.run() 才会去恢复其它任务。for i=1,N do end 这种空循环全程占着 CPU、不挂起，同工程里负责翻灯的任务和定时器就被饿死，所以灯不闪；同时看门狗在忙等期间得不到喂狗，超时（数十秒量级）就复位，这与观察到的「约 18 秒后长亮、约 54 秒似重启」的时序特征吻合。sys.wait(ms) 会挂起当前协程让出 CPU，因此表现正常。注意约 54 秒并非固定值，取决于看门狗超时配置与各任务时序，不要把它当成常数去比对。

处理步骤：

  1. 把脚本里所有用 for 空循环做的延时，统一替换为 sys.wait(ms)，并用定时器或消息驱动灯的状态切换。
  2. 检查是否还有其它阻塞点：长 while 循环、同步等待网络返回、长时间不 yield 的密集计算。
  3. 用串口日志确认各任务确实在按预期运行、看门狗按时被喂。
  4. 需要官方协助时用 docs.openluat.com 或 ai.luatos.com（点击页面右下角 AI 问答入口，图片和文字都可发送）；AI 无法解决时把 AI 回复截图反馈给技术支持。

参考文档：LuatOS 编程框架（协程与 sys.run 调度机制） https://docs.openluat.com/osapi/luatos_framework/ ；sys 核心库（sys.wait） https://docs.openluat.com/osapi/core/sys/ 。

11. 780EPM的模组价格是多少？

解答： 结论：按当时口径，Air780EPM 含税 15.8 元；累计出货 30K（与合宙交易的所有产品出货之和）以后，含税 15 元。 说明：模组定价属于商务事项，不在技术文档管辖范围内。本文仅转述当时的口径，不构成价格承诺，实际成交价与账期以购买渠道和对接销售的正式报价为准。做成本评估时建议把批量、账期与备货排期一起考虑，提前与销售对齐采购计划，避免影响产线节奏。

处理步骤：

  1. 先打开合宙官方淘宝店，看当前挂牌价与在售状态。
  2. 有批量采购计划时，通过官方企业微信群或对接销售索取书面报价。
  3. 以销售提供的正式报价单为准做成本核算与下单。

参考文档：无（属商务/定价事项，请通过购买渠道或对接销售确认）。

12. 需要4G通讯、低功耗、电池待机一年（外部两个按键、一个I2C、电机驱动2个IO、RS232接口），推荐哪款型号？

解答： 结论：推荐 Air780EPM；如需差异化，可考虑 Air780EHV（支持 TTS 和上屏，方便远程运维）。 说明：需求本质是「4G 通信 + 低功耗 + 若干 GPIO、1 路 I2C、1 路串口 + 2 路 IO 驱动电机」。Air780EPM 的 GPIO、I2C、UART 资源足以覆盖，配合低功耗模式（保持连接约 1.5~2mA）或 PSM+（约 3~12uA，非联网）可以按上报周期做到长待机。要注意「电池待机一年」的关键不在选型本身，而在平均电流与电池容量的匹配，以及板级外围有没有常漏电路径（LED、LDO 静态电流、上下拉）。RS232 需要用 UART 加收发器实现，注意电平与方向控制。如果后续还要本地语音播报或屏显，Air780EHV 内置 ES8311、支持 TTS 与上屏，运维更直观。

处理步骤：

  1. 先做电流预算：按上报周期估算平均电流，再决定用低功耗模式还是 PSM+，并选配电池容量。
  2. 用官方 GPIO 复用表核对两个按键、1 路 I2C、2 路电机 IO、1 路 UART 是否够用且互不冲突。
  3. RS232 侧加收发器（如 SP3232 一类），注意供电与方向控制，必要时加 TVS 防浪涌。
  4. 打样后实测休眠/待机电流，关掉 LED、看门狗等常漏电支路后复测，确认满足待机一年。

参考文档：Air780EPM/EHM 系列低功耗文档 https://docs.openluat.com/air780epm/luatos/app/lowpower/sleep/ ；Air780EPM 音频说明（Air780EHV 内置 ES8311 说明） https://docs.openluat.com/air780epm/luatos/hardware/audio/ 。

13. UI功能可以支持多少张图片？

解答： 尚未解答

14. PWRKEY通过1k电阻下拉到地，对开机有影响吗？

解答： 结论：没有影响。1kΩ 串联下拉到地完全在允许范围内，模组上电即开机；文档明确串联电阻接地时最大阻值不应超过 10K，否则有可能无法正常开机。 说明：PWRKEY 是开机触发脚、内部上拉到 VBAT。文档写明：PWRKEY 接地（可以直接接地，也可以串联电阻接地）时芯片上电即开机；串联电阻的作用是减小因内部上拉引起的漏电流，串联电阻接地时最大阻值不应超过 10K，否则有可能无法正常开机——1kΩ 远小于该上限，因此不会影响开机。两个需要同时注意的边界：一是 PWRKEY 外部不能有任何上拉电路，否则会有系统启动不稳定的风险；二是模组上电开机时，需确保 VBAT 上电时的起始电压小于 0.5V。另外，若用 PWRKEY 做常驻中断输入，开机后可用 gpio.setup(gpio.PWR_KEY, nil, gpio.PULLDOWN) 进一步降低待机电流，在 PSM+ 模式下大约能省 15uA。

处理步骤：

  1. 确认接法是 1kΩ 一端接 PWRKEY、一端接 GND（串联下拉），并确认 PWRKEY 处没有任何外部上拉电路。
  2. 确认模组上电时 VBAT 起始电压小于 0.5V，避免低电压造成上电时序混乱而不开机。
  3. 若开机后要把 PWRKEY 当常驻中断输入，改用 gpio.setup(gpio.PWR_KEY, nil, gpio.PULLDOWN) 配置下拉以降低待机电流。
  4. 若最终是要用实体按键做开/关机（而非常接下拉），按官方参考电路加 TVS 做静电保护。

参考文档：PWRKEY 开机键（串联电阻阻值上限与漏电流说明） https://docs.openluat.com/air780epm/luatos/hardware/pwrkey/ ；Air780EPM 开机电路设计说明（PWRKEY 外部禁止上拉、上电起始电压要求） https://docs.openluat.com/air780epm/luatos/hardware/design/poweron/ 。

15. 1603的板子什么时候出来？

解答： 结论：按当时口径，Air1603 的板子还没出来，估计「明后天」。这属于产品排期信息，不在技术文档管辖范围内，具体以官方发布为准。 说明：Air1603 的模组资料与文档站内容已在陆续补齐（产品介绍、固件与 demo、硬件开发资料、第一个入门练习、软件开发资料、FOTA 等都有更新），但「开发板何时上架」属于产品与供应链排期，官方文档不会给出承诺日期，本文的转述也不作为交期依据。需要样品或批量时，请以官方商城上架信息与对接销售的通知为准；板子到位之前，可以先按文档与 demo 把软件侧准备好，缩短后续调试周期。排期紧的情况下，也可以同步评估用现有型号做替代验证。

处理步骤：

  1. 关注合宙官方淘宝店 Air1603 开发板的上架与预售信息。
  2. 需要样品或批量时，通过官方企业微信群或对接销售确认排期与供货。
  3. 板子到位前先通读 Air1603 文档与 demo，把工程框架和驱动准备到可烧录状态。
  4. 若排期无法满足项目节点，同步评估用现有型号做替代方案验证。

参考文档：Air1603 资料中心（产品介绍） https://docs.openluat.com/air1603/ ；Air1603 固件与 demo https://docs.openluat.com/air1603/luatos/firmware/1603_version/ 。

搜索