Table of Contents

Entry Page

Third-Party Add-Ons

Board Support Packages

Product URL List

TQ product page TQMLS1028a

Starterkit

Hardware

Debug Connection

The TQMLS1028A debug UART is connected via a FTDI USB-to-Serial converter to X19 (micro-USB) on the MBLS1028A. A micro-USB/USB-A cable for the connection to the host PC is part of the STKLS1028A accessory set.
Depending on the host operating system, the USB-to-serial converter driver may need to be installed.

Onboard I2C devices

I2C Device Overview

TQMLS1028a

I2C bus TQMLS1028a
I2C1 System Controller
0x11 		Tempsensor
0x18 		Manufacturer EEPROM Software Protection
0x30 		Tempsensor
0x4c 		Manufacturer EEPROM
0x50 		RTC
0x51 		EEPROM
0x57

MBLS1028a

I2C bus MBLS1028a
I2C5 (MUX A) USB Hub
0x44 		Clock-Generator
0x70 		MPCIe
(Depends on usage)
I2C5 (MUX B) Mikro Bus Connector
(Depends on usage)
I²C6 I²C Port Expander
0x70
I²C6 (3v3) I²C Port Expander
0x25

MBLS1028a-IND

I2C bus MBLS1028a-IND
I2C5 USB Hub
0x44 		Clock-Generator
0x70 		MPCIe
(Depends on usage)
I²C6 I²C Port Expander
0x70
I²C6 (3v3) I²C Port Expander
0x71

Hardware Issues

Linux BSP

U-Boot

U-Boot

Supported Features
Buildsystem BSP Revision
OpenIL •
Yocto • • • • • • • • • •
TQ Product Chip Interface Function 0003 0011 0102 0103 0104 0105 0106 0107 0108 0109 0110
TQMLS1028A LS1028A eSDHC1 SD-Card • • • • • • • • • • •
TQMLS1028A LS1028A eSDHC2 eMMC • • • • • • • • • • •
TQMLS1028A LS1028A EC1 RGMII • • • • • • • • • • •
TQMLS1028A LS0128A ENETC SGMII • • • • • • • • • • •
TQMLS1028A LS1028A I2C1 Bus access • • • • • • • • • • •
TQMLS1028A LS1028A FlexSPI QSPI NOR Flash • • • • • • • • • • •
TQMLS1028A LS1028A UART1 RS232 • • • • • • • • • • • Default console

U-Boot

Supported boot devices
Boot device BSP Revision Remarks
0003 0011 0102 0103 0104 0105 0106 0107 0108 0109 0110
eMMC / SD • • • • • • • • • • •
QSPI NOR-Flash • • • • • • • • • • •

Kernel

Operating System

Linux

Supported Features
Buildsystem BSP Revision
OpenIL •
Yocto • • • • • • • • • •
TQ Product Chip Interface Function(s) 0003 0011 0102 0103 0104 0105 0106 0107 0108 0109 0110
TQMLS1028 LS1028 EC1 RGMII • • • • • • • • • • •
ENETC SGMII • • • • • • • • • • •
ENETC QSGMII • • • • • • • • • • •
GPIO • • • • • • • • • • •
eSDHC1 SD-Card • • • • • • • • • • •
eSDHC2 eMMC • • • • • • • • • • •
FLEXCAN1 CAN 2.0B • • • • • • • • • • •
FLEXCAN2 CAN 2.0B • • • • • • • • • • •
FLEXSPI Bus Access • • • • • • • • • • •
I2C1 Bus Access • • • • • • • • • • •
I2C5 Bus Access • • • • • • • • • • •
I2C6 Bus Access • • • • • • • • • • •
LCD controller Display Port • only 1920×1080 resolution supported
LPUART1 • • • • • • • • • • • Default Console
LPUART2 • • • • • • • • • • •
SATA • • • • • • • • • • •
PCIe Host • • • • • • • • • • •
SPI3 Bus Access • • • • • • • • • • •
USB 3.0 TUSB8041I • • • • • • • • • • •
USB 3.0 OTG • • • • • • • • •
MBLS1028A TUSB8041I USB 1 Host • • • • • • • • • • •
USB 2 Host • • • • • • • • • • •
USB 3 Host • • • • • • • • • • •
USB 4 Host • • • • • • • • • • •

OpenIL BSP Version Matrix

Version Matrix

BSP Revision OpenIL Release Hardware platform U-Boot Linux Kernel
0003 201904 mbls1028a 2018.03 4.14.47

OpenIL Images

Finally, you will find the built images in platform-<platformname>/images

Bootloader images:

Linux images:

Device tree blobs:

Rootfs images:

Firmware images:

OpenIL Changelog

0003

DevHost

Build BSP

Compilation

BSP Rev.0100 (and later)

Adapt BSP

OpenIL Deployment

Yocto BSP Version Matrix

BSP Version Matrix

