summaryrefslogtreecommitdiffstats
path: root/Documentation/boards/imx
diff options
context:
space:
mode:
authorRoland Hieber <rohieb@rohieb.name>2018-09-02 23:21:23 +0200
committerSascha Hauer <s.hauer@pengutronix.de>2018-09-07 07:40:28 +0200
commit727b621499d5f16d5703a8b0014a84a2d2cf3c4d (patch)
treee896883d8dc71ca95e2713d59505a1cf5aaf0f20 /Documentation/boards/imx
parentc6e825726d4677a126995598aa9a3a0df24da555 (diff)
downloadbarebox-727b621499d5f16d5703a8b0014a84a2d2cf3c4d.tar.gz
barebox-727b621499d5f16d5703a8b0014a84a2d2cf3c4d.tar.xz
Documentation: i.MX: update Kindle 4/5 board documentation
- complete the instructions to get into USB bootloader mode - put hardware info to the top, and split into sections - add info about the new defconfig - remove build size hints, which have been applied to the defconfig - transform literal blocks into code blocks Signed-off-by: Roland Hieber <rohieb@rohieb.name> Signed-off-by: Sascha Hauer <s.hauer@pengutronix.de>
Diffstat (limited to 'Documentation/boards/imx')
-rw-r--r--Documentation/boards/imx/amazon-kindle-4-5.rst81
1 files changed, 41 insertions, 40 deletions
diff --git a/Documentation/boards/imx/amazon-kindle-4-5.rst b/Documentation/boards/imx/amazon-kindle-4-5.rst
index bc6bf2609b..58f38a058e 100644
--- a/Documentation/boards/imx/amazon-kindle-4-5.rst
+++ b/Documentation/boards/imx/amazon-kindle-4-5.rst
@@ -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
-startup:
+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
+Building barebox
+----------------
-A new USB device "NS Blank CODEX" should appear, barebox may be uploaded using
+``make kindle-mx50_defconfig`` should get you a working config.
-::
+Uploading barebox
+-----------------
- $ 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
-when
+Additionally, 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.
+ (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