u-boot/doc/README.uniphier

1 U-Boot for UniPhier SoC family
6 ----------------------
8 The UniPhier platform is well tested with Linaro toolchains.
9 You can download pre-built toolchains from:
15 ------------------
20     $ make CROSS_COMPILE=<toolchain-prefix> DEVICE_TREE=<device-tree>
22 The recommended <toolchain-prefix> is `arm-linux-gnueabihf-` for 32bit SoCs,
23 `aarch64-linux-gnu-` for 64bit SoCs, but you may wish to change it to use your
26 The following tables show <defconfig> and <device-tree> for each board.
30  Board         | <defconfig>                  | <device-tree>
31 ---------------|------------------------------|------------------------------
32 LD4 reference  | uniphier_ld4_sld8_defconfig  | uniphier-ld4-ref (default)
33 sld8 reference | uniphier_ld4_sld8_defconfig  | uniphier-sld8-def
34 Pro4 reference | uniphier_pro4_defconfig      | uniphier-pro4-ref (default)
35 Pro4 Ace       | uniphier_pro4_defconfig      | uniphier-pro4-ace
36 Pro4 Sanji     | uniphier_pro4_defconfig      | uniphier-pro4-sanji
37 Pro5 4KBOX     | uniphier_pxs2_ld6b_defconfig | uniphier-pro5-4kbox
38 PXs2 Gentil    | uniphier_pxs2_ld6b_defconfig | uniphier-pxs2-gentil
39 PXs2 Vodka     | uniphier_pxs2_ld6b_defconfig | uniphier-pxs2-vodka (default)
40 LD6b reference | uniphier_pxs2_ld6b_defconfig | uniphier-ld6b-ref
44  Board         | <defconfig>           | <device-tree>
45 ---------------|-----------------------|----------------------------
46 LD11 reference | uniphier_v8_defconfig | uniphier-ld11-ref
47 LD11 Global    | uniphier_v8_defconfig | uniphier-ld11-global
48 LD20 reference | uniphier_v8_defconfig | uniphier-ld20-ref (default)
49 LD20 Global    | uniphier_v8_defconfig | uniphier-ld20-global
54     $ make CROSS_COMPILE=arm-linux-gnueabihf- DEVICE_TREE=uniphier-pxs2-vodka
56 The device tree marked as (default) can be omitted.  `uniphier-pxs2-vodka` is
61     $ make CROSS_COMPILE=arm-linux-gnueabihf-
65 ------------------------
68 - u-boot.bin
69 - spl/u-boot.bin
71 U-Boot can boot UniPhier 32bit SoC boards by itself.  Flash the generated images
74  - spl/u-boot-spl.bin at the offset address 0x00000000
75  - u-boot.bin         at the offset address 0x00020000
77 The `u-boot-with-spl.bin` is the concatenation of the two (with appropriate
80  - u-boot-with-spl.bin at the offset address 0x00000000
83 Just copy the u-boot-spl.bin and u-boot.bin to the TFTP public directory,
84 and run the following command at the U-Boot command line:
96 ------------------------
99 - u-boot.bin
101 However, U-Boot is not the first stage loader for UniPhier 64bit SoC boards.
102 U-Boot serves as a non-secure boot loader loaded by [ARM Trusted Firmware],
103 so you need to provide the `u-boot.bin` to the build command of ARM Trusted
106 [ARM Trusted Firmware]: https://github.com/ARM-software/arm-trusted-firmware
109 UniPhier specific commands
110 --------------------------
112  - pinmon (enabled by CONFIG_CMD_PINMON)
113      shows the boot mode pins that has been latched at the power-on reset
115  - ddrphy (enabled by CONFIG_CMD_DDRPHY_DUMP)
118  - ddrmphy (enabled by CONFIG_CMD_DDRMPHY_DUMP)
123 -----------------
125  - UART (on-chip)
126  - NAND
127  - SD/eMMC
128  - USB 2.0 (EHCI)
129  - USB 3.0 (xHCI)
130  - GPIO
131  - LAN (on-board SMSC9118)
132  - I2C
133  - EEPROM (connected to the on-board I2C bus)
134  - Support card (SRAM, NOR flash, some peripherals)
138 ------------------
143  ------------------------------------------
144  bit 1   <----         BKSZ[0]
145  bit 2   ---->         BKSZ[1]
146  bit 3   <----         SoC Bus Width 16/32
147  bit 4   <----         SERIAL_SEL[0]
148  bit 5   ---->         SERIAL_SEL[1]
149  bit 6   ---->         BOOTSWAP_EN
150  bit 7   <----         CS1/CS5
151  bit 8   <----         SOC_SERIAL_DISABLE
154  ------------------------------------------
155  bit 1    <----        CS1_SPLIT
156  bit 2    <----        CASE9_ON
157  bit 3    <----        CASE10_ON
161  bit 7    ---->        BURST_EN
162  bit 8    ---->        FLASHBUS32_16
168  --------------------------------------------------------------------
169  0b00   15MB RAM / 1MB Peri    00000000-00efffff    00f00000-00ffffff
170  0b01   31MB RAM / 1MB Peri    00000000-01efffff    01f00000-01ffffff
171  0b10   64MB RAM / 1MB Peri    00000000-03efffff    03f00000-03ffffff
172  0b11  127MB RAM / 1MB Peri    00000000-07efffff    07f00000-07ffffff
174 Set BSKZ[1:0] to 0b01 for U-Boot.
179 --