blob: bf40fa16ba2ce699e0cc0887c6212211955f1d70 [file] [log] [blame]
.. _up_squared:
UP Squared
##########
Overview
********
UP |sup2| (UP Squared) is an ultra compact single board computer with high
performance and low power consumption. It features the latest Intel |reg| Apollo
Lake Celeron |trade| and Pentium |trade| Processors with only 4W of Scenario Design Power and
a powerful and flexible Intel |reg| FPGA Altera MAX 10 onboard.
.. figure:: img/up_squared.jpg
:align: center
:alt: UP Squared
Up Squared (Credit: https://up-board.org)
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 |reg| Pentium |trade| SoC,
Intel |reg| Celeron |trade| SoC, or Intel |reg| Atom |trade| SoC.
Hardware
********
General information about the board can be found at the `UP Squared`_ website.
.. include:: ../../../../soc/x86/apollo_lake/doc/supported_features.txt
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.
.. contents::
:depth: 1
:local:
:backlinks: top
Build Zephyr application
========================
#. Build a Zephyr application; for instance, to build the ``hello_world``
application on UP Squared:
.. zephyr-app-commands::
:zephyr-app: samples/hello_world
:board: up_squared
:goals: build
.. note::
A Zephyr EFI image file named :file:`zephyr.efi` is automatically
created in the build directory after the application is built.
Booting the UP Squared Board using UEFI
=======================================
.. include:: ../../common/efi_boot.rst
:start-after: start_include_here
.. note::
Refer to the `UP Squared Serial Console Wiki page
<https://wiki.up-community.org/Serial_console>`_ for instructions on how to
connect serial console.
.. note::
You can safely ignore this message if it appears:
.. code-block:: console
WARNING: no console will be available to OS
Booting the UP Squared Board over network
=========================================
.. include:: ../../common/net_boot.rst
:start-after: start_include_here
.. note::
Refer to the `UP Squared Serial Console Wiki page
<https://wiki.up-community.org/Serial_console>`_ 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.
.. code-block:: console
Advanced -> Network Stack Configuration -> Enable Network Stack -> Enable Ipv4 PXE Support
#. Make network boot as the first boot option.
.. code-block:: console
Boot -> Boot Option #1 : [Network]
.. _UP Squared: https://www.up-board.org/upsquared/specifications
.. _UP Squared Pinout: https://wiki.up-community.org/Pinout