Últimamente se ha comentado por aquí lo problemático que puede ser desarrollar juegos MSX en una plataforma u otra. Como de lo que se trata es de hacer programas que sean compatibles, esa es la gracia, con cualquier modelo, creo que sería interesante desarrollar una lista de normas de buena conducta para que a la hora de desarrollar software, se pueda garantizar su correcto funcionamiento en la mayor cantidad posible de modelos, idealmente todos.

Así a bote pronto se me ocurren los siguientes:


PARTE I

---

Versión de MSX

Es lo primero que deberiamos comprobar. Si consultamos  el valor de MSXVER ($002D) obtendremos el modelo sobre el que nos encontramos:

• 0 - MSX1
• 1 - MSX2
• 2 - MSX2+
• 3 - TR
• 4 - OCM  

A continuación, si no estamos sobre un MSX1 y nuestro programa lo requiere podemos afinar más la identificación consultando un par de posiciones de memoria en las que podremos encontrar información acerca de determinados usos locales para los que nuestro modelo de MSX ha sido acondicionado:
 
Estas posiciones son la $2B y la $2C. Su contenido se distribuye de la siguiente manera:


Especialmente importantes son los contenidos del bit 7 de $2B (sincronismo) y de los bits 0-3 de $2C (tipo de teclado).


RAM mínima disponible

El estandar determina que la RAM mínima disponible que puede tener un equipo de la norma es de 8Kb, ¿que significa esto?, pues que si hacemos los juegos pensando en usar 16Kb de RAM, no funcionarán en esas máquinas que sólo monten 8Kb. La decisión es nuestra, en caso de optar por la compatibilidad, deberemos ajustar nuestras necesidades a esa cantidad de memoria, que en realidad será bastante menor de 8Kb (no llegarán a 5Kb los disponibles).

Las areas de datos, en un caso o en otro deberán inicializarse como sigue:

8Kb RAM : Area de datos en RAM a partir de $E000
16Kb RAM : Area de datos en RAM a partir de $C000

Modelos MSX1 conocidos con 8Kb de RAM:

• Casio PV-7

RAM máxima disponible (MSX1)/ Slots primarios) y slots secundarios (Subslots)

El Z80 o micro compatible que incorporan los MSX únicamente puede acceder a un rango de direcciones lineal comprendido entre 0 y 65535 ($FFFF), de ahí que la máxima memoria a la que puede acceder un MSX1 es de 64K (los MSX2 pueden acceder hasta a 4Mb mediante un mapper; pero eso ya es otra historia), no hay margen para más.
Estos 64Kb son lineales para la CPU; pero en realidad su disposición física puede diferir mucho de la lógica. En teoría nosotros vemos lo mismo que la CPU :


Las páginas 0 y 1 siempre están ocupadas por la BIOS y el intérprete de BASIC respectivamente, a partir de ahí el contenido de las dos siguientes dependerá de la cantidad de RAM disponible por el MSX, los equipos con 32Kb o más (¿existen equipos con 24Kb de RAM?) tendrán RAM disponible en las páginas 2 y 3 ($8000 y $C000), los equipos con 16Kb sólo en la página 3 ($C000) y los de 8Kb, igualmente en la página 3; pero a partir de $E000. Respecto a esto, es importante hacer notar que lo único que podremos asumir en un MSX al inicializarse es que en la página 3 siempre tendremos RAM.

Sin embargo, lo habitual es que un equipo MSX incorpore 64Kb, ¿donde están los otros 32Kb?. Están ahí, sólo que enmascarados por la BIOS y por el BASIC; despues de todo hemos dicho que un Z80 no puede ver más alla de 64Kb, así que si tuvieramos los 64Kb de RAM visibles, no podriamos tener al mismo tiempo ni BIOS, ni intérprete BASIC.

Esa RAM "paralela" se esconde en lo que a partir de ahora vamos a llamar slot y que físicamente corresponden, cada uno de ellos, a una ranura de cartucho (aunque no tienen porque ser accesibles por nosotros ).

