常见问题 - 2026-08-13

数据日期：2026-08-13

1. AIR780EGP常用于4G及定位，目前4G通信正常，但定位信息一直出不来，为什么？

解答： Air780EGP是LuatOS二次开发型号，GNSS定位需通过Lua脚本调用exgnss扩展库实现，AT指令无法操作其定位功能；如项目确定走AT指令开发，应选用AT型号Air780EG2（小存储）或Air780EGT（大存储）。 4G通信正常但定位不出来，定位与4G是两套独立系统，请按以下步骤排查： 1. 确认脚本中已require "exgnss"，并先调用exgnss.setup()完成配置，再调用exgnss.open(mode,para)打开定位应用（参考exgnss库文档：https://docs.openluat.com/osapi/ext/exgnss/ ）； 2. 确认GNSS天线已正确连接到GNSS_ANT管脚（PIN2），有源天线可用PIN98（GNSS_VDD，3.3V）馈电，天线需放在室外或靠窗无遮挡环境，首次冷启动定位可能需要数十秒到数分钟； 3. 定位成功时exgnss.open注册的回调会被触发并返回经纬度，可在回调中打印日志确认； 4. 升级到最新版EGP固件后重新下载官方GNSS demo验证（demo含single/combination两种例程）。

2. 780EGP核心固件core几个文件有什么区别？

解答： 这里先区分两件事： 1. 型号层面：Air780EGP是LuatOS二次开发型号，Air780EG2是AT指令型号，二者开发方式不同，固件不能互刷，请按自己的开发方式选型； 2. 固件文件层面：同一型号的core固件包中，不同编号的固件（如14号、19/119号等）区别在于脚本区空间、文件系统空间大小，以及内置功能组件不同。例如19/119号固件是在14号固件功能基础上，把脚本区改为1M字节、文件系统改为168K；部分固件会移除中文矢量字库、CAN、FTP等组件，或增加16号中文灰度点阵字库、TTS、Audio_v2等组件。选择建议：脚本/资源占用小的常规项目用默认固件即可；脚本较大或需要更多文件系统空间时，选大脚本区固件；固件版本历史和各版本更新记录见https://docs.openluat.com/air780egh/luatos/firmware/780egp_version/ 。

3. Air780EP固件现在还有方法获取吗？

解答： Air780E（780EP）并未停产，目前仍在持续供货，现有项目可以放心继续使用，固件也一直维护更新。 1. 固件获取：Air780E的LuatOS底层固件（core）和脚本demo可在合宙文档站对应型号的资料中心/固件版本页下载（https://docs.openluat.com/air780e/luatos/ ），使用Luatools下载工具烧录即可； 2. 新项目选型建议：新立项项目推荐直接采用升级款Air780EPM（同封装、资源更强），从Air780E迁移时注意个别管脚配置（如IO电平设置方式、管脚复用）可能需要按EPM硬件资料做对应修改，硬件资料见https://docs.openluat.com/air780epm/luatos/hardware/ ； 3. 如对供货周期或替代型号有疑问，可联系合宙销售或在官方企业微信群确认。

4. 模组烧录失败有什么因素，底层core有什么要求？

解答： 烧录失败绝大多数情况是没有进入下载模式或供电/连线问题，与底层core版本无特殊绑定关系（core固件由Luatools自动识别匹配，无需手动选择）。请按标准下载流程操作： 1. 模组断电（断开USB/电源）； 2. 打开Luatools，选择好固件和脚本，点击"下载"，等待工具进入等待设备状态； 3. 按住BOOT按键（下载模式按键）不松开； 4. 给模组上电（插USB或接电源）； 5. 长按开机键（PWRKEY）约1~2秒使模组开机； 6. 看到Luatools开始下载后再松开BOOT，等待下载完成。其他常见因素：USB线必须是数据线（非纯充电线）、供电能力不足（建议5V/500mA以上）、驱动未安装（设备管理器中应能看到下载端口）、固件/脚本路径含中文或空格。详细图文步骤参考https://docs.openluat.com/common/howtodown/ 。

5. air8000a套件烧录官方demo gnss single下三个程序后板子断开连接，设备识别不到怎么办？

解答： 下载完成后模组复位运行新脚本，若此时USB重新枚举失败或脚本中进入了低功耗/休眠等状态，可能导致电脑识别不到设备。这不是板子损坏，重新强制进入下载模式即可恢复： 1. 断电，打开Luatools并选好固件，点击下载； 2. 按住BOOT键不松开，再给板子上电； 3. 长按开机键1~2秒，待Luatools开始下载后松开BOOT； 4. 建议先烧录一个最简脚本（如只打印hello world的main.lua）验证连接正常，再逐个排查GNSS demo中是否有进入休眠、关闭USB或异常重启的逻辑。标准下载流程参考https://docs.openluat.com/common/howtodown/ ；若反复出现，可更换数据线、检查USB口供电，并升级到最新版Luatools。

6. Air780核心板烧录固件和脚本都是用串口就可以吗？

解答： Air780系列（Air780E/EPM/EGP等Cat.1型号）核心板烧录固件和脚本默认使用USB口，不使用普通串口。用USB数据线连接电脑后，模组会枚举出下载端口，Luatools通过该端口下载底层固件（core）和Lua脚本。操作要点： 1. 使用数据线（非纯充电线），电脑设备管理器中能看到对应端口即表示连接正常； 2. 若USB无法识别，可将USB_BOOT管脚与VDD_EXT短接后上电强制进入下载模式，或按BOOT+上电+开机键流程操作（参考https://docs.openluat.com/common/howtodown/ ）； 3. 下载完成后日志查看也走USB虚拟串口，外接MCU通信才使用UART串口。

7. 有没有支持海外日本韩国的cat1或者1bis模组？

解答： 有面向海外市场的Cat.1型号，按目标地区选择：欧亚地区（含欧洲、日韩、东南亚等）用Air780EHU，北美地区用Air780EHN；两款海外型号均只支持LuatOS二次开发，不提供AT固件。 1. 型号与频段：Air780EHU覆盖欧亚主流频段，Air780EHN覆盖北美频段，具体支持频段请以官方频段覆盖表为准并与当地运营商频段核对——欧亚版频段见https://docs.openluat.com/air780ehnehu/product/air780ehufreq/ ，北美版频段见https://docs.openluat.com/air780ehnehu/product/air780ehnfreq/ ； 2. 日本、韩国市场请务必先对照频段覆盖表确认当地运营商Band是否在支持范围内，再确认当地认证（如日本TELEC/JATE、韩国KC）情况，认证与合规问题建议联系合宙销售确认； 3. 完整海外选型对比可查阅合宙选型指南https://docs.openluat.com/SelectionGuide/SelectionGuide/ ，或在官方企业微信群咨询。

8. 我用air724刷最新固件做DTU，需要UART1给Lua用（uart.setup(1)返回失败），怎么解决？

解答： 原因：Air724（Air724UG等Cat.1 AT平台）的UART1默认被AT指令底层通道占用，高版本LuatOS固件中uart.setup对UART1增加了任务优先级参数，直接调用uart.setup(1)会因通道被占用而返回失败。解决办法： 1. 升级到V4017及以上版本固件，该版本起uart.setup支持传入任务优先级参数，将Lua串口任务优先级设置为高于AT底层任务后即可抢占UART1给Lua脚本使用； 2. 调用方式按固件版本对应demo中的uart.setup写法传入优先级参数（具体参数定义见Air724固件版本说明与串口demo）； 3. 若项目中UART1必须保留给AT通道，建议DTU数据走其他可用UART，避免与AT底层冲突。固件与版本说明见合宙文档站Air724对应资料页，如有疑问可在官方企业微信群获取固件版本支持确认。

9. micro sip工具能连接到测试服务器，但电话打不出去也打不进来，为什么？

解答： 结论：micro SIP能连上测试服务器只代表网络注册和SIP注册流程正常，呼叫不通通常是账号权限问题——VoLTE/SIP语音测试需要使用单独开通的测试账号，不能使用通用测试账号100000、100001，这两个公共账号没有呼叫权限。处理步骤： 1. 向合宙申请/开通独立的SIP测试账号（一主叫、一被叫），账号开通后再在micro SIP和模组脚本中分别配置； 2. 确认模组侧已正常附着网络、IMS注册成功（脚本中观察SIP注册成功事件）； 3. 主叫、被叫均使用已开通的测试账号互拨验证。账号申请方式可咨询合宙官方企业微信群或销售。

10. demo的NotoSansSC_subset.ttf字库是只有一部分中文字吗？有些字还是乱码？

