Saltar al contenido principal
Flujos de trabajo prácticos para configurar proyectos, interactuar con hardware, escribir firmware, depurar y administrar sesiones. Cada sección incluye ejemplos de indicaciones que puede adaptar.

​
Iniciar un nuevo proyecto

1

Create or select a project

embedder
/project
Diálogo SELECCIONAR PROYECTO con cuadro de búsqueda que muestra el botón para crear un nuevo proyecto y la lista de proyectos anteriores
Elija un proyecto existente o cree uno nuevo.Embedder le pedirá que cree un nuevo proyecto automáticamente si no hay ningún proyecto asociado con el directorio en el que lo ejecuta, así que tenga en cuenta que no siempre es necesario ejecutar /project.
2

Choose a platform

Selecciona la plataforma que estás utilizando de nuestro catálogo o agrega la tuya propia.
Diálogo SELECCIONAR PLATAFORMA con cuadro de búsqueda que muestra las plataformas nRF9xxx de Nordic Semiconductor
Para agregar su propia plataforma, escriba el nombre de la plataforma y presione el botón + Add "[platform name]". Luego se le pedirá que cargue su documentación.
Diálogo SELECCIONAR PLATAFORMA que muestra el menú para cargar documentación en formato pdf
3

Add peripherals

Selecciona los periféricos que estás utilizando de nuestro catálogo o añade el tuyo propio.
Cuadro de diálogo SELECCIONAR PERIFÉRICOS con cuadro de búsqueda que muestra componentes de Analog Devices, Nexperia y Allegro MicroSystems
Seleccione los periféricos que está utilizando (sensores I2C, pantallas SPI, módulos UART, etc.).Puede agregar periféricos personalizados y cargar sus hojas de datos utilizando el mismo proceso descrito para las plataformas en el paso anterior.Ejecute /peripheral nuevamente en cualquier momento para agregar o modificar su configuración.
4

Generate EMBEDDER.md

embedder
/init
Crea un archivo EMBEDDER.md con el contexto, la configuración y más de su proyecto.
Para dispositivos no incluidos en el catálogo, cargue su propia documentación u hojas de datos a través de /peripheral o mediante la consola web (/console) para mejorar el rendimiento del agente.

​
Interacción de hardware

​
Utilice el monitor serie

El terminal serie está integrado directamente en Embedder. La IA lee la salida en serie automáticamente. Abra la barra lateral de serie:
Embedder
/serial
O utilice el método abreviado de teclado: Ctrl+` (comilla invertida) Comportamiento de conexión automática: De forma predeterminada, Embedder se conecta automáticamente a su dispositivo después de flashear Para desactivar la conexión automática, actualice su EMBEDDER.md o solicite:
Embedder
> don't auto-connect to serial after flashing
Filtrar salida en serie: Haga clic en [Filter] en la barra de herramientas en serie para filtrar la salida por patrón de expresiones regulares. Útil para aislar mensajes de registro específicos o errores de resultados ruidosos.
Filtro de terminal serie que muestra la salida de filtrado de patrones de expresiones regulares

​
Desarrollo de firmware

​
Escribir controladores periféricos

Embedder tiene contexto de sus hojas de datos y documentación. Pídale que busque pines, registre mapas y detalles de implementación de controladores cuando desarrolle controladores.
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.

​
Construir y flashear

Embedder utiliza la configuración de su proyecto para determinar las cadenas de herramientas y dependencias requeridas.
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

​
Trabajar con HAL y SDK

Pregunte acerca de los HAL y SDK específicos del proveedor:
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?

​
Depurar con salida en serie

Embedder lee la salida en serie y puede ayudar a analizar problemas en tiempo real.

​
Analizar errores

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

​
Ejecución de seguimiento

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

​
Modo de planificación versus modo de acción

Embedder tiene dos modos para diferentes flujos de trabajo.

​
Modo de acción (predeterminado)

Acceso completo a herramientas. Embedder puede leer, escribir y ejecutar. Usar para:
  • Escribir y modificar código.
  • Creación y actualización de firmware.
  • Realizar cambios en su proyecto.

​
Modo de planificación

Análisis de solo lectura. Embedder investiga sin realizar cambios. Usar para:
  • Planificación de refactorizaciones complejas.
  • Revisión de arquitectura antes de cambios.
  • Análisis de hojas de datos.
Alternar entre modos:
  • Teclado: Shift+Tab
  • Comandos: /plan o /act
Iniciar en modo plan:
Embedder
> /plan
> analyze the power management implementation and suggest improvements
El modo de planificación es ideal para planificar cambios complejos antes de su implementación.

​
Documentación y contexto

​
Aprovechar la documentación cargada

Las plataformas y periféricos elegidos de nuestro catálogo ya tienen la documentación subida. Puede cargar más documentos a través de la consola web a la que se puede acceder mediante /console.
Aplicación web que muestra un lugar para cargar la documentación de su proyecto
Embedder los usará automáticamente:
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?

​
Asistencia basada en hardware

Haga preguntas específicas de hardware sobre su placa:
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?

​
modo bash

Omita el agente AI y ejecute comandos del terminal directamente usando el prefijo !. 
!ls -la

!make clean

!git status
Esto ejecuta el comando en su terminal sin interpretación de IA. Útil para comandos rápidos cuando no necesitas ayuda de IA.

​
Modo de envío en serie

Envíe mensajes directamente a su MCU a través de serie usando el prefijo ~.
embedder
~help
embedder
~reset
embedder
~get status
Esto envía el texto directamente a la consola serie de su dispositivo. Usar para:
  • Envío de comandos AT
  • Interactuar con el dispositivo CLI/REPL
  • Comandos de depuración manual

​
Archivos y directorios de referencia

Utilice @ para incluir rápidamente archivos o directorios en sus indicaciones.
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
Las rutas de los archivos pueden ser relativas o absolutas. Las referencias a directorios muestran listados de archivos, no contenidos.

​
Gestión de sesiones

​
Cambiar de proyecto

Embedder
/project    # Switch to a different project

​
Reanudar sesiones anteriores

Embedder
/history    # Browse and resume past conversations

​
Administrar contexto

Para conversaciones largas:
Embedder
/compress   # Compress conversation to save context

​
Referencia rápida

Flujo de trabajoComando/Atajo
Configuración de nuevo proyecto/project → /peripheral → /init
Monitor serie/serial o Ctrl+`
Modo de cambioShift+Tab o /plan /act
Añadir periférico/peripheral
Archivo de referencia@filename en aviso
Modo bash!command (por ejemplo, !ls)
Envío en serie~message (por ejemplo, ~help)
Deshacer último mensaje/undo o Ctrl+Z ​​
Rebobinar conversación/rewind o Ctrl+Z (2x)
Reanudar sesión/history
Comprimir contexto/compress
Consola web/console
Obtener ayuda/help
Last modified on March 5, 2026