Cuando deciamos que la disposición física puede diferir mucho de la visible lógica, nos referiamos entonces a esto:


Esta sería la disposición de la RAM en un Philips VG-8020. Según el esquema podemos comprobar como los 64Kb se encuentran en serie en el slot 3, mientras que la BIOS y el BASIC están en el slot 0 (es lo habitual). Esto podemos comprobarlo desde BASIC ejecutando:


El resultado obtenido será $F0. Este valor tendremos que interpretarlo a partir de lo siguiente:

Puerto $A8


Este resultado nos está indicando que en ese preciso instante (desde BASIC) en las páginas 2 y 3 estamos "viendo" el slot 3, que como consta en el anterior esquema contiene RAM y que en las páginas 0 y 1 vemos el slot 0, que contiene la BIOS y el BASIC,... todo en orden

Si queremos activar los otros 32Kb podriamos pensar que con un OUT &HA8,&HFF lo tendríamos todo arreglado; pero claro, más de uno ya habrá caido en la cuenta que desde BASIC no podemos desactivar ni la página de la BIOS, ni la del BASIC, el cuelgue sería inmediato. Para este menester será siempre necesario recurrir al código máquina; mediante una rutina como la que sigue conseguiriamos nuestro proposito de activar los 64K:


¿Y ya tendriamos los 64Kb dispuestos para ser usados?;.....pues no....

En el caso del Philips VG-8020 y de otros muchos modelos, si que es cierto que los 64Kb se encuentran en el mismo slot; pero la norma no especifica esto como algo de obligado cumplimiento; por lo que cada fabricante montará esas páginas de 16Kb donde más le convenga, podrán estar distribuidas al azar por cualquiera de los 4 slots. Está claro que para activar una página en concreto se hace necesaria una rutina que no se limite a aplicar una regla fija, sino que busque por todos los slots esa RAM. Ahora, como si todavía no fuera lo suficientemente complicado, entrarán en juego los slots secundarios 8o.
En el mapa de memoria del Philips podemos ver como la RAM está en el slot 3; pero hay algo más, esta aparece realmente en el 3-2, ¿que significa eso?; pues que cada uno de los slots primarios puede subdividirse en otros cuatro (0-3) llamados secundarios o subslots, estos nuevos slots no tienen representación física, se mapean únicamente a nivel lógico. Si un slot primario va a poder estar dividido o no en secundarios podemos consultarlo en las siguiente tabla de posiciones de memoria:

EXPTBL

$FCC1 - Slot 0: $80 = expandido, 0 = no expandido.
$FCC2 - Slot 1: $80 = expandido, 0 = no expandido.
$FCC3 - Slot 2: $80 = expandido, 0 = no expandido.
$FCC4 - Slot 3: $80 = expandido, 0 = no expandido.


Por culpa de todo esto, un nuevo y rápido cálculo nos muestra que de las 16 ubicaciones originales que teniamos para las páginas de 16Kb, ¡ahora podremos tener hasta 64!.
La rutina de la que hemos hablado ya no deberá unicamente buscar la RAM por los slots primarios; sino que tendrá que tener en cuenta también la existencia de los slots secundarios.

Otro ejemplo típico de manipulación de slots es el caso de las ROMs de 32Kb ($4000-$BFFF). Si nos planteamos el hacer una, hemos de tener en cuenta que la BIOS únicamente inicializará por su cuenta la página 1 ($4000-$7FFF) que es donde se encuentra la cabecera de la ROM con la dirección de ejecución de la misma. Tendremos que ser nosotros los que inicialicemos la página 2 con los 16Kb superiores de nuestra ROM y para ello tendremos que averiguar en que slot primario y secundario se encuentra. El procedimiento sería como el que sigue:

Código por Ramones/ TMHB


Con esta rutina, nuestra ROM ya estará completa en las páginas 1 y 2 y podrá ejecutarse correctamente.
 
ROMs de 48Kb (por Ramones)

