UEFI¶

Introduction¶

The emphasis when integrating devices using UEFI is to use the firmware to support and execute a bootloader. Integration has involved using UEFI with:

• PXE which then downloads Grub (mustang, D02 and D03)
  • relies on UEFI exposing a network interface.
• fastboot (HiKey 620)
  • involves the use of LXC to run fastboot flash commands to deploy complete images, including boot, system and userdata amongst others.
• onboard grub (Hikey 960)
  • A UEFI application is installed by the test writer using fastboot.
• onboard flash storage (Juno)
  • device-specific support for running commands in a UEFI shell application.

UEFI menus¶

Some UEFI implementations use a menu which can be processed over serial but these menus have proved to be unreliable for full automation as that involves creating dynamic menu items through a Device Manager. Admins need to create static menu items where all LAVA will do is select a known menu item. e.g.:

[1] PXE boot
[2] Reboot

This can then be automated using these defaults from base.jinja2:

{% set base_menu_interrupt_prompt = 'The default boot selection will start in' -%}
{% set base_menu_interrupt_string = ' ' -%}
{% set base_item_markup_list = (
'            - "["
            - "]"'
) -%}
{% set base_item_class = '0-9' -%}
{% set base_item_separator = ' ' -%}
{% set base_label_class = 'a-zA-Z0-9\s\:' -%}
{% set base_menu_bootloader_prompt = 'Start:' -%}

These defaults describe how to match the line containing the label (PXE boot) and then match the integer which can be passed to UEFI to execute that menu item (1 in this case). Only a single integer is supported by the default base_item_class and the integer must be enclosed in the characters specified in the base_item_markup_list. In practice, only a limited number of devices use this method of presenting a menu in UEFI, so the defaults do not need to be modified.

UEFI graphical interfaces¶

Other UEFI implementations (like the D02 and D03 below) use a system which is closer to BIOS. These are not possible to drive through serial at all as changes are indicated by changing the color highlight and other similar mechanisms. Admins would need to configure the system to use a boot order or other supported mechanism so that LAVA does not interact with the UEFI at all.

Not all UEFI instances include a shell or CLI. Not all shells are capable of downloading test artifacts to the device, e.g. no TFTP support.

D02/D03¶

Serial and power control were available over the network due to the onboard BMC. This made integration much simpler, in theory.

Mustang UEFI¶

Serial and power control work reliably, UEFI is configured by the admin to use PXE to download a build of Grub with which LAVA V2 can interact. UEFI itself is capable of executing Grub locally. Working SATA support, physical NIC and a stable device.

The mustang UEFI uses the ARM BDS (boot device selector) which provides a UEFI menu which can be supported in LAVA over serial:

[1] Boot from eMMC
[2] Device Manager

The UEFI menu support in the template then generates a configuration block for each device (where LAVA PXE Grub is the menu entry created by the admins):

uefi-menu:
  menu_options: pxe-grub
  parameters:
    interrupt_prompt: The default boot selection will start in
    interrupt_string: ' '
    item_markup:
      - "["
      - "]"
    item_class: '0-9'
    separator: ' '
    bootloader_prompt: 'Start:'
  pxe-grub:
  - select:
      items:
      - 'LAVA PXE Grub'

HiKey 620¶

This section only deals with the integration of the HiKey as it relates to the UEFI support.

The HiKey UEFI uses a similar menu approach as the mustang. The HiKey 620 firmware is configured to provide a menu option to boot from the eMMC.

grub-efi:
  reset_device: False
  line_separator: unix
  menu_options: fastboot
  parameters:
    bootloader_prompt: grub>
  installed:
    parameters:
      interrupt_prompt: "Android Fastboot mode"
      interrupt_string: ' '
    commands:
      - search.fs_label rootfs root
      - linux ($root)/boot/ console=tty0 console=ttyAMA3,115200 root=/dev/mmcblk0p9 rootwait rw
      - devicetree ($root)/boot/
      - boot
uefi-menu:
  menu_options: fastboot
  parameters:
    interrupt_prompt: Android Fastboot mode
    interrupt_string: ' '
    item_markup:
      - "["
      - "]"
    item_class: '0-9'
    separator: ' '
    bootloader_prompt: "Start:"
    boot_message: Booting Linux Kernel...
  fastboot:
  - select:
      items:
       - boot from eMMC

HiKey 960¶

This section only deals with the integration of the HiKey as it relates to the UEFI support.

The HiKey UEFI uses a similar menu approach as the mustang. The HiKey 960 is configured using DIP switches to always go into fastboot which can then be interrupted after flashing the relevant files to boot the system. This means that the 960 device configuration does not describe UEFI at all, simply fastboot and then grub:

fastboot: ['boot', 'wait-usb-add', 'lxc-add-device']
grub:
  reset_device: False
  sequence:
  - wait-fastboot-interrupt
  installed:
    commands:
      - boot