跳转至

常见问题 - 2026-08-03

数据日期:2026-08-03

1. Air8000 核心板带充电IC版本,V2030 1号固件驻网失败,V2024 1号固件没问题,是固件原因吗?

解答: 结论: 优先升级最新正式固件复测,此类版本差异多数为固件对新硬件版本适配不完整所致。带充电管理IC的Air8000存在控制射频供电的硬件版本,旧固件可能未完整适配。操作步骤: 1)用Luatools烧录最新正式固件(V2046或更新)后复测;2)抓取开机日志,确认日志中打印的硬件版本号;3)脚本中调用mobile.status()查看驻网状态,必要时用EPAT抓日志定位。若最新固件仍驻网失败,请提供硬件版本号与完整日志联系官方技术支持。

2. 循环调用lcd.setFontFile('/luadb/Serif_Regular_16.bin')刷新显示,内存会一直增加,有办法避免吗?

解答: 结论: 字库只需加载一次,严禁在刷新循环中重复加载。setFontFile每次调用都会重新装载字库文件并占用内存,循环调用会导致内存持续增长。建议: 1)开机时调用一次lcd.setFontFile,刷新循环中只做draw/flush;2)优先改用内置hzfont字库:airui.font_load({type="hzfont", path=nil, size=字号, cache_size=...}),hzfont字体内置于固件、不重复占用脚本空间(Air780EHM/EHV/EGH需V2020及以上的14/114号固件,Air8101用104号固件);3)显示中文配合lcd.drawHzFontUtf8等接口。

3. lora的cad模式目前不支持吧?

解答: 结论: 当前LuatOS的lora2库不支持CAD(Channel Activity Detection,信道活动检测)模式。说明: lora2库适配llcc68/sx1268芯片(支持Air780EPM/Air8000/Air8101/Air780EHM_EHV_EGH等型号),提供的事件回调为tx_done、rx_done、rx_timeout、rx_error,没有CAD相关接口。替代方案: 可将接收方设为持续接收(rx)状态,通过rx_done/rx_timeout事件判断信道上有无数据,间接实现"信道活动检测"的业务效果。参考demo:lora2_main.lua、lora2_receiver.lua、lora2_sender.lua(https://gitee.com/openLuat/LuatOS/tree/master/module/Air780EPM/demo/lora2)。

4. 测试主动进入飞行模式后再进入PSM+模式,结果进入失败,是BUG吧?

解答: 结论: 不需要先进入飞行模式。PSM+模式本身即"离线(等效飞行模式)、代码停跑、唤醒后重新运行"的深睡状态,先手动开飞行模式再进PSM+可能因模式切换时序导致进入失败。建议: 1)正常注网后直接进入PSM+(pm.power(pm.WORK_MODE,3)),不要先调用mobile.flymode();2)切换低功耗模式前先执行AT+POWERMODE="CLOSE"退出当前模式,再进入目标模式;3)PSM+第三个参数控制是否每隔54分钟周期唤醒,按业务设置(设0为周期唤醒、1为不周期唤醒)。参考低功耗文档:https://docs.openluat.com/air780epm/luatos/app/lowpower/sleep/

5. BMI270传感器初始化需要写入8192字节配置参数,I2C能一次发送这么多数据吗?

解答: 结论: 不需要也不建议一次发送8192字节,应分页/分批写入。I2C单次传输长度受底层缓冲限制,而BMI270的初始化配置本身支持分页加载。操作方法: 通过INIT_ADDR_0、INIT_ADDR_1寄存器设置每页写入起始地址,将8192字节配置按页拆分(可先试单次64字节),每页按"寄存器地址+数据"格式用i2c.write逐页下发即可。

6. 724UG生成SOC需要用哪个版本的luatools?

解答: 结论: 与Luatools版本无关。Air724UG使用的是老一代LuatOS-Air(AT架构)固件,该架构本身不输出soc文件,soc文件是LuatOS新架构(Air780/Air8000等型号)的量产文件形式。操作建议: 量产烧录时请在Luatools的固件下载页选择与型号对应的量产固件目录,不要在新架构固件目录中查找soc文件;如需确认可用固件,以docs.openluat.com对应型号产品页发布的固件为准。

7. luatools下载烧录固件失败是什么原因?

解答: 结论: 烧录失败多为临时目录异常、USB连接不稳、驱动或电脑蓝牙干扰所致,按以下顺序排查。步骤: 1)关闭电脑蓝牙后重试(蓝牙可能干扰Luatools烧录);2)删除Luatools安装目录下的_temp临时目录,重启Luatools;3)确认Luatools放在英文路径下(如D:\luatools),电脑硬盘留有足够空间;4)更换质量可靠的短USB数据线、换USB口;5)780/8000/8201系列免驱,722/724/720/795/820等型号需先安装USB驱动,Air1601需CH343驱动。正确烧录步骤与救砖方法参考:https://docs.openluat.com/common/howtodown/

8. luatools 3.4.0使用Air1602板没有任何打印,烧录固件提示cmd 20 timeout怎么办?

解答: 结论: cmd 20 timeout表示PC与模组在下载握手上超时,首先检查板上开关拨档与USB线,再按烧录规范操作。步骤: 1)确认开发板拨码/拨动开关处于正确的下载/供电档位,USB1口(烧录口)已安装CH343驱动;2)断电状态下在Luatools点"下载"进入等待,再按住BOOT键给板子上电,进入下载模式后松开;3)关闭电脑蓝牙、删除Luatools目录下_temp后重试;4)换短USB数据线、换USB口。驱动安装参考:https://docs.openluat.com/air1601/luatos/common/swenv/#21-ch343

9. 6205是没有日志打印的对吧?

解答: 结论: 是的,Air6205没有独立的LuatOS日志。Air6205/Air6205A是配合Air780/Air1601主控使用的无线从机(WiFi 6 + 双模蓝牙5.4),仅通过Airlink协议与主控通信,不运行独立的用户脚本,也不对外输出调试日志。说明: 业务日志、配网状态等均由主控侧脚本打印(例如主控日志中可看到AIRLINK_READY等状态),排查问题请在主控侧抓日志。选型说明见产品选型指南:https://docs.openluat.com/SelectionGuide/SelectionGuide/

10. Air8101C这个还做吗?预计什么时候可以上架?

解答: 结论: Air8101系列目前官方在售为Air8101、Air8101B型号(对应105/106号固件),暂无名为Air8101C的型号资料。建议: 产品上架、规格与购买信息以官方渠道发布为准,可在合宙选型指南与官方淘宝店(https://luat.taobao.com/)查看最新在售型号;如需特定规格的产品规划信息,可通过官方企业微信群咨询商务确认。

11. 780EVT使用AT+POWERMODE="PRO",UART1和RI引脚出现频繁脉冲,客户的MCU会因此唤醒,怎么规避?

解答: 结论: PRO(低功耗)模式下模组休眠/唤醒过程中UART1与RI引脚电平会反复跳变,这是硬件特性,软件无法关闭,需从MCU侧硬件设计规避。方案: 1)在UART1、RI信号线上加约100K下拉电阻,抑制无通信时的悬空脉冲;2)MCU的唤醒脚不要直接接RI,中间加三极管/MOS管或门电路做电平与极性整形,由MCU可控地使能唤醒检测;3)如不需要RI唤醒功能,可将MCU唤醒脚改接其他明确电平的信号。低功耗指令说明见AT固件低功耗文档:https://docs.openluat.com/atmozu/product/command/lowpower/

