board/solidrun/clearfog/README

   1 Update from original Marvell U-Boot to mainline U-Boot:
   2 -------------------------------------------------------
   3
   4 Generate the U-Boot image with these commands:
   5
   6 $ make clearfog_defconfig
   7 $ make
   8
   9 The resulting image including the SPL binary with the
  10 full DDR setup is "u-boot-spl.kwb".
  11
  12 Now all you need to do is copy this image on a SD card.
  13 For example with this command:
  14
  15 $ sudo dd if=u-boot-spl.kwb of=/dev/sdX bs=512 seek=1
  16
  17 Please use the correct device node for your setup instead
  18 of "/dev/sdX" here!
  19
  20 Install U-Boot on eMMC:
  21 -----------------------
  22
  23 The ROM loads the bootloader from eMMC first boot partition at offset 0. This
  24 is unlike load from SD card that is at offset 512. As a result, the offset of
  25 the main U-Boot image on the eMMC boot partition changes. Set
  26 CONFIG_SYS_MMCSD_RAW_MODE_U_BOOT_SECTOR to 0x140 for SPL to load U-Boot from
  27 the correct location.
  28
  29 To make SPL load the main U-Boot image from the eMMC boot partition enable
  30 eMMC boot acknowledgement and boot partition with the following U-Boot
  31 command:
  32
  33   mmc partconf 0 1 1 0
  34
  35 Install U-Boot on eMMC boot partition from Linux running on Clearfog:
  36
  37   echo 0 > /sys/block/mmcblk0boot0/force_ro
  38   dd if=u-boot-spl.kwb of=/dev/mmcblk0boot0
  39
  40 Note that the SD card is not accessible when the Clearfog SOM has eMMC.
  41 Consider initial boot from UART (see below).
  42
  43 Boot selection:
  44 ---------------
  45
  46 Before powering up the board, boot selection should be done via the SW1 dip
  47 switch (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
  59 Boot from UART:
  60 ---------------
  61
  62 Connect the on-board micro-USB (CF Pro: CON11, CF Base: CON5)
  63 to your host.
  64
  65 Set the SW1 DIP switches to UART boot (see above).
  66
  67 Run the following command to initiate U-Boot download:
  68
  69   ./tools/kwboot -b u-boot-spl.kwb /dev/ttyUSBX
  70
  71 Use the correct UART device node for /dev/ttyUSBX.
  72
  73 When download finishes start your favorite terminal emulator
  74 on /dev/ttyUSBX.