~~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 =====
  * [[.linux:yocto:overview|YOCTO Linux BSP documentation]]


<wrap hide> 
  * [[.:windows_ce|Microsoft® Windows® CE]]
  * [[.:windows_embedded|Microsoft® Windows® Embedded]]
  * [[.:qnx|QNX® Neutrino®]]
  * [[.:android|Android]] (coming soon)
</wrap>

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

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

===== Starterkit =====

  * [[.:mba65xx:dip_switches|  MBa65xx DIP switch settings]]

====== Hardware ======
===== Debug Connection =====

The TQMa65xx debug UART is connected via a Microchip USB-to-Serial converter to X37 (micro-USB) on the MBa65xx. A micro-USB/USB-A cable is part of the STKa65xx accessory set. Depending on the host operating system, a driver may need to be installed.


===== Onboard I2C devices =====
<panel type="info" title="TQMa65xx /MBa65xx" no-body="true">
^ I2C bus  ^  TQMa65xx  ^^^^^^^^
^ WKUP_I2C0  |  0x11 \\  Board Controller  |  0x1F \\  Temperature Sensor  |  0x37 \\ Temp. Sensor EEPROM \\  (write protection)  |  0x48 \\ TPM  \\ (optional)  |  0x50 \\  EEPROM  |  0x51 \\ RTC  |  0x57 \\ Temp. sensor EEPROM  |  0x60 \\  DC/DC Converter  | 

^ I2C bus  ^  MBa65xx  ^^^^^^^  
^ MCU_I2C  |  0x18\\ Audio Codec  |  0x20 \\  GPIO Expander  |  0x21 \\  GPIO Expander  |  0x40 \\  Current Sense (24V)  |  0x41 \\  Touch Controller  |  0x45 \\ Current Sense (5V Module)  |  0x78 \\  Clock Generator  |   
</panel>


