FirmwareKit.Comm.Fastboot 1.1.0

.NET 6.0 This package targets .NET 6.0. The package is compatible with this framework or higher. .NET Standard 2.0 This package targets .NET Standard 2.0. The package is compatible with this framework or higher. 
dotnet add package FirmwareKit.Comm.Fastboot --version 1.1.0
                    


                    

                
NuGet\Install-Package FirmwareKit.Comm.Fastboot -Version 1.1.0
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package. 
<PackageReference Include="FirmwareKit.Comm.Fastboot" Version="1.1.0" />
For projects that support PackageReference, copy this XML node into the project file to reference the package. 
<PackageVersion Include="FirmwareKit.Comm.Fastboot" Version="1.1.0" />
                    


                            Directory.Packages.props
                        

                    

                
<PackageReference Include="FirmwareKit.Comm.Fastboot" />
                    


                            Project file
For projects that support Central Package Management (CPM), copy this XML node into the solution Directory.Packages.props file to version the package. 
paket add FirmwareKit.Comm.Fastboot --version 1.1.0
                    


                    

                
#r "nuget: FirmwareKit.Comm.Fastboot, 1.1.0"
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package. 
#:package FirmwareKit.Comm.Fastboot@1.1.0
#:package directive can be used in C# file-based apps starting in .NET 10 preview 4. Copy this into a .cs file before any lines of code to reference the package. 
#addin nuget:?package=FirmwareKit.Comm.Fastboot&version=1.1.0
                    


                            Install as a Cake Addin
                        

                    

                
#tool nuget:?package=FirmwareKit.Comm.Fastboot&version=1.1.0
                    


                            Install as a Cake Tool

FirmwareKit.Comm.Fastboot

NuGet Version License: MIT

A high-performance C# implementation of the Android Fastboot protocol, aligned with the latest AOSP (Android Open Source Project) logic. Designed for firmware flashing, device management, and automation. Part of the FirmwareKit ecosystem.

Features

  • AOSP Aligned: Command framing, response parsing (OKAY/FAIL/INFO/DATA/TEXT), download:%08x size fields, sparse chunked flashing, and CRC verification (has-crc) follow the official Google fastboot implementation byte-for-byte.
  • Multi-Transport:
    • USB — via FirmwareKit.Comm (WinUSB / Linux / macOS native + libusb-dotnet backends)
    • Fastboot over TCP (FB01 handshake, AOSP framing)
    • Fastboot over UDP (AOSP UDP protocol: header / sequence / retransmission)
  • Device Discovery: interface-based matching (0xff/0x42/0x03, identical to AOSP), so any device exposing a standard fastboot interface is found regardless of VID/PID — Android phones, HarmonyOS bootloaders, U-Boot dev boards, Kindle, etc. An optional VID/PID whitelist (devices.json) covers legacy devices with non-standard interfaces.
  • Capability Probing: ProbeCapabilities() detects the device feature set and degrades gracefully for command-subset devices (U-Boot boards: no logical partitions, no CRC, no userspace fastboot).
  • Rich Command Set: flash / flashall / update / erase / format / fetch / upload / boot / logical partitions / super update / vbmeta flags / snapshot-update / gsi / flashing lock & unlock / oem (incl. U-Boot ucmd/acmd/run) / signature / sideload / stage / get_staged.
  • Multi-Targeting: netstandard2.0, netstandard2.1, net6.0, net8.0, net10.0. Native AOT and trimming compatible.

Installation

dotnet add package FirmwareKit.Comm.Fastboot

Latest published version on NuGet: 1.0.1. See the dependency table in NuGet Dependencies for the published ecosystem packages this library builds upon.

Quick Start

1. Connect over USB (automatic discovery)

using FirmwareKit.Comm.Fastboot;
using FirmwareKit.Comm.Fastboot.Usb;

// Enumerate fastboot devices (standard interface 0xff/0x42/0x03).
var devices = UsbManager.GetAllDevices();
if (devices.Count == 0) throw new Exception("no fastboot device found");

using var driver = new FastbootDriver(devices[0]);   // takes ownership of the transport

