DR1 系列评估板 OpenAMP 双核 ARM 通信案例开发手册

前 言

本文主要介绍基于OpenAMP框架的双核ARM通信案例使用说明。

开发环境

Windows开发环境：Windows10 64bit

开发工具：TD_5.9.1_DR1_2025.1_NL、FD_2025.1_SP1

术语表

为便于阅读，下表对文档出现的关键术语进行解释；对于广泛认同释义的术语，在此不做注释。

注意事项

案例位于产品资料“4-软件资料\Demo\amp_demos\”目录下，案例目录详细说明见下表。

1 OpenAMP使用说明

OpenAMP是一个标准化的嵌入式多核框架，主要针对AMP应用场景提供RTOS和裸机程序必要的管理和通信接口。它兼容了Linux的Remoteproc和Rpmsg设计，为远程核心(Remoteprocessors)提供了软件组件，使得用户能够快速地搭建一套标准的核间交互应用场景。

在安路多核异构系统中，APU0作为OpenAMP的Master端，运行Linux系统；APU1作为OpenAMP的Slave端，运行Baremetal或FreeRTOS程序。其中，APU0使用remoteproc（即Rproc）加载APU1程序，并对APU1进行配置。

图 1

目前TLDR1-EVM支持的OpenAMP场景组合如下表。

2 amp_rpmsg_echo案例

2.1 案例功能

案例功能：APU0使用RPMsg向APU1发送数据，APU1接收到数据后再使用RPMsg向APU0回传数据。APU0对回传的数据进行验证，并输出验证结果。

2.2 TD工程说明

请参考《Linux系统开发手册》的“FSBL TD工程说明”章节。

2.2.1 IP核简介

IP核开发相关资料可查阅产品资料“6-开发参考资料\Anlogic官方参考文档\”目录下文档，IP核配置参数如下。

（1）ARM Processor System

ARM Processor System IP核心配置和FSBL工程基本一致，其他详细配置可参考位于产品资料“4-软件资料\Linux\FSBL\fsbl-[版本号]\”目录下的FSBL工程。

2.3 FD工程说明

Baremetal和FreeRTOS FD工程注意事项如下：

（1）创建Platform Project工程时"Processor"选择"apu-1"。

备注：生成Baremetal FD工程时，"Operating system"选择"standalone"；生成FreeRTOS FD工程时，"Operating system"选择"freertos"。

图 2

（2）生成Platform Project工程后双击"system.mss"后继续点击"Modify this BSP's Settings"修改相关配置。

图 3

（3）点击"library"选项勾选"LIB_METAL"和"LIB_OPENAMP"，若不勾选这两个板级支持包将会无法正常创建OpenAMP应用。

图 4

（4）点击"platform"选项将"OUTPUT_DEV"中的Value值设置为"UART0"，若不设置该选项将会导致主机和从机使用同一串口，导致冲突。

图 5

（5）创建Applicable project工程时直接选择"DEMO_OPENAMP_RPMSG_ECHO"应用。

图 6

2.4案例测试

请将产品资料“4-软件资料\Demo\amp_demos\amp_rpmsg_echo\linux_demo\dts\image”目录下的dtb.bin文件拷贝至评估板文件系统目录下。执行如下命令替换系统默认设备树文件，评估板重启生效。

Target# mv dtb.bin /boot/dtb.bin

Target# reboot

图 7

评估板上电启动后，在U-Boot倒计时结束之前长按"Ctrl + C"进入U-Boot命令行模式，执行如下命令，修改环境变量。

U-Boot# setenv mmc_boot 'if mmc dev ${devnum}; then devtype=mmc; if test ${devnum} -eq 0; then setenv bootargs '"'"'console=ttyS1,115200n8 earlycon=uart,mmio32,0xf8401000 loglevel=8 root=/dev/mmcblk0p2 rw rootfstype=ext4 rootwait maxcpus=1=1'"'"'; fi; if test ${devnum} -eq 1; then setenv bootargs '"'"'console=ttyS1,115200n8 earlycon=uart,mmio32,0xf8401000 loglevel=8 root=/dev/mmcblk1p2 rw rootfstype=ext4 rootwait maxcpus=1'"'"'; fi; ext4load mmc ${devnum}:2 ${kernel_addr_r} ${bootdir}/${kernel_image}; ext4load mmc ${devnum}:2 ${fdt_addr_r} ${bootdir}/${devicetree_image}; bootm ${kernel_addr_r} - ${fdt_addr_r}; run scan_dev_for_boot_part2; fi'

