Added Sega System 16B

Added HTML dynamic TOC

doc/src/English ZXTRES Manual.adoc

@@ -3,6 +3,7 @@
 :editor: aowendev
 :revnumber: 1.0.0
 :doctype: book
+:docinfo: shared
 :notitle:
 :front-cover-image: image:img/portada_zxtres.jpg[]
 :email: kounch@users.noreply.github.com
@@ -1578,7 +1579,7 @@ Unlike the original machine, you can hear the audio while playing the tape.
 
 <<<
 
-=== Arcade (Capcom Play System 1 )
+=== Arcade (Capcom Play System 1)
 
 https://en.wikipedia.org/wiki/CP_System[CP System], CPS-1, or Capcom Play System 1 is an arcade system board made by Capcom, which was used for several arcade systems.
 
@@ -3163,9 +3164,9 @@ Mouse PS/2 port data register. Used to read or send direct commands to the PS/2
 |===
 
 PS/2 mouse port status register. The following bits are set:
-|==
+|===
 |BSY|0|0|0|ERR|0|0|PEN
-|==
+|===
 * BSY: set to 1 when a data transmission to the PS/2 port is still in progress. Wait for a value of 0 to start a new transmission.
 * ERR: set to 1 when the last transmission to or from the PS/2 port had errors.
 * PEN: set to 1 when new data is ready to be read from the MOUSEDATA register. After reading MOUSESTATUS, this bit is set to 0.
@@ -3539,9 +3540,9 @@ Control of the left/right channel mix from the 4 channels of the AY-8912. The fo
 |===
 
 Control of the operating mode of the AD724 encoder chip. The following bits are defined:
-|==
+|===
 |Resv|Resv|Resv|Resv|Resv|Resv|Resv|Resv|Resv|MODE
-|==
+|===
 * Resv : the meaning of these bits is reserved and must not be altered.
 * MODE : operating mode of the AD724. 0 = encodes PAL standard. 1 = encodes NTSC standard.
 
@@ -3588,6 +3589,7 @@ Each read operation provides the next ASCII character of the string containing t
 
 === Arcade
 
+
 ==== MRA Tool
 
 This is a tool that mergees https://www.mamedev.org[MAME] ROM files, using an MRA configuration file as a reference. It is also useful to create many kinds of binary blobs. It can be downloaded from https://github.com/kounch/mra-tools-c/tree/master/release[GitHub].
@@ -3610,6 +3612,143 @@ For a description of the different parameters of the tool:
 
 <<<
 
+==== Games by core
+
+Different arcade games are listed below, based on the core, and including the name of the corresponding MAME name.
+
+===== 1942
+
+[align="center",options="header"]
+|===
+|Game Name|ROM Name
+|1942|1942
+|===
+
+===== Atari Tetris
+
+[align="center",options="header"]
+|===
+|Game Name|ROM Name
+|Tetris|atetris
+|===
+
+===== Capcom Play System 1
+
+[align="center",options="header"]
+|===
+|Game Name|ROM Name
+|1941: Counter Attack|1941
+|Adventure Quiz Capcom World 2|cworld2j
+|Captain Commando|captcomm
+|Carrier Air Wing|cawing
+|Dynasty Wars|dynwar
+|Final Fight|ffight
+|Forgotten Worlds|forgottn
+|Ghouls'n Ghosts|ghouls
+|Gulun.Pa!|gulunpa
+|Knights of the Round|knights
+|Magic Sword: Heroic Fantasy|msword
+|Magical Pumpkin: Puroland de Daibouken|mpumpkin
+|Mega Man: The Power Battle|megaman
+|Mega Twins|mtwins
+|Mercs|mercs
+|Nemo|nemo
+|Pang! 3|pang3
+|Pnickies|pnickj
+|Pokonyan! Balloon|pokonyan
+|Quiz & Dragons: Capcom Quiz Game|qad
+|Quiz Tonosama no Yabou 2: Zenkoku-ban|qtono2j
+|Street Fighter II; Hyper Fighting|sf2hf
+|Street Fighter II: Champion Edition|sf2ce
+|Street Fighter II: The World Warrior|sf2
+|Street Fighter Zero|sfzch
+|Strider|strider
+|The King of Dragons|kod
+|Three Wonders|3wonders
+|U.N. Squadron|unsquad
+|Varth: Operation Thunderstorm|varth
+|Willow|willow
+|===
+
+===== Capcom Play System 1.5
+
+[align="center",options="header"]
+|===
+|Game Name|ROM Name
+|Cadillacs and Dinosaurs|dino.rom
+|Muscle Bomber Duo: Ultimate Team Battle|mbombrd.rom
+|Saturday Night Slam Masters|slammast.rom
+|Tenchi wo Kurau II_ Sekiheki no Tatakai|wofch.rom
+|The Punisher|punisher.rom
+|Warriors of Fate|wof.rom
+|===
+
+===== Double Dragon
+
+[align="center",options="header"]
+|===
+|Game Name|ROM Name
+|Double Dragon|Double Dragon|ddragon
+|===
+
+===== Kicker
+
+[align="center",options="header"]
+|===
+|Game Name|ROM Name
+|Kicker|Kicker|kicker
+|===
+
+===== Out Run
+
+[align="center",options="header"]
+|===
+|Game Name|ROM Name
+|Out Run|Out Run|outrun
+|===
+
+===== Pang
+
+[align="center",options="header"]
+|===
+|Game Name|ROM Name
+|Pang!|Pang|pang
+|===
+
+===== Sega System 16B
+
+[align="center",options="header"]
+|===
+|Game Name|ROM Name
+|Alien Syndrome|aliensyn.rom
+|Altered Beast |altbeast.rom
+|Aurail|aurail.rom
+|Bay Route|bayroute.rom
+|Bullet|bullet.rom
+|Cotton|cotton.rom
+|Dunk Shot|dunkshot.rom
+|Dynamite Dux|ddux.rom
+|E-Swat - Cyber Police|eswat.rom
+|Excite League|exctleag.rom
+|Fantasy Zone II - The Tears of Opa-Opa|fantzn2x.rom
+|Flash Point|fpoint.rom
+|Golden Axe|goldnaxe.rom
+|MVP|mvp.rom
+|Passing Shot|passsht.rom
+|Riot City|riotcity.rom
+|RyuKyu|ryukyu.rom
+|Sonic Boom|sonicbom.rom
+|Sukeban Jansi Ryuko|sjryuko.rom
+|Super League|suprleag.rom
+|Time Scanner|timescan.rom
+|Toryumon|toryumon.rom
+|Tough Turf|tturfu.rom
+|Wonder Boy III - Monster Lair|wb3.rom
+|Wrestle War|wrestwar.rom
+|===
+
+<<<
+
 === Links
 
 https://zxuno.speccy.org/index.shtml[ZX-Uno]

