1U-Boot for UniPhier SoC family 2============================== 3 4 5Recommended toolchains 6---------------------- 7 8The UniPhir platform is well tested with Linaro toolchanis. 9You can download pre-built toolchains from: 10 11 http://www.linaro.org/downloads/ 12 13 14Compile the source 15------------------ 16 17sLD3 reference board: 18 $ make uniphier_sld3_defconfig 19 $ make CROSS_COMPILE=arm-linux-gnueabihf- 20 21LD4 reference board: 22 $ make uniphier_ld4_sld8_defconfig 23 $ make CROSS_COMPILE=arm-linux-gnueabihf- 24 25sLD8 reference board: 26 $ make uniphier_ld4_sld8_defconfig 27 $ make CROSS_COMPILE=arm-linux-gnueabihf- DEVICE_TREE=uniphier-sld8-ref 28 29Pro4 reference board: 30 $ make uniphier_pro4_defconfig 31 $ make CROSS_COMPILE=arm-linux-gnueabihf- 32 33Pro4 Ace board: 34 $ make uniphier_pro4_defconfig 35 $ make CROSS_COMPILE=arm-linux-gnueabihf- DEVICE_TREE=uniphier-pro4-ace 36 37Pro4 Sanji board: 38 $ make uniphier_pro4_defconfig 39 $ make CROSS_COMPILE=arm-linux-gnueabihf- DEVICE_TREE=uniphier-pro4-sanji 40 41Pro5 4KBOX Board: 42 $ make uniphier_pxs2_ld6b_defconfig 43 $ make CROSS_COMPILE=arm-linux-gnueabihf- DEVICE_TREE=uniphier-pro5-4kbox 44 45PXs2 Gentil board: 46 $ make uniphier_pxs2_ld6b_defconfig 47 $ make CROSS_COMPILE=arm-linux-gnueabihf- DEVICE_TREE=uniphier-pxs2-gentil 48 49PXs2 Vodka board: 50 $ make uniphier_pxs2_ld6b_defconfig 51 $ make CROSS_COMPILE=arm-linux-gnueabihf- 52 53LD6b reference board: 54 $ make uniphier_pxs2_ld6b_defconfig 55 $ make CROSS_COMPILE=arm-linux-gnueabihf- DEVICE_TREE=uniphier-ld6b-ref 56 57LD11 reference board: 58 $ make uniphier_ld11_defconfig 59 $ make CROSS_COMPILE=aarch64-linux-gnu- 60 61LD20 reference board: 62 $ make uniphier_ld20_defconfig 63 $ make CROSS_COMPILE=aarch64-linux-gnu- 64 65You may wish to change the "CROSS_COMPILE=..." to use your favorite compiler. 66 67 68Burn U-Boot images to NAND 69-------------------------- 70 71Write the following to the NAND device: 72 73 - spl/u-boot-spl.bin at the offset address 0x00000000 74 - u-boot.bin at the offset address 0x00010000 75 76or 77 78 - u-boot-with-spl.bin at the offset address 0x00000000 79 80If a TFTP server is available, the images can be easily updated. 81Just copy the u-boot-spl.bin and u-boot.bin to the TFTP public directory, 82and then run the following command at the U-Boot command line: 83 84 => run nandupdate 85 86 87Burn U-Boot images to eMMC 88-------------------------- 89 90Write the following to the Boot partition 1 of the eMMC device: 91 92 - spl/u-boot-spl.bin at the offset address 0x00000000 93 - u-boot.bin at the offset address 0x00010000 94 95or 96 97 - u-boot-with-spl.bin at the offset address 0x00000000 98 99If a TFTP server is available, the images can be easily updated. 100Just copy the u-boot-spl.bin and u-boot.bin to the TFTP public directory, 101and then run the following command at the U-Boot command line: 102 103 => run emmcupdate 104 105 106UniPhier specific commands 107-------------------------- 108 109 - pinmon (enabled by CONFIG_CMD_PINMON) 110 shows the boot mode pins that has been latched at the power-on reset 111 112 - ddrphy (enabled by CONFIG_CMD_DDRPHY_DUMP) 113 shows the DDR PHY parameters set by the PHY training 114 115 - ddrmphy (enabled by CONFIG_CMD_DDRMPHY_DUMP) 116 shows the DDR Multi PHY parameters set by the PHY training 117 118 119Supported devices 120----------------- 121 122 - UART (on-chip) 123 - NAND 124 - SD/eMMC 125 - USB 2.0 (EHCI) 126 - USB 3.0 (xHCI) 127 - GPIO 128 - LAN (on-board SMSC9118) 129 - I2C 130 - EEPROM (connected to the on-board I2C bus) 131 - Support card (SRAM, NOR flash, some peripherals) 132 133 134Micro Support Card 135------------------ 136 137The recommended bit switch settings are as follows: 138 139 SW2 OFF(1)/ON(0) Description 140 ------------------------------------------ 141 bit 1 <---- BKSZ[0] 142 bit 2 ----> BKSZ[1] 143 bit 3 <---- SoC Bus Width 16/32 144 bit 4 <---- SERIAL_SEL[0] 145 bit 5 ----> SERIAL_SEL[1] 146 bit 6 ----> BOOTSWAP_EN 147 bit 7 <---- CS1/CS5 148 bit 8 <---- SOC_SERIAL_DISABLE 149 150 SW8 OFF(1)/ON(0) Description 151 ------------------------------------------ 152 bit 1 <---- CS1_SPLIT 153 bit 2 <---- CASE9_ON 154 bit 3 <---- CASE10_ON 155 bit 4 Don't Care Reserve 156 bit 5 Don't Care Reserve 157 bit 6 Don't Care Reserve 158 bit 7 ----> BURST_EN 159 bit 8 ----> FLASHBUS32_16 160 161The BKSZ[1:0] specifies the address range of memory slot and peripherals 162as follows: 163 164 BKSZ Description RAM slot Peripherals 165 -------------------------------------------------------------------- 166 0b00 15MB RAM / 1MB Peri 00000000-00efffff 00f00000-00ffffff 167 0b01 31MB RAM / 1MB Peri 00000000-01efffff 01f00000-01ffffff 168 0b10 64MB RAM / 1MB Peri 00000000-03efffff 03f00000-03ffffff 169 0b11 127MB RAM / 1MB Peri 00000000-07efffff 07f00000-07ffffff 170 171Set BSKZ[1:0] to 0b01 for U-Boot. 172This mode is the most handy because EA[24] is always supported by the save pin 173mode of the system bus. On the other hand, EA[25] is not supported for some 174newer SoCs. Even if it is, EA[25] is not connected on most of the boards. 175 176-- 177Masahiro Yamada <yamada.masahiro@socionext.com> 178Oct. 2016 179