69952 - PetaLinux 2017.3 - Product Update Release Notes and Known Issues

Title

69952 - PetaLinux 2017.3 - Product Update Release Notes and Known Issues

Description

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.

Solution

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.

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:

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:

http://www.wiki.xilinx.com/+2017.3+Linux+and+DTG+Release+Notes

2017.3 U-Boot release notes wiki page :

http://www.wiki.xilinx.com/2017.3+u-boot+Release+Notes

2017.3 ATF release notes wiki page :

http://www.wiki.xilinx.com/2017.3+ATF+Release+Notes

2017.3 New Features:

PetaLinux

• 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).

Yocto

• None

FSBL

• None

U-boot

• 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

Device-tree

• 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.

FreeRTOS

• None

PMU Firmware (PMUFW)

• None

Power Management

• None

Standalone

• 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

• QEMU Windows Host Support

VCU

• 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:

README_content

=============================

Contents in the download area

In the download area along with the PetaLinux tool installer and BSPs for various HW. The following content is also available for download:

1. PetaLinux 2017.3 License and copyrights info (TAR/GZIP) file:

   This file contains the copyright headers of all the SW components shipped as part of the PetaLinux tool. It also contains the copyright headers for all the SW packages, available at https://petalinux.xilinx.com/ that petaLinux tool packages in the project, when selected. This file is provide as part of legal requirement for your viewing only. It is not required to be downloaded for using the PetaLinux tool or BSPs.

​

1. PetaLinux 2017.3 Open Components Source Code (TAR/GZIP) file:

This file contains the source code of all the SW components shipped as  part of the PetaLinux tool. It also contains the source code for all the  SW packages, available at https://petalinux.xilinx.com/ that petaLinux tool packages  in the project, when selected. This file is provide as part of legal requirement  for your viewing only. It is not required to be downloaded for using  the PetaLinux tool or BSPs.

Sample list of components in the files 1) and 2):

	QEMU

	busybox

	mtd-utils

	libfdt

	dtc

	u-boot

	device-tree-generator

	iso-codes

	ca-certificates

	db

	bash

	Linux

	ATF

	XEN

	kconfig-frontends

	Note: more than 1000 other SW components.

README

================================ MICROBLAZE BSP generation steps: ================================ This section explain about BSP generation steps.

