Passer au contenu principal
Flux de travail pratiques pour configurer des projets, interagir avec le matériel, écrire un micrologiciel, déboguer et gérer des sessions. Chaque section comprend des exemples d’invites que vous pouvez adapter.

​
Démarrer un nouveau projet

1

Create or select a project

embedder
/project
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
Choisissez un projet existant ou créez-en un nouveau.Embedder vous demandera de créer automatiquement un nouveau projet si aucun projet n’est associé au répertoire dans lequel vous l’exécutez, notez donc que l’exécution de /project n’est pas toujours nécessaire.
2

Choose a platform

Sélectionnez la plateforme que vous utilisez dans notre catalogue ou ajoutez la vôtre.
Boîte de dialogue SÉLECTIONNER UNE PLATEFORME avec champ de recherche affichant les plates-formes nRF9xxx de Nordic Semiconductor
Pour ajouter votre propre plateforme, saisissez le nom de la plateforme et appuyez sur le bouton + Add "[platform name]". Vous serez ensuite invité à télécharger votre documentation.
Boîte de dialogue SÉLECTIONNER LA PLATEFORME affichant le menu pour télécharger la documentation au format PDF
3

Add peripherals

Sélectionnez les périphériques que vous utilisez dans notre catalogue ou ajoutez les vôtres.
Boîte de dialogue SÉLECTIONNER LES PÉRIPHÉRIQUES avec zone de recherche affichant les composants d'Analog Devices, Nexperia et Allegro MicroSystems
Sélectionnez les périphériques que vous utilisez (capteurs I2C, écrans SPI, modules UART, etc.).Vous pouvez ajouter des périphériques personnalisés et télécharger leurs fiches techniques en utilisant le même processus décrit pour les plates-formes à l’étape précédente.Exécutez à nouveau /peripheral à tout moment pour ajouter ou modifier votre configuration.
4

Generate EMBEDDER.md

embedder
/init
Crée un fichier EMBEDDER.md avec le contexte, la configuration et plus encore de vos projets.
Pour les appareils non inclus dans le catalogue, téléchargez votre propre documentation ou fiches techniques via le /peripheral ou via la console web (/console) pour améliorer les performances de l’agent.

​
Interaction matérielle

​
Utiliser le moniteur série