Aunque las ROMs más comunes en el MSX son las de 16Kb y 32Kb (1 y 2 páginas respectivamente) tambien podemos ensamblar ROMs de 48Kb con las que tendriamos el rango completo de direcciones (64Kb) bajo nuestro control.
Son algo más complicadas que las anteriores, el principal problema es que la única página que nos quedaba disponible sin usar es la página 0 y esta página contiene la BIOS. Esto complica algo la programación, ya no sólo porque dejaremos de tener disponible la BIOS para nuestro programa, sino porque con la BIOS perderemos el ISR (Interrupt Service Routine) asociado al modo de interrupciones estandar en los MSX, el IM1, instalado a partir de la dirección $38.

Para sobrellevar esto podremos emplear ciertas estrategias como:

• Usar la página 0 como almacen de datos: para ello, tendríamos que activar nuestra página de la ROM, usar los datos allí contenidos y finalmente restaurar la BIOS. El proceso se repetiría para cada acceso que quisieramos hacer.
  Todo esto habría que hacerlo siempre con las interrupciones desactivadas, ya que como hemos dicho, en el modo IM1, el sistema trataría de ejecutar el código a partir de la dirección $38 al producirse una interrupción y en caso de suceder eso mientras que nuestra página estuviese activa, no existiría tal código y el programa se colgaría.
• Programando un nuevo ISR: tendriamos que sustituir el ISR original de la BIOS con uno nuestro en la dirección $38, de esta manera ya podríamos tener permanentemente activa esta página, que ya podría contener lo que nosotros quisieramos, código, datos o ambos.
• Cambiando el modo de interrupciones a IM2: similar al anterior, mediante este método podríamos tener permanentemente activada la página ya que las interrupciones ya no tratarían de ejecutar el código en $38, nuestro ISR se instalaría en función de los requisitos de IM2 (ver ejemplo en la sección de snippets).
• Soluciones mixtas: ningún método es definitivo y en función de nuestras necesidades podremos en unos momentos tener la página permanentemente activada y en otros desactivarla para poder usar la BIOS.

En cualquier caso, la forma de acceder a esa página y de recuperar la bios, ya no puede ser realizada por las rutinas del sistema, es decir la BIOS. El MSX no cuenta con una manera de posicionar en la página de la BIOS otro slot y volver a recuperar la BIOS con otra rutina de sistema. Por eso hemos de hacerlo nosotros mismos, y para ello hay que ser conscientes y respetuosos con los slots y subslots. Lo que adjunto es un poco evolución de lo anteriormente expuesto, ya que necesitamos tener en la variable slotvar, el slot/subslot de nuestra ROM, por lo tanto estas rutinas no son funcionales si no hemos ejecutado antes la rutina search_slot.

---

FIN DE LA PARTE I

Enhorabuena JL.  Fantástico y encima desmigajado totalmente para que nadie tenga dudas.

Insisto en el tema de que metamos todo esto en la web de Edu. Es que, no es por menospreciar lo interesante del foro en este aspecto, solo que el hilo, se morira y se perderá y luego será dificil de encontrar.

Opto mejor por dejarlo en un sitio de fácil acceso, como es una web bien preparada.

Cosas a añadir. Ya lo dices claro, los 28 ciclos de retardo para el outi, yo contaba 24 sin contar el extra de refresco de memoria, pero faltaría añadir que el problema es el mismo para OUT.

Así pues, con esos datos, tenemos que:

outi
nop
nop
outi

es correcto.

La version out(c),x es

out(c),a
nop
nop
nop
out(c),a

Basada en el mismo principio.

Sobre los 50/60hz, tenemos esto en el TH del MSX2:

* International MSX



There are different kinds of MSX for various countries. The following items

are different by country:



- Keyboard arrangement, character set, PRINT USING format

- Timer interrupt frequency



The version of machine can be found by reading the ID byte information in ROM

(see Figure 2.19) and the correspondence for MSX of each country will be

