summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorIan C <ianc@noddybox.co.uk>2006-11-06 00:11:18 +0000
committerIan C <ianc@noddybox.co.uk>2006-11-06 00:11:18 +0000
commit013bd92377b40c64065e4bb231d4ddaa84c3165e (patch)
tree546ba731cbb7495b4d220901caf31af954d103b5
parent6f8c3d4fafc8e301e89137d80ad85e4e1314bd56 (diff)
Added instructions
-rw-r--r--arm9/instructions.txt155
-rw-r--r--instructions.txt155
2 files changed, 310 insertions, 0 deletions
diff --git a/arm9/instructions.txt b/arm9/instructions.txt
new file mode 100644
index 0000000..c0d81d2
--- /dev/null
+++ b/arm9/instructions.txt
@@ -0,0 +1,155 @@
+ DS81
+ ---------==============================---------
+
+ Copyright 2006 Ian Cowburn
+ ianc@noddybox.co.uk
+
+
+1. LICENSE
+----------
+
+ The code to DS81 is released under the GNU General Public License. See
+ the text file COPYING for details.
+
+ Other included software is provided in good faith, is not released under
+ the GNU General Public License, and is copyright their respective authors.
+ If any of these authors disagree with the distribution of their work then
+ contact me and it will be gladly removed.
+
+ ZX81 BASIC ROM (c) 1981 Nine Tiles Networks LTD
+ 3D Monster Maze (c) 1983 Malcom E. Evans
+ Mazogs, City Patrol and Sabotage (c) 1981, 1982 Don Priestley
+
+
+2. ZX81
+-------
+
+ The ZX81 was an 8-bit computer released by Sinclair Research in 1981, using
+ the Z80 CPU.
+
+ It was a monochrome machine with no sound (be quiet those at the back of
+ the room who used to be able to do sound by doing odd things with the video
+ signal) and a text mode that could be used to plot graphics at a resolution
+ of 64 by 44 (hmmm, smaller than most icons nowadays).
+
+ It came with 1K of RAM, though most people opted for a massive 16K RAM pack.
+
+
+2. DS81
+-------
+
+ DS81 is an emulation of the 16K ZX81 and is is supplied in two main forms,
+ as a native Nintendo DS executable and a version with a Gameboy Advance
+ wrapper (in case your Ninentdo DS homebrew device only supports running
+ GBA executables).
+
+ In addition to this two different versions are supplied, one which
+ initialises the FAT library and one which doesn't. They are identical save
+ for this, and separate ones are supplied in case the FAT library
+ initialisation causes problem on your homebrew device:
+
+ ds81.nds - Nintendo DS version
+ ds81.bs.gba - As above with a GBA wrapper.
+
+ ds81-nofat.nds - Nintendo DS version; no FAT library initialisation.
+ ds81-nofat.bs.gba - As above with a GBA wrapper.
+
+ I'm probably being overly paranoid there, but better safe than sorry.
+
+
+3. Using DS81
+-------------
+
+ When run DS81 displays a splash screen with copyright information and
+ whether the FAT library has been able to find a supported device for the
+ loading of external tapes.
+
+ Once the A button has been pressed the ZX81 resets and displays itself
+ on the top screen, and a soft keyboard is displayed on the bottom, touch
+ sensitive, DS screen.
+
+ If you've never used a ZX81 before then you may wish to find out how the
+ keyboard works -- it uses a keyword entry system, rather than the straight
+ typing if commands. So, for instance, the key P is pressed to enter PRINT
+ when the cursor is in keyword mode (the cursor in an inverted K).
+
+ Trust me; you were glad of it when using the original ZX81's hard plastic
+ membrane keyboard.
+
+ When using the soft keyboard by default the shift key is 'sticky' and once
+ used will stay held down until pressed again.
+
+ The World of Spectrum has the original ZX81 manuals, either as a PDF
+ or in HTML form:
+
+ http://www.worldofspectrum.org/
+
+ At the bottom of the keyboard is an area where you can click to bring up a
+ menu. Either use the stylus, or the joypad and button A to select an
+ option from the following choices:
+
+ RESET ZX81
+ This resets the emulated ZX81.
+
+ SELECT TAPE
+ Selects the built-in tape to use (DS81 has a number of ZX81 tapes
+ built into it). The next section has extra information on the
+ loading of games.
+
+ STICK SHIFT ON
+ Sets the shift key so it stays down until pressed again.
+
+ STICK SHIFT OFF
+ Sets the shift key so it behaves likes all the other keys.
+
+ MAP JOYPAD TO KEYS
+ Allows you to redefine the DS's joypad and buttons to ZX81 keys.
+ Follow the on-screen instructions.
+
+ CANCEL
+ Cancels the menu.
+
+
+
+3. Using the internal tapes on DS81
+-----------------------------------
+
+ Games on the ZX81 were supplied on cassette. DS81 includes a few tape
+ files that are selectable from the menu. Follow the on-screen instructions
+ to select the game. A quick description and the controls to use are
+ displayed on the top screen.
+
+ Once you've selected a tape you can load it in the emulator by using the
+ command LOAD "". If you're really stuck with the ZX81 keyboard:
+
+ 1. Select your tape.
+ 2. Reset the ZX81 from the menu.
+ 3. When the inverse K cursor is displayed press the J key to generate
+ the keyword LOAD.
+ 4. Press the SHIFT key.
+ 5. Press the P key twice to enter the double quotes (DON'T use the
+ double quotes got by pressing SHIFT+Q. These are not the same!)
+ 6. Release the SHIFT key and press the NEW LINE key.
+ 7. The tape will load and run.
+
+
+3. Using external tapes on DS81
+-------------------------------
+
+ If you are using the version of DS81 that allows the use of FAT devices,
+ and you device is supported, they you can load any old tape.
+
+ Simply place the .P file (ZX81 games are usually distributed as .P files
+ that are simply an image of the memory that would have been dumped to tape)
+ and either put it in the root directory of the FAT device or in a directory
+ called ZX81SNAP.
+
+ Note that currently hi-resolution games will not work. For that matter,
+ it can't be at all guaranteed that all original ZX81 games will work as
+ expected. After all, DS81 isn't really a ZX81.
+
+
+-------------------------------------------------------------------------------
+$Id$
+
+ vim:expandtab:spell
diff --git a/instructions.txt b/instructions.txt
new file mode 100644
index 0000000..c0d81d2
--- /dev/null
+++ b/instructions.txt
@@ -0,0 +1,155 @@
+ DS81
+ ---------==============================---------
+
+ Copyright 2006 Ian Cowburn
+ ianc@noddybox.co.uk
+
+
+1. LICENSE
+----------
+
+ The code to DS81 is released under the GNU General Public License. See
+ the text file COPYING for details.
+
+ Other included software is provided in good faith, is not released under
+ the GNU General Public License, and is copyright their respective authors.
+ If any of these authors disagree with the distribution of their work then
+ contact me and it will be gladly removed.
+
+ ZX81 BASIC ROM (c) 1981 Nine Tiles Networks LTD
+ 3D Monster Maze (c) 1983 Malcom E. Evans
+ Mazogs, City Patrol and Sabotage (c) 1981, 1982 Don Priestley
+
+
+2. ZX81
+-------
+
+ The ZX81 was an 8-bit computer released by Sinclair Research in 1981, using
+ the Z80 CPU.
+
+ It was a monochrome machine with no sound (be quiet those at the back of
+ the room who used to be able to do sound by doing odd things with the video
+ signal) and a text mode that could be used to plot graphics at a resolution
+ of 64 by 44 (hmmm, smaller than most icons nowadays).
+
+ It came with 1K of RAM, though most people opted for a massive 16K RAM pack.
+
+
+2. DS81
+-------
+
+ DS81 is an emulation of the 16K ZX81 and is is supplied in two main forms,
+ as a native Nintendo DS executable and a version with a Gameboy Advance
+ wrapper (in case your Ninentdo DS homebrew device only supports running
+ GBA executables).
+
+ In addition to this two different versions are supplied, one which
+ initialises the FAT library and one which doesn't. They are identical save
+ for this, and separate ones are supplied in case the FAT library
+ initialisation causes problem on your homebrew device:
+
+ ds81.nds - Nintendo DS version
+ ds81.bs.gba - As above with a GBA wrapper.
+
+ ds81-nofat.nds - Nintendo DS version; no FAT library initialisation.
+ ds81-nofat.bs.gba - As above with a GBA wrapper.
+
+ I'm probably being overly paranoid there, but better safe than sorry.
+
+
+3. Using DS81
+-------------
+
+ When run DS81 displays a splash screen with copyright information and
+ whether the FAT library has been able to find a supported device for the
+ loading of external tapes.
+
+ Once the A button has been pressed the ZX81 resets and displays itself
+ on the top screen, and a soft keyboard is displayed on the bottom, touch
+ sensitive, DS screen.
+
+ If you've never used a ZX81 before then you may wish to find out how the
+ keyboard works -- it uses a keyword entry system, rather than the straight
+ typing if commands. So, for instance, the key P is pressed to enter PRINT
+ when the cursor is in keyword mode (the cursor in an inverted K).
+
+ Trust me; you were glad of it when using the original ZX81's hard plastic
+ membrane keyboard.
+
+ When using the soft keyboard by default the shift key is 'sticky' and once
+ used will stay held down until pressed again.
+
+ The World of Spectrum has the original ZX81 manuals, either as a PDF
+ or in HTML form:
+
+ http://www.worldofspectrum.org/
+
+ At the bottom of the keyboard is an area where you can click to bring up a
+ menu. Either use the stylus, or the joypad and button A to select an
+ option from the following choices:
+
+ RESET ZX81
+ This resets the emulated ZX81.
+
+ SELECT TAPE
+ Selects the built-in tape to use (DS81 has a number of ZX81 tapes
+ built into it). The next section has extra information on the
+ loading of games.
+
+ STICK SHIFT ON
+ Sets the shift key so it stays down until pressed again.
+
+ STICK SHIFT OFF
+ Sets the shift key so it behaves likes all the other keys.
+
+ MAP JOYPAD TO KEYS
+ Allows you to redefine the DS's joypad and buttons to ZX81 keys.
+ Follow the on-screen instructions.
+
+ CANCEL
+ Cancels the menu.
+
+
+
+3. Using the internal tapes on DS81
+-----------------------------------
+
+ Games on the ZX81 were supplied on cassette. DS81 includes a few tape
+ files that are selectable from the menu. Follow the on-screen instructions
+ to select the game. A quick description and the controls to use are
+ displayed on the top screen.
+
+ Once you've selected a tape you can load it in the emulator by using the
+ command LOAD "". If you're really stuck with the ZX81 keyboard:
+
+ 1. Select your tape.
+ 2. Reset the ZX81 from the menu.
+ 3. When the inverse K cursor is displayed press the J key to generate
+ the keyword LOAD.
+ 4. Press the SHIFT key.
+ 5. Press the P key twice to enter the double quotes (DON'T use the
+ double quotes got by pressing SHIFT+Q. These are not the same!)
+ 6. Release the SHIFT key and press the NEW LINE key.
+ 7. The tape will load and run.
+
+
+3. Using external tapes on DS81
+-------------------------------
+
+ If you are using the version of DS81 that allows the use of FAT devices,
+ and you device is supported, they you can load any old tape.
+
+ Simply place the .P file (ZX81 games are usually distributed as .P files
+ that are simply an image of the memory that would have been dumped to tape)
+ and either put it in the root directory of the FAT device or in a directory
+ called ZX81SNAP.
+
+ Note that currently hi-resolution games will not work. For that matter,
+ it can't be at all guaranteed that all original ZX81 games will work as
+ expected. After all, DS81 isn't really a ZX81.
+
+
+-------------------------------------------------------------------------------
+$Id$
+
+ vim:expandtab:spell