Layout Editor ZMK

Zweck & Benutzerintention: Dieses Tool löst das Problem der Gestaltung, Validierung und des Exports von Tastaturlayouts für ZMK-Firmware. Es richtet sich an Firmware-Ingenieure, Hardware-Designer und Tastaturbauer, die Matrixverkabelung und die Zuordnung je Layer planen. Benutzer liefern board_rows, board_cols, layers und Footprint-Einschränkungen, platzieren Tasten auf einem Raster und weisen pro Layer Keycodes zu. Das Tool gewährleistet Machbarkeit vor dem Prototyping und erzeugt firmware-ready Exports, die direkt in den Build-Prozess integriert werden. Multi-Layer-Planung wird unterstützt und ausgaben sind revisionsfreundlich.
Kernlogik & Funktionen: Das Kernsystem ist eine rasterbasierte Layout-Engine mit definierten Anforderungen: Rasterdefinition, mehrschichtige Tastenplatzierung und Mapping-Validierung. Optionale Funktionen umfassen Footprint-Bibliotheksintegration, automatische Platzierungsvorschläge und den Bulk-Import/-Export von Konfigurationen. Regeln erzwingen eine eindeutige Zuordnung pro Zelle pro Layer, validieren Randbedingungen, erkennen Konflikte zwischen Layern und melden unmögliche Platzierungen. Es erzeugt pro Layer Karten und eine konsolidierte Konfiguration, die zu ZMK YAML- und JSON-Workflows passt.
Inputs & Outputs: Eingaben umfassen board_rows (int), board_cols (int), layers (int), footprint (string). Ausgaben umfassen per-Layer-Keymaps, eine konsolidierte Konfiguration und Validierungsberichte, die Konflikte, Lücken und Randprobleme hervorheben. Exporte entsprechen ZMK-Konventionen und sind bereit für die Firmware-Integration.
Algorithmen & Berechnungen: Es ordnet Rasterkoordinaten Matrixzeilen/Spalten zu, berechnet Layer-Indizes und formatiert Daten in ZMK-kompatible Darstellungen. Es verwendet Standard-Tastatur-Matrix-Logik und unterstützt nicht-einheitliche Layouts über Platzhalter.
Fehler & Randfälle: Es meldet ungültige Eingabebereiche, fehlende Eingaben, Duplikate, Positionsfehler außerhalb der Grenzen sowie Nicht-Verfügbarkeit von Footprint-Bibliotheken mit umsetzbaren Hinweisen. Fail-fast-Verhalten führt zu konkreten Korrekturmaßnahmen.
Industrie/Region & Lokalisierung: Konformität mit US ANSI-Tastaturlayouts standardmäßig; lagespezifische Layer-Zuordnungen und Dokumentation für regionale Layouts. Einheiten sind Rasterzellen; keine herstellungsbezogenen lokalen Hardwareannahmen jenseits von Keycode-Standards.
Annahmen & Ausschlüsse: Geht von Zugriff auf eine gültige Footprint-Bibliothek und firmware-kompatible Ausgaben aus; schließt UI-spezifische Details, Hardware-Tests oder Nicht-ZMK-Firmware-Ziele aus. Bezieht sich nicht auf Fertigungstoleranzen oder nicht-grid Keyboard-Designs.