Skip to content
⚠
Traduzione automatica

Questa pagina è stata tradotta automaticamente dall'inglese e può contenere errori o imprecisioni tecniche. In caso di dubbio consulta la versione inglese o russa. English · Русский

Hai trovato un errore? I contributi sono benvenuti.

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-firmware invece 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 su dev è 88.27.

Compilare il firmware ​

PaginaCosa ci trovi
Compilare il firmwareClonare, 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 hardwareCome targets/ e target.json descrivono le varianti hardware (f7, f18)
Compilare app su AndroidCompilare app .fap su un telefono con Termux + uFBT, senza PC

Scrivere app ​

PaginaCosa ci trovi
La tua prima app in CuFBT, 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 FuriArchitettura hardware e software, il core Furi, furi_assert / furi_check
GUI nelle appDialogs, ViewPort, Views e Scenes, moduli di view
Debug delle appSonde SWD, debug in VS Code, segnali di debug di Furi HAL
API FuriHalBusAttivare/disattivare correttamente le periferiche dell'MCU, mappa dei canali DMA
JavaScript sul FlipperScrivere script in JavaScript invece che in C (gruppo di pagine a parte)
Moduli JS solo di Unleashedsubghz, infrared, blebeacon, usbdisk, i2c, spi, vgm — non ci sono né nel firmware di serie né nella documentazione ufficiale

Lavorare con il dispositivo ​

PaginaCosa ci trovi
Interfaccia a riga di comando (CLI)Collegarsi via seriale USB; tutti i comandi CLI con i relativi argomenti
Aggiornamenti OTACome funziona l'updater, campi del manifest, codici di errore [XX-YY], creazione dei pacchetti
Formato tarball heatshrinkIl contenitore .tar.hs usato per le risorse nei pacchetti di aggiornamento
HardwareSpecifiche tecniche, schemi, modelli 3D, disegni di moduli e devboard

Test ​

PaginaCosa ci trovi
Unit testCompilare ed eseguire l'app unit_tests sul dispositivo, aggiungere test propri
Test di integrazioneIl piano di test manuale usato prima di integrare PR e release

Altre risorse utili ​

Struttura del repository del firmware ​

CartellaContenuto
applicationsApplicazioni e servizi usati nel firmware
assetsAsset usati da applicazioni e servizi
furiFuri Core: primitive e utilità a livello di sistema operativo
debugStrumenti di debug: plugin GDB, file SVD, ecc.
documentationSorgenti della documentazione e configurazioni dei generatori
firmwareCodice sorgente del firmware
libLibrerie proprie e di terze parti, driver
site_sconsUtilità per la compilazione
scriptsScript accessori e librerie Python
targetsDefinizioni dei target hardware (f7, f18)

Molte di queste cartelle hanno un proprio ReadMe.md — vale la pena leggerlo.

Non affiliato a Flipper Devices. Solo per uso didattico e lecito.