解答： 是的。NotoSansSC_subset.ttf是"子集字体"文件，制作时只收录了demo用到的那部分汉字，未收录的字符显示为乱码或缺字，这属于正常现象，不是加载失败。解决办法（任选其一）： 1. 用合宙字库生成工具u8g2_font_tool，把项目中所有需要显示的中文（含界面文字、可能显示的地名/状态字等）一并加入，重新生成完整的ttf/字库文件替换使用，字体使用指南见https://docs.openluat.com/common/luatos_font_guide/ ； 2. 对显示字数少、字号固定的场景，直接使用LuatOS内置中文字体，如u8g2.font_opposansm12_chinese、u8g2.font_opposansm16_chinese、u8g2.font_opposansm24_chinese等，无需外挂字库文件； 3. 生成字库时注意脚本文件保存为UTF-8编码，避免编码不一致导致取字错误。u8g2库接口说明见https://docs.openluat.com/osapi/core/u8g2/ 。

11. Air8101使用示例代码文字显示乱码，是字体文件没有正确加载问题？

解答： 文字显示乱码最常见原因是字体文件为子集字库（只含部分汉字）或脚本/字库编码不匹配，而不一定是"加载失败"。请按以下顺序排查： 1. 确认所用ttf/字库文件包含待显示的全部汉字——demo自带的NotoSansSC_subset.ttf是子集字体，缺字会显示乱码，可用u8g2_font_tool把项目所需字符全部加入重新生成（字体指南：https://docs.openluat.com/common/luatos_font_guide/ ）； 2. 简单显示场景可直接改用内置中文字体u8g2.font_opposansm12/16/24_chinese，排除外挂字体因素； 3. 确认lua脚本文件以UTF-8编码保存，取模字符集与显示字符串编码一致； 4. 若英文字符/数字也乱码，再检查屏幕初始化参数、SPI/I2C接线和u8g2初始化调用是否正确。 u8g2接口文档见https://docs.openluat.com/osapi/core/u8g2/ 。

12. 串口数据长了容易断帧，这个能调整帧间隔吗？

解答： 结论：UART是字节流传输，硬件层面没有"帧间隔"这个可配置参数，所谓"断帧"是因为一帧数据被分多次uart.read读出，需要在应用层做组帧处理，而不是调整串口参数。推荐做法（官方串口demo即采用此模式，参考uart_app.lua）： 1. 串口接收回调中持续uart.read(UART_ID, 1024)读取字节，追加拼接到接收缓冲区； 2. 每收到数据就启动/重置一个空闲定时器（典型50ms，可按协议调整）； 3. 定时器时间内无新数据到来，即认为一帧结束，再对缓冲区数据按协议解析、处理并清空； 4. 若通信协议本身带帧头、长度字段或校验，优先按协议格式（帧头+长度）判定整帧，比固定超时更可靠。这样无论数据多长、分几次到达，都能还原出完整帧。串口接口文档见https://docs.openluat.com/osapi/core/uart/ 。

13. PWRKEY始终接低电平，RESET引脚给500mS低脉冲后模组不启动工作，有什么说法吗？

解答： 结论：PWRKEY（PIN7）通过串阻（≤10KΩ）接地即可实现上电自动开机，这是推荐的自动开机设计；但上电瞬间不应在RESET引脚上施加低脉冲——RESET是复位脚，上电时序期间模组正在完成内部启动，此时拉低RESET会打断/复位启动流程，导致模组无法正常启动；不发该脉冲时一切正常也印证了这一点。建议： 1. 自动开机只需将PWRKEY接低（串10KΩ以内电阻到地），RESET脚正常上拉、上电过程中保持高电平，不要在上电时序中给复位脉冲； 2. 如确需外部复位，请在模组完全启动之后（上电并开机稳定后）再拉低RESET，且按手册要求的脉冲宽度操作； 3. 检查MCU复位脚与模组RESET是否连在一起、MCU上电时是否有复位波形串扰到模组。上电时序与管脚说明见对应型号硬件设计手册。

14. 模组的PIN100悬空时，外部串口和GPIO逻辑不需要做电平转换吗？模组的IO都是3.3V逻辑？

解答： 结论：Air780EPM等新型号已取消老Air780E上通过PIN100硬件选择IO电平的设计，GPIO默认即为3.3V逻辑，PIN100悬空即可、不需要做任何控制，外部3.3V串口/GPIO直连无需电平转换。补充说明： 1. 老款Air780E靠PIN100电平决定IO电压（悬空为1.8V、接地为3.3V），新型号不再适用该方式； 2. 若外设需要1.8V电平，新型号可在软件中调用pm.ioVol(pm.IOVOL_ALL_GPIO, 1800)统一设置IO电平（支持1650~2000mV和2650~3400mV两档范围），设置为3300即3.3V； 3. 与5V逻辑的外设连接仍需电平转换，模组IO不耐压5V。硬件设计资料见https://docs.openluat.com/air780epm/luatos/hardware/ ，IO电平设置说明见https://docs.openluat.com/air780epm/luatos/hardware/pin100/ 。

15. 量产工具不支持103吗？

解答： 合宙Luat量产工具支持当前在产的各型号模组（按soc文件名识别型号，形如LuatOS-SoC_Vxxxx_Airxxxx）。如某型号在工具下拉列表中找不到，请先确认： 1. 将量产工具升级到最新版本，旧版本工具可能未包含新型号配置； 2. 确认该型号的量产固件命名与工具要求一致，具体支持型号清单和操作说明见量产工具文档：https://docs.openluat.com/common/Luat_productiontool/ ； 3. 若升级后仍不支持对应型号，请在官方企业微信群反馈型号与工具版本号确认。

16. 这个模组的PIN100要是悬空，我外部串口和GPIO逻辑不需要做电平转换了？

解答： 对，Air780EPM等新型号不再需要控制PIN100：GPIO默认工作在3.3V逻辑，PIN100悬空即可，外部3.3V电平的串口和GPIO可直接连接、无需电平转换。注意两点： 1. 只有与5V逻辑外设对接时才需要加电平转换，模组IO不耐5V； 2. 若外设要求1.8V电平，可软件调用pm.ioVol(pm.IOVOL_ALL_GPIO, 1800)设置（可选范围1650~2000mV、2650~3400mV），详见https://docs.openluat.com/osapi/core/pm/ ，硬件设计以https://docs.openluat.com/air780epm/luatos/hardware/ 为准。

17. Air8602寄存柜/换电柜专用工业模组上市了吗？

解答： Air8602寄存柜/换电柜专用工业模组已正式上市，可直接选购和开发。产品要点： 1. 主控采用Air1601，集成4G与WiFi通信能力，面向寄存柜、换电柜等工业柜机场景； 2. 板载双路隔离RS485接口，支持12V供电，并适配7寸、9寸、10寸RGB显示屏，便于柜机人机交互； 3. 产品资料（硬件手册、LuatOS开发文档、demo等）见合宙文档站Air8602产品页：https://docs.openluat.com/air8602/product/ ； 4. 采购可在合宙淘宝店https://luat.taobao.com/ 下单，批量与定制需求可联系合宙销售。

18. 之前用的780EGH现在不想用4G供网了，只想使用芯片本身的MCU功能可以吗？

解答： 可以。Air780EGH本质是带4G通信能力的Cat.1模组，4G和GNSS等功能都由Lua脚本按需调用，不插卡、不初始化mobile/网络相关库时，模组就作为普通MCU运行：GPIO、UART、I2C、SPI、定时器、ADC、屏幕显示等外设功能均可独立使用，不依赖4G网络。注意事项： 1. 不使用4G时不要在脚本中调用mobile、socket等联网库，避免模块反复搜网增加功耗； 2. 若追求更低成本的纯MCU应用，也可评估合宙纯MCU型号（如去4G的Air1780等），具体以选型指南https://docs.openluat.com/SelectionGuide/SelectionGuide/ 为准。

19. 会不会开发锂亚电池供电、带可控电源输出、485或TTL串口的4G模组板子？

解答： 这类面向工业现场供电场景的板子已有规划：支持12V/24V宽压电源输入，并带有一路可通过继电器控制通断的电源输出，用于给外部传感器/设备可控供电；串口方面RS485、RS232、TTL均会支持，可满足锂亚电池/外部电源供电的低功耗采集类应用。具体型号、规格和上市时间请以合宙官方发布为准，建议关注合宙文档站https://docs.openluat.com/ 新品页面，或在官方企业微信群、向销售咨询最新进度。

20. 你们已经提供了USB充电口对吗？

解答： 不同型号开发板/核心板的接口配置不同，是否带USB充电口（含充电管理芯片、电池供电切换）请以具体型号的硬件资料为准： 1. 在合宙文档站https://docs.openluat.com/ 找到对应型号产品页，查看"硬件手册/硬件设计"章节的接口说明和原理图； 2. 资料中会标明USB口是仅供电/下载，还是带锂电池充电管理（如标注CHRG、VBAT、充电芯片型号等）； 3. 若资料中未明确，可在官方企业微信群提供具体板卡型号确认。

21. 电池没电了怎么识别？板子自带ADC功能吗？

