Because your request is a bit broad, I want to make sure I give you exactly what you need. Could you clarify if you are looking for:
Technical Documentation/Guides: Instructions on how to compile or install sunxi-tools (like sunxi-fel) specifically on a Windows environment (e.g., using MSYS2 or Zadig drivers)?
Academic or Research Paper: A formal document or "white paper" discussing the architecture and utility of sunxi-tools for low-level hardware manipulation?
The sunxi-tools suite is an essential set of command-line utilities for developers and hobbyists working with Allwinner SoC (System on Chip) based ARM devices, such as the Orange Pi, NanoPi, and Pine64. While these tools are natively developed for Linux, they are fully functional on Windows with the right environment, allowing users to flash firmware, manipulate hardware configurations (FEX files), and interact with devices in FEL mode. Core Utilities in sunxi-tools
The suite provides several specialized tools for low-level device management: Sunxi-tools - GitHub
The glowing cursor on Leo’s screen felt like a heartbeat. On his desk sat a
, a tiny single-board computer that had "bricked" during a failed firmware flash. To fix it, he needed sunxi-tools , a powerful suite designed for Allwinner-based devices. The problem? Most guides assumed he was using . Leo was on , and the path forward felt like a digital maze. 🛠️ The First Hurdle: The Environment Leo knew he couldn’t just click an Sunxi-tools
is source code, meant to be "made" or compiled. He had two choices: MSYS2/MinGW: A way to build native Windows binaries. WSL (Windows Subsystem for Linux): Running a Linux terminal inside Windows.
to keep things lightweight. He typed the commands with bated breath: pacman -S git make gcc pkg-config ⚡ The Spark: FEL Mode He connected the
to his PC via USB. To make the computer "see" the board, he had to trigger He held down the special U-Boot button He tapped the Reset button sunxi-tools windows
Windows made a "chiming" sound, but the Device Manager showed an "Unknown Device." 🔧 The Bridge: Zadig and Drivers
This was the part where most people gave up. Windows didn't know how to talk to an Allwinner chip in FEL mode. Leo opened a tool called He selected the "Unknown Device" He swapped the driver to Click. Install. Success. 🚀 The Moment of Truth
With the drivers set, Leo returned to his terminal. He had compiled the tools, and it was time to see if his PC could reach out and touch the bricked silicon. He typed: sunxi-fel.exe ver The screen scrolled:
A Beginner’s Guide to Using Sunxi-Tools on Windows Sunxi-tools
a collection of command-line utilities designed for ARM devices powered by Allwinner SoCs
(System on Chips), such as Orange Pi, Banana Pi, and CubieBoard
. While originally built for Linux, these tools are essential for Windows users who need to modify device configurations or flash firmware directly via USB. What are Sunxi-Tools?
These tools allow you to interact with the "FEL" mode (a low-level bootloader mode) of Allwinner chips. Key utilities include: sunxi-fexc : Converts binary configuration files ( script.bin ) to human-readable text ( script.fex ) and back again.
: A powerful tool for USB communication with the device, used for uploading bootloaders or flashing memory. : Manages Peripheral Input/Output (PIO) settings. Step 1: Installing USB Drivers with Zadig Because your request is a bit broad, I
on Windows, your computer must recognize the Allwinner device in FEL mode. Enter FEL Mode
: Connect your board to your PC via USB while holding the FEL button (or shorting specific pins, depending on your hardware). : Download and run the Zadig USB tool
In Zadig, find the device (often listed as "Unknown Device" or with ID VID_1f3a_PID_efe8 Select the driver and click Replace Driver Step 2: Getting the Windows Binaries Since the official Sunxi-tools GitHub
provides source code, Windows users typically have two options: Download Pre-compiled Binaries : Use community-maintained repositories like Sunxi-Tools-Win-src which often include batch files like bin2fex.bat fex2bin.bat for easy use. Manual Compilation : Advanced users can compile the tools using an IDE like Code::Blocks toolchain. This requires adding specific dependencies like mman-win32 to handle Linux-style memory management on Windows. Step 3: Common Tasks 1. Modifying Device Configuration (FEX files)
To change hardware settings like GPIO pins or DRAM parameters: : Drag your script.bin bin2fex.bat . This generates a script.fex file you can edit in Notepad. : Once edited, drag script.fex fex2bin.bat to create a new script.bin for your device. 2. Testing FEL Connection Open a Command Prompt in your tools folder and type: sunxi-fel --list --verbose Use code with caution. Copied to clipboard
If successful, this will display a list of all connected Allwinner devices in FEL mode. Important Considerations O_BINARY Flag : If you are compiling the tools yourself, ensure the
flag is set when opening files; otherwise, Windows may corrupt the binary data during the conversion process. Hardware Prep
: Always ensure no SD card or SPI flash is interfering with the boot process if you are trying to force FEL mode.
For more technical details and hardware-specific guides, visit the official Linux-Sunxi Wiki Are you looking to modify a specific board's configuration , or do you need help flashing a new OS image Sunxi-tools - GitHub 26-Oct-2016 — Go to Options > List All Devices
When called with no arguments, sunxi-fel will display a short usage summary. Note: Unless you select a specific device using the - Sunxi-tools - linux-sunxi.org 20-Nov-2021 —
Good for simple FEL operations, but some tools may be missing.
This gives you the real Linux tools on Windows.
Open Zadig:
Launch MSYS2 UCRT64 from Start Menu. Run:
pacman -S mingw-w64-ucrt-x86_64-gcc make git libusb pkg-config
Caution: Replace \\.\PhysicalDriveX with your correct SD card identifier. Use list disk in diskpart first.
sunxi-fel.exe write-sdcard --device \\.\PhysicalDrive2 u-boot-sunxi-with-spl.bin
1. "libusb could not open device" This is almost always a driver issue. Run Zadig again. Ensure you are selecting the device that appears only when the board is plugged in. Sometimes Zadig selects your mouse or keyboard by accident—be careful not to replace those drivers!
2. Slow Transfer Speeds USB FEL transfer speeds on Windows can sometimes be slower than on Linux. If you are writing a full OS image via FEL, be patient.
3. Script vs. Interactive
If you are scripting these tools in a .bat file, ensure you add pauses or error checks, as Windows will close the CMD window immediately upon completion if you double-click the script.
| Tool | Purpose | Works on Windows |
|------|---------|----------------|
| sunxi-fel | Write SPL/U-Boot, read/write RAM/SPI/NAND, execute code | ✅ (via MSYS2 or WSL) |
| sunxi-nand-image-builder | Create NAND flash images | ✅ (WSL only) |
| sunxi-pio | Pin mux/interrupt config | ❌ needs /dev/mem (WSL can’t either) |
| phoenix-info | Read tablet/firmware info | ✅ (WSL only) |