Entry Page

Third-Party Add-Ons

Hardware

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.

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

Supported Features
Buildsystem BSP Revision
OpenIL
Yocto
TQ Product Chip Interface Function 0003 0011 0102 0103 0104 0105 0106 0107 0108 0109
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
eMMC / SD
QSPI NOR-Flash

Linux

Supported Features
Buildsystem BSP Revision
OpenIL
Yocto
TQ Product Chip Interface Function(s) 0003 0011 0102 0103 0104 0105 0106 0107 0108 0109
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
BSP Revision OpenIL Release Hardware platform U-Boot Linux Kernel
0003 201904 mbls1028a 2018.03 4.14.47

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

Bootloader images:

Linux images:

Device tree blobs:

Rootfs images:

Firmware images:

0003

BSP Version Matrix

BSP Revision Yocto Project / Poky Release meta-tq release Target machine1) U-Boot Linux Kernel
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

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

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

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
=> run netboot

1)
i.e. value for MACHINE variable