BSP Revision Yocto Project / Poky Release meta-tq release Target machine1) U-Boot Linux Kernel
0110 4.0.18 - Kirkstone kirkstone tqmls1028a-mbls1028a
tqmls1028a-mbls1028a-ind 		u-boot-2019.10-LSDK-20.04 lf-5.15.5-1.0.0
LSDK-20.12-V5.4-RT
0109 4.0.11 - Kirkstone kirkstone tqmls1028a-mbls1028a
tqmls1028a-mbls1028a-ind 		u-boot-2019.10-LSDK-20.04 lf-5.15.5-1.0.0
LSDK-20.12-V5.4-RT
0108 3.3.3 - Hardknott hardkott tqmls1028a-mbls1028a
tqmls1028a-mbls1028a-ind 		u-boot-2019.10-LSDK-20.04 fslc-5.4-1.0.0-imx
LSDK-20.12-V5.4-RT
lf-5.10.y-rt
0107 3.3.3 - Hardknott hardkott tqmls1028a-mbls1028a
tqmls1028a-mbls1028a-ind 		u-boot-2019.10-LSDK-20.04 fslc-5.4-1.0.0-imx
LSDK-20.12-V5.4-RT
lf-5.10.y-rt
0106 3.0.3 - Zeus zeus tqmls1028a-mbls1028a
tqmls1028a-mbls1028a-ind 		u-boot-2019.10-LSDK-20.04 fslc-5.4-1.0.0-imx
LSDK-20.12-V5.4-RT
lf-5.10.y-rt
0105 3.0.3 - Zeus zeus tqmls1028a-mbls1028a
tqmls1028a-mbls1028a-ind 		u-boot-2019.10-LSDK-20.04 fslc-5.4-1.0.0-imx
LSDK-20.12-V5.4-RT
0104 3.0.3 - Zeus zeus tqmls1028a-mbls1028a
tqmls1028a-mbls1028a-ind 		u-boot-2019.10-LSDK-20.04 fslc-5.4-1.0.0-imx
LSDK-20.12-V5.4-RT
0103 3.0.3 - Zeus zeus tqmls1028a-mbls1028a
tqmls1028a-mbls1028a-ind 		u-boot-2019.10-LSDK-20.04 fslc-5.4-1.0.0-imx"
0102 3.0.3 - Zeus zeus tqmls1028a-mbls1028a
tqmls1028a-mbls1028a-ind 		u-boot-2019.10-LSDK-20.04 fslc-5.4-1.0.0-imx"
0011 3.0.3 - Zeus zeus tqmls1028a-mbls1028a
tqmls1028a-mbls1028a-emmc
tqmls1028a-mbls1028a-ind
tqmls1028a-mbls1028a-ind-emmc 		2018.03 linux-v5.4-LSDK-20.04

Tip: Get notified on new BSP release

Yocto Changelog

BSP Version History

Rev.0108

  • Update documentation

Rev.0107

BSP

  • TQMLS1028a build bl2 for all rcw variants
  • Added 800MHz RCW variants for sd boot and spi boot
  • Update machine configuration:
    • Adjustments for latest meta-freescale for Layerscape based SOM preparation of better linux PREEMPT RT support

Rev.0106

BSP

  • new kernel linux-rt-lsdk-tq-5.10
  • perf: backport from Yocto Dunfell to fix build issues with newer kernels

Rev.0105

BSP

  • Use correct manufacturer EEPROM address

Rev.0104

BSP

  • Added new kernel linux-rt-lsdk-tq-5.4 with PREEMPT_RT support

Rev.0103

BSP

  • Switch from TMU to external sensor IC for core-cluster thermal zone

U-Boot

  • Fix update_pbl_spi and update_pbl_mmc scripts in U-Boot default environment. Before this fix, update_pbl_mmc was unusable.
  • fix CPU node FDT fixups in U-Boot not to break the thermal-zones (making the thermal driver unusable). This adds support for the TQMLS1017A to the tqmls1028a images. Both U-Boot and the Linux kernel must be updated for proper operation on TQMLS1017A.

Rev.0102

BSP

  • Added u-boot-lsdk-tq 2019.10 (based on LSDK 20.04)
  • Added kernel linux-imx-tq 5.4
  • The meta-freescale layer has been made mandatory for these machines

U-Boot

  • SD card and eMMC boot configurations have been merged and are now supported by a single image
  • Changed to TF-A (Trusted Firmware) boot
    • The U-Boot environment for SPI-NOR boot moved to offset 5 MiB
    • The U-Boot environment for eMMC/SD card boot moved to offset 8 MiB
    • The PPA (Primary Protected Application) package was replaced with ATF (ARM Trusted Firmware)
    • For more information about the TF-A boot process please refer to the NXP Layerscape SDK User Guide

Rev.0011

  • Initial BSP Release

Yocto Deployment

Device assignment

Device assignment:
mmcdev 0 = SD Card
mmcdev 1 = eMMC

Yocto Images

Target Machine: tqmls1028a-mba1028a (BSP revision = 0108)

System Image