解答： 模组自带ADC，可以用ADC检测电池电压来判断电量。LuatOS提供adc库：调用adc.open()打开通道后用adc.get()读取电压值；检测模组供电电池可直接使用内部通道adc.CH_VBAT读取VBAT电压，adc.CH_CPU可读取芯片内部温度/供电相关通道。实现要点： 1. 先adc.open(adc.CH_VBAT)（外部电池分压检测则open对应ADC通道号），周期调用adc.get()获取电压； 2. 根据电池放电曲线（锂电池一般3.3V~4.2V区间对应电量百分比）换算剩余电量，低压时做低电告警或关机保护； 3. 注意adc.setRange()如需设置量程必须在adc.open()之前调用。 ADC使用说明与示例见https://docs.openluat.com/air780epm/luatos/app/driver/adc/ 及https://docs.openluat.com/osapi/core/adc/ 。

22. 这个要什么基础才可以开发？有应用软件开发水平不够吧？

解答： 有应用软件开发基础完全足够。LuatOS二次开发使用Lua脚本语言，语法简单、上手快，不需要深入的嵌入式底层/寄存器经验，具备基本的编程逻辑（变量、函数、条件、循环）即可开发。学习路径建议： 1. 先阅读对应型号的LuatOS快速上手文档，跑通hello world和点灯、串口打印例程； 2. 按功能参考官方demo（socket、mqtt、uart、gnss、adc等都有现成例程），在demo基础上修改； 3. 开发中可借助合宙AI工具ai.luatos.com辅助写代码、查API，API权威说明以文档站https://docs.openluat.com/osapi/ 为准； 4. 遇到问题可在官方企业微信群交流。

23. 有没有串口收到一帧数据，直接TCP透传到服务器的指定端口的例程？

解答： 有成熟的官方例程可参考，串口↔TCP透传是LuatOS最典型的DTU用法： 1. 官方demo（module/Air780EPM/demo/下的socket、mqtt目录）中提供了串口收发与网络收发结合的例程，其中uart_app.lua演示了标准的串口组帧模式：uart.on接收回调中uart.read循环读数据，配合50ms空闲定时器拼出完整一帧； 2. 透传实现思路：串口拼出一帧后通过已连接的socket（socket.tcp/socket.udp）发送到服务器指定IP和端口；socket收到服务器数据时直接uart.write转发到串口，即双向透传； 3. 网络部分参考socket demo的连接、断线重连逻辑，注意在IP_READY事件后再建连。代码可在https://gitee.com/openLuat/LuatOS/tree/master/module 对应型号目录查看，socket接口见https://docs.openluat.com/osapi/core/socket/ ；也可用合宙AI工具ai.luatos.com基于上述demo生成透传脚本。

24. 我想知道这个板子的接口定义，在哪里找呢？

解答： 板子的接口定义（管脚定义、引脚功能、电气参数）在官方硬件资料中查找： 1. Air8000系列可访问产品站air8000.cn，或在合宙文档站https://docs.openluat.com/ 对应型号产品页下载硬件手册/硬件设计文档，内含完整管脚定义表和原理图； 2. 文档站资料为统一权威来源，包含管脚复用、电平、默认状态等细节，硬件设计建议以文档站版本为准； 3. 若找不到对应板卡，可在官方企业微信群提供完整型号索取资料。

25. 8783的规格是多少V，多少A？

解答： Air8783为USB RNDIS上网棒形态产品，通过标准USB接口供电，供电规格为5V/1A，即整机功耗约5W。使用要点： 1. 直接插入电脑/设备USB口即可工作（Windows系统免驱，枚举出RNDIS网卡上网），不支持Android设备； 2. 现场使用时确保USB口供电能力不低于5V/1A，避免用供电不足的Hub导致反复重启； 3. 产品详细规格以产品页资料为准：https://docs.openluat.com/air8783/product/ 。

26. 两个空号返回投递成功，是否运营商状态识别串号了？

解答： 结论：这不是模组侧"串号"或状态识别错误。短信状态报告中1048字段是运营商短信网关直接透传的原始结果码，返回0x00表示网关明确回报"投递成功"，模组只是如实上报该结果。说明与建议： 1. 空号却回报成功，问题出在运营商/短信网关侧的状态报告机制（部分网关对空号、拦截、过期等场景不回真实失败码，或回执口径不同），模组无法篡改该字段； 2. 建议拿同一批号码、同一短信内容与卡商/运营商核对短信投递记录和状态报告口径； 3. 应用层若需可靠送达判断，不能只依赖状态报告0x00，应结合业务层回执（如终端收到后回ACK）综合判断。

27. AIR780EGP的pin66/67内部已挂载GSensor，这个IIC接口还能接别的外设吗？

解答： 可以。I2C是总线协议，同一路I2C（SCL/SDA）上可以挂载多个从设备，只要各设备的I2C从机地址不冲突即可，板载GSensor和外挂外设可以共用PIN66/67这组I2C。使用要点： 1. 查阅GSensor与新外设的器件地址，确保地址不同（相同则需更换其中一个器件或换I2C通道）； 2. 总线上所有设备共地，SCL/SDA按规范接上拉电阻（板载已有上拉时一般无需重复加）； 3. LuatOS硬件I2C每次与某一设备通信结束后会发送STOP条件释放总线，再寻址另一设备即可，注意不要在多设备间长时间占用总线； 4. 走线尽量短、避免与高速信号并行。i2c库用法见https://docs.openluat.com/osapi/core/i2c/ 。

28. 设备在用4G传输（TCP）时AT指令好像可以用，但定位信息出不来，固件能否更新成支持AT指令？

解答： 结论：Air780EGP是LuatOS二次开发型号，其GNSS定位只能通过Lua脚本调用exgnss扩展库实现，固件不支持、也不能通过升级变成AT指令版本；定位出不来是脚本/天线/使用方式问题，不是缺AT功能。处理建议： 1. 若项目希望用AT指令开发定位和通信，应更换为AT型号Air780EG2（小存储）或Air780EGT（大存储），EGP与EG2/EGT固件不能互刷； 2. 若继续用EGP做二次开发，请按exgnss流程排查：require "exgnss" → exgnss.setup() → exgnss.open(mode,para)，确认GNSS天线（GNSS_ANT，PIN2）连接、有源天线馈电（PIN98，3.3V）、室外开阔环境，并在定位回调中读取经纬度，参考https://docs.openluat.com/osapi/ext/exgnss/ ； 3. 升级最新EGP固件并运行官方GNSS demo（single/combination）验证。

29. 请问合宙支持opus的编码吗？看起来只支持AMR？

解答： 结论：LuatOS的exaudio音频扩展库不支持opus格式编码/解码，播放支持MP3、WAV、AMR_NB、AMR_WB、PCM格式；录音（编码）仅支持AMR_NB、AMR_WB和PCM，确实没有opus。建议： 1. 音频文件按支持格式准备：语音类可用AMR_NB/AMR_WB（体积小、适合语音对讲），音乐或高音质用MP3，原始数据用PCM/WAV； 2. 如果上游数据源是opus，需在服务器/对端先转码为MP3或AMR再下发，模组侧不做opus解码； 3. exaudio为V2音频框架，通过Luatools添加默认扩展库下载使用，接口与支持格式说明见https://docs.openluat.com/osapi/ext/exaudio/ 。

30. 请问有qq群吗？

解答： 合宙官方没有QQ技术群，官方技术支持渠道如下： 1. 官方企业微信群：扫码加入（合宙文档站https://docs.openluat.com/ 网站底部有企业微信二维码），有技术工程师在线答疑； 2. 文档站：https://docs.openluat.com/ 查阅型号文档、API手册、应用例程； 3. 代码仓库：https://gitee.com/openLuat/LuatOS/tree/master/module 查看官方demo和源码； 4. 合宙AI工具：ai.luatos.com 辅助写代码、查API； 5. 产品采购与样品：https://luat.taobao.com/ 。

31. 通过USB烧录代码电脑设备管理没识别到设备，换线换板子换电脑都不行，怎么回事？

解答： 换线、换板子、换电脑仍识别不到，说明模组大概率没有进入下载模式（正常开机态USB未枚举或脚本关闭了USB）。请强制进入下载模式： 1. 断电，打开Luatools并选好固件，点击下载进入等待状态； 2. 按住BOOT键不松开，给模组上电； 3. 长按开机键（PWRKEY）1~2秒，看到Luatools开始下载后松开BOOT； 4. 观察设备管理器：下载模式下会出现对应端口；若出现未知设备/感叹号，需重装Luatools自带的USB驱动。仍无任何反应时检查：USB_BOOT管脚与VDD_EXT是否短接（可强制下载模式）、供电是否达到5V/500mA、USB座焊接是否良好。流程参考https://docs.openluat.com/common/howtodown/ 。

