AR# 69074


PetaLinux 2017.1 - Product Update Release Notes and Known Issues


This Answer Record acts as the release notes for PetaLinux 2017.1 and contains links to information about resolved issues and updated collateral contained in this release.


BSPs supported for 2017.1 PetaLinux Release

This table contains supported BSPs for Zynq, MicroBlaze, Zynq UltraScale+ MPSoC available on the Embedded Development download page.

PlatformVariantBSP Name
Zynq UltraScale+ MPSoC ZCU102 production silicon xilinx-zcu102-v2017.1-final.bsp
Zynq UltraScale+ MPSoCZCU102 Rev 1.0 ES2xilinx-zcu102-zu9-es2-rev1.0-v2017.1-final.bsp 

BSP's for earlier boards with ES Silicon can be found at:

ZCU102 Rev D ES1 BSP - Headstart Lounge   

ZCU102 Rev D ES2 BSP - EA Lounge

Note: The "sstate cache file" (sstate-rel-v2017.1.tar.gz) can be found on the Xilinx download area along with an associated README file that outlines the procedure to use "sstate cache".

PetaLinux 2017.1 contains the following build collateral:

ComponentGit repoTagCommit IDBranchComments
Kernel Version 4.9
U-Bootgit://"92e3dd638b50ad22dd90072673c80d8730903e95"masterU-boot Version 2017.01
ARM-Trusted-Firmware (ATF)git://"7d1a6732c9ae113999aeabcb9912369760d05c13"masterATF is based on upstream version 1.3
rel-v2017.1Yocto 2.2 Morty
GCCMB compiler version 6.2
ARM 6.2

PetaLinux 2017.1 New Features:


  • Generate a readme for every BSP we deliver that contains the commands used for pre-built image
  • Include V4L2 support in PetaLinux
  • Vivado 2017.1 OS Support
  • Integrate the DFU Utility in PetaLinux to support the USB Slave boot mode in Zynq UltraScale+ MPSoC
  • Xen Linux / PetaLinux Documentation
  • provide vmlinux image part of prebuild Images , which help customer to debug Linux without having to rebuild.
  • petalinux-package --fpga option, please provide default value to point to bitstream in subsystems/linux/hw-description/ or images/linux
  • petalinux-boot --qemu supports PMU for Zynq UltraScale+ MPSoC
  • Enable lspci utilities default in rootfs
  • Use meta-petalinux generated SDK in PetaLinux
  • PetaLinux Tools adapt to Yocto Morty (2.2) for 2017.1
  • Power Management Firmware Set #1
  • Provided BSP for ZCU102 Rev1.0 (or Higher), which will have production silicon. Enabled the DP by default.
  • Removed Board DTS generation in PetaLinux reference design builder, and make use of the DTG generated DTS for the same.


  • Upgraded to Yocto 2.2 Morty release


  • FSBL now includes a field that allows a customer to specify an "Operational Key"
  • Provision to clear PL irrespective of BOOT.BIN having a bitstream file or not based on user configuration
  • 56K chunk of OCM allocated for authentication and decryption of bitstream in secure boot, to make authentication more secure and speed up the boot process
  • Support USB boot mode which allows secure and non secure boot using the image in a host machine connected via a DFU cable to the target device
  • Support APU only restart
  • FSBL code made compliant with MISRA-C norms


  • Non-Processor mode configuration support in AXI_Ethernet Driver in U-Boot.
  • Capability to write/modify Boot environment variables in to uenv.txt and save it on SD/eMMC.
  • Support for ZCU106 Board
  • Mini U-boot for e-mmc flash programming through VDP Tool
  • Support 1-bit and 2-bit mode QSPI flash programming
  • QSPI flash programming support for Single mode: x1 & x2 and Stacked mode: x1 & x2
  • Support for Ethernet to connect via PL to SFP+
  • UBIFS file system support for QSPI in U-Boot.
  • eMMC HS200 mode support in U-Boot
  • Test DFU Util mode in U-Boot (sanity)
  • Add encryption and authentication security functionality to U-boot for Zynq UltraScale+ applications
  • Support for CG and EG Silicon
  • SD 3.0 support in u-boot


  • DTG to handle static Blob for MPSoC
  • Support for Zynq UltraScale+ MPSoC CG family & EG extension devices
  • Support for Device Tree Generation for Board Components.

ARM-Trusted Firmware (ATF)

  • Support for ATF build from SDK
  • ARM Trusted Firmware support for CG and EG Silicon


  • All Bare-Metal Libraries must have a counterpart in FreeRTOS
  • Updated FreeRTOS release version to the latest in SDK
  • Added FreeRTOS support for CG and EG Silicon

PMU Firmware (PMUFW)

  • PMUFW support for APU Restart
  • PMUFW now uses system configuration data exported from the hardware design for PM operations.

