Skip to content

FIRMWARE_FLASHING.md

Latest commit

 

History

History
398 lines (295 loc) · 10.8 KB

FIRMWARE_FLASHING.md

File metadata and controls

398 lines (295 loc) · 10.8 KB
Raw

固件烧录指南

English | 中文

本文档介绍如何将编译好的固件烧录到 AI 智能眼镜设备中。

⚠️ 重要提示

设备已预装固件: 您收到的 AI 智能眼镜设备通常已经预先烧录好了出厂固件，可以直接使用。

只有在以下情况下才需要重新烧录固件:

  • 🔧 您修改了固件代码并需要测试新功能
  • 🐛 需要修复系统问题或升级系统版本
  • 🔄 设备系统损坏需要恢复
  • 🆕 需要安装特定版本的固件

如果您是首次使用设备，建议先参考 快速入门指南 直接开始应用开发。

📋 前置要求

硬件要求

  • AI眼镜开发者样机一台（购买请联系邮箱）
  • USB 数据线（用于连接设备和主机）
  • 开发主机（Windows/Linux）

软件要求

  • 已编译的固件文件（update.img）
  • SocToolKit 烧录工具
  • ADB 工具（Android Debug Bridge）

🔧 准备工作

1. 获取固件文件

有两种方式可以获得固件：

  • 从 Github 下载

    https://github.com/Iam5tillLearning/OpenSource-Ai-Glasses/releases

  • 自行编译（主机环境）

    # 在 AIGLASS_DEV_ENV 根目录编译
./setup_build_env.sh

# 二选一
# 设备带显示能力（默认）
./build.sh

# 设备不带显示能力
./build.sh --without-display

# 固件产物路径
ls -lh output/image/update.img

2. 准备烧录工具

SocToolKit 烧录工具位于项目的 tools 目录下，根据你的操作系统选择对应版本：

tools/
├── Windows/
│   └── SocToolKit/
│       └── SocToolKit.exe
└── Linux/
    └── SocToolKit/
        └── SocToolKit

📝 烧录步骤

第一步：启动 SocToolKit

根据你的操作系统，运行对应的 SocToolKit 工具：

Windows:

tools/Windows/SocToolKit/SocToolKit.exe

Linux:

tools/Linux/SocToolKit/SocToolKit

第二步：选择芯片型号

在 SocToolKit 界面中：

  1. 找到芯片选择下拉菜单
  2. 选择 RV1106B 芯片型号 alt text

第三步：连接设备

  1. 使用 USB 数据线将 AI 智能眼镜连接到开发主机
  2. 等待约 10 秒，让系统识别设备

第四步：进入烧录模式

你可以任选以下两种方式进入刷机模式。

方式一：通过命令进入

  1. 打开终端/命令提示符窗口

  2. 输入以下命令进入设备交互命令行：

    adb shell

  3. 成功连接后，你会看到设备的命令行提示符

  4. 在设备命令行中输入以下命令进入烧录模式：

    reboot loader

  5. 等待几秒钟，设备通常会重启进入 loader 模式；如果长时间没有反应，请先参考下面的排障提示。

排障提示: 如果执行 reboot loader 后设备没有立即重启，甚至一直无法进入刷机模式，请回到主机侧执行以下命令检查当前进程：

adb shell top

