Embedded module TQMa6x - Linux BSP documentation

This is an old revision of the document!

Important Notes

CVE-2015-7547 --- glibc getaddrinfo() stack-based buffer overflow

Pengutronix has released new versions of their OSELAS Toolchains, which fix the CVE-2015-7547 --- glibc getaddrinfo() stack-based buffer overflow issue:

OSELAS version	glibc version
2014.12.2	2.20
2013.12.3	2.18
2012.12.2	2.16.0
2011.11.4	2.14.1
2011.03.2	2.13

TQ strongly recommends to switch your PTXdist based BSP(s) to one of the above mentioned (or later) OSELAS toolchains.

For deployed systems with network connectivity, an update should be taken into consideration!

Step-by-step instructions to switch your BSP to a new toolchain

1. Build the new OSELAS toolchain

Choose the new toolchain version, which fits best and build it according to the Application Note: Building OSELAS.Toolchains().

2. Reconfigure your BSP / platform

Move to your BSP root folder and execute
```
ptxdist platformconfig
```

Navigate to

architecture -->  toolchain -->

and modify the following options

(OSELAS.Toolchain-YYYY.MM.P) check for specific toolchain vendor
(MAJOR.MINOR[.PATCH]) check for specific glibc version

to match the version information for the toochain you built in the first step.

Exit PTXdist and make sure your changes are saved.
To make PTXdist use the new toolchain for your BSP / platform execute
```
ptxdist toolchain <path to the new toolchain>
```

3. Rebuild your BSP

For a clean rebuild execute
```
ptxdist clean
ptxdist go --git
```

BSP revision	0100 (precompiled binaries) TQMa6x BSP Rev.0100 (source)	0101	0104	0105	0109	0110
PTXdist version required by BSP	2013.03	2013.12	2013.12	2014.11	2015.05	2016.04
OSELAS Toolchain cf. Building OSELAS.Toolchains()	2012.12.1	2013.12.1	2013.12.2	2013.12.2	2013.12.2	2014.12.2
Platform	MBa6x	MBa6x	MBa6x	MBa6x	MBa6x	TQMa6x	TQMa6x-FSL
U-Boot	2013.04	2013.04	2013.04	2014.04	2015.04	2015.04	NXP rel_imx_4.1.15_2.0.0_ga
Linux Kernel	3.10	3.13	3.16-rc5	3.16.7	4.1	4.1	NXP rel_imx_4.1.15_2.0.0_ga
Qt Version	4.8.4	4.8.5	4.8.6	5.3.2	5.3.2	5.6.2	5.6.2

With BSP Revision 0109 the Linux kernel version changed from 3.16.7 to 4.1 The devicetree source & blob files for kernel 3.16.7 are not compatible to kernel 4.1 and vice versa.

BSP Rev. ≤ 0105

Naming convention

Device Tree Blobs
Several device tree blobs (.dtb files) are built by default, the resulting files are named as follows:
imx6<q|dl>-mba6x-<hdmi|lvds|multi|pd>.dtb
When building an sd card image, the HDMI enabled device tree blob is used by default.

Module (CPU) type
imx6q	TQMa6Q \| TQMa6D
imx6dl	TQMa6DL \| TQMa6S
Module revision
mba6x	TQMa6x Rev.02xx Variant B \| TQMa6x Rev.01xx
Display interface
hdmi	HDMI only
lvds	LVDS only
pd	parallel display only
multi	HDMI + LVDS + parallel display

Dependency matrix

File	Module	Starterkit Mainboard	i.MX6Q	i.MX6D	i.MX6DL	i.MX6S	Revision 010x
imx6qdl-tqma6x.dtsi	✔		✔	✔	✔	✔	✔
imx6q-tqma6x.dtsi	✔		✔	✔			✔
imx6dl-tqma6x.dtsi	✔				✔	✔	✔
imx6qdl-mba6x.dtsi	included	✔	✔	✔	✔	✔	✔
imx6q-mba6x.dts	included	✔	✔	✔			✔
imx6dl-mba6x.dts	included	✔			✔	✔	✔

Dependency graph

<div style="text-align:center;background-color:#E66A08;width:250px;height: 30px;">
<span style=";color:white;font-size:150%;">CPU specific files</span>
</div>
 
