Getting Started Guide for the UP2 Board¶
The UP Squared board (UP2) is an x86 maker board based on the Intel Apollo Lake platform. The UP boards are used in IoT applications, industrial automation, digital signage, and more.
Connecting to the serial port¶
The UP2 board has two serial ports. The following figure shows the UP2 board’s 40-pin HAT connector we’ll be using as documented in the UP2 Datasheet.
We’ll access the serial port through the I/O pins in the
40-pin HAT connector using a USB TTL serial cable,
and show how to connect a serial port with
PL2303TA USB to TTL serial cable for example:
Connect pin 6 (
Ground), pin 8 (
UART_TXD) and pin 10 (
UART_RXD) of the HAT
connector to respectively the
TX pins of your
USB serial cable. Plug the USB TTL serial cable into your PC and use a
console emulation tool such as
putty to communicate
with the UP2 board for debugging.
Setting up the ACRN hypervisor (and associated components) on the UP2 board is no different than other hardware platforms so please follow the instructions provided in the Run Clear Linux as the Service VM, with the additional information below.
There are a few parameters specific to the UP2 board that differ from what is referenced in the Run Clear Linux as the Service VM section:
- Serial Port settings
- Storage device name
You will need to keep these in mind in a few places:
When mounting the EFI System Partition (ESP)
# mount /dev/mmcblk0p1 /mnt
When adjusting the
- Set the
root=parameter using the
PARTUUIDor device name directly
- Set the
When configuring the EFI firmware to boot the ACRN hypervisor by default
# efibootmgr -c -l "\EFI\acrn\acrn.efi" -d /dev/mmcblk0 -p 1 -L "ACRN Hypervisor" \ -u "bootloader=\EFI\org.clearlinux\bootloaderx64.efi uart=bdf@0:18.1"
There have been reports that the UP2 EFI firmware does not always keep these settings during a reboot. Make sure to always double-check the settings if ACRN is not running correctly. There is no reliable way to set this boot order and you may want to remove other, unused boot entries and also change the boot order (
UP2 serial port setting¶
The serial port (ttyS1) in the 40-pin HAT connector is located at
serial PCI BDF 0:18.1.
You can check this from the
lspci output from the initial Clearlinux installation.
Also you can use
dmesg | grep tty to get its IRQ information for console setting; and update
console=ttyS1 in acrn.conf to match with console setting.
# lspci | grep UART 00:18.0 . Series HSUART Controller #1 (rev 0b) 00:18.1 . Series HSUART Controller #2 (rev 0b) # dmesg | grep tty dw-apb-uart.8: ttyS0 at MMIO 0x91524000 (irq = 4, base_baud = 115200) is a 16550A dw-apb-uart.9: ttyS1 at MMIO 0x91522000 (irq = 5, base_baud = 115200) is a 16550A
The second entry associated with
00:18.1 @irq5 is the one on the 40-pin HAT connector.
UP2 block device¶
The UP2 board has an on-board eMMC device. The device name to be used
throughout the Getting Started therefore is
/dev/mmcblk0pX for any partition).
The UUID of the partition
/dev/mmcblk0p3 can be found by
# blkid /dev/mmcblk
You can also use the device name directly, e.g.: