【瑞萨RA8D1 LVGL/LWIP评测】二、CPKCOR-RA8D1B Zephyr工程适配

1. 摘要🪅

在上一篇中主要记录刚拿到测评板后，如何查找资料、如何搭建环境、如何调试等过程，本篇主要介绍如何在这个开发板上跑Zephyr，以及通过Zephyr自带的例程，如何测试核心板和扩展板的外设资源。欢迎大家收藏、转发，多多交流哈🤗😃🎉🪅📢 🏳️‍🌈🏳️‍🌈🏳️‍🌈🏳️‍🌈🏳️‍🌈🏳️‍🌈🏳️‍🌈🏳️‍🌈🏳️‍🌈🏳️‍🌈🏳️‍🌈🏳️‍🌈🏳️‍🌈🏳️‍🌈🏳️‍🌈🏳️‍🌈🏳️‍🌈🏳️‍🌈🏳️‍🌈🏳️‍🌈🏳️‍🌈🏳️‍🌈🏳️‍🌈🏳️‍🌈🏳️‍🌈🏳️‍🌈🏳️‍🌈🏳️‍🌈🏳️‍🌈🏳️‍🌈🏳️‍🌈🏳️‍🌈🏳️‍🌈🏳️‍🌈🏳️‍🌈🏳️‍🌈🏳️‍🌈🏳️‍🌈🏳️‍🌈🏳️‍🌈🏳️‍🌈🏳️‍🌈🏳️‍🌈🏳️‍🌈 🚀 ——评测系列跳转——🚀 【瑞萨RA8D1 LVGL/LWIP评测】一、开篇

2. Zephyr工程适配步骤

对Zephyr不太熟悉的小伙伴，可以先阅读下下面的几篇博客，然后再回过头来阅读本篇。

我们查看Zephyr的board支持列表，发现并没有支持CPKCOR-RA8D1B，那如何快速支持呢？要从0开始手写吗？当然不是。

我们可以参考EK-RA8D1，Zephyr是支持，EK-RA8D1和CPKCOR-RA8D1B的主控一致，完全可以“照抄”。

在zephyr\\boards\\renesas路径下，我们直接复制ek_ra8d1文件夹，改名为cpkcor_ra8d1b，然后修改里面的.dts、.yaml，Kconfig等文件的名字，如下图：

然后修改cpkcor_ra8d1b.dts文件，主要修改如下：

/*
* Copyright (c) 2024-2025 Renesas Electronics Corporation
* SPDX-License-Identifier: Apache-2.0
*/

/dts-v1/;

#include <renesas/ra/ra8/r7fa8d1bhecbd.dtsi>
#include <zephyr/dt-bindings/flash_controller/xspi.h>
#include <dt-bindings/gpio/gpio.h>
#include <dt-bindings/input/input-event-codes.h>
#include <zephyr/dt-bindings/memory-attr/memory-attr-arm.h>
#include <zephyr/dt-bindings/memory-controller/renesas,ra-sdram.h>
#include <zephyr/dt-bindings/adc/adc.h>
#include <zephyr/dt-bindings/gpio/dvp-20pin-connector.h>
#include <zephyr/dt-bindings/pwm/pwm.h>
#include "cpkcor_ra8d1b-pinctrl.dtsi"