accomplished (see Table 2.23).





   Figure 2.19   Contents of ID byte



-------

| 2BH |   b0  --+

-------    |  character generator

     b1   |

      |  0: Japan   1: United States, etc.

     b2   |  2: USSR

      |

     b3  --+



     b4  --+

      |  date format

     b5   |

      |  0:Y/M/D   1:M/D/Y       2:D/M/Y

     b6  --+



     b7      interrupt period (VSYNC)

         0:60Hz   1:50Hz





-------

| 2CH |   b0  --+

-------    |  keyboard

     b1   |

      |  0:Japan   1:United States, etc.

     b2   |  2:France   3:United Kingdom

      |  4:Germany   5:USSR      6:Spain

     b3  --+



     b4  --+

      |

     b5   |  information about PRINT USING

      |  or others

     b6   |

      |

     b7  --+



Lo cual quiere decir que si eso existe en MSX1 y lo miraré ahora, se puede averiguar solo mirando eso si la máquina es PAL o NTSC, mirando la direccion 2Bh, y por lo menos en las bios MSX1 que estoy mirando si se cumple. Y espera, que me pase a papel el TH del MSX1 de la página de Edu ... sip, 2Bh, en efecto te dice si la máquina es PAL o NTSC.

Sobre los slots... si habría que añadir, aunque fuese la rutina básica para posicionar de tu rom, si ejecuta en 04000h o 08000h (lo más normal) los otros 16k, aunque también están en el TH del MSX1 y del MSX2 con rutinas llamadas "where_am_I" que me hacen gracia en estos momentos.

Excelente idea y trabajo, JL! Sugiero que esto quede pegado arriba, siempre a la vista. Y si pudiese ser que el primer mensaje se fuese editando para incluir las sucesivas aportaciones sería redondo. Y lo de que se recoja en otros lados también. Nunca está de más tener las cosas importantes en más de un sitio, que ya sabemos lo que pasa, que un día peta el servidor y no hay copias y tal...



<modo pejiguero/on> ( y más o menos OT)
Ya que esto va de corrección técnica será mejor decir que es 50Hz ó 60Hz. Es muy común eso de cambiar de PAL a NTSC o viceversa, y no es correcto. Se cambia la frecuencia pero no la norma. Será PAL/50Hz ó PAL/60Hz y NTSC/60Hz ó NTSC/50Hz. La norma de Brasil, por ejemplo, es un PAL a 60Hz. En Francia es a 50Hz pero SECAM... (bueno, no exactamente, porque SECAM es un poco coñazo y por eso los aparatos franceses traen salida RGB y tal, pero bueno... )
Perdón por el rollo, pero es algo que no se por qué no me gusta. Ya veis, cada uno tenemos lo nuestro  
<modo pejiguero/off>

un saludo.

No sé en qué momento el registro 7 llegó a suponer la muerte ... Gracias de todos modos por hablar de esto de este modo MsxKun. Sin duda habrá quien diga que este tema me resulta algo personal ... Pues claro que sí, y si dijera que no mentiría como un bellaco. Pero la verdad es que no veo la gravedad y el bochorno que se le da.

Mi rutina para detectar versión en Beepertron (venga, ahora podéis rajar):

Una de slots y subslots rapidita. Lo básico para hacer una Rom de 32k y de 48k, normal de ASM/C. Dejo al margen las de Basic, puesto que no tengo conocimientos sobre ellas, y hay información en otras páginas (que lo ponga aquí quien más sepa de ellas).

Esto sacado de los TH. Las Roms pueden ser inicializadas tanto en la pagina 0, 1 y 2 del Z80. Dejo al margen las de pagina 0 pues son algo raritas, aunque tenemos casos donde se usaron (Hero, Crazy Train...).

Las de pagina 1 y 2, es decir, 04000h-7FFFh, y 08000h-0BFFFh, son inicializadas por el MSX. El MSX detecta la cabeceza 041h,042h, coge la dirección contenida en 04002h, o 08002h, posiciona ese slot/subslot y ejecuta. Pero no podemos dar por hecho que las otras 16k estén posicionadas, pues la BIOS no lo hace.

