Commit 217c440b authored by Bernhard Nortmann's avatar Bernhard Nortmann
Browse files

README: Improve on (markdown) formatting


Signed-off-by: default avatarBernhard Nortmann <bernhard.nortmann@web.de>
parent 805d2a8e
...@@ -7,74 +7,78 @@ Copyright (C) 2012 Alejandro Mery <amery@geeks.cl> ...@@ -7,74 +7,78 @@ Copyright (C) 2012 Alejandro Mery <amery@geeks.cl>
Tools to help hacking Allwinner A10 (aka sun4i) based devices and possibly Tools to help hacking Allwinner A10 (aka sun4i) based devices and possibly
it's successors, that's why the 'x' in the package name. it's successors, that's why the 'x' in the package name.
<pre> ### sunxi-fexc
sunxi-fexc: `.fex` file (de)compiler
`.fex` file (de)compiler
Usage: ./sunxi-fexc [-vq] [-I &lt;infmt>] [-O &lt;outfmt>] [&lt;input> [&lt;output>]] Usage: ./sunxi-fexc [-vq] [-I <infmt>] [-O <outfmt>] [<input> [<output>]]
infmt: fex, bin (default:fex) infmt: fex, bin (default:fex)
outfmt: fex, bin (default:bin) outfmt: fex, bin (default:bin)
bin2fex: ### bin2fex
compatibility shortcut to call `sunxi-fexc` to decompile a script.bin compatibility shortcut to call `sunxi-fexc` to decompile a _script.bin_
blob back into `.fex` format used by allwinner's SDK to configure blob back into `.fex` format used by Allwinner's SDK to configure
the boards. the boards.
fex2bin: ### fex2bin
compatiblity shortcut to call `sunxi-fexc` to compile a `.fex` file compatiblity shortcut to call `sunxi-fexc` to compile a `.fex` file
into the binary form used by the sun4i kernel. into the binary form used by the legacy 3.4 kernel ("linux&#8209;sunxi").
sunxi-fel: ### sunxi-fel
script interface for talking to the FEL USB handler built in to script interface for talking to the FEL USB handler built in to
th CPU. You activate FEL mode by pushing the usboot/recovery the CPU. You activate [FEL mode] by pushing the _uboot_ / _recovery_
button at poweron. See http://linux-sunxi.org/FEL/USBBoot for button at poweron. See http://linux-sunxi.org/FEL/USBBoot for
a detailed usage guide. a detailed usage guide.
fel-gpio: ### fel-gpio
Simple wrapper around fel-pio and fel to allos GPIO manipulations Simple wrapper (script) around `fel-pio` and `sunxi-fel`
via FEL to allow GPIO manipulations via FEL
fel-sdboot:
ARM native sdcard bootloader forcing the device into FEL mode
fel-pio: ### fel-sdboot
ARM native helper for fel-gpio ARM native sdcard bootloader forcing the device into FEL mode
sunxi-pio: ### fel-pio
Manipulate PIO register dumps ARM native helper (binary) for `fel-gpio`
sunxi-nand-part: ### sunxi-pio
Tool for manipulating Allwinner NAND partition tables Manipulate PIO register dumps
jtag-loop.sunxi: ### sunxi-nand-part
ARM native boot helper to force the SD port into JTAG Tool for manipulating Allwinner NAND partition tables
and then stop, to ease debugging of bootloaders.
### jtag-loop.sunxi
ARM native boot helper to force the SD port into JTAG and then stop,
to ease debugging of bootloaders.
### sunxi-bootinfo
Dump information from Allwinner boot files (_boot0_ / _boot1_)
sunxi-bootinfo:
Dump information from Allwinner boot files (boot0/boot1)
--type=sd include SD boot info --type=sd include SD boot info
--type=nand include NAND boot info (not implemented) --type=nand include NAND boot info (not implemented)
phoenix_info: ### phoenix_info
gives information about a phoenix image created by the gives information about a phoenix image created by the
phoenixcard utility and optionally extracts the embedded boot phoenixcard utility and optionally extracts the embedded boot
code & firmware file from their hidden partitions. code & firmware file from their hidden partitions.
### sunxi-meminfo
Tool for reading DRAM settings from registers. Compiled as a
static binary for use on android and other OSes.
To build this, get a toolchain and run:
make CROSS_COMPILE=arm-linux-gnueabihf- sunxi-meminfo
sunxi-meminfo: ### sunxi-script_extractor
Tool for reading DRAM settings from registers. Compiled as a A simple tool, which can be executed on a rooted Android device
static binary for use on android and other OSes. To build this, to dump the _script.bin_ blob from RAM via reading _/dev/mem_.
get a toolchain, and run: To build this, get a toolchain and run:
make CROSS_COMPILE=arm-linux-gnueabihf- sunxi-meminfo
sunxi-script_extractor: make CROSS_COMPILE=arm-linux-gnueabihf- sunxi-script_extractor
A simple tool, which can be executed on a rooted Android device ---
to dump the script.bin blob from RAM via reading /dev/mem.
To build this, get a toolchain, and run:
make CROSS_COMPILE=arm-linux-gnueabihf- sunxi-script_extractor
</pre>
## License
This software is licensed under the terms of GPLv2+ as defined by the This software is licensed under the terms of GPLv2+ as defined by the
Free Software Foundation, details can be read in the [COPYING][] file. Free Software Foundation, details can be read in the [COPYING][] file.
[copying]: COPYING [copying]: COPYING
\ No newline at end of file [fel mode]: http://linux-sunxi.org/FEL
Markdown is supported
0% or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment