Embedded module TQMa8Mx - YOCTO Linux BSP documentation

Yocto Target Machines

TQMa8.BSP Revision Target machine
≥0030 tqma8mx-1gb-mba8mx
tqma8mx-2gb-mba8mx
tqma8mx-4gb-mba8mx
≥0010 tqma8mx-1gm-mba8mx
tqma8mx-2gm-mba8mx
≥0003 tqma8mq-1gm-mba8mx
tqma8mq-mba8mx
tqma8mq-2gm-mba8mx
0001 tqma8mq-mba8mx
tqma8mq-2gm-mba8mx


BSP Version Matrix - Old Revisions

BSP Revision meta-tq release Yocto Project / Poky Release Target machine1) U-Boot Linux Kernel
0080 hardknott 3.3.3 - Hardknott tqma8mx-1gb-mba8mx
tqma8mx-2gb-mba8mx
tqma8mx-4gb-mba8mx
v2020.04_imx_5.4.47_2.2.0 fslc-5.10-2.1.x-imx
0054 zeus-tqma8 3.0.3 - Zeus tqma8mx-1gb-mba8mx
tqma8mx-2gb-mba8mx
tqma8mx-4gb-mba8mx
v2019.04-lf-5.4.y-1.0.0 lf-5.4.y-1.0.0
0053 zeus-tqma8 3.0.3 - Zeus tqma8mx-1gb-mba8mx
tqma8mx-2gb-mba8mx
tqma8mx-4gb-mba8mx
v2019.04-lf-5.4.y-1.0.0 lf-5.4.y-1.0.0
0030 zeus-tqma8 3.0.3 - Zeus tqma8mx-1gb-mba8mx
tqma8mx-2gb-mba8mx
tqma8mx-4gb-mba8mx
v2019.04-lf-5.4.y-1.0.0 lf-5.4.y-1.0.0
0018 sumo-tqma8x 2.5.2 - Sumo tqma8mx-1gm-mba8mx
tqma8mx-2gm-mba8mx
v2018.03-rel_imx_4.14.98_2.2.0_ga rel_imx_4.14.98_2.2.0_ga
0017 sumo-tqma8x 2.5.2 - Sumo tqma8mx-1gm-mba8mx
tqma8mx-2gm-mba8mx
v2018.03-rel_imx_4.14.98_2.2.0_ga rel_imx_4.14.98_2.2.0_ga
0015 sumo-tqma8x 2.5.2 - Sumo tqma8mx-1gm-mba8mx
tqma8mx-2gm-mba8mx
v2018.03-rel_imx_4.14.98_2.2.0_ga rel_imx_4.14.98_2.2.0_ga
0014 sumo-tqma8x 2.5.2 - Sumo tqma8mx-1gm-mba8mx
tqma8mx-2gm-mba8mx
v2018.03-rel_imx_4.14.98_2.2.0_ga rel_imx_4.14.98_2.2.0_ga
0013 sumo-tqma8x 2.5.2 - Sumo tqma8mx-1gm-mba8mx
tqma8mx-2gm-mba8mx
v2018.03-rel_imx_4.14.98_2.2.0_ga rel_imx_4.14.98_2.2.0_ga
0012 sumo-tqma8x 2.5.2 - Sumo tqma8mx-1gm-mba8mx
tqma8mx-2gm-mba8mx
v2018.03-rel_imx_4.14.78_1.0.0_ga rel_imx_4.14.98_2.2.0_ga
0010 sumo-tqma8x 2.5.2 - Sumo tqma8mx-1gm-mba8mx
tqma8mx-2gm-mba8mx
v2018.03-rel_imx_4.14.78_1.0.0_ga rel_imx_4.14.78_1.0.0_ga
0008 sumo-tqma8x 2.5.2 - Sumo tqma8mq-1gm-mba8mx
tqma8mq-mba8mx
tqma8mq-2gm-mba8mx
v2018.03 rel_imx_4.14.78_1.0.0_ga rel_imx_4.14.78_1.0.0_ga
0007 sumo-tqma8x 2.5.2 - Sumo tqma8mq-1gm-mba8mx
tqma8mq-mba8mx
tqma8mq-2gm-mba8mx
v2018.03 rel_imx_4.14.78_1.0.0_ga rel_imx_4.14.78_1.0.0_ga
0004 sumo-tqma8x 2.5.2 - Sumo tqma8mq-1gm-mba8mx
tqma8mq-mba8mx
tqma8mq-2gm-mba8mx
v2018.03 rel_imx_4.14.78_1.0.0_ga rel_imx_4.14.78_1.0.0_ga
0003 sumo-tqma8x 2.5.2 - Sumo tqma8mq-1gm-mba8mx
tqma8mq-mba8mx
tqma8mq-2gm-mba8mx
v2017.03-rel_4.9.88_imx_imx8qxp_beta2 rel_imx_4.14.78_1.0.0_ga
0001 rocko-tqma8x 2.4.4 - Rocko tqma8mq-mba8mx
tqma8mq-2gm-mba8mx
v2017.03-rel_4.9.88_imx_imx8qxp_beta2 rel_imx_4.9.88_imx8qxp_beta2

