home *** CD-ROM | disk | FTP | other *** search
/ minnie.tuhs.org / unixen.tar / unixen / PDP-11 / Emulators / Ersatz-2.0 / e11.hlp < prev    next >
Encoding:
Text File  |  1997-07-16  |  13.3 KB  |  326 lines
  1. $AT
  2. @file
  3.  
  4. Reads in "file" as if its contents had been entered at the E11 prompt.  The
  5. default extension is ".CMD".  Indirect files cannot be nested.
  6. $ASNTTY
  7. ASSIGN pdpdev pcdev /switches
  8.  
  9. Assigns a PDP-11 character device (TTn: or LPn:) a physical PC device, which
  10. is either a COM port, COM1:-COM4:, an LPT port, LPT1:-LPT4:, or a video
  11. console, CON1:-CON12: (the keyboard and primary monitor may be switched to that
  12. port by pressing Alt-F1 through Alt-F12, or the secondary monitor may be
  13. switched to that port if you press Ctrl-F1 through Ctrl-F12).  Switches are
  14. /IRQn, /SHARE, /FIFO[:n], and /NOFIFO for COM ports, and /IRQn, /NOIRQ, and
  15. /SHARE for LPT ports.
  16. $ASNETH
  17. ASSIGN XEn: PKTD[=int] [prot1 prot2 ...]
  18.  
  19. Assigns a DELUA (XEn:) port to an ethernet board for which a packet driver has
  20. been loaded (from DOS, prior to starting E11).  The packet driver is found at
  21. the specified INT vector (hex), or if it's not specified then the range from 20
  22. to FF is searched for any packet driver not already in use by E11.  The driver
  23. must conform to version 1.09 or later of FTP Software's packet driver spec.  If
  24. prot1 etc. are specified, they are the hex DIX protocol numbers of up to ten
  25. packet types that the DELUA will be able to receive (to allow cooperation with
  26. other protocol stacks on the same PC);  if no protocols are specified then the
  27. DELUA arranges to receive all packet types.
  28. $BOOT
  29. BOOT pdpdev [/switches]
  30.  
  31. Boots the PDP-11 from the specified mass storage device (must be MOUNTed).
  32. Switches are /RT11 or /RSTS (to control mechanism for passing date/time
  33. information to those systems) or /HALT to stop the CPU after loading the boot
  34. block.
  35. $CALC
  36. CALCULATE expr
  37. & expr
  38.  
  39. Calculate the value of an expression.
  40.  
  41. Binary operators:  * / + - (usual precedence)
  42. Unary operators:   + - ^C
  43. Primaries:         (expr) octno decno. ^Xhexno ^Rrad50no 'char
  44.                    r0 r1 r2 r3 r4 r5 sp pc ps r0' r1' r2' r3' r4' r5'
  45. $DEASN
  46. DEASSIGN pdpdev
  47.  
  48. Undoes an ASSIGN command, disconnecting the specified PDP-11 device from its
  49. assigned PC device.
  50. $DELAY
  51. SET DELAY device c:n c:n ...
  52. SHOW DELAY device
  53.  
  54. SET DELAY sets the number of instructions that the specified commands appear to
  55. take to complete on the indicated device.  The device may be DELUA, DL11,
  56. DOSFILE, LP11, PC11, RK11D, RL11, RK611, RS03, RS04 (syn. for RS03 in this
  57. case) RX11, RX211, RXT11, TA11, TM03, or TM11.  For each parameter "c:n", c is
  58. the command number (meaning depends on the device), and n is the number of
  59. PDP-11 instructions the emulator should delay before signaling completion of
  60. that command;  both are octal unless followed by ".". c may be "*" to set the
  61. same delay for all command numbers for the device.  SHOW DELAY shows the delays
  62. set for each of device's commands.  See the Ersatz-11 documentation for
  63. details.
  64. $DEPOS
  65. DEPOSIT addr data1 data2 ...
  66.  
  67. Deposits the specified word(s) at the specified memory address (and following
  68. addresses if more than one data word is given), in the address space specified
  69. by the optional switch(es).  See HELP EXAMINE for switches.
  70. $DLL
  71. INSTALL filename[.DLL]
  72. REMOVE module
  73. SHOW MODULE module
  74.  
  75. Installs, removes, or displays information about a dynamic link library, which
  76. contains user-supplied device emulation code that may be loaded into Ersatz-11
  77. at run time.  Not available in Lite or demo versions.
  78. $DUMP
  79. DUMP filename[.PDP] [A1:B1 A2:B2 ... An[:[Bn]] ]
  80.  
  81. Dumps PDP-11 memory to the specified DOS file.  Any number of address ranges
  82. "Ai:Bi" may be given, and bytes from the specified ranges of memory are stored
  83. in the file in the order given in the command line.  If a range has no ending
  84. address (the colon may be omitted in this case), data are saved all the way to
  85. the end of memory.  If no ranges are given then all of memory is dumped
  86. starting at 000000.
  87.  
  88. DUMP {/ROM | /EEPROM} [/BANKED] filename[.PDP] [A:B]
  89.  
  90. Dumps the specified ROM or EEPROM to a DOS file.  /BANKED means the ROM is
  91. banked and accessed through a 512.-byte window at (17)773000 or (17)765000
  92. (using the page control register to switch banks), if you leave out the ending
  93. address the entire banked ROM will be dumped instead of just the first 512.
  94. bytes.
  95. $EXAM
  96. EXAMINE [/sw] [start [end]]
  97.  
  98. Examines (displays) the word(s) at the specified absolute memory address or
  99. range, in the address space specified by the optional switch(es).  If only one
  100. address is given then one word is displayed.  If nothing is given then the 8
  101. words following the most recent EXAMINE or DEPOSIT command are displayed.  The
  102. address space defaults to whatever was used on the most recent EXAMINE or
  103. DEPOSIT command, or /CURRENT /DATA if none was ever given.  Switches:
  104.  
  105. /CURRENT       current virtual address space (from PSW<15:14>)
  106. /PREVIOUS      previous virtual address space (from PSW<13:12>)
  107. /KERNEL        Kernel mode
  108. /SUPERVISOR    Supervisor mode
  109. /USER          User mode
  110. /INSTRUCTIONS  I space
  111. /DATA          D space
  112. /PHYSICAL      physical address space (used anyway if MMU disabled)
  113. $FPREG
  114. FPREGISTER [ac v1 v2 v3 v4]
  115.  
  116. Displays all FP registers, or sets the value of the specified AC (0-5) to the
  117. specified four octal words.
  118. $GO
  119. GO reladdr
  120.  
  121. Starts the CPU at the specified virtual address.
  122. $HALT
  123. HALT
  124.  
  125. Halts the CPU immediately if it is running.
  126. $INIT
  127. INITIALIZE
  128.  
  129. Reinitializes all devices, disables the MMU, sets kernel mode.
  130. $KEY
  131. DEFINE {KEYPRESS | KEYRELEASE} key def
  132. SHOW {KEYPRESS | KEYRELEASE} key
  133.  
  134. Defines or displays the definition of a key.  Most keys only do something when
  135. pressed, so they have no KEYRELEASE definition, except for the Shift and Ctrl
  136. keys which have to clear the flags that were set when they were pressed.  See
  137. the Ersatz-11 documentation for key names and definition syntax.
  138. $LED
  139. DEFINE LED led flag
  140. SHOW LED led
  141.  
  142. Specifies which keyboard flag (from the DEFINE KEYPRESS script language) is
  143. tied to each of the three keyboard LEDs (names are CAPS, NUM, SCROLL).  OFF may
  144. also be used to turn a keyboard LED off permanently.  SHOW LED shows an LED's
  145. current definition.
  146. $LIST
  147. LIST [/sw] [addr]
  148.  
  149. Disassembles the next eight instructions starting at addr, in the address space
  150. specified by the optional switch(es).  If either is omitted, the default is to
  151. continue immediately after the most recent LIST command or REGISTER display
  152. (any time a register dump is given, either from a REGISTER command or
  153. implicitly due to a halt or STEP command, the default LIST space is set to
  154. /CURRENT /INSTRUCTIONS).  See HELP EXAMINE for other switches.
  155. $LOAD
  156. LOAD filename[.PDP] [A1:B1 A2:B2 ... An[:[Bn]] ]
  157.  
  158. Loads the specified DOS file into PDP-11 memory.  Any number of address ranges
  159. "Ai:Bi" may be given, and bytes from the file are loaded into the specified
  160. ranges in the order they appear in the command line.  The last range may have
  161. no ending address, in which case data are loaded until end-of-file is reached.
  162. If no ranges are given then the file is loaded at 000000.
  163.  
  164. LOAD {/ROM | /EEPROM} [/BANKED] filename[.PDP] [A:B]
  165.  
  166. Loads the specified DOS file into a simulated ROM or EEPROM.  /BANKED means
  167. the ROM is banked and accessed through a 512.-byte window at (17)773000 or
  168. (17)765000 (using the page control register to switch banks).
  169. $LOGDSK
  170. LOG ddcu: [filename] [/APPEND]
  171.  
  172. Logs disk or tape commands to the specified controller (unit number is
  173. insignificant), or turns off logging if no filename is given.  /APPEND means to
  174. append to an existing log file instead of replacing it.
  175. $LOGTTY
  176. LOG ddcu: [filename] [/APPEND]
  177.  
  178. Logs TT: or LP: output to a file, or turns off logging if no filename is given.
  179. /APPEND means to append to an existing log file instead of replacing it.
  180. $LOGETH
  181. LOG XEn: [filename] [/[NO]COMMANDS] [/[NO]RECEIVE] [/[NO]TRANSMIT] [/APPEND]
  182.  
  183. Logs ethernet events;  the switches specify which events are logged.
  184. /[NO]COMMANDS logs (or suppresses logging of) all commands issued to a DELUA by
  185. the PDP-11;  similarly, /[NO]RECEIVE and /[NO]TRANSMIT enable or disable
  186. logging of received or transmitted frames.  LOG XEn: with no parameters closes
  187. the log file, LOG XEn: with switch(es) but no filename adjusts what event types
  188. are logged on a file which is already open.  If a log file is opened with no
  189. switches, the default is /RECEIVE /TRANSMIT.  /APPEND means to append to an
  190. existing log file instead of replacing it.
  191. $MOUNT
  192. MOUNT pdpdev dosfile /switches
  193. MOUNT pdpdev f: /switches
  194. DISMOUNT pdpdev
  195.  
  196. Mounts/dismounts the specified PDP-11 mass storage unit using the specified DOS
  197. container file, or floppy drive if only "f:" is given.  Switches are /RONLY (or
  198. /WPROTECT) and /RW (default) for disks, and drive type if ambiguous.
  199.  
  200. CTcu:   TU60 cassette tape
  201. DLcu:   RL01/02 5/10 MB disk, /RL01, /RL02, or file size tells which
  202. DMcu:   RK06/07 14/28 MB disk, /RK06, /RK07, or file size tells which
  203. DScu:   RS03/04 512KB/1024KB fixed head disk, /RS03, /RS04, size tells which
  204. DTcu:   TU56 DECtape
  205. DXcu:   RX01 floppy disk
  206. DYcu:   RX01/02/03 floppy disk, distinguished by MOUNT switch, SET DY: command,
  207.         file size, or disk format if real drive is mounted
  208. HDcu:   hypothetical disk device, compatible with "Russian" LSI-11/2 emulator
  209. MMcu:   RH11/RH70,TM03,TE16 etc. tape drive
  210. MTcu:   TU10 tape drive
  211. PDcu:   RX01 floppy disk (PDT-11/150 RXT11 controller)
  212. PP:     PC11 paper tape punch
  213. PR:     PC11 paper tape reader
  214. $PROC
  215. PROCEED [breakaddr]
  216.  
  217. Restarts the CPU at the current address, optionally setting a single hard
  218. breakpoint (i.e. not visible to software) at the specified virtual address.
  219. $QUIT
  220. QUIT
  221.  
  222. Exits Ersatz-11.
  223. $REG
  224. REGISTER [r v]
  225. r=v
  226. c=v
  227.  
  228. Displays the CPU general registers and disassembles the next instruction, or
  229. sets the specified register (0-7) to the specified value if r and v are
  230. specified.  Registers may also be set by just typing "PC=1000" etc. at the
  231. command prompt, condition flags may be set with "C=0" etc., CPU priority may be
  232. set with "PRIO=5" etc., and current mode and previous mode may be set with
  233. "CM=U" etc.
  234. $STEP
  235. STEP [count]
  236.  
  237. Executes the specified number of PDP-11 instructions (default=1), displaying
  238. CPU registers after each.
  239. $SETSR
  240. SET SWITCH n
  241. SET SWITCH PORT n
  242.  
  243. The first command form specifies the octal value for the virtual switch
  244. register (initially 000000), which is readable at PDP-11 address 777570.  The
  245. second command form specifies the octal I/O address (use ^Xnnn for hex) of a
  246. 16-bit port which gives the switch register value when read using an 80x86 word
  247. IN instruction.  Building the interface is left as an exercise to the reader.
  248. $SETDR
  249. SET DISPLAY NONE
  250. SET DISPLAY PORT n
  251. SET DISPLAY LPTn:
  252. SET DISPLAY {DR | CDR | R0 | R1 ... | PC}
  253.  
  254. The first command specifies that no hardware display register exists (the
  255. default condition) and that values written to PDP-11 address 777570 should be
  256. thrown away.  The second command specifies the octal I/O address (use ^Xnnn for
  257. hex) of a 16-bit port to which the display register value should be written
  258. with an 80x86 word OUT instruction.  The third command specifies that the
  259. display register should be simulated using the parallel port LED board
  260. described in the documentation (or available from the author).  The fourth
  261. command specifies which register is displayed on the hardware lights port
  262. defined by either the second or third command;  DR is the default but some OSes
  263. use R0 for their null job displays.
  264. $SETKB
  265. SET KEYBOARD {SWAP | NOSWAP}
  266.  
  267. Tells Ersatz-11 whether to swap the functions of the Caps Lock and left Ctrl
  268. keys.  Useful for people who have 101-key Enhanced keyboards, and hate them.
  269. $SETHZ
  270. SET HERTZ {50 | 60}
  271.  
  272. Sets the actual frequency of the emulated KW11L line clock.  This should be
  273. changed only if your software expects 50 Hz, 60 Hz is the default.
  274. $SETSCP
  275. SET [NO]SCOPE
  276.  
  277. Sets the style of rubout processing used with input typed to the Ersatz-11
  278. prompt.  Mainly useful if you ASSIGN TT0: to a DECwriter (etc.) on a COM port.
  279. SCOPE is the default.
  280. $SETSCR
  281. SET SCROLL {HARD | SOFT}
  282.  
  283. Sets the type of scrolling to use for video display.  HARD (the default)
  284. scrolling works by resetting the base address of the screen and is very fast,
  285. but may expose bugs in the video emulation in your GUI OS's DOS box, or cause
  286. problems with TSRs that touch the screen.  SOFT scrolling works by copying the
  287. whole screen up a line on each line feed and should work in even the most
  288. rudimentary DOS emulation window.
  289. $setdev
  290. SET ddcu: parm1 [parm2...]
  291.  
  292. Sets various device-specific parameters for the specified PDP-11 device and
  293. unit.  More than one parameter may be specified in the same command.
  294. The possible parameters for each device type are:
  295.  
  296. CTcu:   CSR=nnnnnn VECTOR=nnn
  297. DKcu:   CSR=nnnnnn VECTOR=nnn
  298. DLcu:   CSR=nnnnnn VECTOR=nnn
  299. DMcu:   CSR=nnnnnn VECTOR=nnn
  300. DScu:   RH11 RH70 CSR=nnnnnn VECTOR=nnn
  301. DTcu:   CSR=nnnnnn VECTOR=nnn
  302. DXcu:   CSR=nnnnnn VECTOR=nnn
  303. DYcu:   SS DS CSR=nnnnnn VECTOR=nnn
  304. LPu:    CSR=nnnnnn VECTOR=nnn
  305. MMcu_s: RH11 RH70 CSR=nnnnnn VECTOR=nnn
  306. MTcu:   CSR=nnnnnn VECTOR=nnn
  307. PDcu:   CSR=nnnnnn VECTOR=nnn
  308. PR:     REWIND
  309. RHc:    RH11 RH70 CSR=nnnnnn VECTOR=nnn
  310. TTu:    CSR=nnnnnn VECTOR=nnn
  311. XEu:    BOOT=DISABLE (default) or BOOT=ddcu:[/os] (to enable remote boot)
  312.         (not yet implemented)
  313. $SHWCSR
  314. SHOW CSR addr
  315.  
  316. Shows the name of the CSR currently defined at the specified octal I/O page
  317. address.
  318. $SHWDEV
  319. SHOW ddcu:
  320.  
  321. Shows current parameters for the specified PDP-11 device.
  322. $UNLOAD
  323. UNLOAD {/ROM | /EEPROM} [/BANKED] addr
  324.  
  325. Unloads a ROM or EEPROM image.
  326.