A collection of command line tools for ARM devices with Allwinner SoCs.
C Assembly Makefile C++ Shell Awk
Clone or download
Latest commit 5c19710 Nov 30, 2017
Permalink
Failed to load latest commit information.
bin fel: Remove obsolete fel-pio (thunk) code Dec 30, 2016
include portable_endian.h: A more uniform fix for the various BSD flavours Nov 29, 2016
tests unify-fex: Use int64_t and portable format specifiers for its output Nov 13, 2016
thunks Makefile: Improve auto-detection of ARM cross compiler Feb 11, 2017
.gitignore Add support for auto-updated version information Oct 21, 2016
.travis.yml travis-ci: Add and activate "make check" build step Nov 12, 2016
LICENSE.md Convert license file to Markdown syntax Oct 22, 2016
Makefile fel: Check the U-Boot's CRC instead of its size Nov 6, 2017
README.md Makefile: Improve auto-detection of ARM cross compiler Jan 27, 2017
adb-devprobe.sh Add copyright headers to various files. Jul 1, 2014
autoversion.sh (Fix permissions on autoversion.sh) Nov 29, 2016
boot_head.S boot_head, a little boot header to work around broken bootloaders Oct 11, 2012
boot_head.lds Fix compatibility with Linaro toolchains for building ARM binaries May 6, 2016
bootinfo.c Fix some issues that showed up as compiler warnings with mingw64 Oct 26, 2016
common.h common.h: Rename errf() to pr_error(), add pr_fatal() Dec 7, 2016
fel-gpio fel: Remove obsolete fel-pio (thunk) code Dec 30, 2016
fel-sdboot.S fel-sdboot: Fix header corruption workaround, implement in assembly May 28, 2016
fel-sdboot.lds Fix compatibility with Linaro toolchains for building ARM binaries May 6, 2016
fel.c fel: Check for the U-Boot header CRC Nov 6, 2017
fel_lib.c fel: Implement fel_clrsetbits_le32() helper Jan 27, 2017
fel_lib.h fel: Implement fel_clrsetbits_le32() helper Jan 27, 2017
fexc.c common.h: Rename errf() to pr_error(), add pr_fatal() Dec 7, 2016
fexc.h fexc: add `uboot` output Sep 29, 2012
find-arm-gcc.sh Makefile: Improve auto-detection of ARM cross compiler Feb 11, 2017
jtag-loop.S jtag-loop: correct build instructions Aug 15, 2012
jtag-loop.c jtag-loop: correct build instructions Aug 15, 2012
jtag-loop.lds Fix compatibility with Linaro toolchains for building ARM binaries May 6, 2016
meminfo.c meminfo: Add missing version output, fix initializer syntax Oct 28, 2016
nand-common.h nand-part: added/updated open source copyright headers Sep 19, 2013
nand-image-builder.c Fix some issues that showed up as compiler warnings with mingw64 Oct 26, 2016
nand-part-a10.h nand-part: create one nand-part program to handle both A10 and A20 Sep 19, 2013
nand-part-a20.h nand-part: create one nand-part program to handle both A10 and A20 Sep 19, 2013
nand-part-main.c Have programs display version information in their usage help Oct 24, 2016
nand-part.c nand-part: Avoid Linux-only ioctl() on other platforms May 3, 2016
phoenix_info.c Have programs display version information in their usage help Oct 24, 2016
pio.c Have a workaround for missing mmap() in fexc.c and pio.c Oct 26, 2016
progress.c fel: support FEL progress gauge via dialog utility Dec 16, 2015
progress.h fel: support FEL progress gauge via dialog utility Dec 16, 2015
script.c fexc: script: add script_find_entry() helper Oct 1, 2012
script.h fexc: Fix thinko in script decompiler May 24, 2016
script_bin.c common.h: Rename errf() to pr_error(), add pr_fatal() Dec 7, 2016
script_bin.h fexc: Convert version[0] header field to filesize Nov 10, 2016
script_extractor.c script_extractor: Remove unnecessary size argument Dec 8, 2015
script_fex.c common.h: Rename errf() to pr_error(), add pr_fatal() Dec 7, 2016
script_fex.h Relicensed as GPLv2+ Jun 15, 2012
script_uboot.c common.h: Rename errf() to pr_error(), add pr_fatal() Dec 7, 2016
script_uboot.h fexc: add `uboot` output Sep 29, 2012
soc_info.c fel: Enable the SMC workaround for H3/H5/A64/H64 Feb 28, 2017
soc_info.h fel: SMC workaround to enter "secure boot" FEL mode on some SoCs Feb 28, 2017
uart0-helloworld-sdboot.c uart0-helloworld: Refactor SID fix Dec 28, 2016
uart0-helloworld-sdboot.lds Add new uart0-helloworld-sdboot.sunxi bootable test image Jun 3, 2016