Optional: enable the VID/PID whitelist fallback and/or load an external device manifest:

UsbManager.MatchMode = UsbMatchMode.InterfaceOrKnownVidPid;   // interface first, whitelist fallback
UsbManager.LoadDeviceProfilesFromFile("devices.json");        // optional external manifest

Or wait for a specific device by serial number:

using var driver = FastbootDriver.WaitForDevice(UsbManager.GetAllDevices, "serial123", timeoutSeconds: 30);

2. Connect over TCP / UDP (network fastboot: U-Boot, fastbootd)

using FirmwareKit.Comm.Fastboot.Network;

using var tcp = new TcpTransport("192.168.1.10", 5554);       // FB01 handshake is automatic
using var driver = new FastbootDriver(tcp);

using var udp = new UdpTransport("192.168.1.10", 5554);
using var driver = new FastbootDriver(udp);

3. Query and flash

driver.ProbeCapabilities();                     // optional: cache device features for graceful degradation
string version = driver.GetVar("version");      // getvar:version
var all = driver.GetVarAll();                   // getvar:all -> dictionary

driver.FlashImage("boot", @"C:\images\boot.img");              // auto sparse chunking / logical resize
driver.FlashImage("system", stream);                           // flash from a stream
driver.FlashAll(@"C:\images\product_out", wipe: false);        // flashall (fastboot-info.txt aware)
driver.FlashVbmeta("vbmeta", @"C:\images\vbmeta.img", disableVerity: true);
driver.ErasePartition("userdata");
driver.Fetch("boot", @"C:\out\boot.img");                      // fetch partition image
driver.Reboot("bootloader");

Progress and events:

driver.ReceivedFromDevice += (s, e) => Console.WriteLine($"INFO: {e.NewInfo}");
driver.DataTransferProgressChanged += (s, p) => Console.WriteLine($"progress: {p.Item1}/{p.Item2}");
driver.CommandCompleted += (s, e) => Console.WriteLine($"{e.Command} -> {e.Response.Result}");

CLI (FirmwareKit.Comm.Fastboot.Cli)

The repository also ships a console front-end (FirmwareKit.Comm.Fastboot.Cli), published as a Native AOT binary named fastboot so it stays a drop-in replacement for the official tool:

fastboot devices                          # list devices (SERIAL\tfastboot, official format)
fastboot -i 0x2207 devices                # filter by USB vendor id
fastboot -s tcp:192.168.1.10:5554 getvar all   # network fastboot
fastboot flash boot boot.img
fastboot flashall
fastboot fetch boot out.img
fastboot update-super super_empty.img
fastboot shutdown
fastboot oem ucmd 'mmc dev 0'             # U-Boot boards (CONFIG_FASTBOOT_OEM_RUN)

NuGet Dependencies

This library is built on the following published FirmwareKit ecosystem packages:

Package Purpose Latest published
FirmwareKit.Comm Cross-platform USB enumeration & sessions (WinUSB/Linux/macOS/libusb) 1.0.0
FirmwareKit.Lp Android super logical-partition metadata (parse / build / export) 1.0.0
FirmwareKit.Sparse Android sparse image parsing, random access, resparsing, CRC 1.1.0
Crc32.NET CRC32 for has-crc download verification 1.2.0

Other published ecosystem packages you may find useful alongside fastboot:

Package Purpose
FirmwareKit.AVB VBMeta / AVB parsing, descriptors, footer, AB flow
FirmwareKit.CPIO CPIO / TAR archive read / write / verify
FirmwareKit.Comm.EDL Qualcomm EDL mode (Sahara / Firehose) communication

Only packages published on NuGet are listed above. Additional FirmwareKit format parsers that are not yet published on NuGet are intentionally omitted from this document.

