Skip to end of metadata
Go to start of metadata
 Table of contents

Introduction

The purpose of this document is to explain how to quickly setup the hardware and install the GENIVI Dev Platform (GDP) on the Renesas R-Car E2 Silk board.

Renesas R-Car E2 Silk

Please refer to this link for detailed hardware specifications.

Master

To build the Master port for Renesas Silk please check GDP Master wiki page, that includes the latest instructions for every supported target board.

GDP-11-RC2

Software and hardware set up of the Silk board for GDP-11-RC2

Software Setup 

Quick Start

The Genivi Development Platform repo uses git-submodules and source scripts to automate the configuration of the required repository build layers. Although this does not fully automate the process, the use of it is advised especially for those wanting to get up and running quickly.

The following is known to work on Ubuntu Linux 14.04 LTS (x86_64)

  1. Install the required development tools on the host by executing the following command:
     $ sudo apt-get install gawk wget git diffstat unzip texinfo gcc-multilib build-essential chrpath socat libsdl1.2-dev xterm
  2. Create a directory for the GDP sources
    $ mkdir GDP
    $ cd GDP
    
  3. Clone the Genivi Development Platform, specifying 'gdp-11' target branch 
     $ git clone https://github.com/GENIVI/genivi-dev-platform.git -b gdp-11-rc2
  4. Initialise build environment
    $ cd genivi-dev-platform
    $ source init.sh silk
  5. Obtain and Install Renesas Graphics Drivers
  6. If you wish to enable touch support for the known Genivi AMM monitor (Faytech 10" V2), uncomment in the local.conf
    #USE_FAYTECH_MONITOR = "1"
  7. Bitbake the image

    $ bitbake genivi-dev-platform

  8. Once built, Setup Hardware & Deploy

Obtain and Install Renesas Graphics Drivers

The graphics and multimedia acceleration packages for Silk/Porter  can be downloaded directly from here via a "click through" license. Note that these easy access drivers have a time limit- the OpenGL and H.264 codec library stop drawing after 3 hours up time, whilst non-graphical services continue. Drivers without this limit are available from Renesas marketing.

The download consists of the following two ZIP files, which can be found under the links for "download Multimedia and Graphics library" and "download related Linux drivers":

  • r-car_series_evaluation_software_package_for_linux-20151228.zip
  • r-car_series_evaluation_software_package_of_linux_drivers-20151228.zip

Follow the following steps to integrate the drivers into the Renesas BSP Yocto layers:

  1. Unzip the two downloads into a folder. In this example a temporary directory is used.
    $ cd $HOME/GDP
    $ mkdir binary-tmp
    $ <unzip the two downloads into binary-tmp>
    

    After this step there should be two files in binary-tmp:

    R-Car_Series_Evaluation_Software_Package_for_Linux-*.tar.gz
    R-Car_Series_Evaluation_Software_Package_of_Linux_Drivers-*.tar.gz
    
  2. Populate meta-renesas with the graphics acceleration drivers.
    cd $HOME/GDP/genivi-dev-platform/meta-renesas/meta-rcar-gen2
    ./copy_gfx_software_<board>.sh ../../binary-tmp
    
  3. Populate meta-renesas with the multimedia acceleration drivers.
    cd $HOME/GDP/genivi-dev-platform/meta-renesas/meta-rcar-gen2
    ./copy_mm_software_lcb.sh ../../binary-tmp
    
  4. Optionally remove the temporary directory
    $ rm -r ../../../binary-tmp
    

    The copy scripts locate the needed parts from the archives in the temporary directory and copies them into the required location in the BSP layers.

Alternatively the drivers can be copied manually

Hardware Setup

Hardware prerequisites

  1. Renesas Silk Board
  2. AC adapter
  3. USB Cable (A-microB Cable)
  4. LAN Cable
  5. Stereo speaker with 3.5 stereo connector (known to work reference)
  6. USB hub (known to work reference)
  7. Touchscreen monitor with HDMI connector (known to work reference) (A non touchscreen monitor paired with a USB mouse can also be used)
  8. Ethernet switch (known to work reference)
  9. LAN cable (2)
  10. Keyboard (known to work reference)
  11. 16GB SD-card
  12. Second 16GB (or less) SD-card for Last User Mode feature
  13. HDMI Cable (known to work reference)

Deployment

Deployment (SDCARD)

On the host

  • Create EXT3 partition on the SD-card.
  • Mount the SD-Card partition under /media/$SDCARD_LABEL.
    Note: Please replace $SDCARD_LABEL with the path to where the SD-card was mounted.
  • Copy the GENIVI Dev Platform files onto the SD-card.
  1. Go to your build directory:
    $ cd $BUILDDIR/tmp/deploy/images/silk 
    
  2. Make sure the SD-Card filesystem is empty
    $ rm -rf /media/$SDCARD_LABEL/*
  3. Extract the root file system archive into the SD-card
    $ sudo tar --extract --numeric-owner --preserve-permissions --preserve-order --totals \
               --directory=/media/$SDCARD_LABEL --file=genivi-dev-platform-silk.tar.bz2 
  4. Copy Kernel Image and Device Tree Blob file into the /boot directory of the SD-card
    $ sudo cp --remove-destination uImage uImage-r8a7794-silk.dtb /media/$SDCARD_LABEL/boot
  5. Ensure the changes have been written to disk
    $ sync 

  6. unmount the SD-Card and insert the card into the SD0 slot of the Renesas board.

To access the shell (serial)

  1. With the Silk board powered off, connect the 'Debug Serial 0' port on the board (for Silk mini-USB port close to on/off switch) with the host PC using the USB cable.
  2. Use 'screen'  (may need to apt-get install screen)
    $ sudo screen /dev/ttyUSB0 38400
  3. Or start a terminal emulator, such as 'minicom' or 'picocom', on the host, connecting to the USB serial port (/dev/ttyUSB0) with 38400, 8n1 settings.
  4. Power on the Silk board to see a shell on the console

On the target board

It is assumed that the Renesas Silk board already has u-boot running as second stage boot loader.

Change U-Boot parameters to boot from SD card
  1. Power up the board and, using your preferred terminal emulator, stop the board's autoboot and run the following 'print' commands to check environment.

    => print

    Please check if the ethaddr environment variable is set to the MAC address value shown on the label on top of the RJ45 Ethernet connector. If not please set it using the following command.

    => setenv ethaddr <MAC address>

    e.g. setenv ethaddr 2e:09:0a:00:75:b5

  2. Then set the follow environment variables and save them
    => setenv baudrate 38400
    => setenv ethact sh_eth
    => setenv bootargs_console console=ttySC10,${baudrate}
    => setenv bootargs_video vmalloc=384M video=HDMI-A-1:1024x768-32@60
    => setenv bootcmd_sd 'ext4load mmc 1:1 0x40007fc0 boot/uImage;ext4load mmc 1:1 0x40f00000 boot/uImage-r8a7794-silk.dtb'
    => setenv bootcmd 'setenv bootargs ${bootargs_console} ${bootargs_video} root=/dev/mmcblk0p1 rw rootfstype=ext3;run bootcmd_sd;bootm 0x40007fc0 - 0x40f00000'
    => saveenv

     

  3. And then reboot the board
    1. User / password is root / root

Limitations and Known Issues

GDP-367 - Crashes on silk board To Do

GDP-ivi9

Software and hardware set up of the Silk board for GDP-ivi9

Software Setup 

Quick Start

The Genivi Development Platform repo uses git-submodules and source scripts to automate the configuration of the required repository build layers. Although this does not fully automate the process, the use of it is advised especially for those wanting to get up and running quickly.

The following is known to work on Ubuntu Linux 14.04 LTS (x86_64)

  1. Install the required development tools on the host by executing the following command:
    $ sudo apt-get install gawk wget git diffstat unzip texinfo gcc-multilib build-essential chrpath socat libsdl1.2-dev xterm
  2. Create a directory for the GDP sources
    $ mkdir GDP
    $ cd GDP
    
  3. Clone the Genivi Development Platform, specifying 'gdp-ivi9' target branch 
     $ git clone https://github.com/GENIVI/genivi-dev-platform.git -b gdp-ivi9
  4. Initialise build environment
    $ cd $HOME/GDP/genivi-dev-platform
    $ source init.sh silk
  5. Obtain and Install Renesas Graphics Drivers
  6. If you wish to enable touch support for the known Genivi AMM monitor (Faytech 10" V2), uncomment in the local.conf
    #USE_FAYTECH_MONITOR = "1"
  7. Bitbake the image

    $ bitbake genivi-dev-platform

  8. Once built, Setup Hardware & Deploy

Obtain and Install Renesas Graphics Drivers

The graphics and multimedia acceleration packages for Silk/Porter  can be downloaded directly from here via a "click through" license. Note that these easy access drivers have a time limit- the OpenGL and H.264 codec library stop drawing after 3 hours up time, whilst non-graphical services continue. Drivers without this limit are available from Renesas marketing.

The download consists of the following two ZIP files, which can be found under the links for "download Multimedia and Graphics library" and "download related Linux drivers":

  • r-car_series_evaluation_software_package_for_linux-20151228.zip
  • r-car_series_evaluation_software_package_of_linux_drivers-20151228.zip

Follow the following steps to integrate the drivers into the Renesas BSP Yocto layers:

  1. Unzip the two downloads into a folder. In this example a temporary directory is used.
    $ cd $HOME/GDP
    $ mkdir binary-tmp
    $ <unzip the two downloads into binary-tmp>
    

    After this step there should be two files in binary-tmp:

    R-Car_Series_Evaluation_Software_Package_for_Linux-*.tar.gz
    R-Car_Series_Evaluation_Software_Package_of_Linux_Drivers-*.tar.gz
    
  2. Populate meta-renesas with the graphics acceleration drivers.
    cd $HOME/GDP/genivi-dev-platform/meta-renesas/meta-rcar-gen2
    ./copy_gfx_software_<board>.sh ../../binary-tmp
    
  3. Populate meta-renesas with the multimedia acceleration drivers.
    cd $HOME/GDP/genivi-dev-platform/meta-renesas/meta-rcar-gen2
    ./copy_mm_software_lcb.sh ../../binary-tmp
    
  4. Optionally remove the temporary directory
    $ rm -r ../../../binary-tmp
    

    The copy scripts locate the needed parts from the archives in the temporary directory and copies them into the required location in the BSP layers.

Alternatively the drivers can be copied manually

Hardware Setup

Hardware prerequisites

  1. Renesas Silk Board
  2. AC adapter
  3. USB Cable (A-microB Cable)
  4. LAN Cable
  5. Stereo speaker with 3.5 stereo connector (known to work reference)
  6. USB hub (known to work reference)
  7. Touchscreen monitor with HDMI connector (known to work reference) (A non touchscreen monitor paired with a USB mouse can also be used)
  8. Ethernet switch (known to work reference)
  9. LAN cable (2)
  10. Keyboard (known to work reference)
  11. 16GB SD-card
  12. Second 16GB (or less) SD-card for Last User Mode feature
  13. HDMI Cable (known to work reference)

Deployment

Deployment (SDCARD)

On the host

  • Create EXT3 partition on the SD-card.
  • Mount the SD-Card partition under /media/$SDCARD_LABEL.
    Note: Please replace $SDCARD_LABEL with the path to where the SD-card was mounted.
  • Copy the GENIVI Dev Platform files onto the SD-card.
  1. Go to your build directory:
    $ cd $BUILDDIR/tmp/deploy/images/silk 
    
  2. Make sure the filesystem is empty
    $ rm -rf /media/$SDCARD_LABEL/*
  3. Extract the root file system archive into the SD-card
    $ sudo tar --extract --numeric-owner --preserve-permissions --preserve-order --totals \
               --directory=/media/$SDCARD_LABEL --file=genivi-dev-platform-silk.tar.bz2 
  4. Copy Kernel Image and Device Tree Blob file into the /boot directory of the SD-card
    $ sudo cp --remove-destination uImage uImage-r8a7794-silk.dtb /media/$SDCARD_LABEL/boot
  5. Ensure the changes have been written to disk
    $ sync 

  6. unmount the SD-Card and insert the card into the SD0 slot of the Renesas board.

To access the shell (serial)

  1. With the Silk board powered off, connect the 'Debug Serial 0' port on the board (for Silk mini-USB port close to on/off switch) with the host PC using the USB cable.
  2. Use 'screen'  (may need to apt-get install screen)
    $sudo screen /dev/ttyUSB0 38400
  3. Or start a terminal emulator, such as 'minicom' or 'picocom', on the host, connecting to the USB serial port (/dev/ttyUSB0) with 38400, 8n1 settings.
  4. Power on the Silk board to see a shell on the console

On the target board

It is assumed that the Renesas Silk board already has u-boot running as second stage boot loader.

Change U-Boot parameters to boot from SD card
  1. Power up the board and, using your preferred terminal emulator, stop the board's autoboot and run the following 'print' commands to check environment.

    => print

    Please check if the ethaddr environment variable is set to the MAC address value shown on the label on top of the RJ45 Ethernet connector. If not please set it using the following command.

    => setenv ethaddr <MAC address>

    e.g. setenv ethaddr 2e:09:0a:00:75:b5

  2. Then set the follow environment variables and save them
    => setenv baudrate 38400
    => setenv ethact sh_eth
    => setenv bootargs_console console=ttySC10,${baudrate}
    => setenv bootargs_video vmalloc=384M video=HDMI-A-1:1024x768-32@60
    => setenv bootcmd_sd 'ext4load mmc 1:1 0x40007fc0 boot/uImage;ext4load mmc 1:1 0x40f00000 boot/uImage-r8a7794-silk.dtb'
    => setenv bootcmd 'setenv bootargs ${bootargs_console} ${bootargs_video} root=/dev/mmcblk0p1 rw rootfstype=ext3;run bootcmd_sd;bootm 0x40007fc0 - 0x40f00000'
    => saveenv

     

  3. And then reboot the board
    1. User / password is root / root

Limitations and Known Issues