<div style=";margin-top:2px;text-align: center;background-color:#1D8EC6;width:250px;height: 30px;">
<span style="color:white;font-size:150%;">Module specific files</span>
</div>
 
<div style="margin-top:2px;text-align: center;background-color:#8F8F8F;width:250px;height: 30px;
">
<span style="color:white;font-size:150%;">Baseboard specific files</span></div>

BSP Rev. ≥ 0109

Naming convention

Device Tree Blobs
Several device tree blobs (.dtb files) are built by default, the resulting files are named as follows:
imx6<q|dl>-mba6<a|b>-<hdmi|lvds|multi|pd>.dtb
When building an sd card image, the HDMI enabled device tree blob is used by default.

Flat Image Tree (FIT)
Additionaly a FIT image (*.itb) is generated, which contains all device trees in a single file.

To select an individual DTB from this FIT you have to set the U-Boot variables fdt_type and fitfdt_part accordingly.

Module (CPU) type
imx6q	TQMa6Q \| TQMa6D
imx6dl	TQMa6DL \| TQMa6S
Module revision & variant
mba6a	TQMa6x Rev.02xx Variant A & C
mba6b	TQMa6x Rev.02xx Variant B \| TQMa6x Rev.01xx
Display interface
hdmi	HDMI only
lvds	LVDS only
pd	parallel display only
multi	HDMI + LVDS + parallel display

Dependency matrix

File	Module	Starterkit Mainboard	i.MX6Q	i.MX6D	i.MX6DL	i.MX6S	Revision 010x	Revision 020x	Ethernet Patch
imx6qdl-tqma6.dtsi	✔		✔	✔	✔	✔	✔	✔
imx6qdl-tqma6a.dtsi	✔		✔	✔	✔	✔		✔	✔
imx6qdl-tqma6b.dtsi	✔		✔	✔	✔	✔	✔	✔
imx6q-tqma6.dtsi	✔		✔	✔			✔	✔
imx6q-tqma6a.dtsi	✔		✔	✔				✔	✔
imx6q-tqma6b.dtsi	✔		✔	✔			✔	✔
imx6dl-tqma6.dtsi	✔				✔	✔	✔	✔
imx6dl-tqma6a.dtsi	✔				✔	✔		✔	✔
imx6dl-tqma6b.dtsi	✔				✔	✔	✔	✔
imx6qdl-mba6.dtsi	included	✔	✔	✔	✔	✔	✔	✔
imx6qdl-mba6a.dtsi	included	✔	✔	✔	✔	✔		✔	✔
imx6qdl-mba6b.dtsi	included	✔	✔	✔	✔	✔	✔	✔
imx6q-mba6.dtsi	included	✔	✔	✔			✔	✔
imx6q-mba6a.dts	included	✔	✔	✔				✔	✔
imx6q-mba6b.dts	included	✔	✔	✔			✔	✔
imx6dl-mba6.dtsi	included	✔			✔	✔	✔	✔
imx6dl-mba6a.dts	included	✔			✔	✔		✔	✔
imx6dl-mba6b.dts	included	✔			✔	✔	✔	✔

Dependency graph

<div style="text-align:center;background-color:#E66A08;width:250px;height: 30px;">
<span style=";color:white;font-size:150%;">CPU specific files</span>
</div>
 
<div style=";margin-top:2px;text-align: center;background-color:#1D8EC6;width:250px;height: 30px;">
<span style="color:white;font-size:150%;">Module specific files</span>
</div>
 
<div style="margin-top:2px;text-align: center;background-color:#8F8F8F;width:250px;height: 30px;
">
<span style="color:white;font-size:150%;">Baseboard specific files</span></div>

Feature				BSP Revision			Remarks
TQ Product	Chip	Interface	Function	0105	0109	0110	Remarks
TQMa6x	i.MX6	Ethernet	RGMII (10/100/1000 Mbit/s)	✔	✔	✔
TQMa6x	i.MX6	uSDHC	eMMC / SD-Card	✔	✔	✔	SD card / eMMC
TQMa6x	i.MX6	UART2	RS232	✔	✔	✔	default console
TQMa6x	i.MX6	I²C	EEPROM, Temperature Sensors	✔	✔	✔
TQMa6x	i.MX6	GPIO					custom config on request
TQMa6x	i.MX6	SPI	SPI NOR Flash	✔	✔	✔
TQMa6x	i.MX6	IIM / Fuse					on request
TQMa6x	i.MX6	Devicetree FIT image			✔		see How To

