SharpKey Multi-HID-Schnittstelle Benutzerhandbuch

Der Name SharpKey leitet sich von Sharp Keyboard Interface ab, da es auf dem urspruenglichen mz25key Sharp MZ-2500/MZ-2800 PS/2-Tastatur-Interface basiert. Das SharpKey Multi-HID Interface ist ein Geraet, das den Anschluss von Tastaturen und Maeusen ueber PS/2 oder Bluetooth an historische Sharp- und NEC-Computer ermoeglicht. Es ist in einem kleinen KM-24-Gehaeuse in Schwarz oder Hellgrau untergebracht, passend zur Farbe der Host-Konsole, und nimmt minimalen zusaetzlichen Platz ein. Es verfuegt ueber zwei externe Anschluesse, einen fuer eine PS/2-Tastatur oder -Maus und den zweiten fuer ein Kabel zur Verbindung mit der Tastatur- oder Mauseingangsbuchse des Hosts. Bei Verwendung von Bluetooth wird der PS/2-Anschluss nicht verwendet und es ist nur ein Host-Kabel vom Host-Port erforderlich. Im Betrieb bezieht das SharpKey Strom vom Host und belastet das Netzteil des Host-Computers nur minimal. Es verbraucht typischerweise 30mA im aktiven Interface-Modus, ansteigend auf 150mA bei aktivierter IoT-Web-Oberflaeche. Der maximale momentane Einschaltstrom fuer WiFi kann 250mA betragen.

Dieser Abschnitt beschreibt die Anschluesse, Schnittstellen, Tasten und LEDs des SharpKey.

Das SharpKey ist mit zwei Mini-DIN-Buchsen, einer LED und einem Konfigurationsschalter zur Aktivierung der integrierten WiFi-IoT-Web-Oberflaeche und des Bluetooth-Geraete-Pairings ausgestattet. Das Bild unten zeigt die Positionen.
Links befindet sich der HOST-Anschluss, eine 8-polige Mini-DIN-Buchse, in die ein HOST-spezifisches Kabel gesteckt wird. Das Kabel verbindet das SharpKey mit einem Maus- oder Tastaturanschluss eines bestimmten Hosts, z.B. Sharp MZ-2800.
Rechts befindet sich der PS/2-Anschluss, eine 6-polige Mini-DIN-Buchse, in die eine PS/2-Tastatur oder PS/2-Maus gesteckt wird. Dieser Anschluss ist hotswap-faehig, sodass ein Geraet bei eingeschaltetem Interface getrennt und wieder eingesteckt werden kann. Das Anschliessen eines anderen Geraets des gleichen Typs ist moeglich, aber ein Wechsel von Tastatur zu Maus oder umgekehrt ist nicht moeglich, da auch das HOST-Kabel gewechselt werden muesste.

Intern befindet sich ein 8-poliger 2mm-Header-Anschluss, der verwendet wird, wenn ein OTA-Firmware-Upgrade fehlschlaegt (d.h. das Geraet gebrickt wurde) oder fuer die Entwicklung und das Debugging neuer Funktionen. Weitere Informationen zu diesem Anschluss finden Sie in der technischen Dokumentation.

Die blaue Aktivitaets-LED zeigt den Geraeebetrieb an und warnt vor Fehlern oder Geraetestatus. Im Normalbetrieb leuchtet die Aktivitaets-LED beim Einschalten des Interface eine Sekunde lang auf und schaltet sich dann aus. Wenn kein PS/2-Geraet angeschlossen ist, leuchtet die LED dauerhaft, bis ein PS/2-Geraet angeschlossen wird (oder Bluetooth aktiviert wird und ein Geraet sich mit dem SharpKey koppelt). Bei Tastaturaktivitaet pulsiert die LED bei jedem Tastendruck. Bei Mausaktivitaet leuchtet die LED nur, wenn die dritte Radtaste gedrueckt wird und die Maus in den Konfigurationsmodus wechselt.

Der WiFi/Bluetooth-Konfigurationsschalter befindet sich im SharpKey-Gehaeuse und wird ueber ein Loch an der Gehaeuseoberseite neben der LED erreicht. Ein nicht-leitender Stift muss verwendet werden, um ihn in das Loch einzufuehren und den internen Schalter zu druecken. Die Dauer, fuer die der Schalter gedrueckt wird, bestimmt die gewuenschte Funktion.

Jede Host-Maschine hat unterschiedliche elektrische und mechanische Spezifikationen fuer ihre Tastatur- und Mauseingaenge. Das SharpKey kann die elektrischen und Protokollanforderungen verwalten, aber die mechanische Anforderung muss mit einem physischen Kabel erfuellt werden. Das bedeutet, dass jeder Host-Maschinen-Tastatur- und Mauseingabeanschluss ein einzigartiges Kabel vom SharpKey zum Host-Tastatur- oder Mausanschluss benoetigt. Bei Sharp-Maschinen ist der Mausanschluss einheitlich, sodass nur ein Kabel benoetigt wird, um das SharpKey mit einem beliebigen Sharp-Mausanschluss zu verbinden. Die verschiedenen Kabel sind unten zu sehen.

Jedes Kabel hat einen 8-poligen Mini-DIN-Stecker (der MZ-2500 hat 2, sodass jeder Seitenstecker verwendet werden kann), der in das SharpKey gesteckt wird. Das andere Ende des Kabels wird in den Host-Tastatur- oder Mausanschluss gesteckt.

Das Anschliessen des SharpKey ist einfach: Beschaffen Sie das richtige Kabel fuer Ihre Host-Maschine (Tastatur oder Maus), stecken Sie das 8-polige Mini-DIN-Ende in das SharpKey und das andere Ende in den Tastatur- oder Mausanschluss Ihrer Host-Maschine. Wenn Sie eine PS/2-Tastatur oder PS/2-Maus verwenden moechten, stecken Sie den 6-poligen Mini-DIN-Stecker der Tastatur/Maus in das andere Ende des SharpKey. Wenn Sie Bluetooth verwenden moechten, muss keine Verbindung mit dem PS/2-Anschluss am SharpKey hergestellt werden.

Hinweis: Bluetooth wird nur aktiviert, wenn kein PS/2-Geraet angeschlossen ist.