Power Management

  • FPD powered up when coherent mode is enabled for LPD peripherals
  • Productization of Isolation Configuration
  • OpenAMP dependencies on Power management to start/stop RPU from APU Linux kernel to use power management kernel APIs
  • Support for Warm Restart
  • Support PMF configuration change by PCW
  • Enable Linux Clock Gating of devices/peripherals
  • Framework in Linux to control power beyond what is specified in the ATF/PSCI
  • Suspend/Resume time requirements from/to Deep Sleep & Power-off
  • Created a use case example (RTC wakeup) showing how to switch to deep sleep and periodically wakeup from RTC
  • Support Callbacks/Notifications across Master with PMF
  • Frequency scaling will be supported
  • Wake on Support for all the wake-on support devices including LAN, UART, GPIO and USB


  • Drive PS Peripherals from IP Located in the Programmable Logic (MB on PL drives/accesses PS peripherals).
  • Improved documentation for bare metal drivers
  • Float support in A53 Bare Metal BSP
  • SD/eMMC - Code Cleanup (Bus width changes and HSD, DDR mode support for eMMC, support for enhanced partition)
  • Performance Improvements for Bare Metal USB 3.0 driver
  • Add DFU Example in USB BareMetal Driver
  • Need driver support for SGMII LVDS for the VCU118 board
  • Support lwip stack for "PS GEM + PCS PMA in PL" in bare-metal.
  • Bare-Metal support for CG and EG Silicon
  • Test application generation for tmrctr driver fails
  • ATF compliant bare-metal BSP sources for AP
  • Deprecate Xil_Kernel 
  • Verified that all bare metal libraries can run in EL1 as Xen Guest (QSPI, IPI. LwIP issues)

Linux Drivers

  • Support Latency configuration for islands during suspend/resume
  • CCI enablement in PCW (support added in DTG to export CCI related information into DT nodes)
  • Linux Driver for Zynq MPSoC AMS IP in the PS.
  • FPGA manager support for Zynq and Zynq UltraScale+ (Full bitstream, nonSecure, Secure)
  • FPGA Manager: Provide Support for Secure (Encrypted, Authenticated) Bit steam downloading
  • Clock adaptation in all SoftIP Linux drivers including AXII2C, AXIWDT, AXIGPIO, AXI Ethernet, AXIDMA/CDMA/VDMA, AXISPI/QSPI, UartLite, Uartns550
  • Test and report all the USB3.0 gadget devices that Linux supports
  • SERDES driver Enhancements to access SLCR registers for all clock handling through ATF
  • Test and confirm SERDES with all combinations (For example, SATA/DP/Ethernet/USB) in a single system
  • Low Power Mode support for SATA
  • USB 2.0 OTG Driver
  • SDR modes 2 to 5 are failing to capture the read data at 90MHz nand_ref_clk with MAXIMUM SDF corner
  • Added SoC revision read mechanism for Zynq MPSoC
  • Implement I2C bus recovery Support in Linux driver
  • Pin controller driver for Zynq UltraScale+
  • Ethernet support for " PS GEM + PCS PMA in PL" in Linux
  • USB 3.0 drivers should be tuned to get best performance (min 2Gbps)
  • Support UBIFS file system in all QSPI flash configuration modes (Single, Dual Parallel, Dual stacked)
  • I2C Slave functionality needs to be added in I2C Linux driver.
  • 2.5G Ethernet Linux Drivers
  • Linux Kernel support for CG and EG Silicon
  • 10G Ethernet Linux driver for control and data plane with 1588 (Uses 10G/25G Ethernet subsystem)
  • Extend DisplayPipe DRM driver to support UYVY formats and switch between YUYV and UYVY formats run time

Known Issues for 2017.1:
Linux/StandaloneApplicationDescriptionWork-aroundTo be fixed version
StandaloneFSBL2017.1 Zynq UltraScale+ MPSoC: xilpm library fails to build(Xilinx Answer 69108)2017.2
PMUFW2017.1 Zynq UltraScale+ MPSoC: PMUFW does not apply appropriate access controls to MMIO calls(Xilinx Answer 69109)2017.2
2017.1 Zynq UltraScale+ MPSoC: PMUFW fails to detect and acknowledge XMPU/XPPU errors(Xilinx Answer 69110)2017.2
2017.1 - 2016.3/4 Zynq UltraScale+ MPSoC: PMUFW will enable AIB (if existing) to isolate powered down components(Xilinx Answer 68003)2017.2
LinuxPetaLinux2017.1 Zynq UltraScale+ MPSoC: PetaLinux Correct suspend/resume calls to work when FPD is off
(Xilinx Answer 69100)2017.2
LinuxPetaLinux2017.1 Zynq UltraScale+ MPSoC: Linux Power Management Ethernet does not work after suspend-resume cycle(Xilinx Answer 69101)2017.2
LinuxPetaLinux2017.1 Zynq UltraScale+ MPSoC: Linux OpenAMP remoteproc "failed to declare rproc mem as DMA mem"(Xilinx Answer 69114)2017.2
LinuxPetaLinux2016.4/2017.1 PetaLinux: Static IP assignment in PetaLinux menu config "Subsystem AUTO Hardware Settings" not working
(Xilinx Answer 69119)2017.2
LinuxPetaLinux2017.1 Zynq UltraScale+ MPSoC: petalinux-package command generated BOOT.BIN is not loading kernel image from QSPI
(Xilinx Answer 69111)2017.2
LinuxPetaLinux2016.4/2017.1 MicroBlaze: PetaLinux ssh command failed to connect to MicroBlaze boards from host machine(Xilinx Answer 69121)2017.2
LinuxPetaLinux2016.4/2017.1 PetaLinux: Firmware Version Configuration not updated in the Linux image
(Xilinx Answer 69122)2017.2
LinuxPetaLinux2017.1 PetaLinux: XSDK crashes when running petalinux-build
(Xilinx Answer 69104)2017.2
LinuxPetaLinux2016.4 PetaLinux : Build (petalinux-build) failure when using ddr3 in the Kintex design
(Xilinx Answer 69106)2017.2
LinuxPetaLinux2017.1 PetaLinux: Xen images built by PetaLinux do not work as expected
(Xilinx Answer 69105)2017.2
LinuxPetaLinux2017.1 PetaLinux: Zynq UltraScale+ MPSoC lacks addressing for high-order DRAM (Xilinx Answer 69117)
LinuxPetaLinux2016.4/2017.1 PetaLinux: sysroot build errors during migration from 2016.3 version to 2016.4/2017.1 version
(Xilinx Answer 69124)
LinuxPetaLinux2017.1 Zynq UltraScale+ MPSoC: PetaLinux fails to build and configure U-Boot(Xilinx Answer 69112)2017.2
LinuxDevice-tree2017.1 Zynq UltraScale+ MPSoC: PetaLinux menuconfig changing UART device settings does not change UART device number in device-tree(Xilinx Answer 69126)2017.2
LinuxPetaLinux2017.1 MicroBlaze: PetaLinux includes MicroBlaze design or IP details in README.(Xilinx Answer 69118)2017.2
LinuxPetaLinux2017.1 Zynq UltraScale+ MPSoC: PetaLinux fails to build uboot with UBIFS file system support for QSPI(Xilinx Answer 69113)2017.2
LinuxU-Boot2017.1 U-boot: spi_flash_probe_bus_cs() failed with QEMU(Xilinx Answer 69103)
LinuxOpenAMP2017.1 Zynq UltraScale+ MPSoC: OpenAMP applications dependency on UART serial console(Xilinx Answer 69115)
LinuxPetaLinux2017.1 Zynq UltraScale+ MPSoC: Linux no V4L2 pixel format for RBG888(Xilinx Answer 69127)
LinuxPetaLinux2017.1 Zynq UltraScale+ MPSoC: Linux Display does not show terminal logs after resume from FPD off(Xilinx Answer 69129)2017.2
StandaloneLibrariesv2.0 - xilfpga - Xilfpga library fails to load the Authenticated bit stream because of wrong check in XFpga_PL_BitSream_Load()(Xilinx Answer 69125)
LinuxPetaLinux2017.1 PetaLinux: Issue with USB2.0 UVC-gadget application on Zynq UltraScale+ MPSoC(Xilinx Answer 69102)2017.2
StandaloneFSBLZynq UltraScale+ MPSoC - SGMII using PS-GTR - Why is the Zynq MP PHY driver reconfiguring the lanes previously set up for SGMII by the FSBL?(Xilinx Answer 68866)None
LinuxPetaLinux2017.1 Zynq UltraScale+ MPSoC: Linux MACB MDIO support for single MAC managing multiple PHYs (Xilinx Answer 69132)2017.2
LinuxDevice-tree2017.1/2 Zynq UltraScale+ MPSoC: Linux hangs when accessing PL peripheral generated by yocto(Xilinx Answer 69587)2018.1
LinuxXSDK2017.1-2017.3 Zynq UltraScale+ MPSoC: Connecting XSDB to Linux CPU idle (Xilinx Answer 69143)2017.4

Linked Answer Records

Master Answer Records

Answer Number Answer Title Version Found Version Resolved
55776 Release Notes and Known Issues for PetaLinux 2013.04 and later tool versions N/A N/A
AR# 69074
Date 05/18/2018
Status Active
Type Release Notes
Tools More Less
Boards & Kits More Less
People Also Viewed