~~NOCACHE~~
~~NOTOC~~
====== Entry Page ======
== Third-Party Add-Ons ==
 
<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/tqmarzg2x/|TQ product page TQMaRZG2x]]\\  

===== Starterkit =====

  * [[.:mbarzg2x:dip_switches|  MBaRZG2x DIP switch settings]]

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

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

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


====== Onboard I2C devices ======
<panel type="info" title="TQMaRZG2x / MBaRZG2x" no-body="true">



^ I2C bus  ^  TQMaRZG2x  ^^^^^^^   
^ I2C1 |  0x11\\  System Controller  |  0x1F\\  Temp Sensor  |  0x37\\  EEPROM\\  (Protected Mode)  |  0x48\\ Plug & Trust Secure Element\\  (optional)  |  0x50\\ EEPROM\\  (Customer EEPROM)  |  0x51\\ RTC\\  (optional)  |  0x57\\  Temp Sensor EEPROM  |

^  I2C bus  ^  MBaRZG2x  ^^^^^^^^^
^  I2C4  |  0x18\\ Audio Codec  |  0x1F\\  Temp Sensor  | 0x37\\  EEPROM\\  (Protected Mode)   |  0x41\\  Touchcontroller  |  0x44\\  USB Hub  |  0x57\\   Temp Sensor EEPROM  |  0x6A\\  PCIe Clock generator  |  0x70\\  Current Sense (24V)  |  0x7D\\  Current Sense (5V MOD)  |
^  I2C6  |  Depends on usage  |||||||||
</panel>

====== Linux BSP ======

