zephyr移植到STM32

开发板：DshanMCUF407

官方开发文档：入门指南 — Zephyr Project Documentation

1. Window下搭建开发环境

1.1 安装Choncolatey

在 powershell 管理员下执行如下命令：

Set-ExecutionPolicy Bypass -Scope Process -Force; [System.Net.ServicePointManager]::SecurityProtocol = [System.Net.ServicePointManager]::SecurityProtocol -bor 3072; iex ((New-Object System.Net.WebClient).DownloadString('https://community.chocolatey.org/install.ps1'))

1.2 安装相关依赖

choco feature enable -n allowGlobalConfirmation
choco install cmake --installargs 'ADD_CMAKE_TO_PATH=System'
choco install ninja gperf python311 git dtc-msys2 wget 7zip

同样是在管理员模式下执行以上命令，使用cmd也是可以的；

1.3创建虚拟python环境

以普通用户身份打开终端窗口

cd %HOMEPATH%
python -m venv zephyrproject\.venv

激活虚拟环境：

cmd 下使用以下命令激活：

zephyrproject\.venv\Scripts\activate.bat

powershell 下使用以下命令激活：

zephyrproject\.venv\Scripts\Activate.ps1

退出虚拟环境：

(.venv)deactivate

1.4 安装west

1.4.1 使用 pip 安装 west

west是Zephyr自己的构建元工具,实际上Zephyr是基于Cmake编写的,west会根据当前环境去调用cmake去编译,这样为我们省去了许多编译步骤.

pip install west

1.4.2 检查 west 安装路径

完成安装后，执行以下命令验证 west 是否安装成功：

west --version

如果显示 west 的版本号，说明安装成功，可以继续使用 west 命令。如果仍然出现无法识别 west 命令的情况，尝试west 安装路径添加到环境变量：

默认情况下，pip 安装的包会放在 Scripts 目录中。请确认 Scripts 路径是否已添加到系统环境变量中。

west 的安装目录可能在以下路径中（假设 Python 安装在默认位置）：

C:\Users\100ask\AppData\Roaming\Python\Python311\Scripts

1.4.3 将 Scripts路径添加到环境变量

1. 打开 “环境变量” 设置（右键“此电脑” -> “属性” -> “高级系统设置” -> “环境变量”）。
2. 在 “系统变量” 中找到 Path 变量并编辑。
3. 添加 Scripts 文件夹路径，例如：

C:\Users\100ask\AppData\Roaming\Python\Python311\Scripts

4. 确保更改后点击 “确定” 并重启 PowerShell。

1.4.4 验证安装

重启 PowerShell，然后运行以下命令验证 west 是否安装成功：

west --version

如果仍然出现无法识别 west 命令的情况，尝试直接使用以下命令执行：

python -m west ...

1.5 获取zephyr源码和安装python依赖

west init zephyrproject // 初始化zephyr环境并获取源码
cd zephyrproject        // 进入zephyrproject目录
west update				// 更新zephyr源码

west zephyr-export

pip install -r %HOMEPATH%\zephyrproject\zephyr\scripts\requirements.txt

1.6 安装Zephyr SDK

Zephyr 软件开发工具包 （SDK） 包含适用于 Zephyr 支持的每个架构的工具链，这些工具链 包括编译器、汇编器、链接器和其他构建所需的程序 Zephyr 应用程序。

使用 安装 Zephyr SDK

cd %HOMEPATH%\zephyrproject\zephyr
west sdk install

如果安装不成功，大多数是网络原因，可跟换网络重新进行，也可以进入官网直接获取，然后解压

最后运行文件夹下 setup.cmd，只需要运行一次就好，如果不更改SDK源码的情况下：

2.编译构建程序（虚拟开发板）

首先我们可以编译一个例程，Sample文件下有很多的示例，我这里编译一个Blinky,led闪烁的示例：

如果您不确定 west 为您的开发板使用什么名称，可以使用该名称来获取 Zephyr 支持的所有开发板的列表。west boards

使用 west 构建 Blinky，为您的板进行适当的更改：<your-board-name>

cd %HOMEPATH%\zephyrproject\zephyr
west build -p always -b <your-board-name> samples\basic\blinky

