官方提供了Windows、Linux和Mac环境下的烧录工具。其中泰山派文档中主要介绍的是Windows下的烧录步骤。然而由于开发是在Linux下,如果烧录的话还需要切换到Windows,这十分的不方便。因此,本节介绍在Linux环境中,如何使用官方提供的update_tool工具来完成固件烧录,包括工具安装、设备连接、进入升级模式、烧写固件及后续测试。
工具安装
在泰山派提供的网盘链接中的“第7章、开发工具”目录下,找到“Linux_Upgrade_Tool_v1.65.zip”,链接如下:
https://pan.baidu.com/s/1HtnpytCBBqBOqZi8mfV4VQ?pwd=qcxx
之后执行如下命令,将其提取并解压至指定目录
unzip Linux_Upgrade_Tool_v1.65.zip
cd Linux_Upgrade_Tool_v1.65
在解压后的目录中,包含以下三个文件:
- upgrade_tool —— 固件升级工具的可执行文件
- config.ini —— 配置文件
- *.pdf —— 开发工具的使用手册
为了方便使用,我们将 upgrade_tool 重命名并安装至系统路径
cp ./upgrade_tool ./tspi_upgrade_tool
sudo cp tspi_upgrade_tool /usr/local/bin
sudo cp config.ini /usr/local/bin
sudo chown root:root /usr/local/bin/tspi_upgrade_tool
sudo chmod a+x /usr/local/bin/tspi_upgrade_tool
注意: 需要设置 config.ini 文件中的 rb_check_off=true,以关闭回读校验,否则可能会导致在固件烧录的最后一步失败。因此,在上述安装过程中,我们一并拷贝了 config.ini 文件。
安装完成后,执行以下命令,检查工具是否可用
tspi_upgrade_tool
若终端显示工具信息,说明安装成功。
设备连接
Linux系统下无需额外安装设备驱动,即可进行固件烧录。接下来,我们需要让设备进入升级模式。其中有Loader和MASKROM两种模式,当无法进入Loader模式时,可以尝试使用MASKROM模式进行固件升级。
Loader升级模式
Loader模式用于正常固件升级,进入方式如下:
方法一(断电进入Loader模式):
- 断开开发板的Type-C数据线。
- 按住设备上的 REC(Recovery)键并保持不放。
- 将 USB 一端连接到主机,Type-C 端连接到开发板。
- 约两秒钟后,松开 REC 键。
方法二(无需断电进入Loader模式):
- 确保 Type-C 数据线已经连接到主机和开发板。
- 按住 REC(Recovery)键并保持不放。
- 短按 RST(Reset)键,使设备重启。
- 约两秒钟后,松开 REC 键。
MASKROM升级模式
MaskRom 模式用于 Bootloader 损坏等情况下的设备恢复。进入方法如下:
- 断开 Type-C 数据线,使开发板断电。
- 使用镊子短接开发板 MicroHDMI 附近的两个触点。
- 保持短接状态的同时,重新连接 Type-C 数据线进行上电。
- 2s后,松开镊子。
固件烧写
不带参数执行如下命令,进入烧录工具的交互模式
tspi_upgrade_tool
之后操作板子进入升级模式,我这里进入的是marskrom模式。然后在命令行输入r,对设备列表进行更新,若设备成功进入升级模式,在设备列表中就会显示我们的设备
输入设备序号并回车,即可选中目标设备,进入到如下界面
上面是工具的具体命令说明,也可以查看烧录工具目录下的那个pdf文档进行查看。
之后,输入如下命令开始固件更新,其中update.img为固件镜像文件,可根据实际情况进行替换。
uf update.img
等待烧录完成。烧录过程中,工具会显示进度信息。结束后,设备会自动重启,表明固件升级成功。
烧录后测试
如果设备使用 USB 转串口(CH340)进行调试,可能需要安装驱动。参考以下链接获取安装指南:
https://zhuanlan.zhihu.com/p/13768333271
串口调试
使用串口工具(如 minicom 或 screen)连接开发板,默认波特率为 1500000。如果连接成功,可以看到设备启动日志并能够成功进入系统,至此表明固件烧录成功。
小结
本节介绍了 update_tool 在 Linux 下的安装、设备连接、进入升级模式、固件烧写及调试过程。希望对大家有所帮助。