调试配置

8 Nov 2024

Read time: 2 minute(s)

BootLoader 和 RT-Thread 均用到调试端口。在 Bringup 过程中，正确配置调试端口至关重要，可以帮助开发者快速发现问题的根本原因，从而快速解决问题。

以 d21x demo128_nand 工程为例，使用 uart0 端口作为调试口，详细配置流程如下：

通过 list 命令查看所有可用的配置，包括 BootLoader 和 RT-Thread。

Built-in configs:
0. d12x_demo68-nand_baremetal_BootLoader
1. d12x_demo68-nand_rt-thread_helloworld
2. d12x_demo68-nor_baremetal_BootLoader
3. d12x_demo68-nor_rt-thread_helloworld
4. d12x_hmi-nor_baremetal_BootLoader
5. d12x_hmi-nor_rt-thread_helloworld
6. d13x_demo88-nand_baremetal_BootLoader
7. d13x_demo88-nand_rt-thread_helloworld
8. d13x_demo88-nor_baremetal_BootLoader
9. d13x_demo88-nor_rt-thread_helloworld
10. d13x_kunlunpi88-nor_baremetal_BootLoader
11. d13x_kunlunpi88-nor_rt-thread_helloworld
12. d21x_demo128-nand_baremetal_BootLoader
13. d21x_demo128-nand_rt-thread_helloworld
14. g73x_demo100-nor_baremetal_BootLoader
15. g73x_demo100-nor_rt-thread_helloworld

配置 BootLoader
1. 选择并使用 lunch list number 进入所需配置的 BootLoader 配置。
  
  例如，d21x_demo128_nand 位于第 12 列，则使用 lunch 12 选择 d21x_demo128_nand BootLoader 配置文件。
2. 输入 me 命令进入 menuconfig 配置界面。
3. 在 menuconfig 界面中，选择 Using Uart0 选项，并设置相应的参数。
```
Board options -->
    [*] Using Uart0
        Uart0 Parameter  ---> //设置对应的参数
BootLoader options  --->
    Console  --->
        (1) Console UART ID //选择对应的串口号
```
4. 保存配置并退出。
5. 使用 m 命令编译 BootLoader。
配置 RT-Thread
1. 选择并使用 lunch list number 进入所需配置的 RT-Thread 配置。
  
  例如，d21x_demo128_nand 位于第 13 列，则使用 lunch 13 选择 d21x_demo128-nand_rt-thread_helloworld 配置。
2. 输入 me 命令进入 menuconfig 配置界面。
3. 在 menuconfig 界面中，选择 Using Uart0 选项，并设置相应的参数。
```
Board options -->
    [*] Using Uart0
        Uart0 Parameter  ---> //设置对应的参数

Rt-Thread options  --->
    RT-Thread Kernel  --->
        Kernel Device Object  --->
            (uart0) the device name for console  //设置对应的串口号
```
4. 保存配置并退出。
5. 使用 m 命令编译 RT-Thread。
pinmux 设置：配置串口对应的硬件复用功能。
以 d21x demo128_nand 工程为例，在 target/d211/demo128-nand/ 目录中找到配置文件 pinmux.c，即可配置 pinmux。
```
struct aic_pinmux aic_pinmux_config[] = {
#ifdef AIC_USING_UART0
    /* uart0 */
    {5, PIN_PULL_DIS, 3, "PA.0"},
    {5, PIN_PULL_DIS, 3, "PA.1"},
#endif
```
- 5：复用功能，可以查看芯片手册.引脚复用功能说明。
- PIN_PULL_DIS：禁止上拉下拉,根据需要选择是否上下拉，有的串口工具无上拉，且主板这边也没做上拉，可以使用上拉。
- 3：驱动强度，默认即可。
- "PA.0"：引脚名称，根据硬件设计的原理图选择。
保存，使用命令 m 编译烧写固件。
重启开发板，即可使用串口调试。