例如：我们采用qemu_cortex_m3，运行Blinky程序，编译结果如下：

打开cmd.exe,进入zephyr目录，启动虚拟环境：

运行Blinky程序：

在zephyr目录中有一个虚拟的qemu开发板类型，我们可以安装qemu使用虚拟开发板验证我们的环境：

cd zephyrproject\zephyr
west build -p always -b <qemu_cortex_m3> samples/hello_world

执行以下命令运行程序：

west build -t run

3.在STM32H750上运行zephyr

当你拿到一个板时可以在zephyr的boards目录下查看是否支持,根据你板子的核以及型号去查

比如我的是stm32h750系列的,这里我通过开发板上的板名去查

cd /scr/zephyrproject/zephyr/boards/st
dir

使用dir命令列出st目录下所有开发板，看一下有没有符合自己的开发板；

也可以使用vscode 打开zephyrproject工程文件，进入boards/st目录下手动找到符合我们的开发板，或者vscode搜索STM32h750,找到我们需要的：

注意：搜索时需要找到boards目录下的，如下图所示：

3.1 新建boards相关文件

我们需要在zephyr/boards/st/ 下新建一个我们的开发板的文件夹，如果官方支持的开发板里没有和我们板子主控相同的，需要找个相近的复制一下，这里我复制的是stm32h750b_dk

将我们复制下来的开发板文件夹改成我们自己开发板的名字，文件夹内与板子名称有关的文件同一样修改成对应的名字：

3.2 修改boards相关配置文件

我们从上往下一次查看并修改每个文件得内容：

修改openocd配置文件：

source [find interface/stlink-dap.cfg]
transport select "dapdirect_swd"set WORKAREASIZE 0x2000
set CHIPNAME STM32H750ZBTx
set BOARDNAME STM23H750ZBT6source [find target/stm32h7x.cfg]# Use connect_assert_srst here to be able to program
# even when core is in sleep mode
# reset_config srst_only srst_nogate connect_assert_srst$_CHIPNAME.cpu0 configure -event gdb-attach {echo "Debugger attaching: halting execution"#reset haltgdb_breakpoint_override hard
}$_CHIPNAME.cpu0 configure -event gdb-detach {echo "Debugger detaching: resuming execution"resume
}# Due to the use of connect_assert_srst, running gdb requires
# to reset halt just after openocd init.
rename init old_init
proc init {} {old_initreset halt
}

如果想使用openocd进行烧录，安装好openocd,按照如上配置既可。

修改board.cmake文件：

这里要指定我们使用那种方法进行烧录，这个支持使用stm32cubeprogrammer、Jlink、openocd

stm32cubeprogrammer和openocd我这里都是使用Stlink进行烧录

**修改board.yml文件 **

修改Kconfig.defconfig和Kconfig.stm32h750zbt6文件

仅修改名字，其他保持不变。

修改stm32h750zbt6_defconfig文件：

修改stm32h750zbt6.dts文件:

修改为对应头文件和开发板名称

修改配置文件：

修改led和串口

串口需要修改为usart1,TX->pa9,RX->pa10

完整dts的配置如下：

