TQMa67xx - YOCTO Linux BSP documentation

Overview

The TQMa67xx provides a robust embedded module platform powered by Texas Instruments’ Jacinto AM67x processor family. 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.

For each Board Support Package (BSP), the corresponding modules are versioned under the matching Git tag in our GitHub repository. Simply check out the tag that matches your BSP release, then open the module’s README file in the “doc” folder to find detailed information.

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 Customer Info Archive is provided upon purchase of a Starter Kit and is released on request by TQ Support. To obtain it, please open a Support Ticket with your order details.

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

Enable Notifications:
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
RAM configs 2 GiB, 8GiB
CPU variants AM67A94
UART (console on UART0) x
GPIO x
I2C x
System EEPROM parsing x
eMMC / SD x
SPI-NOR x
Ethernet Port X14 only
Cortex-R5F Booted with DM firmware
Cortex-M4F no
Boot devices
eMMC x
SD card x
SPI-NOR x
USB Mass Storage (X10) x
USB DFU (X10) x
USB
USB Host (X10, via OTG adapter) USB Mass Storage boot only
USB Device (X10) All boot devices execpt for USB Mass Storage
USB Cable Detect / ID (X10) no
USB switchable VBUS (X10) no (fixed setting for boot device)
USB Host (X11, internal HUB) x

Linux

Linux

