Skip to main content

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) :
Linux :

Étape 1 : Installer et lancer Embedder

Pour installer Embedder, utilisez l’une des méthodes suivantes :
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 :

É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 :
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 :
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

Project selection interface

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

Platform selection interface showing Nordic Semiconductor options

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

Peripheral selection interface with components from various manufacturers

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 :
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 responding to a query about nRF9151 GPS capabilities with live serial output

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 :
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 :
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 :
Vous pouvez également demander des opérations Git plus complexes :

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

Décrivez le problème que vous rencontrez et Embedder vous aidera à le déboguer :
Ou collez une erreur :
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
Configurer un périphérique
Générer le code d’initialisation
Porter le code vers une nouvelle plateforme
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 :
Avant d’apporter des modifications, laissez Embedder comprendre votre code :
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
Dernière modification le 5 mars 2026