Tip: Get notified on new BSP release


U-Boot

Supported features
Feature TQMa8.BSP Revisions Remarks
TQ Product Chip Interface Function 0081 - 0091
TQMa8Mx i.MX8M Cortex M4
TQMa8Mx i.MX8M ENET0 GbE
TQMa8Mx i.MX8M HDMI TX HDMI Fixed Resolution
TQMa8Mx i.MX8M I²C1 Bus Access
TQMa8Mx i.MX8M I²C2 Bus Access
TQMa8Mx i.MX8M I²C3 Bus Access
TQMa8Mx i.MX8M LPUART3 Debug Console default console
TQMa8Mx i.MX8M uSDHC eMMC / SD-Card SD card / eMMC
TQMa8Mx i.MX8M Fuse
TQMa8Mx i.MX8M USB USB Host
TQMa8Mx i.MX8M USB DRD USB Host Host only
TQMa8Mx i.MX8M GPIO GPIO
TQMa8Mx i.MX8M QSPI QSPI NOR

U-Boot - Old Revisions

Feature BSP Revision Remarks
TQ Product Chip Interface Function 0001 0003 0004 0007 0008 0010 0012 0013 0014 0015 0017 0018 0030 0053 0054 0056 0080
TQMa8Mx i.MX8M Cortex M4
TQMa8Mx i.MX8M ENET0 GbE
TQMa8Mx i.MX8M HDMI TX HDMI Fixed Resolution
TQMa8Mx i.MX8M I²C1 Bus Access
TQMa8Mx i.MX8M I²C2 Bus Access
TQMa8Mx i.MX8M I²C3 Bus Access
TQMa8Mx i.MX8M LPUART3 Debug Console default console
TQMa8Mx i.MX8M uSDHC eMMC / SD-Card SD card / eMMC
TQMa8Mx i.MX8M Fuse
TQMa8Mx i.MX8M USB USB Host
TQMa8Mx i.MX8M USB DRD USB Host Host only
TQMa8Mx i.MX8M GPIO GPIO
TQMa8Mx i.MX8M QSPI QSPI NOR

Supported boot devices

Boot device supported
eMMC
SD Card

Linux

Feature TQMa8.BSP Revisions Remarks
TQ Product Chip Interface Function 0081 - 0091
TQMa8Mx i.MX8M CSI Camera Sensor Interface Tested with Vision Components Camera Modules:
* imx327
* ov9281
i.MX8M DSI Display Serial Interface Tianma TM070JVHG33
i.MX8M ENET0 RGMII
i.MX8M ECSPI1 spidev
i.MX8M ECSPI2 spidev
i.MX8M GPIO GPIO
i.MX8M HDMI TX HDMI HDMI audio working with BSP Rev. ≥ 0013
i.MX8M I²C1 Bus access See onboard I2C devices
i.MX8M I²C2 Bus access See onboard I2C devices
i.MX8M I²C3 Bus access See onboard I2C devices
i.MX8M LPUART3 Debug Console Console UART changed from UART1 to UART3 on MBa8Mx ≥ Rev.2xx
i.MX8M USB3 TUSB8041I
(USB Hub)
i.MX8M USB DRD Host
OTG
i.MX8M uSDHC eMMC / SD
i.MX8M PCIe PCI Express™ PCIe only tested with Gen 1
i.MX8M Mini PCIe
i.MX8M PWM4 Buzzer
i.MX8M QSPI Bus access /
Memory access
QSPI limited to SDR (driver / chip compatibility)
i.MX8M SAI3 TLV320AIC3204
MBa8Mx TLV320AIC3204 Audio Codec Line Out
MBa8Mx TLV320AIC3204 Audio Codec Line In
SN65DSI84 DSI to LVDS Bridge LVDS Only on MBa8Mx Rev.02xx
PCA9555BS GPIO Port Expander GPIO
TUSB8041I USB1 (USB 3.0) Host 1
TUSB8041I USB2 (USB 3.0) Host 2
TUSB8041I USB3 (USB 2.0) Host 3
TUSB8041I USB4 (USB 2.0) Host 4

Linux - Old Revisions

Feature BSP Revision Remarks
TQ Product Chip Interface Function 0001 0003 0004 0007 0008 0010 0012 0013 0014 0015 0017 0018 0030 0053 0054 0056 0080
TQMa8Mx i.MX8M CSI Camera Sensor Interface Tested with Vision Components Camera Modules:
* imx327
* ov9281
i.MX8M DSI Display Serial Interface Tianma TM070JVHG33
i.MX8M ENET0 RGMII
i.MX8M ECSPI1 spidev
i.MX8M ECSPI2 spidev
i.MX8M GPIO GPIO
i.MX8M HDMI TX HDMI HDMI audio working with BSP Rev. ≥ 0013
i.MX8M I²C1 Bus access See onboard I2C devices
i.MX8M I²C2 Bus access See onboard I2C devices
i.MX8M I²C3 Bus access See onboard I2C devices
i.MX8M LPUART3 Debug Console Console UART changed from UART1 to UART3 on MBa8Mx ≥ Rev.2xx
i.MX8M USB3 TUSB8041I
(USB Hub)
i.MX8M USB DRD Host
OTG
i.MX8M uSDHC eMMC / SD
i.MX8M PCIe PCI Express™ PCIe only tested with Gen 1
i.MX8M Mini PCIe
i.MX8M PWM4 Buzzer
i.MX8M QSPI Bus access /
Memory access
QSPI limited to SDR (driver / chip compatibility)
i.MX8M SAI3 TLV320AIC3204
MBa8Mx TLV320AIC3204 Audio Codec Line Out
MBa8Mx TLV320AIC3204 Audio Codec Line In
SN65DSI84 DSI to LVDS Bridge LVDS Only on MBa8Mx Rev.02xx
PCA9555BS GPIO Port Expander GPIO
TUSB8041I USB1 (USB 3.0) Host 1
TUSB8041I USB2 (USB 3.0) Host 2
TUSB8041I USB3 (USB 2.0) Host 3
TUSB8041I USB4 (USB 2.0) Host 4

TQMa8Mx / MBa8Mx

I2C bus TQMa8Mx
I2C1 0x08
PMIC
0x1B
Tempsensor
0x33
EEPROM SW Protect
0x53
EEPROM
0x57
EEPROM
0x51
RTC
I2C bus MBa8Mx
I2C1 0x11
System controller
0x23
Portexpander
0x24
Portexpander
0x25
Portexpander
I2C2 0x18
Audio Codec
0x37
EEPROM SW Protect
0x44
USB Hub
0x57
EEPROM
0x68
PCIe Clock generator
0x1F
Tempsensor
I2C3 0x2D
LVDS Bridge
0x2C
eDP Bridge
also available at
Mini PCIe (X28), Mikro Bus (X20 / X21), PCIe (X36), MIPI-CSI (31)


BSP Version History

Rev.0087

BSP

  • Update to Yocto Kirkstone

U-Boot

  • Backport MMU table fixxes from upstream
  • Backport U-Boot relocation and RAM size fixes from upstream

Linux

  • Linux 5.15 support based on linux-fslc 5.15 + imx

Rev.0080

BSP

  • Update to Yocto Hardknott
  • Update sub modules to support hardknott
  • Port TQMa8 boards from branch zeus-tqma8
  • Rework systemd-machine-units bbappend (add simplification from branch zeus-tqma8, adapt to newer systemd version with CAN FD support)
  • Support for linux 5.10 based on linux-fslc 5.10
    • Experimental usb support for ath10k
    • Adjusted kernel config settings
  • Weak assignments in machine files wherever possible to allow overwriting for custom mainboards or project specific tailoring
  • Add ubi as MACHINE_FEATURE if [Q]SPI NOR is supported by machine

Rev.0054

Linux

  • Label sys EEPROM as read only
  • Add RAW/Bayer formats for imx8_mipi_csi2 and mx8-isi-cap

Rev.0053

BSP

  • Prepare support for Vision Components GmbH MIPI CSI cameras
  • add MACHINE_FEATURE 'camera'

U-Boot

  • Allow chip REV. 2.2
  • Apply fix for PCIe PHY VPH
    • Disable VREG_BYPASS early to ensure using the CPU internal regulator for PCIe Phy when supplying with 3.3 V

Linux

  • Added drivers for Vision Components GmbH MIPI CSI cameras with Sony IMX327 and Omnivision OV9281
  • Add device trees for camera support
  • Apply NXP fix for PCIe Phy VPH @ 3.3V
  • Disable PCIe L1SS
  • Enable more RAW/Bayer formats for mxc_mipi_csi and mxc-mipi-csi2_yav
  • improve kernel config
    • Remove ACPI
    • Remove unused audio stuff
    • Remove unused net devices
  • Enable Vision Components GmbH MIPI CSI cameras

Rev.0030

BSP

  • Update to Yocto Zeus
  • Update to Linux kernel lf-5.4.y-1.0.0
  • Update to U-Boot v2019.04-lf-5.4.y-1.0.0
  • Integrate CortexM examples for TQMa8Mx
  • First version of CortexM examples for TQMa8Mx
  • Add configuration for TQMa8Mx with 4 GiB RAM
  • Include RPMSG examle device tree
  • Rename an include (mba8mx.inc → tqma8mx-mba8mx.inc)

U-Boot

  • Compatibility to MBa8Mx REV.0300
  • Add dt examle for M4 / RPMSG
  • Support for variant with 4 GiB RAM
  • Restrict SPL size. Use only configured DDR timing to prevent SRAM overflow
  • Use devicetree to configure MMC env settings
  • Increase env size to 32 kiB
  • Cleanup and cosmetic in config header
  • tqc-rtc improvements (offset, clkout)
  • Fix USB Support. DM_USB and DWC3 for i.MX8M are not 100% compatible when using with non Type-C dual role setup
  • backport device tree fixes from NXP upstream:
    • MLK-24483-2: ecspi compatible to imx51-ecspi
    • MLK-24383: Change the noc clock setting
  • Fix compiler warning in spl

Linux

  • Compatibility to MBa8Mx REV.0300
  • TQMa8Mx: add dt examle for HDMI
  • fix imx-spi for GPIO chip select
  • switch to gpio CS for SPI (device tree change, should fix spi communication issues)

Rev.0018

BSP

  • Optimize environment settings
  • Change console UART1 → UART3
  • Unified wic config
  • Board header cleanup

U-Boot

  • Change console UART1 → UART3
  • Generate local version
  • QSPI optimized pad settings
  • QSPI driver 4 byte addressing
  • WDOG_B pin as hog pin

