Développement
Cette section s'adresse à ceux qui veulent aller plus loin que l'utilisation du Flipper : compiler le firmware Unleashed depuis les sources, écrire leurs propres applications en C ou en JavaScript, les déboguer sur du matériel réel, dialoguer avec l'appareil en ligne de commande, ou comprendre le fonctionnement interne des mises à jour et du matériel.
Unleashed
Unleashed est un fork du firmware officiel qui reste entièrement compatible avec l'API et les applications officielles. Presque tout ce que dit la documentation développeur officielle s'applique tel quel. Les points principaux à retenir :
- clonez
https://github.com/DarkFlippers/unleashed-firmwareau lieu du dépôt officiel ; - lorsque vous compilez des applications avec uFBT, pointez-le vers le SDK Unleashed (
--index-url=https://up.unleashedflip.com/directory.json), sinon votre application est compilée contre le SDK officiel et peut refuser de se charger (détails) ; - l'origine du firmware est signalée comme
Unleashed, la version d'API actuelle surdevest 88.27.
Compiler le firmware
| Page | Ce que vous y trouverez |
|---|---|
| Compiler le firmware | Cloner, compiler et flasher Unleashed sous Linux, macOS et Windows |
| Flipper Build Tool (fbt) | Toutes les cibles, options et variables d'environnement de fbt |
| Cibles matérielles | Comment targets/ et target.json décrivent les variantes matérielles (f7, f18) |
| Compiler des applications sur Android | Compiler des applications .fap sur un téléphone avec Termux + uFBT, sans PC |
Écrire des applications
| Page | Ce que vous y trouverez |
|---|---|
| Votre première application en C | uFBT, modèle d'application, « Hello world » avec une boîte de dialogue, compilation et exécution |
| Manifestes d'application (.fam) | Tous les champs d'application.fam, les options des applications externes, les bibliothèques privées |
| API Furi | Architecture matérielle et logicielle, cœur Furi, furi_assert / furi_check |
| Interface graphique dans les applications | Boîtes de dialogue, ViewPort, Views et Scenes, modules de vue |
| Déboguer les applications | Sondes SWD, débogage dans VS Code, signaux de débogage du HAL Furi |
| API FuriHalBus | Activer / désactiver correctement les périphériques du MCU, carte des canaux DMA |
| JavaScript sur le Flipper | Écrire des scripts en JavaScript plutôt qu'en C (groupe de pages distinct) |
| Modules JS propres à Unleashed | subghz, infrared, blebeacon, usbdisk, i2c, spi, vgm — absents du firmware d'origine comme de la documentation officielle |
Travailler avec l'appareil
| Page | Ce que vous y trouverez |
|---|---|
| Interface en ligne de commande (CLI) | Se connecter via le port série USB ; toutes les commandes du CLI et leurs arguments |
| Mises à jour OTA | Fonctionnement de l'updater, champs du manifeste, codes d'erreur [XX-YY], création de paquets |
| Format d'archive Heatshrink | Le conteneur .tar.hs utilisé pour les ressources des paquets de mise à jour |
| Matériel | Caractéristiques techniques, schémas, modèles 3D, plans des modules et de la dev board |
Tests
| Page | Ce que vous y trouverez |
|---|---|
| Tests unitaires | Compiler et exécuter l'application unit_tests sur l'appareil, ajouter vos propres tests |
| Tests d'intégration | Le plan de test manuel utilisé avant la fusion des PR et les releases |
Autres ressources utiles
- Documentation développeur officielle (Doxygen) : developer.flipper.net — c'est là qu'on cherche les API du firmware que ce wiki ne couvre pas : programmation système, développement d'applications, JavaScript, modules d'extension, formats de fichiers
- Configuration d'un espace de travail CLion — guide de Savely Krasovsky
- Tutoriels de plugin « Hello world! » : en anglais (DroomOne), en russe (Pavel Yakovlev)
- Comment écrire votre propre application
Structure du dépôt du firmware
| Dossier | Contenu |
|---|---|
applications | Applications et services utilisés dans le firmware |
assets | Ressources utilisées par les applications et services |
furi | Furi Core : primitives et utilitaires de niveau système |
debug | Outils de débogage : plugins GDB, fichier SVD, etc. |
documentation | Sources de la documentation et configurations du générateur |
firmware | Code source du firmware |
lib | Bibliothèques propres et tierces, pilotes |
site_scons | Utilitaires de compilation |
scripts | Scripts complémentaires et bibliothèques Python |
targets | Définitions des cibles matérielles (f7, f18) |
Beaucoup de ces dossiers possèdent leur propre ReadMe.md — ils valent la lecture.