U-Boot# saveenv

U-Boot# reset

图 8

如需恢复U-Boot环境变量，在U-Boot命令行模式执行以下命令。

U-Boot# env default -a -f

U-Boot# saveenv

U-Boot# reset

图 9

进入评估板文件系统，执行如下命令，查看环境变量是否设置成功，确保只有一个核心被使用。

Target# cat /proc/cpuinfo

图 10

将APU1 Baremetal或FreeRTOS可执行文件拷贝至评估板文件系统"/lib/firmware/"目录下（若该目录不存在，请新建），并执行如下命令加载APU1程序。本次以Baremeta程序进行演示，如需测试FreeRTOS程序请修改命令中对应的可执行文件名称。

Target# mkdir -p /lib/firmware

Target# cp amp_rpmsg_echo_baremetal_a35.elf /lib/firmware/

Target# echo amp_rpmsg_echo_baremetal_a35.elf > /sys/class/remoteproc/remoteproc0/firmware

Target# echo start > /sys/class/remoteproc/remoteproc0/state

图 11

将产品资料“4-软件资料\Demo\amp_demos\amp_rpmsg_echo\linux_demo\bin”目录下的APU0应用程序可执行文件echo_test拷贝至评估板文件系统，执行如下命令，通过RPMsg实现与APU1进行通信。

Target# chmod +x echo_test

Target# ./echo_test

图 12

图 13

执行如下命令，停止APU1程序。

Target# echo stop > /sys/class/remoteproc/remoteproc0/state

图 14

2.5案例编译

2.5.1 设备树编译

将案例"\linux_demo\dts\src\"目录下tldr1-evm.dts设备树拷贝至LinuxSDK源码"linux/arch/arm64/boot/dts/anlogic"目录下。

图 15

请按照《Linux系统开发手册》文档“LinuxSDK配置与编译”章节，重新编译LinuxSDK即可生成新的设备树镜像文件，位于LinuxSDK源码"device/output/anlogic_dr1m90/image"目录下。

图 16

2.5.2 APU0应用程序编译

请参考《Linux系统开发手册》文档编译LinuxSDK，并将APU0应用程序源码src目录拷贝至Ubuntu，然后在源码目录下执行如下命令修改Makefile文件。工具链路径请以实际情况进行修改。

图 17

修改内容如下：

CC = /home/tronlong/DR1/SDK_2025.1/toolchains/aarch64-linux/bin/aarch64-linux-gnu-gcc

图 18

修改完成保存后，在源码目录下执行如下命令进行编译。

Host# make

图 19

2.5.3APU1 baremetal与FreeRTOS程序编译

请参考《TD-FD工程编译与加载》进行工程编译。

2.6关键代码

2.6.1 linux_demo代码说明

linux_demo程序的echo_test.c文件位于案例"linux_demo\src\"目录下。

（1）加载RPMsg_char驱动。

图 20

（2）绑定RPMsg设备并获取RPMsg驱动。

图 21

（3）创建RPMsg端点。

图 22

（4）打开RPMsg驱动设备节点。

图 23

（5）分配内存，进行数据收发测试。

图 24

图 25

2.6.2 baremetal_demo代码说明

baremetal_demo程序的rpmsg-echo.c文件位于案例

"baremetal_demo\project\amp_rpmsg_echo_a35\amp_rpmsg_echo\src\system\generic\"目录下。

（1）main()函数调用openamp_sample()函数进行系统初始化。

图 26

（2）openamp_sample()函数初始化系统、创建设备、调用app函数、释放设备。

图 27

图 28

（3）创建RPMsg端点、进行消息处理和检测、最后销毁RPMsg端点。

图 29

2.6.3 freertos_demo代码说明

由于FreeRTOS与Baremetal程序相似，freertos_demo代码说明可参考baremetal_demo代码说明小节。