Sunxi-tools Windows May 2026
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 sunxi-tools suite is an essential open-source toolkit for developers and hobbyists working with Allwinner "sunxi" SoCs (like those in Orange Pi, Pine64, or Lichee Pi). While natively designed for Linux, a Windows version exists, though it comes with unique setup hurdles. Core Functionality
The Windows port typically bundles the most critical utilities from the linux-sunxi/sunxi-tools repository:
sunxi-fel: The "star" of the suite. It communicates with the CPU's internal BootROM (FEL mode) via USB to boot from RAM, flash SPI storage, or read/write memory.
fex2bin / bin2fex: Compilers for .fex files (Allwinner’s legacy hardware configuration format).
sunxi-bootinfo: Useful for inspecting the headers of Allwinner bootloader files. Windows Performance & UX
Using these tools on Windows is a mixed bag of powerful low-level access and driver frustration. Pros:
Portability: Allows you to unbrick or flash Allwinner devices without needing a full Linux environment or VM.
Batch Integration: Tools like J-Rios/Sunxi-Tools-Win include .bat scripts that simplify compiling complex boot configurations.
Lightweight: The binaries are tiny and require no formal installation beyond driver setup. Cons:
Driver Complexity: This is the biggest hurdle. You must use Zadig to replace the default Windows USB driver with WinUSB or libusb-win32 for sunxi-fel to recognize the device. sunxi-tools windows
Remote Limitations: It is known to struggle with device detection when used through Remote Desktop or terminal-server sessions due to how USB redirection is handled.
Incomplete Port: Some newer features (like specific NAND image builders) are occasionally omitted from Windows builds or break during compilation due to Linux-specific dependencies. Final Verdict
For Windows users, sunxi-tools is a "must-have but handle with care" utility. It is indispensable for low-level "fel" mode operations that GUI tools like PhoenixSuit can't handle. However, if you are doing heavy development, using these tools via WSL2 (with USBIPD for device attachment) often provides a more stable and feature-complete experience than the standalone Windows .exe versions. J-Rios/Sunxi-Tools-Win-src - GitHub
For developers and hobbyists working with Allwinner SoC-based devices like the sunxi-tools
an essential command-line suite for low-level hardware manipulation
. While natively built for Linux, using these tools on Windows is a popular way to avoid the USB mounting issues often found in virtual machines when flashing firmware. Key Utilities in the Suite
The Windows version of sunxi-tools provides several critical functions for board configuration:
: The primary tool for communicating with the Allwinner BROM over USB. It allows you to put devices into
to load SPL (Secondary Program Loader), read/write memory, or flash SPI storage. sunxi-fexc (fex2bin / bin2fex)
: A compiler/decompiler for Allwinner's hardware description files. It converts human-readable files into the binary format used by legacy kernels.
: Used to manipulate and debug GPIO (General Purpose Input/Output) settings directly. sunxi-bootinfo The sunxi-tools suite is an essential set of
: Dumps technical information from Allwinner boot headers to help identify firmware versions or DRAM settings. Setting Up on Windows Because sunxi-tools depends on
, standard Windows drivers often won't recognize the device in FEL mode. Driver Installation Zadig USB tool to replace the default driver with libusb-win32 for the detected Allwinner device. Binary Acquisition : While you can find pre-compiled versions on , many users prefer compiling from source using Code::Blocks to ensure compatibility with the latest SoC versions. FEL Mode Activation
: Most boards require holding a specific physical button (often labeled "UBOOT" or "Recovery") during power-on to be detected by the Common Use Cases Firmware Recovery
: Rescuing "bricked" devices that cannot boot from an SD card by pushing a minimal bootloader over USB. Hardware Tweaking : Modifying script.bin
to change CPU voltages, DRAM timings, or HDMI settings without re-imaging the entire system. NAND Partitioning sunxi-nand-part
to reconfigure internal storage on older Allwinner tablets or development boards. to flash a specific board?
Using Zadig (The Reliable Method)
Zadig is a universal driver installer for USB devices. It works perfectly with sunxi-tools.
-
Put your device into FEL mode:
- Remove SD card, eMMC, and NAND.
- Disconnect power.
- Connect the USB OTG port to your Windows PC.
- Apply power. The device is now in FEL mode (no LEDs may flash, which is normal).
-
Open Zadig (Run as Administrator).
-
Locate the device: From the dropdown menu, select "Unknown Device #1" or "USB-OTG (Interface 0)" with VID
1F3Aand PIDEFE8. -
Install the driver: Select libusb-win32 (or libusbK) as the target driver. Using Zadig (The Reliable Method) Zadig is a
- Crucial: Do not select WinUSB.
sunxi-fel.execompiled with MSYS2 expects libusb-1.0, which works best with the libusb-win32 driver.
- Crucial: Do not select WinUSB.
-
Click "Replace Driver" or "Install Driver". After installation, the device will appear as "libusb-win32 devices" in Device Manager.
Option 1: WSL2 (Easiest & Full Features)
This gives you the real Linux tools on Windows.
Why Use sunxi-tools on Windows?
Allwinner chips (A10, A20, H3, H5, H6, etc.) feature a low-level boot ROM routine called FEL mode. When a device is powered on without a bootable SD card or NAND, it enters FEL mode and waits for instructions via USB.
sunxi-tools allows you to:
- Flash U-Boot directly to SD card or NAND.
- Upload and execute raw code in RAM (ideal for testing).
- Dump or restore NAND memory.
- Boot the device over USB without writing anything to storage.
Most documentation assumes a Linux host. However, many embedded developers and makers prefer Windows for their daily workflow. Here is how to bridge that gap.
Step 3: Install sunxi-tools inside WSL2
sudo apt update
sudo apt install sunxi-tools
That’s it. Now you have:
sunxi-fel– low-level USB boot protocol toolssunxi-nand-image-buildersunxi-piophoenix-info
Tools Included in sunxi-tools
Some of the tools you might find in a sunxi-tools package include:
-
sunxi-fel: A tool that allows you to interact with the FEL (secure boot) mode of Allwinner SoCs. FEL mode is used for loading and executing binary images directly from the USB OTG port.
-
sunxi-showmem: A utility to display information about the memory (RAM) installed on the device.
-
sunxi-sid: A tool to read the SoC's unique ID.
-
sunxi-nand: For working with NAND flash on these devices.
-
sunxi-bootinfo: Displays information about the boot process and image.