..  _beaglebone:

**********
BeagleBone
**********

.. important::

    The BeagleBone target uses an old TI AM3358 ARM 32 BIT CPU. This processor
    of the AM335x family is used in a lot of current and legacy device at 
    Hirschmann and NetModule. Thus we only support this target to ensure
    that our architecture is working on older architecture too.

CoreOS build instruction
========================

.. code-block:: 

   MACHINE=beaglebone bitbake coreos-image-all-features
   cd tmp/deploy/images/beaglebone

.. list-table:: Image artifacts for BeagleBone
   :widths: 25 75
   :header-rows: 1

   * - Filename
     - Description
   * - <IMAGE>-beaglebone.swu
     - System image bundle used by the CoreOS installer or the CoreOS updater
   * - <IMAGE>-beaglebone.wic.xz
     - System image for SDCard
   * - coreos-image-installer-beaglebone.wic.xz
     - CoreOS installer image for SD Card

.. hint:: 

   Only the .swu image is need if you have already a working installation of CoreOS
   running on the board that you want to update.

CoreOS Pre-installation guide
=============================

If you want to use the internal emmc storage as boot target, you will need to
flash coreos-image-installer-beaglebone.wic.xz to your SDCard using bmaptool.

If you want to use the sdcard as boot target, you will need to flash
<IMAGE>-beaglebone.wic.xz to your SDCard using bmaptool.

By default the board boot on the internal emmc storage. To boot with a SDCard
instead, you will need to push the S2 button (boot switch) while powering up the
board.

.. image:: beaglebone/beaglebone-s2-switch.png

Serial access is available on the 5-pin header. See
`this page <https://elinux.org/Beagleboard:BeagleBone_Black_Serial>`_ for
more info on the serial connector.

Now that you have the installer running, CoreOS can be installed by following
the :ref:`generic installation manual<Installation Manual>` using the SDCard
mehtod.
