Embedded module TQMLS102xA - PTXdist Linux BSP documentation

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 Overview

BSP Version Matrix

BSP revision	Prerelease 7a3ec3d	0004	0005	0100	0102	0109	0110	0111	0112
PTXdist version required by BSP	2015.02	2015.05	2015.05	2015.05	2016.04	2016.04	2018.09	2019.01	2019.01
OSELAS Toolchain cf. Building OSELAS.Toolchains()	2013.12.2	2013.12.2	2013.12.2	2013.12.2	2013.12.2	2013.12.2	2018.02	2018.02	2018.12
Platform	MBLS102xA	MBLS102xA	MBLS102xA	MBLS102xA	MBLS102xA	MBLS102xA	MBLS102xA	MBLS102xA	MBLS102xA
U-boot	2015.04	2015.04	2015.04	2016.05	2016.05	2017.07	2017.11	2017.11	2017.11
Linux Kernel	3.12	3.12	4.4	4.4	4.4	4.4	4.14	4.14	4.14

Bootloader

U-Boot

Supported Features

Buildsystem				BSP Revision											Remarks
PTXdist				•	•	•	•	•	•	•	•	•
Yocto									•	•	•	•	•	•
TQ Product	Chip	Interface	Function	Prerelease 7a3ec3d	0004	0005	0100	0102	0109	0110	0111	0112	0115	0116
TQMLS102xA	LS102xA	eSDHC	eMMC / SD-Card	•	•	•	•	•	•	•	•	•	•	•	mutually exclusive (cf user's manual)
TQMLS102xA	LS102xA	ETSEC	RGMII / SGMII	•	•	•	•	•	•	•	•	•	•	•	For SGMII MBLS102xA Rev. ≥ 0200 required
TQMLS102xA	LS102xA	I2C1	EEPROM / PMC (System Reset Request)	•	•	•	•	•	•	•	•	•	•	•
TQMLS102xA	LS102xA	QSPI	QSPI NOR Flash	•	•	•	•	•	•	•	•	•	•	•	up to 2 Devices
TQMLS102xA	LS102xA	SATA	Host			•	•	•	•	•	•	•	•	•	SSD/HDD
TQMLS102xA	LS102xA	UART1	RS232	•	•	•	•	•	•	•	•	•	•	•	default console
TQMLS102xA	LS102xA	USB XHCI	USB 3.0/2.0	•	•	•	•	•	•	•	•	•	•	•	USB Storage Device

Supported Boot Devices

Boot device	BSP Revision						Remarks
Boot device	0102	0109	0110	0111	0112	0115	Remarks
eMMC / SD	•	•	•	•	•	•	mutually exclusive
QSPI NOR-Flash		•	•	•	•	•

Operating System

Please note that BSP Rev. 0100 is intended to be used on a MBLS102xA Rev. 02xx and higher.

When using BSP Rev. 0100 on a MBLS102xA Rev.01xx, please see How to Use BSP Rev.0100 on MBLS102xA Rev.01xx.

Linux

Supported Features

Buildsystem				BSP Revision											Remarks
PTXdist				•	•	•	•	•	•	•	•	•
Yocto									•	•	•	•	•	•
TQ Product	Chip	Interface	Function(s)	Prerelease 7a3ec3d	0004	0005	0100	0102	0109	0110	0111	0112	0115	0116
TQMLS102xA	LS102x	2D-ACE	24 Bit RGB			•	•	•	•	•	•	•	•	•	Pin header X17 on MBLS102xA
	LS102x	2D-ACE	SiI9022A			•	•	•	•	•	•	•	•	•	HDMI
	LS102x	2D-ACE	SN75LVDS83B			•	•	•	•	•	•	•	•	•	LVDS
	LS102x	CAN1	CAN 2.0 B				•	•	•	•	•	•	•	•
	LS102x	CAN2	CAN 2.0 B				•	•	•	•	•	•	•	•
	LS102x	eSDHC	eMMC	•	•	•	•	•	•	•	•	•	•	•	mutually exclusive (cf user's manual)
	LS102x	eSDHC	SD card	•	•	•	•	•	•	•	•	•	•	•	mutually exclusive (cf user's manual)
	LS102x	eTSEC0	RGMII (10/100/1000 Mbit/s)	•	•	•	•	•	•	•	•	•	•	•
	LS102x	eTSEC1	SGMII (10/100/1000 Mbit/s)				•	•	•	•	•	•	•	•	MBLS102xA Rev. ≥ 0200 required
	LS102x	eTSEC2	RGMII (10/100/1000 Mbit/s)	•	•	•	•	•	•	•	•	•	•	•
	LS102x	GPIO	Digital I/O	•	•	•	•	•	•	•	•	•	•	•
	LS102x	I2C1	Bus access			•	•	•	•	•	•	•	•	•
	LS102x	I2C1	EEPROM (M24C64)			•	•	•	•	•	•	•	•	•	EEPROM
	LS102x	I2C1	RTC (PCF85063)			•	•	•	•	•	•	•	•	•	RTC
	LS102x	I2C1	TEMP-Sensor (SA56004X)			•	•	•	•	•	•	•	•	•	TEMP-Sensor
	LS102x	LPUART1	TTL					•	•	•	•	•
	LS102x	PCIe	PCI Express™ Base Specification, Revision 3.0				•	•	•	•	•	•	•	•	PCIe slot (X35) on MBLS102xA Mini-PCIe slot (X24) on MBLS102xA
	LS102x	QSPI	QSPI NOR Flash			•	•	•	•	•	•	•	•	•
	LS102x	SATA	Serial ATA Revision 3.0				•	•	•	•	•	•	•	•
	LS102x	UART1	TTL	•	•	•	•	•	•	•	•	•	•	•
	LS102x	USB1	USB 3.0 OTG	•	•	•	•	•	•	•	•	•	•	•
	LS102x	USB2	USB2517 on MBLS102xA	•		•	•	•	•	•	•	•	•	•
MBLS102xA	MBED/OpenSDA	miniUSB	Console	•	•	•	•	•	•	•	•	•	•	•	Console available on X43 xor X5 (LPUART)
	TLV320AIC3204	SAI1	Audio Codec								•	•	•	•	U-Boot image with SAI muxing in RCW and SAI CPLD configuration required
	SiI9022A	HDMI	Ext. Monitor					•	•	•	•	•	•	•	MBLS102xA REV.0202 and TQMLS102xA ≥ REV.0203 required
	SN75LVDS83B	LVDS	Ext. Display			•	•	•	•	•	•	•	•	•	X10 / X32
	SP3222E	UART1	RS232	•	•	•	•	•	•	•	•	•	•	•
	SP491E	LPUART1	RS485			•	•	•	•	•	•	•	•	•
	STMPE811	I2C1	Touch
	USB2517	USB2_H4	Host			•	•	•	•	•	•	•	•	•
	USB2517	USB2_H5	Host			•	•	•	•	•	•	•	•	•
	USB2517	USB2_H6	Host			•	•	•	•	•	•	•	•	•	assembly option: Safenet HL Chip Sentinel

Changelog

BSP Version History

2019-09-10 - REV.0112

BSP

Upgrade toolchain to 2018.12.0 / gcc 8.2.1
Use PTXDIST_BSP_AUTOVERSION in configs
Enable PTXCONF_PROJECT_CHECK_LICENSES in configs

Linux

Fixed RS485 support in LPUART driver
Fix reboot issue
Disable CONFIG_MTD_CFI and CONFIG_MTD_NAND
Disable CONFIG_UEVENT_HELPER
Enable IPv6
Enable CRYPTO_USER and CRYPTO_USER_API
Disable SND_SUPPORT_OLD_API and enable SND_HRTIMER

2019-06-21 - REV.0111

BSP

Added U-Boot variants for SAI muxing

U-Boot

RCW: added SAI muxing

Linux

improved Kernel config
added TLV320 codec driver
DTB: added audio codec support

RootFS

Added asound.state file

2019-03-14 - REV.0110

BSP

OSELAS Toolchain Update to 2018.2.0 / gcc-7.3.1
PTXdist Update to 2018.09.0

U-Boot

combined image (RCW/PBI + U-Boot-Binary)
e-MMC boot partition access (not bootable)
UBI: supports RootFS update in U-Boot

Linux

Update to v4.14.78
Extended display support

Parallel dispalys (incl. touch):
Glyn ETM0700G0EDH6 (800×480)
DMB S070PWS19HP-FC21 (1024×600)
DMB S070SWV29HG-DC44 (800×480)

LVDS display (incl. touch):
Tianma TM070JVHG3 (1024×768)

Enable RS485 at boot
set USB3 to OTG
PHY DP83867 reset via SW_RESTART now optional

2018-06-14 - REV.0109

TQMLS102xA-BSP

OSELAS Toolchain Update from 2013.12.2 to 2014.12.2

SD Card Image

devicetree and kernel in firmware partition

U-Boot

using internal dtb
added support for -ae variant
fixed comments in rcw source file
new version: v2017.07
e-MMC DSR detection
support for module identification eeprom (default address 0x54)
system boot from qspi flash → u-boot/dtb/kernel/rootfs
dspi0 enabled in kernel
renamed dtb file: ls1021a-tqmls1021a-mbls102xa.dts
RX ethernet workaround message

Linux

removed u-boot compatibility changes from linux device tree
set lpuart0 to original clock source sysclk
cpu speed throttling via die temperature
fixed e-mmc bus width
dspi0 enabled in kernel

2016-11-23 - REV.0102

TQMLS102xA-BSP

Build ecc and non-ecc u-boot variant, install non-ecc by default

Build Tools

PTXdist 2016.04

U-Boot

QSPI: RCW+U-Boot in a single image
QSPI: RCW built from U-Boot sources
QSPI: fix kernel crash when two qspi flashes in devtree but only one chip placed
Split module and board source files
AHCI: non-queued error recovery
Support DDR3 ECC
PCIe: allow 5G links
Probe MBLS102xA CPLD mux mode and dis-/enable HDMI in DRM system
Show MBLS102xA CPLD mux mode via LEDs

Linux

add gpio expander new on board revision 200
add on-die temperature sensor
enable always-on timer
fix dp83867 device tree required properties
fix PCIe MSI support
enabled CPU frequency scaling

2016-05-19 - REV.0100

TQMLS102xA-BSP

BSP

Kernelconfig: LZO image compression (reduced boot time)
Kernelconfig: build PREEMPT
Kernelconfig: enable PHY timestamping for IEEE1588
Add linuxptp for IEEE1588
Readme update
RCW: update and sync QSPI to SD RCW
RCW: remove USB3.0 overcurrent reporting
Add U-Boot 2016.05-rc1
Do not compile reference device trees for QDS and TWR boards

Kernel

fsl-dcu: support inverted pixel clock (ETM0700G0EDH6 display)
hdmi: add driver for sii9022 transceiver
touchscreen: update driver for M12 type (Hycon controller)
DT: add msi-parent node for pcie
I2C: workaround to recover from a bus stall (SDA held low)
DT: support MBLS102xA.0200 PHYs
DT: Gianfar buffer descriptors no longer little-endian
DT: Add ptp node for IEEE1588 support
DT: Add dspi0 and generic spidev nodes

U-Boot

QSPI quad mode (1-1-4) support (for SD Boot)
I2C: workaround to recover from a bus stall (SDA held low)
SATA: stability improved, not reliably tested
Support for MBLS102xA.0200 PHYs
Support for module EEPROM parsing (like TQMa6)

2016-03-23 - REV.0005

TQMLS102xA-BSP

Build tools

PTXdist 2015.05
OSELAS.Toolchain-2013.12.2

Linux Kernel 4.4
U-Boot 2013.04
Remove kernel fsl-sdk-1.7
Remove u-boot fsl-sdk-1.7

U-Boot

Allow to update SPI U-Boot from MMC U-Boot
XHCI Interface support (supports USB2.0)
Fix e-MMC write hangs
Add function to reset board

Linux

DP83867: LED config
Parallel display support using DRM panel subsystem
Static backlight support via LED driver
Gianfar: use little endian buffer descriptors
Add LS1021A GPIO controller support
Add support for port expanders
RTC support
XHCI and EHCI support
Add function to reset board
Add support for QSPI flash
Prepare SGMII support

Table of Contents

Embedded module TQMLS102xA - PTXdist Linux BSP documentation

BSP Overview

BSP Version Matrix

Bootloader

U-Boot

Supported Boot Devices

Operating System

Linux

Changelog

BSP Version History

2019-09-10 - REV.0112

2019-06-21 - REV.0111

2019-03-14 - REV.0110

2018-06-14 - REV.0109

2016-11-23 - REV.0102

2016-05-19 - REV.0100

2016-03-23 - REV.0005