Skip to content
Daniele Cleri edited this page Feb 7, 2022 · 2 revisions
Clone this wiki locally

Yocto support for UP family boards

Supported Yocto versions

  • Yocto 2.3 (Pyro) - deprecated
  • Yocto 2.5 (Sumo) - deprecated
  • Yocto 2.7 (Warrior) - deprecated
  • Yocto 3.1 LTS (Dunfell)

Supported hardware versions

  • UP Board (Dunfell)
  • UP Squared (Dunfell)
  • UP Core (Dunfell)
  • UP Core Plus (Dunfell)
  • UP Xtreme (Dunfell)
  • UP Squared Pro (Dunfell)
  • UP Xtreme i11 (Dunfell)
  • UP Squared 6000 (Dunfell)

Build Yocto 3.1 Dunfell for UP for UP family boards


  • a build server with at least 100GB of disk space, check the official Yocto Project Quick Build Documentation for more information
  • a supported board or gateways from the UP Series
  • a USB stick with at least 1Gb of space
  • Keyboard, mouse, a screen and an Internet connection

Build Procedure

Refer to the relevant GitHub project for further instructions.

Yocto Evaluation images for UP based systems and boards


  • Linux Kernel 5.4 LTS
  • Sato image includes basic GUI
  • Container support, includes docker, docker-compose

Yocto 3.1 Dunfell evaluation images - TBD

Booting the live USB image

This BSP creates bootable live images, which can be used to directly boot Yocto off of a USB flash drive. Upon completion of a successful build, described in the previous section, the images are created in a sub-folder named ./tmp/deploy/images/up-board/

Under Linux, insert a USB flash drive. Assuming the USB flash drive takes device /dev/sdb, use dd to copy the live image to it. For example:

 dd if=upboard-image-sato-up-board.hddimg of=/dev/sdb
 eject /dev/sdb

This should give you a bootable USB flash device. Insert the device into a bootable USB socket on the target, and power on. At the initial BIOS splash screen, press F7 to display a menu of boot options and select the USB device. This should result in a system booted to the Sato graphical desktop.

If you want a terminal, use the arrows at the top of the UI to move to different pages of available applications, one of which is named 'Terminal'. Clicking that should give you a root terminal.

If you want to ssh into the system, you can use the root terminal to ifconfig the IP address and use that to ssh in. The root password is empty, so to log in type 'root' for the user name and hit 'Enter' at the Password prompt: and you should be in.

If you find you're getting corrupt images on the USB (it doesn't show the syslinux boot: prompt, or the boot: prompt contains strange characters), try doing this first:

 dd if=/dev/zero of=/dev/sdb bs=1M count=512

Connectivity firmware

Ampak connectivity firmware is included to enable WiFi and Bluetooth for UP Core and UP Core Plus boards.

  • WiFi Scan your available WiFi networks:

iwlist wlan0 scan

You will see all the WiFi interfaces in your area.

  • Bluetooth Check your Bluetooth devices in your area:

For UP Core active the Ampak AP6214a service:

systemctl restart firmware-ampak-ap6214a.service

For UP Core Plus active the Ampak AP6355 service:

systemctl restart firmware-ampak-ap6355.service

Unblock your Bluetooth device and check your available devices:

 rfkill unblock bluetooth
 hciconfig hci0
 hcitool scan

Active iTCO Watchdog

You only need to write to the watchdog device and it will be active.

cat >> /dev/watchdog

After some seconds, the board should reboot as expected.