Embedded module TQMa64xxL - YOCTO Linux BSP documentation

BSP Version Matrix

BSP Revision	ci-meta-tq release https://github.com/tq-systems/meta-tq	Yocto Project / Poky Release	Target machine¹⁾	U-Boot	Linux Kernel
0006	Kirkstone	4.0.13 - Kirkstone	tqma64xxl-mbax4xxl TQMa64xxL on MBaX4XxL	ti-u-boot 2021.01	ti-rt-linux-5.10.y
0005	Kirkstone	4.0.13 - Kirkstone	tqma64xxl-mbax4xxl TQMa64xxL on MBaX4XxL	ti-u-boot 2021.01	ti-rt-linux-5.10.y
0004	Kirkstone	4.0.9 - Kirkstone	tqma64xxl-mbax4xxl TQMa64xxL on MBaX4XxL	ti-u-boot 2021.01	ti-rt-linux-5.10.y
0003	Kirkstone	4.0.6 - Kirkstone	tqma64xxl-mbax4xxl TQMa64xxL on MBaX4XxL	ti-u-boot 2021.01	ti-rt-linux-5.10.y
0002	Kirkstone	4.0.6 - Kirkstone	tqma64xxl-mbax4xxl TQMa64xxL on MBaX4XxL	ti-u-boot 2021.01	ti-rt-linux-5.10.y
0001	Hardknott	3.3.6 - Hardknott	tqma64xxl-mbax4xxl TQMa64xxL on MBaX4XxL	ti-u-boot 2021.01	ti-rt-linux-5.10.y

Tip: Get notified on new BSP release

	TQMa64xxL		MBaX4xxL
BSP Rev.	Rev.01xx	Rev.02xx	Rev.01xx	Rev.02xx
0001	✔		✔
0002		✔		✔
0003	✔	✔	✔	✔
0004	✔	✔	✔	✔
0005	✔	✔	✔	✔
0006	✔	✔	✔	✔

U-Boot

Supported features

Feature				BSP Revision
TQ Product	Chip	Interface	Function	0001	0002	0003	0004	0005	0006
TQMa64xxL	AM64xx	GPIO		✔	✔	✔	✔	✔	✔
		I2C0	Bus access	✔	✔	✔	✔	✔	✔
		MCU_UART0	TTL	✔	✔	✔	✔	✔	✔
		MMC0	eMMC	✔	✔	✔	✔	✔	✔
		MMC1	SD Card	✔	✔	✔	✔	✔	✔
		PRG1_RGMII1	GBE	✔	✔	✔	✔	✔	✔
		PRG1_RGMII2	GBE	✔	✔	✔	✔	✔	✔
		RGMII1	GBE	✔	✔	✔	✔	✔	✔
		UART0	TTL	✔	✔	✔	✔	✔	✔
		USB0	USB 3.0	✔	✔	✔	✔	✔	✔

Linux

Supported Features

TQ Product	Chip	Interface	Function	0001	0002	0003	0004	0005	0006
TQMa64xxL	AM64xx	GPIO		✔	✔	✔	✔	✔	✔
		I2C0	Bus access	✔	✔	✔	✔	✔	✔
		MCU_UART0	TTL	✔	✔	✔	✔	✔	✔
		MMC0	eMMC	✔	✔	✔	✔	✔	✔
		MMC1	SD Card	✔	✔	✔	✔	✔	✔
		PRG1_RGMII1	GBE	✔	✔	✔	✔	✔	✔
		PRG1_RGMII2	GBE	✔	✔	✔	✔	✔	✔
		RGMII1	GBE	✔	✔	✔	✔	✔	✔
		UART0	TTL	✔	✔	✔	✔	✔	✔
		USB0	USB 3.0	✔	✔	✔	✔	✔	✔

TQMa64xxL /MBaX4XxL

I2C bus	TQMa64xxL
I2C0	0x4A Temperature Sensor	0x48 SEC (optional)	0x50 Manufacturer EEPROM	0x51 RTC	0x54 Customer EEPROM

BSP Version History

0006

u-boot: Do not set ethXaddr variables in environment for MAC addresses that are not actually assigned to the module

This affects the TQMa6411L variant, which does not support PRU Ethernet, so only a total of 2 instead of 5 MAC addresses are assigned per module.

0005

Added support for TQMa6411L variant
Changed default sysfw variant to HS-FS

All series variants of the AM64x are HS-FS, the GP variants only exist as prototypes. Change the default sysfw variant for future BSP releases, so our images will work on series modules without changes. For prototype modules with AM64x SR1.0 or SR2.0 GP, the following options are available:

Use the old BSP release kirkstone.TQMa64xxL.BSP.SW.0004
Replace tiboot3.bin with tiboot3-am64x-gp-evm.bin in the boot partition
Change SYSFW_DEFAULT_VARIANT in the machine configuration or local.conf

0004

U-Boot

Added support for booting in USB host mode (from USB mass storage) and device mode (using dfu-util on a connected host)

0003

* Enable SDHC controller quirk to fix SD card access on TQMa64xxL REV.010x SoMs.

0002

BSP

Update to Yocto Kirkstone
Update U-Boot and kernel for hardware revision 0200. The obsolete revision 0100 is not supported anymore.
Update Known Issues

U-Boot

Update to include latest ti-u-boot-2021.01 changes. This fixes a license issue in U-Boot (inclusion of GPL-incompatible code).
Updated for compatiblity with latest meta-ti (commit 2a5a0339d5bd)
Updated build to generate tiboot3.bin for all 3 SYSFW variants (GP, HS-FS, HS-SE). Only boot on GP variants has been actually tested, as no TQMa64xxL with a HS CPU variant exists at this point.
Fix QSPI data corruption in U-Boot when accessing UBIFS volumes

Linux

Fix periodic rescan for SD cards with warning message when no SD card is inserted
Make OSPI working

0001

Initial BSP Release

¹⁾

i.e. value for MACHINE variable