~~NOCACHE~~ 
~~NOTOC~~

====== Entry Page ======

== Third-Party Add-Ons ==

  * [[:en:third-party:ittia:db-sql|ITTIA DB SQL]]

<WRAP hide>

  * [[:en:third-party:systemcorp:iec61850|SystemCORP IEC 61850]]
  * [[:en:third-party:netmodule:iec62439|NetModule IEC 62439]]

</WRAP>

===== Board Support Packages =====

  * [[:en:arm:tqma64xxl:linux:yocto:overview|YOCTO Linux BSP documentation]]

<wrap hide>

  * [[:en:arm:tqma64xxl:windows_ce|Microsoft® Windows® CE]]
  * [[:en:arm:tqma64xxl:windows_embedded|Microsoft® Windows® Embedded]]
  * [[:en:arm:tqma64xxl:qnx|QNX® Neutrino®]]
  * [[:en:arm:tqma64xxl:android|Android]] (coming soon)

</wrap>

===== Product URL list =====

[[https://www.tq-group.com/en/products/tq-embedded/arm-architecture/tqma64xxl/|TQ product page TQMa64xxL]]

===== Starterkit =====

  * [[:en:arm:tqma64xxl:mbax4xxl:dip_switches|MBaX4XxL DIP switch settings]]

====== Hardware ======

===== Debug Connection =====

The TQMa64xxL debug UART is connected via a Silicon Labs USB-to-Serial converter to X16 (micro-USB) on the MBaX4XxL. A micro-USB/USB-A cable is part of the STKa64xxL accessory set. Depending on the host operating system, a driver may need to be installed.

===== Onboard I2C devices =====

<panel type="info" title="TQMa64xxL /MBaX4XxL" no-body="true">

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

</panel>

===== U-Boot =====

<panel type="primary" title="U-Boot" subtitle="Supported features" no-body="true">

^Feature  ^^^^  BSP Revision  ^^^^^^Remarks  |
^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  |  ✔  |  ✔  |  ✔  |  ✔  |  ✔  |  ✔  |   | 

</panel>

===== Kernel =====

===== Operating System =====

<panel type="primary" title="Linux" subtitle="Supported Features" no-body="true">

^TQ Product  ^Chip  ^Interface  ^Function  ^  0001  ^  0002  ^  0003  ^  0004  ^  0005  ^  0006  ^Remarks  |
|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  |  ✔  |  ✔  |  ✔  |  ✔  |  ✔  |  ✔  |   |

</panel>

===== Yocto Images =====

<accordion collapsed="true"> <panel title="Target Machine: tqma64xxL-mbax4xxl"> **System Images**<grid> <col sm="12">

^Boot Device  ^Symlink  ^File  |
^SD Card/eMMC  | tq-image-weston-debug-tqma64xxl-mbax4xxl.wic  |tq-image-weston-debug-tqma64xxl-mbax4xxl-<build_timestamp>.rootfs.wic  |

</col> </grid>



**Bootloader Binaries**<grid> <col sm="12">

<callout type="info">
The first-stage bootloader comes in three variants, each including a different version of the system controller firmware:

  * tiboot3-am64x-gp-evm.bin (AM64x Silicon Revision 1.0 or 2.0, General Purpose variant)
  * tiboot3-am64x_sr2-hs-fs-evm.bin (AM64x Silicon Revision 2.0, High Security variant, field-securable)
  * tiboot3-am64x_sr2-hs-evm.bin (AM64x Silicon Revision 2.0, High Security variant, security enforced)

Please refer to the Secure Device Processor SDK documention for more information on the High Security CPU variants. This documentation must be obtained directly from TI.
To select the variant to use, set the SYSFW_DEFAULT_VARIANT variable to "am64x-gp", "am64x_sr2-hs-fs" or "am64x_sr2-hs" (in local.conf or a custom machine definition), to match the used AM64x CPU variant and security enforcement status. The default value is "am64x-gp".
The selected variant will be installed to the boot partition of the generated WIC images as tiboot3.bin. It is possible to change an existing image to boot on a different CPU variant by mounting the boot partition and renaming one of the bootloader binaries to tiboot3.bin.
</callout> 

^Boot Device  ^Symlink  ^File  |
^SD/eMMC  | u-boot.img|u-boot-tqma64xxl-mbax4xxl-2021.01+<git_commit_id>-r0.img  |
^ :::     | tispl.bin  | tispl.bin-tqma64xxl-mbax4xxl-2021.01+<git_commit_id>-r0  |
^ :::     | tiboot3.bin  | tiboot3-am64x-gp-evm.bin  |

</col> </grid>

**Linux Kernel Image**<grid> <col sm="12">

^Symlink  ^File  |
|Image  |  Image--5.10.152+<git_commit_id-r0-tqma64xxl-mbax4xxl-<timestamp>.bin  |

</col> </grid>

**Devicetree Blobs**  <grid> <col sm="12">

^Symlink  ^Description  |
|k3-am642-tqma64xxl-mbax4xxl-tqma64xxl-mbax4xxl.dtb |Default |
|k3-am64-tqma64xxl-mbax4xxl-sdcard.dtbo  |SD Card Devicetree overlay  |
|k3-am64-tqma64xxl-mbax4xxl-wlan.dtbo |WLAN Devicetree overlay  |
</col> </grid>

**Rootfs images**  <grid> <col sm="12">

^Symlink  ^File  |
|tq-image-weston-debug-tqma64xxl-mbax4xxl.tar.gz  |tq-image-weston-debug-tqma64xxl-mbax4xxl-<build_timestamp>.rootfs.tar.gz  |

</col> </grid> </panel> </accordion>

===== Yocto BSP Version Matrix =====

<panel type="primary" title="BSP Version Matrix" no-body="true">

^  BSP Revision  ^  ++ci-meta-tq release| \\ [[https://github.com/tq-systems/meta-tq|https://github.com/tq-systems/meta-tq]]  ++  ^  Yocto Project / Poky Release  ^  Target machine((i.e. value for  [[https://www.yoctoproject.org/docs/2.4.4/ref-manual/ref-manual.html#var-MACHINE|MACHINE]] variable))     ^  U-Boot  ^  Linux Kernel  |
^  [[https://github.com/tq-systems/ci-meta-tq/releases/tag/kirkstone.TQMa64xxL.BSP.SW.0006|0006]]   |  [[https://github.com/tq-systems/ci-meta-tq/tree/kirkstone|Kirkstone]]   |  4.0.13 - Kirkstone  |  ++ tqma64xxl-mbax4xxl | TQMa64xxL on MBaX4XxL ++  |  [[https://github.com/tq-systems/u-boot-tqmaxx/releases/tag/kirkstone.TQMa64xxL.BSP.SW.0006|ti-u-boot 2021.01]]   |  [[https://github.com/tq-systems/linux-tqmaxx/releases/tag/kirkstone.TQMa64xxL.BSP.SW.0006|ti-rt-linux-5.10.y]]   |
^  [[https://github.com/tq-systems/ci-meta-tq/releases/tag/kirkstone.TQMa64xxL.BSP.SW.0005|0005]]   |  [[https://github.com/tq-systems/ci-meta-tq/tree/kirkstone|Kirkstone]]   |  4.0.13 - Kirkstone  |  ++ tqma64xxl-mbax4xxl | TQMa64xxL on MBaX4XxL ++  |  [[https://github.com/tq-systems/u-boot-tqmaxx/releases/tag/kirkstone.TQMa64xxL.BSP.SW.0005|ti-u-boot 2021.01]]   |  [[https://github.com/tq-systems/linux-tqmaxx/releases/tag/kirkstone.TQMa64xxL.BSP.SW.0005|ti-rt-linux-5.10.y]]   |
^  [[https://github.com/tq-systems/ci-meta-tq/releases/tag/kirkstone.TQMa64xxL.BSP.SW.0004|0004]]   |  [[https://github.com/tq-systems/ci-meta-tq/tree/kirkstone|Kirkstone]]   |  4.0.9 - Kirkstone  |  ++ tqma64xxl-mbax4xxl | TQMa64xxL on MBaX4XxL ++  |  [[https://github.com/tq-systems/u-boot-tqmaxx/releases/tag/kirkstone.TQMa64xxL.BSP.SW.0004|ti-u-boot 2021.01]]   |  [[https://github.com/tq-systems/linux-tqmaxx/releases/tag/kirkstone.TQMa64xxL.BSP.SW.0004|ti-rt-linux-5.10.y]]   |
^  [[https://github.com/tq-systems/ci-meta-tq/releases/tag/kirkstone.TQMa64xxL.BSP.SW.0003|0003]]   |  [[https://github.com/tq-systems/ci-meta-tq/tree/kirkstone|Kirkstone]]   |  4.0.6 - Kirkstone  |  ++ tqma64xxl-mbax4xxl | TQMa64xxL on MBaX4XxL ++  |  [[https://github.com/tq-systems/u-boot-tqmaxx/releases/tag/kirkstone.TQMa64xxL.BSP.SW.0003|ti-u-boot 2021.01]]   |  [[https://github.com/tq-systems/linux-tqmaxx/releases/tag/kirkstone.TQMa64xxL.BSP.SW.0002|ti-rt-linux-5.10.y]]   |
^  [[https://github.com/tq-systems/ci-meta-tq/releases/tag/kirkstone.TQMa64xxL.BSP.SW.0002|0002]]   |  [[https://github.com/tq-systems/ci-meta-tq/tree/kirkstone|Kirkstone]]   |  4.0.6 - Kirkstone  |  ++ tqma64xxl-mbax4xxl | TQMa64xxL on MBaX4XxL ++  |  [[https://github.com/tq-systems/u-boot-tqmaxx/releases/tag/kirkstone.TQMa64xxL.BSP.SW.0002|ti-u-boot 2021.01]]   |  [[https://github.com/tq-systems/linux-tqmaxx/releases/tag/kirkstone.TQMa64xxL.BSP.SW.0002|ti-rt-linux-5.10.y]]   |
^  [[https://github.com/tq-systems/ci-meta-tq/releases/tag/hardknott.TQMa64xxL.BSP.SW.0001|0001]]   |  [[https://github.com/tq-systems/ci-meta-tq/tree/hardknott|Hardknott]]   |  3.3.6 - Hardknott  |  ++ tqma64xxl-mbax4xxl | TQMa64xxL on MBaX4XxL ++  |  [[https://github.com/tq-systems/u-boot-tqmaxx/releases/tag/hardknott.TQMa64xxL.BSP.SW.0001|ti-u-boot 2021.01]]   |  [[https://github.com/tq-systems/linux-tqmaxx/releases/tag/hardknott.TQMa64xxL.BSP.SW.0001|ti-rt-linux-5.10.y]]   |

</panel>

----



----


{{section>..:..:general_information:yocto:tips#bsp_release_auto_notification&noheader}}

==== BSP / Hardware compatibility ====

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

===== Yocto Partitions =====

<panel type="primary" title="SD / eMMC image">

  * sector size 512 Byte
  * unpartitioned area: 4MiB (0x2000 sectors)

^Size  ^Usage  |
|0x0001 sector / 512 Byte  |MBR / Partition Table  |

</panel>

===== Yocto Changelog =====

<panel type="info" title="BSP Version History" no-body="true"> 
<accordion collapsed="true">

<panel title="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.

</panel>
<panel title="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

</panel>

 
<panel title="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)

</panel>
<panel title="0003">
* Enable SDHC controller quirk to fix SD card access on TQMa64xxL REV.010x SoMs.

</panel>



 <panel title="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

</panel>

<panel title="0001">

  * Initial BSP Release

</panel> 
</accordion> 
</panel>

====== known issues ======

==== EEPROM may not be usable on TQMa64xx < Rev.0200 ====

^Details  ^|
^[c]Issue[/c]  |The EEPROM for the module data (MAC, Serial Number, variant identification) does not work reliably yet. \\ The MAC addresses must therefore be set manually in the UBoot. \\ These can be taken from the label on the module.  |
^Affected Revisions  ^|
^[c]Module[/c]  |TQMa64xx: Rev. 0100, Rev. 0101  |
^Solution  ^|
^[c]Fix[/c]|The MAC addresses can be set via the Uboot: \\  \\ //setenv ethaddr "eth-address from label"// \\ //setenv eth1addr "eth-address from label +1"// \\ //setenv eth2addr "eth-address from label +2"// |

----

----