12. 第一批发货的1601开发板使用CH340下载波特率2M,用新luatools下载固件和脚本会自动改到6M吗?

解答: 结论: 会自动协商,无需手动设置。新版Luatools下载时会自动选择最高可用波特率,旧版开发板的下载速率受USB转串口芯片限制。注意: Air1601开发板烧录口使用的USB转串口芯片为CH343(不是CH340),需先安装CH343驱动才能正常枚举和下载,驱动与环境配置见:https://docs.openluat.com/air1601/luatos/common/swenv/#21-ch343

13. Air1780可以测试WS2812吗?有专门接口吗?

解答: 结论: 可以,LuatOS提供专用的sensor库WS2812驱动接口。代码要点: 1)GPIO方式:sensor.ws2812b(pin, data, T0H, T0L, T1H, T1L),可自定义时序参数;2)PWM方式:sensor.ws2812b_pwm(pin, data),要求该引脚PWM能输出800kHz波形,时序更稳定。data为GRB顺序的灯珠数据缓冲。两种方式均为库内置接口,无需自行模拟时序。

14. 银尔达724的短信收不到/不能转发问题怎么排查?

解答: 结论: 最常见原因是模组短信存储空间已满。开机默认只清除已读短信,未读短信若长期不读取会一直占用空间,存满后新短信无法接收。处理方法: 1)脚本中定期执行ril.request("AT+CMGD=1,4")删除全部短信(或按业务删除已处理短信);2)收到短信后及时读取并标记已读;3)转发场景下确认转发完成后再删除原短信,避免存储堆积。

15. 合宙的账号系统可以绑定多个微信吗?

解答: 结论: 账号体系以手机号为核心,一个手机号账号绑定一个微信即可。企业账号属于虚拟群组账号,其成员各自使用本人的手机号账号登录并绑定本人微信,无需也不支持一个账号绑定多个微信。

16. 大圆AI只能合宙内部员工使用吗?普通微信客户能否用大圆AI聊天?

解答: 结论: 客户获取合宙技术支持请使用官方公开渠道:1)docs.openluat.com 文档站及站内AI问答;2)合宙官方企业微信群(文档站底部二维码扫码加入);3)LuatOS官方Gitee仓库(https://gitee.com/openLuat/LuatOS)查代码与demo。内部AI助手不对外提供服务,普通微信无法直接对话。

17. 把docs文档复制到企业微信文档内,是否可以通过大圆回复企业微信群的问题?

解答: 结论: 合宙技术文档以官方文档站(https://docs.openluat.com/)为唯一权威来源,文档内容随固件持续更新。将文档复制到第三方平台不保证内容同步,也不构成官方支持入口。建议: 技术问题直接在官方企业微信群提问并附文档链接,或查阅文档站对应型号页面,确保获取的是最新版本内容。

18. Air8000一直停留在正在搜索网络/驻网失败,是什么原因?

解答: 结论: 驻网失败按SIM卡→天线→固件→硬件版本顺序排查。步骤: 1)确认SIM卡方向、接触良好,双卡设备调用mobile.simid(1)切换到SIM2测试;用手机卡交叉验证排除坏卡;2)检查射频天线座是否扣紧、天线匹配是否正确;3)升级最新正式固件复测,带充电IC版本注意硬件版本适配;4)脚本中用mobile.status()查看驻网状态码,用EPAT/mobile日志抓取注册流程(+CREG/+CERG)。SIM硬件设计参考:https://docs.openluat.com/air8000/luatos/hardware/sim/

19. 开发板不识别SIM卡怎么办?

解答: 结论: 不识卡按"卡→卡座/连线→滤波电路→软件配置"顺序排查。VDD_SIM测不到电压是不识卡的结果而非原因(模组会以1.8V/3.3V交替尝试约4次后关闭供电)。步骤: 1)换一张确认正常的手机卡交叉测试,排除坏卡;2)检查SIM卡方向、卡座焊接与SIM_CLK/SIM_DATA/SIM_RST信号线是否连错、虚焊;3)TVS管容值过大、或SIM线上22Ω+33pF滤波网络会影响通信,可换0Ω电阻、去掉33pF电容验证;4)SIM卡座的USIM_DET检测脚(Air780Exx为PIN79/WAKEUP2;Air8000无固定脚,单卡可悬空)需正确配置或悬空;5)双卡设备确认已调用mobile.simid(n)选择对应卡槽。硬件设计说明:https://docs.openluat.com/air8000/luatos/hardware/sim/

20. GNSS result中3743.430127,11810.527734这种数据如何计算偏移?

解答: 结论: 这是NMEA原始的ddmm.mmmmm(度分)格式经纬度,不是十进制度,不能直接当坐标使用。GNSS输出为WGS-84坐标系。换算方法: 十进制度 = 度 + 分/60。例如3743.430127 = 37度43.430127分 → 37 + 43.430127/60 ≈ 37.7238°N;11810.527734 = 118度10.527734分 → 118 + 10.527734/60 ≈ 118.1755°E。代码要点: LuatOS的exgnss库可通过exgnss.gga()/exgnss.rmc()的lnglat_mode参数直接选择输出格式:0=ddmm.mmmmm原始、1=十进制度×1000000整数、2=DD.DDDDDDD十进制度、3=原始RMC,建议直接用模式2免去手工换算。国内地图(GCJ-02/BD-09)显示有偏移,可用官方工具核对转换:https://docs.openluat.com/file/GPS-Offset.html

21. 蓝牙连接后用特征值发送AT指令是否有效?

解答: 结论: 无效。BLE GATT特征值(Characteristic)写入是一条自定义数据通道,写入内容不会被模组自动解析为AT指令执行。原理: LuatOS的ble库中,特征值写事件通过ble.WRITE(带响应写)/ble.WRITE_CMD(无响应写)回调把数据交给用户脚本,模组本身不内置"BLE转AT"通路。实现方法: 在GATT写事件回调中自行解析收到的数据,若要支持AT指令,需在脚本里判断字符串并调用ril.request()执行对应AT命令、再通过notify把结果回发;若直接做透传/控制,按自定义协议处理即可。ble库用法参考:https://docs.openluat.com/osapi/core/ble/

22. Air8201买了不知道怎么看定位?

解答: 结论: Air8201G/H有现成GNSS定位demo,烧录即可在日志中查看定位结果,不需要从零开发。步骤: 1)烧录官方gnss demo(demo中通过UART2外接/内置GNSS模块,支持lbsLoc2库AGPS辅助定位,gnssmode可设1=全卫星、2=单北斗);2)室外开阔处上电,定位成功后日志打印GGA/RMC语句,含经纬度、时间、卫星数;3)注意有源天线座与无源天线座不可混插,插反会导致长时间无法定位;4)需要远程查看时,可在demo基础上把经纬度通过MQTT/socket上传到自己的服务器或云平台。GNSS入门教程:https://docs.openluat.com/luatos_lesson/011_luatos_GNSS2/

