xref: /OK3568_Linux_fs/buildroot/board/solidrun/clearfog/readme.txt (revision 4882a59341e53eb6f0b4789bf948001014eff981)
1*4882a593Smuzhiyun**********************
2*4882a593SmuzhiyunSolidRun Clearfog Base
3*4882a593Smuzhiyun**********************
4*4882a593Smuzhiyun
5*4882a593SmuzhiyunThis file documents Buildroot's support for the Clearfog Base by Solid Run.
6*4882a593Smuzhiyun
7*4882a593SmuzhiyunVendor's documentation:
8*4882a593Smuzhiyunhttps://wiki.solid-run.com/doku.php?id=products:a38x:documents
9*4882a593Smuzhiyun
10*4882a593SmuzhiyunWarning for eMMC variant of the MicroSoM
11*4882a593Smuzhiyun========================================
12*4882a593Smuzhiyun
13*4882a593SmuzhiyunIf you bought a MicroSoM version that includes an on-board eMMC flash, the
14*4882a593Smuzhiyunbuilt-in microSD card slot *WILL NOT WORK*. The Internet says that you have to
15*4882a593Smuzhiyunupload the first bootloader via UART. This manual does not cover these steps;
16*4882a593Smuzhiyunonly MicroSoMs without the eMMC are supported.
17*4882a593Smuzhiyun
18*4882a593SmuzhiyunBuild
19*4882a593Smuzhiyun=====
20*4882a593Smuzhiyun
21*4882a593SmuzhiyunStart with the default Buildroot's configuration for Clearfog:
22*4882a593Smuzhiyun
23*4882a593Smuzhiyun  make solidrun_clearfog_defconfig
24*4882a593Smuzhiyun
25*4882a593SmuzhiyunBuild all components:
26*4882a593Smuzhiyun
27*4882a593Smuzhiyun  make
28*4882a593Smuzhiyun
29*4882a593SmuzhiyunThe results of the build are available in ./output/images.
30*4882a593Smuzhiyun
31*4882a593SmuzhiyunCreate a bootable SD card
32*4882a593Smuzhiyun=========================
33*4882a593Smuzhiyun
34*4882a593SmuzhiyunTo determine the device associated to the SD card have a look in the
35*4882a593Smuzhiyun/proc/partitions file:
36*4882a593Smuzhiyun
37*4882a593Smuzhiyun  cat /proc/partitions
38*4882a593Smuzhiyun
39*4882a593SmuzhiyunBuildroot prepares a bootable "sdcard.img" image in the output/images/
40*4882a593Smuzhiyundirectory, ready to be dumped on a microSD card. Launch the following
41*4882a593Smuzhiyuncommand as root:
42*4882a593Smuzhiyun
43*4882a593Smuzhiyun  dd if=output/images/sdcard.img of=/dev/<your-microsd-device> conv=fdatasync
44*4882a593Smuzhiyun
45*4882a593Smuzhiyun*** WARNING! The dd command will destroy all the card content. Use with care! ***
46*4882a593Smuzhiyun
47*4882a593SmuzhiyunFor details about the medium image layout, see the definition in
48*4882a593Smuzhiyunboard/solidrun/clearfog/genimage.cfg.
49*4882a593Smuzhiyun
50*4882a593SmuzhiyunBoot the Clearfog board
51*4882a593Smuzhiyun=======================
52*4882a593Smuzhiyun
53*4882a593SmuzhiyunHere's how to boot the board:
54*4882a593Smuzhiyun
55*4882a593Smuzhiyun- Set up the DIP switches for microSD boot. The correct values are:
56*4882a593Smuzhiyun  1: off, 2: off, 3: ON, 4: ON, 5: ON. In this scheme, switch #1" is closer to
57*4882a593Smuzhiyun  the ethernet ports and #5 is closer to the microSD card, "ON" means towards
58*4882a593Smuzhiyun  the SOM, and "off" means towards the SFP cage.
59*4882a593Smuzhiyun- Connect to the board's console over the microUSB port.
60*4882a593Smuzhiyun- Insert the SD card into the slot on the board (pins up).
61*4882a593Smuzhiyun- Power up the board.
62