From mboxrd@z Thu Jan 1 00:00:00 1970 Return-path: Received: from metis.ext.pengutronix.de ([2001:67c:670:201:290:27ff:fe1d:cc33]) by bombadil.infradead.org with esmtps (Exim 4.90_1 #2 (Red Hat Linux)) id 1gWNu1-00059T-EA for barebox@lists.infradead.org; Mon, 10 Dec 2018 15:55:33 +0000 From: Roland Hieber Date: Mon, 10 Dec 2018 16:55:09 +0100 Message-Id: <20181210155511.1376-1-rhi@pengutronix.de> MIME-Version: 1.0 List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: 7bit Sender: "barebox" Errors-To: barebox-bounces+u.kleine-koenig=pengutronix.de@lists.infradead.org Subject: [PATCH 1/3] Documentation: i.MX: improve wording, add markup and missing articles To: Barebox Mailing List Cc: Roland Hieber Signed-off-by: Roland Hieber --- Documentation/boards/imx.rst | 102 +++++++++++++++++++---------------- 1 file changed, 57 insertions(+), 45 deletions(-) diff --git a/Documentation/boards/imx.rst b/Documentation/boards/imx.rst index 35a180b0dd..2e6a30fd2f 100644 --- a/Documentation/boards/imx.rst +++ b/Documentation/boards/imx.rst @@ -32,114 +32,126 @@ Normally it's not necessary to call this tool manually, it is executed automatically at the end of the build process. The images generated by the build process can be directly written to an SD card: .. code-block:: sh # with Multi Image support: cat images/barebox-freescale-imx51-babbage.img > /dev/sdd # otherwise: cat barebox-flash-image > /dev/sdd The above will overwrite the MBR (and consequently the partition table) on the destination SD card. To preserve the MBR while writing the rest -of the image to the card, use:: +of the image to the card, use: + +.. code-block:: sh dd if=images/barebox-freescale-imx51-babbage.img of=/dev/sdd bs=1024 skip=1 seek=1 -NOTE: MaskROM on i.MX8 expects image to start at +33KiB mark, so the +Note that MaskROM on i.MX8 expects the image to start at the +33KiB mark, so the following command has to be used instead: +.. code-block:: sh + dd if=images/barebox-nxp-imx8mq-evk.img of=/dev/sdd bs=1024 skip=33 seek=33 Or, in case of NAND: +.. code-block:: sh + dd if=images/barebox-nxp-imx8mq-evk.img of=/dev/nand bs=1024 skip=33 seek=1 -The images can also always be started second stage:: +The images can also always be started as second stage on the target: + +.. code-block:: console - bootm /mnt/tftp/barebox-freescale-imx51-babbage.img + barebox@Board Name:/ bootm /mnt/tftp/barebox-freescale-imx51-babbage.img Using GPT on i.MX ^^^^^^^^^^^^^^^^^ -For i.MX SoCs that place vendor specific header at +1KiB mark of a -boot medium, special care needs to be taken when parition that medium -with GPT. In order to make room for i.MX boot header GPT Partition +For i.MX SoCs that place a vendor specific header at the +1KiB mark of a +boot medium, special care needs to be taken when partitioning that medium +with GPT. In order to make room for the i.MX boot header, the GPT Partition Entry Array needs to be moved from its typical location, LBA 2, to an offset past vendor specific information. One way to do this would be -to use ``-j`` or ``--adjust-main-table`` option of ``sgdisk``. For -example, the following sequence: +to use the ``-j`` or ``--adjust-main-table`` option of ``sgdisk``. For +example, the following sequence + +.. code-block:: sh sgdisk -Z sgdisk -o -j 2048 -n 1:8192:+100M will create a single GPT partition starting at LBA 8192 and would -place Partition Entry Array starting at LBA 2048 which should leave -enough room for Barebox/i.MX boot header. Once that is done ``dd`` +place the Partition Entry Array starting at LBA 2048, which should leave +enough room for the Barebox/i.MX boot header. Once that is done, the ``dd`` command above can be used to place Barebox on the same medium. Information about the ``imx-image`` tool ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ The imx-image tool can be used to generate imximages from raw binaries. It requires an configuration file describing how to setup the SDRAM on a particular board. This mainly consists of a poke table. The recognized options in this file are: Header: -+----------------+--------------------------------------------------------------+ -| soc |soctype can be one of imx35, imx51, imx53, imx6, imx7, vf610, | -| | imx8mq | -+----------------+--------------------------------------------------------------+ -| loadaddr | The address the binary is uploaded to | -+----------------+--------------------------------------------------------------+ -| dcdofs | The offset of the image header in the image. This should be: | -| | * ``0x400``: MMC/SD, NAND, serial ROM, PATA, SATA | -| | * ``0x1000``: NOR Flash | -| | * ``0x100``: OneNAND | -+----------------+--------------------------------------------------------------+ ++--------------------+--------------------------------------------------------------+ +| ``soc `` | soctype can be one of imx35, imx51, imx53, imx6, imx7, vf610,| +| | imx8mq | ++--------------------+--------------------------------------------------------------+ +| ``loadaddr `` | The address the binary is uploaded to | ++--------------------+--------------------------------------------------------------+ +| ``dcdofs `` | The offset of the image header in the image. This should be: | +| | | +| | * ``0x400``: MMC/SD, NAND, serial ROM, PATA, SATA | +| | * ``0x1000``: NOR Flash | +| | * ``0x100``: OneNAND | ++--------------------+--------------------------------------------------------------+ Memory manipulation: -+------------------------------------+-----------------------------------------+ -| wm 8 | write into byte | -+------------------------------------+-----------------------------------------+ -| wm 16 | write into short | -+------------------------------------+-----------------------------------------+ -| wm 32 | write into word | -+------------------------------------+-----------------------------------------+ -| set_bits | set set bits in in | -+------------------------------------+-----------------------------------------+ -| clear_bits | clear set bits in in | -+------------------------------------+-----------------------------------------+ -| nop | do nothing (just waste time) | -+------------------------------------+-----------------------------------------+ - - can be of 8, 16 or 32. ++----------------------------------------+-------------------------------------------------+ +| ``wm 8 `` | write ```` into byte ```` | ++----------------------------------------+-------------------------------------------------+ +| ``wm 16 `` | write ```` into short ```` | ++----------------------------------------+-------------------------------------------------+ +| ``wm 32 `` | write ```` into word ```` | ++----------------------------------------+-------------------------------------------------+ +| ``set_bits `` | set set bits in ```` in ```` | ++----------------------------------------+-------------------------------------------------+ +| ``clear_bits `` | clear set bits in ```` in ```` | ++----------------------------------------+-------------------------------------------------+ +| ``nop`` | do nothing (just waste time) | ++----------------------------------------+-------------------------------------------------+ + +```` can be one of 8, 16 or 32. Checking conditions: -+------------------------------------+-----------------------------------------+ -| check | Poll until condition becomes true. | -| | with being one of: | -| | * ``until_all_bits_clear`` | -| | * ``until_all_bits_set`` | -| | * ``until_any_bit_clear`` | -| | * ``until_any_bit_set`` | -+------------------------------------+-----------------------------------------+ ++----------------------------------------+-----------------------------------------+ +| ``check `` | Poll until condition becomes true. | +| | with ```` being one of: | +| | | +| | * ``until_all_bits_clear`` | +| | * ``until_all_bits_set`` | +| | * ``until_any_bit_clear`` | +| | * ``until_any_bit_set`` | ++----------------------------------------+-----------------------------------------+ Some notes about the mentioned *conditions*. - ``until_all_bits_clear`` waits until ``(*addr & mask) == 0`` is true - ``until_all_bits_set`` waits until ``(*addr & mask) == mask`` is true - ``until_any_bit_clear`` waits until ``(*addr & mask) != mask`` is true - ``until_any_bit_set`` waits until ``(*addr & mask) != 0`` is true. USB Boot ^^^^^^^^ Most boards can be explicitly configured for USB Boot Mode or fall back to USB Boot when no other medium can be found. The barebox repository contains a USB upload tool. As it depends on the libusb development headers, -- 2.19.1 _______________________________________________ barebox mailing list barebox@lists.infradead.org http://lists.infradead.org/mailman/listinfo/barebox