Merge branch 'u-boot-tegra/master' into 'u-boot-arm/master'

[karo-tx-uboot.git] / doc / README.sata

diff --git a/doc/README.sata b/doc/README.sata
index 3e2c6e83135bccb999ba61a2cdebf7cef109d868..d0ce6673b01a118278f5d013c9b1acbe1ac43916 100644 (file)
--- a/doc/README.sata
+++ b/doc/README.sata
@@ -1,24 +1,25 @@
 1. SATA usage in U-boot
 
-       Two ways to operate the hard disk
+       There are two ways to operate the hard disk
 
-       * Raw read/write block from/to SATA hard disk;
-       * ext2load read file from ext2 filesytem in hard disk
+       * Read/write raw blocks from/to SATA hard disk
+       * ext2load to read a file from ext2 file system
 
-1.0 How to know the information of SATA hard disk?
+1.0 How to read the SATA hard disk's information?
 
        => sata info
 
-SATA device 0: Model: ST3320620AS Firm: 3.AAD Ser#:             4QF01ZTN
-            Type: Hard Disk
-            Supports 48-bit addressing
-            Capacity: 305245.3 MB = 298.0 GB (625142448 x 512)
+SATA device 0: Model: ST3320620AS Firm: 3.AAD Ser#:            4QF01ZTN
+           Type: Hard Disk
+           Supports 48-bit addressing
+           Capacity: 305245.3 MB = 298.0 GB (625142448 x 512)
 
-1.1 How to save the kernel, filesystem, dtb to SATA hard disk with raw?
+1.1 How to raw write the kernel, file system, dtb to a SATA hard disk?
 
-       Notes: 0x1000 sectors = 2 MBytes
+       Notes: Hard disk sectors are normally 512 bytes, so
+               0x1000 sectors = 2 MBytes
 
-       wirte kernel
+       write kernel
        => tftp 40000 /tftpboot/uImage.837x
        => sata write 40000 0 2000
 
@@ -30,7 +31,7 @@ SATA device 0: Model: ST3320620AS Firm: 3.AAD Ser#:             4QF01ZTN
        => tftp 40000 /tftpboot/mpc837xemds.dtb
        => sata write 40000 a000 1000
 
-1.2 How to read the kernel, filesystem, dtb from SATA hard disk with raw?
+1.2 How to raw read the kernel, file system, dtb from a SATA hard disk?
 
        load kernel
        => sata read 200000 0 2000
@@ -44,20 +45,19 @@ SATA device 0: Model: ST3320620AS Firm: 3.AAD Ser#:             4QF01ZTN
        boot
        => bootm 200000 1000000 2000000
 
-1.3 How to load image from ext2 filesystem in U-boot?
+1.3 How to load an image from an ext2 file system in U-boot?
 
-       U-boot doesn't support ext2 write to hard disk, so
-       you have to write the image to hard disk under Linux env,
-        before you load image from ext2 filesystem.
+       U-boot doesn't support writing to an ext2 file system, so the
+       files must be written by other means (e.g. linux).
 
        => ext2ls sata 0:1 /
-       <DIR>       4096 .
-       <DIR>       4096 ..
-       <DIR>      16384 lost+found
-                1352023 uImage.837x
-                3646377 ramdisk.837x
-                  12288 mpc837xemds.dtb
-                     12 hello.txt
+       <DIR>       4096 .
+       <DIR>       4096 ..
+       <DIR>      16384 lost+found
+                1352023 uImage.837x
+                3646377 ramdisk.837x
+                  12288 mpc837xemds.dtb
+                     12 hello.txt
 
        => ext2load sata 0:1 200000 /uImage.837x