32. luatools更新后识别不到设备了，怎么办？

解答： Luatools更新后识别不到设备，多为驱动或工具版本问题，按以下顺序处理： 1. 先强制进入下载模式验证：断电→Luatools点下载→按住BOOT→上电→长按开机键，看设备管理器是否出现端口（流程见https://docs.openluat.com/common/howtodown/ ）； 2. 更新后驱动可能被替换，若设备管理器出现带感叹号的未知设备，重新安装最新版Luatools（会自动重装USB驱动），或手动更新驱动指向Luatools安装目录的驱动文件； 3. 卸载当前Luatools，到文档站下载最新完整安装包重新安装，避免在线增量更新异常； 4. 检查Luatools中固件/型号选择、USB线（数据线）和供电。若以上均无效，可在官方企业微信群提供Luatools版本号和设备管理器截图反馈。

33. 怎么给钱呀？

解答： 样品和小批量采购可直接在合宙官方淘宝店下单付款：https://luat.taobao.com/ ，支持支付宝/网银等常规淘宝支付方式；批量采购、对公付款、账期或签订合同，可联系合宙销售（通过官方企业微信群或文档站底部联系方式对接）。选型和价格可同时参考合宙选型指南https://docs.openluat.com/SelectionGuide/SelectionGuide/ 。

34. Air8782P已上架，资料在哪？

解答： Air8782P的产品资料（硬件手册、LuatOS开发文档、固件、demo等）已在合宙文档站发布，访问产品页即可：https://docs.openluat.com/air8782p/product/ 。页面中可查看管脚定义、电气规格、快速上手和各类应用例程；配套源码demo也可在gitee仓库https://gitee.com/openLuat/LuatOS/tree/master/module 对应目录获取。

35. 如何查看上传到aircloud的图片，系统更新后查不到了？

解答： 上传到AirCloud（合宙iot平台）的图片，在平台网页端的"图片文件"页面查看，而不是普通设备数据页： 1. 登录合宙iot平台iot.luatos.com，进入对应的项目和设备； 2. 打开"AirCloud图片文件"（图片/文件管理）页面，按设备和时间查看模组上传的图片文件； 3. 系统更新后若查不到，先确认：设备端图片是否通过excloud扩展库按接口要求上传成功（观察上传返回值/回调）、上传时绑定的设备/项目与当前登录账号是否一致、图片是否在文件保留期限内； 4. 确认设备端excloud初始化参数（项目key、设备id等）与平台一致。 excloud库接口说明见https://docs.openluat.com/osapi/ext/excloud/ ；平台操作问题可在官方企业微信群反馈。

36. AirM2M_780E_V1163_LTE_LPAT中的MQTT是哪个版本？MQTT中用的SSL是哪个版本？

解答： LPAT固件是面向特定低功耗/透传场景的固件版本，其内置MQTT与SSL（TLS）的具体版本号随固件版本更新而变化，不能仅凭V1163固件名给出固定版本号。请按以下方式确认： 1. 查阅该固件版本的发布说明/版本历史（合宙文档站对应型号固件版本页），版本说明中会标注组件更新情况； 2. MQTT协议层面LuatOS支持标准MQTT 3.1.1，SSL/TLS能力以固件内置mbedtls/SSL组件为准； 3. 若对接的服务器对TLS版本/加密套件有强制要求（如仅允许TLS1.2），建议升级到最新固件后用mqtt demo实测握手是否成功，并在失败时导出底层日志确认协商版本； 4. 对版本号有明确合规要求的，可在官方企业微信群提供完整固件文件名，由工程师确认对应组件版本。

37. 上传升级固件失败，什么原因？

解答： 上传升级固件（FOTA差分包/整包）失败常见原因及排查： 1. 平台操作过于频繁：短时间内反复上传/创建固件可能被平台限流，间隔一段时间后重试； 2. 固件包问题：升级包必须由两个指定版本的底层固件（core）通过差分工具生成，版本号、型号必须与设备当前版本严格匹配，包名/项目key不一致会被拒绝； 3. 版本号规则：FOTA对版本号格式和递增关系有要求，不符合规则时平台判定异常； 4. 网络问题：上传过程中网络中断也会失败，换稳定网络重新上传。建议先用官方FOTA demo按文档流程完整走通一次，再替换为自己的包，参考https://docs.openluat.com/air780epm/luatos/app/ota/fota/ ；仍失败时在企业微信群提供固件文件名、平台报错截图和设备日志。

38. 780EHU不支持AT开发？

解答： 对，Air780EHU（欧亚海外版）只支持LuatOS二次开发（Lua脚本），不提供AT指令固件，无法用AT指令开发。海外型号中Air780EHU（欧亚）和Air780EHN（北美）均为二开型号。说明： 1. 海外项目请基于LuatOS做二次开发，联网、定位、串口等功能均通过Lua API实现； 2. 频段覆盖见https://docs.openluat.com/air780ehnehu/product/air780ehufreq/ ，选型对比可查https://docs.openluat.com/SelectionGuide/SelectionGuide/ 。

39. 这个有wifi功能吗？

解答： 合宙Cat.1蜂窝模组（如Air780E/EPM/EGP、Air8000等）通过4G蜂窝网络联网，本身不带WiFi连接功能（不能连路由器WiFi上网）。说明： 1. 带WiFi能力的是特定型号（如Air8602工业模组集成4G+WiFi），是否有WiFi需以具体型号规格书为准； 2. 选型时可在合宙选型指南https://docs.openluat.com/SelectionGuide/SelectionGuide/ 按"通信方式"筛选，或在文档站对应型号产品页确认功能列表； 3. 如需WiFi联网方案，可在官方企业微信群说明具体应用场景获取选型建议。

40. 产品只有CE/FCC认证，俄罗斯当地没有认证，使用时是非法还是违规？

解答： 关于CE/FCC认证在俄罗斯使用的合规性，说明如下： 1. CE（欧盟）、FCC（美国）认证是对应地区市场的准入认证，俄罗斯有本国强制认证要求（移动通信产品通常需满足俄罗斯当地的型号核准/准入，如FAC/相关EAC合规要求），CE/FCC不能替代俄罗斯本地认证； 2. 未取得当地认证而在当地销售或入网，属于合规风险，可能影响清关、运营商入网和合法销售，具体定性（非法/违规）及处罚以俄罗斯当地法律法规和海关、运营商要求为准； 3. 建议在量产出口前：向合宙销售确认该型号是否已具备俄罗斯本地认证或认证计划，并咨询当地认证机构/进口商完成本地核准； 4. 合宙产品的认证情况以官方提供的认证证书为准，可通过官方企业微信群或销售索取最新认证清单，切勿仅凭CE/FCC判断可直接上市。

41. 你们的产品有出口俄罗斯的吗？俄罗斯市场有代理销售吗？

解答： 面向俄罗斯及欧亚市场，合宙有对应的海外型号可供选型：欧亚地区推荐Air780EHU（LuatOS二次开发），频段覆盖欧亚主流Band，是否满足俄罗斯运营商频段请对照频段表核对（https://docs.openluat.com/air780ehnehu/product/air780ehufreq/ ）。关于销售渠道： 1. 样品可直接在合宙官方淘宝店https://luat.taobao.com/ 采购； 2. 俄罗斯本地代理/经销及出口、认证、批量交付事宜，建议直接联系合宙销售或通过官方企业微信群对接，获取最新的海外销售与认证支持； 3. 海外选型总览见https://docs.openluat.com/SelectionGuide/SelectionGuide/ 。

42. 780EHV在VOLTE通话时没办法录音了吗？

解答： 可以录音。Air780EHV在VoLTE通话过程中支持将通话语音录制保存为文件，官方提供了现成的通话录音demo（call_save_file），演示了在通话建立后启动录音、把双向语音写入文件、通话结束后停止录音的完整流程。使用要点： 1. 参考demo文档与代码：https://docs.openluat.com/air780ehv/luatos/app/volte/call_save_file/ ； 2. 录音格式遵循exaudio音频框架支持的格式（AMR_NB/AMR_WB/PCM等），按demo配置录音参数； 3. 需在VoLTE正常注册、通话接通后再启动录音，并确保文件系统空间充足。

43. SIP呼叫程序能同时注册两个服务器，同时呼两个不同服务器上的号码吗？

解答： 当前LuatOS的SIP/VoLTE方案不支持同时注册到两个SIP服务器并同时呼叫两个不同服务器上的号码，同一时间按单服务器注册、单路通话设计。替代建议： 1. 如业务需要对接两个平台，可在应用层做切换：按需注销当前服务器、注册到另一服务器后再发起呼叫（非同时在线）； 2. 或在服务器侧做汇接，由一个SIP账号接入、服务器转发到另一平台； 3. 多注册/多路通话的支持计划以官方后续固件版本说明为准，需求强烈可在官方企业微信群反馈。

