Skip to main content

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

Schritt 1: Embedder installieren und starten

Um Embedder zu installieren, verwende eine der folgenden Methoden:
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:

Schritt 2: In deinem Konto anmelden

Embedder benoetigt ein Konto. Wenn du eine interaktive Sitzung mit dem Befehl embedder startest, musst du dich anmelden:
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:
Du siehst den Projektauswahlbildschirm von Embedder.

Projekt erstellen

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

Projekt-Auswahloberflaeche

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

Plattform-Auswahloberflaeche mit Optionen 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

Peripherie-Auswahloberflaeche mit Komponenten verschiedener Hersteller

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:
Embedder-Oberflaeche mit einer Frage zu den nRF9151-GPS-Faehigkeiten, Dokumentergebnissen mit Hardware-Anforderungstabelle und serieller Ausgabe mit Satelliteninformationen

Embedder beantwortet eine Frage zu nRF9151-GPS mit Live-Serienausgabe

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:
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:
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:
Du kannst auch komplexere Git-Operationen anfordern:

Schritt 7: Einen Bug beheben oder ein Feature hinzufuegen

Beschreibe das Problem, das du siehst, und Embedder hilft dir beim Debugging:
Oder fuege eine Fehlermeldung ein:
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
Peripherie konfigurieren
Initialisierungscode generieren
Code auf eine neue Plattform 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:
Lass Embedder vor Aenderungen deinen Code verstehen:
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
Zuletzt geändert am 5. März 2026