SharpKey Multi-HID-Schnittstelle Entwicklerhandbuch

Ueberblick

SharpKey ist ein Multi-Host-Tastaturinterface basierend auf dem ESP32-Mikrocontroller. Es uebersetzt moderne PS/2- und Bluetooth-Tastaturen in die nativen Tastaturprotokolle historischer Sharp- und NEC-Computer. Unterstuetzte Host-Maschinen sind:
  • Sharp MZ-2500 -- SuperMZ-Serie
  • Sharp MZ-2800 -- 16-Bit SuperMZ
  • Sharp MZ-5500/5600/6500 -- MZ Business-Serie
  • Sharp X1 -- X1-Serie Personalcomputer
  • Sharp X68000 -- 68000-basierte Workstation
  • NEC PC-9801 -- NEC 98-Architektur
Dieselbe Codebasis erstellt auch die einfachere mz25key-Variante, die nur auf MZ-2500 und MZ-2800 abzielt.
SharpKey ist um das Dual-Core ESP-32S AI Thinker Modul herum konzipiert. Core 1 ist dem zeitkritischen Host-Interface gewidmet, waehrend Core 0 FreeRTOS-Systemaufgaben, WiFi, Bluetooth und HID-Eingabeverarbeitung uebernimmt.
Die Firmware enthaelt eine integrierte WiFi-Web-Oberflaeche fuer Konfiguration, Tastenzuordnungs-Anpassung und OTA-Firmware-Updates. Bluetooth-HID-Unterstuetzung ermoeglicht drahtlose Tastaturen und Maeuse mit historischer Hardware.
Hinweis: Dieses Entwicklerhandbuch enthaelt umfangreichen Quellcode, API-Dokumentation, Architekturdiagramme und technische Details, die alle in englischer Sprache verbleiben. Bitte lesen Sie die englische Version fuer den vollstaendigen Inhalt einschliesslich:
  • Voraussetzungen und Build-Umgebung
  • Repository-Struktur und Quellmodule
  • Softwarearchitektur und Kern-Trennung
  • Host-Protokollimplementierungen (MZ-2500, MZ-2800, X1, X68000, PC-9801)
  • Tastenzuordnungssystem und Web-Interface
  • Bluetooth-HID-Integration
  • OTA-Update-Mechanismus
  • Docker-Build und CI/CD-Pipeline (Jenkins)
  • Debugging-Techniken

SharpKey ist unter der GNU General Public License v3 lizenziert. Autor: Philip Smart.

Danksagungen

Die Espressif IDF-Entwicklungsumgebung und ESP-32S-Referenzmaterialien wurden verwendet.

Lizenzen

Unter GNU Public Licence v3 lizenziert. Keine kommerzielle Nutzung ohne Genehmigung.

Hinweis zur Funkregulierung

Dieses Geraet enthaelt ein vorzertifiziertes ESP32-S Funkmodul im 2,4 GHz ISM-Band. Verantwortung des Erbauers fuer Konformitaet.