by

Índice general

Contenido 1

1. Introducción / Características. 2

1.1. Introducción . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2

1.2. Características . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2

2. Requisitos. 4

3. Instalación. 5

4. Instalación del programa BTYPER. 8

4.1. Formato ROM (BTYPER.ROM) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8

4.2. Formato BIN (BTYPER.BIN) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9

4.3. Formato COM (BTYPER.COM) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9

4.4. Formato DSK (BTYPER.DSK) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9

4.5. Formato CAS (BTYPER.CAS) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10

4.6. Formato WAV (BTYPER.WAV) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10

4.7. Requisitos mínimos. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10

4.8. Links. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11

5. Funcionamiento. 12

I

5.1. Modo Keyboard Only . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13

5.2. Modo GamePad Only . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14

5.3. Modo Multidevice (GamePad + Keyboard) . . . . . . . . . . . . . . . . . . . . . . . . 15

6. Mapeo del teclado. 17

6.1. Teclas especiales . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17

7. Cuestiones Frecuentes. 19

8. Contacto y créditos. 21

1

1

Introducción / Características.

1.1. Introducción

Black Typer es un interfaz y conjunto de programas gracias a los cuales una computadora MSX puedeser utilizada como teclado y/o gamepad compatible USB.

Gracias al interface podremos darle vida a ese viejo computador MSX al que no le damos utilizad,brindándonos la posibilidad de revivir, en un sistema actual, las mismas experiencias que disfrutamos connuestra primera computadora. Pero no solo eso, podremos utilizarlo en una gran variedad de dispositivos:

Ordenadores de placa única, como Raspberry Pi.

Tablets y Smartphones.

Consolas (Playstation, Wii, Xbox)

Smart TVs.

Cualquier dispositivo que soporte un teclado externo USB.

Teclado/Joystick para emuladores.

1.2. Características

Las características principales de Black Typer son:

Compatible con cualquier modelo de MSX.

Soporte de HID Boot Protocol y HID Report Protocol en modo Keyboard Only.

Protocolo de comunicación asíncrono, no necesita sincronización inicial con el MSX.

Modos de funcionamiento, Keyboard Only, Gamepad Only y combo (multidispositivo) Keyboard+ Gamepad

2

1.2. CARACTERÍSTICAS

Soporte para joysticks MSX.

Cambio de modo en tiempo real.

Compatible con dispositivo USBTopia como joystick externo.

3

2

Requisitos.

Para la utilización de Black Typer serán necesarios estos requerimientos:

MSX con puerto de impresora funcional.

Programa BTYPER.

Slot/Subslot libre, si ejecutamos el programa desde un cartucho externo.

Reproductor de cassette, unidad de disco o cartucho flash, para la carga y ejecución del programa(en caso de no disponer del cartucho externo). 1

Cable USB A-TO-B, para la conexión del interface al dispositivo destino (no incluído). 2

1Necesario uno de ellos para la carga del programa BTYPER, en caso no de utilizar cartucho externo.2El cable para la conexión del interfaz con el dispositivo no está incluído, ni se vende por separado. No presenta

dificultad comprarlo en cualquier tienda de informática, electrónica o gran almacén.

4

3

Instalación.

Para utilizar su interfaz Black Typer, siga los siguientes pasos:

1. Asegúrese de que su computadora MSX está apagada.

2. Conecte el conector de impresora Centronics macho del interfaz al conector de impresora de suMSX.

3. Conecte el cable USB A-TO-B en la entrada USB hembra del interfaz y en el dispositivo destinodonde desee utilizar el MSX como teclado y/o gamepad. El indicador led comenzará, al cabo deunos segundos a parpadear. Esto significa que no se ha producido, todavía,la sincronización conel MSX.

4. Encienda su computadora MSX para ejecutar el programa BTYPER. Si lo tiene ya instalado en uncartucho externo, el indicador debería de dejar de parpadear cuando se produzca la sincronización.Su interfaz está listo para ser usado. En caso de tener que cargar el programa BTYPER, siga lassiguientes instrucciones.

Para más información sobre como conectar Black Typer, consulte el esquema de conexion de la figura3.2.

NOTA: Black Typer cuenta con un conector USB-Mini-female en su parte lateral, junto con elcable centronics macho, como el que se ve en la figura 3.1. Este conector está destinado a programary actualizar el dispositivo. El usuario no debe de utilizarlo nunca para conectar dispositivos en él o através de él.

5

Figura 3.1: Conector USB-Mini Female

Si no dispone del programa BTYPER en un cartucho externo, deberemos cargarlo, como se explica enel siguiente capítulo.

