~~NOCACHE~~
====== Entry Page ======
== Third-Party Add-Ons ==
   * [[:en:third-party:ittia:db-sql|ITTIA DB SQL]]
   * [[https://www.nxp.com/design/software/development-software/vortiqa-software-for-networking/vortiqa-application-solutions-kits/layerscape-1043a-multicore-communications-processor-broadband-home-router-application-solutions-kit:QORIQ-LS1043A-BHR-ASK|NXP LS1043A Broadband Home Router Application Solutions Kit]]
   * [[https://www.nxp.com/design/software/development-software/vortiqa-software-for-networking/vortiqa-application-solutions-kits/layerscape-1046a-multicore-communications-processor-broadband-home-router-application-solutions-kit:QORIQ-LS1046A-BHR-ASK|NXP LS1046A Broadband Home Router Application Solutions Kit]]



<WRAP hide>
   * [[:en:third-party:systemcorp:iec61850|SystemCORP IEC 61850]]
   * [[:en:third-party:netmodule:iec62439|NetModule IEC 62439]]
</WRAP>

===== Board Support Packages =====
  * [[.:linux:yocto:overview| Yocto Linux BSP Documentation]]
  * [[.:linux:openwrt:overview| OpenWrt Linux BSP Documentation]]
===== Product URL list =====

[[https://www.tq-group.com/en/products/tq-embedded/qoriq-layerscape/tqmls1043a|TQ product page TQMLS1043a]]\\  
[[https://www.tq-group.com/en/products/tq-embedded/qoriq-layerscape/tqmls1046a|TQ product page TQMLS1046a]]\\ 
[[https://www.tq-group.com/en/products/tq-embedded/qoriq-layerscape/tqmls1088a|TQ product page TQMLS1088a]]

===== Starterkit =====

  * [[.:mbls10xxa:dip_switches|MBLS10xxA DIP switch settings]]
  * [[.:mbls10xxa:ethernet|MBLS10xxA Ethernet interface assignment]]
  * [[.:mbls10xxa:serdes|MBLS10xxA SerDes protocols]]
<WRAP hide>
  * [[.:mbls10xxa:connectors|MBLS10xxA connectors]]
  * [[..:display-kits|Display kits]]
</WRAP>

====== Hardware ======
===== Onboard I2C devices =====
<panel type="primary" title="TQMLS10xxA / MBLS10xxA" no-body="true">
^ I2C bus  ^  TQMLS10xxA  ^^^^^
^ I2C1  |  0x18 \\ Tempsensor  |  0x30 \\  EEPROM software protection  |  0x50 \\  EEPROM  |  0x51\\  RTC  |  0x57\\  EEPROM  | 



^ I2C bus  ^  MBLS10xxA  ^^^^
^ I2C4  |  0x70\\  I2C Multiplexer \\ connects I2C4 to either I2C0, I2C1, I2C2 or I2C3 \\  (only one at a time)  |||| 
^ I2C4 > I2C0 |  0x44\\  USB Hub  |  0x20\\  I2C GPIO Port expander  |  0x21\\  I2C GPIO Port expander  |  0x22\\  I2C GPIO Port expander  |     
^ I2C4 > I2C1  |  0x34\\  Clock Generator 100MHz  |  0x6E\\  Clock Generator 125MHz  |  0x19\\  Retimer 1  |  0x18\\  Retimer 2  |
^ I2C4 > I2C2  |  Connected to SFP+ bays and connector X18  ||||  
^ I2C4 > I2C3  |  Connected to X18  ||||
</panel>
\\

====== Hardware Issues ======




====== Linux BSP ======
===== U-Boot =====
==== Supported features ====




==== Supported boot devices ====
<panel type="info" title="Supported boot devices" no-body="true">
^  Boot device  ^  Supported  ^  Remark  ^
|  eMMC  |  •  |  TQMLS1088 only  |
|  SD Card  |  •  |  |
|  QSPI NOR  |  •  |  |
</panel>




===== Kernel =====
===== Operating System =====

<panel type="primary" title="Linux" subtitle="Supported Features" no-body="true">
^ Feature  ^^^^ BSP Revision  ^^^^^^ Remarks  ^   
^ TQ Product  ^ Chip  ^ Interface  ^ Function  ^  0003  ^  0100  ^  0101  ^  0102  ^  0103  ^  0106  ^ ::: ^
|  TQMLS10xxA  | LS10xxA  | ENET1 | RGMII |  •  |  •  |  •  |  •  |  •  |  •  |  |
| :::  | LS10xxA  | ENET2 | RGMII |  •  |  •  |  •  |  •  |  •  |  •  |  |
| :::  | LS10xxA  | eSDHC  | SD Card |  •  |  •  |  •  |  •  |  •  |  •  | Mutually exclusive  |
| :::  | LS10xxA  | :::  | eMMC |  •  |  •  |  •  |  •  |  •  |  •  | :::  |
| :::  | LS10xxA  | eSPI  | Bus access  |  •  |  •  |  •  |  •  |  •  |  •  |   |
| :::  | LS10xxA  | I2C1  | Bus access  |  •  |  •  |  •  |  •  |  •  |  •  |   |
| :::  | LS10xxA  | I2C4  | Bus access  |  •  |  •  |  •  |  •  |  •  |  •  |   |  
| :::  | LS10xxA  | IFC  |  |  •  |  •  |  •  |  •  |  •  |  •  |  |
| :::  | LS10xxA  | SerDes1  |  |  •  |  •  |  •  |  •  |  •  |  •  |  |
| :::  | LS10xxA  | SerDes2((not available on LS1043))  |  |  •  |  •  |  •  |  •  |  •  |  •  |  |
| :::  | LS10xxA  | :::  | SATA  |  •  |  •  |  •  |  •  |  •  |  •  | X9  |
| :::  | LS10xxa  | :::  | miniPCIe |  •  |  •  |  •  |  •  |  •  |  •  | X7  | 
| :::  | LS10xxA  | UART2  | TTL  |  •  |  •  |  •  |  •  |  •  |  •  | Default console  |
| :::  | LS10xxA  | USB1  | TUSB8041  |  •  |  •  |  •  |  •  |  •  |  •  |  |
| :::  | LS10xxA  | USB2  | OTG |  •  |  •  |  •  |  •  |  •  |  •  | X35  |
| :::  | LS10xxA  | USB3  | USB Type C |  •  |  •  |  •  |  •  |  •  |  •  | X16  |
| MBLS10xxA  | PCA9555PW  | GPIO  | Digital Input |  •  |  •  |  •  |  •  |  •  |  •  | 2 x Button (S3, S4)  |
| :::  | PCA9544ABS  | I2C  |  I2C Multiplexer  |  •  |  •  |  •  |  •  |  •  |  •  |  |  
| :::  | PCA9544ABS  | I2C  |  I2C0  |  •  |  •  |  •  |  •  |  •  |  •  |   |  
| :::  | PCA9544ABS  | I2C  |  I2C1  |  •  |  •  |  •  |  •  |  •  |  •  |  |  
| :::  | PCA9544ABS  | I2C  |  I2C2  |  •  |  •  |  •  |  •  |  •  |  •  |  |
| :::  | PCA9544ABS  | I2C  |  I2C3  |  •  |  •  |  •  |  •  |  •  |  •  |   | 
| :::  | TUSB8041 | USB1  | Host USB3.0 |  •  |  •  |  •  |  •  |  •  |  •  | X15A  |
| :::  | :::  | USB2  | Host USB3.0 |  •  |  •  |  •  |  •  |  •  |  •  | X15B  |
| :::  | :::  | USB3  | Host USB2.0 |  •  |  •  |  •  |  •  |  •  |  •  | X19  |
| :::  | :::  | USB4  | Host USB2.0 |  •  |  •  |  •  |  •  |  •  |  •  | X6  |
</panel>









===== Yocto BSP Version Matrix =====
<panel type="primary" title="BSP Version Matrix" no-body="true">
^  BSP Revision  ^  ++meta-tq release|\\ [[https://github.com/tq-systems/meta-tq]]++  ^  Yocto Project / Poky Release  ^  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/meta-tq/releases/tag/kirkstone.TQMLS10xxA.BSP.SW.0106|0106]]  |  [[https://github.com/tq-systems/meta-tq/tree/kirkstone|kirkstone]]  |   4.0.13 - Kirkstone  |  ++tqmls1043a-mbls10xxa | TQMLS1043a with 1GB and 2GB RAM / MBLS10xxa REV.020x  ++\\  ++tqmls1046a-mbls10xxa | TQMLS1046a with 2GB and 8GB RAM / MBLS102xa REV.020x  ++ \\  ++tqmls1088a-mbls10xxa | TQMLS1088a with 2GB RAM / MBLS10xxa REV.020x  ++  |   [[https://github.com/tq-systems/u-boot-tqmaxx/releases/tag/kirkstone.TQMLS10xxA.BSP.SW.0106|lf-5.15.71-2.2.0 (v2022.04)]]  |  [[https://github.com/tq-systems/linux-tqmaxx/releases/tag/kirkstone.TQMLS10xxA.BSP.SW.0106|linux-6.1.y]]  |
|  [[https://github.com/tq-systems/meta-tq/releases/tag/zeus.TQMLS10xxA.BSP.SW.0103|0103]]  |  [[https://github.com/tq-systems/meta-tq/tree/zeus|zeus]]  |   3.0.4 - Zeus  |  ++tqmls1043a-mbls10xxa | TQMLS1043a REV.020x / MBLS10xxa REV.020x  ++\\  ++tqmls1043a_2g-mbls10xxa|  TQMLS1043a REV.020x with 2GB RAM / MBLS10xxa REV.020x  ++  \\  ++tqmls1046a-mbls10xxa | TQMLS1046a REV.020x / MBLS102xa REV.020x  ++ \\  ++tqmls1046a_8g-mbls10xxa | TQMLS1046a REV.020x with 8GB RAM / MBLS10xxa REV.020x  ++ \\    ++tqmls1088a-mbls10xxa | TQMLS1088a REV.020x / MBLS10xxa REV.020x  ++  |  v2018.07  |  ++ TQMLS1043A / 1046A | 5.4.87 Mainline ++\\  ++ TQMLS1088A | 5.4.47 - NXP LSDK 20.04  ++  |
|  [[https://github.com/tq-systems/meta-tq/releases/tag/warrior.TQMLS10xx.BSP.SW.0102|0102]]  |  [[https://github.com/tq-systems/meta-tq/tree/warrior|warrior]]  |   2.7.3 - Warrior  |  ++tqmls1043a-mbls10xxa | TQMLS1043a REV.020x / MBLS10xxa REV.020x  ++\\  ++tqmls1043a_2g-mbls10xxa|  TQMLS1043a REV.020x with 2GB RAM / MBLS10xxa REV.020x  ++  \\  ++tqmls1046a-mbls10xxa | TQMLS1046a REV.020x / MBLS102xa REV.020x  ++ \\  ++tqmls1046a_8g-mbls10xxa | TQMLS1046a REV.020x with 8GB RAM / MBLS10xxa REV.020x  ++ \\    ++tqmls1088a-mbls10xxa | TQMLS1088a REV.020x / MBLS10xxa REV.020x  ++  |  v2018.07  |  ++ TQMLS1043A / 1046A | 4.19 Mainline ++\\  ++ TQMLS1088A | 4.19.46 - NXP LSDK 19.06  ++  |
|    [[https://github.com/tq-systems/meta-tq/releases/tag/warrior.TQMLS10xx.BSP.SW.0101|0101]]  |  [[https://github.com/tq-systems/meta-tq/tree/warrior|warrior]]  |   2.7.1 - Warrior  |  ++tqmls1043a-mbls10xxa | TQMLS1043a REV.020x / MBLS10xxa REV.020x  ++\\  ++tqmls1043a_2g-mbls10xxa|  TQMLS1043a REV.020x with 2GB RAM / MBLS10xxa REV.020x  ++  \\  ++tqmls1046a-mbls10xxa | TQMLS1046a REV.020x / MBLS102xa REV.020x  ++ \\  ++tqmls1046a_8g-mbls10xxa | TQMLS1046a REV.020x with 8GB RAM / MBLS10xxa REV.020x  ++ \\    ++tqmls1088a-mbls10xxa | TQMLS1088a REV.020x / MBLS10xxa REV.020x  ++  |  v2018.07  |  ++ TQMLS1043A / 1046A | 4.19 Mainline ++\\  ++ TQMLS1088A | 4.19.46 - NXP LSDK 19.06  ++  |  
|    [[https://github.com/tq-systems/meta-tq/releases/tag/warrior.TQMLS10xx.BSP.SW.0100|0100]]  |  [[https://github.com/tq-systems/meta-tq/tree/warrior|warrior]]  |   2.7.1 - Warrior  |  ++tqmls1043a-mbls10xxa | TQMLS1043a REV.020x / MBLS10xxa REV.020x  ++\\  ++tqmls1046a-mbls10xxa | TQMLS1046a REV.020x / MBLS102xa REV.020x  ++ \\  ++tqmls1046a_8g-mbls10xxa | TQMLS1046a REV.020x with 8GB RAM / MBLS10xxa REV.020x  ++ \\    ++tqmls1088a-mbls10xxa | TQMLS1088a REV.020x / MBLS10xxa REV.020x  ++  |  v2018.07  |  ++ TQMLS1043A / 1046A | 4.19 Mainline ++\\  ++ TQMLS1088A | 4.19.46 - NXP LSDK 19.06  ++  |  
|  [[https://github.com/tq-systems/meta-tq/releases/tag/warrior.TQMLS1046A.BSP.SW.0003|0003]]  |  [[https://github.com/tq-systems/meta-tq/tree/warrior|warrior]]  |  2.7.1 - Warrior  |    ++tqmls1043a-mbls10xxa | TQMLS1043a REV.020x / MBLS10xxa REV.020x  ++\\  ++tqmls1046a-mbls10xxa | TQMLS1046a REV.020x / MBLS10xxa REV.020x  ++  |  v2018.07  |  4.19  |
|  [[https://github.com/tq-systems/meta-tq/releases/tag/rocko.TQMLS1046A.BSP.SW.0002|0002]]  |    [[https://github.com/tq-systems/meta-tq/tree/rocko|rocko]]  |  2.4.4 - Rocko  |  ++tqmls1046a-mbls10xxa | TQMLS1046a REV.020x / MBLS10xxa REV.020x  ++  |  v2018.07  |  4.19  |     
</panel>

 

===== Yocto Changelog =====
<panel type="info" title="BSP Version History" no-body="true">
<accordion collapsed="true">
<panel title="Rev.0103">
**BSP**
  * Update to Yocto Zeus

**U-Boot** 
  * Add XFI Retimer and serdes initialization
  * Add mmc subcommand to query max enhanced partition size

**Linux**
  * TQMLS1043A/TQMLS1046A update to Linux Mainline - 5.4.87 
  * TQMLS1088A update to Linux LSDK 20.04 - 5.4.47
</panel>
<panel title="Rev.0102">
**U-Boot** 
  * Update DDR4-RAM Configuration for new Revision
</panel>
<panel title="Rev.0101">
** BSP **
  * add support for TQMLS1043a with 2GB RAM

** U-Boot **
  * TQMLS1043: fixed SF_DEFAULT_BUS 

** Linux **
  * add EDAC support
  * fix error message on reboot
</panel>

<panel title="Rev.0100">
** BSP **
  * add support for TQMLS1088
  * add support for TQMLS1046 with 8 GB RAM
</panel>

<panel title="Rev.0003">
** BSP **
  * update to Yocto Warrior
  * added support for TQMLS1043
</panel>

<panel title="Rev.0002">
  * initial BSP release
</panel>
</accordion>
</panel>
===== OpenWrt BSP Version Matrix =====
^  BSP Revision  ^  [[https://github.com/tq-systems/openwrt/tree/OpenWrt.TQMLS10xx.BSP.SW.0001|0001]]  ^
^  OpenWrt Release  |  [[https://git.openwrt.org/?p=openwrt/openwrt.git;a=commit;h=fcd14017007db35a4a41ef4fd6b69a5e02edbd5e|Master branch]]   |
^  Target Devices  |  tqmls1043a-mbls10xxa\\  tqmls1043a-mbls10xxa-2g\\  tqmls1046a-mbls10xxa\\  tqmls1046a-mbls10xxa-8g\\    |    
^  U-Boot  |  [[https://github.com/tq-systems/u-boot-tqmaxx/tree/TQMLS10xxA-u-boot-v2018.07|2018.07 + TQ patches]]  |
^  Linux  |  4.19.108 Mainline + [[https://github.com/tq-systems/openwrt/tree/TQMLS10xxA/target/linux/generic|OpenWrt patches]] + [[https://github.com/tq-systems/openwrt/tree/TQMLS10xxA/target/linux/tqmls/patches-4.19|TQ patches]]  |


===== OpenWrt Changelog =====

++++ 0001 |
  * initial BSP Release
++++

===== Yocto Images =====

<accordion collapsed="true">
<panel title="Target Machine: tqmls43a-mbls10xxa">

** System Image **

<grid>
<col sm="12">
^ Boot device  ^ Symlink   ^ File     ^
^ SD Card/eMMC  | tq-image-generic-tqmls1043a-mbls10xxa.wic  | tq-image-generic-tqmls1043a-mbls10xxa-<build_timestamp>.rootfs.wic  |
</col>
</grid>

** Bootstream (Bootloader) Binary**
<grid>
<col sm="12">
^ Boot Device  ^ Symlink  ^ File  ^
^ SD Card/eMMC  | u-boot.bin  | u-boot-esdhc-2018.07-r0.bin  |
</col>
</grid>

**Linux Kernel Binary**
<grid>
<col sm="12">
^ Symlink  ^ File  ^
| Image  | %%Image--5.4-r0-tqmls1043a-mbls10xxa-<build_timestamp>.bin%% |
</col>
</grid>

**Devicetree Binarys**
<grid>
<col sm="12">
^ Symlink  ^ Description  ^
| fsl-tqmls1043a-mbls10xxa.dtb  | default device tree blob for TQMLS1043a on MBLS10xxA  |
</col>
</grid>

**RootFS Images**
<grid>
<col sm="12">
^ Symlink  ^ File  ^
| tq-image-generic-tqmls1043a-mbls10xxa.ext4  | tq-image-generic-tqmls1043a-mbls10xxa-<build_timestamp>.rootfs.ext4  |
| tq-image-generic-tqmls1043a-mbls10xxa.tar.gz  | tq-image-generic-tqmls1043a-mbls10xxa-<build_timestamp>.rootfs.tar.gz  |
</col>
</grid>
</panel>



<panel title="Target Machine: tqmls1046a-mbls10xxa">

**Complete system image**
<grid>
<col sm="12">
^ Boot Device  ^ Symlink  ^ File  ^
^ SD Card/eMMC  | tq-image-generic-tqmls1046a-mbls10xxa.wic | tq-image-generic-tqmls1046a-mbls10xxa-<build_timestamp>.rootfs.wic  |
</col>
</grid>

**Bootstream (Bootloader) Binary**
<grid>
<col sm="12">
^ Boot Device  ^ Symlink  ^ File  ^
^ SD Card/eMMC  | u-boot.bin  | u-boot-esdhc-2018.07-r0.bin  |
</col>
</grid>

**Linux Kernel Binary**
<grid>
<col sm="12">
^ Symlink  ^ File  ^
| Image  | %%Image--5.4-r0-tqmls1046a-mbls10xxa-<build_timestamp>.bin%%  |
</col>
</grid>

**Devicetree Binarys**
<grid>
<col sm="12">
^  Symlink   ^  Description  ^
| fsl-tqmls1046a-mbls10xxa.dtb  | default device tree blob for TQMLS1046A on MBLS10xxA  |
</col>
</grid>

**RootFS Images**
<grid>
<col sm="12">
^  Symlink   ^  File     ^
| tq-image-generic-tqmls1046a-mbls10xxa.ext4  | tq-image-generic-tqmls1046a-mbls10xxa-<build_timestamp>.rootfs.ext4 |
| tq-image-generic-tqmls1046a-mbls10xxa.tar.gz  | tq-image-generic-tqmls1046a-mbls10xxa-<build_timestamp>.rootfs.tar.gz  |
</col>
</grid>
</panel>



<panel title="Target Machine: tqmls1088a-mbls10xxa">

**Complete system image**
<grid>
<col sm="12">
^ Boot Device  ^ Symlink  ^ File  ^
^ SD Card/eMMC  | tq-image-generic-tqmls1088a-mbls10xxa.wic | tq-image-generic-tqmls1088a-mbls10xxa-<build_timestamp>.rootfs.wic |
</col>
</grid>

**Bootstream (Bootloader) Binary**
<grid>
<col sm="12">
^ Boot Device  ^ Symlink  ^ File  ^
^ SD Card/eMMC  | u-boot.bin | u-boot-esdhc-2018.07-r0.bin |
</col>
</grid>

**Linux Kernel Binary**
<grid>
<col sm="12">
^ Symlink  ^ File  ^
| Image  | %%Image--5.4-r0-tqmls1088a-mbls10xxa-<build_timestamp>.bin%% |
</col>
</grid>

**Devicetree Binarys**
<grid>
<col sm="12">
^  Symlink   ^  Description  ^
| fsl-tqmls1088a-mbls10xxa.dtb | default device tree blob for TQMLS1088A on MBLS10xxA |
</col>
</grid>

**RootFS Images**
<grid>
<col sm="12">
^  Symlink   ^  File     ^
| tq-image-generic-tqmls1088a-mbls10xxa.ext4  |  tq-image-generic-tqmls1088a-mbls10xxa-<build_timestamp>.rootfs.ext4 |
| tq-image-generic-tqmls1088a-mbls10xxa.tar.gz  | tq-image-generic-tqmls1088a-mbls10xxa-<build_timestamp>.rootfs.tar.gz  |
</col>
</grid>
</panel>

</accordion>
===== Yocto Deployment =====

==== Device assignment ====
<WRAP round info 40%>__Device assignment:__\\
//mmcdev 0// = eMMC\\
//mmcdev 1// = SD Card\\
</WRAP>

==== Yocto specific command Update eMMC ==== 

==== uboot command to start netboot ====

<code>
=> run netboot
</code>