> ## Documentation Index > Fetch the complete documentation index at: https://docs.embedder.com/llms.txt > Use this file to discover all available pages before exploring further. # Schnellstart ## 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](https://ghostty.org/) fuer die beste Erfahrung auf macOS und Linux. **macOS (Homebrew):** ```bash theme={"system"} brew install --cask ghostty ``` **Linux:** ```bash theme={"system"} # Siehe https://ghostty.org/docs/install fuer distributionsspezifische Anleitungen ``` [Alacritty](https://alacritty.org/) fuer die beste Erfahrung auf Windows. **Mit winget:** ```powershell theme={"system"} winget install Alacritty.Alacritty ``` **Mit Scoop:** ```powershell theme={"system"} scoop install alacritty ``` ## Schritt 1: Embedder installieren und starten Um Embedder zu installieren, verwende eine der folgenden Methoden: ```bash theme={"system"} curl -fsSL https://embedder.com/install | bash ``` Native Installationen aktualisieren sich automatisch im Hintergrund, damit du immer auf der neuesten Version bleibst. ```powershell theme={"system"} irm https://embedder.com/install | iex ``` 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: ```bash theme={"system"} 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: ```bash theme={"system"} 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: ```bash theme={"system"} 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](/de/core-concepts/common-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](/de/core-concepts/common-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](/de/core-concepts/common-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](/de/core-concepts/best-practices) fuer weitere Tipps. ## Wie geht es weiter? Mach weiter mit [Best Practices](/de/core-concepts/best-practices) fuer bessere Ergebnisse oder mit [Haeufige Workflows](/de/core-concepts/common-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