23. AirRC522_1000有购买链接吗?用普通RC522可以吗?

解答: 结论: 可以使用普通RC522模块替代。AirRC522_1000是合宙配件板,其demo通过SPI接口驱动RC522芯片,普通RC522模块采用相同的SPI时序与寄存器协议,按SPI引脚接线即可直接替代。代码要点: 参考demo AirRC522_1000.lua(https://gitee.com/openLuat/LuatOS/tree/master/module/Air780EPM/demo/accessory_board),按实际接线修改SPI号与CS/IRQ引脚。

24. 合宙模组支持高速串口lwip方式吗?

解答: 结论: LuatOS脚本开发下不存在"串口跑lwip"的模式——socket.LWIP_系列常量是网卡类型标识(用于多网卡场景指定网络通道),与串口无关。串口与网络之间的数据透传用socket库实现。做法: 参考官方"TCP&UDP"教程demo,建立TCP/UDP连接后,在uart接收回调里把串口数据通过socket发送,在socket接收回调里把网络数据写入uart,即完成串口↔网络透传。串口注意事项(Air780EPM):* UART1为主串口,支持3.0V/1.8V电平,LPUART唤醒时非9600波特率会丢字节;UART3不支持休眠唤醒;UART0固定921600用于调试日志。文档:https://docs.openluat.com/air780epm/luatos/app/driver/uart/

25. 外接RTC相关资料有吗?只支持一种RTC芯片吗?

解答: 结论: 不限制RTC芯片型号。LuatOS内置rtc核心库操作的是模组内部RTC(rtc.set/rtc.get/rtc.timezone/rtc.setBaseYear);外接RTC芯片走I2C/SPI由用户脚本驱动,任何接口兼容的RTC芯片都可以移植。现有资料: 官方提供PCF8563T的参考demo(位于oldmodule/Air780E/demo/pcf8563t/,为旧LuatOS-Air架构,接口为pcf8563t.setup/write/read/alarm/control,移植到新架构时改用i2c库按芯片手册时序读写即可)。新架构各型号demo/rtc目录下有内部RTC用法示例。

26. RTC时间在卡故障或无卡、关机一段时间后如何保证时间延续?

解答: 结论: 模组内部RTC在断电(VBAT断开)后不走时,需要"掉电保持时间"必须外接RTC芯片配备份电池。方案: 1)外接PCF8563T等I2C接口RTC芯片,配纽扣电池/超级电容做备份供电,脚本开机时先读外部RTC再rtc.set()同步到模组(参考oldmodule/Air780E/demo/pcf8563t/);2)无卡/注网失败场景无法NTP对时,同样依赖外部RTC;3)有网时优先用socket.sntp()同步网络时间(成功后自动设置模组RTC,默认东八区)。

27. 通话播放TTS后停止,再次通话播放TTS提示busy,如何处理?

解答: 结论: busy是因为上一次播放通道未正确释放,必须等播放结束事件并显式停止后再发起下一次播放。代码要点: 1)监听PLAY_DONE事件(旧音频框架)或AUDIO_START/AUDIO播放完成事件,回调中调用exaudio.play_stop({type=1})释放通道,再sys.publish("PLAY_DONE")通知下一次播放;2)通话状态用标志位(如is_calling)管理,通话中不重复发起播放;3)Air8000等使用新音频框架的型号需V2048及以上的13/113号固件,初始化时设audio_mode="new",在通话建立后的AUDIO_START事件中播放。参考demo:Air8201G的cc_tts_app.lua、Air8000的play_audio_during_cc.lua(https://gitee.com/openLuat/LuatOS/tree/master/module/Air8000/demo/cc)。

28. 高压板串口插电脑调试导致电脑掉键盘鼠标怎么办?

解答: 结论: 这是高压板的高/低压区隔离不足,干扰或浪涌通过串口地线/信号线串入电脑USB,导致USB主机复位(键鼠掉线),属PCB硬件设计问题。处理步骤: 1)立即停止直连,在串口链路加隔离:使用磁耦/光耦隔离USB转串口模块,或串口侧加隔离芯片,供电用隔离电源;2)检查PCB高压区与低压区的爬电距离、地分割与布局,信号线远离高压功率回路;3)调试时电脑可改用电池供电(不接大地)降低风险。根本解决需按安规要求重做高压/低压隔离与PCB布局。

29. 模组到平台打算用哪种协议传送?

解答: 结论: 推荐MQTT。LuatOS内置mqtt库(支持MQTT 3.1.1),适用于多数物联网平台的长连接、低流量、弱网重连场景;也可使用socket库走自定义TCP/UDP协议,或HTTP(s)上报。建议: 云平台(OneNET、自建服务器等)普遍支持MQTT,按平台提供的三元组/ClientID接入即可;透传/低功耗场景参考官方TCP&UDP教程demo。

30. 780EPM能用C语言openCPU开发吗?

解答: 结论: Air780EPM/Air780EHM不支持C-SDK(OpenCPU C语言)开发,官方推荐使用LuatOS(Lua脚本)二次开发。LuatOS内置socket/mqtt/uart/i2c/spi/lcd/gnss等丰富库,开发效率高且固件持续维护。选型说明见产品页:https://docs.openluat.com/air780epm/product/

31. Air8202G_V0设计文件可以直接用3.7V标称锂电池吗?电池充满4.2V模组能受得了吗?

解答: 结论: 可以。普通锂离子/聚合物电池(标称3.7V、满电4.2V,工作范围约3.2~4.2V)可直接接模组VBAT,不需要外加升降压电路。通信模组VBAT内部有多路DCDC和LDO供电域,电压耐受按电池满电设计,与普通单片机3.3V电源不是一个概念。注意: Air8202内置OVP与充电管理(支持4.2V/4.35V充电截止电压软件配置、船运模式),按硬件手册设计充电与保护即可;确保VBAT走线宽度满足2A以上峰值电流。

32. Luatools 3.4.0刷不了机/烧录失败,换英文路径也不行,怎么回事?

解答: 结论: 先关闭电脑蓝牙再烧录——PC蓝牙与Luatools烧录通道冲突是该版本烧录失败的常见原因。补充排查: 1)删除Luatools目录下_temp临时目录后重启;2)确认硬盘剩余空间充足、Luatools在英文路径;3)更换USB数据线/USB口;4)按规范步骤进入下载模式:断电→Luatools点下载→按住BOOT→上电。仍失败参考烧录教程:https://docs.openluat.com/common/howtodown/

33. 780EHV板子跑官方hello world出现黄色工具提示,是重启吗?

解答: 结论: 黄色提示多为Luatools与模组的USB连接瞬断后重新枚举,即模组重启或USB链路掉线,绝大多数是USB供电/接触不稳导致。处理: 1)换短一些、线阻小的优质USB数据线(手机原装线通常可用);2)直插电脑后置USB口,避免用USB Hub;3)确认板子供电充足、VBAT无跌落;若反复出现且伴随业务复位,抓启动日志确认是软件异常重启还是纯USB重枚举。

