diff --git a/doc/img/bios5.png b/doc/img/bios5.png deleted file mode 100644 index baf5530..0000000 Binary files a/doc/img/bios5.png and /dev/null differ diff --git a/doc/img/portadauno.jpg b/doc/img/portadauno.jpg deleted file mode 100644 index cadf58c..0000000 Binary files a/doc/img/portadauno.jpg and /dev/null differ diff --git a/doc/English Miniduino Manual.adoc b/doc/src/English Miniduino Manual.adoc similarity index 100% rename from doc/English Miniduino Manual.adoc rename to doc/src/English Miniduino Manual.adoc diff --git a/doc/English ZXDOS+ and gomaDOS+ Manual.adoc b/doc/src/English ZXDOS+ and gomaDOS+ Manual.adoc similarity index 99% rename from doc/English ZXDOS+ and gomaDOS+ Manual.adoc rename to doc/src/English ZXDOS+ and gomaDOS+ Manual.adoc index 1dff4d0..ecce743 100644 --- a/doc/English ZXDOS+ and gomaDOS+ Manual.adoc +++ b/doc/src/English ZXDOS+ and gomaDOS+ Manual.adoc @@ -2605,7 +2605,7 @@ image:img/keyboardZX81.jpg[pdfwidth=80%] During the core execution: - `F1` (`Caps Shift+Symbol Shift+1` on gomaDOS+): Enable or disable the alternative chars -- `F5` (`Caps Shift+Symbol Shift+5` on gomaDOS+) or joystick button 2 (or `Caps Shift+Space` on gomaDOS+, `PC XT` keyboard mode): Show or hide configuration menu +- `F5` (`Caps Shift+Symbol Shift+5` on gomaDOS+) or joystick button 2: Show or hide configuration menu - `F9` (`Caps Shift+Symbol Shift+9` on gomaDOS+): Disables or enables the MIC audio output, since some games make annoying sounds when enabled - `F10` (`Caps Shift+Symbol Shift+0` on gomaDOS+): Enables or disables playing the audio input through the audio output, to hear loading sounds while loading - `Scroll Lock` (`Caps Shift+Symbol Shift+G` on gomaDOS+): Switch between RGB and VGA video output @@ -2616,7 +2616,7 @@ During the core execution: ==== Basic Guide -Pressing `F5` (`Caps Shift+Symbol Shift+5` on gomaDOS+) or joystick button 2 (`Caps Shift+Space` on gomaDOS+, `PC XT` keyboard mode) shows or hides the configuration menu. Cursor keys (`Caps Shift+5`, `Caps Shift+6`, `Caps Shift+7` and `Caps Shift+8` on gomaDOS+, `PC XT` keyboard mode) and `Enter` to select and choose menu options. +Pressing `F5` (`Caps Shift+Symbol Shift+5` on gomaDOS+) or joystick button 2 shows or hides the configuration menu. Cursor keys (`Caps Shift+5`, `Caps Shift+6`, `Caps Shift+7` and `Caps Shift+8` on gomaDOS+, `PC XT` keyboard mode) and `Enter` to select and choose menu options. [.text-center] image:img/zx81.jpg[pdfwidth=70%] @@ -3591,7 +3591,7 @@ For a gomaDOS+, since the recovery image uses a PS/2 configuration as default, f *Hardware required*: - USB-Blaster cable. Using the right pins for ZXDOS+, <<#_jtag_cable_connections,as explained earlier>> -- Flash Image file and andrecovery file fo ZXDOS+ (LX25). The same ones as for Raspberry Pi, from the https://github.com/zxdos/zxdos-plus/raw/master/lx25/FLASH.zip[official repository] +- Flash Image file and and recovery file for ZXDOS+ (LX25). The same ones as for Raspberry Pi, from the https://github.com/zxdos/zxdos-plus/raw/master/lx25/FLASH.zip[official repository] *Software required*: @@ -3657,7 +3657,7 @@ image:img/recovery_mac_1.png[pdfwidth=90%] [start=9] . If all goes well, we will see that the FPGA LED change their state and the BIOS is shown on the display. -If there is no image on the display, press `Scroll Lock` (`Caps Shift+Symbol Shift+G` on gomaDOS+): to switch between RGB and VGA modes, just in case the recovery BIOS did start in the wrong mode for our setup. +If there is no image on the display, press `Scroll Lock` (`Caps Shift+Symbol Shift+G` on gomaDOS+) to switch between RGB and VGA modes, just in case the recovery BIOS did start in the wrong mode for our setup. [.text-center] image:img/recovery.png[pdfwidth=70%] @@ -3690,7 +3690,7 @@ Ususally, the recovery image is set to use a PS/2 keyboard so, for a gomaDOS+, s [NOTE] ==== -If no image is shown, press again `Scroll Lock` (`Caps Shift+Symbol Shift+G` on gomaDOS+): to switch between RGB and VGA modes. In this case, you should have to enter the BIOS and change <<#_advanced, the right advanced setting>> that matches your display. +If no image is shown, press again `Scroll Lock` (`Caps Shift+Symbol Shift+G` on gomaDOS+) to switch between RGB and VGA modes. In this case, you should have to enter the BIOS and change <<#_advanced, the right advanced setting>> that matches your display. ==== [NOTE] @@ -3722,7 +3722,7 @@ When using Linux with `urjtag`, the process should be quite similar, although th *Hardware required*: - USB-Blaster cable. Using the right pins for ZXDOS+, <<#_jtag_cable_connections,as explained earlier>> -- Flash Image file and andrecovery file fo ZXDOS+ (LX25). The same ones as for Raspberry Pi, from the https://github.com/zxdos/zxdos-plus/raw/master/lx25/FLASH.zip[official repository] +- Flash Image file and and recovery file for ZXDOS+ (LX25). The same ones as for Raspberry Pi, from the https://github.com/zxdos/zxdos-plus/raw/master/lx25/FLASH.zip[official repository] *Software required*: @@ -3760,7 +3760,7 @@ pld load recovery.zxd.bit [start=9] . If all goes well, we will see that the FPGA LED change their state and the BIOS is shown on the display. -If there is no image on the display, press `Scroll Lock` (`Caps Shift+Symbol Shift+G` on gomaDOS+): to switch between RGB and VGA modes, just in case the recovery BIOS did start in the wrong mode for our setup. +If there is no image on the display, press `Scroll Lock` (`Caps Shift+Symbol Shift+G` on gomaDOS+) to switch between RGB and VGA modes, just in case the recovery BIOS did start in the wrong mode for our setup. [.text-center] image:img/recovery.png[pdfwidth=70%] @@ -3793,7 +3793,7 @@ Ususally, the recovery image is set to use a PS/2 keyboard so, for a gomaDOS+, s [NOTE] ==== -If no image is shown, press again `Scroll Lock` (`Caps Shift+Symbol Shift+G` on gomaDOS+): to switch between RGB and VGA modes. In this case, you should have to enter the BIOS and change <<#_advanced, the right advanced setting>> that matches your display. +If no image is shown, press again `Scroll Lock` (`Caps Shift+Symbol Shift+G` on gomaDOS+) to switch between RGB and VGA modes. In this case, you should have to enter the BIOS and change <<#_advanced, the right advanced setting>> that matches your display. ==== [NOTE] diff --git a/doc/English ZXUNO+ Manual.adoc b/doc/src/English ZXUNO+ and +UNO Manual.adoc similarity index 82% rename from doc/English ZXUNO+ Manual.adoc rename to doc/src/English ZXUNO+ and +UNO Manual.adoc index 2bcb30e..d2bd075 100644 --- a/doc/English ZXUNO+ Manual.adoc +++ b/doc/src/English ZXUNO+ and +UNO Manual.adoc @@ -1,13 +1,13 @@ -= ZXUNO+ Manual += ZXUNO+ and +UNO Manual :author: kounch -:revnumber: 1.2.0 +:revnumber: 1.3.0 :doctype: book :notitle: :front-cover-image: image:img/portadauno.jpg[] :email: kounch@users.noreply.github.com -:Revision: 1.2 -:description: English ZXUNO+ Manual -:keywords: Manual, English, ZXUNO+ +:Revision: 1.3 +:description: English ZXUNO+ and +UNO Manual +:keywords: Manual, English, ZXUNO+, +UNO :icons: font :source-highlighter: rouge :toc: left @@ -18,7 +18,7 @@ == Introduction -ZXUNO+ is the latest iteration of https://zxuno.speccy.org[ZX-Uno] a hardware and software project based on an FPGA board programmed to work like a ZX Spectrum computer, and created by the ZX-Uno team: Superfo, AVillena, McLeod, Quest and Hark0. +ZXUNO+ and +UNO are another iteration of https://zxuno.speccy.org[ZX-Uno] a hardware and software project based on an FPGA board programmed to work like a ZX Spectrum computer, and created by the ZX-Uno team: Superfo, AVillena, McLeod, Quest and Hark0. Over time, the project has been growing, and now it is possible to install different configurations (cores) in the flash memory of the FPGA, which work like different systems than the ZX Spectrum, and you can choose to start the ZXUNO+ with the desired configuration among all those installed. @@ -41,6 +41,8 @@ Without the previous work of all of these people (and more), this manual wouldn' === Ports and Connectors +==== ZXUNO+ + [.text-center] image:./img/zxunofront.png[pdfwidth=65%] @@ -50,6 +52,16 @@ image:./img/zxunoback.png[pdfwidth=65%] [.text-center] image:./img/zxunoboard.png[pdfwidth=65%] +<<< + +==== +UNO + +[.text-center] +image:img/plusuno_frontal.jpg[pdfwidth=45%] + +[.text-center] +image:img/plusuno_trasera.jpg[pdfwidth=70%] + ==== Description [cols=2*] @@ -57,7 +69,7 @@ image:./img/zxunoboard.png[pdfwidth=65%] |1 |Audio Out |2 -|Video Out +|Composite Video Out |3 |Expansion Port |4 @@ -72,16 +84,30 @@ image:./img/zxunoboard.png[pdfwidth=65%] |Mouse USB (PS/2) Port |9 |Keyboard USB (PS/2) Port +|10 +|Left Joystick Port +|11 +|Right Joystick Port +|12 +|RGB/VGA video out +|13 +|Volume control +|14 +|PS/2 Port +|15 +|Reset button +|16 +|Internal speaker opening |=== ===== RJ-45 Video Out -This is the pinout or RJ-45 connector to use as VGA output: +This is the pinout or RJ-45 connector to use as VGA output on a ZXUNO+: [.text-center] image:img/rj45pinout.png[pdfwidth=50%] -This are the pin numbers for RJ-45 connector to use as RGB out with a SCART connector: +This are the pin numbers for RJ-45 connector to use as RGB out with a SCART connector on a ZXUNO+: [.text-center] image:img/rj45scart.png[pdfwidth=50%] @@ -105,7 +131,7 @@ In order to take advantage of its full potential, you may also have: ==== SD card formatting -In order to use a SD card, it has to be formatted with, at least, one FAT16 or FAT32 format (depending on the case, one or the other format is recommended for compatibility with different third-party cores). It must be the first partition if there are more than one, except for the Spectrum core wich can have <<#_SD_advanced_format_3e,the first partition in +3DOS format, and then the second one in FAT16 or FAT32 format>> to use with a +3e ROM. +In order to use a SD card, it has to be formatted with, at least, one FAT16 or FAT32 format (depending on the case, one or the other format is recommended for compatibility with different third-party cores). It must be the first partition if there are more than one, except for the Spectrum core wich can have <<#_sd_advanced_format_3e,the first partition in +3DOS format, and then the second one in FAT16 or FAT32 format>> to use with a +3e ROM. [NOTE] ==== @@ -298,29 +324,244 @@ sudo mkfs.fat -F 16 -n ZXUNOPLUS -s 128 /dev/sdc1 <<< -=== Keyboard +=== Keyboard and mouse + +==== +UNO keyboard + +The +UNO keyboard, being similar to the original ZX Spectrum keyboard, lacks some of the existing keys on a modern PC keyboard. The keyboard membrane is connected to an Arduino board, which manages the transformation key presses to PS/2 keyboard protocol. The board is programmed so it can behave in different modes according to your needs. + +The default is ZX Spectrum mode. To change to a different mode, you must press `Caps Shift+Symbol Shift+U` and then the key for the desired mode. After doing that, some text is automatically typed, to show the selected mode (for example `.zx` if you press `Caps Shift+Symbol Shift+U` and then `0`). + +This table shows the available modes and activation keys: + +[align="center",width="40%",%header,cols=2*] +|=== +|Mode +|Key +|ZX Spectrum +|`0` +|Amstrad CPC +|`1` +|MSX +|`2` +|Commodore 64 +|`3` +|Atari 800XL +|`4` +|BBC Micro +|`5` +|Acorn Electron +|`6` +|Apple (I and II) +|`7` +|Commodore VIC 20 +|`8` +|PC XT +|`9` +|Oric Atmos +|`A` +|SAM Coupé +|`B` +|Jupiter ACE +|`C` +|=== + +<<< + +ZX Spectrum mode key assignment, with the corresponding keypress when used simultaneouly with `Caps Shift+Symbol Shift`: + +[align="center",width="80%",cols=10*] +|=== +^|**1** +^|**2** +^|**3** +^|**4** +^|**5** +^|**6** +^|**7** +^|**8** +^|**9** +^|**0** +^|`F1` +^|`F2` +^|`F3` +^|`F4` +^|`F5` +^|`F6` +^|`F7` +^|`F8` +^|`F9` +^|`F1` +^|**Q** +^|**W** +^|**E** +^|**R** +^|**T** +^|**Y** +^|**U** +^|**I** +^|**O** +^|**P** +^|`F11` +^|`F12` +^| +^| +^| +^| +^|`Mode` +^| +^| +^| +^|**A** +^|**S** +^|**D** +^|**F** +^|**G** +^|**H** +^|**J** +^|**K** +^|**L** +^|**Enter** +^| +^| +^| +^| +^|`ScrLk` +^| +^| +^| +^| +^| +^|**CShift** +^|**Z** +^|**X** +^|**C** +^|**V** +^|**B** +^|**N** +^|**M** +^|**SShift** +^|**Space** +^| +^| +^|`Save` +^| +^|`Vers` +^|`hRes` +^|`sRes` +^| +^| +^| +|=== + +Where: + +- `ScrLk`: `Scroll Lock` changes between RGB and VGA video mode (on Next Core, you must use `Caps Shift+Symbol Shift+2` or`F2` instead) +- `Save`: Sets the current mode as the default one +- `Vers`: Shows (types) current firmware version +- `hRes`: Hard Reset +- `sRes`: Soft Reset + +<<< + +The full list of key combinations (and compatible modes) is as follows: + +[align="center",width="75%",%header,cols=3*] +|=== +|Caps S.+Symbol S. +|Mode +|Action +|1 +|All +|`F1` +|2 +|All +|`F2` +|3 +|All +|`F3` +|4 +|All +|`F4` +|5 +|All +|`F5` +|6 +|All +|`F6` +|7 +|All +|`F7` +|8 +|All +|`F8` +|9 +|All +|`F9` +|0 +|All +|`F10` +|Q +|All +|`F11` +|W +|All +|`F12` +|S +|C64 +|`Ctrl+F12` +|E +|Acorn/CPC +|`PgUp` +|R +|Acorn +|`PgDown` +|U +|All +|`Mode` +|G +|ZX/MSX/C64 +|`ScrLk` +|X +|All +|`Save` +|C +|PC +|`OPQA` +|V +|All +|`Version` +|B +|ZX +|`Ctrl+Alt+Bcksp` +|N +|ZX +|`Ctrl+Alt+Supr` +|=== + +<<< ==== PS/2 Keyboard The keyboard map (physical keys of the keyboard assignment to the keystrokes that are presented to the different cores) is changed using the `Advanced` menu of the BIOS. There are three different maps to choose from: Spanish (default), English, and Spectrum (advanced). -You can also change it using the `keymap` utility. Inside `/bin` you have to create a directory named `keymaps` and copy inside the keyboard map files that you want to use. For example, to switch to the US map you have to write `.keymap us` from esxdos. +You can also change it using the `keymap` utility. Inside `/sys` you have to create a directory named `keymaps` and copy inside the keyboard map files that you want to use. For example, to switch to the US map you have to write `.keymap us` from esxdos. For the map to be preserved after a master reset, it has to be selected as `Default` in the BIOS. For more information, see https://www.zxuno.com/forum/viewtopic.php?f=37&t=208[this message in the ZX-Uno forum]. -==== Spanish +*Spanish* [.text-center] image:./img/keyboardEsp.png[pdfwidth=70%] -==== English +*English* [.text-center] image:./img/keyboardEng.png[pdfwidth=70%] -==== Spectrum +*Spectrum* [.text-center] image:./img/keyboardAV.png[pdfwidth=70%] @@ -331,7 +572,7 @@ image:./img/keyboardAV.png[pdfwidth=70%] Special keys which can be used during startup: -- `F2`: Enter BIOS setup +- `F2` (`Caps Shift+Symbol Shift+2` on +UNO): Enter BIOS setup - `Caps Lock` or `Cursor down` or, if a joystick is connected, pressing `down`: Core selection menu - `Esc`, or if a joystick with two or more fire buttons is connected, pressing the 2nd fire button: ZX Spectrum core ROM selection menu - `R`: Loads the Spectrum core ROM in "real" mode, disabling esxdos, new graphics modes, etc. (pressing `Esc` afterwards allows you to choose another core) @@ -341,19 +582,30 @@ Special keys which can be used during startup: Special keys that can be used while running the main core (ZX Spectrum): - `Esc`: BREAK -- `F2`: Edit -- `F5`: NMI -- `F7`: Play or pause when playing .PZX files -- `F8`: Rewind .PZX file to the previous mark -- `F10`: Graph -- `F12`: Turbo Boost. Speeds up CPU to 28MHz while pressed (beginnig with core EXP27). -- `Ctrl+Alt+Backspace`: Hard reset. Backspace is the delete key, located in the top-right portion of the keyboard, above `Enter`. -- `Ctrl+Alt+Supr`: Soft reset. +- `F2` (`Caps Shift+Symbol Shift+2` on +UNO): Edit +- `F3` (`Caps Shift+Symbol Shift+3` on +UNO): True Video +- `F4` (`Caps Shift+Symbol Shift+4` on +UNO): Inverse Video +- `F5` (`Caps Shift+Symbol Shift+5` on +UNO): NMI +- `F7` (`Caps Shift+Symbol Shift+7` on +UNO): Play or pause when playing .PZX files +- `F8` (`Caps Shift+Symbol Shift+8` on +UNO): Rewind .PZX file to the previous mark +- `F10` (`Caps Shift+Symbol Shift+0` on +UNO): Graph +- `F12` (`Caps Shift+Symbol Shift+W` on +UNO): Turbo Boost. Speeds up CPU to 28MHz while pressed (beginnig with core EXP27). +- `Ctrl+Alt+Backspace` (`Caps Shift+Symbol Shift+B` on +UNO): Hard reset. Backspace is the delete key, located in the top-right portion of the keyboard, above `Enter`. +- `Ctrl+Alt+Del` (`Caps Shift+Symbol Shift+N` on +UNO): Soft reset. - `Scroll Lock`: Switches between composite and VGA video modes. <<< -==== esxdos +==== PS/2 Mouse + +You can also connect a mouse to the PS/2 port. The switch inside a +UNO, near the Wi-Fi chip and keys `1` and `2`, selects between a direct connection of the mouse, or if a PS/2 splitter cable is needed (when using the mouse along with a PS/2 keyboard). + +[.text-center] +image:./img/plusuno_switch.jpg[pdfwidth=70%] + +<<< + +=== esxdos https://esxdos.org/index.html[esxdos] is a firmware for the DivIDE/DivMMC hardware interfaces (which ZXUNO+ implements). This allows access to storage devices such as a SD card. It includes commands similar to those of UNIX, although to use them you must precede them with a period, for example `.ls`,` .cd`, `.mv`, etc. @@ -388,7 +640,7 @@ It is also recommended to add the specific esxdos commands for ZXUNO+. These can zxuc zxunocfg -<<#_zxuno+_commands,It is explained later>> what each of them does. +<<#_zxuno_commands,It is explained later>> what each of them does. <<< @@ -446,7 +698,7 @@ The second screen shows the installed ZX Spectrum ROMs. You can reorder (Move Up [.text-center] image:img/bios3.png[pdfwidth=70%] -_Upgrade_ screen is used to perform the different updates of the Flash memory content: esxdos, BIOS, Cores, etc. (see <<#_updates,the section corresponding to updates>> for more information). +_Upgrade_ screen is used to perform the different updates of the Flash memory content: esxdos, BIOS, Cores, etc. (see <<#_upgrade,the section corresponding to upgrades>> for more information). <<< @@ -457,6 +709,11 @@ image:img/bios4.png[pdfwidth=70%] In the _Boot_ screen you can choose which one of the installed cores is loaded by default at startup. +[CAUTION] +==== +Never set a Spectrum core (apart from the main one, the first core in the flash. This would set the ZX-Uno into a loop of core resets. +==== + <<< ==== Advanced @@ -467,14 +724,63 @@ image:img/bios5.png[pdfwidth=70%] The Advanced configuration screen is used to edit the following settings: - Keyboard layout (Keyb Layout): See <<#_keyboard,the corresponding section>> for more information) -- Joystick behavior when emulated with the numeric keypad (Joy Keypad): Kempston, Sinclair Joystick 1, Sinclair Joystick 2, Protek or Fuller -- Behavior of a joystick connected to the port (Joy DB9): Kempston, Sinclair Joystick 1, Sinclair Joystick 2, Protek, Fuller or simulate the keys `Q`,` A`, `O`,` P`, `Space` and `M` +- Joystick behavior when emulated with the numeric keypad (Joy Keypad) and the second joystick (with splitter): Kempston, Sinclair Joystick 1, Sinclair Joystick 2, Protek or Fuller +- Behavior of a joystick connected to the main port (Joy DB9): Kempston, Sinclair Joystick 1, Sinclair Joystick 2, Protek, Fuller or simulate the keys `Q`,` A`, `O`,` P`, `Space` and `M` +- Enable the second physical joystick (splitter). Only on +UNO and for cores which have splitter support - Video output: PAL, NTSC or VGA - Scanlines simulation: Enabled or Disabled - VGA horizontal frequency: 50, 51, etc. - CPU speed: Normal (1x) or accelerated (2X, 3X, etc.) - Csync: Spectrum or PAL +This table explains how the joystick buttons are assigned: + +[align="center",width="100%",%header,cols=6*,options="header"] +|=== +|Button +|Kempston +|Sinclair 1 +|Sinclair 2 +|Protek +|Fuller +|Left +|Bit 0 +|1 +|6 +|5 +|Bit 2 +|Right +|Bit 1 +|2 +|7 +|8 +|Bit 3 +|Down +|Bit 2 +|3 +|8 +|6 +|Bit 1 +|Up +|Bit 3 +|4 +|9 +|7 +|Bit 0 +|Fire 1 +|Bit 4 +|5 +|0 +|0 +|Bit 4 +|Fire 2 +|Bit 5 +|X +|Z +|9 +|Bit 5 +|=== + <<< ==== Exit @@ -1373,13 +1679,13 @@ See the <<#_cores,corresponding section>> for instructions of how to install thi While the core is running: - `End`: Switches between colour, green monochrome, amber monochrome and black and white -- `F6`: Sets up a custom mark at the current PZX position (only in the version with PZX support) +- `F6` (`Caps Shift+Symbol Shift+6` on +UNO): Sets up a custom mark at the current PZX position (only in the version with PZX support) - `F7: PXC Play/Pause (only in the version with PZX support) - `F8: Moves the PZX position to a the custom mark (only in the version with PZX support) - `CTRL+ F8: Rewinds the PZX position to a "tag BRWS" mark. These marks are used, for example, to label where a multiload starts (only in the version with PZX support) - `F9: Stops playing the PZX and set the position back to the beginning (only in the version with PZX support) -- `F11`: Enabe or disable the Wi-Fi module -- `F12`: Enable or disable 28 MHz CPU speed. +- `F11` (`Caps Shift+Symbol Shift+Q` on +UNO): Enabe or disable the Wi-Fi module +- `F12` (`Caps Shift+Symbol Shift+W` on +UNO): Enable or disable 28 MHz CPU speed. The PZX player will stop when it gets to the end of the file, or if it finds a STOP mark, or if it finds a STOP IF IN 48K mark and the core is in 48K mode (no 128K pagination). @@ -1414,8 +1720,8 @@ See the <<#_cores,corresponding section>> for instructions of how to install thi While the core is running: - `Esc`: BREAK -- `F5`: NMI -- `F8`: Change Turbosound mixer configuration between ACB and ABC. +- `F5` (`Caps Shift+Symbol Shift+5` on +UNO): NMI +- `F8` (`Caps Shift+Symbol Shift+8` on +UNO): Change Turbosound mixer configuration between ACB and ABC. - `Scroll Lock`: Switches between composite and VGA video modes. - `Ctrl+Alt+Backspace` or `F11`: Hard reset. Backspace is the delete key, located in the top-right portion of the keyboard, above `Enter`. - `Ctrl+Alt+Supr` or `F12`: Soft reset. @@ -1445,8 +1751,8 @@ See the <<#_cores,corresponding section>> for instructions of how to install thi While the core is running: - `Esc`: BREAK -- `F5`: NMI -- `F8`: Change Turbosound mixer configuration between ACB and ABC. +- `F5` (`Caps Shift+Symbol Shift+5` on +UNO): NMI +- `F8` (`Caps Shift+Symbol Shift+8` on +UNO): Change Turbosound mixer configuration between ACB and ABC. - `Ctrl+Alt+Backspace` or `F11`: Hard reset. Backspace is the delete key, located in the top-right portion of the keyboard, above `Enter`. - `Ctrl+Alt+Supr` or `F12`: Soft reset. @@ -1476,11 +1782,11 @@ See the <<#_cores,corresponding section>> for instructions of how to install thi While the core is running: -- `F5`: NMI -- `F8`: Change Turbosound betwween ACB and ABC. -- `F10`: Pentagon Mode -- `F11`: 48K Mode -- `F12`: 128K Mode +- `F5` (`Caps Shift+Symbol Shift+5` on +UNO): NMI +- `F8` (`Caps Shift+Symbol Shift+8` on +UNO): Change Turbosound betwween ACB and ABC. +- `F10` (`Caps Shift+Symbol Shift+0` on +UNO): Pentagon Mode +- `F11` (`Caps Shift+Symbol Shift+Q` on +UNO): 48K Mode +- `F12` (`Caps Shift+Symbol Shift+W` on +UNO): 128K Mode - `Ctrl+Alt+Backspace` or `F11`: Hard reset. Backspace is the delete key, located in the top-right portion of the keyboard, above `Enter` - `Ctrl+Alt+Supr` or `F12`: Soft reset. @@ -1532,7 +1838,7 @@ Obtain the TBBlue distribution that matches the core version, for example, looki [TIP] ==== -If you are using a SD card with <>, the `esxmmc.rom` file version must match the one of the SD card. +If you are using a SD card with <<#_esxdos,esxdos>>, the `esxmmc.rom` file version must match the one of the SD card. ==== See the <<#_cores,corresponding section>> for instructions of how to install the TBBlue core in ZXUNO+. @@ -1616,11 +1922,11 @@ You can set up the files in the SD in two different ways: While the core is running: - `Shift+F10`: Shows Atom Software Archive Menu -- `F10`: Soft Reset -- `F1`: Turbo mode 1Mhz -- `F2`: Turbo mode 2Mhz -- `F3`: Turbo mode 4Mhz -- `F4`: Turbo mode 8Mhz +- `F10` (`Caps Shift+Symbol Shift+0` on +UNO): Soft Reset +- `F1` (`Caps Shift+Symbol Shift+1` on +UNO): Turbo mode 1Mhz +- `F2` (`Caps Shift+Symbol Shift+2` on +UNO): Turbo mode 2Mhz +- `F3` (`Caps Shift+Symbol Shift+3` on +UNO): Turbo mode 4Mhz +- `F4` (`Caps Shift+Symbol Shift+4` on +UNO): Turbo mode 8Mhz The keyboard uses the following mapping: @@ -1676,7 +1982,7 @@ While the core is running: - `Scroll Lock`: Switches between composite and VGA video. - `Ctrl+Shift+1` to `Ctrl+Shift+4`: Use other graphic modes (60Hz, etc) - `F10` and `Ctrl+F10`: Soft Reset -- `Ctrl+Alt+Backspace`: Hard reset. Backspace is the delete key, located in the top-right portion of the keyboard, above `Enter` +- `Ctrl+Alt+Backspace` (`Caps Shift+Symbol Shift+B` on +UNO): Hard reset. Backspace is the delete key, located in the top-right portion of the keyboard, above `Enter` <<< @@ -1769,8 +2075,8 @@ During core execution: - `Print Scr` or `Left Windows`: `COPY` - `F10` and `Ctrl+F10`: Soft Reset. - `Ctrl+Alt+F5`: NMI. -- `Ctrl+Alt+Del`: Reset. -- `Ctrl+Alt+Backspace`: Hard reset. Backspace is the delete key, located in the top-right portion of the keyboard, above `Enter`. +- `Ctrl+Alt+Del` (`Caps Shift+Symbol Shift+N` on +UNO): Reset. +- `Ctrl+Alt+Backspace` (`Caps Shift+Symbol Shift+B` on +UNO): Hard reset. Backspace is the delete key, located in the top-right portion of the keyboard, above `Enter`. - `End`: Switches beteween color and green screen modes ==== Basic Guide @@ -1953,8 +2259,8 @@ While the core is running: - `*` (numeric keyboard): Change between colour monitor and black and white - `F1` to `F10`: Insert disk image between 1 and 10 from the SD. Press `F12` afterwards. - `Shift+F1` to `Shift+F10`: : Insert disk image between 11 and 20 from the SD. Press `F12` afterwards. -- `Ctrl+Alt+Backspace`: Hard reset. Backspace is the delete key, located in the top-right portion of the keyboard, above `Enter` -- `F12`: Soft reset. +- `Ctrl+Alt+Backspace` (`Caps Shift+Symbol Shift+B` on +UNO): Hard reset. Backspace is the delete key, located in the top-right portion of the keyboard, above `Enter` +- `F12` (`Caps Shift+Symbol Shift+W` on +UNO): Soft reset. <<< @@ -1986,8 +2292,8 @@ Special keys that can be used while running the core: - `Z` and `X` (or joystick fire buttons): Fire Buttons - `0`: When in a vertical core, enable or disable 90º rotation of directional controls - `Scroll Lock`: Switches between composite and VGA video modes. -- `F10`: Soft Reset -- `Ctrl+Alt+Backspace`: Hard reset. Backspace is the delete key, located in the top-right portion of the keyboard, above `Enter`. +- `F10` (`Caps Shift+Symbol Shift+0` on +UNO): Soft Reset +- `Ctrl+Alt+Backspace` (`Caps Shift+Symbol Shift+B` on +UNO): Hard reset. Backspace is the delete key, located in the top-right portion of the keyboard, above `Enter`. <<< @@ -2019,13 +2325,13 @@ While the core is running: - `Scroll Lock`: change between RGB and VGA video mode - `-`: Enable or disable scanlines in VGA mode - `*`: Change machine type between PAL and NTSC -- `Ctrl+Alt+Backspace`: Hard reset. -- `F5`: `Help` -- `F6`: `Start` -- `F7`: `Select` -- `F9`: `Reset` -- `F11`: Load a disk -- `F12`: Show or hide the configuration menu +- `Ctrl+Alt+Backspace` (`Caps Shift+Symbol Shift+B` on +UNO): Hard reset. +- `F5` (`Caps Shift+Symbol Shift+5` on +UNO): `Help` +- `F6` (`Caps Shift+Symbol Shift+6` on +UNO): `Start` +- `F7` (`Caps Shift+Symbol Shift+7` on +UNO): `Select` +- `F9` (`Caps Shift+Symbol Shift+9` on +UNO): `Reset` +- `F11` (`Caps Shift+Symbol Shift+Q` on +UNO): Load a disk +- `F12` (`Caps Shift+Symbol Shift+W` on +UNO): Show or hide the configuration menu - The numeric keypad emulates a joystic, where `5` and `2` keys work as __down__ direction and `0` is the fire button <<< @@ -2063,7 +2369,7 @@ ZXUNO+ core version is developed by Quest and DistWave. Some of the features of the core are: - RGB and VGA support -- Support for joysticks, keyboard, mouse and rotary encoder controls (see <<#_rotary_enoders,here>> for more information) +- Support for joysticks, keyboard, mouse and rotary encoder controls (see <<#_rotary_encoders,here>> for more information) ==== SD card format @@ -2082,7 +2388,18 @@ During the core execution: - `I`, `J`, `K`, `L` or joystick 2: Directional controls for player 2 - `H` or joystick 2 fire button: Player 2 fire button - `Scroll Lock`: change between RGB and VGA video mode -- `Ctrl+Alt+Backspace`: Hard reset. +- `Ctrl+Alt+Backspace` (`Caps Shift+Symbol Shift+B` on +UNO): Hard reset. + +===== Personalización de los controles + +Existe oras versiones de este core que permite modificar el soporte de teclado. Para ello, se ha de crear en la raiz de la tarjeta SD un fichero llamado KEYSP1` para el primer jugador y `KEYSP2` para el segundo (se puede descargar uno de ejemplo desde https://www.zxuno.com/forum/download/file.php?id=1360[el foro de ZX-Uno]). + +Estos ficheros se pueden crear con un editor hexadecimal (como https://mh-nexus.de/en/hxd/[HxD para Windows])y están formados por una secuencia de bytes indicando en este orden: `Arriba`, `Abajo`, `Izquierda`, `Derecha`, `Botón de disparo`. Los códigos a utilizar en la secuencia se pueden consultar en la tabla <<#_scan_codes,Scan Codes>> al final del manual (Columna MAKE), pero, teniendo en cuenta que, si el código está emparejado con `0xE0`, se ha de usar el otro valor, sumánole `0x80` (por ejemplo, para `E0 14`, sería `0x94`). + +[TIP] +==== +Por ejemplo, la secuencia `15 1C 44 4D 29` se correspondería con `Q A O P Espacio` +==== <<< @@ -2152,9 +2469,9 @@ While the core is running: - `Scroll Lock`: change between RGB and VGA video mode - `-` (numeric keyboard): Enable or disable scanlines in VGA mode -- `F12`: Reset +- `F12` (`Caps Shift+Symbol Shift+W` on +UNO): Reset - `Shift+F12`: Soft Reset trying to load automatically the selected disk at `BEEB.MMB` -- `Ctrl+Alt+Backspace`: Hard reset. Backspace is the delete key, located in the top-right portion of the keyboard, above `Enter`. +- `Ctrl+Alt+Backspace` (`Caps Shift+Symbol Shift+B` on +UNO): Hard reset. Backspace is the delete key, located in the top-right portion of the keyboard, above `Enter`. <<< @@ -2196,6 +2513,8 @@ To load, for example, a file name `MENU`, use the command: *MENU ---- +<<< + To show the list of available discs inside `BEEB.MMB` file: [source] @@ -2220,7 +2539,7 @@ Remember that, after inserting a disc, if it has automatic boot, you can start i https://en.wikipedia.org/wiki/Camputers_Lynx[The Lynx] was an 8-bit British home computer that was first released in early 1983 as a 48kB model.Several models were available with 48kB, 96kB or 128 kB RAM. -The ZXUNO+ core has these features: +The ZX-Uno core has been https://github.com/Kyp069/lynx[developed by Kyp069] and has these features: - 48kB and 96 kB modes - Optional Scorpion ROM @@ -2238,11 +2557,11 @@ This core does not use the SD card While running the core: -- `F6`: Switch between 48kB mode and 96kB mode (default) -- `F7`: Enable or disable Scorpio ROM -- `F8`: Switch the option to consider port $80 bits 2 and 3, so that Level 9 games are displayed properly. -- `Ctrl+Alt+Del`: Reset. -- `Ctrl+Alt+Backspace`: Hard reset. Backspace is the delete key, located in the top-right portion of the keyboard, above `Enter`. +- `F6` (`Caps Shift+Symbol Shift+6` on +UNO): Switch between 48kB mode and 96kB mode (default) +- `F7` (`Caps Shift+Symbol Shift+7` on +UNO): Enable or disable Scorpio ROM +- `F8` (`Caps Shift+Symbol Shift+8` on +UNO): Switch the option to consider port $80 bits 2 and 3, so that Level 9 games are displayed properly. +- `Ctrl+Alt+Del` (`Caps Shift+Symbol Shift+N` on +UNO): Reset. +- `Ctrl+Alt+Backspace` (`Caps Shift+Symbol Shift+B` on +UNO): Hard reset. Backspace is the delete key, located in the top-right portion of the keyboard, above `Enter`. <<< @@ -2270,7 +2589,7 @@ Binary files are loaded with `MLOAD` instead of `LOAD`. Maxduino, which is used in <<#_miniduino,miniduino>> does not, at this moment, native support for Lynx tape files. ==== -You can use programs like <<#_audio_file_conversion,Lynx2Wav>> with Lynx `TAP` files. The resulting audio files can be embedded inside of TSX or TZX with tools like <<#_creación_de_ficheros_tzx_o_tsx_desde_otros_formatos,MakeTSX or RetroConverter>>. +You can use programs like <<#_audio_file_conversion,Lynx2Wav>> with Lynx `TAP` files. The resulting audio files can be embedded inside of TSX or TZX with tools like <<#_making_tzx_or_tsx_files_from_other_formats,MakeTSX or RetroConverter>>. The http://retrowiki.es/viewtopic.php?f=31&t=200036835[lince] script makes all this process easier, creating directly Maxduino `TZX` compatible files from Lynx `TAP` files. @@ -2306,8 +2625,8 @@ The CHIP-8 machine uses an hexadecimal keyboard as input. This is the key mappin While the core is running: - `Esc`: Show or hide configuration menu -- `F11`: Hard Reset -- `F12`: Reset +- `F11` (`Caps Shift+Symbol Shift+Q` on +UNO): Hard Reset +- `F12` (`Caps Shift+Symbol Shift+W` on +UNO): Reset <<< @@ -2400,9 +2719,9 @@ The `Clear` key is not implemented. While the core is running: - `Windows`: `MODSEL` -- `F5`: NMI -- `F11`: Hard Reset -- `F12` o `Ctrl+Alt+Supr`: Reset +- `F5` (`Caps Shift+Symbol Shift+5` on +UNO): NMI +- `F11` (`Caps Shift+Symbol Shift+Q` on +UNO): Hard Reset +- `F12` o `Ctrl+Alt+Del` (`Caps Shift+Symbol Shift+N` on +UNO): Reset <<< @@ -2433,7 +2752,7 @@ The https://en.wikipedia.org/wiki/Commodore_16[Commodore 16] was a home computer The ZXUNO+ core is based on https://hackaday.io/project/11460-fpgated[FPGATED project from István Hegedus], with some changes and upgrades, like loading tapes from audio sources. -Featutres: +Features: - Commodore 16 PAL expanded to 64K RAM - 1541 Floppy, redirected to SD RAW. Read only (.D64 image files) @@ -2517,9 +2836,9 @@ While the core is running: - `+`: Change audio input polarity - `-`: Enable or disable scanlines in VGA mode - `Scroll Lock`: change between RGB and VGA video mode -- `F11`: Change joystick between port 0 and port 1 -- `F12`: Soft Reset -- `Ctrl+Alt+Backspace`: Hard reset. +- `F11` (`Caps Shift+Symbol Shift+Q` on +UNO): Change joystick between port 0 and port 1 +- `F12` (`Caps Shift+Symbol Shift+W` on +UNO): Soft Reset +- `Ctrl+Alt+Backspace` (`Caps Shift+Symbol Shift+B` on +UNO): Hard reset. <<< @@ -2530,6 +2849,16 @@ image:img/c16.png[pdfwidth=70%] From within BASIC, you can load from a external tape (or <<#_miniduino,other external audio device>>) with the command `LOAD`. One it's finished, type `RUN` and press `Enter` if needed. +[NOTE] +==== +El software Maxduino incorporando en <<#_miniduino,el miniduino>> no tiene, por el momento, soporte para los archivos de cinta de Commodore 16, pero posible utilizar <<#_audio_file_conversion,Comodoro>> para generar ficheros `TZX` compatibles +==== + +[TIP] +==== +Es posible utilizar programas como <<#_audio_file_conversion,Audiotap o Comodoro>> con los ficheros `TAP` de cinta de Commodore. +==== + To show the contents of the current disk, press `F3` or use the command `DIRECTORY`. To load a file from disk use the command `DLOAD""` and then, usually, `RUN`. To load the first `PRG` file of a disk, press `Shit+TAB` or use the commadn `DLOAD"*"`. @@ -2620,8 +2949,8 @@ While the core is running: - `Alt` = Commodore - Numeric Keyboard: Emulated Joystick - `F1` to `F8`: F1 to F8 -- `F9`: Pound symbol key -- `F10`: `+` symbol key +- `F9` (`Caps Shift+Symbol Shift+9` on +UNO): Pound symbol key +- `F10` (`Caps Shift+Symbol Shift+0` on +UNO): `+` symbol key - `Insert`: Select the first disk in the SD card - `Page Up`: Select the next disk - `Page Down`: Select the previous disk @@ -2631,10 +2960,10 @@ While the core is running: - `-`: Enable or disable scanlines in VGA mode - `Scroll Lock`: change between RGB and VGA video mode - `End`: Change the colour palette -- `F11`: Change joystick port behaviour +- `F11` (`Caps Shift+Symbol Shift+Q` on +UNO): Change joystick port behaviour - `Ctrl+F12`: Soft Reset to JyffyDOS mode - `Ctrl+F12`: Soft Reset to original C64 ROM mode (to load from tape) -- `Ctrl+Alt+Backspace`: Hard reset. +- `Ctrl+Alt+Backspace` (`Caps Shift+Symbol Shift+B` on +UNO): Hard reset. <<< @@ -2645,6 +2974,21 @@ image:img/c64.png[pdfwidth=70%] From within BASIC, you can load from a external tape (or <<#_miniduino,other external audio device>>) with the command `LOAD`. One it's finished, type `RUN` and press `Enter` if needed. +[NOTE] +==== +Para cargar desde cinta se debe estar usando la ROM de C64 original que se activa con `Ctrl+F12`. +==== + +[NOTE] +==== +El software Maxduino incorporando en <<#_miniduino,el miniduino>> no tiene, por el momento, soporte para los archivos de cinta de Commodore 64, pero posible utilizar <<#_audio_file_conversion,Comodoro>> para generar ficheros `TZX` compatibles +==== + +[TIP] +==== +Es posible utilizar programas como <<#_audio_file_conversion,Audiotap o Comodoro>> con los ficheros `TAP` de cinta de Commodore. +==== + To show the contents of the current disk, press `Shift+Esc` or use the command `LOAD "*",8,1`. Once you see READY on screen, use the command `RUN`. If the disk has more than one program, press `F1` or use the command `LOAD "$"`. Then use the command `LIST` to see a list of the files in the disk. @@ -2674,7 +3018,7 @@ This core does not use the SD card While running the core: -- `F1`: Cancel tape loading +- `F1` (`Caps Shift+Symbol Shift+1` on +UNO): Cancel tape loading - `Alt`: Type using graphic mode <<< @@ -2688,7 +3032,12 @@ You can load from a external tape (or other external audio device) with the comm [NOTE] ==== -Maxduino, which is used in <<<<#_miniduino,miniduino>> does not, at this moment, support for Commodore PET tape files. +Maxduino, which is used in <<#_miniduino,miniduino>> does not, at this moment, support for Commodore PET tape files, pero posible utilizar <<#_audio_file_conversion,Comodoro>> para generar ficheros `TZX` compatibles +==== + +[TIP] +==== +Es posible utilizar programas como <<#_audio_file_conversion,Audiotap o Comodoro>> con los ficheros `TAP` de cinta de Commodore. ==== [TIP] @@ -2725,10 +3074,10 @@ While the core is running: - `F9` to `F11`: Load cartridges embedded in the core - Numeric keyboard `-`: Change audio input polarity. The red LED is enable when inverted. - `Scroll Lock`: To switch between composite video and VGA -- `F11`: Swtich the joystick mapping between port 0 or port 1 +- `F11` (`Caps Shift+Symbol Shift+Q` on +UNO): Swtich the joystick mapping between port 0 or port 1 - `Num Lock`: Reset disabling the 32K memory expansion (enabled by default) -- `F12`: Reset enabling the memory expansion -- `Ctrl+Alt+Backspace`: Hard reset. Backspace is the delete key, located in the top-right portion of the keyboard, above `Enter` +- `F12` (`Caps Shift+Symbol Shift+W` on +UNO): Reset enabling the memory expansion +- `Ctrl+Alt+Backspace` (`Caps Shift+Symbol Shift+B` on +UNO): Hard reset. Backspace is the delete key, located in the top-right portion of the keyboard, above `Enter` <<< @@ -2741,9 +3090,15 @@ You can load from a external tape (or other external audio device) with the comm [NOTE] ==== -Maxduino, which is used in <<#_miniduino,miniduino>> does not, at this moment, support for Commodore VIC-20 tape files. +Maxduino, which is used in <<#_miniduino,miniduino>> does not, at this moment, support for Commodore VIC-20 tape files, pero es posible utilizar <<#_audio_file_conversion,Comodoro>> para generar ficheros `TZX` compatibles ==== +[TIP] +==== +Es posible utilizar programas como <<#_audio_file_conversion,Audiotap o Comodoro>> con los ficheros `TAP` de cinta de Commodore. +==== + + [TIP] ==== You can use programs like <<#_audio_file_conversion,Audiotap>> with Commodore `TAP` files. @@ -2805,18 +3160,18 @@ You can use a SD card with the first partition in FAT16 format, where you can st While the core is running: -- `F1`: Normal speed -- `F2`: 2x speed -- `F3`: 4x speed -- `F9`: Enable or disable sound +- `F1` (`Caps Shift+Symbol Shift+1` on +UNO): Normal speed +- `F2` (`Caps Shift+Symbol Shift+2` on +UNO): 2x speed +- `F3` (`Caps Shift+Symbol Shift+3` on +UNO): 4x speed +- `F9` (`Caps Shift+Symbol Shift+9` on +UNO): Enable or disable sound - `Esc`: Freezes a BASIC or machine code execution. Pressing again the same key, resumes the execution - `Del`: Pauses a BASIC program execution while being pressed - `End`: BREAKs a BASIC program execution - `Shift.+M`: Enables plus mode in those programs that have the support (e.g. TETRIS.GTP) - `M`: Gets back to normal mode from plus mode -- `F12`: Soft Reset +- `F12` (`Caps Shift+Symbol Shift+W` on +UNO): Soft Reset - `Ctrl+Alt+F5`: NMI -- `Ctrl+Alt+Supr`: Soft Reset +- `Ctrl+Alt+Del` (`Caps Shift+Symbol Shift+N` on +UNO): Soft Reset - `Ctrl+Alt+F12`: Master Reset <<< @@ -2889,7 +3244,7 @@ While the core is running: - `F6` : Change paper colour - `F7` : Change border colour - `F9` : Select 64 or 32 columns mode (only with VGA output) -- `F10`: `PAGE` key +- `F10` (`Caps Shift+Symbol Shift+0` on +UNO): `PAGE` key - `Home`: `CLEAR` key - `Scroll Lock`: Select between VGA and PAL mode. - `Shift+0`: If `ULCBAS.CAS` has been loadead (Upper/Lower Case Driver) changes between only uppercase mode or uppercase and lowercase mode @@ -2966,10 +3321,10 @@ You can use a SD card with the first partition in FAT16 format, where you can st While the core is running: - `F1` to `F4`: Turbo Modes -- `F12`: Soft Reset +- `F12` (`Caps Shift+Symbol Shift+W` on +UNO): Soft Reset - `Ctrl+Alt+F5`: NMI -- `Ctrl+Alt+Supr`: Reset -- `Ctrl+Alt+Backspace`: Hard reset. Backspace is the delete key, located in the top-right portion of the keyboard, above `Enter` +- `Ctrl+Alt+Del` (`Caps Shift+Symbol Shift+N` on +UNO): Reset +- `Ctrl+Alt+Backspace` (`Caps Shift+Symbol Shift+B` on +UNO): Hard reset. Backspace is the delete key, located in the top-right portion of the keyboard, above `Enter` <<< @@ -3064,10 +3419,10 @@ While running the core: - `Print Scr`: Changes between VGA and RGB mode - `Scroll Lock`: Enables or disables scanlines - `Pause`: Changes between 50Hz and 60Hz -- `F11`: Enables and disables turbo mode -- `Ctrl+Alt+Supr`: Soft Reset +- `F11` (`Caps Shift+Symbol Shift+Q` on +UNO): Enables and disables turbo mode +- `Ctrl+Alt+Del` (`Caps Shift+Symbol Shift+N` on +UNO): Soft Reset - `Ctrl+Alt+F12`: Hard Reset -- `Ctrl+Alt+Backspace`: Restarts the FPGA +- `Ctrl+Alt+Backspace` (`Caps Shift+Symbol Shift+B` on +UNO): Restarts the FPGA - `Left ALT`: MSX GRAPH - `Right ALT`: MSX CODE - `Page Up`: MSX SELECT @@ -3254,7 +3609,29 @@ While the core is running: - `Esc` or joystick button 2: Show or hide configuration menu - Cursor keys, and `Enter` to use the menu -- `Ctrl+Alt+Backspace`: Hard reset +- `Ctrl+Alt+Backspace` (`Caps Shift+Symbol Shift+B` on +UNO): Hard reset + +===== Personalización de los controles + +Existe otras versiones de este core que permiten el control también con teclado: + +- `W`, `A`, `S`, `D` (personalizables) o el joystick 1: Controles de dirección del jugador 1 +- `F` y `R` (personalizables) o botones de disparo del joystick 1: Botones A y B (Jugador 1) +- `5` y `1`: `Select` y `Start` (Jugador 1) +- `I`, `J`, `K`, `L` (personalizables) o el joystick 2: Controles de dirección del jugador 2 +- `H`, `Y` (personalizables) o botones de disparo del joystick 1: Botones A y B (Jugador 2) +- `6` y `2`: `Select` y `Start` (Jugador 1) +- `F4` (`Caps Shift+Symbol Shift+4` en ZXUnGo+): Intercambiar la asignación de teclas de jugador 1 y jugador 2 +- `Ctrl+Alt+Backspace` (`Caps Shift+Symbol Shift+F` y luego `B` en ZXUnGo+): Hard Reset. Backspace es la tecla de borrar hacia atrás, encima de `Enter` + +Los controles por defecto del core con soporte de teclado se pueden modificar. Para ello, se ha de crear en la raiz de la tarjeta SD un fichero llamado KEYSP1` para el primer jugador y `KEYSP2` para el segundo (se puede descargar uno de ejemplo desde https://www.zxuno.com/forum/download/file.php?id=1360[el foro de ZX-Uno]). + +Estos ficheros se pueden crear con un editor hexadecimal (como https://mh-nexus.de/en/hxd/[HxD para Windows])y están formados por una secuencia de bytes indicando en este orden: `Arriba`, `Abajo`, `Izquierda`, `Derecha`, `Botón A`, `Botón B`. Los códigos a utilizar en la secuencia se pueden consultar en la tabla <<#_scan_codes,Scan Codes>> al final del manual (Columna MAKE), pero, teniendo en cuenta que, si el código está emparejado con `0xE0`, se ha de usar el otro valor, sumánole `0x80` (por ejemplo, para `E0 14`, sería `0x94`). + +[TIP] +==== +Por ejemplo, la secuencia `15 1C 44 4D 29 22` se correspondería con `Q A O P Espacio X`, y la secuencia `1D 1B 23 2B 1A 22` se correspondería con `W S D F Z X` +==== <<< @@ -3375,7 +3752,7 @@ Yo load and run a program, you have to type `-` and the name of the file. This w A different core version of https://es.wikipedia.org/wiki/Oric_Atmos[Oric Atmos], based on Rampa's implementation for MiST, Mistica and SiDi. -It has the following features: +It has been https://github.com/Kyp069/atmos[developed by Kyp069] and has these features: - VGA (Scandoubler) and composite video out - 64KB RAM and 16KB ROM. The ROM hides the upper memory, but it can be accessed all the memory banks using machine code @@ -3405,8 +3782,8 @@ While the core is running: - `F1` : Choose ROM 1.1 - `F2` : Choose ROM 1.22 -- `F5`: NMI -- `F10`: Enable audio output when using `CSAVE` +- `F5` (`Caps Shift+Symbol Shift+5` on +UNO): NMI +- `F10` (`Caps Shift+Symbol Shift+0` on +UNO): Enable audio output when using `CSAVE` - `Ctrl+Alt+Backspace` or `F11`: Hard reset. Backspace is the delete key, located in the top-right portion of the keyboard, above `Enter`. - `Ctrl+Alt+Del` or `F12`: Soft reset - `Scroll Lock`: Selects between VGA and composite video modes @@ -3461,7 +3838,7 @@ The latest ZX-Uno core has been made by avlixa, and some of its features are: - Two different video modes: Composite Video/RGB and VGA - 7 game variants - Support for 2 or 4 players -- Support for Joysticks, keyboard, mouse and rotary encoder controls (see <<#_rotary_enoders,here>> for more information) +- Support for Joysticks, keyboard, mouse and rotary encoder controls (see <<#_rotary_encoders,here>> for more information) - Several colour modes ==== SD format @@ -3475,7 +3852,7 @@ This core does not use the SD card. While the core is running: - `Esc` or joystick button 2: Show or hide configuration menu -- `Ctrl+Alt+Backspace`: Hard reset +- `Ctrl+Alt+Backspace` (`Caps Shift+Symbol Shift+B` on +UNO): Hard reset - `Scroll Lock`: switch between VGA and RGB mode - `F3` o `F12`: Restart game - Number between `1` and `7`: Change the game variant @@ -3558,8 +3935,8 @@ This core does not use the SD card While the core is running: - `Ctrl+Alt+F5`: NMI. -- `Ctrl+Alt+Supr`: Soft reset. -- `Ctrl+Alt+Backspace`: Hard reset. Backspace is the delete key, located in the top-right portion of the keyboard, above `Enter`. +- `Ctrl+Alt+Del` (`Caps Shift+Symbol Shift+N` on +UNO): Soft reset. +- `Ctrl+Alt+Backspace` (`Caps Shift+Symbol Shift+B` on +UNO): Hard reset. Backspace is the delete key, located in the top-right portion of the keyboard, above `Enter`. <<< @@ -3607,8 +3984,8 @@ Durante la ejecución del core: - `X`. `Space` or joystick 1 secondary fire button: Fire button 1 for player 1 - `Pause`: Master System pause button - `Scroll Lock`: Change between RGB/Composite and VGA video mode -- `Ctrl+Alt+Backspace`: Hard reset -- `F12`: Reset and show the file selection menu +- `Ctrl+Alt+Backspace` (`Caps Shift+Symbol Shift+B` on +UNO): Hard reset +- `F12` (`Caps Shift+Symbol Shift+W` on +UNO): Reset and show the file selection menu <<< @@ -3670,8 +4047,8 @@ During the core execution: - `C` or secondary joystick button: Fire button 3 - `V`: Fire button 4 - `Esc`: Show or hide the menu -- `Ctrl+Alt+Backspace`: Hard reset -- `F12`: Reset +- `Ctrl+Alt+Backspace` (`Caps Shift+Symbol Shift+B` on +UNO): Hard reset +- `F12` (`Caps Shift+Symbol Shift+W` on +UNO): Reset <<< @@ -3719,18 +4096,18 @@ See the <<#_cores,corresponding section>> for instructions of how to install the During the core execution: - `Scroll Lock`: Change between RGB/Composite and VGA video mode -- `F2`: Switch between RGB and Composite when not in VGA video mode -- `F3`: Reset -- `Ctrl+Alt+Backspace`: Hard reset +- `F2` (`Caps Shift+Symbol Shift+2` on +UNO): Switch between RGB and Composite when not in VGA video mode +- `F3` (`Caps Shift+Symbol Shift+3` on +UNO): Reset +- `Ctrl+Alt+Backspace` (`Caps Shift+Symbol Shift+B` on +UNO): Hard reset - After loading a ROM, most games will prompt the user with "SELECT GAME". Press `0`-`9` on the keyboard or mapped controller button to play the game. -- `Esc` or joystick button 2 to show or hide the options menu +- `Esc` (`Caps Shift+Space` on +UNO) or joystick button 2 to show or hide the options menu - `W`, `A`, `S`, `D` or cursor keys and then `Enter` to choose and select menu options <<< ==== Basic Guide -Pressing `Esc` or joystick button 2 shows or hides the configuration menu. Cursor keys and `Enter` to select and choose menu options. +Pressing `Esc` (`Caps Shift+Space` on +UNO) or joystick button 2 shows or hides the configuration menu. Cursor keys and `Enter` to select and choose menu options. [.text-center] image:img/videopacuno.png[pdfwidth=70%] @@ -3800,6 +4177,119 @@ Some monitor stop playing audio if the video signal is lost. It's recommended to <<< +=== ZX81 and ZX80 + +Alternative ZX81 and ZX80 core, made by avlixa, based on Grant Searle's ZX80 page. + +Features: + +- Selectable ZX80/ZX81 (ZX80 currently working only in RGB mode) +- 16k/32k/48k RAM packs +- 8KB with CHR$128/UDG addon (not tested) +- QS CHRS (not tested) +- CHROMA81 +- Turbo in Slow mode: NoWait, x2, x8 +- YM2149 sound chip (ZON X-81 compatible) +- Joystick types: Cursor, Sinclar, ZX81, ZXpand +- PAL/NTSC timings +- Turbo loading of .o and .p files +- Load alternative ROM +- Program loading using the audio input + +==== SD card format + +You can use a SD card with the first partition in FAT16 or FAT32 format to store ROM and tape files. + +You can copy a file named `ZX8X.ROM` (available at the https://github.com/avlixa/ZX81_MiSTer_zxdos/raw/master/roms/zx8x.rom[official repository] into folder `/zx81/roms`: it is a concatenation of ZX81 rom (8k) + ZX80 rom (4k). + +See the <<#_cores,corresponding section>> for instructions of how to install the ZX81 and ZX80 core in ZXUNO+. + +<<< + +==== Keyboard + +The PS/2 keyboard isn't mapped and the original machine keys layout is kept. For example, to obtain a `"` you have to type `Shift+P` or `Shift+0` to delete. + +**ZX80** + +[.text-center] +image:img/keyboardZX80.jpg[pdfwidth=80%] + +**ZX81** + +[.text-center] +image:img/keyboardZX81.jpg[pdfwidth=80%] + +===== Special keys and buttons + +During the core execution: + +- `F1` (`Caps Shift+Symbol Shift+1` on +UNO): Enable or disable the alternative chars +- `F5` (`Caps Shift+Symbol Shift+5` on +UNO) or joystick button 2: Show or hide configuration menu +- `F9` (`Caps Shift+Symbol Shift+9` on +UNO): Disables or enables the MIC audio output, since some games make annoying sounds when enabled +- `F10` (`Caps Shift+Symbol Shift+0` on +UNO): Enables or disables playing the audio input through the audio output, to hear loading sounds while loading +- `Scroll Lock` (`Caps Shift+Symbol Shift+G` on +UNO): Switch between RGB and VGA video output +- `Ctrl+Alt+Supr` (`Caps Shift+Symbol Shift+B` on +UNO): Reset +- `Ctrl+Alt+Backspace` (`Caps Shift+Symbol Shift+B` on +UNO): Hard reset + +<<< + +==== Basic Guide + +Pressing `F5` (`Caps Shift+Symbol Shift+5` on +UNO) or joystick button 2 shows or hides the configuration menu. Cursor keys (`Caps Shift+5`, `Caps Shift+6`, `Caps Shift+7` and `Caps Shift+8` on +UNO, `PC XT` keyboard mode) and `Enter` to select and choose menu options. + +[.text-center] +image:img/zx8180.jpg[pdfwidth=70%] + +The following options are available: + +- Reset +- Load Tape +- Load ROM +- Configuration Options +- Exit + +<<< + +[.text-center] +image:img/zx8180_2.jpg[pdfwidth=70%] + +- Computer Model: ZX80/ZX81 +- Main RAM: 16K/32K +- Low RAM: Off/8KB +- Joystick: Cursor/Sinclair/ZX81 +- QS CHRS: Disabled/Enabled +- CHR$128/UDG: 128 chars/64 chars/Disabled +- Chroma81: Disabled/Enabled +- Inverse Video: Off/On +- Black Border: Off/On +- Slow mode speed: Original/No Wait/x2 +- Video frequency: 50Hz/60Hz + +You can load a tape file selecting it from the menu, then enter the command `LOAD""` and `Enter` + +[TIP] +==== +Some monitors stop playing audio if the video signal is lost. It's recommended to plug headphones or a external speaker if you want to hear the sound while loading a tape. On a +UNO, the internal speaker will play the sound if nothing is connected to the audio out port. +==== + +`.p` files with colorization and char are supported. + +For colorization to work, CHROMA81 should be enabled before loading. For alternate chars, QS CHRS should be enabled before loading. + +[TIP] +==== +The recommended options for most games are: + +Main RAM: 16KB +Low RAM: 8KB +CHR$128: 128 chars +QS CHRS: enabled +CHROMA81: enabled +==== + +<<< + == Other Hardware === Rotary Encoders @@ -3932,6 +4422,8 @@ https://www.alessandrogrussu.it/tapir/index.html[Tapir] is a GUI program for Win https://sourceforge.net/projects/wav-prg/files/audiotap/2.2/[Audiotap] is a graphical interface program made for Windows (but also working on Wine) that can convert Commodore `TAP` files to `WAV` audio files. +http://retrowiki.es/viewtopic.php?f=110&t=200037282[Comodoro 2.0] es un script que permite convertir a formato `TAP` y `TZX` para poder realizar cargas por audio en las Commodore Pet, VIC-20, 16 y 64. + https://github.com/RW-FPGA-devel-Team/lynx2wav[Lynx2Wav] is a program that can convert Camputers Lynx `TAP` files to `WAV` audio. https://github.com/rcmolina/CamputersLYNX[2lynx2wav] also can convert Camputers Lynx `TAP` files to audio files. @@ -4136,6 +4628,11 @@ image:img/jtagzxunoplus.jpg[pdfwidth=80%] *DO NOT* connect the 3V line ==== +[NOTE] +==== +For a +UNO, you have to unplug the ZX-Uno board to make a recovery. +==== + <<< ==== Recovery using a Raspberry Pi @@ -4269,7 +4766,7 @@ sudo openocd -f /usr/local/share/openocd/scripts/interface/altera-usb-blaster.cf [start=11] . If all goes well, we will see that the FPGA LED change their state and the BIOS is shown on the display. -If there is no image on the display, press `Scroll Lock` to switch between RGB and VGA modes, just in case the recovery BIOS did start in the wrong mode for our setup. +If there is no image on the display, press `Scroll Lock` (`Caps Shift+Symbol Shift+G` on +UNO) to switch between RGB and VGA modes, just in case the recovery BIOS did start in the wrong mode for our setup. [.text-center] image:img/recovery.png[pdfwidth=70%] @@ -4292,18 +4789,278 @@ image:img/recovery2.png[pdfwidth=70%] This process can't be undone, and it will replace all the previously installed cores, the BIOS, the ZX Spectrum ROMs and their configuration with the data in the image file. ==== +[NOTE] +==== +Ususally, the recovery image is set to use a PS/2 keyboard so, for a +UNO, some key combinations, like `Caps Shift + 5`, etc may not work. In this case, you have to change the keyboard mode to `PC XT`(`Caps Shift + Symbol Shift + U` and then `9`), to make them work temporarily. +==== + [start=15] . After some minutes, the process will end, and, after turning the ZXUNO+ off and on, it should start fine. [NOTE] ==== -If no image is shown, press again `Scroll Lock` to switch between RGB and VGA modes. In this case, you should have to enter the BIOS and change <<#_advanced, the right advanced setting>> that matches your display. +If no image is shown, press again `Scroll Lock` (`Caps Shift+Symbol Shift+G` on +UNO) to switch between RGB and VGA modes. In this case, you should have to enter the BIOS and change <<#_advanced, the right advanced setting>> that matches your display. +==== + +[NOTE] +==== +For a +UNO, since the recovery image uses a PS/2 configuration as default, follow this steps to set up the BIOS correctly: + +. If you see no image, switch between RGB and VGA mode (`Caps Shift+Symbol Shift+G`) +. Change to `PC XT` keyboard mode (`Caps Shift+Symbol Shift+U` and then `9`) +. Reboot +UNO without losing the temporary keyboard mode (`Caps Shift+Symbol Shift+B`) +. Quickly, press `Caps Shift + 1` +. Again, if there's no image, switch between RGB and VGA mode (`Caps Shift+Symbol Shift+G`) +. Navigate through BIOS and turno on these options: +- `Advanced` -> `Keyboard Layout`: `Spectrum` +- `Advanced` -> `Video`: `VGA` (only if there was no image) +. Save changes: +- `Exit` -> `Save changes and exit` +. Completely turn off +UNO` and turn it on again +==== + +<<< + +==== Recovery using MacOS and USB-Blaster cable + +*Hardware required*: + +- USB-Blaster cable. Using the right pins for ZXUNO+, <<#_jtag_cable_connections,as explained earlier>> +- Flash Image file and and recovery file for ZX-Uno. The same ones as for Raspberry Pi, from https://github.com/zxdos/zxuno/tree/master/modflash[Github repository] and https://www.zxuno.com/forum/viewtopic.php?f=37&t=774[ZX-Uno forum] + +*Software required*: + +- Mac OS +- Extra data folder for UrJTAG, obtained from https://github.com/zxdos/zxdos-plus/blob/master/lx25/urjtag.zip[here] +- https://brew.sh[Homebrew for Mac OS] +- UrJTAG: following instructions from https://n4abi.com/posts/2018-07-08-de0-nano-urjtag.html[here]: + +*Instruction Steps*: + +. Prepare UrJTAG instal: + +[source,shell] +---- +brew install libftdi libusb pkg-config +git clone https://github.com/C-Elegans/urjtag.git +cd urjtag +---- + +[start=2] +. Copy the extra data folder for UrJTAG, into urjtag `data` folder. + +. Start compiling: + +[source,shell] +---- +./configure --with-libftdi --with-libusb --with-ftd2xx --with-inpout32 --enable-python=no +make -j4 +sudo make install +---- + +[start=4] +. Copy `FLASH.ZX1` file to the root of the ZX-Uno SD card. + +. Connect USB-Blaster cable to ZXUNO+ and the Mac + +. Turn on the ZXUNO+ or +UNO. + +. Make sure that, we are in the directory where `recovery.bit` is, and execute `jtag` command. + +<<< + +[start=8] +. A new shell appears. Now type the commands: + +[source,shell] +---- +cable usbblaster +detect +pld load recovery.bit +---- + +[NOTE] +==== +Make sure, when using `detect`, that the device is shown as detected. You may need to execute `detect` several times until it appears. +==== + +[.text-center] +image:img/recovery_mac_1.png[pdfwidth=90%] + +<<< + +[start=9] +. If all goes well, we will see that the FPGA LED change their state and the BIOS is shown on the display. + +If there is no image on the display, press `Scroll Lock` (`Caps Shift+Symbol Shift+G` on +UNO) to switch between RGB and VGA modes, just in case the recovery BIOS did start in the wrong mode for our setup. + +[.text-center] +image:img/recovery.png[pdfwidth=70%] + +[start=10] +. Insert in the ZXUNO+ the SD card formatted as FAT16 o FAT32, and with the `FLASH.ZX1` file downloaded previously. + +. Unplug the USB-Blaster. + +<<< + +[start=12] +. Select the option `Upgrade Flash from SD`. Press Enter, choose `Yes`, and press Enter again to start the Flash writing process. + +[.text-center] +image:img/recovery2.png[pdfwidth=70%] + +[WARNING] +==== +This process can't be undone, and it will replace all the previously installed cores, the BIOS, the ZX Spectrum ROMs and their configuration with the data in the image file. +==== + +[NOTE] +==== +Ususally, the recovery image is set to use a PS/2 keyboard so, for a +UNO, some key combinations, like `Caps Shift + 5`, etc may not work. In this case, you have to change the keyboard mode to `PC XT`(`Caps Shift + Symbol Shift + U` and then `9`), to make them work temporarily. +==== + +[start=13] +. After some minutes, the process will end, and, after turning the ZXUNO+ off and on, it should start fine. + +[NOTE] +==== +If no image is shown, press again `Scroll Lock` (`Caps Shift+Symbol Shift+G` on +UNO) to switch between RGB and VGA modes. In this case, you should have to enter the BIOS and change <<#_advanced, the right advanced setting>> that matches your display. +==== + +[NOTE] +==== +For a +UNO, since the recovery image uses a PS/2 configuration as default, follow this steps to set up the BIOS correctly: + +. If you see no image, switch between RGB and VGA mode (`Caps Shift+Symbol Shift+G`) +. Change to `PC XT` keyboard mode (`Caps Shift + Symbol Shift + U` and then `9`) +. Reboot +UNO without losing the temporary keyboard mode (`Caps Shift + Symbol Shift + B`) +. Quickly, press `Caps Shift + 1` +. Again, if there's no image, switch between RGB and VGA mode (`Caps Shift+Symbol Shift+G`) +. Navigate through BIOS and turno on these options: +- `Advanced` -> `Keyboard Layout`: `Spectrum` +- `Advanced` -> `Video`: `VGA` (only if there was no image) +. Save changes: +- `Exit` -> `Save changes and exit` +. Completely turn off +UNO` and turn it on again +==== + +[NOTE] +==== +When using Linux with `urjtag`, the process should be quite similar, although the dependencies (libftdi libusb pkg-config) would have to be installed with the appropiate package manager (apt, yum, pacman, etc.) +==== + +<<< + +==== Recovery using Windows and USB-Blaster cable + +*Hardware required*: + +- USB-Blaster cable. Using the right pins for ZXUNO+, <<#_jtag_cable_connections,as explained earlier>> +- Flash Image file and and recovery file fo ZXUNO+ (LX25). The same ones as for Raspberry Pi, from https://github.com/zxdos/zxuno/tree/master/modflash[Github repository] and https://www.zxuno.com/forum/viewtopic.php?f=37&t=774[ZX-Uno forum] + +*Software required*: + +- Windows +- USB-Blaster drivers for Windows, available at https://www.zxuno.com/forum/viewtopic.php?f=25&t=432[ZX-Uno forums] +- UrJTAG, for Windows, available at https://github.com/zxdos/zxdos-plus/blob/master/lx25/urjtag.zip[the official repository] + +*Instruction Steps*: + +. Extract the ZIP file with drivers (obtained from the https://www.zxuno.com/forum/download/file.php?id=889[ZX-Uno forums]) + +. Plug USB-Blaster to the Windows PC and install the driver choosing to select manually installation files and using the folder `drivers` obtained after extracting the ZIP + +. Extract UrJTAG Windows software, obtained at the https://github.com/zxdos/zxdos-plus/blob/master/lx25/urjtag.zip[official repository] + +. Copy `FLASH.ZX1` file to the root of the ZX-Uno SD card. + +. Connect USB-Blaster cable to ZXUNO+ and the PC + +. Make sure that you are in the directory where `recovery.bit` is, and execute `jtag` command. + +. Turn on the ZXUNO+ or +UNO. + +. A new shell appears. Now type the commands: + +[source,shell] +---- +cable usbblaster +detect +pld load recovery.bit +---- + +<<< + +[start=9] +. If all goes well, we will see that the FPGA LED change their state and the BIOS is shown on the display. + +If there is no image on the display, press `Scroll Lock` (`Caps Shift+Symbol Shift+G` on +UNO) to switch between RGB and VGA modes, just in case the recovery BIOS did start in the wrong mode for our setup. + +[.text-center] +image:img/recovery.png[pdfwidth=70%] + +[start=10] +. Insert in the ZXUNO+ the SD card formatted as FAT16 o FAT32, and with the `FLASH.ZX1` file downloaded previously. + +. Unplug the USB-Blaster. + +<<< + +[start=12] +. Select the option `Upgrade Flash from SD`. Press Enter, choose `Yes`, and press Enter again to start the Flash writing process. + +[.text-center] +image:img/recovery2.png[pdfwidth=70%] + +[WARNING] +==== +This process can't be undone, and it will replace all the previously installed cores, the BIOS, the ZX Spectrum ROMs and their configuration with the data in the image file. +==== + +[NOTE] +==== +Ususally, the recovery image is set to use a PS/2 keyboard so, for a +UNO, some key combinations, like `Caps Shift + 5`, etc may not work. In this case, you have to change the keyboard mode to `PC XT`(`Caps Shift + Symbol Shift + U` and then `9`), to make them work temporarily. +==== + +[start=13] +. After some minutes, the process will end, and, after turning the ZXUNO+ off and on, it should start fine. + +[NOTE] +==== +If no image is shown, press again `Scroll Lock` (`Caps Shift+Symbol Shift+G` on +UNO) to switch between RGB and VGA modes. In this case, you should have to enter the BIOS and change <<#_advanced, the right advanced setting>> that matches your display. +==== + +[NOTE] +==== +For a +UNO, since the recovery image uses a PS/2 configuration as default, follow this steps to set up the BIOS correctly: + +. If you see no image, switch between RGB and VGA mode (`Caps Shift+Symbol Shift+G`) +. Change to `PC XT` keyboard mode (`Caps Shift + Symbol Shift + U` and then `9`) +. Reboot +UNO without losing the temporary keyboard mode (`Caps Shift + Symbol Shift + B`) +. Quickly, press `Caps Shift + 1` +. Again, if there's no image, switch between RGB and VGA mode (`Caps Shift+Symbol Shift+G`) +. Navigate through BIOS and turno on these options: +- `Advanced` -> `Keyboard Layout`: `Spectrum` +- `Advanced` -> `Video`: `VGA` (only if there was no image) +. Save changes: +- `Exit` -> `Save changes and exit` +. Completely turn off +UNO` and turn it on again ==== <<< == References +=== Scan Codes + +[.text-center] +image:img/scancodes.png[pdfwidth=80%] + +<<< + +=== Links + https://zxuno.speccy.org/index.shtml[ZX-Uno] http://desubikado.sytes.net/zx-uno-faq-version-desubikado/[ZX-Uno FAQ] @@ -4322,6 +5079,8 @@ https://github.com/spark2k06/zxunops2/blob/master/Alternative/Nuevo%20firmware%2 https://docs.google.com/spreadsheets/d/17-ifpHcy932_AP7SAv9uBLxg-2ZptcdgTvQ8ILXQLM4/htmlview[Almost (In-) Complete List of esxDOS DOT-Commands] +http://www.benophetinternet.nl/hobby/vanmezelf/ESXDOS%20manual.pdf[ESXDOS Manual] + http://retrowiki.es/viewtopic.php?f=83&t=200032578&p=200075671&hilit=wifi#p200075671[WiFi (RetroWiki)] https://www.va-de-retro.com/foros/viewtopic.php?t=1718&start=10#p25076[Cargando Leches 2.0] diff --git a/doc/Manual de Miniduino.adoc b/doc/src/Manual de Miniduino.adoc similarity index 100% rename from doc/Manual de Miniduino.adoc rename to doc/src/Manual de Miniduino.adoc diff --git a/doc/Manual de ZXDOS+ y gomaDOS+.adoc b/doc/src/Manual de ZXDOS+ y gomaDOS+.adoc similarity index 99% rename from doc/Manual de ZXDOS+ y gomaDOS+.adoc rename to doc/src/Manual de ZXDOS+ y gomaDOS+.adoc index bd5b2aa..c2abac9 100644 --- a/doc/Manual de ZXDOS+ y gomaDOS+.adoc +++ b/doc/src/Manual de ZXDOS+ y gomaDOS+.adoc @@ -2606,7 +2606,7 @@ image:img/keyboardZX81.jpg[pdfwidth=80%] Durante la ejecución del core: - `F1` (`Caps Shift+Symbol Shift+1` en gomaDOS+): Habilitar o deshabilitar los caracteres alternativos -- `F5` (`Caps Shift+Symbol Shift+5` en gomaDOS+) o el botón 2 del joystick (o `Caps Shift+Espacio` en gomaDOS+) para mostrar u ocultar el menú. +- `F5` (`Caps Shift+Symbol Shift+5` en gomaDOS+) o el botón 2 del joystick para mostrar u ocultar el menú. - `F9` (`Caps Shift+Symbol Shift+9` en gomaDOS+): Deshabilita o habilita la salida MIC al conector de audio, porque algunos juegos generan un ruido molesto - `F10` (`Caps Shift+Symbol Shift+0` en gomaDOS+): Habilita o deshabilita sonido de entrada por la salida de audio, para escuchar la cinta si se carga por audio - `Bloq. Despl.` (`Caps Shift+Symbol Shift+G` en gomaDOS+): para cambiar entre modo de vídeo RGB y VGA @@ -2617,7 +2617,7 @@ Durante la ejecución del core: ==== Guía básica -Pulsando `F5` (`Caps Shift+Symbol Shift+5` en gomaDOS+) o el botón 2 del joystick (o `Caps Shift+Espacio` en gomaDOS+, en modo de teclado `PC XT`) se muestra el menú de configuración. Se usan las teclas de cursor (`Caps Shift+5`, `Caps Shift+6`, `Caps Shift+7` y `Caps Shift+8` en gomaDOS+, en modo de teclado `PC XT`) y `Enter` para elegir y seleccionar opciones del menú. +Pulsando `F5` (`Caps Shift+Symbol Shift+5` en gomaDOS+) o el botón 2 del joystick se muestra el menú de configuración. Se usan las teclas de cursor (`Caps Shift+5`, `Caps Shift+6`, `Caps Shift+7` y `Caps Shift+8` en gomaDOS+, en modo de teclado `PC XT`) y `Enter` para elegir y seleccionar opciones del menú. [.text-center] image:img/zx81.jpg[pdfwidth=70%] @@ -3549,7 +3549,7 @@ sudo openocd -f /usr/local/share/openocd/scripts/interface/altera-usb-blaster.cf [start=11] . Si todo va bien, veremos cómo cambia el estado de los LED de la FPGA y veremos la imagen de la BIOS en el monitor. -En el caso de que no se vea imagen, pulsar `Bloq. Despl.` (`Caps Shift+Symbol Shift+G` en gomaDOS+): para cambiar entre modo de vídeo RGB y VGA, por si acaso la BIOS ha arrancado en un modo que no corresponde a la conexión del monitor. +En el caso de que no se vea imagen, pulsar `Bloq. Despl.` (`Caps Shift+Symbol Shift+G` en gomaDOS+) para cambiar entre modo de vídeo RGB y VGA, por si acaso la BIOS ha arrancado en un modo que no corresponde a la conexión del monitor. [.text-center] image:img/recovery.png[pdfwidth=70%] @@ -3584,7 +3584,7 @@ Habitualmente, la imagen de recuperación está configurada para usar un teclado [NOTE] ==== -Si no se obtiene imagen, pulsar de nuevo `Bloq. Despl.` (`Caps Shift+Symbol Shift+G` en gomaDOS+): para cambiar entre modo de vídeo RGB y VGA. En este caso, sería necesario acceder a la BIOS y cambiar el <<#_advanced, ajuste avanzado correspondiente>> para indicar la configuración de nuestro monitor. +Si no se obtiene imagen, pulsar de nuevo `Bloq. Despl.` (`Caps Shift+Symbol Shift+G` en gomaDOS+) para cambiar entre modo de vídeo RGB y VGA. En este caso, sería necesario acceder a la BIOS y cambiar el <<#_advanced, ajuste avanzado correspondiente>> para indicar la configuración de nuestro monitor. ==== [NOTE] @@ -3677,7 +3677,7 @@ image:img/recovery_mac_1.png[pdfwidth=90%] [start=9] . Si todo va bien, veremos cómo cambia el estado de los LED de la FPGA y veremos la imagen de la BIOS en el monitor. -En el caso de que no se vea imagen, pulsar `Bloq. Despl.` (`Caps Shift+Symbol Shift+G` en gomaDOS+): para cambiar entre modo de vídeo RGB y VGA, por si acaso la BIOS ha arrancado en un modo que no corresponde a la conexión del monitor. +En el caso de que no se vea imagen, pulsar `Bloq. Despl.` (`Caps Shift+Symbol Shift+G` en gomaDOS+) para cambiar entre modo de vídeo RGB y VGA, por si acaso la BIOS ha arrancado en un modo que no corresponde a la conexión del monitor. [.text-center] image:img/recovery.png[pdfwidth=70%] @@ -3712,7 +3712,7 @@ Habitualmente, la imagen de recuperación está configurada para usar un teclado [NOTE] ==== -Si no se obtiene imagen, pulsar de nuevo `Bloq. Despl.` (`Caps Shift+Symbol Shift+G` en gomaDOS+): para cambiar entre modo de vídeo RGB y VGA. En este caso, sería necesario acceder a la BIOS y cambiar el <<#_advanced, ajuste avanzado correspondiente>> para indicar la configuración de nuestro monitor. +Si no se obtiene imagen, pulsar de nuevo `Bloq. Despl.` (`Caps Shift+Symbol Shift+G` en gomaDOS+) para cambiar entre modo de vídeo RGB y VGA. En este caso, sería necesario acceder a la BIOS y cambiar el <<#_advanced, ajuste avanzado correspondiente>> para indicar la configuración de nuestro monitor. ==== [NOTE] @@ -3782,7 +3782,7 @@ pld load recovery.zxd.bit [start=9] . Si todo va bien, veremos cómo cambia el estado de los LED de la FPGA y veremos la imagen de la BIOS en el monitor. -En el caso de que no se vea imagen, pulsar `Bloq. Despl.` (`Caps Shift+Symbol Shift+G` en gomaDOS+): para cambiar entre modo de vídeo RGB y VGA, por si acaso la BIOS ha arrancado en un modo que no corresponde a la conexión del monitor. +En el caso de que no se vea imagen, pulsar `Bloq. Despl.` (`Caps Shift+Symbol Shift+G` en gomaDOS+) para cambiar entre modo de vídeo RGB y VGA, por si acaso la BIOS ha arrancado en un modo que no corresponde a la conexión del monitor. [.text-center] image:img/recovery.png[pdfwidth=70%] @@ -3817,7 +3817,7 @@ Habitualmente, la imagen de recuperación está configurada para usar un teclado [NOTE] ==== -Si no se obtiene imagen, pulsar de nuevo `Bloq. Despl.` (`Caps Shift+Symbol Shift+G` en gomaDOS+): para cambiar entre modo de vídeo RGB y VGA. En este caso, sería necesario acceder a la BIOS y cambiar el <<#_advanced, ajuste avanzado correspondiente>> para indicar la configuración de nuestro monitor. +Si no se obtiene imagen, pulsar de nuevo `Bloq. Despl.` (`Caps Shift+Symbol Shift+G` en gomaDOS+) para cambiar entre modo de vídeo RGB y VGA. En este caso, sería necesario acceder a la BIOS y cambiar el <<#_advanced, ajuste avanzado correspondiente>> para indicar la configuración de nuestro monitor. ==== [NOTE] diff --git a/doc/Manual de ZXUNO+.adoc b/doc/src/Manual de ZXUNO+ y +UNO.adoc similarity index 83% rename from doc/Manual de ZXUNO+.adoc rename to doc/src/Manual de ZXUNO+ y +UNO.adoc index 5bd8e75..f794aa4 100644 --- a/doc/Manual de ZXUNO+.adoc +++ b/doc/src/Manual de ZXUNO+ y +UNO.adoc @@ -1,13 +1,13 @@ -= Manual de ZXUNO+ += Manual de ZXUNO+ y +UNO :author: kounch -:revnumber: 1.2.0 +:revnumber: 1.3.0 :doctype: book :notitle: :front-cover-image: image:img/portadauno.jpg[] :email: kounch@users.noreply.github.com -:Revision: 1.2 -:description: Manual en castellano de ZXUNO+ -:keywords: Manual, Castellano, ZXUNO+ +:Revision: 1.3 +:description: Manual en castellano de ZXUNO+ y +UNO +:keywords: Manual, Castellano, ZXUNO+, +UNO :icons: font :source-highlighter: rouge :toc: left @@ -18,7 +18,7 @@ == Introducción -ZXUNO+ es la iteración más reciente 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. +ZXUNO+ y +UNO son otra iteració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 instalar distintas configuraciones (cores) en la memoria flash de la FPGA, y que trabajan como otros sistemas distintos del ZX Spectrum, pudiendo elegir arrancar el ZXUNO+ con la configuración que se desee de entre todas las instaladas. @@ -41,6 +41,8 @@ Sin el trabajo previo de todas estas personas (y más), ese manual no podría ex === Puertos y Conectores +==== ZXUNO+ + [.text-center] image:./img/zxunofront.png[pdfwidth=65%] @@ -50,6 +52,16 @@ image:./img/zxunoback.png[pdfwidth=65%] [.text-center] image:./img/zxunoboard.png[pdfwidth=65%] +<<< + +==== +UNO + +[.text-center] +image:img/plusuno_frontal.jpg[pdfwidth=45%] + +[.text-center] +image:img/plusuno_trasera.jpg[pdfwidth=70%] + ==== Descripción [cols=2*] @@ -57,7 +69,7 @@ image:./img/zxunoboard.png[pdfwidth=65%] |1 |Salida de Sonido |2 -|Salida de vídeo +|Salida de vídeo compuesto |3 |Salida / Puerto de Expansión |4 @@ -72,16 +84,30 @@ image:./img/zxunoboard.png[pdfwidth=65%] |Puerto de Ratón USB (PS/2) |9 |Puerto de Teclado USB (PS/2) +|10 +|Puerto de Joystick Izquierdo +|11 +|Puerto de Joystick Derecho +|12 +|Salida RGB/VGA +|13 +|Control de volumen +|14 +|Puerto PS/2 +|15 +|Pulsador de reset +|16 +|Abertura para altavoz interno |=== ===== Salida de vídeo RJ-45 -Este es el esquema del conector RJ-45 para utilizar como salida VGA: +Este es el esquema del conector RJ-45 para utilizar como salida VGA en un ZXUNO+: [.text-center] image:img/rj45pinout.png[pdfwidth=50%] -Esta es la numeración del conector RJ-45 para utilizar como salida RGB con conector SCART: +Esta es la numeración del conector RJ-45 para utilizar como salida RGB con conector SCART en un ZXUNO+: [.text-center] image:img/rj45scart.png[pdfwidth=50%] @@ -302,13 +328,228 @@ sudo mkfs.fat -F 16 -n ZXUNOPLUS -s 128 /dev/sdc1 <<< -=== Teclado +=== Teclado y ratón + +==== Teclado incorporado en +UNO + +El teclado de +UNO al ser similar al teclado del ZX Spectrum original, carece de algunas de teclas existentes en un teclado moderno de PC. Internamente, el teclado de membrana está conectado a una placa Arduino, que se encarga de transformar las pulsaciones al protocolo PS/2 de teclado. Esta placa está programada de manera que pueda comportarse de distintas maneras según nos interese. + +Por defecto, está configurado en modo ZX Spectrum. Para cambiar a otro modo, se debe pulsar `Caps Shift+Symbol Shift+U` y luego la tecla correspondiente. Al hacerlo, se tecleará automáticamente un texto indicando el modo seleccionado (por ejemplo: `.zx` si se pulsa `Caps Shift+Symbol Shift+U` y luego `0`). + +La siguiente tabla indica los distintos modos y la tecla de activación asociada: + +[align="center",width="40%",%header,cols=2*] +|=== +|Modo +|Tecla +|ZX Spectrum +|`0` +|Amstrad CPC +|`1` +|MSX +|`2` +|Commodore 64 +|`3` +|Atari 800XL +|`4` +|BBC Micro +|`5` +|Acorn Electron +|`6` +|Apple (I y II) +|`7` +|Commodore VIC 20 +|`8` +|PC XT +|`9` +|Oric Atmos +|`A` +|SAM Coupé +|`B` +|Jupiter ACE +|`C` +|=== + +<<< + +La distribución del teclado en modo ZX Spectrum, con la pulsación asociada al combinar junto con `Caps Shift+Symbol Shift`, se puede resumir según el siguiente esquema: + +[align="center",width="80%",cols=10*] +|=== +^|**1** +^|**2** +^|**3** +^|**4** +^|**5** +^|**6** +^|**7** +^|**8** +^|**9** +^|**0** +^|`F1` +^|`F2` +^|`F3` +^|`F4` +^|`F5` +^|`F6` +^|`F7` +^|`F8` +^|`F9` +^|`F1` +^|**Q** +^|**W** +^|**E** +^|**R** +^|**T** +^|**Y** +^|**U** +^|**I** +^|**O** +^|**P** +^|`F11` +^|`F12` +^| +^| +^| +^| +^|`Modo` +^| +^| +^| +^|**A** +^|**S** +^|**D** +^|**F** +^|**G** +^|**H** +^|**J** +^|**K** +^|**L** +^|**Enter** +^| +^| +^| +^| +^|`BlqDs` +^| +^| +^| +^| +^| +^|**CShift** +^|**Z** +^|**X** +^|**C** +^|**V** +^|**B** +^|**N** +^|**M** +^|**SShift** +^|**Space** +^| +^| +^|`Guarda` +^| +^|`Vers` +^|`hRes` +^|`sRes` +^| +^| +^| +|=== + +Donde: + +- `BlqDs`: `Bloq. Despl.` cambia de modo vídeo RGB a VGA y viceversa (en el core de Next, se debe usar `Caps Shift+Symbol Shift+2` o `F2`) +- `Guarda`: Define el modo actual como el modo por defecto +- `Vers`: Muestra (teclea) la versión actual del firmware +- `hRes`: Hard Reset +- `sRes`: Soft Reset + +<<< + +La lista completa de combinaciones de teclado (y el modo en que se pueden utilizar) es la siguiente: + +[align="center",width="75%",%header,cols=3*] +|=== +|Caps S.+Symbol S. +|Modo +|Acción +|1 +|Todos +|`F1` +|2 +|Todos +|`F2` +|3 +|Todos +|`F3` +|4 +|Todos +|`F4` +|5 +|Todos +|`F5` +|6 +|Todos +|`F6` +|7 +|Todos +|`F7` +|8 +|Todos +|`F8` +|9 +|Todos +|`F9` +|0 +|Todos +|`F10` +|Q +|Todos +|`F11` +|W +|Todos +|`F12` +|S +|C64 +|`Ctrl+F12` +|E +|Acorn/CPC +|`Re Pág` +|R +|Acorn +|`PgAbajo` +|U +|Todos +|`Modo` +|G +|ZX/MSX/C64 +|`BlqDs` +|X +|Todos +|`Guarda` +|C +|PC +|`OPQA` +|V +|Todos +|`Versión` +|B +|ZX +|`Ctrl+Alt+Bcksp` +|N +|ZX +|`Ctrl+Alt+Supr` +|=== + +<<< ==== Teclado PS/2 El mapa de un teclado conectado al puerto PS/2 (asignación de las teclas físicas del teclado con las pulsaciones que se presentan a los distintos cores) se cambia desde el menú `Advanced` de la BIOS. Existen tres mapas distintos a elegir: Español (por defecto), inglés, y Spectrum (avanzado). -También se puede cambiar con la utilidad `keymap`. Dentro de `/bin` hay que crear un directorio llamado `keymaps` y ahí copiar los mapas de teclado se desee usar. Por ejemplo, para cambiar al mapa US hay que escribir `.keymap us` desde esxdos. +También se puede cambiar con la utilidad `keymap`. Dentro de `/sys` hay que crear un directorio llamado `keymaps` y ahí copiar los mapas de teclado se desee usar. Por ejemplo, para cambiar al mapa US hay que escribir `.keymap us` desde esxdos. Para que el mapa se conserve después de un master reset, hay que tener seleccionado `Default` en la configuración de BIOS. @@ -335,25 +576,36 @@ image:./img/keyboardAV.png[pdfwidth=70%] Teclas especiales durante el arranque: -- `F2` Entrar en la BIOS -- `Bloq. Mayús` o `Cursor abajo` o, si hay un joystick conectado, pulsar la dirección hacia abajo: Menú de selección de cores -- `Esc` o, si hay un joystick de dos o más botones conectado, pulsar el botón de disparo 2: Menú de selección de ROMS del core de ZX Spectrum +- `F2` (`Caps Shift+1` en +UNO) Entrar en la BIOS +- `Bloq. Mayús` o `Cursor abajo` (`Caps Shift+2` en +UNO) o, si hay un joystick conectado, pulsar la dirección hacia abajo: Menú de selección de cores +- `Esc` (`Caps Shift+Espacio` en +UNO) o, si hay un joystick de dos o más botones conectado, pulsar el botón de disparo 2: Menú de selección de ROMS del core de ZX Spectrum - `R`: Carga la ROM del core de ZX Spectrum en modo "real" deshabilitando esxdos, nuevos modos gráficos, etc. (combinado con `Esc` a continuación permite elegir otra ROM distinta) -- `/` (del teclado numérico): Carga la ROM por defecto del core de ZX Spectrum en modo "root" (combinado con `Esc` a continuación permite elegir otra ROM distinta) +- `/` (del teclado numérico, `Symbol Shift+V` en +UNO): Carga la ROM por defecto del core de ZX Spectrum en modo "root" (combinado con `Esc` a continuación permite elegir otra ROM distinta) - Número del `1` al `9`: Cargar el core en la ubicación de la Flash correspondiente a dicho número Teclas especiales que se pueden utilizar durante la ejecución del core principal (ZX Spectrum): -- `Esc`: BREAK -- `F2`: Edit -- `F5`: NMI -- `F7`: Reproducir o Pausa en la reproducción de archivos .PZX -- `F8`: Rebobinar el archivo .PZX hasta la marca anterior -- `F10`: Graph -- `F12`: Turbo Boost. Pone a la CPU a 28MHz mientras se mantenga pulsada (a partir del core EXP27). -- `Ctrl+Alt+Backspace`: Hard reset. Backspace es la tecla de borrar hacia atrás, encima de `Enter`. -- `Ctrl+Alt+Supr`: Soft reset. -- `Bloq. Despl.`: cambia de modo video compuesto a VGA y viceversa. +- `Esc` (`Caps Shift+Espacio` en +UNO): BREAK +- `F2` (`Caps Shift+1` en +UNO): Edit +- `F3` (`Caps Shift+Symbol Shift+3` en +UNO): True Video +- `F4` (`Caps Shift+Symbol Shift+4` en +UNO): Inverse Video +- `F5` (`Caps Shift+Symbol Shift+5` en +UNO): NMI +- `F7` (`Caps Shift+Symbol Shift+7` en +UNO): Reproducir o Pausa en la reproducción de archivos .PZX +- `F8` (`Caps Shift+Symbol Shift+8` en +UNO): Rebobinar el archivo .PZX hasta la marca anterior +- `F10` (`Caps Shift+Symbol Shift+0` en +UNO): Graph +- `F12` (`Caps Shift+Symbol Shift+w` en +UNO): Turbo Boost. Pone a la CPU a 28MHz mientras se mantenga pulsada (a partir del core EXP27). +- `Ctrl+Alt+Backspace` (`Caps Shift+Symbol Shift+B` en +UNO): Hard reset. Backspace es la tecla de borrar hacia atrás, encima de `Enter`. +- `Ctrl+Alt+Supr` (`Caps Shift+Symbol Shift+N` en +UNO): Soft reset. +- `Bloq. Despl.` (`Caps Shift+Symbol Shift+G` en +UNO): cambia de modo video compuesto a VGA y viceversa. + +<<< + +==== Ratón PS/2 + +También es posible conectar un ratón al puerto PS/2. El interruptor que hay en el interior de un +UNO, cerca de las teclas `1` y `2` y el chip Wi-Fi, permite definir si hará falta un adaptador de teclado y ratón (para conectar simultáneamente un teclado y ratón), o no. + +[.text-center] +image:./img/plusuno_switch.jpg[pdfwidth=70%] <<< @@ -394,7 +646,7 @@ Es recomendable, además, añadir los comandos esxdos específicos para ZXUNO+. zxuc zxunocfg -<<#_comandos_para_ZXUNO+,Más adelante>> se explica lo que hace cada uno de ellos. +<<#_comandos_para_zxuno,Más adelante>> se explica lo que hace cada uno de ellos. <<< @@ -458,6 +710,11 @@ image:img/bios4.png[pdfwidth=70%] En la pantalla _Boot_ se puede elegir qué core de los instalados se desea que cargue por defecto en el arranque. +[CAUTION] +==== +Nunca se ha de elegir como arranque un core de tipo Spectrum distinto del principal (Primer core de la flash). Esto provoca un bucle de reinicios constantes del mismo. +==== + <<< ==== Advanced @@ -468,14 +725,63 @@ image:img/bios5.png[pdfwidth=70%] La pantalla de configuración avanzada sirve para modificar los siguientes ajustes: - Distribución del teclado (Keyb Layout): Ver <<#_teclado,el apartado correspondiente >> para más información) -- Comportamiento del joystick emulado con el teclado numérico (Joy Keypad): Kempston, Sinclair Joystick 1, Sinclair Joystick 2, Protek o Fuller -- Comportamiento de un joystick conectado al puerto (Joy DB9): Kempston, Sinclair Joystick 1, Sinclair Joystick 2, Protek, Fuller o simular las teclas `Q`, `A`, `O`, `P`, `Espacio` y `M` +- Comportamiento del joystick emulado con el teclado numérico (Joy Keypad) y del segundo joystick (con splitter): Kempston, Sinclair Joystick 1, Sinclair Joystick 2, Protek o Fuller +- Comportamiento de un joystick conectado al puerto principal (Joy DB9): Kempston, Sinclair Joystick 1, Sinclair Joystick 2, Protek, Fuller o simular las teclas `Q`, `A`, `O`, `P`, `Espacio` y `M` +- Activar el segundo joystick (splitter). Sólo válido para +UNO y para los cores que estén diseñados para soportarlo - Salida de vídeo (Video): PAL, NTSC o VGA - Simulación de línea de exploración (Scanlines): Activas (Enabled) o inactivas (Disabled) - Frecuencia horizontal de VGA (Frequency): 50, 51, etc. - Velocidad de la CPU: Normal (1x) o acelerada (2X, 3X, etc.) - Csync: Spectrum o PAL +La siguiente tabla resume las distintas asignaciones de botones de joystick: + +[align="center",width="100%",%header,cols=6*,options="header"] +|=== +|Botón +|Kempston +|Sinclair 1 +|Sinclair 2 +|Protek +|Fuller +|Izquierda +|Bit 0 +|1 +|6 +|5 +|Bit 2 +|Derecha +|Bit 1 +|2 +|7 +|8 +|Bit 3 +|Abajo +|Bit 2 +|3 +|8 +|6 +|Bit 1 +|Arriba +|Bit 3 +|4 +|9 +|7 +|Bit 0 +|Disparo 1 +|Bit 4 +|5 +|0 +|0 +|Bit 4 +|Disparo 2 +|Bit 5 +|X +|Z +|9 +|Bit 5 +|=== + <<< ==== Exit @@ -1371,13 +1677,13 @@ Se puede utilizar una tarjeta SD con la primera partición en formato FAT16 o FA Durante la ejecución del core: - `Fin`: Alterna la visualización entre color, monocromo verde, monocromo ámbar o blanco y negro -- `F6`: Pone una marca personalizada en la posición actual de un PZX que se haya cargado (sólo en la versión con soporte para PZX) +- `F6` (`Caps Shift+Symbol Shift+6` en +UNO): Pone una marca personalizada en la posición actual de un PZX que se haya cargado (sólo en la versión con soporte para PZX) - `F7: Play/Pausa de PZX (sólo en la versión con soporte para PZX) - `F8: Mueve la posición de PZX a la marca personalizada (sólo en la versión con soporte para PZX) - `CTRL+ F8: Rebobina el PZX hasta una marca del tipo "tag BRWS". Estas marcas sirven para señalar, por ejemplo, el comienzo de una multicarga (sólo en la versión con soporte para PZX) - `F9: Para la reproducción del PZX y rebobina hasta el principio (sólo en la versión con soporte para PZX) -- `F11`: Activar o desactivar el módulo Wi-Fi -- `F12`: Activar o desactivar la velocidad de la CPU a 28Mhz. No es necesario mantener pulsada la tecla, como en el core original +- `F11` (`Caps Shift+Symbol Shift+Q` en +UNO): Activar o desactivar el módulo Wi-Fi +- `F12` (`Caps Shift+Symbol Shift+w` en +UNO): Activar o desactivar la velocidad de la CPU a 28Mhz. No es necesario mantener pulsada la tecla, como en el core original Además, cuando termina la reproducción completa de un fichero PZX, el reproductor se para automáticamente. También se parará si se encuentra en el fichero una marca STOP, o si se encuentra una marca STOP IF IN 48K y el core está en modo de 48K (sin paginación de 128K). @@ -1409,12 +1715,12 @@ Se debe de utilizar una tarjeta SD con la primera partición en formato FAT16 o Durante la ejecución del core: -- `Esc`: BREAK -- `F5`: NMI -- `F8`: Alternar la configuración de mezcla de Turbosound entre ACB y ABC. -- `Bloq. Despl.`: cambia de modo video compuesto a VGA y viceversa. -- `Ctrl+Alt+Backspace` o `F11`: Hard reset. Backspace es la tecla de borrar hacia atrás, encima de `Enter`. -- `Ctrl+Alt+Supr` o `F12`: Soft reset. +- `Esc` (`Caps Shift+Espacio` en +UNO): BREAK +- `F5` (`Caps Shift+Symbol Shift+5` en +UNO): NMI +- `F8` (`Caps Shift+Symbol Shift+8` en +UNO): Alternar la configuración de mezcla de Turbosound entre ACB y ABC. +- `Bloq. Despl.` (`Caps Shift+Symbol Shift+G` en +UNO): cambia de modo video compuesto a VGA y viceversa. +- `Ctrl+Alt+Backspace` o `F11` (`Caps Shift+Symbol Shift+Q` en +UNO): Hard reset. Backspace es la tecla de borrar hacia atrás, encima de `Enter`. +- `Ctrl+Alt+Supr` o `F12` (`Caps Shift+Symbol Shift+w` en +UNO): Soft reset. <<< @@ -1438,11 +1744,11 @@ Se debe de utilizar una tarjeta SD con la primera partición en formato FAT16 o Durante la ejecución del core: -- `Esc`: BREAK -- `F5`: NMI -- `F8`: Alternar la configuración de mezcla de Turbosound entre ACB y ABC. -- `Ctrl+Alt+Backspace` o `F11`: Hard reset. Backspace es la tecla de borrar hacia atrás, encima de `Enter`. -- `Ctrl+Alt+Supr` o `F12`: Soft reset. +- `Esc` (`Caps Shift+Espacio` en +UNO): BREAK +- `F5` (`Caps Shift+Symbol Shift+5` en +UNO): NMI +- `F8` (`Caps Shift+Symbol Shift+8` en +UNO): Alternar la configuración de mezcla de Turbosound entre ACB y ABC. +- `Ctrl+Alt+Backspace` o `F11` (`Caps Shift+Symbol Shift+Q` en +UNO): Hard reset. Backspace es la tecla de borrar hacia atrás, encima de `Enter`. +- `Ctrl+Alt+Supr` o `F12` (`Caps Shift+Symbol Shift+w` en +UNO): Soft reset. <<< @@ -1468,13 +1774,13 @@ Se debe de utilizar una tarjeta SD con la primera partición en formato FAT16 o Durante la ejecución del core: -- `F5`: NMI -- `F8`: Alternar la configuración de mezcla de Turbosound entre ACB y ABC. -- `F10`: Modo Pentagon -- `F11`: Modo 48K -- `F12`: Modo 128K -- `Ctrl+Alt+Backspace` o `F11`: Hard reset. Backspace es la tecla de borrar hacia atrás, encima de `Enter`. -- `Ctrl+Alt+Supr` o `F12`: Soft reset. +- `F5` (`Caps Shift+Symbol Shift+5` en +UNO): NMI +- `F8` (`Caps Shift+Symbol Shift+8` en +UNO): Alternar la configuración de mezcla de Turbosound entre ACB y ABC. +- `F10` (`Caps Shift+Symbol Shift+0` en +UNO): Modo Pentagon +- `F11` (`Caps Shift+Symbol Shift+Q` en +UNO): Modo 48K +- `F12` (`Caps Shift+Symbol Shift+w` en +UNO): Modo 128K +- `Ctrl+Alt+Backspace` o `F11` (`Caps Shift+Symbol Shift+Q` en +UNO): Hard reset. Backspace es la tecla de borrar hacia atrás, encima de `Enter`. +- `Ctrl+Alt+Supr` o `F12` (`Caps Shift+Symbol Shift+w` en +UNO): Soft reset. El core arranca por defecto en modo 128K. @@ -1526,7 +1832,7 @@ Obtener la distribución de TBBlue correspondiente al core instalado, por ejempl [TIP] ==== -En el caso de tener en la tarjeta SD instalado <>, el archivo `esxmmc.rom` debe ser la ROM con el mismo número de versión. +En el caso de tener en la tarjeta SD instalado <<#_esxdos,esxdos>>, el archivo `esxmmc.rom` debe ser la ROM con el mismo número de versión. ==== Si no estuviera ya, <<#_cores,instalar el core TBBlue>> en el ZXUNO+. @@ -1537,14 +1843,14 @@ Si no estuviera ya, <<#_cores,instalar el core TBBlue>> en el ZXUNO+. Durante la ejecución del core: -`F1`: Hard Reset +`F1` (`Caps Shift+Symbol Shift+1` en +UNO): Hard Reset `Espacio+F1`: Menú de arranque -`F2`: Activa o desactiva Scandoubler -`F3`: Cambia entre 50Hz y 60Hz -`F4`: Soft reset -`F5`: Pausa CPU -`F9`: Multiface -`F10`: NMI +`F2` (`Caps Shift+Symbol Shift+2` en +UNO): Activa o desactiva Scandoubler +`F3` (`Caps Shift+Symbol Shift+3` en +UNO): Cambia entre 50Hz y 60Hz +`F4` (`Caps Shift+Symbol Shift+4` en +UNO): Soft reset +`F5` (`Caps Shift+Symbol Shift+5` en +UNO): Pausa CPU +`F9` (`Caps Shift+Symbol Shift+9` en +UNO): Multiface +`F10` (`Caps Shift+Symbol Shift+0` en +UNO): NMI <<< @@ -1615,11 +1921,11 @@ Ahora, se puede organizar la información en la tarjeta SD de dos maneras distin Durante la ejecución del core: - `Mayús+F10`: Muestra el menú de Atom Software Archive -- `F10`: Soft Reset -- `F1`: Modo turbo 1Mhz -- `F2`: Modo turbo 2Mhz -- `F3`: Modo turbo 4Mhz -- `F4`: Modo turbo 8Mhz +- `F10` (`Caps Shift+Symbol Shift+0` en +UNO): Soft Reset +- `F1` (`Caps Shift+Symbol Shift+1` en +UNO): Modo turbo 1Mhz +- `F2` (`Caps Shift+Symbol Shift+2` en +UNO): Modo turbo 2Mhz +- `F3` (`Caps Shift+Symbol Shift+3` en +UNO): Modo turbo 4Mhz +- `F4` (`Caps Shift+Symbol Shift+4` en +UNO): Modo turbo 8Mhz El teclado está mapeado en inglés, según el siguiente esquema: @@ -1673,10 +1979,12 @@ Como el fichero `MMB` se llama igual que el que utiliza el <<#_bbc_micro,core de Durante la ejecución del core: -- `Bloq. Despl.`: cambia de modo video compuesto a VGA y viceversa. +- `Bloq. Despl.` (`Caps Shift+Symbol Shift+G` en +UNO): cambia de modo video compuesto a VGA y viceversa. - `Ctrl+Bloq May+1` - `Ctrl+Bloq May+4`: Configurar otros modos gráficos (60Hz, etc) - `F10` y `Ctrl+F10`: Soft Reset -- `Ctrl+Alt+Backspace`: Hard reset. Backspace es la tecla de borrar hacia atrás, encima de `Enter`. +- `Ctrl+Alt+Backspace` (`Caps Shift+Symbol Shift+B` en +UNO): Hard reset. Backspace es la tecla de borrar hacia atrás, encima de `Enter`. + +<<< ==== Guía básica @@ -1693,8 +2001,6 @@ BASIC > ---- -<<< - Automáticamente se monta el disco 0 de la imagen, y se puede ver su contenido con el comando: [source] @@ -1767,8 +2073,8 @@ Durante la ejecución del core: - `Impr. Pant` o `Windows Izquierda`: `COPY` - `F10` y `Ctrl+F10`: Soft Reset. - `Ctrl+Alt+F5`: NMI. -- `Ctrl+Alt+Supr`: Reset. -- `Ctrl+Alt+Backspace`: Hard reset. Backspace es la tecla de borrar hacia atrás, encima de `Enter`. +- `Ctrl+Alt+Supr` (`Caps Shift+Symbol Shift+N` en +UNO): Reset. +- `Ctrl+Alt+Backspace` (`Caps Shift+Symbol Shift+B` en +UNO): Hard reset. Backspace es la tecla de borrar hacia atrás, encima de `Enter`. - `Fin`: Alterna entre modo color y modo fósforo verde ==== Guía básica @@ -1952,10 +2258,10 @@ Durante la ejecución del core: - `-` (teclado numérico): Activar o desactivar scanlines en salida VGA. - `*` (teclado numérico): Alternar entre monitor en color y monitor en blanco y negro. -- `F1` a `F10`: Insertar la imagen de disco 1 a 10 en la tarjeta SD. Pulsar `F12` a continuación. +- `F1` a `F10` (`Caps Shift+Symbol Shift+0` en +UNO): Insertar la imagen de disco 1 a 10 en la tarjeta SD. Pulsar `F12` a continuación. - `Mayús+F1` a `Mayús+F10`: Insertar la imagen de disco 11 a 20 en la tarjeta SD. Pulsar `F12` a continuación. -- `Ctrl+Alt+Backspace`: Hard reset. Backspace es la tecla de borrar hacia atrás, encima de `Enter`. -- `F12`: Soft reset. +- `Ctrl+Alt+Backspace` (`Caps Shift+Symbol Shift+B` en +UNO): Hard reset. Backspace es la tecla de borrar hacia atrás, encima de `Enter`. +- `F12` (`Caps Shift+Symbol Shift+w` en +UNO): Soft reset. [WARNING] ==== @@ -1991,9 +2297,9 @@ Durante la ejecución: - Teclas de cursor (o palanca de joystick): Joystick - `Z` y `X` (o botones de disparo de joystick): Botones de disparo - `0`: En cores verticales, activa o desactiva giro de 90º en las direcciones de los controles -- `Bloq. Despl.`: Cambia de modo video compuesto a VGA y viceversa. -- `F10`: Soft Reset -- `Ctrl+Alt+Backspace`: Hard reset. Backspace es la tecla de borrar hacia atrás, encima de `Enter` +- `Bloq. Despl.` (`Caps Shift+Symbol Shift+G` en +UNO): Cambia de modo video compuesto a VGA y viceversa. +- `F10` (`Caps Shift+Symbol Shift+0` en +UNO): Soft Reset +- `Ctrl+Alt+Backspace` (`Caps Shift+Symbol Shift+B` en +UNO): Hard reset. Backspace es la tecla de borrar hacia atrás, encima de `Enter` <<< @@ -2022,16 +2328,16 @@ Si no estuviera ya, <<#_cores,instalar el core de Atari 800XL>> en el ZXUNO+. Durante la ejecución del core: -- `Bloq. Despl.`: para cambiar entre modo de video compuesto y VGA +- `Bloq. Despl.` (`Caps Shift+Symbol Shift+G` en +UNO): para cambiar entre modo de video compuesto y VGA - `-`: Activar o desactivar scanlines en modo VGA - `*`: Alternar el tipo de máquina entre PAL y NTSC -- `Ctrl+Alt+Backspace`: Hard reset. Backspace es la tecla de borrar hacia atrás, encima de `Enter` -- `F5`: `Help` -- `F6`: `Start` -- `F7`: `Select` -- `F9`: `Reset` -- `F11`: Cargar un disco -- `F12`: Acceder al menú de opciones +- `Ctrl+Alt+Backspace` (`Caps Shift+Symbol Shift+B` en +UNO): Hard reset. Backspace es la tecla de borrar hacia atrás, encima de `Enter` +- `F5` (`Caps Shift+Symbol Shift+5` en +UNO): `Help` +- `F6` (`Caps Shift+Symbol Shift+6` en +UNO): `Start` +- `F7` (`Caps Shift+Symbol Shift+7` en +UNO): `Select` +- `F9` (`Caps Shift+Symbol Shift+9` en +UNO): `Reset` +- `F11` (`Caps Shift+Symbol Shift+Q` en +UNO): Cargar un disco +- `F12` (`Caps Shift+Symbol Shift+w` en +UNO): Acceder al menú de opciones - El teclado numérico emula un joystick. Las teclas `5` y `2` sirven indistintamente para la dirección __abajo__ y `0` es el disparo <<< @@ -2087,11 +2393,22 @@ Durante la ejecución del core: - `F` o el botón de disparo del joystick 1: Disparo del jugador 1 - `I`, `J`, `K`, `L` o el joystick 2: Controles de dirección del jugador 2 - `H` o el botón de disparo del joystick 2: Disparo del jugador 2 -- `Bloq. Despl.`: para cambiar entre modo de video compuesto y VGA -- `Ctrl+Alt+Backspace`: Hard reset. Backspace es la tecla de borrar hacia atrás, encima de `Enter` +- `Bloq. Despl.` (`Caps Shift+Symbol Shift+G` en +UNO): para cambiar entre modo de video compuesto y VGA +- `Ctrl+Alt+Backspace` (`Caps Shift+Symbol Shift+B` en +UNO): Hard reset. Backspace es la tecla de borrar hacia atrás, encima de `Enter` <<< +===== Personalización de los controles + +Existe oras versiones de este core que permite modificar el soporte de teclado. Para ello, se ha de crear en la raiz de la tarjeta SD un fichero llamado KEYSP1` para el primer jugador y `KEYSP2` para el segundo (se puede descargar uno de ejemplo desde https://www.zxuno.com/forum/download/file.php?id=1360[el foro de ZX-Uno]). + +Estos ficheros se pueden crear con un editor hexadecimal (como https://mh-nexus.de/en/hxd/[HxD para Windows])y están formados por una secuencia de bytes indicando en este orden: `Arriba`, `Abajo`, `Izquierda`, `Derecha`, `Botón de disparo`. Los códigos a utilizar en la secuencia se pueden consultar en la tabla <<#_scan_codes,Scan Codes>> al final del manual (Columna MAKE), pero, teniendo en cuenta que, si el código está emparejado con `0xE0`, se ha de usar el otro valor, sumánole `0x80` (por ejemplo, para `E0 14`, sería `0x94`). + +[TIP] +==== +Por ejemplo, la secuencia `15 1C 44 4D 29` se correspondería con `Q A O P Espacio` +==== + ==== Guía básica Pulsando `Esc` o el botón 2 del joystick se muestra el menú de configuración. Se usan las teclas de cursor y `Enter` para elegir y seleccionar en el menú. @@ -2156,11 +2473,11 @@ image:img/keyboardbbc.png[pdfwidth=80%] Durante la ejecución del core: -- `Bloq. Despl.`: Cambia de modo video compuesto a VGA y viceversa. +- `Bloq. Despl.` (`Caps Shift+Symbol Shift+G` en +UNO): Cambia de modo video compuesto a VGA y viceversa. - `-` (del teclado numérico): Activa o desactiva scanlines -- `F12`: Reset +- `F12` (`Caps Shift+Symbol Shift+w` en +UNO): Reset - `Mayús+F12`: Soft Reset intentando cargar automáticamente el disco seleccionado en `BEEB.MMB` -- `Ctrl+Alt+Backspace`: Hard reset. Backspace es la tecla de borrar hacia atrás, encima de `Enter`. +- `Ctrl+Alt+Backspace` (`Caps Shift+Symbol Shift+B` en +UNO): Hard reset. Backspace es la tecla de borrar hacia atrás, encima de `Enter`. <<< @@ -2202,6 +2519,8 @@ Para cargar, por ejemplo, un programa llamado `MENU`, y que esté en el disco us *MENU ---- +<<< + Para ver una lista de los discos disponibles en el fichero `BEEB.MMB`: [source] @@ -2227,7 +2546,7 @@ Recordar, tras insertar un disco, que si este tiene arranque automático, se pue El https://es.wikipedia.org/wiki/Camputers_Lynx[Lynx] fue un ordenador doméstico británico de 8 bits lanzado a principios de 1983 por la compañía Camputers. Se lanzaron en total tres modelos, con 48kB, 96kB o 128kB de RAM. -La versión para ZXUNO+ tiene estas características: +La versión para ZX-Uno ha sido https://github.com/Kyp069/lynx[desarrollada por Kyp069] y tiene las siguientes características: - Modos 48kB y 96 kB - ROM Scorpion opcional @@ -2244,11 +2563,11 @@ Este core no utiliza la tarjeta SD. Durante la ejecución del core: -- `F6`: Alterna entre el modo 48kB y el modo 96kB (por defecto) -- `F7`: Alterna entre activar o desactivar la ROM Scorpio (activa por defecto) -- `F8`: Activar o desactivar el tener en cuenta los bits 2 y 3 del puerto $80 (señal CAS del banco 2), para que se vean bien los juegos de Level 9.- `Ctrl+Alt+Supr`: Reset -- `F11`: Reset -- `Ctrl+Alt+Backspace`: Hard reset. Backspace es la tecla de borrar hacia atrás, encima de `Enter` +- `F6` (`Caps Shift+Symbol Shift+6` en +UNO): Alterna entre el modo 48kB y el modo 96kB (por defecto) +- `F7` (`Caps Shift+Symbol Shift+7` en +UNO): Alterna entre activar o desactivar la ROM Scorpio (activa por defecto) +- `F8` (`Caps Shift+Symbol Shift+8` en +UNO): Activar o desactivar el tener en cuenta los bits 2 y 3 del puerto $80 (señal CAS del banco 2), para que se vean bien los juegos de Level 9.- `Ctrl+Alt+Supr` (`Caps Shift+Symbol Shift+N` en +UNO): Reset +- `F11` (`Caps Shift+Symbol Shift+Q` en +UNO): Reset +- `Ctrl+Alt+Backspace` (`Caps Shift+Symbol Shift+B` en +UNO): Hard reset. Backspace es la tecla de borrar hacia atrás, encima de `Enter` <<< @@ -2273,7 +2592,7 @@ Para ficheros binarios, se debe usar `MLOAD` en vez de `LOAD`. [NOTE] ==== -El software Maxduino incorporando en <<<<#_miniduino,el miniduino>> no tiene, por el momento, soporte para los archivos de cinta `TAP` de Lynx. +El software Maxduino incorporando en <<#_miniduino,el miniduino>> no tiene, por el momento, soporte para los archivos de cinta `TAP` de Lynx. ==== Es posible utilizar programas como <<#_conversión_a_fichero_de_audio,Lynx2Wav>> con los ficheros `TAP` de cinta de Lynx. Los ficheros de audio obtenidos se pueden embeber a su vez dentro de ficheros TSX o TZX con herramientas como <<#_creación_de_ficheros_tzx_o_tsx_desde_otros_formatos,MakeTSX o RetroConverter>>. @@ -2311,9 +2630,9 @@ La máquina CHIP-8 utiliza un teclado hexadecimal como entrada. La asignación e Durante la ejecución del core: -- `Esc`: para mostrar u ocultar el menú. -- `F11`: Hard Reset -- `F12`: Reset +- `Esc` (`Caps Shift+Espacio` en +UNO): para mostrar u ocultar el menú. +- `F11` (`Caps Shift+Symbol Shift+Q` en +UNO): Hard Reset +- `F12` (`Caps Shift+Symbol Shift+w` en +UNO): Reset <<< @@ -2406,9 +2725,9 @@ El teclado está con la distribución en inglés. No está implementada la tecla Durante la ejecución del core: - `Windows`: `MODSEL` -- `F5`: NMI -- `F11`: Hard Reset -- `F12` o `Ctrl+Alt+Supr`: Reset +- `F5` (`Caps Shift+Symbol Shift+5` en +UNO): NMI +- `F11` (`Caps Shift+Symbol Shift+Q` en +UNO): Hard Reset +- `F12` o `Ctrl+Alt+Supr` (`Caps Shift+Symbol Shift+N` en +UNO): Reset <<< @@ -2510,12 +2829,12 @@ Si no estuviera ya, <<#_cores,instalar el core de Commodore 16>> en el ZXUNO+. Durante la ejecución del core: -- `Esc`: Esc +- `Esc` (`Caps Shift+Espacio` en +UNO): Esc - `Tab`: RUN/STOP - `Windows izquierda` = Commodore - Teclado Numérico: Joystick emulado -- `F1` a `F3`: F1 a F3 -- `Bloq. Num` o `F4`: HELP +- `F1` a `F3` (`Caps Shift+Symbol Shift+3` en +UNO): F1 a F3 +- `Bloq. Num` o `F4` (`Caps Shift+Symbol Shift+4` en +UNO): HELP - `Insert`: Seleccionar el primer disco de la tarjeta SD - `Re.Pag`: Seleccionar el siguiente disco - `Av.Pag`: Seleccionar el disco anterior @@ -2524,9 +2843,9 @@ Durante la ejecución del core: - `+` del teclado numérico: Cambiar la polaridad de la entrada de audio - `-` del teclado numérico: Activar o desactivar scanlines en modo VGA - `Bloq. Desp`: para cambiar entre modo de video compuesto y VGA -- `F11`: Seleccionar la asignación del joystick al puerto 0 o al puerto 1 -- `F12`: Reset -- `Ctrl+Alt+Backspace`: Hard reset. Backspace es la tecla de borrar hacia atrás, encima de `Enter` +- `F11` (`Caps Shift+Symbol Shift+Q` en +UNO): Seleccionar la asignación del joystick al puerto 0 o al puerto 1 +- `F12` (`Caps Shift+Symbol Shift+w` en +UNO): Reset +- `Ctrl+Alt+Backspace` (`Caps Shift+Symbol Shift+B` en +UNO): Hard reset. Backspace es la tecla de borrar hacia atrás, encima de `Enter` <<< @@ -2537,6 +2856,16 @@ image:img/c16.png[pdfwidth=70%] Desde BASIC, se puede cargar desde una cinta (u <<#_miniduino,otro dispositivo externo de audio>>) con el comando `LOAD`. Una vez finalizadada la carga, escribir `RUN` y pulsar `Enter` si fuese necesario. +[NOTE] +==== +El software Maxduino incorporando en <<#_miniduino,el miniduino>> no tiene, por el momento, soporte para los archivos de cinta de Commodore 16, pero es posible utilizar <<#_conversión_a_fichero_de_audio,Comodoro>> para generar ficheros `TZX` compatibles +==== + +[TIP] +==== +Es posible utilizar programas como <<#_conversión_a_fichero_de_audio,Audiotap o Comodoro>> con los ficheros `TAP` de cinta de Commodore. +==== + Para listar el directorio del disco seleccionado, pulsar `F3` o introducir el comando `DIRECTORY`. Para cargar un fichero del disco, usar el comando `DLOAD""` y luego, normalmente, `RUN`. Para cargar rápidamente el primer fichero `PRG` de un disco pulsar `Mayús+TAB` o usar el comando `DLOAD"*"`, y luego, normalmente, `RUN`. @@ -2619,13 +2948,13 @@ Si no estuviera ya, <<#_cores,instalar el core de Commodore 64>> en el ZXUNO+. Durante la ejecución del core: -- `Esc`: Start/Stop +- `Esc` (`Caps Shift+Espacio` en +UNO): Start/Stop - `Tab`: RUN/STOP - `Alt` = Commodore - Teclado Numérico: Joystick emulado -- `F1` a `F8`: F1 a F8 -- `F9`: Tecla del símbolo de la libra -- `F10`: Tecla del símbolo `+` +- `F1` a `F8` (`Caps Shift+Symbol Shift+8` en +UNO): F1 a F8 +- `F9` (`Caps Shift+Symbol Shift+9` en +UNO): Tecla del símbolo de la libra +- `F10` (`Caps Shift+Symbol Shift+0` en +UNO): Tecla del símbolo `+` - `Insert`: Seleccionar el primer disco de la tarjeta SD - `Re.Pag`: Seleccionar el siguiente disco - `Av.Pag`: Seleccionar el disco anterior @@ -2635,10 +2964,10 @@ Durante la ejecución del core: - `-` del teclado numérico: Activar o desactivar scanlines en modo VGA - `Bloq. Desp`: para cambiar entre modo de video compuesto y VGA - `Fin` = Cambiar paleta de colores -- `F11`: Rotar entre puertos de joystick -- `F12`: Reset modo JiffyDOS +- `F11` (`Caps Shift+Symbol Shift+Q` en +UNO): Rotar entre puertos de joystick +- `F12` (`Caps Shift+Symbol Shift+w` en +UNO): Reset modo JiffyDOS - `Ctrl+F12`: Reset modo ROM C64 original (para carga de cintas) -- `Ctrl+Alt+Backspace`: Hard reset. Backspace es la tecla de borrar hacia atrás, encima de `Enter` +- `Ctrl+Alt+Backspace` (`Caps Shift+Symbol Shift+B` en +UNO): Hard reset. Backspace es la tecla de borrar hacia atrás, encima de `Enter` <<< @@ -2648,11 +2977,22 @@ Durante la ejecución del core: image:img/c64.png[pdfwidth=70%] Desde BASIC, se puede cargar desde una cinta (u <<#_miniduino,otro dispositivo externo de audio>>) con el comando `LOAD`. Una vez finalizadada la carga, escribir `RUN` y pulsar `Enter` si fuese necesario. + [NOTE] ==== Para cargar desde cinta se debe estar usando la ROM de C64 original que se activa con `Ctrl+F12`. ==== +[NOTE] +==== +El software Maxduino incorporando en <<#_miniduino,el miniduino>> no tiene, por el momento, soporte para los archivos de cinta de Commodore 64, pero es posible utilizar <<#_conversión_a_fichero_de_audio,Comodoro>> para generar ficheros `TZX` compatibles +==== + +[TIP] +==== +Es posible utilizar programas como <<#_conversión_a_fichero_de_audio,Audiotap o Comodoro>> con los ficheros `TAP` de cinta de Commodore. +==== + Para cargar desde un disco, habitualmente, se puede pulsar `Mayus+Esc` o bien escribir `LOAD "*",8,1` y pulsar `Enter`. Una vez aparezca `READY` en la pantalla, escribir `RUN` y pulsar `Enter` para ejecutar el programa. Si el disco tuviera varios programas, usar `F1` para listar el contenido, o bien escribir `LOAD "$"` y pulsar `Enter`. A continuación, escribir `LIST`, y pulsar `Enter`, para ver una lista con los archivos dentro del disco. @@ -2688,7 +3028,7 @@ El teclado está con la distribución en inglés. Durante la ejecución del core: -- `F1`: Cancelar carga desde cinta +- `F1` (`Caps Shift+Symbol Shift+1` en +UNO): Cancelar carga desde cinta - `Alt`: Permite escribir en modo gráfico <<< @@ -2702,12 +3042,12 @@ Se puede cargar desde una cinta (u otro dispositivo externo de audio) con el com [NOTE] ==== -El software Maxduino incorporando en <<<<#_miniduino,el miniduino>> no tiene, por el momento, soporte para los archivos de cinta de Commodore PET. +El software Maxduino incorporando en <<#_miniduino,el miniduino>> no tiene, por el momento, soporte para los archivos de cinta de Commodore PET, pero es posible utilizar <<#_conversión_a_fichero_de_audio,Comodoro>> para generar ficheros `TZX` compatibles ==== [TIP] ==== -Es posible utilizar programas como <<#_conversión_a_fichero_de_audio,Audiotap>> con los ficheros `TAP` de cinta de Commodore. +Es posible utilizar programas como <<#_conversión_a_fichero_de_audio,Audiotap o Comodoro>> con los ficheros `TAP` de cinta de Commodore. ==== <<< @@ -2735,12 +3075,12 @@ Este core no utiliza la tarjeta SD. Durante la ejecución del core: -- `F9` a `F11`: Cargar cartuchos incorporados al core (si los hubiera) +- `F9` a `F11` (`Caps Shift+Symbol Shift+Q` en +UNO): Cargar cartuchos incorporados al core (si los hubiera) - `-` del teclado numérico: Cambiar la polaridad de la entrada de audio. El LED rojo se enciende cuando la polaridad está invertida - `Bloq. Desp`: para cambiar entre modo de video compuesto y VGA - `Bloq. Num`: Reset desactivando la ampliación de memoria de 32K (activa por defecto) -- `F12`: Reset activando la ampliación de memoria -- `Ctrl+Alt+Backspace`: Hard reset. Backspace es la tecla de borrar hacia atrás, encima de `Enter` +- `F12` (`Caps Shift+Symbol Shift+w` en +UNO): Reset activando la ampliación de memoria +- `Ctrl+Alt+Backspace` (`Caps Shift+Symbol Shift+B` en +UNO): Hard reset. Backspace es la tecla de borrar hacia atrás, encima de `Enter` <<< @@ -2753,12 +3093,12 @@ Se puede cargar desde una cinta (u otro dispositivo externo de audio) con el com [NOTE] ==== -El software Maxduino incorporando en <<<<#_miniduino,el miniduino>> no tiene, por el momento, soporte para los archivos de cinta de Commodore VIC-20. +El software Maxduino incorporando en <<#_miniduino,el miniduino>> no tiene, por el momento, soporte para los archivos de cinta de Commodore VIC-20, pero es posible utilizar <<#_conversión_a_fichero_de_audio,Comodoro>> para generar ficheros `TZX` compatibles ==== [TIP] ==== -Es posible utilizar programas como <<#_conversión_a_fichero_de_audio,Audiotap>> con los ficheros `TAP` de cinta de Commodore. +Es posible utilizar programas como <<#_conversión_a_fichero_de_audio,Audiotap o Comodoro>> con los ficheros `TAP` de cinta de Commodore. ==== <<< @@ -2817,18 +3157,18 @@ Se puede utilizar una tarjeta SD, con la primera partición en formato FAT16, pa Durante la ejecución del core: -- `F1`: Velocidad de ejecución normal -- `F2`: Velocidad de ejecución 2x -- `F3`: Velocidad de ejecución 4x -- `F9`: Habilitar o deshabilitar sonido -- `Esc`: Congela la ejecución de un programa BASIC o Código Máquina. Volviendo a pulsar, la ejecución continua +- `F1` (`Caps Shift+Symbol Shift+1` en +UNO): Velocidad de ejecución normal +- `F2` (`Caps Shift+Symbol Shift+2` en +UNO): Velocidad de ejecución 2x +- `F3` (`Caps Shift+Symbol Shift+3` en +UNO): Velocidad de ejecución 4x +- `F9` (`Caps Shift+Symbol Shift+9` en +UNO): Habilitar o deshabilitar sonido +- `Esc` (`Caps Shift+Espacio` en +UNO): Congela la ejecución de un programa BASIC o Código Máquina. Volviendo a pulsar, la ejecución continua - `Supr`: Detiene la ejecución de un programa BASIC mientras se mantenga pulsada - `Fin`: Si se pulsa durante la ejecución de un programa BASIC realiza un BREAK - `Mayús.+M`: Habilita el modo plus más avanzado en aquellos programas que estén preparados para usarlo (por ejemplo `TETRIS.GTP`) - `M`: Vuelve al modo normal desde el modo plus - `Ctrl+Alt+F5`: NMI -- `Ctrl+Alt+Supr`: Soft Reset -- `Ctrl+Alt+Backspace`: Hard reset. Backspace es la tecla de borrar hacia atrás, encima de `Enter` +- `Ctrl+Alt+Supr` (`Caps Shift+Symbol Shift+N` en +UNO): Soft Reset +- `Ctrl+Alt+Backspace` (`Caps Shift+Symbol Shift+B` en +UNO): Hard reset. Backspace es la tecla de borrar hacia atrás, encima de `Enter` <<< @@ -2894,16 +3234,16 @@ https://github.com/pullmoll/cass80 Durante la ejecución del core: -- `F5`: Cambia color de la tinta -- `F6`: Cambia el color del papel -- `F7`: Cambia color del borde -- `F9`: Cambia entre modo 64/32 columnas (solo salida VGA) -- `F10`: Tecla `PAGE` +- `F5` (`Caps Shift+Symbol Shift+5` en +UNO): Cambia color de la tinta +- `F6` (`Caps Shift+Symbol Shift+6` en +UNO): Cambia el color del papel +- `F7` (`Caps Shift+Symbol Shift+7` en +UNO): Cambia color del borde +- `F9` (`Caps Shift+Symbol Shift+9` en +UNO): Cambia entre modo 64/32 columnas (solo salida VGA) +- `F10` (`Caps Shift+Symbol Shift+0` en +UNO): Tecla `PAGE` - `Inicio`: Tecla `CLEAR` - `Bloq. Despl`: Cambia entre modo VGA y PAL. Nota: en el modo PAL la imagen se desplaza hacia arriba y vuelve a entra por abajo en un bucle, como pasaba antiguamente en los canales de TV analógicos cuando no estaban bien sintonizados. - `Mayús+0`: Si se ha cargado el fichero `ULCBAS.CAS` (Upper/Lower Case Driver) permite cambiar el estado de solo mayúsculas o mayúsculas+minúsculas. -- `Ctrl+Alt+Supr`: Reset -- `Ctrl+Alt+Backspace`: Hard Reset +- `Ctrl+Alt+Supr` (`Caps Shift+Symbol Shift+N` en +UNO): Reset +- `Ctrl+Alt+Backspace` (`Caps Shift+Symbol Shift+B` en +UNO): Hard Reset <<< @@ -2976,10 +3316,10 @@ Se puede utilizar una tarjeta SD, con la primera partición en formato FAT16, pa Durante la ejecución del core: -- `F1` a `F4`: Modos Turbo +- `F1` a `F4` (`Caps Shift+Symbol Shift+4` en +UNO): Modos Turbo - `Ctrl+Alt+F5`: NMI -- `Ctrl+Alt+Supr`: Reset -- `Ctrl+Alt+Backspace`: Hard reset. Backspace es la tecla de borrar hacia atrás, encima de `Enter` +- `Ctrl+Alt+Supr` (`Caps Shift+Symbol Shift+N` en +UNO): Reset +- `Ctrl+Alt+Backspace` (`Caps Shift+Symbol Shift+B` en +UNO): Hard reset. Backspace es la tecla de borrar hacia atrás, encima de `Enter` <<< @@ -3071,13 +3411,13 @@ Si no estuviera ya, <<#_cores,instalar el core de MSX>> en el ZUNO+. Durante la ejecución del core: -- `F1` a `F5`: `F1` a `F5` +- `F1` a `F5` (`Caps Shift+Symbol Shift+5` en +UNO): `F1` a `F5` - `Impr Pant`: Cambia el modo entre VGA y RGB - `Bloq Desp`: Cambia el modo de línea de exploración (Scanlines) - `Pausa`: Cambia entre 50Hz y 60Hz -- `F11`: Activa o desactiva el modo turbo -- `Ctrl+Alt+Supr`: Soft Reset -- `Ctrl+Alt+Backspace`: Hard Reset. Backspace es la tecla de borrar hacia atrás, encima de `Enter` +- `F11` (`Caps Shift+Symbol Shift+Q` en +UNO): Activa o desactiva el modo turbo +- `Ctrl+Alt+Supr` (`Caps Shift+Symbol Shift+N` en +UNO): Soft Reset +- `Ctrl+Alt+Backspace` (`Caps Shift+Symbol Shift+B` en +UNO): Hard Reset. Backspace es la tecla de borrar hacia atrás, encima de `Enter` - `ALT Izquierdo`: MSX GRAPH - `ALT Derecho`: MSX CODE - `Re Pág`: MSX SELECT @@ -3193,8 +3533,8 @@ El teclado no está mapeado a la distribución de uno PS/2 estándar, e intenta Durante la ejecución del core: -- `F1` a `F5`: F1 a F5 -- `Esc`: `GRAPH` +- `F1` a `F5` (`Caps Shift+Symbol Shift+5` en +UNO): F1 a F5 +- `Esc` (`Caps Shift+Espacio` en +UNO): `GRAPH` - `Tab`: `ALPHA` - `Bloq. Mayús`: `CTRL` - `Mayús`: `SHIFT` @@ -3266,7 +3606,29 @@ Durante la ejecución del core: - `Esc` o botón 2 del joystick: Mostrar u ocultar el menú de configuración - Teclas de cursor, y `Enter` para usar el menú -- `Ctrl+Alt+Backspace`: Hard reset. Backspace es la tecla de borrar hacia atrás, encima de `Enter` +- `Ctrl+Alt+Backspace` (`Caps Shift+Symbol Shift+B` en +UNO): Hard reset. Backspace es la tecla de borrar hacia atrás, encima de `Enter` + +===== Personalización de los controles + +Existe otras versiones de este core que permiten el control también con teclado: + +- `W`, `A`, `S`, `D` (personalizables) o el joystick 1: Controles de dirección del jugador 1 +- `F` y `R` (personalizables) o botones de disparo del joystick 1: Botones A y B (Jugador 1) +- `5` y `1`: `Select` y `Start` (Jugador 1) +- `I`, `J`, `K`, `L` (personalizables) o el joystick 2: Controles de dirección del jugador 2 +- `H`, `Y` (personalizables) o botones de disparo del joystick 1: Botones A y B (Jugador 2) +- `6` y `2`: `Select` y `Start` (Jugador 1) +- `F4` (`Caps Shift+Symbol Shift+4` en ZXUnGo+): Intercambiar la asignación de teclas de jugador 1 y jugador 2 +- `Ctrl+Alt+Backspace` (`Caps Shift+Symbol Shift+F` y luego `B` en ZXUnGo+): Hard Reset. Backspace es la tecla de borrar hacia atrás, encima de `Enter` + +Los controles por defecto del core con soporte de teclado se pueden modificar. Para ello, se ha de crear en la raiz de la tarjeta SD un fichero llamado KEYSP1` para el primer jugador y `KEYSP2` para el segundo (se puede descargar uno de ejemplo desde https://www.zxuno.com/forum/download/file.php?id=1360[el foro de ZX-Uno]). + +Estos ficheros se pueden crear con un editor hexadecimal (como https://mh-nexus.de/en/hxd/[HxD para Windows])y están formados por una secuencia de bytes indicando en este orden: `Arriba`, `Abajo`, `Izquierda`, `Derecha`, `Botón A`, `Botón B`. Los códigos a utilizar en la secuencia se pueden consultar en la tabla <<#_scan_codes,Scan Codes>> al final del manual (Columna MAKE), pero, teniendo en cuenta que, si el código está emparejado con `0xE0`, se ha de usar el otro valor, sumánole `0x80` (por ejemplo, para `E0 14`, sería `0x94`). + +[TIP] +==== +Por ejemplo, la secuencia `15 1C 44 4D 29 22` se correspondería con `Q A O P Espacio X`, y la secuencia `1D 1B 23 2B 1A 22` se correspondería con `W S D F Z X` +==== <<< @@ -3356,7 +3718,7 @@ image:img/keyboardoric.png[pdfwidth=80%] Durante la ejecución del core: -- `Bloq. Despl.`: para cambiar entre modo de vídeo RGB y VGA +- `Bloq. Despl.` (`Caps Shift+Symbol Shift+G` en +UNO): para cambiar entre modo de vídeo RGB y VGA - `Inicio`: Mostrar datos de depuración (Pista de disco actual -dos dígitos-, número de imagen de disco -dos dígitos-, y registro de contador de programa -cuatro dígitos-) - `Fin`: NMI - `Inicio+Fin`: Reset @@ -3392,7 +3754,7 @@ Para ejecutar un programa, se ha de escribir `-` delante del nombre. Así, por e Otra versión distinta de core de https://es.wikipedia.org/wiki/Oric_Atmos[Oric Atmos], basada en la versión de Rampa para MiST, Mistica y SiDi. -Esta versión tiene las siguientes características: +Esta versión ha sido https://github.com/Kyp069/atmos[desarrollada por Kyp069] y tiene las siguientes características: - Salida de vídeo compuesto o VGA (Scandoubler) - 64KB de RAM y 16KB de ROM. La ROM oculta la parte alta de la memoria, pero se puede acceder a todos los bancos de memoria mediante ensamblador @@ -3421,15 +3783,15 @@ image:img/keyboardoric.png[pdfwidth=80%] Durante la ejecución del core: -- `F1`: Seleccionar la ROM 1.1 -- `F2`: Seleccionar la ROM 1.22 -- `F5`: NMI -- `F10`: Habilita la salida de audio al ejecutar `CSAVE` -- `Ctrl+Alt+Backspace` o `F11`: Hard reset. Backspace es la tecla de borrar hacia atrás, encima de `Enter` -- `Ctrl+Alt+Supr` o `F12`: Soft reset -- `Bloq. Despl.`: para cambiar entre modo de vídeo compuesto y VGA +- `F1` (`Caps Shift+Symbol Shift+1` en +UNO): Seleccionar la ROM 1.1 +- `F2` (`Caps Shift+Symbol Shift+2` en +UNO): Seleccionar la ROM 1.22 +- `F5` (`Caps Shift+Symbol Shift+5` en +UNO): NMI +- `F10` (`Caps Shift+Symbol Shift+0` en +UNO): Habilita la salida de audio al ejecutar `CSAVE` +- `Ctrl+Alt+Backspace` o `F11` (`Caps Shift+Symbol Shift+Q` en +UNO): Hard reset. Backspace es la tecla de borrar hacia atrás, encima de `Enter` +- `Ctrl+Alt+Supr` o `F12` (`Caps Shift+Symbol Shift+w` en +UNO): Soft reset +- `Bloq. Despl.` (`Caps Shift+Symbol Shift+G` en +UNO): para cambiar entre modo de vídeo compuesto y VGA - `Alt Gr.`: Tecla `FUNC` -- `Esc`: Tecla `ESC` +- `Esc` (`Caps Shift+Espacio` en +UNO): Tecla `ESC` - `Supr`: Tecla `DEL` - `Ctrl`: Tecla `CTRL` - `Mayus.`: Tecla `SHIFT` @@ -3442,11 +3804,6 @@ Durante la ejecución del core: [.text-center] image:img/oric.png[pdfwidth=70%] -[NOTE] -==== -La versión 1.0 del core no detecta correctamente los ajustes de la BIOS y siempre arranca en modo vídeo compuesto. Por tanto, unos instantes después de haberlo cargado, se debe pulsar `Bloq. Despl.` para activar la salida de vídeo VGA -==== - Desde BASIC, se puede cargar desde una cinta (u <<#_miniduino,otro dispositivo externo de audio>>) usando el comando `CLOAD ""` y `Enter`. A continuación, aparecerá en pantalla el mensaje [source] @@ -3500,9 +3857,9 @@ Este core no utiliza la tarjeta SD. Durante la ejecución del core: - `Esc` o botón 2 del joystick: Mostrar u ocultar el menú de configuración -- `Ctrl+Alt+Backspace`: Hard reset. Backspace es la tecla de borrar hacia atrás, encima de `Enter` -- `Bloq. Despl.`: cambia de modo vídeo RGB a VGA y viceversa -- `F3` o `F12`: Reinicio del juego +- `Ctrl+Alt+Backspace` (`Caps Shift+Symbol Shift+B` en +UNO): Hard reset. Backspace es la tecla de borrar hacia atrás, encima de `Enter` +- `Bloq. Despl.` (`Caps Shift+Symbol Shift+G` en +UNO): cambia de modo vídeo RGB a VGA y viceversa +- `F3` o `F12` (`Caps Shift+Symbol Shift+w` en +UNO): Reinicio del juego - Número del `1` al `7`: Cambiar el tipo de juego - Joystick 2 (derecha): Control de paleta de la derecha (Jugador 1). - Joystick 1 (izquierda): Control de paleta de la izquierda (Jugador 2) @@ -3590,8 +3947,8 @@ Este core no utiliza la tarjeta SD. Durante la ejecución del core: - `Ctrl+Alt+F5`: NMI. -- `Ctrl+Alt+Supr`: Soft reset. -- `Ctrl+Alt+Backspace`: Hard reset. Backspace es la tecla de borrar hacia atrás, encima de `Enter`. +- `Ctrl+Alt+Supr` (`Caps Shift+Symbol Shift+N` en +UNO): Soft reset. +- `Ctrl+Alt+Backspace` (`Caps Shift+Symbol Shift+B` en +UNO): Hard reset. Backspace es la tecla de borrar hacia atrás, encima de `Enter`. <<< @@ -3638,9 +3995,9 @@ Durante la ejecución del core: - `Z`, `Windows` o el botón de joystick 1: Botón de disparo 1 del jugador 1 - `X`, `Espacio` o el botón secundario de joystick 1: Botón de disparo 2 del jugador 1 - `Pausa`: Tecla de botón de pausa de Master System -- `Bloq. Despl.`: para cambiar entre modo de vídeo RGB/Vídeo Compuesto y VGA -- `Ctrl+Alt+Backspace`: Hard reset. Backspace es la tecla de borrar hacia atrás, encima de `Enter` -- `F12`: Reset y mostrar el selector de ficheros +- `Bloq. Despl.` (`Caps Shift+Symbol Shift+G` en +UNO): para cambiar entre modo de vídeo RGB/Vídeo Compuesto y VGA +- `Ctrl+Alt+Backspace` (`Caps Shift+Symbol Shift+B` en +UNO): Hard reset. Backspace es la tecla de borrar hacia atrás, encima de `Enter` +- `F12` (`Caps Shift+Symbol Shift+w` en +UNO): Reset y mostrar el selector de ficheros <<< @@ -3701,9 +4058,9 @@ Durante la ejecución del core: - `X` o el botón principal de joystick: Botón de disparo 2 - `C` o el botón secundario de joystick: Botón de disparo 3 - `V`: Botón de disparo 4 -- `Esc`: para mostrar u ocultar el menú. -- `Ctrl+Alt+Backspace`: Hard reset. Backspace es la tecla de borrar hacia atrás, encima de `Enter` -- `F12`: Reset +- `Esc` (`Caps Shift+Espacio` en +UNO): para mostrar u ocultar el menú. +- `Ctrl+Alt+Backspace` (`Caps Shift+Symbol Shift+B` en +UNO): Hard reset. Backspace es la tecla de borrar hacia atrás, encima de `Enter` +- `F12` (`Caps Shift+Symbol Shift+w` en +UNO): Reset <<< @@ -3750,19 +4107,19 @@ Si no estuviera ya, <<#_cores,instalar el core de Videopac>> en el ZXUNO+. Durante la ejecución del core: -- `Bloq. Despl.`: para cambiar entre modo de vídeo RGB/Vídeo Compuesto y VGA -- `F2`: Alternar entre RGB y vídeo compuesto cuando no se está usando el modo VGA -- `F3`: Reset -- `Ctrl+Alt+Backspace`: Hard reset. . Backspace es la tecla de borrar hacia atrás, encima de `Enter` +- `Bloq. Despl.` (`Caps Shift+Symbol Shift+G` en +UNO): para cambiar entre modo de vídeo RGB/Vídeo Compuesto y VGA +- `F2` (`Caps Shift+Symbol Shift+2` en +UNO): Alternar entre RGB y vídeo compuesto cuando no se está usando el modo VGA +- `F3` (`Caps Shift+Symbol Shift+3` en +UNO): Reset +- `Ctrl+Alt+Backspace` (`Caps Shift+Symbol Shift+B` en +UNO): Hard reset. . Backspace es la tecla de borrar hacia atrás, encima de `Enter` - Tras cargar una ROM, la mayoría de los juegos mostrarán un mensaje "SELECT GAME". Pulsar una tecla entre `0` y `9` o el botón del joystick para jugar. -- `Esc` o el botón 2 del joystick para mostrar u ocultar el menú. -- `W`, `A`, `S`, `D` o las teclas de cursor y luego `Enter` para elegir y seleccionar en el menú. +- `Esc` (`Caps Shift+Symbol Shift+Espacio` en +UNO) o el botón 2 del joystick para mostrar u ocultar el menú. +- `W`, `A`, `S`, `D` o las teclas de cursor (`Caps Shift+6` y `Caps Shift+7` en +UNO) y luego `Enter` para elegir y seleccionar en el menú. <<< ==== Guía básica -Pulsando `Esc` o el botón 2 del joystick se muestra el menú de configuración. Se usan las teclas de cursor y `Enter` para elegir y seleccionar en el menú. +Pulsando `Esc` (`Caps Shift+Symbol Shift+Espacio` en +UNO) o el botón 2 del joystick se muestra el menú de configuración. Se usan las teclas de cursor (`Caps Shift+6` y `Caps Shift+7` en +UNO) y `Enter` para elegir y seleccionar en el menú. [.text-center] image:img/videopacuno.png[pdfwidth=70%] @@ -3832,6 +4189,119 @@ Algunos monitores dejan de reproducir la entrada de audio si se desactiva la se <<< +=== ZX81 y ZX80 + +Versión alternativa de core de ZX81 y ZX80 creada por avlixa, basada en la página de Grant Searle's sobre el ZX80 + +Características: + +- Se puede elegir entre ZX80 y ZX81 (ZX80 sólo con salida RGB por el momento) +- 16k/32k/48k RAM packs +- 8KB con addon CHR$128/UDG (sin probar) +- QS CHRS (sin probar) +- CHROMA81 +- Turbo en modo lento: NoWait, x2, x8 +- Chip de sonido YM2149 (compatible con ZON X-81) +- Múltiples joysticks (Cursor, Sinclar, ZX81, ZXpand) +- Timings PAL y NTSC +- Turbo carga de ficheros .o y .p +- Carga de ROM alternativa +- Carga de programas a través de la entrada de audio + +==== Formato de Tarjeta SD + +Se debe de utilizar una tarjeta SD, con la primera partición en formato FAT16 o FAT32, para almacenar los ficheros con archivos de cinta o ROM que se deseen cargar. + +Se puede copiar, si se desea, un fichero `ZX8X.ROM` (disponible the https://github.com/avlixa/ZX81_MiSTer_zxdos/raw/master/roms/zx8x.rom[repositorio oficial] en el directorio `/zx81/roms`: se trata de los ficheros ZX81 rom (8k) + ZX80 rom (4k) concatenados. + +Si no estuviera ya, <<#_cores,instalar el core de ZX81 y ZX80>> en el ZX-Uno. + +<<< + +==== Teclado + +El teclado no está mapeado a la distribución PS/2 estándar, y mantiene la distribución de la máquina original. Así, por ejemplo, para obtener `"` se ha de pulsar `Mayús+P` o para borrar, `Mayús+0`. + +**ZX80** + +[.text-center] +image:img/keyboardZX80.jpg[pdfwidth=80%] + +**ZX81** + +[.text-center] +image:img/keyboardZX81.jpg[pdfwidth=80%] + +===== Teclas especiales y botones + +Durante la ejecución del core: + +- `F1` (`Caps Shift+Symbol Shift+1` en +UNO): Habilitar o deshabilitar los caracteres alternativos +- `F5` (`Caps Shift+Symbol Shift+5` en +UNO) o el botón 2 del joystick para mostrar u ocultar el menú. +- `F9` (`Caps Shift+Symbol Shift+9` en +UNO): Deshabilita o habilita la salida MIC al conector de audio, porque algunos juegos generan un ruido molesto +- `F10` (`Caps Shift+Symbol Shift+0` en +UNO): Habilita o deshabilita sonido de entrada por la salida de audio, para escuchar la cinta si se carga por audio +- `Bloq. Despl.` (`Caps Shift+Symbol Shift+G` en +UNO): para cambiar entre modo de vídeo RGB y VGA +- `Ctrl+Alt+Supr` (`Caps Shift+Symbol Shift+B` en +UNO): Reset +- `Ctrl+Alt+Backspace` (`Caps Shift+Symbol Shift+B` en +UNO): Hard reset. + +<<< + +==== Guía básica + +Pulsando `F5` (`Caps Shift+Symbol Shift+5` en +UNO) o el botón 2 del joystick se muestra el menú de configuración. Se usan las teclas de cursor (`Caps Shift+5`, `Caps Shift+6`, `Caps Shift+7` y `Caps Shift+8` en +UNO, en modo de teclado `PC XT`) y `Enter` para elegir y seleccionar opciones del menú. + +[.text-center] +image:img/zx8180.jpg[pdfwidth=70%] + +En él se pueden activar, desactivar o configurar las siguientes opciones: + +- Reiniciar el core (Reset) +- Cargar un archivo de cinta (Load Tape) +- Cargar una ROM alternativa (Load ROM) +- Configurar opciones (Configuration Options) +- Salir del menú (Exit) + +<<< + +[.text-center] +image:img/zx8180_2.jpg[pdfwidth=70%] + +- Elegir el modelo de computador (Computer Model): ZX80/ZX81 +- Tamaño de RAM (Main RAM): 16K/32K +- RAM baja (Low RAM): Off/8KB +- Joystick: Cursor/Sinclair/ZX81 +- Habilitar o deshabilitar QS CHRS +- Configuración de CHR$128/UDG: 128 chars/64 chars/Disabled +- Habilitar o deshabilitar Chroma81: Disabled/Enabled +- Vídeo inverso (Inverse Video): Off/On +- Borde negro (Black Border): Off/On +- Modo de velocidad (Slow mode speed): Original/No Wait/x2 +- Frecuencia de vídeo (Video frequency): 50Hz/60Hz + +Desde BASIC, se puede cargar desde un fichero cinta, que se haya seleccionado desde el menú, con el comando `LOAD""` y pulsando `Enter`. + +[TIP] +==== +Algunos monitores dejan de reproducir la entrada de audio si se desactiva la señal de vídeo. Se recomienda conectar unos auriculares o altavoces externos para poder oir el sonido durante la carga de una cinta. +==== + +Se pueden cargar archivos `.p` con color y caracteres alternativos. + +Para que funcione el coloreado, se debe activar CHROMA81 antes de la carga. Igualmente, para los caracteres alternativos, QS CHRS debería estar activo antes de cargar. + +[TIP] +==== +Las opciones recomendadas para la mayoría de los juegos son: + +Main RAM: 16KB +Low RAM: 8KB +CHR$128: 128 chars +QS CHRS: enabled +CHROMA81: enabled +==== + +<<< + == Otro Hardware === Codificadores rotatorios @@ -3937,6 +4407,8 @@ make Si todo se ha hecho correctamente, se habrá generado el fichero `playtzx` que se puede copiar a donde se desee en el disco duro y utilizar. Se puede borrar el directorio descomprimido donde se compiló. +<<< + ==== Teléfono móvil, tableta, reproductor de sonido MP3, etc. En general, existen muy pocas alternativas (o ninguna) alternativas de programas que puedan reproducir directamente un archivo de cinta en un dispositivo móvil, así que, normalmente, será necesario convertir a un fichero de audio el contenido de la cinta antes de intentar cargarla con uno de estos aparatos. @@ -3972,6 +4444,8 @@ https://www.alessandrogrussu.it/tapir/index.html[Tapir] es un programa con inter https://sourceforge.net/projects/wav-prg/files/audiotap/2.2/[Audiotap] es un programa con interfaz gráfica para Windows (pero que se puede usar también con Wine en Linux o Mac) que permite convertir ficheros `TAP` de Commodore como `WAV` de audio. +http://retrowiki.es/viewtopic.php?f=110&t=200037282[Comodoro 2.0] es un script que permite convertir a formato `TAP` y `TZX` para poder realizar cargas por audio en las Commodore Pet, VIC-20, 16 y 64. + https://github.com/RW-FPGA-devel-Team/lynx2wav[Lynx2Wav] es un programa que permite convertir ficheros `TAP` de Camputers Lynx como `WAV` de audio. https://github.com/rcmolina/CamputersLYNX[2lynx2wav] también permite convertir ficheros `TAP` de Camputers Lynx a ficheros `WAV` de audio. @@ -4176,6 +4650,11 @@ image:img/jtagzxunoplus.jpg[pdfwidth=80%] *NO* se ha de conectar la línea de 3V ==== +[NOTE] +==== +En el caso de un +UNO, será necesario extraer la placa de ZX-Uno para realizar la recuperación. +==== + <<< ==== Recuperación usando una Raspberry Pi @@ -4333,12 +4812,34 @@ image:img/recovery2.png[pdfwidth=70%] Este proceso sustituirá todos los cores instalados, la BIOS, así como las ROMs de ZX Spectrum y la configuración por lo que haya en la imagen, y no se puede deshacer. ==== +[NOTE] +==== +Habitualmente, la imagen de recuperación está configurada para usar un teclado PS/2 y no el teclado de membrana de Spectrum, así que, en el caso de +UNO, puede que no funcionen las combinaciones como `Caps Shift + 5`, etc. En este caso, se ha de cambiar el modo de teclado a `PC XT` (`Caps Shift+Symbol Shift+U` y luego `9`), para que funcionen de nuevo temporalmente. +==== + [start=15] . Tras unos minutos, el proceso finalizará, y podremos comprobar como, al apagar y encender, el ZXUNO+ vuelve a arrancar correctamente. [NOTE] ==== -Si no se obtiene imagen, pulsar de nuevo `Bloq. Despl.`: para cambiar entre modo de video compuesto y VGA. En este caso, sería necesario acceder a la BIOS y cambiar el <<#_advanced, ajuste avanzado correspondiente>> para indicar la configuración de nuestro monitor. +Si no se obtiene imagen, pulsar de nuevo `Bloq. Despl.` (`Caps Shift+Symbol Shift+G` en +UNO) para cambiar entre modo de video compuesto y VGA. En este caso, sería necesario acceder a la BIOS y cambiar el <<#_advanced, ajuste avanzado correspondiente>> para indicar la configuración de nuestro monitor. +==== + +[NOTE] +==== +En el caso de +UNO, como la configuración de la imagen de recuperación por defecto espera un teclado PS/2, se pueden seguir los siguientes pasos para configurar la BIOS correctamente: + +. Si no hay imagen, cambiar entre modo vídeo RGB y modo VGA (`Caps Shift+Symbol Shift+G`) +. Cambiar al modo `PC XT` de teclado (`Caps Shift+Symbol Shift+U` y luego `9`) +. Reiniciar el +UNO sin que se pierda la configuración del teclado (`Caps Shift+Symbol Shift+B`) +. Rápidamente, pulsar `Caps Shift + 1` +. De nuevo, si no hay imagen, cambiar entre modo VGA y modo vídeo RGB (`Caps Shift+Symbol Shift+G`) +. Navegar por la BIOS y configurar las siguientes opciones: +- `Advanced` -> `Keyboard Layout`: `Spectrum` +- `Advanced` -> `video`: `VGA` (sólo si no teníamos imagen) +. Guardar los cambios de la BIOS: +- `Exit` -> `Save changes and exit` +.Apagar completamente el +UNO y volver a encenderlo ==== <<< @@ -4414,7 +4915,7 @@ image:img/recovery_mac_1.png[pdfwidth=90%] [start=9] . Si todo va bien, veremos cómo cambia el estado de los LED de la FPGA y veremos la imagen de la BIOS en el monitor. -En el caso de que no se vea imagen, pulsar `Bloq. Despl.` para cambiar entre modo de vídeo RGB y VGA, por si acaso la BIOS ha arrancado en un modo que no corresponde a la conexión del monitor. +En el caso de que no se vea imagen, pulsar `Bloq. Despl.` (`Caps Shift+Symbol Shift+G` en +UNO) para cambiar entre modo de vídeo RGB y VGA, por si acaso la BIOS ha arrancado en un modo que no corresponde a la conexión del monitor. [.text-center] image:img/recovery.png[pdfwidth=70%] @@ -4437,17 +4938,35 @@ image:img/recovery2.png[pdfwidth=70%] Este proceso sustituirá todos los cores instalados, la BIOS, así como las ROMs de ZX Spectrum y la configuración por lo que haya en la imagen, y no se puede deshacer. ==== -<<< +[NOTE] +==== +Habitualmente, la imagen de recuperación está configurada para usar un teclado PS/2 y no el teclado de membrana de Spectrum, así que, en el caso de +UNO, puede que no funcionen las combinaciones como `Caps Shift + 5`, etc. En este caso, se ha de cambiar el modo de teclado a `PC XT` (`Caps Shift+Symbol Shift+U` y luego `9`), para que funcionen de nuevo temporalmente. +==== [start=13] . Tras unos minutos, el proceso finalizará, y podremos comprobar como, al apagar y encender, el ZX-Uno vuelve a arrancar correctamente. [NOTE] ==== -Si no se obtiene imagen, pulsar de nuevo `Bloq. Despl.`para cambiar entre modo de vídeo RGB y VGA. En este caso, sería necesario acceder a la BIOS y cambiar el <<#_advanced, ajuste avanzado correspondiente>> para indicar la configuración de nuestro monitor. +Si no se obtiene imagen, pulsar de nuevo `Bloq. Despl.` (`Caps Shift+Symbol Shift+G` en +UNO) para cambiar entre modo de video compuesto y VGA. En este caso, sería necesario acceder a la BIOS y cambiar el <<#_advanced, ajuste avanzado correspondiente>> para indicar la configuración de nuestro monitor. ==== +[NOTE] +==== +En el caso de +UNO, como la configuración de la imagen de recuperación por defecto espera un teclado PS/2, se pueden seguir los siguientes pasos para configurar la BIOS correctamente: +. Si no hay imagen, cambiar entre modo vídeo RGB y modo VGA (`Caps Shift+Symbol Shift+G`) +. Cambiar al modo `PC XT` de teclado (`Caps Shift+Symbol Shift+U` y luego `9`) +. Reiniciar el +UNO sin que se pierda la configuración del teclado (`Caps Shift+Symbol Shift+B`) +. Rápidamente, pulsar `Caps Shift + 1` +. De nuevo, si no hay imagen, cambiar entre modo VGA y modo vídeo RGB (`Caps Shift+Symbol Shift+G`) +. Navegar por la BIOS y configurar las siguientes opciones: +- `Advanced` -> `Keyboard Layout`: `Spectrum` +- `Advanced` -> `video`: `VGA` (sólo si no teníamos imagen) +. Guardar los cambios de la BIOS: +- `Exit` -> `Save changes and exit` +.Apagar completamente el +UNO y volver a encenderlo +==== [NOTE] ==== @@ -4499,7 +5018,7 @@ pld load recovery.bit [start=9] . Si todo va bien, veremos cómo cambia el estado de los LED de la FPGA y veremos la imagen de la BIOS en el monitor. -En el caso de que no se vea imagen, pulsar `Bloq. Despl.` para cambiar entre modo de vídeo RGB y VGA, por si acaso la BIOS ha arrancado en un modo que no corresponde a la conexión del monitor. +En el caso de que no se vea imagen, pulsar `Bloq. Despl.` (`Caps Shift+Symbol Shift+G` en +UNO) para cambiar entre modo de vídeo RGB y VGA, por si acaso la BIOS ha arrancado en un modo que no corresponde a la conexión del monitor. [.text-center] image:img/recovery.png[pdfwidth=70%] @@ -4522,6 +5041,10 @@ image:img/recovery2.png[pdfwidth=70%] Este proceso sustituirá todos los cores instalados, la BIOS, así como las ROMs de ZX Spectrum y la configuración por lo que haya en la imagen, y no se puede deshacer. ==== +[NOTE] +==== +Habitualmente, la imagen de recuperación está configurada para usar un teclado PS/2 y no el teclado de membrana de Spectrum, así que, en el caso de +UNO, puede que no funcionen las combinaciones como `Caps Shift + 5`, etc. En este caso, se ha de cambiar el modo de teclado a `PC XT` (`Caps Shift+Symbol Shift+U` y luego `9`), para que funcionen de nuevo temporalmente. +==== <<< @@ -4530,13 +5053,34 @@ Este proceso sustituirá todos los cores instalados, la BIOS, así como las ROMs [NOTE] ==== -Si no se obtiene imagen, pulsar de nuevo `Bloq. Despl.`para cambiar entre modo de vídeo RGB y VGA. En este caso, sería necesario acceder a la BIOS y cambiar el <<#_advanced, ajuste avanzado correspondiente>> para indicar la configuración de nuestro monitor. +En el caso de +UNO, como la configuración de la imagen de recuperación por defecto espera un teclado PS/2, se pueden seguir los siguientes pasos para configurar la BIOS correctamente: + +. Si no hay imagen, cambiar entre modo vídeo RGB y modo VGA (`Caps Shift+Symbol Shift+G`) +. Cambiar al modo `PC XT` de teclado (`Caps Shift+Symbol Shift+U` y luego `9`) +. Reiniciar el +UNO sin que se pierda la configuración del teclado (`Caps Shift+Symbol Shift+B`) +. Rápidamente, pulsar `Caps Shift + 1` +. De nuevo, si no hay imagen, cambiar entre modo VGA y modo vídeo RGB (`Caps Shift+Symbol Shift+G`) +. Navegar por la BIOS y configurar las siguientes opciones: +- `Advanced` -> `Keyboard Layout`: `Spectrum` +- `Advanced` -> `video`: `VGA` (sólo si no teníamos imagen) +. Guardar los cambios de la BIOS: +- `Exit` -> `Save changes and exit` +.Apagar completamente el +UNO y volver a encenderlo ==== <<< == Referencias +=== Scan Codes + +[.text-center] +image:img/scancodes.png[pdfwidth=80%] + +<<< + +=== Enlaces + https://zxuno.speccy.org/index.shtml[ZX-Uno] http://desubikado.sytes.net/zx-uno-faq-version-desubikado/[ZX-Uno FAQ] @@ -4555,6 +5099,8 @@ https://www.zxuno.com/forum/viewtopic.php?f=37&t=208[Configuración de teclado d https://docs.google.com/spreadsheets/d/17-ifpHcy932_AP7SAv9uBLxg-2ZptcdgTvQ8ILXQLM4/htmlview[Almost (In-) Complete List of esxDOS DOT-Commands] +http://www.benophetinternet.nl/hobby/vanmezelf/ESXDOS%20manual.pdf[ESXDOS Manual] + https://www.va-de-retro.com/foros/viewtopic.php?t=1718&start=10#p25076[Cargando Leches 2.0] https://vintageisthenewold.com/se-basic-iv-updated/[SE Basic IV updated] diff --git a/doc/img/MiniduinoBack.jpg b/doc/src/img/MiniduinoBack.jpg similarity index 100% rename from doc/img/MiniduinoBack.jpg rename to doc/src/img/MiniduinoBack.jpg diff --git a/doc/img/MiniduinoFront.jpg b/doc/src/img/MiniduinoFront.jpg similarity index 100% rename from doc/img/MiniduinoFront.jpg rename to doc/src/img/MiniduinoFront.jpg diff --git a/doc/img/MiniduinoLogo.jpg b/doc/src/img/MiniduinoLogo.jpg similarity index 100% rename from doc/img/MiniduinoLogo.jpg rename to doc/src/img/MiniduinoLogo.jpg diff --git a/doc/img/MiniduinoPlay.jpg b/doc/src/img/MiniduinoPlay.jpg similarity index 100% rename from doc/img/MiniduinoPlay.jpg rename to doc/src/img/MiniduinoPlay.jpg diff --git a/doc/img/MiniduinoVersion.jpg b/doc/src/img/MiniduinoVersion.jpg similarity index 100% rename from doc/img/MiniduinoVersion.jpg rename to doc/src/img/MiniduinoVersion.jpg diff --git a/doc/img/Portada.jpg b/doc/src/img/Portada.jpg similarity index 100% rename from doc/img/Portada.jpg rename to doc/src/img/Portada.jpg diff --git a/doc/src/img/ScanCodes.png b/doc/src/img/ScanCodes.png new file mode 100644 index 0000000..806d734 Binary files /dev/null and b/doc/src/img/ScanCodes.png differ diff --git a/doc/img/ZXDOSback.jpg b/doc/src/img/ZXDOSback.jpg similarity index 100% rename from doc/img/ZXDOSback.jpg rename to doc/src/img/ZXDOSback.jpg diff --git a/doc/img/ZXDOSfront.jpg b/doc/src/img/ZXDOSfront.jpg similarity index 100% rename from doc/img/ZXDOSfront.jpg rename to doc/src/img/ZXDOSfront.jpg diff --git a/doc/img/a2600.jpg b/doc/src/img/a2600.jpg similarity index 100% rename from doc/img/a2600.jpg rename to doc/src/img/a2600.jpg diff --git a/doc/img/a2600uno.jpg b/doc/src/img/a2600uno.jpg similarity index 100% rename from doc/img/a2600uno.jpg rename to doc/src/img/a2600uno.jpg diff --git a/doc/img/a800xl.jpg b/doc/src/img/a800xl.jpg similarity index 100% rename from doc/img/a800xl.jpg rename to doc/src/img/a800xl.jpg diff --git a/doc/img/ace_vlist.png b/doc/src/img/ace_vlist.png similarity index 100% rename from doc/img/ace_vlist.png rename to doc/src/img/ace_vlist.png diff --git a/doc/img/acorn.jpg b/doc/src/img/acorn.jpg similarity index 100% rename from doc/img/acorn.jpg rename to doc/src/img/acorn.jpg diff --git a/doc/img/apple1_1.png b/doc/src/img/apple1_1.png similarity index 100% rename from doc/img/apple1_1.png rename to doc/src/img/apple1_1.png diff --git a/doc/img/apple1_2.png b/doc/src/img/apple1_2.png similarity index 100% rename from doc/img/apple1_2.png rename to doc/src/img/apple1_2.png diff --git a/doc/img/atom.png b/doc/src/img/atom.png similarity index 100% rename from doc/img/atom.png rename to doc/src/img/atom.png diff --git a/doc/img/bbcmicro.png b/doc/src/img/bbcmicro.png similarity index 100% rename from doc/img/bbcmicro.png rename to doc/src/img/bbcmicro.png diff --git a/doc/img/bios.png b/doc/src/img/bios.png similarity index 100% rename from doc/img/bios.png rename to doc/src/img/bios.png diff --git a/doc/img/bios2.png b/doc/src/img/bios2.png similarity index 100% rename from doc/img/bios2.png rename to doc/src/img/bios2.png diff --git a/doc/img/bios3.png b/doc/src/img/bios3.png similarity index 100% rename from doc/img/bios3.png rename to doc/src/img/bios3.png diff --git a/doc/img/bios4.png b/doc/src/img/bios4.png similarity index 100% rename from doc/img/bios4.png rename to doc/src/img/bios4.png diff --git a/doc/src/img/bios5.png b/doc/src/img/bios5.png new file mode 100644 index 0000000..4f5743b Binary files /dev/null and b/doc/src/img/bios5.png differ diff --git a/doc/img/bios6.png b/doc/src/img/bios6.png similarity index 100% rename from doc/img/bios6.png rename to doc/src/img/bios6.png diff --git a/doc/img/boot.png b/doc/src/img/boot.png similarity index 100% rename from doc/img/boot.png rename to doc/src/img/boot.png diff --git a/doc/img/c16.png b/doc/src/img/c16.png similarity index 100% rename from doc/img/c16.png rename to doc/src/img/c16.png diff --git a/doc/img/c64.jpg b/doc/src/img/c64.jpg similarity index 100% rename from doc/img/c64.jpg rename to doc/src/img/c64.jpg diff --git a/doc/img/c64.png b/doc/src/img/c64.png similarity index 100% rename from doc/img/c64.png rename to doc/src/img/c64.png diff --git a/doc/img/cgenie.png b/doc/src/img/cgenie.png similarity index 100% rename from doc/img/cgenie.png rename to doc/src/img/cgenie.png diff --git a/doc/img/cgenieload.png b/doc/src/img/cgenieload.png similarity index 100% rename from doc/img/cgenieload.png rename to doc/src/img/cgenieload.png diff --git a/doc/img/chip8.jpg b/doc/src/img/chip8.jpg similarity index 100% rename from doc/img/chip8.jpg rename to doc/src/img/chip8.jpg diff --git a/doc/img/chip8uno.jpg b/doc/src/img/chip8uno.jpg similarity index 100% rename from doc/img/chip8uno.jpg rename to doc/src/img/chip8uno.jpg diff --git a/doc/img/coleco.jpg b/doc/src/img/coleco.jpg similarity index 100% rename from doc/img/coleco.jpg rename to doc/src/img/coleco.jpg diff --git a/doc/img/colecouno.jpg b/doc/src/img/colecouno.jpg similarity index 100% rename from doc/img/colecouno.jpg rename to doc/src/img/colecouno.jpg diff --git a/doc/img/cpc.png b/doc/src/img/cpc.png similarity index 100% rename from doc/img/cpc.png rename to doc/src/img/cpc.png diff --git a/doc/img/cpc2.png b/doc/src/img/cpc2.png similarity index 100% rename from doc/img/cpc2.png rename to doc/src/img/cpc2.png diff --git a/doc/img/cpc464.png b/doc/src/img/cpc464.png similarity index 100% rename from doc/img/cpc464.png rename to doc/src/img/cpc464.png diff --git a/doc/img/db9joy.png b/doc/src/img/db9joy.png similarity index 100% rename from doc/img/db9joy.png rename to doc/src/img/db9joy.png diff --git a/doc/img/electron.png b/doc/src/img/electron.png similarity index 100% rename from doc/img/electron.png rename to doc/src/img/electron.png diff --git a/doc/img/esxdos.png b/doc/src/img/esxdos.png similarity index 100% rename from doc/img/esxdos.png rename to doc/src/img/esxdos.png diff --git a/doc/img/fuzix01.png b/doc/src/img/fuzix01.png similarity index 100% rename from doc/img/fuzix01.png rename to doc/src/img/fuzix01.png diff --git a/doc/img/fuzix02.png b/doc/src/img/fuzix02.png similarity index 100% rename from doc/img/fuzix02.png rename to doc/src/img/fuzix02.png diff --git a/doc/img/fuzix03.png b/doc/src/img/fuzix03.png similarity index 100% rename from doc/img/fuzix03.png rename to doc/src/img/fuzix03.png diff --git a/doc/img/fuzix04.png b/doc/src/img/fuzix04.png similarity index 100% rename from doc/img/fuzix04.png rename to doc/src/img/fuzix04.png diff --git a/doc/img/fuzix05.png b/doc/src/img/fuzix05.png similarity index 100% rename from doc/img/fuzix05.png rename to doc/src/img/fuzix05.png diff --git a/doc/img/galaksija.png b/doc/src/img/galaksija.png similarity index 100% rename from doc/img/galaksija.png rename to doc/src/img/galaksija.png diff --git a/doc/img/gomaDosBack.jpg b/doc/src/img/gomaDosBack.jpg similarity index 100% rename from doc/img/gomaDosBack.jpg rename to doc/src/img/gomaDosBack.jpg diff --git a/doc/img/gpio.jpg b/doc/src/img/gpio.jpg similarity index 100% rename from doc/img/gpio.jpg rename to doc/src/img/gpio.jpg diff --git a/doc/img/ht1080z.png b/doc/src/img/ht1080z.png similarity index 100% rename from doc/img/ht1080z.png rename to doc/src/img/ht1080z.png diff --git a/doc/img/ht1080z_2.png b/doc/src/img/ht1080z_2.png similarity index 100% rename from doc/img/ht1080z_2.png rename to doc/src/img/ht1080z_2.png diff --git a/doc/img/jtag.jpg b/doc/src/img/jtag.jpg similarity index 100% rename from doc/img/jtag.jpg rename to doc/src/img/jtag.jpg diff --git a/doc/img/jtag02.jpg b/doc/src/img/jtag02.jpg similarity index 100% rename from doc/img/jtag02.jpg rename to doc/src/img/jtag02.jpg diff --git a/doc/img/jtag03.jpg b/doc/src/img/jtag03.jpg similarity index 100% rename from doc/img/jtag03.jpg rename to doc/src/img/jtag03.jpg diff --git a/doc/img/jtag04.jpg b/doc/src/img/jtag04.jpg similarity index 100% rename from doc/img/jtag04.jpg rename to doc/src/img/jtag04.jpg diff --git a/doc/img/jtaggomados.jpg b/doc/src/img/jtaggomados.jpg similarity index 100% rename from doc/img/jtaggomados.jpg rename to doc/src/img/jtaggomados.jpg diff --git a/doc/img/jtagzxunoplus.jpg b/doc/src/img/jtagzxunoplus.jpg similarity index 100% rename from doc/img/jtagzxunoplus.jpg rename to doc/src/img/jtagzxunoplus.jpg diff --git a/doc/img/keyboardAtom.jpg b/doc/src/img/keyboardAtom.jpg similarity index 100% rename from doc/img/keyboardAtom.jpg rename to doc/src/img/keyboardAtom.jpg diff --git a/doc/img/keyboardAv.png b/doc/src/img/keyboardAv.png similarity index 100% rename from doc/img/keyboardAv.png rename to doc/src/img/keyboardAv.png diff --git a/doc/img/keyboardEng.png b/doc/src/img/keyboardEng.png similarity index 100% rename from doc/img/keyboardEng.png rename to doc/src/img/keyboardEng.png diff --git a/doc/img/keyboardEsp.png b/doc/src/img/keyboardEsp.png similarity index 100% rename from doc/img/keyboardEsp.png rename to doc/src/img/keyboardEsp.png diff --git a/doc/img/keyboardZX80.jpg b/doc/src/img/keyboardZX80.jpg similarity index 100% rename from doc/img/keyboardZX80.jpg rename to doc/src/img/keyboardZX80.jpg diff --git a/doc/img/keyboardZX81.jpg b/doc/src/img/keyboardZX81.jpg similarity index 100% rename from doc/img/keyboardZX81.jpg rename to doc/src/img/keyboardZX81.jpg diff --git a/doc/img/keyboardbbc.png b/doc/src/img/keyboardbbc.png similarity index 100% rename from doc/img/keyboardbbc.png rename to doc/src/img/keyboardbbc.png diff --git a/doc/img/keyboardoric.png b/doc/src/img/keyboardoric.png similarity index 100% rename from doc/img/keyboardoric.png rename to doc/src/img/keyboardoric.png diff --git a/doc/img/lynx.png b/doc/src/img/lynx.png similarity index 100% rename from doc/img/lynx.png rename to doc/src/img/lynx.png diff --git a/doc/img/msx.png b/doc/src/img/msx.png similarity index 100% rename from doc/img/msx.png rename to doc/src/img/msx.png diff --git a/doc/img/mz700load.png b/doc/src/img/mz700load.png similarity index 100% rename from doc/img/mz700load.png rename to doc/src/img/mz700load.png diff --git a/doc/img/mz700puente.jpg b/doc/src/img/mz700puente.jpg similarity index 100% rename from doc/img/mz700puente.jpg rename to doc/src/img/mz700puente.jpg diff --git a/doc/img/nes.jpg b/doc/src/img/nes.jpg similarity index 100% rename from doc/img/nes.jpg rename to doc/src/img/nes.jpg diff --git a/doc/img/nesuno.jpg b/doc/src/img/nesuno.jpg similarity index 100% rename from doc/img/nesuno.jpg rename to doc/src/img/nesuno.jpg diff --git a/doc/img/next.png b/doc/src/img/next.png similarity index 100% rename from doc/img/next.png rename to doc/src/img/next.png diff --git a/doc/img/next2.png b/doc/src/img/next2.png similarity index 100% rename from doc/img/next2.png rename to doc/src/img/next2.png diff --git a/doc/img/next3.png b/doc/src/img/next3.png similarity index 100% rename from doc/img/next3.png rename to doc/src/img/next3.png diff --git a/doc/img/oric.png b/doc/src/img/oric.png similarity index 100% rename from doc/img/oric.png rename to doc/src/img/oric.png diff --git a/doc/img/pcxt.png b/doc/src/img/pcxt.png similarity index 100% rename from doc/img/pcxt.png rename to doc/src/img/pcxt.png diff --git a/doc/img/pet.jpg b/doc/src/img/pet.jpg similarity index 100% rename from doc/img/pet.jpg rename to doc/src/img/pet.jpg diff --git a/doc/img/phoenix.png b/doc/src/img/phoenix.png similarity index 100% rename from doc/img/phoenix.png rename to doc/src/img/phoenix.png diff --git a/doc/img/pi_no.jpg b/doc/src/img/pi_no.jpg similarity index 100% rename from doc/img/pi_no.jpg rename to doc/src/img/pi_no.jpg diff --git a/doc/img/pi_no_back.jpg b/doc/src/img/pi_no_back.jpg similarity index 100% rename from doc/img/pi_no_back.jpg rename to doc/src/img/pi_no_back.jpg diff --git a/doc/img/pizero.jpg b/doc/src/img/pizero.jpg similarity index 100% rename from doc/img/pizero.jpg rename to doc/src/img/pizero.jpg diff --git a/doc/img/pizeroaddon.jpg b/doc/src/img/pizeroaddon.jpg similarity index 100% rename from doc/img/pizeroaddon.jpg rename to doc/src/img/pizeroaddon.jpg diff --git a/doc/img/pizeroback.jpg b/doc/src/img/pizeroback.jpg similarity index 100% rename from doc/img/pizeroback.jpg rename to doc/src/img/pizeroback.jpg diff --git a/doc/src/img/plusuno_frontal.jpg b/doc/src/img/plusuno_frontal.jpg new file mode 100644 index 0000000..169fc01 Binary files /dev/null and b/doc/src/img/plusuno_frontal.jpg differ diff --git a/doc/src/img/plusuno_switch.jpg b/doc/src/img/plusuno_switch.jpg new file mode 100644 index 0000000..c45212c Binary files /dev/null and b/doc/src/img/plusuno_switch.jpg differ diff --git a/doc/src/img/plusuno_trasera.jpg b/doc/src/img/plusuno_trasera.jpg new file mode 100644 index 0000000..7a8f911 Binary files /dev/null and b/doc/src/img/plusuno_trasera.jpg differ diff --git a/doc/img/pong.jpg b/doc/src/img/pong.jpg similarity index 100% rename from doc/img/pong.jpg rename to doc/src/img/pong.jpg diff --git a/doc/img/ponguno.jpg b/doc/src/img/ponguno.jpg similarity index 100% rename from doc/img/ponguno.jpg rename to doc/src/img/ponguno.jpg diff --git a/doc/img/portadaminiduino.jpg b/doc/src/img/portadaminiduino.jpg similarity index 100% rename from doc/img/portadaminiduino.jpg rename to doc/src/img/portadaminiduino.jpg diff --git a/doc/src/img/portadauno.jpg b/doc/src/img/portadauno.jpg new file mode 100644 index 0000000..f42f63c Binary files /dev/null and b/doc/src/img/portadauno.jpg differ diff --git a/doc/img/recovery.png b/doc/src/img/recovery.png similarity index 100% rename from doc/img/recovery.png rename to doc/src/img/recovery.png diff --git a/doc/img/recovery2.png b/doc/src/img/recovery2.png similarity index 100% rename from doc/img/recovery2.png rename to doc/src/img/recovery2.png diff --git a/doc/img/recovery_mac_1.png b/doc/src/img/recovery_mac_1.png similarity index 100% rename from doc/img/recovery_mac_1.png rename to doc/src/img/recovery_mac_1.png diff --git a/doc/img/rj45pinout.png b/doc/src/img/rj45pinout.png similarity index 100% rename from doc/img/rj45pinout.png rename to doc/src/img/rj45pinout.png diff --git a/doc/img/rj45scart.png b/doc/src/img/rj45scart.png similarity index 100% rename from doc/img/rj45scart.png rename to doc/src/img/rj45scart.png diff --git a/doc/img/samcoupe.png b/doc/src/img/samcoupe.png similarity index 100% rename from doc/img/samcoupe.png rename to doc/src/img/samcoupe.png diff --git a/doc/img/sms.png b/doc/src/img/sms.png similarity index 100% rename from doc/img/sms.png rename to doc/src/img/sms.png diff --git a/doc/img/tbblue1.jpg b/doc/src/img/tbblue1.jpg similarity index 100% rename from doc/img/tbblue1.jpg rename to doc/src/img/tbblue1.jpg diff --git a/doc/img/tbblue2.jpg b/doc/src/img/tbblue2.jpg similarity index 100% rename from doc/img/tbblue2.jpg rename to doc/src/img/tbblue2.jpg diff --git a/doc/img/teclado.png b/doc/src/img/teclado.png similarity index 100% rename from doc/img/teclado.png rename to doc/src/img/teclado.png diff --git a/doc/img/terminex.png b/doc/src/img/terminex.png similarity index 100% rename from doc/img/terminex.png rename to doc/src/img/terminex.png diff --git a/doc/img/usbasp.jpg b/doc/src/img/usbasp.jpg similarity index 100% rename from doc/img/usbasp.jpg rename to doc/src/img/usbasp.jpg diff --git a/doc/img/usbasp_2.jpg b/doc/src/img/usbasp_2.jpg similarity index 100% rename from doc/img/usbasp_2.jpg rename to doc/src/img/usbasp_2.jpg diff --git a/doc/img/vectrex.png b/doc/src/img/vectrex.png similarity index 100% rename from doc/img/vectrex.png rename to doc/src/img/vectrex.png diff --git a/doc/img/vic20.png b/doc/src/img/vic20.png similarity index 100% rename from doc/img/vic20.png rename to doc/src/img/vic20.png diff --git a/doc/img/videopac.jpg b/doc/src/img/videopac.jpg similarity index 100% rename from doc/img/videopac.jpg rename to doc/src/img/videopac.jpg diff --git a/doc/img/videopacuno.png b/doc/src/img/videopacuno.png similarity index 100% rename from doc/img/videopacuno.png rename to doc/src/img/videopacuno.png diff --git a/doc/img/zx81.jpg b/doc/src/img/zx81.jpg similarity index 100% rename from doc/img/zx81.jpg rename to doc/src/img/zx81.jpg diff --git a/doc/src/img/zx8180.jpg b/doc/src/img/zx8180.jpg new file mode 100644 index 0000000..45fc0eb Binary files /dev/null and b/doc/src/img/zx8180.jpg differ diff --git a/doc/src/img/zx8180_2.jpg b/doc/src/img/zx8180_2.jpg new file mode 100644 index 0000000..4129a45 Binary files /dev/null and b/doc/src/img/zx8180_2.jpg differ diff --git a/doc/img/zx81_2.jpg b/doc/src/img/zx81_2.jpg similarity index 100% rename from doc/img/zx81_2.jpg rename to doc/src/img/zx81_2.jpg diff --git a/doc/img/zxunoback.png b/doc/src/img/zxunoback.png similarity index 100% rename from doc/img/zxunoback.png rename to doc/src/img/zxunoback.png diff --git a/doc/img/zxunoboard.png b/doc/src/img/zxunoboard.png similarity index 100% rename from doc/img/zxunoboard.png rename to doc/src/img/zxunoboard.png diff --git a/doc/img/zxunofront.png b/doc/src/img/zxunofront.png similarity index 100% rename from doc/img/zxunofront.png rename to doc/src/img/zxunofront.png diff --git a/doc/miniduino_en.adoc b/doc/src/miniduino_en.adoc similarity index 100% rename from doc/miniduino_en.adoc rename to doc/src/miniduino_en.adoc diff --git a/doc/miniduino_es.adoc b/doc/src/miniduino_es.adoc similarity index 100% rename from doc/miniduino_es.adoc rename to doc/src/miniduino_es.adoc diff --git a/doc/style.yml b/doc/src/style.yml similarity index 100% rename from doc/style.yml rename to doc/src/style.yml