README.md

sunxi-tools

License Build Status Releases Commits

Copyright (C) 2012 Alejandro Mery amery@geeks.cl
For a full list of contributors, see this link or use the command git shortlog -se --no-merges.

Command line utilities to work with devices based on Allwinner SoCs: sun4i, sun5i, ... - that's why the 'x' in the package name.

sunxi-fexc

.fex file (de)compiler

Usage: ./sunxi-fexc [-vq] [-I <infmt>] [-O <outfmt>] [<input> [<output>]]

infmt:  fex, bin  (default:fex)
outfmt: fex, bin  (default:bin)

bin2fex

compatibility shortcut to call sunxi-fexc to decompile a script.bin blob back into .fex format used by Allwinner's SDK to configure the boards.

fex2bin

compatiblity shortcut to call sunxi-fexc to compile a .fex file into the binary form used by the legacy 3.4 kernel ("linux-sunxi").

sunxi-fel

script interface for USB communication with the FEL handler built in to the CPU. You usually activate FEL mode by pushing the uboot / recovery button at poweron, or by having your device "fail over" to FEL when no other boot option is available. See http://linux-sunxi.org/FEL/USBBoot for a detailed usage guide.

When called with no arguments, sunxi-fel will display a short usage summary.

Note: Unless you select a specific device using the --dev or --sid options, the tool will access the first Allwinner device (in FEL mode) that it finds. You can print a list of all FEL devices currently connected/detected with ./sunxi-fel --list --verbose.

fel-gpio

Simple wrapper (script) around sunxi-pio and sunxi-fel to allow GPIO manipulations via FEL

fel-sdboot

ARM native sdcard bootloader forcing the device into FEL mode

uart0-helloworld-sdboot

ARM native sdcard bootloader, which is only printing a short "hello" message to the UART0 serial console. Because it relies on runtime SoC type detection, this single image is bootable on a wide range of Allwinner devices and can be used for testing. Additionally, it may serve as a template/example for developing simple bare metal code (LED blinking and other similar GPIO related things).

sunxi-pio

Manipulate PIO registers/dumps

sunxi-nand-part

Tool for manipulating Allwinner NAND partition tables

sunxi-nand-image-builder

Tool used to create raw NAND images (including boot0 images)

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)

--type=sd	include SD boot info
--type=nand	include NAND boot info (not implemented)

phoenix_info

gives information about a phoenix image created by the phoenixcard utility and optionally extracts the embedded boot 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-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

Building

Compilation requires the development version of libusb-1.0 (include header and library) to be installed for sunxi-fel. Unless you explicitly pass LIBUSB_CFLAGS and LIBUSB_LIBS to the make utility, pkg-config is also needed.

Available build targets:

  • make tools builds tools that are useful on the host. This is what most people will want, and our default target (when simply using make).

  • make target-tools builds tools that are intended for the target (Allwinner SoC), using a cross-compiler. The Makefile will try to auto-detect a suitable toolchain prefix, and falls back to arm-none-eabi- otherwise. If needed, you may override this by explicitly setting CROSS_COMPILE.
    Hint: When compiling 'natively' on the target platform you may simply use an empty toolchain prefix here (make target-tools CROSS_COMPILE= or make all CROSS_COMPILE=).

  • make all builds both tools and target-tools.

  • make install-tools builds tools and then copies/installs them to a filesystem location. The destination is affected by settings for DESTDIR, PREFIX and possibly BINDIR. For details, please refer to the Makefile. You may use make install as a shortcut for this.

  • make install-target-tools builds target-tools and then copies/installs them to a filesystem location selected by DESTDIR, PREFIX and possibly BINDIR - see make install-tools above.

  • make install-all builds and installs both tools and target-tools.

  • make misc builds miscellaneous (host) utilities that are not part of our 'standard' suite. Currently this means phoenix_info and sunxi-nand-image-builder.

  • make install-misc builds misc and installs the resulting binaries.

License

This software is licensed under the terms of GPLv2+ as defined by the Free Software Foundation, details can be read in the LICENSE.md file.