===== U-Boot  =====
<panel type="primary" title="U-Boot" subtitle="Supported features"  no-body="true">
^ Feature  ^^^^ BSP Revision  ^^ Remarks  ^
^ TQ Product  ^ Chip   ^ Interface  ^ Function  ^  0003   ^  0010  ^  0020  ^ ::: ^
| TQMaRZG2x  | RZ/G2  | Ethernet  | GbE  |  ✔  |  ✔  |  ✔  |    |
| :::  | RZ/G2  | GPIO  |   |  ✔  |  ✔  |  ✔  |    |
| :::  | RZ/G2  | I2C | Bus Access  |  ✔  |  ✔  |  ✔  | [[./linux/yocto/overview#onboard_i2c_devices|See onboard I2C devices]]   |
| :::  | RZ/G2  | SDHC | eMMC\\  SD Card  |  ✔  |  ✔  |  ✔  |    |
| :::  | RZ/G2  | UART0  | Console  |  ✔  |  ✔  |  ✔  |    |
| :::  | RZ/G2  | USB  | Host  |  ✔  |  ✔  |  ✔  |   |
</panel>

<panel type="info" title="Supported boot devices" no-body="true">
^  Boot device  ^  Supported  ^  Remark  ^
|  eMMC          |  ✔  | The bootable SD/eMMC-Interface of the CPU is connected to eMMC  |
|  SPI NOR boot  |  ✔  |
</panel>
===== Operating System =====
<panel type="primary" title="Linux" subtitle="Supported features" no-body="true">
^ Feature  ^^^^ BSP Revision  ^^ Remarks  ^
^ TQ Product  ^ Chip   ^ Interface  ^ Function  ^  0003  ^  0010  ^  0020  ^ ::: ^
| TQMaRZG2x  | RZ/G2   | Audio  | TLV320AIC  |    |    |  |
| :::  | RZ/G2  | Ethernet  | GbE  |  ✔  |  ✔  |  ✔  |    |
| :::  | RZ/G2  | CAN  | CAN 2.0B  |  ✔  |  ✔  |  ✔  |    |
| :::  | RZ/G2  | FlexSPI  | QSPI-NOR  |  ✔  |  ✔  |  ✔  |    |
| :::  | RZ/G2  | GPIO  |   |  ✔  |  ✔  |  ✔  |    |
| :::  | RZ/G2  | GPU   |   |     |  ✔  |  ✔  |    |
| :::  | RZ/G2  | HDMI  |   |  ✔  |  ✔  |  ✔  |    | 
| :::  | RZ/G2  | I²C1  | Bus access  |  ✔  |  ✔  |  ✔  | [[./linux/yocto/overview#onboard_i2c_devices|See onboard I2C devices]]   |
| :::  | RZ/G2  | I²C4  | Bus access  |  ✔  |  ✔  |  ✔  | [[./linux/yocto/overview#onboard_i2c_devices|See onboard I2C devices]]   |
| :::  | RZ/G2  | I²C6  | Bus access  |  ✔  |  ✔  |  ✔  | [[./linux/yocto/overview#onboard_i2c_devices|See onboard I2C devices]]   |
| :::  | RZ/G2  | LVDS  | Display Interface  |  ✔  |  ✔  |  ✔  |    |
| :::  | RZ/G2  | LPUART4  | Console UART  |  ✔  |  ✔  |  ✔  |    |
| :::  | RZ/G2  | MIPI-CSI  | Camera Interface   |    |   |   |   |
| :::  | RZ/G2  | PCIe  | Host  |  ✔  |  ✔  |  ✔  | Tested with   |
| :::  | RZ/G2  | Sata   | Host |  ✔  |  ✔  |  ✔  | RZG2H and RZG2N only  |
| :::  | RZ/G2  | UART0  | Console  |  ✔  |  ✔  |  ✔  |    |
| :::  | RZ/G2  | USB  | USB Host  |  ✔  |  ✔  |  ✔  |   |
| :::  | RZ/G2  | USB| USB OTG  |  ✔  |  ✔  |  ✔  |   |
| :::  | RZ/G2  | uSDHC  | SD-Card  |  ✔  |  ✔  |  ✔  |   |
| :::  | RZ/G2  | uSDHC  | eMMC  |  ✔  |  ✔  |  ✔  |   |
| MBaRZG2x   | TLV320AIC  | Audio Codec  | Headphone Out / Line Out  |    |    |    |   |
| :::  |  :::  | :::  | Line In  |    |    |    |    | 
</panel>

===== 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/ci-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/rocko.TQMaRZG2x.BSP.SW.0010|0010]]   |  [[https://github.com/tq-systems/ci-meta-tq/tree/rocko|rocko]]   |  2.4.3 - Rocko  |  ++tqmarzg2h_c-mbarzg2x|TQMaRZG2H with 4GB RAM on MBaRZG2x ++\\  ++tqmarzg2m_aa-mbarzg2x|TQMaRZG2M with 2GB RAM on MBaRZG2x ++\\  ++tqmarzg2m_e-mbarzg2x|TQMaRZG2M with 8GB RAM on MBaRZG2x  ++\\  ++tqmarzg2n_b-mbarzg2x|TQMaRZG2N with 2 GB RAM on MBaRZG2x  ++  |  [[https://github.com/tq-systems/linux-tqmaxx/releases/tag/rocko.TQMaRZG2x.BSP.SW.0010|v2018.09-VLP_1.0.6]]  |  [[https://github.com/tq-systems/u-boot-tqmaxx/releases/tag/rocko.TQMaRZG2x.BSP.SW.0010|v4.19.140-VLP_1.0.6]]  | 
^  [[https://github.com/tq-systems/linux-tqmaxx/releases/tag/zeus.TQMaRZG2.BSP.SW.0003|0003]]  |  [[https://github.com/tq-systems/ci-meta-tq/tree/zeus|zeus]]  |  3.0.4 - Zeus  |  ++tqmarzg2n_b-mbarzg2x | TQMaRZG2N with 2 GB RAM on MBaRZG2x++\\  ++tqmarzg2h_c-mbarzg2x|TQMaRZG2H with 4GB RAM on MBaRZG2x++\\  ++tqmarzg2m_e-mbarzg2x| TQMaRZG2M with 8GB RAM on MBaRZG2x++  |  [[https://github.com/tq-systems/u-boot-tqmaxx/tree/zeus.TQMaRZG2.BSP.SW.0003|v2018.09-VLP_1.0.6]]  |  [[https://github.com/tq-systems/linux-tqmaxx/tree/zeus.TQMaRZG2.BSP.SW.0002|v4.19.140-VLP_1.0.6]]  |
^  [[https://github.com/tq-systems/linux-tqmaxx/releases/tag/zeus.TQMaRZG2.BSP.SW.0002|0002]]  |  [[https://github.com/tq-systems/ci-meta-tq/tree/zeus|zeus]]  |  3.0.4 - Zeus  |  ++tqmarzg2n_b-mbarzg2x | TQMaRZG2N with 2 GB RAM on MBaRZG2x++\\  ++tqmarzg2h_c-mbarzg2x|TQMaRZG2H with 4GB RAM on MBaRZG2x++\\  ++tqmarzg2m_e-mbarzg2x| TQMaRZG2M with 8GB RAM on MBaRZG2x++  |  [[https://github.com/tq-systems/u-boot-tqmaxx/tree/zeus.TQMaRZG2.BSP.SW.0002|v2018.09-VLP_1.0.6]]  |  [[https://github.com/tq-systems/linux-tqmaxx/tree/zeus.TQMaRZG2.BSP.SW.0002|v4.19.140-VLP_1.0.6]]  |    

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





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

<accordion collapsed="true">
<panel title="Target Machine: tqmarzg2m_aa-mbarzg2x">
** System Image **

<grid>
<col sm="12">
^ Boot device  ^ Symlink   ^ File     ^
^ SD Card/eMMC  | tq-image-weston-tqmarzg2m_aa-mbarzg2x.wic  | tq-image-weston-tqmarzg2m_aa-mbarzg2x-<build_timestamp>.rootfs.wic  |
</col>
</grid>

**Bootstream (Bootloader) Binary**
<grid>
<col sm="12">
^ Boot Device  ^ Symlink  ^ File  ^
^ SD Card/eMMC  | u-boot-tqmarzg2m_aa-mbarzg2x.bin  | u-boot-tqmarzg2m_aa-mbarzg2x-2018.09-r0.bin  |
</col>
</grid>

**Linux Kernel Binary**
<grid>
<col sm="12">
^ Symlink  ^ File  ^
| Image  | Image--4.19.140+git0+8e6bd492a3-r1-tqmarzg2m_aa-mbarzg2x-<build_timestamp>.bin  |
</col>
</grid>

**Devicetree Binarys**
<grid>
<col sm="12">
^  Symlink   ^  Description  ^
| r8a774a1-tqmarzg2m_aa-mbarzg2x.dtb  | default device tree blob for TQMaRZG2m on MBaRZg2x  |
| r8a774a1-tqmarzg2m_aa-mbarzg2x-lvds-tm070jvhg33.dtb  | device tree with activated LVDS0 channel and TM070JVHG33 display timing  |
</col>
</grid>

**RootFS Images**
<grid>
<col sm="12">
^  Symlink   ^  File     ^
| tq-image-weston-tqmarzg2m_aa-mbarzg2x.ext4  | tq-image-weston-tqmarzg2m_aa-mbarzg2x-<build_timestamp>.rootfs.ext4 |
| tq-image-weston-tqmarzg2m_aa-mbarzg2x.tar.gz  | tq-image-weston-tqmarzg2m_aa-mbarzg2x-<build_timestamp>.rootfs.tar.gz  |
</col>
</grid>
</panel>

<panel title="Target Machine: tqmarzg2m_e-mbarzg2x">

** System Image **

<grid>
<col sm="12">
^ Boot device  ^ Symlink   ^ File     ^
^ SD Card/eMMC  | tq-image-weston-tqmarzg2m_e-mbarzg2x.wic  | tq-image-weston-tqmarzg2m_e-mbarzg2x-<build_timestamp>.rootfs.wic  |
</col>
</grid>

**Bootstream (Bootloader) Binary**
<grid>
<col sm="12">
^ Boot Device  ^ Symlink  ^ File  ^
^ SD Card/eMMC  | u-boot-tqmarzg2m_e-mbarzg2x.bin  | u-boot-tqmarzg2m_e-mbarzg2x-2018.09-r0.bin  |
</col>
</grid>

**Linux Kernel Binary**
<grid>
<col sm="12">
^ Symlink  ^ File  ^
| Image  | Image--4.19.140+git0+8e6bd492a3-r1-tqmarzg2m_e-mbarzg2x-<build_timestamp>.bin  |
</col>
</grid>

**Devicetree Binarys**
<grid>
<col sm="12">
^  Symlink   ^  Description  ^
| r8a774a1-tqmarzg2m_e-mbarzg2x.dtb  | default device tree blob for TQMaRZG2m on MBaRZg2x  |
| r8a774a1-tqmarzg2m_e-mbarzg2x-lvds-tm070jvhg33.dtb  | device tree with activated LVDS0 channel and TM070JVHG33 display timing  |
</col>
</grid>

**RootFS Images**
<grid>
<col sm="12">
^  Symlink   ^  File     ^
| tq-image-weston-tqmarzg2m_e-mbarzg2x.ext4  | tq-image-weston-tqmarzg2m_e-mbarzg2x-<build_timestamp>.rootfs.ext4 |
| tq-image-weston-tqmarzg2m_e-mbarzg2x.tar.gz  | tq-image-weston-tqmarzg2m_e-mbarzg2x-<build_timestamp>.rootfs.tar.gz  |
</col>
</grid>
</panel>

<panel title="Target Machine: tqmarzg2h_c-mbarzg2x">

** System Image **

<grid>
<col sm="12">
^ Boot device  ^ Symlink   ^ File     ^
^ SD Card/eMMC  | tq-image-weston-tqmarzg2h_c-mbarzg2x.wic  | tq-image-weston-tqmarzg2h_c-mbarzg2x-<build_timestamp>.rootfs.wic  |
</col>
</grid>

**Bootstream (Bootloader) Binary**
<grid>
<col sm="12">
^ Boot Device  ^ Symlink  ^ File  ^
^ SD Card/eMMC  | u-boot-tqmarzg2h_c-mbarzg2x.bin  | u-boot-tqmarzg2h_c-mbarzg2x-2018.09-r0.bin  |
</col>
</grid>

**Linux Kernel Binary**
<grid>
<col sm="12">
^ Symlink  ^ File  ^
| Image  | Image--4.19.140+git0+8e6bd492a3-r1-tqmarzg2h_c-mbarzg2x-<build_timestamp>.bin  |
</col>
</grid>

**Devicetree Binarys**
<grid>
<col sm="12">
^  Symlink   ^  Description  ^
| r8a774e1-tqmarzg2h_c-mbarzg2x.dtb  | default device tree blob for TQMaRZG2m on MBaRZg2x  |
| r8a774e1-tqmarzg2h_c-mbarzg2x-lvds-tm070jvhg33.dtb  | device tree with activated LVDS0 channel and TM070JVHG33 display timing  |
</col>
</grid>

**RootFS Images**
<grid>
<col sm="12">
^  Symlink   ^  File     ^
| tq-image-weston-tqmarzg2h_c-mbarzg2x.ext4  | tq-image-weston-tqmarzg2h_c-mbarzg2x-<build_timestamp>.rootfs.ext4 |
| tq-image-weston-tqmarzg2h_c-mbarzg2x.tar.gz  | tq-image-weston-tqmarzg2h_c-mbarzg2x-<build_timestamp>.rootfs.tar.gz  |
</col>
</grid>
</panel>

<panel title="Target Machine: tqmarzg2n_b-mbarzg2x">

** System Image **

<grid>
<col sm="12">
^ Boot device  ^ Symlink   ^ File     ^
^ SD Card/eMMC  | tq-image-weston-tqmarzg2n_b-mbarzg2x.wic  | tq-image-weston-tqmarzg2n_b-mbarzg2x-<build_timestamp>.rootfs.wic  |
</col>
</grid>

**Bootstream (Bootloader) Binary**
<grid>
<col sm="12">
^ Boot Device  ^ Symlink  ^ File  ^
^ SD Card/eMMC  | u-boot-tqmarzg2n_b-mbarzg2x.bin  | u-boot-tqmarzg2n_b-mbarzg2x-2018.09-r0.bin  |
</col>
</grid>

**Linux Kernel Binary**
<grid>
<col sm="12">
^ Symlink  ^ File  ^
| Image  | Image--4.19.140+git0+8e6bd492a3-r1-tqmarzg2n_b-mbarzg2x-<build_timestamp>.bin  |
</col>
</grid>

**Devicetree Binarys**
<grid>
<col sm="12">
^  Symlink   ^  Description  ^
| r8a774e1-tqmarzg2n_b-mbarzg2x.dtb  | default device tree blob for TQMaRZG2m on MBaRZg2x  |
| r8a774e1-tqmarzg2n_b-mbarzg2x-lvds-tm070jvhg33.dtb  | device tree with activated LVDS0 channel and TM070JVHG33 display timing  |
</col>
</grid>

**RootFS Images**
<grid>
<col sm="12">
^  Symlink   ^  File     ^
| tq-image-weston-tqmarzg2n_b-mbarzg2x.ext4  | tq-image-weston-tqmarzg2n_b-mbarzg2x-<build_timestamp>.rootfs.ext4 |
| tq-image-weston-tqmarzg2n_b-mbarzg2x.tar.gz  | tq-image-weston-tqmarzg2n_b-mbarzg2x-<build_timestamp>.rootfs.tar.gz  |
</col>
</grid>
</panel>

</accordion>

===== Yocto Deployment =====

==== Device assignment ====
<grid>
<col sm="4">
<callout type="primary" icon="true">
**U-Boot Device Assignment:**\\
\\
//mmc dev 0// = SD Card\\
//mmc dev 1// = eMMC\\
</callout>
</col>
</grid>


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

<panel type="info" title="BSP Version History" no-body="true">
<accordion collapsed="true">
<panel title="Rev.0020">
  * Switch to Yocto Dunfell
  * Flash Writer v1.05
  * ATF v2.7
  * U-Boot v2021.10
  * Linux 5.10 (CIP)
</panel>


<panel title="Rev.0010">
  * GPU and video codec support via meta-rzg2
  * Backport to Yocto rocko
</panel>

<panel title="Rev.0003">
  *  Add support for tqmarzg2m with 2GB RAM
</panel>

<panel title="Rev.0002">
Inital BSP Release
</panel>
</accordion>
</panel>