rt-thread/bsp/rockchip/rk2108/README_CN.md

89 lines
2.8 KiB
Markdown
Raw Normal View History

# Rockchip RK2108 BSP说明
---
**目录**
[TOC]
---
## 简介
本文档为Rockchip RK2108 ARM Cortex-M4F with Cache的BSP说明。目录结构如下
```shell
bsp/rockchip
|-- common
| |-- drivers # RT-Thread OS适配层通用驱动
| |-- rk_hal # Rockchip HAL 硬件抽象层实现
| | |-- lib
| | | |-- bsp # 芯片相关的初始化和功能实现
| | | |-- CMSIS # 标准CMSIS库
| | | `-- hal # HAL 通用驱动
|-- rk2108
| |-- application # 应用程序
| |-- board # 板级支持
| | |-- common # 通用板级支持
| | `-- rk2108_evb # rk2108_evb 板级支持
| |-- driver # RK2108 私有驱动目录
| `-- image # 存放打包固件
`-- tools # Rockchip 通用工具
```
## 开发流程
### 编译
在bsp/rockchip/rk2108下进行操作。
```shell
cd bsp/rockchip/rk2108
./mkimage.sh
```
### 打包
使用Rockchip工具resource_header_tool和firmware_merger进行固件打包分区配置文件为setting.ini。固件打包命令在脚本mkimage.sh中一起完成。完成固件打包后能得到Firmware.img。
这里对loader相关文件进行说明
- rk2108_loader.bin用于启动引导的loader将与rtthread.bin一起打包
- rk2108_loader_fake.bin由于Rockchip固件打包时IDBlock格式要求固定需要两个bin文件因此在没有外挂psram使用psram.bin的情况下需要增加一个没有实际作用的loader_fake.bin文件。
- rk2108_db_loader.bin用于固件烧写的loader。
### 下载
保持maskrom按键按下的状态然后重新上电或者按下reset按键即可进入maskrom模式。
在Linux环境下使用Rockchip工具upgrade_tool进行固件升级脚本命令如下
```shell
sudo ./upgrade_firmware.sh
```
如果没有sudo权限请联系管理员修改rule.d让Rockchip的设备节点有rw权限。请管理员在/etc/udev/rules.d下面创建文件70-usbboot.rules。注意不同的系统版本70-usbboot.rules文件命名的前缀数字不同。
```shell
cd /etc/udev/rules.d
sudo touch 70-usbboot.rules
```
在70-usbboot.rules文件中增加以下内容其中“2207”为Rockchip USB设备的VID。
```shell
SUBSYSTEM=="usb", ATTRS{idVendor}=="2207", GROUP="plugdev", MODE="0666", ENV{ID_MM_DEVICE_IGNORE}="1"
```
完成以上修改后普通用户使用Rockchip工具upgrade_tool进行固件升级脚本命令如下
```shell
./upgrade_firmware.sh
```
在Windows环境下使用Rockchip工具RKDevTool进行固件升级首次使用前需要安装驱动程序DriverAssitant。工具获取请联系Rockchip。
## 维护
Steven Liu : steven.liu@rock-chips.com