README
1Update from original Marvell U-Boot to mainline U-Boot:
2-------------------------------------------------------
3
4Generate the U-Boot image with these commands:
5
6$ make clearfog_defconfig
7$ make
8
9The resulting image including the SPL binary with the
10full DDR setup is "u-boot-spl.kwb".
11
12Now all you need to do is copy this image on a SD card.
13For example with this command:
14
15$ sudo dd if=u-boot-spl.kwb of=/dev/sdX bs=512 seek=1
16
17Please use the correct device node for your setup instead
18of "/dev/sdX" here!
19
20Install U-Boot on eMMC:
21-----------------------
22
23To make SPL load the main U-Boot image from the eMMC boot partition enable
24eMMC boot acknowledgement and boot partition with the following U-Boot
25command:
26
27 mmc partconf 0 1 1 0
28
29Install U-Boot on eMMC boot partition from Linux running on Clearfog:
30
31 echo 0 > /sys/block/mmcblk0boot0/force_ro
32 dd if=u-boot-spl.kwb of=/dev/mmcblk0boot0
33
34Note that the SD card is not accessible when the Clearfog SOM has eMMC.
35Consider initial boot from UART (see below).
36
37Install U-Boot on SATA:
38-----------------------
39
40When loading the main U-Boot image from raw SATA sector, set
41CONFIG_SPL_SATA_RAW_U_BOOT_SECTOR to 0x141.
42
43Boot selection:
44---------------
45
46Before powering up the board, boot selection should be done via the SW1 dip
47switch (0: OFF, 1: ON):
48
49 - SPI: 00010
50 - SD/eMMC: 00111
51 - M.2 SSD: 11100
52 - UART: 01001 [1]
53
54[1]: According to SolidRun's manual, 11110 should be used for UART booting on
55 the ClearFog 'Pro' variant.
56 However, this doesn't work (anymore) at least on Rev. 2.1 (but '01001' as
57 mentionend for the 'Base' variant does).
58
59Boot from UART:
60---------------
61
62Connect the on-board micro-USB (CF Pro: CON11, CF Base: CON5)
63to your host.
64
65Set the SW1 DIP switches to UART boot (see above).
66
67Run the following command to initiate U-Boot download:
68
69 ./tools/kwboot -b u-boot-spl.kwb /dev/ttyUSBX
70
71Use the correct UART device node for /dev/ttyUSBX.
72
73When download finishes start your favorite terminal emulator
74on /dev/ttyUSBX.
75