summaryrefslogtreecommitdiffstats
path: root/Documentation/boards/am335x.rst
blob: 6972020179fe8c305d36107aa496c9e9c9a045c8 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
Texas Instruments AM335x
========================

The Texas Instruments AM335x SoCs have a two-stage boot process. The first stage
loader, also known as MLO is loaded by the ROM code. The MLO loads the second stage
loader from the same medium.

Building barebox
----------------

The TI AM335x boards in barebox are covered by the ``am335x_mlo_defconfig``
for the MLO and ``am335x_defconfig`` for the regular barebox image. The
resulting images will be placed under ``images/``:

::

  barebox-am33xx-afi-gf.img
  barebox-am33xx-afi-gf-mlo.img
  barebox-am33xx-beaglebone.img
  barebox-am33xx-beaglebone-mlo.img
  barebox-am33xx-phytec-phycore-mlo-256mb.img
  barebox-am33xx-phytec-phycore-mlo-128mb.img
  barebox-am33xx-phytec-phycore-mlo-512mb.img
  barebox-am33xx-phytec-phycore-mlo-2x512mb.img
  barebox-am33xx-phytec-phyflex-mlo-256mb.img
  barebox-am33xx-phytec-phyflex-mlo-512mb.img
  barebox-am33xx-phytec-phycore.img
  barebox-am33xx-phytec-phycore-no-spi.img
  barebox-am33xx-phytec-phyflex.img

Some boards come in different variants, make sure to pick the correct one.

Starting and updating barebox
-----------------------------

SPI NOR and NAND
^^^^^^^^^^^^^^^^

The regular board images can be started from another bootloader, see
:ref:`second_stage`. The board should provide update handlers
to update (or initially install) barebox on SPI NOR or NAND, see :ref:`update`.

SD/MMC
^^^^^^

To start barebox from SD/MMC prepare a card with a FAT filesystem. Copy the MLO
file for your board to the card and name it ``MLO``. Copy the regular image
for your board to the card and name it ``barebox.bin``.

AM335x Boards
-------------

.. toctree::
  :glob:
  :numbered:
  :maxdepth: 1

  am335x/*