1. Create and Configure a project $ petalinux-create -t project –template microblaze –force -n $ petalinux-config --get-hw-description= --oldconfig $ petalinux-config -c kernel
2. Select following configs and save it. I2C_MUX EEPROM_AT24 I2C_MUX_PCA954x I2C_CHARDEV COMMON_CLK_SI570 CONFIG_TMPFS (enable for kcu105 design)
3. Project Build $ petalinux-build $ mkdir -p pre-built/linux/images $ cp /images/linux/* /pre-built/linux/images/
4. Package the BSP with files generated with following command $ petalinux-package –bsp -p --hwsource --output

NOTE: –hwsource is optional and can be removed

========================== ZYNQ BSP generation steps: ========================== This section explain about BSP generation steps. Note: While building bsps, we use openAMP files from internal repos. when configuring and packing the root file system of the target. If you want to use openamp on your target ,Please copy files from
from published bsp’s. While copying files please maintain same directory structure.

1. Create and Configure a project $ petalinux-create -t project –template microblaze –force -n $ petalinux-config --get-hw-description= --oldconfig $ petalinux-config -c kernel
2. Select following configs and save it. I2C_XILINX I2C_MUX I2C_MUX_PCA954x I2C_CHARDEV
3. Choose any desired board and follow steps in it. a. zc702 board $ petalinux-config Add zynq_zc702_config to SUBSYSTEM_UBOOT_CONFIG_TARGET b. zc706 board $ petalinux-config Add zynq_zc706_config to SUBSYSTEM_UBOOT_CONFIG_TARGET
4. Get openamp device tree $ cp /project-spec/meta-user/recipes-bsp/device-tree/files/openamp-overlay.dtsi /project-spec/meta-user/recipes-bsp/device-tree/files $ echo '/include/ "openamp-overlay.dtsi"' >> /project-spec/meta-user/recipes-bsp/device-tree/files/system-user.dtsi $ echo 'SRC_URI += "file://openamp-overlay.dtsi"' >> project-spec/meta-user/recipes-bsp/device-tree/device-tree-generation_%.bbappend
5. Enable openamp and its examples in rootfs $ petalinux-config -c rootfs Enable following packages and save it openamp-fw-echo-testd openamp-fw-mat-muld openamp-fw-rpc-demo packagegroup-petalinux-openamp
6. Project Build $ petalinux-build $ mkdir -p pre-built/linux/images $ cp /images/linux/* /pre-built/linux/images
7. Clean up configurations by default few configurations are enabled to generate prebuilt images. These configurations are cleaned up while packaging a bsp. However you can keep them if you needed them in project. $ petalinux-config -c rootfs Disable following packages and save it openamp-fw-echo-testd openamp-fw-mat-muld openamp-fw-rpc-demo packagegroup-petalinux-openamp
8. Package the BSP with files generated with following command $ petalinux-package –bsp -p --hwsource --output

NOTE: –hwsource is optional and can be removed

============================ ZYNQMP BSP generation steps: ============================ This section explain about BSP generation steps. Note: While building bsps, we use some openAMP, Xen and QEMU files from internal repos. If you want to use openAMP, Xen or QEMU,Please copy the files from published bsp’s. While copying files, please maintain same directory structure.

1. Creation and configuration of project $ petalinux-create -t project –template zynqMP –force -n $ petalinux-config --get-hw-description= --oldconfig
2. Get openamp,qemu and xen device trees $ cp -r /project-spec/meta-user/recipes-bsp/device-tree/files/{openamp-overlay.dtsi,xen-overlay.dtsi,zynqmp-qemu-arm.dts,multi-arch/} /project-spec/meta-user/recipes-bsp/device-tree/files $ echo '/include/ "openamp-overlay.dtsi"' >> /project-spec/meta-user/recipes-bsp/device-tree/files/system-user.dtsi $ echo 'SRC_URI += "file://openamp-overlay.dtsi"' >> project-spec/meta-user/recipes-bsp/device-tree/device-tree-generation_%.bbappend
3. Enable openamp and its examples in rootfs $ petalinux-config -c rootfs Select following packages and save it openamp-fw-echo-testd openamp-fw-mat-muld openamp-fw-rpc-demo packagegroup-petalinux-openamp
4. Configuring BSP a. zcu102 production and zcu102 rev1.0 boards b. zcu102 es1, zcu102 es2 and zcu102 revD boards c. zcu104 board d. zcu102 warm restart board e. zcu106 board f. zc1254 board
5. Choose any desired board and follow steps in it. a. zcu102 production and es2 rev1.0 board $ petalinux-config Add xilinx_zynqmp_zcu102_rev1_0_defconfig to SUBSYSTEM_UBOOT_CONFIG_TARGET b. zcu102 es1, es2 and revD board $ petalinux-config Add xilinx_zynqmp_zcu102_revB_defconfig to SUBSYSTEM_UBOOT_CONFIG_TARGET c. zcu104 board $ petalinux-config Add xilinx_zynqmp_zcu104_revA_defconfig to SUBSYSTEM_UBOOT_CONFIG_TARGET d. zcu102 warm restart board $ cat » project-spec/meta-user/recipes-core/images/petalinux-image.bbappend «EOF IMAGE_INSTALL_append = “ wdt-heartbeat” IMAGE_INSTALL_append = “ mpsrm-init” IMAGE_INSTALL_append = “ openamp-fw” EOF $ petalinux-config –oldconfig $ petalinux-config -c rootfs Select following packages and save it wdt-heartbeat mpsrm-init openamp-fw $ echo ‘SIGGEN_UNLOCKED_RECIPES += “initscripts”’ » /build/conf/local.conf $ petalinux-config -c kernel Select following configs and save it IRQ_DOMAIN_DEBUG GCOV_KERNEL FREEZER SUSPEND PM SRAM $ petalinux-config Add xilinx_zynqmp_zcu102_rev1_0_defconfig to SUBSYSTEM_UBOOT_CONFIG_TARGET NOTE: Copy wdt-heartbeat,mpsrm-init,openamp-fw recipes from the warm restart BSP at project-spec/meta-user/recipes-apps/{openamp-fw,wdt-heartbeat}, project-spec/meta-user/recipes-core/mpsrm-init e. zcu106 design $ echo 'IMAGE_INSTALL_append = " gstreamer-vcu-examples"' >> /project-spec/meta-user/recipes-core/images/petalinux-image.bbappend $ petalinux-config --oldconfig $ petalinux-config -c rootfs Select following packages and save it packagegroup-petalinux-gstreamer packagegroup-petalinux-matchbox packagegroup-petalinux-x11 libdrm libdrm-kms libdrm-tests gstreamer-vcu-examples $ petalinux-config Add xilinx_zynqmp_zcu106_revA_defconfig to SUBSYSTEM_UBOOT_CONFIG_TARGET NOTE: Copy recipee-multimedia from zcu106 bsp at project-spec/meta-user/recipes-multimedia f. zc1254 $ cat >> project-spec/meta-user/recipes-core/images/petalinux-image.bbappend <<EOF IMAGE_INSTALL_append = " rfdc" IMAGE_INSTALL_append = " rfdc-intr" IMAGE_INSTALL_append = " rfdc-read-write" IMAGE_INSTALL_append = " rfdc-selftest" EOF $ petalinux-config --oldconfig $ petalinux-config -c rootfs Select following packages and save it rfdc rfdc-intr rfdc-read-write rfdc-selftest $ petalinux-config Add xilinx_zynqmp_zc1254_revA_defconfig to SUBSYSTEM_UBOOT_CONFIG_TARGET NOTE: Copy fsbl from zc1254 bsp at project-spec/meta-user/recipes-bsp/fsbl
6. Project Build $ petalinux-build $ mkdir -p pre-built/linux/images $ cp /images/linux/* /pre-built/linux/images/
7. Build xen images $ echo ‘/include/ “xen-overlay.dtsi”’ » /project-spec/meta-user/recipes-bsp/device-tree/files/system-user.dtsi $ echo 'SRC_URI += "file://xen-overlay.dtsi \"' >> project-spec/meta-user/recipes-bsp/device-tree/device-tree-generation_%.bbappend $ petalinux-config Select following config and save it. Image Packaging Configuration Root filesystem type (INITRD) $ petalinux-config -c rootfs Select following package and save it packagegroup-petalinux-xen $ petalinux-build $ cp -L /images/linux/Image /pre-built/linux/images/xen-Image $ cp -L /images/linux/system.dtb /pre-built/linux/images/xen.dtb $ cp -L /images/linux/xen.ub /pre-built/linux/images/xen.ub $ cp -L /images/linux/rootfs.cpio.gz.u-boot /pre-built/linux/images/xen-rootfs.cpio.gz.u-boot
8. Clean up of configurations by default few configurations are enabled to generate prebuilt images. These configurations are cleaned up while packaging a bsp. However you can keep them if you needed them in project. $ petalinux-config -c rootfs Disable following packages and save it openamp-fw-echo-testd openamp-fw-mat-muld openamp-fw-rpc-demo packagegroup-petalinux-openamp packagegroup-petalinux-xen $ petalinux-config Select following config and save it. Image Packaging Configuration Root filesystem type (INITRAMFS)
9. Package the BSP with files generated with following command $ petalinux-package –bsp -p --hwsource --output

NOTE: –hwsource is optional and can be removed

2017.3-PetaLinux-Packages-List

Tool/Library Versions

RHEL/CentOS versions

Ubuntu