Download
Share
Print this page
Renesas RZ/G Series User Manual
  1. Manuals
  2. Brands
  3. Renesas Manuals
  4. Single board computers
  5. RZ/G Series
  6. User manual
Renesas RZ/G Series User Manual

Renesas RZ/G Series User Manual

Hide thumbs Also See for RZ/G Series:

Advertisement

Quick Links

Download this manual
Cover
RZ/G2L-SBC, Single Board Computer
Renesas Microprocessor
RZ Family RZ/G Series
OPN
US157-G2LSBCPOCZ
All information contained in these materials, including products and product specifications,
represents information on the product at the time of publication and is subject to change by
Renesas Electronics Corp. without notice. Please review the latest information published by
Renesas Electronics Corp. through various means, including the Renesas Electronics Corp.
website (http://www.renesas.com).
www.renesas.com
User's Manual: Hardware and Software
Rev.1.20 OCT, 2024
1 Renesas Electronics Corporation. All rights reserved.

Advertisement

loading
Need help?

Need help?

Do you have a question about the RZ/G Series and is the answer not in the manual?

Questions and answers

Subscribe to Our Youtube Channel

Related Manuals for Renesas RZ/G Series

Summary of Contents for Renesas RZ/G Series

  • Page 1 All information contained in these materials, including products and product specifications, represents information on the product at the time of publication and is subject to change by Renesas Electronics Corp. without notice. Please review the latest information published by Renesas Electronics Corp. through various means, including the Renesas Electronics Corp.
  • Page 2 Renesas Electronics disclaims any and all liability for any damages or losses incurred by you or any third parties arising from the use of any Renesas Electronics product that is inconsistent with any Renesas Electronics data sheet, user’s manual or other Renesas Electronics document.
  • Page 3 MultiMediaCard Association. Note that in each section of the Manual, trademark notation of ® and TM may be omitted. All other trademarks and registered trademarks are the property of their respective owners. © 2024 Renesas Electronics Corporation. All rights reserved.
  • Page 4 Microcontroller Unit Products The following usage notes are applicable to all Microprocessing unit and Microcontroller unit products from Renesas. For detailed usage notes on the products covered by this document, refer to the relevant sections of the document as well as any technical updates that have been issued for the products.
  • Page 5 This user manual describes the RZ/G2L based single board computer. This system architecture is of a generic single-board computer based on the Renesas RZ/G2L series SoC. It is a fully capable general purpose computer module aimed at HMI, industrial, and robotics applications.
  • Page 6 RZ Family / RZ/G Series RZ/G2L-SBC, Single Board Computer Introduction ........................ 5 Features ........................5 Glossary ........................11 Overview ......................13 Physical View ........................14 Required Resources ..................15 Development Tools and Software ..................15 Hardware ..........................15 RZ/G2L SoC MPU Architecture ................. 16 Operational Flow .........................
  • Page 7 RZ Family / RZ/G Series RZ/G2L-SBC, Single Board Computer GPIO Internals ........................36 Quick Start ......................39 Hardware requirement ......................39 Essential Hardware Setup ....................39 Complete Hardware Setup ....................40 Linux SD Card Creation ...................... 41 Booting ..........................41 Yocto OE Build ....................
  • Page 8 RZ Family / RZ/G Series RZ/G2L-SBC, Single Board Computer 9.7.3 Accessing the Camera ..................... 69 Package Management ......................70 9.8.1 Setting up Debian as a backend source ..............70 9.8.2 Using DPKG to install packages ................71 Install packages using Python3-pip ..................71 9.10...
  • Page 9 RZ Family / RZ/G Series RZ/G2L-SBC, Single Board Computer 14.3.2 Remote debugging on Visual Studio Code ............103 14.3.3 Remote debugging on Eclipse IDE ................ 107 14.4 Postmortem analysis example ..................113 14.4.1 Postmortem analysis on CLI .................. 113 14.4.2 Postmortem analysis on Visual Studio Code ............
  • Page 10 RZ Family / RZ/G Series RZ/G2L-SBC, Single Board Computer Revision History ..................... 127 R12UZ0158EU0102 Rev.1.2 Page 10 of 129 Oct.08.2024...
  • Page 11 RZ Family / RZ/G Series RZ/G2L-SBC, Single Board Computer Glossary Terms Description The technical name of the standard specification for Wi-Fi is 802.11. This is also the working group 802.11 - Wi-Fi that develops and maintains the standards for Wi-Fi that everyone conforms to.
  • Page 12 RZ Family / RZ/G Series RZ/G2L-SBC, Single Board Computer A system on chip is a complete hardware platform packaged on to a single chip. It contains the CPU, internal fast memory, interrupt controllers, pin controllers, ROM memory, and a number of other peripherals and even sensors;...
  • Page 13 The board supports analog audio applications via audio codec and stereo headphone jack. It also pins out five 12-bit ADC inputs for interfacing with analog sensors through an expansion module (not included). A 5V input power is sourced via a USB-C connector and managed via a single-chip Renesas RAA215300 PMIC device.
  • Page 14 RZ Family / RZ/G Series 1. Overview 1.1 Physical View Figure 1: Top side view of the RZ/G2L-SBC Figure 2: Bottom side of the RZ/G2L-SBC R12UZ0158EU0102 Rev.1.2 Page 14 of 129 Oct.08.2024...
  • Page 15 RZ Family / RZ/G Series 2. Required Resources 2. Required Resources 2.1 Development Tools and Software The following tools are used for development: • SEGGER JLink software (SEGGER - The Embedded Experts - Downloads - J-Link / J-Trace). • Tera Term (Download File List - Tera Term - OSDN) on Windows PC for accessing UART.
  • Page 16 RZ Family / RZ/G Series 3. RZ/G2L SoC MPU Architecture 3. RZ/G2L SoC MPU Architecture The RZ/G2L MPU is a feature-packed SoC (System on Chip) that can support a variety of applications. Below is an overview of SoCs. Figure 3: RZ/G2L SoC (System on Chip) Overview 3.1 Operational Flow...
  • Page 17 RZ Family / RZ/G Series 4. Functional Overview Functional Overview This section delves into the functional and design aspects of the RZ/G2L-SBC. The below image highlights the key hardware components in the RZ/G2L SBC design. Figure 5: RZ/G2L SBC System Overview...
  • Page 18 RZ Family / RZ/G Series 4. Functional Overview Dual USB Port Power Supply Controller - Covering ISL61852FIRZ (Renesas Electronics) the Industrial Temperature Range of -40C to +85C Integrated 802.11 b/g/n Wi-Fi Module iWi-L-WB (Laird) Crystal resonator for XIN XRCGB24M000F0L00R0 (Murata)
  • Page 19 RZ Family / RZ/G Series 4. Functional Overview 4.1 Overview of Connectors Given below is the basic positioning of the top-level connectors. Figure 6: RZ/G2L-SBC top side connectors. R12UZ0158EU0102 Rev.1.2 Page 19 of 129 Oct.08.2024...
  • Page 20 RZ Family / RZ/G Series 4. Functional Overview Figure 7: RZ/G2L-SBC Bottom view connectors. Figure 8: RZ/G2L-SBC side view I/O ports. R12UZ0158EU0102 Rev.1.2 Page 20 of 129 Oct.08.2024...
  • Page 21 RZ Family / RZ/G Series 4. Functional Overview 4.2 Power Supply This section delves into the RZ/G2L-SBC's power supply architecture. The RZ/G2L-SBC uses a simple design, with a 5V supply as the single external power source. 4.2.1 USB Type-C Power This board has one USB Type-C receptacle for power input with USB Power Delivery.
  • Page 22 RZ Family / RZ/G Series 4. Functional Overview Figure 9: Power supply rails. The Input power of 5V is used to generate 5 independent power lines: ➢ Two independent 3.3 V lines for peripherals and ethernet. ➢ A 1.8V master supply line ➢...
  • Page 23 RZ Family / RZ/G Series 4. Functional Overview 4.2.3 Power Supply Regulation The power supply is regulated by Renesas RAA215300 low-cost 9 channel PMIC IC. Figure 10: Block Diagram of Power Supply Regulation using RAA215300. 4.3 Power Management Integrated Circuit- PMIC All LDOs are cycled as per the POR cycle.
  • Page 24 Figure 12: Reset Control Logic 4.5 Clock Configuration The RZ/G2L-SBC design uses a Renesas VersaClock-3S as a singular programmable clock generator as the master clock source for the entire board. It drives the source clock for not just the RZ/G2L-SoC but all other devices that use an external clock input.
  • Page 25 RZ Family / RZ/G Series 4. Functional Overview Figure 13: Block diagram of Clock interfacing. 4.6 Peripheral Interface 4.6.1 Gigabit Ethernet The RZ/G2L-SBC comes with two Gigabit ethernet ports. They are identified as Eth 0 and Eth 1 in the Linux environment.
  • Page 26 RZ Family / RZ/G Series 4. Functional Overview Figure 14: Ethernet 0 PHY interfacing. R12UZ0158EU0102 Rev.1.2 Page 26 of 129 Oct.08.2024...
  • Page 27 4. Functional Overview Figure 15: Ethernet 1 PHY interfacing. 4.6.2 USB 2.0 Ports The SBC has 4 USB 2.0 ports which are of type A. The primary USB hub is the Renesas UPD720115 (µPD720115) which is a 4-port hub conforming to USB battery charging specification version 1.2. It has one upstream port and 4 downstream ports.
  • Page 28 RZ Family / RZ/G Series 4. Functional Overview Figure 16: UPD720115 block diagram. Figure 17: USB 2.0 Hub Block Diagram R12UZ0158EU0102 Rev.1.2 Page 28 of 129 Oct.08.2024...
  • Page 29 4.6.5 Audio DAC with 3.5mm Jack The RZ/G2L-SBC comes with an onboard audio DAC from Renesas: DA7219. The audio DAC is interfaced to RZ/G2L SoC to its SSI1 and I2C 0. The SSI 1 is used for audio streaming of I2S data while the I2C interface is used for mux and peripheral control.
  • Page 30 RZ Family / RZ/G Series 4. Functional Overview Figure 20: Audio CODEC Interface Block Diagram 4.6.6 HDMI Display Subsystem The RZ/G2L-SBC comes with a HDMI display output which is derived from the RGB parallel interface from RZ/G2L SoC through an RGB to HDMI converter interface IC. The physical HDMI port is a mini- HDMI type (not micro).
  • Page 31 RZ Family / RZ/G Series 4. Functional Overview Figure 21: HDMI Bridge and mini HDMI port interfacing. 4.6.7 40-pin I/O Header The RZ/G2L-SBC comes with a 40-pin GPIO interface which is broadly compliant with Raspberry Pi 3 40-pin GPIO interface and provides additional interfaces like two CAN ports. The diagram below shows the pin configuration along with marking of the bottom I/O ports for reference of the orientation of the board.
  • Page 32 RZ Family / RZ/G Series 4. Functional Overview Figure 22: 40 PIN GPIO map with orientation details. 4.6.8 PMOD Type 6A Standard Interface The RZ/G2L-SBC is equipped with a 2x6 pin header routed to the PMOD Type-6A interface conforming to the 1.3.0...
  • Page 33 RZ Family / RZ/G Series 4. Functional Overview Figure 24: PMOD Type 6A 2x6 0.1mm pin out with orientation details. 4.6.9 uSD-Card Interface The RZ/G2L-SBC comes with a spring-loaded micro-sd card slot. This is intended to be the primary storage as well as the OS boot device. The SD card is connected to channel 0 of the RZ/G2L SoC SD/MMC interface.
  • Page 34 RZ Family / RZ/G Series 4. Functional Overview Figure 26: JTAG/SWD Block Diagram 4.6.11 Expansion Connector The RZ/G2L-SBC has two connectors in the bottom J12 and J13 that contain pin outs for the ADC inputs, Bootstrapping (boot mode selection), and the QSPI1 interface in addition to a few GPIO’s. This is meant to be used in conjunction with an adapter/daughter board.
  • Page 35 RZ Family / RZ/G Series 4. Functional Overview Flash module. The QSPI is the default boot device which contains the firmware: Arm Trusted Firmware (ATF), OPTEE (loaded but disabled by default) and U-Boot. Figure 28: QSPI interface. 4.7.2 DDR4 SDRAM The DDR4 SDRAM is controlled by the DDD3L/DDR4 SDRAM Memory Controller (MEMC) that is built- in to the RZ/G2L.
  • Page 36 RZ Family / RZ/G Series 4. Functional Overview 4.7.3 EEPROM with temperature sensor. The RZ/G2L-SBC has an onboard CAT34TS02 C Temperature sensor with on-chip EEPROM, which is meant to hold factory data like Serial number, manufacturer name, etc. It is currently only used to hold the ethernet MAC ID’s.
  • Page 37 RZ Family / RZ/G Series 4. Functional Overview Figure 31: Multiplexed peripheral functions configuration diagram for GPIO pins RZ/G2L can support up to 123 general-purpose I/O pins from 49 ports in the following table: Table 3: GPIO-supported pins in RZ/G2L...
  • Page 38 RZ Family / RZ/G Series 4. Functional Overview PORT 34 P36_1 P36_0 PORT 35 P37_2 P37_1 P37_0 PORT 36 P38_1 P38_0 PORT 37 P39_2 P39_1 P39_0 PORT 38 P40_2 P40_1 P40_0 PORT 39 P41_1 P41_0 PORT 3A P42_4 P42_3 P42_2...
  • Page 39 RZ Family / RZ/G Series 5. Quick Start 5. Quick Start 5.1 Hardware requirement The basic hardware setup consists of the following: RZ/G2L-SBC 2. FTDI RS232 UART cable 3. USB-C 5V 3A+ power supply 4. SD-mmc card (minimum 8 GB) Waveshare 5”...
  • Page 40 RZ Family / RZ/G Series 5. Quick Start 5.3 Complete Hardware Setup Figure 33: Complete setup R12UZ0158EU0102 Rev.1.2 Page 40 of 129 Oct.08.2024...
  • Page 41 RZ Family / RZ/G Series 5. Quick Start 5.4 Linux SD Card Creation The Linux bootable SD card creation is a very simple process. The idea is to use any filesystem imaging tool (etcher) to burn the ‘.wic’ file (core-image-qt-rzpi.wic) located in the ‘target/images’ directory of the release.
  • Page 42 Table 5: List of packages to manually download for Yocto Build We assume that all the downloaded zip files from Table 5 are collected at the path ‘Downloads/renesas-yocto’ in the user’s home directory creating paths ‘~/Downloads/renesas- R12UZ0158EU0102 Rev.1.2 Page 42 of 129...
  • Page 43 This example assumes the pre-requisite files that are described in Table 4 are located at ‘ ~/Downloads/renesas-yocto/ rz-sbc-qt-v1.1.1’ path after unpacking. Alternatively, one can initiate a build directly in `host/src` by copying the zip files listed in Table 5 to the ‘host/src’...
  • Page 44 RZ Family / RZ/G Series 6. Yocto OE Build renesas@builder- pc:~/yocto/yocto_rzsbc_board/build/tmp/deploy/images/rzpi$ tree ├── host │ ├── build │ │ ├── core-image-qt-rzpi-20240918080332.rootfs.manifest │ │ ├── core-image-qt-rzpi-20240918080332.testdata.json │ │ ├── core-image-qt-rzpi.manifest -> core-image-qt-rzpi- 20240918080332.rootfs.manifest │ │ └── core-image-qt-rzpi.testdata.json -> core-image-qt-rzpi- 20240918080332.testdata.json │...
  • Page 45 RZ Family / RZ/G Series 6. Yocto OE Build │ ├── Readme.md │ ├── sd-creator │ │ ├── linux │ │ │ ├── Readme.md │ │ │ └── sd_flash.sh │ │ ├── Readme.md │ │ └── windows │ │ ├── config.ini │...
  • Page 46 RZ Family / RZ/G Series 6. Yocto OE Build ├── RZG2L-SBC_Evaluation_license.pdf └── target ├── env │ ├── Readme.md │ └── uEnv.txt ├── images │ ├── bl2_bp-rzpi.bin │ ├── bl2_bp-rzpi.srec │ ├── bl2-rzpi.bin │ ├── core-image-qt-rzpi.wic │ ├── dtbs │ │...
  • Page 47 RZ Family / RZ/G Series 7. Creating bootable SD card 7. Creating bootable SD card This section describes all the tools and methods for creating the Linux bootable SD card under different environments. 7.1 Linux Host This section explores the SD-flashing tools available in the Linux environment.
  • Page 48 The Renesas BSP provides firmware update tools to make it seamless to perform these tasks under multiple OS environments.
  • Page 49 RZ Family / RZ/G Series 8. Programming / Flashing Firmware to RZ/G2L-SBC The sub-directory `host/tools/uload-bootloader` in Yocto build output / release folder contains the toolset for sd-card flashing. The sub-directory contains its readme (Readme.md) file with the flashing procedure. Default bootloader images (.bin) are in the subdirectory `/boot/uload-bootloader` of the root filesystem in sd card.
  • Page 50 RZ Family / RZ/G Series 8. Programming / Flashing Firmware to RZ/G2L-SBC Step 1. Navigate through the release to the Windows utility directory and update the config.ini with the COM port number. Execute the uload-flash_bootloader.bat Step 2. Notice application windows open and perform flashing. Once the flashing is completed, it will disconnect from the UART port.
  • Page 51 RZ Family / RZ/G Series 9. Accessing Supported Features 9. Accessing Supported Features In this section, we will explore the features and interfaces available on the RZ/G2L-SBC. 9.1 QT Demo Applications The Linux root file system contains a few QT applications for demo purposes. They can be launched from the taskbar at the top of the screen.
  • Page 52 RZ Family / RZ/G Series 9. Accessing Supported Features Qt demo Screenshot Description application name Qt Smart Home - This application shows how you can (QtSmarthome- control and adjust various home demo.sh) operations. Some activities are the control of windows, blinds, heating, and lighting.
  • Page 53 RZ Family / RZ/G Series 9. Accessing Supported Features Qt Cinematic - This UX demo application presents Experience some graphical features of Qt5. (QtCinematic - The name 'Cinematic Experience' Experience- reflects how it's possible to build user demo.sh) interfaces with increased dynamics.
  • Page 54 RZ Family / RZ/G Series 9. Accessing Supported Features Enables the CAN driver enumeration and reconfigures enable_overlay_can 1 or 'yes' rzpi-can.dtbo the relevant IO pins to connect to the CAN peripheral. Enables the waveshare DSI to display touch panel enable_overlay_dsi 1 or 'yes' rzpi-dsi.dtbo...
  • Page 55 RZ Family / RZ/G Series 9. Accessing Supported Features SPI0 MISO GPIO SPI0 CK SPI0 CS GPIO C0 SDA C0 SCL GPIO GPIO GPIO GPIO CAN0 TX GPIO CAN0 RX CAN1 TX CAN1 RX The SoC uses bank ID and io line number to identify the GPIO port. The pin mux uses a unique Px_y notation for the physical pins.
  • Page 56 RZ Family / RZ/G Series 9. Accessing Supported Features Inside the P23_0 directory, some control interfaces are created by the Linux sysfs to manage the GPIO pin: root@rzpi:/sys/class/gpio# cd P23_0 root@rzpi:/sys/class/gpio/P23_0# ls active_low device direction edge power subsystem uevent value Note: The Linux sysfs is not populated with all the gpio’s.
  • Page 57 RZ Family / RZ/G Series 9. Accessing Supported Features Then reboot the RZ/G2L-SBC. To check if the I2C channel 3 is enabled, run the following command, and check the result: root@rzpi:~# i2cdetect -l i2c-3 Renesas RIIC adapter I2C adapter i2c-1...
  • Page 58 RZ Family / RZ/G Series 9. Accessing Supported Features #enable_overlay_can=1 enable_overlay_can=1 To verify that the CAN channels are enabled, run the following command and check the result: root@rzpi:~# ip a | grep can 3: can0: <NOARP,ECHO> mtu 16 qdisc noop state DOWN group default qlen 10 link/can 4: can1: <NOARP,ECHO>...
  • Page 59 9.4 On-board Audio Codec with Stereo Jack The RZ/G2L-SBC comes equipped with an onboard audio codec: Renesas DA7219. The audio codec is connected to the DAI interface (SSI 1) of the SoC configured to I2S data format for the audio data while the control interface is on the I2C 0 interface.
  • Page 60 RZ Family / RZ/G Series 9. Accessing Supported Features The following shows the two commands to play audio files. root@rzpi:~# aplay /home/root/audios/04_16KH_2ch_bgm_maoudamashii_healing01.wav root@rzpi:~# gst-play-1.0 /home/root/audios/COMMON6_MPEG2_L3_24KHZ_160_2.mp3 `aplay` command supports only `wav` format audio files. `gst-play-1.0` command supports `wav`, `mp3` and `aac` formats.
  • Page 61 RZ Family / RZ/G Series 9. Accessing Supported Features 9.5 MIPI DSI Display Touch Panel RZ/G2L-SBC has a MIPI DSI interface that supports both a display module and a touch interface. The DSI port supports dual-channel DSI and one I2C interface in the connector.
  • Page 62 RZ Family / RZ/G Series 9. Accessing Supported Features Figure 39: DSI port notch lock open by pulling it up. R12UZ0158EU0102 Rev.1.2 Page 62 of 129 Oct.08.2024...
  • Page 63 RZ Family / RZ/G Series 9. Accessing Supported Features Figure 40: Waveshare DSI touch display DSI port interfacing cable orientation. Mount the RZ/G2L-SBC on to the rear end of the display panel. R12UZ0158EU0102 Rev.1.2 Page 63 of 129 Oct.08.2024...
  • Page 64 RZ Family / RZ/G Series 9. Accessing Supported Features Figure 41: RZ/G2L-SBC mounted to the Waveshare DSI panel and interfaced. Insert the other end of the FPC cable into the RZ/G2L-SBC DSI port and lock it. The locking mechanism is shown below.
  • Page 65 RZ Family / RZ/G Series 9. Accessing Supported Features Figure 43: Metal support screws supplied by Waveshare The Waveshare DSI display panel comes with four metal supports that raise the display along with the rear attached SBC off the surface to provide sturdy support with clearance. However, these are not high enough for the RZ/G2L-SBC due to the SBC having dual ethernet ports where one port is too high sitting on the two USB ports.
  • Page 66 RZ Family / RZ/G Series 9. Accessing Supported Features 9.6 Playing Video Files on RZ/G2L-SBC Use gst-launch-1.0 to play video files. The playbin element in GStreamer makes it easy to play multimedia content. Run the following command: root@rzpi:~# gst-launch-1.0 playbin uri=file:///<path/to/your/video/path>...
  • Page 67 RZ Family / RZ/G Series 9. Accessing Supported Features Figure 45: Orientation of the camera module. Blue stripe upward. The black notch must be pulled up to unlock it. Figure 46: Pull the notch up to unlock it. Insert the flat cable in the correct orientation, as depicted in the pictures.
  • Page 68 RZ Family / RZ/G Series 9. Accessing Supported Features Figure 47: CSI module inserted. Push down on the notch to lock it with the flat cable inserted. Figure 48: Push down the notch to lock it when you have inserted the flat cable R12UZ0158EU0102 Rev.1.2...
  • Page 69 RZ Family / RZ/G Series 9. Accessing Supported Features 9.7.2 Enabling CSI camera drivers To enable the camera, edit the uEnv.txt and enable the following line: #enable_overlay_csi_ov5640=1 enable_overlay_csi_ov5640=1 Reboot the board. 9.7.3 Accessing the Camera Before initializing the camera capture, it needs to be enabled and configured. The Linux distribution has a helper script (v4l2-init.sh) in the /home/root directory to enable and configure the camera.
  • Page 70 RZ Family / RZ/G Series 9. Accessing Supported Features 9.8 Package Management The distribution comes with Debian package manager ‘apt-get’ and ‘dpkg’ for binary package handling. 9.8.1 Setting up Debian as a backend source Follow the steps below to modify the Debian package repository and install packages according to your needs.
  • Page 71 RZ Family / RZ/G Series 9. Accessing Supported Features 9.8.2 Using DPKG to install packages The utility ‘dpkg’ is the low-level package manager for Debian-based systems. It is the local system wide package manager. It handles installation, removal, provisioning, indexing and other aspects of packages installed on the system.
  • Page 72 RZ Family / RZ/G Series 9. Accessing Supported Features you don't need to install any additional libraries. It's a great choice for building desktop applications due to its simplicity and ease of use. The following steps will show how to create a new Tkinter application: Step 1.
  • Page 73 RZ Family / RZ/G Series 9. Accessing Supported Features import tkinter on_button_click(): label.config(text="Hello, Tkinter!") root = tk.Tk() root.title("Sample application") root.geometry("200x100") # Create a label label = tk.Label(root, text="Press the button", width=20, height=2) label.pack() # Create a button button = tk.Button(root, text="Click...
  • Page 74 RZ Family / RZ/G Series 9. Accessing Supported Features Note: It is a must to have an input device (USB mouse or touchscreen) plugged in before you start the browser. The lack of an input device will cause a "Segmentation fault".
  • Page 75 RZ Family / RZ/G Series 10. Network Boot and TFTP 10. Network Boot and TFTP This section outlines the process for network booting using TFTP (Trivial File Transfer Protocol). It includes configuration steps and commands necessary for a successful setup.
  • Page 76 RZ Family / RZ/G Series 10. Network Boot and TFTP 10.2 NFS server setup NFS (Network File System) is a protocol that allows clients to access files over a network as if they were local. It enables multiple clients to share files from a central server, simplifying file management across machines.
  • Page 77 RZ Family / RZ/G Series 10. Network Boot and TFTP U-Boot 2021.10 (May 24 2024 - 07:26:08 +0000) CPU: Renesas Electronics CPU rev 1.0 Model: RZpi DRAM: 896 MiB MMC: sd@11c00000: 0 Loading Environment from SPIFlash... SF: Detected is25wp256 with page size 256...
  • Page 78 RZ Family / RZ/G Series 10. Network Boot and TFTP Figure 52: TFTP boot setup Step 1: After setting up the TFTP server and ensuring the hardware connections are correct, place the required boot images such as the kernel image, device tree blob (DTB), device tree overlay (DTBO), and root file system in the TFTP directory (/tftpboot).
  • Page 79 RZ Family / RZ/G Series 10. Network Boot and TFTP renesas@builder-pc:/tftpboot/rzsbc/$ tree -L 2 ├── Image ├── overlays │ ├── rzpi-can.dtbo │ ├── rzpi-dsi.dtbo │ ├── rzpi-ext-i2c.dtbo │ ├── rzpi-ext-spi.dtbo │ └── rzpi-ov5640.dtbo ├── rootfs │ ├── bin -> usr/bin │...
  • Page 80 RZ Family / RZ/G Series 10. Network Boot and TFTP For example, load ‘Image’, ‘rzpi.dtb’ and ‘rzpi-ext-spi.dtbo’ files. => setenv bootcmd 'tftp 0x48080000 rzsbc/Image; tftp 0x48000000 rzsbc/rzpi.dtb; tftp 0x48010000 rzsbc/overlays/rzpi-ext-spi.dtbo; booti 0x48080000 - 0x48000000 - 0x48010000' Step 4: Save the changes to the environment variables so they persist across reboots: =>...
  • Page 81 RZ Family / RZ/G Series 11. Using SSH and SCP for Remote Access and File Transfers 11. Using SSH and SCP for Remote Access and File Transfers This section explains how to use SSH (Secure Shell) for secure remote access to the RZ/G2L-SBC and how to utilize SCP (Secure Copy Protocol) for file transfers.
  • Page 82 RZ Family / RZ/G Series 11. Using SSH and SCP for Remote Access and File Transfers Once the SSH connection is established, open the SSH daemon's configuration file: $ vi /etc/ssh/sshd_config Inside the file, search for a directive called PasswordAuthentication. This may be commented out.
  • Page 83 RZ Family / RZ/G Series 11. Using SSH and SCP for Remote Access and File Transfers Figure 53: SSH in settings in Mobaxterm Click ‘OK’ to save the setting. Click on the session to initiate an SSH connection. Figure 54: Connect to SSH session in Mobaxterm 11.3.2 SSH from Linux host...
  • Page 84 RZ Family / RZ/G Series 11. Using SSH and SCP for Remote Access and File Transfers $ ssh root@192.168.5.30 The authenticity of host '192.168.5.30 (192.168.5.30)' can't be established. RSA key fingerprint is SHA256:v39PhjNp4F7HcQpwJmfNOYcC+ZZ3Yw8i1ICsL2mXUgg. This key is not known by any other names.
  • Page 85 RZ Family / RZ/G Series 11. Using SSH and SCP for Remote Access and File Transfers Figure 56: Using WinSCP to transfer files 11.4.2 SCP from Linux host Step 1: Open a terminal and run $ scp <local_file> username@<device_ip>:<remote_path> For example: $ scp hello-world root@192.168.5.30:/home/root...
  • Page 86 RZ Family / RZ/G Series 12. Building the eSDK 12. Building the eSDK The extensible SDK makes it easy to add new applications and libraries to an image, modify the source for an existing component, test changes on the RZ/G2L-SBC, and ease integration into the rest of the OpenEmbedded Build System.
  • Page 87 Poky (Yocto Project Reference Distro) Extensible SDK installer version 3.1.26 ========================================================================== Enter target directory for SDK (default: ~/poky_sdk): ~/esdk/3.1.26 You are about to install the SDK to "/home/renesas/esdk/3.1.26". Proceed [Y/n]? Y Extracting SDK....done Setting it up... Extracting buildtools... Preparing build system...
  • Page 88 RZ Family / RZ/G Series 13. Application Building, Packaging and Running renesas@builder-pc:~$ source ~/esdk/3.1.26/environment-setup-aarch64-poky-linux SDK environment now set up; additionally you may now run devtool to perform development tasks. Run devtool --help for further details. Note: User needs to run the above command once for each shell session. In addition, ‘source’ is a bash specific call.
  • Page 89 /path/to/your/sdk/bin/g++) # Define the sysroot path for cross-compilation set(CMAKE_SYSROOT /path/to/your/sysroot) # Add the executable target “helloworld” add_executable(helloworld src/helloworld.c) For example, if the SDK is installed in `/home/renesas/esdk/3.1.26`, the completed configuration file will resemble the following: cmake_minimum_required(VERSION 3.10) project(HelloWorld C) set(CMAKE_C_COMPILER /home/renesas/esdk/3.1.26/tmp/sysroots/x86_64/usr/bin/aarch64-poky-linux/aarch64-...
  • Page 90 -- Check for working C compiler: /usr/bin/cc - skipped -- Detecting C compile features -- Detecting C compile features - done -- Configuring done -- Generating done -- Build files have been written to: /home/renesas/cmake_helloworld/build renesas@builder-pc:~/cmake_helloworld/build$ cmake --build [ 50%] Building C object CMakeFiles/hello.dir/src/helloworld.c.o...
  • Page 91 RZ Family / RZ/G Series 13. Application Building, Packaging and Running cmake_minimum_required(VERSION 3.10) project(HelloWorld C) set(CMAKE_C_COMPILER /home/renesas/esdk/3.1.26/tmp/sysroots/x86_64/usr/bin/aarch64-poky-linux/aarch64- poky-linux-gcc) set(CMAKE_CXX_COMPILER /home/renesas/esdk/3.1.26/tmp/sysroots/x86_64/usr/bin/aarch64-poky-linux/aarch64- poky-linux-g++) # Sysroot path set(CMAKE_SYSROOT /home/renesas/esdk/3.1.26/tmp/sysroots/rzpi) add_executable(helloworld src/helloworld.c) # Specify the installation path install(TARGETS helloworld DESTINATION /usr/local/bin) # CPack configuration set(CPACK_GENERATOR "DEB")
  • Page 92 -- Detecting C compiler ABI info - done -- Detecting C compile features -- Detecting C compile features - done -- Configuring done -- Generating done -- Build files have been written to: /home/renesas/cmake_helloworld/build renesas@builder-pc:~/cmake_helloworld/build$ cpack CPack: Create package using DEB CPack: Install projects...
  • Page 93 RZ Family / RZ/G Series 13. Application Building, Packaging and Running 13.3.2 Package a Python program This section explains how to package Python scripts into a .deb file using CPack, focusing on the necessary configurations and packaging steps. Two options are available for running a Python script: 1.
  • Page 94 RZ Family / RZ/G Series 13. Application Building, Packaging and Running cmake_minimum_required(VERSION 3.10) project(TkinterExample) # Define script and wrapper set(SCRIPT_NAME "src/main.py") set(WRAPPER_SCRIPT "src/tkinter_wrapper.sh") set(EXEC_NAME "tkinter_example") # Define installation paths set(INSTALL_DIR "/usr/local/bin") set(INSTALL_SCRIPT_DIR "/usr/local/share/tkinter_example") # Install the wrapper script configure_file(${CMAKE_SOURCE_DIR}/${WRAPPER_SCRIPT} ${CMAKE_BINARY_DIR}/${EXEC_NAME} @ONLY)
  • Page 95 -- Check for working CXX compiler: /usr/bin/c++ - skipped -- Detecting CXX compile features -- Detecting CXX compile features - done -- Configuring done -- Generating done -- Build files have been written to: /home/renesas/cmake_python/build renesas@builder-pc:~/cmake_python/build$ cpack CPack: Create package using DEB CPack: Install projects...
  • Page 96 RZ Family / RZ/G Series 13. Application Building, Packaging and Running NOTICE: BL2: <version> NOTICE: BL2: Built : <date> NOTICE: BL2: Booting BL31 NOTICE: BL31: <version> NOTICE: BL31: Built : <date> … rzpi login: root root@rzpi:~# ./helloworld Hello, World! root@rzpi:~# 13.5 Install and Run Debian application packages by using DPKG...
  • Page 97 RZ Family / RZ/G Series 13. Application Building, Packaging and Running NOTICE: BL2: <version> NOTICE: BL2: Built : <date> NOTICE: BL2: Booting BL31 NOTICE: BL31: <version> NOTICE: BL31: Built : <date> … rzpi login: root root@rzpi:~# audios demo helloworld-1.0.0-Linux.deb tkinter_example-1.0.0-Linux.deb images info v4l2-init.sh videos...
  • Page 98 RZ Family / RZ/G Series 13. Application Building, Packaging and Running For applications that have a graphical interface, the display id needs to be set in the environment. For this reason, export the DISPLAY if you're using an environment where the display is not automatically...
  • Page 99 RZ Family / RZ/G Series 14. Remote debugging using GDBServer 14. Remote debugging using GDBServer In this section, GDBServer will be utilized to facilitate remote debugging on the RZ/G2L-SBC. GDBServer enables the debugging process to run on the RZ/G2L-SBC (the target machine) while being controlled from a different system (the host machine) via a network connection.
  • Page 100 RZ Family / RZ/G Series 14. Remote debugging using GDBServer 14.3 Remote debugging example 14.3.1 Remote debugging on CLI CLI (Command Line Interface) is a text-based user interface used to interact with computer programs and operating systems. Unlike graphical user interfaces (GUIs), where users interact with visual elements (like buttons and icons), a CLI requires users to input commands in text form.
  • Page 101 RZ Family / RZ/G Series 14. Remote debugging using GDBServer root@rzpi:~# ifconfig eth1 eth1: flags=4163<UP,BROADCAST,RUNNING,MULTICAST> mtu 1500 metric 1 inet 169.254.43.30 netmask 255.255.0.0 broadcast 169.254.255.255 inet6 fe80::1ea0:d3ff:fe20:119b prefixlen 64 scopeid 0x20<link> ether 1c:a0:d3:20:11:9b txqueuelen 1000 (Ethernet) RX packets 34497 bytes 2657706 (2.5 MiB) RX errors 0 dropped 0 overruns 0 frame 0 TX packets 68954 bytes 97379412 (92.8 MiB)
  • Page 102 RZ Family / RZ/G Series 14. Remote debugging using GDBServer (gdb) target remote 169.254.43.30:2000 Remote debugging using 169.254.43.30:2000 Reading /home/root/hello-gdbserver from remote target... warning: File transfers from remote targets can be slow. Use "set sysroot" to access files locally instead.
  • Page 103 RZ Family / RZ/G Series 14. Remote debugging using GDBServer Eventually, run `quit` to exit GDB and stop the debugging section. (gdb) quit In parallel, the output can be monitored on the target device. Remote debugging from host ::ffff:169.254.43.86, port 40666...
  • Page 104 RZ Family / RZ/G Series 14. Remote debugging using GDBServer Figure 57: C/C++ Extension in VSCode 2. Create a Workspace: Create a new workspace (you can name it remote-debugging). Create a folder within this workspace and place your program file, hello-gdbserver.c in it.
  • Page 105 RZ Family / RZ/G Series 14. Remote debugging using GDBServer "version": "0.2.0", "configurations": [ "name": "gdb", "type": "cppdbg", "request": "launch", "program": "</local/path/to/the/executable>", "cwd": "${workspaceFolder}", "stopAtEntry": true, "stopAtConnect": true, "MIMode": "gdb", "miDebuggerPath": "</path/to/gdb>", "miDebuggerServerAddress": "<target_addr>:<port>", "setupCommands": [ "description": "Enable pretty-printing for gdb", "text": "enable-pretty-printing",...
  • Page 106 RZ Family / RZ/G Series 14. Remote debugging using GDBServer Ensure your workspace appears as follows: renesas@builder-pc:~/remote-debugging$ tree -a ├── program │ ├── hello-gdbserver │ └── hello-gdbserver.c └── .vscode └── launch.json 2 directories, 4 files 4. Connect to the Remote Target: As with the CLI section, start the GDBServer on the remote device and specify the target application.
  • Page 107 RZ Family / RZ/G Series 14. Remote debugging using GDBServer Figure 61: Step through each step in Debug Mode in VSCode 14.3.3 Remote debugging on Eclipse IDE In the previous section, the use of VSCode for remote debugging with GDB and GDBServer was discussed.
  • Page 108 RZ Family / RZ/G Series 14. Remote debugging using GDBServer Click Next then Finish and paste the content from hello-gdbserver.c into the C file. Step 3: Configure the Cross Toolchain Go to Project > Properties. In the left pane, select C/C++ Build > Settings.
  • Page 109 RZ Family / RZ/G Series 14. Remote debugging using GDBServer Figure 65: Configuring includes path in Eclipse tool settings In the Cross GCC Linker section, go to Libraries and specify the library search path: Library search path: /home/renesas/esdk/3.1.26/tmp/sysroots/x86_64/usr/lib Figure 66: Configuring libraries path in Eclipse tool settings In the Miscellaneous section, specify the linker flags: Linker flags: --sysroot=/home/renesas/esdk/3.1.26/poky_sdk/tmp/sysroots/rzpi...
  • Page 110 RZ Family / RZ/G Series 14. Remote debugging using GDBServer Step 4: Configure Eclipse to connect to the GDB Server: In Eclipse, go to the Run menu and select Debug Configurations. Under the Debugger tab, select C/C++ Remote Application In the Main tab, in Connection Type, select Remote and click Edit Figure 68: Debug configuration settings in Eclipse Host: Enter the IP address of RZ/G2L-SBC.
  • Page 111 RZ Family / RZ/G Series 14. Remote debugging using GDBServer Figure 69: Configuring SSH connection settings in debug configurations In the Remote Absolute File Path field, specify the location where Eclipse will copy the program on the RZ/G2L-SBC. Click Browse to connect via SSH and select the target location, or manually enter the path on the RZ/G2L-SBC.
  • Page 112 RZ Family / RZ/G Series 14. Remote debugging using GDBServer Figure 71: Configuring GDB debugger in Eclipse debug configurations Step 5: Start the Debugging Session: After configuring the debug settings, click Apply and then Debug. Eclipse will attempt to connect to the GDB server running on the target device.
  • Page 113 RZ Family / RZ/G Series 14. Remote debugging using GDBServer Figure 73: Step through each step in the Debug Mode in Eclipse The path of the compiler may need to be adjusted to reflect the specific system configuration. 14.4 Postmortem analysis example This section provides an overview of postmortem analysis, a critical process for diagnosing application crashes by examining core dump files.
  • Page 114 RZ Family / RZ/G Series 14. Remote debugging using GDBServer renesas@builder-pc:~$ source ~/esdk/3.1.26/environment-setup-aarch64-poky-linux SDK environment now set up; additionally you may now run devtool to perform development tasks. Run devtool --help for further details. renesas@builder-pc:~/remote-debugging/segfault_program$ $CC $CFLAGS segfault_example.c -o segfault_example...
  • Page 115 RZ Family / RZ/G Series 14. Remote debugging using GDBServer renesas@builder-pc:~/remote-debugging/segfault_program$ aarch64-poky-linux-gdb segfault_example core.810 GNU gdb (GDB) 9.1 Copyright (C) 2020 Free Software Foundation, Inc. License GPLv3+: GNU GPL version 3 or later <http://gnu.org/licenses/gpl.html> This is free software: you are free to change and redistribute it.
  • Page 116 RZ Family / RZ/G Series 14. Remote debugging using GDBServer "version": "0.2.0", "configurations": [ "name": "gdb", "type": "cppdbg", "request": "launch", "program": "/home/renesas/remote-debugging/program/segfault_example", "cwd": "${workspaceFolder}", "stopAtEntry": true, "stopAtConnect": true, "MIMode": "gdb", "miDebuggerPath": "/home/renesas/esdk/3.1.26/tmp/sysroots/x86_64/usr/bin/aarch64-poky- linux/aarch64-poky-linux-gdb", "miDebuggerServerAddress": "169.254.43.30:2000", "coreDumpPath": "/home/renesas/remote-debugging/segfault/core.810", "setupCommands": [ "description": "Enable pretty-printing for gdb", "text": "enable-pretty-printing",...
  • Page 117 RZ Family / RZ/G Series 14. Remote debugging using GDBServer 14.4.3 Postmortem analysis on Eclipse This subsection describes postmortem analysis using Eclipse IDE. Similar with Visual Studio Code, Eclipse allows loading core dump to inspect the application's state at the time of a crash.
  • Page 118 RZ Family / RZ/G Series 14. Remote debugging using GDBServer Figure 77: Starting analysis of the Core dump file in Eclipse debug mode Inspect the values of variables at that point in time by hovering over them or using the Variables view.
  • Page 119 The build contains a support script `bootloader_flash.py` for flashing bootloader on Linux. The script is part of the Yocto build. The official release is a qualified yocto build from Renesas and is a full package with all tools and scripts.
  • Page 120 RZ Family / RZ/G Series 15. Appendix Before performing a flashing: ✓ Make sure the board is powered off, ✓ Connect the debug serial port (SCIF0 - TXD, RXD, GND) to your Linux PC ✓ Connect the adapter board with jumpers set to serial load boot mode.
  • Page 121 RZ Family / RZ/G Series 15. Appendix '11E00 ===== Please Input Qspi Save Address === Please Input : H Please Input : H'00000 Work RAM(H'50000000-H'53FFFFFF) Clear..please send ! Writing BL2... ('.' & CR stop load) SPI Data Clear(H'FF) Check :H'00000000-0000CFFF,Clear OK H'00000000-0000CFFF Erasing....Erase Completed...
  • Page 122 RZ Family / RZ/G Series 15. Appendix Before performing a flashing: ✓ Make sure the board is powered off, ✓ Connect the debug serial port (SCIF0 - TXD,RXD,GND) to your Linux PC ✓ Connect the adapter board with jumpers set to serial load boot mode.
  • Page 123 RZ Family / RZ/G Series 16. Troubleshooting 16. Troubleshooting 16.1 Unable to run support scripts for Bootloader/Firmware flashing on Linux Not all Linux distributions ship with the Python3 package and its modules, which are required to run the support scripts described in the Programming / Flashing Firmware to RZ/G2L-SBC section ‘Flash bootloader on u-boot console—...
  • Page 124 RZ Family / RZ/G Series 17. References 16.5 ‘Ifconfig’ doesn’t list the Wi-Fi interface The Wi-Fi is not active by default at boot. While all the drivers and subsystems are loaded, the Wi-Fi must be enabled with the command ‘enable Wi-Fi’ in conmanctl utility as described in the section ‘Wi- Fi 802.11 Module’.
  • Page 125 Solutions products (github.com) u-boot: Renesas-SST/u-boot: A u-boot suporting System & Solutions Products (github.com) flash-writer: Renesas-SST/flash-writer: Serial flashing utility to load into blank boards supporting System & Solutions Products (github.com) 17.2 RZ/G2L SoC Product page: RZ/G Series (Linux-based MPU) | Renesas...
  • Page 126 RZ Family / RZ/G Series 17. References 17.3.5 JEDEC DDR4 DDR4 SDRAM STANDARD | JEDEC 17.3.6 PMOD Specification Wiki: Pmod Interface - Wikipedia Specification document: pmod-interface-specification-1_3_1.pdf (digilent.com) 17.3.7 Essential Linux Tutorial Linux/Unix Tutorial (geeksforgeeks.org) Linux/Unix Tutorial - javatpoint UNIX / LINUX Tutorial (tutorialspoint.com) 17.3.8 Packaging...
  • Page 127 RZ Family / RZ/G Series Revision History Revision History Description Rev. Date Page Summary — 1.00 Jul.12.24 Initial release Update: Yocto build output hierarchy Add ALSA Mixer figure for Audio feature New Arducam 5MP OV5640 resolutions supported Chromium web browser Debian Package Manager —...
  • Page 128 RZ/G2L-SBC, Single Board Computer – User Manual Publication Date: Oct.08.2024 Published by: Renesas Electronics Corporation...
  • Page 129 RZ Family/ RZ/G Series R12UZxxxxEU010x...

This manual is also suitable for:

Rz/g2l-sbc