Linux

  • Change console UART1 → UART3
  • Fix dt for LVDS over DSI @ eLCDIF
  • Fix generating local version
  • Increase CMA size to 640 MB
  • Fix simple-panel settings for tianma LVDS display
  • Add support for PWM
  • Add support for mikroBUS module RTC5
  • QSPI optimized pad settings
  • Backport some ASoC patches
  • Ressource leak fixes for imx-tlv320aic32x4

Rev.0017

BSP

  • meta-tq: added u-boot-fw-utils support
  • tqma8mq: linux: increase QSPI NOR frequency

Linux

  • tqma8mq: linux: add UARTS 2,3,4

Rev.0015

BSP

  • conf: use device tree name logic for kernel and image also for non TQMa8Mx boards
  • tqma8mx: linux: update audio settings in dt for new kernel version
  • u-boot: new RAM timing for TQMa8Mx
  • scfw: update to version 1.2.7
  • rework imx-sc-firmware recipe (use git tag in package name = needs tq_imx-scfw-v1.2.7-b3357 or later)
  • tqma8mx: add support for MBa8Mx Rev.020x

U-Boot

  • tqma8mx: u-boot: QSPI support
  • tqma8mx: u-boot: USB HUB support for MBa8x Rev.020x
  • tqma8mx: u-boot: manufacturer EEPROM
  • tqma8mx: u-boot: lot of GPIO are requested and preconfigured

Linux

  • tqma8mx: linux: QSPI support
  • tqma8mx: linux: SD3 / USDHC support
  • tqma8mx: linux: rtc / rtc alarm
  • tqma8mx: linux: USB OTG (USB 2.0 only)
  • tqma8mx: linux: HDMI audio
  • tqma8mx: linux: PCIe Slot
  • tqma8mx: linux: GPIO buttons
  • tqma8mx: linux: GPIO LED
  • tqma8mx: linux: LVDS via DSI bridge on MBa8x REV.0x20x

Rev.0014

  • new RAM timing for TQMa8Mx

Rev.0013

  • remove backported versions of imx-atf, use now imx_4.14.98_2.2.0
  • update U-boot version to imx_4.14.98_2.2.0 version
  • alsa-state installs now the correct file for tqma8mx codec
  • working sound output on codec with aplay
  • working sound output on codec and HDMI with gstreamer / pulsesink

Rev.0012

  • Update to Linux kernel rel_imx_4.14.98_2.2.0
  • Uboot prepare using NXP release rel_imx_4.14.98_2.2.0
  • temporary use older versions of imx-atf for TQMa8

Rev.0010

  • machine config tqma8mq-mba8mx is not longer supported
  • Rename machine config from tqma8mq_[1,2]gm_mba8mx to tqma8mx_[1,2]gm_mba8mx all CPU derivates are supported (i.MX8M[D,Q,QL])
  • TQMa8Mx revision 020x support
  • RAM Timing with better power management support (CPU revision 2.1)
  • U-Boot supports both machine configurations / devicetree is set automatically before booting
  • U-Boot shows correct module name (TQMa8M[D,Q,QL])
  • added packages for performance analysis (iotop, dstat, atop)
  • updates for weston, busybox and images
  • disabled ssh login without password

Rev.0008

  • improved LVDS support (SPWG 18 + 24 Bit)
  • INNOLUX LVDS display 18/24 Bit support
  • Device support on I2C2 bus
  • initial sound driver (asound.state missing, playback is only working after configuring codec with amixer)
  • additional packages in tq-image-generic image recipe (Firmware, systemd compatibility)
  • improved configuration settings in ci-meta-tq

Rev.0007

  • Ethernet LED configuration fixes
  • e-MMC boot environment fixes
  • DT fixes for TMU

Rev.0004

  • LVDS support
  • Netboot support (Rootfs via NFS)
  • support for eMMC HS modes
  • added opensssh in Rootfs
  • remove meta-gnome

Rev.0003

  • port to yocto sumo
  • added machine tqma8mx with 1GB RAM

Rev.0001

  • initial release



1)
i.e. value for MACHINE variable
  • Last modified: 2023/12/18 15:24