本文作者：AMD 工程師 Longley Zhang

背景說明

本文基于 EDF 2025.11 版本進行測試，記錄了在 VEK385 開發(fā)板上，如何：

1. 通過 JTAG 模式 啟動 EDF 鏡像；

2. 使用 TFTP 引導(dǎo) Linux 內(nèi)核與 rootfs；

3. 在 Linux 環(huán)境中使用官方發(fā)布的 wic 鏡像 刷寫 UFS 設(shè)備；

在 2025.11 的 EDF 文檔里，燒寫 UFS 主要是依賴 Image Recovery Application。而本文提供的流程不依賴 Image Recovery Application，方便在非開發(fā)板的環(huán)境下使用。

生成 boot.bin 和 system.dtb

首先從 edf-ospi 或 xilinx-bootbin 工程中生成 EDF 啟動所需的 boot.bin 和 system.dtb。

具體的 Yocto 環(huán)境的構(gòu)建，請參考這個中文博客:

https://adaptivesupport.amd.com/s/article/000039734?language=zh_CN

在構(gòu)建環(huán)境中執(zhí)行命令：

MACHINE=versal-2ve-2vm-vek385-revb-sdt-seg bitbake edf-ospi

或

MACHINE=versal-2ve-2vm-vek385-revb-sdt-seg bitbake xilinx-bootbin

構(gòu)建完成后，從 /deploy/images 路徑中拷貝生成的鏡像文件：

boot.bin

system.dtb

生成 Linux 內(nèi)核鏡像與 rootfs

接下來生成 Linux kernel image 和 rootfs。

1.在 rootfs 中加入刷寫 UFS 需要的工具，例如：

bmaptool

bmap-writer

ufs-utils

可以在 local.conf 中追加配置：

IMAGE_INSTALL:append = " bmaptool bmap-writer ufs-utils "

2. 在構(gòu)建環(huán)境執(zhí)行：

MACHINE=amd-cortexa78-mali-common bitbake core-image-full-cmdline

3. 構(gòu)建完成后，從 /deploy/images 路徑中拷貝下面文件：

Image

*.cpio.gz.u-boot

說明：

官方的 EDF 文檔（PetaLinux to EDF Migration Guide | Boot Image on Hardware with JTAG）在 “Boot-Image-on-Hardware-with-JTAG” 一節(jié)中推薦 core-image-minimal，但該鏡像非常精簡，缺少很多必要的工具包（比如缺少SCP命令）。本文改用 core-image-full-cmdline，便于直接在系統(tǒng)內(nèi)刷寫 UFS。

EDF 文檔：

https://xilinx-wiki.atlassian.net/wiki/spaces/A/pages/3467935747/PetaLinux+to+EDF+Migration+Guide#Boot-Image-on-Hardware-with-JTAG

通過 XSDB + JTAG 啟動 boot.bin

1.將 XSDB 連接到 VEK385 板卡。

2. 在 xsdb 中通過 JTAG 加載并啟動 boot.bin:

ta 1

device program boot.bin

執(zhí)行成功后，在 UART 終端中進入 u-boot。

在 u-boot 中通過 TFTP 啟動 Linux

進入 u-boot 命令行后：

1.配置網(wǎng)絡(luò)參數(shù)（根據(jù)你的實際網(wǎng)絡(luò)環(huán)境修改）：

setenv serverip 10.10.70.101

setenv ipaddr 10.10.70.1

其中：

serverip：TFTP 服務(wù)器 IP 地址；

ipaddr：VEK385 板端 IP 地址。

2. 通過 TFTP 下載內(nèi)核、設(shè)備樹和 rootfs（cpio）：

tftpboot 0x20000000 Image

tftpboot 0x22000000 system.dtb

tftpboot 0x23000000 core-image-full-cmdline-amd-cortexa78-mali-common.rootfs-20260205023743.cpio.gz.u-boot

注意：

core-image-full-cmdline-amd-cortexa78-mali-common.rootfs-20260205023743.cpio.gz.u-boot 的文件名中包含時間戳，你實際構(gòu)建得到的文件名可能不同，請以你本地輸出為準。

3. 啟動 Linux：

booti 0x20000000 0x23000000 0x22000000

在 Linux 系統(tǒng)中刷寫 UFS

成功進入 Linux 后，可以對 UFS 設(shè)備進行刷寫。

1.切換到 root 用戶，并確認 UFS 設(shè)備和分區(qū)：

sudo -s

#查找 UFS 設(shè)備及其分區(qū)信息

fdisk -l

根據(jù) fdisk -l 的輸出，確認 UFS 設(shè)備節(jié)點（例如 /dev/sda，實際以系統(tǒng)識別為準）。

2. 將 wic 鏡像及 bmap 文件拷貝到板端本地內(nèi)存：

可以使用 scp 從主機拷貝到開發(fā)板，例如：

#從服務(wù)器拷貝 bmap 文件

scp longley@10.10.70.101:/home/longley/2025.2/edf-linux-disk-image-amd-cortexa78-mali-common.rootfs-20251116015456.wic.ufs.bmap ./

#從服務(wù)器拷貝壓縮的 wic 鏡像

scp longley@10.10.70.101:/home/longley/2025.2/edf-linux-disk-image-amd-cortexa78-mali-common.rootfs-20251116015456.wic.ufs.xz ./

如板上有 SD 卡接口，也可以通過 SD 卡將這兩個文件復(fù)制到板端內(nèi)存。

3. 使用 bmap-writer 或 bmaptool 刷寫 UFS：

方式一：使用 bmap-writer：

xzcat edf-linux-disk-image-amd-cortexa78-mali-common.rootfs-20251116015456.wic.ufs.xz

| bmap-writer -

edf-linux-disk-image-amd-cortexa78-mali-common.rootfs-20251116015456.wic.ufs.bmap

/dev/sda

方式二：使用 bmaptool：

bmaptool copy

--bmap edf-linux-disk-image-amd-cortexa78-mali-common.rootfs-20251116015456.wic.ufs.bmap

edf-linux-disk-image-amd-cortexa78-mali-common.rootfs-20251116015456.wic.ufs.xz

/dev/sda

注意事項：

/dev/sda 僅為示例設(shè)備節(jié)點，請根據(jù) fdisk -l 的結(jié)果確認實際設(shè)備；

上述操作會覆蓋整個 UFS 設(shè)備，刷寫前請確認設(shè)備上無需要保留的數(shù)據(jù)。

文中使用的 wic 與 bmap 文件為 VEK385 官方發(fā)布的鏡像，從 AMD 的 Wiki 下載獲得。

UFS 配置相關(guān)說明

在對 UFS 進行刷寫之前，需要按照官方文檔完成 UFS 設(shè)備的配置與初始化。

您可參考以下文檔中 “Device Configuration” 一節(jié)：

UFS Linux driver | Device Configuration：

https://xilinx-wiki.atlassian.net/wiki/spaces/A/pages/3103293588/UFS+Linux+driver#Device-Configuration