34. AIR510W定位成功后没有1pps信号/pps时有时无是否正常?

解答: 结论: 1PPS是定位有效的秒脉冲输出,定位成功(有效星历、参与解算卫星数达标)后才会稳定输出;遮挡导致丢星、定位降效时1PPS会消失或断续,属正常现象。排查: 1)到室外开阔天空处测试,1PPS应恢复稳定;2)与正常板卡交叉对换GNSS模块,确认问题跟随模块还是底板(天线座、馈线、焊接);3)确认1PPS引脚配置正确、上拉合适。若开阔环境下仍无1PPS且定位异常,可走售后检测。

35. AIR8000A手机发现不了WIFI和蓝牙,是什么原因?

解答: 结论: Air8000A的WiFi/BLE由WiFi协处理器提供,手机发现不了多数是协处理器未初始化或焊接不良。排查步骤: 1)抓开机日志,搜索AIRLINK_READY,若无该日志说明WiFi协处理器启动失败,重点检查模组底部焊盘是否连锡/虚焊(自行画板尤其注意);2)WiFi固件需为最新(最新为14版),可先烧录WiFi固件再烧LuatOS固件与脚本(require "check_wifi"可检测并提示4G升级或线刷);3)确认型号:Air8000A/W带WiFi+BLE,Air8000D/DB/T不带WiFi/BLE;4)蓝牙配网依赖WiFi协处理器就绪,softAP/蓝牙配网用法见:https://docs.openluat.com/air8000/luatos/app/wifi/

36. mcu.tick64()延时1秒计算结果不是1000ms是什么问题?

解答: 结论: mcu.tick64()返回值单位是微秒(us)且基于底层tick频率,不能直接当毫秒,必须用差值函数配合频率换算。正确写法: 计时开始t1=mcu.tick64(),结束t2=mcu.tick64(),则耗时(毫秒)= mcu.dtick64(t2,t1) / mcu.hz() * 1000;其中mcu.dtick64()自动处理64位计数回绕。注意: 需要毫秒级计时应直接使用mcu.ticks()(单位毫秒);不要用t2-t1直接相减后当作ms,否则数值会差约1000倍(hz通常为数千万级)。API说明:https://docs.openluat.com/osapi/core/mcu/

37. 合宙的模块能实现SIP通话方案吗?

解答: 结论: 可以。LuatOS提供exsip库实现SIP/VoIP通话,Air8201、Air8000等型号均有完整SIP通话demo(含注册、来电/去电、通话中放音/TTS等)。代码要点: exsip默认编码为PCMU、PCMA(G.711),在config.lua中可配置codec;通话音频走ES8311 codec(Air780EHV内置,其余型号外挂,参考AirAUDIO_1010音频配件板)。demo见:https://gitee.com/openLuat/LuatOS/tree/master/module/Air8000/demo/sip

38. air780ex2可以做微秒级别的定时器吗?

解答: 结论: 可以,Air780E系列(含EX2/EPM等)提供硬件定时器+ioqueue方案实现微秒级精确定时/脉冲输出,软件定时器(sys.timer)只能到毫秒级且有抖动。代码要点: 1)精确脉冲/方波输出参考官方demo fix_pulse_output.lua:使用硬件定时器0配合ioqueue.setdelay连续模式,可输出20us级方波(Air780EPM/Air8000/Air780EHM_EHV_EGH均有此demo);2)微秒级信号测量可用mcu.tick64()做时间戳捕获(参考dht11_capture.lua)。demo路径:https://gitee.com/openLuat/LuatOS/tree/master/module/Air780EPM/demo/ioqueue

39. iRTU DTU不用充值了吗?

解答: 结论: iRTU(DTU)固件已免费开放,无需充值即可使用。固件源码、下载与使用文档见官方文档站iRTU相关页面。

40. air153c与780E的PCB示例有吗?

解答: 有,https://docs.openluat.com/accessory/Air153C/

41. 量产模块之前烧录正常,今天突然无法烧录,方向是什么?

解答: 结论: 同批次此前正常、突发无法烧录,优先排查PC环境而非模组。步骤: 1)关闭电脑蓝牙后重试(蓝牙干扰Luatools烧录是常见原因);2)删除Luatools目录下_temp、换USB口/USB线、重启Luatools;3)确认驱动正常、无其他串口工具占用端口;4)个别模组异常时按BOOT+USB强制进入下载模式救砖(串口烧录不能救砖)。参考:https://docs.openluat.com/common/howtodown/

42. 关闭蓝牙后能烧录,为什么蓝牙开关会影响程序烧录?

解答: 结论: 这是PC侧蓝牙栈与Luatools烧录通道(USB枚举/串口数据传输)冲突所致,不是模组问题。原理: 电脑蓝牙开启时,蓝牙射频/驱动可能占用或干扰USB调度与串口收发时序,导致Luatools下载握手中断、校验失败;关闭蓝牙后链路恢复稳定。建议: 烧录期间关闭PC蓝牙(含USB蓝牙适配器),使用Luatools最新版本;烧录环境要求与常见问题见:https://docs.openluat.com/common/howtodown/

43. 如何用API或订阅消息得到NTP同步成功?基站时间和NTP时间有差别吗,选哪个?

解答: 结论: 调用socket.sntp()发起NTP同步,等待NTP_UPDATE消息即表示同步成功,成功后库会自动设置本地时间(默认东八区)。代码要点: socket.sntp()默认使用ntp.aliyun.com,随后sys.waitUntil("NTP_UPDATE", 5000),超时返回nil则同步失败可重试。时间源选择: 基站同步时间快但精度依赖运营商、部分卡不支持;NTP精度高、通用性好,建议优先NTP,基站时间作为无互联网场景的补充。详细说明与示例:https://docs.openluat.com/common/time_sync/ ,demo参考ntp_test.lua。

44. 固件从版本1升2正常,从2升3提示下载成功但重启后版本号还是2,为什么?

解答: 结论: 以模组本地实际版本号为准,"升级成功"提示只代表服务器完成了数据下发,不代表新固件已写入并生效。可能原因: 差分包(版本2→3)生成不完整或校验失败,模组回滚到了原版本。处理: 1)升级后读取本地版本号确认;2)重新触发生成差分包后再升级,或改用整包升级;3)确认差分包与当前模组型号、当前版本严格对应。

45. 使用IRTU任务流,怎么实现每4分钟定时唤醒、串口采集电表数据、上传服务器后再低功耗睡眠?

解答: 结论: 用PSM+模式实现周期唤醒:PSM+下模组深睡、代码停跑,按设定周期唤醒后脚本从头执行。任务流配置要点: 唤醒→初始化串口→采集电表数据→建立连接上传服务器→上传完成后进入PSM+睡眠;PSM+第三参数控制54分钟周期唤醒机制,4分钟周期小于54分钟,按iRTU任务流的定时唤醒配置即可。连接服务器时选择低功耗连接方式。PSM+开发指南:https://docs.openluat.com/value/irtu/docs/psm/#41-psm

46. 780EPM下载固件只留BOOT引脚不接RESET可以吗?