doc/src/Manual de ZXTRES.adoc

@@ -2,6 +2,7 @@
 :author: kounch
 :revnumber: 1.0.0
 :doctype: book
+:docinfo: shared
 :notitle:
 :front-cover-image: image:img/portada_zxtres.jpg[]
 :email: kounch@users.noreply.github.com
@@ -20,7 +21,7 @@
 
 ZXTRES, ZXTRES+ y ZXTRES++ son la continuación de https://zxuno.speccy.org[ZX-Uno] un proyecto de hardware y software basado en una placa FPGA programada para trabajar como un ordenador ZX Spectrum, y creado por el equipo de ZX-Uno: Superfo, AVillena, McLeod, Quest y Hark0.
 
-Con el paso del tiempo, el proyecto ha ido creciendo, de forma que es posible usar distintas configuraciones de software (cores) y que trabajan como otros sistemas distintos del ZX Spectrum, pudiendo elegir arrancar el ZXTRES con la configuración que se desee de entre varias disponibles.
+Con el paso del tiempo, el proyecto ha ido creciendo, de forma que es posible usar distintas configuraciones de software (cores) y que trabajan como otros sistemas distintos del ZX Spectrum, pudiendo elegir al arrancar el ZXTRES la configuración que se desee de entre varias disponibles.
 
 La página oficial de la familia ZXTRES es https://www.forofpga.es/viewforum.php?f=251[https://www.forofpga.es/viewforum.php?f=251].
 
@@ -1979,7 +1980,7 @@ El core se inicia por defecto utilizando la salida VGA. Si se desea que sea la s
 
 - `F12` mostrar el menú de control del core
 - Cursor o el mando 1: Controles de dirección del jugador uno
-- `Ctrl`, `Alt` y `Espacio` o botones A, B, C del mando 1: Botones 1,2 y 3 del jugador uno
+- `Ctrl`, `Alt` y `Espacio` o botones A, B, C del mando 1: Botones 1, 2 y 3 del jugador uno
 - `R`,`F`,`G`,`D` o mando 2: Movimiento del jugador dos
 - `A`, `S` y `Q` o botones A, B, C del mando 2: Botones 1, 2 y 3 del jugador dos
 - `1` y `2`: Iniciar partida jugador 1 o jugador 2
@@ -2039,7 +2040,7 @@ El core se inicia por defecto utilizando la salida VGA. Si se desea que sea la s
 
 - `F12` mostrar el menú de control del core
 - Cursor o el mando 1: Controles de dirección
-- `Ctrl`, `Alt` y `Espacio` o botones A, B, C del mando 1: Botones 1,2 y 3
+- `Ctrl`, `Alt` y `Espacio` o botones A, B, C del mando 1: Botones 1, 2 y 3
 - `1` y `2`: Iniciar partida de 1 o 2 jugadores
 - `5` y `6`: Insertar una moneda
 - `P : Pausa`