Boot device Symlink File
SD Card/eMMC tq-image-generic-debug-tqmls1028a-mbls1028a.wic tq-image-generic-debug-tqmls1028a-mbls1028a-<build_timestamp>.rootfs.wic

Bootstream (Bootloader) Binary

Boot Device Symlink File
SD Card/eMMC u-boot.bin u-boot-tfa-2019.10-r0.bin

Linux Kernel Binary

Symlink File
Image.gz Image.gz--5.4.44+git0+2b11415c75-r0-tqmls1028a-mbls1028a-<build_timestamp>.bin

Devicetree Binarys

Symlink Description
fsl-ls1028a-mbls1028a.dtb default device tree blob for TQMLS1028A on MBLS1028A
fsl-ls1028a-mbls1028a-ind.dtb default device tree blob for TQMLS1028A on MBLS1028A-IND

RootFS Images

Symlink File
tq-image-generic-debug-tqmls1028a-mbls1028a.ext4 tq-image-generic-debug-tqmls1028a-mbls1028a-<build_timestamp>.rootfs.ext4
tq-image-generic-debug-tqmls1028a-mbls1028a.tar.gz tq-image-generic-debug-tqmls1028a-mbls1028a-<build_timestamp>.rootfs.tar.gz

Target Machine: tqmls1028a-mba1028a (BSP revision = 0107)

System Image

Boot device Symlink File
SD Card/eMMC tq-image-small-debug-tqmls1028a-mbls1028a.wic tq-image-small-debug-tqmls1028a-mbls1028a-<build_timestamp>.rootfs.wic

Bootstream (Bootloader) Binary

Boot Device Symlink File
SD Card/eMMC u-boot.bin u-boot-tfa-2019.10-r0.bin

Linux Kernel Binary

Symlink File
Image.gz Image.gz--5.4.44+git0+2b11415c75-r0-tqmls1028a-mbls1028a-<build_timestamp>.bin

Devicetree Binarys

Symlink Description
fsl-ls1028a-mbls1028a.dtb default device tree blob for TQMLS1028A on MBLS1028A
fsl-ls1028a-mbls1028a-ind.dtb default device tree blob for TQMLS1028A on MBLS1028A-IND

RootFS Images

Symlink File
tq-image-small-debug-tqmls1028a-mbls1028a.ext4 tq-image-small-debug-tqmls1028a-mbls1028a-<build_timestamp>.rootfs.ext4
tq-image-small-debug-tqmls1028a-mbls1028a.tar.gz tq-image-small-debug-tqmls1028a-mbls1028a-<build_timestamp>.rootfs.tar.gz

Target Machine: tqmls1028a-mba1028a (BSP revision ≤ 0106)

System Image

Boot device Symlink File
SD Card/eMMC tq-image-generic-tqmls1028a-mbls1028a.wic tq-image-generic-tqmls1028a-mbls1028a-<build_timestamp>.rootfs.wic

Bootstream (Bootloader) Binary

Boot Device Symlink File
SD Card/eMMC u-boot.bin u-boot-tfa-2019.10-r0.bin

Linux Kernel Binary

Symlink File
Image.gz Image.gz--5.4-r0-tqmls1028a-mbls1028a-<build_timestamp>.bin

Devicetree Binarys

Symlink Description
fsl-ls1028a-mbls1028a.dtb default device tree blob for TQMLS1028A on MBLS1028A

RootFS Images

Symlink File
tq-image-generic-tqmls1028a-mbls1028a.ext4 tq-image-generic-tqmls1028a-mbls1028a-<build_timestamp>.rootfs.ext4
tq-image-generic-tqmls1028a-mbls1028a.tar.gz tq-image-generic-tqmls1028a-mbls1028a-<build_timestamp>.rootfs.tar.gz

Target Machine: tqmls1028a-mba1028a-ind (BSP revision ≤ 0106)

System Image

Boot device Symlink File
SD Card/eMMC tq-image-generic-tqmls1028a-mbls1028a-ind.wic tq-image-generic-tqmls1028a-mbls1028a-ind-<build_timestamp>.rootfs.wic

Bootstream (Bootloader) Binary

Boot Device Symlink File
SD Card/eMMC u-boot.bin u-boot-tfa-2019.10-r0.bin

Linux Kernel Binary

Symlink File
Image.gz Image.gz--5.4-r0-tqmls1028a-mbls1028a-ind-<build_timestamp>.bin

Devicetree Binarys

Symlink Description
fsl-ls1028a-mbls1028a-ind.dtb default device tree blob for TQMLS1028A on MBLS1028A

RootFS Images

Symlink File
tq-image-generic-tqmls1028a-mbls1028a-ind.ext4 tq-image-generic-tqmls1028a-mbls1028a-ind-<build_timestamp>.rootfs.ext4
tq-image-generic-tqmls1028a-mbls1028a-ind.tar.gz tq-image-generic-tqmls1028a-mbls1028a-ind-<build_timestamp>.rootfs.tar.gz

Yocto specific command Update eMMC

uboot command to start netboot

=> run netboot
1)
i.e. value for MACHINE variable