Sviluppo
Questa sezione è destinata a chi vuole andare oltre il semplice uso del Flipper: compilare il firmware Unleashed dai sorgenti, scrivere app proprie in C o in JavaScript, eseguirne il debug su hardware reale, dialogare con il dispositivo dalla riga di comando o capire come funzionano aggiornamenti e hardware sotto il cofano.
Unleashed
Unleashed è un fork del firmware ufficiale che resta pienamente compatibile con le API e le app ufficiali. Quasi tutto quello che si trova nella documentazione ufficiale per sviluppatori si applica senza modifiche. Le cose principali da ricordare:
- clona
https://github.com/DarkFlippers/unleashed-firmwareinvece del repository ufficiale; - quando compili app con uFBT, puntalo all'SDK Unleashed (
--index-url=https://up.unleashedflip.com/directory.json), altrimenti la tua app verrà compilata contro l'SDK ufficiale e potrebbe rifiutare di caricarsi (dettagli); - l'origine del firmware è riportata come
Unleashed, la versione corrente delle API sudevè 88.27.
Compilare il firmware
| Pagina | Cosa ci trovi |
|---|---|
| Compilare il firmware | Clonare, compilare e flashare Unleashed su Linux, macOS e Windows |
| Flipper Build Tool (fbt) | Tutti i target, le opzioni e le variabili d'ambiente di fbt |
| Target hardware | Come targets/ e target.json descrivono le varianti hardware (f7, f18) |
| Compilare app su Android | Compilare app .fap su un telefono con Termux + uFBT, senza PC |
Scrivere app
| Pagina | Cosa ci trovi |
|---|---|
| La tua prima app in C | uFBT, template dell'app, "Hello world" con una finestra di dialogo, compilazione ed esecuzione |
| Manifest delle app (.fam) | Tutti i campi di application.fam, opzioni per le app esterne, librerie private |
| API Furi | Architettura hardware e software, il core Furi, furi_assert / furi_check |
| GUI nelle app | Dialogs, ViewPort, Views e Scenes, moduli di view |
| Debug delle app | Sonde SWD, debug in VS Code, segnali di debug di Furi HAL |
| API FuriHalBus | Attivare/disattivare correttamente le periferiche dell'MCU, mappa dei canali DMA |
| JavaScript sul Flipper | Scrivere script in JavaScript invece che in C (gruppo di pagine a parte) |
| Moduli JS solo di Unleashed | subghz, infrared, blebeacon, usbdisk, i2c, spi, vgm — non ci sono né nel firmware di serie né nella documentazione ufficiale |
Lavorare con il dispositivo
| Pagina | Cosa ci trovi |
|---|---|
| Interfaccia a riga di comando (CLI) | Collegarsi via seriale USB; tutti i comandi CLI con i relativi argomenti |
| Aggiornamenti OTA | Come funziona l'updater, campi del manifest, codici di errore [XX-YY], creazione dei pacchetti |
| Formato tarball heatshrink | Il contenitore .tar.hs usato per le risorse nei pacchetti di aggiornamento |
| Hardware | Specifiche tecniche, schemi, modelli 3D, disegni di moduli e devboard |
Test
| Pagina | Cosa ci trovi |
|---|---|
| Unit test | Compilare ed eseguire l'app unit_tests sul dispositivo, aggiungere test propri |
| Test di integrazione | Il piano di test manuale usato prima di integrare PR e release |
Altre risorse utili
- Documentazione ufficiale per sviluppatori (Doxygen): developer.flipper.net — è lì che si cercano le API del firmware che questa wiki non copre: programmazione di sistema, sviluppo di app, JavaScript, moduli di espansione, formati dei file
- Configurazione di un workspace CLion — guida di Savely Krasovsky
- Tutorial per un plugin "Hello world!": in inglese (DroomOne), in russo (Pavel Yakovlev)
- Come scrivere la propria app
Struttura del repository del firmware
| Cartella | Contenuto |
|---|---|
applications | Applicazioni e servizi usati nel firmware |
assets | Asset usati da applicazioni e servizi |
furi | Furi Core: primitive e utilità a livello di sistema operativo |
debug | Strumenti di debug: plugin GDB, file SVD, ecc. |
documentation | Sorgenti della documentazione e configurazioni dei generatori |
firmware | Codice sorgente del firmware |
lib | Librerie proprie e di terze parti, driver |
site_scons | Utilità per la compilazione |
scripts | Script accessori e librerie Python |
targets | Definizioni dei target hardware (f7, f18) |
Molte di queste cartelle hanno un proprio ReadMe.md — vale la pena leggerlo.
