本文整理自：https://www.gloomyghost.com/live/20230215.aspx

v85x 平台包括了 V853, V853s, V851s, V851se。 s后缀代表芯片内封了DDR内存，e后缀代表芯片内封 ephy。拥有 Cortex-A7 core@900MHz, RISC-V@600MHz 和一个 0.5TOPS（VIP9000PICO_PID0XEE, 567MACS, 576 x 348M x 2 ≈ 500GOPS） 的 NPU。其中的 RISC-V 小核心为 平头哥玄铁E907

E907 平台

玄铁E907 是一款完全可综合的高端 MCU 处理器。它兼容 RV32IMAC 指令集，提供可观的整型性能提升以及高能效的浮点性能。E907 的主要特性包括：单双精度浮点单元，以及快速中断响应。

在V85x平台中使用的E907为RV32IMAC，不包括 P 指令集。

V85x 平台框图

V851s

芯片架构图

相关内存分布

E907 子系统框图

具体的寄存器配置项这里就不过多介绍了，具体可以参考数据手册《V851S&V851SE_Datasheet_V1.0.pdf》

V853 的异构系统通讯在硬件上使用的是 MSGBOX，在软件层面上使用的是 AMP 与 RPMsg 通讯协议。其中 A7 上基于 Linux 标准的 RPMsg 驱动框架，E907基于 OpenAMP 异构通信框架。

AMP 与 RPMSG

V853 所带有的 A7 主核心与 E907 辅助核心是完全不同的两个核心，为了最大限度的发挥他们的性能，协同完成某一任务，所以在不同的核心上面运行的系统也各不相同。这些不同架构的核心以及他们上面所运行的软件组合在一起，就成了 AMP 系统 （Asymmetric Multiprocessing System, 异构多处理系统）。

由于两个核心存在的目的是协同的处理，因此在异构多处理系统中往往会形成 Master - Remote 结构。主核心启动后启动从核心。当两个核心上的系统都启动完成后，他们之间就通过 IPC（Inter Processor Communication）方式进行通信，而 RPMsg 就是 IPC 中的一种。

在AMP系统中，两个核心通过共享内存的方式进行通信。两个核心通过 AMP 中断来传递讯息。内存的管理由主核负责。

软件适配

这部分使用BSP开发包即可，配置设备树如下：

