meta-rauc-aws-ec2: add README

Author: Thomas Roos

layers/bsp/meta-rauc-aws-ec2/README.rst

@@ -0,0 +1,79 @@
+This README file contains information on the contents of the meta-rauc-aws-ec2 layer.
+
+Please see the corresponding sections below for details.
+
+Dependencies
+============
+
+* URI: git://git.openembedded.org/openembedded-core
+* URI: https://github.com/rauc/meta-rauc.git
+* URI: https://github.com/aws4embeddedlinux/meta-aws
+* URI: https://github.com/lgirdk/meta-virtualization
+
+
+Patches
+=======
+
+Please submit any patches against the meta-rauc-aws-ec2 layer via GitHub
+pull request on https://github.com/rauc/meta-rauc-community.
+
+Maintainer: Thomas Roos <throos@amazon.de>
+
+Disclaimer
+==========
+
+Note that this is just an example layer that shows a few possible configuration
+options how RAUC can be used.
+Actual requirements may differ from project to projects and will probably need
+a much different RAUC/bootloader/system configuration.
+
+Also note that this layer is for demo purpose only and does not care about
+migratability between different layer revision.
+
+I. Adding the meta-rauc-aws-ec2 layer to your build
+=======================================================
+
+Run 'bitbake-layers add-layer meta-rauc-aws-ec2'
+
+II. Build The Demo System
+=========================
+
+::
+
+   $ source oe-init-build-env
+
+Set the ``MACHINE`` to the model you intend to build for. E.g.::
+
+
+   MACHINE = "aws-ec2-arm64"
+   # or MACHINE = "aws-ec2-x86-64"
+
+Make sure either your distro (recommended) or your local.conf have ``rauc``
+``DISTRO_FEATURE`` enabled::
+
+   DISTRO_FEATURES:append = " rauc"
+
+Add this to your local.conf
+   INHERIT += "aws-ec2-image"
+
+Build the image::
+
+   $ bitbake core-image-minimal
+
+III. Flash & Run The Demo System
+================================
+
+Follow instructions here: https://github.com/aws4embeddedlinux/meta-aws/blob/master/scripts/ec2-ami/README.md
+
+IV. Build and Install The Demo Bundle
+=====================================
+
+To build the bundle, run::
+
+  $ bitbake ec2-demo-bundle
+
+Copy the generated bundle to the target system via scp.
+
+On the target, you can then install the bundle::
+
+  # rauc install /path/to/ec2-demo-bundle.raucb

layers/bsp/meta-rauc-aws-ec2/recipes-core/bundles/ec2-demo-bundle.bb

@@ -0,0 +1,17 @@
+inherit bundle
+
+LICENSE = "MIT"
+LIC_FILES_CHKSUM = "file://${COMMON_LICENSE_DIR}/MIT;md5=0835ade698e0bcf8506ecda2f7b4f302"
+
+RAUC_BUNDLE_COMPATIBLE = "aws-ec2 demo platform"
+
+RAUC_BUNDLE_FORMAT = "verity"
+
+RAUC_BUNDLE_SLOTS = "rootfs"
+
+RAUC_IMAGE_FSTYPE = "tar.bz2"
+
+RAUC_SLOT_rootfs = "core-image-minimal"
+# uncomment for enabling adaptive update method 'block-hash-index'
+#RAUC_SLOT_rootfs[fstype] = "ext4"
+#RAUC_SLOT_rootfs[adaptive] = "block-hash-index"

layers/bsp/meta-rauc-aws-ec2/recipes-core/images/core-image-minimal.bbappend

@@ -0,0 +1,19 @@
+IMAGE_INSTALL:append = " kernel-image kernel-modules"
+
+inherit aws-ec2-image
+WKS_FILE = "ec2_partition.wks.in"
+do_image_wic[depends] += "boot-image:do_deploy"
+
+# Optimizations for RAUC adaptive method 'block-hash-index'
+# rootfs image size must to be 4K-aligned
+IMAGE_ROOTFS_ALIGNMENT = "4"
+# ext4 block size should be set to 4K and use a fixed directory hash seed to
+# reduce the image delta size (keep oe-core's 4K bytes-per-inode)
+EXTRA_IMAGECMD:ext4 = "-i 4096 -b 4096 -E hash_seed=86ca73ff-7379-40bd-a098-fcb03a6e719d"
+
+IMAGE_PREPROCESS_COMMAND:append = " rootfs_user_fstab"
+
+####
+rootfs_user_fstab () {
+    install -d -m 0755 ${IMAGE_ROOTFS}/data
+}