Zynq Ultrascale+ MPSoC/Versal firmware driver

Linux Drivers

Release Date: 2023-07-22

Xilinx Zynq UltraScale+ MPSoC Video Codec Unit
Overview
Supported Features
API information and Example pipelines
Source code repos
CMA Size setting instructions for Yocto and Petalinux users:
Using kernel menuconfig option
Using bootargs at uboot prompt
Using custom uEnv.txt for Yocto
Device Tree Binding
Known Issues
2022.2 Release
New Feature Support:
Bug Fixes:
Known Issues:
2022.1 Release
New Feature Support:
Bug Fixes:
Known Issues:
2021.2 Release
New Feature Support:
Bug Fixes:
Known Issues:
2021.1 Release
New Feature Support:
Bug Fixes:
Known Issues:
2020.2 Release
2020.1 Release
New Feature Support:
2019.2 Release :
New Feature Support
Bug Fixes
2019.1 Release :
New Feature Support
Bug fixes
2018.3 Release :
2018.2 Release :
Linux I2S Driver
Introduction
Typical system using I2S Rx and I2S Tx
Driver Overview
Kernel Configuration options for Driver
Device Tree Binding
Procedure to test I2s with Gstreamer Utilities
Pass Through i2s driver testing Procedure
Debug capability
/proc/asound/card#/pcm0p/xrun_debug
Boards Supported
Change log
Related Links
Xilinx TSN Solution
Xilinx TSN Driver
Xilinx ALSA ASoC driver
Introduction
HW IP Features
Driver Features
Known Issues & Limitations
Kernel Configurations
Device tree binding
Test Procedure
Change Log
2020.1
2019.2
2019.1
2018.3:
Related Links
Zynq UltraScale+ MPSoC AMS
Introduction
HW/IP features
PL block
PS block
Missing features, known Issues, limitations
Kernel configurations
Device Tree Settings
Test Procedure
Test Case 1: Read channel value via sysfs
Test Case 2: Get rising event for channel using sample application
Test Case 3: Rising event – negative test using sample application
Test Case 4: Get falling event for voltage channel using sample application
Change Log
Mainline status
Related Links
APM
APM_1
Introduction
This page describes the APM driver which is available in Xilinx Linux distribution as drivers/uio/uio_xilinx_apm.c HW IP features
Features supported in driver
Missing Features and known Issues/Limitations in Driver
Kernel Configuration
The following config options should be enabled in order to build the apm driver:
Devicetree
AXI PL APM Example:
There are 4 APMs available on the Zynq Ultrascale PS:
Test Procedure
Run the apm app. The app can be found at https://github.com/ Xilinx/linux-xlnx/tree/master/samples/xilinx_apm
Mainline Status
The driver is not mainlined.
Change Log
Related Links
Axi timer
AXI Timer
Introduction
HW IP features
Kernel Configuration
Devicetree
Mainline status
Boot log snippet
Changelog
AXI USB gadget driver
Introduction
HW/IP Features
Features supported by driver
Kernel Configuration
Devicetree
Performance
Test Procedure
Mainline Status
Change Log
Axi Watchdog
Axi_Watchdog_1
Introduction
HW IP Features
Known Issues and Limitations
Kernel Configuration
Devicetree
Test procedure
Mainline Status
Change Log
Related Links
Linux AXI Ethernet driver
HW IP features
AXI 1G/2.5G Ethernet Subsystem (PG138)
10 Gigabit Ethernet subsystem (PG157)
10G/25G Ethernet Subsystem (PG210)
USXGMII Ethernet Subsystem (PG251)
MRMAC Ethernet Subsystem (PG314)
Features supported in the driver
Missing Features and Known Issues/Limitations in Driver
Important AR links
Kernel Configuration
Device-tree
Soft Ethernet MAC(1G, legacy 10G or 10G/25G MAC, MRMAC) Configured with MCDMA
Related device tree information
IEEE 1588 Support
Performance
1G Ethernet with AXIDMA
10G Ethernet with AXIMCDMA
Diagnostic and Protocol Tests
Stress Test
Performance Test
1588 Testing
Mainline status
Change Log
Related Links
Linux GIC Driver
Introduction
Interrupt Types
Peripheral Interrupt
Software-generated interrupt (SGI)
Device Tree
Change Log
Linux CAN driver
Introduction
HW/IP Features
Features supported in driver
Missing features, Known Issues and Limitations
Kernel Configuration
Device Tree
Test Procedure
CAN Driver Testing from user space
Expected Output
Mainline status
Change Log
2023.1
2022.2
2022.1
2021.2
2021.1
2020.2
2020.1
2019.2
2019.1
2018.3
2018.2
2018.1
2017.4
2017.3
2017.2
2017.1
2016.4
2016.3
Related Links
Linux DMA From User Space
Introduction
Background Knowledge
Coherency
Cached versus Non-Cached Memory
Kernel Space versus User Space For DMA
DMA In Linux
The Linux DMA Engine Framework
Xilinx Provided DMA Drivers
Linux Kernel APIs
DMA Proxy Design
Design Details
Hardware Design
Source Files
Changed From Previous Design
Alternative Designs
DMA Proxy Design for AXI CDMA
User Space Only Without Kernel Driver
Linux DMA From User Space 2.0
Introduction
System Requirements and Assumptions
Hardware
AXI DMA
Receive Only
Coherency
Advanced System Techniques
AXI Back Pressure
Jitter
Stream FIFOs
Software
Functional Changes
Non-Blocking Design
Channel Buffers
Kernel Details
Proxy Device Tree
Kernel Configuration
CCI Enablement
Dma-proxy-test Application Details
Results
Source Code
System Observations
Quick Start
Hardware
Software
Known Issues
Linux Multichannel DMA from User Space
Introduction
Background Knowledge
Why Multichannel?
System Requirements and Assumptions
Hardware
Data Generators
Interrupt Lines
MCDMA Options
System ILA
Source Files
Software
Device Tree
Proxy Driver
Proxy Application
Running the Application
Inserting the Kernel Module
Running the Application
Conclusion
Linux EDAC Driver
Overview
HW/IP Features
Missing features, Known Issues and Limitations
Kernel Configurations
Device tree Node Settings
Mainline Status
Test Procedure
Zynq
ZynqMP
Expected Output
Zynq
ZynqMP
Change log
2016.3
2016.4
2017.1
2017.2
2017.3
2017.4
2018.1
2018.2
2018.3
2019.1
2019.2
2020.1
2020.2
2021.1
2021.2
2022.1
2022.2
2023.1
Related Links
Linux Emaclite Driver
Ethernetlite driver is in minimal support mode and will be deprecated shortly
Introduction
HW IP features
Features supported
Features Supported in the driver
Missing Features and Known Issues/Limitations in Driver
Kernel Configuration
Devicetree
Test Procedure
Diagnostic and Protocol Tests
Netperf
Stress Test
Netperf
Performance Tests
Netperf
Mainline status
Change Log
Related Links
Linux FPU 440
Linux GPIO Driver
HW IP Features
Versal
ZynqMP
Zynq
Features supported in driver
Versal
ZynqMP
Zynq
Missing Features, Known Issues and Limitations
Kernel Configuration
Devicetree
Test procedure
SysFs Interface
Using GPIO with SysFs
Mounting Sysfs
Using the GPIO driver from User Space
Using the GPIO Driver from a User Space Application
Linux Kernel Drivers
Additional Setup Required
Board schematic (GPIO pinout)
Required Information from the Device Tree
LEDS-GPIO Driver
Add LEDs to the Device Tree
Kernel Configuration
Using the LEDs
GPIO-Keys Driver
Add GPIO-Keys to the Device Tree
Kernel Configuration
Using the GPIO-Keys
GPIO-Keys-Polled
Demo Application
Mainline Status
Change Log
2023.1
2022.2
2022.1
2021.2
2021.1
2020.2
2020.1
2019.2
2019.1
2018.3
2018.2 Summary:
2018.1 Summary:
2017.4
2017.3 Summary:
2017.2
2017.1 Summary:
2016.4
2016.3 Summary:
Related Links
Linux Clocking Wizard
HW IP Features
Known Issues and limitations
Kernel Configuration
Devicetree
Test procedure
Mainline Status
Change Log
Linux I2C Driver
HW IP Features
Known Issues and limitations
Kernel Configuration
Devicetree
Test procedure
Expected Output
Mainline Status
Change Log
Linux LLTEmac Flat
Zynq UltraScale+ MPSoC PS-PCIe End Point Driver
Linux Soft PCIe Driver
AXI PCIe Soft IP
Hardware Setup
Root Port Driver Configuration
End Point Driver Configuration
Device Tree binding
Test Procedure
Kernel Console Output
Driver Initialization for Zynq
Driver Initialization for Microblaze
Broadcom NIC card probing
lspci output
Ethernet Interface
Testing of Ethernet interface
MSI Interrupts Zynq:
MSI Interrupts Microblaze:
Related Links
Linux ZynqMP PS-PCIe Root Port Driver
Controller for PCI Express
End Point Driver Configuration
Rootfs Configuration
Device Tree binding
Test Procedure
Kernel Console Output
Driver Initialization for ZynqMP
Broadcom NIC card probing
lspci output
Ethernet Interface
Testing of Ethernet interface
MSI Interrupts
Related Links
Xilinx Linux PL PCIe Root Port
XDMA IP
Root Port Driver Configuration
ZynqMP XDMA PL PCIe Root Port:
Hardware setup
Tested End Points
End Point Driver Configuration
Device Tree binding
Test Procedure
Kernel Console Output
Driver Initialization for Versal
NVMe card probing
Testing of NVMe Access
Interrupts
QDMA IP
Versal QDMA PL PCIe4 Root Port:
Related Links
Versal Adaptive SoC CCIX-PCIe Module (CPM) Root port Linux driver
Linux SPI Driver
Overview
HW/IP Features
Missing features, Known Issues and Limitations
Kernel Configuration
Devicetree Settings
Adding An SPI EEPROM to the Device Tree
Adding a flash to the Device tree
Test Procedure
SysFs Interface
Using An Aardvark I2C/SPI Activity Board For SPI EEPROM Testing
Expected Log
Change Log
2016.3
2016.4
2017.1
2017.2
2017.3
2017.4
2018.1
2018.2
2018.3
2019.1
2019.2
2020.1
2020.2
2021.1
2021.2
2022.1
2022.2
2023.1
Related Links
Linux SystemACE Driver
Linux TFT Driver
Linux Trafficgen Driver
Linux USB Gadget Driver
USB
Linux USB DWC3 Host/Peripheral Driver
WARNING
Devicetree
Testing Device mode
ZCU102 Board Setup
Testing Host mode
ZCU102 Board Setup
Interoperability Testing:
USB 2.0
USB 3.0
Linux User Mode Pseudo Driver
Linux ZynqMP GQSPI Driver
Introduction
HW/IP Features
Driver Features
Missing Features and known Issues/Limitations in Driver
Important AR links
Kernel Configuration Options
Device-tree
Testing Procedure
QSPI flash testing with flashcp
QSPI flash testing with jffs2
Expected Ouput
Performance Details
Single
Dual
Mainline Status
Change Log
2016.3
2016.4
2017.1
2017.2
2017.3
2017.4
2018.1
2018.2
2018.3
2019.1
2019.2
2020.1
2020.2
2021.1
2021.2
2022.1
2022.2
2023.1
Mainline status
Related Links
Linux LTTEmac Flat
Zynqmp and Versal DMA
Introduction
HW IP features
Features supported in driver
Missing Features and known Issues/Limitations in Driver
Kernel Configuration
Devicetree
Test Procedure
Mainline status
Change Log
Related Links
ZynqMP firmware driver
Zynq Ultrascale+ MPSoC/Versal firmware driver
Firmware interface driver for Zynq Ultrascale+ MPSoC/Versal
Introduction
HW IP features
Features supported in driver
Missing Features, Known Issues and Limitations
Devicetree
Test procedure
Mainline status
Change Log
Related Links
ZynqMP Linux Reset-controller Driver
Introduction
HW IP Features.
Missing Features, Known Issues and Limitations
Kernel Configuration
Devicetree
Test procedure
Expected Output
Mainline Status
Change Log
Related Links
ZynqMP Linux Pin Controller Driver
Introduction
HW IP features
Features supported in driver
Missing Features, Known Issues and Limitations
Example Use Case
Kernel Configuration
Devicetree (for 2018.1 release)
Devicetree (for 2017.4 and earlier releases)
Test procedure
Expected Output
Mainline Status
Change Log
Related Links
ZynqMP OCM EDAC Driver
Overview
HW/IP Features
Driver Features
Missing features, Known Issues and Limitations
Kernel Configuration
Devicetree Settings
Mainline Status
Testing Procedure
To inject CE Errors
To inject UE Errors
Expected Output
Changelog
2016.3
2016.4
2017.1
2017.2
2017.3
2017.4
2018.1
2018.2
2018.3
2019.1
2019.2
2020.1
2020.2
2021.1
2021.2
2022.1
2022.2
2023.1
Related Links
Zynqmp QSPI Driver
Xilinx QSPI Driver Kernel Configuration:
GQSPI Controller Features:
Linux Driver Features :
Testing :
Changelog
Zynqmp RTC
Zynqmp_RTC_1
Introduction
HW/IP FEATURES:
Missing features, Known Issues, limitations
Overview of Linux RTC Framework
Kernel Configuration:
Testing Procedure
Mainline status
ChangeLog
2023.1
2022.2
2022.1
2021.2
2021.1
2020.2
2020.1
2019.2
2019.1
2018.3
2018.2
2018.1
2017.4
2017.3
2017.2
2017.1
2016.3
Related Links
ZynqMP NAND
Introduction
HW IP Features
Controller Features
Driver Features
Missing features, Known Issues, limitations
Important AR links
Bad Block management
Kernel Configuration Options
Device Tree Settings
Nand Partition details
Performance
Prerequisites
Kernel tools
user space tools
Driver Probe
How to Run
Expected Output
Block Erase test
How to Run
Expected Output
Write Page test
How to Run
Expected Output
Read Page and Data integrity test
How to Run
Expected Output
Data integrity test using nandtest utility
How to Run
Expected Output
MTD oob test
How to Run
Expected Output with Software-ECC
Expected Output with Hardware-ECC
MTD speed test
How to Run
Expected Output with Software-ECC
Expected Output with Hardware-ECC
MTD stress test
How to Run
Expected Output
MTD page read test
How to Run
Expected Output
Change Log
2016.3
2016.4
2017.1
2017.2
2017.3
2017.4
2018.1
2018.2
2018.3
2019.1
2019.2
2020.1
2020.2
2021.1
2021.2
2022.1
2022.2
2023.1
Mainline status
Related Links
ZynqMP DisplayPort Linux driver
HW IP features
Missing Features, Known Issues and Limitations
Missing Features
Limitation
Important AR links
Note
Kernel Configuration
Devicetree
Implementation
Power Management
Applications
DRM
Live Input
ALSA
Xorg
Disable Xorg Timeouts
Related Links
Solution Versal PL Programming
Introduction‍
HW IP Features
Features supported in the driver
Unsupported features in the driver
Missing Features, Known Issues and Limitations in the driver
Kernel Configuration
Devicetree
DFX flow - Required DT overlays syntax
Typical DFX topology
Required DT syntax for dfx-static - Full Image
dfx-static image configuration
dfx-static image has already been configured prior to OS boot up.
Required DT syntax for dfx-PR0 - Partial
dfx-rm0 image configuration
dfx-rm1 image configuration
FPGA Programming
Steps for programming the Bitstream/PDI using sysfs
Steps for programming the Bistream/PDI using overlay
Steps to remove the drivers got added as part of DTO
Steps for programming the Bitstream/PDI using Debug fs
Steps for programming the Bitstream/PDI using fpgautil
Exercising FPGA programming using Libdfx
Mainline Status
Release history
References
Solution ZynqMP PL Programming
Introduction‍
HW IP Features
Features supported in the driver
Known Issues for PL Programing
Summary Table for Partial Reconfiguration / Dynamic Function Exchange Feature Support
Kernel Configuration
Devicetree
Bitstream Format
Building Software Images
PetaLinux Flow
Yocto Flow
OSL Flow
FPGA programming
Exercising FPGA programming using fpgautil
Exercising FPGA programming using fpga framework attributes
FPGA programming using sysfs attributes
FPGA Readback using debugfs attributes
FPGA programming using Device Tree Overlay (DTO)
Working with Device Tree Overlay (DTBO)
Exercising FPGA programming using Libdfx
Mainline Status
Release history
See also
References
Solution Zynq PL Programming With FPGA Manager
Introduction ‍
HW IP Features
Features supported in the Driver
Missing Features, Known Issues and Limitations
Kernel Configuration
Device-tree
FPGA programming using Device Tree Overlay (DTO)
Tools Required
Images Required for testing
Test Procedure
Using Device Tree Overlay:
Expected Output Using DTBO
Using sysfs interface
Expected Output Using Sysfs
Change Log
Related Links
Solution ZynqMP SoC revision read mechanism
HW IP Features
Features supported in driver
Missing Features, Known Issues and Limitations
Kernel Configuration
Test procedure
Using dd command
Using linux application
Mainline Status
Change Log
Related Links
XADC
Introduction
HW/IP features
Analog-to-Digital Converters
PS-XADC Interface
PL-JTAG Interface
Missing features, Known Issues, limitations
Kernel configurations
Device Tree Settings
Test Procedure
Expected Output
Change Log
2016.3
2016.4
2017.1
2017.2
2017.3
2017.4
2018.1
2018.2
2018.3
2019.1
2019.2
2020.1
Mainline status
Related Links
PS UART
PS_UART_1
Introduction
HW IP Features
Features supported in driver
Missing Features, Known Issues and Limitations
Kernel Configuration
Test procedure
Expected Output
Mainline status
Change Log
Related Links
ZynqMP AES Driver
Introduction
HW IP Features
Features supported in driver
Kernel Configuration
Devicetree
AF ALG AES Encrypt example
AF ALG AES Decrypt example
Expected Output
Mainline status
Change Log
Related Links
Xilinx ALSA Audio Formatter driver
Table of contents
Introduction
IP/Driver Features
Known Issues & Limitations
Kernel Configuration options for Driver
Device Tree Binding
Test Procedure
Boards Supported
Mainline Status
Change log
2020.1
2019.2
2019.1
2018.3:
Related Links
Multi-Scaler Linux Driver
Introduction
HW IP features
Missing Features / Known Issues / Limitations in Driver
Kernel Configuration
Device Tree Binding
Test Procedure
Debugging
Use Cases
Stride and Height Alignment
Notes
Change Log
2023.1
2022.2
2022.1
2021.2
2021.1
2020.2
2020.1
2019.2
2019.1
2018.3
Related Links
Xilinx ALSA SDI Audio driver
Table of contents
Introduction
IP/Driver Features
Known Issues & Limitations
Kernel Configurations
Device Tree Bindings
Test Procedure
Procedure to test SDI audio with ALSA Utilities
Procedure to test SDI audio with Gstreamer Utilities
Boards Supported
Change log
2021.1
2020.1
2019.2
2019.1
2018.3:
Related Links
Xilinx ALSA SPDIF driver
Table of contents
Introduction
HW IP Features
Known Issues & Limitations
Kernel Configurations
Device Tree Binding
Test Procedure
Procedure to test SPDIF audio with ALSA Utilities
Procedure to test SPDIF audio with Gstreamer Utilities
Boards Supported
Mainline Status
Change Log
2020.1
2019.2
2019.1
Related Links
Xilinx ALSA Audio I2S driver
Introduction
IP/Driver Features
Known Issues & Limitations in Driver
Kernel Configuration
Device Tree Binding
Test procedure
Procedure to test I2S with ALSA utilities
Procedure to test I2S with Gstreamer utilities
Procedure to test I2S Pass-Through
Boards Supported
Mainline Status
Change log
2020.2
2020.1
2019.2
2019.1
2018.3
Related Links
Zynq Ultrascale+ MPSoC Secure Driver for Linux
Introduction
HW IP Features
Features supported in driver
Kernel Configuration
Test Procedure
Expected Output:
Mainline status
Change Log
Related Links
Cadence WDT Driver
Introduction
HW IP Features
Known Issues and Limitations
Kernel Configuration
Device tree and Build Configurations
Zynq7000
Zynq UltraScale+ MPSoC/RFSoC
Test Procedure
Mainline Status
Change Log
Related Links
CAN4Linux
can4linux Overview
README (can4linux 4.2)
Restrictions (Features)
Compiling:
Related Links
Cadence I2C Driver
Introduction
HW IP Features
Known issues and limitations
Important AR links
Kernel Configuration
Devicetree
Test procedure
Expected Output
Mainline Status
ChangeLog
Qspi
Introduction
HW IP Features
Driver Features
Known issues and limitations
Xilinx GQSPI Driver Kernel Configuration
Devicetree
Testing Procedure
QSPI flash testing with flashcp
QSPI flash testing with jffs2
Logs:
Changelog
Related Links
RFdc Linux driver
Introduction
RF-ADC Features
RF-DAC Features
Test Cases
Changelog
2018.3
2018.2
2018.1
2017.4
Related Links
SDFEC Driver
SD-FEC Driver for Zynq Ultrascale+ TM RFSoC
Introduction
HW IP Features
Features supported in driver
Missing Features, Known Issues and Limitations
Kernel Configuration
Device Tree Settings
Driver Examples
LDPC DOCSIS 3.1 Demo Example
Change Log
2019.1
2018.3
2018.2
2018.1
Related Links
RSA Driver
Introduction
HW IP Features
Features supported in driver
Kernel Configuration
Devicetree
Test Procedure
Expected Output
Mainline status
Change Log
Related Links
SD controller
Introduction
Zynq
Zynqmp/Versal
HW/IP features
Zynq
ZynqMP/Versal
Features supported by driver
Zynq
ZynqMP
Versal
Missing features, known Issues, limitations
Kernel configurations
Devicetree
Performance
Test Procedure
Expected output
Mainline Status
Change Log
Related Links
SPI Zynq driver
Introduction
HW IP Features
Missing Features and known Issues/Limitations in Driver
Kernel Configuration Options
Device-tree
Using SPI with EEPROM
Adding an SPI EEPROM to the devicetree
Using SPI with flash
Adding an SPI flash to the devicetree
Zynq:
ZynqMP:
Test Procedure
Testing using sysfs
Testing using flashcp
Testing using jffs2
Expected Output
Change Log
2016.3
2016.4
2017.1
2017.2
2017.3
2017.4
2018.1
2018.2
2018.3
2019.1
2019.2
2020.1
2020.2
2021.1
2021.2
2022.1
2022.2
2023.1
Related Links
Uartlite Driver
Introduction
HW IP Features
Features supported in driver
Missing Features, Known Issues and Limitations
Kernel Configuration
Devicetree
Vivado Block Design
Test procedure
Expected Output
Mainline Status
Change Log
Related Links
Video Framebuffer Write
Introduction
Interfacing with the Video Framebuffer Driver from DMA Clients
DMA Interleaved Template Requirements
Buffer Alignment
Driver Operation
Buffer Alignment
IP/Driver Features
Missing Features / Known Issues / Limitations in Driver
Kernel Configuration
Device Tree Binding
Testing Procedure
Boards Supported
Known Issues
Change Log
2021.2
2021.1
2020.2
2020.1
2019.2
2019.1
2018.3
2018.2
2018.1
2017.4
2017.3
Related Links
Video Framebuffer Read
Introduction
Interfacing with the Video Framebuffer Driver from DMA Clients
DMA Interleaved Template Requirements
Buffer Alignment
Driver Operation
Buffer Alignment
IP/Driver Features
Missing Features / Known Issues / Limitations in Driver
Kernel Configuration
Device Tree Binding
Testing Procedure
Boards Supported
Known Issues
Change Log
2021.2
2021.1
2020.2
2020.1
2019.2
2019.1
2018.3
2018.2
2018.1
2017.4
2017.3
Related Links
Mem 2 Mem Composite Video Framework
Mem 2 Mem without any Sub-device device
Mem 2 Mem VPSS-CSC & VPSS-SC device
Mem 2 Mem VPSS-SC Composite device
Mem 2 Mem VPSS-CSC Composite device
Linux Versal Sysmon Driver
Introduction:
Basic HW Architecture:
SW Architecture:
Change log
2020.2
Related Links
Xilinx DRM KMS driver
Overview
Linux Kernel defconfig
Device tree binding
Supporting IPs
Supporting features
DRM KMS Driver Sub-Pages
Work to be done
Changelog
Xilinx DRM KMS DisplayPort 1.4 TX Subsystem Driver
Introduction
DP Tx interface with Video PHY Controller for Zynq UltraScale+ MPSoC:
DP Tx interface with GT Quad base Controller for Versal:
Driver Overview
Driver Features
Missing Features / Known Issues / Limitations in Driver
Device Tree Binding
Reference design for Zynq UltraScale+ MPSoC
Reference design for Versal :
Test Procedure
Test procedure for video display:
Test procedure for Audio:
Boards Supported
Change Log
2022.1
2021.2
2021.1
Related Links
Xilinx DRM KMS HDMI-Tx Driver
Introduction
Driver Overview
IP/Driver Features
Note:
Missing Features / Known issues / Limitations in Driver
Kernel Configuration Options for Driver
Device Tree Binding
Device Control
HDCP Support
Test procedure
DEBUG Capability
Boards Supported
Change Log
2022.1
2021.2
2021.1
2020.2
2020.1
2019.2
2019.1
2018.3
2018.1
Related Links
Xilinx DRM KMS MIPI DSI2-Tx Driver
Introduction
IP / Driver Features
Other supported features
Unsupported Features
Kernel Configuration
Device tree binding
Test Procedure
Xorg (X11) and Mali GPU
Steps to manually launch Xorg
Disable Xorg Timeouts:
Power & Clock Management
Boards Supported
Known Issues
Change log
2022.1
2021.2
2021.1
2020.2
2020.1
2019.2
2019.1
2018.3
2018.2
2018.1
2017.4
2017.3
2017.2
2017.1
Related Links
Xilinx DRM KMS related bootargs
Overview
ZynqMP DisplayPort driver arguments
Xilinx DRM KMS boot arguments
Other kernel boot arguments
Related Links
Xilinx DRM KMS SDI-Tx Driver
Introduction
Driver Overview
IP/Driver Features
Kernel Configuration Options for Driver
Device Tree Binding
Test Procedure
Debug capability
Boards Supported
Known Issues
Changelog
2022.1
2021.2
2021.1
2020.2
2020.1
2019.1
2018.3
2018.2
2018.1
2017.4
2017.3
Related Links
Xilinx DRM VPSS Scaler driver with CSC
Driver Overview
IP/Driver Features
Missing Features / Known Issues / Limitations in Driver
Video Processing Subsystem Release Notes and Known Issues
Kernel Configuration options for Driver
Device Tree Binding
Test Procedure
Known Issues
Change log
2021.2
2021.1
2020.2
2020.1
2019.2
2019.1
2018.3
2018.2
2018.1
Related Links
Xilinx V4L2 driver
Overview
Linux Kernel defconfig
Device tree binding
Example Designs
V4L2 Driver Sub-Pages
Related Links
Xilinx V4L2 DisplayPort 1.4 RX Subsystem Driver
Introduction
DP Rx interface with Video PHY Controller for Zynq UltraScale+ MPSoC
DP Rx interface with GT Quad base Controller for Versal
Driver Overview
MCDP6000 Retimer driver callback implementation:
Driver Features
Missing Features / Known Issues / Limitations in Driver
Device Tree Binding
Building Driver Modules in OSL flow
Reference Design for Zynq UltraScale+ MPSoC:
Reference Design for Versal
Test Procedure
Test procedure for video capture and play
Test procedure for Audio
Debug Capabilities
Boards Supported
Change Log
Related Links
V4L-Utils & Libdrm Build Instructions
1 Introduction
2 Prerequisites
3 Cross-compile v4l-utils
3.1 Download the v4l-utils source archive
3.2 Configure the target build
3.3 Build and install
4 Cross-compile LibDRM
4.1 Clone the LibDRM repository
4.2 Configure the target build
4.3 Build and Install
Xilinx V4L2 CFA driver
Overview
Linux Kernel defconfig
Device tree binding
Supporting features
Xilinx V4L2 CRESAMPLE driver
Overview
Linux Kernel defconfig
Device tree binding
Supporting features
Work to be done
Xilinx V4L2 Demosaic driver
Introduction
IP / Driver Features
Kernel Configuration
Device tree binding
Testing Procedure
Successful Creation of a Media Device
Successful Frame Captures
Boards Supported
Known Issues
Changelog
2020.2
2020.1
2019.2
2019.1
2018.3
2018.2
2018.1
2017.4
2017.3
Related Links
Xilinx V4L2 Gamma Correction LUT driver
Introduction
IP/Driver Features
Kernel Configuration
Device Tree Binding
Testing Procedure
Successful Creation of a Media Device
Successful Frame Captures
Boards Supported
Known Issues
Changelog
2020.2
2020.1
2019.2
2019.1
2018.3
2018.2
2018.1
2017.4
2017.3
Related Links
Xilinx V4L2 MIPI CSI driver
Introduction
IP/Driver Features
Update for 2021.1
Missing Features / Known Issues / Limitations in Driver
MIPI CSI-2 Rx Subsystem IP Release Notes and Known Issues
Kernel Configuration
Device Tree Binding
Test Procedure
Boards Supported
Known Issues
Change log
2021.2
2021.1
2020.2
2020.1
2019.2
2019.1
2018.3
2018.2
2018.1
2017.4
2017.3
2017.2
2017.1
2016.4
2016.3
Related Links
Xilinx V4L2 REMAPPER driver
Overview
Linux Kernel defconfig
Device tree binding
Supporting features
Changes
2020.2
Xilinx V4L2 RGB2YUV driver
Overview
Linux Kernel defconfig
Device tree binding
Supporting features
Work to be done
Changes
2020.2
Xilinx V4L2 Scaler driver
Overview
Linux Kernel defconfig
Device tree binding
Supporting features
Work to be done
Changes
2020.2
Xilinx V4L2 SDI Rx driver
Introduction
IP/Driver Features
Missing Features / Known Issues / Limitations in Driver
Kernel Configuration
Device Tree Binding
Test Procedure
Debug capability
FAQ
Tested Platforms
Known Issues and Limitations
Change log
2021.2
2021.1
2020.2
2020.1
2019.2
2019.1
2018.3
2018.2
2018.1
2017.4
2017.3
Related Links
Xilinx V4L2 Switch driver
Overview
Linux Kernel defconfig
Device tree binding
Supporting features
Changes
2020.2
Related Links
Xilinx V4L2 TPG driver
Introduction
IP/Driver Features
Missing Features / Know limitations / Issues in Driver
Kernel Configuration
Device Tree Binding
Test Procedure
Known Issues
Change log
2021.2
2021.1
2020.2
2020.1
2019.2
2019.1
2018.3
2018.2
2018.1
2017.4
2017.3
2017.2
2017.1
2016.4
2016.3
2016.2
2016.1
2015.4
2015.3
2015.2
2015.1
2014.4
2014.3
2014.2
2014.1
2013.4
Related Links
Xilinx V4L2 VPSS CSC driver
Introduction
IP/Driver Features
Missing Features / Known Issues / Limitations in Driver
Video Processing Subsystem Release Notes and Known Issues
Kernel Configuration
Device tree binding
Testing Procedure
Successful Creation of a Media Device
Successful Frame Captures
Boards Supported
Known Issues
Change log
2021.2
2021.1
2020.2
2020.1
2019.2
2019.1
2018.3
2018.2
2018.1
2017.4
2017.3
Related Links
Xilinx V4L2 VPSS Scaler driver
Introduction
IP/Driver Features
Missing Features / Known Issues / Limitations in Driver
Video Processing Subsystem Release Notes and Known Issues
Kernel Configuration
Device Tree Binding
Testing Procedure
Successful Creation of a Media Device
Successful Frame Captures
Frame Scaling or Resizing:
Boards Supported
Known Issues
Change log
2021.2
2021.1
2020.2
2020.1
2019.2
2019.1
2018.3
2018.2
2018.1
2017.4
2017.3
Related Links
Xilinx V4L2 hdmirx driver
Introduction
Driver Overview
IP/Driver Features
Kernel Configuration Options for Driver
Device Tree Binding
Device Control
HDCP Support
Test procedure
Custom EDID Support
DEBUG Capability
Boards Supported
Change Log
2021.2
2021.1
2020.2
2020.1
2019.2
2019.1
2018.3
2018.1
Related Links
Xilinx Arm Mali-400 Driver
Overview
Driver access and license
Device tree binding
Runtime power management
Selecting particular backends:
Wayland/GBM backend:
X11 backend:
Fbdev backend:
Headless-EGL backend:
QT wayland/KMS/GBM plugin:
Update-alternatives:
Related Links
Xilinx Phy VideoPhy Driver
Introduction
Driver Overview
IP/Driver Features
HW IP Configuration
Kernel Configuration Options for Driver
Device Tree Binding
DEBUG Capability
How to capture vphy state machine logs
How to capture register dump
Boards Supported
Change Log
2021.2
2021.1
2020.2
2020.1
2019.2
2019.1
2018.3
2018.1
Related Links
Xilinx HDMI 2.1 PHY driver
Introduction
Driver Overview
IP/Driver Features
HW IP Configuration
Kernel Configuration Options for Driver
Device Tree Binding
DEBUG Capability
How to capture register dump
Boards Supported
Change Log
Related Links
Zynq EDAC Driver
Overview
HW/IP Features
Missing features, Known Issues and Limitations
Kernel Configurations
Device tree Node Settings
Test Procedure
For Zynq
For ZynqMP
Expected Output
For Zynq
For ZynqMP
Change log
2016.3
2016.4
2017.1
2017.2
2017.3
2017.4
2022.1
Mainline status
Related Links
Zynq Emacps Linux Driver
NOTE: This driver is now deprecated. Please refer to macb driver.
Introduction
Device tree node details
Features supported
Known Issues and Limitations
IEEE1588 time stamping:
Single MAC managing two PHYs:
No interrupt support for PHY events in driver
Testing Tools
Diagnostic and Protocol Tests
Build Instructions PTPd
Build Instructions for TestPtp utility
Stress Test
Build Instructions PTPd
Build Instructions for TestPtp utility
Performance Tests
Build Instructions PTPd
Build Instructions for TestPtp utility
IEEE1588
Build Instructions PTPd
Build Instructions for TestPtp utility
Work tobe done
Zynq Pl353 SMC and NAND drivers
Introduction
HW/IP Features
Controller Features
Driver Features
Missing Features, Known issues, limitations
Bad Block management
Kernel Configuration options
SMC Driver
NAND Driver
NOR Driver
Zynq_Pl353_SMC_and_NAND_drivers_6
Device Tree
Performance
Test Procedure
JFFS2 filesystem
UBIFS file system
Flashcp
mtd_speedtest
How to run
Expected Output
Change Log
2016.3
2016.4
2017.1
2017.2
2017.3
2017.4
2018.1
2018.2
2018.3
2019.1
2019.2
2020.1
2020.2
2021.1
2021.2
2022.1
2022.2
2023.1
Mainline Status
References
Zynq QSPI Driver
Introduction
HW/IP Features
Features Supported in Driver
Missing Features and known Issues/Limitations in Driver
Kernel Configuration Options
Device-tree
Test Procedure
QSPI flash testing with flashcp
QSPI flash testing with jffs2
Expected Output
Performance Details
Single
Dual
Mainline Status
Change Log
2016.3
2016.4
2017.1
2017.2
2017.3
2017.4
2018.1
2018.2
2018.3
2019.1
2019.2
2020.1
2020.2
2021.1
2021.2
2022.1
2022.2
2023.1
Mainline status
Related Links
Zynq SDIO WiFi
Introduction
HW/IP features
Features Supported by Driver
Missing features, Known Issues, Limitations
Kernel Configuration
Devicetree
Test Procedure
Expected Output
Mainline Status
Change Log
Related Links
Zynq Ultrascale MPSOC Linux SIOU driver
Introduction
Kernel Configuration
Support till 2020.2 release :
Support form 2021.1 release :
Devicetree
Support till 2020.2 release :
Support form 2021.1 release :
Test Procedure
Expected O/P
Mainline Status
Change log
Related Links
Zynq Ultrascale MPSOC Linux USB device driver
Introduction
HW/IP Features
Features supported in driver
Missing Features, Known Issues and Limitations
Important AR links
Host Mode
Kernel Configuration
Devicetree
Test Procedure
Expected Output
Performance
Peripheral Mode
Mass Storage
Kernel Configuration
Devicetree
Performance
Testing Procedure
Ethernet Gadget
Kernel Configuration
Devicetree
Performance
Testing Procedure
USB Attached SCSI Protocol(UASP)
Kernel Configuration
Devicetree
Performance
Test procedure
OTG Mode
Kernel Configuration
Test Procedure
Mainline Status
Phy Settings
Change log
Video Scene Change Detection(SCD)
Overview
IP/Driver Features
Missing features / Known issues / Limitations in driver
Kernel Configuration
Device Tree Binding
Testing Procedure
Successful Creation of a Media Device
Successful Frame Captures
Streaming based SCD
Memory based SCD
Boards Supported
Known Issues
Change log
2019.2
2019.1
2018.3
Related Links
Zynq Linux USB Device Driver
Introduction
HW/IP Features
Features supported by driver
Missing features, Known Issues, limitations
Important AR links
Host Mode
Kernel Configuration
Devicetree
Performance
Test Procedure
Peripheral Mode
Kernel Configuration
Devicetree
Performance
Test Procedure
OTG Mode
Kernel Configuration
Devicetree
Test Procedure
Mainline Status
Change Log
Related Links
CCF SI5324 Driver
Introduction
Driver Overview
Known Issues and Limitations
Kernel Configuration Options for Driver
Device Tree Binding
Boards Supported
Change Logs
Related Links
Common Clock Framework for Zynq Ultrascale+ MPSOC
HW IP features
Features Supported in the Driver
Missing features, Known Issues, limitations
Important AR links
Kernel Configuration
Test Procedure
Change log
Related Links
Cortexa53 EDAC Driver
Kernel Configuration Options for Driver
Devicetree
Eror injection on L1 Cache:
Error injection on L2 Cache:
Changelog:
Related Links
CPU frequency scaling
Introduction
HW IP features
Features supported in driver
Frequencies supported in Zynq Ultrascale+ MPSoC
Missing Features, Known Issues and Limitations
Kernel Configuration
Test Procedure
Mainline status
Change Log
CPU Idle
Introduction
HW IP features
Features supported in driver
Missing Features, Known Issues and Limitations
Kernel Configuration
Devicetree
Change Log
Related Links
Macb Driver
HW IP features
Features supported in driver
Missing Features, Known Issues and Limitations
Important AR links
Kernel Configuration
Devicetree
Related devicetree information
Ethernet DT
PHY DT
Xilinx converter and PHY DT
RGMII Tuning in DT
TSU clock in DT
Fixed link DT
Common MDIO DT
PS SGMII DTs (ZynqMP only)
Pointers on PHY reset via GPIO
Performance
Zynq
ZynqMP
Test Procedure
Diagnostic and Protocol Tests
PING
WebServer
Telnet
FTP & TFTP
Pkt Generator
Performance Tests
Netperf
Iperf
Stress Test
Iperf with option -d
Ping flood test
PTP
Mainline status
PHY details
Change Log
Related Links
USB Host Controller Driver
Xilinx ALSA HDMI Audio driver
Table of contents
Introduction
HW IP Features
Know Issues & Limitations in Driver
Kernel Configurations
Device tree binding
Test Procedure
Procedure to test HDMI with ALSA utilities
Procedure to test HDMI with Gstreamer utilities
Boards Supported
Change log
2020.1
2019.2
2019.1
2018.3:
Related Links
AXI GPIO
Introduction
HW IP Features
Features supported in driver
Missing Features, Known Issues and Limitations
Kernel Configuration Options for Driver
Devicetree
Test procedure on ZCU102 eval board
Expected Output
Addition of Dip Switches and Push Buttons to the node to generate interrupts on ZCU102 eval boards
Kernel Configuration for dip switches and push buttons
Expected Output
Push buttons to the device tree
Expected Output
Mainline Status
Change Log
Related Links
Video_Mixer
Overview
Supported IP Features
Limitations
Kernel Configuration
Device Tree Configuration
DRM Implementation Overview
CSC coefficients programming
Test Procedure
modetest
Test 1 - Ensure DRM driver has been properly loaded and is configured
Test 3 - Scale the layer (if enabled for the layer)
Test 4 - Change layer alpha (if enabled for the layer)
Test 5 - Change the background color
Vbltest
Test 7- Vbltest - Testing vertical blanking interrupts
Known Issues
Change log
2023.1
2022.2
2022.1
2021.2
2021.1
2020.2
2020.1
2019.2
2019.1
2018.3
2018.2
2018.1
Related Links
jesd204b
Introduction
HW IP Features
Known Issues and Limitations
Kernel Configuration Options for Driver
Devicetree
Test procedure on Microblaze
Expected Output
Mainline Status
Change Log
Related Links
OSPI Linux driver (Temp)
OSPI Linux driver
Introduction
Features Supported in HW
Features supported in driver
Driver Missing features, Known Issues and Limitations
Supported Flash parts
Testing
Kernel Configuration
Device-tree
Performance Details
Mainline Status
Change Log
2023.1
2022.2
2022.1
2021.2
2021.1
2020.2
2020.1
2019.2
Misc DP159 Driver
Introduction
Driver Overview
Known Issues and Limitations
Kernel Configuration Options for Driver
Device Tree Binding
Boards Supported
Changes
2020.2
Related Links
Linux Soft DMA Driver
Introduction
HW IP features
AXI DMA
Features supported in the driver
AXI CDMA
Features supported in the driver
AXI VDMA
Features supported in the driver
AXI MCMDA
Features supported in the driver
Missing Features and Known Issues/Limitations in Driver
AXI DMA
AXI CDMA
AXI VDMA
Kernel Configuration
Devicetree
AXI DMA and MCDMA
AXI CDMA
AXI VDMA
Mainline Status
Change Log
Linux SHA Driver
Introduction
HW IP Features
Features supported in driver
PLM Configuration
Test Procedure
Expected Output
Mainline status
Change Log
Related Links
Xilinx GMII2RGMII converter
Introduction
HW IP features
Features supported in driver
Missing Features, Known Issues and Limitations
Kernel Configuration
Devicetree
Test Procedure
Mainline status
Related Links
Linux Versal EDAC Driver
Overview
Supporting Features
Missing features, Known Issues and Limitations
Kernel Configurations
Device tree Node
Requirements
Mainline Status
Test Procedure
Change log
2020.2
2021.1
2021.2
2022.1
2022.2
2023.1
Related Links
versal sbsa Uart driver
versal uart Driver
Introduction
HW IP Features
Features supported in driver
Missing Features, Known Issues and Limitations
Kernel Configuration
Devicetree
Mainline Status
Change Log
Related Links
Linux FlexNoc PM Driver
Introduction:
Basic HW Architecture:
Note:
SW Architecture:
Change log
2020.2
Mainline status
Related Links
Zynq Linux Pin Controller Driver
Introduction
HW IP features
Features supported in driver
Missing Features, Known Issues and Limitations
Kernel Configuration
Devicetree
Test procedure
Expected Output
Mainline Status
Change Log
Related Links
SATA
Introduction
HW IP Features
Missing Features, Known Issues and Limitations
Kernel Configuration
These below settings are to be set for enabling SATA support in Linux
Devicetree
Support till 2020.2 release:
Support form 2021.1 release:
Performance
Test Procedure
Expected O/P
Mainline status
Phy Settings
Change Log
Related Links
libdfx - Linux User Space Solution for FPGA Programming
Introduction
Source Code
API Details
Pre-fetch
fpga-load
Deferred-drivers-load
Remove
Destroy package
To Get PDI image Active UID info list
To Get PDI Image Meta-header info
Example Application flow
Build procedure
Build procedure for compiling library from source
Build User Application and link with library source
Reference DTBO file format
Devicetree Overlay file contents example: For Only PDI/BIN/BIT configuration
PL drivers probing ( For Deferred Probe)
Devicetree Overlay file contents example: For PDI configuration + PL drivers probing
Create Device Tree Overlay Blob ( .dtbo ) file from .dts file
Limitations
Known issues
References
Intc
Introduction
HW/IP Features
Features supported in driver
Devicetree
Mainline status
Boot log snippets
Changelog
2022.2
2022.1
2021.2
2021.1
Related Links
Xilinx Secure Configuration Linux Driver
Features supported in driver
Missing Features, Known Issues and Limitations
Kernel configuration
PLM Configuration
Device tree
Example
Expected Output
Mainline status
Changelog
Related Links

Back to home page