Embedded module TQMaRZG2x - YOCTO Linux BSP documentation

The meta-tq layer extends the Yocto Project's reference system Poky to provide support for a selection of TQ Embedded CPU Modules, including the TQMaRZG2x.

It uses the same codebase as the PTXdist based TQ Linux BSPs and therefore provides the same versions of U-Boot and Linux kernel, but doesn't define a specific root filesystem configuration.

As starting point tq provides ci-meta-tq that covers the dependencies of meta-tq to the other yocto layers. So for the first build we recommend to use ci-meta-tq which already provides all required yocto layers as git submodules instead of meta-tq to build this BSP release.

The instructions on this page refer to the BSP and ancillary tools listed in the following table:

BSP Revision	0020
ci-meta-tq release all releases	dunfell.TQMaRZG2x.BSP.SW.0020
Yocto Project / Poky Release	3.1.17
Target machine¹⁾	tqmarzg2m-mbarzg2x TQMaRZG2M with 2GB on MBaRZG2x tqmarzg2n_mbarzg2x TQMaRZG2N with 2 GB RAM on MBaRZG2x tqmarzg2h_mbarzg2x TQMaRZG2H with 4GB RAM on MBaRZG2x
U-Boot	v2021.10/rz
Linux Kernel	rz-5.10-cip17

It's strongly recommended to use git for downloading both the Yocto Project / Poky Release as well as ci-meta-tq (instead of downloading archives and extracting them)

The goal of these wiki pages is to get you started using ci-meta-tq with the STKaRZG2x, so instead of reinventing the wheel we will adhere to the very compact Yocto Project Quick Start and supply details specific to the STKaRZG2x where necessary.

For further details regarding Yocto Project 3.1.17 - Dunfell please refer to its official documentation.

Build Host

Yocto Project / Poky requires a Linux build host, so first of all you need a development workstation (or a virtual machine²⁾) with a Linux distribution installed.

Please refer to section Compatible Linux Distribution of the Yocto Project Quick Start for supported linux distributions and section Build Host Packages for required build host packages for those distributions.

The instructions on this page have been tested on Ubuntu 20.04 (64 bit) in a VMWare virtual machine.

Although not required by Yocto Project / Poky, we also recommend to configure and run a tftp server (for image download / update) and an nfs server (for network mounted root filesystem) on your development host.

BSP build instructions

Please setup the build host as described in the Prerequisites section above .

1. Open a new terminal and create a directory for the BSP build e.g. in the home directory afterwards enter the new directory.

$ mkdir -p ~/workspace/dunfell.TQMaRZG2x.BSP.SW.0020
$ cd ~/workspace/dunfell.TQMaRZG2x.BSP.SW.0020

2. Create a local copy of meta-tq

$ git clone --recurse-submodules https://github.com/tq-systems/ci-meta-tq.git

3. Checkout BSP release on new local branch.

$ cd ci-meta-tq
$ git checkout dunfell.TQMaRZG2x.BSP.SW.0020 -b dunfell-tqmarzg2x

4. Update git submodules:

$ git submodule update --init
$ git submodule sync

5. Download RZ/G Multimedia Package and extract it into the sources folder in the BSP directroy.

For licensing reasons TQ Systems is not allowed to provide the RZ/G Multimedia Package with the TQMaRZG2x BSP sources. Downloading the RZ/G requires at least a registration on the Renesas website, there are two packages that can be downladed the Evaluation Version and the Product Version both packages have the same features, but the Evaluation version has a one hour runtime limitation. A reset must be issued after an hour to reactivate the Evaluation RZ/G Multimedia Package. For further information please see Quickstart Guide that is delivered with the STKaRZG2x.

e.g.

 
$ tar -C ~/workspace/rocko.TQMaRZG2x.BSP.SW.0010/ci-meta-tq/sources -zxvf ~/Downloads/RZG2_Group_Evaluation_Software_Package_for_Linux_20200619.tar.gz

6. The meta-rzg2 layer provides a script to deploy the RZ/G Multimedia Package into the right place. Navigate to the meta-rzg2 Yocto layer and execute the copy_proprietary_softwares script:

$ cd ~/workspace/rocko.TQMaRZG2x.BSP.SW.0010/ci-meta-tq/sources/meta-rzg2
$ sh docs/sample/copyscript/copy_proprietary_softwares.sh -f ~/workspace/rocko.TQMaRZG2x.BSP.SW.0010/ci-meta-tq/sources/proprietary
$ cd ../../

7. Export the environment DISTRO and MACHINE³⁾ environment variable:

$ export DISTRO=dumpling-wayland-rzg2
$ export MACHINE=tqmarzg2m_mbarzg2x

8. Setup local branch to track the remote branch.

$ git branch -u origin/dunfell

9. Configure the Build:

$ source setup-environment tqmarzg2x_build rzg2

10.Build an Image for STKaRZG2x:

Image with debug features/root login

bitbake rzg2-image-weston-debug-debug

Image without debug features/root login

bitbake rzg2-image-weston-debug

The resulting image is tmp/deploy/images/tqmarzg2m_mbarzg2x⁴⁾/rzg2-image-weston-debug-tqmarzg2m_mbarzg2x⁵⁾.wic
11. Write the Image⁶⁾⁷⁾

$ sudo dd if=tmp/deploy/images/tqmarzg2m_mbarzg2x/rzg2-image-weston-debug-tqmarzg2m_mbarzg2x.wic of=TARGET_DEVICE

12. Boot the STKaRZG2x from SD card (cf. MBaRZG2x DIP switch settings) |

¹⁾

i.e. value for MACHINE variable

²⁾

for testing purposes Yocto Project provides a ready to use virtual machine called Build Appliance

³⁾

valid machines are
tqmarzg2m-mbarzg2x
tqmarzg2n_mbarzg2x
tqmarzg2h_mbarzg2x

⁴⁾

valid machines are
tqmarzg2m-mbarzg2x
tqmarzg2n_mbarzg2x
tqmarzg2h_mbarzg2x

⁵⁾

valid machines are
tqmarzg2m-mbarzg2x
tqmarzg2n_mbarzg2x
tqmarzg2h_mbarzg2x

⁶⁾

valid machines are
tqmarzg2m-mbarzg2x
tqmarzg2n_mbarzg2x
tqmarzg2h_mbarzg2x

⁷⁾

TARGET_DEVICE has to be an SD card

Embedded module TQMaRZG2x - YOCTO Linux BSP documentation

Preface

Prerequisites

Build Host

Yocto Build instructions

BSP build instructions

Image with debug features/root login

Image without debug features/root login