
 Ohio Scientific Superboard II Emulator V1.0b Documentation

 This document describes the basic use of this emulator.  

 W_OSI Program:
  The startup configuration is located in the *.INI file
  Upload during Hard Reset [MENUE] or at program Start-Up

  Optional Command Line Options:
  You can add any self defined *.INI file in the program directory
  Default file: OSI.INI

 Use of Emulator:
	F1:  Open this HELP file
	F4:  Toggle between Fullscreen and Window mode
	F7:  Pause Emulation
	F8:  Toggle graphic mode display (starts at 0x9000)
	F9:  SAVE command similar to the tape save routine *)
	F10: LOAD command similar to the tape load routine **)
	F11: Enters Debugger
	F12: Soft RESET CPU

	Del: Delete previous character
	Ins: Copy character under cursor location
	Cursor: This keys generate keystrokes for some cursor
	programs. NEW: Keyboard Layout can be redefined

 *)	Address 515 controls transfer to modem chip
 **)	SPACE returns to Keyboard Input
	After LOAD or SAVE menu selection use basic command
	like usual to start data transfer

	IMPORTANT: Select closed saved files after SAVE
	command or press F12 
	
 The Debugger:
  The debugger allows you to watch the Emulator working.
  It shows the 6502's A,X, and Y registers, stack
  pointer, stack dump, etc.
  You can get into the monitor by pressing F11 while
  the emulator is running normally.

 Debugger Commands:
	HARD-RESET: like Power OFF/ON
	GOTO-SETUP: opens *.INI file for change
	-> activate with HART-RESET
	RESET: reset CPU
	SetPC: change program counter to new hex value
	SetBP: change debugger break point to hex value
	ClrBP: SET breakpoint to default
	IRQ/NMI: enable, disables interrupt handling
	Run: starts free run mode
	Single Step: execute single instruction
	Close: close debugger window

 Monitor Flags:
	Stop on Error code: pop up debugger,
	when invalid opcode is detected
	Trace into subs: Sub-routine follow/return mode
	Display Mem/Stack: displays RAM and PC-Stack

-----------------------------------------------------

 Notes/Bugs/Future Improvements:

 12-Aug-2001 Fix of program abort sequence
 no real good test program in Speed mode yet
 DOS system based on self made version (not the real 65V)
 19-Mar-02 ACIA read fix from ED
 OSI monitor routine at $FE3E-FE44 will randomly access
 any memory location while processing data. The OSI monitor
 bug has potential to affect any memory-mapped peripheral.
 Fix: emulate the delays associated with getting characters
 12-April-02 OSI ADC instruction 
 25-May-02 Keyboard Mapping function and more disk features
 31-May-02 New Ket.dat format and cursor function for Eprom2
 New menu items: Load Config File and Export OSI Loader
 03-March-03 Game font (Superboard II) by default
 Graphic Mode now available in single and double resolution
 10-June-03 Integration of WAVE to File conversion by
 using a KCS converter module

-----------------------------------------------------

 SYSTEM REQUIREMENTS

 This has not been tested thoroughly, but the minimum 
 requirements should be:
 a 200 MHz Pentium-class machine or better,8 Mbytes of RAM,
 10MB hard drive space, Windows 98 up to Windows 2k & XP.
 
-----------------------------------------------------

 * Keep these files always in the main program directory:
	  BASDE.ROM Kernel ROM file for SBII
	  MODE.ROM  BASIC  ROM file for SBII
	  KEY.DAT       New Map for PC keystrokes to OSI

 * The keyboard is currently mapped as close to the original
  as possible.

  With the new Keyboard Mapping function you can modify the
  mapping file KEY.DAT. 
  USAGE: Set with left Mouse key or remove with right Mouse
  Key special PC function keys can assign up to two OSI keys to
  emulate Joystick or special monitor EPROM keys.
-----------------------------------------------------

 MONDE.ROM: Original System ROM on my Superboard II

 MONUS.ROM: US version System ROM

-----------------------------------------------------
 Extended System ROMs

 EPROM1: DOS boot sequence and extended BASIC commands

 1.) "C" cold start to initial memory
 2.) "D" DOS boot
 3.) Than any selection to enable DOS commands
 Now DOS is installed starting from $E000.

 DOS Commands: 
 DISK
 Var = ERR:	Returns last Disk OS Error number
 OLD Val:		Direct Load Command
		without Val -> Break (Warm-start)
 DOS:		Loads DOS system from disk and starts
 ASS:		Loads Assembler prog and starts $0700
 TUNE A,B:	not yet emulated      
 OUT:		sent to serial port
 PAGE:		Clear entire Char display
 SET n:		Set DATA read pointer to this BAS line
 Var = CALL Adr, Val:	Calls Subroutine by Val (change $0011)
 SUB

 Command available after "W" Warm-start only
 No return value in direct command mode entry like PRINT...
 
 Simple cursor function integrated. Copy char under cursor 
 by pressing the Shift ENTER key combination.
 -----------------------------------------------------
 
 EPROM2: Extended BASIC commands and graphic mode

 How to enable ext. commands
 1.) "C" cold start to initial memory
 2.) "B" Extended Basic enable

 Commands:
 SUB
 CLG:		Clear screen in HiresMode
 SCR X,Y:	Set screen text position X,Y(0...31)
 GET
 PAGE:		Clear Text screen
 DEY(T):	Delay for T*100 msec
 SET n:		Set DATA read pointer to this BAS line
 RAD(D):	converts RAD in DEG degree (V*57.2958)
 DEG(R):	converts DEG in RAD degree (R*0.0174533)
 FRAC(R):	Cuts integer value from real(fractional)
 Var = CALL Adr,Val:	Calls Subroutine by Val (change $0011)
 GDIS X,Y (,M):	Draw/Clear pixel/line in Hires Mode X,Y(0...255)

 Cursor functions (predefined in key.dat):
	BACKSPACE = CLR screen, Cursor home
	Ctrl A = Home
	Ctrl > = Cursor Right
	Ctrl < = Cursor Left
	LF     = Cursor Down
	Shift LF = Cursor UP
	Ctrl D = Delete
	Ctrl I = Insert

-----------------------------------------------------
 Thanks to all programmers who made their code available.
        
	Based on The Compukit UK101 Emulator
	(Issued by Ian McLaughlin and in 1998)
	see http://www.compukit.org

	Some nice sources from APPLE //E EMULATOR
	(Issued by Michael O'Brien in 1996)

 The Compiler:
 Many thanks to the free wxDev-Cpp Compiler 7.0.0.42
 See under http://wxdsgn.sourceforge.net/


 GNU GENERAL PUBLIC LICENSE           Version 2, June 1991

 Copyright (C) 1989, 1991 Free Software Foundation, Inc.
 675 Mass Ave, Cambridge, MA 02139, USA
 Everyone is permitted to copy and distribute verbatim copies
 of this license document, but changing it is not allowed.

 Preamble

 The licenses for most software are designed to take away your
 freedom to share and change it.  By contrast, the GNU General
 Public License is intended to guarantee your freedom to share
 and change free software--to make sure the software is free for
 all its users. This General Public License applies to most of 
 the Free Software Foundation's software and to any other program
 whose authors commit to using it. (Some other Free Software
 Foundation software is covered by the GNU Library General
 Public License instead.) You can apply it to your programs,too.