Le terminal série est intégré directement dans Embedder. L’IA lit automatiquement la sortie série. Ouvrez la barre latérale série :
Embedder
/serial
Ou utilisez le raccourci clavier : Ctrl+` (backtick) Comportement de connexion automatique : Par défaut, Embedder se connecte automatiquement à votre appareil après avoir flashé Pour désactiver la connexion automatique, mettez à jour votre EMBEDDER.md ou votre invite :
Embedder
> don't auto-connect to serial after flashing
Filtrer la sortie série : Cliquez sur [Filter] dans la barre d’outils série pour filtrer la sortie par modèle d’expression régulière. Utile pour isoler des messages de journal ou des erreurs spécifiques d’une sortie bruyante.
Filtre de terminal série affichant la sortie de filtrage de modèle regex

​
Développement du micrologiciel

​
Écrire des pilotes de périphériques

Embedder a le contexte de vos fiches techniques et de votre documentation. Demandez-lui de rechercher les brochages, d’enregistrer les cartes et les détails d’implémentation des pilotes lors du développement des pilotes.
Embedder
> write an I2C driver for the BME280 sensor on I2C1 (SDA=PB7, SCL=PB6).
> include functions for reading temperature, humidity, and pressure.
> use the existing HAL_I2C functions in our codebase.
Embedder
> create a UART driver for GPS module on UART2 at 9600 baud.
> implement a ring buffer for RX, parse NMEA sentences, and extract lat/long coordinates.
Embedder
> implement SPI driver for the SD card module on SPI1.
> include initialization, single block read/write, and proper CS pin handling on PA4.

​
Construire et flasher

Embedder utilise la configuration de votre projet pour déterminer les chaînes d’outils et les dépendances requises.
1

Install dependencies

Embedder
> help me install the dependencies for this project
2

Build the project

Embedder
> build the project
3

Flash the firmware

Embedder
> flash the firmware to the device
4

Build, flash, and monitor

Embedder
> build and flash, then show me the serial output

​
Travailler avec les HAL et les SDK

Renseignez-vous sur les HAL et SDK spécifiques au fournisseur :
Embedder
> how do I configure the STM32 HAL for I2C?
Embedder
> show me how to use the ESP-IDF GPIO driver
Embedder
> what's the correct way to initialize DMA on this chip?

​
Débogage avec sortie série

Embedder lit la sortie série et peut aider à analyser les problèmes en temps réel.

​
Analyser les erreurs

Embedder
> what's causing this error in the serial output?
Embedder
> the device keeps resetting, analyze the crash dump
Embedder
> parse the debug logs and find the issue

​
Exécution du suivi

Embedder
> add debug prints to trace the initialization sequence
Embedder
> why isn't the interrupt handler being called?

​
Mode Plan vs mode Acte

Embedder dispose de deux modes pour différents flux de travail.

​
Mode Acte (par défaut)

Accès complet aux outils. Embedder peut lire, écrire et exécuter. Utiliser pour :
  • Rédaction et modification de code
  • Construction et flashage du firmware
  • Apporter des modifications à votre projet

​
Mode Planification

Analyse en lecture seule. Intégrez des recherches sans apporter de modifications. Utiliser pour :
  • Planification de refactors complexes
  • Revoir l’architecture avant les changements
  • Analyser les fiches techniques
Basculer entre les modes :
  • Clavier : Shift+Tab
  • Commandes : /plan ou /act
Démarrer en mode plan :
Embedder
> /plan
> analyze the power management implementation and suggest improvements
Le mode Planification est idéal pour planifier des changements complexes avant leur mise en œuvre.

​
Documentation et contexte

​
Tirer parti de la documentation téléchargée

Les plateformes et périphériques choisis dans notre catalogue disposent déjà d’une documentation téléchargée. Vous pouvez télécharger davantage de documents via la console Web accessible via le /console.
Application Web montrant un endroit pour télécharger la documentation de votre projet
Embedder les utilisera automatiquement :
Embedder
> what's the maximum I2C clock speed for this sensor?
Embedder
> show me the register map for the accelerometer
Embedder
> what are the power consumption specs in sleep mode?

​
Assistance adaptée au matériel

Posez des questions spécifiques au matériel sur votre carte :
Embedder
> what switch position on the stm32n6570-dk enables flash mode?
Embedder
> what's the pin mapping for the Arduino header?
Embedder
> can I use DMA with this UART peripheral?

​
Mode bash

Contournez l’agent AI et exécutez les commandes du terminal directement en utilisant le préfixe !. 
!ls -la

!make clean

!git status
Cela exécute la commande dans votre terminal sans interprétation de l’IA. Utile pour les commandes rapides lorsque vous n’avez pas besoin de l’aide de l’IA.

​
Mode d’envoi série

Envoyez des messages directement à votre MCU via série en utilisant le préfixe ~.
embedder
~help
embedder
~reset
embedder
~get status
Cela envoie le texte directement à la console série de votre appareil. Utiliser pour :
  • Envoi de commandes AT
  • Interagir avec l’appareil CLI/REPL
  • Commandes de débogage manuel

​
Fichiers et répertoires de référence

Utilisez @ pour inclure rapidement des fichiers ou des répertoires dans vos invites.
1

Reference a file

Embedder
> explain the logic in @src/main.c
Embedder
> what does @drivers/i2c.h do?
2

Reference a directory

Embedder
> what's in @src/drivers/?
Embedder
> show me the structure of @lib/
3

Multiple references

Embedder
> compare @src/old_driver.c and @src/new_driver.c
Les chemins de fichiers peuvent être relatifs ou absolus. Les références de répertoire affichent la liste des fichiers, pas leur contenu.

​
Gestion des sessions

​
Changer de projet

Embedder
/project    # Switch to a different project

​
Reprendre les sessions précédentes

Embedder
/history    # Browse and resume past conversations

​
Gérer le contexte

Pour les longues conversations :
Embedder
/compress   # Compress conversation to save context

​
Référence rapide

Flux de travailCommande/Raccourci
Mise en place d’un nouveau projet/project → /peripheral → /init
Moniteur série/serial ou Ctrl+`
Mode de commutationShift+Tab ou /plan /act
Ajouter un périphérique/peripheral
Fichier de référence@filename dans l’invite
Mode bash!command (par exemple, !ls)
Envoi série~message (par exemple, ~help)
Annuler le dernier message/undo ou Ctrl+Z ​​
Rembobiner la conversation/rewind ou Ctrl+Z (2x)
Reprise de la séance/history
Compresser le contexte/compress
Console Web/console
Obtenir de l’aide/help
Last modified on March 5, 2026