summaryrefslogtreecommitdiff
path: root/INSTRUCTION
blob: fef55557a7cf1f764a66b899cabf11524a96204e (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
                                    3dsspec
                        Nintendo 3DS Spectrum emulator.

             Copyright (C) 2021  Ian Cowburn <ianc@noddybox.co.uk>

         This program is free software; you can redistribute it and/or
          modify it under the terms of the GNU General Public License
         as published by the Free Software Foundation; either version 3
             of the License, or (at your option) any later version.

        This program is distributed in the hope that it will be useful,
         but WITHOUT ANY WARRANTY; without even the implied warranty of
         MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
                  GNU General Public License for more details.

       You should have received a copy of the GNU General Public License
      along with this program; if not, see <http://www.gnu.org/licenses/>

================================================================================

1. General Operation
--------------------

You will be presented with the emulated spectrum screen in the upper display
and a keyboard on the touch display.  Press the keys to interact with the
emulation.  Click on the MENU banner to display the main menu.


2. The Main Menu
----------------

The main menu shows the following options.  To interact with the menu either
use the touchscreen or up/down on the pad and A to select:

    Reset Spectrum              - Reset the spectrum.
    Load TAP File               - Load a TAP file from the SD card.  To load the
                                  TAP file enter LOAD "" in the emulator.
    Configure                   - Configures the emulator.  See the following
                                  section.
    Map Joypad to Keys          - Allows you to define what keys on the keyboard
                                  the joypad and buttons will press.
    Save Memory Snapshot        - Save a snapshot of the running state.
    Load Memory Snapshot        - Load a previously saved memory snapshot.
    Save Joypad/Key State       - Saves the current joypad to keys mapping.
    Load Joypad/Key State       - Loads a saved joypad/key state.
    Debug                       - Displays a debug menu.  See a later section
                                  for details.
    Exit 3DSSPEC                - Exits the emulator.
    Cancel                      - Cancel the menu and go back to the emulation.


3. Configuration
----------------

The configuration screen gives you the following options.

    Sticky Shift                - Whether the two shift keys are 'sticky'.
                                  Sticky means that when pressed the key stays
                                  pressed until they are pressed again.
    Load Default Snapshot       - Whether the emulator attempts to load a
                                  memory snapshot called AUTO when it starts.
    Sound                       - Whether to play sound.


4. Debug Menu
-------------

The debug menu gives you access to various debug options.  The menu has the
following options:

    Enable Debug Output         - Enables debug output.  When selected it
                                  prompts for a host and port number and
                                  connects to that host and port to send debug
                                  messages.
    Disable Debug Output        - Disables the debug output.
    Disassembler                - Displays a disassembly of the spectrum's
                                  memory.  Press the joypad up/down to decrement
                                  and increment the displayed address.  Press
                                  the shoulder buttons to move in pages.  Press
                                  the B button to enter an address.  Press the
                                  START button to exit.
    Memory Viewer               - Displays a hex dump of the spectrum's memory.
                                  Press the joypad up/down to decrement and
                                  increment the displayed address.  Press the
                                  shoulder buttons to move in pages.  Press the
                                  B button to enter an address.  Press the START
                                  button to exit.
    CPU Info                    - Displays a screen with the Z80's registers.
                                  Press the shoulder buttons to cycle which
                                  register pointer is dumped to the screen.
                                  Press the B button to execute the next
                                  instruction.  Hold the X button to execute
                                  quickly.  Press the START button to exit.