AR# 69952


PetaLinux 2017.3 - Product Update Release Notes and Known Issues


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



BSPs supported for 2017.3 PetaLinux Release

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

Platform Variant BSP Name
Zynq-7000 ZC702 ZC702 BSP
Zynq-7000 ZC706 ZC706 BSP
MicroBlaze AC701 AC701 BSP
MicroBlaze KCU105 KCU105
MicroBlaze KC705 KC705 BSP
Zynq UltraScale+ MPSoC ZCU102 production silicon ZCU102 BSP (prod-silicon)
Zynq UltraScale+ MPSoC ZCU102 ZU9 ES2 Rev 1.0 ZCU102-ZU9-ES2 Rev 1.0 BSP


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

Refer to the attached file "2017.3-PetaLinux-Packages-List" for software package versions tested on host machines, which is required for PetaLinux installation tools.
Follow the attached README for steps to create BSPs using the template flow.

PetaLinux 2017.3 contains the following build collateral:


Component Git repo Branches/Tag Commit ID Comments
FSBL git:// xilinx-v2017.3 "3c9f0cfde9307c2dc1a298f9f22d492601232821" FSBL for Zynq7000 is at embeddedsw/lib/sw_apps/zynq_fsbl
FSBL for Zynq UltraScale+ is at embeddedsw/lib/sw_apps/zynqmp_fsbl
PMU Firmware git:// xilinx-v2017.3 "3c9f0cfde9307c2dc1a298f9f22d492601232821" PMU for Zynq UltraScale+ Firmware is at embeddedsw/lib/sw-apps/zynqmp_pmufw
Device-tree git:// xilinx-v2017.3.1 "5b21302249df23f0de9b3b6ec4c75704339e3414"  
Linux git:// xilinx-v2017.3 "f1b1e077d641fc83b54c1b8f168cbb58044fbd4e" Kernel Version 4.9
U-Boot git:// xilinx-v2017.3 "da811c4511ef9caeb95f9a22fe49d38bd8e56ded" U-boot Version 2017.01
QEMU git:// xilinx-v2017.3 "8f8c89b18f6e4523099e41d81769fc534064b8de"  
Xen git:// xilinx-v2017.3 "89dceb9fc81120e6a914f998763dd4c49b74d3d5"
ARM-Trusted-Firmware (ATF) git:// xilinx-v2017.3 "f9b244beaa7ac6a670b192192b6e92e5fd6044dc" ATF is based on upstream version 1.3
Yocto git://
rel-v2017.3   Yocto 2.2 Morty
qemu-devicetrees git:// xilinx-v2017.3 "4b951c594078562e9dd828430075968dd91ac425"  
OpenAMP git:// xilinx-v2017.3 "b041167a42a75f08c7b709622158f8d9d346a594"  
libmetal git:// xilinx-v2017.3 "962bc1fe8df758bfea0fe831f0c1192e1f6045b8"
GCC       MB compiler version 6.2
ARM 6.2


Wiki Updates:

Covers details for Linux Kernel, Device drivers, U-boot, ATF and DTG changes (new features/fixes) in a particular release. 

2017.3 Linux and DTG release notes wiki page:

2017.3 U-Boot release notes wiki page :

2017.3 ATF release notes wiki page :


2017.3 New Features:




  • Individual workspace of XSCT in PetaLinux projects
  • PetaLinux support for Vivado 2017.3 installed host OS 
  • For more details please see (UG1144)(UG1156) and (UG1157).



  • None





  • None



  • U-Boot Documentation Improvements - Capture the Filesystem types supported for all the Boot mediums
  • Provide UBIFS file system support for on-die ECC enabled NAND on Zynq UltraScale+ MPSoC



  • Add support for AXI Interrupt controller in cascade mode in the Device tree generator


ARM-Trusted Firmware (ATF)



  • Added new SMC support for SHA3 calculation support from ELs other than EL3.
  • Added new SMC support for RSA to encrypt with private key and verify with public key.
  • Fixed incorrect chipId calculation.




  • None


PMU Firmware (PMUFW)


  • None


