Diferencias

Muestra las diferencias entre dos versiones de la página.

--- joy2ps2 [2024/06/19 18:46] – [FAQ] spark2k06
+++ joy2ps2 [2024/06/19 19:01] (actual) – spark2k06
@@ Línea 1: / Línea 1: @@
-====== Descripción ======
+<wrap centeralign>
+{{::joy2ps2.png?600|}}
+</wrap>
-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.
+[[https://dokuwiki.aitorgomez.net/joy2ps2_es|Documentación en Español]]
-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.
+[[https://dokuwiki.aitorgomez.net/joy2ps2_en|Documentation in English]]
-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#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.