Zum Hauptinhalt springen

​
Bevor du beginnst

Stelle sicher, dass du Folgendes hast:
  • Eine Terminal-Anwendung (siehe Empfehlungen unten)
  • Ein Firmware-Projekt, mit dem du arbeiten kannst (oder beginne ein neues)

​
Empfohlene Terminals

Ghostty fuer die beste Erfahrung auf macOS und Linux.macOS (Homebrew):
brew install --cask ghostty
Linux:
# Siehe https://ghostty.org/docs/install fuer distributionsspezifische Anleitungen

​
Schritt 1: Embedder installieren und starten

Um Embedder zu installieren, verwende eine der folgenden Methoden: 
curl -fsSL https://embedder.com/install | bash
Native Installationen aktualisieren sich automatisch im Hintergrund, damit du immer auf der neuesten Version bleibst.
Um Embedder zu starten, fuehre embedder im Verzeichnis deines Projekts aus: 
cd dein-projekt
embedder

​
Schritt 2: In deinem Konto anmelden

Embedder benoetigt ein Konto. Wenn du eine interaktive Sitzung mit dem Befehl embedder startest, musst du dich anmelden: 
embedder
# Bei der ersten Nutzung wirst du zur Anmeldung aufgefordert
Folge den Anweisungen, um dich mit deinem Konto anzumelden. Wenn sich die Web-App nicht automatisch oeffnet, klicke auf den Link im Terminal. Nach der Anmeldung werden deine Zugangsdaten gespeichert und du musst dich nicht erneut anmelden. Um spaeter das Konto zu wechseln, verwende den Befehl /logout.

​
Schritt 3: Deine erste Sitzung starten

Oeffne dein Terminal in einem beliebigen Projektverzeichnis und starte Embedder: 
cd /pfad/zu/deinem/projekt
embedder
Du siehst den Projektauswahlbildschirm von Embedder.

​
Projekt erstellen

Dialog zur Projektauswahl mit Suchfeld, Schaltflaeche zum Erstellen eines neuen Projekts und Liste vorheriger Projekte

​
Plattform auswaehlen

Nach dem Start fordert Embedder dich auf, deine Hardware-Plattform auszuwaehlen. Nutze das Suchfeld zum Filtern, navigiere mit den Pfeiltasten und bestaetige mit Enter.
Dialog zur Plattformauswahl mit Suchfeld und nRF9xxx-Plattformen von Nordic Semiconductor
Waehle die Plattform, die zu deiner Hardware passt. Embedder nutzt die offizielle Dokumentation deiner Plattform fuer Codegenerierung und Antworten. Um benutzerdefinierte Plattformen hinzuzufuegen, siehe Haeufige Workflows.

​
Peripherie auswaehlen

Nach der Plattformauswahl fordert Embedder dich auf, deine Peripherie zu konfigurieren. In diesem Schritt legst du fest, welche externen Komponenten dein Projekt verwendet.
Dialog zur Peripherieauswahl mit Suchfeld und Komponenten von Analog Devices, Nexperia und Allegro MicroSystems
Nutze das Suchfeld, um bestimmte Komponenten zu finden. Navigiere mit den Pfeiltasten und druecke die Leertaste, um Auswahlen umzuschalten. Druecke Enter, wenn du fertig bist. Um benutzerdefinierte Peripherie hinzuzufuegen, siehe Haeufige Workflows.
Du kannst deine Peripherie-Konfiguration spaeter mit dem Befehl /peripherals aendern.

​
Schritt 4: Deine erste Frage stellen

Sobald Plattform und Peripherie konfiguriert sind, kannst du hardwarespezifische Fragen in natuerlicher Sprache stellen. Embedder nutzt automatisch relevante Datenblaetter, Referenzhandbuecher und Errata. Wenn ein Geraet verbunden ist, liest es zudem die serielle Ausgabe in Echtzeit. Teste eine Frage zu deiner Hardware: 
erzaehl mir etwas ueber die gps-faehigkeiten des nrf9151
Embedder-Oberflaeche mit einer Frage zu den nRF9151-GPS-Faehigkeiten, Dokumentergebnissen mit Hardware-Anforderungstabelle und serieller Ausgabe mit Satelliteninformationen
Embedder zeigt relevante Dokumentation an, inklusive Hardware-Anforderungen, Pin-Konfigurationen und Timing-Spezifikationen. Der serielle Monitor zeigt Echtzeit-Ausgaben des verbundenen Geraets. Du kannst auch Fragen zu deinem Code stellen: 
was macht dieses projekt?

