~~NOCACHE~~
====== Entry Page ======
== Third-Party Add-Ons ==
* [[:en:third-party:ittia:db-sql|ITTIA DB SQL]]
===== Board Support Packages =====
* [[.linux:yocto:overview| Yocto Linux BSP Documentation]]
* [[.linux:openil:overview| OpenIL Linux BSP Documentation]]
===== Product URL List =====
[[https://www.tq-group.com/en/products/tq-embedded/qoriq-layerscape/tqmls1028a/|TQ product page TQMLS1028a]]\\
===== Starterkit =====
* [[.:mbls1028a:dip_switches| MBLS1028A DIP switch settings]]
====== 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 bus ^ TQMLS1028a ^^^^^^^
^ I2C1 | System Controller\\ 0x11 | Tempsensor\\ 0x18 | Manufacturer EEPROM Software Protection\\ 0x30 | Tempsensor\\ 0x4c | Manufacturer EEPROM\\ 0x50 | RTC\\ 0x51 | EEPROM\\ 0x57 ^
^ 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 |||
^ 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 =====
^ Buildsystem ^^^^ BSP Revision ^^^^^^^^^^ ^
| OpenIL |||| • | | | | | | | | | | |
| Yocto |||| | • | • | • | • | • | • | • | • | • | • | ::: |
^ TQ Product ^ Chip ^ Interface ^ Function ^ ++0003| only OpenIL++ ^ 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 |
^ Boot device ^ BSP Revision ^^^^^^^^^^ Remarks ^
^ ::: ^ 0003 ^ 0011 ^ 0102 ^ 0103 ^ 0104 ^ 0105 ^ 0106 ^ 0107 ^ 0108 ^ 0109 ^ 0110 ^ ::: ^
| eMMC / SD | • | • | • | • | • | • | • | • | • | • | • | |
| QSPI NOR-Flash | • | • | • | • | • | • | • | • | • | • | • | |
===== Kernel =====
===== Operating System =====
^ 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 1920x1080 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-/images//
Bootloader images:
Linux images:
Device tree blobs:
Rootfs images:
Firmware images:
===== OpenIL Changelog =====
++++ 0003|
*initial release
++++
===== DevHost =====
==== Build BSP ====
===== Compilation =====
==== BSP Rev.0100 (and later) ====
==== Adapt BSP ====
===== OpenIL Deployment =====
===== Yocto BSP Version Matrix =====
Please visit our [[https://github.com/tq-systems/|Github]] for the latest updates and BSP releases.
^ BSP Revision ^ Yocto Project / Poky Release ^ ++meta-tq release|\\ [[https://github.com/tq-systems/meta-tq]]++ ^ Target machine((i.e. value for [[https://www.yoctoproject.org/docs/2.4.4/ref-manual/ref-manual.html#var-MACHINE|MACHINE]] variable)) ^ U-Boot ^ Linux Kernel ^
| [[https://github.com/tq-systems/ci-meta-tq/releases/tag/kirkstone.TQMLS1028A.BSP.SW.0110|0110]] | 4.0.18 - Kirkstone | [[https://github.com/tq-systems/meta-tq/tree/kirkstone|kirkstone]] | tqmls1028a-mbls1028a\\ tqmls1028a-mbls1028a-ind | [[https://github.com/tq-systems/u-boot-tqmaxx/releases/tag/kirkstone.TQMLS1028A.BSP.SW.0110|u-boot-2019.10-LSDK-20.04 ]] | [[https://github.com/tq-systems/linux-tqmaxx/tree/kirkstone.TQMLS1028A.BSP.SW.0110|lf-5.15.5-1.0.0]]\\ [[https://github.com/tq-systems/linux-tqmaxx/releases/tag/zeus.TQMLS1028A.BSP.SW.linux-rt-lsdk-tq.0105|LSDK-20.12-V5.4-RT]] |
| [[https://github.com/tq-systems/ci-meta-tq/releases/tag/kirkstone.TQMLS1028A.BSP.SW.0109|0109]] | 4.0.11 - Kirkstone | [[https://github.com/tq-systems/meta-tq/tree/kirkstone|kirkstone]] | tqmls1028a-mbls1028a\\ tqmls1028a-mbls1028a-ind | [[https://github.com/tq-systems/u-boot-tqmaxx/releases/tag/kirkstone.TQMLS1028A.BSP.SW.0109|u-boot-2019.10-LSDK-20.04 ]] | [[https://github.com/tq-systems/linux-tqmaxx/tree/kirkstone.TQMLS1028A.BSP.SW.0109|lf-5.15.5-1.0.0]]\\ [[https://github.com/tq-systems/linux-tqmaxx/releases/tag/zeus.TQMLS1028A.BSP.SW.linux-rt-lsdk-tq.0105|LSDK-20.12-V5.4-RT]] |
| [[https://github.com/tq-systems/ci-meta-tq/releases/tag/hardknott.TQMLS1028A.BSP.SW.0108|0108]] | 3.3.3 - Hardknott | [[https://github.com/tq-systems/meta-tq/tree/hardknott|hardkott]] | tqmls1028a-mbls1028a\\ tqmls1028a-mbls1028a-ind | [[https://github.com/tq-systems/u-boot-tqmaxx/releases/tag/hardknott.TQMLS1028A.BSP.SW.0108|u-boot-2019.10-LSDK-20.04 ]] | [[https://github.com/tq-systems/linux-tqmaxx/tree/hardknott.TQMLS1028A.BSP.SW.0108|fslc-5.4-1.0.0-imx]]\\ [[|LSDK-20.12-V5.4-RT]]\\ [[https://github.com/tq-systems/linux-tqmaxx/tree/zeus.TQMLS1028A.BSP.SW.linux-rt-lsdk-tq-5.10.0106|lf-5.10.y-rt]] |
| [[https://github.com/tq-systems/ci-meta-tq/releases/tag/hardknott.TQMLS1028A.BSP.SW.0107|0107]] | 3.3.3 - Hardknott | [[https://github.com/tq-systems/meta-tq/tree/hardknott|hardkott]] | tqmls1028a-mbls1028a\\ tqmls1028a-mbls1028a-ind | [[https://github.com/tq-systems/u-boot-tqmaxx/releases/tag/hardknott.TQMLS1028A.BSP.SW.0107|u-boot-2019.10-LSDK-20.04 ]] | [[https://github.com/tq-systems/linux-tqmaxx/tree/hardknott.TQMLS1028A.BSP.SW.0107|fslc-5.4-1.0.0-imx]]\\ [[|LSDK-20.12-V5.4-RT]]\\ [[https://github.com/tq-systems/linux-tqmaxx/tree/zeus.TQMLS1028A.BSP.SW.linux-rt-lsdk-tq-5.10.0106|lf-5.10.y-rt]] |
| [[https://github.com/tq-systems/ci-meta-tq/tree/zeus.TQMLS1028A.BSP.SW.0106|0106]] | 3.0.3 - Zeus | [[https://github.com/tq-systems/meta-tq/tree/zeus-tqmls1028a|zeus]] | tqmls1028a-mbls1028a\\ tqmls1028a-mbls1028a-ind | [[https://github.com/tq-systems/u-boot-tqmaxx/releases/tag/zeus.TQMLS1028A.BSP.SW.0106|u-boot-2019.10-LSDK-20.04 ]] | [[https://github.com/tq-systems/linux-tqmaxx/releases/tag/zeus.TQMLS1028A.BSP.SW.linux-imx-tq.0106|fslc-5.4-1.0.0-imx]]\\ [[https://github.com/tq-systems/linux-tqmaxx/tree/zeus.TQMLS1028A.BSP.SW.linux-rt-lsdk-tq-5.4.0106|LSDK-20.12-V5.4-RT]]\\ [[https://github.com/tq-systems/linux-tqmaxx/tree/zeus.TQMLS1028A.BSP.SW.linux-rt-lsdk-tq-5.10.0106|lf-5.10.y-rt]] |
| [[https://github.com/tq-systems/ci-meta-tq/tree/zeus.TQMLS1028A.BSP.SW.0105|0105]] | 3.0.3 - Zeus | [[https://github.com/tq-systems/meta-tq/tree/zeus-tqmls1028a|zeus]] | tqmls1028a-mbls1028a\\ tqmls1028a-mbls1028a-ind | [[https://github.com/tq-systems/u-boot-tqmaxx/releases/tag/zeus.TQMLS1028A.BSP.SW.0105|u-boot-2019.10-LSDK-20.04 ]] | [[https://github.com/tq-systems/linux-tqmaxx/releases/tag/zeus.TQMLS1028A.BSP.SW.linux-imx-tq.0105|fslc-5.4-1.0.0-imx]]\\ [[https://github.com/tq-systems/linux-tqmaxx/releases/tag/zeus.TQMLS1028A.BSP.SW.linux-rt-lsdk-tq.0105|LSDK-20.12-V5.4-RT]] |
| [[https://github.com/tq-systems/ci-meta-tq/tree/zeus.TQMLS1028A.BSP.SW.0104|0104]] | 3.0.3 - Zeus | [[https://github.com/tq-systems/meta-tq/tree/zeus-tqmls1028a|zeus]] | tqmls1028a-mbls1028a\\ tqmls1028a-mbls1028a-ind | [[https://github.com/tq-systems/u-boot-tqmaxx/tree/e087a79844c0da717aa98a2fa9427292447fee0e|u-boot-2019.10-LSDK-20.04 ]] | [[https://github.com/tq-systems/linux-tqmaxx/tree/2b11415c757089214777f8f5198282e154beff8f|fslc-5.4-1.0.0-imx]]\\ [[https://github.com/tq-systems/linux-tqmaxx/tree/ae195e3b32c3527d062d7c5ddb957819ffb92649|LSDK-20.12-V5.4-RT]] |
| [[https://github.com/tq-systems/ci-meta-tq/tree/zeus.TQMLS1028A.BSP.SW.0103|0103]] | 3.0.3 - Zeus | [[https://github.com/tq-systems/meta-tq/tree/zeus-tqmls1028a|zeus]] | tqmls1028a-mbls1028a\\ tqmls1028a-mbls1028a-ind | [[https://github.com/tq-systems/u-boot-tqmaxx/releases/tag/zeus.TQMLS1028A.BSP.SW.0103|u-boot-2019.10-LSDK-20.04 ]] | [[https://github.com/tq-systems/linux-tqmaxx/releases/tag/zeus.TQMLS1028A.BSP.SW.linux-imx-tq.0103|fslc-5.4-1.0.0-imx"]] |
| [[https://github.com/tq-systems/ci-meta-tq/tree/zeus.TQMLS1028A.BSP.SW.0102|0102]] | 3.0.3 - Zeus | [[https://github.com/tq-systems/meta-tq/tree/zeus-tqmls1028a|zeus]] | tqmls1028a-mbls1028a\\ tqmls1028a-mbls1028a-ind | [[https://github.com/tq-systems/u-boot-tqmaxx/releases/tag/zeus.TQMLS1028A.BSP.SW.0102|u-boot-2019.10-LSDK-20.04 ]] | [[https://github.com/tq-systems/linux-tqmaxx/releases/tag/zeus.TQMLS1028A.BSP.SW.linux-imx-tq.0102|fslc-5.4-1.0.0-imx"]] |
| [[https://github.com/tq-systems/ci-meta-tq/tree/zeus.MBLS1028A.BSP.SW.0011|0011]] | 3.0.3 - Zeus | [[https://github.com/tq-systems/meta-tq/tree/zeus-tqmls1028a|zeus]] | tqmls1028a-mbls1028a\\ tqmls1028a-mbls1028a-emmc\\ tqmls1028a-mbls1028a-ind\\ tqmls1028a-mbls1028a-ind-emmc | [[https://github.com/tq-systems/u-boot-tqmaxx/releases/tag/zeus.TQMLS1028A.BSP.SW.0011|2018.03]] | [[https://github.com/tq-systems/linux-tqmaxx/releases/tag/zeus.TQMLS1028A.BSP.SW.0011|linux-v5.4-LSDK-20.04]] |
{{section>..:..:general_information:yocto:tips#bsp_release_auto_notification&noheader}}
===== Yocto Changelog =====
* Update documentation
**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
**BSP**
* new kernel linux-rt-lsdk-tq-5.10
* perf: backport from Yocto Dunfell to fix build issues with newer kernels
**BSP**
* Use correct manufacturer EEPROM address
**BSP**
* Added new kernel linux-rt-lsdk-tq-5.4 with PREEMPT_RT support
**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.
**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
* Initial BSP Release
===== Yocto Deployment =====
==== Device assignment ====
__Device assignment:__\\
//mmcdev 0// = SD Card\\
//mmcdev 1// = eMMC\\
===== Yocto Images =====
** System Image **
^ Boot device ^ Symlink ^ File ^
^ SD Card/eMMC | tq-image-generic-debug-tqmls1028a-mbls1028a.wic | tq-image-generic-debug-tqmls1028a-mbls1028a-.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-.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-.rootfs.ext4 |
| tq-image-generic-debug-tqmls1028a-mbls1028a.tar.gz | tq-image-generic-debug-tqmls1028a-mbls1028a-.rootfs.tar.gz |
** System Image **
^ Boot device ^ Symlink ^ File ^
^ SD Card/eMMC | tq-image-small-debug-tqmls1028a-mbls1028a.wic | tq-image-small-debug-tqmls1028a-mbls1028a-.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-.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-.rootfs.ext4 |
| tq-image-small-debug-tqmls1028a-mbls1028a.tar.gz | tq-image-small-debug-tqmls1028a-mbls1028a-.rootfs.tar.gz |
** System Image **
^ Boot device ^ Symlink ^ File ^
^ SD Card/eMMC | tq-image-generic-tqmls1028a-mbls1028a.wic | tq-image-generic-tqmls1028a-mbls1028a-.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-.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-.rootfs.ext4 |
| tq-image-generic-tqmls1028a-mbls1028a.tar.gz | tq-image-generic-tqmls1028a-mbls1028a-.rootfs.tar.gz |
** System Image **
^ Boot device ^ Symlink ^ File ^
^ SD Card/eMMC | tq-image-generic-tqmls1028a-mbls1028a-ind.wic | tq-image-generic-tqmls1028a-mbls1028a-ind-.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-.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-.rootfs.ext4 |
| tq-image-generic-tqmls1028a-mbls1028a-ind.tar.gz | tq-image-generic-tqmls1028a-mbls1028a-ind-.rootfs.tar.gz |
==== Yocto specific command Update eMMC ====
==== uboot command to start netboot ====
=> run netboot