本文主要描述了如何在Linux系統啟動以后，在線將bitstream文件更新到ZYNQ PL的過程及方法。相關內容主要譯自xilinx-wiki，其中官網給出了兩種方法，分別為Device Tree Overlay和Sysfs interface。由於項目需要，暫只對sysfs interface在線燒錄的執行過程作簡要介紹和實踐，並附有相關的配置腳本文件，更多詳情請參照Solution Zynq PL Programming With FPGA Manager。
內核配置
為保證FPGA Manager可正常使用，需要按圖中配置內核相關選項。（在zynq_defconfig里面，這些選項是默認使能的）
配置 Zynq FPGA Manager：
選擇：Device Drivers ---> FPGA Configuration Framework
配置Contiguous Memory Allocator：
CONFIG_CMA
Kernel Features --> Contiguous Memory Allocator
CONFIG_DMA_CMA
Select: Device Drivers --> Generic Driver Options → DMA Contiguous Memory Allocator
工具准備
- bootgen
映像文件准備
- FSBL
- u-boot
- Linux內核映像（uImage)
- 該映像可參考http://www.wiki.xilinx.com/Zynq+Linux創建
- Bin文件
使用Bootgen工具，將.bit文件轉換成.bin文件
bootgen -image Full_Bitstream.bif -arch zynq -process_bitstream bin
其中，Full_Bitstream.bif文件應包含下列內容
all: { design_1_wrapper.bit /* Bitstream file name */ }
執行過程
設置flags為Full Bitstream模式
echo 0 > /sys/class/fpga_manager/fpga0/flags
通過sysfs提供的接口，下載Bitstream文件到PL
mkdir -p /lib/firmware cp /media/design_1_wrapper.bit.bin /lib/firmware/ echo design_1_wrapper.bit.bin > /sys/class/fpga_manager/fpga0/firmware
正常輸出如下：
參考腳本
為便於項目使用，筆者將上述過程形成以下兩個腳本，其中makebitbin.sh可將.bit文件轉換為.bin文件，具體使用方法為：
注意，該腳本執行前需要配置好Bootgen工具才可以正常使用！
腳本如下：
#!/bin/bash ############################################################################### # # Copyright (C) 2019 by Luego Zhang <zhanglucc@foxmail.com> # # This program is free software; you can redistribute it and/or modify # it under the terms of the GNU General Public License as published by # the Free Software Foundation; either version 2 of the License, or # (at your option) any later version. # # Reference: # https://xilinx-wiki.atlassian.net/wiki/spaces/A/pages/18841645/Solution+Zynq+PL+Programming+With+FPGA+Manager ################################################################################ # => Force locale language to be set to English. This avoids issues when doing # text and string processing. export LC_ALL=C LANGUAGE=C LANG=C # => Help and information usage() { printf " NAME $(basename ${BASH_SOURCE}) - generating .bin from .bit file using Bootgen SYNOPSIS $(basename ${BASH_SOURCE}) [option] filename DESCRIPTION In order to load bitstream files to PL through Linux, we need to get one type of file with suffix like '.bit.bin'. Run this script and .bin will be generated with the given file(.bit) using Bootgen. Please run this script in PC. OPTIONS --help Display this help message EXAMPLE Version : 191031v1.0 " exit 0; } expr "$*" : ".*--help" > /dev/null && usage # => Setting the development environment variables if [ ! "${ZN_CONFIG_DONE}" ]; then printf "\033[31m[ERROR]\033[0m Please source the settings64.sh script first\n" exit 1 else # => Setting zynq-7000 development envirionment variables if [ -f "${ZN_SCRIPTS_DIR}/xilinx/export_xilinx_env.sh" ]; then source ${ZN_SCRIPTS_DIR}/xilinx/export_xilinx_env.sh else error_exit "Could not find file ${ZN_SCRIPTS_DIR}/xilinx/export_xilinx_env.sh" exit 1 fi fi ZN_SCRIPT_NAME="$(basename ${BASH_SOURCE})" ZN_SCRIPT_PATH="$(dirname ${BASH_SOURCE})" ################################################################################ # => The beginning print_info "[ $(date "+%Y/%m/%d %H:%M:%S") ] Starting ${BASH_SOURCE}\n" # => Check user input is correct [[ -f $1 ]] || error_exit "$1 not found, please check that the filename is correct\n" echo_info "1. Create fullbitstream.bif " BIF_FILE=${ZN_SCRIPT_PATH}/fullbitstream.bif echo "//arch = zynq; split = yes; format = .bit.bin" > ${BIF_FILE} echo "all:" >>${BIF_FILE} echo "{" >>${BIF_FILE} echo " $1" >>${BIF_FILE} echo "}" >>${BIF_FILE} echo_info "2. Generate .bif file for Bootgen" bootgen -image fullbitstream.bif -arch zynq -process_bitstream bin -w # => The end print_info "[ $(date "+%Y/%m/%d %H:%M:%S") ] Finished ${ZN_SCRIPT_NAME}\n"
另一個腳本為load-fpga-image.sh，該腳本應在開發板上運行，具體使用方法為：
將load-fpga-image.sh腳本和上一步生成的blinkblink.bit.bin文件共同copy至開發板的同一目錄下，然后按以下方法執行腳本：
./load-fpga-image.sh blinkblink.bit.bin
即可，參考腳本如下：
#!/bin/bash ############################################################################### # # Copyright (C) 2019 by Luego Zhang <zhanglucc@foxmail.com> # # This program is free software; you can redistribute it and/or modify # it under the terms of the GNU General Public License as published by # the Free Software Foundation; either version 2 of the License, or # (at your option) any later version. # # Reference: # https://xilinx-wiki.atlassian.net/wiki/spaces/A/pages/18841645/ \ # Solution+Zynq+PL+Programming+With+FPGA+Manager ################################################################################ # => Force locale language to be set to English. This avoids issues when doing # text and string processing. export LC_ALL=C LANGUAGE=C LANG=C # => Help and information usage() { printf " NAME $(basename ${BASH_SOURCE}) - load fullbitstream file to PL through Linux SYNOPSIS $(basename ${BASH_SOURCE}) [option] bitstream_file DESCRIPTION Load bitstream file to PL using sysfs interface through Linux. Be careful the type of bitstream_file is .bit.bin file which is generated by Bootgen and bitstream_file should be in the same path with the script. Please run this script on the board! OPTIONS --help Display this help message EXAMPLE Version : 191031v1.0 " exit 0; } expr "$*" : ".*--help" > /dev/null && usage #------------------------------------------------------------------------------ # => Check system environment and make sure fpga manager runs well FPGA_MGR_PATH=/sys/class/fpga_manager/fpga0 if [ ! -d ${FPGA_MGR_PATH} ]; then printf "\033[31m[ERROR]\033[0m FPGA Manager is not found, please check the driver!" exit 1 fi # => Check that user input is correct if [ ! -f "$1" ]; then printf "\033[31m[ERROR]\033[0m '$1' not found, please check if the file exists\n" exit 1 fi ZN_SCRIPT_NAME="$(basename ${BASH_SOURCE})" ZN_SCRIPT_PATH="$(dirname ${BASH_SOURCE})" BITSTREAM="$1" FPGA_MGR_FLAGS=${FPGA_MGR_PATH}/flags FPGA_MGR_FIRMWARE=${FPGA_MGR_PATH}/firmware ################################################################################ # => The beginning echo "\033[32m[ $(date "+%Y/%m/%d %H:%M:%S") ]\033[0m Starting ${ZN_SCRIPT_NAME}\n" # => Set flags for Full Bitstream echo 0 > $FPGA_MGR_FLAGS read flag <<<$(cat $FPGA_MGR_FLAGS) [ "$flag" = "0" ] || $(echo "[error] invalid mode, please check ${FPGA_MGR_FLAGS}" && exit 1) # => Loading Bitstream into PL mkdir -p /lib/firmware/ && cp ./$BITSTREAM /lib/firmware/ echo $BITSTREAM > $FPGA_MGR_FIRMWARE # => The end printf "\033[32m[ $(date "+%Y/%m/%d %H:%M:%S") ]\033[0m Finished ${ZN_SCRIPT_NAME}\n"