wo ist der haupteinstiegspunkt?

erklaere die ordnerstruktur
Embedder liest bei Bedarf deine Dateien und Datenblaetter. Du musst den Kontext nicht manuell bereitstellen.

​
Schritt 5: Deine erste Code-Aenderung

Lass Embedder jetzt Firmware generieren. Versuche eine einfache Aufgabe: 
fuege eine funktion hinzu, um die LED an GPIO-Pin 13 umzuschalten
Embedder wird:
  1. Die passende Datei finden
  2. Relevante Registerdefinitionen im Datenblatt lesen
  3. Vorgeschlagene Aenderungen mit Quellenangaben zeigen
  4. Dich um Freigabe bitten
  5. Die Aenderung anwenden
Embedder fragt immer nach Erlaubnis, bevor Dateien geaendert werden, sofern du nichts anderes angibst.

​
Schritt 6: Git mit Embedder verwenden

Embedder macht Git-Operationen konversationell: 
welche dateien habe ich geaendert?

committe meine aenderungen mit einer aussagekraeftigen nachricht
Du kannst auch komplexere Git-Operationen anfordern: 
erstelle einen neuen branch namens feature/uart-driver

zeige mir die letzten 5 commits

hilf mir beim aufloesen von merge-konflikten

​
Schritt 7: Einen Bug beheben oder ein Feature hinzufuegen

Beschreibe das Problem, das du siehst, und Embedder hilft dir beim Debugging: 
mein SPI-Peripheriebaustein antwortet nicht - hilf mir beim debuggen
Oder fuege eine Fehlermeldung ein: 
ich bekomme einen hard fault bei HAL_UART_Transmit - warum?
Embedder wird:
  • Deinen Code mit dem Datenblatt abgleichen
  • Nach typischen Konfigurationsfehlern suchen
  • Bekannte Errata fuer deinen MCU gegenpruefen
  • Korrekturen vorschlagen und testen

​
Schritt 8: Weitere haeufige Workflows testen

Es gibt viele Moeglichkeiten, mit Embedder zu arbeiten: Treiber schreiben 
schreibe einen I2C-Treiber fuer den BME280-Temperatursensor
Peripherie konfigurieren 
konfiguriere PWM auf Timer 2 mit 1 kHz frequenz
Initialisierungscode generieren 
initialisiere den ADC mit 12-bit auf kanal 5
Code auf eine neue Plattform portieren 
hilf mir, diesen STM32-Treiber nach nRF52 zu portieren
Siehe Haeufige Workflows fuer weitere Informationen.
Merke: Embedder versteht deine Hardware. Stelle Fragen so, wie du sie einem erfahrenen Firmware-Engineer mit Datenblattwissen stellen wuerdest.

​
Profi-Tipps fuer Einsteiger

Statt: “konfiguriere den timer”Besser: “konfiguriere Timer 3 fuer ein 10-ms-Interruptintervall mit dem 16-MHz-HSI-Takt”
Zerlege komplexe Aufgaben in Schritte:
1. initialisiere die SPI-peripherie mit 1 MHz
2. schreibe eine funktion zum lesen eines registers vom beschleunigungssensor
3. fuege eine funktion hinzu, um den beschleunigungssensor auf ±2g zu konfigurieren
Lass Embedder vor Aenderungen deinen Code verstehen:
analysiere meine clock-konfiguration

wie sieht die aktuelle interrupt-prioritaetskonfiguration aus?
Siehe Best Practices fuer weitere Tipps.

​
Wie geht es weiter?

Mach weiter mit Best Practices fuer bessere Ergebnisse oder mit Haeufige Workflows fuer praktische Beispiele.

​
Hilfe erhalten

  • In Embedder: Tippe /help oder frage “wie kann ich…”
  • Dokumentation: Durchsuche unsere Leitfaeden fuer detaillierte Informationen
  • Community: Tritt unserer Discord-Community fuer Tipps und Support bei
Last modified on March 5, 2026