===== U-Boot =====
<panel type="primary"  title="U-Boot" subtitle="Supported features" no-body="true">
^ Feature  ^^^^^ BSP Revision  ^ Remarks  ^
^ TQ Product  ^ Chip  ^ Interface  ^ Function  ^  0007  ^  0008  ^  0009  ^ :::  ^
| TQMa65xx  | AM65xx  | CPSW | GbE  |  ✔  |  ✔  |  ✔  | Available on Connector X28  | 
| :::  | :::  | GPIO  |   |  ✔  |  ✔  |  ✔  |   |
| :::  | :::  | I²C  |   |  ✔  |  ✔  |  ✔  | [[./linux/yocto/overview#onboard_i2c_devices|See onboard I2C devices]]  |
| :::  | :::  | MMC  | SD Card  |  ✔  |  ✔  |  ✔  |   |
| :::  | :::  | :::  | eMMC  |  ✔  |  ✔  |  ✔  |   |
| :::  | :::  | QSPI | NOR Flash  |  ✔  |  ✔  |  ✔  |   |
| :::  | :::  | UART0  | Console  |  ✔  |  ✔  |  ✔  |   |
| :::  | :::  | USB  | USB 2.0  |  ✔  |  ✔  |  ✔  |  |
</panel>


===== Kernel =====
===== Operating System =====

<panel type="primary" title="Linux" subtitle="Supported Features" no-body="true">
^ TQ Product  ^ Chip    ^ Interface   ^ Function   ^  0007  ^  0008  ^  0009  ^  Remarks  ^
| TQMa65xx  | AM65xx  | CPSW | GbE  |  ✔  |  ✔  |  ✔  | Available on Connector X28  | 
| :::  | :::  | GPIO  |   |  ✔  |  ✔  |  ✔  |   |
| :::  | :::  | I²C  |   |  ✔  |  ✔  |  ✔  | [[./linux/yocto/overview#onboard_i2c_devices|See onboard I2C devices]]  |
| :::  | :::  | MCAN  | CAN 2.0B  |  ✔  |  ✔  |  ✔  |  | 
| :::  | :::  | MMC  | SD Card  |  ✔  |  ✔  |  ✔  |   |
| :::  | :::  | :::  | eMMC  |  ✔  |  ✔  |  ✔  |   |
| :::  | :::  | OLDI | LVDS |    |  ✔  |  ✔  | Tested with TIANMA TM070JVHG33  | 
| :::  | :::  | PRU_ICSSG0  | 2x GbE  |  ✔  |  ✔  |  ✔  | Connector X4/X5 |
| :::  | :::  | PRU_ICSSG1  | 2x GbE  |  ✔  |  ✔  |  ✔  | Connector X6/X7 |
| :::  | :::  | PRU_ICSSG2  | 2x GbE  |  ✔  |  ✔  |  ✔  | Connector X15/X16 |
| :::  | :::  | QSPI | NOR Flash  |  ✔  |  ✔  |  ✔  |   |
| :::  | :::  | UART0  | Console  |  ✔  |  ✔  |  ✔  |   |
| :::  | :::  | USB  | USB 2.0  |  ✔  |  ✔  |  ✔  |   |
| :::  | :::  | VOUT1  | RGB Display  |     |  ✔  |  ✔  | tested with DMB DC44 and FC21  |
</panel>

===== Yocto Images =====
<accordion collapsed="true">
<panel title="Target Machine: tqma65xx-2gb-mba65xx">
**System Images**

<grid>
<col sm="12">
^ Boot Device  ^ Symlink  ^ File  ^
^ SD Card/eMMC  | tq-image-weston-tqma65xx-2gb-mba65xx.wic  | tq-image-weston-tqma65xx-2gb-mba65xx.wic-<build_timestamp>.rootfs.wic  |
</col>
</grid>

**Bootloader Binaries**

<grid>
<col sm="12">
^ Boot Device  ^ Symlink  ^ File  ^
^ SD/eMMC  | u-boot.img | u-boot-tqma65xx-2gb-mba65xx-2020.01-r0.img  |
</col>
</grid>

**Linux Kernel Image**

<grid>
<col sm="12">
^ Symlink  ^ File  ^
| Image  | Image--5.4.109-r0-tqma65xx-2gb-mba65xx-<build_timestamp>.bin  |
</col>
</grid>

**Devicetree Blobs**
<grid>
<col sm="12">
^ Symlink  ^ Description  ^
| k3-am654-tqma65xx-mba65xx.dtb | Default |
| k3-am65-tqma65xx-mba65xx-eth-prg0.dtbo | PRU Ethernet Devicetree overlay  | 
| k3-am65-tqma65xx-mba65xx-eth-prg1.dtbo  | PRU Ethernet Devicetree overlay  | 
| k3-am65-tqma65xx-mba65xx-lvds-display.dtbo  | LVDS Devicetree overlay  |
| k3-am65-tqma65xx-mba65xx-dmb-fc21.dtbo  | Parallel Display Devicetree overlay |
| k3-am65-tqma65xx-mba65xx-dmb-dc44.dtbo  | Parallel Display Devicetree overlay |
| k3-am65-tqma65xx-mba65xx-audio.dtbo  | Audio Devicetree overlay |

</col>
</grid>

**Rootfs images**
<grid>
<col sm="12">
^ Symlink  ^ File  ^
| tq-image-weston-tqma65xx-2gb-mba65xx.ext4 | tq-image-weston-tqma65xx-2gb-mba65xx-<build_timestamp>.rootfs.ext4  |
| tq-image-weston-tqma65xx-2gb-mba65xx.tar.gz  | tq-image-weston-tqma65xx-2gb-mba65xx-<build_timestamp>.rootfs.tar.gz  |
</col>
</grid>
</panel>

<panel title="Target Machine: tqma65xx-4gb-mba65xx">
**System Images**

<grid>
<col sm="12">
^ Boot Device  ^ Symlink  ^ File  ^
^ SD Card/eMMC  | tq-image-weston-tqma65xx-4gb-mba65xx.wic  | tq-image-weston-tqma65xx-4gb-mba65xx.wic-<build_timestamp>.rootfs.wic  |
</col>
</grid>

**Bootloader Binaries**

<grid>
<col sm="12">
^ Boot Device  ^ Symlink  ^ File  ^
^ SD/eMMC  | u-boot.img | u-boot-tqma65xx-4gb-mba65xx-2020.01-r0.img  |
</col>
</grid>

**Linux Kernel Image**

<grid>
<col sm="12">
^ Symlink  ^ File  ^
| Image  | Image--5.4.109-r0-tqma65xx-4gb-mba65xx-<build_timestamp>.bin  |
</col>
</grid>

**Devicetree Blobs**
<grid>
<col sm="12">
^ Symlink  ^ Description  ^
| k3-am654-tqma65xx-mba65xx.dtb | Default |
| k3-am65-tqma65xx-mba65xx-eth-prg0.dtbo | PRU Ethernet Devicetree overlay  | 
| k3-am65-tqma65xx-mba65xx-eth-prg1.dtbo  | PRU Ethernet Devicetree overlay  | 
| k3-am65-tqma65xx-mba65xx-lvds-display.dtbo  | LVDS Devicetree overlay  |
| k3-am65-tqma65xx-mba65xx-dmb-fc21.dtbo  | Parallel Display Devicetree overlay |
| k3-am65-tqma65xx-mba65xx-dmb-dc44.dtbo  | Parallel Display Devicetree overlay |
| k3-am65-tqma65xx-mba65xx-audio.dtbo  | Audio Devicetree overlay |

</col>
</grid>

**Rootfs images**
<grid>
<col sm="12">
^ Symlink  ^ File  ^
| tq-image-weston-tqma65xx-4gb-mba65xx.ext4 | tq-image-weston-tqma65xx-4gb-mba65xx-<build_timestamp>.rootfs.ext4  |
| tq-image-weston-tqma65xx-4gb-mba65xx.tar.gz  | tq-image-weston-tqma65xx-4gb-mba65xx-<build_timestamp>.rootfs.tar.gz  |
</col>
</grid>
</panel>
</accordion>  

===== Yocto BSP Version Matrix =====
<alert type="success" dismiss="true">Please visit our [[https://github.com/tq-systems/|Github]]  for the latest updates and BSP releases.</alert>
<panel type="primary" title="BSP Version Matrix" no-body="true">
^  BSP Revision  ^  ++ci-meta-tq release|\\ [[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.TQMa65xx.BSP.SW.0009|0009]]  |  [[https://github.com/tq-systems/ci-meta-tq/tree/kirkstone|kirkstone]]  |  4.0.6 - Kirkstone  |  ++ tqma65xx-2gb-mba65xx |\\  TQMa65xx on MBa65xx with 2GB RAM ++ \\  ++ tqma65xx-4gb-mba65xx  |\\    TQMa65xx on MBa65xx with 4GB RAM ++  |  [[https://github.com/tq-systems/u-boot-tqmaxx/releases/tag/kirkstone.TQMa65xx.BSP.SW.0009|2020.01]]  |  [[https://github.com/tq-systems/linux-tqmaxx/releases/tag/kirkstone.TQMa65xx.BSP.SW.0009|linux-v5.4.109-ti-5.4.y]]  |     
^  [[https://github.com/tq-systems/ci-meta-tq/releases/tag/hardknott.TQMa65xx.BSP.SW.0008|0008]]  |  [[https://github.com/tq-systems/ci-meta-tq/tree/hardknott|hardknott]]   |  3.3.5 - Hardknott  |  ++ tqma65xx-2gb-mba65xx |\\  TQMa65xx on MBa65xx with 2GB RAM ++ \\  ++ tqma65xx-4gb-mba65xx  |\\    TQMa65xx on MBa65xx with 4GB RAM ++  |  [[https://github.com/tq-systems/u-boot-tqmaxx/releases/tag/hardknott.TQMa65xx.BSP.SW.0008|2020.01]]  |  [[https://github.com/tq-systems/linux-tqmaxx/releases/tag/hardknott.TQMa65xx.BSP.SW.0008|linux-v5.4.109-ti-5.4.y]]  |  
^  [[https://github.com/tq-systems/ci-meta-tq/releases/tag/zeus.TQMa65xx.BSP.SW.0007|0007]]  |  [[https://github.com/tq-systems/ci-meta-tq/tree/zeus|zeus]]  |  3.0.3 - Zeus  |  ++ tqma65xx-mba65xx |\\  TQMa65xx-PROTO1/MBa65xx ++ \\  ++ tqma65xx-mba65xx-p2  |\\    TQMa65xx-PROTO2/MBa65xx\\  TQMa65xx-PROTO3/MBa65xx ++  |  [[https://github.com/tq-systems/u-boot-tqmaxx/releases/tag/zeus.TQMa65xx.BSP.SW.0007|2020.01]]  |  [[https://github.com/tq-systems/linux-tqmaxx/releases/tag/zeus.TQMa65xx.BSP.SW.0007|linux-v5.4.93-ti-5.4.y]]  |  
</panel>

===== 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="0009">

**BSP**
  * Update to Yocto Kirkstone 
  * Fix RX hang of PRU Ethernet ports
  * Set SERIAL_CONSOLES correctly
</panel>

<panel title="0008">

**BSP**
  * Update to Yocto Hardknott
  * Better support for modules without SPI-NOR flash
  * Set correct EEPROM page size for faster writes
  * Add MTD and CAN utils to TQ images (meta-dumpling)
  * New kernel recipe linux-ti-tq-5.4.109
  * New U-Boot recipe u-boot-ti-tq-2020.01

** U-Boot **
  * Fix unintended difference to TI AM65x-EVM memory layout in U-Boot SPL
  * Fix GPIO access from U-Boot command line
  * Build UBI images for SPI-NOR boot

** Linux **
  * Fix access to QSPI-NOR flash from Linux
  
</panel>

<panel title="0007">
** BSP **
  * u-boot / linux fix switchable base URL

** U-Boot **

  * Added Update commands 
  * Read infomation from SOM EEPROM
  * Read PRU-MAC address from EEPROM
  *  

** Linux **
  * GPIO buttons implemented as gpio-keys-polled  
  * Added support for software controlled LEDs 

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


===== Yocto Deployment =====
==== Device assignment ====
<WRAP round info 40%>__Device assignment:__\\
//mmcdev 0// = eMMC\\
//mmcdev 1// = SD Card\\
</WRAP>

==== Yocto specific command Update eMMC ==== 
1. Run the following command in the Uboot shell to create update script: 

<code> 
setenv  install_firmware 'echo MBR... && mmc dev 1 && mmc read $loadaddr 0 1 && mmc dev 0 && mmc write $loadaddr 0 1 && echo U-Boot... && mmc dev 1 && mmc read $loadaddr 2 7FE && mmc dev 0 && mmc write $loadaddr 2 7FE && echo U-Boot environment... && mmc dev 1 && mmc read $loadaddr 801 800 && mmc dev 0 &&mmc write $loadaddr 801 800 && echo reserved... && mmc dev 1 && mmc read $loadaddr 1001 1000 && mmc dev 0 &&mmc write $loadaddr 1001 1000 && echo Firmware Partition... && mmc dev 1 && mmc read $loadaddr 2001 10000 && mmc dev 0 && mmc write $loadaddr 2001 10000 && echo Root FS... && mmc dev 1 && mmc read $loadaddr C001 19F800 && mmc dev 0 && mmc write $loadaddr C001 19F800' 
</code> 



==== uboot command to start netboot ====

<code>
=> run netboot
</code>