aboutsummaryrefslogtreecommitdiff
path: root/board/solidrun/clearfog/readme.txt
blob: b56f0a9b49ed7b860843a54acb3fc4a253ed6452 (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
59
60
61
62
63
64
65
66
67
68
**********************
SolidRun Clearfog Base
**********************

This file documents Buildroot's support for the Clearfog Base by Solid Run.

Vendor's documentation:
https://wiki.solid-run.com/doku.php?id=products:a38x:documents

Warning for eMMC variant of the MicroSoM
========================================

If you bought a MicroSoM version that includes an on-board eMMC flash, the
built-in microSD card slot *WILL NOT WORK*. The Internet says that you have to
upload the first bootloader via UART. This manual does not cover these steps;
only MicroSoMs without the eMMC are supported.

Limitations
===========

There's no access to the SPI flash in this combination of kernel/uboot/dts.

There is no support for the SFP.

Build
=====

Start with the default Buildroot's configuration for Clearfog:

  make solidrun_clearfog_defconfig

Build all components:

  make

The results of the build are available in ./output/images.

Create a bootable SD card
=========================

To determine the device associated to the SD card have a look in the
/proc/partitions file:

  cat /proc/partitions

Buildroot prepares a bootable "sdcard.img" image in the output/images/
directory, ready to be dumped on a microSD card. Launch the following
command as root:

  dd if=./output/images/sdcard.img of=/dev/<your-microsd-device>

*** WARNING! The script will destroy all the card content. Use with care! ***

For details about the medium image layout, see the definition in
board/solidrun/clearfog/genimage.cfg.

Boot the Clearfog board
=======================

Here's how to boot the board:

- Set up the DIP switches for microSD boot. The correct values are:
  1: off, 2: off, 3: ON, 4: ON, 5: ON. In this scheme, switch #1" is closer to
  the ethernet ports and #5 is closer to the microSD card, "ON" means towards
  the SOM, and "off" means towards the SFP cage.
- Connect to the board's console over the microUSB port.
- Insert the SD card into the slot on the board (pins up).
- Power up the board.