The latest development version of this page may be more current than this released 4.0.0 version.

UP Squared

Overview

UP² (UP Squared) is an ultra compact single board computer with high performance and low power consumption. It features the latest Intel® Apollo Lake Celeron™ and Pentium™ Processors with only 4W of Scenario Design Power and a powerful and flexible Intel® FPGA Altera MAX 10 onboard.

This board configuration enables kernel support for the UP Squared board.

Note

This board configuration works on all three variants of UP Squared boards containing Intel® Pentium™ SoC, Intel® Celeron™ SoC, or Intel® Atom™ SoC.

Hardware

General information about the board can be found at the UP Squared website.

Supported Features

In addition to the standard architecture devices (HPET, local and I/O APICs, etc.), Zephyr supports the following Apollo Lake-specific SoC devices:

HSUART
GPIO
I2C

HSUART High-Speed Serial Port Support

The Apollo Lake UARTs are NS16550-compatible, with “high-speed” capability.

Baud rates beyond 115.2kbps (up to 3.6864Mbps) are supported, with additional configuration. The UARTs are fed a master clock which is fed into a PLL which in turn outputs the baud master clock. The PLL is controlled by a per-UART 32-bit register called PRV_CLOCK_PARAMS (aka the PCP), the format of which is:

[31]	[30:16]	[15:1]	[0]
enable	`m`	`n`	toggle

The resulting baud master clock frequency is (n/m) * master.

Typically, the master clock is 100MHz, and the firmware by default sets the PCP to 0x3d090240, i.e., n = 288, m = 15625, which results in the de-facto standard 1.8432MHz master clock and a max baud rate of 115.2k. Higher baud rates are enabled by changing the PCP and telling Zephyr what the resulting master clock is.

Use devicetree to set the value of the PRV_CLOCK_PARAMS register in the UART block of interest. Typically a devicetree overlay file would be present in the application directory (specific to the board, such as up_squared.overlay), with contents like this:

/ {
    soc {
        uart@0 {
            pcp = <0x3d090900>;
            clock-frequency = <7372800>;
            current-speed = <230400>;
        };
    };
};

The relevant variables are pcp (the value to use for PRV_CLOCK_PARAMS), and clock-frequency (the resulting baud master clock). The meaning of current-speed is unchanged, and as usual indicates the initial baud rate.

GPIO

GPIOs are exposed through the HAT header, and can be referred using predefined macros such as UP2_HAT_PIN3. The physical pins are connected to the on-board FPGA acting as level shifter. Therefore, to actually utilize these GPIO pins, the function of the pins and directions (input/output) must be set in the BIOS. This can be accomplished in BIOS, under menu Advanced, and option HAT Configurations. When a corresponding pin is set to act as GPIO, there is an option to set the direction of the pin. This needs to be set accordingly for the GPIO to function properly.

Connections and IOs

Refer to the UP Squared website and UP Squared Pinout website for connection diagrams.

Programming and Debugging

Use the following procedures for booting an image on a UP Squared board.

Build Zephyr application 

Build a Zephyr application; for instance, to build the hello_world application on UP Squared:
```
# From the root of the zephyr repository
west build -b up_squared samples/hello_world
```
Note

A Zephyr EFI image file named zephyr.efi is automatically created in the build directory after the application is built.

Booting the UP Squared Board using UEFI 

Preparing the Boot Device

Prepare a USB flash drive to boot the Zephyr application image on a board.

Format the USB flash drive as FAT32.

On Windows, open File Explorer, and right-click on the USB flash drive. Select Format.... Make sure in File System, FAT32 is selected. Click on the Format button and wait for it to finish.

On Linux, graphical utilities such as gparted can be used to format the USB flash drive as FAT32. Alternatively, under terminal, find out the corresponding device node for the USB flash drive (for example, /dev/sdd). Execute the following command:
```
$ mkfs.vfat -F 32 <device-node>
```
Important

Make sure the device node is the actual device node for the USB flash drive. Or else you may erase other storage devices on your system, and will render the system unusable afterwards.
Copy the Zephyr EFI image file zephyr/zephyr.efi to the USB drive.

Booting Zephyr on a board

Boot the board to the EFI shell with USB flash drive connected.

Insert the prepared boot device (USB flash drive) into the board.
Connect the board to the host system using the serial cable and configure your host system to watch for serial data. See board’s website for more information.

Note

Use a baud rate of 115200.
Power on the board.
When the following output appears, press F7:
```
Press <DEL> or <ESC> to enter setup.
```
From the menu that appears, select the menu entry that describes that particular EFI shell.
From the EFI shell select Zephyr EFI image to boot.
```
Shell> fs0:zephyr.efi
```
When the boot process completes, you have finished booting the Zephyr application image.

Note

Refer to the UP Squared Serial Console Wiki page for instructions on how to connect serial console.

Note

You can safely ignore this message if it appears:

WARNING: no console will be available to OS

Booting the UP Squared Board over network 

Prepare Linux host

Install DHCP, TFTP servers. For example dnsmasq
```
$ sudo apt-get install dnsmasq
```

Configure DHCP server. Configuration for dnsmasq is below:

# Only listen to this interface
interface=eno2
dhcp-range=10.1.1.20,10.1.1.30,12h

Configure TFTP server.
```
# tftp
enable-tftp
tftp-root=/srv/tftp
dhcp-boot=zephyr.efi
```
zephyr.efi is a Zephyr EFI binary created above.
Copy the Zephyr EFI image zephyr/zephyr.efi to the /srv/tftp folder.
$ cp zephyr/zephyr.efi /srv/tftp

TFTP root should be looking like:

$ tree /srv/tftp
/srv/tftp
└── zephyr.efi

Restart dnsmasq service:

$ sudo systemctl restart dnsmasq.service

Prepare the board for network boot

Enable PXE network from BIOS settings.
Make network boot as the first boot option.

Booting the board

Connect the board to the host system using the serial cable and configure your host system to watch for serial data. See board’s website for more information.

Note

Use a baud rate of 115200.
Power on the board.

Verify that the board got an IP address. Run from the Linux host:

$ journalctl -f -u dnsmasq
dnsmasq-dhcp[5386]: DHCPDISCOVER(eno2) 00:07:32:52:25:88
dnsmasq-dhcp[5386]: DHCPOFFER(eno2) 10.1.1.28 00:07:32:52:25:88
dnsmasq-dhcp[5386]: DHCPREQUEST(eno2) 10.1.1.28 00:07:32:52:25:88
dnsmasq-dhcp[5386]: DHCPACK(eno2) 10.1.1.28 00:07:32:52:25:88

Verify that network booting is started:

$ journalctl -f -u dnsmasq
dnsmasq-tftp[5386]: sent /srv/tftp/zephyr.efi to 10.1.1.28

When the boot process completes, you have finished booting the Zephyr application image.

Note

Refer to the UP Squared Serial Console Wiki page for instructions on how to connect serial console.

Note

To enable PXE boot for Up Squared board do the following:

Enable network from BIOS settings.

Advanced -> Network Stack Configuration -> Enable Network Stack -> Enable Ipv4 PXE Support

Make network boot as the first boot option.
```
Boot -> Boot Option #1 : [Network]
```

UP Squared

Overview

Hardware

Supported Features

HSUART High-Speed Serial Port Support

GPIO

Connections and IOs

Programming and Debugging

Build Zephyr application

Booting the UP Squared Board using UEFI

Preparing the Boot Device

Booting Zephyr on a board

Booting the UP Squared Board over network

Prepare Linux host

Prepare the board for network boot

Booting the board

Build Zephyr application 

Booting the UP Squared Board using UEFI 

Booting the UP Squared Board over network 