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