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-dev-4.14
  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 when configuring, e.g.:
  48
  49         $ cd $AGL_TOP
  50         $ source meta-agl/scripts/aglsetup.sh -m h3uclb -b build \
  51           agl-devel agl-demo agl-localdev
  52
  53 This works as the AGL reference hardware support has been integrated with the
  54 "h3ulcb" (and "h3ulcb-nogfx") machine templates in the AGL UCB tree.  In the
  55 resulting build, the image can be used on the reference hardware by using the
  56 DTB file "r8a7795-agl-refhw.dtb".  In the reference hardware u-boot settings,
  57 this can be done with the following (in case of booting from the Micro SD card
  58 in SD#0):
  59
  60         => setenv bootargs 'console=ttySC0,115200 root=/dev/mmcblk1p1 rootwait ro rootfstype=ext4'
  61         => setenv bootcmd 'run load_ker; run load_dtb; booti 0x48080000 - 0x48000000'
  62         => setenv load_dtb 'ext4load mmc 0:1 0x48000000 /boot/r8a7795-agl-refhw.dtb'
  63         => setenv load_ker 'ext4load mmc 0:1 0x48080000 /boot/Image'
  64         => saveenv
  65
  66         => printenv
  67         ...
  68         bootargs=console=ttySC0,115200 root=/dev/mmcblk1p1 rootwait ro rootfstype=ext4
  69         bootcmd=run load_ker; run load_dtb; booti 0x48080000 - 0x48000000
  70         load_dtb=ext4load mmc 0:1 0x48000000 /boot/r8a7795-agl-refhw.dtb
  71         load_ker=ext4load mmc 0:1 0x48080000 /boot/Image
  72         ..
  73
  74
  75 III. Updating firmware
  76 ======================
  77
  78 Please refer to meta-agl-refhw-gen3/docs/ReferenceHW_Rcar_gen3.md for details.
  79
  80
  81 IV. Notes
  82 =========
  83 1.  SD#1 is not supported.
  84 2.  There are suspicious HDMI0/1 interrupts detected and disabled forcibly by
  85     the kernel during boot. The reason is under investigation.