6

Figura 3.2: Esquema de conexión

7

4

Instalación del programa BTYPER.

El programa BTYPER se presenta en diferentes formatos, para garantizar que cualquier usuario puedaejecutarlo sin ningún tipo de restricción. BTYPER cuenta con las siguientes versiones:

ROM: Formato ROM compatible para grabar en un dispositivo flashrom o bien ejecutar con uncargador de ROMs, como ODO.

BIN: Formato binario compatible con MSX-BASIC, para cargar desde unidad de disco o dispositivode almacenamiento masivo.

COM: Formato ejecutable compatible con MSX-DOS, MSX-DOS2 y Nextor.

DSK: Imagen de disco. Puede ser ejeuctada con emuladores de disco, como Sofa Run It, desdeNextor o bien transfiriendo el contenido a un floppy disk.

CAS: Formato cassette para ser reproducido con programas como MSX2Cas o similares. Tambiénpara su posible conversión a fichero de audio para ser reproducido con un dispositivo externo.

WAV: Fichero de audio para reproducir con dispositivo externo, o bien ser grabado en un cassettepara reproducir con datarecorder compatible.

BTYPER, en todas sus versiones, y con una pequeña guía de manejo, puede ser descargado desde aquí:

http://alabs.tech/res/BTYPER.ZIP

4.1. Formato ROM (BTYPER.ROM)

El programa BTYPER.ROM puede ser ejecutado de dos maneras:

Mediante su grabación en una unidad flashrom externa.

Manualmente desde MSX-DOS con un cargador de ROMs.

8

4.2. FORMATO BIN (BTYPER.BIN)

Para utilizar el programa BTYPER manualmente necesitaremos de un MSX dotado de unidad de disco,MSX-DOS 1.0 (o superior) y el programa ODO o similar.

Para su ejecución:

1. Inserte, en su unidad de disco, un disco con arranque MSX-DOS 1.0 o superior, ODO.COM y elprograma BTYPER.ROM.

2. Desde la linea de comando ejecute: ODO BTYPER.ROM

Para la grabación en un dispositivo Flash-Rom externo consulte el manual de su dispositivo para losdetalles de carga.

4.2. Formato BIN (BTYPER.BIN)

Para ejecutar BTYPER.BIN necesitará una unidad de disco o dispositivo de almacenamiento masivo(como MegaFlashRom SCC+, LPESDMMC, MegaSCSI...).

1. Transfiera el programa BTYPER.BIN a su unidad de disco o sistema de almacenamiento masivo.

2. Desde el entorno MSX-BASIC ejecute BLOAD”BTYPER.BIN”,R

4.3. Formato COM (BTYPER.COM)

Para ejecutar BTYPER.COM necesitará una unidad de disco o dispositivo de almacenamiento masivo(como MegaFlashRom SCC+, LPESDMMC, MegaSCSI...).

1. Inserte, en su unidad de disco, un disco con arranque MSX-DOS 1.0 o superior y el programaBTYPER.COM.

2. Desde la linea de comando ejecute: BTYPER

4.4. Formato DSK (BTYPER.DSK)

Se presentandos dos opciones para ejecutar BTYPER en formato DSK:

1. Transferir el contenido del DSK a un floppy disk.

9

4.5. FORMATO CAS (BTYPER.CAS)

2. Ejecutar el fichero a través de un emulador de disco como el incluido en Nextor, MegaFlashROMSCC+,Sofa Run It o similar.

Si transfiere el contenido a un floppy disk:

1. Inserte el floppy disk en su MSX.

2. Arranque el MSX.

3. BTYPER cargará automáticamente.

4.5. Formato CAS (BTYPER.CAS)

1. Ejecute el programa cargador de ficheros .CAS, en su dispositivo externo (PC, Mac, Linux,Smartphone), como MSX2Cas.

2. Arranque su MSX y desde el entorno MSX-BASIC teclee: BLOAD”CAS:”,R

3. Siga las instrucciones para comenzar la carga en su programa cargador de .CAS. El programacargará automáticamente.

4.6. Formato WAV (BTYPER.WAV)

El fichero de audio WAV puede ser reproducido desde un dispositivo externo o bien almacenado en uncassette para su reproducción posterior via datarecorder.

Arranque su MSX y desde el entorno MSX-BASIC teclee: BLOAD”CAS:”,R

Pulse PLAY en su datarecorder o bien siga las instrucciones para reproducir el fichero de audioen su dispositivo externo.

El programa cargará automáticamente.

4.7. Requisitos mínimos.

Los requisitos mínimos para la ejecución de BTYPER dependen del formato utilizado.

