126 lines
3.5 KiB
ReStructuredText
126 lines
3.5 KiB
ReStructuredText
.. _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/intel/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:: ../../../intel/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:: ../../../intel/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
|