Power Management


  • None




  • Removed older versions of drivers are libraries that have become obsolete.
  • EL1-NS support for Zynq MP PS drivers
  • CCI support for Zynq MP PS drivers using DMA
    • NAND, QSPI, zDMA, EmacPS, SD 
  • New drivers added for:
    • dpdma_v1_0 driver for the DP DMA in Zynq MP

    • avbuf_v1_0 driver for Video Pipeline of the DisplayPort Subsystem in Zynq MP

    • dppsu_v1_0 driver for DisplayPort Transmitter in Zynq MP

    • mcdma_v1_0 driver for AXI MultiChannel Direct Memory Access  IP

    • v_sdirx_v1_0 driver for UHDSDI Rx soft IP 
    • v_sdirxss_v1_0 driver UHDSDI Rx subsystem soft IP 
    • v_sditx_v1_0 driver for UHDSDI Tx soft IP 
    • v_sditxss_v1_0 driver for UHDSDI Tx subsystem soft IP 
    • sdi_common_v1_0 driver for common functions used in SDI drivers and applications
    • v_demosaic_v1_0 for DeMosiac IP
    • v_gamma_lut_v1_0 for Gamma Lut IP
  • Changes around Video related drivers
    • v_csc_v2_2 , vprocss_v2_4 drivers  : Support for conversion from 420/422/444/RGB to 420/422/444/RGB 
    • v_frmbuf_rd_v2_0, v_frmbuf_wr_v2_0, v_mix_v3_0 drivers :  New streaming and memory video formats and 64 bit address support for memory mapped interfaces. Support for second buffer for semi-planar formats 
    • video_common_v4_2 driver 
      • Addition of new video modes, frame rates, color formats for SDI.
      • Addition of  new member AspectRatio to video stream structure
      • Addition of XVIDC_VM_3840x2160_60_P_RB video format
      • Addition of new streaming alpha formats and new memory formats
  • Baremetal BSP (standalone_v6_4):  
    • Support for CCI at EL1-NS.
    • Revamp of R5 MPU handling logic with addition of new APIs
    • Bug fixes 
  • XilFpga Library(xilfpga_v3_0):
    • Support for Device-key Encrypted bitstream loading and PL configuration registers readback. 
  • XilSecure Library(xilsecure_v2_2):
    • RSA decrypt with private key and encrypt with public key support.
    • RSA 2048 support.
    • New APIs to support xilsecure functionalities in Linux. 
  • XilSkey Library (xilskey_v6_3):
    • Support for programming eFUSE and BBRAM of Kintex UltraScale plus.
  • lwIP stack(lwip141_v1_9):
    • Support for EL1-NS
    • Support for CCI
    • FreeRTOS support for AXI Ethernet adapter that uses AXI FIFO
    • Bug fixes 
  • XilIsf Library(xilisf_v5_9):
    • 4Byte addressing support for Micron devices.
  • AXI Ethernet Driver(axiethernet_v5_6):
    • Support for MCDMA. 
  • SDPS Driver (sdps_v3_3):
    • Support for 64bit DMA addressing
    • Support for 200MHz in SD driver
  • AXI DMA Driver (axidma_v9_4):
    • Support for cyclic DMA mode. 
  • mbox driver(mbox_v4_2):
    • Support for FIFO reset using hardware control register
  • Minor bug fixes across drivers
  • Fix for compilation warning across drivers 
  • Fix for doxygen documenting across drivers
  • ZynqMP_FSBL
    • Support for Secondary boot mode as specified in image header of the boot image
    • Support for 1-bit and 2-bit QSPI buswidths
    • For secure boot, added PPK invalidity checks
  • ZynqMP_PMUFW
    • Added three level debug prints for PMU Firmware application
    • Added xilsecure API calls to support xilsecure functionality from Linux
    • Multiple changes related to self refresh functionality (save/restore)

Linux Drivers

  • Support for QSPI IS25LP256D, N25Q00, MT25Q 128 Mb, 256 Mb devices and Parallel NOR Flash: MT28EW devices 128Mb, 256Mb
  • Support Linux PCIe RP Driver for PL based PCIe Hard IP on Zynq UltraScale+ MPSoC devices
  • USB3.0 stream transfers for Bulk endpoint validation
  • Support for VLAN and Priority queue support in macb driver
  • Support for 10G/25G Ethernet 1588 MCDMA driver
  • HW Crypto Accelerators accessing framework for RSA and SHA3

OpenAMP and Libmetal


  • LibMetal source clean-up
  • LibMetal Documentation Enhancement
  • OpenAMP Documentation Enhancements



  • QEMU Windows Host Support


  • Support 4K60 through the VCU SW stack with File IO
  • Documentation of Multimedia software stack for Zynq MPSoC
  • VCU SW stack latency report for Control SW, OMX and Gstreamer


Known Issues for 2017.3:

Linux/Standalone Application Description Work-around To be fixed version
Linux Documentation 2017.3/4 PetaLinux: Ubuntu 16.04.1 version in supported linux distribution doesn't align with UG973 and UG1144. (Xilinx Answer 70395) 2018.1
Linux Drivers 2017.1-2017.4 Zynq UltraScale+ MPSoC: Linux MACB MDIO support for single MAC managing multiple PHYs (Xilinx Answer 69132) 2018.1
Linux QEMU 2017.1-2017.4 U-boot: spi_flash_probe_bus_cs() failed with KCU105 and AC701 QEMU (Xilinx Answer 69103) 2018.1
Linux Drivers 2017.1-2017.4 Zynq UltraScale+ MPSoC: Linux hangs when accessing PL peripheral generated by Yocto (Xilinx Answer 69587) 2018.1
Linux XSDK 2017.1-2017.4 Zynq UltraScale+ MPSoC: Connecting XSDB to Linux CPU idle  (Xilinx Answer 69143)  
Standalone XSDK 2017.3 Vivado/SDK - SDK fails to generate xparameters for PCS/PMA when connecting to ENET1/2/3 (Xilinx Answer 69980) 2017.4
Linux PetaLinux Zynq UltraScale+ MPSoC: How to enable UHS(SD 3.0) support for ZCU102 and ZCU106 evaluation board PetaLinux BSPs  (Xilinx Answer 69978)  
Linux PetaLinux 2017.3 PetaLinux: Change to the name of FIT image (image.ub) in petalinux-config menu not reflected once images are built
(Xilinx Answer 69979) 2017.4
Linux PetaLinux 2016.4-2017.4 Zynq UltraScale+ MPSoC: PetaLinux does not correctly override the U-boot environment variables to set SD boot when both eMMC (SDIO0) and SD (SDIO1) are enabled in design (Xilinx Answer 69780) 2018.1
Linux PetaLinux 2017.1-2017.4 PetaLinux: QEMU flash_stripe.c is not included in the QEMU utilities shipped with PetaLinux  (Xilinx Answer 69975) 2018.1
Linux Device-tree 2017.1-2017.4 Zynq UltraScale+ MPSoC: Linux mmcblk0 error -110 sending stop command, original cmd response 0x900, card status 0xe00 using Swissbit SD card (Xilinx Answer 69995) 2018.1
Standalone XSDK 2017.2/3 Zynq UltraScale+ MPSoC: FSBL Boot image with Key Rolling causes XFSBL Tag Mismatch error  (Xilinx Answer 70005) 2017.4
Linux Device-tree 2017.1-2017.4 Zynq UltraScale+ MPSoC: Linux causes a hang in RPU code which was running fine until Linux loaded  (Xilinx Answer 70009) 2018.1
Linux Drivers 2016.4-2017.4 Zynq UltraScale+ MPSoC: Linux DDR EDAC driver unable to inject ECC errors when using either 32-bit DQ width, address mapping or Bank/Row/Column addressing mode  (Xilinx Answer 69997) 2018.1
Linux Driver 2017.3 Linux: AXI DMA test client errors  (Xilinx Answer 70011) 2017.4
Linux VCU 2017.3 Zynq UltraScale+ MPSoC (VCU): Frame drops are observed in 4kp60fps transcode use case in Linux  (Xilinx Answer 70013) 2017.4
Linux VCU 2017.3 Zynq UltraScale+ MPSoC (VCU): Multistream decoder > 4 FULL HD instance fails with memory allocation errors in Linux (Xilinx Answer 70014) 2017.4
Linux Xen 2017.3 Zynq UltraScale+ MPSoC: Xen Ethernet passthrough fails in PetaLinux  (Xilinx Answer 70007) 2017.4
Linux Xen 2017.3 Zynq UltraScale+ MPSoC: Xen Linux reboot command on Dom0 does not work. (Xilinx Answer 70163) 2017.4
Standalone XSDK 2017.3 Zynq UltraScale+ MPSoC: SDK extra_compiler_flags appending the default values  (Xilinx Answer 70217) 2017.4
Linux PetaLinux 2017.1-2017.4 PetaLinux: Removing DTB "from boot image" settings causes U-Boot to fail to load ramdisk image.ub (Xilinx Answer 70304) 2018.1
Linux Device-tree 2017.3/4 Zynq-7000: DTG does not build for single core Zynq design (Xilinx Answer 70402) 2018.1


文件名 文件大小 File Type
2017.3-PetaLinux-Packages-List.xlsx 19 KB XLSX
README_content.txt 1 KB TXT
2017.4-PetaLinux-Packages-List.xlsx 19 KB XLSX



Answer Number 问答标题 问题版本 已解决问题的版本
55776 Release Notes and Known Issues for PetaLinux 2013.04 and later tool versions N/A N/A
AR# 69952
日期 06/07/2018
状态 Active
Type 版本说明
Tools More Less
Boards & Kits More Less
People Also Viewed