@@ -2197,6 +2198,71 @@ Estas son las principales:
 
 <<<
 
+=== Arcade (Sega System 16B)
+
+La https://es.wikipedia.org/wiki/Sega_System_16[Sega System 16B] es la segunda variante de una placa de arcade lanzada en 1985 por Sega.
+
+La versión para ZXTRES ha sido desarrollada por somhic, adaptando la https://github.com/jotego/jts16[versión original de Jotego].
+
+Algunas de sus características son:
+
+- Salida de vídeo VGA
+- Salida de vídeo RGB (utilizando el puerto VGA)
+- Soporte de mando real y mando emulado en teclado
+
+==== Formato de Tarjeta microSD
+
+El core necesita para funcionar ficheros con las https://es.wikipedia.org/wiki/Imagen_ROM[imagenes ROM] de los chips de la maquina arcade original, agregados dentro de un unico fichero .ROM, junto con un fichero .ARC que contiene el nombre del fichero ROM a cargar, así como la configuración de los https://es.wikipedia.org/wiki/Interruptor_DIP[interruptores DIP] de la maquina original.
+
+Tanto los ficheros ROM como los ficheros ARC se pueden crear utilizando <<#_mra_tool,MRA Tool>>, tomando como referencia los ficheros MRA disponibles en el https://github.com/jotego/jtbin/blob/master/mra/Out%20Run%20(sitdown-upright%2C%20Rev%20B).mra[repositorio del creador] del core original.
+
+Los ficheros ARC y ROM se pueden alojar en cualquier lugar de la tarjeta microSD. 
+
+[TIP]
+====
+El core se inicia por defecto utilizando la salida VGA. Si se desea que sea la salida RGB a 15KHz, se ha de crear en la raíz de la tarjeta un fichero con el nombre `15KHZ.CFG`.
+====
+
+==== Teclado
+
+===== Teclas especiales y botones
+
+- `F12` mostrar el menú de control del core
+- Cursor o el mando 1: Controles de dirección del jugador uno
+- `Ctrl`, `Alt` y `Espacio` o botones A, B, C del mando 1: Botones 1, 2 y 3 del jugador uno
+- `R`,`F`,`G`,`D` o mando 2: Movimiento del jugador dos
+- `A`, `S` y `Q` o botones A, B, C del mando 2: Botones 1, 2 y 3 del jugador dos
+- `1` y `2`: Iniciar partida jugador 1 o jugador 2
+- `5` y `6`: Insertar una moneda
+- `P : Pausa`
+- `F3`: Soft Reset (reinicia el Core)
+- `F12` (pulsación larga): Alterna entre el modo RGB y VGA
+
+<<<
+
+==== Guía básica
+
+Al pulsar `F12`, se mostrará el menú con las distintas opciones del Core. Se puede navegar utilizando las teclas de cursor o un mando. `Enter` o el botón B del mando selecciona un elemento.
+
+[.text-center]
+image:img/jts16b.jpg[scaledwidth=50%]
+
+Estas son las principales:
+
+- `Load ARC`: Para cargar desde la tarjeta microSD un fichero .ARC
+- `Rotate Controls`: Para girar el comportamiento de los controles de dirección
+- `Video Mode`: Sólo en el caso de salida de vídeo VGA, para aplicar distintos filtros a la imagen
+- `FX Volume`: Volumen de los efectos de sonido
+- `FX`: Activar o desactivar efectos de sonido
+- `FM`: Activar o desactivar efectos de sonido FM
+- `Test Mode`: Activa o desactiva el modo de prueba
+- `Pause`: Activa o desactiva la pausa
+- `DIP Switches`: Accede a ver y modificar el estado de los interruptores DIP que haya definidos en el fichero ARC
+- `Reset`: Soft Reset (reinicia el Core)
+- `Exit`: Cierra el menú de opciones
+
+<<<
+
 === Atari 2600
 
 La https://es.wikipedia.org/wiki/Atari_2600[Atari 2600] es una videoconsola lanzada al mercado bajo el nombre de Atari VCS (Video Computer System).
@@ -2929,7 +2995,7 @@ Estas son las principales:
 - `Mount SD:`: Para montar un fichero VHD como disco (se ha de hacer reset para que el sistema lo utilice),
 - `Reset FPGA`: para reiniciar la FPGA
 