解答: 结论: 量产板可以只引出BOOT而不接RESET。烧录时按住BOOT上电即可进入下载模式,不依赖RESET引脚;RESET主要用于外部硬件复位/看门狗复位。建议: 若量产工装需要自动复位或现场需要硬复位,建议同时引出RESET和电源控制;原理图完成后可提交合宙官方硬件评审。下载设计参考:https://docs.openluat.com/common/howtodown/

47. AT指令能否兼容LPAT到普通AT固件?需要改代码吗?

解答: 结论: 标准AT指令集在LPAT与普通AT固件间兼容,业务AT代码一般不需要修改。唯一例外: Air780E上AT+POWERMODE(PRO/PSM+低功耗)指令仅LPAT固件支持,而LPAT已停止更新;普通AT固件主推型号(Air780EPM/EQ等)原生支持AT+POWERMODE。建议: 新产品直接选用主推AT型号获得完整低功耗指令支持;Air780E老产品可用AT+CSCLK=3实现接近PRO模式的休眠效果。

48. Air780E从LPAT固件升级到普通AT固件后无法上线,是不支持PRO模式吗?

解答: 结论: Air780E普通AT固件不支持AT+POWERMODE指令(该指令仅LPAT固件支持,LPAT已停止维护),下发后会报错,但不会导致无法上线。排查方向: 无法上线与低功耗指令无关,请检查APN、SIM卡、天线驻网与服务器配置。低功耗替代: 普通AT固件下用AT+CSCLK=3进入慢时钟休眠,功耗与PRO模式接近;需要完整PRO/PSM+功能建议换用主推型号(Air780EPM/EQ等)。

49. 合宙模组支持哪些RTC芯片?

解答: 结论: 不限制RTC芯片型号。LuatOS内置rtc库操作模组内部RTC(rtc.set/rtc.get/rtc.timezone/rtc.setBaseYear);外接RTC通过I2C/SPI由脚本驱动,任何时序兼容的RTC芯片(PCF8563、DS3231等)均可移植。现有参考: 官方提供PCF8563T的demo(oldmodule/Air780E/demo/pcf8563t/,旧LuatOS-Air架构),新架构可按芯片寄存器手册用i2c库重新实现读写/闹钟逻辑。

50. APN没有用户名和密码,直接设置名称就可以吗?

解答: 结论: 可以。绝大多数物联网卡/普通卡的APN只需设置接入点名称,用户名和密码留空。LuatOS中通过mobile.apn设置或AT+CGDCONT配置时,按卡商提供的APN名称填入即可,认证字段留空。

51. 正常单链接接收数据有+IPD,但有时只有数据没有+IPD导致无法触发URC处理,什么原因?

解答: 结论: 单链接(CIPMUX=0)下"数据直出、没有+IPD头"是透传模式(CIPMODE=1)的正常表现,不是丢URC。原理: AT固件TCP连接有两种接收模式:CIPMODE=0时数据以+IPD头形式上报(便于MCU解析);CIPMODE=1为透传模式,收到的数据直接输出到串口、不带+IPD,需发"+++"退出透传。另外CIPQSEND=1快发模式下URC时序也可能变化。处理: 1)AT开发时确认并固定CIPMODE=0、CIPMUX=0,用AT+CIPMODE?查询;2)若做透传业务,应按透传协议直接接收数据流,不依赖+IPD;3)LuatOS脚本开发建议直接用socket库的接收回调取数据,不解析+IPD文本。AT指令说明:https://docs.openluat.com/atmozu/product/command/tcp/

52. SIP通话呼几次才能通一次,且报错busy,怎么处理?

解答: 结论: busy(486)通常是服务器重复发送INVITE请求,脚本未做去重,把同一次呼叫的重发当成新来电、在通话忙时又上报一次所致。处理: 在incoming来电事件中按Call-ID去重,相同Call-ID的重复INVITE不重复上报/不应答新会话,直接忽略。编码设置: exsip默认codecs为PCMU、PCMA(G.711),在config.lua中设置codec="PCMA"可与对端协商A律编码;注意LuatOS不支持G729。

53. SIP支持G729编码吗?

解答: 结论: 不支持G.729。LuatOS的exsip库(exsipproto协议层)仅内置G.711的两种编码:PCMU(G.711 u律,payload type 0)和PCMA(G.711 a律,payload type 8),默认codecs={"PCMU","PCMA"}。建议: 在SIP服务器/对端网关上配置编码协商优先级为PCMA/PCMU,由网关侧做G.729转码;终端侧无法通过配置开启G.729。

54. ES8311初始化失败,不插SIM卡就报错,插SIM卡才能正常初始化,是什么原因?

解答: 结论: ES8311初始化与SIM卡无软件关联,现象高度指向电源/时序问题:不插卡时上电时序或供电电流不同,导致codec供电/I2C通信异常。排查: 1)ES8311为I2C控制,先抓I2C波形确认ACK是否正常,检查SDA/SCL上拉(4.7k~10k)与供电时序;2)Air780EHV内置ES8311由GPIO20使能,外挂型号参考AirAUDIO_1010配件板设计(含复位时序:拉低→等待→拉高);3)确认供电纹波与VBAT峰值电流余量;4)按官方音频硬件设计核对原理图/PCB。配件资料:https://docs.openluat.com/accessory/airaudio_1010/

55. 合宙模组支持48kHz采样率吗?

解答: 结论: 非通话场景(本地录音/放音)ES8311 codec支持48kHz采样率,可按exaudio库的采样率参数配置。通话(SIP/VoLTE)场景音频编码为窄带/宽带语音(8kHz/16kHz),不使用48kHz。音频API说明:https://docs.openluat.com/osapi/core/audio/

56. Air8000的USIM_DET是哪个引脚?

解答: 结论: Air8000没有固定专用的USIM_DET引脚,SIM热插拔检测可用任意带中断的GPIO实现(如WAKEUP0、CHG_DET/WAKEUP6或其他WAKEUP/AGPIOWU引脚);单卡无热插拔需求时该脚可悬空不接。注意: 1)若借用CHG_DET(WAKEUP6)做检测,会触发上电自动开机行为;2)检测脚上拉不要接VDD_EXT(低功耗/PSM+下VDD_EXT不能保持输出),应上拉到可控的AGPIO Vref(PIN99/GPIO23)或AGPIO域。代码要点: gpio.debounce(引脚,500)消抖后gpio.setup(引脚, function(val) ... mobile.flymode/重新读卡 ... end)。Air780Exx系列USIM_DET为固定PIN79(WAKEUP2)。SIM硬件设计:https://docs.openluat.com/air8000/luatos/hardware/sim/

57. Air8201G-BLMO板子能直接插有源GNSS天线吗?

解答: 结论: 该版本板子对有源天线做了预留兼容,有源天线插入对应有源天线座即可由板上馈电正常工作。注意: 有源天线座与无源天线座不可混插——有源天线插到无源座会因无馈电而无法工作,无源天线插到有源座也可能影响匹配,插反会导致长时间无法定位。

58. 淘宝非官方买的模块怎么买LBS资源?

解答: 结论: 基站定位(LBS)资源按设备授权,需先把模块绑定到您自己的IoT账号下再购买授权。步骤: 登录合宙IoT平台,将模块IMEI添加/绑定到自己账号,然后按平台指引购买LBS服务。操作说明与计费方式见:https://docs.openluat.com/value/basestation/