44. air780EHV支持短视频上传吗？手册里有适配30万像素摄像头。

解答： Air780EHV适配30万像素SPI摄像头（如GC0310等），但当前只支持拍照（采集单帧图像并上传），不支持短视频录像/视频上传。说明与建议： 1. 可实现"定时拍照→图片经http/mqtt/AirCloud上传"的图像采集类应用； 2. 需要短视频/视频流的场景，请评估更高规格的音视频模组方案，选型参考https://docs.openluat.com/SelectionGuide/SelectionGuide/ 或咨询官方企业微信群； 3. 摄像头拍照用法见对应型号camera应用文档与demo。

45. 创建固件时提示固件名不存在是什么原因？

解答： 这是合宙iot平台（FOTA/远程升级）创建固件时的名称匹配问题。平台上每个项目由项目key（PRODUCT_KEY）唯一标识，固件名与项目存在绑定关系，创建设备固件时填写的固件名称必须与设备端代码/升级配置中使用的固件名完全一致，否则平台检索不到对应固件，提示"固件名不存在"。排查步骤： 1. 核对平台项目中的固件名与设备脚本里fota/ota初始化使用的固件名（及项目key）是否逐字一致，注意大小写、空格、前后缀； 2. 确认设备已正确绑定到当前项目（项目key对应），不要跨项目引用固件名； 3. 先在平台正确创建固件条目、上传升级包，再让设备请求升级。 FOTA配置与demo见https://docs.openluat.com/air780epm/luatos/app/ota/fota/ 。

46. Air8783的硬件看门狗用的是GPIO23吗？设备不重启运行多长时间能证明喂狗成功？

解答： 是的。Air8783板载一颗独立的外部硬件看门狗芯片，喂狗信号（WDI）连接在GPIO23上，LED状态指示在GPIO24。官方固件/示例脚本中默认不含喂狗动作，需要用户在自己的代码里定时翻转/脉冲GPIO23来喂狗；一旦程序跑飞、停止喂狗，看门狗超时后会自动拉复位重启设备。实现与验证： 1. 用gpio库配置GPIO23为输出，启动一个周期定时器（周期必须小于看门狗超时时间，留足余量），在定时器回调中翻转GPIO23输出脉冲； 2. 把喂狗定时器放在主业务逻辑正常运行的前提下喂狗——若关键任务卡死应停止喂狗，让看门狗复位； 3. 验证方法：人为在脚本中加一段"停止喂狗"的逻辑（或让任务死循环），设备应在看门狗超时时间内自动重启；正常持续喂狗时设备应长期不重启。实测正常喂狗后连续运行28分钟以上无复位即说明喂狗生效，建议按更长时间（如数小时/跨业务周期）持续观察。硬件原理见https://docs.openluat.com/air8783/product/ ，看门狗通用说明见https://docs.openluat.com/common/watchdog/ 。

47. Air8783怎么lua二次开发？

解答： Air8783是基于Air780ER2的USB上网棒产品，定位为免开发的RNDIS上网设备（Windows免驱），官方原则上不开放二次开发、产品本身也没有引出扩展接口。但因ER2与Air780EX2硬件方案一致，可借用Air780EPM的LuatOS固件体系做纯软件方式的二次开发（不依赖额外硬件接口），官方已提供基于该方式的短信转发示例工程。开发方式： 1. 参考官方工程air8783_sms_forwarder：https://gitee.com/openLuat/LuatOS/tree/master/module/Air780EPM/project/air8783_sms_forwarder ，工程基于Air780EPM固件目录构建； 2. 用Luatools按Air780EPM固件+自定义脚本下载到设备验证功能； 3. 注意该方式属于在无外接引脚的上网棒上做软件功能定制，无法使用未引出的外设。产品资料见https://docs.openluat.com/air8783/product/ 。

48. 固件我看写的是用Air780EPM的，是吗？

解答： 是的。Air8783基于Air780ER2，而ER2与Air780EX2硬件一致，做LuatOS二次开发时复用Air780EPM的固件体系（Luatools中按Air780EPM固件下载）。官方短信转发示例工程即放在Air780EPM工程目录下：https://gitee.com/openLuat/LuatOS/tree/master/module/Air780EPM/project/air8783_sms_forwarder ，可直接参考其固件选择方式和脚本结构。

49. 1602能添加到合宙iot平台的项目里吗？我试了一下报错不存在。

解答： Air1602是纯MCU产品，本身不带4G等蜂窝联网能力，不能像Cat.1模组那样直接作为独立联网设备添加到合宙iot平台项目——平台上创建/添加设备需要对应的通信模组身份，因此直接添加会报"不存在"。处理方式： 1. 先确认设备的联网通信方式：Air1602需通过外接通信模组（如4G模组）或网关接入平台，平台侧应添加实际负责联网的通信模组/网关设备； 2. 批量采购的模组在出库时可由合宙按客户账号批量绑定添加，请提供设备的MUID/IMEI清单和目标平台账号，由销售/商务在出库时自动添加到指定账号； 3. 具体绑定流程可在官方企业微信群提供账号信息和MUID，由工作人员协助处理。

50. 设备使用发短信功能，一次发400字节左右数据回复error 305，是什么意思？

解答： error 305表示短信发送失败。400字节远超单条短信容量：纯英文/数字（GSM7编码）单条最多160个字符，中文（UCS2编码）单条最多70个字符，超长内容必须靠长短信（多条拼接）发送。发送失败常见原因是固件版本较老不支持长短信自动拼接，或当前网络/卡商对长短信支持不好。处理建议： 1. 升级到较新固件（LuatOS自V2034版本起支持GSM7/UCS2自适应编码与长短信自动拼接），由协议栈自动拆分、接收端自动合并； 2. 若仍失败，在应用层主动把内容拆成多条（中文按约60~67字/条留余量）逐条sms.send发送； 3. 检查当前信号质量（RSRP）、SIM卡短信功能是否正常、卡是否欠费/关闭短信； 4. 400字节这种数据量更适合走TCP/MQTT传输，短信仅适合小数据量、高可靠通知场景。短信接口见https://docs.openluat.com/osapi/core/sms/ ，短信应用demo见https://docs.openluat.com/air780epm/luatos/app/common/sms/ 。

51. 780EHM不小心烧了8000T的脚本但没烧固件，有办法补救吗？

解答： 可以补救，无需返修。只是下载了别的型号的Lua脚本、底层固件（core）没有烧错，不会损坏模组： 1. 重新给780EHM下载正确的脚本即可覆盖错误脚本——Luatools中选择780EHM对应的固件和你自己的脚本重新下载； 2. 若因错误脚本导致USB不枚举、Luatools连不上，按强制下载模式操作：断电→Luatools点下载→按住BOOT→上电→长按开机键，开始下载后松开BOOT（参考https://docs.openluat.com/common/howtodown/ ）； 3. 下载时注意核对型号，避免再次选错固件/工程。

52. 插上USB之后luatools没反应，设备管理器没有多东西出来？

解答： 插上USB后设备管理器没有任何新设备出现，说明模组没有进入可枚举状态或没有正常开机/下载，按以下步骤处理： 1. 强制进入下载模式：断电，打开Luatools点下载，按住BOOT键不松开，再上电，然后长按开机键（PWRKEY）1~2秒，观察设备管理器是否出现端口（流程见https://docs.openluat.com/common/howtodown/ ）； 2. 检查USB线是数据线而非纯充电线，换一个USB口（优先直连电脑、不经Hub），确认供电5V/500mA以上； 3. 若出现带感叹号的未知设备，重装Luatools自带USB驱动； 4. 自底板还需检查USB_BOOT与VDD_EXT可短接强制下载、USB差分线（D+/D-）走线与焊接。

53. 510w支持10Hz定位吗？

解答： Air510W目前不支持10Hz定位输出频率（当前GNSS定位输出刷新率不支持到10Hz档位）。说明： 1. 定位数据输出速率以GNSS模组配置和固件支持为准，高频输出需求请在选型阶段确认； 2. 如项目对定位刷新率有明确要求（如高动态轨迹），建议在官方企业微信群说明具体应用场景，由工程师确认可支持的最高更新率或推荐合适的GNSS方案； 3. 相关GNSS型号资料可在文档站https://docs.openluat.com/ 对应产品页查阅。

54. 烧录时提示ack err，电脑端口识别到343了，怎么解决？

解答： 端口能识别（出现343下载端口）说明连接正常，下载过程报ack err属于下载通信/波特率问题——该类模组下载需要使用6Mbps下载波特率，波特率不匹配会导致握手应答失败报ack err。处理步骤： 1. 在Luatools下载设置中确认下载波特率为6Mbps（按工具默认高速档），不要人为降低到不支持的速率； 2. 检查USB线质量和长度、USB口稳定性，差线在高速下载时易丢包导致ack err，尽量用短的优质数据线直连电脑； 3. 若自底板USB走线较长或信号差，改善USB D+/D-走线、保证供电； 4. 重试下载，必要时重新进下载模式（断电→BOOT→上电→开机）。

55. 为什么设备开机想远程升级为平台上的版本，IOT平台总是提示已是最新版本不给升级？

解答： 平台提示"已是最新版本"，说明平台判定设备当前版本号不低于/不匹配目标升级版本，升级条件未满足。FOTA对版本号有严格规则，常见原因： 1. 版本号比较：设备上报的当前版本号与平台固件版本号比较后，平台认为无需升级（版本号未按规则递增、或目标版本号不高于当前版本）； 2. 升级包匹配：FOTA差分包由"当前版本→目标版本"两个固件生成，若设备实际版本与差分包的起始版本不一致，平台不会推送； 3. 设备上报版本号不正确（脚本中版本号定义/读取与实际烧录固件不符）。建议：严格按FOTA文档要求的版本号规则命名和递增，先用官方FOTA demo在两个明确版本间完整验证一次升级流程，再套用到项目，参考https://docs.openluat.com/air780epm/luatos/app/ota/fota/ 。

56. 刚接上时USB还正常，点底层+脚本下载时出现USB无法识别，怎么解决？

解答： 刚接上能识别、一点"底层+脚本下载"就掉成USB无法识别，通常是下载开始瞬间模组复位进入下载模式、USB重新枚举失败，或供电在下载大电流时跌落导致。按以下步骤处理： 1. 强制重新进下载模式再试：断电→Luatools点下载→按住BOOT→上电→长按开机键，开始下载后松开BOOT（https://docs.openluat.com/common/howtodown/ ）； 2. 供电是高频原因：底层下载瞬间电流较大，若USB口供流不足（劣质Hub、电脑前置口、充电线线阻大）会导致电压跌落、USB掉线，改用后置直连USB口、短粗数据线，或外接5V/1A以上电源； 3. 驱动问题：掉线后若出现未知设备/感叹号，重装Luatools自带USB驱动、升级到最新版Luatools； 4. 底层+脚本一起下载时间长、数据量大，可先单独下载底层core验证稳定，再下载脚本，定位是否某阶段掉线； 5. 自底板检查USB D+/D-走线、VBAT去耦和电源设计。

57. 这两个文件有什么区别呢？

解答： 因未看到截图中的两个文件名，LuatOS固件下载中最常见的"两个文件区别"有以下两类，可对照判断： 1. 底层固件（core）与脚本工程的区别：形如LuatOS-SoC_Vxxxx_Airxxxx的是底层core固件（含操作系统和驱动，需与型号对应）；另一类是用户Lua脚本工程（main.lua等业务代码）。二者分别下载、互不替代，core只需刷一次，脚本可反复更新； 2. 同型号不同编号的core固件（如14号、19/119号、21/121号）：区别在脚本区/文件系统空间大小和内置组件不同——例如19/119号脚本区1M字节+文件系统168K；21/121号脚本区704KB+文件系统256K，并移除中文矢量字库/CAN/FTP等、增加16号灰度点阵字库/TTS/Audio_v2等。查看方法：在Luatools中悬停或在文档站固件版本页对照文件名与说明，固件历史见对应型号固件版本页（如https://docs.openluat.com/air780egh/luatos/firmware/780egp_version/ ）。如仍不确定，可在官方企业微信群提供完整文件名确认。

58. 这个4G网卡驱动可以不用加载吗？项目中没用这个感觉4G网络也能正常工作。

解答： 可以不加载。netdrv_4g.lua是demo中提供的一个4G网卡示例驱动脚本，作用是监听网络状态事件（IP_READY/IP_LOSE）并把默认网卡设置为socket.LWIP_GP，用于需要RNDIS网卡转发、多网卡管理或明确网卡绑定的场景。说明： 1. 普通项目直接用socket/mqtt/http等API走4G通信时，协议栈会默认使用4G链路，不加载该文件网络也能正常工作； 2. 只有在涉及USB RNDIS网卡、多网卡切换或需要显式管理默认网卡的应用中才需要参考/加载它； 3. 不使用时从脚本列表中去掉该require即可，不影响联网。

59. 有的air780epm休眠后mqtt会反复上线离线，怎么回事？

解答： 休眠唤醒后MQTT反复上线/离线，本质是休眠期间网络连接断开、唤醒后连接重建与重连机制处理不当，或低功耗模式下网络驻留行为导致。排查方向： 1. 先升级到最新版固件（旧版本在低功耗/重连处理上可能有已知问题），在最新版本上复现验证； 2. 唤醒后需等待网络真正就绪（监听IP_READY事件/确认注网成功）再重建MQTT连接，不要在网络未恢复时立即重连； 3. 合理设置MQTT的keepalive与重连退避，避免连接未断透时频繁重连造成上下线抖动； 4. 确认所用低功耗模式（PSM/低功耗等级）与业务心跳周期匹配，过深的休眠可能导致服务器侧超时踢线； 5. 若仍复现，导出模组底层日志（含休眠/唤醒/注网/MQTT交互）结合mqtt库日志分析定位。

60. 合宙显示联网了但平台下发的指令模组收不到，有时来回联网，是什么问题？

解答： 显示联网但平台下发收不到、且连接来回波动，通常是MQTT链路实际不稳定（反复掉线重连）或订阅/网络就绪处理问题，"显示联网"只代表模组注网成功，不代表MQTT长连接稳定。排查步骤： 1. 升级到最新版固件先排除已知问题； 2. 导出底层日志和MQTT库日志，重点看MQTT是否反复disconnect/reconnect、订阅（subscribe）是否在每次重连后重新成功、设备是否在正确的topic上订阅； 3. 确认MQTT连接建立并订阅成功后再上报/接收，断线重连后必须重新订阅； 4. 检查信号质量（RSRP）、天线、SIM卡流量/欠费，弱信号会导致链路频繁中断； 5. 核对keepalive周期与运营商NAT超时，必要时缩短心跳保活。定位时建议先用官方mqtt demo在同一卡、同一环境对比验证。

61. 模组烧了的话会有什么现象吗？

解答： 模组因过压、反接、静电或IO过流等损坏后，常见现象有： 1. 完全开不了机：上电无任何启动电流/日志，按住下载模式也无法识别端口； 2. 异常发烫：上电后模组明显发烫，甚至远超正常工作温度，多为电源域或芯片内部损坏； 3. 部分损坏：个别管脚（IO/串口/电源脚）被打坏，模组可能仍能开机，但局部发烫、对应外设功能异常（如某路串口/I2C不通）； 4. 电流异常：待机电流明显偏大或短路（供电电源限流保护）。预防建议：严格按硬件手册设计电源（防反接、过压保护）、IO不超耐压（3.3V逻辑、不接5V）、做好ESD防护、调试时避免带电接线。出现硬件损坏需更换模组，无法通过软件恢复。

62. exaudio脚本是靠luatools里面的添加默认拓展库下载的吗？luatools不是自动更新吗？

解答： 是的。exaudio属于扩展库（V2音频框架），脚本中require "exaudio"后，通过Luatools下载时在"添加默认扩展库"中勾选/包含exaudio，Luatools会自动把对应扩展库文件一并下载到模组，无需手动找库文件。说明： 1. Luatools会随版本更新自带较新的扩展库，但建议保持Luatools为最新版，以确保扩展库与固件版本匹配； 2. exaudio为新音频框架（V2），接口和支持格式以官方文档为准：https://docs.openluat.com/osapi/ext/exaudio/ ； 3. 若下载后运行报找不到库，确认下载时确实勾选了exaudio扩展库且固件版本支持。

63. exaudio是有新框架嘛？

解答： 对，exaudio是新的音频框架（audio V2），相比旧版音频接口在播放/录音流程和多格式支持上做了重构。使用exaudio即可，播放支持MP3、WAV、AMR_NB、AMR_WB、PCM，录音支持AMR_NB、AMR_WB、PCM（不支持opus）。扩展库通过Luatools"添加默认扩展库"随脚本下载，接口说明与示例见https://docs.openluat.com/osapi/ext/exaudio/ 。

64. 物联卡不能连人联网域名IP 116.198.4.175被卡商拦截了，怎么办？

解答： 这是物联网卡的专网访问限制问题，不是模组故障。很多物联卡（尤其是定向APN卡）默认只能访问卡商白名单内的服务器地址，访问白名单外的域名/IP（如116.198.4.175）会被拦截。解决办法： 1. 联系物联卡售卡方/卡商，把你要访问的服务器域名（和IP）加入该卡的定向白名单（APN专网白名单），加白后即可访问； 2. 若服务器通过域名访问，白名单一般加域名，部分卡商需同时报备IP和端口； 3. 临时验证可用一张公网通用流量卡（全网通非定向卡）测试，确认链路本身正常； 4. 服务器侧尽量使用固定IP/稳定域名，避免频繁变更导致白名单失效。模组侧无需特殊配置，网络正常后直接用http/socket访问即可。

