Diffstat (limited to 'Documentation')
2 files changed, 41 insertions, 67 deletions
diff --git a/Documentation/boards/imx.rst b/Documentation/boards/imx.rst
index 56fd3ab..99ca10b 100644
@@ -118,33 +118,6 @@ Some notes about the mentioned *conditions*.
- ``until_any_bit_clear`` waits until ``(*addr & mask) != mask`` is true
- ``until_any_bit_set`` waits until ``(*addr & mask) != 0`` is true.
-Internal Boot Mode Through Internal RAM(IRAM)
-The Internal Boot Mode Through Internal RAM is supported on:
-As can be easily deduced from its name, the Internal Boot Mode Through
-Internal RAM is just a variant of Internal Boot Mode so all of the
-stated above still applies in this case. What it differs in is the following:
-* Boot process is done in two stages(First stage binary can be
- produced with ``imx_v7-xload_defconfig``)
-* DCD of the first stage image is set such that the image is fetched
- into an unoccupied area or IRAM
-* First stage image once uncompressed and set up will look for a
- second stage bootloader on the same media it booted from and start
- it(see mach-imx/xload.c for more details)
-* Second stage images are just regular i.MX boot images
-Since on a typical i.MX SoC unused IRAM area is not enough to run
-anything but a PBL this mode, due to its very limited usability,
-serves only one purpose -- allow for a portion of a bootloader to be
-executed without depending on DRAM to be functional. This peculiarity
-of the mode can be used to implement various memory testing
diff --git a/Documentation/boards/imx/amazon-kindle-4-5.rst b/Documentation/boards/imx/amazon-kindle-4-5.rst
index bc6bf26..58f38a0 100644
@@ -1,7 +1,8 @@
-Amazon Kindle 4/5 Model No. D01100, D01200 and EY21
+Amazon Kindle 4/5 (Wi-Fi/No-Touch, Touch and Paperwhite)
-The Kindle Model No. D01100 (Kindle Wi-Fi), D01200 (Kindle Touch)
+The Kindle Models No. D01100 (Kindle Wi-Fi, also known as No-Touch or K4NT),
+D01200 (Kindle Touch)
and EY21 (Paperwhite) are refered as the Kindle 4th and 5th generation.
Those e-book readers share a common set of hardware:
@@ -15,55 +16,55 @@ while the newer EY21 uses 256MiB of LPDDR2.
The devices boot up in internal boot mode from an eMMC boot partition and
are shipped with a vendor modified u-boot imximage based on u-boot v2009.08.
-To upload and run a new bootloader the older devices can be put into
-USB-downloader mode by the SOC microcode when a specific key is pressed during
+This device is battery-powered and there is no way to switch the device off.
+When the device is inactive, the Kindle software will first reduce the
+power consumption to a few milliamps of battery power, after some minutes
+the power consumption is further reduced to about 550 microamps. Switching
+on iomux pullups may significantly reduce your standby-time.
-* the fiveway down button on the model D01100
-* the home button on model D01200
-A new USB device "NS Blank CODEX" should appear, barebox may be uploaded using
+``make kindle-mx50_defconfig`` should get you a working config.
- $ scripts/imx/imx-usb-loader barebox-kindle-d01100.img
- $ scripts/imx/imx-usb-loader barebox-kindle-d01200.img
+To upload and run a new bootloader, the older devices can be put into
+USB bootloader mode by the SoC microcode:
-Hint: keep the select button pressed down to get the barebox USB console.
+1. Connect the Kindle to your host computer with a USB cable.
+2. Power down the device by holding the power button until the power LED goes
+ dark (about 10 seconds).
+4. Hold the power button, and hold down a device-specific special key:
+ * the fiveway down button on the model D01100
+ * the home button on model D01200
+4. Then release the power button, but still hold the special key.
+5. A new USB device named ``NS Blank CODEX`` should appear on your host computer.
+ You can now release the special button.
+7. Finally, upload barebox to the Kindle by using:
-Barebox may be used as drop-in replacement for the shipped bootloader, when
-the imximg fits into 258048 bytes. When installing the barebox imximg on
-the eMMC, take care not to overwrite the vendor supplied serial numbers stored
-on the eMMC,
-e.g. for the D01100 just write the imx-header and the application section::
+ .. code-block:: console
- loady -t usbserial
- memcpy -b -s barebox-kindle-d01100.img -d /dev/disk0.boot0.imx_header 1024 0 2048
- memcpy -b -s barebox-kindle-d01100.img -d /dev/disk0.boot0.self 4096 0 253952
+ $ scripts/imx/imx-usb-loader barebox-kindle-d01100.img
+ $ scripts/imx/imx-usb-loader barebox-kindle-d01200.img
-Note: a USB serial ACM console will be launched by a barebox init script
+Additionally, a USB serial ACM console will be launched by a barebox init script
* the cursor select key is pressed during startup of model D01100
* the home button is pressed within a second after startup of model D01200.
- If you press the home button during startup, you will enter USB boot mode.
+ (If you press the home button during startup, you will enter USB boot mode.)
* the EY21 has no keys to press, a USB console will be launched for 10s.
-This device is battery-powered and there is no way to switch the device off.
-When the device is inactive, the kindle software will first reduce the
-power consumption to a few milliamps of battery power, after some minutes
-the power consumption is further reduced to about 550 microamps. Switching
-on iomux pullups may significantly reduce your standby-time.
-Hints to reduce the build image size
+Barebox may be used as drop-in replacement for the shipped bootloader, when
+the imximg fits into 258048 bytes. When installing the barebox imximg on
+the eMMC, take care not to overwrite the vendor supplied serial numbers stored
+on the eMMC,
+e.g. for the D01100 just write the imx-header and the application section:
-Note that a drop-in replacement barebox imximage must not exceed 258048 bytes
-since the space behind it is in use. Hence, don't build in drivers and FS
-that are not required, e.g.
-``NET, DISK_AHCI, DISK_INTF_PLATFORM_IDE, DISK_ATA, VIDEO, PWM, LED,
-USB_STORAGE, USB_ULPI, NAND, MTD_UBI, FS_UBIFS, MFD_MC34704, MFD_MC9SDZ60,
-MFD_STMPE, EEPROM_AT25, EEPROM_AT24, KEYBOARD_GPIO, PARTITION_DISK_EFI``
+.. code-block:: console
-Also unselect support for other boards to get rid of their dependencies.
-Further select ``IMAGE_COMPRESSION_XZKERN``.
+ $ loady -t usbserial
+ $ memcpy -b -s barebox-kindle-d01100.img -d /dev/disk0.boot0.imx_header 1024 0 2048
+ $ memcpy -b -s barebox-kindle-d01100.img -d /dev/disk0.boot0.self 4096 0 253952