diff options
author | Amaury Pouly <pamaury@rockbox.org> | 2011-11-06 01:49:13 +0000 |
---|---|---|
committer | Amaury Pouly <pamaury@rockbox.org> | 2011-11-06 01:49:13 +0000 |
commit | 5827937270bac874ae9e04679b3130fef9e306c4 (patch) | |
tree | 51bc262dedecdb7620300b46f23005c4b0eed311 /utils/imxtools/README | |
parent | 33d6bd61b51178b42a07a97118a689d849666331 (diff) | |
download | rockbox-5827937270bac874ae9e04679b3130fef9e306c4.tar.gz rockbox-5827937270bac874ae9e04679b3130fef9e306c4.zip |
sbtools: rename to imxtools, move imx_hid_recovery to imxtools/sbloader, fix tools to correctly handle/free memory, properly return error codes
git-svn-id: svn://svn.rockbox.org/rockbox/trunk@30907 a1c6a512-1295-4272-9138-f99709370657
Diffstat (limited to 'utils/imxtools/README')
-rw-r--r-- | utils/imxtools/README | 32 |
1 files changed, 32 insertions, 0 deletions
diff --git a/utils/imxtools/README b/utils/imxtools/README new file mode 100644 index 0000000000..8bf6fd5f8e --- /dev/null +++ b/utils/imxtools/README | |||
@@ -0,0 +1,32 @@ | |||
1 | This file document the format of the command file used by the elftosb tool. | ||
2 | By no way our tools tries to be compatible with Freescale's elftosb2. | ||
3 | However, our format is more subset of the general one. | ||
4 | |||
5 | The parse supports a limited form of comments: comments starting with // and ending at the end of the line. | ||
6 | |||
7 | A file first contains the list of sources: | ||
8 | |||
9 | sources | ||
10 | { | ||
11 | hw_init = "sdram_init.elf"; | ||
12 | rockbox = "rockbox.elf"; | ||
13 | } | ||
14 | |||
15 | It can then contain an arbitrary number of section. A section is identified by a number. | ||
16 | Within a section, three commands are supported: "load", "jump" and "call": | ||
17 | |||
18 | section(0x626f6f74) // hex for 'boot' | ||
19 | { | ||
20 | load hw_init; | ||
21 | call hw_init; | ||
22 | load rockbox; | ||
23 | jump rockbox; | ||
24 | } | ||
25 | |||
26 | Finally, both elftosb and sbtoelf tools use key files. A key file is a list of keys. | ||
27 | Each key consist is 128-bit long and is written in hexadecimal: | ||
28 | |||
29 | 00000000000000000000000000000000 | ||
30 | |||
31 | The parser does not handle blank line and only allows a final newline at the end of the file. | ||
32 | A file is allowed to contain zero (0) keys. | ||