65. AIR8000A含税批量单价是多少？1000片也是45嘛？

解答： AIR8000A含税批量单价为45元，为统一价格，1000片批量同样按45元/片执行。说明：产品价格与促销可能随时间调整，下单前请以合宙官方淘宝店https://luat.taobao.com/ 实际标价为准；更大批量或长期供货的商务政策可联系合宙销售确认。

66. luatools更新完之后串口一直掉，是什么原因？

解答： 串口反复掉线一般不是Luatools工具本身导致，多为供电不足、USB线/口接触不良，或运行的脚本中有复位、休眠、重配串口等逻辑导致。建议交叉定位： 1. 先用Luatools下载官方默认固件（最简hello world脚本），观察串口是否还掉线——若不掉，说明是自身脚本问题（检查是否有pm休眠、pm.power、uart重复setup、异常重启wdt等逻辑）； 2. 若刷默认固件仍掉线，排查物理链路：换短的优质数据线、直连电脑后置USB口、确保供电5V/500mA以上，排除Hub和前置口； 3. 升级Luatools到最新版并重装驱动； 4. 结合掉线时机（下载时/运行时/休眠后）进一步判断，运行时掉线重点查脚本中的低功耗与重启逻辑。

67. AT+HTTPACTION=1啥数据都没有回复，网络状态良好的情况下回复也慢，怎么解决？

解答： 网络状态良好但AT+HTTPACTION=1无数据返回/响应慢，需要同时抓MCU与模组两侧串口数据定位是指令没发对、模组没回，还是HTTP请求本身慢。排查步骤： 1. 接线抓包：把MCU_TX、MCU_RX和模组_TX、模组_RX分别引出，用两个串口工具同时监听两侧收发，确认MCU发出的AT指令完整、正确（含AT+HTTPINIT、AT+HTTPPARA配置URL、AT+HTTPACTION=1的完整时序），以及模组实际回了什么； 2. 检查HTTP配置：确认URL正确（http/https、域名、端口、路径），HTTPS需配置SSL相关参数，目标服务器可达、响应快； 3. 响应慢多为服务器处理慢、DNS解析慢或网络时延，可换一个稳定的测试URL对比； 4. 确认模组HTTP流程状态机正确（每步等待OK/对应URC再发下一条），不要指令堆叠； 5. 将两侧完整日志（时间戳）提供给技术支持进一步分析。

68. 这边乱码是什么问题？

解答： 串口打印/通信出现乱码，最常见原因是波特率不匹配。模组串口默认波特率多为115200，请先把串口工具和模组uart.setup的波特率都设为115200（8数据位、无校验、1停止位）验证。其他排查点： 1. 确认串口工具波特率、校验位、停止位与模组配置一致； 2. 检查TX/RX是否交叉连接、是否共地； 3. 若用USB转串口模块，确认模块本身工作正常、驱动正确； 4. 中文乱码还需确认终端编码为UTF-8； 5. 若改过程序波特率，按实际设置值对应打开。

69. luatools更新弹更新失败，是什么原因？

解答： Luatools在线更新失败，多发生在版本跨度太大、更新包下载不完整或网络受限的情况下。解决办法： 1. 直接下载最新版完整安装包重新安装，而不是依赖在线增量更新：可在合宙文档站工具页面获取最新Luatools下载地址，或让合宙AI工具ai.luatos.com提供最新下载链接； 2. 安装前关闭旧版本Luatools，必要时卸载旧版再全新安装； 3. 安装/更新时关闭可能拦截的杀毒软件，确保网络可正常访问下载服务器； 4. 新版安装后会自动带最新USB驱动，可顺带解决部分识别问题。

70. 烧录提示core目录有空格怎么办？

解答： 该提示是因为底层固件（core）所在目录路径中含有空格或特殊字符（如中文、括号、多层路径），下载工具解析路径异常。解决办法：将core固件文件夹移动到简单的英文路径下再下载，例如直接放到桌面（或D:\luat\等短路径），确保文件夹全路径不含空格、中文和特殊字符，然后在Luatools中重新选择该路径的固件即可。

71. AT指令AT+CCED=0,1和AT+ECSTATUS查询出来的RSRP哪个更准确？

解答： 以AT+CCED=0,1返回的RSRP为准。AT+CCED=0,1查询的是小区信号测量信息（包含RSRP/RSRQ等），反映当前服务小区的实时信号质量；AT+ECSTATUS返回的工程状态信息中信号字段口径与CCED不同。做信号质量判断、天线/部署评估时，建议统一采用AT+CCED=0,1的RSRP数值。

72. AT+CCED=0,1查询的值是-140还是-156？

解答： AT+CCED=0,1返回的RSRP有效下限按-140dBm口径计算（即信号极弱时RSRP趋近-140dBm）。信号强度参考：RSRP约-80dBm及以上为很好，-90~-100dBm为中等可正常通信，接近-110dBm以下为弱信号、易掉线，-140dBm附近基本无有效服务。项目中做信号阈值判断时按-140dBm作为量程下限处理即可。

73. http文件下载处理在回调中，判断标志后return退不出回调还会继续接收数据，有什么办法停止下载？

解答： 结论：LuatOS的http核心库没有取消/中止下载的API（不存在http.cancel/stop/abort之类接口）。http.request是阻塞式调用，会一直占住当前task直到本次请求完成、失败或超时；opts.callback只是下载进度/数据回调，在回调里return仅结束本次回调，不会中断底层继续接收数据。可行的处理方式： 1. 用opts.timeout设置合理超时，到时间请求自动结束并返回，避免无限等待； 2. 不需要文件内容时用opts.dst把响应直接落盘到文件，回调里只做进度判断、不缓存body，下载结束后如判定不需要再删除文件，避免占用内存（内存方式body上限约32KB，大文件必须落盘）； 3. 把http.request放在独立task中执行，需要"忽略结果"时让该task自行结束，主业务不等待其返回值即可； 4. 若需要更精细的下载控制（分段、可控停止等），可使用httpplus扩展库或改用socket自行实现HTTP下载流程。 http接口说明见https://docs.openluat.com/osapi/core/http/ 。

74. HTTP文件下载速度可以降低吗？调整了TARGET_KBPS从50改到100实际速度还是50。

解答： 需要明确：TARGET_KBPS不是LuatOS官方http库的参数（官方API中没有这个常量），它是你所用demo脚本里自定义的一个限速变量，改它是否生效取决于demo自己的限速逻辑如何实现；而且实际下载速率主要受4G网络实时带宽、信号质量、服务器响应和限速算法精度影响，软件限速只能做到"大致不超过目标值"，不会精确等于设定值（设100实测约90KB/s属正常现象）。建议： 1. 若限速不生效，检查demo中TARGET_KBPS是否真正被限速逻辑引用（例如通过延时/分片控制接收节奏），而不是定义了未使用； 2. 软件限速本身不精确，网络空闲时实际速度会在目标值附近波动； 3. 若要可靠限速或更稳定的下载控制，建议在应用层按分片接收+定时控制节奏，或用httpplus扩展库/自行用socket实现。 http接口见https://docs.openluat.com/osapi/core/http/ 。

75. 780EHU自制板子挂GC0310摄像头出现这种黑边，遇到过吗？

解答： 摄像头画面出现黑边/花边，多为SPI图像数据信号完整性问题或接触不良，而非摄像头本身损坏。GC0310这类SPI Camera在时钟频率较高、走线较长时，SPI时钟线（spiclk）信号反射/过冲会导致采样到的图像边缘异常。已验证有效和推荐的处理措施： 1. 在SPI时钟线spiclk上串联一个约22Ω电阻（靠近模组端），抑制信号反射，实测可解决黑边问题； 2. 检查摄像头排线/FPC座焊接与接触是否良好，重新插拔、加焊； 3. SPI走线尽量短、等长、少过孔，数据线和时钟线包地处理； 4. 软件上可适当降低camera初始化时的SPI时钟速度（cspi_speed参数），降速验证是否改善，稳定后再权衡帧率； 5. 确认供电电压稳定、干净（摄像头模拟/数字电源去耦到位）。摄像头最高支持30万像素，型号支持与接口见对应型号camera应用文档。

76. 780EVT模组可以热启动吗？设备开机状态插入SIM卡会导致SIM卡损坏不？

解答： 支持SIM卡热插拔，开机状态下插拔SIM卡不会损坏SIM卡。说明： 1. LuatOS支持SIM热插拔检测（mobile应用提供热插拔功能，需按文档配置检测管脚/使能），插回卡后模组可重新识别并注网； 2. 即使不配置热插拔，热插拔SIM本身也是安全的，不会烧毁卡或模组，只是不配置时可能需要重启或重新初始化才能识别新卡； 3. 热插拔功能的具体管脚要求和使能方式见对应型号mobile应用文档。

