1
0
mirror of https://git.yoctoproject.org/meta-arm synced 2026-07-16 15:57:19 +00:00
Files
meta-arm/meta-arm-autonomy/documentation/n1sdp-image-customization.md
Diego Sueiro 1b2500bfb0 arm-autonomy/wic: Deploy Xen related artefacts in the wic boot partition
This patch brings the following changes:
* Documentation about how to customize the wic image for N1SDP
* Introduce a custom wks and grub.cfg file for N1SP when building with
  `DISTRO_FEATURES += "arm-autonomy-host"` to include Xen artefacts and boot
  option.
* Introduce a mechanism to include extra global settings for machines defined
  in meta-arm-bsp when building with `DISTRO_FEATURES += "arm-autonomy-host"`.

Change-Id: Ic9f36bae3bf04df1ee6a6c543e812f27c5c537a0
Issue-Id: SCM-1065
Signed-off-by: Diego Sueiro <diego.sueiro@arm.com>
Signed-off-by: Jon Mason <jon.mason@arm.com>
2020-10-02 10:28:01 -04:00

1.4 KiB

Customizing Arm Autonomy Host image layout for N1SDP

When buiding with DISTRO_FEATURES += "arm-autonomy-host" the user can perform a couple of customizations in the generated wic image:

  1. Set the guest partition size (default: 4iG) via GUEST_PART_SIZE and GUEST_PART_SIZE_UNIT (M or G) variables to be set in any conf file. The value of these variables should be aligned with the sum of all XENGUEST_IMAGE_DISK_SIZE set for the guests. By default, LVM2 metadata is 1 MiB per physical volume, hence it needs to be taken into account when setting GUEST_PART_SIZE.

  2. The wic image partition layout and contents with a custom wks file via ARM_AUTONOMY_WKS_FILE variable (default: arm-autonomy-n1sdp-efidisk.wks.in which is affected by GUEST_PART_SIZE, GUEST_PART_SIZE_UNIT and GRUB_CFG_FILE variables).

  3. Custom grub.cfg file via GRUB_CFG_FILE (default: arm-autonomy-n1sdp-grub.cfg) variable to be set in any conf file. The full path or relative to ARM_AUTONOMY_WKS_FILE should be set.

The arm-autonomy-n1sdp-efidisk.wks.in and arm-autonomy-n1sdp-grub.cfg files are located at meta-arm-autonomy/dynamic-layers/meta-arm-bsp/wic.

Other variables can also be custmized to set what files need to be included in the wic image boot partition. Please refer to meta-arm-autonomy/dynamic-layers/meta-arm-bsp/conf/machine/n1sdp-extra-settings.inc for more details.