From patchwork Fri Dec 12 05:45:46 2014 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Hyungwon Hwang X-Patchwork-Id: 420369 X-Patchwork-Delegate: promsoft@gmail.com Return-Path: X-Original-To: incoming@patchwork.ozlabs.org Delivered-To: patchwork-incoming@bilbo.ozlabs.org Received: from theia.denx.de (theia.denx.de [85.214.87.163]) by ozlabs.org (Postfix) with ESMTP id 577FA1400A0 for ; Fri, 12 Dec 2014 16:46:33 +1100 (AEDT) Received: from localhost (localhost [127.0.0.1]) by theia.denx.de (Postfix) with ESMTP id 42AF64BA4F; Fri, 12 Dec 2014 06:46:24 +0100 (CET) Received: from theia.denx.de ([127.0.0.1]) by localhost (theia.denx.de [127.0.0.1]) (amavisd-new, port 10024) with ESMTP id HskoKFptnuLz; Fri, 12 Dec 2014 06:46:24 +0100 (CET) Received: from theia.denx.de (localhost [127.0.0.1]) by theia.denx.de (Postfix) with ESMTP id 7C16E4BA57; Fri, 12 Dec 2014 06:46:21 +0100 (CET) Received: from localhost (localhost [127.0.0.1]) by theia.denx.de (Postfix) with ESMTP id DD0724BA24 for ; Fri, 12 Dec 2014 06:46:05 +0100 (CET) Received: from theia.denx.de ([127.0.0.1]) by localhost (theia.denx.de [127.0.0.1]) (amavisd-new, port 10024) with ESMTP id SyAtZnlcyfob for ; Fri, 12 Dec 2014 06:46:05 +0100 (CET) X-policyd-weight: NOT_IN_SBL_XBL_SPAMHAUS=-1.5 NOT_IN_SPAMCOP=-1.5 NOT_IN_BL_NJABL=-1.5 (only DNSBL check requested) Received: from mailout2.samsung.com (mailout2.samsung.com [203.254.224.25]) by theia.denx.de (Postfix) with ESMTPS id 645734BA21 for ; Fri, 12 Dec 2014 06:46:04 +0100 (CET) Received: from epcpsbgr1.samsung.com (u141.gpu120.samsung.co.kr [203.254.230.141]) by mailout2.samsung.com (Oracle Communications Messaging Server 7u4-24.01 (7.0.4.24.0) 64bit (built Nov 17 2011)) with ESMTP id <0NGG0081KG0JOU80@mailout2.samsung.com> for u-boot@lists.denx.de; Fri, 12 Dec 2014 14:45:55 +0900 (KST) Received: from epcpsbgm2.samsung.com ( [172.20.52.112]) by epcpsbgr1.samsung.com (EPCPMTA) with SMTP id 1C.7F.17016.3118A845; Fri, 12 Dec 2014 14:45:55 +0900 (KST) X-AuditID: cbfee68d-f79296d000004278-e3-548a81132889 Received: from epmmp1.local.host ( [203.254.227.16]) by epcpsbgm2.samsung.com (EPCPMTA) with SMTP id CB.0A.09430.3118A845; Fri, 12 Dec 2014 14:45:55 +0900 (KST) Received: from localhost.localdomain ([10.88.98.185]) by mmp1.samsung.com (Oracle Communications Messaging Server 7u4-24.01 (7.0.4.24.0) 64bit (built Nov 17 2011)) with ESMTPA id <0NGG00C13G0G7MG0@mmp1.samsung.com>; Fri, 12 Dec 2014 14:45:55 +0900 (KST) From: Hyungwon Hwang To: u-boot@lists.denx.de Date: Fri, 12 Dec 2014 14:45:46 +0900 Message-id: <1418363146-11748-4-git-send-email-human.hwang@samsung.com> X-Mailer: git-send-email 1.9.1 In-reply-to: <1418363146-11748-1-git-send-email-human.hwang@samsung.com> References: <1418363146-11748-1-git-send-email-human.hwang@samsung.com> X-Brightmail-Tracker: H4sIAAAAAAAAA+NgFrrLLMWRmVeSWpSXmKPExsWyRsSkQFe4sSvE4NMyE4ulM/pYLa79nsFm 8ebhZkaLjiMtjBbftmxjtJh+/C2rxdu9newO7B6zGy6yePx9fh1IzG5l9jh7ZwejR9+WVYwB rFFcNimpOZllqUX6dglcGTs/nGMqOGNU8evjE+YGxs8aXYycHBICJhKndjxhhrDFJC7cW8/W xcjFISSwlFHi4Oe3jDBFUzp/skMkFjFKHJnTwwKSEBJoZZK48SIaxGYT0JNYcO0HO4gtIiAh 8av/KiNIA7PAEkaJORtes4IkhAV8JX7unA7WzCKgKjHz/xaw1bwC7hI35xyFOkNO4uSxyWD1 nAIeEgvPNLJCLHOXWH90G9gVEgLT2SWWHzzECjFIQOLb5ENAQzmAErISmw5AzZGUOLjiBssE RuEFjAyrGEVTC5ILipPSiwz1ihNzi0vz0vWS83M3MQJD/fS/Z707GG8fsD7EKMDBqMTD+yK1 K0SINbGsuDL3EKMp0IaJzFKiyfnAiMoriTc0NjOyMDUxNTYytzRTEudVlPoZLCSQnliSmp2a WpBaFF9UmpNafIiRiYNTqoFx3kV7j4O/ZUVfOJg7zWtRe6R/5VfE453tTxhOBAf4X4hW9Z/Q 8XqpbOXG9ivHr76qzlOY3xWbo/8w1k4p4azrvm1KWpcbV9r95MkpW9L3QU0rd1r5poZJft8K tzmcOOTrMunDnNVfz2+eunnHOd1fe16fOf39Xuj0/tO2p//beYXqHbBM49FbqMRSnJFoqMVc VJwIAJkfwPFwAgAA X-Brightmail-Tracker: H4sIAAAAAAAAA+NgFlrOIsWRmVeSWpSXmKPExsVy+t9jAV3hxq4Qg90XtC2Wzuhjtbj2ewab xZuHmxktOo60MFp827KN0WL68besFm/3drI7sHvMbrjI4vH3+XUgMbuV2ePsnR2MHn1bVjEG sEY1MNpkpCampBYppOYl56dk5qXbKnkHxzvHm5oZGOoaWlqYKynkJeam2iq5+AToumXmAB2i pFCWmFMKFApILC5W0rfDNCE0xE3XAqYxQtc3JAiux8gADSSsYczY+eEcU8EZo4pfH58wNzB+ 1uhi5OSQEDCRmNL5kx3CFpO4cG89WxcjF4eQwCJGiSNzelhAEkICrUwSN15Eg9hsAnoSC679 AGsQEZCQ+NV/lRGkgVlgCaPEnA2vWUESwgK+Ej93TgdrZhFQlZj5fwsziM0r4C5xc85RZoht chInj00Gq+cU8JBYeKaRFWKZu8T6o9vYJzDyLmBkWMUomlqQXFCclJ5rpFecmFtcmpeul5yf u4kRHEnPpHcwrmqwOMQowMGoxMP7IrUrRIg1say4MvcQowQHs5II798ooBBvSmJlVWpRfnxR aU5q8SFGU6CrJjJLiSbnA6M8ryTe0NjEzMjSyNzQwsjYXEmcV8m+LURIID2xJDU7NbUgtQim j4mDU6qBsSwr5tNdBRf1bYtsxPsk3FmFP+93nsryV5fdLmuh8XWzmK/TGYPOM82uyX784/zz VelTSvS6nkoevey95udRIVPdWQfn5sqfVuAp3Vaoavhde3FvUKWmpWweh05aaNuW5/uXt994 67BylW7dqq++cUyM34+WnvtjOPmbVMjMWOk5BtazW99eVGIpzkg01GIuKk4EAJgcEpq6AgAA DLP-Filter: Pass X-MTR: 20000000000000000@CPGS X-CFilter-Loop: Reflected Cc: Hyungwon Hwang Subject: [U-Boot] [RESEND][PATCH v11 3/3] Odroid-XU3: Add documentation for Odroid-XU3 X-BeenThere: u-boot@lists.denx.de X-Mailman-Version: 2.1.13 Precedence: list List-Id: U-Boot discussion List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , MIME-Version: 1.0 Sender: u-boot-bounces@lists.denx.de Errors-To: u-boot-bounces@lists.denx.de This patch adds documentation for Odroid-XU3. This documentation is based on that of Odroid (doc/README-odroid) made by Przemyslaw Marczak. The documentation includes basic information about boot media layout, environment, partition layout, and the instruction to burn the u-boot image to boot media. Signed-off-by: Hyungwon Hwang Acked-by: Simon Glass Tested-by: Kevin Hilman Cc: Minkyu Kang Cc: Lukasz Majewski Cc: Sjoerd Simons Cc: Javier Martinez Canillas Cc: Simon Glass --- Changes for v6: - Newly added Changes for v7: - Fix several errata in the documentation Changes for v8: - None Changes for v9: - Add the new contents to the documentation of Odroid X2/U2, instead of making new document for Odorid XU3 Changes for v10: - Fix a erratum Changes for v11: - Add a comment to specify not available networking yet doc/README.odroid | 46 ++++++++++++++++++++++++++++++---------------- 1 file changed, 30 insertions(+), 16 deletions(-) doc/README.odroid | 47 +++++++++++++++++++++++++++++++---------------- 1 file changed, 31 insertions(+), 16 deletions(-) diff --git a/doc/README.odroid b/doc/README.odroid index 25b962b..8a004ca 100644 --- a/doc/README.odroid +++ b/doc/README.odroid @@ -1,28 +1,39 @@ - U-boot for Odroid X2/U3 + U-boot for Odroid X2/U3/XU3 ======================== 1. Summary ========== -This is a quick instruction for setup Odroid boards based on Exynos4412. -Board config: odroid_config +This is a quick instruction for setup Odroid boards. +Board config: odroid_config for X2/U3 +Board config: odroid-xu3_config for XU3 2. Supported devices ==================== -This U-BOOT config can be used on two boards: +This U-BOOT config can be used on three boards: - Odroid U3 - Odroid X2 with CPU Exynos 4412 rev 2.0 and 2GB of RAM +- Odroid XU3 +with CPU Exynos5422 and 2GB of RAM 3. Boot sequence ================ iROM->BL1->(BL2 + TrustZone)->U-BOOT -This version of U-BOOT doesn't implement SPL but it is required(BL2) -and can be found in "boot.tar.gz" from here: +This version of U-BOOT doesn't implement SPL. So, BL1, BL2, and TrustZone +binaries are needed to boot up. + +<< X2/U3 >> +It can be found in "boot.tar.gz" from here: http://dev.odroid.com/projects/4412boot/wiki/FrontPage?action=download&value=boot.tar.gz or here: http://odroid.in/guides/ubuntu-lfs/boot.tar.gz +<< XU3 >> +It can be downloaded from: +https://github.com/hardkernel/u-boot/tree/odroidxu3-v2012.07/sd_fuse/hardkernel + + 4. Boot media layout ==================== The table below shows SD/eMMC cards layout for U-boot. @@ -35,18 +46,20 @@ The block offset is starting from 0 and the block size is 512B. | Bl2 | 31 | 30 | 1 (boot) | | U-boot | 63 | 62 | 1 (boot) | | Tzsw | 2111 | 2110 | 1 (boot) | -| Uboot Env | 2500 | 2500 | 0 (user) | +| Uboot Env | 2560 | 2560 | 0 (user) | ------------------------------------- 5. Prepare the SD boot card - with SD card reader ================================================= To prepare bootable media you need boot binaries provided by hardkernel. -File "boot.tar.gz" (link in point 3.) contains: -- E4412_S.bl1.HardKernel.bin -- E4412_S.tzsw.signed.bin -- bl2.signed.bin +From the downloaded files, You can find: +- bl1.bin +- tzsw.bin +- bl2.bin - sd_fusing.sh - u-boot.bin +(The file names can be slightly different, but you can distinguish what they are +without problem) This is all you need to boot this board. But if you want to use your custom u-boot then you need to change u-boot.bin with your own u-boot binary* @@ -56,7 +69,7 @@ and run the script "sd_fusing.sh" - this script is valid only for SD card. The proper binary file of current U-boot is u-boot-dtb.bin. quick steps for Linux: -- extract boot.tar.gz +- Download all files from the link at point 3 and extract it if needed. - put any SD card into the SD reader - check the device with "dmesg" - run ./sd_fusing.sh /dev/sdX - where X is SD card device (but not a partition) @@ -66,7 +79,7 @@ Check if Hardkernel U-boot is booting, and next do the same with your U-boot. with a eMMC card reader (boot from eMMC card slot) ===================================================== To boot the device from the eMMC slot you should use a special card reader -which supports eMMC partiion switch. All of the boot binaries are stored +which supports eMMC partition switch. All of the boot binaries are stored on the eMMC boot partition which is normally hidden. The "sd_fusing.sh" script can be used after updating offsets of binaries @@ -81,8 +94,8 @@ But then the device can boot only from the SD card slot. 8. Prepare the boot media using Hardkernel U-boot ================================================= -You can update the U-boot to the custom one if you have an working bootloader -delivered with the board on a eMMC/SD card. Then follow the steps: +You can update the U-boot to the custom one if you have a working bootloader +delivered with the board on the eMMC/SD card. Then follow the steps: - install the android fastboot tool - connect a micro usb cable to the board - on the U-boot prompt, run command: fastboot (as a root) @@ -91,7 +104,7 @@ delivered with the board on a eMMC/SD card. Then follow the steps: 9. Partition layout ==================== -Default U-boot environment is setup for fixed partiion layout. +Default U-boot environment is setup for fixed partition layout. Partition table: MSDOS. Disk layout and files as listed in the table below. ----- ------ ------ ------ -------- --------------------------------- @@ -106,6 +119,7 @@ Partition table: MSDOS. Disk layout and files as listed in the table below. Supported fdt files are: - exynos4412-odroidx2.dtb - exynos4412-odroidu3.dtb +- exynos5422-odroidxu3.dtb Supported kernel files are: - Image.itb @@ -144,6 +158,7 @@ And the boot sequence is: 11. USB host support ==================== +NOTE: This section is only for Odroid X2/U3. The ethernet can be accessed after starting the USB subsystem in U-Boot. The adapter does not come with a preconfigured MAC address, and hence it needs