This page covers the generation of devicetree source (DTS) files using Xilinx tools as well as the building/compiling of these source files using standard open-source tools. In particular, use of the Xilinx Devicetree Generator (DTG) will be covered for generating DTS files from a Xilinx hardware project while the devicetree compiler (DTC) will be covered for compiling DTS files into a devicetree binary (DTB). Although the primary use of the DTB is to provide it to the Linux kernel so that Linux can be initialized to specific hardware correctly, the DTB can also be used with QEMU to emulate hardware for both Linux and standalone systems.
Table of Contents
...
- zynqmp-clk-ccf.dtsi has static clock node configuration, if user wants to change any of the clock information update those in system-user.dtsi.
- Multi concat Interrupt blocks wont be supported by the DTG.
- DTG doesn't support IP that are packaged in a subsystem(multiple BD's)
- Interrupt port width more than one wont be supported.
- When multicore is enabled for the MAC IPs(if the MAC IPs are more than 1) then there is issue with the label in DTG and it fails. But there wont be an issue if the MAC IP is one and multicore is enabled.
- DTG wont support for generation of private peripheral interrupts(PPI).
- DTG supports the video pipeline generation based on the internal TRD designs as mentioned in the wiki https://xilinx-wiki.atlassian.net/wiki/spaces/A/pages/25329832/Zynq+UltraScale+MPSoC+VCU+TRD+2018.3
- DTG doesn't support custom IP, For Multimedia use case If there are any custom IPs connected between the video pipeline IPs DTG wont support those, user may need to add the input and output ports.
- For broadcaster IP the output can connect to multiple output ports and DTG cant know which output port is a valid for the correct pipeline.
- If there are multiple similar video pipelines in the design user need to add the input and output port information in the nodes. The below wiki gives some info about how to add the input and output ports.
- DTG doesn't support non memory-mapped IP's.
- DTG limitation for multimedia IPs
New Features for
...
2022.1:
- Added mrmac IP initial support.
- Added DPU IP support
- Replaced the hardcoded values with the macros for reset and power.
- Added dma channels for axi_mcdma IP support in DTG.
- Generate the memory node for each axi_noc IP for Versal
List of drivers supported in the DTG and their bindings in Linux tree
- can, canfd
...
- Added dfx support in DTG
- generating the aie clock node for versal designs if they have aie ip.
- For aie node you can find the detailed doc in below
- https://github.com/Xilinx/linux-xlnx/blob/master/Documentation/devicetree/bindings/
...
...
List of drivers supported in the DTG and their bindings in Linux tree
- can, canfd
- axi_cdma
- axi_dma
- axi_emc
- axi_ethernet, axi_10g_ethernet,xxv_ethernet
- axi_gpio
- axi_iic
- axi_pcie,axi_pcie3,xdma
- axi_perf_mon
- axi_quad_spi
- axi_sysace
- axi_tft
- axi_timebase_wdt
- axi_traffic_gen
- axi_usb2_device
- vcu
- axi_vdma
- xadc_wiz
- axi_intc
- ddr4,ddr3,mig_7series
- pr_decoupler
- usp_rf_data_converter
- axi_timer
- tsn_endpoint_ethernet_mac
- axi_uartlite
- axi_uart16550
...
Code Block | ||
---|---|---|
| ||
cd linux-xlnx/scripts/dtc make ARCH=arm <devicetree name>.dtb dtx_diff system1.dtb system2.dtb |
Advanced DTG Topics
How to
...
generate dfx supported dtsi files (only for versal)
This section explains how to generate the dtsi files that supports dfx flow.
1.clone the device-tree
https://github.com/Xilinx/device-tree-xlnx.git -b xlnx_rel_v2022.1
2.launch xsct
i.xsct % setws <workspace dir name>
ii.xsct % repo -set <above cloned device-tree-xlnx path>
iii.xsct % platform create -name dev -hw <static xsa path> -rm-hw <rp-rm xsa path> -proc <proc> -os device_tree
iv.xsct % bsp config dt_overlay true
v.xsct % platform generate
you will find static and partial dtsi files in the <workspace dir>/dev/psv_cortexa72_0/device_tree_domain/bsp/
convert them into dtbo files using the compiling steps.
How to enable DT OVERLAY from DTG
This section only focuses on DTG aspects of devicetree overlays. For more comprehensive information on using overlays refer to the applicable FPGA Manager driver page. Links to the applicable page can be found under Linux Drivers.
Using HSI commands
1.Clone the device tree repo
https://github.com/Xilinx/device-tree-xlnx
2) Go to the HSI prompt
[vabbarap@xhdl3763 /proj/xhdsswstaff/vabbarap/Overlay/New_hdf> % hsi
hsi v2017.3 (64-bit)SW Build 2018833 on Wed Oct 4 19:58:07 MDT 2017
Copyright 1986-2017 Xilinx, Inc. All Rights Reserved.
3)
hsi% open_hw_design system.hdf
4)
hsi% set_repo_path /home/vabbarap/workspace/sync_dt_tip/clk_wiz_15_12_2017 (DTG repo path)
5)
hsi% create_sw_design -proc psu_cortexa53_0 sd22 -os device_tree
6)
hsi% set_property CONFIG.dt_overlay true [get_os]
7)
hsi% generate_target -dir dt/
hsi% ls dt/
pcw.dtsi pl.dtsi sd22.mss system-top.dts zynqmp-clk-ccf.dtsi zynqmp.dtsi
Using XSCT (From 2019.2 release no hsi support)
...
3) hsi open_hw_design system.xsa
4) hsi set_repo_path /home/vabbarap/workspace/sync_dt_tip/dt_15_12_2019 (DTG repo path)
5) hsi create_sw_design -proc psu_cortexa53_0 sd22 -os device_tree
...
Release Notes
- 2016.4 DTG Release Notes
- http://www.wiki.xilinx.com/2017.3+Linux+and+DTG+Release+Notes
- http://www.wiki.xilinx.com/2017.4+Linux+and+DTG+Release+Notes
- http://www.wiki.xilinx.com/2018.1+Linux+and+DTG+Release+Notes
- http://www.wiki.xilinx.com/2018.2+Linux+and+DTG+Release+Notes
- 2018.3 Release Notes for Open Source Components (see DTG section)
- 2022.1 Release Notes for Open Source Components (see DTG section)
Build Steps
- Build FSBL
- Build Device Tree Compiler (DTC)
- Build PMU Firmware
- Build Arm Trusted Firmware (ATF)
- Build U-Boot
- Build and Modify a Root File System
- (You are here) Build Device Tree Blob
- Build Linux Kernel
- Prepare Boot Image
- Prepare Boot Medium
- Setup a Serial Console
- Additional Information: Build Qt and Qwt Libraries
Related Links
- Build U-Boot
- Build Linux Kernel
- Updated device tree specification can be found here https://www.devicetree.org/
- https://elinux.org/Device_Tree_Usage