Por ello, ya que las vamos a utilizar, es necesario saber en que slot/subslot estamos y posicionar esas 16k Extra. Esto se realiza con esta pequeña rutina ASM, repito, contenida en THs.

Adjunto pequeño programa inicializador, también explicado en los TH, que crea una Rom arrancable en pagina 1, y busca las 16k extra (08000h-0BFFFh), y las posiciona.



Y ahora hablemos de las Roms de 48k. Estas Roms, perfectamente legales, cuentan con un problema: Las 16 extra utilizadas se posicionan en la misma zona del Z80 que la BIOS. Esto nos complica la programación, y contamos con algunas maneras de usarlas:

[] Como almacen de datos: Posicionamos la pagina de la Rom, usamos los datos, y volvemos a poner la BIOS. Siempre con las INTERRUPCIONES DESACTIVADAS, ya que en el modo IM1, el sistema salta a 038h cuando se produce una interrupción y podría destrozarnos el programa.

[] Con código propio. Pero hemos, o bien cambiar el modo de interrupción a IM2 (cosa que funciona pero no se hasta que punto es standard), o bien creamos nuestra propia rutina de control de interrupciones. 038h en adelante.

[] Un poco de ambos.

En cualquier caso, la forma de acceder a esa página y de recuperar la bios, ya no puede ser realizada por las rutinas del sistema, es decir la BIOS. El MSX no cuenta con una manera de posicionar en la página de la BIOS otro slot y volver a recuperar la BIOS con otra rutina de sistema. Por eso hemos de hacerlo nosotros mismos, y para ello hay que ser conscientes y respetuosos con los slots y subslots. Lo que adjunto es un poco evolución de lo anteriormente expuesto, ya que necesitamos tener en la variable slotvar, el slot/subslot de nuestra Rom, por lo tanto estas rutinas no son funcionales si no hemos ejecutado antes la rutina search_slot.



Repito. Cuando accedais a esa página, aseguraros que teneis las interrupciones desactivadas, o bien, cuando está posicionada no se os ocurra activarlas, a no ser que conteis con vuestro propio interrupt handler.

Ale, si algo no queda claro, lo puedo extender un poco, pero para empezar creo que es suficiente.

M... y que hay de la rutina CALSLT ($001c)?
La he probado y parecer funcionar, pero claro, puedo estar metiendo la pata, pa variar 

Ahora veo, asi te ahorras tener que tener alguna rutina en pag0 a la cual saltar, por pequeña que sea... Conectas y catapumchimbola, tienes datos y haces. Pillao

Bueno, en cuanto pueda y se me enfríen las yemas de los dedos ire actualizando el primer mensaje con vuestras aportaciones. Lo primero, gracias a Ramones por redactar ese texto y ejemplos de uso de slots y página 0, lo incluiré citando al autor . Totalmente cierto el lapsus del PAL/NTSC/50/60, en todo caso se ha de hablar realmente de 50/60Hz, que es lo que realmente determina la disponibilidad del VDP en cada refresco. También trataré de incluir el tema de los modos mixtos y el uso de instrucciones no oficiales del Z80.

Respecto al PSG#7, no creo que deba ser incluido aquí ya que no se trata de un tema de compatibilidad entre máquinas, es simplemente de una cuestión de no debe de hacerse en ninguna máquina, sea de la generación que sea. Si se investigase un poco más el origen de esa recomendación hecha por los creadores de hardware igual habría tema para hacer un pequeño artículo...


Hey, Andrea, thanks for your info! ; but right now I believe that since the infamous PSG#7 affaire, this problem is a very well-known one . Anyway I found interesting the last bit of your post; you say that misusing the register could lead to swapped or even non working joysticks. Have you found the info somewhere or maybe do you have electronic knowledge of what happens if you output incorrect data?

Thanks again!