常见问题 - 2026-10-18

数据日期：2026-10-18

1. Air8780V设备约15秒重启，是否有现成的main.lua可实现收到短信后语音转发到HTTP服务器？

解答： 结论：官方没有「收到短信 → 合成语音 → 推送到 HTTP 服务器」这一整包现成的 main.lua；最接近的是 Air780EHV/EGH/EHM 的「短信和来电转发」demo（短信内容与来电号码转发到飞书/钉钉/企业微信机器人或手机号，通话中可录音留存），语音那一段需要自己用 sms + audio(tts) + http 三个库拼。说明：Air8780V 板载的就是 Air780EHV，所以 sms_call_forward 这个 demo 可以直接下下来改，而且 EHV 内部已集成 Audio Codec、原生支持 TTS/VoLTE，做语音不需要再外挂 ES8311。demo 里「转发」那一步本质是向 webhook 发 HTTP 请求，把地址换成你自己的接口、按你的报文格式组包即可，http 库支持 POST。至于约 15 秒就重启：这个量级不像板载 Air153C 硬件看门狗的动作（其超时是 200~280 秒量级），更像是脚本在启动阶段就报错、或供电跌落/射频异常导致的复位，所以要先用最小脚本做二分，把「脚本问题」和「硬件问题」分开。处理步骤： 1. 进下载模式：Air8780 板载 USB-BOOT 键，文档写法是上电前按住再上电；对已通电的板子，等效做法是按住 USB-BOOT 再触发一次 RESET。 2. 用 Luatools「量产文件刷机」刷回对应型号的出厂 .soc，确认空脚本下是否仍 15 秒重启。 3. 不再重启 → 问题在脚本，逐段注释定位；仍重启 → 接 USB 抓 trace/4gdiag 日志，重点看复位原因与供电。 4. 业务侧基于 sms_call_forward demo 改：转发目标换成自己的 HTTP 接口，语音部分用 tts 合成后播放或录音后 POST。参考文档：https://docs.openluat.com/air8780/software/debug/、https://docs.openluat.com/air780epm/luatos/app/common/sms_call_forward/

2. Air8607文档链接打不开怎么办？

解答： 结论：多半是打开了目录根路径 https://docs.openluat.com/air8607/ ——该目录下只有 product / hardware / software 三个子目录、没有 index.md，线上会直接返回 403，不是站点挂了。说明：mkdocs 是目录式渲染，目录里没有 index.md 就生成不出页面，访问根路径得到的是「目录列表被拒绝」的 403。Air8607 的资料按「型号说明 / 硬件 / 软件」三块组织：product 下是产品与型号说明，hardware 下是原理图、封装与电路，software 下是出厂固件与下载调试。顺带提醒一个常见误解：Air8607 的 Type-C 是板载 CH343 转串口，不是 USB Host，接不了 UVC 摄像头和键鼠，带 USB 的型号是后续的 8607A。处理步骤： 1. 直接打开产品页 https://docs.openluat.com/air8607/product/ ，不要用 /air8607/ 。 2. 硬件资料走 /air8607/hardware/ ，固件与调试走 /air8607/software/ 。 3. 仍打不开就换网络、清浏览器缓存，或到 docs.openluat.com 首页搜索「Air8607」。参考文档：https://docs.openluat.com/air8607/product/、https://docs.openluat.com/air8607/hardware/

3. Air700ECP支持无CS的SPI从机模式吗？

解答： 结论：不支持。Air700 系列（含 Air700ECP/ECH/ECT）的 SPI 只能做主机，不能做从机，也就谈不上「无 CS 的从机模式」。说明：spi 库在 master_slave 参数的注意事项里写得很清楚：合宙 Air780EXX 系列、Air8000 系列、Air700 系列以及 Air8101 系列只支持主机模式；能当从机的是特定形态（文档提到 Air8101 作为主控外挂 4G 模组时可作 SPI 从机）。另外从协议上看，CS 是从机侧的输入信号，主设备靠拉低某个从机的 CS 来选中它，「无 CS 从机」在标准 SPI 里本身就不成立。如果拓扑是「外部 MCU 做主机、Air700ECP 当外设」，那就必须换接口；如果反过来 Air700ECP 做主机，则是完全可用的。处理步骤： 1. 先确认拓扑：谁做主机。外部 MCU 必须做主机时，Air700ECP 不能当从机。 2. 改用 UART（推荐）或 I2C 做两机通信，二者天然带地址/应答机制。 3. 必须用 SPI 就把 Air700ECP 设为主机，外设做从机并给它独立 CS。参考文档：https://docs.openluat.com/osapi/core/spi/

