~~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 ^ ^ | 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 ^ ::: ^ | 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 ^ ^ ^ 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 ===== ^ 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.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