# 开发板概况

TB-RK3588X采用瑞芯微最新旗舰SOC芯片RK3588。RK3588是一款采用ARM架构的通用型SoC，集成了四核Cortex-A76和四核Cortex-A55 CPU，G610 MP4 GPU，以及6 TOPs算力的NPU。

内置多种功能强大的嵌入式硬件引擎，支持8K@60fps的H.265 和VP9解码器、8K@30fps的H.264 解码器和4K@60fps的AV1解码器；支持8K@30fps 的H.264和H.265编码器，高质量的JPEG编码器/解码器，专门的图像预处理器和后处理器。

RK3588还引入了新一代完全基于硬件的最大4800万像素ISP（图像信号处理器），实现了许多算法加速器，如HDR、3A、LSC、3DNR、2DNR、锐化、dehaze、鱼眼校正、伽马校正等，在图形后期处理方面拥有广泛应用。

RK3588集成了瑞芯微自研的第三代NPU处理器，可支持 INT4/INT8/INT16/FP16 混合运算，其强大的兼容性，可以轻松转换基于TensorFlow / MXNet/PyTorch/Caffe 等一系列框架的网络模型。

![Debug_Port](./Images/RK3588_arch.png)

TB-RK3588X采用核心板与底板的形式，核心板通过MXM314Pin标准接口与底板连接可构成完整的行业主板，扩展接口丰富，极大程度的发挥RK3588高性能优势，可直接用于各种智能产品开发，加快产品落地。

![Debug_Port](./Images/RK3588_overview.png)

## TB-RK3588X默认套装
TB-RK3588X默认套装包含了以下物品
- TB-RK3588C0核心板 x 1

