diff options
Diffstat (limited to 'Documentation/boards')
-rw-r--r-- | Documentation/boards/imx.rst | 27 | ||||
-rw-r--r-- | Documentation/boards/imx/amazon-kindle-4-5.rst | 81 |
2 files changed, 41 insertions, 67 deletions
diff --git a/Documentation/boards/imx.rst b/Documentation/boards/imx.rst index 56fd3ab41c..99ca10b7cc 100644 --- a/Documentation/boards/imx.rst +++ b/Documentation/boards/imx.rst @@ -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: - -* i.MX51 - -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 -scenarious. - USB Boot ^^^^^^^^ 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 |