4. 合宙摄像头模组1040 SPI接口接入AIR780EPM开发板，图像显示竖条纹，是FPC接触问题还是摄像头坏了？

解答： 尚未解答

5. 代理下单是否还需要签合同？

解答： 结论：可以先不签合同：通过淘宝企业店 / 微信商城下单，下单后联系客服按代理价改价付款，先把货上架试销；等订单量稳定后再谈囤货或签协议。说明：这属于商务与渠道政策，不在技术文档管辖范围，具体折扣、起订量、账期以对接销售的口径为准。实操上建议先把「型号清单 + 预计月用量 + 目标客户类型」整理好一次性给到销售，比逐款问价效率高得多；另外代理价是下单后由客服改价，所以订单不要先付款，否则改价流程会变麻烦。处理步骤： 1. 在淘宝企业店 / 微信商城按正常流程下单，先不付款。 2. 把订单号发给客服，说明申请代理价，等改价完成后再付款。 3. 上架试销一段时间，统计真实出货量，再和销售谈囤货或签代理协议。参考文档：无（属商务/渠道事项，请通过购买渠道或对接销售确认）。

6. 780EHV可以在欧洲使用吗？需要支持VoLTE。

解答： 结论：Air780EHV 不行。它是面向国内的型号（TDD B34/B38/B39/B40/B41 + FDD B1/B3/B5/B8），不覆盖欧洲运营商频段；欧洲 / 亚欧场景应选 Air780EHU（B1/B3/B5/B7/B8/B20/B28/B38/B40/B41）。说明：频段是硬件差异，刷固件改不了。官方在频段对照页里特别强调过：不能因为「某个频段刚好重合」就认为能在该国使用，因为无法保证当地运营商所有基站都覆盖那个频段，只有全部覆盖才能保证随处可连。VoLTE 方面，EHV 内部集成了 Audio Codec（ES8311）并支持 VoLTE/TTS，国内做语音不需要外挂；换成 EHU 之后必须外挂 Audio Codec 才能出声。还要注意：海外型号只过了 CE / FCC，没有做当地运营商认证，也没有组织实地场测，海外 VoLTE 到底能不能用必须自己拿当地卡场测，官方不给承诺。处理步骤： 1. 选型换成 Air780EHU，按目标国家的运营商逐个核对频段。 2. 硬件预留 Audio Codec（如 ES8311）与听筒 / MIC 通路。 3. 出货前用当地运营商的卡场测：VoLTE 注册、主被叫、通话质量、APN。 4. 产品里务必提供手动设置 APN 的入口，海外卡基本都需要手填。参考文档：https://docs.openluat.com/air780ehv/product/、https://docs.openluat.com/air780ehnehu/product/air780ehufreq/

7. 724UG可以用于欧洲打电话吗？

解答： 结论：不行，Air724UG 不能用于欧洲打电话。说明：Air724UG 是国内 Cat.1 型号，官方没有面向欧洲的频段版本；欧洲要选 Air780EHU 这类亚欧版（B1/B3/B5/B7/B8/B20/B28/B38/B40/B41）。而且 724 平台现在只保留 AT 与 LuatOS 两层资料，产品与频段页已经不在站点上了，说明它不在当前主推序列。语音这边也不只是频段问题：要 VoLTE 支持，还要外挂 Audio Codec（EHV 是内置 codec 的特例）。所以换型号等于同时解决频段、语音通路和后续维护三件事，比在 724 上硬改省事。处理步骤： 1. 欧洲项目直接选 Air780EHU；国内要免外挂 codec 才考虑 EHV，但 EHV 不能出海。 2. 按目标运营商核对频段，缺一个都别赌。 3. 出货前做实地场测（CE / FCC 之外没有运营商认证）。参考文档：https://docs.openluat.com/air780ehnehu/product/air780ehufreq/、https://docs.openluat.com/air780ehv/product/

8. 只打电话不接听，是否可以不外挂音频芯片？