- TB-RK3588B0底板 × 1/ TB-RK3588B1底板×1

  （说明：TB-RK3588B1为TB-RK3588B0升级版，尺寸为3.5寸工业板尺寸，接口做少量变更，具体参考[TB-RK3588X板级指南](https://t.rock-chips.com/wiki.php?filename=%E6%9D%BF%E7%BA%A7%E6%8C%87%E5%8D%97/TB-RK3588X)）

- 12V/2A 电源适配器 x 1

- 风扇 x 1

- Type-C 数据线 x 1

另外，在使用过程中，你可能需要以下配件：

- 显示设备
  - 带 HDMI 接口的显示器或电视，及 HDMI 连接线
- 网络
  - 100M/1000M 以太网线缆，及有线路由器
  - WiFi 路由器
- 输入设备
  - USB 无线/有线的鼠标/键盘
- 串口调试
  - Micro USB 数据线，作为串口调试连接线

## 组装说明

1. 将底板上1、2号螺丝取下

   ![Debug_SecureCRT](./Images/zhuzhuang1.png)

2. 将1号螺丝安装至核心板上

   ![Debug_SecureCRT](./Images/zhuzhuang2.png)

3. 取出散热片配件，将散热片空位对齐放置于核心板上

   ![Debug_SecureCRT](./Images/zhuzhuang3.png)

4. 取出散热片配套螺丝3、4，从核心板背面将螺丝锁上

   ![Debug_SecureCRT](./Images/zhuzhuang4.png)

5. 将核心板安装至底板上，依次锁上1、2号螺丝

   ![Debug_SecureCRT](./Images/zhuzhuang5.png)

6. 将风扇电源线接入对如下图排针上，完成安装

   ![Debug_SecureCRT](./Images/zhuzhuang6.png)

# 串口调试

## 串口连接

使用MicroUSB数据线(需自备)连接TB-RK3588X如下图位置，线缆另一端接至电脑端。

![Debug_SecureCRT](./Images/tb-rk3588-debug2.png)

说明：开发板的调试口(通常开发板上的调试口边上有标有类似`DEBUG` 或 `UART TO USB`的丝印)

## Windows上串口调试

### 安装驱动

TB-RK3588上自带usb转串口芯片为FT232，如果操作系统提示安装驱动，请下载驱动程序或通过驱动精灵进行安装。

### 获取端口号

打开电脑设备管理器获取调试串口的端口号，如图1-1所示：

![Debug_Port](./Images/Debug_port.png)

 <center>图1-1：获取调试端口号</center>

### 配置调试串口信息

打开串口工具`SecureCRT`（请自行网上搜索下载）, 点击"快速连接"按钮，打开调试串口配置界面如图1-2和图1-3所示：

1. Port: 选择设备管理器显示的端口号
2. 波特率： 1500000
3. 禁止流控：不勾选RTS/CTS

![Debug_SecureCRT](./Images/Debug_SecureCRT.png)

<center>图1-2：SecureCRT</center>

![Debug_Config](./Images/Debug_config.png)

<center> 图1-3：配置调试串口信息</center>

## Linux主机调试

### 安装minicom

```shell
sudo apt -y install minicom
```

### 配置调试窗口信息

按如下步骤，配置保存串口信息：
```eval_rst
.. hint:: 以下步骤执行一次即可!
```
1. 在插入串口调试线后先获取设备节点，如果不是`ttyUSB0`请对应修改`minicom`的配置值。

   ```shell
   $ls /dev/ttyUSB*
   /dev/ttyUSB0
   ```

1. 执行如下命令打开`minicom`

   ```shell
   sudo minicom -s
   ```

2. 进入串口设置界面：输入CTRL-A Z

   ```shell
   +-------------------------------+
   | Filenames and paths           |
   | File transfer protocols       |
   | Serial port setup             |
   | Modem and dialing             |
   | Screen and keyboard           |
   | Save setup as dfl             |
   | Save setup as                 |
   | Exit                          |
   +-------------------------------+
   ```

3. 端口设置：选择`Serial port setup`

4. 设置串口设备： 输入"A"，填入`/dev/ttyUSB0`, 然后按回车确定

5. 禁止流控：输入“F”，按回车确定

6. 设置波特率：输入“E”，再输入“A”直到显示`Current 1500000 8N1`, 然后按回车确认

8. 配置完成后，界面显示

   ```shell
   +--------------------------------------------------------+
   | A -        Serial Device          : /dev/ttyUSB0       |
   | B -        Lockfile Location      : /var/lock          |
   | C -        Callin Program         :                    |
   | D -        Callout Porgram        :                    |
   | E -        Bps/Par/Bits           : 1500000 8N1        |
   | F -        Hardware Flow Control  : No                 |
   | G -        Software Flow Control  : No                 |
   +--------------------------------------------------------+
   ```

8. 退出端口设置：按回车

9. 保存配置： 选择`Save setup as dfl`

10. 退出设置：选择`Exit`

### 运行minicom

```shell
sudo minicom
```

# 烧写固件

TB-RK3588x 出厂默认安装`debian11`系统，如果需求运行其他操作系统，请下载对应固件烧写到板子上。

如果在升级过程中出现意外，无法进入loader烧写模式，仍可以进入 `MaskRom` 模式来烧写固件。

## 固件获取

**TB-RK3588X0** (TB-RK3588X0-IMAGES.tar.gz)下载地址： 

​	[点击下载](https://console.box.lenovo.com/l/2n6YIQ)

## 进入烧写模式

## 准备程序

- TB-RK3588x 开发板
- 电脑主机
- 附赠的Type-C 数据线
- 附赠的12v电源适配器

### 安装Windows RK USB驱动程序

下载 [Flashtool压缩包](https://console.box.lenovo.com/l/d5GXjR)，解压目录FlashTool_CN.zip\FlashTool_CN\Windows\DriverAssitant。运行里面的 `DriverInstall.exe` 。先选择`驱动卸载`，然后再选择`驱动安装`。

![瑞芯微驱动助手](./Images/rk_devicetool.png)

### 进入loader烧写模式

1. 接入12V电源适配器给予开发板供电，Type-C数据一端接在开发板上一端接到电脑PC端的USB接口上。
2. 按住主板的`V+/Recovery`按键不放。
3. 电源适配器上电后，按下`复位(Reset)`按键。
4. 当开发板进入loader模式后，松开按键。

### 进入maskrom烧写模式

1. 接入12V电源适配器给予开发板供电，Type-C数据一端接在开发板上一端接到电脑PC端的USB接口上。
2. 按住主板的`Maskrom`按键不放。
3. 电源适配器上电后，按下`复位(Reset)`按键。
4. 当开发板进入maskrom模式后，松开按键。

![瑞芯微驱动助手](./Images/tb-rk3588-debug.png)

## 查询烧写状态

### Linux主机查询

先下载得到edge工具（请先下载Linux工程源代码）至电脑上，执行如下命令查询烧写状态:

```shell
./edge flash -q
```

1. none：表示开发板未进入烧写模式。
2. loader：表示开发板进入loader烧写模式。
3. maskrom：表示开发板进入maskrom烧写模式。

### Windows主机查询

下载[RKDevTool_Release_v2.84](https://console.box.lenovo.com/l/X5fncG)工具至电脑上。

双击打开RKDevTool_Release_v2.84目录下的RKDevTool.exe  

- 没有发现设备（如果图1-4所示）：表示开发板未进入烧写模式。

- 发现一个LOADER设备（如图1-5所示）：表示开发板进入loader烧写模式。

- 发现一个MASKROM设备（如图1-6所示）：表示开发板进入maskrom烧写模式。

![none](./Images/Flash_none.png)

<center>图1-4：没有发现设备</center>

![loader](./Images/Flash_loader.png)

<center>图1-5：发现一个LOADER设备</center>

![maskrom](./Images/Flash_maskrom.png)

<center>图1-6：发现一个MASKROM设备</center>

## Linux主机烧写镜像

### 烧写所有镜像

烧写所有镜像包括：`MiniLoaderAll.bin`, `uboot.img`, `resource.img`, `boot_linux.img`，`rootfs.img`和`parameter.txt`

```shell
./edge flash -a
```

### 烧写uboot镜像

烧写镜像：MiniLoaderAll.bin，uboot.img和parameter.txt

```shell
./edge flash -u
```

### 烧写kernel镜像

烧写镜像：boot_linux.img和resource.img

```shell
./edge flash -k
```

### 烧写文件系统镜像

烧写镜像：rootfs.img

```shell
./edge flash -r
```

### 查看烧写帮助

```
查看支持的烧写参数：
./edge flash -h
```

## Windows主机烧写镜像

- 双击打开RKDevTool_Release_v2.84目录下的RKDevTool.exe。

- 确认开发板已经进入`loader`或者`maskrom`烧写模式。

- 打勾选择需要烧写的镜像。 

```eval_rst
.. note:: Loader和Parmeter选项建议打勾选择，其他选项根据需要打勾选择。
```
- 点击“执行”按钮，开始烧写固件（如图1-7所示）。

   ![flash](./Images/Flash.png)

<center>图1-7：烧写固件</center>