【瑞萨AI挑战赛】PyOCD 调试

本文介绍了瑞萨 Titan RA8P1 开发套件结合 pyocd 工具和板载 DAP-LINK 实现固件上传的项目设计，包括环境搭建、工程构建、固件生成、命令行烧录、效果演示等。

项目介绍

• 环境搭建：pyOCD 部署、Keil CMSIS Pack 获取；
• 工程测试：工程创建、关键代码、工程编译；
• 固件上传：使用 pyOCD 工具将生成的 hex 固件通过命令行上传至板端；

Titan Board 板载 RA4M2 芯片作为 USB-Debugger 调试器，但是 e2 studio IDE 不支持 DAP-LINK 调试，如何将编译生成的 hex 或 bin 固件上传至板端？PyOCD 是一个不错的选择。

PyOCD

PyOCD 是 ARM 为 DAP-Link 开发的 python 语言调试软件，支持多平台 ARM 内核芯片的烧录和在线调试。

借助 Keil CMSIS Pack 软件支持包，极大程度拓展了PyOCD所支持的芯片平台。

详见：PyOCD使用 — DAPLink DOC 0.0.1 文档 . pyocd · PyPI .

环境搭建

包括 pyOCD 部署、CMSIS pack 获取。

PyOCD 安装

• 安装 Python 软件，注意版本需高于 3.8.0；
• 打开微软应用商店，搜索并安装 Windows Terminal ；
• 打开终端软件，执行以下指令安装 pyOCD

python3 -m pip install -U pyocd

• 安装完成后执行 pyocd -V 获取对应的版本号

Keil CMSIS Pack 获取

• 下载 RA8P1 芯片对应的 Keil CMSIS Pack 支持包 Arm Keil | Renesas RA_DFP ；

• 获取开发板主控对应的系列名称，终端执行指令

pyocd list -t -s pack --pack D:\Renesas.RA_DFP.6.4.0.pack

由 Titan Board 主控型号 R7KA8P1KFLCAC 可知应选择 r7ja8p1ks ；

硬件连接

• 使用 Type-C 数据线连接板载 USB-Debug 接口；

工程创建

• 文件 - 新建 - 瑞萨 C/C++ 项目 - Renesas RA ；

• 自定义设备选择 R7KA8P1KFLCAC ，调试器选择 J-Link ；

• 项目创建完成后，选择进入透视图模式；

  

• 由原理图可知，板载三个 RGB 用户 LED 对应引脚分别为 P013、P613、P012 ；

  

• 将 P613 引脚均配置为输出模式，初始为低电平，点击 Generate Project Content ；

  

• 右键项目文件夹，构建工程，确认无报错；

工程代码

打开 ./src/hal_entry.c 文件，添加如下代码

void hal_entry(void)
{
    /* TODO: add your own code here */
    while(1)
    {
        R_IOPORT_PinWrite(&g_ioport_ctrl, BSP_IO_PORT_06_PIN_13, BSP_IO_LEVEL_LOW);
        R_BSP_SoftwareDelay(100, BSP_DELAY_UNITS_MILLISECONDS);
        R_IOPORT_PinWrite(&g_ioport_ctrl, BSP_IO_PORT_06_PIN_13, BSP_IO_LEVEL_HIGH);
        R_BSP_SoftwareDelay(100, BSP_DELAY_UNITS_MILLISECONDS);
    }
}

保存文件。

工程编译

• 右键项目文件夹，选择 属性 ，进入 C/C++ 构建 - 设置 选项；
• 进入 GNU Arm Cross Create Flash Image - General 选项；
• 在输出格式中选择 Intel HEX ，应用并关闭；

• 右键项目文件夹，构建工程，确认无报错；

• 查看工程目录下的 Debug 文件夹，生成相应的 HEX 格式的固件；

固件上传

• 使用 Type-C 数据线连接开发板和电脑；
• 终端执行指令

pyocd load --pack D:\Renesas.RA_DFP.6.4.0.pack -f 10000000 -t r7ja8p1ks D:\Debug\RA8P1_Blink.hex

• 待进度条走完，即完成固件上传，程序自动运行。

效果演示

板载绿色 LED 快速闪烁，间隔为 100 毫秒；

总结

本文介绍了瑞萨 Titan RA8P1 开发套件结合 pyocd 工具和板载 DAP-LINK 实现固件上传的项目设计，包括环境搭建、工程构建、固件生成、命令行烧录、效果演示等，为相关产品在边缘 AI 领域的快速开发和应用设计提供了参考。