doc: boards: imx: order table of contents alphabetically

Upper and lower case are significant when sorting file names. Stay with
lower case file names for now, and make sure the file name order is the
same as the order of the page titles in the table of contents.

Signed-off-by: Roland Hieber <rohieb@rohieb.name>
Signed-off-by: Sascha Hauer <s.hauer@pengutronix.de>

1 files changed, 58 insertions, 0 deletions

diff --git a/Documentation/boards/imx/amazon-kindle-4-5.rst b/Documentation/boards/imx/amazon-kindle-4-5.rst
new file mode 100644
index 0000000000..1e71cd26ba
--- /dev/null
+++ b/Documentation/boards/imx/amazon-kindle-4-5.rst
@@ -0,0 +1,58 @@
+Amazon Kindle 4/5 Model No. D01100, D01200 and EY21
+===================================================
+
+The Kindle Model No. D01100 (Kindle Wi-Fi), 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:
+
+* a Freescale i.MX50 SOC
+* 2 or 4GiB eMMC
+* a MC13892 PMIC
+
+The older readers D01100 and D01200 use 256MiB of LPDDR1,
+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
+startup:
+* 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
+$ scripts/imx/imx-usb-loader barebox-kindle-d01100.img
+$ scripts/imx/imx-usb-loader barebox-kindle-d01200.img
+Hint: keep the select button pressed down to get the barebox USB console.
+
+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:
+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
+
+Note: a USB serial ACM console will be launched by a barebox init script
+when
+* 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.
+* 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.
+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
+Also unselect support for other boards to get rid of their dependencies.
+Further select IMAGE_COMPRESSION_XZKERN