Sobald die Kabel angeschlossen sind, schalten Sie Ihre Maschine ein und verwenden Sie die PS/2-Tastatur/-Maus oder Bluetooth-Tastatur/-Maus wie gewohnt. Wenn Tasten nicht korrekt den Host-Tasten zugeordnet werden, koennen Sie die IoT-Web-Oberflaeche verwenden, um Tastenzuordnungen nach Bedarf hinzuzufuegen.

Hinweis: Die Firmware enthaelt einen Wiederholungsmechanismus fuer die PS/2-Tastaturerkennung -- wenn die Tastatur ihren Power-On Self Test nicht abgeschlossen hat, wenn der Adapter startet, versucht der Adapter bis zu 10 Mal mit 100ms Verzoegerungen, bevor er auf Bluetooth-Modus zurueckfaellt.

Hinweis: Bluetooth-Geraete erfordern eine Kopplung und koennen nach dem Einschalten einige Sekunden zum Verbinden benoetigen. Wenn Sie Bluetooth beim Einschalten verwenden, wecken Sie die Bluetooth-Geraete durch wiederholtes Druecken der Umschalttaste oder Schuetteln der Maus auf, da sich das Geraet im Schlafmodus befindet und das SharpKey keine Verbindung herstellen kann.

Neben PS/2-HID-Geraeten koennen auch drahtlose Bluetooth-Geraete mit dem SharpKey verbunden werden. Um Bluetooth zu verwenden, sollte kein PS/2-Geraet mit dem SharpKey verbunden sein. Wenn das SharpKey beim Start ein PS/2-Geraet erkennt, wird Bluetooth nicht aktiviert. Der Bluetooth-Transceiver im ESP32 ist nicht besonders leistungsstark, daher muss sich Ihr Geraet in einer Reichweite von 1m oder weniger befinden (einige Geraete, typischerweise Maeuse, arbeiten ueber groessere Entfernungen). Beim Erhalt, im Werkszustand oder nach einer NVS-Loeschung, fuehrt das SharpKey einen Bluetooth-Scan durch, um nach Geraeten in der Naehe zu suchen, die sich im Pairing-Modus befinden. Druecken Sie einfach die Pairing-Taste an Ihrem Tastatur- oder Mausgeraet und innerhalb von 5-10 Sekunden sollte eine Verbindung ohne PIN-Eingabe hergestellt werden. Bis zu 5 zusaetzliche Geraete koennen mit dem SharpKey gekoppelt werden (die gleichzeitig arbeiten, wenn alle 5 Geraete verbunden sind), indem das SharpKey in den Kopplungsmodus versetzt wird. Um den Kopplungsmodus zu aktivieren, druecken Sie den WiFi/Config-Schalter fuer 10-15 Sekunden. Waehrend Sie die Taste halten, aendert sich das Muster der blauen LED:

• 2-5 Sekunden: blinkt zweimal pro Sekunde, was WiFi-Aktivierungsmodus anzeigt, wenn Sie den Schalter loslassen.
• 5-10 Sekunden: blinkt 4 Mal pro Sekunde, was den Standard-WiFi-Modus anzeigt, wenn Sie den Schalter loslassen.
• 10-15 Sekunden: blinkt 8 Mal pro Sekunde, was den Bluetooth-Kopplungsmodus anzeigt, wenn Sie den Schalter loslassen.

Lassen Sie den Schalter nach 10 Sekunden los und das SharpKey wechselt in den Kopplungsmodus und verbindet sich mit allen HID-Geraeten, die es im Pairing-Modus findet. Das SharpKey bleibt 60 Sekunden im Kopplungsmodus, waehrend dieser Zeit koppelt es sich mit so vielen HID-Geraeten wie moeglich. Die Geraeteauthentifizierung (PIN-Eingabe) wurde fuer das SharpKey programmtechnisch deaktiviert, da es keine Moeglichkeit hat, eine Kopplungs-PIN anzuzeigen. Diese Methode funktioniert im Allgemeinen gut fuer die meisten BLE- und BT-Classic-Geraete, aber sollte Ihr Geraet eine PIN erfordern, die nicht deaktiviert werden kann, beginnt nach etwa 10 Sekunden die blaue LED mit 3 langen Pulsen zu blinken, die jede Sekunde wiederholt werden. Wenn Sie die LED blinken sehen, geben Sie den PIN-Code '1234' auf Ihrer Tastatur ein und druecken Sie ENTER. Wenn die LED weiterhin blinkt, wiederholen Sie die PIN-Eingabe, bis die Kopplung erfolgt und die LED aufhoert zu blinken. Bei zukuenftigen Ein-/Ausschaltzyklen des SharpKey muss Ihr Bluetooth-Geraet durch Schuetteln oder Aufwecken reaktiviert werden, damit es sich wieder verbindet. Dies kann durch wiederholtes Druecken der Umschalttaste auf Ihrer Tastatur oder durch Bewegen Ihrer Maus erreicht werden. Wenn das Bluetooth-Geraet nicht geweckt wird, kann das SharpKey es nicht sehen und keine Verbindung herstellen. Das Wiederverbinden kann je nach Geraet und Entfernung zum SharpKey 1-10 Sekunden dauern.

Das SharpKey verfuegt ueber mehrere vorkonfigurierte Tastenzuordnungen, werksseitig auf ein UK-Tastaturlayout fuer alle unterstuetzten Host-Maschinen eingestellt. Ueber Tastenkombinationen (siehe unten) ist es moeglich, eine andere Zuordnung auszuwaehlen. Die integrierten Zuordnungen werden im Laufe der Zeit weiterentwickelt, um mehr Tastaturen zu unterstuetzen, und diese Updates werden als Firmware-Update verteilt. Derzeit unterstuetzte Tastaturlayouts sind:

• Wyse KB-3926 UK Layout
• Generic OADG109 Japanese Layout
• Sanwa SKB-L1 Japanese Layout
• Perixx Periboard 810 UK Layout
• OMOTON K8508 UK Layout