Boot device	supported
eMMC / SD boot	✔
TFTP boot	✔
SPI NOR boot	✔

Feature				BSP Revision							Remarks
TQ Product	Chip	Interface	Function	Pre-Release	0100	0101	0104	0105	0109	0110	Remarks
TQMa6x	i.MX6	AUD3	TLV320AIC3204			✔	✔	✔	✔	✔	AudioCodec
	i.MX6	EIM	Bus access					✔	✔	✔	driver support / no device on MBa6x
	i.MX6	ENET	RGMII (10/100/1000 Mbit/s)	✔		✔	✔	✔	✔	✔	MBa6x Rev. ≥ 0102 required
	i.MX6	FLEXCAN1	CAN 2.0B		✔	✔	✔	✔	✔	✔	BSP Rev. ≤ 0100: bitrate is not set as correctly
	i.MX6	FLEXCAN2	CAN 2.0B		✔	✔	✔	✔	✔	✔	BSP Rev. ≤ 0100: bitrate is not set as correctly
	i.MX6	GPIO		✔	✔	✔	✔	✔	✔	✔	BSP Rev. ≥ 0104: available via sysfs default pin-multiplexing covers all GPIO pins available on X30
	i.MX6	GPIO1_IO21	Buzzer		✔	✔	✔	✔	✔	✔	BSP Rev. ≤ 0101 supported via sysfs gpio BSP Rev. ≥ 0104 supported via `beep` command
	i.MX6	GPU2D	Hardware Acceleration				○	✔	✔	✔	BSP Rev. ≥ 0105 or kernel 3.10.17-fsl ◊ ptxdist platformconfig → extra kernel ◊ rootfs from Freescale reference BSP required tested resolution 1366×768 For using GPU see How To
	i.MX6	GPU3D	Hardware Acceleration				○	✔	✔	✔	BSP Rev. ≥ 0105 or kernel 3.10.17-fsl ◊ ptxdist platformconfig → extra kernel ◊ rootfs from Freescale reference BSP required tested resolution 1366×768 For using GPU see How To
	i.MX6	HDMI	HDMI			✔	✔	✔	✔	✔	known limitations ◊ requires monitor with correct HPD signal For Freescale kernel see How To
	i.MX6	I2C1	I2C devices			✔	✔	✔	✔	✔	see supported onboard I2C devices
	i.MX6	I2C3	I2C devices			✔	✔	✔	✔	✔	see supported onboard I2C devices
	i.MX6	IPU1	Parallel LCD				✔	✔	✔	✔	displays supported BSP Rev. ≥ 0104: EDT ET(M)0700G0DH6 (7“ WVGA) supported by `imx6[q\|dl]-mba6x-pd.dtb`
	i.MX6	JTAG
	i.MX6	LDB	LVDS	✔	✔	✔	✔	✔	✔	✔	displays supported BSP Rev. ≥ 0104: ChiMei G104X (10.4” XGA) supported by `imx6[q\|dl]-mba6x-lvds.dtb`
	i.MX6	PCIe	Device Discovery				✔	✔	✔	✔	BSP Rev. 0104 TQMa6D/Q support
	i.MX6	PWM1	Backlight Dimming				✔	✔	✔	✔	MBa6x Rev. ≥ 0200 required
	i.MX6	SATA	Serial ATA 3.0		✔	✔	✔	✔	✔	✔	TQMa6Q and TQMa6D only
	i.MX6	SPDIF	Digtal Audio					✔	✔	✔	availabe at X30.10/12 on MBa6x
	i.MX6	SPI1	Bus access		✔	✔	✔	✔	✔	✔	BSP Rev. ≥ 0104: SS2 configured for spidev, SS3 prepared for usage (pin-multiplexing)
	i.MX6	SPI1	NOR flash		✔	✔	✔	✔	✔	✔	/dev/mtd0
	i.MX6	SPI5	Bus access				✔	✔	✔	✔	TQMa6Q only BSP Rev. ≥ 0104: SS1 configured for spidev
	i.MX6	TEMPMON				✔	✔	✔	✔	✔
	i.MX6	UART1									not available on MBa6x
	i.MX6	UART2	RS232	✔	✔	✔	✔	✔	✔	✔	default console
	i.MX6	UART3	TTL		✔	✔	✔	✔	✔	✔
	i.MX6	UART4	RS485		✔	✔	✔	✔	✔	✔
	i.MX6	UART5	TTL		✔	✔	✔	✔	✔	✔
	i.MX6	USB_OTG	Host	✔	✔	✔	✔	✔	✔	✔
	i.MX6	USB_OTG	OTG			✔	✔	✔	✔	✔
	i.MX6	USB_UH1	USB2517	✔	✔	✔	✔	✔	✔	✔
	i.MX6	USB_UH2									not available on MBa6x
	i.MX6	USB_UH3									not available on MBa6x
	i.MX6	uSDHC	SD(HC)-Card sd2 SD card sd3 eMMC	✔	✔	✔	✔	✔	✔	✔	see issues for known limitations
	i.MX6	VPU	Hardware Acceleration						✔	✔	For using VPU see How To
