home *** CD-ROM | disk | FTP | other *** search
/ C/C++ Interactive Guide / c-cplusplus-interactive-guide.iso / c_ref / csource4 / 284_01 / i8080.doc < prev    next >
Encoding:
Text File  |  1989-03-13  |  5.8 KB  |  153 lines
  1. NAME
  2.     I8080.EXE    8080 Simulator
  3.  
  4. SYNOPSIS
  5.     i8080 [-f] [-m] [-b boot] [-t tr] [-A file ... -H file]
  6.  
  7. DESCRIPTION    
  8.     Rules when specifying options:
  9.  
  10.     . You can specify options in any order.
  11.     . Don't use the same option twice.
  12.     . The program is case-sensitive.
  13.     . Space is required between an option character and its parameter.
  14.  
  15.     Description of options:
  16.  
  17.     f - When "POP PSW" is executed, the program checks inconsistency
  18.         between flags. Default is no checking. When the program detects
  19.         the inconsistency, it warns the user.
  20.  
  21.     m - When the program is terminated abnormally, the contents of the 
  22.         memory is dumped. Without this option, no memory is dumped.
  23.         If I8080 encounters an undefined instruction, the program 
  24.         will be terminated.
  25.         With this option, memory is dumped into a file, "CORE.HEX"
  26.         which will be examined later.
  27.  
  28.     b - With this option, the boot file name will be "boot". The default
  29.         is "CPM20.HEX".  When I8080 starts running, it reads the boot file 
  30.         in memory and starts executing a program from the address 0.
  31.         In normal case, I8080 performs IPL of CP/M, but you can specify
  32.         a stand alone program to execute.
  33.  
  34.     t - This options sets the trace-level. Default trace level is 0.
  35.         Currently, the available trace level is from 0 to 7.
  36.  
  37.         level                |  0  1  2  3  4  5  6  7 
  38.         ----------------------------------------------------------------
  39.         Display Instruction  |  N  Y  N  Y  N  Y  N  Y
  40.         Display Registers    |  N  N  Y  Y  N  N  Y  Y
  41.         Dispaly #calls       |  N  N  N  N  Y  Y  Y  Y
  42.  
  43.         When "Display Instruction" is set "Y", I8080 displays
  44.         an excecuted instruction at every step. A displayed instruction
  45.         is disassembled.
  46.  
  47.         When "Display Register" is set "Y", I8080 displays the contents
  48.         of registers before an instruction is excecuted.
  49.  
  50.         When "Display #calls" is set "Y", I8080 counts the number of times
  51.         each instruction is called. At the termination of the program,
  52.         it displays the profile of the program.
  53.  
  54.     A - This specifies a virtual disk file in the virtual disk drive A.
  55.         The disk drive can be B,C,D,E,F,G, or H. 
  56.         The default filename for the drive A is "CPMSYS.DSK". 
  57.         There is no default filename for the drive B-H.
  58.         When you specify "." for filename, a physical drive is assigned.
  59.  
  60.     When you enter an invalid option, it is simply ignored.
  61.  
  62.  
  63.     I8080 executes CP/M-80. Without -b option, I8080 reads and executes
  64.     "CPMnn.HEX" (nn is two digit number. Default is 20.). This file
  65.     contains CCP and BDOS from the standard CP/M, BIOS for I8080, and 
  66.     a short IPL code.
  67.  
  68.     After I8080 executes CP/M, it works like a real CP/M.
  69.     In this system, 8 disk drives can be accessed. These disk drives 
  70.     differ from physical disk drives. To distinguish them, we
  71.     call them virtual disk drives.
  72.  
  73.     In the virtual disk drive, a virtual disk can be mounted.
  74.     A virtual disk is a file that is created under the host operating
  75.     system and includes the contents of a real CP/M floppy disk.
  76.     Users can treat this file as if it is a floppy disk.
  77.  
  78.     You must use a program "newdsk" before executing I8080.
  79.  
  80.     Under MSDOS, CP/M devices correspond to MSDOS devices as shown below.
  81.     No I/O byte is supported.
  82.  
  83.     CON: standard input and output (File-handle 0 and 1.)
  84.     RDR: auxiliary standard input (Input from file-handle 3.)
  85.     PUN: auxiliary standard ouput (Output to file-handle 3.)
  86.     LST: standard printer ouput (File-handle 4.)
  87.  
  88.     I8080 handles only ASCII characters (No Japanese characters).
  89.  
  90.     To terminate CP/M, HLT instruction should be executed.
  91.     Alternatively, CP/M can be terminated by executing HALT.COM
  92.     in a virtual disk, "CPMSYS.DSK". 
  93.  
  94. Description of stand-alone programs:
  95.  
  96.     We call a 8080 program a stand-alone program when the program
  97.     is executed with the -b option of I8080, instead of using CP/M.
  98.  
  99.     Stand-alone programs directly use BIOS of I8080 so 
  100.     in some cases the description above doesn't make any sense.
  101.     Please refer to the documentation of each stand-alone program.
  102.  
  103.     You can create a stand-alone program using an 8080 assembler.
  104.     Note that you need to use BIOS in I8080 when the program
  105.     utilizes I/O routines. For details, please refer to "how to
  106.     create a stand-alone program".
  107.  
  108. EXAMPLES
  109.  
  110.     This example executes CP/M. "CPMSYS.DSK" is mounted as a virtual
  111.     disk drive.
  112.  
  113.     i8080
  114.  
  115.  
  116.     Although this example executes CP/M, the specified virtual disks are
  117.     mounted to the virtual dis½ dri~e A and B. Flags are checked
  118.     and a warning message will be es is
  119.     specified in the command line, all filenames are concatenated in the 
  120.     order.
  121.     A pathname can be specified with this option.
  122.  
  123. u    This option specifies a CP/M user number. The parameter should be
  124.     from 0 to 31, decimal number. The default user number is 0.
  125.     
  126.     In a virtual disk, it is assumed that all CP/M files are in the
  127.     user number specified with this option. Thus, when reading a file,
  128.     displaying a filename, or erasing a file, only files that are in the 
  129.     specified user number will be processed. When writing a file, the file
  130.     is created in the specified user number.
  131.  
  132. d    This option specifies a virtual disk. Although the default has
  133.     an appropriate name, please try to specify on every time. Any MSDOS 
  134.     pathname can be specified for the parameter. The virtual disk must exist
  135.     beforehand even if writing a file to the disk.
  136.  
  137. Filenames
  138.  
  139.     A CP/M filename consists of a
  140.     primary name (The length is less than or equal to 8 characters.),
  141.     a period, and secondary name (The length is less than or8080 are
  142.     displayed in a strange format.
  143.  
  144.     The profile of a program uses a long integer to count numbers.
  145.     The overflow will occur if I8080 is executed too long.
  146.  
  147.     Only one physical disk drive is available.
  148.  
  149.     
  150.     
  151.  
  152.  
  153.