Compatibility Notes

  • Protocol level: byte-compatible with AOSP fastboot (framing, sizes, handshakes, sparse, CRC); the official client and this library can talk to the same device interchangeably.
  • Discovery: standard interface 0xff/0x42/0x03 by default; optional VID/PID whitelist for legacy devices. Use -i <VID> in the CLI to filter by vendor id.
  • Non-Android devices (U-Boot boards, HarmonyOS bootloaders, Kindle, …): discovered via the interface rule; advanced features degrade automatically via ProbeCapabilities().
  • See docs/PROJECT_GUIDE.md for the full project structure, per-device fastboot entry methods, Windows driver (Zadig / HiSuite) and Linux udev setup, and ecosystem reuse guidance.

Requirements

  • .NET Standard 2.0: compatible with Unity and .NET Framework 4.6.1+.
  • .NET 8+: fully supports Native AOT and trimming.

Tests

dotnet test FirmwareKit.Comm.Fastboot.Tests/FirmwareKit.Comm.Fastboot.Tests.csproj

Coverage: protocol response parsing, download / sparse / CRC, TCP & UDP transports, boot image builder, capability probing, device profile loading, and AOSP driver parity.

Credits

  • Based on AOSP system/core/fastboot (reference sources under fastboot/ in this repository).
  • Part of the FirmwareKit ecosystem by uotan-Dev.

License

This project is licensed under the MIT License.

Product Compatible and additional computed target framework versions.
.NET net5.0 was computed.  net5.0-windows was computed.  net6.0 is compatible.  net6.0-android was computed.  net6.0-ios was computed.  net6.0-maccatalyst was computed.  net6.0-macos was computed.  net6.0-tvos was computed.  net6.0-windows was computed.  net7.0 was computed.  net7.0-android was computed.  net7.0-ios was computed.  net7.0-maccatalyst was computed.  net7.0-macos was computed.  net7.0-tvos was computed.  net7.0-windows was computed.  net8.0 is compatible.  net8.0-android was computed.  net8.0-browser was computed.  net8.0-ios was computed.  net8.0-maccatalyst was computed.  net8.0-macos was computed.  net8.0-tvos was computed.  net8.0-windows was computed.  net9.0 was computed.  net9.0-android was computed.  net9.0-browser was computed.  net9.0-ios was computed.  net9.0-maccatalyst was computed.  net9.0-macos was computed.  net9.0-tvos was computed.  net9.0-windows was computed.  net10.0 is compatible.  net10.0-android was computed.  net10.0-browser was computed.  net10.0-ios was computed.  net10.0-maccatalyst was computed.  net10.0-macos was computed.  net10.0-tvos was computed.  net10.0-windows was computed. 
.NET Core netcoreapp2.0 was computed.  netcoreapp2.1 was computed.  netcoreapp2.2 was computed.  netcoreapp3.0 was computed.  netcoreapp3.1 was computed. 
.NET Standard netstandard2.0 is compatible.  netstandard2.1 is compatible. 
.NET Framework net461 was computed.  net462 was computed.  net463 was computed.  net47 was computed.  net471 was computed.  net472 was computed.  net48 was computed.  net481 was computed. 
MonoAndroid monoandroid was computed. 
MonoMac monomac was computed. 
MonoTouch monotouch was computed. 
Tizen tizen40 was computed.  tizen60 was computed. 
Xamarin.iOS xamarinios was computed. 
Xamarin.Mac xamarinmac was computed. 
Xamarin.TVOS xamarintvos was computed. 
Xamarin.WatchOS xamarinwatchos was computed. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

NuGet packages

This package is not used by any NuGet packages.

GitHub repositories (1)

Showing the top 1 popular GitHub repositories that depend on FirmwareKit.Comm.Fastboot:

Repository Stars
Uotan-Dev/UotanToolboxNT
现代化 Android & OpenHarmony 工具箱 | A Modern Toolbox for Android & OpenHarmony Devices
Version Downloads Last Updated
1.1.0 108 8/1/2026
1.0.1 476 3/10/2026
1.0.0 117 3/3/2026

1.1.0 - Multi-command CLI (CommandLineParser), -i vendor-id filter, official devices -l format, device capability probing, VID/PID whitelist discovery (devices.json), AOT-safe manifest loader, U-Boot oem ucmd/acmd, monotonic timeouts, AVB-based vbmeta flag editing.