Entwicklung
Dieser Abschnitt richtet sich an alle, die mehr wollen, als den Flipper nur zu benutzen: die Unleashed Firmware aus dem Quellcode bauen, eigene Apps in C oder JavaScript schreiben, sie auf echter Hardware debuggen, über die Kommandozeile mit dem Gerät sprechen oder verstehen, wie Updates und die Hardware intern funktionieren.
Unleashed
Unleashed ist ein Fork der offiziellen Firmware, der vollständig kompatibel zur offiziellen API und zu den offiziellen Apps bleibt. Nahezu alles aus der offiziellen Entwicklerdokumentation gilt unverändert. Die wichtigsten Punkte, die du dir merken solltest:
- klone
https://github.com/DarkFlippers/unleashed-firmwarestatt des offiziellen Repositorys; - wenn du Apps mit uFBT baust, richte es auf das Unleashed-SDK aus (
--index-url=https://up.unleashedflip.com/directory.json), sonst wird deine App gegen das offizielle SDK gebaut und lädt möglicherweise nicht (Details); - die Firmware-Herkunft wird als
Unleashedgemeldet, die aktuelle API-Version aufdevist 88.27.
Die Firmware bauen
| Seite | Was du bekommst |
|---|---|
| Die Firmware bauen | Unleashed unter Linux, macOS und Windows klonen, bauen und flashen |
| Flipper Build Tool (fbt) | Jedes fbt-Target, jede Option und jede Umgebungsvariable |
| Hardware-Targets | Wie targets/ und target.json Hardwarevarianten beschreiben (f7, f18) |
| Apps unter Android bauen | .fap-Apps auf dem Smartphone mit Termux + uFBT kompilieren, ohne PC |
Apps schreiben
| Seite | Was du bekommst |
|---|---|
| Deine erste App in C | uFBT, App-Vorlage, "Hello world" mit einem Dialog, bauen und ausführen |
| App-Manifeste (.fam) | Alle Felder von application.fam, Optionen für externe Apps, private Bibliotheken |
| Furi-API | Hardware- und Softwarearchitektur, Furi-Kern, furi_assert / furi_check |
| GUI in Apps | Dialoge, ViewPort, Views & Scenes, View-Module |
| Apps debuggen | SWD-Probes, Debugging in VS Code, Debug-Signale des Furi HAL |
| FuriHalBus-API | MCU-Peripherie korrekt ein- und ausschalten, DMA-Kanalbelegung |
| JavaScript auf dem Flipper | Skripte in JavaScript statt in C schreiben (eigene Seitengruppe) |
| JS-Module nur in Unleashed | subghz, infrared, blebeacon, usbdisk, i2c, spi, vgm — nicht in der Stock-Firmware, nicht in der offiziellen Dokumentation |
Mit dem Gerät arbeiten
| Seite | Was du bekommst |
|---|---|
| Kommandozeile (CLI) | Über USB-Serial verbinden; jeder CLI-Befehl mit seinen Argumenten |
| OTA-Updates | Wie der Updater arbeitet, Manifestfelder, [XX-YY]-Fehlercodes, Pakete bauen |
| Heatshrink-Tarball-Format | Der .tar.hs-Container für Ressourcen in Update-Paketen |
| Hardware | Technische Daten, Schaltpläne, 3D-Modelle, Zeichnungen von Modulen und Devboards |
Testen
| Seite | Was du bekommst |
|---|---|
| Unit-Tests | Die App unit_tests auf dem Gerät bauen und ausführen, eigene Tests ergänzen |
| Integrationstests | Der manuelle Testplan, der vor dem Mergen von PRs und vor Releases durchlaufen wird |
Weitere nützliche Ressourcen
- Offizielle Entwicklerdokumentation (Doxygen): developer.flipper.net — hier schlägst du Firmware-APIs nach, die dieses Wiki nicht abdeckt, mit Abschnitten zu Systemprogrammierung, App-Entwicklung, JavaScript, Erweiterungsmodulen und Dateiformaten
- Einrichtung eines CLion-Workspace — Anleitung von Savely Krasovsky
- "Hello world!"-Plugin-Tutorials: Englisch (DroomOne), Russisch (Pavel Yakovlev)
- Wie du deine eigene App schreibst
Projektstruktur des Firmware-Repositorys
| Ordner | Inhalt |
|---|---|
applications | Anwendungen und Dienste, die in der Firmware verwendet werden |
assets | Assets, die von Anwendungen und Diensten verwendet werden |
furi | Furi Core: Primitive und Hilfsfunktionen auf Betriebssystemebene |
debug | Debug-Werkzeuge: GDB-Plugins, SVD-Datei usw. |
documentation | Dokumentationsquellen und Generator-Konfigurationen |
firmware | Quellcode der Firmware |
lib | Eigene und Drittanbieter-Bibliotheken, Treiber |
site_scons | Build-Hilfsfunktionen |
scripts | Ergänzende Skripte und Python-Bibliotheken |
targets | Definitionen der Hardware-Targets (f7, f18) |
Viele dieser Ordner haben ihre eigene ReadMe.md — die Lektüre lohnt sich.