reserved-memory { // 配置预留内存区间 e907_dram: riscv_memserve { // riscv 核心使用的内存 reg = <0x0 0x43c00000 0x0 0x00400000>; // 起始地址 0x43c00000 长度 4MB no-map; }; vdev0buffer: vdev0buffer@0x43000000 { // vdev设备buffer预留内存 compatible = "shared-dma-pool"; reg = <0x0 0x43000000 0x0 0x40000>; no-map; }; vdev0vring0: vdev0vring0@0x43040000 { // 通讯使用的vring设备0 reg = <0x0 0x43040000 0x0 0x20000>; no-map; }; vdev0vring1: vdev0vring1@0x43060000 { // 通讯使用的vring设备1 reg = <0x0 0x43060000 0x0 0x20000>; no-map; }; }; e907_rproc: e907_rproc@0 { // rproc相关配置 compatible = "allwinner,sun8iw21p1-e907-rproc"; clock-frequency = <600000000>; memory-region = <&e907_dram>, <&vdev0buffer>, <&vdev0vring0>, <&vdev0vring1>; mboxes = <&msgbox 0>; mbox-names = "mbox-chan"; iommus = <&mmu_aw 5 1>; memory-mappings = /* DA len PA */ /* DDR for e907 */ < 0x43c00000 0x00400000 0x43c00000 >; core-name = "sun8iw21p1-e907"; firmware-name = "melis-elf"; status = "okay"; }; rpbuf_controller0: rpbuf_controller@0 { // rpbuf配置 compatible = "allwinner,rpbuf-controller"; remoteproc = <&e907_rproc>; ctrl_id = <0>; /* index of /dev/rpbuf_ctrl */ iommus = <&mmu_aw 5 1>; status = "okay"; }; rpbuf_sample: rpbuf_sample@0 { compatible = "allwinner,rpbuf-sample"; rpbuf = <&rpbuf_controller0>; status = "okay"; }; msgbox: msgbox@3003000 { // msgbox配置 compatible = "allwinner,sunxi-msgbox"; #mbox-cells = <1>; reg = <0x0 0x03003000 0x0 0x1000>, <0x0 0x06020000 0x0 0x1000>; interrupts = <GIC_SPI 0 IRQ_TYPE_LEVEL_HIGH>, <GIC_SPI 1 IRQ_TYPE_LEVEL_HIGH>; clocks = <&clk_msgbox0>; clock-names = "msgbox0"; local_id = <0>; status = "okay"; }; e907_standby: e907_standby@0 { compatible = "allwinner,sunxi-e907-standby"; firmware = "riscv.fex"; mboxes = <&msgbox 1>; mbox-names = "mbox-chan"; power-domains = <&pd V853_PD_E907>; status = "okay"; }; 

内存划分

在设备树配置小核心使用的内存，包括小核自己使用的内存，设备通信内存，回环内存等等，这里E907 运行在 DRAM 内。内存起始地址可以在数据手册查到。

通常来说我们把内存地址设置到末尾，例如这里使用的 V851s，拥有 64MByte 内存，则内存范围为 0x40000000 - 0x44000000，这里配置到 0x43c00000 即可。对于 V853s 拥有 128M 内存则可以设置到 0x47C00000，以此类推。对于交换区内存则可以配置在附近。

reserved-memory { // 配置预留内存区间 e907_dram: riscv_memserve { // riscv 核心使用的内存 reg = <0x0 0x43c00000 0x0 0x00400000>; // 起始地址 0x43c00000 长度 4MB no-map; }; vdev0buffer: vdev0buffer@0x43000000 { // vdev设备buffer预留内存 compatible = "shared-dma-pool"; reg = <0x0 0x43000000 0x0 0x40000>; no-map; }; vdev0vring0: vdev0vring0@0x43040000 { // 通讯使用的vring设备0 reg = <0x0 0x43040000 0x0 0x20000>; no-map; }; vdev0vring1: vdev0vring1@0x43060000 { // 通讯使用的vring设备1 reg = <0x0 0x43060000 0x0 0x20000>; no-map; }; }; 

然后需要配置下 e907 的链接脚本，找到 e907_rtos/rtos/source/projects/v851-e907-lizard/kernel.lds 将 ORIGIN 配置为上面预留的内存。

MEMORY { /*DRAM_KERNEL: 4M */ DRAM_SEG_KRN (rwx) : ORIGIN = 0x43c00000, LENGTH = 0x00400000 } 

然后配置小核的 defconfig 位于 e907_rtos/rtos/source/projects/v851-e907-lizard/configs/defconfig 配置与其对应即可。

CONFIG_DRAM_PHYBASE=0x43c00000 CONFIG_DRAM_VIRTBASE=0x43c00000 CONFIG_DRAM_SIZE=0x0400000 

配置启动小核

配置启动小核的流程如下，这里只讨论使用 linux 启动小核的情况，不讨论快启相关。

1. 加载固件
   1. 调用 firmware 接口获取文件系统中的固件
   2. 解析固件的 resource_table 段，该段有如下内容
      1. 声明需要的内存（Linux 为其分配，设备树配置）
      2. 声明使用的 vdev（固定为一个）
      3. 声明使用的 vring（固定为两个）
   3. 将固件加载到指定地址
2. 注册 rpmsg virtio 设备
   1. 提供 vdev->ops（基于 virtio 接口实现的）
   2. 与 rpmsg_bus 驱动匹配，完成 rpmsg 初始化
3. 启动小核
   1. 调用 rproc->ops->start

1. 加载固件

驱动位于 kernel/linux-4.9/drivers/remoteproc/sunxi_rproc_firmware.c

首先调用 sunxi_request_firmware 函数

int sunxi_request_firmware(const struct firmware **fw, const char *name, struct device *dev) { int ret, index; struct firmware *fw_p = NULL; u32 img_addr, img_len; ret = sunxi_find_firmware_storage(); if (ret < 0) { dev_warn(dev, "Can't finded boot_package head\n"); return -ENODEV; } index = ret; ret = sunxi_firmware_get_info(dev, index, name, &img_addr, &img_len); if (ret < 0) { dev_warn(dev, "failed to read boot_package item\n"); ret = -EFAULT; goto out; } ret = sunxi_firmware_get_data(dev, index, img_addr, img_len, &fw_p); if (ret < 0) { dev_err(dev, "failed to read Firmware\n"); ret = -ENOMEM; goto out; } *fw = fw_p; out: return ret; } 

驱动会从固件的特定位置读取，使用函数 sunxi_find_firmware_storage，这里会去固定的位置查找固件，位置包括 lib/firmware，/dev/mtd0. /dev/mtd1, /dev/mmcblk0 等位置。对于Linux启动我们只需要放置于 lib/firmware 即可。

static int sunxi_find_firmware_storage(void) { struct firmware_head_info *head; int i, len, ret; loff_t pos; const char *path; u32 flag; len = sizeof(*head); head = kmalloc(len, GFP_KERNEL); if (!head) return -ENOMEM; ret = sunxi_get_storage_type(); for (i = 0; i < ARRAY_SIZE(firmware_storages); i++) { path = firmware_storages[i].path; pos = firmware_storages[i].head_off; flag = firmware_storages[i].flag; if (flag != ret) continue; pr_debug("try to open %s\n", path); ret = sunxi_firmware_read(path, head, len, &pos, flag); if (ret < 0) pr_err("open %s failed,ret=%d\n", path, ret); if (ret != len) continue; if (head->magic == FIRMWARE_MAGIC) { kfree(head); return i; } } kfree(head); return -ENODEV; } 

2. 配置时钟

配置clk与小核的 boot 选项，驱动位于kernel/linux-4.9/drivers/remoteproc/sunxi_rproc_boot.c 可以自行参考

struct sunxi_core *sunxi_remote_core_find(const char *name); int sunxi_core_init(struct sunxi_core *core); void sunxi_core_deinit(struct sunxi_core *core); int sunxi_core_start(struct sunxi_core *core); int sunxi_core_is_start(struct sunxi_core *core); int sunxi_core_stop(struct sunxi_core *core); void sunxi_core_set_start_addr(struct sunxi_core *core, u32 addr); void sunxi_core_set_freq(struct sunxi_core *core, u32 freq); 

使用 DEBUGFS 加载固件

由于已经对外注册了接口，这里只需要使用命令即可启动小核心。假设小核的elf名字叫e907.elf 并且已经放置进 lib/firmware 文件夹

echo e907.elf > /sys/kernel/debug/remoteproc/remoteproc0/firmware echo start > /sys/kernel/debug/remoteproc/remoteproc0/state 

E907 小核开发

这里提供了一个 RTOS 以供开发使用，此 RTOS 基于 RTT 内核。地址 https://github.com/YuzukiHD/Yuzukilizard/tree/master/Software/BSP/e907_rtos

同时，docker 镜像内也已包含此开发包，可以直接使用。

搭建开发环境

使用 DOCKER

直接拉取 gloomyghost/yuzukilizard 即可

 docker pull gloomyghost/yuzukilizard 

独立搭建开发环境

使用 git 命令下载（不可以直接到 Github 下载 zip，会破坏超链接与文件属性）

git clone --depth=1 https://github.com/YuzukiHD/Yuzukilizard.git 

然后复制到当前目录下

 cp -rf Yuzukilizard/Software/BSP/e907_rtos/ . && cd e907_rtos 

下载编译工具链到指定目录

cd rtos/tools/xcompiler/on_linux/compiler/ && wget https://github.com/YuzukiHD/Yuzukilizard/releases/download/Compiler.0.0.1/riscv64-elf-x86_64-20201104.tar.gz && cd - 

编译第一个 elf 系统

进入 rtos/source 文件夹

cd rtos/source/ 

应用环境变量并加载方案

source melis-env.sh;lunch 

然后直接编译即可，他会自动解压配置工具链。编译完成后可以在 ekernel/melis30.elf 找到固件。

make -j 

配置小核系统

小核的编译框架与 kernel 类似，使用 kconfig 作为配置项。使用 make menuconfig 进入配置页。

其余使用与标准 menuconfig 相同这里不过多赘述。

小核使用

小核使用 UART 输出 console

首先配置小核的 PINMUX 编辑文件 e907_rtos/rtos/source/projects/v851-e907-lizard/configs/sys_config.fex 这里使用 UART3 , 引脚为PE12, PE13 , mux 为 7

[uart3] uart_tx = port:PE12<7><1><default><default> uart_rx = port:PE13<7><1><default><default> 

然后配置使用 uart3 作为输出，运行 make menuconfig 居进入配置

 Kernel Setup ---> Drivers Setup ---> Melis Source Support ---> [*] Support Serial Driver SoC HAL Drivers ---> Common Option ---> [*] enable sysconfig // 启用读取解析 sys_config.fex 功能 UART Devices ---> [*] enable uart driver // 启用驱动 [*] support uart3 device // 使用 uart3 (3) cli uart port number // cli 配置到 uart3 Subsystem support ---> devicetree support ---> [*] support traditional fex configuration method parser. // 启用 sys_config.fex 解析器 

到 linux 中配置设备树，将设备树配置相应的引脚与 mux

如果设备树不做配置引脚和 mux，kernel会很贴心的帮你把没使用的 Pin 设置 io_disable 。由于使用的是 iommu 操作 UART 设备，会导致 io 不可使用。如下所示。

此外，还需要将 uart3 的节点配置 disable，否则 kernel 会优先占用此设备。

&uart3 { pinctrl-names = "default", "sleep"; pinctrl-0 = <&uart3_pins_active>; pinctrl-1 = <&uart3_pins_sleep>; status = "disabled"; }; 

如果配置 okay 会出现以下提示。

uart: create mailbox fail uart: irq for uart3 already enabled uart: create mailbox fail 

启动小核固件后就可以看到输出了

核心通讯

建立通讯节点

启动小核后，使用 eptdev_bind test 2 建立两个通讯节点的监听，可以用 rpmsg_list_listen 命令查看监听节点。

然后在 Linux 内创建通讯节点，由于我们上面启用了两个监听所以这里也开两个节点

echo test > /sys/class/rpmsg/rpmsg_ctrl0/open echo test > /sys/class/rpmsg/rpmsg_ctrl0/open 

然后就可以在 /dev/ 下看到通讯节点 /dev/rpmsg0，/dev/rpmsg1

也可以在小核控制台看到节点的建立

核心通讯

Linux -> e907

可以直接操作 Linux 端的节点，使用 echo 写入数据

echo "Linux Message 0" > /dev/rpmsg0 echo "Linux Message 0" > /dev/rpmsg1 

小核即可收到数据

e907 -> Linux

使用命令 eptdev_send 用法 eptdev_send <id> <data>

eptdev_send 0 "E907 Message" eptdev_send 1 "E907 Message" 

在 Linux 侧直接可以读取出来

cat /dev/rpmsg0 cat /dev/rpmsg1 

可以一直监听，例如多次发送数据

Linux 侧获得的数据也会增加

关闭通讯

Linux 侧关闭，操作控制节点，echo <id> 给节点即可

echo 0 > /sys/class/rpmsg/rpmsg_ctrl0/close echo 1 > /sys/class/rpmsg/rpmsg_ctrl0/close 

同时 E907 也会打印链接关闭

rpmsg 需知

1. 端点是 rpmsg 通信的基础；每个端点都有自己的 src 和 dst 地址，范围（1 - 1023，除了
   0x35）
2. rpmsg 每次发送数据最大为512 -16 字节；（数据块大小为 512，头部占用 16 字节）
3. rpmsg 使用 name server 机制，当 E907 创建的端点名，和 linux 注册的 rpmsg 驱动名一
   样的时候，rpmsg bus 总线会调用其 probe 接口。所以如果需要 Linux 端主动发起创建端
   点并通知 e907，则需要借助上面提到的 rpmsg_ctrl 驱动。
4. rpmsg 是串行调用回调的，故建议 rpmsg_driver 的回调中不要调用耗时长的函数，避免影
   响其他 rpmsg 驱动的运行

自定义小核 APP

小核的程序入口位于 e907_rtos/rtos/source/projects/v851-e907-lizard/src/main.c

#include <stdio.h> #include <openamp/sunxi_helper/openamp.h> int app_entry(void *param) { return 0; } 

可以自定义小核所运行的程序。

自定义小核命令

SDK 提供了 FINSH_FUNCTION_EXPORT_ALIAS 绑定方法，具体为

FINSH_FUNCTION_EXPORT_ALIAS(<函数名称>, <命令>, <命令的描述>) 

例如编写一个 hello 命令，功能是输出 Hello World，描述为 Show Hello World

int hello_cmd(int argc, const char **argv) { printf("Hello World\n"); } FINSH_FUNCTION_EXPORT_ALIAS(hello_cmd, hello, Show Hello World) 

即可在小核找到命令与输出。