MBa6x	TLV320AIC3204	Audio Codec	Headphone Out / Line Out			✔	✔	✔	✔	✔	selectable using solder straps on MBa6x
			Line In			✔	✔	✔	✔	✔
			Microphone In
	LAN9500	ENET	10/100 Mbit/s	✔	✔	✔	✔	✔	✔	✔	BSP Rev. ≤ 0101 MAC needs to be configured via U-Boot variable `usbethaddr` BSP Rev. ≥ 0104 automatic MAC configuration with MBa6x Rev. ≥ 0200
	GPIO	GPIO Key			✔	✔	✔	✔	✔	✔	configured as input device
	LED	LED	LED				✔	✔	✔	✔	MBa6x Rev. ≥ 0200 required
	USB2517	USB1	LAN9500	✔	✔	✔	✔	✔	✔	✔	MBa6x Rev. ≥ 0102 required
	USB2517	USB2	Host		✔	✔	✔	✔	✔	✔
	USB2517	USB3	Host		✔	✔	✔	✔	✔	✔
	USB2517	USB4 on pinheader X27	Host		✔	✔	✔	✔	✔	✔
	USB2517	USB5 on Mini-PCIe connector X23	Host
	USB2517	USB6	Host		✔	✔	✔	✔	✔	✔
	USB2517	USB7 on LVDS connector X19									not tested

TQMa6x Rev.01xx / TQMa6x Rev.02xx Variant B

I2C bus	TQMa6x			MBa6x
I2C1				0x18 Audiocodec
I2C3	0x08 PMIC	0x48 LM75	0x50 EEPROM	0x49 LM75	0x57 EEPROM	0x68 RTC

TQMa6x Rev.02xx Variant A & C

I2C bus	TQMa6x			MBa6x
I2C1	0x08 PMIC	0x48 LM75	0x50 EEPROM	0x18 Audiocodec	0x49 LM75	0x57 EEPROM	0x68 RTC
I2C3	not available due to ethernet patch

i.MX6	AUD3	I2S				t.b.d
i.MX6	I2S	AudioCodec				t.b.d

2018/19/04 - REV 0110

2015/10/14 - REV 0109

2015/22/01 - REV 0105

Development Environment, .:Linux:build_bsp|Building BSP, .:Linux:adapt_BSP|Adapting BSP, .:Linux:deployment|Deployment, .:Linux:Downloads, .:Linux:FAQ, .:Linux:How to..., .:Linux:Known issues

Embedded module TQMa6x - Linux BSP documentation

BSP Overview

Version Matrix

Flat Devicetree

Naming convention

Dependency matrix

Dependency graph

Naming convention

Dependency matrix

Dependency graph

Bootloader

Supported features

Supported boot devices

Operating System

Supported Features

Onboard I2C devices

TQMa6x Rev.01xx / TQMa6x Rev.02xx Variant B

TQMa6x Rev.02xx Variant A & C

Changelog

Embedded module TQMa6x - Linux BSP documentation