"lead":"Velxio wird mit <strong>48+ interaktiven elektronischen Komponenten</strong> geliefert, die von <a>wokwi-elements</a> betrieben werden. Alle Komponenten können auf der Simulationsleinwand platziert, mit Drähten verbunden und in Echtzeit mit Ihrem Arduino-Sketch interagieren.",
"addingHeading":"Komponenten hinzufügen",
"adding1":"Klicken Sie auf die Schaltfläche <strong>+</strong> auf der Simulationsleinwand.",
"adding2":"Verwenden Sie die <strong>Suche</strong> oder blättern Sie nach <strong>Kategorie</strong> in der Komponentenauswahl.",
"adding3":"Klicken Sie auf eine Komponente, um sie auf der Leinwand zu platzieren.",
"adding4":"<strong>Ziehen</strong> Sie, um die Position zu ändern; klicken Sie, um den <strong>Eigenschaftsdialog</strong> zu öffnen.",
"connectingHeading":"Komponenten verbinden",
"connecting1":"Klicken Sie auf einen <strong>Pin</strong> einer Komponente, ein Draht beginnt an diesem Pin.",
"connecting2":"Klicken Sie auf einen <strong>Ziel-Pin</strong>, um die Verbindung abzuschließen.",
"connecting3":"Drähte sind nach Signaltyp <strong>farbcodiert</strong>:",
"thColor":"Farbe",
"thSignalType":"Signaltyp",
"colorRed":"Rot",
"colorBlack":"Schwarz",
"colorBlue":"Blau",
"colorGreen":"Grün",
"colorPurple":"Lila",
"colorGold":"Gold",
"colorOrange":"Orange",
"colorCyan":"Cyan",
"sigVcc":"VCC (Strom)",
"sigGnd":"GND (Masse)",
"sigAnalog":"Analog",
"sigDigital":"Digital",
"sigPwm":"PWM",
"sigI2c":"I2C (SDA/SCL)",
"sigSpi":"SPI (MOSI/MISO/SCK)",
"sigUsart":"USART (TX/RX)",
"categoriesHeading":"Komponentenkategorien",
"outputHeading":"Ausgabe",
"thComponent":"Komponente",
"thDescription":"Beschreibung",
"compLed":"LED",
"compLedDesc":"Einzelne LED mit konfigurierbarer Farbe",
"compRgbLed":"RGB-LED",
"compRgbLedDesc":"Dreifarbige LED (rot, grün, blau)",
"comp7Seg":"7-Segment-Anzeige",
"comp7SegDesc":"Einstellige numerische Anzeige",
"compLcd16x2":"LCD 16x2",
"compLcd16x2Desc":"2-zeiliges Zeichen-LCD (I2C oder parallel)",
"propsLead":"Jede Komponente hat einen <strong>Eigenschaftsdialog</strong>, der durch Klicken auf die Leinwand geöffnet wird:",
"thProperty":"Eigenschaft",
"propArduinoPin":"Arduino-Pin",
"propArduinoPinDesc":"Der digitale oder analoge Pin, mit dem diese Komponente verbunden ist",
"propColor":"Farbe",
"propColorDesc":"Visuelle Farbe (LEDs, Drähte)",
"propValue":"Wert",
"propValueDesc":"Komponentenwert (z. B. Widerstand in Ohm)",
"propRotation":"Drehung",
"propRotationDesc":"In 90-Grad-Schritten drehen",
"propDelete":"Löschen",
"propDeleteDesc":"Komponente von der Leinwand entfernen"
},
"sectionMeta":{
"intro":{
"title":"Einführung | Velxio-Dokumentation",
"description":"Erfahren Sie mehr über Velxio, den kostenlosen Open-Source-Arduino-Emulator mit echter AVR8- und RP2040-CPU-Emulation und 48+ interaktiven elektronischen Komponenten."
},
"gettingStarted":{
"title":"Erste Schritte | Velxio-Dokumentation",
"description":"Erste Schritte mit Velxio: Nutzen Sie den gehosteten Editor, hosten Sie selbst mit Docker oder richten Sie eine lokale Entwicklungsumgebung ein. Simulieren Sie in Minuten Ihren ersten Arduino-Sketch."
"description":"Wie Velxio AVR8 (ATmega328p), RP2040 und RISC-V (ESP32-C3) CPUs emuliert. Behandelt Ausführungsschleifen, Peripherie und Pin-Zuordnung für alle unterstützten Boards."
"description":"Browser-seitiger RV32IMC-Emulator für ESP32-C3, XIAO ESP32-C3 und C3 SuperMini. Behandelt Speicherkarte, GPIO, UART0, den ESP32-Image-Parser, RV32IMC-ISA und Testsuite."
"description":"QEMU-basierte Emulation für ESP32 und ESP32-S3 (Xtensa LX6/LX7). Behandelt den lcgamboa-Fork, libqemu-xtensa, GPIO, WiFi, I2C, SPI, RMT/NeoPixel und LEDC/PWM."
"description":"Vollständige Referenz für alle 48+ interaktiven elektronischen Komponenten in Velxio: LEDs, Displays, Sensoren, Taster, Potentiometer und mehr. Enthält Verdrahtungs- und Eigenschaftsdetails."
},
"roadmap":{
"title":"Fahrplan | Velxio-Dokumentation",
"description":"Velxios Feature-Fahrplan: Was implementiert ist, was in Arbeit ist und was für zukünftige Versionen geplant ist."
"description":"Detaillierte Übersicht über die Velxio-Systemarchitektur: Frontend, Backend, AVR8-Emulationspipeline, Datenflüsse, Zustand-Stores und Drahtsystem."
"description":"Wie Velxio die offiziellen Wokwi-Open-Source-Bibliotheken integriert: avr8js, wokwi-elements und rp2040js. Behandelt Konfiguration, Updates und die 48 verfügbaren Komponenten."
},
"mcp":{
"title":"MCP-Server | Velxio-Dokumentation",
"description":"Velxio MCP-Server-Referenz: Integrieren Sie KI-Agenten (Claude, Cursor) mit Velxio über das Model Context Protocol. Behandelt Werkzeuge, Transporte, Schaltungsformat und Beispiel-Walkthroughs."
},
"setup":{
"title":"Projektstatus | Velxio-Dokumentation",
"description":"Vollständiger Status aller implementierten Velxio-Funktionen: AVR-Emulation, Komponentensystem, Drahtsystem, Code-Editor, Beispielprojekte und nächste Schritte."
},
"rp2040Emulation":{
"title":"RP2040-Emulation (Raspberry Pi Pico) | Velxio-Dokumentation",
"description":"Wie Velxio den Raspberry Pi Pico und Pico W mit rp2040js emuliert: ARM Cortex-M0+ bei 133 MHz, GPIO, UART, ADC, I2C, SPI, PWM und WFI-Optimierung."
},
"raspberryPi3Emulation":{
"title":"Raspberry Pi 3-Emulation (QEMU) | Velxio-Dokumentation",
"description":"Wie Velxio einen vollständigen Raspberry Pi 3B mit QEMU raspi3b emuliert: echtes Raspberry Pi OS, Python + RPi.GPIO-Shim, zweikanaliger UART, VFS und Multi-Board-Serienbrücke."
"title":"QEMU aus dem Quellcode bauen | Velxio-Dokumentation",
"description":"Schritt-für-Schritt-Anleitung zum Kompilieren von libqemu-xtensa und libqemu-riscv32 aus dem lcgamboa/qemu-Fork. Volle Transparenz unter AGPLv3."
"lead":"Der Raspberry Pi Pico und Pico W werden vollständig im Browser mit <a>rp2040js</a> emuliert, einem Open-Source-ARM-Cortex-M0+-Emulator. Es wird kein QEMU oder Backend-Prozess benötigt, das Binärprogramm läuft mit voller Geschwindigkeit in einem Web Worker.",
"boardsHeading":"Unterstützte Boards",
"boardPico":"Raspberry Pi Pico",
"altPico":"Raspberry Pi Pico",
"boardPicoW":"Raspberry Pi Pico W",
"altPicoW":"Raspberry Pi Pico W",
"thBoard":"Board",
"thFqbn":"FQBN",
"thBuiltinLed":"Eingebaute LED",
"ledGpio25":"GPIO 25",
"ledCyw43":"GPIO 25 (über CYW43)",
"binaryHeading":"Binärformat",
"binaryBody1":"Das Backend kompiliert den Sketch mit <code>arduino-cli</code> für <code>rp2040:rp2040:rpipico</code> und gibt ein rohes ARM-Binärprogramm (<code>.bin</code>) zurück, das in Base64 kodiert ist. Anders als bei AVR gibt es kein Intel HEX, das Binärprogramm wird direkt in den RP2040-Flash bei Offset 0 geladen.",
"binaryBody2":"Das Backend fügt dem Sketch außerdem <code>#define Serial Serial1</code> voran, sodass Arduino <code>Serial</code>-Aufrufe an UART0 (den virtuellen seriellen Port, der an das serielle Monitor gestreamt wird) umgeleitet werden.",
"perPwmNotes":"Keine Wellenformausgabe an Komponenten",
"perTimer":"Timer / Alarm",
"perTimerNotes":"Verwendet von <code>delay()</code> und <code>millis()</code>",
"wfiHeading":"WFI-Optimierung",
"wfiBody":"Wenn die CPU eine <strong>WFI</strong> (Wait For Interrupt)-Anweisung ausführt, spult der Emulator die Systemuhr zum nächsten geplanten Alarm vor, anstatt durch Leerlaufzyklen zu rotieren. Dies reduziert die CPU-Auslastung bei <code>delay()</code>-Aufrufen drastisch.",
"simLoopHeading":"Simulationsschleife",
"simLoopBody":"Die Simulation läuft innerhalb von <code>requestAnimationFrame</code> mit ~60 FPS. Jeder Frame führt ungefähr <strong>2.200.000</strong> CPU-Zyklen aus (133 MHz / 60 fps). GPIO-Listener werden ausgelöst, wenn sich ein Pin-Zustand ändert, und aktualisieren die visuellen Komponenten auf der Leinwand.",
"limitsHeading":"Bekannte Einschränkungen",
"limit1":"Pico W-Funkchip (CYW43439) wird nicht emuliert, WiFi/Bluetooth funktioniert nicht",
"limit2":"SPI nur Loopback, keine echte SPI-Geräteemulation",
"limit3":"PWM erzeugt korrekte Frequenz, aber keine visuelle Wellenform auf Komponenten",
"limit4":"DMA nicht emuliert",
"limit5":"Zweiter CPU-Kern (Kern 1) nicht emuliert, <code>multicore_launch_core1()</code> hat keine Wirkung",
"fullDocsHeading":"Vollständige Dokumentation",
"fullDocsBody":"Siehe die vollständige technische Referenz: <a>RP2040_EMULATION.md</a>"
},
"rpi3":{
"label":"// qemu raspi3b",
"heading":"Raspberry Pi 3-Emulation (QEMU)",
"lead":"Der Raspberry Pi 3B wird mit <strong>QEMU 8.1.3</strong> und <code>-M raspi3b</code> emuliert. Dies ist das einzige Board in Velxio, das ein vollständiges Betriebssystem ausführt, ein echtes <strong>Raspberry Pi OS (Trixie)</strong>-Image, das im Emulator gebootet wird. Benutzer schreiben Python-Skripte (nicht C++), die vom echten Python 3-Interpreter innerhalb der VM ausgeführt werden.",
"serialLead":"QEMU stellt dem Backend zwei UART-Kanäle zur Verfügung:",
"serialUser":"<strong>ttyAMA0</strong>: Benutzerseriell: interaktives Terminal (serieller Monitor). Die <code>print()</code>-Ausgabe des Benutzers erscheint hier.",
"serialGpio":"<strong>ttyAMA1</strong>: GPIO-Shim: überträgt ein Textprotokoll zwischen dem GPIO-Shim innerhalb der VM und dem Backend.",
"shimHeading":"RPi.GPIO-Shim",
"shimBody1":"Ein benutzerdefinierter <code>RPi.GPIO</code>-Shim wird unter <code>/usr/local/lib/python3.11/dist-packages/RPi/GPIO.py</code> in die VM injiziert. Wenn Benutzercode <code>GPIO.output(pin, value)</code> aufruft, schreibt der Shim eine Zeile wie <code>GPIO 17 1</code> auf <strong>ttyAMA1</strong>. Das Backend liest dies, löst ein <code>gpio_change</code>-WebSocket-Ereignis aus, und das Frontend aktualisiert die visuelle Komponente auf der Leinwand.",
"shimBody2":"Das Gegenteil funktioniert auch: Das Frontend kann <code>SET 17 1</code> über WebSocket - Backend - ttyAMA1 - Shim - Benutzercode senden, der es über <code>GPIO.input(17)</code> liest.",
"vfsHeading":"Virtuelles Dateisystem (VFS)",
"vfsBody":"Jede Raspberry Pi-Board-Instanz hat ihr eigenes VFS, das auf Dateien innerhalb der laufenden VM abbildet. Der Standardbaum ist:",
"overlayHeading":"Overlay-Images",
"overlayBody":"Das Basis-Raspberry-Pi-OS-SD-Image wird nie modifiziert. Jede Sitzung erstellt ein frisches <strong>qcow2-Overlay</strong> über dem Basis-Image, sodass alle Laufzeitänderungen isoliert und beim Beenden der Sitzung verworfen werden.",
"limitsHeading":"Bekannte Einschränkungen",
"limit1":"Keine I2C- oder SPI-Geräteemulation",
"limit2":"Keine PWM-Wellenformausgabe an Komponenten",
"limit3":"Keine Netzwerkfähigkeit (WiFi/Ethernet nicht emuliert)",
"limit4":"Sitzungszustand wird nicht gespeichert, Overlay wird beim Stoppen verworfen",
"limit5":"Bootzeit ist langsam (~10-20 s), da ein vollständiges Betriebssystem starten muss",
"limit6":"Erfordert das ~5,67 GB große Basis-SD-Image auf dem Server",
"fullDocsHeading":"Vollständige Dokumentation",
"fullDocsBody":"Siehe die vollständige technische Referenz: <a>RASPBERRYPI3_EMULATION.md</a>"
},
"gettingStarted":{
"label":"// einrichtung",
"heading":"Erste Schritte",
"lead":"Befolgen Sie diese Schritte, um Ihren ersten Arduino-Sketch zu simulieren.",
"option1Heading":"Option 1: Gehostete Version nutzen",
"option1Body":"Keine Installation erforderlich, gehen Sie zu <a>https://velxio.dev</a> und beginnen Sie sofort mit dem Programmieren.",
"option2Heading":"Option 2: Selbst hosten mit Docker",
"option2Body":"Führen Sie einen einzelnen Docker-Befehl aus, um eine vollständig lokale Instanz zu starten:",
"option2After":"Öffnen Sie dann <strong>http://localhost:3080</strong> in Ihrem Browser.",
"firstSim1":"<strong>Öffnen Sie den Editor</strong> unter <a>velxio.dev/editor</a>.",
"firstSim2":"<strong>Wählen Sie ein Board</strong> aus der Symbolleiste (z. B. <em>Arduino Uno</em>).",
"firstSim3":"<strong>Schreiben Sie Arduino-Code</strong> im Monaco-Editor, zum Beispiel:",
"firstSim4":"<strong>Klicken Sie auf Kompilieren</strong>: Das Backend ruft <code>arduino-cli</code> auf und gibt eine <code>.hex</code>-Datei zurück.",
"firstSim5":"<strong>Klicken Sie auf Ausführen</strong>: Der AVR8-Emulator führt das kompilierte Programm aus.",
"firstSim6":"<strong>Fügen Sie Komponenten hinzu</strong> mit der Komponentenauswahl (klicken Sie auf die Schaltfläche <strong>+</strong> auf der Leinwand).",
"firstSim7":"<strong>Verbinden Sie Drähte</strong>, indem Sie auf einen Komponenten-Pin und dann auf einen anderen Pin klicken.",
"troubleshootingHeading":"Fehlerbehebung",
"thProblem":"Problem",
"thSolution":"Lösung",
"tsArduinoCliMissingProblem":"<code>arduino-cli: command not found</code>",
"tsArduinoCliMissingSolution":"Installieren Sie <code>arduino-cli</code> und fügen Sie es zu Ihrem PATH hinzu.",
"tsLedNoBlinkProblem":"LED blinkt nicht",
"tsLedNoBlinkSolution":"Überprüfen Sie die Browser-Konsole auf Port-Listener-Fehler; überprüfen Sie die Pin-Zuweisung im Komponenten-Eigenschaftsdialog.",
"tsSerialEmptyProblem":"Serieller Monitor ist leer",
"tsSerialEmptySolution":"Stellen Sie sicher, dass <code>Serial.begin()</code> in <code>setup()</code> aufgerufen wird, bevor <code>Serial.print()</code> verwendet wird.",
"tsCompileErrorsProblem":"Kompilierungsfehler",
"tsCompileErrorsSolution":"Überprüfen Sie die Kompilierungskonsole am unteren Rand des Editors auf die vollständige <code>arduino-cli</code>-Ausgabe."
},
"thirdParty":{
"label":"// open-source-bibs",
"heading":"Wokwi-Bibliotheken",
"lead":"Velxio verwendet offizielle Wokwi-Open-Source-Repositorys, die lokal in <code>third-party/</code> geklont sind. Dies bietet aktuelle, kompatible Emulations-Engines und visuelle Komponenten ohne Abhängigkeiten von der npm-Registry.",
"libAvr8jsDesc":"ATmega328p / ATmega2560 CPU-Emulator bei 16 MHz",
"libRp2040jsDesc":"Raspberry Pi Pico (RP2040)-Emulator",
"npmIntro":"Alle drei Bibliotheken werden direkt von der npm-Registry durch <code>frontend/package.json</code> bezogen. Referenz-Klone können unter <code>third-party/</code> für Credits und Offline-Hacking liegen, aber der Build benötigt sie nicht.",
"updatingHeading":"Aktualisieren der Bibliotheken",
"updatingBody":"Bearbeiten Sie die Versions-Pins in <code>frontend/package.json</code> (<code>@wokwi/elements</code>, <code>avr8js</code>, <code>rp2040js</code>) und führen Sie <code>npm install</code> in <code>frontend/</code> aus.",
"afterBumpHeading":"Nach dem Erhöhen von wokwi-elements (nur beim Hinzufügen neuer Komponenten)",
"afterBumpBody":"Der Metadatengenerator scannt das upstream <code>src/</code>, das das npm-Paket nicht enthält. Klonen Sie wokwi-elements einmal in <code>third-party/</code> und generieren Sie neu:",
"howAvrHeading":"Wie avr8js die Simulation antreibt",
"fullDetailsCallout":"<strong>Vollständige Details:</strong> Siehe <a>docs/WOKWI_LIBS.md</a> im Repository."
},
"mcp":{
"label":"// KI-integration",
"heading":"MCP-Server",
"lead":"Velxio stellt einen <a>Model Context Protocol</a> (MCP)-Server bereit, der KI-Agenten (Claude, Cursor und andere) ermöglicht, Schaltungen zu erstellen, Code zu generieren und Arduino-Sketche direkt zu kompilieren.",
