Device tree files

Device tree file types

The device tree is a set of text files in the Linux kernel source tree that describe the hardware of a certain platform. They are located at arch/arm/boot/dts/ and can have two extensions:

ConnectCore 6 Plus system-on-module

The ConnectCore 6 Plus is a system-on-module (SOM) solution that integrates:

The ConnectCore 6 Plus system-on-module needs to be soldered to a carrier board. For this reason, there is not a single *.dts file for it. Instead, its hardware features are collected into *.dtsi files that can be included by a final platform *.dts.

Since the ConnectCore 6 Plus system-on-module is offered in different variants, multiple *.dtsi files have been defined to describe the hardware inside:

File Description
imx6qp-ccimx6.dtsi Common hardware for ConnectCore 6 Plus system-on-module variants with QuadPlus/DualPlus CPU
imx6qp-ccimx6-wb.dtsi ConnectCore 6 Plus system-on-module variant with QuadPlus/DualPlus CPU, wireless, and Bluetooth

Depending on your ConnectCore 6 Plus variant, your final platform *.dts file will need to include one of these files.

ConnectCore 6 Plus SBC

The ConnectCore 6 Plus SBC is a carrier board assembling the ConnectCore 6 Plus system-on-module. The SBC assembles additional hardware like HDMI, Ethernet PHY, audio chip, PCIe minicard, microSD card holder, user LEDs, and so on.

As a final platform, the SBC has a *.dts file that includes one of the ConnectCore 6 Plus system-on-module *.dtsi files.

Include files

The SBC can assemble different variants of the ConnectCore 6 Plus system-on-module, so the common hardware of the SBC is also described in several .dtsi files:

The SBC can assemble different variants of the ConnectCore 6 Plus system-on-module, so the common hardware of the SBC is described in a .dtsi file:

File Description
imx6qp-ccimx6qpsbc.dtsi Common hardware for ConnectCore 6 Plus SBC

Final platform files

The final ConnectCore 6 Plus SBC platform is described in a *.dts file:

File Digi product smart part number CPU family Wireless Bluetooth
imx6qp-ccimx6qpsbc-id160.dts CC-WMX-KK8D-TN QuadPlus

Graphical representation

The following graphic illustrates the composition of a .dts file.