MZ-2500/2800 Interfaz de Teclado
Vision general
El mz25key es una interfaz de teclado dedicada para los ordenadores Sharp MZ-2500 y MZ-2800, basada en el microcontrolador ESP32 de doble nucleo. Traduce teclados PS/2 y Bluetooth HID modernos al protocolo matricial nativo MZ-2500/MZ-2800. El mz25key comparte su codigo fuente con el proyecto SharpKey multi-host pero se compila con una configuracion simplificada para MZ-2500 o MZ-2800. Nota: Este documento contiene contenido tecnico completo (protocolos, diagramas de temporizado, esquemas, listas de materiales, bloques de codigo) que permanece en ingles. Consulte la version inglesa para el contenido completo.
El diseno esta basado en el ESP-32S WROOM, un SoC de doble nucleo 240MHz WiFi/BT.
Firmware
Instalacion y build automatizados (recomendado)
macOS / Linux / WSL — setup_mz25key.sh
chmod +x setup_mz25key.sh
./setup_mz25key.sh
Detecta automaticamente su sistema operativo. Prefiere Docker (la imagen oficial espressif/idf:v4.4, una descarga unica de ~3 GB) y recurre a una instalacion nativa de ESP-IDF v4.4 cuando Docker no esta disponible.
Windows 10 / 11 — setup_mz25key_windows.ps1 (nativo, sin WSL ni Docker)
Set-ExecutionPolicy -Scope Process -ExecutionPolicy Bypass
.\setup_mz25key_windows.ps1
El script de Windows usa winget para instalar Git y (si es necesario) Python 3.10 en un entorno virtual aislado, luego instala la cadena de herramientas nativa ESP-IDF v4.4 para Windows de Espressif y compila el firmware. Tras una ejecucion correcta, la imagen del firmware esta en build/main.bin. Para ejecuciones desatendidas, MZ25KEY_REPO_URL define la URL del repositorio y MZ25KEY_BUILD fuerza el metodo de compilacion (docker o native).
Agradecimientos
El entorno Espressif IDF y los materiales ESP-32S fueron utilizados.
Licencias
Bajo GNU Public Licence v3. No se permite uso comercial sin autorizacion.