View source for R-Car/Boards/CCPF-SK/GettingStarted/Linux

{{Template:R-Car-Gen3-Navbox}}
{{TOC right}}

[[Category:R-Car]]
[[Category:R-Car Gen3]]

== Introduction ==

This page contains how to set up CCPF-SK for the first time. 
* [[R-Car/Boards/CCPF-SK]]

== Required items ==

# [[R-Car/Boards/CCPF-SK | CCPF-SK]]
# [[R-Car/Boards/H3SK | R-Car Starter Kit Premier(H3)]] or [[R-Car/Boards/M3SK | R-Car Starter Kit Pro(M3)]]
#: See also [[{{PAGENAME}}#Confirmed_Starter_Kit]].
# Micro SD card(at least 16GB)
# Tools for assembly
#* phillips screwdriver, wrench, nut driver
# Host PC(Ubuntu 20.04 x64 is recommended as OS)
#* {{Note}}: For Windows user, please refer to the [[R-Car/Boards/CCPF-SK/GettingStarted/Windows]]
# Write down the MAC Address
#: The original (board default) MAC address can be found on the label on top of RJ45 connector.
# Prebuilt Yocto BSP binary
#* Download Yocto BSP binary and GFX/MMP package from following page:
#*: Binary: [https://www.renesas.com/node/1596716 Download for H3] [https://www.renesas.com/node/1596726 Download for M3]
#*: GFX/MMP: [https://www.renesas.com/node/1596721 Download for H3] [https://www.renesas.com/node/1596731 Download for M3]
#*: {{Note}} '''Source code is not needed for this guide'''. But, if source code is required, please refer to following:
#*:: Source: [https://www.renesas.com/node/1596636 Download for H3] [https://www.renesas.com/node/1596631 Download for M3]
#* Extract downloaded files
#*: ex.) R-Car Starter Kit Premier(H3)
#*:: Unzip Yocto-v5.9.0-ccpfsk-h3ulcb-binary.zip -d <working directory>
#*:: Unzip Yocto-v5.9.0-ccpfsk-h3ulcb-gfx_mmp.zip -d <working directory>
#*: Expected Directory Structure is following:
#*:: <syntaxhighlight lang=text>
<working directory>
    |-- binary      
    `-- gfx_mmp
</syntaxhighlight>

=== Confirmed Starter Kit ===
{| class="wikitable"
|-
!Board !! SoC !! Confirmed
|-
| R-Car Starter Kit Premier || H3e-2G v3.0 || OK
|-
| R-Car Starter Kit Premier || H3 v3.0 (1rank DDR) || OK
|-
| R-Car Starter Kit Premier || H3 v3.0 (2rank DDR) || NT
|-
| R-Car Starter Kit Premier || H3 v2.0 with 8GB DDR || NT
|-
| R-Car Starter Kit Premier || H3 v2.0 with 4GB DDR || NT
|-
| R-Car Starter Kit Pro || M3 v3.0 || OK
|-
| R-Car Starter Kit Pro || M3 v1.0 || NT
|}
{{Note}} NT='Not Tested'
See also:
* [[R-Car/Boards/H3SK#Hardware]]
* [[R-Car/Boards/M3SK#Hardware]]

== HW Setup ==

=== Assemble the CCPF-SK ===

Video and documentation:
* [http://www.shimafuji.co.jp/en/products/1923 English page]
* [http://www.shimafuji.co.jp/products/2308 Japanese page]

== SW Setup ==

=== Prepare SD card ===

# Insert SD card to Host PC
# Install bmaptool
#: <syntaxhighlight lang=bash>sudo apt install bmap-tools</syntaxhighlight>
# Check SD card device file path(ex. /dev/sdb, /dev/mmcblk0 and so on)
#: <syntaxhighlight lang=bash>sudo fdisk -l</syntaxhighlight>
# Flash image to SD card using bmaptool
#: <syntaxhighlight lang=bash>
cd <working directory>
sudo umount /dev/sdx*
sudo bmaptool copy ./binary/rootfs/core-image-weston-release-h3ulcb.wic.xz /dev/sdx
# note: If you use m3 starter kit, please use core-image-weston-release-m3ulcb.wic.xz
</syntaxhighlight>
# Copy GFX/MMP package to 2nd partition of SD card
#: <syntaxhighlight lang=bash>
sudo mount /dev/sdx2 /mnt
sudo cp ./gfx_mmp/gfx_mmp.tar.bz2 -t /mnt
sudo umount /mnt
</syntaxhighlight>

=== Flashing IPL(Firmware) ===

# Install required application and setup serial device.
#: <syntaxhighlight lang=bash>
sudo apt install python3 python3-pip
pip3 install pyserial
sudo gpasswd -a $USER dialout
</syntaxhighlight>
# Power off the Boards
# Connect Host PC and the Board with Micro-USB cable.
## /dev/ttyUSBx is checked by using "dmesg" command
##: <syntaxhighlight lang=bash>
dmesg | grep /dev/ttyUSB
</syntaxhighlight>
# Run the script to flash IPL(firmware)
## Execute following command
##: <syntaxhighlight lang=bash>
cd binary/ipl
./renesas-bsp-rom-writer_64bit/starterkit/linux/yocto_writer
</syntaxhighlight>
## Follow the instruction shown in console.
## Wait for script is finished.

=== Booting Yocto ===

# power off the board
# Insert Micro SD card to the board
# launch minicom
#: <syntaxhighlight lang=bash>minicom -D /dev/ttyUSBx </syntaxhighlight>
# Power on the board and interrupt autoboot on U-boot by pressing any key.
# Execute following command for set up U-boot:
#: <syntaxhighlight lang=bash>
setenv ethaddr xx:xx:xx:xx:xx:xx
setenv bootargs 'rw root=/dev/mmcblk1p1 rootwait'
setenv dtb 'r8a77951-ulcb-ccpf-sk.dtb'
setenv load_kernel_sd 'ext2load mmc 0:1 0x48080000 /boot/Image'
setenv load_dtb_sd 'ext2load mmc 0:1 0x48000000 /boot/${dtb}'
setenv bootcmd 'run load_kernel_sd; run load_dtb_sd; booti 0x48080000 - 0x48000000'
saveenv
</syntaxhighlight>
#: Note:
#:: Input your board's mac address instead of "xx:xx:xx:xx:xx:xx ".
#:: dtb is changed by Starter Kit version. Please refer to following table.
#:: Please refer to the following page to check your Starter kit version:
#::* https://elinux.org/R-Car/Boards/H3SK#Hardware
#::* https://elinux.org/R-Car/Boards/M3SK#Hardware
# Execute "reset" command on U-boot to reset the board
# Yocto will be booted automatically
#: Note:
#:: The board reboots automatically for the first booting Yocto.
#:: This is caused by installing GFX/MMP package.
#:: After the second boot, automatic reboot is not occurred.
::: {| class="wikitable"
|-
! Board name !! SoC version !! Type Name || DTB file
|-
| H3SK || 2.0<br>2.0<br>2.0/3.0 ||  RTP0RC77951SKBX010SA00<br>RTP0RC77951SKBX010SA01<br>RTP0RC77951SKBX010SA03 || r8a77951-ulcb-ccpf-sk.dtb
|- 
| H3e-2G SK || 3.0 ||  RTP8J779M1ASKB0SK0SA003 || r8a779<span style="color:#ff0000;">m</span>1-ulcb-ccpf-sk.dtb
|- 
| M3SK || 1.0 || RTP0RC7796SKBX0010SA09 || r8a77960-ulcb-ccpf-sk.dtb
|- 
| M3SK || 3.0 || RTP8J77961ASKB0SK0SA05A || r8a77961-ulcb-ccpf-sk.dtb
|- 
|}

== Next Step ==

Building and Customizing Yocto BSP
* [[R-Car/Boards/CCPF-SK/Yocto-Gen3]]
<!-- using other OS(AGl/Ubuntu/Android/RTOS and so on.) -->

== Troubleshooting ==

=== Q&A site ===
* https://renesasrulz.com/r-car-h3-m3-cockpit/

=== FAQ site ===
* https://en-support.renesas.com/knowledgeBase/category/31363 (English page)
* https://ja-support.renesas.com/knowledgeBase/category/31403 (Japanese page)

=== U-boot doesn't boot. ===
* Please check the Dip switch(SW1=ON, SW6=All ON) on R-Car Starter Kit(Not CCPF-SK board).
: See also :
:* https://elinux.org/R-Car/Boards/H3SK#Flashing_firmware
:* https://elinux.org/R-Car/Boards/M3SK#Flashing_firmware
* If U-Boot doesn't boot in spite that SW1/SW6 is correct, please flash the IPL(firmware) again.
: See also:
:* https://elinux.org/R-Car/Boards/H3SK#Flashing_firmware_by_using_CPLD_and_Flash_Writer
:* https://elinux.org/R-Car/Boards/M3SK#Flashing_firmware_by_using_CPLD_and_Flash_Writer
* If U-Boot doesn't boot after following above instruction, the board may be broken.
: So please try other board.