TQMa93xxCA - YOCTO Linux BSP documentation
Overview
The TQMa93xxCA located on on the MBa93xxCA is based on NXP's i.MX 93xx. 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
| Feature | MBa93xxCA REV.020x | MBa93xxLA REV.020x | MBa93xxLA-MINI REV.020x |
|---|---|---|---|
| RAM configs | 1 / 1.5 / 2 GiB | 1 / 1.5 / 2 GiB | 1 / 1.5 / 2 GiB |
| inline ECC | x | x | x |
| CPU variants | i.MX93 | i.MX93 | i.MX93 |
| Fuses / OCRAM | x | x | x |
| speed grade / temperature grade detection | x | x | x |
| UART (console on UART1) | x | x | x |
| GPIO | |||
| LED | x | x | |
| Button | x | x | |
| I2C | |||
| system EEPROM parsing | x | x | x |
| PMIC | x | x | x |
| eMMC / SD | |||
| Read | x | x | x |
| Write | x | x | x |
| Ethernet | |||
| GigE / FEC via Phy on MBa93xxCA | x | x | x |
| GigE / EQOS via Phy on MBa93xxCA | x | x | x |
| Bootdevices | |||
| SD-Card on USDHC2 | x | x | x |
| eMMC on USDHC1 | x | x | x |
| QSPI-NOR on FlexSPI | x | x | see Known Issues |
| Serial Downloader | x | x | |
| USB | |||
| USB 2.0 Host / Hub | x | x | x |
| USB DRD (USB 2.0 Cable Detect, VBUS) | x | x | x |
| QSPI NOR | |||
| Read with 1-1-4 SDR | x | x | see Known Issues |
| PP / Erase with 1-1-4 SDR | x | x | see Known Issues |
| Cortex M33 | |||
| env settings for starting from TCM | |||
| examples with UART3 as debug console |
NOTE: for MBa93xxLA-MINI REV.010x is only be used for IBPQ. Customers will get REV.020x or later.
TODO or not tested / supported
- CPU variants with single core and without NPU
Linux
Linux
Support matrix for MBa93xxCA REV.020x and MBa93xxLA REV.010x
| Feature | linux-imx-tq_6.1 | linux-imx-tq_6.6 | linux-tq_6.12 |
|---|---|---|---|
| RAM configs | 1 / 1.5 / 2 GiB | 1 / 1.5 / 2 GiB | 1 / 1.5 / 2 GiB |
| CPU variants | i.MX93 | i.MX93 | i.MX93 |
| Fuses / OCRAM | x | x | x |
| speed grade / temperature grade detection | x | x | |
| Frequency scaling | x | ||
| UART | |||
| console on UART1 (via USB / UART converter) | x | x | x |
| UART2/3/4 | x | x | x |
| GPIO | |||
| LED | x | x | x |
| Button | x | x | x |
| I2C | |||
| EEPROMs | x | x | x |
| PMIC | x | x | x |
| RTC | x | x | x |
| Temperature Sensors | x | x | x |
| IMU / Gyroscope | x | x | x |
| Port expander | x | x | x |
| ENET | |||
| GigE / FEC via Phy on MBa93xxCA | x | x | x |
| GigE / EQOS via Phy on MBa93xxCA | x | x | x |
| USB | |||
| USB 2.0 Host / Hub | x | x | x |
| USB DRD (USB 2.0 Cable Detect, VBUS) | x | x | x |
| QSPI NOR | |||
| Read with 1-1-4 SDR | x | ||
| Read with 1-4-4 SDR | x | x | |
| PP / Erase with 1-1-4 SDR | x | ||
| PP / Erase with 1-4-4 SDR | x | x | |
| Display | |||
| LVDS | x | x | x |
| CAN-FD | |||
| CAN-FD | x | x | x |
| SPI | |||
| spidev at all CS | x | x | |
| internal ADC | |||
| ADC | x | x | x |
| Cortex M33 | |||
| examples running from TCM | see notes | see notes | |
| use UART3 as debug console (see issues) | x | x | |
| LPB boot | |||
| NPU | |||
| Firmware for CORTEX M33 | see issues | ||
| Demo | |||
| MIPI CSI (see Issues section) | |||
| Gray with Vision Components GmbH camera (Sensor OV9281) | |||
| Raw Bayer with Vision Components GmbH camera (Sensor IMX327) |
Onboard I2C Devices
TQMa93xxCA / MBa9xxxCA
| I2C bus | TQMa93xxCA | |||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
| I2C1 | 0x1B Temp Sensor | 0x25 PMIC | 0x33 EEPROM SW Protect | 0x48 Trusted Secure Element (optional) | 0x51 RTC | 0x53 EEPROM | 0x57 EEPROM | 0x5F EEPROM (Identification Page) | 0x6A Gyroscope (optional) |
|||
| I2C bus | MBa93xxCA | ||||||
|---|---|---|---|---|---|---|---|
| I2C3 | 0x1C Temperature Sensor | 0x34 EEPROM (Software Protection) | 0x50 USB-C Power Delivery Controller | 0x54 EEPROM | 0x70 I2C Port expander | 0x71 I2C Port expander | 0x72 I2C Port expander |
| I2C5 | 0x0F Display-Port Bridge | ||||||