Es gibt jedoch einen Grenzfall, dass eine Taste nicht funktioniert oder nicht so funktioniert, wie sie sollte, fuer einen einzelnen Benutzer. Auch koennen andere Benutzer feststellen, dass ihre regionalen (laenderspezifischen) Tastaturen nicht gut funktionieren. Diese Maengel muessen vom Benutzer behoben werden, der mehr praktische Erfahrung hat. Zu diesem Zweck kann das SharpKey so konfiguriert werden, dass es jeden PS/2-Code oder jede Code-Kombination in eine vom aktiven Host erwartete Tastensequenz umwandelt. Bluetooth-Scancodes werden intern auf PS/2-Scancodes abgebildet, sodass alle Tastatur-Typ-Zuordnungen (PS/2 oder Bluetooth) mit PS/2-Codes durchgefuehrt werden. Um Aenderungen vorzunehmen, ist das SharpKey mit einem integrierten Webserver ausgestattet, der WiFi-Technologie nutzt und im Access-Point-Modus (Sie verbinden Ihr WiFi-Geraet mit dem SharpKey) oder Client-Modus konfiguriert werden kann, wobei das SharpKey gespeicherte Anmeldedaten verwendet, um sich mit Ihrem Heimnetzwerk-Router zu verbinden. Um auf die Web-Oberflaeche zuzugreifen, muss das SharpKey den WiFi Access Point oder Client Transceiver aktivieren. Dies geschieht ueber den WiFi/BT-Konfigurationsschalter. Es gibt zwei WiFi-Modi, Access Point und Client:

• Access Point ist, wenn das SharpKey als WiFi-Router fungiert und Sie in den WiFi-Einstellungen Ihres Computers/Telefons nach dem WiFi-Netzwerk suchen: sharpkey und sich mit dem Passwort verbinden: sharpkey. SSID und Passwort koennen in der Konfiguration geaendert werden, aber sollten Sie Ihre Aenderungen vergessen, wird durch Druecken des WiFi/BT-Schalters fuer mehr als 5 Sekunden der Access-Point-Modus mit den genannten Standardwerten aktiviert.
• Client-Modus ist, wenn sich das SharpKey mit Ihrem Heimnetzwerk verbindet, dessen Details vorab ueber den Access-Point-Modus eingegeben werden muessen. Einmal eingestellt, versucht das SharpKey bei jedem Wechsel in den WiFi-Modus automatisch, sich mit Ihrem Router zu verbinden, entweder per DHCP (Ihr Router weist eine Adresse zu) oder mit einer von Ihnen angegebenen festen Adresse.

Die Schritte zum Zugriff auf die einzelnen Modi sind in der folgenden Tabelle zu sehen.

