Building and flashing images on Renesas R-Car S4¶
To flash AutoSD onto your R-Car S4 board, you must update the R-Car S4 boot firmware, host the {productshortname} image on a TFTP server on your workstation, and configure your R-Car S4 to communicate with the TFTP server.
Prerequisites
- Access to the Renesas R-Car S4 support page
- A workstation PC configured with a TFTP server
- A network connection between the PC and the R-Car S4 board
Installing the Boot Firmware¶
To install the boot firmware for the R-Car S4, download the startup guide, Tera Term macros, and boot firmware files from the R-Car S4 support page. These files are in the Software Downloads section and require login credentials from Renesas.
- Download the Startup Guide zip file,
R-Car_S4_SDK_start_up_guide_content_v3.16.2.zip
. - Extract the
R-CarS4_SDK_StartupGuide_3.16.2.zip
file from the archive. - This archive contains the
R-CarS4_SDK_StartupGuide.pdf
guide and theteratermmacro
folder. - Download the firmware files from
R-Car S4 SDK Linux PKG with GCC compiler v3.16.2
. - Download
xOS3_SDK1_Linux_ReferenceSDK1_v3.16.2_release.zip
- Unpack the archive, then unpack the included
rcar-xos_sdk1-gateway_v3.16.2_release.tar.gz
file - The boot firmware is in
rcar-xos/v3.16.2/os/bootloader/s4
To install the firmware, follow the instructions in section 18 of the R-CarS4_SDK_StartupGuide.pdf
, “How to flash images.”
Installing the AutoSD Image¶
To flash AutoSD onto your R-Car S4 board, you must host the AutoSD image on a TFTP server on your workstation machine and configure your R-Car S4 to communicate with the TFTP server.
Prerequisites
- Boot firmware is installed and working
- A workstation PC configured with a TFTP server
- A network connection between the PC and the R-Car S4 board
Configuring Networking in U-Boot¶
Configure networking on your R-Car S4 so that the board can communicate with the TFTP server that hosts your AutoSD image.
Procedure
- Connect port 1 of the 3 ports on the Ethernet sub-board.
Note
Identify port 1 from the PCB label (silkscreen) next to the connector. The 3 connectors are labeled CN101, CN201, CN301. Port 1 is CN101. You can also observe the physical layout of the board. Port 1 is farther apart from the other 2 ports, and to the right when you face the RJ45 connector side of the board.
-
Set the necessary networking environment variables:
setenv ethaddr __<xx:xx:xx:xx:xx:xx>__ setenv ipaddr 192.168.0.20 setenv netmask 255.255.255.0 setenv serverip 192.168.0.1 saveenv
Where the values match the values for your network setup:
ethaddr
specifies the MAC address from the sticker attached to the Ethernet connectoripaddr
specifies the IP address of the S4 boardnetmask
specifies the standard netmaskserverip
specifies the IP address of the PC hosting the TFTP server
Building the Image¶
The process to build AutoSD images involves the automotive-image-builder
tool, which is available in the
automotive-image-builder repository. This repository contains a configuration
file for the Renesas R-Car S4 automotive-image-builder/targets/rcar_s4.ipp.yml
that you can use to build images for your R-Car S4 board.
Prerequisites
- A Fedora, CentOS, or RHEL system running on AArch64 architecture
git
gzip
- A workstation PC configured with a TFTP server
Procedure
-
Clone the
automotive-image-builder
repository:git clone https://gitlab.com/CentOS/automotive/src/automotive-image-builder.git
-
Build the R-Car S4 AutoSD image:
cd automotive-image-builder ./automotive-image-builder --container build --target rcar_s4 --mode package --export image <manifest> .
Replace
<manifest>
with your custom OSBuild manifest file, in the.mpp.yml
format. If you do not have your own manifest file, you can build an AutoSD image with theautomotive-image-builder/example.mpp.yml
manifest file. -
Compress the image:
gzip cs9-rcar_s4-developer-regular.aarch64.img cs9-rcar_s4-developer-regular.aarch64.img.gz
-
Place this image into your TFTP server.
Flashing the Image¶
To flash the AutoSD image onto your R-Car S4, you must copy the image from your TFTP server onto your board.
Prerequisites
- A workstation PC configured with a TFTP server that hosts your AutoSD image
- A network connection between the PC and the R-Car S4 board
Procedure
-
Download the image file to
0x480000000
:tftp 0x480000000 cs9-rcar_s4-developer-regular.aarch64.img.gz
-
Copy the image to the MMC device
0
:gzwrite mmc 0 0x480000000 ${filesize} 1000000 0
Configuring U-Boot to Boot the Image¶
To boot the AutoSD image, you must configure U-Boot on the R-Car S4 to boot from the image.
Prerequisites
- The image is copied to MMC device
0
.
Procedure
-
Create an environment variable called
grub
that loads and starts EFI from partition 1 of the MMC device:setenv grub 'fatload mmc 0:1 0x70000000 /EFI/BOOT/BOOTAA64.EFI && bootefi 0x70000000' setenv bootargs setenv bootcmd 'run grub' saveenv
At this point, the board is configured to boot straight into AutoSD after reset.
-
To boot into AutoSD immediately, reset the board using the
reset
command. - To start the boot process manually, use the
run grub
command.
Additional Resources
- R-Car S4 Startup Guide, available from the R-Car S4 support page