Saltar al contenido principal

​
Antes de comenzar

Asegúrate de tener:
  • Una aplicación de terminal (ver recomendaciones a continuación)
  • Un proyecto de firmware para trabajar (o iniciar uno nuevo)

​
Terminales recomendados

Ghostty para obtener la mejor experiencia en macOS y Linux.macOS (casero):
brew install --cask ghostty
Linux:
# See https://ghostty.org/docs/install for distribution-specific instructions

​
Paso 1: Instalar e iniciar Embedder

Para instalar Embedder, utilice uno de los siguientes métodos: 
curl -fsSL https://embedder.com/install | bash
Las instalaciones nativas se actualizan automáticamente en segundo plano para mantenerte con la última versión.
Para iniciar Embedder, ejecute embedder en su directorio de proyectos: 
cd your-project
embedder

​
Paso 2: Inicia sesión en tu cuenta

Embedder requiere una cuenta para su uso. Cuando inicia una sesión interactiva con el comando embedder, deberá iniciar sesión: 
embedder
# You'll be prompted to log in on first use
Siga las indicaciones para iniciar sesión con su cuenta. Si la aplicación web no se abre automáticamente, haga clic en el enlace en su pantalla. Una vez que haya iniciado sesión, sus credenciales se almacenarán y no necesitará iniciar sesión nuevamente. Para cambiar de cuenta más tarde, utilice el comando /logout.

​
Paso 3: Comienza tu primera sesión

Abra su terminal en cualquier directorio de proyecto e inicie Embedder: 
cd /path/to/your/project
embedder
Verá la pantalla de selección de proyectos de Embedder.

​
Creando un proyecto

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

​
Selecciona tu plataforma

Después de iniciar, Embedder le solicita que seleccione su plataforma de hardware. Utilice el cuadro de búsqueda para filtrar plataformas, luego utilice las teclas de flecha para navegar y presione Entrar para seleccionar.
Diálogo SELECCIONAR PLATAFORMA con cuadro de búsqueda que muestra las plataformas nRF9xxx de Nordic Semiconductor
Seleccione la plataforma que coincida con su hardware. Embedder utiliza la documentación oficial de su plataforma para basar la generación de código y las respuestas. Para agregar plataformas personalizadas, consulte flujos de trabajo comunes.

​
Selecciona tus periféricos

Después de seleccionar su plataforma, Embedder le solicita que configure sus periféricos. Este paso le permite especificar qué componentes externos utiliza su proyecto.
Cuadro de diálogo SELECCIONAR PERIFÉRICOS con cuadro de búsqueda que muestra componentes de Analog Devices, Nexperia y Allegro MicroSystems
Utilice el cuadro de búsqueda para encontrar componentes específicos, luego utilice las teclas de flecha para navegar y presione la barra espaciadora para alternar las selecciones. Presione Enter cuando haya terminado de configurar sus periféricos. Para agregar periféricos personalizados, consulte flujos de trabajo comunes.
Puede cambiar la configuración de su periférico más adelante utilizando el comando /peripherals.

​
Paso 4: Haz tu primera pregunta

Una vez que su plataforma y sus periféricos estén configurados, puede hacer preguntas específicas del hardware en lenguaje natural. Embedder hace referencia automáticamente a las hojas de datos, manuales de referencia y erratas relevantes. Si hay un dispositivo conectado, también lee la salida en serie en tiempo real. Intente preguntar sobre su hardware: 
tell me about the nrf9151 gps capabilities
Interfaz integrada que muestra un mensaje sobre las capacidades del GPS nRF9151, resultados de búsqueda de documentos con una tabla de requisitos de hardware y un monitor en serie que muestra información satelital
Embedder presenta documentación relevante, incluidos requisitos de hardware, configuraciones de pines y especificaciones de sincronización. El monitor serie muestra la salida en tiempo real desde su dispositivo conectado. También puedes preguntar sobre tu código base: 
what does this project do?

where is the main entry point?

explain the folder structure
Embedder lee sus archivos y hojas de datos según sea necesario; no es necesario agregar contexto manualmente.

​
Paso 5: Realiza tu primer cambio de código

Ahora hagamos que Embedder genere algo de firmware. Pruebe una tarea sencilla: 
add a function to toggle the LED on GPIO pin 13
El incrustador:
  1. Encuentre el archivo apropiado
  2. Lea las definiciones de registros relevantes de la hoja de datos.
  3. Mostrarte los cambios propuestos con citas.
  4. Pide tu aprobación 5.Haz el cambio
Embedder siempre solicita permiso antes de modificar archivos a menos que se indique lo contrario.

​
Paso 6: Usa Git con Embedder

Embedder hace que las operaciones de Git sean conversacionales: 
what files have I changed?

commit my changes with a descriptive message
También puede solicitar operaciones Git más complejas: 
create a new branch called feature/uart-driver

show me the last 5 commits

help me resolve merge conflicts

​
Paso 7: corregir un error o agregar una función

Describe el problema que estás viendo y Embedder te ayudará a depurarlo: 
my SPI peripheral isn't responding - help me debug
O pegue un error: 
I'm getting a hard fault when I call HAL_UART_Transmit - why?
El incrustador:
  • Verifique su código con la hoja de datos
  • Busque errores de configuración comunes
  • Referencia cruzada de erratas conocidas para su MCU
  • Sugerir y probar correcciones.

​
Paso 8: Pruebe otros flujos de trabajo comunes

Hay varias formas de trabajar con Embedder: Escribe un conductor 
write an I2C driver for the BME280 temperature sensor
Configurar un periférico 
set up PWM on Timer 2 with a 1kHz frequency
Generar código de inicialización 
initialize the ADC for 12-bit resolution on channel 5
Código de puerto a una nueva plataforma 
help me port this STM32 driver to nRF52
Consulte flujos de trabajo comunes para obtener más información.
Recuerde: Embedder comprende su hardware. Hágale preguntas de la misma manera que le haría a un ingeniero de firmware experimentado que haya memorizado la hoja de datos.

​
Consejos profesionales para principiantes

En lugar de: “configurar el temporizador”Pruebe: “configure el temporizador 3 para un intervalo de interrupción de 10 ms utilizando el reloj HSI de 16 MHz”
Divida las tareas complejas en pasos:
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
Antes de realizar cambios, permita que Embedder comprenda su código:
analyze my clock configuration

what's the current interrupt priority setup?
Consulte mejores prácticas para obtener más consejos.

​
¿Qué sigue?

Continúe con Mejores prácticas para obtener consejos sobre cómo obtener los mejores resultados, o Flujos de trabajo comunes para ver ejemplos prácticos.

​
Obteniendo ayuda

  • En Embedder: escriba /help o pregunte “¿cómo puedo…”
  • Documentación: explore nuestras guías para obtener información detallada
  • Comunidad: únete a nuestra comunidad de Discord para obtener consejos y ayuda.
Last modified on March 5, 2026