Nach dem Druecken des WiFi-Konfigurationsschalters fuer die erforderliche Zeit wird das Geraet neu gestartet und in den angeforderten WiFi-Modus wechseln. Die blaue LED leuchtet auf - wenn sie dauerhaft leuchtet, ist ein Fehler aufgetreten. Wenn sie mehrmals kurz blinkt, wurde die gewuenschte WiFi-Konfiguration eingerichtet. Wenn alles erfolgreich war und Sie entweder dem Access Point Netzwerk beigetreten sind oder das SharpKey sich mit Ihrem Netzwerk verbunden hat, oeffnen Sie einen Browser und geben Sie die korrekte IP-Adresse ein (z.B. http://192.168.4.1 fuer den anfaenglichen Access Point Modus), um den Statusbildschirm unten zu sehen. Eine visuelle Anzeige der SharpKey-Verbindung mit Ihrem

Der SharpKey-Werkszustand startet automatisch im Access-Point-Modus, wenn WiFi aktiviert wird. WiFi wird durch Druecken des WiFi/BT-Konfigurationsschalters fuer 2-5 Sekunden aktiviert. Wenn das Geraet konfiguriert ist und nicht erreichbar ist (z.B. durch Netzwerkaenderung), aktiviert das Druecken des WiFi/BT-Konfigurationsschalters fuer 5-10 Sekunden automatisch den Access-Point-Modus mit Standardparametern. Die Standardparameter im unkonfigurierten Access-Point-Modus sind unten aufgefuehrt.

Nachdem das SharpKey in den WiFi-Modus versetzt wurde, rufen Sie das WiFi-Menue Ihres Computers oder Telefons auf und waehlen Sie das Netzwerk sharpkey. Geben Sie das Passwort sharpkey ein und Ihr Computer oder Telefon tritt dem SharpKey-Netzwerk bei, und Sie koennen auf die Web-Oberflaeche zugreifen. Geben Sie die URL http://192.168.4.1 in einen Webbrowser ein und Sie sehen den Statusbildschirm:

Der Statusbildschirm zeigt 2 Bereiche: einen WiFi-Konfiguration-Bereich mit der aktiven WiFi-Konfiguration des SharpKey und einen Versionsinformationen-Bereich mit den installierten Firmware-Modulen und deren Versionsnummern sowie der Dateisystemversion. Auf der linken Seite des Bildschirms, dem Seitenleistenmenue, befinden sich die verfuegbaren Optionen zum Anzeigen oder Konfigurieren in der Web-Oberflaeche. Klicken Sie auf die Option WiFi Manager im linken Seitenleistenmenue. Dies startet den WiFi-Manager-Konfigurationsbildschirm:

Sie haben nun die Wahl, das SharpKey als Access Point oder als Client zu konfigurieren. Access Point bedeutet, das SharpKey stellt das WiFi-Netzwerk bereit und Ihr Computer/Telefon muss sich darueber verbinden. Client-Modus bedeutet, Sie geben die Details Ihres Heimnetzwerks ein und das SharpKey verbindet sich automatisch damit. Wenn Sie den Access-Point-Modus verwenden moechten, koennen Sie ihn mit den Standardwerten belassen oder mit dem Bereich WiFi konfigurieren unten aendern.

Die Optionen fuer den Access-Point-Modus im Bereich WiFi konfigurieren sind:

Nachdem Sie die erforderlichen Einstellungen eingegeben haben, druecken Sie Save und die Daten werden validiert. Wenn die Daten korrekt sind, wird eine gruene Meldung angezeigt. Wenn die Meldung rot ist, korrigieren Sie den Fehler und druecken Sie erneut Save. Nach erfolgreichem Speichern druecken Sie Reboot und das SharpKey startet neu und wechselt sofort in den WiFi-Modus zur Datenbestaetigung.

Der SharpKey-Werkszustand startet automatisch im Access-Point-Modus, wenn WiFi aktiviert wird. Folgen Sie der Access-Point-Modus-Konfiguration, bis Sie den SharpKey-Statusbildschirm sehen, und folgen Sie dann den Anweisungen unten.

Klicken Sie auf die Option 'WiFi Manager' im linken Seitenleistenmenue. Dies startet den WiFi-Manager-Konfigurationsbildschirm:

Sie haben nun die Wahl, das SharpKey als Access Point zu konfigurieren (folgen Sie den Anweisungen Access-Point-Modus konfigurieren) oder im Client-Modus zu konfigurieren. Wenn Sie sich fuer den Client-Modus entscheiden, klicken Sie auf den Radio-Button Client und der Bereich WiFi konfigurieren wird aktualisiert, um Client-Parameter anzufordern. Es gibt zwei Client-Betriebsmodi: DHCP aktiviert, bei dem der Router alle Netzwerkverbindungsinformationen bereitstellt, oder DHCP deaktiviert, bei dem Sie Netzwerkparameter manuell angeben. Die anfaenglich im Bereich WiFi konfigurieren angeforderten Parameter sind unten aufgefuehrt:

Sollten Sie den DHCP-deaktivierten Modus verwenden, werden zusaetzliche Parameter im Bereich WiFi konfigurieren angefordert:

Nachdem Sie den korrekten Betriebsmodus eingestellt und die angeforderten Parameter eingegeben haben, druecken Sie Save und die Parameter werden validiert und aktualisiert. Bei gueltigen Parametern erscheint eine gruene Erfolgsmeldung. Bei ungueltigen Parametern erscheint eine rote Meldung mit Hinweis auf den Fehler. Nach erfolgreichem Speichern druecken Sie Reboot in der Seitenleiste und das SharpKey startet neu. Druecken Sie den WiFi-Schalter erneut, um den WiFi-Modus mit den neuen Einstellungen zu aktivieren. Wenn das SharpKey keine Verbindung zum Netzwerk herstellen kann, bleibt die LED an; andernfalls blinkt sie mehrmals kurz zur Bestaetigung. Wenn das SharpKey den WiFi-Modus nicht aktivieren kann, bleibt die LED an und nach 1 Minute wird neu gestartet. In diesem Fall druecken Sie den WiFi/BT-Konfigurationsschalter 5-8 Sekunden lang und es wechselt in den WiFi Access Point Modus mit Standardeinstellungen.

Das SharpKey ist mit einer Funktion ausgestattet, die Aktualisierungen seiner internen Firmware oder des Dateisystems ermoeglicht. Firmware oder Dateisystem koennen fuer neue Funktionen oder zur Behebung bekannter Fehler aktualisiert werden. Um die OTA-Update-Funktion zu nutzen, greifen Sie auf die Web-Oberflaeche ueber die Access Point/Client-Informationen oben zu und oeffnen Sie einen Browser, um die Statusseite zu laden:

Klicken Sie auf die Option OTA Update im linken Seitenleistenmenue. Dies startet den OTA-Update-Konfigurationsbildschirm:

Der OTA-Update-Bildschirm zeigt 4 Bereiche:

• einen Versionsinformationen-Bereich mit den installierten Firmware-Modulen und deren Versionsnummern.
• einen ESP32 Partitions-Bereich mit dem Layout des NVS Flash RAM auf dem ESP32 SoC. Das SharpKey verwendet ein fehlertolerantes Update-System im Round-Robin-Verfahren. Wenn die aktuelle Firmware auf Partition ota_0 laeuft, werden Updates auf ota_1 geschrieben. Bei Startfehler wird automatisch auf ota_0 zurueckgerollt. Dies gilt nicht fuer das Dateisystem filesys - bei einem fehlgeschlagenen Update kann das Dateisystem beschaedigt werden und die Web-Oberflaeche funktioniert nicht mehr.
• einen Firmware Upload-Bereich zum Auswaehlen und Hochladen einer neuen Firmware-Datei.
• einen File Pack Upload-Bereich zum Auswaehlen und Hochladen eines neuen Dateisystem-Images.

Um die Firmware zu aktualisieren, klicken Sie auf Select file im Bereich Firmware Upload und waehlen Sie ein gespeichertes oder heruntergeladenes Firmware-Image. Eine Validierung erfolgt vor der Programmierung, sodass das SharpKey ein falsches Image ablehnt. Die Validierung prueft auch die Version und blockiert das Update, wenn die gewaehlte Version mit der aktuellen Firmware identisch ist.

Klicken Sie auf Upgrade, wenn Sie bereit sind, die neue Firmware hochzuladen und zu flashen, oder auf Cancel, um die gewaehlte Datei zu loeschen. Nach dem Druecken von Upgrade beginnt der Update-Vorgang:

Nach erfolgreichem Upload erscheint eine gruene Erfolgsmeldung mit der Empfehlung, einen Neustart durchzufuehren. Bei einer roten Meldung starten Sie das SharpKey neu und versuchen Sie den Firmware-Upload erneut. Der Ausfallsicherungsmechanismus ueberschreibt nie die aktuelle Firmware.

Um das Dateipaket (das Dateisystem mit Tastenzuordnungsabbildern und Webserver-Dateien) zu aktualisieren, klicken Sie auf Select file im Bereich File Pack Upload und waehlen Sie ein gespeichertes oder heruntergeladenes Dateipaket-Image.

Klicken Sie auf Upgrade, wenn Sie bereit sind, oder auf Cancel, um die gewaehlte Datei zu loeschen. Nach dem Druecken von Upgrade beginnt der Update-Vorgang:

Nach erfolgreichem Upload erscheint eine gruene Erfolgsmeldung mit der Empfehlung, einen Neustart durchzufuehren. Bei einer roten Meldung starten Sie das SharpKey neu und versuchen Sie den Dateipaket-Upload erneut. Wenn ein Dateipaket-Update fehlschlaegt und das SharpKey den WiFi-Modus nicht aktivieren kann, ist das Dateisystem wahrscheinlich beschaedigt. Das SharpKey-Interface funktioniert weiterhin, aber kein Zugriff auf die Web-Oberflaeche ist moeglich. Zur Korrektur muss eine externe Programmiersonde an das SharpKey angeschlossen werden. Stellen Sie sicher, dass waehrend eines Uploads die Stromversorgung nicht unterbrochen wird.

Die Host-Konfigurationsseite ermoeglicht es Ihnen, die automatische Host-Maschinen-Erkennung des SharpKey zu uebersteuern. Standardmaessig analysiert der Adapter elektrische Signale vom Host-Anschluss beim Einschalten, um die angeschlossene Maschine zu bestimmen (Auto-Modus). Wenn die automatische Erkennung fuer Ihre Maschine nicht zuverlaessig funktioniert, koennen Sie den Host-Typ manuell auf dieser Seite auswaehlen. Verfuegbare Modi:

• Auto (Standard) -- der Adapter erkennt den Host automatisch beim Einschalten.
• Sharp MZ-2500
• Sharp MZ-2800
• Sharp X1 / X1 Turbo
• Sharp X68000
• Sharp MZ-5500 / MZ-5600 / MZ-6500
• NEC PC-9801
• Mouse -- Nur-Maus-Modus (keine Tastaturemulation).

Waehlen Sie den gewuenschten Modus und klicken Sie auf Save. Die Einstellung wird im nichtfluechtigen Speicher gespeichert und tritt beim naechsten Einschalten in Kraft. Um zur automatischen Erkennung zurueckzukehren, waehlen Sie Auto und speichern Sie.

Um nicht zugeordnete Tastenkombinationen oder Tastaturen mit unterschiedlichem Layout, Konfiguration und Scancodes zu verarbeiten, ermoeglicht das SharpKey die Bearbeitung von Tastenzuordnungen. Die Tastenzuordnungen koennen ueber den integrierten Tastenzuordnungseditor oder ueber eine lokale Datei-Speichern-Bearbeiten-Hochladen-Prozedur mit einem Tool wie dhex aktualisiert werden. Wenn die Tastenzuordnungsdatei beschaedigt wird, koennen Sie ein Backup von einer lokalen Datei hochladen oder das SharpKey die interne Standardzuordnung neu laden lassen. Angesichts der Unterschiede zwischen den verschiedenen unterstuetzten Maschinen unterscheiden sich der Tastenzuordnungseditor und seine Daten pro Modell. Unten folgt ein Abschnitt fuer jede Maschine, der die Zuordnungslogik und die Verwendung des Editors beschreibt. Die Tastenzuordnung kann nur fuer den aktiven Host bearbeitet werden, der beim Start des SharpKey erkannt wurde. Der grundlegende Tastenzuordnungseditor, der allen unterstuetzten Hosts gemeinsam ist, basiert auf einer Hex-Eingabetabelle mit Zuordnungsprioritaet von oben nach unten, wobei jeder Eintrag eine Tastenzuordnung angibt. Daten koennen in Hex- oder Dezimalwerten eingegeben werden. Um den Tastenzuordnungseditor des aktiven Hosts aufzurufen, starten Sie die Web-Oberflaeche und oeffnen Sie einen Browser, um die Statusseite zu laden:

Klicken Sie auf die Option <HOST> KeyMap im linken Seitenleistenmenue. Dies startet den Tastenzuordnungseditor fuer den aktiven Host:

Es gibt 2 Bereiche im Tastenzuordnungseditor: einen fuer die direkte Eingabe und Bearbeitung der Zuordnungswerte und einen zweiten zum Speichern und Laden einer Zuordnungsdatei auf eine lokale Festplatte. Im Bereich KeyMap Editor wird eine Tabelle basierend auf responsiver Technologie angezeigt. Verwenden Sie das Maus-Scrollrad zum Scrollen oder die TAB/Cursor-Tasten zum Links- und Rechtsscrollen. Die Tabellenkoepfe unterscheiden sich je nach aktivem Host und werden in den folgenden Host-Abschnitten naeher beschrieben. Der Editor kann Zeilen hinzufuegen, loeschen, tauschen, Aenderungen speichern oder neu laden:

• Um eine Zeile hinzuzufuegen, klicken Sie auf das gruene + Symbol.
• Um eine einzelne Zeile zu loeschen, klicken Sie auf das rote - Symbol auf der zu loeschenden Zeile.
• Um mehrere Zeilen zu loeschen, klicken Sie auf die Kontrollkaestchen rechts neben jeder zu loeschenden Zeile und druecken Sie Delete.
• Um ZWEI Zeilen zu tauschen, markieren Sie die Kontrollkaestchen der beiden Zeilen und druecken Sie Swap.
• Um die Zuordnung zu speichern, klicken Sie auf Save, wenn Aenderungen vorgenommen wurden.
• Um alle Aenderungen zu verwerfen, klicken Sie auf Reload.

Meldungen werden im Statusfeld oberhalb der Schaltflaechen angezeigt. Bitte sehen Sie die folgenden Abschnitte fuer spezifischere Details.

Die MZ-2500- und MZ-2800-Modelle verwenden eine gemeinsame Tastenzuordnungstabelle. Wie bei anderen unterstuetzten Host-Maschinen ermoeglicht die Zuordnung die Ausrichtung auf ein bestimmtes Tastaturmodell (z.B. Wyse KB-3296) und eine bestimmte Host-Variante (z.B. MZ-80B auf einem MZ-2500). Die MZ-2500/MZ-2800-Maschinen verwenden eine Tastatur basierend auf einer 13x8 oder 14x8 Tastenmatrix, bei der alle inaktiven Tasten logisch 1 sehen und eine aktive Taste logisch 0 sieht. Die MZ-2500-Tastaturmatrix kann in den folgenden Tabellen und dem Bild zusammen mit dem Tastaturlayout visualisiert werden.

    MZ-2500 Keyboard Map.
    
     Row     D7        D6        D5        D4        D3        D2        D1        D0
    ----------------------------------------------------------------------------------
      0      F8        F7        F6        F5        F4        F3        F2        F1
      1      KP -      KP +      KP .      KP ,      KP 9      KP 8      F1O       F9
      2      KP 7      KP 6      KP 5      KP 4      KP 3      KP 2      KP 1      KP 0
      3      BREAK     RIGHT     LEFT      DOWN      UP        RETURN    SPACE     TAB
      4       G         F         E        D         C         B         A         / ?
      5       O         N         M        L         K         J         I         H
      6       W         V         U        T         S         R         Q         P
      7       , <       . >       _        YEN |     ^ '       Z         Y         X  
      8       7 '       6 &       5 %      4 $       3 #       2 "       1 !       0
      9                 [ {       @ `      - =       ; +       : *       9 )       8 (
     10       KP /      KP *      ESC      BACKSPACE INST/DEL  CLR/HOME  COPY      ] }
     11                                    CTRL      KANA      SHIFT     LOCK      GRAPH
     12                                                                  KJ2       KJ1 
     13                                                                  HELP      ARGO 
    
     Col      0        1         2         3         4         5         6         7        8        9        10       11       12      13
     --------------------------------------------------------------------------------------------------------------------------------------
     D0       F1       F9        KP 0      TAB       / ?       H         P         X        0        8 (      ] }      GRAPH    KJ1     ARGO
     D1       F2       F10       KP 1      SPACE     A         I         Q         Y        1 !      9 )      COPY     LOCK     KJ2     HELP
     D2       F3       KP 8      KP 2      RETURN    B         J         R         Z        2 "      : *      CLR/HOME SHIFT
     D3       F4       KP 9      KP 3      UP        C         K         S         ^        3 #      ; +      INST/DEL KANA
     D4       F5       KP ,      KP 4      DOWN      D         L         T         YEN |    4 $      - =      BACKSPACE CTRL
     D5       F6       KP .      KP 5      LEFT      E         M         U         _        5 %      @ `      ESC
     D6       F7       KP +      KP 6      RIGHT     F         N         V         . >      6 &      [ {      KP *
     D7       F8       KP -      KP 7      BREAK     G         O         W         , <      7 '               KP /

Die MZ-2800-Tastaturmatrix kann in den folgenden Bildern visualisiert werden:

Eine PS/2-Taste (Bluetooth-Tastaturen werden intern auf PS/2-Tasten abgebildet) erfordert moeglicherweise die Aktivierung eines oder mehrerer Zeilen/Spalten-Paare in der Tastaturmatrix UND moeglicherweise die Deaktivierung eines anderen Zeilen/Spalten-Paares. Hierzu werden 14 Parameter pro einzelne Tastenzuordnung bereitgestellt. Der Zuordnungsprozess durchlaeuft die Zuordnungstabelle von oben nach unten bei jedem PS/2-Tastendruck. Bei Uebereinstimmung wird die MZ-2500/2800-Ausgangsmatrix aktualisiert. Es koennen bis zu 3 Matrixbits (3 Tastendrucke) pro PS/2-Taste gesetzt und bis zu 2 Matrixfreigaben pro PS/2-Taste konfiguriert werden. Die folgende Tabelle beschreibt jeden konfigurierbaren Parameter:

Alle Zuordnungsparameter werden im Editor in HEX-Notation angezeigt:

Die Dateneingabe kann in HEX- oder DEZIMAL-Notation erfolgen, indem Sie auf eine Spalte klicken und einen Wert eingeben. Details fuer jede Spalte und die erforderlichen Eingabewerte finden Sie unten. PS/2 KeyCode - Diese Spalte erwartet einen PS/2- oder Bluetooth-Tastatur-Scancode. Z.B. hat die Taste A den generischen Scancode-Wert 0x1C. PS/2-Scancodes koennen durch mehrere Bytes dargestellt werden, verwenden Sie nur das primaere Byte und ignorieren Sie erweiterte Code-Sequenzen wie E0/E1/F0. PS/2 Control Key - Dieser Parameter gibt an, welche Modifikator-Tasten zusammen mit dem PS/2-Scancode gedrueckt werden:

Modifier Key	Value	Modifier Key	Value	Modifier Key	Value	Modifier Key	Value
SHIFT	0x01	CTRL	0x02	CAPS	0x04	ALT	0x08
ALTGR	0x10	GUI	0x20	FUNC	0x40	BREAK	0x80

Ein Popover-Auswahlliste wurde diesem Feld hinzugefuegt. Wenn Sie in das Feld klicken, erscheint ein Popover. Klicken Sie auf die gewuenschten Modifikator-Tasten.

For Keyboard - Diese Spalte erwartet einen 8-Bit-Wert, wobei jedes Bit ein unterstuetztes Tastaturmodell angibt. Ein Wert von 255 (0xFF) aktiviert die Zuordnung fuer alle Tastaturmodelle.

Keyboard Model	Value	Keyboard Model	Value	Keyboard Model	Value	Keyboard Model	Value
UK WYSE KB3926	0x01	JAPAN OADG109	0x02	JAPAN Sanwa SKB-L1	0x04	Keyboard 4	0x08
Keyboard 5	0x10	Keyboard 6	0x20	UK Periboard 810 (BT)	0x40	UK OMOTON K8508 (BT)	0x80

For Host Model - Diese Spalte erwartet einen 8-Bit-Wert, wobei jedes Bit ein Maschinenmodell angibt. Ein Wert von 255 (0xFF) bedeutet alle Host-Modelle.

Host Model	Value	Host Model	Value	Host Model	Value	Host Model	Value
MZ80B	0x01	MZ2000	0x02	MZ2500	0x04	MZ2800	0x08

Make Row 1, Row 2, Row 3, Break Row 1, Row 2 - Diese Spalte erwartet einen 4-Bit-Wert, der eine Strobe-Zeile von 0 bis 15 darstellt. Ein Wert von 255 (0xFF) bedeutet, dass der Parameter nicht verwendet wird.

Die folgende Tabelle beschreibt die Standardzuordnung in einem leicht verstaendlichen Format.

Die Sharp X1 Serie umfasst X1, X1 Turbo und X1 Turbo Z. Die Zuordnung ist konventioneller, da ein PS/2-Scancode auf einen X1-Scancode abgebildet wird, anstatt auf eine Tastenmatrix wie bei den Sharp MZ-Maschinen. Der X1 erfordert einen 8-Bit-Tastencode plus einen 8-Bit-Modifikatorcode. Die Turbo/Turbo Z Serie hat einen Modusschalter: Modus A (Original) und Modus B, wobei Modus B eine schnellere 24-Bit-Antwort fuer Spiele sendet.

Modus A wird fuer alle Sharp X1 Modelle verwendet. Er sendet Tastendaten als ASCII-Code + Steuermodifikator-Tasten im Format <Control Bits><Ascii Key Code>. Die Bitwerte fuer das Steuerbyte koennen in der folgenden Tabelle gesehen werden und verwenden negative Logik, d.h. 0 ist aktiv, 1 ist inaktiv.

Modus B ist fuer Spiele gedacht und sendet einen Teilsatz von Tasten als direkte 24-Bit-Darstellung. Die Daten werden im Format <BYTE1><BYTE2><BYTE3> gesendet.

Die folgende Tabelle beschreibt jeden konfigurierbaren Parameter:

Die Dateneingabe kann in HEX- oder DEZIMAL-Notation erfolgen. Details fuer die Spalten finden Sie unten. PS/2 KeyCode - Erwartet einen PS/2- oder Bluetooth-Tastatur-Scancode. PS/2 Control Key - Modifikator-Tasten fuer den Abgleich:

Modifier Key	Value	Modifier Key	Value	Modifier Key	Value	Modifier Key	Value
SHIFT	0x01	CTRL	0x02	CAPS	0x04	KANA	0x08
GRAPH	0x10	GUI	0x20	FUNC	0x40	BREAK	0x80

For Keyboard - 8-Bit-Wert fuer Tastaturmodelle. 255 (0xFF) aktiviert alle Modelle.

Keyboard Model	Value	Keyboard Model	Value	Keyboard Model	Value	Keyboard Model	Value
UK WYSE KB3926	0x01	JAPAN OADG109	0x02	JAPAN Sanwa SKB-L1	0x04	Keyboard 4	0x08
Keyboard 5	0x10	Keyboard 6	0x20	UK Periboard 810 (BT)	0x40	UK OMOTON K8508 (BT)	0x80

For Host Model - 8-Bit-Wert fuer Maschinenmodelle. 255 (0xFF) = alle Modelle.

Host Model	Value	Host Model	Value	Host Model	Value	Host Model	Value
Sharp X1 Original	0x01	Sharp X1 Turbo	0x02	Sharp X1 TurboZ	0x04

X1 Mode - Gibt den Betriebsmodus an. Mode A: KeyCode 1 und Control Key aktiv. Mode B: KeyCode 1 (BYTE1), KeyCode 2 (BYTE2), Control Key (BYTE3) aktiv.

Mode	Value	Mode	Value
Mode A	0x01	Mode B	0x02

X1 Control Key - Modifikator-Tasten, die zusammen mit dem X1 KeyCode an den Sharp X1 gesendet werden:

Modifier Key	Value	Modifier Key	Value	Modifier Key	Value	Modifier Key	Value
SHIFT	0x01	CTRL	0x02	CAPS	0x04	KANA	0x08
GRAPH	0x10	GUI	0x20	FUNC	0x40	BREAK	0x80

Die folgende Tabelle beschreibt die Standardzuordnung in einem leicht verstaendlichen Format.

Die Sharp X68000 Serie umfasst die Modelle Original, ACE, Expert, Super, Pro, XVI, Compact und 68030. Die Zuordnung ist konventionell und aehnlich dem PS/2-Protokoll, d.h. bei jedem Tastendruck wird ein Scancode ueber eine asynchrone serielle Leitung gesendet. Unten sind das X68000-Tastaturlayout und die Scancodes pro Taste zu sehen.

X68000 Scan Codes
,---. ,---.    ,-------------------,    ,-------------------.  ,-----------. ,---------------.
| 61| | 62|    | 63| 64| 65| 66| 67|    | 68| 69| 6A| 6B| 6C|  | 5A| 5B| 5C| | 5D| 52| 53| 54|
`---' `---'    `-------------------'    `-------------------'  `-----------' `---------------'
,-----------------------------------------------------------.  ,-----------. ,---------------.
| 01| 02| 03| 04| 05| 06| 07| 08| 09| 0A| 0B| 0C| 0D| 0E| 0F|  | 36| 5E| 37| | 3F| 40| 41| 42|
|-----------------------------------------------------------|  |------------ |---------------|
|  10 | 11| 12| 13| 14| 15| 16| 17| 18| 19| 1A| 1B| 1C|     |  | 38| 39| 3A| | 43| 44| 45| 46|
|------------------------------------------------------. 1D |  `---=====---' |---------------|
|  71  | 1E| 1F| 20| 21| 2l| 23| 24| 25| 26| 27| 28| 29|    |   ___| 3C|___  | 47| 48| 49| 4A|
|-----------------------------------------------------------|  | 3B|---| 3D| |-----------|---|
|  70    | 2A| 2B| 2C| 2D| 2E| 2F| 30| 31| 32| 33| 34|   70 |  `---| 3E|---' | 4B| 4C| 4D|   |
`-----------------------------------------------------------|  .---=====---. |-----------| 4E|
       | 5F| 55 | 56 |     35     | 57 | 58 | 59 | 60|         |  72 |  73 | | 4F| 50| 51|   |
       `---------------------------------------------'         `-----------' `---------------'

Die folgende Tabelle beschreibt jeden konfigurierbaren Parameter:

Die Dateneingabe kann in HEX- oder DEZIMAL-Notation erfolgen. Details finden Sie unten. PS/2 KeyCode - Erwartet einen PS/2- oder Bluetooth-Scancode. PS/2 Control Key - Modifikator-Tasten:

Modifier Key	Value	Modifier Key	Value	Modifier Key	Value	Modifier Key	Value
SHIFT	0x01	CTRL	0x02	CAPS	0x04	KANA	0x08
GRAPH	0x10	GUI	0x20	FUNC	0x40	BREAK	0x80

For Keyboard - 8-Bit-Wert. 255 (0xFF) aktiviert alle Modelle.

Keyboard Model	Value	Keyboard Model	Value	Keyboard Model	Value	Keyboard Model	Value
UK WYSE KB3926	0x01	JAPAN OADG109	0x02	JAPAN Sanwa SKB-L1	0x04	Keyboard 4	0x08
Keyboard 5	0x10	Keyboard 6	0x20	UK Periboard 810 (BT)	0x40	UK OMOTON K8508 (BT)	0x80

For Host Model - 8-Bit-Wert. 255 (0xFF) = alle Modelle.

Host Model	Value	Host Model	Value	Host Model	Value	Host Model	Value
X68000 Original	0x01	ACE	0x02	Expert	0x04	Super	0x08
Pro	0x10	XVI	0x20	Compact	0x40	68030	0x80

X68K KeyCode - Der an den X68000 gesendete Tastencode. X68K Control Key - Modifikator-Tasten, die an den X68000 gesendet werden:

Modifier Key	Value	Modifier Key	Value	Modifier Key	Value	Modifier Key	Value
SHIFT	0x80	RELEASESHIFT	0x40	SHIFT	0x01

Die folgende Tabelle beschreibt die Standardzuordnung in einem leicht verstaendlichen Format.

Tastenkombinationen sind spezielle Tastenkombinationen zum Aktivieren/Deaktivieren einer Tastaturfunktion. Wenn eine Funktion ueber eine Tastenkombination ausgewaehlt wird, wird sie im permanenten Speicher gespeichert und bleibt ueber Ein-/Ausschaltzyklen hinweg aktiv. Die folgenden Tastenkombinationen sind derzeit definiert:

Die Bedeutung der Tastenkombinationen ist die Zuordnungsfilterung. Wenn das Tastaturmodell als KB-3926 ausgewaehlt ist, sind nur Zuordnungseintraege aktiv, die das Tastaturmodell als KB-3926 oder STANDARD haben. Dies ermoeglicht die Erstellung sehr spezifischer Tastenzuordnungen pro Tastaturmodell, Maschinentyp und Modell.

Das SharpKey kann bei Verwendung als Maus-Interface Mausparameter sowohl auf der PS/2- als auch auf der Host-Seite konfigurieren. Bluetooth-Maeuse teilen die PS/2-Konfigurationswerte. Die grundlegende Konfiguration kann mit der Maus selbst durch Druecken des Scrollrads fuer eine bestimmte Zeitdauer vorgenommen werden:

Der Wert wird durch Scrollen des Scrollrads vorwaerts (erhoehen) oder rueckwaerts (verringern) geaendert. Wenn der gewuenschte Wert eingestellt ist, klicken Sie auf das Scrollrad, um den Wert dauerhaft zu speichern. Eine weitere Moeglichkeit ist die webbasierte Maus-Konfiguration:

Klicken Sie auf Mouse Config im linken Seitenleistenmenue:

Der Maus-Konfigurationsbildschirm zeigt 2 Bereiche:

Mouse Host Configuration Dieser Bereich bietet eine Option: Einstellung der Host-seitigen Skalierung der PS/2-Bewegungsdaten. Mouse PS/2 Configuration Dieser Bereich bietet 3 konfigurierbare Optionen:

Nach Einstellung der gewuenschten Werte druecken Sie 'Save', um die Aenderungen dauerhaft zu speichern.

Bei der Entwicklung dieses Tastatur-Interfaces wurden die Espressif IDF-Entwicklungsumgebung und ESP-32S-Referenzmaterialien verwendet.

Dieses Design, Hardware und Software, ist unter der GNU Public Licence v3 lizenziert.

Ohne ausdrueckliche Genehmigung des Autors darf dieses Design oder eine seiner Hardware-/Firmware-Komponenten nicht kommerziell genutzt werden. Diese Bedingung hat Vorrang vor allen durch die GNU GPL 3-Lizenz gewaehrten Rechten.

Die in diesem Projekt als GPL v3 gekennzeichneten Quell- und Binaerdateien sind freie Software: Sie koennen sie unter den Bedingungen der GNU General Public License weiterverbreiten und/oder modifizieren, entweder in Version 3 der Lizenz oder (nach Ihrer Wahl) jeder spaeteren Version.

Die Quelldateien werden in der Hoffnung verbreitet, dass sie nuetzlich sein werden, jedoch OHNE JEDE GEWAEHRLEISTUNG. Weitere Details finden Sie in der GNU General Public License.

Sie sollten eine Kopie der GNU General Public License zusammen mit diesem Programm erhalten haben. Wenn nicht, siehe http://www.gnu.org/licenses/.

Dieses Geraet enthaelt ein vorzertifiziertes ESP32-S Funkmodul (AI Thinker), das im 2,4 GHz ISM-Band sendet und somit weltweit als absichtlicher Strahler gemaess den Hochfrequenzvorschriften gilt (einschliesslich FCC Part 15 Subpart C in den USA und der Funkanlagenrichtlinie 2014/53/EU in der Europaeischen Union). Das ESP32-S-Modul wird unmodifiziert verwendet und verfuegt ueber eigene regulatorische Zertifizierungen (FCC, CE und andere). Diese Zertifizierungen auf Modulebene erstrecken sich jedoch nicht automatisch auf ein Fertigprodukt, das das Modul enthaelt. Die Ausnahmeregelung fuer vorzertifizierte Module erlaubt es einzelnen Hobbybastlern, eine begrenzte Anzahl von Geraeten fuer den persoenlichen, experimentellen oder Bildungszweck zu bauen. Wichtige Einschraenkungen

• Zusammengebaute Geraete duerfen nicht an Dritte verkauft, zum Verkauf angeboten, verschenkt oder anderweitig verteilt werden, es sei denn, das Fertigprodukt hat eine eigene Geraetezulassung erhalten.
• Der Bau fuer den persoenlichen Gebrauch in begrenzter Stueckzahl ist im Allgemeinen im Rahmen von Hobbyisten- und Experimentierbestimmungen erlaubt (z.B. FCC § 15.23), vorausgesetzt, das Geraet verursacht keine schaedlichen Stoerungen.
• Die regulatorischen Anforderungen variieren je nach Land. Erbauer ausserhalb der Vereinigten Staaten sollten die geltenden Vorschriften bei ihrer nationalen Funkfrequenzbehoerde erfragen.

Verantwortung des Erbauers
Es liegt in der alleinigen Verantwortung des Erbauers sicherzustellen, dass jedes aus diesen Entwuerfen konstruierte Geraet allen geltenden Hochfrequenzvorschriften entspricht. Der Autor stellt diese Entwuerfe fuer den persoenlichen, Bildungs- und Hobbygebrauch zur Verfuegung.