From b6a68098795b0b6bc4735735e5e55cc9f6454436 Mon Sep 17 00:00:00 2001 From: Amaury Pouly Date: Sun, 17 Apr 2011 23:40:14 +0000 Subject: sbtools: document a bit the command file format git-svn-id: svn://svn.rockbox.org/rockbox/trunk@29744 a1c6a512-1295-4272-9138-f99709370657 --- utils/sbtools/README | 32 ++++++++++++++++++++++++++++++++ 1 file changed, 32 insertions(+) create mode 100644 utils/sbtools/README diff --git a/utils/sbtools/README b/utils/sbtools/README new file mode 100644 index 0000000000..8bf6fd5f8e --- /dev/null +++ b/utils/sbtools/README @@ -0,0 +1,32 @@ +This file document the format of the command file used by the elftosb tool. +By no way our tools tries to be compatible with Freescale's elftosb2. +However, our format is more subset of the general one. + +The parse supports a limited form of comments: comments starting with // and ending at the end of the line. + +A file first contains the list of sources: + +sources +{ + hw_init = "sdram_init.elf"; + rockbox = "rockbox.elf"; +} + +It can then contain an arbitrary number of section. A section is identified by a number. +Within a section, three commands are supported: "load", "jump" and "call": + +section(0x626f6f74) // hex for 'boot' +{ + load hw_init; + call hw_init; + load rockbox; + jump rockbox; +} + +Finally, both elftosb and sbtoelf tools use key files. A key file is a list of keys. +Each key consist is 128-bit long and is written in hexadecimal: + +00000000000000000000000000000000 + +The parser does not handle blank line and only allows a final newline at the end of the file. +A file is allowed to contain zero (0) keys. -- cgit v1.2.3