Skip to content
⚠
Traduction automatique

Cette page a été traduite automatiquement depuis l'anglais et peut contenir des erreurs ou des imprécisions techniques. En cas de doute, reportez-vous à la version anglaise ou russe. English · Русский

Vous avez repéré une erreur ? Les corrections sont les bienvenues.

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-firmware au 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 sur dev est 88.27.

Compiler le firmware ​

PageCe que vous y trouverez
Compiler le firmwareCloner, 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ériellesComment targets/ et target.json décrivent les variantes matérielles (f7, f18)
Compiler des applications sur AndroidCompiler des applications .fap sur un téléphone avec Termux + uFBT, sans PC

Écrire des applications ​

PageCe que vous y trouverez
Votre première application en CuFBT, 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 FuriArchitecture matérielle et logicielle, cœur Furi, furi_assert / furi_check
Interface graphique dans les applicationsBoîtes de dialogue, ViewPort, Views et Scenes, modules de vue
Déboguer les applicationsSondes SWD, débogage dans VS Code, signaux de débogage du HAL Furi
API FuriHalBusActiver / 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 à Unleashedsubghz, infrared, blebeacon, usbdisk, i2c, spi, vgm — absents du firmware d'origine comme de la documentation officielle

Travailler avec l'appareil ​

PageCe 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 OTAFonctionnement de l'updater, champs du manifeste, codes d'erreur [XX-YY], création de paquets
Format d'archive HeatshrinkLe conteneur .tar.hs utilisé pour les ressources des paquets de mise à jour
MatérielCaractéristiques techniques, schémas, modèles 3D, plans des modules et de la dev board

Tests ​

PageCe que vous y trouverez
Tests unitairesCompiler et exécuter l'application unit_tests sur l'appareil, ajouter vos propres tests
Tests d'intégrationLe plan de test manuel utilisé avant la fusion des PR et les releases

Autres ressources utiles ​

Structure du dépôt du firmware ​

DossierContenu
applicationsApplications et services utilisés dans le firmware
assetsRessources utilisées par les applications et services
furiFuri Core : primitives et utilitaires de niveau système
debugOutils de débogage : plugins GDB, fichier SVD, etc.
documentationSources de la documentation et configurations du générateur
firmwareCode source du firmware
libBibliothèques propres et tierces, pilotes
site_sconsUtilitaires de compilation
scriptsScripts complémentaires et bibliothèques Python
targetsDéfinitions des cibles matérielles (f7, f18)

Beaucoup de ces dossiers possèdent leur propre ReadMe.md — ils valent la lecture.

Sans lien avec Flipper Devices. Pour un usage pédagogique et légal uniquement.