Skip to main content

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

​
Paso 1: Instalar e iniciar Embedder

Para instalar Embedder, utilice uno de los siguientes métodos:
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:

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

Project selection interface

​
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

Platform selection interface showing Nordic Semiconductor options

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

Peripheral selection interface with components from various manufacturers

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

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:
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:
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:
También puede solicitar operaciones Git más complejas:

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

Describe el problema que estás viendo y Embedder te ayudará a depurarlo:
O pegue un error:
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
Configurar un periférico
Generar código de inicialización
Código de puerto a una nueva plataforma
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:
Antes de realizar cambios, permita que Embedder comprenda su código:
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.
Última modificación el 5 de marzo de 2026