常见问题 - 2026-09-04
数据日期：2026-09-04
1. Air8783自定义Webhook为什么不生效？
解答： 结论：Air8783没有独立的"自定义Webhook"指令，对接自有HTTP接口应使用QIWEI（企业微信）指令，该通道无加签校验，可作为通用Webhook使用，并支持custom_headers自定义请求头。不生效通常是指令格式、密码、网络或服务器侧的问题。
原因与排查步骤：
1. 配置指令格式必须为 密码#CMD#参数JSON，默认密码123456，例如：123456#QIWEI#{"webhook":"https://your-server/hook","custom_headers":{}}；密码错误设备会直接丢弃且不回执，JSON格式错误会回执"【配置失败】JSON格式错误"。
2. 推送到Webhook属于HTTP请求，消耗的是SIM卡的4G流量：请确认设备中插入的是支持4G联网的手机SIM卡（物联网卡不适用）、已安装4G天线且信号正常，设备处于可上网状态。
3. 确认服务器地址可从公网访问、支持POST JSON、证书有效（建议先用HTTP或标准企微机器人地址验证链路，再切换到自有HTTPS地址），并在服务端查看是否收到请求，以区分是设备未发出还是服务器未接收。
4. 发送 密码#GETCFG#{} 让设备回执当前全部配置，核对webhook是否已正确写入；配置保存在fskv中，重启不丢失。
5. 建议先用官方"Air8783配置指令生成工具"生成指令，避免手工拼写错误。
配置指令集、示例与在线生成工具见官方说明：https://docs.openluat.com/air8783/product/config/
2. 网站Web应用上传文件后刷新就没了，怎么解决？
解答： 结论：这是网页端文件列表未即时刷新导致的显示问题，文件上传成功后已保存在平台服务器上，并不会因刷新页面而丢失。
原因与处理步骤： 1. 平台Web页面的"资源列表"在上传完成后偶发不自动刷新，此时可退出该页面后重新进入，或清空浏览器缓存后重新登录，列表即会显示已上传的文件。 2. 可通过"下载"或在设备端拉取该文件的方式验证文件确实存在、内容完整，不必重复上传。 3. 若重新进入后文件仍不存在，说明上传当时未成功（如网络中断、文件超限），请按页面提示的格式与大小要求重新上传。 4. 若确认上传成功但列表长期不显示，可截图保留操作时间与文件名，通过官方企业微信群反馈平台侧排查。
合宙IoT平台入口：https://iot.openluat.com/
3. Air8000A BLE和WiFi并存会有影响吗？
解答： 结论：可以并存，BLE与WiFi由同一颗无线芯片提供，属于"伴生关系"，同时开启不会互相冲突；但该芯片与4G主控之间通过SPI接口运行自研AirLink协议通信，实际使用时需注意BLE侧的能力限制。
原理说明： 1. Air8000的A/AB/U/N/W版本内置两颗芯片：一颗4G主控、一颗WiFi/BLE芯片，WiFi与BLE在同一颗芯片上，可同时工作；D/DB版本不含WiFi/BLE。 2. BLE当前已知限制（以官方文档为准）：同一时间仅支持连接1个从设备；发射功率固定为6dBm（空旷距离约10米）；MTU固定为256字节，超出部分需自行分包处理；接收数据不做缓冲，数据到达即触发回调事件；接收灵敏度约-97dBm。 3. WiFi进行大流量吞吐时会占用同一颗芯片与SPI带宽，建议BLE侧避免同时进行高频大数据量交互，必要时在应用层做收发节奏控制与超时重发。
硬件设计说明：https://docs.openluat.com/air8000/luatos/hardware/wifi&ble/ BLE接口与限制说明：https://docs.openluat.com/osapi/core/ble/
4. Air8000W核心板插上电脑识别不到模块端口，怎么办？
解答： 结论：识别不到端口绝大多数是供电与开机时序、USB线缆或驱动问题，按以下顺序排查即可定位。
排查步骤： 1. 确认上电方式：核心板接上USB后需按一下开机键，模块才会开机并枚举端口；观察电源指示灯是否亮起。 2. 更换USB线与USB口：部分线材仅含充电线序不含数据线，建议更换为确认可传数据的短线，并直连电脑USB口，避免使用劣质HUB。 3. 确认驱动：安装并打开Luatools，软件会自动安装/修复USB转串口驱动；在Windows设备管理器中查看是否出现Luat USB虚拟端口，若端口带黄色感叹号请重新安装驱动，也可换一台电脑交叉验证。 4. 若正常开机仍不枚举，使用强制BOOT下载时序：先按住BOOT键不松，再按开机键并给模块上电，待Luatools提示检测到设备后再松开BOOT键，顺序不要颠倒。 5. 排查时请保留Luatools完整界面截图（含日志区），便于官方支持渠道进一步定位。
Luatools下载与使用教程：https://docs.openluat.com/common/Luatools/
5. Air780EHM模块引脚103是否需要接地？
解答： 结论：PIN103必须悬空、不做任何连接，既不要接地也不要接电源或信号，否则可能影响模块正常工作甚至损坏。
依据与说明： 1. 该结论出自官方《合宙 Air780EPM/Air780EHM 硬件手册 V1.4》管脚定义表，表末明确列出"悬空,不接"的管脚清单：PIN2/3/4/5/6/8/21/44/68/69/74/75/87/98/103/104/105/108/109，PIN103在清单内。 2. PCB设计时该焊盘保留即可，不要铺铜连接、不要打过孔接地；若底板已误接，请割断走线后再上电验证。 3. 邻近管脚设计时也请注意区分：PIN100为GPIO17/IO_Volt_Set（悬空为3.0V电平域、接地为1.8V，软件推荐用pm.iovol配置），PIN101为WAKEUP0（仅中断输入），PIN102为GPIO20（AON_GPIO），均不可与PIN103混淆。
硬件手册与管脚资料下载入口：https://docs.openluat.com/air780epm/product/shouce/
6. Air780EG2的付费LBS定位不行，请求超时，1PPS灯不亮，怎么排查？
解答： 结论：LBS基站定位与GNSS卫星定位是两套相互独立的系统，"LBS请求超时"和"1PPS灯不亮"要分别排查；1PPS灯只在GNSS完成定位后才输出脉冲。
排查步骤： 1. LBS（基站定位）方向：先确认SIM卡已注网且能上网（AT+CGREG?、AT+CGATT?），LBS请求需要把基站信息通过4G上传到定位服务器；付费LBS还需确认账号/套餐有效、KEY等鉴权参数配置正确，欠费或参数错误会表现为请求超时。 2. GNSS方向：用AT+CGNSPWR=1确认GNSS电源已开启，执行AT+CGNSSEQ="RMC"、AT+CGNSINF查看定位状态；1PPS在未完成首次定位前不输出属正常现象。 3. 天线与环境：确认GNSS天线（注意EG2为有源天线方案）已可靠连接、供电正常，并在靠窗或室外露天环境测试，室内、金属遮挡下可能长时间无法定位。 4. 将模块固件升级到官方最新版本后复测；若LBS在网络正常、账号有效时仍持续超时，保留AT交互日志通过官方支持渠道反馈。
AT指令手册与固件下载见Air780EG2产品文档：https://docs.openluat.com/atmozu/product/shouce/
7. Air8000核心板插USB有电流声、芯片发烫、不开机不识别端口，是不是烧坏了？
解答： 结论：出现电流声、芯片明显发烫且无法开机时，说明链路上存在异常大电流，大概率是模块或底板电源短路/反接、引脚误接所致。此时必须立即断电，避免故障扩大，再按下列步骤判定。
排查与处置步骤： 1. 立即断开USB与一切外部供电，不要反复上电尝试。 2. 用万用表检查电源与GND之间是否短路、供电极性是否接反、电压是否为规格范围内；逐路检查底板是否有焊接连锡、异物或损坏的外围器件。 3. 拆掉所有自定义外围连线，仅保留核心板本体，更换USB线和电脑后单独上电测试；若核心板本体仍发烫不开机，可基本判定模块硬件损坏。 4. 硬件损坏无法通过软件方式恢复，请联系购买渠道（淘宝客服或官方企业微信群）按售后政策检测维修；若仍在保修期内，可申请保修处理，过保设备由售后评估维修可行性。
选购与售后入口：https://luat.taobao.com/
8. 有没有Air780E带TTS_ONCHIP后缀的固件？
解答： 结论：LuatOS固件按功能划分为多个"功能固件"，TTS_ONCHIP表示把中文TTS语音合成引擎编译进core、运行时无需外挂TTS资源文件的固件版本。是否提供此后缀的Air780E固件，以Luatools固件下载列表和Air780E产品资料页实际发布的文件为准，历史上不同批次固件命名会有调整，不建议凭第三方教程中的旧文件名找固件。
获取与确认步骤： 1. 打开Luatools，在"固件下载"中选择模块型号Air780E，查看官方当前发布的全部固件，关注文件名/更新记录中含"TTS"字样的条目；Luatools列出的即为官方仍在维护的版本。 2. 如列表中没有TTS版本，可查看Air780E产品资料中心的"固件版本"页面确认，或通过官方企业微信群说明需求（所需TTS场景、Flash容量）由官方确认可用版本。 3. 若项目以语音播报/TTS为核心需求，建议直接选用主打语音的型号Air780EHV（内置Audio Codec，硬件支持1路Mic和1路Speaker，固件支持TTS/VoLTE），免除外挂Codec与固件功能裁剪的问题。
Air780E资料中心：https://docs.openluat.com/air780e/ Air780EHV硬件手册（含TTS/VoLTE能力说明）：https://docs.openluat.com/air780ehv/product/shouce/ Luatools下载与使用：https://docs.openluat.com/common/Luatools/
9. Air8000的demo中readme使用说明与实际demo不同步，如何解决？
解答： 结论：以官方代码仓库中最新demo代码和在线文档为准。demo随固件持续迭代，压缩包或教程截图中的readme可能滞后，出现文件名、接口或步骤不一致时，不应照搬旧readme。
处理步骤： 1. 从官方LuatOS代码仓库获取Air8000对应demo的最新版本，直接查看仓库内的main.lua、库文件和目录结构，以代码实际调用的接口为准：https://gitee.com/openLuat/LuatOS/tree/master/module 2. 对照在线文档中心Air8000章节的对应功能教程（文档随版本更新），核对初始化流程、依赖库（如require列表）和参数说明：https://docs.openluat.com/air8000/ 3. 注意core固件与demo脚本的版本配套：新demo可能依赖新版固件才有的接口，建议将core升级到官方最新稳定版后再运行最新demo。 4. 若确认是readme或文档本身的描述错误，可通过官方企业微信群反馈具体页面链接与差异点，由官方修订；开发中遇到的接口疑问也可在群内获取支持。
10. 程序写重启后按Boot也下载不了固件怎么办？
解答： 结论：即使应用脚本导致模块不断重启，BOOT（下载）模式仍由底层固化的引导程序响应，与用户脚本无关，进入BOOT模式即可强制下载；关键是严格遵守上电时序并保证USB连接可靠。
操作步骤： 1. 推荐操作顺序：在Luatools中先选好固件/脚本并点击"下载"，然后让模块断电，按住BOOT键不松→给模块上电（或按开机键），待Luatools日志提示检测到下载设备后再松开BOOT键。 2. 检查USB链路：使用确认可传数据的USB短线直连电脑，避开HUB和延长线；必要时更换USB口或电脑，并确认Luatools驱动安装正常。 3. 供电要充足：USB口供电能力不足会导致进入下载模式后掉线，建议使用带外部供电的开发板/核心板或独立4V电源供电。 4. 可用一块正常的合宙核心板在同一电脑、线缆上做对比测试：核心板能下载即说明工具与电脑正常，问题在故障板的供电或接线。 5. 若设备曾因刷机中断变砖，可尝试将BOOT引脚外部拉高到3.3V强制进入BOOT模式后重新烧录。
固件烧录故障排查：https://docs.openluat.com/common/howtodown/ Luatools教程：https://docs.openluat.com/common/Luatools/
11. Luatools收到的信息可以在其他串口工具收集吗？没有流量能把4G关掉只收短信吗？
解答： 结论：这是两个独立问题，答案不同——（1）模块的日志/trace信息本质是串口数据，可以用其他串口工具收集，并非只能用Luatools；（2）短信不走流量通道，没有流量只要SIM卡未停机且正常注网就能收发短信，也不需要"关掉4G"。
问题一：用其他串口工具收集日志 1. Luatools看到的运行日志来自模块主串口（main_uart，多数型号为UART1）的trace输出，任何串口工具（SSCOM、LLCOM等）选择对应COM口、按文档要求的波特率连接即可接收；AT开发模式下波特率通常为115200。 2. Luatools还提供"通用串口打印"功能，适合不方便使用完整Luatools界面的场景。 3. 注意不要同时让Luatools和其他工具占用同一COM口，串口同一时间只能被一个程序打开。
问题二：无流量时只收短信 1. 短信和基站授时走的是运营商信令通道，不消耗数据流量；官方FAQ已明确：正常手机卡在未停机状态下，流量用尽仍可收短信和授时（物联网卡本身多为无短信业务的卡种，需先向卡商确认卡支持短信）。 2. 不需要关闭4G：保持模块正常注网即可接收短信；只要业务脚本不主动建立数据连接（不发起socket/MQTT/HTTP等），就不会产生流量。也可在脚本中不调用联网相关接口，或按需通过mobile接口控制数据拨号。
Luatools工具教程（含通用串口打印）：https://docs.openluat.com/common/Luatools/
12. 模组PCB焊盘的坐标怎么算？没有纵坐标。
解答： 结论：不建议自行按焊盘坐标画封装，坐标应相对封装原点（一般为模组本体几何中心或1脚定位点）成对给出X/Y，只拿到横向坐标无法手工还原。官方在产品资料页直接提供了可导入的PCB封装库文件，直接取用即可保证坐标、焊盘尺寸与钢网开孔准确。
操作步骤： 1. 进入对应模组产品资料中心（"产品手册/硬件设计"栏目），下载官方封装文件：合宙提供立创EDA（EasyEDA）格式封装，可直接在立创EDA中导入使用；同时提供PADS等其他EDA格式文件。 2. 若所用EDA软件不在官方提供格式内，可先导入立创EDA再导出为中间格式（如DXF），或依据硬件设计手册中的封装尺寸图（含X/Y坐标与公差）在软件中按封装原点重新绘制。 3. 务必同时参考手册的推荐钢网与推荐焊盘尺寸，避免只按丝印画图导致虚焊或连锡。
以Air780EPM/EHM为例，硬件手册与封装资料入口：https://docs.openluat.com/air780epm/product/shouce/
13. OTA升级包有Linux端的生成工具吗？
解答： 结论：官方的差分包/整包升级包制作功能集成在Luatools中，而Luatools官方仅支持Windows 10及以上系统，不支持macOS和Linux，目前没有发布Linux端的升级包生成工具。
说明与建议： 1. 差分升级包的制作方法：在Windows环境用Luatools选择"差分包/整包升级包制作"，分别导入升级前、升级后的两个.soc固件文件，工具即生成用于FOTA的.bin差分升级包。 2. Linux/macOS环境下的可行方案：使用Windows虚拟机（如VMware/VirtualBox运行Win10及以上）安装Luatools制作升级包；或准备一台Windows电脑在发布环节统一出包。 3. 升级包本身与操作系统无关，制作完成后上传到合宙IoT平台或自建HTTP升级服务器即可，设备侧下载、校验、烧录流程不受影响。 4. 如需在CI/CD流水线上自动出包，可将Luatools安装在Windows构建节点或Windows容器中调用；官方未提供可替代的Linux命令行差分工具，请勿使用来历不明的第三方工具，以免差分包不被模组校验接受。
Luatools运行环境与升级包制作教程：https://docs.openluat.com/common/Luatools/ FOTA升级说明：https://docs.openluat.com/luatos_lesson/009_luatos_fota/
14. 缺少aircloud.zip资源包，在哪里下载？
解答： 结论：官方没有单独发布名为aircloud.zip的独立压缩包，AirCloud示例是LuatOS代码仓库中的一个demo工程，应从官方Gitee仓库直接获取整套demo目录使用。
获取步骤： 1. 打开官方LuatOS仓库对应型号的demo目录（以Air780EPM为例）：https://gitee.com/openLuat/LuatOS/tree/master/module/Air780EPM/demo/aircloud ，目录中包含数据上报（aircloud_up）、图片上传（image）、运维日志（mtn）等示例工程。 2. 在Gitee页面可直接下载整个仓库，或只复制该demo目录下的main.lua及所需库文件到本地工程；使用时请连同demo依赖的库文件一起拷贝，不要只取单个文件。 3. AirCloud对应用的扩展库为excloud，API说明见：https://docs.openluat.com/osapi/ext/excloud/ ；数据上报功能教程见：https://docs.openluat.com/air780epm/luatos/app/base/aircloud_up/ 4. 使用前在合宙IoT平台（https://iot.luatos.com/ ）创建项目并获取PRODUCT_KEY，填入脚本后设备才能完成鉴权与数据上报。
15. 合宙IoT平台资源列表与教程不一致，找不到对应文件怎么办？
解答： 结论：平台资源会随版本调整命名或目录，教程截图可能未同步更新，遇到不一致时以当前页面实际提供的文件和在线文档为准即可，不影响资源本身的使用。
处理步骤： 1. 以功能为线索在当前资源列表中查找：教程中提到的文件可能已改名或合并，可按文件类型（如.soc固件、.lua脚本、.md说明）和更新日期辨认最新版本。 2. 优先阅读页面内随资源附带的md说明文件，其内容通常比外部教程截图更新；也可对照在线文档站对应型号的教程章节操作：https://docs.openluat.com/ 3. 固件类资源建议直接以Luatools"固件下载"列表中的最新版本为准；示例代码以Gitee官方仓库为准：https://gitee.com/openLuat/LuatOS/tree/master/module 4. 若确认存在资源缺失或链接失效，可记录平台页面链接、资源名称与教程链接，通过官方企业微信群反馈，由平台侧补充更新。
合宙IoT平台入口：https://iot.openluat.com/
16. 8202活动测试账号被挤下线无法使用怎么办？
解答： 结论：活动演示账号为公共账号，同一账号在同一时间只允许一处登录，其他人登录会把先前会话挤下线，这是正常的账号单点登录限制，并非平台故障。
处理方法： 1. 稍等片刻后重新登录即可，建议避开体验高峰时段，或多尝试几次以获取登录会话。 2. 登录后尽快完成"查看设备状态"等需要验证的操作，避免长时间挂线占用公共账号。 3. 如果自己已有Air8202设备，建议注册并使用自己的合宙账号、在自己账号下创建项目并绑定设备IMEI，数据、设备状态与后续的远程升级都归属本人，不受公共账号互踢影响。 4. 若按活动教程开发网页，演示账号仅用于验证登录与设备状态查看流程，正式提交作品应使用自有账号下的设备数据。
合宙IoT平台：https://iot.openluat.com/ ；活动公告见：https://docs.openluat.com/hezhou_publish/
17. 上传应用是用公用账号吗？
解答： 结论：不要使用任何公用账号。向合宙IoT平台上传脚本/资源、创建项目、绑定设备、推送FOTA升级等操作，都必须使用自己注册的账号，且设备IMEI需要归属在本人账号的项目下。
原因与操作说明： 1. 平台的项目、设备、资源与升级任务都是按账号隔离的。公用账号下的项目任何人都可能改动，容易导致设备被他人绑定、资源被删、升级被误触发，无法保证设备安全和业务稳定。 2. 正确流程：注册并登录自己的合宙账号 → 新建产品/项目获取PRODUCT_KEY → 在项目中添加设备IMEI → 在脚本中填入自己项目的PRODUCT_KEY → 上传脚本/资源并发布升级。 3. 设备的账号归属直接决定FOTA能否下发：设备必须在操作者本人账号名下，平台才会向其推送升级任务；若设备已在他人账号下，需先按设备归属转移流程处理。 4. 活动教程中出现的演示账号（如Air8202活动账号）仅用于网页登录演示和设备状态查看体验，不用于正式的应用上传与设备管理。
平台入口：https://iot.openluat.com/ 设备归属与转移说明：https://docs.openluat.com/air780epm/product/attributioniot/
18. 如何把一部分C代码编译进core？
解答： 结论：LuatOS的core是合宙用C语言编译发布的底层固件，用户无法自行把C代码编译进官方core；常规开发应使用Lua脚本实现业务逻辑。确有必须以C实现的功能（如高频算法、自研外设驱动），可向合宙提出定制需求，由官方评估后编译进固件。
原理与处理方式： 1. LuatOS采用"core固件 + script脚本"两层结构：core包含RTOS内核、协议栈和已内置的C模块，用户脚本运行在Lua虚拟机中，随脚本可直接require官方提供的各类扩展库，绝大多数功能无需改动core。 2. 自行编译core需要完整的芯片SDK、编译环境与官方源码适配，官方未对普通用户开放该流程，自行刷入非官方core也会失去固件兼容与升级保障。 3. 需要定制时，请通过官方企业微信群或商务渠道提交需求，内容包括：模块型号、期望新增的C功能、应用场景、性能/实时性要求、预期出货量等，由合宙评估技术可行性与排期后提供定制固件。 4. 若只是为了提高执行效率，优先评估Lua+zbuff、定时器、中断回调等机制是否已满足，避免不必要的core定制。
LuatOS框架与core/script结构说明：https://docs.openluat.com/luatos_lesson/001_luatos_framework/
19. 模组在低功耗模式下会影响FOTA下发吗？
解答： 结论：低功耗（尤其是PSM/PSM+深睡）会影响FOTA的实时性，但不是"不能升级"。FOTA任务无法下发，更常见的原因是设备不在当前账号的项目下或升级时机设计不当，需从设备归属和低功耗流程两方面处理。
原理与处理步骤： 1. 平台侧前提：设备IMEI必须已添加到你自己账号下、且与固件所在项目对应，否则平台不会向该设备下发升级任务。若设备在他人账号或销售名下，需联系归属方将IMEI添加到目标项目（或完成设备转移）后再推送。 2. 低功耗行为：进入PSM/PSM+后模块不再监听寻呼，服务器此时无法主动触达设备；设备只在唤醒窗口、主动注网收发数据时才能查询并拉取升级任务。因此"平台点了升级但设备一直不动"在深睡状态下属于正常现象。 3. 软件设计要点：在脚本中安排周期性唤醒（如定时退出PSM、驻网后调用libfota2检查升级），检测到升级后完整执行下载、校验和写入；必须在fota回调返回成功（ret为0）后再调用rtos.reboot()重启，确认新版本运行正常后再允许重新进入休眠，避免升级中途掉电。 4. 若业务长期深睡，可在服务器侧配合设备的上线节奏下发升级，或在设备每次上报数据的连接窗口内完成升级检查。
FOTA教程：https://docs.openluat.com/luatos_lesson/009_luatos_fota/ libfota2接口：https://docs.openluat.com/osapi/ext/libfota2/ 设备归属说明：https://docs.openluat.com/air780epm/product/attributioniot/
20. LuatOS平台远程升级不用添加设备吗？只在项目里添加IMEI就可以吗？
解答： 结论：是的，使用合宙官方IoT平台做FOTA时，不需要逐台做硬件登记之类的"添加设备"操作，核心条件就是在自己账号的项目中添加设备IMEI；同时设备脚本中必须填入该项目的PRODUCT_KEY并按规范设置版本号，平台才能识别设备并推送升级。
完整条件与步骤： 1. 在合宙IoT平台（https://iot.openluat.com/ ）自己的账号下创建项目，获取项目的PRODUCT_KEY。 2. 在项目的设备管理中添加待升级设备的IMEI（可单个添加或批量导入），设备归属在自己账号名下是FOTA下发的前提。 3. 设备端main.lua中定义PRODUCT_KEY为该项目的key；VERSION必须为xxx.yyy.zzz三段格式（如001.000.001），平台通过比对版本号决定是否升级。 4. 用Luatools制作升级包（差分或整包），在项目中上传并创建升级任务、选择目标IMEI后发布；设备上线检查到新版本即下载，fota回调返回0表示成功，随后调用rtos.reboot()完成切换。 5. 注意一台设备同一时间只能归属在一个项目下；若IMEI已在其他账号项目中，需先在原项目删除、再在新项目添加（即设备转移），否则当前项目无法向其下发任务。
FOTA应用教程：https://docs.openluat.com/air780epm/luatos/app/ota/fota/ 设备归属说明：https://docs.openluat.com/air780epm/product/attributioniot/
21. 设备不在自己名下如何远程升级？
解答： 结论：FOTA只能由设备当前归属账号下的项目发起，设备不在自己名下时无法直接远程升级，必须先完成设备归属转移或请归属方协助升级。
处理方式（按设备来源选择）： 1. 设备在其他个人/公司账号下：联系设备归属人登录其账号，在原项目中删除该IMEI，然后在你自己账号的项目中添加该IMEI；先删后加完成转移，转移后即可正常推送升级。 2. 设备在淘宝店或销售渠道名下：联系购买店铺/销售，提供IMEI清单，请其将设备释放或转移到你的账号项目下。 3. 暂不能转移时的替代方案：可由归属方在其项目中代发升级任务，或使用自建HTTP升级服务器（libfota2支持第三方服务器），由设备端脚本直接向自有服务器查询升级，从而绕过平台账号归属限制。 4. 转移前确认设备脚本中的PRODUCT_KEY已改为新项目的key、VERSION符合xxx.yyy.zzz三段格式，避免转移后设备仍连旧项目。
设备归属与转移规则：https://docs.openluat.com/air780epm/product/attributioniot/
22. Air8782的485传感器供电怎么解决？
解答： 结论：Air8782本体只提供3.3V IO电平、没有设计可直接给RS485传感器供电的电源输出管脚，因此传感器不能直接从模组取电，需要在底板上独立解决供电，并将RS485收发器与传感器的电源、地线统一规划。
解决方式： 1. 外接电源方案：在底板上为485传感器和TTL转RS485芯片设计独立供电（按传感器标称电压，如5V/12V/24V，由DCDC或LDO从系统电源取得），模组UART的TX/RX经TTL转RS485芯片（如MAX485类）连接传感器的A/B差分线，方向控制脚接一个GPIO。 2. 共地是硬性要求：模块、485芯片、传感器、外接电源必须共地，否则通信不稳定；电源电流按传感器峰值功耗预留余量，不要从3.3V IO域飞线取电，以免拉垮模组供电导致重启。 3. 接口建议引出4根线：Vout（传感器电源）、GND、A、B；总线末端按需要加120Ω终端电阻。 4. 软件侧使用exmodbus扩展库实现Modbus-RTU读写。若希望省去底板电源与485设计，可评估选用集成RS485接口与对外供电的工控板型号（如Air8782P等成品板）。
RS485/Modbus硬件接线参考：https://docs.openluat.com/embedded/sensor/ exmodbus接口：https://docs.openluat.com/osapi/ext/exmodbus/ Air8782P资料：https://docs.openluat.com/air8782p/product/
23. Air8000系列ADC采集电压不对是什么原因？
解答： 结论：Air8000的ADC采值不对，绝大多数是量程模式与外部分压重复叠加、输入电压超量程或多通道切换时序造成的。Air8000提供ADC0(PIN75)、ADC1(PIN68)、ADC2(PIN42)、ADC3(PIN87)，为12位AUXADC，需要根据被测电压范围选择正确的采集路径。
原理与排查步骤： 1. 两种量程路径不要叠加外部分压： - 内部分压路径（adc.ADC_RANGE_MAX）：底层已做好分压，可直接测0~3.3V，外部禁止再加电阻分压，否则等于二次分压，读数必然偏小且非线性。 - 直通路径（adc.ADC_RANGE_MIN）：可测0~1.6V，外部不能加内部分压；若被测电压高于1.6V，应在外部加分压电阻把电压降到1.6V以内再接入。 2. 被测电压超过3.3V时，必须使用外部电阻分压配ADC_RANGE_MIN，使分压后电压落在1.6V以内，并在软件中按分压比换算回真实电压；建议有效输入工作在0.1~1.5V区间以保证线性度。 3. Air8000所有ADC共用一个采集通道，同一时间只能采一路，多路轮询时每次adc.open/adc.read之间保留适当间隔，避免通道切换未稳定造成串值。 4. adc.open后有约500uA的工作电流，低功耗场景采集完成应调用adc.close；测芯片内部温度用adc.CH_CPU、测VBAT用adc.CH_VBAT，不要与外部通道混用。 5. 先用已知稳定电压（如万用表实测的电池电压或标准电源）校验一路通道，确认量程与分压比配置正确后再接入实际信号。
Air8000 ADC硬件设计说明：https://docs.openluat.com/air8000/luatos/hardware/adc/
24. Air780EPM从PSM+唤醒后SIM卡注册被拒绝怎么办？
解答： 结论：PSM+唤醒后注网被拒绝（SIM注册拒绝）通常不是模组损坏，而是SIM卡/运营商侧的限制或唤醒后注网时序问题，应按"卡本身→卡策略→模块时序"顺序排查。
排查步骤： 1. 确认SIM卡状态：联系卡商核实该卡是否正常开户、是否有机卡绑定/定向APN/PSM业务限制、是否欠费停机；物联网卡常见只允许特定APN或被限制PSM行为。 2. 交叉验证：换一张确认正常的手机SIM卡测试，若手机卡唤醒后可正常注册，说明问题在原卡的运营商策略而非模块；反之用原卡放入手机或另一模组观察是否同样被拒。 3. 抓取注网日志：记录唤醒后的mobile网络事件与注册拒绝原因码（如+CREG/+CGREG拒绝cause值），不同cause可区分是SIM未激活、网络拒绝附着还是PSM相关的T3324/T3412定时器问题。 4. 软件处理：唤醒后等待模块完成驻网和附着（监听网络就绪事件）再发起业务；可在检测到注册被拒时按退避策略重试搜网注网，避免频繁在深睡/唤醒间快速切换。 5. 将模块固件升级到最新稳定版后复测，并保留复现时的完整日志，联系卡商或通过官方企业微信群进一步定位。
网络状态相关接口mobile：https://docs.openluat.com/osapi/core/mobile/
25. Air780EPT的MQTT AT指令收不到CONNECT OK且查询MQTTSTATU为0怎么处理？
解答： 结论：MQTTSTATU为0、收不到CONNECT OK，说明MQTT连接没有建立完成，问题通常出在前置注网、指令时序或鉴权参数上，单纯重复AT+MIPSTART不能解决。AT固件MQTT必须按固定指令顺序执行。
按以下顺序排查： 1. 先确认网络前提：AT+CGREG?确认已注册网络（返回1或5）、AT+CGATT?确认已附着（返回1），再确认SIM卡未欠费、数据业务可用；网络未就绪时TCP不可能建立。 2. 按规范时序执行：AT+MCONFIG=clientid,user,password配置鉴权三要素 → AT+MIPSTART="服务器地址","端口"建立TCP（SSL场景用AT+SSLMIPSTART）→ 收到"CONNECT OK"表示TCP已通 → 必须立即发送AT+MCONNECT=1,60完成MQTT登录，等待过久会被服务器断开。 3. 收到"CONNACK OK"才表示MQTT真正登录成功；之后再用AT+MSUB订阅、AT+MPUB发布，订阅的下行消息通过+MSUB URC主动上报。 4. 用AT+MQTTSTATU查询状态作为辅助判断；若TCP都未建立（无CONNECT OK），重点检查地址/端口、防火墙与SIM卡出网；若TCP建立但无CONNACK，重点检查clientid/user/password与CleanSession、keepalive参数。 5. 结束时先AT+MDISCONNECT再AT+MIPCLOSE，重连前保证旧连接完全释放；同时确认服务器端没有因clientid重复登录把本设备踢下线。
AT固件MQTT指令教程（含SSL单向/双向认证）：https://docs.openluat.com/atmozu/product/command/mqtt/
26. Air8000A的1PPS指示灯可以修改闪烁频率吗？
解答： 结论：可以修改。1PPS由GNSS芯片的时间脉冲（Timepulse）引脚输出，其周期和高电平宽度可通过向GNSS芯片发送CFGTP配置报文修改，Air8000A的GNSS芯片挂在UART2上（管脚PIN94/PIN95），用脚本向该串口写入配置报文即可。
操作要点： 1. 硬件连接：GNSS模块与主控之间通过UART2通信，确认已按硬件文档打开GNSS电源并初始化UART2。 2. 配置方法：构造CFGTP报文（以u-blox协议为例，对应UBX-CFG-TP标准命令），设置时间脉冲周期（period）和脉冲宽度（pulseLen，即高电平持续时间），例如希望"亮1秒、周期自行设定"则把高电平时间配置为1000ms；注意1PPS默认含义是每秒一个脉冲，常规用法是周期1000ms、高电平宽度较短（如100ms），指示灯随之每秒闪一次。 3. 报文需按协议计算校验和后通过UART2发出，可用官方GNSS库的相关发送接口，或直接用uart.write发送原始报文；部分GNSS芯片掉电后配置丢失，需要在每次开机初始化时重新配置，或写入其备份存储。 4. 指示灯效果还受外部LED高/低有效接法影响，调宽高电平时间即改变点亮时长。
Air8000 GNSS硬件设计（含UART2与CFGTP说明）：https://docs.openluat.com/air8000/luatos/hardware/gnss/ libgnss库：https://docs.openluat.com/osapi/core/libgnss/
27. Air780EGT和Air780EG除了有源天线引脚不同，AT命令是否完全复用？
解答： 结论：可以兼容替代。使用AT指令开发时，Air780EGT（以及Air780EG2）可直接替代Air780EG，AT指令集复用，业务软件无需修改；两者的差异主要在硬件资源和个别管脚，不在AT指令。
具体差异： 1. 存储与下载能力：Air780EG2为4MB Flash+4MB RAM，支持128K Byte及以下的文件下载；Air780EGT为8MB Flash+8MB RAM，支持1M Byte及以下的文件下载；除文件下载大小外，EG2与EGT其他方面没有区别。 2. 唯一需要改PCB的情况：产品使用有源GNSS天线时，Air780EG为有源天线供电的管脚是PIN8（GNSS_VDD），Air780EG2/EGT改为PIN98（GNSS_VDD），原有底板需相应调整该供电走线；使用无源天线则不涉及此问题。 3. 型号划分差异：Air780EG同时支持AT指令和LuatOS二次开发，而EG2/EGT把AT与LuatOS区分为不同型号（AT型号刷AT固件、LuatOS型号刷LuatOS固件），替代时需选对应开发方式的型号。 4. 详细的逐管脚差异可下载官方管脚对比表（Air780EGvsAir780EG2vsAir780EGT管脚对比20260429.xlsx）核对。
官方兼容替代说明与管脚对比表：https://docs.openluat.com/atmozu/product/air780eg2egtvsair780eg/
28. Luatools可以监测Air780EHM处理器和内存指标吗？
解答： 结论：内存指标可以直接监测——Luatools（3.1.12及以上版本）提供内存曲线图和CSV导出功能；处理器（CPU）没有类似任务管理器那样的"占用率百分比"实时曲线，需要结合脚本侧的运行时间统计与日志进行评估。
内存监测方法： 1. 固件需为V2020及以上版本，在脚本中周期调用rtos.meminfo()并打印，例如：
sys.timerLoopStart(function()
log.info("mem.lua", rtos.meminfo())
log.info("mem.sys", rtos.meminfo("sys"))
end, 5000)
处理器负载评估： 1. LuatOS是协作式单Lua虚拟机框架，一般不存在传统RTS意义上的CPU占用率统计；判断"CPU忙不忙"主要看业务执行耗时，可用os.mclock()/rtos.tick等在关键任务前后打点，统计单次执行时间与周期占比。 2. 避免长时间阻塞式运算占用主线程，重计算应分片执行或放到定时器/协程中；若出现看门狗复位、日志卡顿等现象，通常即代表某段代码执行时间过长。 3. 任务与消息调度情况可通过log日志观察，必要时结合errDump异常日志上报进行线上分析。
内存(RAM)使用分析（含rtos.meminfo与Luatools曲线说明）：https://docs.openluat.com/common/LuatOS_ram/
29. 模组MQTT连接自签证书服务器不成功是什么原因？
解答： 结论：连不上是因为模组按TLS标准默认会校验服务器证书，而自签证书不被设备信任（链路上无受信CA、域名/SAN不匹配或证书过期），握手在校验阶段失败。AT固件日志中常见错误码0x2700，即MBEDTLS_ERR_X509_CERT_VERIFY_FAILED。
解决方式（按安全等级二选一）： 1. 保留证书校验（推荐生产环境）： - 自建CA签发服务器证书，并把CA根证书（ca.crt）写入模块（AT固件用AT+FSCREATE创建文件、AT+FSWRITE写入，再用AT+SSLCFG="cacert",...配置；同时AT+SSLCFG="seclevel",88,1设置安全等级，AT+SSLCFG="hostname",...配置SNI/主机名校验）。 - 证书的CN/SAN必须与连接使用的域名一致、在有效期内，时间未同步也会导致校验失败，注意先完成NTP授时。 2. 关闭服务器证书校验（仅适合自建可控链路的调试/内网场景）： - LuatOS脚本方式创建MQTT客户端时设置ssl=true（不携带CA即不校验服务器证书），或在ssl配置中按文档关闭证书验证；AT固件按MQTT over SSL教程将安全等级配置为不校验证书。 - 关闭校验后数据仍加密，但无法防止中间人伪造服务器，请勿在公网正式业务中长期使用。 3. 排查时先用标准CA签发的证书（或官方MQTT测试服务器）验证链路，再切换到自签服务器，以区分是网络问题还是证书问题。
AT固件MQTT/SSL配置教程：https://docs.openluat.com/atmozu/product/command/mqtt/ LuatOS MQTT（TLS）教程：https://docs.openluat.com/luatos_lesson/003_luatos_mqtt/
30. 4G模组只发数据收不到服务器数据是什么问题？
解答： 结论："能发不能收"说明上行链路基本通，问题多出在下行接收机制、NAT长连接保活或服务器侧，而不一定是信号问题。物联网卡经运营商NAT上网，长时间无数据的TCP/MQTT连接会被网间设备回收，设备却不一定立即感知，表现为上报正常但收不到下发。
按层次排查： 1. 确认接收逻辑：TCP/UDP客户端必须在接收回调（如socket的recv事件、MQTT的消息回调、AT固件的+MSUB URC）中处理数据；若业务只在发送后同步等待一次应答，服务器稍后下发的数据就会错过。订阅类业务确认已成功订阅对应Topic。 2. 长连接保活：MQTT设置合理的keepalive（如60~120秒）并响应心跳；裸TCP在应用层增加定时心跳包，维持NAT映射并及时发现死链；检测到断线必须自动重连、重新订阅。 3. 服务器侧核对：在服务器日志/控制台确认下行消息确实已发出、发给了正确的clientid/连接，且设备在线；UDP服务器要确认回包目标地址端口与设备出口地址一致（NAT后地址以设备发包来源为准）。 4. 无线链路：确认4G天线已可靠连接、RSRP/SINR良好，弱场或基站高负载时上行可缓存重试、下行易丢包；可换地点、换运营商卡交叉验证。 5. 健壮性设计：业务必须容忍断网、重连、重复/乱序消息，关键下发采用应答+重试机制，不要假设长连接始终可达。
socket编程：https://docs.openluat.com/air780epm/luatos/app/socket/TCP&UDP%20%E6%95%99%E7%A8%8B/ MQTT教程：https://docs.openluat.com/luatos_lesson/003_luatos_mqtt/
31. 字库缺少某些字怎么扩展？
解答： 结论：固件内置字体只覆盖常用字符（内置ttf为GB2312一、二级汉字；lcd/eink/u8g2固件仅内置12号单色点阵中文），遇到生僻字、特殊符号或需要大字号时，应自行制作包含所需字符的字体文件（ttf矢量字库或bin点阵字库）并烧录到设备中使用，而不是依赖固件内置字库。
扩展方式： 1. ttf矢量字库（推荐，可显示12~255号字）： - 准备获得授权的.ttf字体文件，使用官方字体工具LuatOS_Font_Tools.exe，按字符集快捷勾选（如一二级中文、英/法等）或直接粘贴自定义文字内容，从原字体中提取所需字符，生成精简ttf，可显著减小体积。 - 将精简ttf烧录到模块文件系统、脚本空间，或放在SD/TF卡、外置nor/nand flash中。 - 按所用UI库加载：airui用airui.font_load({type="hzfont",path="/xxx.ttf"})（不需要hzfont.init）；lcd先hzfont.init("/xxx.ttf")再lcd.drawHzfontUtf8()；u8g2用u8g2.SetHzFont("/xxx.ttf")后u8g2.DrawUTF8()。 2. bin单色点阵字库（仅lcd核心库支持）：用官方工具按指定字号生成bin文件后通过lcd.setFontFile()加载，适合资源受限且字号固定的场景；u8g2场景也可使用社区u8g2字库制作工具生成自定义点阵。 3. 先确认缺字原因：若字符本就不在GB2312范围（如生僻字、emoji），必须用包含该字形的授权字体重新提取；同时确认所用固件支持对应库组合（目前没有固件同时支持eink+hzfont或u8g2+hzfont，需要矢量中文优先选airui或lcd方案）。
LuatOS字体使用说明（含工具下载、制作与烧录步骤）：https://docs.openluat.com/common/luatos_font_guide/
32. 如何配置地图Key？
解答： 结论：地图Key由地图服务商按账号单独签发，必须自行申请、独立使用，不能多人共用同一个Key；设备端直接明文使用Key容易泄露和被盗刷，正确做法是后端代理或配置访问白名单。
配置与保护方式： 1. 申请Key：到所选地图开放平台注册账号并创建应用，按平台要求选择对应的服务类型（如Web端JS API、Web服务API、Android/iOS SDK等），获取属于自己的Key；不同平台的Key不能混用。 2. 按平台规则配置安全设置：Web端JS API通常要求配置域名白名单（Referer白名单），只允许自己的网页域名使用；服务端API使用密钥（SK/Secret）做签名校验，Key和SK都不能写进前端页面或固件。 3. 推荐架构：模组/前端不直接持有地图Key，而是请求自己的业务后端，由后端携带Key（或按SK签名）调用地图服务并返回结果，从而隐藏凭据、统一配额管理。 4. 定位类应用中若仅使用合宙基站/WiFi定位或设备GNSS原始数据，则不涉及地图Key；只有调用地图展示、逆地理编码等接口时才需要对应平台的Key。 5. 一旦发现Key泄露或被盗用，应立即在开放平台禁用并重新生成，同时检查配额与账单。
各地图厂商的申请入口与安全配置以对应开放平台官方文档为准；GNSS定位库参考：https://docs.openluat.com/osapi/core/libgnss/
33. 合宙运动传感器8202整机赠送活动规则是什么？
解答： 结论：该活动为合宙Air8202定位器整机前端页面开发活动。2026年9月3日公告启动（免费送出60台Air8202定位整机，先到先得），9月7日起活动升级为"提交作品二选一"福利，作品优化提交截止日期为2026年9月30日。活动规则在持续更新，参与前务必以官方公告的最新版本为准。
初始赠送规则（2026.9.3公告）：凡按照合宙教程开发前端网页，同时满足以下全部条件者，奖励Air8202整机一台： 1. 能够成功登录演示账号（账号：18101796680，密码：Hz8202）； 2. 能够正常查看账号内若干台设备的状态； 3. 页面整体体验超过对标网站 move.luatos.com（登录账号密码同上）。
升级后的参与方式（2026.9.7公告，所有提交作品的用户可二选一）： - 福利一：提交作品即可以活动优惠价购买整机，无需等待评比，具体价格与包含的流量、平台服务年限以公告为准； - 福利二：继续优化前端页面，交互、视觉、功能体验整体优于move.luatos.com的作品，经评审后免费获得整机一台。
说明：活动前端全部开源并配套AI开发教程；Air8202为硬件全集成的定位器方案，接上电池即可定位上报。作品提交方式、评审标准及后续变更以官方公告页和活动群通知为准。
合宙公告（含活动规则与提交方式）：https://docs.openluat.com/hezhou_publish/ Air8202产品资料：https://docs.openluat.com/air8202/product/