Feature
Suspend (deep / s2idle) no
UART
Console (UART0, via X7 USB / UART converter) x
RS485 (MCU_UART0) x
GPIO
LED x
Button x
I2C
EEPROMs x
PMIC x
RTC x
Temperature sensor x
Ethernet
2x Gigabit Ethernet x
1x Single-pair Gigabit Ethernet x
WLAN/Bluetooth
TI CC3351 WLAN/BT x
CAN
2x CAN with CAN FD x
USB
USB (X10: Dual role, Cable Detect, VBUS) x
USB (X11: Host ports on internal hub) x
BG95 IoT module (Virtual UART on internal hub) x
PWM
LVDS Backlight x
Fan control x (disabled by default)
SPI-NOR
Read with 1-4-4 SDR x
Write / erase with 1-4-4 SDR x
Graphics
GPU x
Display
LVDS x
DSI (X24: RasberryPi 7") x
Audio
Analog audio (Line-out, Line-in, Microphone) x
MIPI-CSI
Grayscale with Vision Components camera (X18: Sensor OV9281) x
Raw Bayer with Vision Components camera (X18: Sensor IMX327) x
Raw Bayer with RaspberryPi camera module (X19/X20: Sensor IMX219) x

SoC Security States (GP, HS-FS, HS-SE)

State Full Name Description
GP General Purpose In this baseline state, the SoC lacks active hardware security mechanisms. The boot process is completely open, meaning the system loads and executes firmware without verifying cryptographic signatures or requiring authentication.
HS-FS High Security – Field Securable This is the default state in which chips are shipped from the factory. Fundamental protection mechanisms—such as securing the ROM code, specific hardware peripherals, and internal manufacturer keys—are already active, and the DMSC (Device Management and Security Controller) is locked. However, because the user has not yet programmed their own custom keys into the hardware at this stage, the system does not strictly enforce secure boot (mandatory software authentication) during startup.
HS-SE High Security – Security Enforced This represents the final, fully secured state intended for the finished end product. It is irreversibly activated once the user has programmed (blown) and enabled their own cryptographic keys within the chip. From this point forward, all security architectures are strictly enforced: internal secrets are thoroughly isolated, and the processor will only execute firmware that carries a valid cryptographic signature and can be fully authenticated.
More information about this can also be found here:

I2C Devices

Onboard I2C Devices

I2C Bus - TQMa67xx
I2C1 0x1B
Tempsensor in EEPROM 		0x25
PMIC 		0x48
Plug & Trust Secure Element
(optional) 		0x51
RTC 		0x53
EEPROM 		0x6A
Gyroscope
I2C Bus - MBa67xx
I2C3 0x0F
DisplayPort bridge 		0x18
Audio Codec 		0x1C
Tempsensor 		0x34
EEPROM SW Protect 		0x44
USB Hub 		0x54
Tempsensor EEPROM 		0x6A
PCIe Clock generator

Changelog

Changelog BSPs

scarthgap.TQ.ARM.BSP.0008

Added

  • linux-tq-6.12:
    • TQMa8MPxS: support for hardware REV.0300
    • TQMa93xx: support EDAC for inline ECC
  • imx-system-manager-tq:
    • prepare TQMa94xxLA / MBa94xxCA
  • imx-oei-tq:
    • prepare TQMa94xxLA / MBa94xxCA
  • linux-imx-tq-6.12:
    • TQMa95xxLA / TQMa95xxSA: support thermal zones for PMIC temperature sensors

Changed

  • u-boot-imx-tq-2024.04:

    • TQMa8MPxS: add support for hardware revision 030x

  • rcw: update TQMLS1028A PCIe configuration

    • The default RCW was renamed from "default" to "8_5_11_14", providing SGMII, QSGMII, PCIe Gen2 and SATA
    • A second RCW variant "8_5_11_11" was added, providing SGMII, QSGMII, PCIe Gen3, but no SATA

  • linux-ti-tq-6.12: update to latest ti-linux-6.12.y

  • linux-rt-tq-6.12: update to v6.12.74-rt16

  • imx-system-manager-tq: update to NXP version lf-6.18.2_1.0.0

    This integrates all fixes and features from NXP release and port supported boards from TQ-Systems. Switch to use new branch TQM-lf-6.18.2

  • imx-oei-tq: update to NXP version lf-6.18.2_1.0.0

    This integrates all fixes and features from NXP release and port supported boards from TQ-Systems. Switch to use new branch TQM-lf-6.18.2

  • linux-imx-tq-6.12:

    • TQMa95xxLA / TQMa95xxSA: support thermal zones for PMIC temperature sensors
    • integrate fixes from NXP lf-6.12.49-2.2.0

  • linux-imx-tq-6.6:

    • enable CONFIG_PTP_1588_CLOCK
    • integrate fixes from FSLC 6.6-2.2.x-imx

    This includes fixes from linux-stable up to tag v6.6.129

  • imx-system-manager-tq: update to NXP version lf-6.12.49_2.2.0

    • prepare TQMa94xxLA / MBa94xxCA
    • TQMa95xxLA/TQMa95xxSA: improve debug UART support code

  • imx-oei-tq: update to NXP version lf-6.12.49_2.2.0

    • prepare TQMa94xxLA / MBa94xxCA
    • TQMa95xxLA/TQMa95xxSA: improve debug UART support code

  • linux-ti-tq-6.12: enable rpmsg_ctrl kernel module

  • u-boot-imx-tq-2025.04:

    • Enable U-Boot environment handling from rootfs

    • Update to NXP downstream version lf-6.12.49_2.2.0

      • prepare for TQMa94xxLA

      • TQMa95xxLA/TQMa95xxSA: simplify and implrove board support code

        Use board_phys_sdram_size generic implementation under arch/arm/mach-imx and handle CPU variants with features disabled by fuses

    • TQMa95xxLA: FlexSPI boot support

  • imx-boot-tq:

    • prepare building for i.MX94

    • i.MX9[4,5]: do not build FlexSPI boot images for Octal SPI with DTR and DQS by default

      Not all boards have Octal SPI assembled. Use generic but slower setup by default. If needed this can be configured per board using modified QSPI_HEADER environment.

    • update to use upstream version lf-6.12.49-2.2.0

  • linux-imx-tq-6.12:

    • enable CONFIG_PTP_1588_CLOCK
    • Prepare config fragments for TQMa94xxLA / MBa94xxCA support
    • TQMa95xxLA:
      • FlexSPI support
      • 10GiGE support
      • dual LVDS example

  • linux-tq-6.6:

    • enable CONFIG_PTP_1588_CLOCK
    • update to 6.6.129

  • linux-rt-tq-6.6-rt: update to v6.6.129-rt70

  • linux-tq-6.12:

    • TQMa8MPxS: enable Eqos / TSN multiple queue support
    • enable CONFIG_PTP_1588_CLOCK
    • update to v6.12.76

Fixed

  • linux-tq-6.12:

    • TQMa8MPxS: correct GPIO for RTC interrupt

    • TQMa8MPxS: fix ethernet phy IRQ

    • TQMa8MPxS: correct SD-Card supply

      When reinserting the card under Linux card detect was not functional

  • linux-ti-tq-6.12:

    • TQMa62xx/TQMa67xx: fix dual-channel LVDS example Device Tree

  • linux-imx-tq-6.12: TQMa95xxLA: fix RTS / CTS pad configuration for LPUART5 / LPUART7.

    UART did not work with activated hardware flow control.

  • imx-system-manager-tq:

    • TQMa95xxSA: fix DDR ranges.

      The ranges shall reflect the assembled RAM size, not the addressable range of the DDR controller

  • u-boot-imx-tq-2025.04:

    • TQMa95xxLA: correct FlexSPI pin muxing

      Muxing uses wrong pads. Thus FlexSPI could not be used.

Removed

  • linux-ti-tq-6.6: remove recipe after all boards are updated to 6.12
  • linux-tq_6.1: remove recipe after all boards are updated to 6.6 or 6.12
  • linux-rt-tq_6.1: remove recipe after all boards are updated to 6.6 or 6.12
  • linux-imx-tq_6.1: remove recipe after all boards are updated to 6.6

scarthgap.TQ.ARM.BSP.0007

Added

  • u-boot-tq-2026.01: new recipe

    Replaces u-boot-tq-2025.10 for TQMa62xx[L]/TQMa64xxL/TQMa67xx[L].

  • TQMa95xxLA: add board support for MBa95xxCA

    This adds the board support based on the same recipe versions used for TQMa95xxSA

  • u-boot-imx-tq-2024.04:

    • TQMa91xx / TQMa93xx: inline ECC support
    • TQMa91xx: 512 MiB RAM configuration
    • TQMa8MPxL / TQMa8MPxS / TQMa91xx / TQMa93xx: distro boot as default
    • TQMa8MPxL / TQMa8MPxS / TQMa91xx / TQMa93xx: distro boot support for SPI-NOR

  • u-boot-tq-2025.10: new recipe (supports TQMa62xx[L]/TQMa64xxL/TQMa67xx[L])

  • TQMa91xxCA / TQMa91xxCA: add board support for MBa93xxCA

    board support is available with imx / nxp flavour only and uses linux-imx-tq-6.6

  • TQMa95xxSA: add board support for MB-SMARC-2

    This adds new versions for u-boot-imx-tq (based on NXP lf_v2025.04) and linux-imx-tq (based on NXP + FSLC 6.12-2.0.x-imx)

  • TQMa93xxLA: add board support for MBa93xxLA-MINI

    board support is available with mainline flavour only and uses linux-tq-6.12

  • TQMa93xxCA / TQMa93xxLA: enable LVDS for mainline linux-kernel on MBa93xxCA and MBa93xxLA

  • Build fitImage kernels by default

    KERNEL_IMAGETYPES now contains fitImage by default on all platforms. Note that the fitImage has not been tested on all machines yet.

  • Introduce KERNEL_IMAGETYPES_INSTALL

    KERNEL_IMAGETYPES_INSTALL can be used to select a subset of KERNEL_IMAGETYPES to install to the target images. By default, all images except for vmlinux are installed, unless "tiny" is listed in DISTRO_FEATURES. With the "tiny" distro feature, only the primary image defined via KERNEL_IMAGETYPE is installed.

  • linux-rt-tq-6.12: TQMLS102xA / TQMa335x:

    Update to branch containing all fixes from stable-rt. Mark recipe as compatible for these machines.

  • MicIn support for all platforms

    • Depending on the used hardware codec control adjustments might be necessary

Changed

  • Introduce "verity" distro feature

    Move verity support to a separate feature instead of enabling the build of verity images when the "secure" feature is set.

    The "secure" distro feature can now be enabled without setting DM_VERITY_IMAGE_TYPE

  • TQMa8MPxL/TQMa8MPxS/TQMa93xx/TQMa91xx:

    • Build kernel as fitImage

      The kernel is now combined with the Device Trees to a fitImage, which can optionally be signed using UBOOT_SIGN_ENABLE.

    • Use Distroboot by default

    • A new script-partition has been added to the SPI UBI to support distroboot

    • The ubi rootfs volume has been renamed from rootfs to root to conform with distroboot settings

  • TQMa91/93:

    • CONFIG_SYS_LOADADDR is no longer overridden by BSP
    • Shared memory of edgelock enclave is relocated within 512MB RAM region

  • imx-boot-tq: fix signature verification with UBOOT_SIGN_ENABLE

  • tq-bootscripts: sign scripts when UBOOT_SIGN_ENABLE is set

  • u-boot-imx-tq-2024.04:

    • TQMa8MPxL / TQMa8MPxS / TQMa91xx / TQMa93xx: use RTC driver

      Use dedicated RTC driver in favour of I2C direct access for fixups.

    • TQMa93xx/TQMa91xx: update DDR config and prepare for more variants

      Use configurations generated with up to date tools from NXP and use shared ddrphy_trained_csr to decrease space needed for SPL as already implemented for TQMa8MPxL

    • TQMa8MPxL / TQMa8MPxS: do not override CONFIG_SYS_BOOTM_LEN

  • TQMa62xx[L]: Add support for 1400MHz CPU frequency (in PMIC configurations with 0.85V core voltage)

  • TQMa67xx[L]/MBa67xx: Add support for SoM and Starterkit revisions 02xx, drop support for revisions 01xx

    DisplayPort support is now enabled by default.

  • linux-ti-tq-6.12:

    • Update to latest version of ti-linux-6.12.y (includes linux-stable up to v6.12.57 and the cc33xx WLAN and Bluetooth drivers version 1.0.2.10). cc33xx-fw has been updated to 1.7.0.323 for compatiblity with the new driver version.

  • doc: add MBa93xxLA-MINI

  • imx-boot-tq: simplify compile_prepare for i.MX8M / i.MX8 / i.MX8X

  • u-boot-imx-tq-2020.04:

    • TQMa8Mx / TQMa8Mx[M,N]L: always run fastboot when usb boot detected in uuu capable image

  • machines:

    • Only install kernel-devicetree when needed

      If the only installed kernel image is a fitImage, the DTBs do not need to be installed separately.

    • Set defaults for WKS_FILE, MACHINE_WKS_BOOTSTREAM, and WIC_BOOTPART_SIZE in module includes. They can still be overridden in individual machine configurations if needed.

  • imx-system-amanager-tq: update to NXP lf-6.12.20 baseline. This is needed to support newer i.MX95 chip revisions. While at it use common include from meta-freescale and prepare building without debug console / monitor.

  • imx-oei-tq: update to NXP lf-6.12.20 baseline. This gives better support for multiple DDR configurations and is needed for new i.MX95 chip revisions.

  • u-boot-imx-tq_2024.04:

    • TQMa8MPxL / TQMa8MPxS / TQMa93xx / TQMa91xx: improve defconfigs

      Remove unused commands and settings

    • TQMa8MPxL / TQMa8MPxS: Disable FASTBOOT_FSL in uuu defconfigs.

      This is an NXP downstream config with some bogus dependencies.

  • imx-boot-tq: TQMa8 / TQMa9

    Update to use NXP lf-6.12.20-2.0.0 release, needed for upcoming TQMa95xx support.

  • linux-tq-6.12:

    • TQMa8MPxL / TQMa8MPxS / TQMa93xx / TQMLS10xxA / TQMLX2160A / TQMLS102xA

      • allow using truested keys from different providers: CAAM, TPM, TEE
      • Integrate stable fixes up to tag 6.12.68

    • TQMa8MPxS

      Add Dual LVDS devicetrees (AUO G133HAN.01, AUO G185HAN.01)

  • linux-rt-tq-6.12: TQMa8MPxL / TQMa8MPxS / TQMa93xx / TQMLS10xxA / TQMLX2160A

    • Integrate fixes from TQ Systems downstream branch
    • Integrate stable fixes up to tag v6.12.64
    • Integrate stable-rt fixes up to tag v6.12.57-rt14

  • linux-imx-tq-6.6:

    • TQMa8Mx / TQMa8MxML / TQMa8MxNL / TQMa8Xx / TQMa8XxS / TQMa8x:
      • allow using truested keys from different providers: CAAM, TPM, TEE
      • Include stable fixes up to v6.6.119

  • linux-tq-6.6: TQMa6 / TQMa6UL[L]x[L] / TQMa7 / TQMa8Mx / TQMa8MxML / TQMa8MxNL:

    Include stable fixes up to v6.6.119

  • linux-rt-tq-6.6: TQMa6 / TQMa6UL[L]x[L] / TQMa7 / TQMa8Mx / TQMa8MxML / TQMa8MxNL:

    Include stable fixes up to v6.6.106-rt61

Removed

  • u-boot-tq-2025.10: TQMa62xx[L]/TQMa64xxL/TQMa67xx[L] use u-boot-tq-2026.01 now

Fixed

  • u-boot-tq-2026.01:

    • TQMa62xx[L], TQMa64xxL, TQMa67xx[L]: increase maximum cluster size for FAT filesystems from 16k to 64k, fixing U-Boot access to larger filesystems
    • TQMa62xx[L], TQMa64xxL, TQMa67xx[L]: fix U-Boot becoming unable to establish an Ethernet link on any interface when the connection on the interface tried first fails
    • TQMa67xx[L]: enable MBa67xx USB hub ports (X11) in U-Boot

  • linux-tq_6.12:

    • TQMa8MPxS: fix SD card reset

      Implement long reset pulse to guarantee a clean reset of the card to bring cards out of UHS signalling. Otherwise a card may not be detected.

    • TQMa93xx: fix eMMC detection at low temperatures

    At temperatures < -25°C eMMC data errors may be detected and detection only works with a retry. A warning in bootlog will be seen in this case. Detection works as expected with optimized pad configuration.

  • linux-imx-tq_6.6:

    • TQMa91xx / TQMa93xx: fix eMMC detection at low temperatures

    At temperatures < -25°C eMMC data errors may be detected and detection only works with a retry. A warning in bootlog will be seen in this case. Detection works as expected with optimized pad configuration.

  • u-boot-imx-tq_2024.04:

    • TQMa8MPxL / TQMa8MPxS / TQMa91xx / TQMa93xx: avoid address conflicts for boot scripts

      Select addresses in env to prevent overrides for use cases like PXE boot.

    • TQMa8MPxS: fix SD card reset

      Implement long reset pulse to guarantee a clean reset of the card to bring cards out of UHS signalling. Otherwise a card may not be detected.

    • TQMa8MPxL / TQMa8MPxS: fix secure boot for multi DDR config build

      When enabling additional features, SPL size with 4 DDR configs enabled does not fit in SRAM. All DDR configs have the same board specific ddrphy_trained_csr data. Share the data to save space for SPL.

    • TQMa8MPxL / TQMa8MPxS / TQMa91xx / TQMa93xx: enable cyclic watchdog service

      When watchdog is started but cyclic service is not configured the system will reboot after timeout. Add missing defconfig.

  • u-boot-imx-tq-2020.04:

    • TQMa8Mx / TQMa8Mx[M,N]L: fix uuu support

      Enable USB gadget support in u-boot devicetree and remove USB host support in favour of SDP on 8Mx[M,N]L

  • TQMa8 / TQMa9: fix default WKS_FILE assignment for machines

    Instead of using an anonymous python function use a named function and do an explicit assignment to make the assignment reproducible.

  • linux-[rt-]tq-6.12: TQMa93 (MBa93xxCA):

    Mark regulators for mPCIe Slot (X16) as always on. This is needed to support USB devices.

  • linux-imx-tq-6.6: TQMa93/TQMa91 (MBa93xxCA):

    Mark regulators for mPCIe Slot (X16) as always on. This is needed to support USB devices.

  • TQMa62xx, TQMa64xxL, TQMa67xx: Various fixes for compatibility with latest meta-ti (tag 11.01.12)

scarthgap.TQ.ARM.BSP.0006

Added

  • linux-rt-tq-6.12: TQMLS10xxA / TQMLX2160A:

    Mark recipe as compatible for these machines

  • TQMa8MPxS: add board support for SoM on MB-SMARC-2

  • TQMLX2160A: Add Secure Boot support

    See the TQMLX2160A README for more information. The current implementation only secures the boot process up to the bootloader. The kernel and userspace are not verified.

Changed

  • imx-atf-tq: TQMa8 / TQMa9:

    Include NXP fixes up to tag lf-6.6.52-2.2.1 and adjustments for Layerscape.

  • linux-rt-tq-6.6: TQMa6 / TQMa6UL[L]x[L] / TQMa7 / TQMa8Mx / TQMa8MxML / TQMa8MxNL:

    Include stable fixes up to v6.6.101 and stable-rt fixes up to v6.6.101-rt59

  • linux-tq-6.6: TQMa6 / TQMa6UL[L]x[L] / TQMa7 / TQMa8Mx / TQMa8MxML / TQMa8MxNL:

    Include stable fixes up to v6.6.102

  • linux-imx-tq-6.6: TQMa8 / TQMa9:

    Include NXP fixes up to tag lf-6.6.52-2.2.1 and stable fixes up to 6.6.101 from linux-fslc

  • linux-[rt-]tq-6.12: TQMa335x / TQMa93 / TQMa8MP / TQMLS10xx / TQMLX2160:

    • Include linux-stable fixes up to 6.12.41
    • configure STMMAC as built-in to support NFS root on boards with MDIO on STMMAC

  • machines: use require for machine config includes

  • alsa-state: enable IN3_L / Left Mixer input path (prepare MicIn support) for i.MX base SoM

  • layer.conf: add LAYERRECOMMENDS

  • doc:

    • Added known issues for TQMa1012AL, TQMLS102xA, TQMLS1028A
    • Added feature matrix for TQMa1012AL, TQMLS102xA
    • various improvements

Removed

  • u-boot-tq-2025.07: TQMa62xx[L]/TQMa64xxL/TQMa67xx[L] use u-boot-tq-2025.10 now

Fixed

  • TQMa62xx[L]/TQMa64xxL/TQMa67xx[L]: Fix MAC address assignments

    On each of these modules, two addresses more than intended (and reserved for the module) were assigned to ethXaddr variables in U-Boot.

    This issue is a regression in the new U-Boot version added in scarthgap.TQ.ARM.BSP.0005.

  • TQMLS102xA: Enable missing Linux drivers

  • TQMLS10xxA: Fix UBIFS rootfs partition selection

  • linux-tq-6.12: TQMLX2106A: Fix creation of multiple DPAA2 DPSW objects

  • u-boot-tq-2023.04: TQMa6x:

    Add errata workarounds for KSZ9031 ethernet phy to improve reliability of establishing a link.

  • u-boot-tq-2017.11: TQMLS102xA:

    Upstream device tree node naming for ESDHC controller was changes. Fix board specific DSR code to be compatibel with old and new naming.

  • u-boot-imx-tq-2024.04:

    FEC driver MDIO bus handling for enabled DM_MDIO and DM_ETH_PHY has several flaws that were hidden behind ifdefs. The code has fixes for the relevant code paths.

  • u-boot-tq-2023.04: TQMa7x:

    No MDIO bus was found after fixing several bugs in fec-mxc driver. Bug was caused by forcing unique MDIO bus names via device tree. Naming should be handled by FEC driver that creates the bus depending on Kconfig settings.

  • u-boot-lsdk-tq-2019.04: TQMLS1028A: Fix PCIe initialisation flow

    Backport some fixes to the initalisation flow, limit to Gen2 and add wait for link polling. Both the limitation and the polling loop improve compatibility to more cards, since bootloader support is crucial for working PCIe under Linux.

  • tq-bootconf: add reproducible default for 'FIT_CONF_PREFIX'

    When adding support to machines a reproducible default is needed to keep boot configurations and fitImages in sync.

  • TQMLS1012AL: Fix build with Secure Boot support

    Secure Boot on the TQMLS1012AL is build-tested only.

  • qoriq-atf: Fix hash calculation on all Layerscape platforms

    Fixes validation failure when Secure Boot is enabled.

Removed

  • u-boot-tq_2018.07: remove recipe after TQMLS10xxA was upgraded to v2022.04

scarthgap.TQ.ARM.BSP.0005

Added

  • TQMa67xx: new module

    The TQMa67xx SoM and its starterkit baseboard MBa67xx are a new platform based on the TI J722S/AM67(A) SoC family.

  • TQMa8MPxL:

    • add optionally usable RAUC A/B support
    • add optionally usable distroboot support (need to modify U-Boot bootcmd)

  • u-boot-imx-tq-2024.04:

    • support TQMa8MPxL on MBa8MPxL and MBa8MP-RAS414

  • linux-imx-tq-6.6:

    • support TQMLS1012AL
    • support TQMLS1028A

  • linux-tq-6.12:

    • support TQMLS102xA
    • support TQMLS10xxA
    • support TQMLX2160A

  • linux-ti-tq-6.12: New default kernel for TQMa62xx[L], TQMa64xxL and TQMa67xx[L]

  • u-boot-tq-2025.07: New U-Boot for TQMa62xx[L], TQMa64xxL and TQMa67xx[L]

    Differing from u-boot-ti-tq-2023.04, the A53 SPL stage (tispl.bin) has been dropped, simplifying and speeding up the boot process. The R5 SPL (tiboot3.bin) now directly boots into the U-Boot proper (u-boot.img).

  • TQMLS1028A:

    • u-boot-lsdk-tq: Insert MTD partitions into DT for Linux

  • TQMLX2160A:

    • Re-add SFP support
    • Install fitImage into root filesystem
    • Add SATA support in U-Boot

Changed

  • TQMa6ULx[L] / TQMa6ULLx[L]:

    • u-boot-tq-2023.04: enable some more features like gpio button, LED, CLI regulator and PMIC support.

  • tq-extlinux: The console option in the kernel cmdline is now populated based on SERIAL_CONSOLES instead of relying on the console and baudrate variables in the U-Boot environment

  • TQMLS1028A:

    • u-boot-lsdk-tq-2019.10:
      • update module EEPROM handling, use DM for I2C and I2C EEPROM
      • use GPIO HOG for inputs
      • update default devicetree name (matching updated kernel version)

  • u-boot-imx-tq-2024.04:

    • TQMa91 / TQMa93: enable watchdog support. The watchdog is used as sysreset provider. It can be enabled from console before booting kernel.

  • linux-tq-6.12:

    • use generic sound card name for MBa8Mx (TQMa8Mx, TQMa8MxNL, TQMa8MxNL), MBa8MPxL (TQMa8MPxL), MBa6ULxL (TQMa6ULx, TQMa6ULLx), MBa7x (TQMa7x)
    • include stable fixes up to v6.12.30

  • linux-tq-6.6:

    • use generic sound card name for MBa8Mx (TQMa8Mx, TQMa8MxNL, TQMa8MxNL), MBa8MPxL (TQMa8MPxL), MBa6ULxL (TQMa6ULx, TQMa6ULLx), MBa7x (TQMa7x)
    • include stable fixes up to v6.6.92

  • linux-imx-tq-6.6:

    • use generic sound card name for MBa8Mx (TQMa8Mx, TQMa8MxNL, TQMa8MxNL), MBa8MPxL (TQMa8MPxL), MBa6ULxL (TQMa6ULx, TQMa6ULLx), MBa7x (TQMa7x)
    • update with fixes from FSLC 6.6-2.2.x-imx branch including stable fixes up to v6.6.91

  • machines: use wic.zst instead of uncompressed wic for default IMAGE_FSTYPES for all machines. bmaptool supports also packed images, so we can lower the IO pressure for copying artifacts while keeping usability.

    The TQ_IMAGE_COMPRESSION variable (defined in meta-tq/conf/machine/include/tq-image.inc) can be adjusted in local.conf or a custom distro to use a different compression algorithm; setting it to an empty value will leave the files uncompressed.

  • u-boot-tq-2017.11:

    • TQMLS102xA: use external generated RCW images from rcw recipe instead of in tree RCW.

  • u-boot-lsdk-tq-2022.04:

    • TQMLS10xxA: adjust for node names in v6.12 Linux kernel

  • rcw:

    • TQMLS102xA: improve RCW generation
    • incorporate changes from NXP upstream since lf-5.15.32-2.0.0 up to tag lf-6.6.52-2.2.0 / lf-6.12.3-1.0.0

  • TQMLS102xA

    • Machine uses the common ALSA configuration (alsa-state)
    • Machine uses the common WKS file for ARMv7-A modules
    • Uses 'mainline' BSP as defined in meta-freescale

  • TQMLS1028A:

    • Use mainline BSP graphic software stack

  • TQMLX2160A:

    • u-boot-lsdk-tq-2019.04: Update XFI & retimer configuration

Removed

  • linux-ti-tq-6.1

    linux-ti-tq-6.1 has been obsolete since scarthgap.TQ.ARM.BSP.0001 in favor of linux-ti-tq-6.6. With the addition of linux-ti-tq-6.12 as the new default kernel for TQMa62xx[L]/TQMa64xxL/TQMa67xx[L], the linux-ti-tq-6.1 recipe is removed.

  • u-boot-ti-tq-2023.04: remove recipe

    Only u-boot-tq-2025.07 is supported for the TQMa62xx[L], TQMa64xxL and TQMa67xx[L] in future BSP releases.

  • linux-tq-5.4

    • TQMLS102xA is now supported by linux-tq-6.12

  • linux-rt-tq-5.4

    • Currently there is no replacement for RT-enabled kernel on TQMLS102xA
    • Support for newer kernels can be added on request

  • linux-imx-tq-5.15

    • Both TQMLS1012AL and TQMLS10128A are now supported by linux-imx-tq-6.6

  • MBaX4XxL

    • The legacy Image kernel image has been removed from the root filesystem

      We boot the fitImage by default since kirkstone.TQMa64xxL.BSP.SW.0007. U-Boot versions older than that release need to be updated, or a custom BSP image including Image in KERNEL_IMAGETYPES needs to be built.

Fixed

  • TQMa6x / TQMa6ULx[L] / TQMa6ULLx[L] / TQMa7x:

    • u-boot-tq-2023.04: fix FEC initialisation flow for compiling with DM_MDIO and DM_ETH_PHY without the fixes depending on presence of MAC addresses, multiple instances of MDIO bus will be allocated but never freed. If no MAC address is given, mdio command may cause an infinite loop.

  • TQMa6ULx[L] / TQMa6ULLx[L]:

    • u-boot-tq-2023.04: redundand environment was not configured but is expected by environment access tools in rootfs

  • machines: fix creation of multiple wic images for machines with a fixed boot firmware dependency to the actual assembled RAM.

    • TQMa6x
    • TQMa6ULx[L]
    • TQMa6ULLx[L]
    • TQMa7x
    • TQMa8Mx
    • TQMa8MxML

  • TMa8MPxL:

    • linux-tq-6.12: Fix SD-Card disconnect due to automatic disable of LDO5.

  • TQMLS1028A:

    • u-boot-lsdk-tq: implement reset pulse for PCIe and SATA ports, deactivate W_DISABLE (PCIE_DIS). This allows PCIe link training and PCIe device tree fixups. for Linux. Cards with bridges were previously not detected and handled in linux.
    • qoriq-atf: Fix applying errata #841119 and #826419 in Linux

  • TQMLS1088A:

    • Fix muxing of USB2_DRVVBUS/USB2_PWRFAULT. These pins were previously GPIO and could not be used for USB host power control.

  • TQMLX2160A:

    • Set snoop-delayed exclusive handling. Fixes load/store exclusive related issues
    • qoriq-atf: Fix applying errata #841119 and #826419 in Linux
    • Configure DPMAC 17 and 18 for SGMII in SERDES2 configs 7 and 11
      • RGMII usage is not supported in this case
    • Fix unreliable detection of onboard USB hub

  • u-boot-imx-tq-2024.04

    • TQMa93xx: Cortex M33 is usable again. Basic initialisation in secure Cortex A55 was hidden behind a conditional since TQMa91xx support was added

  • rcw

    • TQMLX2160A: Mux RGMII pins as GPIO if SGMII is used at SERDES2

The information provided on this wiki page is subject to change due to circumstances beyond our control. While we strive to keep all details as accurate and up-to-date as possible, it is possible that certain updates or changes may go unnoticed for some time. As a result, some sections of this page may contain outdated information. If you notice any mistakes in the documentation, we kindly ask you to inform the TQ Support through our ticket system.