diff options
| author | Juergen Borleis <jbe@pengutronix.de> | 2018-03-23 09:43:51 +0100 |
|---|---|---|
| committer | Sascha Hauer <s.hauer@pengutronix.de> | 2018-03-26 09:23:21 +0200 |
| commit | f04deb4018a2df204e16fc13c74028120cdb60a6 (patch) | |
| tree | 1f97528de964704199937c87d956003095cad0c6 /Documentation | |
| parent | 971366078893a669246a52e6058d47de9993e77e (diff) | |
| download | barebox-f04deb4018a2df204e16fc13c74028120cdb60a6.tar.gz barebox-f04deb4018a2df204e16fc13c74028120cdb60a6.tar.xz | |
i.MX/DCD compiler and interpreter: logic is different
Reading the manual more carefully discovers a different logic for the
DCD 'check' command. They use the term "until". In order to get the
manual and the software in sync, this change switches to the term
"until" as well. Changing must happen at compiler and interpreter level
to make it work.
Signed-off-by: Juergen Borleis <jbe@pengutronix.de>
Signed-off-by: Sascha Hauer <s.hauer@pengutronix.de>
Diffstat (limited to 'Documentation')
| -rw-r--r-- | Documentation/boards/imx.rst | 57 |
1 files changed, 57 insertions, 0 deletions
diff --git a/Documentation/boards/imx.rst b/Documentation/boards/imx.rst index 704aa027b6..9b1eb82d41 100644 --- a/Documentation/boards/imx.rst +++ b/Documentation/boards/imx.rst @@ -48,6 +48,63 @@ The images can also always be started second stage:: bootm /mnt/tftp/barebox-freescale-imx51-babbage.img +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> | soctype can be one of imx35, imx51, imx53, imx6 | ++----------------+--------------------------------------------------------------+ +| loadaddr <adr> | The address the binary is uploaded to | ++----------------+--------------------------------------------------------------+ +| dcdofs <ofs> | 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 <addr> <value> | write <value> into byte <addr> | ++------------------------------------+-----------------------------------------+ +| wm 16 <addr> <value> | write <value> into short <addr> | ++------------------------------------+-----------------------------------------+ +| wm 32 <addr> <value> | write <value> into word <addr> | ++------------------------------------+-----------------------------------------+ +| set_bits <width> <addr> <value> | set set bits in <value> in <addr> | ++------------------------------------+-----------------------------------------+ +| clear_bits <width> <addr> <value> | clear set bits in <value> in <addr> | ++------------------------------------+-----------------------------------------+ +| nop | do nothing (just waste time) | ++------------------------------------+-----------------------------------------+ + +<width> can be of 8, 16 or 32. + +Checking conditions: + ++------------------------------------+-----------------------------------------+ +| check <width> <cond> <addr> <mask> | Poll until condition becomes true. | +| | with <cond> 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. + Internal Boot Mode Through Internal RAM(IRAM) --------------------------------------------- |