OpenSource-Ai-Glasses

# 固件烧录指南

[English](FIRMWARE_FLASHING.en.md) | 中文

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

## ⚠️ 重要提示

> **设备已预装固件**: 您收到的 AI 智能眼镜设备通常已经预先烧录好了出厂固件，**可以直接使用**。
>
> **只有在以下情况下才需要重新烧录固件**:
> - 🔧 您修改了固件代码并需要测试新功能
> - 🐛 需要修复系统问题或升级系统版本
> - 🔄 设备系统损坏需要恢复
> - 🆕 需要安装特定版本的固件
>
> **如果您是首次使用设备，建议先参考 [快速入门指南](tutorials/beginner/getting-started.md) 直接开始应用开发。**

## 📋 前置要求

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

### 软件要求
- 已编译的固件文件（update.img）
- SocToolKit 烧录工具
- ADB 工具（Android Debug Bridge）

## 🔧 准备工作

### 1. 获取固件文件

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

- #### 从 Github 下载
   ```bash
   https://github.com/Iam5tillLearning/OpenSource-Ai-Glasses/releases
   ```

- #### 自行编译（主机环境）

   ```bash
   # 在 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:**
```bash
tools/Windows/SocToolKit/SocToolKit.exe
```

**Linux:**
```bash
tools/Linux/SocToolKit/SocToolKit
```

### 第二步：选择芯片型号

在 SocToolKit 界面中：
1. 找到芯片选择下拉菜单
2. 选择 **RV1106B** 芯片型号
![alt text](Images/SocToolKit-1.png)

### 第三步：连接设备

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

### 第四步：进入烧录模式

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

#### 方式一：通过命令进入

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

2. 输入以下命令进入设备交互命令行：
   ```bash
   adb shell
   ```

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

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

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

> **排障提示**: 如果执行 `reboot loader` 后设备没有立即重启，甚至一直无法进入刷机模式，请回到主机侧执行以下命令检查当前进程：
>
> ```bash
> adb shell top
> ```
>
> 如果看到有应用名或进程名以 `{` 开头，记下对应 PID 后执行：
>
> ```bash
> adb shell kill -9 <PID>
> ```
>
> 然后重新执行 `reboot loader`。这通常意味着某个开机脚本没有正常运行完毕，系统被卡死，导致无法顺利切入刷机模式。

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

适用场景：
- 设备无法正常启动
- `adb` 不可用
- `reboot loader` 长时间不生效

1. 先确保设备处于完全断电状态：
   - 将设备电源开关拨到关闭
   - 断开设备与电脑之间的 USB 连接
2. 找到镜腿圆孔内的刷机按钮：

   ![刷机键位置](Images/刷机键.jpg)

3. 使用牙签等非金属尖细物按住该刷机按钮，不要松开
4. 在保持按住按钮的同时，用 USB 数据线将设备连接到电脑
5. 等待 SocToolKit 中识别到设备后，再松开刷机按钮
6. 设备出现在刷机工具中后，即可继续后续烧录步骤

### 第五步：确认设备连接

在 SocToolKit 界面中：
- 查看 **USB设备** 区域
- 确认设备已被识别并显示在列表中
![alt text](Images/SocToolKit-2.png)

### 第六步：选择固件文件

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

### 第七步：开始烧录

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

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

### 第八步：烧录完成

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

## ✅ 验证烧录

### 方法一：通过 ADB 验证

```bash
# 连接设备
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 即将上线，后续会提供更便捷的配网入口。

## 🔄 完整烧录流程图

```mermaid
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[开始应用开发]
```

## 🛠️ 常见问题

### 1. ADB 连接不上设备

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

**解决方案**:
```bash
# 检查设备连接
adb devices

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

# 再次检查设备
adb devices
```

### 2. 设备未进入 loader 模式

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

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

### 3. SocToolKit 无法识别设备

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

**解决方案**:
- 确认已选择正确的芯片型号（RV1106B）
- 检查 USB 驱动是否正确安装（Windows 系统）
- 尝试以管理员权限运行 SocToolKit（Windows 系统）
- 在 Linux 系统上检查 USB 设备权限：
  ```bash
  # 查看 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. **开发应用程序**
   - 参考 [应用开发指南](APPLICATION_DEVELOPMENT.md)
   - 使用交叉编译工具链开发用户级应用
   - 通过 ADB 部署和调试程序

2. **配置系统**
   - 配置网络连接
   - 设置系统参数
   - 安装必要的软件包

3. **测试验证**
   - 运行测试用例
   - 验证硬件功能
   - 性能测试

4. **调试开发**
   - 通过 ADB 进行日志调试
   - 使用 GDB 进行程序调试
   - 性能分析和优化

## 📚 相关文档

- [开发环境搭建指南](ENV_SETUP.md) - 开发环境搭建
- [应用开发指南](APPLICATION_DEVELOPMENT.md) - 应用程序开发入门
- [固件开发指南](firmware/getting-started.md) - 固件开发入门
- [故障排除](troubleshooting/common-issues.md) - 常见问题解决

## 📞 获取帮助

如果遇到烧录问题：
- 📖 查阅本文档的常见问题部分
- 💬 在 [GitHub Issues](https://github.com/Iam5stillLearning/OpenSource-Ai-Glasses/issues) 提问
- 📧 发送邮件至: iam5stilllearning@foxmail.com
- 💡 查看 [故障排除文档](troubleshooting/common-issues.md)

---

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