/ {
model = "Renesas CPKCOR-RA8D1B";
compatible = "renesas,ra8d1b", "renesas,ra8";

chosen {
zephyr,sram = &sram0;
zephyr,flash = &flash0;
zephyr,console = &uart3;
zephyr,shell-uart = &uart3;
zephyr,entropy = &trng;
zephyr,flash-controller = &flash1;
zephyr,canbus = &canfd0;
zephyr,crc = &crc;
};

leds {
compatible = "gpio-leds";

led1: led1 {
gpios = <&ioporta 1 GPIO_ACTIVE_HIGH>;
label = "GREEN";
};
};

mikrobus_header: mikrobus-connector {
compatible = "mikro-bus";
#gpio-cells = <2>;
gpio-map-mask = <0xffffffff 0xffffffc0>;
gpio-map-pass-thru = <0 0x3f>;
gpio-map = <0 0 &ioport0 4 0>,/* AN */
<1 0 &ioport5 7 0>,/* RST */
<2 0 &ioport4 13 0>,/* CS */
<3 0 &ioport4 12 0>,/* SCK */
<4 0 &ioport4 10 0>,/* MISO */
<5 0 &ioport4 11 0>,/* MOSI */
/* +3.3V */
/* GND */
<6 0 &ioport9 7 0>,/* PWM */
<7 0 &ioport0 10 0>,/* INT */
<8 0 &ioport4 8 0>,/* RX */
<9 0 &ioport4 9 0>,/* TX */
<10 0 &ioport4 0 0>,/* SCL */
<11 0 &ioport4 1 0>;/* SDA */
/* +5V */
/* GND */
};

buttons {
compatible = "gpio-keys";

button0: s1 {
gpios = <&ioport0 8 (GPIO_PULL_UP | GPIO_ACTIVE_LOW)>;
label = "Push button switch 1";
zephyr,code = <INPUT_KEY_0>;
};
};

sdram1: sdram@68000000 {
compatible = "zephyr,memory-region", "mmio-sram";
device_type = "memory";
reg = <0x68000000 DT_SIZE_M(32)>;/* 256 Mbits */
zephyr,memory-region = "SDRAM";
status = "okay";
};

renesas_mipi_connector: mipi-connector {
compatible = "renesas,ra-gpio-mipi-header";
#gpio-cells = <2>;
gpio-map-mask = <0xffffffff 0xffffffc0>;
gpio-map-pass-thru = <0 0x3f>;
gpio-map = <14 0 &ioport5 11 0>,/* IIC_SDA */
<15 0 &ioport4 4 0>,/* DISP_BLEN */
<16 0 &ioport5 12 0>,/* IIC_SCL */
<17 0 &ioport5 10 0>,/* DISP_INT */
<18 0 &ioporta 1 0>;/* DISP_RST */
};

ek_ra8d1_parallel_graphics_expansion: parallel-graphics-expansion {
compatible = "renesas,ra-parallel-graphics-header";
#gpio-cells = <2>;
gpio-map-mask = <0xffffffff 0xffffffc0>;
gpio-map-pass-thru = <0 0x3f>;
gpio-map = <1 0 &ioport4 4 0>,/* DISP_BLEN */
<2 0 &ioport5 11 0>, /* IIC_SDA */
<3 0 &ioport5 10 0>, /* DISP_INT */
<4 0 &ioport5 12 0>, /* IIC_SCL */
<6 0 &ioporta 1 0>; /* DISP_RST */
};

dvp_20pin_connector: dvp-20pin-connector {
compatible = "arducam,dvp-20pin-connector";
#gpio-cells = <2>;
gpio-map-mask = <0xffffffff 0xffffffc0>;
gpio-map-pass-thru = <0x0 0x3f>;
gpio-map = <DVP_20PIN_PEN 0 &ioport7 4 0>,
<DVP_20PIN_PDN 0 &ioport7 5 0>;
};

aliases {
led0 = &led1;
sw0 = &button0;
mipi-dsi = &mipi_dsi;
watchdog0 = &wdt;
sram-ext = &sdram1;
};

zephyr,user {
i3c-pullup-gpios = <&ioportb 2 GPIO_ACTIVE_LOW>,
<&ioport7 11 GPIO_ACTIVE_LOW>;
};
};

&xtal {
clock-frequency = <DT_FREQ_M(24)>;
mosel = <0>;
#clock-cells = <0>;
status = "okay";
};

&subclk {
status = "okay";
};

&pll {
status = "okay";
/* PLL */
clocks = <&xtal>;
div = <4>;
mul = <160 0>;

pllp {
status = "okay";
};

pllq {
status = "okay";
};

pllr {
status = "okay";
};
};