77. USB高低温测试到50℃就不识别了，-50℃没问题，可能是什么原因？

解答： 高温（约+50℃）USB不识别、低温正常，通常是外围电路器件的温度特性问题，而非模组主芯片：USB D+/D-通路上的ESD保护器件、上拉/匹配电阻、USB座、LDO或时钟器件在高温下参数漂移，可能导致USB枚举失败。排查建议： 1. 重点检查USB差分线上的ESD/保护器件和电阻电容，选用温漂小、工业温度范围合格的器件，可临时去掉ESD器件对比验证； 2. 检查给USB/晶振供电的电源器件在高温下是否输出跌落； 3. PCB走线、焊接在高温热胀下是否有虚焊/接触不良； 4. 确认所用器件额定温度覆盖整机工作温度范围（工业级-40~+85℃）； 5. 用官方核心板在同样高温环境下对比，若核心板正常则可锁定为自底板外围设计问题。

78. 我发的时间都是1969年是什么原因？时间戳用的os.time()。

解答： 时间显示1969年（时间戳接近0）说明模组还没有完成网络对时。LuatOS开机后系统时间默认为起始时间（1969/1970年基准），os.time()取的是系统时间，只有在联网成功并完成SNTP/NTP网络对时后，系统时间才会被校准为真实时间。解决步骤： 1. 先确保模组注网成功、可正常联网（等待IP_READY/网络就绪）； 2. 调用socket.sntp()发起网络对时，对时成功会产生NTP_UPDATE事件； 3. 在收到NTP_UPDATE（对时完成）之后再使用os.time()/os.date()取时间上报，避免取到未校准的基准时间； 4. 也可调用socket.ntptm()读取同步后的时间信息。完整时间同步说明见https://docs.openluat.com/common/time_sync/ 。

79. AIR780EGP模块可以在120摄氏度稳定工作吗？

解答： 不能在120℃环境下使用。Air780EGP这类Cat.1模组的正常工作温度范围为-40℃~+80℃（工业级温区），120℃已远超规格上限，无法保证稳定工作，且可能造成永久性损坏。建议： 1. 具体型号的温度规格、存储温度等指标以该型号产品手册/规格书为准，高温场景请在文档站对应型号产品页核实参数； 2. 若整机环境温度可能达到120℃，应做散热/隔热设计，使模组本体温度控制在规格范围内，或选用更高温等级的方案； 3. 对温宽有特殊要求，请在官方企业微信群提供具体应用工况确认。

80. 780EPT使用AT指令配置休眠后不休眠，怎么配置？

解答： AT型号（Air780EPT等）配置低功耗休眠使用AT+POWERMODE指令。要点： 1. 设置低功耗模式，如AT+POWERMODE="PSM+",2,1可进入PSM+（PRO）低功耗模式；第三参数控制唤醒周期行为（设为1可快速唤醒，设为0时约54分钟周期唤醒一次）； 2. 进入休眠还需满足硬件条件：USB断开（USB插着通常不允许深睡）、无数据收发、网络允许进入省电状态； 3. 配置后用AT+POWERMODE?查询当前模式，结合测量待机电流确认是否真正进入低功耗； 4. 注意休眠后唤醒方式（数据/短信/定时唤醒）与业务匹配。 AT低功耗指令详细参数见https://docs.openluat.com/atmozu/product/command/lowpower/ 。

81. Air724UG新买的模块烧录程序后能正常联网，但联网指示灯和SIM卡检测灯不亮，固件变了吗？

解答： 能正常联网说明模组工作正常、固件无问题，指示灯不亮是网络状态灯（NETLIGHT类）和SIM检测灯的控制脚未被驱动或硬件灯回路问题，而非"固件变了"。这类状态指示灯一般由特定GPIO（如NETLIGHT管脚）按网络状态输出闪烁/电平来驱动，需要软件/固件主动控制。排查步骤： 1. 查硬件资料确认联网指示灯、SIM检测灯对应的控制管脚及有效电平（是高电平点亮还是低电平点亮），以及灯的供电路径、限流电阻是否焊接正常； 2. 确认当前固件/脚本是否配置了该管脚为输出并按网络状态翻转——AT固件与LuatOS固件对指示灯管脚的默认处理可能不同，若刷的是不带灯控逻辑的脚本，灯不会亮； 3. 二开脚本中可用gpio库手动控制对应管脚：联网成功后按节奏翻转网络灯，SIM就绪后点亮SIM灯，验证灯本身是否完好； 4. 若手动拉高/拉低管脚灯仍不亮，排查LED、限流电阻、供电和焊接； 5. 管脚复用被其他功能占用也会导致灯不亮，检查管脚是否被配置成了其他功能。 Air724UG的管脚定义以对应型号硬件资料为准，可在文档站https://docs.openluat.com/ 查阅或在官方企业微信群确认。

82. 现在想做一个个人美牙仪项目，需要远程收集使用时间和位置并上传服务器，选什么型号？

解答： 需求为"4G通信+GNSS定位+数据上传服务器"，应选带GNSS的Cat.1型号，按开发方式选择： 1. LuatOS二次开发（Lua脚本，灵活、可自定义采集和上报逻辑，推荐用于此类终端）：选Air780EGP（小存储）或Air780EGH（大存储）； 2. AT指令开发（外接MCU驱动）：选Air780EG2（小存储）或Air780EGT（大存储）。实现方式：GNSS定位通过exgnss库获取经纬度（AT型号用对应AT指令），使用时长由本地计时/记录，再通过socket/MQTT/HTTP把位置和时长数据上传到自建服务器或合宙iot平台。完整型号对比与选型请参考合宙选型指南https://docs.openluat.com/SelectionGuide/SelectionGuide/ ，定位库见https://docs.openluat.com/osapi/ext/exgnss/ 。

83. 现在780E什么价格？

解答： Air780E仍在正常供货，具体实时价格以官方渠道标价为准（产品价格随市场和活动调整，不在此报固定价格以免误导）： 1. 样品/小批量：合宙官方淘宝店https://luat.taobao.com/ 查看Air780E（及核心板/开发板）实时单价并直接下单； 2. 批量采购、含税价和长期供货价：联系合宙销售或官方企业微信群获取报价； 3. 新立项项目也可对比升级款Air780EPM（资源更强、同封装），选型与价格对比见https://docs.openluat.com/SelectionGuide/SelectionGuide/ 。

84. 724UG支持VOLTE通话吗？

解答： VoLTE通话能力与模组型号、固件版本及当地运营商VoLTE网络支持有关。Air724UG在满足运营商VoLTE网络条件、使用支持语音的固件时可进行VoLTE语音通话；实际是否可用建议直接用开发板飞线搭建最小语音链路（接听筒/麦克风音频通道、插支持VoLTE的SIM卡）拨打测试验证。验证要点： 1. 确认所用固件版本支持VoLTE/语音功能，SIM卡已开通VoLTE且当地运营商网络支持； 2. 按硬件资料接好音频输入输出（MIC/SPK）后做拨打/接听测试； 3. 具体AT指令或LuatOS语音接口、固件版本以对应型号文档和demo为准，必要时在官方企业微信群提供固件版本号确认语音支持情况。

85. Air780核心板烧录固件和脚本用串口就可以吗？

解答： Air780系列核心板烧录固件（core）和Lua脚本统一使用USB口，不使用普通UART串口。USB数据线连接电脑后枚举下载端口，Luatools通过该端口完成固件与脚本下载，日志也走USB虚拟串口；UART串口用于和外接MCU通信。若USB无法识别，可短接USB_BOOT与VDD_EXT后上电强制进入下载模式，或按BOOT+上电+开机键流程操作（https://docs.openluat.com/common/howtodown/ ）。

86. 支持AT命令的模组有哪些？air8000不支持AT命令。

解答： 合宙Cat.1模组按开发方式分为LuatOS二次开发（Lua）和AT指令两类，二者分属不同型号、固件不通用，没有同一型号同时支持AT和LuatOS二开。 1. AT指令型号：Air780EPT（小存储）/Air780EHT（中存储）/Air780EVT（大存储）、带定位的Air780EG2（小存储）/Air780EGT（大存储），以及Air700ECT、Air780EX2T等AT型号；AT指令手册见https://docs.openluat.com/atmozu/product/shouce/ ； 2. LuatOS二次开发型号：Air780EPM/EHM/EHV、带定位的Air780EGP/EGG/EGH、海外Air780EHN/EHU，以及Air8000等； 3. Air8000确为LuatOS二次开发型号，不提供AT固件，需要AT开发请选用上述AT型号。具体型号的存储规格、定位/语音等功能差异，请以合宙选型指南https://docs.openluat.com/SelectionGuide/SelectionGuide/ 和文档站对应型号产品页为准。