X-Git-Url: http://git.ipfire.org/?a=blobdiff_plain;f=doc%2FREADME.uniphier;h=f79659c9cabdef273609b2f1afa95a541559cc09;hb=6f1f3f59ed8fa49d9020d52a5952afa170c084a6;hp=6ba0320f4f48776f395da6058903ff025426a9d2;hpb=7bb839d672ed3b28c7740429df4a307482868c5b;p=people%2Fms%2Fu-boot.git diff --git a/doc/README.uniphier b/doc/README.uniphier index 6ba0320f4f..f79659c9ca 100644 --- a/doc/README.uniphier +++ b/doc/README.uniphier @@ -2,78 +2,111 @@ U-Boot for UniPhier SoC family ============================== -Tested toolchains ------------------ +Recommended toolchains +---------------------- - (a) Ubuntu packages (CROSS_COMPILE=arm-linux-gnueabi-) +The UniPhir platform is well tested with Linaro toolchanis. +You can download pre-built toolchains from: - If you are building U-Boot on Ubuntu, its standard package is recommended. - You can install it as follows: + http://www.linaro.org/downloads/ - $ sudo apt-get install gcc-arm-linux-gnueabi- - (b) Linaro compilers (CROSS_COMPILE=arm-linux-gnueabihf-) +Compile the source +------------------ - You can download pre-built toolchains from: +sLD3 reference board: + $ make uniphier_sld3_defconfig + $ make CROSS_COMPILE=arm-linux-gnueabihf- - http://www.linaro.org/downloads/ +LD4 reference board: + $ make uniphier_ld4_sld8_defconfig + $ make CROSS_COMPILE=arm-linux-gnueabihf- - (c) kernel.org compilers (CROSS_COMPILE=arm-unknown-linux-gnueabi-) +sLD8 reference board: + $ make uniphier_ld4_sld8_defconfig + $ make CROSS_COMPILE=arm-linux-gnueabihf- DEVICE_TREE=uniphier-sld8-ref - You can download pre-built toolchains from: +Pro4 reference board: + $ make uniphier_pro4_defconfig + $ make CROSS_COMPILE=arm-linux-gnueabihf- - ftp://www.kernel.org/pub/tools/crosstool/files/bin/ +Pro4 Ace board: + $ make uniphier_pro4_defconfig + $ make CROSS_COMPILE=arm-linux-gnueabihf- DEVICE_TREE=uniphier-pro4-ace +Pro4 Sanji board: + $ make uniphier_pro4_defconfig + $ make CROSS_COMPILE=arm-linux-gnueabihf- DEVICE_TREE=uniphier-pro4-sanji -Compile the source ------------------- - -PH1-sLD3: - $ make ph1_sld3_defconfig - $ make CROSS_COMPILE=arm-linux-gnueabi- +Pro5 4KBOX Board: + $ make uniphier_pxs2_ld6b_defconfig + $ make CROSS_COMPILE=arm-linux-gnueabihf- DEVICE_TREE=uniphier-pro5-4kbox -PH1-LD4: - $ make ph1_ld4_defconfig - $ make CROSS_COMPILE=arm-linux-gnueabi- +PXs2 Gentil board: + $ make uniphier_pxs2_ld6b_defconfig + $ make CROSS_COMPILE=arm-linux-gnueabihf- DEVICE_TREE=uniphier-pxs2-gentil -PH1-Pro4: - $ make ph1_pro4_defconfig - $ make CROSS_COMPILE=arm-linux-gnueabi- +PXs2 Vodka board: + $ make uniphier_pxs2_ld6b_defconfig + $ make CROSS_COMPILE=arm-linux-gnueabihf- -PH1-sLD8: - $ make ph1_sld8_defconfig - $ make CROSS_COMPILE=arm-linux-gnueabi- +LD6b reference board: + $ make uniphier_pxs2_ld6b_defconfig + $ make CROSS_COMPILE=arm-linux-gnueabihf- DEVICE_TREE=uniphier-ld6b-ref -PH1-Pro5: - $ make ph1_pro5_defconfig - $ make CROSS_COMPILE=arm-linux-gnueabi- +LD11 reference board: + $ make uniphier_ld11_defconfig + $ make CROSS_COMPILE=aarch64-linux-gnu- -ProXstream2: - $ make pxs2_defconfig - $ make CROSS_COMPILE=arm-linux-gnueabi- +LD20 reference board: + $ make uniphier_ld20_defconfig + $ make CROSS_COMPILE=aarch64-linux-gnu- -PH1-LD6b: - $ make ph1_ld6b_defconfig - $ make CROSS_COMPILE=arm-linux-gnueabi- +PXs3 reference board: + $ make uniphier_v8_defconfig + $ make CROSS_COMPILE=aarch64-linux-gnu- DEVICE_TREE=uniphier-pxs3-ref -You may wish to change the "CROSS_COMPILE=arm-linux-gnueabi-" -to use your favorite compiler. +You may wish to change the "CROSS_COMPILE=..." to use your favorite compiler. Burn U-Boot images to NAND -------------------------- -Write two files to the NAND device as follows: - - spl/u-boot-spl-dtb.bin at the offset address 0x00000000 - - u-boot-dtb.img at the offset address 0x00010000 +Write the following to the NAND device: + + - spl/u-boot-spl.bin at the offset address 0x00000000 + - u-boot.bin at the offset address 0x00020000 + +or + + - u-boot-with-spl.bin at the offset address 0x00000000 If a TFTP server is available, the images can be easily updated. -Just copy the u-boot-spl-dtb.bin and u-boot-dtb.img to the TFTP public -directory, and then run the following command at the U-Boot command line: +Just copy the u-boot-spl.bin and u-boot.bin to the TFTP public directory, +and then run the following command at the U-Boot command line: => run nandupdate +Burn U-Boot images to eMMC +-------------------------- + +Write the following to the Boot partition 1 of the eMMC device: + + - spl/u-boot-spl.bin at the offset address 0x00000000 + - u-boot.bin at the offset address 0x00020000 + +or + + - u-boot-with-spl.bin at the offset address 0x00000000 + +If a TFTP server is available, the images can be easily updated. +Just copy the u-boot-spl.bin and u-boot.bin to the TFTP public directory, +and then run the following command at the U-Boot command line: + + => run emmcupdate + + UniPhier specific commands -------------------------- @@ -83,14 +116,19 @@ UniPhier specific commands - ddrphy (enabled by CONFIG_CMD_DDRPHY_DUMP) shows the DDR PHY parameters set by the PHY training + - ddrmphy (enabled by CONFIG_CMD_DDRMPHY_DUMP) + shows the DDR Multi PHY parameters set by the PHY training + Supported devices ----------------- - UART (on-chip) - NAND + - SD/eMMC - USB 2.0 (EHCI) - USB 3.0 (xHCI) + - GPIO - LAN (on-board SMSC9118) - I2C - EEPROM (connected to the on-board I2C bus) @@ -115,7 +153,7 @@ The recommended bit switch settings are as follows: SW8 OFF(1)/ON(0) Description ------------------------------------------ - bit 1 ----> CS1_SPLIT + bit 1 <---- CS1_SPLIT bit 2 <---- CASE9_ON bit 3 <---- CASE10_ON bit 4 Don't Care Reserve @@ -129,10 +167,10 @@ as follows: BKSZ Description RAM slot Peripherals -------------------------------------------------------------------- - 0b00 15MB RAM / 1MB Peri 00000000-0effffff 0f000000-0fffffff - 0b01 31MB RAM / 1MB Peri 00000000-1effffff 1f000000-1fffffff - 0b10 64MB RAM / 1MB Peri 00000000-3effffff 3f000000-3fffffff - 0b11 127MB RAM / 1MB Peri 00000000-7effffff 7f000000-7fffffff + 0b00 15MB RAM / 1MB Peri 00000000-00efffff 00f00000-00ffffff + 0b01 31MB RAM / 1MB Peri 00000000-01efffff 01f00000-01ffffff + 0b10 64MB RAM / 1MB Peri 00000000-03efffff 03f00000-03ffffff + 0b11 127MB RAM / 1MB Peri 00000000-07efffff 07f00000-07ffffff Set BSKZ[1:0] to 0b01 for U-Boot. This mode is the most handy because EA[24] is always supported by the save pin @@ -141,4 +179,4 @@ newer SoCs. Even if it is, EA[25] is not connected on most of the boards. -- Masahiro Yamada -Aug. 2015 +Jan. 2017