&pll2 {
status = "okay";
clocks = <&xtal>;
div = <4>;
mul = <160 0>;

pll2p {
status = "okay";
freq = <DT_FREQ_M(480)>;
div = <2>;
};
};

&sciclk {
clocks = <&pllp>;
div = <4>;
status = "okay";
};

&canfdclk {
clocks = <&pllp>;
div = <6>;
status = "okay";
};

&lcdclk {
clocks = <&pll>;
div = <2>;
status = "okay";
};

&octaspiclk {
clocks = <&pll2p>;
div = <2>;
status = "okay";
};

&uclk {
clocks = <&pllq>;
div = <5>;
status = "okay";
};

&i3cclk {
clocks = <&pllp>;
div = <3>;
status = "okay";
};

&ioport0 {
status = "okay";
};

&ioport1 {
status = "okay";
};

&ioport4 {
status = "okay";
};

&ioport5 {
status = "okay";
};

&ioport6 {
status = "okay";
};

&ioport7 {
status = "okay";
};

&ioport9 {
status = "okay";
};

&ioporta {
status = "okay";
};

&ioportb {
status = "okay";
};

&sci9 {
pinctrl-0 = <&sci9_default>;
pinctrl-names = "default";
status = "okay";

uart9: uart {
current-speed = <115200>;
status = "okay";
};
};

&sci4 {
pinctrl-0 = <&sci4_default>;
pinctrl-names = "default";

i2c4: i2c {
sda-output-delay = <300>;
noise-filter-clock-select = <1>;
bit-rate-modulation;
};
};

&sci3 {
pinctrl-0 = <&sci3_default>;
pinctrl-names = "default";
status = "okay";

uart3: uart {
current-speed = <115200>;
status = "okay";
};
};

&trng {
status = "okay";
};

&spi1 {
pinctrl-0 = <&spi1_default>;
pinctrl-names = "default";
status = "okay";
};

&i3c0 {
i2c-scl-hz = <DT_FREQ_K(400)>;
i3c-scl-hz = <DT_FREQ_M(4)>;
pinctrl-0 = <&i3c0_default>;
pinctrl-names = "default";
interrupts = <60 1>, <61 1>, <62 1>, <63 1>, <64 1>, <65 1>;
interrupt-names = "resp", "rx", "tx", "rcv", "ibi", "eei";
status = "okay";
};

&flash1 {
partitions {
compatible = "fixed-partitions";
#address-cells = <1>;
#size-cells = <1>;

storage_partition: partition@0 {
label = "storage";
reg = <0X0 DT_SIZE_K(12)>;
};
};
};

&pwm3 {
pinctrl-0 = <&pwm3_default>;
pinctrl-names = "default";
interrupts = <51 12>, <52 12>;
interrupt-names = "gtioca", "overflow";

cam_clock: pwmclock {
compatible = "pwm-clock";
status = "disabled";
#clock-cells = <1>;
clock-frequency = <24000000>;
pwms = <&pwm3 0 PWM_KHZ(24000) PWM_POLARITY_NORMAL>;
};
};

&pwm7 {
pinctrl-0 = <&pwm7_default>;
interrupts = <40 1>, <41 1>;
interrupt-names = "gtioca", "overflow";
pinctrl-names = "default";
status = "okay";
};

&canfd_global {
status = "okay";

canfd0 {
pinctrl-0 = <&canfd0_default>;
pinctrl-names = "default";
rx-max-filters = <16>;
status = "okay";
};
};

&iic1 {
#address-cells = <1>;
#size-cells = <0>;
clock-frequency = <DT_FREQ_M(1)>;
pinctrl-0 = <&iic1_default>;
pinctrl-names = "default";
};

&eth {
local-mac-address = [74 90 50 B0 5D E9];
status = "okay";
phy-handle = <&phy>;
};

&mdio {
pinctrl-0 = <&ether_default>;
pinctrl-names = "default";
status = "okay";

phy: ethernet-phy@5 {
compatible = "ethernet-phy";
reg = <5>;
status = "okay";
};
};

