RPMSG在C66x上的使用方法

Release 20241219

1. 增加 rpmsg-lite_rtthread 目录，该目录为CCS工程下，根据 freeRTOS 移植的 rpmsg-lite 工程，适用于 RT-Thread 系统下的 rpmsg-lite 程序
2. 验证了 RT-Thread 系统下的 rpmsg-lite 示例程序的正确性

一、目录结构

本文件夹包含 rpmsg 的相关文件，及其测试工程。

工程目录结构如下所示

rpmsg
  ├── rpmsg-lite_rtthread             /* RT-Thread 系统下的 rpmsg-lite 工程 */
  ├── csl_66x                         /* csl 相关文件 */
  │   ├── binary                      /* 库文件目录 */
  │   ├── ti                          /* 头文件目录 */
  ├── librpmsg                        /* rpmsg 相关文件 */
  │   ├── include                     /* 头文件目录 */
  │   ├── lib                         /* 库文件 */
  ├── test_rpmsg_core0                /* core0 工程 */
  │   ├── main0.c                     /* 主函数 */
  │   ├── ...                         /* 示例工程其他文件 */
  ├── test_rpmsg_core1                /* 除 core0 外，其他核的工程 */
  │   ├── main1.c                     /* 主函数 */
  │   ├── ...                         /* 示例工程其他文件 */
  ├── 78E.ccxml                       /* 调试启动文件 */
  ├── c6x_DDR_init.out                /* 78E DDR 初始化程序 */
  └── README.md  

二、测试环境

板卡： FT-M6678E-DSK-V0

CCS：Code Composer Studio 7.4.0 编译器版本： TI v8.2.2

CSL：csl_66x 在进行以下步骤前，请先安装CSL库，方法详见 csl_66x下readme.pdf

三、编译方法

1. 导入示例程序到CCS

   将 librpmsg 、test_rpmsg_core0 和 test_rpmsg_core1 文件夹均复制到CCS工作目录下。

   File -> Import -> Code composer studio -> CCS Projects -> 选择目录 -> 勾选 test_rpmsg_core0 和 test_rpmsg_core1 -> Finsh

2. 添加 libmsg 头文件

   在如下位置中：

   右键工程 -> Properties -> Build -> C6000 Compiler -> Include Options -> Add dir to #include  search path

   添加头文件路径：

   ${WORKSPACE_LOC}/librpmsg/include
   ${WORKSPACE_LOC}/librpmsg/include/platform/m6678e
   ${WORKSPACE_LOC}/librpmsg/include/environment/bm
   ${CSL_66_PATH}

3. 添加宏定义

   在如下位置中：

   右键工程 -> Properties -> Build -> C6000 Compiler -> Predefined Symbols -> Pre-define NAME

   添加宏定义

   CSL_SOC_M6678E

4. 添加库文件及其路径

   在如下位置中：

   右键工程 -> Properties -> Build -> C6000 Linker -> File search Path -> Add dir to library  search path

   分别添加 CSL 库路径和 rpmsg 库路径

   ${CSL_66_PATH}/binary/Debug/
   /librpmsg/lib/M6678E

   然后在：

   右键工程 -> Properties -> Build -> C6000 Linker -> File search Path -> Include library file or command file as input

   添加库名：

   csl6678v4.lib
   librpmsg.lib

   注意：testrpmsgcore0 和 testrpmsgcore1 工程均需要进行如上操作。如果路径不一致请根据实际情况填写。

四、运行方法

1. 进入调试界面

   View -> Target Configurations

   在 Target Configurations 栏中，找到 78E.ccxml （如果没有请自行添加），右键选择

   Launch Selected Configuration

2. 初始化DDR

   选择 core0 右键 -> Connect Target

   Run -> Load -> 选择DDR初始化程序 -> OK -> 运行程序

3. 运行程序

   按住 Ctrl 键，同时选择 Core1 、 Core2 和 Core3 -> 右键 Connect Target ->  Group core(s)

   此时，已经将 Core1 、 Core2 和 Core3 合并为 Group 1

   单击 Group 1，下载 test_rpmsg_core1 程序，并运行。此时，Core1 、 Core2 和 Core3 同时运行了 test_rpmsg_core1 程序，等待 core0 中。

   单击 Core 0， 下载 test_rpmsg_core0 程序，并允许。

   程序运行成功打印如下信息：

   [C66xx_0] test done!
   [C66xx_2] test done!
   [C66xx_3] test done!
   [C66xx_1] test done!