/** Copyright (c) 2023-2024 STMicroelectronics** SPDX-License-Identifier: Apache-2.0*//dts-v1/;
#include <st/h7/stm32h750Xb.dtsi>
#include <st/h7/stm32h750xbhx-pinctrl.dtsi>
#include "arduino_r3_connector.dtsi"
#include <zephyr/dt-bindings/input/input-event-codes.h>/ {model = "STMicroelectronics STM32H750ZBT6";compatible = "st,stm32h750zbt6";chosen {zephyr,console = &usart1;zephyr,shell-uart = &usart1;zephyr,sram = &sram0;zephyr,flash = &flash0;zephyr,flash-controller = &mt25ql512ab1;zephyr,display = &ltdc;};sdram2: sdram@d0000000 {compatible = "zephyr,memory-region", "mmio-sram";device_type = "memory";reg = <0xd0000000 DT_SIZE_M(16)>; /* 128Mbit */zephyr,memory-region = "SDRAM2";zephyr,memory-attr = <( DT_MEM_ARM(ATTR_MPU_RAM) )>;};ext_memory: memory@90000000 {compatible = "zephyr,memory-region";reg = <0x90000000 DT_SIZE_M(256)>; /* max addressable area */zephyr,memory-region = "EXTMEM";/* The ATTR_MPU_EXTMEM attribut causing a MPU FAULT */zephyr,memory-attr = <( DT_MEM_ARM(ATTR_MPU_IO) )>;};leds {compatible = "gpio-leds";led_1: led_1 {gpios = <&gpiof 9 GPIO_ACTIVE_LOW>;label = "User1 LD1";};led_2: led_2 {gpios = <&gpiof 10 GPIO_ACTIVE_LOW>;label = "User2 LD2";};};gpio_keys {compatible = "gpio-keys";user_button: button {label = "User";gpios = <&gpioc 13 GPIO_ACTIVE_HIGH>;zephyr,code = <INPUT_KEY_0>;};};aliases {led0 = &led_1;led1 = &led_2;sw0 = &user_button;die-temp0 = &die_temp;};
};&clk_hse {clock-frequency = <DT_FREQ_M(25)>;status = "okay";
};&clk_lse {status = "okay";
};&ltdc {pinctrl-0 = <&ltdc_r0_pi15 &ltdc_r1_pj0 &ltdc_r2_pj1 &ltdc_r3_ph9&ltdc_r4_pj3 &ltdc_r5_pj4 &ltdc_r6_pj5 &ltdc_r7_pj6&ltdc_g0_pj7 &ltdc_g1_pj8 &ltdc_g2_pj9 &ltdc_g3_pj10&ltdc_g4_pj11 &ltdc_g5_pi0 &ltdc_g6_pi1 &ltdc_g7_pk2&ltdc_b0_pj12 &ltdc_b1_pj13 &ltdc_b2_pj14 &ltdc_b3_pj15&ltdc_b4_pk3 &ltdc_b5_pk4 &ltdc_b6_pk5 &ltdc_b7_pk6&ltdc_de_pk7 &ltdc_clk_pi14 &ltdc_hsync_pi12 &ltdc_vsync_pi9>;pinctrl-names = "default";disp-on-gpios = <&gpiod 7 GPIO_ACTIVE_HIGH>;ext-sdram = <&sdram2>;status = "okay";clocks = <&rcc STM32_CLOCK_BUS_APB3 0x00000008>,<&rcc STM32_SRC_PLL3_R NO_SEL>;width = <480>;height = <272>;pixel-format = <PANEL_PIXEL_FORMAT_RGB_565>;display-timings {compatible = "zephyr,panel-timing";de-active = <1>;pixelclk-active = <0>;hsync-active = <0>;vsync-active = <0>;hsync-len = <1>;vsync-len = <10>;hback-porch = <43>;vback-porch = <12>;hfront-porch = <8>;vfront-porch = <4>;};def-back-color-red = <0xFF>;def-back-color-green = <0xFF>;def-back-color-blue = <0xFF>;
};&pll {div-m = <5>;mul-n = <192>;div-p = <2>;div-q = <2>;div-r = <5>;clocks = <&clk_hse>;status = "okay";
};&pll3 {div-m = <5>;mul-n = <192>;div-p = <2>;div-q = <20>;div-r = <99>;clocks = <&clk_hse>;status = "okay";
};&rcc {clocks = <&pll>;clock-frequency = <DT_FREQ_M(480)>;d1cpre = <1>;hpre = <2>;d1ppre = <2>;d2ppre1 = <2>;d2ppre2 = <2>;d3ppre = <2>;
};&usart1 {pinctrl-0 = <&usart1_tx_pa9 &usart1_rx_pa10>;pinctrl-names = "default";current-speed = <115200>;status = "okay";
};&quadspi {pinctrl-names = "default";pinctrl-0 = <&quadspi_clk_pf10 &quadspi_bk1_ncs_pg6&quadspi_bk1_io0_pd11 &quadspi_bk1_io1_pf9&quadspi_bk1_io2_pf7 &quadspi_bk1_io3_pf6&quadspi_bk2_io0_ph2 &quadspi_bk2_io1_ph3&quadspi_bk2_io2_pg9 &quadspi_bk2_io3_pg14>;dual-flash;status = "okay";mt25ql512ab1: qspi-nor-flash-1@90000000 {compatible = "st,stm32-qspi-nor";reg = <0x90000000 DT_SIZE_M(64)>; /* 512 Mbits */qspi-max-frequency = <72000000>;spi-bus-width = <4>;reset-cmd;status = "okay";partitions {compatible = "fixed-partitions";#address-cells = <1>;#size-cells = <1>;partition@0 {reg = <0x0 DT_SIZE_M(64)>;};};};mt25ql512ab2: qspi-nor-flash-2@90000000 {compatible = "st,stm32-qspi-nor";reg = <0x90000000 DT_SIZE_M(64)>; /* 512 Mbits */qspi-max-frequency = <72000000>;status = "okay";};
};&fmc {pinctrl-0 = <&fmc_nbl0_pe0 &fmc_nbl1_pe1&fmc_sdclk_pg8 &fmc_sdnwe_ph5 &fmc_sdcke1_ph7&fmc_sdne1_ph6 &fmc_sdnras_pf11 &fmc_sdncas_pg15&fmc_a0_pf0 &fmc_a1_pf1 &fmc_a2_pf2 &fmc_a3_pf3 &fmc_a4_pf4&fmc_a5_pf5 &fmc_a6_pf12 &fmc_a7_pf13 &fmc_a8_pf14&fmc_a9_pf15 &fmc_a10_pg0 &fmc_a11_pg1&fmc_a14_pg4 &fmc_a15_pg5 &fmc_d0_pd14 &fmc_d1_pd15&fmc_d2_pd0 &fmc_d3_pd1 &fmc_d4_pe7 &fmc_d5_pe8 &fmc_d6_pe9&fmc_d7_pe10 &fmc_d8_pe11 &fmc_d9_pe12 &fmc_d10_pe13&fmc_d11_pe14 &fmc_d12_pe15 &fmc_d13_pd8 &fmc_d14_pd9&fmc_d15_pd10>;pinctrl-names = "default";status = "okay";sdram {status = "okay";power-up-delay = <100>;num-auto-refresh = <8>;mode-register = <0x230>;refresh-rate = <0x603>;bank@1 {reg = <1>;st,sdram-control = <STM32_FMC_SDRAM_NC_8STM32_FMC_SDRAM_NR_12STM32_FMC_SDRAM_MWID_16STM32_FMC_SDRAM_NB_4STM32_FMC_SDRAM_CAS_3STM32_FMC_SDRAM_SDCLK_PERIOD_2STM32_FMC_SDRAM_RBURST_ENABLESTM32_FMC_SDRAM_RPIPE_1>;st,sdram-timing = <2 7 4 7 2 2 2>;};};
};&rtc {clocks = <&rcc STM32_CLOCK_BUS_APB4 0x00010000>,<&rcc STM32_SRC_LSE RTC_SEL(1)>;status = "okay";
};&die_temp {status = "okay";
};&adc3 {st,adc-clock-source = <SYNC>;st,adc-prescaler = <4>;status = "okay";
};/* Arduino Header pins: Tx:D1, Rx:D0 */
/* LPUART1 can also be used with this pins */
&usart1 {dma-names = "tx", "rx";pinctrl-0 = <&usart1_tx_pa9 &usart1_rx_pa10>;pinctrl-names = "default";current-speed = <115200>;status = "okay";
};

4.测试

修改好之后，我们编译一个zephyr自带的跑马灯demo试一下，使用指令：

west build -p always -b stm32h750zbt6 samples/basic/blinky

编译无问题，接好调试器后，我们使用以下命令进行下载：

west flash //使用stm32cubeprogrammer 进行下载
west flash -r openocd   //使用openocd进行下载
west flash -r jlink     //使用jlink进行下载

烧录完成后，我们可以看到开发板led1开始闪烁，并且也可以通过串口查看到打印出led的状态；

注意：

如果成功烧录没有反应，检查stm32h750zbt6_defconfig文件有没有配置系统时钟和外部HSE时钟

关闭HSE旁路模式

去掉hse-bypass，重新编译，烧录，板子就正常运行了。