&usbhs {
pinctrl-0 = <&usbhs_default>;
pinctrl-names = "default";
maximum-speed = "high-speed";
status = "okay";

zephyr_udc0: udc {
status = "okay";
};
};

&usbhs_phy {
phys-clock-src = "xtal";
};

&adc0 {
status = "okay";
pinctrl-0 = <&adc0_default>;
pinctrl-names = "default";
};

&dac0 {
pinctrl-0 = <&dac0_default>;
pinctrl-names = "default";
status = "okay";
};

&port_irq12 {
interrupts = <88 12>;
status = "okay";
};

&port_irq13 {
interrupts = <89 12>;
status = "okay";
};

&sdram {
pinctrl-0 = <&sdram_default>;
pinctrl-names = "default";
status = "okay";
auto-refresh-interval = <SDRAM_AUTO_REFREDSH_INTERVEL_10CYCLES>;
auto-refresh-count = <SDRAM_AUTO_REFREDSH_COUNT_8TIMES>;
precharge-cycle-count = <SDRAM_AUTO_PRECHARGE_CYCLE_3CYCLES>;
multiplex-addr-shift = "10-bit";
edian-mode = "little-endian";
continuous-access;
bus-width = "16-bit";

bank@0 {
reg = <0>;
renesas,ra-sdram-timing = <SDRAM_TRAS_6CYCLES
SDRAM_TRCD_3CYCLES
SDRAM_TRP_3CYCLES
SDRAM_TWR_2CYCLES
SDRAM_TCL_3CYCLES
937
SDRAM_TREFW_8CYCLES>;
};
};

&ceu {
pinctrl-0 = <&ceu_default>;
pinctrl-names = "default";
interrupts = <53 12>;
interrupt-names = "ceui";
clocks = <&pclka MSTPC 16>, <&cam_clock 0>;
clock-names = "pclk", "cam-xclk";
burst-transfer = <256>;
};

zephyr_lcdif: &lcdif {};

zephyr_mipi_dsi: &mipi_dsi {};

renesas_mipi_i2c: &iic1 {};

pmod_sd_shield: &sdhc1 {};

dvp_20pin_i2c: &iic1 {};

dvp_20pin_interface: &ceu {};

&usbfs {
pinctrl-0 = <&usbfs_default>;
pinctrl-names = "default";
maximum-speed = "full-speed";
};

&wdt {
status = "okay";
};

&ulpt0 {
status = "okay";

timer {
status = "okay";
};
};

&ulpt1 {
status = "okay";

timer {
status = "okay";
};
};

&ospi0 {
pinctrl-0 = <&ospi0_default>;
pinctrl-names = "default";
status = "okay";

s28hl512t: ospi-nor-flash@90000000 {
compatible = "renesas,ra-ospi-b-nor";
protocol-mode = <XSPI_OCTO_MODE>;
data-rate = <XSPI_DTR_TRANSFER>;
ospi-max-frequency = <DT_FREQ_M(200)>;
reg = <0x90000000 DT_SIZE_M(64)>;
write-block-size = <1>;
status = "okay";

pages_layout: pages_layout {
pages_layout_4k: pages_layout_4k {
pages-count = <32>;
pages-size = <DT_SIZE_K(4)>;
};

pages_layout_128k: pages_layout_128k {
pages-count = <1>;
pages-size = <DT_SIZE_K(128)>;
};

pages_layout_256k: pages_layout_256k {
pages-count = <255>;
pages-size = <DT_SIZE_K(256)>;
};
};

partitions {
compatible = "fixed-partitions";
#address-cells = <1>;
#size-cells = <1>;

partition@0 {
label = "nor";
reg = <0x00000000 DT_SIZE_M(64)>;
};
};
};
};

&crc {
status = "okay";
};

mikrobus_serial: &uart3 {};

mikrobus_spi: &spi1 {};

修改完成后，我们可以简单测试下：

west build -p always -b cpkcor_ra8d1b .\\samples\\hello_world

west flash

连接串口，查看测试结果：