解答： 结论：可以。完全不需要声音输入输出的场景（只做主叫、振铃/挂断判断，或只做被叫但不接听）可以不外挂音频芯片；被叫也能接起来，只是双方都听不到声音。说明：外挂 Audio Codec（如 ES8311）只负责模拟音频的编解码通路，和「能不能建立通话」是两件事。文档口径是：Air780EGH / EGG 支持 TTS 与 VoLTE 通话、录音，但需要外部添加 Audio Codec，模组内部没有集成；Air780EHV 是例外，内部已集成 ES8311，什么都不用加。所以先看型号再谈要不要加：EHV 直出，EHM/EGH/EGG 若需要听或说就必须加 codec，纯粹做拨号与状态机可以不加。另外固件必须选带 VoLTE / 通话能力的版本，普通固件里没有这套接口。处理步骤： 1. 先明确业务：是否需要播报、是否需要听对端声音。 2. 都不需要 → 不设计 codec，只保留 VoLTE 固件 + cc 接口做呼叫控制。 3. 需要出声 → 按型号决定：EHV 直出，EHM/EGH/EGG 外挂 ES8311。 4. 用 cc 库做主叫/被叫/挂断状态机，先验证能建立通话再接音频。参考文档：https://docs.openluat.com/air780egh/product/、https://docs.openluat.com/air780ehv/product/、https://docs.openluat.com/osapi/core/cc/

9. 之前用PV的程序能否与U系列程序通用？

解答： 结论：Lua 脚本大体可以通用（同一套 LuatOS API），但不能直接照搬——引脚复用、网络制式与 APN、内核固件型号这三处必须改。说明：这里的 PV 通常指 Air780EPV（EC718PV 平台），U 系列指 Air780EHU 这类海外型号。两者都跑 LuatOS，业务层（socket / mqtt / http / fskv 等）写法一致，所以「通用」体现在脚本结构上；差异在硬件与固件：一是引脚复用表不同，PWM、SPI、UART 的通道号与 GPIO 要按新模组的复用表重配；二是频段与 APN 不同，海外卡基本要手填 APN；三是 .soc 内核不能混刷，必须用目标型号自己的固件。还要提醒一点：EPV 属于较老平台，官方最后一版 EPV 固件是 V1002，之后要 EPV 固件只能云编译或自行编译，新项目用 U 系列正好把内核维护问题一起解决。处理步骤： 1. 把脚本里写死的 GPIO / 通道号抽成配置项，按新模组复用表填。 2. 换用目标型号自己的内核固件，不要拿 EPV 的 .soc 烧 EHU。 3. 补 APN 手动配置入口，先用当地卡手工设一次验证。 4. 回归测试分三块：联网、业务协议、外设，逐块确认。参考文档：https://docs.openluat.com/air780ep/luatos/firmware/、https://docs.openluat.com/air780ehnehu/product/air780ehufreq/

10. Air8783H模组能否增加WiFi功能？现有已购买的模组能否返厂加装？

解答： 结论：改硬件设计可以加 WiFi（要增加 WiFi 电路与天线、尺寸变大、成本增加十几元，并可做 WiFi / 4G 优先级切换），但已经买到的 Air8783 不能返厂加装。说明：Air8783 目前只有一个硬件型号，板载 Air780ER2，对外只走 USB（RNDIS 上网 + 短信转发），没有留扩展接口，二次开发只能在软件层做——所以「返厂加 WiFi」在硬件上没有落点。要 4G + WiFi 的组合，更现实的是换型号：Air8000 系列本身就把 4G + WiFi 6（支持 AP 与 STA）+ BLE + GNSS 集成在一颗里，其中 Air8000W 是 4G / WiFi / BLE / 以太网、不带 GNSS。另外文档里没有 Air8783H 这个型号（只有 Air8783），如果丝印写的是 8783H，建议先核对完整型号再谈改型。处理步骤： 1. 核对现有丝印完整型号；8783 没有 WiFi 版本，也没有扩展口。 2. 需要 WiFi 就按新硬件做：WiFi 电路 + 天线 + 优先级策略，重新开板。 3. 不想改板 → 直接用 Air8000W 核心板 / 整机做验证。 4. 已购 8783 继续当纯 4G dongle 用，不要指望返厂改。参考文档：https://docs.openluat.com/air8783/product/、https://docs.openluat.com/air8000/product/