59. Air780EPM长链接建立后下发消息监听不到,重连后才能收到,为什么?

解答: 结论: 长连接在线但收不到下发,通常是服务器侧连接句柄/会话与模组实际链路不一致(如NAT超时、中间网关断开但模组未感知、服务器仍把消息发到旧连接),重连后句柄刷新才能收到。处理: 1)参考官方低功耗长连接demo prj_0_tcp_long.lua(https://gitee.com/openLuat/LuatOS/tree/master/module/Air780EPM/demo/lowpower/prj),用sys.publish("TCP_CLIENT_RUN_REQ",true)管理连接、内置自动重连,并用SEND_DATA_REQ/RSP消息机制保证收发在同一有效链路上;2)应用层加心跳(建议间隔小于NAT会话超时,如60~120s)维持链路、及时检测死链并重连;3)服务器侧在下发前校验连接有效性,收到新连接注册时踢掉同设备旧会话;4)低功耗场景确认PSM/休眠唤醒后连接已重建再下发。

60. Air8000核心板插电脑USB无反应怎么供电启动?

解答: 结论: USB口可直接供电,需要正确操作开关与开机键。步骤: 1)Type-C接USB;2)板正面的供电/充电拨动开关拨到"供电"端;3)板背面USB ON/OFF开关拨到USB ON;4)长按开机键直到模组启动。注意(带充电IC版本): 快速上下电可能使充电管理IC误判短路而切断VBAT,导致无法开机/不识别USB/无法下载,此时应断电静置后再正常上电。参考:https://docs.openluat.com/air8000/product/shouce/

61. LuatOS开发从哪份资料开始,怎么新建工程?

解答: 结论: 按"环境→demo→教程→API文档"的顺序入门。路径: 1)安装Luatools并按烧录教程烧录官方固件与hello world(https://docs.openluat.com/common/howtodown/);2)到Gitee仓库对应型号demo目录(https://gitee.com/openLuat/LuatOS/tree/master/module)选现成demo跑通;3)按luatos_lesson系列教程学习工程结构(main.lua + 功能模块,require引用库);4)API与库说明查文档站osapi及各型号页面。文档站站内AI与官方企业微信群可答疑。

62. 进入低功耗后电流每秒波动两次是什么原因?

解答: 结论: 休眠电流周期性跳变说明有周期性事件在唤醒系统(软件定时器、串口/网络活动、外设未关断),不是休眠本身的问题。排查: 1)先烧官方低功耗demo(lowpower/prj)在官方开发板上测底电流,确认硬件基线正常;2)逐项关闭业务功能定位唤醒源:检查sys.timer周期任务、socket心跳、GNSS/音频/LCD等外设是否进入休眠前关闭;3)USB连接会影响电流测量,测低功耗电流请断开USB用稳压电源/电流表;4)外部上拉、电平倒灌也会导致电流抬高(见I2C倒灌相关条目)。

63. 合宙能接中移OneNET平台吗?DTU固件是否可通过设置接入?

解答: 结论: 可以接入OneNET。OneNET支持MQTT协议(MQTT 3.1.1),LuatOS内置mqtt库,按平台创建设备后获取产品ID/设备名/密钥(三元组),在脚本中按OneNET的MQTT连接报文格式(ClientID/Username/密码签名)填入即可登录并上报/订阅。说明: 官方暂无OneNET专用成品工程,可在官方mqtt demo基础上修改鉴权参数;DTU固件的透传/平台接入以官方DTU支持的平台列表为准,不支持的平台需自行脚本开发。

64. i2c0/i2c1有内部上拉吗?休眠时外部上拉电阻会倒灌电流怎么办?

解答: 结论: Air780EPM的I2C0无内部上拉,需外部上拉;I2C1板载G-Sensor占用,通信时引脚为高电平。倒灌处理(关键): 外部上拉电阻不要接到VDD_EXT——VDD_EXT在低功耗(pm.WORK_MODE,1)和PSM+(pm.WORK_MODE,3)下不能保持稳定输出,休眠时外设电源域与模组引脚压差会通过上拉电阻倒灌。方案: 1)上拉到可控的AGPIO Vref域(如Air8000的PIN99/GPIO23,AGPIO可固定输出高电平做Vref);2)上拉电源串入MOS管/负载开关,休眠前由GPIO切断外设电源;3)休眠前将I2C引脚置低/断开,参考Air8000低功耗demo drv_lowpower.lua的处理方式(https://gitee.com/openLuat/LuatOS/tree/master/module/Air8000/demo/lowpower)。

65. USB能否触发复位机制?luatools触发的是软复位吗?

解答: 结论: Luatools通过USB虚拟串口下发的是软件复位指令(软复位/重启进入下载模式),不是硬件复位。外部硬件复位有两种独立方式:拉低RESET引脚、或切断VBAT重新上电。建议: 量产工装若需要全自动控制,引出RESET引脚(或电源开关)由工装MCU控制,配合BOOT引脚可实现无人值守烧录;仅靠USB软复位在模组死机时可能失效。

66. 780E模块支持哪些型号的PCB贴片天线?哪个效果好些?

解答: 结论: 合宙提供AirANT1564、AirANT4073两款PCB贴片天线可选,阻抗均为50Ω,尺寸/频段略有差异。选型建议: 根据PCB净空区面积、布局方向选择尺寸合适的型号;天线性能高度依赖净空与匹配,建议由射频硬件工程师或天线厂家结合实际主板做匹配调试。选型与配件参数可在官方选型指南与淘宝店核对:https://docs.openluat.com/SelectionGuide/SelectionGuide/

67. Air8000的BLE支持125K Coded扩展广播吗?

解答: 结论: Air8000的BLE依赖WiFi协处理器提供,官方定位为蓝牙配网/softAP等近场配置场景,未开放125K Coded PHY(远距离扩展广播)等高级BLE特性配置,不建议用于对BLE功能深度定制的项目。建议: 仅做蓝牙配网、近场控制可使用;需要完整BLE 5.x Coded/长距离广播能力,建议选用合宙专用蓝牙模组(如Air5101系列)。WiFi/BLE功能说明:https://docs.openluat.com/air8000/luatos/app/wifi/

68. Air1602原理图审核好了吗?

解答: 结论: 原理图评审请通过官方硬件评审渠道提交(官方企业微信群/文档站入口),评审结果以官方回复为准。提交建议: 提交时附完整原理图PDF、PCB布局图、设计说明(供电、SIM、天线、外设连接),评审一般在收到资料后按顺序处理;急单可在群内说明项目节点。Air1601/1602硬件设计资料见文档站对应产品页。

69. 780ER3/4211的硬件手册、GPIO复用表、原理图参考在哪里?

解答: 结论: Air780ER2/ER3(4211平台)硬件资料统一在官方产品手册页,含硬件设计手册、GPIO复用表、参考设计:https://docs.openluat.com/air780er2/product/shouce/

70. 10寸屏幕必须要接转接板吗?转接板原理图有资料吗?

解答: 结论: 10.1寸屏(1024×600)为50PIN接口,在V1.1开发板上必须通过10寸屏转接板连接。注意: 转接板上交叉的是LCD显示线序,不是触摸(TP)线序,接线时按丝印区分LCD/TP座。

71. Air780EG还在出货吗?

解答: 结论: Air780EG属非主推老型号,可通过官方商务渠道采购,但不再有持续的技术支持与固件更新。建议: 新项目优先选用主推型号(如Air780EPM/EHM等),文档、固件与技术支持均有保障,选型参考:https://docs.openluat.com/SelectionGuide/SelectionGuide/

72. Air780EGP的I2C1为什么不用也会输出高电平?

解答: 结论: I2C1被板载G-Sensor占用,系统运行时会周期性与G-Sensor通信,SDA/SCL呈现高电平(I2C空闲态)属正常现象。说明: 若业务未使用I2C1,可在软件中关闭G-Sensor相关功能/不初始化该I2C总线;如仍需该组引脚做其他用途,需确认与板载G-Sensor不冲突或选用其他引脚。

73. DTU不见了/不用充值了吗?

解答: 结论: iRTU(DTU)固件已免费开放,不再需要充值,可直接下载固件与源码使用。资料在官方文档站iRTU相关页面获取。

74. 模块烧录时提示脚本空间不足/下载不了底层库是什么原因?

解答: 结论: 所选固件的脚本分区容量小于脚本+库总大小。处理: 1)在Luatools固件列表中选择脚本空间更大的固件版本(同一型号通常提供不同脚本空间规格);2)精简脚本:移除未使用的库、压缩资源文件;3)用最新版Luatools重新下载,排除临时文件导致的容量误报。

