This README file contains information on the contents of the meta-agl-refhw-gen3
layer which provides support for the Renesas R-Car H3 based AGL reference
hardware.

Dependencies
============

This layer depends on:

  URI: git://git.openembedded.org/openembedded-core
  layers: meta
  branch: dunfell

  URI: git://git.openembedded.org/meta-openembedded
  layers: meta-oe, meta-python
  branch: dunfell

  URI: https://github.com/renesas-rcar/meta-renesas
  branch: dunfell-dev-4.14


Build Instructions
==================

  I. Building with the layer in the AGL environment
 II. Build agl-demo-platform by using meta-agl-refhw-gen3
III. Updating firmware
 IV. Notes


I. Adding the meta-agl-refhw-gen3 layer to your AGL environment
===============================================================

This layer has been integrated into the AGL build environment for the UCB 11.0
(Kooky Koi) release, so manual integration is no longer required.  See section
(II) below for how to build an image, and the "How to build the Firmware" section
in the document meta-agl-refhw-gen3/docs/ReferenceHW_Rcar_gen3.md for how to
configure a standalone build without AGL.


II. Build for Reference Hardware
================================

You should follow the instructions in the "Building for Supported Renesas Boards"
section on the AGL developer site to build images for the reference hardware.

Use the "h3ulcb" machine when configuring, e.g.:

	$ cd $AGL_TOP
	$ source meta-agl/scripts/aglsetup.sh -m h3uclb -b build \
	  agl-devel agl-demo agl-localdev

This works as the AGL reference hardware support has been integrated with the
"h3ulcb" (and "h3ulcb-nogfx") machine templates in the AGL UCB tree.  In the
resulting build, the image can be used on the reference hardware by using the
DTB file "r8a7795-agl-refhw.dtb".  In the reference hardware u-boot settings,
this can be done with the following (in case of booting from the Micro SD card
in SD#0):

	=> setenv bootargs 'console=ttySC0,115200 root=/dev/mmcblk1p1 rootwait ro rootfstype=ext4'
	=> setenv bootcmd 'run load_ker; run load_dtb; booti 0x48080000 - 0x48000000'
	=> setenv load_dtb 'ext4load mmc 0:1 0x48000000 /boot/r8a7795-agl-refhw.dtb'
	=> setenv load_ker 'ext4load mmc 0:1 0x48080000 /boot/Image'
	=> saveenv
	
	=> printenv
	...
	bootargs=console=ttySC0,115200 root=/dev/mmcblk1p1 rootwait ro rootfstype=ext4
	bootcmd=run load_ker; run load_dtb; booti 0x48080000 - 0x48000000
	load_dtb=ext4load mmc 0:1 0x48000000 /boot/r8a7795-agl-refhw.dtb
	load_ker=ext4load mmc 0:1 0x48080000 /boot/Image
	..


III. Updating firmware
======================

Please refer to meta-agl-refhw-gen3/docs/ReferenceHW_Rcar_gen3.md for details.


IV. Notes
=========
1.  SD#1 is not supported.
2.  There are suspicious HDMI0/1 interrupts detected and disabled forcibly by
    the kernel during boot. The reason is under investigation.