Table of Contents
TQMa91xxLA - YOCTO Linux BSP documentation
Overview
The TQMa91xxLA provides a powerful embedded module platform based on NXP’s i.MX9 CPU series. The BSP is based on the Yocto Project using TQ’s meta-tq hardware support layer, with build host setup instructions and BSP sources provided via GitHub.
Please see the meta-tq repository on GitHub for further instructions. A list of supported Yocto images and example configurations is available in the BSP repository GitHub.
Documentation and Downloads
Documentation and Downloads
TQ Systems provides comprehensive documentation on its embedded mini-module products to facilitate the evaluation and design phase with our products.
Publicly Available User Manuals & Datasheets
The following documents can be downloaded directly from our Website (no login required) for the desired product:
User Manual (Baseboard)
Detailed hardware descriptions, installation steps, jumper settings, connector layouts and troubleshooting tips.
User Manual (Module)
Electrical specifications, interface overviews, software setup guides and reference tables.
Datasheets
Absolute maximum ratings, timing diagrams and ordering information.
Customer Info Archive (Starter Kit Customers)
The archive includes:
- Mainboard schematic & placement diagram
- Module CAD files (native format)
- Module mechanical dimensions (2D/3D drawings)
- Pinmuxing configuration (recommended device tree fragments)
- Pinout reference (signal assignments, voltage domains)
- Design checklist (layout guidelines, EMI/ESD considerations)
- Processing instructions (LGA Modules)
BSP Tagging and Revisioning
BSP Git Tagging and Revisioning
TQ manages all Board Support Package (BSP) releases in the meta-tq GitHub repository using annotated Git tags. This ensures each release is traceable to an exact source snapshot and clearly documents which Yocto branch, platform (module) and software revision it covers.
Tag Format:
<YoctoBranch>.<ModuleIdentifier>.TQ.ARM.BSP.<RevisionNumber>
| Component | Description |
|---|---|
| YoctoBranch | Name of the Yocto Project release (e.g. kirkstone, scarthgap) |
| ModuleIdentifier | Target module name when present; omitted entirely for “scarthgap” tags |
| TQ.ARM.BSP | Literal marker for “Board Support Package – Software” |
| RevisionNumber | Four-digit, zero-padded incrementing counter (e.g. 0001, 0002, …) |
Examples:
kirkstone.TQMa64xxL.BSP.SW.0008
scarthgap.BSP.SW.0001 – here no module identifier is used
Supported Platforms Reference:
To see exactly which platforms (machines/boards) each BSP tag covers, open the meta-tq folder in that tag and view its README.md:
/tq-systems/meta-tq/tree/<git-tag>/meta-tq
Click on README.md there to find the full list of Yocto machine names, board variants, RAM options and support status.
Get Notified
In order to be automatically notified of new BSP releases by e-mail, you must activate notifications in the corresponding Github repository.
1. Go to the desired repository in Github (e.g. meta-tq)
2. Click on the notification button
in the top right corner. 3. Log in or create a Github account if you have not already done so.
4. Select “All activity” so that you will be notified of every new release.
Software Versions:
For the exact versions of U-Boot, Linux kernel and other components used in a BSP tag, view doc/README.SoftwareVersions.md in that tag.
tq-systems/meta-tq/blob/<git-tag>/meta-tq/doc/README.SoftwareVersions.md
Current BSP Information
U-boot
U-Boot
Support matrix for MBa91xxCA REV.010x / MBa93xxCA REV.020x
| Feature | u-boot-imx-tq_2024.04 |
|---|---|
| RAM configs | 0.5 / 1 GiB |
| inline ECC | x |
| CPU variants | i.MX91 |
| Fuses / OCRAM | x |
| speed grade / temperature grade detection | x |
| UART (console on UART1) | x |
| GPIO | |
| LED | x |
| Button | x |
| I2C | |
| system EEPROM parsing | x |
| PMIC | x |
| eMMC / SD | |
| Read | x |
| Write | x |
| Ethernet | |
| GigE / FEC via Phy on MBa91xxCA | x |
| GigE / EQOS via Phy on MBa91xxCA | x |
| Bootdevices | |
| SD card on USDHC2 | x |
| eMMC on USDHC1 | x |
| QSPI-NOR on FlexSPI | x |
| Serial Downloader | x |
| USB | |
| USB 2.0 Host / Hub | x |
| USB DRD (USB 2.0 Cable Detect, VBUS) | x |
| (configured as device to be usable with UUU ) | |
| QSPI NOR | |
| Read with 1-1-4 SDR | x |
| PP / Erase with 1-1-4 SDR | x |
Linux
Linux
Support matrix for MBa91xxCA REV.010x / MBa93xxCA REV.020x
| Feature | linux-imx-tq_6.6 |
|---|---|
| RAM configs | 0.5 / 1 GiB |
| CPU variants | i.MX91 |
| Fuses / OCRAM | x |
| EDAC / ECC | x |
| speed grade / temperature grade detection | |
| UART | |
| console on UART1 (via USB / UART converter) | x |
| UART2 | x |
| GPIO | |
| LED | x |
| Button | x |
| I2C | |
| EEPROMs | x |
| PMIC | x |
| RTC | x |
| Temperature Sensors | x |
| IMU / Gyroscope | x |
| Port expander | x |
| ENET | |
| GigE / FEC via Phy on MBa9[1,3]xxCA | x |
| GigE / EQOS via Phy on MBa9[1,3]xxCA | x |
| USB | |
| USB 2.0 Host / Hub | x |
| USB DRD (USB 2.0 Cable Detect, VBUS) | x |
| QSPI NOR | |
| Read with 1-1-4 SDR | |
| Read with 1-4-4 SDR | |
| PP / Erase with 1-1-4 SDR | |
| PP / Erase with 1-4-4 SDR | |
| Display (MBa91xxCA only) | |
| LVDS via Bridge | x |
| DPI / RGB | x |
| CAN-FD | |
| CAN-FD | x |
| SPI | |
| spidev at all CS | x |
| internal ADC | |
| ADC | x |
I2C Devices
Onboard I2C Devices
| I2C Bus - TQMa91xxCA | |||||||||
|---|---|---|---|---|---|---|---|---|---|
| I2C1 | 0x1B Tempsensor | 0x25 PMIC | 0x33 EEPROM SW Protect | 0x48 Plug & Trust Secure Element (optional) | 0x51 RTC (optional) | 0x53 EEPROM | 0x57 EEPROM | 0x57 EEPROM (identification page) | 0x6A Gyroscope (optional) |
| I2C Bus - MBa91xxCA | |||||||
|---|---|---|---|---|---|---|---|
| I2C3 | 0x1C Tempsensor | 0x34 EEPROM SW Protect | 0x50 USB-C Power Delivery Controller | 0x54 Tempsensor EEPROM | 0x70 Port-Expander 1 | 0x71 Port-Expander 2 | 0x72 Port-Expander 3 |
Changelog
Changelog BSPs
Changelog PRE-RELEASE
Added
-
u-boot-2026.01: add TQMa62xx and TQMa64xxL 1GiB Nanya RAM variants
Alternative RAM vendor needs a different configuration. RAM type detection and initialisation is handled in boot firmware
-
imx-atf-tq: add support for v2.12 based on NXP lf_v2.12 branch
-
qoriq-atf: add support for v2.12 based on NXP lf_v2.12 branch
Add support for TQMLS1012AL, TQMLS10xxA, TQMLS1028A, TQMLX2160A
- linux-rt-tq-6.12: update to v6.12.89-rt18
- linux-rt-tq-6.12: incorporate TQ-Systems fixes from linux-tq-6.12
- linux-rt-tq-6.6: update to v6.6.135-rt75
- linux-tq-6.12: update to v6.12.90
- linux-tq-6.6: update to v6.6.140
- linux-imx-tq-6.6: update from linux-fslc incl. v6.6.138
-
tqma93xx-mba93xxca/la: fix distroboot flow for rpmsg and lvds configs with linux-imx-tq
Use correct overrides for the BSP flavour to generate the menu entries and use correct overlay name for rpmsg menu item. Otherwise no configurations were generated for NXP BSP flavour and the remoteproc device tree overlay was silently not applied.
-
u-boot-imx-tq-2024.04: TQMa8MPxL / TQMa8MPxS
Add missing check for started Cortex-M and add
clk-imx8mp.mcore_booted=1to kernel command line to prevent swithcing off unused clocks. Otherwise a running firmware on Cortex-M will stop during kernel boot. -
linux-tq-6.12:
- includes fix for
Copy fail(CVE-2026-31431) - includes fix for
Dirty frag(CVE-2026-43284)
- includes fix for
-
linux-tq-6.6:
- includes fix for
Copy fail(CVE-2026-31431) - includes fix for
Dirty frag(CVE-2026-43284)
- includes fix for
-
linux-imx-tq-6.6:
- includes fix for
Copy fail(CVE-2026-31431) - includes fix for
Dirty frag(CVE-2026-43284)
- includes fix for
- imx-atf-tq-2.10: remove recipe, all users were updated to use imx-atf-tq-2.12
- qoriq-atf-2.10: remove recipe, all users were updated to use qoriq-atf-2.12
- u-boot-tqmt-2015.07: TQMT10xx variants using this recipe are not supported under scarthgap.
- linux-tqmt-5.15: TQMT10xx variants using this recipe are not supported under scarthgap.
- machines: Remove TQMT10xx variants since they are not supported under scarthgap.