~~NOCACHE~~
====== Entry Page ======
== Third-Party Add-Ons ==
   * [[:en:third-party:ittia:db-sql|ITTIA DB SQL]]
<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]]
  * [[.:pikeos:overview|PikeOS BSP Information]]

----

⠀⠀[[https://www.tq-group.com/en/products/tq-embedded/arm-architecture/tqma8Xx/#downloads |TQMa8XxP Bootloader Fix: ERR051393]]


===== Product URL list =====

[[https://www.tq-group.com/en/products/tq-embedded/arm-architecture/tqma8xx/|TQ product page TQMa8Xx]]\\  

===== Starterkit =====

  * [[.:mba8xx:dip_switches|  MBa8Xx DIP switch settings]]


====== Hardware ======

===== Debug Connection =====

The TQMa8Xx debug UART is connected via a FTDI USB-to-Serial converter to X13 (micro-USB) on the MBa8Xx. A micro-USB/USB-A cable is part of the STKa8MPxL accessory set. Depending on the host operating system, a driver may need to be installed.

===== Onboard I2C devices =====

<accordion>
<panel title="TQMa8Xx Rev.02xx / MBa8Xx Rev.02xx">
^ I2C bus  ^  TQMa8Xx  ^^^^^
^ I2C1  |  0x19\\ Temperature sensor  |  0x31\\ EEPROM\\  (software protection)  |  0x57\\  EEPROM  |  0x51\\  EEPROM  |  0x68\\ RTC  |

^ I2C bus  ^  MBa8Xx  ^^^^^^^^
^ I2C1  |  0x18\\ Audio codec  |  0x1C\\ Temperature sensor  |  0x2C\\ Display-Port bridge  |  0x34\\ EEPROM (software protection)  |  0x44\\  USB Hub  |  0x54\\ EEPROM  |  0x6A\\ PCIe clock generator  |  0x70\\ Port Expander  |

</panel>

<panel title="TQMa8Xx Rev.01xx / MBa8Xx Rev.01xx">
^ I2C bus  ^  TQMa8Xx  ^^^^^
^ I2C1  |  0x19\\ Temperature sensor  |  0x31\\ Temperature sensor  |  0x50\\  EEPROM  |  0x51\\  EEPROM  |  0x68\\ RTC  |

^ I2C bus  ^  MBa8Xx  ^^^^^^^^
^ I2C1  |  0x18\\ Audio codec  |  0x1C\\ Temperature sensor  |  0x2C\\ Display-Port bridge  |  0x2D\\ USB-Hub  |  0x34\\ Temperature sensor  |  0x54\\ EEPROM  |  0x6A\\ PCIe clock generator  |  0x70\\ Port Expander  |
</panel>
</accordion>
====== Hardware Issues ======




====== Linux BSP ======
===== U-Boot =====
<panel type="primary" title="U-Boot">
^ Feature  ^^^^  TQMa8.BSP Revision  ^  Remarks  ^
^ TQ Product  ^ Chip   ^ Interface  ^ Function  ^  0081 - 0091  ^ ::: ^
| TQMa8Xx  | i.MX8X  | ENET0  | GbE  |  ✔  |
| :::  | i.MX8X  | ENET1  | GbE  |  ✔  |
| :::  | i.MX8X  | FlexSPI | QSPI NOR  |  ✔  |  | 
| :::  | i.MX8X  | Fuse  | |  ✔  |   |
| :::  | i.MX8X  | GPIO  | |  ✔  |   |
| :::  | i.MX8X  | I²C  | EEPROM, Temperature Sensors  |  ✔  |    |  
| :::  | i.MX8X  | UART1  | Debug Console  |  ✔  |  default console  |
| :::  | i.MX8X  | USB   | Host  |  ✔  |  
| :::  | i.MX8X  | uSDHC  | eMMC / SD-Card  |  ✔  |  SD card / eMMC  |
</panel>

<accordion collapsed="true">
<panel type="primary" title="U-Boot - Old Revisions">
^ Feature  ^^^^  BSP Revision  ^^^^^^^^^^^^^^^^^ Remarks  ^
^ TQ Product  ^ Chip   ^ Interface  ^ Function  ^  0001  ^  0002  ^  0005  ^  0006  ^  0007  ^  0009  ^  0016  ^  0017  ^  ((requires [[.:linux:yocto:overview#bsphardware_compatibility|TQMa8Xx / MBa8Xx REV.02xx]])) 0025  ^  ((requires [[.:linux:yocto:overview#bsphardware_compatibility|TQMa8Xx / MBa8Xx REV.02xx]])) 0028  ^  ((requires [[.:linux:yocto:overview#bsphardware_compatibility|TQMa8Xx / MBa8Xx REV.02xx]])) 0029  ^  ((requires [[.:linux:yocto:overview#bsphardware_compatibility|TQMa8Xx / MBa8Xx REV.02xx]])) 0030  ^  ((requires [[.:linux:yocto:overview#bsphardware_compatibility|TQMa8Xx / MBa8Xx REV.02xx]])) 0032  ^  ((requires [[.:linux:yocto:overview#bsphardware_compatibility|TQMa8Xx / MBa8Xx REV.02xx]])) 0033  ^  ((requires [[.:linux:yocto:overview#bsphardware_compatibility|TQMa8Xx / MBa8Xx REV.02xx]])) 0035  ^   ((requires [[.:linux:yocto:overview#bsphardware_compatibility|TQMa8Xx / MBa8Xx REV.02xx]])) 0036  ^  0055  ^ ::: ^
| TQMa8Xx  | i.MX8X  | ENET0  | GbE  |  ✔  |  ✔  |  ✔  |  ✔  |  ✔  |  ✔  |  ✔  |  ✔  |  ✔  |  ✔  |  ✔  |  ✔  |  ✔  |  ✔  |  ✔  |  ✔  |  ✔  |
| :::  | i.MX8X  | ENET1  | GbE  |  ✔  |  ✔  |  ✔  |  ✔  |  ✔  |  ✔  |  ✔  |  ✔  |  ✔  |  ✔  |  ✔  |  ✔  |  ✔  |  ✔  |  ✔  |  ✔  |  ✔  |
| :::  | i.MX8X  | FlexSPI | QSPI NOR  |  |  |  |  |  |  |  |  ✔  |  ✔  |  ✔  |  ✔  |  ✔  |  ✔  |  ✔  |  ✔  |  ✔  |  ✔  |  | 
| :::  | i.MX8X  | Fuse  |   |   |   |  ✔  |  ✔  |  ✔  |  ✔  |  ✔  |  ✔  |  ✔  |  ✔  |  ✔  |  ✔  |  ✔  |  ✔  |  ✔  |  ✔  |  ✔  |   |
| :::  | i.MX8X  | GPIO  |   | | | | | |  ✔  |  ✔  |  ✔  |  ✔  |  ✔  |  ✔  |  ✔  |  ✔  |  ✔  |  ✔  |  ✔  |  ✔  |   |
| :::  | i.MX8X  | I²C  | EEPROM, Temperature Sensors  |  ✔  |  ✔  |  ✔  |  ✔  |  ✔  |  ✔  |  ✔  |  ✔  |  ✔  |  ✔  |  ✔  |  ✔  |  ✔  |  ✔  |  ✔  |  ✔  |  ✔  |    |  
| :::  | i.MX8X  | UART1  | Debug Console  |  ✔  |  ✔  |  ✔  |  ✔  |  ✔  |  ✔  |  ✔  |  ✔  |  ✔  |  ✔  |  ✔  |  ✔  |  ✔  |  ✔  |  ✔  |  ✔  |  ✔  | default console  |
| :::  | i.MX8X  | USB   | Host  |  |  |  |  |  |  |  ✔  |  ✔  |  ✔  |  ✔  |  ✔  |  ✔  |  ✔  |  ✔  |  ✔  |  ✔  |  ✔  |  
| :::  | i.MX8X  | uSDHC  | eMMC / SD-Card  |  ✔  |  ✔  |  ✔  |  ✔  |  ✔  |  ✔  |  ✔  |  ✔  |  ✔  |  ✔  |  ✔  |  ✔  |  ✔  |  ✔  |  ✔  |  ✔  |  ✔  | SD card / eMMC  |
</panel>
</accordion>

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


===== Kernel =====
===== Operating System =====
<panel type="primary" title="Linux">
^ Feature  ^^^^  TQMa8.BSP Revision  ^  Remarks  ^
^ TQ Product  ^ Chip  ^ Interface  ^ Function  ^  0081 - 0091  ^ :::^ 
| TQMa8Xx  | i.MX8X  | Cortex M4  | Integrated Microcontroller  |  ✔  |   | 
| :::  | i.MX8X  | ENET1  | GbE  |  ✔  |   |    
| :::  | i.MX8X  | ENET2  | GbE  |  ✔  |   |
| :::  | i.MX8X  | FLEXCAN0  | CAN  |  ✔  |  CAN FD is not automatically configured due to a systemd limitation   |
| :::  | i.MX8X  | FLEXCAN1  | CAN  |  ✔  | :::  | 
| :::  | i.MX8X  | FlexSPI  | QSPI NOR Flash |  ✔  |   |     
| :::  | i.MX8X  | GPU  | Hardware Acceleration  |  ✔  |   |
| :::  | i.MX8X  | I²C1  | Bus Access |  ✔  |  [[./linux/yocto/overview#onboard_i2c_devices|See onboard I2C devices]]  | 
| :::  | i.MX8X  | MIPI DSI  | LVDS  |  ✔  |  Tested with Tianma TM070JVHG33 display  |
| :::  | i.MX8X  | LPSPI1  | Bus access  |  ✔  |   |
| :::  | i.MX8X  | LPSPI2  | Bus access  |  ✔  |   |
| :::  | i.MX8X  | LPSPI3  | Bus access  |  ✔  |   |
| :::  | i.MX8X  | LPUART1 | Console |  ✔  |   |
| :::  | i.MX8X  | LPUART3 | TTL |  ✔  |  available on MBa8xx connector\\  X4_45 RX\\  X4_47 TX  | 
| :::  | i.MX8X  | GPIO |  |  ✔  |
| :::  | i.MX8X  | PCIe | Host |  ✔  |  BSP revision ≤ 0017 requires MBa8xx ≥ Rev.0102, also see [[.:linux:yocto:known_issues#linux_kernel_does_not_start_with_sumotqma8bspsw0005_on_mba8xx_rev0101|Known Issues]]   |
| :::  | i.MX8X  | SAI  | TLV320AIC  |  ✔  |
| :::  | i.MX8X  | USB3 | TUSB8041I  |  ✔  |
| :::  | i.MX8X  | USB OTG1  | Host  |  ✔  |
| :::  | :::     | :::       | Device  |  ✔  |
| :::  | i.MX8X  | USB OTG2  | TUSB8041I |  ✔  |
| :::  | i.MX8X  | uSDHC  | uSDHC0 / eMMC\\  uSDHC1 / SD Card   |  ✔  |
| MBa8xx  | TLV320AIC  | Audio\\  Codec  | Headphone Out / Line Out  |  ✔  |
| :::  | :::  | ::: | Line In  |  ✔  |
| :::  | :::  | ::: | Microphone In  |  ✘  |
| :::  | TUSB8041I  | USB1  | Host USB 2.0  |  ✔  |  Available on X24 (MPCIe)  |
| :::  | TUSB8041I  | USB2  | Host USB 2.0  |  ✔  |  Available on X22 (LVDS)  | 
| :::  | TUSB8041I  | USB3  | Host USB 3.0  |  ✔  |  Available on X20  | 
| :::  | TUSB8041I  | USB4  | Host USB 3.0  |  ✔  |  Available on X20  |
</panel>

<accordion collapsed="true">
<panel type="primary" title="Linux - Old Revisions">
^ Feature  ^^^^ BSP Revision  ^^^^^^^^^^^^^^^^^ Remarks  ^
^ TQ Product  ^ Chip  ^ Interface  ^ Function  ^  0001  ^  0002   ^  0005  ^  0006  ^  0007  ^  0009  ^  0016  ^  0017  ^  ((requires [[.:linux:yocto:overview#bsphardware_compatibility|TQMa8Xx / MBa8Xx REV.02xx]])) 0025  ^  ((requires [[.:linux:yocto:overview#bsphardware_compatibility|TQMa8Xx / MBa8Xx REV.02xx]])) 0028  ^  ((requires [[.:linux:yocto:overview#bsphardware_compatibility|TQMa8Xx / MBa8Xx REV.02xx]])) 0029  ^  ((requires [[.:linux:yocto:overview#bsphardware_compatibility|TQMa8Xx / MBa8Xx REV.02xx]])) 0030  ^  ((requires [[.:linux:yocto:overview#bsphardware_compatibility|TQMa8Xx / MBa8Xx REV.02xx]])) 0032  ^  ((requires [[.:linux:yocto:overview#bsphardware_compatibility|TQMa8Xx / MBa8Xx REV.02xx]])) 0033  ^  ((requires [[.:linux:yocto:overview#bsphardware_compatibility|TQMa8Xx / MBa8Xx REV.02xx]])) 0035  ^  ((requires [[.:linux:yocto:overview#bsphardware_compatibility|TQMa8Xx / MBa8Xx REV.02xx]])) 0036  ^  0055  ^ :::^ 
| TQMa8Xx  | i.MX8X  | Cortex M4  | Integrated Microcontroller  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  ✔  |   | 
| :::  | i.MX8X  | ENET1  | GbE  |  ✔  |  ✔  |  ✔  |  ✔  |  ✔  |  ✔  |  ✔  |  ✔  |  ✔  |  ✔  |  ✔  |  ✔  |  ✔  |  ✔  |  ✔  |  ✔  |  ✔  |   |    
| :::  | i.MX8X  | ENET2  | GbE  |  ✔  |  ✔  |  ✔  |  ✔  |  ✔  |  ✔  |  ✔  |  ✔  |  ✔  |  ✔  |  ✔  |  ✔  |  ✔  |  ✔  |  ✔  |  ✔  |  ✔  |   |
| :::  | i.MX8X  | FLEXCAN0  | CAN  |  |  |  |  |  |  |  ✔  |  ✔  |  ✔  |  ✔  |  ✔  |  ✔  |  ✔  |  ✔  |  ✔  |  ✔  |  ✔  | CAN FD is not automatically configured due to a systemd limitation   |
| :::  | i.MX8X  | FLEXCAN1  | CAN  |  |  |  |  |  |  |  ✔  |  ✔  |  ✔  |  ✔  |  ✔  |  ✔  |  ✔  |  ✔  |  ✔  |  ✔  |  ✔  | :::  | 
| :::  | i.MX8X  | FlexSPI  | QSPI NOR Flash |  |  |  |  |  |  |  |  ✔  |  ✔  |  ✔  |  ✔  |  ✔  |  ✔  |  ✔  |  ✔  |  ✔  |  ✔  |   |     
| :::  | i.MX8X  | GPU  | Hardware Acceleration  |  |  |  |  |  |  ✔  |  ✔  |  ✔  |  ✔  |  ✔  |  ✔  |  ✔  |  ✔  |  ✔  |  ✔  |  ✔  |  ✔  |   |
| :::  | i.MX8X  | I²C1  | Bus Access |  ✔  |  ✔  |  ✔  |  ✔  |  ✔  |  ✔  |  ✔  |  ✔  |  ✔  |  ✔  |  ✔  |  ✔  |  ✔  |  ✔  |  ✔  |  ✔  |  ✔  | [[./linux/yocto/overview#onboard_i2c_devices|See onboard I2C devices]]  | 
| :::  | i.MX8X  | MIPI DSI  | LVDS  |  |  |  ✔  |  ✔  |  ✔  |  ✔  |  ✔  |  ✔  |  ✔  |  ✔  |  ✔  |  ✔  |  ✔  |  ✔  |  ✔  |  ✔  |  ✔  | Tested with Tianma TM070JVHG33 display |
| :::  | i.MX8X  | LPSPI1  | Bus access  |  |  |  |  |  |  |  |  ✔  |  ✔  |  ✔  |  ✔  |  ✔  |  ✔  |  ✔  |  ✔  |  ✔  |  ✔  |   |
| :::  | i.MX8X  | LPSPI2  | Bus access  |  |  |  |  |  |  |  |  ✔  |  ✔  |  ✔  |  ✔  |  ✔  |  ✔  |  ✔  |  ✔  |  ✔  |  ✔  |   |
| :::  | i.MX8X  | LPSPI3  | Bus access  |  |  |  |  |  |  |  |  ✔  |  ✔  |  ✔  |  ✔  |  ✔  |  ✔  |  ✔  |  ✔  |  ✔  |  ✔  |   |
| :::  | i.MX8X  | LPUART1 | Console |  ✔  |  ✔  |  ✔  |  ✔  |  ✔  |  ✔  |  ✔  |  ✔  |  ✔  |  ✔  |  ✔  |  ✔  |  ✔  |  ✔  |  ✔  |  ✔  |  ✔  |   |
| :::  | i.MX8X  | LPUART3 | TTL |  |  |  |  |  |  |  |  ✔  |  ✔  |  ✔  |  ✔  |  ✔  |  ✔  |  ✔  |  ✔  |  ✔  |  ✔  | available on MBa8xx connector\\  X4_45 RX\\  X4_47 TX  | 
| :::  | i.MX8X  | GPIO |  |  |  ✔  |  ✔  |  ✔  |  ✔  |  ✔  |  ✔  |  ✔  |  ✔  |  ✔  |  ✔  |  ✔  |  ✔  |  ✔  |  ✔  |  ✔  |  ✔  |
| :::  | i.MX8X  | PCIe | Host |  |  ✔  |  ✔  |  ✔  |  ✔  |  ✔  |  ✔  |  ✔  |  |  ✔  |  ✔  |  ✔  |  ✔  |  ✔  |  ✔  |  ✔  |  ✔  | BSP revision ≤ 0017 requires MBa8xx ≥ Rev.0102, also see [[.:linux:yocto:known_issues#linux_kernel_does_not_start_with_sumotqma8bspsw0005_on_mba8xx_rev0101|Known Issues]]   |
| :::  | i.MX8X  | SAI  | TLV320AIC  |  |  |  |  |  |  |  |  |  |  |  |  |    |  ✔  |  ✔  |  ✔  |  ✔  |
| :::  | i.MX8X  | USB3 | TUSB8041I  |  |  |  |  |  |  |  |  |  ✔  |  ✔  |  ✔  |  ✔  |
| :::  | i.MX8X  | USB OTG1  | Host  |  |  |  |  |  |  |  |  |  ✔  |  ✔  |  ✔  |  ✔  |
| :::  | :::     | :::       | Device  |  |  |  |  |  |  |  |  |  ✔  |  ✔  |  ✔  |  ✔  |
| :::  | i.MX8X  | USB OTG2  | TUSB8041I |  |  |  ✔  |  ✔  |  ✔  |  ✔  |  ✔  |  ✔  |  ✔  |  ✔  |  ✔  |  ✔  |
| :::  | i.MX8X  | uSDHC  | uSDHC0 / eMMC\\  uSDHC1 / SD Card   |  ✔  |  ✔  |  ✔  |  ✔  |  ✔  |  ✔  |  ✔  |  ✔  |  ✔  |  ✔  |  ✔  |  ✔  |  ✔  |  ✔  |  ✔  |  ✔  |  ✔  |
| MBa8xx  | TLV320AIC  | Audio\\  Codec  | Headphone Out / Line Out|  |  |  |  |  |  |  |  |  |  |  |  |    |  ✔  |  ✔  |  ✔  |  ✔  |
| :::  | :::  | ::: | Line In  |  |  |  |  |  |  |  |  |  |  |  |  |  |  ✔  |  ✔  |  ✔  |  ✔  |
| :::  | :::  | ::: | Microphone In  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |
| :::  | TUSB8041I  | USB1  | Host USB 2.0  |  |  |  ✔  |  ✔  |  ✔  |  ✔  |  ✔  |  ✔  |  ✔  |  ✔  |  ✔  |  ✔  |  ✔  |  ✔  |  ✔  |  ✔  |  ✔  | Available on X24 (MPCIe)  |
| :::  | TUSB8041I  | USB2  | Host USB 2.0  |  |  |  ✔  |  ✔  |  ✔  |  ✔  |  ✔  |  ✔  |  ✔  |  ✔  |  ✔  |  ✔  |  ✔  |  ✔  |  ✔  |  ✔  |  ✔  | Available on X22 (LVDS)  | 
| :::  | TUSB8041I  | USB3  | Host USB 3.0  |  |  |  ✔  |  ✔  |  ✔  |  ✔  |  ✔  |  ✔  |  ✔  |  ✔  |  ✔  |  ✔  |  ✔  |  ✔  |  ✔  |  ✔  |  ✔  | Available on X20  | 
| :::  | TUSB8041I  | USB4  | Host USB 3.0  |  |  |  ✔  |  ✔  |  ✔  |  ✔  |  ✔  |  ✔  |  ✔  |  ✔  |  ✔  |  ✔  |  ✔  |  ✔  |  ✔  |  ✔  |  ✔  | Available on X20  |
</panel>
</accordion>
===== FAQ =====
===== Yocto =====
===== Yocto BSP Version Matrix - Old Revisions =====
<accordion collapsed="true">
<panel type="primary" title="BSP Version Matrix - Old Revisions">
^  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/zeus.TQMa8Xx.BSP.SW.0055|0055]]  |  3.0 - Zeus  |  [[https://github.com/tq-systems/ci-meta-tq/tree/zeus-tqma8|zeus-tqma8]]  |  ++tqma8xqp-2gb-mba8xx|TQMa8QXP with 2 GB RAM (DDR3) on MBa8Xx++\\  ++tqma8xqp-1gb-mba8xx|TQMa8QXP with 1 GB RAM (DDR3) on MBa8Xx++\\  ++tqma8xdp-1gb-mba8xx|TQMa8XDP with 1GB RAM (DDR3) on MBa8Xx++\\  ++tqma8xqp4-mba8xx|TQMa8XQP4 with 2GB RAM (LPDDR4) on MBa8Xx++\\  ++tqma8xdp4-mba8xx|TQMa8XDP4 with 2GB RAM (LPDDR4) on MBa8Xx++  |   [[https://github.com/tq-systems/u-boot-tqmaxx/releases/tag/zeus.TQMa8Xx.BSP.SW.0055|v2020.04-imx-5.4.47-2.2.0]]  |  [[https://github.com/tq-systems/linux-tqmaxx/releases/tag/zeus.TQMa8Xx.BSP.SW.0055|lf-5.4.y-1.0.0]]   |
|  [[https://github.com/tq-systems/meta-tq/releases/tag/zeus.TQMa8Xx.BSP.SW.0036|0036]]  |  3.0 - Zeus  |  [[https://github.com/tq-systems/ci-meta-tq/tree/zeus-tqma8|zeus-tqma8]]  |  ++tqma8xqp-mba8xx|TQMa8QXP with 1 GB RAM (DDR3) on MBa8Xx++\\  ++tqma8xdp-mba8xx|TQMa8DXP with 1 GB RAM (DDR3) on MBa8Xx++\\  ++tqma8xqp4-mba8xx|TQMa8XQP4 with 2GB RAM (LPDDR4) on MBa8Xx++\\  ++tqma8xdp4-mba8xx|TQMa8XDP4 with 2GB RAM (LPDDR4) on MBa8Xx++  |   [[https://github.com/tq-systems/u-boot-tqmaxx/releases/tag/zeus.TQMa8Xx.BSP.SW.0036|v2020.04-imx-5.4.47-2.2.0]]  |  [[https://github.com/tq-systems/linux-tqmaxx/releases/tag/zeus.TQMa8Xx.BSP.SW.0036|lf-5.4.y-1.0.0]]   |
|  [[https://github.com/tq-systems/meta-tq/releases/tag/zeus.TQMa8Xx.BSP.SW.0035|0035]]  |  3.0 - Zeus  |  [[https://github.com/tq-systems/ci-meta-tq/tree/zeus-tqma8|zeus-tqma8]]  |  ++tqma8xqp-mba8xx|TQMa8QXP with 1 GB RAM (DDR3) on MBa8Xx++\\  ++tqma8xdp-mba8xx|TQMa8DXP with 1 GB RAM (DDR3) on MBa8Xx++\\  ++tqma8xqp4-mba8xx|TQMa8XQP4 with 2GB RAM (LPDDR4) on MBa8Xx++\\  ++tqma8xdp4-mba8xx|TQMa8XDP4 with 2GB RAM (LPDDR4) on MBa8Xx++  |   [[https://github.com/tq-systems/u-boot-tqmaxx/releases/tag/zeus.TQMa8Xx.BSP.SW.0035|v2020.04-imx-5.4.47-2.2.0]]  |  [[https://github.com/tq-systems/linux-tqmaxx/releases/tag/zeus.TQMa8Xx.BSP.SW.0035|lf-5.4.y-1.0.0]]   |
|  [[https://github.com/tq-systems/meta-tq/releases/tag/zeus.TQMa8Xx.BSP.SW.0033|0033]]  |  3.0 - Zeus  |  [[https://github.com/tq-systems/ci-meta-tq/tree/zeus-tqma8|zeus-tqma8]]  |  ++tqma8xqp-mba8xx|TQMa8QXP with 1 GB RAM (DDR3) on MBa8Xx++\\  ++tqma8xqp4-mba8xx|TQMa8XQP4 with 2GB RAM (LPDDR4) on MBa8Xx++  |   [[https://github.com/tq-systems/u-boot-tqmaxx/releases/tag/zeus.TQMa8Xx.BSP.SW.0033|v2020.04-imx-5.4.47-2.2.0]]  |  [[https://github.com/tq-systems/linux-tqmaxx/releases/tag/zeus.TQMa8Xx.BSP.SW.0033|lf-5.4.y-1.0.0]]   |
|  [[https://github.com/tq-systems/meta-tq/releases/tag/zeus.TQMa8Xx.BSP.SW.0032|0032]]  |  3.0 - Zeus  |  [[https://github.com/tq-systems/ci-meta-tq/tree/zeus-tqma8|zeus-tqma8]]  |  ++tqma8xqp-mba8xx|TQMa8QXP with 1 GB RAM (DDR3) on MBa8Xx++\\  ++tqma8xqp4-mba8xx|TQMa8XQP4 with 2GB RAM (LPDDR4) on MBa8Xx++  |   [[https://github.com/tq-systems/u-boot-tqmaxx/releases/tag/zeus.TQMa8Xx.BSP.SW.0032|v2020.04-imx-5.4.47-2.2.0]]  |  [[https://github.com/tq-systems/linux-tqmaxx/releases/tag/zeus.TQMa8Xx.BSP.SW.0032|lf-5.4.y-1.0.0]]   |
|  [[https://github.com/tq-systems/meta-tq/releases/tag/zeus.TQMa8Xx.BSP.SW.0030|0030]]  |  3.0 - Zeus  |  [[https://github.com/tq-systems/ci-meta-tq/tree/zeus-tqma8|zeus-tqma8]]  |  ++tqma8xqp-mba8xx|TQMa8QXP with 1 GB RAM (DDR3) on MBa8Xx++\\  ++tqma8xqp4-mba8xx|TQMa8XQP4 with 2GB RAM (LPDDR4) on MBa8Xx++  |   [[https://github.com/tq-systems/u-boot-tqmaxx/releases/tag/zeus.TQMa8Xx.BSP.SW.0030|v2019.04-lf-5.4.y-1.0.0]]  |  [[https://github.com/tq-systems/linux-tqmaxx/releases/tag/zeus.TQMa8Xx.BSP.SW.0030|lf-5.4.y-1.0.0]]   |
|  [[https://github.com/tq-systems/meta-tq/releases/tag/zeus.TQMa8.BSP.SW.0029|0029]]  |  3.0 - Zeus  |  [[https://github.com/tq-systems/ci-meta-tq/tree/zeus-tqma8|zeus-tqma8]]  |  ++tqma8xqp-mba8xx|TQMa8QXP with 1 GB RAM (DDR3) on MBa8Xx++\\  ++tqma8xqp4-mba8xx|TQMa8XQP4 with 2GB RAM (LPDDR4) on MBa8Xx++  |   [[https://github.com/tq-systems/u-boot-tqmaxx/releases/tag/zeus.TQMa8.BSP.SW.0029|v2019.04-lf-5.4.y-1.0.0]]  |  [[https://github.com/tq-systems/linux-tqmaxx/releases/tag/zeus.TQMa8.BSP.SW.0029|lf-5.4.y-1.0.0]]   |
|  [[https://github.com/tq-systems/meta-tq/releases/tag/zeus.TQMa8Xx.BSP.SW.0028|0028]]  |  3.0 - Zeus  |  [[https://github.com/tq-systems/ci-meta-tq/tree/zeus-tqma8|zeus-tqma8]]  |  ++tqma8xqp-mba8xx|TQMa8QXP with 1 GB RAM (DDR3) on MBa8Xx++  |   [[https://github.com/tq-systems/u-boot-tqmaxx/releases/tag/zeus.TQMa8Xx.BSP.SW.0028|v2019.04-lf-5.4.y-1.0.0]]  |  [[https://github.com/tq-systems/u-boot-tqmaxx/releases/tag/zeus.TQMa8Xx.BSP.SW.0025|lf-5.4.y-1.0.0]]   |
|  [[https://github.com/tq-systems/meta-tq/releases/tag/zeus.TQMa8Xx.BSP.SW.0025|0025]]  |  3.0 - Zeus  |  [[https://github.com/tq-systems/ci-meta-tq/tree/zeus-tqma8|zeus-tqma8]]  |  tqma8xqp-mba8xx  |   [[https://github.com/tq-systems/u-boot-tqmaxx/releases/tag/zeus.TQMa8.BSP.SW.0025|v2019.04-lf-5.4.y-1.0.0]]  |  [[https://github.com/tq-systems/linux-tqmaxx/releases/tag/zeus.TQMa8Xx.BSP.SW.0025|lf-5.4.y-1.0.0]]   |
|  [[https://github.com/tq-systems/meta-tq/releases/tag/sumo.TQMa8Xx.BSP.SW.0017|0017]]  |  2.5.2 - Sumo  |  [[https://github.com/tq-systems/ci-meta-tq/tree/sumo-tqma8x|sumo-tqma8x]]  |  tqma8xqp-mba8xx \\  tqma8xd-mba8xx  |   v2018.03-rel_imx_4.14.98_2.2.0_ga  |  rel_imx_4.14.98_2.2.0_ga  | 
|  [[https://github.com/tq-systems/meta-tq/releases/tag/sumo.TQMa8Xx.BSP.SW.0016|0016]]  |  2.5.2 - Sumo  |  [[https://github.com/tq-systems/ci-meta-tq/tree/sumo-tqma8x|sumo-tqma8x]]  |  tqma8xqp-mba8xx \\  tqma8xd-mba8xx  |   v2018.03-rel_imx_4.14.98_2.2.0_ga  |  rel_imx_4.14.98_2.2.0_ga  | 
|  [[https://github.com/tq-systems/meta-tq/releases/tag/sumo.TQMa8.BSP.SW.0009|0009]]  |  2.5.2 - Sumo  |  [[https://github.com/tq-systems/ci-meta-tq/tree/sumo-tqma8x|sumo-tqma8x]]  |  tqma8xqp-mba8xx \\  tqma8xd-mba8xx  |  v2018.03 rel_imx_4.14.78_1.0.0_ga  |  rel_imx_4.14.78_1.0.0_ga  |
|  [[https://github.com/tq-systems/meta-tq/releases/tag/sumo.TQMa8.BSP.SW.0007|0007]]  |  2.5.2 - Sumo  |  [[https://github.com/tq-systems/ci-meta-tq/tree/sumo-tqma8x|sumo-tqma8x]]  |  tqma8xqp-mba8xx \\  tqma8xd-mba8xx  |  v2018.03 rel_imx_4.14.78_1.0.0_ga  |  rel_imx_4.14.78_1.0.0_ga  |
|  [[https://github.com/tq-systems/meta-tq/releases/tag/sumo.TQMa8.BSP.SW.0006|0006]]  |  2.5.2 - Sumo  |  [[https://github.com/tq-systems/ci-meta-tq/tree/sumo-tqma8x|sumo-tqma8x]]  |  tqma8xqp-mba8xx \\  tqma8xd-mba8xx  |  v2018.03 rel_imx_4.14.78_1.0.0_ga  |  rel_imx_4.14.78_1.0.0_ga  |
|  [[https://github.com/tq-systems/meta-tq/releases/tag/sumo.TQMa8.BSP.SW.0005|0005]]  |  2.5.2 - Sumo  |  [[https://github.com/tq-systems/ci-meta-tq/tree/sumo-tqma8x|sumo-tqma8x]]  |  tqma8xqp-mba8xx \\  tqma8xd-mba8xx  |  v2018.03 rel_imx_4.14.78_1.0.0_ga  |  rel_imx_4.14.78_1.0.0_ga  |
|  [[https://github.com/tq-systems/meta-tq/releases/tag/sumo.TQMa8.BSP.SW.0002|0002]]  |  2.5.2 - Sumo  |  [[https://github.com/tq-systems/ci-meta-tq/tree/sumo-tqma8x|sumo-tqma8x]]  |  tqma8qx-mba8xx  |  v2018.03 rel_imx_4.14.78_1.0.0_ga  |  rel_imx_4.14.78_1.0.0_ga  |
|  [[https://github.com/tq-systems/meta-tq/releases/tag/rocko.TQMa8Xx.BSP.SW.0001|0001]]  |  2.4.4 - Rocko  |  [[https://github.com/tq-systems/ci-meta-tq/tree/rocko-tqma8x|rocko-tqma8x]]  |  tqma8qx-mba8qx  |  v2017.03 rel_4.9.88_imx_imx8qxp_beta2  |  rel_imx_4.9.88_imx8qxp_beta2  | 
</panel>
</accordion>
<panel type="info" title="BSP / Hardware compatibility" no-body="true">
^ ^  TQMa8Xx4  ^  TQMa8Xx  ^^^  MBa8Xx  ^^
^  BSP Rev.  ^  Rev.01xx  ^  Rev.01xx  ^  Rev.02xx  ^  Rev.03xx  ^  Rev.01xx  ^  Rev.02xx  ^
^   < 0025  |     |  ✔  |     |     |  ✔  |     |
^   ≥ 0025  |     |     |  ✔  |     |     |  ✔  |
^   ≥ 0029  |  ✔  |     |     |     |     |  ✔  |
^   ≥ 0033  |  ✔  |     |  ✔  |  ✔  |     |  ✔  |
</panel>
{{section>..:..:general_information:yocto:tips#bsp_release_auto_notification&noheader}}
===== Yocto Target Machines =====
<panel type="primary" title="Yocto Target Machines" no-body="true">

^  TQMa8.BSP Revision  ^  Target machine  |
|  [[https://github.com/tq-systems/meta-tq/releases/tag/zeus.TQMa8Xx.BSP.SW.0055|≥0055]]   |  tqma8xqp-2gb-mba8xx \\ tqma8xqp-1gb-mba8xx \\ tqma8xdp-1gb-mba8xx \\ tqma8xqp4-mba8xx \\ tqma8xdp4-mba8xx  |
|  [[https://github.com/tq-systems/meta-tq/releases/tag/zeus.TQMa8Xx.BSP.SW.0035|≥0035]]   |  tqma8xqp-mba8xx \\ tqma8xdp-mba8xx \\ tqma8xqp4-mba8xx \\ tqma8xdp4-mba8xx  |
|  [[https://github.com/tq-systems/meta-tq/releases/tag/zeus.TQMa8.BSP.SW.0029|≥0029]]   |  tqma8xqp-mba8xx \\ tqma8xqp4-mba8xx  |
|  [[https://github.com/tq-systems/meta-tq/releases/tag/zeus.TQMa8Xx.BSP.SW.0025|≥0025]]   |  tqma8xqp-mba8xx  |
|  [[https://github.com/tq-systems/meta-tq/releases/tag/sumo.TQMa8.BSP.SW.0005|≥0005]]   |  tqma8xqp-mba8xx \\ tqma8xd-mba8xx  |
|  [[https://github.com/tq-systems/meta-tq/releases/tag/sumo.TQMa8.BSP.SW.0002|0002]]   |  tqma8qx-mba8xx  |
|  [[https://github.com/tq-systems/meta-tq/releases/tag/rocko.TQMa8Xx.BSP.SW.0001|0001]]   |  tqma8qx-mba8qx  |

\\
</panel> 
<WRAP hide>
<panel type="info" title="BSP / Hardware compatibility" no-body="true">
^ ^  TQMa8Xx  ^^  MBa8Xx  ^^
^::: ^  Rev.01xx  ^  Rev.02xx  ^  Rev.01xx  ^  Rev.02xx  ^
^  BSP Rev < 0025  |  ✔  |  |  ✔  |  |
^  BSP REV ≥ 0025  |  |  ✔  |  |  ✔  |

^::: ^  TQMa8Xx4  ^^  MBa8Xx  ^^
^::: ^  Rev.01xx  ^^  Rev.02xx  ^^  
^  BSP REV ≥ 0029  |  ✔  ||  ✔  || 
</WRAP>

</panel>


===== Yocto Changelog =====
<panel type="info" title="BSP Version History" no-body="true">
<accordion collapsed="true">
<panel title="Rev.0089">
https://github.com/tq-systems/meta-tq/blob/kirkstone.TQMa8.BSP.SW.0089/meta-tq/CHANGELOG.md#kirkstonetqarmbsp0004
</panel>
<panel title="Rev.0088">
https://github.com/tq-systems/meta-tq/blob/kirkstone.TQMa8.BSP.SW.0089/meta-tq/CHANGELOG.md#kirkstonetqarmbsp0003
</panel>
<panel title="Rev.0087">
**BSP**
  * Update to Yocto Kirkstone
**U-Boot**
  * Update imx-seco
  * Update imx seco-libs
  * Update imx-sc-firmware  
  
**Linux**
  * Linux 5.15 support based on linux-fslc 5.15 + imx
</panel>

<panel title="Rev.0083">

**U-Boot**

  * Support booting UBI rootfs from SPI NOR
  * Use local version as implemented in branch zeus-tqma8. This will make the U-boot version string consistent with newer and upcomming kernel version string and consists of <upstream version>-tq+g<git short hash>
  * Support for large micron SPI NOR on TQMa8Xx / TQMa8x flash was discovered but progam / erase silently fails. Backport upstream driver changes for FlexSPI IP and use this driver instead of the older one.
  * TQMa8[all variants] adjust DEFAULT_FDT_FILE to kernel 5.10 used in this BSP. This is also the naming scheme that will be found in linux-mainline.

**Linux**

  * Rewrite to use linux-yocto class
  * Force build vivante gpu driver for linux-tq-imx as out of tree module to ensure versions between module and userland match. Overrides default assignments from meta-freescale.
  * Switch to use linux-yocto for kernel fragment handling
  * Remove support for i.MX8 based machines


</panel>

<panel title="Rev.0082">

**BSP**

  * Update to Yocto Hardknott

**Linux**

  * Linux 5.10 support based on linux-fslc 5.10 + imx

</panel>


<panel title="Rev.0055">

**BSP**
  * Support for Cortex M4 enabled bootstream 
  * Add new variant tqma8xqp-2gb-mba8xx
  * Rename existing machines tqma8x[d,q]p-mba8xx to tqma8x[d,q]p-1gb-mba8xx to allow new variants
  * Update SCFW version: basic CortexM4 support for TQMa8Xx[S] and new 2GB DDR3L / ECC variant of TQMa8Xx
  * Update tqma8-cortexm-demos version: basic CortexM4 support for TQMa8Xx[S]
  * Disable packages only relevant for NXP STK:
    * nxp8987 WiFi
    * imx-m[4,7]-demos
  * Migrate all imx8 machines with U-Boot v2020.04 support to NXP BSP version
  * Migrate all machines to NXP BSP version
  * Drop support for v2019.04, since no user left

**U-Boot**
  * Add reserved memory nodes in DT to prevent U-Boot accessing M4 reserved memory
  * Allow building bootstream with Cortex M4 demo for TQ Systems SOM
  * Fix location U-Boot config node in DT
  * Prevent voltage switch error message for e-MMC. This is not a real error but ugly behaviour which was fixed for other SOM before
  * Add GPIO_OPEN_DRAIN to I2C GPIO to prevent warnings (sync with kernel)
  * DSR support for Micron SPI NOR
  * I2C recovery gpio 

**Linux**
  * Device trees for Cortex M4 demos
  * Set CAN PDRV to low
  * Upstream fixes from linux-imx
  * Label sys EEPROM as read only
  * Add GPIO_OPEN_DRAIN to I2C GPIO to prevent warnings
  * Make backlight for LVDS work again. When using PWM from different power domain, this domain needs to be enabled
  * Improve kernel config:
    * Remove ACPI
    * Remove unused audio stuff
    * Remove unused net devices
    * Enable Vision Components GmbH MIPI CSI cameras
  * DSR support for Micron SPI NOR
  * I2C recovery gpio
  * Enable wifi support in kernelconfig
  * Fix DT for mPCIe USB cards on MBa8Xx
</panel>
<panel title="Rev.0036">

**BSP**
  * config/machines: sanitize variable assignments to improve reusability
    * Replace IMAGE_INSTALL_append with more approbiate MACHINE_EXTRA_RRECOMMENDS_append
    * Remove all dirty magic for DISTRO_FEATURES_remove
    * Replace hard assignments to IMAGE_BOOT_FILES with ?= 

**U-Boot**
  * v2020.04 fix FEC Ethernet PHY init
    * Fix phy_config using devicetree
    * Forward error from phy_config

</panel>

<panel title="Rev.0035">

**BSP**
  * support for tqma8xdp[4]-mba8xx

**U-Boot**
  * Fix board name for TQMa8XDP[4]
**Linux**
  * Support for tqma8xdp[4]-mba8xx

</panel>

<panel title="Rev.0033">

**U-Boot**
  * Fix not working update scripts when exchanging an SD card just before start updating
  * Allow DSR for Macronix SPI NOR on all supported TQ-Systems SOM


**Linux**
  * Backport improvements for TI TLV320AIC32x4 codec
  * Lower drive strength for some pins
  * QSPI NOR DSR
  * Adjust thermal trip points
  * Reenable audio in DT (deadlock fixed for I2C host)
  * Fix deadlock i2c-imx-lpi2c
  * Fix PMIC / CPU thermal sensor support
  * Allow DSR for Macronix SPI NOR on all supported TQ-Systems SOM
  * Add DSR support for Macronix flash
  * Enable VPU support
</panel>

<panel title="Rev.0032">
**BSP**

  * Update SCFW to tq-TQMa8.NXP-v1.6.0.B4894.0030
  * Use Release Version of SC Firmware without debug output
  * Update to U-Boot imx-5.4.47-2.2.0
  * Update to ATF v2.2 / imx-5.4.47_2.2.0
  * QSPIA_SS1 is usable as GPIO

</panel>

<panel title="Rev.0030">

** U-Boot**
  * Fix compatible names in devicetree

**Linux**
  * Fix compatible names in devicetree
  * Increase clock for LPSPI1, use same PER base clocks as other LPSPI instance. Fixes clock mismatch for spidev on TQMa8XxS

</panel>

<panel title="Rev.0029">

**BSP**
  * Add default config for TQMa8Xx for u-boot-fw-utils-imx-tq
  * Fix missing dependency on bison-native for u-boot-fw-utils-imx-tq
  * Rewrite systemd-machine-units bbappend to conform to new systemd version. CAN does not need separate units, but a simple network definition 
  * Add Support for TQMa8XQP4. The new machine needs a different bootstream hence a differen SCU firmware. The rest is equal to the existing TQMa8XQP.

**U-Boot**
  * Support for TQMa8XQP4 as variant of TQMa8Xx (defconfigs, memory defines)
  * Use same asound.state for all TQMa8 boards. Depends on linux support
  * Fixed missing defines for default mtest addresses
  * Use weak assignments for IMXBOOT_TARGETS to allow overrides and to prevent generating invalid bootstreams in imx-boot-mfgtool_
  * fix wrong setting for pin muxing
  * Drop support for TQMa8XxS HW REV.010x

**Linux**
  * Fix wrong setting for pin muxing
  * Drop support for TQMa8XxS HW REV.010x

</panel>
<panel title="Rev.0028">
**BSP**
  * Support bootstream for FlexSPI
  * Support bootstream for mfgtool config
  * Port / append mfgtool dependend recipes

**U-Boot**
  * Display CPU info
  * Add mfgtool config
  * Single config for SD / e-MMC / FlexSPI Boot device

**Linux**
  * Support PCIe
</panel>

<panel title="Rev.0025">
**BSP**
  * Update to Yocto Zeus
  * Port TQMa8Xx to new U-Boot / Linux kernel
  * Add recipes for kernel / u-boot based on NXP 5.4.y_1.0.0 reference BSP
  * Add machine files for TQMa8 modules (based on old local kernel and u-boot, only basic boot support)
  * SCFW firmware update to 1.3.1 
  * Add bbappends for recipes from meta-imx
  * Add recipes from sumo-tqma8x branch

**Linux**
  * Port simple-panel display timings
  * Backport LVDS bugfixes from 5.4.3_2.0.0 beta
  * Port LVDS DSI bridge
  * Port audio fixes for TQ Systems starter kits
  * Mesa: restrict bbappend to mx8
  * Disable *.bz2 image types

</panel>
<panel title="Rev.0017">
**BSP**
  * meta-dumpling: added u-boot-fw-utils in packagegroups
  * meta-tq : u-boot-fw-utils support


**Linux**
  * added spidev for busses SPI1 / SPI2 / SPI3  
  * added LPUART3 / available on unused SAI pins   
  * fix QSPI driver 
</panel>

<panel title="Rev.0016"> 
**BSP**
  * Update to scfw version 1.2.7
  * systemd-machine-units reduce default can bitrate

**U-Boot**
  * Update to imx_4.14.98_2.2.0 
  * Fix QSPI probe write a byte to flash (MACRONIX)
  * QSPI Boot support

**Linux**
  * Update to rel_imx_4.14.98_2.2.0
</panel>
<panel title="Rev.0009">
  * backport CAN fixes from current NXP kernel
  * support additional LVDS display
  * add etm11010g0dka
</panel>

<panel title="Rev.0007">
  * CAN / Ethernet preconfigured via systemd service
  * PCIe disabled DT for old STK
  * Ethernet phy led config fix
  * Better reserved memory config for TQMa8XD
</panel>

<panel title="Rev.0006">
  * PCIe GPIO pins (PERST pin config correction) in DT and U-Boot
  * PCIe DT with Gen1 only support (for transparent PCIe switch / bridge)
</panel>
<panel title="Rev.0005">
Global:

  * SCU Firmware based on porting kit v1.1.2

TQMa8XQP:

  * make LVDS work again
  * polish boot flow
  * rename configs and names (tqma8qxp-mba8xx -> tqma8xqp-mbaxx)
  * support net boot

TQMa8XD:

  * initial support (tqma8xd-mba8xx)

TQMa8XQPS

  * test newtwork support in linux
  * support net boot (GBE0)

</panel>
<panel title="Rev.0002">
  * port to yocto sumo / NXP rel_imx_4.14.78_ga
  * SCU firmware base v1.1
  * rename configs and names (tqma8qxp-mba8xx -> tqma8xqp-mbaxx) siehe version matrix
</panel>
<panel title="Rev.0001">
  * initial release
</panel>
</accordion>
</panel>

===== Yocto Partitions =====

<panel type="primary" title="SD / eMMC image">

  * sector size 512 Byte
  * unpartitioned area: 4MiB (0x2000 sectors)

^ Size  ^ Usage  ^
| 0x0001 sector  / 512 Byte  | MBR / Partition Table  |
| 0x0001 sector  / 512 Byte  | free  |
| 0x800 sectors / 1 MiB  | u-boot  |
| 0x1000 sectors / 2 MiB  | environment  | 
| 0x2000 sectors / 4 MiB  | reserved  |
| 0xA000 sectors / 20 MiB  | /boot / firmware (Kernel,devicetrees)  |
| 0x100000 sectors / 512 MiB  | RootFS  |
</panel>

===== Yocto Images =====
<accordion collapsed="true">



<panel title="Target Machine: tqma8xdp-1gb-mba8Xx">


**System Images**

<grid>
<col sm="12">
^ Boot Device  ^ Symlink  ^ File  ^
^ SD Card/eMMC  | 
^ SD Card/eMMC  | tq-image-weston-tqma8xdp-1gb-mba8xx.wic | tq-image-weston-tqma8xdp-1gb-mba8xx-<build_timestamp>.rootfs.wic |
</col>
</grid>


**Bootloader Binaries**

<grid>
<col sm="12">
^ Boot Device  ^ Symlink  ^ File  ^
^ SD/eMMC  | imx-boot  | imx-boot-tqma8xdp-1gb-mba8xx-sd.bin-flash_spl |
</col>
</grid>

**Linux Kernel Image**

<grid>
<col sm="12">
^ Symlink  ^ File  ^
| Image  | Image--5.10.74+git0+a988e804a1-r0-tqma8xdp-1gb-mba8xx-<build_timestamp>.bin  |
</col>
</grid>

**Devicetree Blobs**
<grid>
<col sm="12">
^ Symlink  ^ Description  ^
| imx8dxp-tqma8xdp-mba8xx.dtb | Default |
| imx8dxp-tqma8xdp-mba8xx-lvds0-tm070jvhg33.dtb  | Default with LVDS0 interface activated  |
| imx8dxp-tqma8xdp-mba8xx-lvds1-tm070jvhg33.dtb  | Default with LVDS1 interface activated  |
| imx8dxp-tqma8xdp-mba8xx-rpmsg.dtb  | Default with RPMSG support  |

</col>
</grid>


**Rootfs images**
<grid>
<col sm="12">
^ Symlink  ^ File  ^
| tq-image-weston-tqma8xdp-1gb-mba8xx.ext4  | tq-image-weston-tqma8xdp-1gb-mba8xx-<build_timestamp>.rootfs.ext4   |
| tq-image-weston-tqma8xdp-1gb-mba8xx.tar.gz  | tq-image-weston-tqma8xdp-1gb-mba8xx-<build_timestamp>.rootfs.tar.gz  |
</col>
</grid>
</panel>


<panel title="Target Machine: tqma8xqp-1gb-mba8xx">


**System Images**

<grid>
<col sm="12">
^ Boot Device  ^ Symlink  ^ File  ^
^ SD Card/eMMC  | 
^ SD Card/eMMC  | tq-image-weston-tqma8xqp-1gb-mba8xx.wic | tq-image-weston-tqma8xqp-1gb-mba8xx-<build_timestamp>.rootfs.wic |
</col>
</grid>


**Bootloader Binaries**

<grid>
<col sm="12">
^ Boot Device  ^ Symlink  ^ File  ^
^ SD/eMMC  | imx-boot  | imx-boot-tqma8xqp-1gb-mba8xx-sd.bin-flash_spl |
</col>
</grid>

**Linux Kernel Image**

<grid>
<col sm="12">
^ Symlink  ^ File  ^
| Image  | Image--5.10.74+git0+a988e804a1-r0-tqma8xqp-1gb-mba8xx-<build_timestamp>.bin  |
</col>
</grid>

**Devicetree Blobs**
<grid>
<col sm="12">
^ Symlink  ^ Description  ^
| imx8qxp-tqma8xqp-mba8xx.dtb | Default |
| imx8qxp-tqma8xqp-mba8xx-lvds0-tm070jvhg33.dtb  | Default with LVDS0 interface activated  |
| imx8qxp-tqma8xqp-mba8xx-lvds1-tm070jvhg33.dtb  | Default with LVDS1 interface activated  |
| imx8qxp-tqma8xqp-mba8xx-rpmsg.dtb  | Default with RPMSG support  |

</col>
</grid>


**Rootfs images**
<grid>
<col sm="12">
^ Symlink  ^ File  ^
| tq-image-weston-tqma8xqp-1gb-mba8xx.ext4  | tq-image-weston-tqma8xqp-1gb-mba8xx-<build_timestamp>.rootfs.ext4   |
| tq-image-weston-tqma8xqp-1gb-mba8xx.tar.gz  | tq-image-weston-tqma8xqp-1gb-mba8xx-<build_timestamp>.rootfs.tar.gz  |
</col>
</grid>
</panel>


<panel title="Target Machine: tqma8xqp-2gb-mba8xx">


**System Images**

<grid>
<col sm="12">
^ Boot Device  ^ Symlink  ^ File  ^
^ SD Card/eMMC  | 
^ SD Card/eMMC  | tq-image-weston-tqma8xqp-2gb-mba8xx.wic | tq-image-weston-tqma8xqp-2gb-mba8xx-<build_timestamp>.rootfs.wic |
</col>
</grid>


**Bootloader Binaries**

<grid>
<col sm="12">
^ Boot Device  ^ Symlink  ^ File  ^
^ SD/eMMC  | imx-boot  | imx-boot-tqma8xqp-2gb-mba8xx-sd.bin-flash_spl |
</col>
</grid>

**Linux Kernel Image**

<grid>
<col sm="12">
^ Symlink  ^ File  ^
| Image  | Image--5.10.74+git0+a988e804a1-r0-tqma8xqp-2gb-mba8xx-<build_timestamp>.bin  |
</col>
</grid>

**Devicetree Blobs**
<grid>
<col sm="12">
^ Symlink  ^ Description  ^
| imx8qxp-tqma8xqp-mba8xx.dtb | Default |
| imx8qxp-tqma8xqp-mba8xx-lvds0-tm070jvhg33.dtb  | Default with LVDS0 interface activated  |
| imx8qxp-tqma8xqp-mba8xx-lvds1-tm070jvhg33.dtb  | Default with LVDS1 interface activated  |
| imx8qxp-tqma8xqp-mba8xx-rpmsg.dtb  | Default with RPMSG support  |

</col>
</grid>


**Rootfs images**
<grid>
<col sm="12">
^ Symlink  ^ File  ^
| tq-image-weston-tqma8xqp-2gb-mba8xx.ext4  | tq-image-weston-tqma8xqp-2gb-mba8xx-<build_timestamp>.rootfs.ext4   |
| tq-image-weston-tqma8xqp-2gb-mba8xx.tar.gz  | tq-image-weston-tqma8xqp-2gb-mba8xx-<build_timestamp>.rootfs.tar.gz  |
</col>
</grid>
</panel>



<panel title="BSP Revision ≥ 0025">
==== Target Machine: tqma8xqp-mba8xx ====
=== System Image ===

== SD Card/eMMC ==

^  Symlink   ^  File     ^
| tq-image-weston-tqma8xqp-mba8xx.wic | tq-image-weston-tqma8xqp-mba8xx-<build_timestamp>.rootfs.wic |

=== Bootstream (Bootloader) Binary ===
== SD Card/eMMC ==

^  Symlink   ^  File     ^
| imx-boot-tqma8xqp-mba8xx-sd.bin | imx-boot-tqma8xqp-mba8xx-sd.bin-flash_spl |

=== Linux Kernel Binary ===
^  Symlink   ^  File     ^
| Image\\ Image-tqma8xqp-mba8xx.bin  | Image--5.4-r0-tqma8xqp-mba8xx-<build_timestamp>.bin  |

=== Devicetree Binarys ===
^  Symlink   ^  Description  ^
|  imx8qxp-mba8xx.dtb\\  imx8qxp-mba8xx-tqma8xqp-mba8xx.dtb  |  device tree blob for TQMa8XQP on MBa8Xx  |
|  imx8qxp-mba8xx-lvds-tm070jvhg33.dtb\\  imx8qxp-mba8xx-lvds-tm070jvhg33-tqma8xqp-mba8xx.dtb  |  device tree blob for LVDS Display  |



=== RootFS Images ===

^  Symlink   ^  File     ^
|  tq-image-weston-tqma8xqp-mba8xx.ext4  | tq-image-weston-tqma8xqp-mba8xx-<build_timestamp>.rootfs.ext4 |
|  tq-image-weston-tqma8xqp-mba8xx.tar.gz  | tq-image-weston-tqma8xqp-mba8xx-20200625075001.rootfs.tar.gz  |
</panel>
<panel title="BSP Revision ≤ 0017">

==== Target Machine: tqma8xd-mba8xx ====

=== System Image ===

== SD Card/eMMC ==

^  Symlink   ^  File     ^
| tq-image-qt5-tqma8xd-mba8xx.wic | tq-image-qt5-tqma8xd-mba8xx-<build_timestamp>.rootfs.wic |

=== Bootstream (Bootloader) Binary ===
== SD Card/eMMC ==

^  Symlink   ^  File     ^
| imx-boot-tqma8xd-mba8xx-sd.bin | imx-boot-tqma8xd-mba8xx-sd.bin-flash |

=== Linux Kernel Binary ===
^  Symlink   ^  File     ^
| Image\\ Image-tqma8xd-mba8xx.bin  | Image--4.14.98-r0-tqma8xd-mba8xx-<build_timestamp>.bin  |

=== Devicetree Binarys ===
^  Symlink   ^  Description  ^
|  Image-fsl-imx8dx-tqma8xd-mba8xx.dtb\\  fsl-imx8dx-tqma8xd-mba8xx.dtb  |  device tree blob for TQMa8XD  |
|  Image-fsl-imx8dx-tqma8xd-mba8xx-lvds-etml1010g0dka.dtb\\  fsl-imx8dx-tqma8xd-mba8xx-lvds-etml1010g0dka.dtb  |  device tree blob for LVDS Display  |
|  Image-fsl-imx8dx-tqma8xd-mba8xx-lvds-tm070jvhg33.dtb\\  fsl-imx8dx-tqma8xd-mba8xx-lvds-tm070jvhg33.dtb  |  device tree blob for TIANMA LVDS Display  |
|  Image-fsl-imx8dx-tqma8xd-mba8xx-no-pcie.dtb\\  fsl-imx8dx-tqma8xd-mba8xx-no-pcie.dtb   | Devicetree for older Carrier Revision to disable PCIe |
|  Image-fsl-imx8dx-tqma8xd-mba8xx-pcie-gen1.dtb\\  fsl-imx8dx-tqma8xd-mba8xx-pcie-gen1.dtb  | Devicetree for older Carrier Revision to enable PCIe Gen1 |

=== RootFS Images ===

^  Symlink   ^  File     ^
|  tq-image-qt5-tqma8xd-mba8xx.ext4  | tq-image-qt5-tqma8xd-mba8xx-<build_timestamp>.rootfs.ext4 |
|  tq-image-qt5-tqma8xd-mba8xx.tar.gz  | tq-image-qt5-tqma8xd-mba8xx-<build_timestamp>.rootfs.tar.gz  |


==== Target Machine: tqma8xqp-mba8xx ====
=== System Image ===

== SD Card/eMMC ==

^  Symlink   ^  File     ^
| tq-image-qt5-tqma8xqp-mba8xx.wic | tq-image-qt5-tqma8xqp-mba8xx-<build_timestamp>.rootfs.wic |

=== Bootstream (Bootloader) Binary ===
== SD Card/eMMC ==

^  Symlink   ^  File     ^
| imx-boot-tqma8xqp-mba8xx-sd.bin | imx-boot-tqma8xqp-mba8xx-sd.bin-flash |

=== Linux Kernel Binary ===
^  Symlink   ^  File     ^
| Image\\ Image-tqma8xqp-mba8xx.bin  | Image--4.14.98-r0-tqma8xqp-mba8xx-<build_timestamp>.bin  |

=== Devicetree Binarys ===
^  Symlink   ^  Description  ^
|  Image-fsl-imx8dx-tqma8xqp-mba8xx.dtb\\  fsl-imx8dx-tqma8xqp-mba8xx.dtb  |  device tree blob for TQMa8XQP  |
|  Image-fsl-imx8dx-tqma8xqp-mba8xx-lvds-etml1010g0dka.dtb\\  fsl-imx8dx-tqma8xqp-mba8xx-lvds-etml1010g0dka.dtb  |  device tree blob for LVDS Display  |
|  Image-fsl-imx8dx-tqma8xqp-mba8xx-lvds-tm070jvhg33.dtb\\  fsl-imx8dx-tqma8xqp-mba8xx-lvds-tm070jvhg33.dtb  |  device tree blob for TIANMA LVDS Display  |
|  Image-fsl-imx8dx-tqma8xqp-mba8xx-no-pcie.dtb\\  fsl-imx8dx-tqma8xqp-mba8xx-no-pcie.dtb   | Devicetree for older Carrier Revision to disable PCIe |
|  Image-fsl-imx8dx-tqma8xqp-mba8xx-pcie-gen1.dtb\\  fsl-imx8dx-tqma8xqp-mba8xx-pcie-gen1.dtb  | Devicetree for older Carrier Revision to enable PCIe Gen1 |

=== RootFS Images ===

^  Symlink   ^  File     ^
|  tq-image-qt5-tqma8xqp-mba8xx.ext4  | tq-image-qt5-tqma8xqp-mba8xx-<build_timestamp>.rootfs.ext4 |
|  tq-image-qt5-tqma8xqp-mba8xx.tar.gz  | tq-image-qt5-tqma8xqp-mba8xx-<build_timestamp>.rootfs.tar.gz  |
</panel>
</accordion>



===== Known Issues =====

==== Display port interface is not working ====
^ Details  ||
^ [c]Effect[/c]  | Display Port interface is not working on MBa8Xx  |
^ [c]Issue[/c]  | SN65DSI86 DSI to embedded DisplayPort (eDP) bridge is not supported in BSP  |
^ Affected Revisions  ||
^ [c]BSP[/c]  | all revisions  |
^ [c]Module[/c]  | all revisions  |
^ [c]Mainboard[/c]  | all revisions\\ (Please note: SN65DSI86 is no longer assembled on MBa8Xx ≥ Rev.0203)  |
^ Solution  ||
^ [c]Fix[/c] | no plan to fix (due to missing driver support) |
^ [c]Workaround[/c] | n/a (for custom designs use another DSI to DP bridge, e.g. TC9595)  |

----

==== Linux kernel does not start with sumo.TQMa8.BSP.SW.0005 on MBa8Xx ≤ Rev.0101 ====
^ Details  ||
^ [c]Effect[/c]  | Linux kernel does not start (no more messages after ''Starting kernel...'')  |
^ [c]Issue[/c]  | PCIe requires external clock generator  |
^ Affected Revisions  ||
^ [c]Bsp[/c]  | sumo.TQMa8Xx.BSP.SW.0002\\ sumo.TQMa8.BSP.SW.0005  |
^ [c]Module[/c]  | all revisions  |
^ [c]Mainboard[/c]  | MBa8Xx ≤ Rev.0101  |
^ Solution  ||
^ [c]Fix[/c] | Upgrade to MBa8Xx Rev.0102 (please contact [[support@tq-group.com?subject=MBa8Xx: Upgrade to Rev.0102|TQ Support]] for further information)  |
^ [c]Workaround[/c] | Use {{ :en:arm:tqma8xx:tqma8.bsp.sw.0006_dtbs-no-pcie.tar |devicetree with disabled PCIe interface}} (will be included in next BSP release)  |

----

==== PCIe device detection ====
^ Details  ||
^ [c]Effect[/c]  | Some PCIe devices (e.g. PCIe switches) may not be properly detected  |
^ [c]Issue[/c]  | PCIe signals //clock//, //enable// and //reset// do not comply to the PCIe specification  |
^ Affected Revisions  ||
^ [c]Bsp[/c]  | ≤ sumo.TQMa8.BSP.SW.0005  |
^ [c]Module[/c]  | all revisions  |
^ [c]Mainboard[/c]  | MBa8Xx ≥ Rev.0102  |
^ Solution  ||
^ [c]Fix[/c] | TBD  |
^ [c]Workaround[/c] | Limit PCIe speed to Gen1 by using proper devicetree ''*-pcie-gen1.dtb'' (provided with BSP release sumo.TQMa8.BSP.SW.0006)  |

----

==== No QSPI NOR Flash support in U-Boot ====
^ Details  ||
^ [c]Effect[/c]  | Executing ''sf probe'' in U-Boot causes the first byte of the QSPI NOR Flash to be overwritten  |
^ [c]Issue[/c]  | QSPI NOR Flash is not suppported in U-Boot  |
^ Affected Revisions  ||
^ [c]Bsp[/c]  | sumo.TQMa8.BSP.SW.0005  |
^ [c]Module[/c]  | all revisions  |
^ [c]Mainboard[/c]  | all revisions  |
^ Solution  ||
^ [c]Fix[/c] | TBD  |
^ [c]Workaround[/c] | N/A  |

===== Yocto Deployment =====

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

==== Yocto specific command Update eMMC ==== 
1. Run the following commands in the Uboot shell to create update script: 
<code> 
setenv root_loop 'setenv start 24000 && setenv r1 $rootblks16 && while itest $r1 -gt 0; do if itest $r1 -gt 0x100000; then setenv count 0x100000; else setenv count $r1; fi && mmc dev 1 && mmc read $loadaddr $start $count && mmc dev 0 && mmc write $loadaddr $start $count && setexpr start $start + $count && setexpr r1 $r1 - $count; done; setenv r1; setenv start; setenv count'
</code> 

<code> 
setenv  install_firmware 'echo MBR... && mmc dev 1 && mmc read $loadaddr 0 1 && mmc dev 0 && mmc write $loadaddr 0 1 && echo U-Boot... && mmc dev 1 && mmc read $loadaddr 40 1FC0 && mmc dev 0 && mmc write $loadaddr 40 1FC0 && echo U-Boot environment... && mmc dev 1 && mmc read $loadaddr 2000 2000 && mmc dev 0 && mmc write $loadaddr 2000 2000 && echo Firmware Partition... && mmc dev 1 && mmc read $loadaddr 4000 20000 && mmc dev 0 && mmc write $loadaddr 4000 20000  && echo Root FS... && run root_loop'
</code> 

  * create  the environment variable **rootblks16** and set the value accordingly to the size of the RootFS in this case 2070MB.
<WRAP round important> To calculate the value of **rootblks16** devide the size of the image in byte by 512 and convert the result into a hex value.\\  

2070** * **1024** * **1024 = 2170552320
\\
2170552320** / **512 = 4239360
\\ 
4239360 = 40B000<sub>HEX</sub>

</WRAP>
<code>
setenv rootblks16 0x40B000
</code>


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

<code>
=> run netboot
</code>

==== uuu custom command list ====