如果看到有应用名或进程名以 { 开头，记下对应 PID 后执行：

adb shell kill -9 <PID>

然后重新执行 reboot loader。这通常意味着某个开机脚本没有正常运行完毕，系统被卡死，导致无法顺利切入刷机模式。

方式二：通过硬件刷机按钮进入

适用场景：

  • 设备无法正常启动
  • adb 不可用
  • reboot loader 长时间不生效

  1. 先确保设备处于完全断电状态：

    • 将设备电源开关拨到关闭
    • 断开设备与电脑之间的 USB 连接

  2. 找到镜腿圆孔内的刷机按钮：

    刷机键位置

  3. 使用牙签等非金属尖细物按住该刷机按钮，不要松开

  4. 在保持按住按钮的同时，用 USB 数据线将设备连接到电脑

  5. 等待 SocToolKit 中识别到设备后，再松开刷机按钮

  6. 设备出现在刷机工具中后，即可继续后续烧录步骤

第五步：确认设备连接

在 SocToolKit 界面中：

  • 查看 USB设备 区域
  • 确认设备已被识别并显示在列表中 alt text

第六步：选择固件文件

  1. 在 SocToolKit 界面中点击 "固件..." 按钮
  2. 在弹出的文件选择对话框中，导航到固件所在目录
  3. 选择刚刚编译出来的 update.img 文件
  4. 点击 "打开" 确认选择

第七步：开始烧录

  1. 确认固件路径正确显示在界面中
  2. 点击 "升级" 按钮开始烧录
  3. 等待烧录进度条完成

烧录过程中：

  • ⏳ 请保持 USB 连接稳定
  • ⚠️ 不要断开设备电源
  • ⚠️ 不要关闭 SocToolKit 工具
  • 📊 观察进度条和日志信息

第八步：烧录完成

  1. 当烧录进度达到 100% 时，工具会提示烧录成功
  2. 设备将自动重启
  3. 等待设备启动完成（约 10 秒）

✅ 验证烧录

方法一：通过 ADB 验证

# 连接设备
adb shell

# 查看设备状态
uname -a

方法二：通过设备功能验证

  1. 检查设备显示是否正常
  2. 检查摄像头功能是否正常
  3. 检查音频功能是否正常
  4. 按下方“首次配网检查”完成联网验证

首次配网检查（重要）

  1. 确认路由器已开启 2.4GHz Wi-Fi，手机已连接到目标 2.4GHz 网络。
  2. 在 Android 手机的 Wi-Fi 设置里，对当前网络点击“分享”，生成 Wi-Fi 二维码。
  3. 让眼镜进入配网模式（开机未联网自动进入，或连续短按按键 10 次手动进入）。
  4. 将手机上的二维码展示给眼镜扫描，等待设备提示配网成功。
  5. 如果二维码来自 5GHz/5G 网络，设备无法连接，请切换到 2.4GHz 后重新分享二维码。

手机端 App 即将上线，后续会提供更便捷的配网入口。

🔄 完整烧录流程图

graph TD
    A[编译固件] --> B[拷贝 update.img 到本机]
    B --> C[启动 SocToolKit]
    C --> D[选择芯片 RV1106B]
    D --> E[USB 连接设备]
    E --> F[等待 10 秒]
    F --> G[执行 adb shell]
    G --> H[执行 reboot loader]
    H --> I[确认设备在 SocToolKit 中显示]
    I --> J[点击'固件...'选择 update.img]
    J --> K[点击'升级'开始烧录]
    K --> L[等待烧录完成]
    L --> M[设备自动重启]
    M --> N[验证烧录结果]
    N --> O[开始应用开发]
Loading

🛠️ 常见问题

1. ADB 连接不上设备

问题: 执行 adb shell 时提示设备未找到

解决方案:

# 检查设备连接
adb devices

# 如果没有设备，尝试重启 adb 服务
adb kill-server
adb start-server

# 再次检查设备
adb devices

2. 设备未进入 loader 模式

问题: 执行 reboot loader 后，设备没有立即重启，或长时间无法进入 loader 模式，SocToolKit 中没有显示设备

解决方案:

  • 先在主机侧执行以下命令，检查当前是否有以 { 开头的异常应用名或进程名： 
    adb shell top
  • 如果存在此类进程，记下 PID 后执行： 
    adb shell kill -9 <PID>
  • 杀掉异常进程后，再次执行 reboot loader
  • 该现象通常说明某个开机脚本没有正常运行完毕，系统处于卡死状态
  • 如果设备无法正常启动、adb 不可用，或软件方式始终无效，可直接改用上文“方式二：通过硬件刷机按钮进入”
  • 检查 USB 连接是否稳定
  • 尝试更换 USB 端口
  • 尝试更换 USB 数据线
  • 等待更长时间（有时需要 30 秒）
  • 手动重启设备后再次尝试

3. SocToolKit 无法识别设备

问题: 设备已连接但 SocToolKit 不显示

解决方案:

  • 确认已选择正确的芯片型号（RV1106B）
  • 检查 USB 驱动是否正确安装（Windows 系统）
  • 尝试以管理员权限运行 SocToolKit（Windows 系统）
  • 在 Linux 系统上检查 USB 设备权限： 
    # 查看 USB 设备
lsusb

# 添加 udev 规则（如需要）
sudo nano /etc/udev/rules.d/99-rockchip.rules

4. 烧录过程中断

问题: 烧录进度条卡住或报错

解决方案:

  • 检查 USB 连接是否稳定
  • 检查固件文件是否完整（对比文件大小和 MD5）
  • 确保磁盘空间充足
  • 重新编译固件并重试
  • 尝试降低 USB 传输速度（在 SocToolKit 设置中）

5. 烧录完成但设备无法启动

问题: 烧录成功但设备开机黑屏或无反应

解决方案:

  • 等待更长时间（首次启动可能需要 2-3 分钟）
  • 检查固件是否与硬件版本匹配
  • 尝试重新烧录
  • 检查设备硬件连接（电池、屏幕等）
  • 通过串口查看启动日志（如有串口调试功能）

6. Windows 系统驱动问题

问题: Windows 系统无法识别设备

解决方案:

  1. 下载并安装 Rockchip USB 驱动
  2. 在设备管理器中检查设备状态
  3. 更新或重新安装驱动程序
  4. 禁用驱动签名验证（仅用于测试）

7. 固件版本回退

问题: 需要烧录旧版本固件

解决方案:

  • 使用相同的烧录步骤
  • 选择旧版本的 update.img 文件
  • 烧录前备份当前配置（如有需要）

💡 最佳实践

烧录前

  • ✅ 确保固件编译无错误
  • ✅ 备份重要数据和配置
  • ✅ 充满设备电池（至少 50%）
  • ✅ 准备稳定的 USB 连接环境
  • ✅ 验证固件文件的完整性

烧录中

  • ✅ 保持电脑和设备电源稳定
  • ✅ 不要移动或触碰设备
  • ✅ 观察烧录日志信息
  • ✅ 耐心等待完成，不要中断

烧录后

  • ✅ 验证设备功能完整性
  • ✅ 记录固件版本信息
  • ✅ 保存烧录日志（如遇问题）
  • ✅ 测试关键功能模块

🚀 下一步

固件烧录完成后，你可以：

  1. 开发应用程序

    • 参考 应用开发指南
    • 使用交叉编译工具链开发用户级应用
    • 通过 ADB 部署和调试程序

  2. 配置系统

    • 配置网络连接
    • 设置系统参数
    • 安装必要的软件包

  3. 测试验证

    • 运行测试用例
    • 验证硬件功能
    • 性能测试

  4. 调试开发

    • 通过 ADB 进行日志调试
    • 使用 GDB 进行程序调试
    • 性能分析和优化

📚 相关文档

📞 获取帮助

如果遇到烧录问题：

最后更新: 2025-11-11 | 版本: v1.0.0