|
|
Line 37: |
Line 37: |
| | | |
| * The boot ROMs must have been setup, before the Apollo emulation may be run (see below). | | * The boot ROMs must have been setup, before the Apollo emulation may be run (see below). |
− | * Make sure you understand how to ungrab the mouse before runnung MESS with option mouse (see below) | + | * Make sure you understand how to ungrab the mouse before runnung MAME with option mouse (see below) |
| * The DN3x00 emulation may be run without option -mouse (i.e. without grabbing the mouse), if you are willing to move the cursor with the arrow keys of the keyboard (works quite good, once you get used to it) | | * The DN3x00 emulation may be run without option -mouse (i.e. without grabbing the mouse), if you are willing to move the cursor with the arrow keys of the keyboard (works quite good, once you get used to it) |
| * DN3x00 is being used as shorthand for DN3000 or DN3500 or DN5500; same for DSP3x00 | | * DN3x00 is being used as shorthand for DN3000 or DN3500 or DN5500; same for DSP3x00 |
Line 81: |
Line 81: |
| | | |
| Would you like to reconfigure this node (Y/N)?</nowiki> | | Would you like to reconfigure this node (Y/N)?</nowiki> |
| + | |
| + | * Enter ''n'' to quit or ''y'' to modify the configuration; the configuration will be saved in the NVRAM of the emulation. |
| + | |
| + | ===How to run calendar=== |
| + | |
| + | * If the Winchester disk image hasn't been used for some time (14 days), it may be necessary to run calendar. |
| + | |
| + | ====To run calendar==== |
| + | |
| + | * Switch the Apollo emulation into Service Mode (see below) and reset or restart the emulation |
| + | * press Return (in the MAME window or in the Terminal window) until the MD version and prompt (“>”) are shown |
| + | * enter ''ex calendar'' and wait |
| + | * enter ''w'' to select the Winchester disk |
| + | * check and eventually change the timezone |
| + | * check and eventually change date and time |
| + | * confirm questions as appropriate and wait for the MD prompt to reappear |
| + | |
| + | ===How to run salvol=== |
| + | |
| + | * If Domain/OS has crashed or has been aborted, it may be necessary to salvage the disk. |
| + | |
| + | ====To run salvol==== |
| + | |
| + | * Switch the Apollo emulation into Service Mode (see below) and reset or restart the emulation |
| + | * press Return (in the MAME window or in the Terminal window) until the MD version and prompt (“>”) are shown |
| + | * enter ''ex salvol'' and wait |
| + | * enter ''w'' to select the Winchester disk |
| + | * enter return to start salvaging of logical volume 1 with default options |
| + | * confirm Anything more to do? with n and wait for the MD prompt to reappear |
| + | |
| + | ===How to run dex=== |
| + | |
| + | * The Diagnostic EXecutive (dex) is a comprehensive diagnostic control system for diagnostic products in the offline environment. |
| + | |
| + | ====To run dex==== |
| + | |
| + | * Switch the Apollo emulation into Service Mode and set all other Driver Configuration values to Off (see below) |
| + | * reset or restart the emulation |
| + | * press Return until the MD version and prompt (“>”) are shown (in MAME window or in Terminal window) |
| + | * enter ''ex dex'' and wait |
| + | * enter help for more info |
| + | * enter auto for full test (confirm errors with C or N); '''expect the following tests to fail''' |
| + | ** mem.dex Test 140: Parity Checker Test (emulation won't allow more the 40 parity error tests) |
| + | ** cpu.dex Test 302: SIO keyboard port test (behavior is ok for DSP3x00, run test with option -nokb) |
| + | ** disp.dex Test 20: Video SYNC Gen. Add. Test (not emulated for Monochrome graphics) |
| + | ** win.dex Test 103: Format Bad Track Test (not emulated) |
| + | ** fpu.dex Test 2: General Instruction (many FPU operations and operands are not yet emulated) |
| + | |
| + | ===How to run Domain/OS in the DN3x00 emulation=== |
| + | |
| + | * Start the MAME emulation for dn3500 or dn3000 (resp. dn3500_19i or dn3000_19i) with option -mouse |
| + | make sure you understand how to ungrab the mouse (see below) |
| + | * if Apollo emulation has been set to Normal Mode Domain/OS will boot without user intervention |
| + | * if Apollo emulation has been set to Service Mode perform the following steps |
| + | ** in the MAME window press Return until the MD version and prompt (“>”) are shown |
| + | ** enter ''ex aegis'' (or ex domain_os) and wait until the bootshell prompt “)” appears |
| + | ** enter ''go'' to load as in normal mode (or help for more info) |
| + | ** wait until the DM has been started and the DM screen is shown |
| + | ** login as user ''user'' with empty password (or -apollo- if the registry already has been created) |
| + | ** wait for the first pad to appear and then enter shell commands … |
| + | ** see below for the mapping of the Apollo keyboard keys to the PC keyboard function keys |
| + | ** to logout press key ''F1'' to move the cursor into the command window and enter ''lo'' |
| + | ** to shutdown Domain/OS press key ''F1'' to move the cursor into the command window and enter ''shut'' |
| + | |
| + | ===How to run Domain/OS in the DSP3x00 emulation=== |
| + | |
| + | * Start the MAME emulation for dsp3500 or dsp3000 (w/o option -mouse) |
| + | * if Apollo emulation has been set to Normal Mode Domain/OS will boot without user intervention |
| + | * if Apollo emulation has been set to Service Mode perform the following steps |
| + | ** in MAME window or in Terminal window press Return until the MD version and prompt (“>”) are shown |
| + | ** enter ''ex aegis'' (or ex domain_os) and wait until the bootshell prompt “)” appears |
| + | ** enter ''go'' to load as in normal mode (or help for more info) |
| + | ** wait until SPM and MBX Helper have been started |
| + | ** enter ''sh'' to start the login shell (or help for more info) |
| + | ** login as user ''user'' with empty password (or -apollo- if the registry already has been created) |
| + | ** wait for the shell prompt “$” and then enter shell commands … |
| + | ** enter ''exit'' as shell command to logout |
| + | ** enter ''shut'' to shutdown Domain/OS |
| + | |
| + | ==MAME Basics== |
| + | |
| + | ===How to stop the emulation=== |
| + | |
| + | * in the MAME window press ''ScrLock'' to switch your keyboard in partial emulation mode |
| + | * press ''Esc'' to stop the emulation |
| + | See also the MAME Documentation. |
| + | |
| + | ===How to reset the emulation=== |
| + | |
| + | * in the MAME window press ''ScrLock'' to switch your keyboard in partial emulation mode |
| + | press ''F3'' to reset the emulation |
| + | See also the MAME Documentation. |
| + | |
| + | ===How to restart the emulation=== |
| + | |
| + | * Stop the emulation (see before) and restart the emulation from the command line, or in the MAME window press ''ScrLock'' to switch your keyboard in partial emulation mode |
| + | * Press ''Shift'' and ''F3'' to restart the emulation |
| + | See also the MAME Documentation. |
| + | |
| + | ===How to suspend the emulation=== |
| + | |
| + | * In the MAME window press ''ScrLock'' to switch your keyboard in partial emulation mode |
| + | * Press button ''P'' to pause the emulation |
| + | * Press button ''P'' once again to resume the emulation |
| + | * Eventually delete the extra character p in the emulation |
| + | * Eventually press ''ScrLock'' to switch your keyboard back to fully emulated keyboard mode |
| + | See also the MAME Documentation. |
| + | |
| + | ===How to ungrab the mouse=== |
| + | |
| + | * If the emulation has been started with option -mouse, the mouse will be grabbed as long as the emulation is running. |
| + | * Suspend the emulation (see before) to ungrab the mouse. The mouse will be grabbed again, if the emulation is resumed (see before). |
| + | |
| + | ==Service Mode/Normal Mode== |
| + | |
| + | To switch the Apollo emulation between Service Mode and Normal Mode |
| + | |
| + | * Open the Apollo Driver Configuration menu (see below) |
| + | * select and change the value of entry Service/Normal |
| + | * close the menus and reset the emulation (see before) |
| + | |
| + | ==Apollo Driver Configuration== |
| + | |
| + | To check or modify the Apollo Driver Configuration |
| + | |
| + | * Start the emulation for DN3500, DN3000, DSP3500 or DSP3000 |
| + | * In the MAME window press ''ScrLock'' to switch your keyboard in partial emulation mode |
| + | * press ''Tab'' to enter the Internal User Interface |
| + | * Press ''Cursor Down'' twice to select Driver Configuration and press ''Return'' to open the Driver Configuration menu |
| + | |
| + | The Apollo Driver Configuration menu has the following entries |
| + | |
| + | {| |
| + | |Entry||Descriptiion |
| + | |- |
| + | |Service/Normal||select Service mode or Normal mode |
| + | |- |
| + | |Graphics Controller||Select 8-Plane Color, 4-Plane Color or 15“ Monochrome graphics controller (for dn3x00 only, will be ignored for dn3x0_19i and dsp3x00 |
| + | |- |
| + | |20 Years Ago||set default date in the RTC back by 20 years to omit the Nov 2, 1997 problem of Domain/OS software releases before SR 10.4.1 |
| + | |- |
| + | |Node ID from Disk||set node ID to value from the logical volume label of the first logical disk volume; without this option the default node ID 12345 is used |
| + | |- |
| + | |Idle Sleep||Add sleep calls in the Idle Loop of Domain/OS to reduce the CPU usage of the emulation; should be used only for DSP3x00 |
| + | |- |
| + | |Trap Trace||Trace all Domain/OS SVC traps in the error log file |
| + | |- |
| + | |FPU Trace||Trace all FPU operations in the error log file |
| + | |- |
| + | |Disk Trace||Trace disk I/O in the error log file |
| + | |- |
| + | |Network Trace||Trace network packets in the error log file |
| + | |} |
| + | |
| + | * Press ''Cursor Down'' or ''Cursor Up'' to select the proper menu entry |
| + | * Press ''Cursor Right'' or ''Cursor Left'' to select the proper value |
| + | * Press button ''Tab'' to close the menu |
| + | * Press button ''F3'' to restart the emulation using the new settings |
| + | * Press ''ScrLock'' to switch your keyboard back to in full emulation mode |
| + | |
| + | Notes: |
| + | |
| + | * The new Driver Configuration setting won't be used unless the emulation has been reset or restarted |
| + | * Each system (i.e. DN3500, DN3000, DSP3500 or DSP3000) has its own Driver Configuration settings |
| + | * Warning: entering character 'p'' in partial emulation mode will pause (i.e. freeze) the emulation (e.g. for “r cpu”) |
| + | See also the MAME Documentation. |
| + | |
| + | '''This section has not been completely copied over from the MESS wiki. It should be done within the next 24 hours.''' |
To run an emulation start MAME with one system and additional command line options, e.g.
See the MAME Documentation for specifics on installing and using MAME.
See also the MAME Documentation.
The Apollo emulation should be configured for proper operation.
See also the MAME Documentation.
See also the MAME Documentation.
See also the MAME Documentation.
See also the MAME Documentation.