ROM:

• Desde cartucho externo:

10

4.8. LINKS.

◦ MSX 8K RAM◦ SLOT LIBRE◦ Cartucho externo (flash rom o similar).

• Desde cargador de ROMs (ODO o similar).◦ MSX 16K RAM◦ Unidad de disco o dispositivo de almacenamiento masivo.

BIN:

• MSX 16K RAM• Unidad de disco o dispositivo de almacenamiento masivo.

COM:

• MSX 64K RAM• MSX-DOS o superior.• Unidad de disco o dispositivo de almacenamiento masivo.

DSK:

• Transferido a un floppy disk:◦ MSX 16K RAM◦ Unidad de disco o dispositivo de almacenamiento masivo.

• Desde emulador de disco:◦ MSX 128K RAM◦ Dispositivo de almacenamiento masivo con emulación de disco o programa emulador.

CAS:

• MSX 16K RAM• Programa cargador de ficheros .CAS• Cable de cassette compatible MSX.

WAV:

• MSX 16K RAM• Dispositivo para reproducir ficheros de audio .WAV.• Cable de cassette compatible MSX.

4.8. Links.

MSX2Cas MSX Cassette Loader: https://sites.google.com/site/msx2cas/home

ODO Rom Loader: http://msxbanzai.tni.nl/dev/ODOV04.LZH

BTYPER: http://alabs.tech/res/BTYPER.ZIP

11

5

Funcionamiento.

El programa BTYPER es el encargado de enviar al interface los comandos y/o pulsaciones de teclas/joysticksejecutados en su computadora MSX. Dependiendo el modo utilizado, BTYPER enviará al interface lainformación adecuada.

BTYPER permite, además de enviar los datos al interface Black Typer, configurar tanto al arranquedel programa, como dentro del mismo, los modos de funcionamiento y opciones extra, mediante lapulsación de determinadas teclas.

Configuración de modos y extras mientras arranca el programa:

• Mantenga pulsada SPACE durante el arranque para seleccionar el modo Keyboard Only.• Mantenga pulsada CTRL durante el arranque para seleccionar el modo GamePad only.• Mantenga pulsada CTRL + SPACE durante el arranque para seleccionar el modo Multidevice

Combo (GamePad + Keyboard).• Si mantiene pulsada la tecla TAB, en los modos Gamepad, se deshabilitará el teclado como

joystick y solo funcionarán los joysticks conectados a los ports como tales.• Si mantiene pulsada la tecla INS, en los modos Gamepad, se invertirá el uso del joystick

y Hat Switch. Es decir, los cursores y/o joystick funcionarán como Hat Switch y las teclasmapeadas como Hat Switch funcionarán como joystick.

Configuración de modos y extras durante la ejecución del programa:

• Pulse y suelte a la vez las teclas CAPS + CTRL + SHIFT para realizar el cambio de modo.• Durante el cambio de modo pulse la tecla TAB, en los modos Gamepad, se deshabilitará el

teclado como joystick y solo funcionarán los joysticks conectados a los ports como tales.• Durante el cambio de modo pulse la tecla INS, en los modos Gamepad, se invertirá el uso

del joystick y Hat Switch. Es decir, los cursores y/o joystick funcionarán como Hat Switch ylas teclas mapeadas como Hat Switch funcionarán como joystick.

El cambio de modo permutará por los 3 modos de configuración. 1

1El intertaz almacena siempre el último modo seleccionado, pero BTYPER no puede conocer cuál fue. Por eso mismo,si su ultimo modo almacenado fue, por ejemplo, Keyboard Only, la primera pulsación para cambiarlo volverá a poner elmismo modo, Keyboard Only.

12

5.1. MODO KEYBOARD ONLY

Keyboard Only.

GamePad Only.

Multidevice.

Si inicialmente se seleccionó un modo mientras arrancaba el programa, la selección de modo durante laejecución continuará desde esa posición.

NOTA SOBRE EL CAMBIO DE MODO: No todos los sistemas operativos detectan el cambiode de modo en caliente de manera correcta. Por ejemplo, Windows 7, tiene problemas al cambiar demodo sin desconectar el cable. Sin embargo en otros tales como macOS, el cambio de modo en calienteno cuenta con ningún problema. Recomendamos al usuario que, si ha de cambiar de modo y para evitarproblemas, conecte y desconecte el cable una vez realizado el cambio desde BTYPER.

5.1. Modo Keyboard Only

En el modo ”keyboard only”, el MSX se comporta como un teclado standard USB. Además de esto, seañaden los movimientos/pulsaciones de un joystick conectado en cualquiera de los 2 puertos del MSX.

