README

   1 This README file contains information on the contents of the meta-agl-refhw-gen3
   2 layer which provides support for the Renesas R-Car H3 based AGL reference
   3 hardware.
   4
   5 Dependencies
   6 ============
   7
   8 This layer depends on:
   9
  10   URI: git://git.openembedded.org/openembedded-core
  11   layers: meta
  12   branch: kirkstone
  13
  14   URI: git://git.openembedded.org/meta-openembedded
  15   layers: meta-oe, meta-python
  16   branch: kirkstone
  17
  18   URI: https://github.com/renesas-rcar/meta-renesas
  19   branch: kirkstone-dev_3.5_M3_v5.9.0
  20
  21
  22 Build Instructions
  23 ==================
  24
  25   I. Building with the layer in the AGL environment
  26  II. Build agl-demo-platform by using meta-agl-refhw-gen3
  27 III. Updating firmware
  28  IV. Notes
  29
  30
  31 I. Adding the meta-agl-refhw-gen3 layer to your AGL environment
  32 ===============================================================
  33
  34 This layer has been integrated into the AGL build environment for the UCB 11.0
  35 (Kooky Koi) release, so manual integration is no longer required.  See section
  36 (II) below for how to build an image, and the "How to build the Firmware" section
  37 in the document meta-agl-refhw-gen3/docs/ReferenceHW_Rcar_gen3.md for how to
  38 configure a standalone build without AGL.
  39
  40
  41 II. Build for Reference Hardware
  42 ================================
  43
  44 You should follow the instructions in the "Building for Supported Renesas Boards"
  45 section on the AGL developer site to build images for the reference hardware.
  46
  47 Use the "h3ulcb" machine and "agl-refhw-h3" feature when configuring, e.g.:
  48
  49         $ cd $AGL_TOP
  50         $ source meta-agl/scripts/aglsetup.sh -m h3ulcb -b build \
  51           agl-refhw-h3 agl-demo agl-devel
  52
  53 This works as the AGL reference hardware support activated by the "agl-refhw-h3"
  54 feature integrates on top of the "h3ulcb" (or "h3ulcb-nogfx") machine support in
  55 the AGL UCB tree.  Note that it has not been tested with the "h3ulcb-kf" machine.
  56 In the resulting build, the image can be used on the reference hardware by using
  57 the DTB file "r8a7795-agl-refhw.dtb".  In the reference hardware u-boot settings,
  58 this can be done with the following (in case of booting from the Micro SD card
  59 in SD#0):
  60
  61         => setenv bootargs 'console=ttySC0,115200 root=/dev/mmcblk1p1 rootwait ro rootfstype=ext4'
  62         => setenv bootcmd 'run load_ker; run load_dtb; booti 0x48080000 - 0x48000000'
  63         => setenv load_dtb 'ext4load mmc 0:1 0x48000000 /boot/r8a7795-agl-refhw.dtb'
  64         => setenv load_ker 'ext4load mmc 0:1 0x48080000 /boot/Image'
  65         => saveenv
  66
  67         => printenv
  68         ...
  69         bootargs=console=ttySC0,115200 root=/dev/mmcblk1p1 rootwait ro rootfstype=ext4
  70         bootcmd=run load_ker; run load_dtb; booti 0x48080000 - 0x48000000
  71         load_dtb=ext4load mmc 0:1 0x48000000 /boot/r8a7795-agl-refhw.dtb
  72         load_ker=ext4load mmc 0:1 0x48080000 /boot/Image
  73         ..
  74
  75
  76 III. Updating firmware
  77 ======================
  78
  79 Please refer to meta-agl-refhw-gen3/docs/ReferenceHW_Rcar_gen3.md for details.
  80
  81
  82 IV. Notes
  83 =========
  84 1.  SD#1 is not supported.