home *** CD-ROM | disk | FTP | other *** search
/ ftp.barnyard.co.uk / 2015.02.ftp.barnyard.co.uk.tar / ftp.barnyard.co.uk / cpm / walnut-creek-CDROM / SIMTEL / CPMUG / CPMUG019.ARK / RM80.DOC < prev    next >
Text File  |  1984-04-29  |  8KB  |  234 lines
  1. RM80 V2.0 User's Guide
  2.  
  3.    RM80 is a PROM-resident monitor for an 8080 (or Z80) system. It
  4. supports one console, one modem, and two cassette decks interfaced
  5. with a Tarbell Tape Interface, with relays. There are four main 
  6. groups of commands:
  7.  
  8.      1) The hex monitor (edit memory in hex or ASCII)
  9.      2) Standard Tarbell driver (read/write standard tapes)
  10.      3) SDC Format tape driver (read/write RM80 tapes)
  11.      4) Communications executive (allow link to remote CPU)
  12.  
  13.    All data entered from the console has the following editing
  14. facilities available before hitting the CR key:
  15.  
  16.      1) CTRL-U will abort the current line
  17.      2) DEL (RUBOUT) will discard the previous character,
  18.         and echo it to the console.
  19.  
  20.    Memory is allocated as follows (in the 24K version):
  21.  
  22.      0000-57FF   User program and buffer area
  23.      5800-5BFF   Default system tape buffer
  24.      5900-590A   Default system filename buffer
  25.      590B-590B   Tape unit number buffer
  26.      590C-590C   Physical record number buffer
  27.      590E-5C8D   System input buffer
  28.      5C8E-5CCD   System stack
  29.      C000-CBFF   3K PROM containing RM80
  30.  
  31.    Once a program has been loaded in, and execution begun, assuming
  32. the stack pointer has the same value as when execution began, a
  33. simple RET will return you to RM80. At any point, a jump to location
  34. C000 will restart RM80.
  35.  
  36.    The commands are all in the same format:
  37.  
  38.      <KEYWORD> <BLANKS> <PARAM> <BLANKS> <PARAM>
  39.  
  40. <KEYWORD> - is an up to 5 character word in the list of commands
  41. <BLANKS>  - is a string of one or more blanks
  42. <PARAM>   - is an up to 4 digit hex number
  43.  
  44.    Some commands will require further data before execution. These
  45. will prompt the user for that data. The MOVE command requires a
  46. destination address, so a valid response to the 'TO?' prompt is a
  47. <PARAM> as above. Anytime the prompt 'FILENAME?' occurs, any legal
  48. CP/M filename may be typed. A CP/M filename is of the form
  49.  
  50.      <name>   or   <name>.<type>
  51.  
  52. <name> is any group of up to 8 ASCII characters
  53. <type> is any string of up to 3 ASCII characters
  54.  
  55. Standard CP/M file types are as follows:
  56.  
  57.      ASM - Assembler source file
  58.      HEX - Intel hex object file
  59.      COM - Memory image object file (loads at 100H)
  60.      BAS - BASIC source file
  61.      FOR - FORTRAN source file 
  62.  
  63. ************************************************************************
  64.  
  65. RM80 Hex Monitor Commands
  66.  
  67. DUMP fwa lwa
  68.  
  69.      Dump memory in hex and ASCII starting at fwa, ending at lwa.
  70.      Control characters are printed as periods. Dumping may be
  71.      aborted at any time by typing any character.
  72.  
  73. TYPE fwa lwa
  74.  
  75.      Type memory in ASCII starting at fwa ending at lwa. All 
  76.      control characters print as themselves (exercise caution).
  77.  
  78. ENTER fwa
  79.  
  80.      Allow user to enter memory contents in Hex. A four digit
  81.      prompt 'xxxx?' will be printed at the start of each input
  82.      line, to show the user where the first byte typed on that
  83.      line will be loaded into memory. The user may return to RM80
  84.      by typing an empty line (CR right after prompt).
  85.  
  86. MOVE fwa lwa
  87.  
  88.      Move block of memory starting at fwa ending at lwa to the
  89.      area starting at the destination address (supplied in response
  90.      to the TO? prompt. Blocks may overlap either way.
  91.  
  92. FILL fwa lwa
  93.  
  94.      Fill memory with constant supplied in response to 'WITH?'
  95.      prompt, starting at fwa ending at lwa.
  96.  
  97. GO fwa
  98.  
  99.      Jump to address fwa. Default is 100H.
  100.  
  101. ************************************************************************
  102.  
  103. Standard Tarbell Tape Handler Commands
  104.  
  105. STORE fwa lwa
  106.  
  107.      Store memory starting at fwa ending at lwa to tape in Tarbell
  108.      standard format (data bytes then checksum).
  109.  
  110. FETCH fwa lwa
  111.  
  112.      Fetch standard Tarbell file into memory starting at fwa, and
  113.      ending at lwa. Note that the file size (lwa-fwa+1) must be
  114.      the same as the file size used in creating the file with
  115.      STORE (or equivalent). The message 'CHECKSUM ERROR' indicates
  116.      that data was lost (or user specified fwa and lwa wrong for
  117.      this file).
  118.  
  119. CHECK fwa lwa
  120.  
  121.      Same as FETCH, but data is not loaded into memory . Good
  122.      for checking quality of files written with STORE.
  123.  
  124. UNIT n
  125.  
  126.      Sets unit number for above commands (default = 1)
  127.  
  128. Notes on using cassette tapes with RM80:
  129.  
  130.      Before writing data to tape, the user should put the recorder
  131.      into RECORD and allow a reasonable leader (count to 10). The
  132.      REMOTE cable (motor control) may be re-inserted and the WRITE
  133.      command issued. Further files may be written without additional
  134.      leader. When reading tapes, the cassette may be positioned
  135.      any length of leader (and/or blank tape) before the actual data.
  136.      Port FF lights will display data being written to or read from
  137.      cassette tape.
  138.  
  139. ************************************************************************
  140.  
  141. SDC Tape Handler commands
  142.  
  143. WRITE n
  144.  
  145.      Writes n pages (256 bytes each) starting at 100H, to tape
  146.      in SDC format. A filename will be requested with the 'FILENAME?'
  147.      prompt. When the entire file is written, RM80 will respond with
  148.      'xxxx BYTES WRITTEN' and then provide a command prompt.
  149.  
  150. WRITE fwa lwa
  151.  
  152.      As above, but the user nay specify any addresses.
  153.  
  154. READ fwa
  155.  
  156.      Read next SDC format file into memory starting at fwa.
  157.      Reading may be aborted at any time by typing any character.
  158.      Default fwa is 100H. Header info is printed as each
  159.      record is read into memory.
  160.  
  161. LOAD 
  162.  
  163.      Load Intel Hex Object Format file in SDC Format into memory
  164.      at addresses specified in object file. Loading may be aborted
  165.      at any point by typing any character.
  166.  
  167. DUMP 
  168.    
  169.      Dump next SDC format file to console in Hex and ASCII.
  170.      Header info is printed as each record is read. Conventions are
  171.      the same as the memory dump command. Dumping may be aborted
  172.      as usual.
  173.  
  174. TYPE
  175.  
  176.      Type next SDC format file to console in ASCII. Conventions are
  177.      the same as the memory TYPE command. Typing may be aborted
  178.      as usual.
  179.  
  180. SCAN
  181.  
  182.      Read SDC tape and print header info until interrupted by any
  183.      character from the console.
  184.  
  185. UNIT n
  186.  
  187.      Select tape unit for all tape commands until respecified.
  188.  
  189. Header info when printed, is in the following form: 
  190.  
  191.      NAME = aaaaaaaa  TYPE = aaa  SIZE = dddd  PRN = dd  CRC = ssss
  192.  
  193.      aa...aa  is an ASCII character string
  194.      dd...dd  is a Hex number
  195.      ss...ss  is the string 'GOOD' or 'BAD'
  196.  
  197.  
  198. The SDC physical record format is as follows:
  199.  
  200.      FIRST   NUMBER     NAME     CONTENTS
  201.  
  202.      BYTE    OF BYTES   
  203.  
  204.       00      01        SOH      ASCII Start Of Header
  205.       01      08        FN       ASCII file name
  206.       09      03        FT       ASCII file type
  207.       12      01        PRN      Integer Physical record number
  208.       13      02        PRS      Integer Physical record size (HI/LO)
  209.       14      01        STX      ASCII Start Of Text
  210.       15      prs       DATA     Data Bytes (normally 1024 of them)
  211.       15+prs  01        ETX      ASCII End Of Text
  212.       16+prs  02        CRC      Integer Cyclic Redundancy Checksum (HI/LO)
  213.  
  214. ************************************************************************
  215.  
  216. Communications Link Executive
  217.  
  218. LINK
  219.  
  220.      Establish communications link with remote computer. Characters from
  221.      console are sent to the modem. Characters from the modem are 
  222.      typed on the console. Various control characters allow tape files
  223.      to be sent or received, or downloaded. To return to RM80 at any 
  224.      time, type CTRL-X. This will not break the link, which may be
  225.      re-entered by typing LINK again from RM80.
  226.  
  227.           CTRL-O     Enable Object File Loader
  228.           CTRL-N     Disable Object File Loader
  229.           CTRL-R     Enable Text File Loader
  230.           CTRL-Q     Disable Text File Loader and write to tape
  231.           CTRL-X     Return to monitor
  232.  
  233. ************************************************************************
  234.