Estos son los datos recibidos, a través del puerto USB, en la máquina destino:

REPORT ID = 1MODIFIER BYTE

RESERVEDKEYSTROKE 1 KEYSTROKE 2KEYSTROKE 3KEYSTROKE 4KEYSTROKE 5KEYSTROKE 6

Cuadro 5.1: Buffer Keyboard Only.

El mapeo de los joysticks será el siguiente:

13

5.2. MODO GAMEPAD ONLY

Joystick MSX USB Keyboard

UP CURSOR UPDOWN CURSOR DOWNLEFT CURSOR LEFT

RIGHT CURSOR RIGHTBUTTON 1 SPACEBUTTON 2 N

Cuadro 5.2: Teclas mapeadas Joystick MSX.

Para que Black Typer funcione en modo Keyboard Only mantendremos pulsada la tecla SPACE,únicamente durante el arranque del programa BTYPER o bien utilizarmos el cambio de modo durantela ejecución para seleccionarlo.

La configuración será guardada en el interface Black Typer, y utilizada por defecto en la siguienteejecución.

5.2. Modo GamePad Only

En este modo, Black Typer se comportará como un joystick/pad USB. Aquí podremos ver los bytesenviados al dispositivo destino:

REPORT ID = 2JOYSTICK X AXISJOYSTICK Y AXIS

BT BC BX BS HAT SWITCHR3 L3 O2 O1 R2 L2 R1 L1

Cuadro 5.3: Buffer GamePad Only.

El mapeo de un joystick en cualquier port será el siguiente:

Joystick MSX GamePad USB

UP HAT(D-PAD) - JOYSTICK -Y AXISDOWN HAT(D-PAD) - JOYSTICK +Y AXISLEFT HAT(D-PAD) - JOYSTICK -X AXIS

RIGHT HAT(D-PAD) - JOYSTICK +X AXIS BUTTON 1 BS BUTTONBUTTON 2 BX BUTTON

Cuadro 5.4: Correspondencia Joystick MSX con GamePad USB.

14

5.3. MODO MULTIDEVICE (GAMEPAD + KEYBOARD)

El mapeo del teclado MSX será el siguiente:

Keyboard MSX GamePad USB

CURSORS AXIS JOYSTICKCTRL, CODE, GRAPH BUTTON 2 (BX)SPACE, SHIFT, TAB BUTTON 1 (BS)

BS BUTTON 3 (BC)SELECT BUTTON 4 (BT)

F1 L1 BUTTONF2 L2 BUTTONF4 R2 BUTTONF5 R1 BUTTON

A, W, S, D HAT SWITCHRETURN O1

Cuadro 5.5: Correspondencia Teclado MSX con GamePad USB.

Para que Black Typer funcione en modo GamePad Only mantendremos pulsada la tecla CTRL,únicamente durante el arranque del programa BTYPER o bien utilizarmos el cambio de modo durantela ejecución para seleccionarlo.

La configuración será guardada en el interface Black Typer, y utilizada por defecto en la siguienteejecución.

AXIS JOYSTICK puede ser cambiado por HAT SWITCH si invertimos el modo en laconfiguración.

HAT SWITCH puede ser cambiado por AXIS JOYSTICK si invertimos el modo en laconfiguracion.

5.3. Modo Multidevice (GamePad + Keyboard)

En este modo, Black Typer se comportará como un keyboard standard + joystick/pad USB. Es decir,un combo usb. El dispositivo host destino recibirá datos de ambos dispositivos.

El mapeo de teclas y joysticks es exactamente el mismo que el explicado en los puntos 5.1 y 5.2. Ahorabien, cuando, por ejemplo, pulsemos la tecla CURSOR UP el dispositivo destino recibirá dos datos:

Uno con el identificador de tecla CURSOR UP, para teclado.

15

5.3. MODO MULTIDEVICE (GAMEPAD + KEYBOARD)

Los datos equivalentes a AXIS X del joystick analogico simulado + HAT (D-PAD).

Como esto podría acarrear problemas, de cara al funcionamiento de algunos programas, es posibleevitar que las pulsaciones en el teclado se codifiquen como datos para el joystick/gamepad. Para ellosolo hemos de mantener pulsado, en el arranque de BTYPER la tecla TAB.

Para que Black Typer funcione en modo multidispositvo mantendremos pulsada la tecla CTRL +SPACE, durante el arranque del programa BTYPER o bien utilizarmos el cambio de modo durante laejecución para seleccionarlo.

La configuración será guardada en el interface Black Typer, y utilizada por defecto en la siguienteejecución.

