Passer au contenu principal

​
Avant de commencer

Assurez-vous d’avoir :
  • Une application terminal (voir recommandations ci-dessous)
  • Un projet de firmware avec lequel travailler (ou en démarrer un nouveau)

​
Terminaux recommandés

Ghostty pour la meilleure expérience sur macOS et Linux.macOS (Homebrew) :
brew install --cask ghostty
Linux :
# See https://ghostty.org/docs/install for distribution-specific instructions

​
Étape 1 : Installer et lancer Embedder

Pour installer Embedder, utilisez l’une des méthodes suivantes : 
curl -fsSL https://embedder.com/install | bash
Les installations natives se mettent automatiquement à jour en arrière-plan pour vous permettre de disposer de la dernière version.
Pour lancer embedder, exécutez embedder dans le répertoire de vos projets : 
cd your-project
embedder

​
Étape 2 : Connectez-vous à votre compte

Embedder nécessite un compte pour être utilisé. Lorsque vous démarrez une session interactive avec la commande embedder, vous devrez vous connecter : 
embedder
# You'll be prompted to log in on first use
Suivez les invites pour vous connecter avec votre compte. Si l’application Web ne s’ouvre pas automatiquement, cliquez sur le lien sur votre écran. Une fois connecté, vos identifiants sont stockés et vous n’aurez plus besoin de vous reconnecter. Pour changer de compte ultérieurement, utilisez la commande /logout.

​
Étape 3 : Démarrez votre première session

Ouvrez votre terminal dans n’importe quel répertoire de projet et démarrez Embedder : 
cd /path/to/your/project
embedder
Vous verrez l’écran de sélection du projet Embedder.

​
Créer un projet

Boîte de dialogue SÉLECTIONNER UN PROJET avec zone de recherche affichant le bouton Créer un nouveau projet et la liste des projets précédents

​
Sélectionnez votre plateforme

Après le démarrage, Embedder vous invite à sélectionner votre plate-forme matérielle. Utilisez le champ de recherche pour filtrer les plates-formes, puis utilisez les touches fléchées pour naviguer et appuyez sur Entrée pour sélectionner.
Boîte de dialogue SÉLECTIONNER UNE PLATEFORME avec champ de recherche affichant les plates-formes nRF9xxx de Nordic Semiconductor
Sélectionnez la plateforme qui correspond à votre matériel. Embedder utilise la documentation officielle de votre plate-forme pour ancrer sa génération de code et ses réponses. Pour ajouter des plates-formes personnalisées, voir [flows courants] (§§U77§§).

​
Sélectionnez vos périphériques

Après avoir sélectionné votre plateforme, Embedder vous invite à configurer vos périphériques. Cette étape vous permet de spécifier les composants externes utilisés par votre projet.
Boîte de dialogue SÉLECTIONNER LES PÉRIPHÉRIQUES avec zone de recherche affichant les composants d'Analog Devices, Nexperia et Allegro MicroSystems
Utilisez la zone de recherche pour rechercher des composants spécifiques, puis utilisez les touches fléchées pour naviguer et appuyez sur Espace pour basculer les sélections. Appuyez sur Entrée lorsque vous avez terminé de configurer vos périphériques. Pour ajouter des périphériques personnalisés, voir [flux de travail courants] (§§U79§§).
Vous pourrez modifier ultérieurement la configuration de vos périphériques à l’aide de la commande /peripherals.

​
Étape 4 : Posez votre première question

Une fois votre plateforme et vos périphériques configurés, vous pouvez poser des questions spécifiques au matériel en langage naturel. Embedder référence automatiquement les fiches techniques, les manuels de référence et les errata pertinents. Si un appareil est connecté, il lit également la sortie série en temps réel. Essayez de poser des questions sur votre matériel : 
tell me about the nrf9151 gps capabilities
Interface d'intégration affichant une invite sur les capacités GPS du nRF9151, les résultats de la recherche de documents avec le tableau des exigences matérielles et le moniteur série affichant les informations satellite
Embedder présente la documentation pertinente, y compris la configuration matérielle requise, les configurations de broches et les spécifications de synchronisation. Le moniteur série affiche la sortie en temps réel de votre appareil connecté. Vous pouvez également poser des questions sur votre base de code : 
what does this project do?

where is the main entry point?

explain the folder structure
Embedder lit vos fichiers et fiches techniques selon vos besoins - vous n’avez pas besoin d’ajouter manuellement du contexte.

​
Étape 5 : Effectuez votre premier changement de code

Laissons maintenant Embedder générer du firmware. Essayez une tâche simple : 
add a function to toggle the LED on GPIO pin 13
L’intégrateur :
  1. Trouvez le fichier approprié
  2. Lisez les définitions de registre pertinentes dans la fiche technique
  3. Montrez-vous les modifications proposées avec des citations
  4. Demandez votre approbation
  5. Effectuez le changement
Embedder demande toujours la permission avant de modifier des fichiers, sauf indication contraire.

​
Étape 6 : Utiliser Git avec Embedder

Embedder rend les opérations Git conversationnelles : 
what files have I changed?

commit my changes with a descriptive message
Vous pouvez également demander des opérations Git plus complexes : 
create a new branch called feature/uart-driver

show me the last 5 commits

help me resolve merge conflicts

​
Étape 7 : Corriger un bug ou ajouter une fonctionnalité

Décrivez le problème que vous rencontrez et Embedder vous aidera à le déboguer : 
my SPI peripheral isn't responding - help me debug
Ou collez une erreur : 
I'm getting a hard fault when I call HAL_UART_Transmit - why?
L’intégrateur :
  • Vérifiez votre code par rapport à la fiche technique
  • Recherchez les erreurs de configuration courantes
  • Croisement des errata connus pour votre MCU
  • Proposer et tester des correctifs

​
Étape 8 : Testez d’autres workflows courants

Il existe plusieurs façons de travailler avec Embedder : Écrivez un pilote 
write an I2C driver for the BME280 temperature sensor
Configurer un périphérique 
set up PWM on Timer 2 with a 1kHz frequency
Générer le code d’initialisation 
initialize the ADC for 12-bit resolution on channel 5
Porter le code vers une nouvelle plateforme 
help me port this STM32 driver to nRF52
Voir flux de travail courants pour plus d’informations.
Rappelez-vous : Embedder comprend votre matériel. Posez-lui des questions comme vous le feriez avec un ingénieur de micrologiciel expérimenté qui a mémorisé la fiche technique.

​
Conseils de pro pour les débutants

Au lieu de : “configurer la minuterie”Essayez : “configurer la minuterie 3 pour un intervalle d’interruption de 10 ms en utilisant l’horloge HSI de 16 MHz”
Divisez les tâches complexes en étapes :
1. initialize the SPI peripheral at 1MHz
2. write a function to read a register from the accelerometer
3. add a function to configure the accelerometer for ±2g range
Avant d’apporter des modifications, laissez Embedder comprendre votre code :
analyze my clock configuration

what's the current interrupt priority setup?
Voir meilleures pratiques pour plus de conseils.

​
Quelle est la prochaine étape ?

Continuez avec les [Meilleures pratiques] (§§U83§§) pour obtenir des conseils pour obtenir les meilleurs résultats, ou avec les [Flux de travail courants] (§§U84§§) pour des exemples pratiques.

​
Obtenir de l’aide

  • Dans Embedder : Tapez /help ou demandez “comment puis-je…”
  • Documentation : parcourez nos guides pour des informations détaillées
  • Communauté : rejoignez notre communauté Discord pour obtenir des conseils et de l’aide
Last modified on March 5, 2026