75. Air8000A自己画的板子串口无数据,测试程序在开发板正常,是硬件问题吗?

解答: 结论: 同一固件在开发板正常、自制板异常,基本可锁定为自制板硬件问题。排查: 1)抓开机日志,若无任何打印,检查模组供电(VBAT峰值2A能力)、开机时序、底部焊盘是否虚焊/连锡(LGA焊接不良最常见);2)若有启动日志但WiFi相关异常,搜AIRLINK_READY判断协处理器状态,先按"先烧WiFi固件、再烧LuatOS固件"流程重烧;3)对照官方硬件设计检查复位/BOOT/电源走线。重点排查模组底部及WiFi相关焊盘焊接质量。

76. Air780EHM支持ILI9488屏吗?

解答: 结论: Air780EHM的SPI LCD接口(固定PIN49~53,最大支持320×480分辨率)官方已调试适配的屏驱IC清单为:ST7735、ST7735S、ST7789、ST7796、ILI9341、ILI9486、GC9306,不含ILI9488,因此没有现成驱动。可移植方案: ILI9488与ILI9486同为SPI接口320×480屏,初始化流程相近,可参考官方lcd_custom_drv.lua自定义驱动,用lcd.cmd()按ILI9488手册编写初始化序列、调整分辨率与偏移参数后移植。LCD硬件设计与适配说明:https://docs.openluat.com/air780epm/luatos/hardware/lcd/

77. Air8101有AT指令的4G+WiFi+蓝牙+定位一体模块吗?

解答: 结论: 该类一体化需求没有AT固件版本对应产品;用LuatOS脚本二次开发推荐选用Air8000A(4G + WiFi6 + BLE5.4 + GNSS + G-sensor)。Air8000A支持蓝牙配网/softAP与socket/mqtt等完整网络能力,选型见:https://docs.openluat.com/SelectionGuide/SelectionGuide/

78. Air8000固件V2048什么时候发布?

解答: 结论: 固件发布时间以官方固件下载页及Luatools固件列表实际放出为准,请不要依据未发布的版本号安排量产计划。建议: 需要新音频框架(audio_mode="new")等特性的项目,在固件列表出现V2048或更新正式版本后再升级验证;发布进度可关注文档站或官方企业微信群通知。

79. 旧LuatOS-Air固件为什么没有soc文件输出?

解答: 结论: 老一代LuatOS-Air(AT架构,如Air724UG)固件本身不输出soc文件;soc是新架构LuatOS固件的量产打包格式。量产时请在Luatools中选择与型号对应的量产固件目录,按老架构固件的烧录方式生产即可,无需寻找soc文件。

80. 能否用模拟器运行MP3播放demo,但烧录到板子后反复掉线且烧不进新程序?

解答: 结论: MP3播放依赖硬件音频通路,PC模拟器只能验证业务逻辑流程,音频效果必须以真机为准;烧录到板子后反复掉线、无法再烧录,按烧录异常处理。步骤: 1)关闭PC蓝牙(蓝牙会占用/干扰USB串口),删除Luatools目录下_temp临时目录;2)强制进入下载模式:板子断电→Luatools点"下载"→按住BOOT键不松→上电,必要时长按开机键,用USB连接烧录(串口烧录不能救砖);3)换优质短USB数据线直连电脑后置USB口,确认驱动正常、Luatools为最新版且放在纯英文路径;4)先只烧底层core固件,成功后再烧脚本,定位是固件还是脚本导致复位。参考烧录教程:https://docs.openluat.com/common/howtodown/

81. 烧录demo后板子反复掉线,连新core和脚本都烧不进去怎么解决?(换了2台Win10电脑也一样)

解答: 结论: 多台电脑复现说明问题在板子端或烧录方式,按强制下载流程救回。步骤: 1)关闭PC蓝牙、删除Luatools的_temp目录、Luatools放纯英文路径(如D:\luatools);2)严格按下载时序操作:板子断电→Luatools点"下载"→按住BOOT不松→上电→开始下载后松开,必要时长按开机键;3)必须用USB口烧录(救砖不支持串口),换短数据线直连电脑后置USB口,确认驱动正常;4)先单独烧core固件验证,成功后再烧脚本。完整步骤见:https://docs.openluat.com/common/howtodown/

82. 模组开机会重启/死机,日志显示sys内存一直增长,可能是什么原因?

解答: 结论: sys内存持续增长是内存泄漏特征,需定位反复执行的代码路径。排查: 1)已知lcd.setFontFile循环调用会重复装载字库导致内存增长,应只在初始化时调用一次(或改用内置hzfont字库);2)用PC模拟器挂测1小时观察sys内存曲线,若模拟器稳定则泄漏点可能在硬件相关回调;3)检查是否有循环内创建大buffer、socket/uart数据未消费、定时器重复注册未关闭、字符串拼接累积等;4)定期打印内存(memory库)定位增长时刻对应的业务操作。

83. Air8000控制射频供电的硬件版本,是否可通过打开某个GPIO让供电正常?

解答: 结论: 不要盲目拉高GPIO尝试,射频供电控制与具体硬件版本电路相关,需以对应版本原理图为准。处理步骤: 1)抓开机日志确认硬件版本号;2)对照该版本原理图确认射频供电使能方式与有效电平;3)升级最新正式固件验证;4)提供硬件版本号与原理图联系官方技术支持确认。

84. Luatools更新固件后docs是否需要手动更新?

解答: 结论: 在线文档(docs.openluat.com)随版本持续更新,直接以文档站最新内容为准,无需手动更新本地副本。建议: 升级固件后查看该版本固件修改记录(release notes),确认所用API是否有参数或行为变更,并对照最新文档调整代码。