11. 是否有现成的4G+WiFi dongle，可以先拿样机测试？

解答： 结论：目前没有现成的 4G + WiFi dongle 样机，近期也没有开发计划；着急要只能定制（先锁定研发资源，原答口径是 1000 个左右约 3 周）。过渡期建议先用 Air8000W 核心板验证 SIP-CC 桥接通话。说明：dongle 形态的关键是「免驱 + RNDIS」，现在的 Air8783 只做 4G（板载 Air780ER2），加 WiFi 等于重做一块板。Air8000W 自带 4G + WiFi 6 + BLE + 以太网，同一套软件支持 4G / WiFi / 以太网多网融合，用它做核心板可以把「4G 桥接 + WiFi 热点 + SIP 通话」先在桌面上跑通，再决定要不要投定制 dongle。数量、周期、报价属于商务承诺，以销售最终给的为准。处理步骤： 1. 先用 Air8000W 核心板搭验证环境，跑通 4G 转 WiFi 与 SIP-CC 通话。 2. 把形态需求（尺寸、接口、是否要求免驱）整理成一页给销售。 3. 确认要定制后再谈数量与周期（原答口径约 1000 个 / 3 周）。参考文档：https://docs.openluat.com/air8000/product/、https://docs.openluat.com/air8783/product/

12. 在小板/开发板上想增加PWM接口用于电机控制，如何实现？

解答： 结论：可以。模组侧只输出 3.3V 逻辑电平的 PWM，经光耦（或光耦 + 驱动）隔离后接外部电源，就能驱动 5~24V 的电机控制器；PWM 路数不够时用外扩芯片补，多路 CS 用来分别选中。说明：pwm 库的频率范围是 1Hz~13MHz，通道号与 GPIO 绑定、使用前要先做引脚复用；Air8000 支持 PWM0~PWM5，其他型号的可用通道数要看各自的硬件文档。做电机控制时，PWM 只负责给速度 / 位置指令，功率级一定放在外部（光耦隔离 + MOS / 驱动器 + 独立电源），不要从模组的 3.3V 取电。预留 SPI 与 UART 是为了以后接多路 PWM 扩展芯片或编码器；CS 单独引出的意义是同一路 SPI 总线上能挂多片、靠片选逐个访问。处理步骤： 1. 先查所选模组的 PWM 通道数与对应 GPIO，完成引脚复用。 2. 光耦按电机侧电压 / 电流与开关频率选型，PWM 地与电机地分开。 3. 预留 SPI（SCLK / MOSI / MISO）+ 多路 CS，另留一路 UART 给调试或编码器。 4. 用 pwm.setup / pwm.setFreq 动态调速，改参数前先 pwm.close。参考文档：https://docs.openluat.com/osapi/core/pwm/

13. 手表大小的设备要做定位和4G，推荐什么型号？

解答： 结论：优先考虑 Air780EGG（4G + GNSS 二合一、LuatOS、国内全网通）；手表尺寸能不能做，瓶颈不在模组，而在 GNSS 天线与结构。说明：Air780EGG 与 EGH / EGP 共用一份硬件手册与封装（文档标注 17.7×15.8×2.3mm），本身就是为「通信 + 定位」二合一设计的，比「4G 模组 + 独立 GNSS 模组」省一块板、也省一路供电。要注意三点：一是手表体积小，GNSS 天线净空和地平面很难做，贴身佩戴时定位会明显变差，普通手机级精度在小体积上实现难度大；二是 EGG 是面向国内的型号，出海要换 EHN（北美）/ EHU（亚欧）；三是长待机与 GNSS 常开是冲突的，PSM+ 下必须做定位占空比。原答里的 docs.luatos.com 已经不可用（TLS 证书校验失败），请改用 docs.openluat.com。处理步骤： 1. 先按 Air780EGG 做硬件评估，重点是天线净空、电池与充电。 2. 定位用 libgnss / exgnss，按业务做「定时定位 + 休眠」而不是常开。 3. 出海项目改选 Air780EHN（北美）或 Air780EHU（亚欧）。 4. 方案细节用 ai.luatos.com 或对接 FAE 复核。参考文档：https://docs.openluat.com/air780egh/product/、https://docs.openluat.com/osapi/core/libgnss/