-Por otra parte el mando 1 se comporta simultáneamente con protocolo Kempston (con dos botones de disparo) y Sinclair (1,2,3,4,5) con segundo botón de disparo (`z`). El mando conectado al puerto 2 se comporta con protocolo Sinclair (6,7,8,9,0) y segundo botón de disparo (`x`).
+Por otra parte el mando 1 se comporta simultáneamente con protocolo Kempston (con dos botones de disparo) y Sinclair (1, 2, 3, 4, 5) con segundo botón de disparo (`z`). El mando conectado al puerto 2 se comporta con protocolo Sinclair (6, 7, 8, 9, 0) y segundo botón de disparo (`x`).
 
 <<<
 
@@ -4240,6 +4306,38 @@ A continuación se enumeran distintos juegos de máquina recreativa, según el c
 |Pang!|Pang|pang
 |===
 
+===== Sega System 16B
+
+[align="center",options="header"]
+|===
+|Nombre Juego|Nombre ROM
+|Alien Syndrome|aliensyn.rom
+|Altered Beast |altbeast.rom
+|Aurail|aurail.rom
+|Bay Route|bayroute.rom
+|Bullet|bullet.rom
+|Cotton|cotton.rom
+|Dunk Shot|dunkshot.rom
+|Dynamite Dux|ddux.rom
+|E-Swat - Cyber Police|eswat.rom
+|Excite League|exctleag.rom
+|Fantasy Zone II - The Tears of Opa-Opa|fantzn2x.rom
+|Flash Point|fpoint.rom
+|Golden Axe|goldnaxe.rom
+|MVP|mvp.rom
+|Passing Shot|passsht.rom
+|Riot City|riotcity.rom
+|RyuKyu|ryukyu.rom
+|Sonic Boom|sonicbom.rom
+|Sukeban Jansi Ryuko|sjryuko.rom
+|Super League|suprleag.rom
+|Time Scanner|timescan.rom
+|Toryumon|toryumon.rom
+|Tough Turf|tturfu.rom
+|Wonder Boy III - Monster Lair|wb3.rom
+|Wrestle War|wrestwar.rom
+|===
+
 <<<
 
 === Enlaces

doc/src/docinfo.html

@@ -0,0 +1,80 @@
+<!-- Generate a nice TOC -->
+<!--
+<script src="https://code.jquery.com/jquery-1.11.3.min.js"></script>
+<script src="https://code.jquery.com/ui/1.11.4/jquery-ui.min.js"></script>
+<script src="https://cdnjs.cloudflare.com/ajax/libs/jquery.tocify/1.9.0/javascripts/jquery.tocify.min.js"></script>
+-->
+<script src="js/jquery-1.11.3.min.js"></script>
+<script src="js/jquery-ui.min.js"></script>
+<script src="js/jquery.tocify.min.js"></script>
+<!-- We do not need the tocify CSS because the asciidoc CSS already provides most of what we neeed -->
+
+<style>
+    .tocify-header {
+        font-style: italic;
+    }
+
+    .tocify-subheader {
+        font-style: normal;
+        font-size: 90%;
+    }
+
+    .tocify ul {
+        margin: 0;
+    }
+
+    .tocify-focus {
+        color: #7a2518;
+        background-color: rgba(0, 0, 0, 0.1);
+    }
+
+    .tocify-focus>a {
+        color: #7a2518;
+    }
+</style>
+
+<script type="text/javascript">
+    $(function () {
+        // Add a new container for the tocify toc into the existing toc so we can re-use its
+        // styling
+        $("#toc").append("<div id='generated-toc'></div>");
+        $("#generated-toc").tocify({
+            extendPage: true,
+            context: "#content",
+            highlightOnScroll: true,
+            hideEffect: "slideUp",
+            // Use the IDs that asciidoc already provides so that TOC links and intra-document
+            // links are the same. Anything else might confuse users when they create bookmarks.
+            hashGenerator: function (text, element) {
+                return $(element).attr("id");
+            },
+            // Smooth scrolling doesn't work properly if we use the asciidoc IDs
+            smoothScroll: false,
+            // Set to 'none' to use the tocify classes
+            theme: "none",
+            // Handle book (may contain h1) and article (only h2 deeper)
+            selectors: $("#content").has("h1").size() > 0 ? "h1,h2,h3,h4,h5" : "h2,h3,h4,h5",
+            ignoreSelector: ".discrete"
+        });
+
+        // Switch between static asciidoc toc and dynamic tocify toc based on browser size
+        // This is set to match the media selectors in the asciidoc CSS
+        // Without this, we keep the dynamic toc even if it is moved from the side to preamble
+        // position which will cause odd scrolling behavior
+        var handleTocOnResize = function () {
+            if ($(document).width() < 768) {
+                $("#generated-toc").hide();
+                $(".sectlevel0").show();
+                $(".sectlevel1").show();
+            }
+            else {
+                $("#generated-toc").show();
+                $(".sectlevel0").hide();
+                $(".sectlevel1").hide();
+            }
+        }
+
+        $(window).resize(handleTocOnResize);
+        handleTocOnResize();
+    });
+</script>