dokuwiki

Esta página es de solo lectura. Puedes ver la fuente pero no puedes cambiarla. Pregunta a tu administrador si crees que esto es incorrecto.
====== Descripción ======

Joy2PS2 es una interfaz versátil diseñada para conectar uno o dos gamepads de varias plataformas retro. Esta solución convierte y redirige los eventos de los gamepads en pulsaciones de teclado hacia un puerto PS/2. 

Encontrarás este tipo de puerto en PCs antiguos y algunos modernos, así como en dispositivos recientes como el Next o el ZXUno, siendo este último la plataforma para la cual fue inicialmente diseñada. Esta interfaz es altamente compatible y adaptable, incluyendo varios mapas de teclado en su firmware para facilitar la interacción con diversos sistemas.

Nota: A partir de la release 2, Joy2PS2 es compatible con PCs reales que utilizan conexión PS/2.

{{::case_joy2ps2.jpg?600|}}

El diseño original del logo y de la carcasa para la versión 2.3 de Joy2PS2 fue creado por [[https://twitter.com/mejias3d|Jorge Mejias Cazorla]]. Puedes encontrar más de su trabajo en su perfil de Twitter:

[[https://www.flickr.com/photos/133386349@N08/shares/13m92J|Fotos de la carcasa y PCB de la versión 2.3 de Joy2PS2]]

{{:snes_joy2ps2.jpg?400|}}

[[http://www.zxuno.com/forum/viewtopic.php?f=25&t=1625|Versión integrada en mando SNES, por Antonio Villena]]


[[https://www.youtube.com/watch?v=GII2eh_ROhA|Video de demostración de la versión 1.0 de Joy2PS2, utilizando el antiguo firmware de Arduino]]



Los gamepads compatibles con la interfaz son los siguientes: Atari, NeoGeo OldStyle, MSX, Amstrad CPC, VIC 20, Sega Master System, Sega Megadrive (de 3 o 6 botones), Amiga, ZX Spectrum y NES Famicom DB9. Todos ellos pueden conectarse directamente a los zócalos DB15 o DB9. Sin embargo, algunos como el MSX, necesitarán un adaptador especial para utilizar el tercer botón.


====== Controles ======

Se puede acceder a un estado especial llamado SHIFT en cualquier momento usando cualquiera de las siguientes combinaciones:

  * Presionar Start + Botón 1
  * Presionar Select + Start
  * Pulsar y soltar la tecla Keymapper (necesario solo para gamepads sin el botón Start)

En el modo SHIFT, podría parecer que ninguno de los botones funciona, pero esto no es correcto. En este modo, las acciones se activan con el botón 1 del gamepad como evento final. Para cancelar el modo SHIFT, se puede pulsar nuevamente una combinación de SHIFT o el botón 2 del gamepad.

Nota: Las combinaciones descritas se realizan presionando y soltando los botones, sin mantenerlos presionados. Cualquier cambio de dirección reinicia el contador de las otras acciones.

  * Sólo botón 1: Cambia la configuración de cursores a OPQA y viceversa en el Joystick 1 (el principal).
[[https://dokuwiki.aitorgomez.net/doku.php?id=joy2ps2_es#mapas_de_teclado|Mapas de teclado]] 
  * Sólo botón 2: Cancela el modo SHIFT. También puedes cancelarlo volviendo a pulsar la combinación de SHIFT.

{{:shiftmode_zxuno.png?800|}}

===== Reinicio del ZXUno =====

A continuación se describen las secuencias para reiniciar el ZXUno a través del modo SHIFT:

  * **1 vez abajo y luego botón 1**: Reset. Se cambia automáticamente a cursores.
  * **2 veces abajo y luego botón 1**: MasterReset. Se cambia automáticamente a cursores.
  * **3 veces abajo y luego botón 1**: MasterReset y acceso a ROMs. Se cambia automáticamente a cursores.
  * **4 veces abajo y luego botón 1**: MasterReset y acceso a cores. Se cambia automáticamente a cursores
  * **5 veces abajo y luego botón 1**: MasterReset y acceso al BIOS. Se cambia automáticamente a cursores.
  * **6 veces o más abajo y luego botón 1**: Continúa en la opción de 5 veces.

===== Menú de Juegos =====

Las siguientes secuencias permiten navegar por el menú de juegos usando el modo SHIFT:

  * **1 vez arriba y luego botón 1**: Acciona la tecla 'R'.
  * **2 veces arriba y luego botón 1**: Acciona la tecla '0'.
  * **Repetir hacia arriba seguido del botón 1**: Continúa secuencialmente desde '1' hasta '9', donde se mantiene.

===== Cargador de juegos =====

Utiliza las siguientes secuencias en el modo SHIFT para cargar juegos:

  * **1 vez derecha y luego botón 1**: Activa el NMI.
  * **2 veces derecha y luego botón 1**: Ejecuta las teclas 'LOAD ""' (modo 128k).
  * **3 veces derecha y luego botón 1**: Ejecuta las teclas 'J ""' (load"" modo 48k).
  * **4 veces derecha y siguientes**: Se mantiene en la opción de las 3 veces.

===== Funciones extra =====

Las siguientes funciones pueden activarse en el modo SHIFT mediante las secuencias descritas:

  * **1 vez izquierda y luego botón 1**: Activa el Modo Teclado (detalles más abajo).
  * **2 veces izquierda y luego botón 1**: Ejecuta la función Escape (útil para joysticks de un solo botón, usado junto con el botón de Keymapper como shift).
  * **3 veces izquierda y luego botón 1 del jugador 1 o 2**: Cambia el mapa de teclado del jugador correspondiente (ver detalles de los mapas disponibles más abajo).
  * **4 veces izquierda y luego botón 1**: Cambia de modo de vídeo (Scroll / Lock).
  * **5 veces izquierda y siguientes**: Se mantiene en la opción de cambio de vídeo.

===== Cambio entre DB15/DB9 y DB9x2 =====

Para alternar entre las configuraciones DB15/DB9 y DB9x2, sigue estos pasos mientras estés en modo SHIFT:

  * Presiona y mantén pulsado el botón 1, luego pulsa el botón 2.

La configuración seleccionada se mantendrá incluso después de un reinicio en caliente del ZXUno.

===== Tiempos de envío de Scancodes =====

Desde la release 3, los tiempos de semireloj y reloj para el envío de Scancodes en el ZXUno, tras un reinicio en frío o en caliente, se ajustan a los estándares de un teclado real, siendo 16 y 32 us respectivamente.

  * **En modo SHIFT, manteniendo pulsado Start y presionando ARRIBA**: Disminuye los tiempos en múltiplos de cuatro, hasta un mínimo de 4 y 8 us.
  * **En modo SHIFT, manteniendo pulsado Start y presionando ABAJO**: Aumenta los tiempos en múltiplos de cuatro, hasta un máximo de 16 y 32 us.

===== Habilitación / Deshabilitación de la Escucha de Comandos del Host =====

Desde la release 5, la función de escucha de comandos del host en el ZXUno está deshabilitada por defecto y tras cualquier reinicio, ya sea en frío o en caliente.

  * **Para habilitar la escucha**: En modo SHIFT, presiona y mantén pulsado el botón 1, luego pulsa la tecla derecha.
  * **Para deshabilitar la escucha**: En modo SHIFT, presiona y mantén pulsado el botón 1, luego pulsa la tecla izquierda.
  * **Para mantener activa la escucha de forma temporal**: Permanece en modo SHIFT. La escucha se desactivará automáticamente tras la inicialización del teclado.


====== Modo Teclado (KEYSTROKES) ======

Este modo permite interactuar con el teclado de manera directa a través de los siguientes comandos:

  * **Arriba**: Cambia la tecla hacia adelante e imprime el carácter en pantalla.
  * **Abajo**: Cambia la tecla hacia atrás e imprime el carácter en pantalla.
  * **Izquierda**: Borra el carácter anterior.
  * **Derecha**: Acepta el carácter actual o inserta un espacio.
  * **Botón 1**: Cambia a la tecla correspondiente con la tecla derecha del shift (para imprimir mayúsculas o caracteres especiales).
  * **Botón 2**: Actúa como la tecla Intro.
  * **Para salir del modo**: Entrar al modo SHIFT y seleccionar otra opción, o salir del modo SHIFT si ya estás dentro.

[[https://youtu.be/Av-fX18Ev8M|Ejemplo de "Hello World" en modo Teclado]]

====== Firmware Oficial ======

[[https://github.com/spark2k06/zxuno/tree/master/joy2ps2|Firmware oficial]]

Para actualizar al último firmware oficial, Joy2PS2.hex, puedes utilizar el software de actualización de binarios para AVR, [[https://github.com/binaryupdates/xLoader|XLoader]].

Para actualizaciones desde la línea de comandos en OpenBSD o Linux, utiliza avrdude con los parámetros adecuados:

  * **OpenBSD**:

<code bash>
avrdude -p atmega168 -c arduino -P /dev/cuaU0 -v -b 19200 -U flash:w:joy2ps2.hex
</code>

El parámetro /dev/cuaU0 puede cambiar a /dev/cuaU1, /dev/cuaU2, etc., dependiendo de los dispositivos serie conectados.

  * **Linux**:

La configuración es similar, pero el dispositivo podría ser /dev/ttyUSB0, /dev/ttyACM0, etc., dependiendo de cómo se identifique en el sistema.

====== Mapas de teclado ======

===== Mapa 0 =====

(Por defecto al conectar o reiniciar en frío el ZXUno)

(Desde Release 4)

{{:mapa0.png?400|}}

===== Mapa 1 =====

(Desde Release 4)

{{:mapa1.png?400|}}

===== Mapa 2 =====

(Teclas por defecto de M.A.M.E)

{{:mapa2.png?600|}}

====== Listado de cores probados ======

A continuación se muestra un listado de cores en los que se ha probado la interfaz.

[[http://www.zxuno.com/forum/viewforum.php?f=13|Enlace a Spectrum]]

[[http://www.zxuno.com/forum/viewforum.php?f=37|Enlace a otros]]

  * Spectrum
  * Amstrad CPC
  * BBC Micro
  * Atari 2600 ([[http://www.zxuno.com/forum/viewtopic.php?f=48&t=1378|Versión compatible con teclado]])
  * NES ([[http://www.zxuno.com/forum/viewtopic.php?f=63&p=17554#p17554|Versión compatible con teclado]])
  * Atari 800 XL
  * Kyp Spectrum
  * Jupiter ACE
  * SAM Coupe
  * ZX81
  * Acorn Electron
  * Acorn Atom
  * TBBlue (Next)
  * PC/XT (Desde la release 2)
  * Apple II (resintetizando core con CLK y DATA como PULLUP, [[http://www.zxuno.com/forum/download/file.php?id=1344|Descarga aquí]])
  * VIC-20 (resintetizando core con CLK y DATA como PULLUP, [[http://www.zxuno.com/forum/download/file.php?id=1346|Descarga aquí]])
  * Oric Atmos (resintetizando core con CLK y DATA como PULLUP, [[http://www.zxuno.com/forum/download/file.php?id=1345|Descarga aquí]])
  * C64 beta 7 (resintetizando core con CLK y DATA como PULLUP, [[http://www.zxuno.com/forum/download/file.php?id=1349|Descarga aquí]])
  * MSX1
  * Sega Master System (Desde release 4, y de momento sólo el primer jugador)
  * Arcade: Phoenix, Pacman, Galaxian, Frogger, Invaders, Scramble, Galaga (Desde release 4)
====== Versión actual ======

  * [[https://github.com/spark2k06/zxuno/raw/master/joy2ps2|Release 7]]



====== Agradecimientos ======

Por último, deseamos agradecer a todos quienes, de una manera u otra, han contribuido a que este proyecto se convierta en una realidad:

[[http://zxuno.speccy.org/|ZXUno]]

[[https://twitter.com/ZXUno|Equipo ZXUno]]

[[http://www.zxuno.com/forum/|Comunidad ZXUno]]

[[https://twitter.com/mejias3d|Jorge Mejias Cazorla (Mejias3D)]]

[[https://twitter.com/antoniovil|Antonio Villena]]

[[https://twitter.com/zxprojects|mcleod_ideafix]]

[[https://twitter.com/SamQuest|Samuel (Quest)]]

[[https://twitter.com/eubrunosilvapt|Bruno Silva]]

[[https://twitter.com/yombo|Juanjo Luna (Yombo)]]

[[http://denki.world3.net/arcade.html|Retro Adapter]] (Enlace roto)

[[https://github.com/dkudrow/arduino/tree/master/PS2Emu|PS2Emu de Dani]]


====== Preguntas Frecuentes (FAQ) ======

**¿Mi gamepad de Megadrive de 6 botones es completamente reconocido o sólo algunos botones como en el conector DB9 del ZXUno?**

Todos los botones son reconocidos y se mapearán según el mapa de teclas configurado. También funcionarán el botón de Start y el botón de Mode para aquellos gamepads de Megadrive que los incluyan.

**¿Es posible jugar con 2 jugadores? ¿Qué sucede si se presionan teclas del primer jugador?**

Sí, es posible. Al conectar el dispositivo, la interfaz se configura para usarse desde el puerto DB9 principal o el DB15 (Neogeo). Si se usa el puerto DB9 auxiliar (segundo jugador), se activarán teclas asociadas a los últimos botones del DB15 debido a que comparten pines. Para usar dos jugadores, es necesario cambiar a modo DB9x2 usando la secuencia correspondiente en modo SHIFT.

**He seleccionado un core con un modo de vídeo diferente al configurado por defecto en la BIOS desde el menú de cores. ¿Cómo puedo cambiarlo sin un teclado físico conectado?**

Hay una secuencia para cambiar el modo de vídeo mientras estás en modo SHIFT. Consulta la sección de combinaciones del modo SHIFT en esta wiki para más detalles.

**Encuentro un juego que no puedo iniciar porque falta un mapeo para una tecla requerida en el menú de opciones, ¿qué puedo hacer?**

El firmware incluye las teclas más comunes utilizadas en los menús de juegos de ordenador, desde '0' a '4' y la 'R' para redefinir. Si se necesitan otras teclas, se pueden solicitar para ser incluidas en una actualización del firmware.

**Los mapeados de teclas no se ajustan a las necesidades de un determinado core o juego, hay solución para ello?**

Nuevamente, desde el firmware todo o casi todo es posible. Y en cuanto a cores, lo ideal sería seguir una misma norma y no utilizar distintas teclas. Por defecto en la interfaz se ha tratado de elegir las teclas más comunes, aunque se podría revisar, si está justificado.

**No estoy de acuerdo con la disposición de secuencias del modo SHIFT, ¿hay alternativas?**

Es normal tener preferencias distintas respecto a las secuencias del firmware oficial. Los usuarios pueden debatir y decidir sobre las combinaciones ideales para desarrollar un firmware alternativo. También, si tienes conocimientos de programación, puedes modificar el firmware a tu gusto, ya que los códigos fuente están disponibles para todos.

**Cuando conecto un teclado externo, se repiten pulsaciones de teclas al usar el gamepad.**

Esto puede ocurrir porque el teclado externo tiene activada la escucha de comandos, lo que puede interferir en la comunicación al compartir los pines CLK/DATA del conector PS/2. Una solución es colocar un diodo en la línea DATA con el cátodo hacia el teclado externo. Para más información, visita este enlace:

http://www.zxuno.com/forum/viewtopic.php?f=63&t=1804

Aunque Joy2PS2 fue diseñado para funcionar sin necesidad de un teclado externo, especialmente en configuraciones como máquinas arcade tipo bartop, usar un teclado puede mejorar la experiencia del usuario.