16

6

Mapeo del teclado.

Quizás la característica más confusa de Black Typer es como se mapea el teclado del MSX, respectoal teclado configurado en la máquina destino.

La explicación es muy sencilla, pero puede ser confusa de entender: Black Typer entiende el tecladodel MSX como un teclado raw standard. Esto quiere decir que la tecla dibujada en el teclado MSX notiene por qué corresponder con la tecla que obtendermos en el dispositivo destino al pulsar.

Por poner un ejemplo sencillo: Si nuestro teclado MSX es QWERTY y en nuestro dispositivo destinotenemos el teclado configurado como Frances-AZERTY, al pulsar la tecla Q en el MSX, lo que obtendremosen pantalla será una A.

Así pues, si tenemos configurado nuestro dispositivo como un teclado es-es, y el MSX es japonés la letrañ la conseguiremos pulsando ; que es el sitio físico donde se encontraría en un teclado español.

6.1. Teclas especiales

Dado que el número de teclas de un teclado MSX no se corresponde con un teclado standard USB (esinferior) se han habilitado atajos de teclado para obtener las teclas que no están disponibles en MSX.

17

6.1. TECLAS ESPECIALES

Teclado USB MSX

F6 SELECT + F1F7 SELECT + F2F8 SELECT + F3F9 SELECT + F4F10 SELECT + F5F11 CODE + F1F12 CODE + F2

VOLUME UP SELECT + CURSOR UPVOLUME DOWN SELECT + CURSOR DOWN

MUTE SELECT + STOPPREV. TRACK SELECT + CURSOR LEFTNEXT TRACK SELECT + CURSOR RIGHTPLAY/PAUSE SELECT + SHIFT + STOP

GUI KEY CODEALT LEFT GRAPH

ALT RIGHT GRAPH + SELECTCambio de modo CAPS + SHIFT + CTRL

Cuadro 6.1: Teclas especiales.

El cambio de modo en tiempo real, explicado en el punto 5.

18

7

Cuestiones Frecuentes.

Q: La sincronización no se realiza, pulso teclas y no aparecen en pantalla.

A: Puede ser debido a varios motivos:

Compruebe que el programa BTYPER está corriendo.Compruebe el estado de su cable A-TO-BCompruebe que tiene seleccionado el modo Keyboard Only o Multidevice.Vuelva a realizar los pasos explicados en el punto 3.

En caso de persistir el problema, póngase en contacto con A-Labs.

Q: Pulso en mi MSX la tecla ) y me aparece un caracter diferente en pantalla.

A: Como se explica en el punto 6, el teclado MSX pasa a ser un teclado físico donde las teclasdibujadas no tienen por qué coincidir con las que interpreta su sistema operativo. Revise laconfiguración del layout de teclado en su sistema operativo.

Q: ¿Puedo usar USBTopia como joystick en los modos GamePad?

A: Por supuesto. Puede utilizar USBTopia como joystick en cualquier puerto.

Q: ¿Puedo utilizar Black Typer como teclado en USBTopia?

A: Por supuesto. Black Typer, en modo Keyboard Only y solo en modo Keyboard Only,puede funcionar como teclado para la simulación de joystick en su computadora MSX medianteUSBTopia.

Q: En modo Keyboard, algunas teclas no me funcionan.

A: Puede ser debido a varios motivos:

19

Compruebe que efectivamente esas teclas funcionan en su computadora MSX. Vaya alMSX-BASIC y pulse las teclas. Si aparecen en pantalla, su teclado funciona correctamente.En caso contrario, póngase en contacto con su servicio técnico para la reparación.Compruebe que su puerto de impresora es funcional. Debido al poco uso que se realiza delpuerto de impresora en la actualidad, podría ser que su puerto no funcionase o, quizás, nuncahubiese funcionado, adecuadamente. Para garantizar que es un problema de Black Typer,intente, a ser posible, probar el interface en una computadora MSX diferente, si dispone deella:

• Si los problema son idénticos, póngase en contacto con A-Labs.• Si Black Typer funciona correctamente con esa computadora MSX, póngase en contacto

con el servicio técnico para la reparación de la anterior.

20

8

Contacto y créditos.

⇒ Diseño, programación, fabricación y distribución: Armando Pérez Abad

⇒ Diseño de logos, nombres e ideas:

⇒ Traducción: Néstor A. Soriano Vílchez (Konamiman).

@alabstech

contact@alabs.tech

http://alabs.tech

no se hace responsable de los daños causados en su computadora MSX por este interfaz.

21

Figura 8.1: Black Typer.

22