SharpKey Interfaccia Multi-HID Manuale Utente
Lo SharpKey
Il nome SharpKey deriva da Sharp Keyboard Interface, poiche e basato sull'originale mz25key Sharp MZ-2500/MZ-2800 PS/2 Keyboard Interface.
Lo SharpKey Multi-HID Interface e un dispositivo che consente la connessione di tastiere e mouse, tramite PS/2 o Bluetooth, a computer Sharp e NEC vintage. E alloggiato in un piccolo case KM-24 nero o grigio chiaro e dispone di due porte esterne: una per tastiera o mouse PS/2 e la seconda per un cavo di collegamento alla presa di ingresso tastiera o mouse dell'host. Con Bluetooth, la porta PS/2 non viene utilizzata.
In funzionamento, lo SharpKey e alimentato dall'host, con un consumo tipico di 30mA in modalita interfaccia attiva, fino a 150mA con interfaccia web IoT abilitata. La corrente di picco istantanea per WiFi puo raggiungere 250mA.
Questa sezione descrive le porte, le interfacce, i pulsanti e i LED dello SharpKey.
Porte
Lo SharpKey e dotato di due porte femminili mini-DIN, un LED e un interruttore di configurazione. L'immagine seguente mostra le posizioni.
A sinistra c'e il connettore HOST, una presa femminile mini-DIN a 8 pin. A destra c'e il connettore PS/2, una presa femminile mini-DIN a 6 pin. Questa porta supporta l'hot-swap.
A sinistra c'e il connettore HOST, una presa femminile mini-DIN a 8 pin. A destra c'e il connettore PS/2, una presa femminile mini-DIN a 6 pin. Questa porta supporta l'hot-swap.
Internamente c'e un connettore header a 8 pin 2mm, utilizzato per recupero firmware o sviluppo.
LED
Il LED blu di attivita indica il funzionamento del dispositivo e avvisa di errori o stato.
| Stato LED | Occorrenza | Descrizione |
|---|---|---|
| Acceso | All’accensione | Si accende per 1 secondo poi si spegne. Avvio e inizializzazione normali. |
| Uso normale | Tastiera o mouse PS/2 non collegato, dispositivo Bluetooth non accoppiato. | |
| Spento | All’accensione | Guasto del dispositivo. |
| Uso normale | Dispositivo in funzionamento normale. | |
| Lampeggiante | Uso normale | Il LED lampeggia brevemente ad ogni pressione di tasto. |
| Selezione WiFi | Lampeggio a 0,5s quando il tasto WiFi e premuto per piu di 2 secondi. | |
| Accoppiamento BT | Lampeggio a 0,125s quando premuto per piu di 10 secondi. | |
| Reset NVS | Lampeggio lungo 1 volta al secondo quando premuto per piu di 15 secondi. |
Interruttori
L'interruttore di configurazione WiFi/Bluetooth si trova all'interno del case SharpKey, accessibile tramite un foro sul coperchio.
| Durata pressione | LED | Funzionalita |
|---|---|---|
| 1 secondo | Spento. | Annullare qualsiasi funzionalita selezionata. |
| 2 pressioni in 1 secondo | SharpKey si riavvia. | Riavviare lo SharpKey. |
| 2 - 4 secondi | Lampeggia 2 volte al secondo. | Selezionare la modalita WiFi configurata. |
| 5 - 9 secondi | Lampeggia 4 volte al secondo. | Selezionare la modalita Access Point predefinita. |
| 10 - 14 secondi | Lampeggia 8 volte al secondo. | Selezionare la modalita di accoppiamento Bluetooth. |
| 15 - 19 secondi | Un lampeggio lungo al secondo. | Selezionare la modalita Reset NVS. |
Cavi
Ogni macchina host ha specifiche diverse. Il SharpKey gestisce i requisiti elettrici e di protocollo, ma il requisito meccanico deve essere soddisfatto con un cavo fisico specifico per ogni host.
Collegamento dello SharpKey
Collegare lo SharpKey e semplice: procurarsi il cavo corretto, collegare il connettore mini-DIN a 8 pin allo SharpKey e l'altra estremita alla porta tastiera o mouse dell'host.
NB. Il Bluetooth sara abilitato solo quando nessun dispositivo PS/2 e collegato.
NB. Il firmware include un meccanismo di retry per il rilevamento della tastiera PS/2 -- fino a 10 tentativi con ritardi di 100ms.
Accoppiamento Bluetooth
Per utilizzare il Bluetooth, nessun dispositivo PS/2 deve essere collegato. Il ricetrasmettitore Bluetooth dell'ESP32 ha una portata limitata (~1m). Alla ricezione o dopo un reset NVS, lo SharpKey esegue una scansione Bluetooth. Premere il pulsante di accoppiamento sul dispositivo e la connessione si stabilira in 5-10 secondi senza PIN.
Fino a 5 dispositivi possono essere accoppiati premendo l'interruttore WiFi/Config per 10-15 secondi. Se richiesto un PIN, inserire '1234'.
Accesso all'interfaccia web IoT
Lo SharpKey ha mappe tastiera preconfigurate (UK predefinito). Layout supportati: Wyse KB-3926 UK, Generic OADG109 Japanese, Sanwa SKB-L1 Japanese, Perixx Periboard 810 UK, OMOTON K8508 UK.
Due modalita WiFi: Access Point (lo SharpKey funge da router WiFi, rete sharpkey, password sharpkey) e Client (lo SharpKey si connette alla rete domestica).
Configurazione modalita Access Point
| Parametro | Valore |
|---|---|
| SSID | sharpkey |
| Password | sharpkey |
| Indirizzo IP | 192.168.4.1 |
Configurazione modalita Client
Per la modalita Client, cliccare su Client e inserire le credenziali di rete. Due sotto-modalita: DHCP abilitato o disabilitato.
Aggiornamenti OTA
Lo SharpKey consente l'aggiornamento del firmware o del file system tramite OTA. Cliccare su OTA Update nel menu laterale. Il sistema utilizza un aggiornamento fault-tolerant round robin tra le partizioni ota_0 e ota_1.
Configurazione host
Consente di sovrascrivere il rilevamento automatico dell'host. Modalita disponibili: Auto (predefinito), Sharp MZ-2500, MZ-2800, X1/X1 Turbo, X68000, MZ-5500/5600/6500, NEC PC-9801, Mouse.
Editor mappe tasti
Lo SharpKey consente la modifica delle mappe tasti tramite l'editor integrato o procedura locale di salvataggio-modifica-upload. L'editor di base utilizza una tabella esadecimale con priorita dall'alto verso il basso.
Sharp MZ-2500 / MZ-2800 Mappa tasti
I modelli MZ-2500 e MZ-2800 condividono una tabella di mappatura comune. Queste macchine utilizzano una matrice tastiera 13x8 o 14x8.
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
Sharp X1 Mappa tasti
La serie Sharp X1 include X1, X1 Turbo e X1 Turbo Z. La mappatura e piu convenzionale: un scancode PS/2 corrisponde a uno scancode X1. Il Turbo/Turbo Z ha Mode A (originale) e Mode B (gioco, 24 bit).
Sharp X68000 Mappa tasti
La serie Sharp X68000 include i modelli Original, ACE, Expert, Super, Pro, XVI, Compact e 68030. La mappatura e convenzionale, simile al protocollo PS/2.
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| |
`---------------------------------------------' `-----------' `---------------'
Scorciatoie da tastiera
Le scorciatoie da tastiera sono combinazioni speciali per abilitare/disabilitare funzionalita. I parametri vengono salvati in memoria permanente. Le combinazioni SHIFT+CTRL+ESC+numero selezionano modelli di tastiera e host specifici.
Configurazione mouse
Lo SharpKey in modalita interfaccia mouse consente la configurazione dei parametri del mouse sia lato PS/2 che lato host, tramite la rotella del mouse o l'interfaccia web.
Ringraziamenti
L'ambiente di sviluppo Espressif IDF e i materiali di riferimento ESP-32S sono stati utilizzati nella progettazione di questa interfaccia.
Licenze
Questo progetto e concesso in licenza sotto la GNU Public Licence v3. Nessun uso commerciale senza autorizzazione dell'autore.
Avviso sulle normative wireless
Questo dispositivo incorpora un modulo wireless ESP32-S pre-certificato (AI Thinker) che trasmette nella banda ISM 2,4 GHz. Le certificazioni a livello di modulo non si estendono automaticamente al prodotto finito. E responsabilita del costruttore garantire la conformita alle normative applicabili.