85. iRTU源码固件选择多大脚本空间的版本?

解答: 结论: iRTU源码功能库较多(含libgnss等),应选择脚本空间较大的固件版本(如103号等大空间版本),否则烧录时会提示脚本空间不足。说明: 裁剪功能后仍超出容量,则精简未使用的库与资源文件,或选择同型号更大脚本空间的固件。

86. 780EPM能同时用iRTU和摄像头吗?

解答: 结论: 目前没有同时集成iRTU与CAMERA功能的固件(两者资源占用大)。可行方案: 1)在iRTU周期唤醒后的运行窗口内初始化摄像头、完成拍照上传,再进入低功耗;2)选用内存/脚本空间更大的兼容型号(如Air780EHM,支持libgnss且空间更大)承载更多功能。

解答: 结论: Air8000T是纯4G型号,不带WiFi/BLE硬件,airui依赖的WiFi airlink链路在该型号上必然为false;单独network_airlink用4G通道所以正常。另外: airui demo中reset、bl引脚可能与UART3引脚冲突,复用WiFi相关引脚时需按实际硬件调整。需要WiFi/BLE请选Air8000A/W(见选型指南:https://docs.openluat.com/SelectionGuide/SelectionGuide/ )。

解答: 结论: 不能解决,反而会失去WiFi能力——Air8000T为纯4G型号,不支持WiFi/BLE,airui的WiFi airlink在8000T上无法工作。建议: 排查8000W的WiFi协处理器初始化(日志搜AIRLINK_READY、按"先烧WiFi固件再烧LuatOS固件"流程重烧、升级最新WiFi固件);需要同时给Air1602供网的场景,按主控网络需求在选型指南中选择对应型号:https://docs.openluat.com/SelectionGuide/SelectionGuide/

89. Air8000D进入低功耗后电流跳动是什么原因?

解答: 结论: 电流跳动说明有周期性唤醒源或外设未关断。排查: 1)先烧官方低功耗demo(lowpower)在开发板上验证底电流基线;2)逐项关闭业务定位:定时器周期任务、socket心跳/重连、GNSS/音频/LCD/G-Sensor是否在休眠前关闭;3)测电流时断开USB,用稳压电源+电流表测量;4)检查外部上拉倒灌(上拉应改到可控AGPIO域,而非休眠掉电的VDD_EXT);5)Air8000D无WiFi/BLE,不存在协处理器功耗。参考低功耗demo:https://gitee.com/openLuat/LuatOS/tree/master/module/Air8000/demo/lowpower

90. Air780EQ偶发收到数据没有+IPD导致无法处理,可能是什么问题?

解答: 结论: 偶发无+IPD头、数据直接输出,通常是连接处于透传模式(CIPMODE=1)或快发模式(CIPQSEND=1)下URC上报时机变化,属于AT固件接收模式行为。处理: 1)用AT+CIPMODE?查询并固定CIPMODE=0(非透传,数据带+IPD头)、CIPMUX=0单链接;2)MCU解析侧增加容错:既解析"+IPD"格式也能处理裸数据流;3)检查是否意外进入透传(发"+++"退出);4)若用LuatOS脚本开发,直接用socket库接收回调取数,不依赖+IPD文本。AT指令文档:https://docs.openluat.com/atmozu/product/command/tcp/

91. oAuth更新后接入代码需要更新吗?

解答: 结论: 需要。oAuth体系更新后各工具使用独立的key/凭证,不与其他项目共用,接入代码需更换为新申请凭证,并按新鉴权流程获取token。说明: Luatools与文档站登录也已接入同一套oAuth,授权失效时重新登录授权即可。

92. 外接G-Sensor或I2C设备时休眠会倒灌电流,能去掉外部上拉电阻吗?

解答: 结论: 不能直接去掉I2C上拉(去掉后I2C无法通信),正确做法是把上拉改到休眠时可控的电源域。原理: I2C需要4.7k~10k上拉电阻,若上拉到VDD_EXT,模组进入低功耗(WORK_MODE,1)/PSM+(WORK_MODE,3)后VDD_EXT不能保持输出,而外设侧仍有电,电流经上拉电阻倒灌入模组引脚。方案: 1)上拉到AGPIO可固定输出的Vref域(Air8000可用PIN99/GPIO23作为Vref,休眠保持高电平);2)上拉电源经MOS管/负载开关由GPIO控制,休眠前断电;3)休眠前软件将I2C引脚置为匹配电平,避免压差。参考Air8000低功耗demo drv_lowpower.lua:https://gitee.com/openLuat/LuatOS/tree/master/module/Air8000/demo/lowpower

93. Luatools安装/打开出现清理临时目录失败怎么解决?

解答: 结论: 临时目录被占用或权限不足导致清理失败。步骤: 1)关闭Luatools及所有占用串口的软件后,手动删除Luatools目录下_temp文件夹再重新打开;2)仍失败则将Luatools放到纯英文路径(如D:\luatools)运行;3)以管理员权限运行Luatools;4)确认磁盘剩余空间充足。

94. 合宙物联网卡怎么买?

解答: 结论: 通过合宙官方渠道购买:1)合宙官方淘宝店(https://luat.taobao.com/ )选购物联网卡;2)通过文档站底部官方企业微信群联系商务,咨询套餐与批量采购。开卡后按运营商APN配置即可使用。

95. 合宙有成品带外壳的DTU吗?

解答: 结论: 成品形态以官方淘宝店(https://luat.taobao.com/ )在售商品为准。当前iRTU固件已免费开放,可选购合宙DTU/核心板配合外壳组装使用;成品DTU最新供货情况可在官方企业微信群向商务确认。

96. Air8000核心板带充电IC版本能否通过GPIO控制射频供电?

解答: 结论: 射频供电控制方式取决于具体硬件版本电路,不能仅凭GPIO号操作。步骤: 1)抓开机日志获取硬件版本号;2)对照该版本原理图确认射频供电使能脚与有效电平;3)升级最新正式固件验证(固件已对新版本硬件适配);4)若确认硬件版本存在供电缺陷,联系官方售后换板。

97. Air8000 V2048固件什么时候发布?

解答: 结论: 固件发布时间以官方固件下载页及Luatools固件列表实际放出为准,请不要依据未发布的版本号安排量产计划。建议: 需要新音频框架(audio_mode="new")等特性的项目,在固件列表出现V2048或更新正式版本后再升级验证;发布进度可关注文档站或官方企业微信群通知。

98. 1601下载慢是什么原因?

解答: 结论: Air1601下载口(USB1)使用CH343 USB转串口芯片,下载速率由链路自动协商,下载慢通常是USB链路质量、驱动或PC蓝牙干扰导致,而非固件本身。处理: 1)安装CH343官方驱动(注意不是CH340驱动):https://docs.openluat.com/air1601/luatos/common/swenv/#21-ch343 ;2)换优质短USB数据线,直连电脑后置USB口,避免USB Hub;3)关闭PC蓝牙,删除Luatools目录下_temp后重试;4)使用最新版Luatools及最新正式固件。

搜索