Air724UG 客户使用教程

按顺序完成驱动安装、配置生成、文件导入和设备启用。

交付文件
config.bin
配置方式
网页生成
存放位置
设备U盘根目录

客户下载入口

脚本与驱动下载

驱动、设备脚本和现场所需文件请从网盘下载。客户使用时不需要访问 GitHub，也不需要拿到源码仓库。

打开网盘下载

2. 准备内容

先确认手上有设备、SIM卡、数据线和客户通知参数。

设备与网络

准备 Air724UG 设备、可用 SIM 卡、USB 数据线和可联网电脑。SIM 卡需能收短信，若需要来电通知，还需确认语音功能正常。

客户参数

至少准备配置名称、通知类型和对应密钥。若客户要求来电处理、短信录音或状态灯策略，也一并确认。

交付文件

现场最终只交付 config.bin。客户不需要导入 config.lua，也不需要拿到网页源码。

3. 安装驱动

电脑首次连接设备无法识别串口时，先安装对应 Windows 驱动。

  1. 确认电脑系统版本。Windows 10/11 优先使用 driver/DriversForWin10，Windows 7/8 使用 driver/DriversForWin78。
  2. 64 位系统运行 DPInst64.exe，32 位系统运行 DPInst32.exe。请右键选择“以管理员身份运行”。
  3. 安装完成后重新插拔设备，打开设备管理器，确认出现 Air724UG 相关串口或 USB 设备。
  4. 如果之前安装过异常驱动，可先运行 DriverUninstall64.exe 或 DriverUninstall32.exe 卸载，再重新安装。
注意

安装和卸载驱动都需要管理员权限。驱动正常后，设备后续导入 config.bin 不需要重复安装。

4. 生成配置

打开配置生成器，按客户信息填写，再导出 config.bin。

  1. 进入 配置生成器 页面。
  2. 填写“配置名称 / 客户标识”，例如客户名称、门店编号或项目编号。
  3. 导出格式保持 JSON 安全配置。除非维护旧设备，一般不要切换到旧版 Lua 兼容。
  4. config.bin 密钥 默认是 jocry。若设备端更改过密钥，网页里必须填写相同密钥。
  5. 按客户需求设置“开机通知”“来电动作”“本机号码”等现场常用项。
  6. 点击“设备参数”“短信录音”“本机预设”，在小窗口中填写不常改的参数。
  7. 点击 导出 config.bin，保存生成的配置文件。
文件规则

设备识别的文件名必须是 config.bin。不要改成客户名、日期名或其他后缀。

5. 通知设置

通知类型先勾选，再进入对应小窗口填写二级参数。

通用步骤

在“通知类型”区域勾选客户需要的渠道，然后点击同一行的“设置”。每一种通知类型都有自己的设置小窗口。

常见渠道

Bark、Custom POST、Telegram、PushDeer、DingTalk、Feishu、WeCom、Pushover、iNotify、SMTP、Gotify、ServerChan 都在各自窗口内填写参数。

  1. 只勾选客户实际使用的通知渠道，未使用的渠道保持不勾选。
  2. 通知密钥、Webhook、Token、邮箱账号等敏感内容只填写在对应小窗口里。
  3. 多个渠道可以同时启用，设备会按配置逐项通知。
  4. “通知头”“号码末尾位数”“兜底通知头”用于整理推送标题，现场一般保持默认即可。

6. 导入旧配置

本页面只支持导入 config.bin，不再支持导入 config.lua。

  1. 打开“本机预设”小窗口。
  2. 点击“导入 config.bin”，选择已有的 config.bin。
  3. 如果导入失败，先检查网页里的 config.bin 密钥 是否与该文件生成时使用的密钥一致。
  4. 导入成功后，检查客户名称、通知类型和二级通知参数，再重新导出新的 config.bin。
不要导入 config.lua

客户现场通常只持有 config.bin。为避免文本编码和旧脚本差异造成误判，页面已取消 config.lua 导入方式。

7. 设备启用

把生成好的 config.bin 放到设备暴露的 U 盘根目录。

  1. 设备端脚本需已烧录完整 script/ 目录，包含 main.lua、config.lua、usbmsc.lua、utils/、handler/、lib/ 和 audio/。
  2. 将设备连接电脑，等待出现设备 U 盘或可写入的 USB 存储。
  3. 把网页导出的 config.bin 复制到设备 U 盘根目录。
  4. 安全弹出 U 盘或断开 USB，重启设备。
  5. 设备启动后会读取 /usbmsc0/config.bin，解密并加载配置。
烧录提醒

烧录设备脚本时保持 script/ 原有文件夹结构，不要把文件全部打散放在同一层。

8. 验收检查

配置下发后，按下面几项快速确认现场是否可交付。

开机设备能正常入网，状态灯按配置工作。
短信向 SIM 卡发送测试短信，确认指定通知渠道收到内容。
来电拨打设备号码，确认来电动作、录音或挂断策略符合客户要求。
通知检查通知标题、号码末尾位数和设备信息附加内容是否符合预期。
文件客户最终只保留本次确认可用的 config.bin。

9. 常见问题

现场最常遇到的问题，先按这里排查。

导入 config.bin 提示解密失败怎么办？

先检查网页里的 config.bin 密钥。密钥必须和生成该文件时使用的密钥一致。仍失败时，重新从原配置页面导出新的 config.bin。

为什么不能导入 config.lua？

现场交付以 config.bin 为准。取消 config.lua 导入可以避免旧脚本格式、编码和客户误操作造成的导入异常。

设备没有出现 U 盘或串口怎么办？

先更换 USB 线和 USB 口，再检查驱动是否安装。Windows 下可重新运行对应系统目录里的 DPInst64.exe 或 DPInst32.exe。

通知没有收到怎么办？

确认通知类型已勾选，并进入对应“设置”窗口填写了 Token、Webhook、邮箱或 Key。再检查 SIM 卡网络、设备信号和客户通知服务是否可用。

什么时候使用旧版 Lua 兼容？

只有设备端还没更新到 JSON 安全配置解析时才使用。新设备和已升级设备保持默认的 JSON 安全配置。