Was ist das UF2-Dateiformat?
UF2 steht für USB Flashing Format, ein Dateiformat, das Microsoft 2017 für seine MakeCode (PXT)-Plattform entwickelt hat. Es wurde konzipiert, um Mikrocontroller über USB-Massenspeicher zu flashen: Das Board erscheint als gewöhnliches Wechselmedium, und Sie kopieren die Firmware wie jede andere Datei darauf. Die Spezifikation ist offen und wird von Microsoft unter einer MIT-Lizenz veröffentlicht.
Eine .uf2-Datei ist eine flache Sequenz von 512-Byte-Blöcken. Jeder Block ist in sich abgeschlossen - er trägt einen 32-Byte-Header mit Magic Numbers, der Ziel-Flash-Adresse, der Payload-Länge, dem Index und der Gesamtzahl des Blocks sowie einer Family-ID, die den Ziel-Chip identifiziert, gefolgt von bis zu 476 Bytes Firmware und einer abschließenden Magic Number. Dieses Design löst ein reales Problem: Ein Betriebssystem kann die Blöcke einer kopierten Datei in beliebiger Reihenfolge schreiben. Da jeder Block unabhängig ist, kann der Bootloader des Boards die Daten in dem Moment flashen, in dem sie ankommen, ohne jemals eine unvollständige Datei sehen zu müssen.
Die meisten Anwender begegnen UF2 beim Programmieren eines Hobby- oder Bildungs-Boards. Der Raspberry Pi Pico (RP2040), BBC micro:bit sowie viele Boards von Adafruit, Arduino und Seeed akzeptieren UF2, und so werden CircuitPython- und MakeCode-Projekte installiert. Normalerweise erhalten Sie eine .uf2, indem Sie sie aus einem Editor wie MakeCode exportieren oder eine vorgefertigte Firmware für Ihr exaktes Board herunterladen. Verwandte Firmware-Formate, die Ihnen begegnen könnten, sind rohe .BIN-Images und Intel .HEX-Dateien.
Sicherheit
RISIKO: MEDIUMA UF2 file is passive data and cannot run on your PC, but flashing firmware rewrites a board's program memory. Only flash a .uf2 that is built for your exact board, and only from a source you trust, since the wrong or malicious firmware can leave a board unusable until you reflash a known-good image.
Formatdetails
kurz gefasstProgramme zum Öffnen von UF2-Dateien
Windows4 apps
The board's UF2 bootloader (USB drive)
Integriert Put the board in bootloader mode so it appears as a USB drive, then drag the .uf2 file onto that drive.
Microsoft MakeCode
Kostenlos Build a project in MakeCode and use Download to export and flash a .uf2.
uf2conv.py (Microsoft UF2 tools)
Open Source Convert firmware with uf2conv.py firmware.bin -o firmware.uf2, or inspect a UF2 with uf2conv.py -i firmware.uf2.
Arduino IDE
Open Source Install the board package, then Upload to compile and flash via the UF2 bootloader. 
macOS2 apps
The board's UF2 bootloader (USB drive)
Integriert Drag the .uf2 file onto the removable drive the board presents in bootloader mode. 
Linux2 apps
The board's UF2 bootloader (USB drive)
Integriert Mount the board's USB drive and copy the .uf2 file onto it.
uf2conv.py (Microsoft UF2 tools)
Open Source Run python3 uf2conv.py firmware.bin -o firmware.uf2 to build or inspect UF2 files. Technische Details
technische Spezifikation| Encoding | binary |
| Byte order | little-endian (all 32-bit fields) |
| Container | flat sequence of independent 512-byte blocks |
| Typical size | a few KB to about 1 MB |
| Structure | A series of 512-byte blocks; each has a 32-byte header (magic numbers, target flash address, payload size, block index and count, family ID), up to 476 bytes of firmware payload, and a trailing magic number |
| Versioning | flags and 32-bit family-ID field identify the target chip (for example RP2040) |
| Integrity | three magic numbers per block (0x0A324655, 0x9E5D5157, 0x0AB16F30) validate each block; no CRC |
| Platforms | Windows, macOS, Linux, ChromeOS |
| Initial Release Full | 2017, with Microsoft MakeCode |
| Notes | You do not open a UF2 to view it; you copy it onto the board's USB drive to flash firmware. Because each 512-byte block is self-contained, the operating system can write the blocks in any order and the bootloader still flashes correctly. |
| Veröffentlicht | 2017 (Microsoft MakeCode / PXT) |
| Offener Standard | Ja · lizenzgebührenfrei |
| Spezifikation | github.com |
UF2-Konvertierungen
Community Q&A
von Nutzern gefragtNoch keine Fragen - stellen Sie die erste Frage zu UF2-Dateien.
Häufig gestellte Fragen
Wie öffne ich eine UF2-Datei?
.uf2-Datei auf dieses Laufwerk. Das Board flasht sie und startet neu.Wie versetze ich einen Raspberry Pi Pico in den Bootloader-Modus?
.uf2 darauf, und das Board startet mit der neuen Firmware neu.Kann ich eine UF2-Datei in BIN konvertieren?
uf2conv.py extrahiert die rohe Binärdatei mit uf2conv.py file.uf2 -c -o file.bin. Behalten Sie die im UF2-Header gespeicherte Flash-Adresse im Auge.
