home *** CD-ROM | disk | FTP | other *** search
/ Liren Large Software Subsidy 15 / 15.iso / s / s270 / 1.ddi / PCKDD51B.EXE / $MODEL < prev    next >
Encoding:
Text File  |  1991-01-15  |  159.9 KB  |  4,788 lines

  1. # (c)Copyright MetaLink Corporation 1989,1990,1991
  2. # Model File for 8052
  3. A0 "iceMASTER - 8052";
  4. A21 "MetaLink Corporation" "Chandler, Arizona";
  5. A16 "iceMASTER";
  6. A17 "MetaLink";
  7. A18 "(800)METAICE {(800)638-2423}";
  8. A45 "iceMASTER (8051 Family)" "iceMASTER (68HC11 Family)" "iceMASTER (COP800 Family)";
  9. # (c)Copyright MetaLink Corporation 1989, 1990, 1991
  10. A1 1 0 0 0 ;
  11. A2  4 "8052";
  12. A3 0 1 0xE0 0 0 "ACC"        ;
  13. A3 0 1 0xF0 0 0 "B"            ;
  14. A3 0 1 0x83 0 0 "DPH"        ;
  15. A3 0 1 0x82 0 0 "DPL"        ;
  16. A3 0 1 0xA8 0 0 "IE"        ;
  17. A3 0 1 0xF8 0 0 "IOCON"        ;
  18. A3 0 1 0xB8 0 0 "IP"        ;
  19. A3 0 1 0x80 0 0 "P0"        ;
  20. A3 0 1 0x90 0 0 "P1"        ;
  21. A3 0 1 0xA0 0 0 "P2"        ;
  22. A3 0 1 0xB0 0 0 "P3"        ;
  23. A3 0 1 0x87 0 0 "PCON"        ;
  24. A3 0 1 0xD0 0 0 "PSW"        ;
  25. A3 0 1 0xCB 0 0 "RCAP2H"    ;
  26. A3 0 1 0xCA 0 0 "RCAP2L"    ;
  27. A3 0 1 0x99 0 0 "SBUF"        ;
  28. A3 0 1 0x98 0 0 "SCON"        ;
  29. A3 0 1 0x81 0 0 "SP"        ;
  30. A3 0 1 0xC8 0 0 "T2CON"        ;
  31. A3 0 1 0x88 0 0 "TCON"        ;
  32. A3 0 1 0x8C 0 0 "TH0"        ;
  33. A3 0 1 0x8A 0 0 "TL0"        ;
  34. A3 0 1 0x8D 0 0 "TH1"        ;
  35. A3 0 1 0x8B 0 0 "TL1"        ;
  36. A3 0 1 0xCD 0 0 "TH2"        ;
  37. A3 0 1 0xCC 0 0 "TL2"        ;
  38. A3 0 1 0x89 0 0 "TMOD"        ;
  39. A3 1 0 0x88 0 0 "IT0"        ;
  40. A3 1 0 0x89 0 0 "IE0"        ;
  41. A3 1 0 0x8A 0 0 "IT1"        ;
  42. A3 1 0 0x8B 0 0 "IE1"        ;
  43. A3 1 0 0x8C 0 0 "TR0"        ;
  44. A3 1 0 0x8D 0 0 "TF0"        ;
  45. A3 1 0 0x8E 0 0 "TR1"        ;
  46. A3 1 0 0x8F 0 0 "TF1"        ;
  47. A3 1 0 0x98 0 0 "RI"        ;
  48. A3 1 0 0x99 0 0 "TI"        ;
  49. A3 1 0 0x9A 0 0 "RB8"        ;
  50. A3 1 0 0x9B 0 0 "TB8"        ;
  51. A3 1 0 0x9C 0 0 "REN"        ;
  52. A3 1 0 0x9D 0 0 "SM2"        ;
  53. A3 1 0 0x9E 0 0 "SM1"        ;
  54. A3 1 0 0x9F 0 0 "SM0"        ;
  55. A3 1 0 0xA8 0 0 "EX0"        ;
  56. A3 1 0 0xA9 0 0 "ET0"        ;
  57. A3 1 0 0xAA 0 0 "EX1"        ;
  58. A3 1 0 0xAB 0 0 "ET1"        ;
  59. A3 1 0 0xAC 0 0 "ES"        ;
  60. A3 1 0 0xAD 0 0 "ET2"        ;
  61. A3 1 0 0xAF 0 0 "EA"        ;
  62. A3 1 0 0xB0 0 0 "RXD"        ;
  63. A3 1 0 0xB1 0 0 "TXD"        ;
  64. A3 1 0 0xB2 0 0 "INT0"        ;
  65. A3 1 0 0xB3 0 0 "INT1"        ;
  66. A3 1 0 0xB4 0 0 "T0"        ;
  67. A3 1 0 0xB5 0 0 "T1"        ;
  68. A3 1 0 0xB6 0 0 "WR"        ;
  69. A3 1 0 0xB7 0 0 "RD"        ;
  70. A3 1 0 0xB8 0 0 "PX0"        ;
  71. A3 1 0 0xB9 0 0 "PT0"        ;
  72. A3 1 0 0xBA 0 0 "PX1"        ;
  73. A3 1 0 0xBB 0 0 "PT1"        ;
  74. A3 1 0 0xBC 0 0 "PS"        ;
  75. A3 1 0 0xBD 0 0 "PT2"        ;
  76. A3 1 0 0xBF 0 0 "PCT"        ;
  77. A3 1 0 0xC8 0 0 "CAP2"        ;
  78. A3 1 0 0xC9 0 0 "CNT2"        ;
  79. A3 1 0 0xCA 0 0 "TR2"        ;
  80. A3 1 0 0xCB 0 0 "EXEN2"        ;
  81. A3 1 0 0xCC 0 0 "TCLK"        ;
  82. A3 1 0 0xCD 0 0 "RCLK"        ;
  83. A3 1 0 0xCE 0 0 "EXF2"        ;
  84. A3 1 0 0xCF 0 0 "TF2"        ;
  85. A3 1 0 0xD0 0 0 "P"            ;
  86. A3 1 0 0xD2 0 0 "OV"        ;
  87. A3 1 0 0xD3 0 0 "RS0"        ;
  88. A3 1 0 0xD4 0 0 "RS1"        ;
  89. A3 1 0 0xD5 0 0 "F0"        ;
  90. A3 1 0 0xD6 0 0 "AC"        ;
  91. A3 1 0 0xD7 0 0 "CY"        ;
  92. A3 1 0 0xF8 0 0 "ALF"        ;
  93. A3 1 0 0xF9 0 0 "P1F"        ;
  94. A3 1 0 0xFA 0 0 "P2F"        ;
  95. A3 1 0 0xFB 0 0 "P3F"        ;
  96. A3 1 0 0xFC 0 0 "IZC"        ;
  97. A3 1 0 0xFD 0 0 "SERR"        ;
  98. A3 1 0 0xFE 0 0 "T32"        ;
  99. A3 1 0 0xFF 0 0 "WDT"        ;
  100. A4    0x10000    
  101. 0xFFFF;    
  102. A5    0x10000    
  103. 0xFFFF;    
  104. A6 256 128;
  105. A7 "3.004" ;    
  106. A8
  107. 3    
  108. 1    
  109. 3    
  110. 3    
  111. 0    
  112. ;    
  113. A9        
  114. 1        
  115. 0        
  116. 0        
  117. 0        
  118. "\x0A"    
  119. &"\x00"    
  120. &"\xE0"    
  121. &"\x88"    
  122. &"\xC8"    
  123. &"\x83"    
  124. &"\x82"    
  125. &"\xA8"    
  126. &"\xD0"    
  127. &"\xF0"    
  128. &"\x81"    
  129. &"\x00"    
  130. &"\x00"    
  131. &"\x00"    
  132. &"\x00"    
  133. &"\x00"    
  134. &"\x00"    
  135. &"\x40"    
  136. &"\x00"    
  137. &"\x00"    
  138. &"\x07"    
  139. &"\x00"    
  140. &"\xDC"    
  141. &"\xC8"    
  142. &"\xB4"    
  143. &"\xA8"    
  144. &"\x9C"    
  145. &"\x90"    
  146. &"\x84"    
  147. &"\x78"    
  148. &"\x6C"    
  149. &"\x7D"    
  150. &"\x62"    
  151. &"\x76"    
  152. &"\x72"    
  153. &"\x6E"    
  154. &"\x6A"    
  155. &"\x7A"    
  156. &"\x66"    
  157. &"\x5E"    
  158. &"\x5A"    
  159. ;        
  160. A9                    
  161. 2                    
  162. 0                    
  163. 0                    
  164. 0                    
  165. "\x85\xA8\xA8\xA8"    
  166. &"\x00\x00"            
  167. &"\x00\x00"            
  168. &"\x00\x00"            
  169. &"\x00\x00"            
  170. &"\x00\x00"            
  171. &"\x00\x00"            
  172. &"\x00\x00"            
  173. &"\x00\x00"            
  174. &"\x00\x00"            
  175. &"\x00\x00"            
  176. &"\x00\x00"            
  177. &"\x00\x00"            
  178. &"\x00\x00"            
  179. &"\x00\x00"            
  180. &"\x00\x00"            
  181. &"\x00\x00"            
  182. &"\x00\x00"            
  183. &"\x00\x00"            
  184. &"\x00\x00"            
  185. &"\x00\x00"            
  186. &"\x00\x00"            
  187. &"\x00\x00"            
  188. &"\x00\x00"            
  189. &"\x00\x00"            
  190. &"\x00\x00"            
  191. &"\x00\x00"            
  192. &"\x00\x00"            
  193. &"\x00\x00"            
  194. &"\x00\x00"            
  195. &"\x00\x00"            
  196. &"\x00\x00"            
  197. &"\x00\x00"            
  198. &"\x00\x00"            
  199. &"\x00\x00"            
  200. &"\x00\x00"            
  201. &"\x00\x00"            
  202. &"\x00\x00"            
  203. &"\x00\x00"            
  204. &"\x00\x00"            
  205. &"\x00\x00"            
  206. &"\x00\x00"            
  207. &"\x00\x00"            
  208. &"\x75\x81\zGG\x00"    
  209. &"\x75\xF0\zHH\x00"    
  210. &"\x75\xE0\zII\x00"    
  211. &"\x75\xD0\zJJ\x00"    
  212. &"\x75\x82\zKK\x00"    
  213. &"\x75\x83\zLL\x00"    
  214. &"\x75\xC8\zMM\x00"    
  215. &"\x75\x88\zNN\x00"    
  216. &"\x75\xA8\zPP\x00"    
  217. &"\x02\zRR\zRR\x00"    
  218. ;                    
  219. A9                    
  220. 3                    
  221. 0                    
  222. 0                    
  223. 0                    
  224. "\x85\xA8\xA8\xA8"    
  225. &"\x85\xA8\xA8\xA8"    
  226. &"\x10\xAF\xFE\x00"    
  227. &"\x02\x00\x00\x00"    
  228. &"\x83\x00\x00\zTV"    
  229. &"\xE5\x88"            
  230. &"\x75\x88\x00\x00"    
  231. &"\x83\x00\x00\zTV"    
  232. &"\xE5\xC8"            
  233. &"\x75\xC8\x00\x00"    
  234. &"\x83\x00\x00\zTV"    
  235. &"\xE5\x83"            
  236. &"\x83\x00\x00\zTV"    
  237. &"\xE5\x82"            
  238. &"\x83\x00\x00\zTV"    
  239. &"\xE5\xA8"            
  240. &"\x83\x00\x00\zTV"    
  241. &"\xE5\xD0"            
  242. &"\x83\x00\x00\zTV"    
  243. &"\xE5\xF0"            
  244. &"\x83\x00\x00\zTV"    
  245. &"\xE5\x81"            
  246. &"\x83\x00\x00\zTV"    
  247. &"\x75\xD0\x00\x00"    
  248. &"\x00\x00"            
  249. &"\x00\x00"            
  250. &"\x00\x00"            
  251. &"\x00\x00"            
  252. &"\x00\x00"            
  253. &"\x00\x00"            
  254. &"\x00\x00"            
  255. &"\x00\x00"            
  256. &"\x00\x00"            
  257. &"\x00\x00"            
  258. &"\x00\x00"            
  259. &"\x00\x00"            
  260. &"\x00\x00"            
  261. &"\x00\x00"            
  262. &"\x00\x00"            
  263. &"\x00\x00"            
  264. &"\x00\x00"            
  265. &"\x00\x00"            
  266. &"\x00\x00"            
  267. &"\x00\x00"            
  268. &"\x00\x00"            
  269. &"\x00\x00"            
  270. &"\x02\x00\x00\x00"    
  271. ;                    
  272. A9            
  273. 4            
  274. 0            
  275. 0            
  276. 0            
  277. "\x00"        
  278. &"\x01\x00"    
  279. ;            
  280. A9                            
  281. 5                            
  282. 0                            
  283. 0                            
  284. 0                            
  285. "\x01"                        
  286. &"\xAF"    
  287. &"\xF0"    
  288. ;                            
  289. A9        
  290. 6        
  291. 0        
  292. 0        
  293. 0        
  294. "\x07"    
  295. &"\x00"    
  296. &"\x03\x0B\x13\x1B\x23\x2B";
  297. A11    0;    # This directive specifies the order in which the SFRs will
  298. #         be displayed in the Interrogate and Modify Registers Menus:
  299. #           0:  display SFRs (left-to-right, top-to-bottom)
  300. #               in the order supplied in the Model File
  301. #           1:  display SFRs (left-to-right, top-to-bottom)
  302. #               alphabetically (ASCII collating sequence)
  303. #           2:  display SFRs (left-to-right, top-to-bottom)
  304. #               in increasing address order
  305. A12 1;
  306. A13   6  "\x03\x0B\x13\x1B\x23\x2B";
  307. A14 8;    
  308. A15 0;    
  309. A19 0x8F "2.25";    
  310. A22 4096 516 8192;    
  311. A23 3;
  312. A24 1 0 0x00000 0x10000 0x10000 0x10000 0x10000 0x00000  0 0    0 0xBE 0 1   0 "Mode 1: ROMless (803X) Operation, /EA = Low";
  313. A24 2 1 0x04000 0x04000 0x10000 0x00000 0x10000 0x03FF0 16 0    0 0xC8 1 2   0 "Mode 2: ROM (805X), /EA = High";
  314. A25  0;
  315. A26  0;
  316. A27 0 0;    
  317. A28 0 0;    
  318. A33  0;
  319. A36 0 # post-file   delay == 0 milliseconds (no delay)
  320. 0;    # post-module delay == 0 milliseconds (no delay)
  321. #
  322. #    A40 <technique> <video_RAM_address_override> <MBZ> ;
  323. #
  324. #        <technique>
  325. #
  326. #            0    Perform PC video display output by                 (DEFAULT)
  327. #                writing directly to video RAM.
  328. #                This option should be specified only when using
  329. #                PC's that are 100%-IBM-hardware-compatible.
  330. #                This is the fastest technique.
  331. #
  332. #                Users with older CGA video controllers may notice some
  333. #                flickering in the display when this technique is used.
  334. #                The flickering can be eliminated by choosing <technique> 1
  335. #                below.
  336. #
  337. #                The ANSI.SYS device driver may or may not be loaded,
  338. #                at the user's discretion, with no ill effects.
  339. #
  340. #                See also <video_RAM_address_override> below.
  341. #
  342. #            1    Perform PC video display output by
  343. #                using BIOS interrupts (only).
  344. #                This option should be specified when using
  345. #                PC's that are not 100%-IBM-hardware-compatible,
  346. #                but that do have a 100%-IBM-compatible BIOS.
  347. #                This is the next fastest technique.
  348. #
  349. #                The ANSI.SYS device driver may or may not be loaded,
  350. #                at the user's discretion, with no ill effects.
  351. #
  352. #            2    Perform PC video display output by
  353. #                using (indirectly) DOS interrupts.
  354. #                This option should be specified when using
  355. #                PC's that are not 100%-IBM-hardware-compatible
  356. #                and do not have a 100%-IBM-compatible BIOS.
  357. #                This is the slowest technique.
  358. #
  359. #                When this technique is used with a color monitor
  360. #                and the device driver ANSI.SYS has been loaded, the
  361. #                colors in effect at the time the host software is
  362. #                invoked will "bleed through" into the display.
  363. #
  364. #        <video_RAM_address_override>
  365. #
  366. #            The value in this field has meaning only when the video
  367. #            display <technique> above is 0 (write directly to video RAM)
  368. #            and the value specified here is non-zero.
  369. #            The host software automatically uses the following base
  370. #            addresses for video RAM:
  371. #
  372. #                0xB000        for a Monochrome Display Adapter
  373. #                0xB800        for a Color/EGA  Display Adapter
  374. #
  375. #            If your display adapter is set up to use a different address,
  376. #            then specify that address here.  It should be in the form
  377. #            0xhhhh, where "hhhh" is the hexadecimal address of the base
  378. #            of the video RAM segment.
  379. #
  380. #        <MBZ>
  381. #
  382. #            0    (Must Be Zero)
  383. #
  384. A40 0 0x0000 0; # display output by writing directly to video RAM
  385. A41 0 # HLL source display:  leading blanks -- skip (1) / don't skip (0)
  386. 4;    # HLL source display:  tab stops (column width) for ASCII TAB chars (0-10)
  387. # A42 directive is for Performance Analyzer (primarily):
  388. A42 0xDB # 4% bar char  (video display)
  389. '#'      # 4% bar char  (when writing to file)
  390. 0x10     # 2% bar char  (video display)
  391. '>'      # 2% bar char  (when writing to file)
  392. 0xE6     # "micro-" (mu) symbol (video display)
  393. 'u'      # "micro-" (mu) symbol (when writing to file)
  394. 0xB3     # vertical line char   (video display)
  395. '|'      # vertical line char   (when writing to file)
  396. 0;       # in Symbolic and Mixed mode, display both Global & Local code labels
  397. #        #   (0 = Globals & Locals, 1 = Globals only, 2 = Locals only)
  398. A43 ','; # separator for every 3rd digit in time/count values
  399. A46    201        
  400. 299;    
  401. A47    260209    
  402. 0;        
  403. A48    100    
  404. 0;    
  405. #
  406. #A49:
  407. #
  408. #        The 1st number in the A49 directive is used to set the
  409. #        time-out limit for normal reception from, and transmission to,
  410. #        the emulator.  Note that the number specified here is not
  411. #        an actual clock time value, but rather a count for the number
  412. #        of times the host SW will execute (wait in) the innermost
  413. #        "wait for a byte to be received" or
  414. #        "wait for a byte to be transmitted" loop.  The larger the number,
  415. #        the longer the time-out interval will be (i.e., the more times the
  416. #        host SW will execute the innermost "wait" loop before declaring
  417. #        an actual time-out).  Generally, faster host computers will require
  418. #        a larger number here;  slower host computers can get by with a
  419. #        smaller number.  Note that if the number here is too large and there
  420. #        actually is a communication failure/problem, it will take a very
  421. #        long time for the host SW to detect and report the problem.
  422. #
  423. #        The 2nd number in the A49 directive is used to set the
  424. #        time-out limit for the quick communication test routine
  425. #        which is used to detect a warm-start condition when the host SW
  426. #        is first invoked.  The larger the number specified here,
  427. #        the longer the host SW will wait for a response from the emulator
  428. #        during the host SW's one-time-initialization
  429. #        (only performed when the host SW is first invoked).
  430. A49        #
  431. 5    # 1st RS232 communication time-out limit (normal comm)
  432. 4    # 2nd RS232 communication time-out limit (warm-start comm test)
  433. ;    # end of A49
  434. #
  435. #A50:
  436. #        The following variables are used to set the display mode for
  437. #        each data type when displaying symbol values.  The modes are as follows:
  438. #        0 = hex format   1 = decimal format   2 = character format
  439. #
  440. #        The data display variable will revert to its default format for any
  441. #        mode number specified other than those above.
  442. #
  443. A50        #
  444. 0    # char              default: hex
  445. 0    # unsigned char     default: hex
  446. 1    # int               default: decimal
  447. 1    # unsigned int      default: decimal
  448. 1    # long              default: decimal
  449. 1    # unsigned long     default: decimal
  450. 0    # float             default: hex
  451. ;    # end of A50
  452. A51    1 ;        
  453. #.(Begin_Help_File)
  454. #.($3)Configure
  455. #The \bConfigure\r pull-down menu allows you to set up and customize
  456. #various aspects of the operation of the emulator and
  457. #the host software.
  458. #.($4)Emulator
  459. #The \bEmulator\r command invokes a pop-up menu to allow you to
  460. #establish the operational characteristics of the emulator base
  461. #and the probe card (pod).  These include such things as
  462. #the probe card's \l($6)mode\m of operation, and
  463. #the \l($17)communication^port\m
  464. #and \l($20)baud^rate\m
  465. #to be used for the RS-232 communication
  466. #link between the host PC and the emulator base.
  467. #.($5)Execute
  468. #The \bExecute\r command first establishes communication between
  469. #the host software system and the emulator base unit.
  470. #Then, the host software initializes the emulator base.
  471. #This initialization usually only needs to be performed once
  472. #at the beginning of each session.
  473. #.sp 1
  474. #The host sofware uses the current values associated with \l($6)Mode\m,
  475. #\l($17)Comm^port\m and \l($20)Baud^rate\m to
  476. #establish communication and initialize the emulator base.
  477. #When you change any of these values, all three are written to
  478. #the \b$CONFIG\r file.  The host software automatically reads
  479. #this file when it begins executing.  Thus, if you change any
  480. #of these values, the new settings become your defaults.
  481. #.($6)Mode
  482. #The \bMode\r command allows you to specify the probe card's mode
  483. #of operation.  This command is available only for those probe cards
  484. #which can operate in different modes.  The available modes are
  485. #different for each probe card. Typically, these modes consist of
  486. #combinations of:
  487. #.sp 1
  488. #.in +2 {
  489. #.in +3 {
  490. #.ti -3
  491. #-^^ROM mode / ROMless mode
  492. #.ti -3
  493. #-^^WDT (Watchdog Timer) On / WDT Off
  494. #.in -3 }
  495. #.in -2 }
  496. #.sp 1
  497. #Determine how the probe card should operate, based on your
  498. #application and your target system environment, and then select
  499. #the appropriate mode.
  500. #.($17)Comm port
  501. #The \bComm^port\r command allows to select the RS-232 communication
  502. #port on your computer which the host software will use to communicate
  503. #with the emulator base.  The available communication ports are COM1
  504. #and COM2.
  505. #.($20)Baud rate
  506. #The \bBaud^rate\r command allows you to select the baud rate
  507. #that the host software will use during communication with the
  508. #emulator base.  Normally, you should choose the highest (fastest)
  509. #available baud rate to maximize system throughput.
  510. #However, you may need to select a lower (slower) baud rate if:
  511. #.sp 1
  512. #.in +2 {
  513. #.in +3 {
  514. #.ti -3
  515. #-^^the emulator base is a long distance from your computer
  516. #.ti -3
  517. #-^^the 8250 UART chip in your computer cannot sustain
  518. #high-speed RS-232 communications
  519. #.in -3 }
  520. #.in -2 }
  521. #.sp 1
  522. #After establishing communication with the emulator base,
  523. #the baud rate may not be changed
  524. #unless the emulator is reset.
  525. #.($30)Code Memory Mapping
  526. #The \bCode^Memory\r command invokes a pop-up menu allowing
  527. #you to map Code memory
  528. #to either the emulator base or the target board.
  529. #.($31)Map Block To Emulator
  530. #The \bEmulator\r command maps a block of Code memory to the
  531. #emulator base.  You will be prompted for the starting and ending
  532. #addresses of the range you wish to map to the emulator base.
  533. #.($32)Map Block To Target
  534. #The \bTarget\r command maps a block of Code memory to the
  535. #target board.  You will be prompted for the starting and ending
  536. #addresses of the range you wish to map to the target board.
  537. #.($33)Mapping All Memory
  538. #The \bAll\r command quickly maps all of Code memory to either
  539. #the emulator base or the target board.  After selecting the \bAll\r
  540. #command a pull-down menu will be displayed with the two choices
  541. #\l($34)Emulator\m and \l($35)Target\m available.
  542. #.($34)Emulator
  543. #The \bEmulator\r command quickly maps all of Code memory to the
  544. #emulator base.
  545. #.($35)Target
  546. #The \bTarget\r command quickly maps all of Code memory to the
  547. #target board.
  548. #.($36)Load
  549. #The \bLoad\r command reads Code memory mapping information previously
  550. #\l($37)Save\md in a file
  551. #and establishes that Code memory mapping.
  552. #.($37)Save
  553. #The \bSave\r command saves (writes) the current Code memory
  554. #mapping information into a file.  At a later time, the mapping
  555. #can be restored to its current state by using
  556. #the \l($36)Load\m command.
  557. #.($38)Xdata Memory Mapping
  558. #The \bXdata^Memory\r command invokes a pop-up menu allowing
  559. #you to map External Data memory
  560. #to either the emulator base or the target board.
  561. #.($39)Map Block to Emulator
  562. #The \bEmulator\r command maps a block of External Data memory to the
  563. #emulator base.  You will be prompted for the starting and ending
  564. #addresses of the range you wish to map to the emulator base.
  565. #.($40)Map Block to Target
  566. #The \bTarget\r command maps a block of External Data memory to the
  567. #target board.  You will be prompted for the starting and ending
  568. #addresses of the range you wish to map to the target board.
  569. #.($41)Mapping All Memory
  570. #The \bAll\r command quickly maps all of External Data memory to either
  571. #the emulator base or the target board.  After selecting the \bAll\r
  572. #command a pull-down menu will be displayed with the two choices
  573. #\l($42)Emulator\m and \l($43)Target\m.
  574. #.($42)Emulator
  575. #The \bEmulator\r command quickly maps all of External Data memory to
  576. #the emulator base.
  577. #.($43)Target
  578. #The \bTarget\r command quickly maps all of External Data memory to
  579. #the target board.
  580. #.($44)Load
  581. #The \bLoad\r command reads External Data memory mapping information
  582. #previously \l($45)Save\md in a file
  583. #and establishes that External Data memory mapping.
  584. #.($45)Save
  585. #The \bSave\r command saves (writes) the current External Data memory
  586. #mapping information into a file.  At a later time, the mapping
  587. #can be restored to its current state by using
  588. #the \l($44)Load\m command.
  589. #.($46)Display Attributes
  590. #The display \bAttributes\r command invokes a pop-up menu which
  591. #allows you to customize the characteristics of the video display
  592. #on your host PC.
  593. #.($47)Lines
  594. #The \bLines\r command allows you change the total number of
  595. #lines displayed on your screen.
  596. #The choices available are dependent on the
  597. #video display adapter installed in your host PC:
  598. #.sp 1
  599. #.in +4 {
  600. #.ba {
  601. #MDA (Monochrome Display  Adapter):   25 lines
  602. #.sp 1
  603. #CGA (Color      Graphics Adapter):   25 lines
  604. #.sp 1
  605. #EGA (Enhanced   Graphics Adapter):   25 lines
  606. #                                     43 lines
  607. #.sp 1
  608. #VGA (Video      Graphics Array  ):   25 lines
  609. #                                     28 lines
  610. #                                     50 lines
  611. #.ea }
  612. #.in -4 }
  613. #.($48)
  614. #The 25-line display mode is the default and is available
  615. #when using any video adapter or monitor in your PC.
  616. #.($49)
  617. #The 28-line display mode is available only when certain video
  618. #adapters are installed in your PC.  See \l($47)Lines\m for details.
  619. #.($50)
  620. #The 43-line display mode is available only when certain video
  621. #adapters are installed in your PC.  See \l($47)Lines\m for details.
  622. #.($51)
  623. #The 50-line display mode is available only when certain video
  624. #adapters are installed in your PC.  See \l($47)Lines\m for details.
  625. #.($53)CGA/EGA/VGA Default
  626. #The \bCGA/EGA/VGA Default\r command sets up video colors and other
  627. #display attributes suitable for all color monitor types.
  628. #The supplied binary file $CLR1$ contains these color definitions.
  629. #These definitions make use of 16 foreground colors,
  630. #but only 8 background colors.  If you have an EGA or VGA installed
  631. #in your system, the \l($54)EGA/VGA^Default\m provides a full
  632. #16 background colors.
  633. #.($54)EGA/VGA Default
  634. #The \bEGA/VGA Default\r command sets up video colors and other
  635. #display attributes suitable for EGA & VGA color monitors.
  636. #The supplied binary file $CLR2$ contains these color definitions.
  637. #These definitions make full use of 16 foreground \uand\r 16 background
  638. #colors.  If you accidentally (or intentionally) select this command
  639. #when the display adapter installed in your PC is actually a CGA
  640. #or Monochrome adapter, many areas of the screen will blink!
  641. #This is because the $CLR2$ file is set up assuming that the
  642. #video display attribute control bit for "blink" actually means
  643. #"bold (or bright) background".
  644. #.($55)Monochrome Default
  645. #The \bMonochrome Default\r command sets up video
  646. #display attributes suitable for monochrome adapters/monitors.
  647. #The supplied binary file $CLRM$ contains these color definitions.
  648. #The only "color", other than black & white, available
  649. #for monochrome adapters is blue.  However, "blue" does not display
  650. #as blue, but rather as \uunderline\ring.
  651. #If you accidentally (or intentionally) select this command
  652. #when the display adapter installed in your PC is actually
  653. #something other than a Monochrome adapter, the video display
  654. #indeed \uwill\r be painted in a rather hideous combination
  655. #of black, white and blue.
  656. #.($56)User
  657. #The \bUser\r command sets up video colors and other
  658. #display attributes to your customized settings.
  659. #The binary file $COLOR (not supplied) contains these color definitions.
  660. #.sp 1
  661. #To create your own customized, default color definitions, first
  662. #invoke the \l($57)Select\m command to change individual display
  663. #attribute settings.  Then, \l($76)Save\m those settings into
  664. #the $COLOR file, making sure that the \bSave Option\r
  665. #for \l($79)Colors\m is \uon\r.
  666. #.sp 1
  667. #The $COLOR file is read during \b%rs1\r initialization,
  668. #thus establishing your own customized, default color definitions.
  669. #.($57)Select
  670. #The \bSelect\r command allows you to select/modify video colors and
  671. #other display attributes individually.
  672. #.($58)Windows
  673. #The \bWindows\r command invokes a pop-menu allowing you to customize
  674. #the characteristics of the windows on the main screen.
  675. #.sp 1
  676. #The data in each of the windows is updated after every emulation
  677. #cycle (\l($96)Run\m) or whenever you change the value in a
  678. #register, memory location or variable.
  679. #.sp 1
  680. #We recommend that you first \l($59)Modify\m the windows to:
  681. #.sp 1
  682. #.in +2 {
  683. #.in +4 {
  684. #.ti -4
  685. #1)^^Specify which windows will be active (present) or
  686. #inactive (absent).
  687. #.ti -4
  688. #2)^^Determine the order in which the windows will be
  689. #displayed (top of screen {1} to bottom of screen {n}).
  690. #.in -4 }
  691. #.in -2 }
  692. #.sp 1
  693. #and then \l($60)Size\m the windows to suit your needs.
  694. #.($59)Configure|Windows|Modify
  695. #The \bModify\r command allows you to define the layout and content
  696. #of all the windows on the main screen.
  697. #Use the arrow keys to move the highlighted cursor to the attribute
  698. #you wish to change and then follow the directions displayed
  699. #on the bottom border of the box.
  700. #.sp 1
  701. #The window attributes which you can change in this menu are:
  702. #.sp 1
  703. #.in +2 {
  704. #.in +5 {
  705. #.ti -5
  706. #\bActive\r
  707. #.sp 1
  708. #Each window can either be active (present, \bYes\r)
  709. #or inactive (absent, \bNo\r).  By default, the only inactive window
  710. #is the Watch Window.  And yes, you can operate the \b%rs1\r system
  711. #with all the windows inactive.
  712. #.sp 1
  713. #.ti -5
  714. #\bOrder\r
  715. #.sp 1
  716. #The order of presentation of the window names in
  717. #the \bWindow\r & \bOrder\r columns mirrors the order in which the
  718. #windows will appear on the main screen (top to bottom).
  719. #.sp 1
  720. #.ti -5
  721. #\bStart^Address\r
  722. #.sp 1
  723. #For most of the "dump" style windows, you can
  724. #specify the starting address for the data which will be displayed
  725. #in each window.  The Stack Window always contains as much of the
  726. #stack as possible.  Its starting address fluctuates from one
  727. #emulation cycle to the next, based on the content of the
  728. #Stack Pointer register (@SP).
  729. #For the External Data window, you can choose
  730. #whether you want this same behavior with respect to the Data Pointer
  731. #register (@DPTR), or simply a fixed starting address.
  732. #The Source Window always reflects the source lines and/or
  733. #machine instructions
  734. #in the vicinity of the value in the Program Counter register (@PC).
  735. #.sp 1
  736. #.ti -5
  737. #\bOptions\r
  738. #.sp 1
  739. #Each window has certain unique, user-controllable display
  740. #characteristics.
  741. #For all of the "dump" style windows, you can
  742. #specify whether you want to see the data in both hexadecimal
  743. #and ASCII formats, or in hexadecimal format only.
  744. #For the Register Window, you can define the fill character
  745. #which separates an SFR's name from its current content (value).
  746. #.in -5 }
  747. #.in -2 }
  748. #.($60)Configure|Windows|Size
  749. #The \bSize\r command allows you to make each window on the main screen
  750. #larger (taller) or smaller (shorter).
  751. #We recommend that you size the windows from top-of-screen to
  752. #bottom-of-screen.
  753. #The sizes of all windows \ubelow\r the one you are currently
  754. #adjusting will change automatically in response to your adjustments.
  755. #The sizes of all windows \uabove\r the one on which you are currently
  756. #working will remain unchanged.
  757. #.sp 1
  758. #The Quick Help line at the bottom of the screen shows you which
  759. #keys to use to affect the size changes.  If you 'Exit' without
  760. #'Accept'ing the changes made to the last selected window,
  761. #that window will revert to its former size.
  762. #.($61)Configure|Windows|Goto
  763. #The \bGoto\r command allows you to select, or "jump into", the
  764. #the windows on the main screen.
  765. #When you do this, you can peruse and/or change the data in the
  766. #windows.  To change a value, you don't even have to press the
  767. #\bEnter\r key to pop-up the dialog box -- simply start typing
  768. #the new value for the highlighted location/item and the
  769. #dialogue box pops up automatically.
  770. #.sp 1
  771. #The Quick Help line at the bottom of the screen shows you which
  772. #keys to use in perusing the windows.
  773. #.sp 1
  774. #\bHint:\r
  775. #.sp 1
  776. #.in +2 {
  777. #As an additional, convenient shortcut to invoke
  778. #the \bConfigure|Windows|Goto\r command,
  779. #you can press the \bTab\r or \bShift^Tab\r keys when
  780. #no pull-down menus are hanging off the top menu bar on the
  781. #main screen.
  782. #.in -2 }
  783. #.($62)Configure|Windows|Add Watch
  784. #The \bAdd\r command allows you to add a watch variable to the
  785. #Watch Window.
  786. #.sp 1
  787. #You can think of the Watch Window as one or more
  788. #peepholes into different areas of
  789. #memory, where you specify the starting addresses symbolically
  790. #(the names of the variables, registers or bits),
  791. #and where the displayed values
  792. #are interpreted according to the individual data types of the
  793. #variables (if such information is available in the program file).
  794. #.sp 1
  795. #The Watch Window must be active before you can add anything to it.
  796. #.sp 1
  797. #There is no limit on the number of entities which can be
  798. #watched -- the Watch Window is scrollable.
  799. #.sp 1
  800. #If the value of a variable in the Watch Window changes
  801. #from one emulation cycle to the next
  802. #(see \l($96)Run\m),
  803. #that value will be highlighted to alert you of the change.
  804. #.($63)Configure|Windows|Delete Watch
  805. #The \bDelete\r command allows you to delete (remove) a
  806. #watch variable from the Watch Window.
  807. #.($64)Identification
  808. #The \bIdentification\r command pops up a window
  809. #describing the properties of your \b%rs1\r emulator system.
  810. #The information displayed includes such things as hardware,
  811. #firmware and software version numbers, memory sizes, model numbers
  812. #and option configurations.
  813. #Such information is useful, for example, when you
  814. #call %rs2 for Technical Support at %rs3.
  815. #.($65)Options
  816. #The \bOptions\r command pops up a menu which allows you
  817. #to customize miscellaneous characteristics of the user
  818. #interface configuration.
  819. #.($67)Alert|Diagnostics
  820. #The \bDiagnostics\r command toggles whether or not
  821. #your computer will beep when the host software pops up a diagnostic
  822. #message box.  This toggle command applies to all types of
  823. #diagnostics:  errors, warnings and informative diagnostics.
  824. #.($68)Alert|Bad Key/Command
  825. #The \bBad^key/command\r command toggles whether or not
  826. #your computer will beep when you:
  827. #.sp 1
  828. #.in +4 {
  829. #.in +4 {
  830. #.ti -4
  831. #1)^^Press a key that is not recognized (does not apply)
  832. #in a particular context.
  833. #.ti -4
  834. #2)^^Select an inactive (inaccessible) command in a pull-down
  835. #or pop-up menu.
  836. #.in -4 }
  837. #.in -4 }
  838. #.($69)Alert|Host-break
  839. #Pressing the \bEsc\r key to break (stop) emulation is called
  840. #"stopping emulation via a Host-break".
  841. #.sp 1
  842. #The \bAlert|Host-break\r command toggles whether or not
  843. #your computer will beep when you break emulation via a "Host-break".
  844. #(The computer will never beep when emulation stops because a normal
  845. #hardware breakpoint was reached.)
  846. #.($70)Flicker
  847. #The \bFlicker/command\r command toggles whether or not
  848. #the host software will flicker displayed information in
  849. #various contexts.
  850. #The software uses flickering as a form of
  851. #immediate visual feedback to confirm that
  852. #"something has happened" or "this action was taken".
  853. #.sp 1
  854. #Currently, the software employs flickering to show the:
  855. #.sp 1
  856. #.in +4 {
  857. #.in +4 {
  858. #.ti -4
  859. #1)^^selected response in a "Yes/No/Cancel" dialog.
  860. #.sp 1
  861. #.ti -4
  862. #2)^^new value assigned to a variable or register when that
  863. #variable or register is changed using the \l($118)Var/Reg\m command
  864. #\uand\r both the name and new value are typed in the
  865. #same input box.
  866. #.in -4 }
  867. #.in -4 }
  868. #.($71)Trace Prefetch
  869. #The \bTrace^prefetch\r command toggles whether or not
  870. #the host software will prefetch (read) raw trace buffer data from the
  871. #\b%rs1\r emulator during keyboard "idle" time.
  872. #.($72)Main Esc
  873. #The \bMain^Esc^\r command controls the host software's behavior
  874. #when you press the \bEsc\r key when no pull-down menus are visible
  875. #(pulled down) on the main screen:
  876. #.sp 1
  877. #.in +2 {
  878. #.in +6 {
  879. #.ti -6
  880. #On:^^^The host software asks whether or not you really
  881. #want to exit completely back to DOS.
  882. #.ti -6
  883. #Off:^^The host software treats the \bEsc\r key as an unrecognized
  884. #keystroke and handles it according to the current setting
  885. #of the \l($68)Alert|Bad^key/command\m toggle.
  886. #.in -6 }
  887. #.in -2 }
  888. #.sp 1
  889. #Note that the \l($121)File|Exit\m command provides an alternative
  890. #method for exiting back to DOS.
  891. #.($73)Function-Key
  892. #The \bFunction-Key\r command calls a pull-down menu that
  893. #gives you access to commands to change the number of
  894. #\l($74)Lines\m of function key labels displayed and to
  895. #\l($75)Modify\m function key assignments.
  896. #.($74)Lines
  897. #The \bLines\r command is used to specify the number of lines of
  898. #\l($75)Function^Key\m labels to display at the bottom of the screen.
  899. #Up to four lines may be used (corresponding to all function keys
  900. #and their Shift, Alt, and Ctrl states).  Specifying 0 lines
  901. #shuts off the display of function key labels.
  902. #.($75)Modify Function Key Assignments
  903. #The \bModify\r command calls a pop up menu from which you may
  904. #modify function key assignments.  From this menu you may
  905. #\l($107)Assign\m new commands to function keys, \l($108)Clear\m
  906. #function key assignments, activate (\l($111)Save\m) new
  907. #assignments for the duration of the current session
  908. #and \l($112)Write\m an assignment/option report.
  909. #.sp 1
  910. #The function key menu is divided into two windows, the
  911. #\bAssignment^Window\r and the \bOption^Window\r.  The assignment
  912. #window is used to display each function key and its assigned option.
  913. #The short description of the assigned option is always displayed and
  914. #depending on the \l($110)Display^Mode\m a long description may also
  915. #be displayed.  The option window is used to display all the
  916. #possible options available for assignment.  The short description
  917. #of each option is always displayed and depending on the display
  918. #mode the long description may also be displayed.
  919. #.sp 1
  920. #The short description of an assignment option is the description
  921. #that is shown for the \l($74)Function^Key^Labels\m displayed at the
  922. #bottom of the screen.  The long description of an assignment option
  923. #is the full command path to a command (e.g., the full command
  924. #path to the current command is \bConfigure|Function-Keys|Modify\r).
  925. #.($76)Save
  926. #The \bSave\r command lets you selectively save various
  927. #facets of the current user interface configuration.
  928. #By doing so, you create new default settings for the user
  929. #interface configuration.
  930. #.($77)Save|Save
  931. #The \bSave\r command saves the current user interface configuration
  932. #environment according to the setting of the 'Save Opts' controls
  933. #which follow in this menu.
  934. #.($78)Lines
  935. #The setting of the \bLines\r toggle specifies whether or not the
  936. #current screen size (number of lines) will be saved into the
  937. #\b$LINES\r file when you select
  938. #the \l($77)Configure|Options|Save|Save\m command.
  939. #.($79)Colors
  940. #The setting of the \bColors\r toggle specifies whether or not the
  941. #current screen colors and highlighting controls
  942. #will be saved into the \b$COLOR\r file when you select
  943. #the \l($77)Configure|Options|Save|Save\m command.
  944. #.($80)Windows
  945. #The setting of the \bWindows\r toggle specifies whether or not the
  946. #current main screen window configuration
  947. #will be saved into the \b$WINDOW\r file when you select
  948. #the \l($77)Configure|Options|Save|Save\m command.
  949. #.($81)Alert
  950. #The setting of the \bAlert\r toggle specifies whether or not the
  951. #current \bAlert\b Options settings
  952. #will be saved into the \b$ALERT\r file when you select
  953. #the \l($77)Configure|Options|Save|Save\m command.
  954. #.($82)Miscellaneous
  955. #The setting of the \bMiscellaneous\r toggle specifies whether or not the
  956. #current \bMiscellaneous\b Options settings
  957. #will be saved into the \b$MISC\r file when you select
  958. #the \l($77)Configure|Options|Save|Save\m command.
  959. #.($83)Function Keys
  960. #The setting of the \bFunction Keys\r toggle specifies whether or not
  961. #the current function (hot) key definitions
  962. #will be saved into the \b$FKEYDEF\r file when you select
  963. #the \l($77)Configure|Options|Save|Save\m command.
  964. #.($84)Restore
  965. #The \bRestore\r command restores a previously \l($77)Save\md
  966. #user interface configuration.
  967. #.($85)File
  968. #The \bFile\r pull-down menu allows you to load programs into the
  969. #the emulator, build and run macros and save/restore the current
  970. #application environment.
  971. #.($86)File|Load
  972. #The \bLoad\r command is used to load code memory
  973. #with object code from a disk file. Several different
  974. #object file formats are accepted:
  975. #.sp 1
  976. #.in +2 {
  977. #.in +3 {
  978. #.ti -3
  979. #-^^Intel standard hex file format
  980. #.ti -3
  981. #-^^Intel absolute object module format (AOMF)
  982. #.ti -3
  983. #-^^Archimedes absolute object modules
  984. #.ti -3
  985. #-^^BSO absolute object modules
  986. #.ti -3
  987. #-^^Enertec absolute object modules
  988. #.ti -3
  989. #-^^Franklin absolute object modules
  990. #.ti -3
  991. #-^^IAR absolute object modules
  992. #.ti -3
  993. #-^^Kiel absolute object modules
  994. #.ti -3
  995. #-^^MCC absolute object modules
  996. #.ti -3
  997. #-^^Microtek Research absolute object modules
  998. #.ti -3
  999. #-^^Sysoft absolute object modules
  1000. #.ti -3
  1001. #-^^%rs2 absolute object file format.
  1002. #.in -3 }
  1003. #.in -2 }
  1004. #.sp 1
  1005. #Symbolic source-level debugging is supported with most formats.
  1006. #.sp 1
  1007. #NOTE:^^If you are loading the very first program,
  1008. #or simply reloading or replacing that program,
  1009. #respond \uNo\r to the "Merge..." prompt dialog.
  1010. #Only respond \uYes\r to the "Merge..." prompt dialog
  1011. #if you intend to merge the code and symbols from two or
  1012. #more files -- respond \uNo\r for the first
  1013. #file in the sequence and \uYes\r for all subsequent files.
  1014. #.($87)File|Store
  1015. #The \bStore\r command is used to save the status of
  1016. #the system in a system status disk file.
  1017. #It performs the complementary function of the
  1018. #\l($88)Restore\m command.
  1019. #.($88)File|Restore
  1020. #The \bRestore\r command is used to restore the
  1021. #system status to some state which
  1022. #was previously saved in a system status disk file.
  1023. #It performs the complementary function
  1024. #of the \l($87)Store\m command.
  1025. #.($89)File|Download
  1026. #The \bDownload\r command is used to download data from
  1027. #a disk file to your target system's external data
  1028. #memory or code memory.
  1029. #Downloading can be used to initialize your target system's
  1030. #external data memory
  1031. #(also see the \l($86)Load\m command).
  1032. #Several different object file formats are accepted.
  1033. #.sp 1
  1034. #(The \bDownload\r command is not available for some parts
  1035. #because they do not have the ability to access
  1036. #external data/code memory.)
  1037. #.($90)File|Upload
  1038. #The \bUpload\r command is used to load the emulator's code
  1039. #memory with object code from the target system.
  1040. #Uploading code allows you to use
  1041. #the program from the
  1042. #code memory in your target system.
  1043. #.sp 1
  1044. #(The \bUpload\r command is not available for some parts
  1045. #because they do not have the ability to access
  1046. #external data/code memory.)
  1047. #.($91)File|Macro
  1048. #The \bMacro\r command pops up the Macro Menu.
  1049. #In the Macro Menu you can create a macro command
  1050. #file or execute (run) a previously-created macro command file.
  1051. #.($92)Execute
  1052. #The \bExecute\r command begins execution of the commands from
  1053. #a macro command file.  Execution continues from the macro
  1054. #command file until the end of the file is reached. Control
  1055. #then returns to manually entered commands.
  1056. #If you type \bCtrl C\r while the macro is executing,
  1057. #the macro will terminate immediately and the session will
  1058. #resume in the normal, interactive mode.
  1059. #.($93)Learn
  1060. #The \bLearn\r command creates a macro command file by entering
  1061. #every keystroke typed into the macro command file.
  1062. #Learn mode terminates when you enter the percent character, \b%%\r,
  1063. #followed by an \bE\r.
  1064. #.($94)Delay
  1065. #The \bDelay\r command creates a delay in between every
  1066. #keystroke read from a macro command file.
  1067. #You specify the delay time in milliseconds (1/1000th second).
  1068. #.($95)Repeat
  1069. #You can use the \bRepeat\r command to specify a repetition count
  1070. #for execution of macro command files.  The default repetition
  1071. #count is zero (0).
  1072. #.($96)Run
  1073. #The commands in the \bRun\r pull-down menu allow you to start
  1074. #various types of emulations.
  1075. #These include:
  1076. #.sp 1
  1077. #.in +4 {
  1078. #.in +4 {
  1079. #.ti -4
  1080. #1)^^Starting emulation from RESET conditions,
  1081. #.ti -4
  1082. #2)^^Resuming emulation under current, or slightly modified, conditions,
  1083. #.ti -4
  1084. #3)^^Several varieties of single-stepping.
  1085. #.in -4 }
  1086. #.in -4 }
  1087. #.($97)Reset (emulator)
  1088. #The \bReset^(emulator)\r command initiates emulation in the
  1089. #target application system, with emulation beginning from
  1090. #the chip's normal RESET state.
  1091. #.sp 1
  1092. #The \b%rs1\r emulator base unit supplies the RESET pulse.
  1093. #.($98)Reset (target)
  1094. #The \bReset^(target)\r command initiates emulation in the
  1095. #target application system, with emulation beginning from
  1096. #the chip's normal RESET state.
  1097. #.sp 1
  1098. #The \b%rs1\r emulator base unit does \unot\r supply the RESET pulse
  1099. #automatically.  Emulation will not begin until
  1100. #the target application system supplies the RESET pulse or until
  1101. #you press the \bRESET\r button on the emulator base unit.
  1102. #.($99)Go
  1103. #The \bGo\r command begins (or resumes) emulation starting from
  1104. #the current PC address.
  1105. #.($100)Go From
  1106. #The \bGo^from\r command begins (or resumes) emulation starting from
  1107. #an address that you supply.
  1108. #When you select the \bGo^from\r command, the host software
  1109. #will prompt you to supply the address at which to commence emulation.
  1110. #.($101)Go Until
  1111. #The \bUntil\r command sets a temporary breakpoint
  1112. #which remains in effect only for the duration of the
  1113. #next emulation cycle.
  1114. #When you select the \bUntil\r command, the host software
  1115. #will prompt you to supply the temporary breakpoint address.
  1116. #The software then transmits this breakpoint to the emulator
  1117. #without disturbing any other breakpoints which may already exist.
  1118. #Then, emulation will begin as if you had selected the
  1119. #\l($99)Go\m command.  Emulation continues until the program
  1120. #passes through \uany\r breakpoint, including the temporary
  1121. #breakpoint just established.  When emulation stops, the
  1122. #host software removes the temporary breakpoint from
  1123. #the emulator, again,
  1124. #without disturbing (deleting) any other breakpoints which
  1125. #may have been previously established.
  1126. #.($102)Step
  1127. #You can use the \bStep\r (single-step) command to execute
  1128. #one machine instruction and then stop (break emulation).
  1129. #The emulator will execute the next instruction
  1130. #(i.e., the one addressed by
  1131. #the Program Counter (PC)) and then break.
  1132. #.($103)Line
  1133. #The \bLine\r command allows you to single-step from one
  1134. #source line to the next.
  1135. #Emulation begins at the current PC and stops (breaks) when
  1136. #execution reaches the next source line in \uany\r module.
  1137. #.($104)Over
  1138. #The \bOver\r command allows you to single-step from one
  1139. #source line to the next.
  1140. #Emulation begins at the current PC and stops (breaks) when
  1141. #execution reaches the next source line in the \ucurrent\r module.
  1142. #This has the effect of "stepping over" calls to functions
  1143. #or procedures in other modules.
  1144. #.($105)To
  1145. #The \bTo\r command allows you to single-step from one
  1146. #function to the next.
  1147. #Emulation begins at the current PC and stops (breaks) when
  1148. #execution reaches the next function, procedure \uor\r
  1149. #global (public) code label.
  1150. #.sp 1
  1151. #.in +4 {
  1152. #NOTE:^^Global code labels are included only
  1153. #because not all language processors (compilers) mark
  1154. #procedures/functions properly in the debug records in
  1155. #the absolute object module for the program.
  1156. #.in -4 }
  1157. #.($106)Display/Alter
  1158. #The \bDisplay/Alter\r command calls a pull-down menu from
  1159. #which you may \l($115)Assemble\m new code into memory,
  1160. #\l($114)Disassemble\m existing code memory, change
  1161. #\l($118)Symbol\m values, view/change \l($119)Ram-bits\m,
  1162. #and view/change raw \l$(252)Code\m,
  1163. #\l($258)Indirect^Data\m and \l($264)External^Data\m memory.
  1164. #.($107)Assign
  1165. #The \bAssign\r command is used to assign the current (highlighted)
  1166. #option in the \l($75)Option^Window\m to the current (highlighted)
  1167. #function key in the \l($75)Assignment^Window\m.
  1168. #.sp 1
  1169. #An alternate method of assigning an option to a function key is to
  1170. #press the function key.  If the current window is the
  1171. #\bAssignment^Window\r the option of the current (highlighted)
  1172. #function key is copied as the option for the pressed function key.
  1173. #If the current window is the \bOption^Window\r the current
  1174. #(highlighted) option is copied to the pressed function key.
  1175. #.sp 1
  1176. #Note that when using the alternate method of assigning a function
  1177. #key, if the function key that has "Help" assigned to it is pressed,
  1178. #you will be asked whether your intention is to get "Help" or to
  1179. #reassign that function key.
  1180. #.($108)Clear
  1181. #The \bClear\r command is used to clear the assignment of the
  1182. #current (highlighted) function key.
  1183. #.($109)Help
  1184. #Due to the fact that function key assignments are being modified,
  1185. #function keys are turned off while in the function key menu.
  1186. #This means that normal means of getting "Help" are also
  1187. #turned off.  A special test is included to check if the "Help"
  1188. #function key has been pressed for "Help" or for re\l($107)assignment\m.
  1189. #For this reason "Help" for individual commands can be
  1190. #accessed through the main "Help" screen for
  1191. #the \l($75)Function^Key^Menu\m.
  1192. #.($110)Display
  1193. #The \bDisplay\r command is used to toggle the \l($75)Function^Key\m
  1194. #menu display mode.  There are two display modes.  One display
  1195. #mode shows the function key and the short description of the option
  1196. #assigned to it in the \bAssignment^Window\r and both the short and
  1197. #long description of each option in the \bOption^Window\r.  The
  1198. #other display mode shows the function key and both the short and long
  1199. #description of the assigned option in the \bAssignment^Window\r
  1200. #and just the short description of each option in the
  1201. #\bOption^Window\r.
  1202. #.($111)Save
  1203. #The \bSave\r command makes the edited assignments active for the
  1204. #current session.  If you wish to make the assignments permanent
  1205. #the \l($77)Configure|Save|Save\m command must be issued.
  1206. #.($112)Write
  1207. #The \bWrite\r command is used to write the function key
  1208. #\l($75)Assignments\m and \l($75)Options\m to a disk file.
  1209. #The disk file is written in an ASCII text format.
  1210. #.($113)Asm/Dasm
  1211. #The \bAsm/Dasm\r command calls a pop up menu from which
  1212. #you may \l($115)Assemble\m instructions into
  1213. #code memory and \l($114)Disassemble\m existing code memory.
  1214. #By default the \bDisassemble\r mode is active on entry to
  1215. #the pop up menu.
  1216. #.($114)Disassemble
  1217. #The \bDisassemble\r command turns on disassemble mode.  In this
  1218. #mode you can quickly view a page of disassembled code
  1219. #from anywhere in code memory by typing an absolute code
  1220. #address or a symbolic name (line number or label), or can scroll
  1221. #through code memory (disassembling a page at a time) using the
  1222. #page down (PgDn) key.
  1223. #.sp 1
  1224. #The disassembled code will be interspersed with HLL source
  1225. #images (if available) if the 'Mixed' display
  1226. #\l($116)Mode\m is active.
  1227. #.sp 1
  1228. #Note that if an absolute address is entered and the
  1229. #\l($117)Label-synch\m mode is off, the address may or may not
  1230. #correspond to an instruction boundary and may result in
  1231. #an out-of-synch disassembly.
  1232. #.($115)Assemble
  1233. #The \bAssemble\r command turns on assemble mode.  In this mode
  1234. #you may enter new instructions into code memory.
  1235. #The assembler may also be used to add a label at a specified
  1236. #PC address.  The PC address at which to add the instruction
  1237. #may be specified by typing an absolute code address, a symbolic
  1238. #name (line number or label) or by using the down arrow ('\x19')
  1239. #and up arrow ('\x18') keys to increment and decrement the address.
  1240. #.sp 1
  1241. #When entering an instruction, symbolic information may be used.
  1242. #This includes the ability to define a new label at the current
  1243. #address and using symbolic names in the operand part of the
  1244. #instruction.  When a new label is entered, it is inserted into
  1245. #the internal symbol table as a global (public) symbol.
  1246. #.sp 1
  1247. #Note that if the assembled instruction does not contain the
  1248. #same number of bytes as the original instruction at the current
  1249. #address you will be notified and asked to verify the
  1250. #operation.
  1251. #.($116)Mode
  1252. #The \bMode\r command is used to toggle the display mode between
  1253. #\b'Code'\r mode and \b'Mixed'\r mode.  The 'Code' display mode
  1254. #means just display assembly language instructions.  The 'Mixed'
  1255. #display mode (available only if HLL source is available) means
  1256. #display HLL source images interspersed with the assembly code.
  1257. #.($117)Label-synch
  1258. #The \bLabel-synch\r command is used to toggle label synchronization
  1259. #on and off.  When \bLabel-synch\r is on, the software uses existing
  1260. #code labels to verify that \l($114)Disassemble\m addresses are on
  1261. #instruction boundaries.  If they are not the software will adjust
  1262. #the address so the disassembly begins on an instruction boundary.
  1263. #If the \bLabel-synch\r mode is off, no such checks are made and
  1264. #the disassembly will start at the specified address.
  1265. #.sp 1
  1266. #Note that if \bLabel-synch\r mode is off, the specified address
  1267. #may or may not correspond to an instruction boundary and
  1268. #may result in an out-of-synch disassembly.
  1269. #.($118)Var/Reg
  1270. #The \bVar/Reg\r command can be used to change the value of
  1271. #any program variable or register (including the PC).  When
  1272. #the command is selected you will be prompted for the name
  1273. #of the variable or register to change and for its new value.
  1274. #The current value will also be displayed.
  1275. #.($119)RAM-Bits
  1276. #The \bRAM-Bits\r command is used to view or change bits in the
  1277. #128 directly-addressable bit area of Internal Data memory.
  1278. #A bit's value may be toggled by typing the bit address
  1279. #(absolute or symbolic) or by using the cursor keys to move to
  1280. #the desired bit and then pressing the 'Enter' key.
  1281. #.($120)Misc
  1282. #The \bMisc\rellaneous pull-down menu contains commands
  1283. #that give you access to:
  1284. #.sp 1
  1285. #.in +4 {
  1286. #.in +4 {
  1287. #.ti -4
  1288. #1)^^Unique features of the target processor.
  1289. #.ti -4
  1290. #2)^^Special options/features of the \b%rs1\r emulator.
  1291. #.ti -4
  1292. #3)^^Miscellaneous other things.
  1293. #.in -4 }
  1294. #.in -4 }
  1295. #.($121)File|Exit
  1296. #The \bExit\r command is used to terminate the \b%rs1\r host software and
  1297. #return normally to DOS.
  1298. #.($122)OS-Esc
  1299. #The \bOS-Esc\r command suspends the
  1300. #\b%rs1\r system and transfers control to DOS.
  1301. #You can then,
  1302. #subject only to memory availability,
  1303. #type any DOS command(s)
  1304. #and invoke other programs (e.g., a text editor).
  1305. #When you type the \uexit\r command at the DOS prompt,
  1306. #you will resume execution in the \b%rs1\r system at the
  1307. #point of suspension.
  1308. #.sp 1
  1309. #While the \b%rs1\r system is suspended and DOS is active,
  1310. #the DOS prompt will be augmented with a string reminding
  1311. #you how to resume execution in the \b%rs1\r system.
  1312. #.sp 1
  1313. #\bSpecial Note\r
  1314. #.sp 1
  1315. #After you have been running the \b%rs1\r host software for
  1316. #a while (in a single session), you may find that you can
  1317. #no longer escape to DOS because there is not enough memory
  1318. #available to DOS to load a new copy of COMMAND.COM
  1319. #(the DOS command processor).
  1320. #.sp 1
  1321. #During normal operation, the host software routinely allocates
  1322. #and frees memory nodes.  The runtime library processes these
  1323. #allocation and deallocation requests, using a pool of
  1324. #memory (the heap) managed by the runtime library.
  1325. #If there is not
  1326. #enough unallocated memory in the heap to satisfy  a particular allocation
  1327. #request, the runtime library obtains another memory segment from DOS.
  1328. #.sp 1
  1329. #When the host software issues a request to free an allocated
  1330. #node, the runtime library puts that node back into the pool of
  1331. #unallocated memory.  That node is then available for
  1332. #allocation when the host software next requests a memory node.
  1333. #\uHowever\r, the runtime library \unever\r releases memory segments
  1334. #back to DOS.
  1335. #.sp 1
  1336. #Thus, after you have been running the \b%rs1\r system for a while,
  1337. #there may be a lot of memory available to the host software
  1338. #for its internal use, but as far as DOS is concerned, there may be
  1339. #very little available memory.
  1340. #.sp 1
  1341. #The DOS \bCHKDSK\r or \bMEM\r commands report the amount of available
  1342. #memory as seen by DOS.
  1343. #The reported value has very little relationship to the amount of
  1344. #memory actually available to the host software for
  1345. #continuing an emulation session.
  1346. #.($123)Expanded Memory Usage Information
  1347. #If you have Expanded Memory (LIM-compatible) in your computer,
  1348. #the \b%rs1\r host software can make limited use of it.
  1349. #To enable access to Expanded Memory, you must have the
  1350. #appropriate 'DEVICE=...' statement in your 'CONFIG.SYS' file.
  1351. #See the documentation accompanying your Expanded Memory board
  1352. #for the specific details on how to do this.
  1353. #.sp 1
  1354. #The \bEMM Usage\r command displays the following information:
  1355. #.sp 1
  1356. #.in +2 {
  1357. #.in +9 {
  1358. #.ti -9
  1359. #System:^^Total
  1360. #amount of Expanded Memory in the PC.
  1361. #.ti -9
  1362. #Others:^^Amount
  1363. #of Expanded Memory being used by other programs
  1364. #(programs other than the \b%rs1\r host software).
  1365. #.ti -9
  1366. #Usable:^^Maximum
  1367. #amount of Expanded Memory which can be utilized
  1368. #by the \b%rs1\r host software.
  1369. #Currently, this is limited to 64KB.
  1370. #.ti -9
  1371. #In Use:^^Amount
  1372. #of Expanded Memory currently being used
  1373. #by the \b%rs1\r host software.
  1374. #This value never will be greater than "\bUsable:\r".
  1375. #.in -9 }
  1376. #.in -2 }
  1377. #.($124)
  1378. #The Programmer Command is used to pop-up the
  1379. #Programmer Menu.  The Programmer Menu gives you the
  1380. #capability to program 83C751 or 83C752 PROM's and
  1381. #EPROM's.
  1382. #.($125)A-to-D Converter
  1383. #The A-to-D-converter command is used to read the
  1384. #Analog to Digital  converter.
  1385. #The content of each channel is displayed in hexadecimal.
  1386. #NOTE:  Reading the A to D converter will modify certain registers:
  1387. #.sp 1
  1388. #.in +2 {
  1389. #.ba {
  1390. #512,532,515,535:  ADCON, ADDAT, DAPR, and IRCON
  1391. #517,537:          ADCON0, ADCON1, ADDAT, DAPR, and IRCON
  1392. #550:              ADAT and ADCON
  1393. #552:              ADCH and ADCON
  1394. #752:              ADAT and ADCON
  1395. #.ea }
  1396. #.in -2 }
  1397. #.($126)MDU
  1398. #The Multiplication-division-unit Command is used to display
  1399. #the results of an arithmetic operation involving the
  1400. #Multiplication / Division Unit (MDU) of the '517 and '537.
  1401. #The results are displayed
  1402. #as signed or unsigned decimal numbers.
  1403. #.($127)DPTRs (multiple)
  1404. #The \bDPTRs^(multiple)\r command reads and displays all the possible
  1405. #DPTR (Data Pointer) register values for those chips that have multiple
  1406. #DPTRs or an Alternate DPTR.
  1407. #.($128)FIFO
  1408. #The \bFIFO\r command reads and displays the FIFO
  1409. #on the 80C152/83C152 and the 80C452.
  1410. #.sp 1
  1411. #\uNOTE\r:^^Once the FIFO is read, the data in the FIFO is lost.
  1412. #.($129)
  1413. #(Help Information Not Used.)
  1414. #.($130)Source/Symbols
  1415. #When the \bSource/Symbols\r command is selected a pull-down menu
  1416. #of options relating to High Level Language and Symbol display
  1417. #and search is displayed.
  1418. #.($131)Source,Module Update
  1419. #The \bModule^Update\r command is used to select the
  1420. #\bModule^Update^Mode\r.  This mode determines how the software
  1421. #will decide what the \l($134)Current^Module\m is.  The mode
  1422. #choices are \l($132)AUTO\m (automatic) and \l($133)USER\m
  1423. #(user-defined).
  1424. #.($132)Source,Module Update,AUTO
  1425. #The \bAUTO\r \l($131)Module^Update\m Mode means that the software will
  1426. #automatically determine what the \l($134)Current^Module\m is.
  1427. #This determination is made based on the PC address.  If the
  1428. #PC address falls within the address range of a module, that
  1429. #module will be made the Current Module.
  1430. #.($133)Source,Module Update,User
  1431. #The \bUser\r \l($131)Module^Update\m Mode means that you have set
  1432. #(or will set) the \l($134)Current^Module\m to a specific
  1433. #module which will remain the Current Module until the
  1434. #Module Update Mode is changed to Automatic or until
  1435. #you change the Current Module.
  1436. #.($134)Source,Current Module
  1437. #The \bCurrent^Module\r command is used to set the
  1438. #Current Module to a specific module.  When a Current Module
  1439. #has been set this way the \l($131)Module^Update^Mode\m is
  1440. #set to \l($133)User\m.
  1441. #.sp 1
  1442. #The concept of the Current Module is to make Symbolic searches
  1443. #context sensitive.
  1444. #If there are two symbols with the same name (that were defined
  1445. #in two different modules) the Current Module will be searched
  1446. #first.
  1447. #.($135)Source,Search Path
  1448. #The \bSearch^Path\r command is used to set the  HLL (High Level
  1449. #Language) search path directory used to locate the source or
  1450. #listing files for each module in the program currently loaded into
  1451. #code memory.  The source files (C) or listing files (PL/M) must
  1452. #exist in the HLL search path to enable the emulation system to
  1453. #locate and display HLL source images.
  1454. #.sp 1
  1455. #The HLL search path may also be set using the \b'-s'\r
  1456. #\l($249)Command^Line^Option\m.
  1457. #.($136)Source,Raw Source
  1458. #The \bRaw^Source\r command displays the raw source file for
  1459. #a specified module.  Each source line image is preceded by
  1460. #its line number.  The line numbers that are highlighted
  1461. #specially correspond to line numbers with
  1462. #entries in that modules line number table, meaning they may
  1463. #be referenced symbolically throughout the software.
  1464. #.sp 1
  1465. #File information, such as the source language and source filename
  1466. #are displayed along with the name of the module.  The module
  1467. #being displayed can be changed by typing a new module name at the
  1468. #\bEnter Module\r prompt.
  1469. #.sp 1
  1470. #The displayed source images can be positioned quickly to a
  1471. #particular line number by typing the desired line number
  1472. #at the \bLine Number\r prompt.
  1473. #.($137)Source,Modules
  1474. #The \bModules\r command displays module information for all
  1475. #modules.  The information is displayed sorted by module
  1476. #address range.
  1477. #.sp 1
  1478. #Further information for the \bModules\r command is available for:
  1479. #.in +4 {
  1480. #.ti -2
  1481. #\l($365)Enter^Module^Prompt\m
  1482. #.ti -2
  1483. #\l($367)Screen^Content\m
  1484. #.in -4 }
  1485. #.($138)Source,Scopes
  1486. #The \bScopes\r command displays scope information for all
  1487. #modules and procedures.  The information is displayed sorted
  1488. #first by module address range and then alphabetically by
  1489. #procedure name within each module.
  1490. #.sp 1
  1491. #Further information for the \bScopes\r command is available for:
  1492. #.in +4 {
  1493. #.ti -2
  1494. #\l($365)Enter^Mod/Proc^Prompt\m
  1495. #.ti -2
  1496. #\l($367)Screen^Content\m
  1497. #.in -4 }
  1498. #.($139)Source,Line Numbers
  1499. #The \bLine^Numbers\r command displays line number information for
  1500. #all modules.  The information is displayed sorted first by module
  1501. #address range and then by ascending line numbers within each module.
  1502. #.sp 1
  1503. #Two screen modes are available for line number information for
  1504. #this command.  The \bnarrow\r screen contains the \bLine^Number\r,
  1505. #its \bAddress\r and the names of any \bSymbols\r defined at
  1506. #that address.
  1507. #The \bwide\r screen contains (in addition to the line number,
  1508. #address and symbol name) the \bSource Image\r for the line number.
  1509. #For lines describing modules, the information displayed for
  1510. #each module is the \baddress^range\r and \bname\r.
  1511. #.sp 1
  1512. #Further information for the \bLine^Numbers\r command is available for:
  1513. #.in +4 {
  1514. #.ti -2
  1515. #\l($365)Enter^Module^Prompt\m
  1516. #.in -4 }
  1517. #.($140)Symbols,Global
  1518. #The \bGlobal\r command displays all global
  1519. #(public) symbols associated with the program currently loaded in
  1520. #code memory.  Symbols are listed sorted alphabetically.
  1521. #.sp 1
  1522. #Further information for the \bGlobal\r command is available for:
  1523. #.in +4 {
  1524. #.ti -2
  1525. #\l($365)Enter^Symbol^Prompt\m
  1526. #.ti -2
  1527. #\l($366)Screen^Content\m
  1528. #.in -4 }
  1529. #.($141)Symbols,Local
  1530. #The \bLocal\r command displays all local symbols
  1531. #associated with the program currently loaded in code memory.
  1532. #Symbols are listed sorted first by module (or procedure) and
  1533. #then alphabetically within each module.
  1534. #.sp 1
  1535. #In addition to the normal screen content for the symbol displays
  1536. #the address range and name for each module (or procedure) is
  1537. #displayed before the symbols for that module (or procedure).
  1538. #.sp 1
  1539. #Further information for the \bLocal\r command is available for:
  1540. #.in +4 {
  1541. #.ti -2
  1542. #\l($365)Enter^Symbol^Prompt\m
  1543. #.ti -2
  1544. #\l($366)Screen^Content\m
  1545. #.in -4 }
  1546. #.($142)Symbols,Alpha
  1547. #The \bAlpha\r command displays all local and global
  1548. #(public) symbols associated with the program currently loaded in
  1549. #code memory.  Symbols are listed sorted alphabetically.
  1550. #.sp 1
  1551. #Further information for the \bAlpha\r command is available for:
  1552. #.in +4 {
  1553. #.ti -2
  1554. #\l($365)Enter^Symbol^Prompt\m
  1555. #.ti -2
  1556. #\l($366)Screen^Content\m
  1557. #.in -4 }
  1558. #.($143)Symbols,Address
  1559. #The \bAddress\r command displays all local and global
  1560. #(public) symbols associated with the program currently loaded in
  1561. #code memory.  Symbols are listed sorted first by memory space
  1562. #and then by address within each memory space.
  1563. #The Left-arrow (\x1B) and Right-arrow (\x1A) keys select the
  1564. #desired memory space
  1565. #and scroll the display to the first symbol in that memory space.
  1566. #If no symbols exist in a particular memory space the
  1567. #Left-arrow (\x1B) and Right-arrow (\x1A) keys will
  1568. #skip that memory space.
  1569. #.sp 1
  1570. #Further information for the \bAddress\r command is available for:
  1571. #.in +4 {
  1572. #.ti -2
  1573. #\l($365)Enter^Symbol^Prompt\m
  1574. #.ti -2
  1575. #\l($366)Screen^Content\m
  1576. #.in -4 }
  1577. #.($144)Break/Trace
  1578. #The \bBreak/Trace\r command pulls down a menu which gives you direct
  1579. #access the the breakpoint and tracing features of the emulator.
  1580. #.($145)Trace Trigger
  1581. #The \bTrace-Trigger\r command is used to select
  1582. #either the \l($146)Start\m, \l($147)Center\m, \l($148)End\m
  1583. #or \l($149)Variable\m settings for the Trace Trigger.
  1584. #.sp 1
  1585. #The Status Window shows the current value of the trace trigger
  1586. #in the "Trig:" field.
  1587. #.sp 1
  1588. #The Trace Trigger controls when emulation stops,
  1589. #relative to the actual breakpoint, in terms of the amount of
  1590. #information captured into the trace buffer.
  1591. #.($146)Start
  1592. #When you select the \bStart\r Trace Trigger,
  1593. #emulation stops after \x7E4K trace frames accumulate in the
  1594. #trace buffer \ufollowing\r the breakpoint.
  1595. #.($147)Center
  1596. #When you select the \bCenter\r Trace Trigger,
  1597. #emulation stops after \x7E2K trace frames accumulate in the
  1598. #trace buffer \ufollowing\r the breakpoint.
  1599. #.($148)End
  1600. #When you select the \bEnd\r Trace Trigger,
  1601. #emulation stops upon reaching the first breakpoint
  1602. #(i.e., zero (0) additional frames  frames accumulate in the
  1603. #trace buffer following the breakpoint).
  1604. #.sp 1
  1605. #This is the default Trace Trigger value.
  1606. #.($149)Variable
  1607. #When you select the \bVariable\r Trace Trigger,
  1608. #you can specify exactly how many trace frames will accumulate in the
  1609. #trace buffer following the breakpoint.
  1610. #.($150)Break Count
  1611. #You use the \bBreak Count\r command to specify the number of
  1612. #breakpoints to be reached ("passed through") during real-time
  1613. #emulation before emulation actually stops.
  1614. #Unlike the \l($271)Repetition^Count\mer,
  1615. #the \bBreak Count\rer is hardware-controlled and operates
  1616. #nonintrusively during full-speed, real-time emulation.
  1617. #.sp 1
  1618. #The Status Window shows the current Break Count value in the
  1619. #"\bBrkCnt\r" field.
  1620. #.($151)Set
  1621. #The \bSet\r command calls the pop up \bBreak^Menu\r from which
  1622. #you may \l($161)Add\m, \l($167)Remove\m, \l($154)Edit\m or
  1623. #just view breaks (both \l($152)Simple\m and \l($153)Complex\m).
  1624. #If any breaks are added or edited in the pop up \bBreak^Menu\r,
  1625. #they are evaluated and set only upon exit from
  1626. #the pop up \bBreak^Menu\r.
  1627. #.sp 1
  1628. #The pop up \bBreak^Menu\r also provides access to the pop up
  1629. #\l($172)Opcode^Class^Menu\m.
  1630. #.($152)Simple Breaks
  1631. #\bSimple^Breaks\r are single addresses or address ranges where
  1632. #breakpoints are set or where trace is turned ON or OFF.
  1633. #A \l($162)Code^Break\mpoint may be set for any code memory
  1634. #address (or range) and an \l($163)External^Data^Break\mpoint
  1635. #may be set for any External Data address (or range), but
  1636. #\l($164)Trace^ON\m and \l($165)Trace^OFF\m points may only
  1637. #be set for code memory addresses (or ranges).
  1638. #.sp 1
  1639. #The TAB key is used to toggle between the \bSimple^Break\r
  1640. #window and the \l($153)Complex^Break\m window.
  1641. #.($153)Complex Breaks
  1642. #\bComplex^Breaks\r can be \l($162)Code^Break\mpoints,
  1643. #\l($164)Trace^ON\m points and \l($165)Trace^OFF\m points.
  1644. #Each \bComplex^Break\r element (one per line) is evaluated as the
  1645. #\uAND\r condition of a \l($155)Code^Address\m (or range), a
  1646. #\l($156)Direct^Address\m (or range), a \l($157)Bit^Address\m
  1647. #(or range), an \l($158)Opcode^Value\m (or range of values), an
  1648. #\l($160)Immediate^Operand^Value\m (or range of values) and
  1649. #an \l($159)Opcode^Class\m.  If any of the fields are left blank
  1650. #they are not \uAND\red during the evaluation.
  1651. #.sp 1
  1652. #Obviously, it is easy to create a \bComplex^Break\r element
  1653. #that makes no sense.  For example, if an opcode value of 80h
  1654. #(SJMP) is selected along with any direct address this element
  1655. #will evaluate to NULL.  When the \bComplex^Breaks\r are
  1656. #evaluated, NULL elements are considered errors and you will
  1657. #be notified of them.
  1658. #.sp 1
  1659. #The TAB key is used to toggle between the \bComplex^Break\r
  1660. #window and the \l($152)Simple^Break\m window.
  1661. #.($154)Edit
  1662. #If the \l($152)Simple^Break\m window is the current window
  1663. #when the \bEdit\r command is selected, a dialog box will pop up
  1664. #to prompt for an address range for a \bSimple^Break\r.
  1665. #.sp 1
  1666. #If the \l($153)Complex^Break\m window is the current window
  1667. #when the \bEdit\r command is selected, a pull-down menu is
  1668. #called from which you can select which \bComplex^Break\r
  1669. #field to \bEdit\r, \l($155)Code^Address\m,
  1670. #\l($156)Direct^Address\m, \l($157)Bit^Address\m,
  1671. #\l($158)Opcode^Value\m, \l($159)Opcode^Class\m, or
  1672. #\l($160)Immediate^Operand\m.
  1673. #.($155)Code Address Range
  1674. #When the \bCode^Address^Range\r command is selected a dialog box
  1675. #will pop up to prompt for a \bCode^Address^Range\r.  Either a
  1676. #single address or an address range may be entered (numerically or
  1677. #symbolically).
  1678. #.($156)Direct Address Range
  1679. #When the \bDirect^Address^Range\r command is selected a dialog box
  1680. #will pop up to prompt for a \bDirect^Address^Range\r.  Either a
  1681. #single address or an address range may be entered (numerically or
  1682. #symbolically).
  1683. #.sp 1
  1684. #When \l($153)Complex^Breaks\m are evaluated, a direct address
  1685. #(or range) is evaluated by searching the program loaded in code
  1686. #memory for instructions that have direct operands and then comparing
  1687. #the entered address (or range) with those operands when found.
  1688. #.($157)Bit Address Range
  1689. #When the \bBit^Address^Range\r command is selected a dialog box
  1690. #will pop up to prompt for a \bBit^Address^Range\r.  Either a
  1691. #single address or an address range may be entered (numerically or
  1692. #symbolically).
  1693. #.sp 1
  1694. #When \l($153)Complex^Breaks\m are evaluated, a bit address
  1695. #(or range) is evaluated by searching the program loaded in code
  1696. #memory for instructions that have bit operands and then comparing
  1697. #the entered address (or range) with those operands when found.
  1698. #.($158)Opcode Range
  1699. #When the \bOpcode^Range\r command is selected a dialog box
  1700. #will pop up to prompt for an \bOpcode^Range\r.  Either a
  1701. #single opcode or a range of opcodes may be entered.
  1702. #.sp 1
  1703. #When \l($153)Complex^Breaks\m are evaluated, an opcode
  1704. #(or range) is evaluated by searching the program loaded in code
  1705. #memory for instructions whose opcodes match the entered
  1706. #opcode (or range).
  1707. #.($159)Opcode Class
  1708. #When the \bOpcode^Class\r command is selected a dialog box
  1709. #will pop up to prompt for an \l($172)Opcode^Class\m name.
  1710. #.sp 1
  1711. #When \l($153)Complex^Breaks\m are evaluated and the entered
  1712. #opcode class is found, the program loaded in code memory is
  1713. #searched for opcodes that match the opcodes found in that
  1714. #opcode class.
  1715. #.($160)Immediate Operand Range
  1716. #When the \bImmediate^Operand^Range\r command is selected a dialog box
  1717. #will pop up to prompt for a \bImmediate^Operand^Range\r.  Either a
  1718. #single immediate operand or a range of immediate operands may be
  1719. #entered.
  1720. #.sp 1
  1721. #When \l($153)Complex^Breaks\m are evaluated, an immediate operand
  1722. #(or range) is evaluated by searching the program loaded in code
  1723. #memory for instructions that have immediate operands and then
  1724. #comparing the entered immediate operand (or range) with those
  1725. #operands when found.
  1726. #.($161)Add
  1727. #When the \bAdd\r command is selected a menu is pulled-down
  1728. #from which the type of break to \bAdd\r may be set, a
  1729. #\l($162)Code^Break\m point, a \l($164)Trace^ON\m point, a
  1730. #\l($165)Trace^OFF\m point and if the current window
  1731. #is the \l($152)Simple^Break\m window, an
  1732. #\l($163)External^Data^Break\m point.
  1733. #.($162)CBREAK
  1734. #When the \bCBREAK\r command is selected the type of the break
  1735. #element to be added is set to a \bCode^Break\r point.
  1736. #Control is then immediately passed to the \l($154)Edit\m command.
  1737. #.($163)XBREAK
  1738. #When the \bXBREAK\r command is selected the type of the break
  1739. #element to be added is set to an \bExternal^Data^Break\r point.
  1740. #Control is then immediately passed to the \l($154)Edit\m command.
  1741. #This command is available only for the \l($152)Simple^Break\m window.
  1742. #.($164)TRON
  1743. #When the \bTRON\r command is selected the type of the break
  1744. #element to be added is set to a \bTrace^ON\r point.
  1745. #Control is then immediately passed to the \l($154)Edit\m command.
  1746. #.($165)TROFF
  1747. #When the \bTROFF\r command is selected the type of the break
  1748. #element to be added is set to a \bTrace^OFF\r point.
  1749. #Control is then immediately passed to the \l($154)Edit\m command.
  1750. #.($166)
  1751. #.($167)Remove
  1752. #The \bRemove\r command is used to remove the currently
  1753. #highlighted break element.
  1754. #.($168)
  1755. #(Help Information Not Used.)
  1756. #.($169)Hex
  1757. #The \bHex\r command toggles the \bBreak^Menu\r display mode to
  1758. #hex mode in which only numeric addresses and values are displayed.
  1759. #This mode has no effect on how addresses and values may be entered.
  1760. #.($170)Symbolic
  1761. #The \bSymbolic\r command toggles the \bBreak^Menu\r display mode to
  1762. #symbolic mode.  In this mode addresses and values are displayed
  1763. #symbolically.
  1764. #This mode has no effect on how addresses and values may be entered.
  1765. #.($171)
  1766. #(Help Information Not Used.)
  1767. #.($172)Opcode Class
  1768. #The \bOpcode^Class\r command calls the pop-up \bOpcode^Class^Menu\r
  1769. #from which you can create or modify an opcode class.
  1770. #An opcode class is a user-defined grouping of MCS-51 instructions.
  1771. #Each opcode class is made of one or many opcode class elements.
  1772. #Each opcode class element contains three fields, the
  1773. #\l($177)Mnemonic\m, \l($178)Operand^1\m
  1774. #and \l($179)Operand^2\m.  Opcode class elements can be
  1775. #\l($203)Add\med or \l($204)Remove\md and the fields of an opcode
  1776. #class element can be \l($175)Edit\med.
  1777. #.sp 1
  1778. #When an opcode class element is evaluated the three fields are
  1779. #effectively \uAND\red together.  Any field left blank is not
  1780. #included in the \uAND\r evaluation.
  1781. #.sp 1
  1782. #Note that although the CJNE class of instructions has three
  1783. #operands, each CJNE instruction can be uniquely specified using the
  1784. #provided fields.
  1785. #.($173)Load
  1786. #The \bLoad\r command allows you to restore a previously
  1787. #\l($174)Save\md break setup from a disk file.  Any current
  1788. #break elements (\l($152)Simple\m and \l($153)Complex\m) are removed.
  1789. #.($174)Save
  1790. #The \bSave\r command allows you to store all the currently
  1791. #defined break elements (\l($152)Simple\m and \l($153)Complex\m)
  1792. #to a disk file.  That file can be then \l($173)Load\med at a
  1793. #later time.
  1794. #.($175)Edit
  1795. #When the \bEdit\r command is selected a menu is pulled-down
  1796. #from which you may \l($176)Name\m an \l($172)Opcode^Class\m,
  1797. #or \bEdit\r the \l($177)Mnemonic\m, \l($178)Operand^1\m or
  1798. #\l($179)Operand^2\m field of the currently highlighted
  1799. #opcode class element.
  1800. #.($176)Name
  1801. #The \bName\r command allows you to \bName\r an
  1802. #\l($172)Opcode^Class\m.  The name of an opcode class is special
  1803. #in that when an opcode class is \l($206)Save\md, it is saved in
  1804. #a file name that is created automatically using the opcode class
  1805. #name.  For example, if an opcode class is named "PGMFLOW" the
  1806. #file name the opcode class will be saved to is "PGMFLOW.$OC".
  1807. #This is true of the \l($205)Load\m command also.  When the load
  1808. #command is selected you will be prompted for the opcode class
  1809. #name to load.  The software will look for a file whose name is
  1810. #created from the opcode class name in the manner described above.
  1811. #.($177)Mnemonic
  1812. #The \bMnemonic\r command allows you to edit the \bMnemonic\r
  1813. #field of the currently highlighted \l($172)Opcode^Class\m element.
  1814. #Any valid MCS-51 instruction mnemonic is valid.
  1815. #.($178)Operand 1
  1816. #The \bOperand^1\r command calls a pull-down menu from which you
  1817. #may select the type of \l($373)Operand\m to use for the
  1818. #\bOperand^1\r field.  The first operand of an MCS-51 instruction
  1819. #is often called the destination operand.
  1820. #.($179)Operand 2
  1821. #The \bOperand^2\r command calls a pull-down menu from which you
  1822. #may select the type of \l($373)Operand\m to use for the
  1823. #\bOperand^2\r field.  The second operand of an MCS-51 instruction
  1824. #is often called the source operand.
  1825. #.($203)Add
  1826. #The \bAdd\r command adds an empty \l($172)Opcode^Class\m element
  1827. #and automatically passes control to the \l($175)Edit\m pull-down menu.
  1828. #The \bAdd\red opcode class element is then highlighted (made the
  1829. #current opcode class element).
  1830. #.($204)Remove
  1831. #The \bRemove\r command removes the current (highlighted)
  1832. #\l($172)Opcode^Class\m element.
  1833. #.($205)Load
  1834. #The \bLoad\r command allows you to restore a previously
  1835. #\l($206)Save\md \l($172)Opcode^Class\m.  If an opcode class
  1836. #is currently loaded in memory it will be cleared before
  1837. #the new opcode class is \bLoad\red.  When the \bLoad\r command
  1838. #is selected you will be prompted for the opcode class
  1839. #\l($176)Name\m to load.  The software will search for the disk
  1840. #file for that opcode class.  The file name used is created from
  1841. #the opcode class name.  For example, if the desired opcode class
  1842. #is named "PGMFLOW" the file name searched for is "PGMFLOW.$OC".
  1843. #.($206)Save
  1844. #The \bSave\r command is used to store the currently defined
  1845. #\l($172)Opcode^Class\m to a disk file.  The disk file name is
  1846. #created from the opcode class \l($176)Name\m.  For example,
  1847. #if the opcode class name is "PGMFLOW" the opcode class will
  1848. #be \bSave\rd to the file named "PGMFLOW.$OC".  If the opcode
  1849. #class has not been named yet, you will be prompted to enter
  1850. #the name.
  1851. #.($207)Clear
  1852. #The \bClear\r command is used to clear all breaks set
  1853. #through the \l($151)Break^Menu\m.
  1854. #.($208)Disable
  1855. #The \bDisable\r command is used to temporarily disable all breaks
  1856. #set through the \l($151)Break^Menu\m.  The breaks can be
  1857. #enabled using the \l($209)Enable\m command.
  1858. #.($209)
  1859. #The \bEnable\r command is used to enable breaks (originally
  1860. #set through the \l($151)Break^Menu\m) that were temporarily
  1861. #\l($208)Disabled\m.
  1862. #.($210)View Trace
  1863. #The \bView-Trace\r command is used to examine and/or write to a file
  1864. #the contents of the trace buffer.
  1865. #The trace buffer can be examined/written in several
  1866. #different display modes.
  1867. #.($211)Raw
  1868. #In the \bRaw\r display mode, you see the binary content of
  1869. #the address/data bus for each bus cycle (trace frame)
  1870. #in a raw hex format.
  1871. #.sp 1
  1872. #The notations used in the \bRaw\r mode display are:
  1873. #.sp 1
  1874. #.in +4 {
  1875. #.in +11 {
  1876. #.ti -11
  1877. #*^^^^^^^^^^Opcode-fetch cycle
  1878. #(beginning of instruction's execution)
  1879. #.ti -11
  1880. #**(LCALL)^^Interrupt (1st ALE cycle)
  1881. #.ti -11
  1882. #**^^^^^^^^^Interrupt (2nd, 3rd & 4th ALE cycles)
  1883. #.ti -11
  1884. #R^^^^^^^^^^Reset
  1885. #.ti -11
  1886. #DMA^^^^^^^^DMA activity
  1887. #.ti -11
  1888. #?^^^^^^^^^^same as "(uncertain)" in the \l($212)Code\m display mode
  1889. #.ti -11
  1890. #<<^^^^^^^^^(Probe column) marks next instruction
  1891. #to be executed (not executed yet)
  1892. #.in -11 }
  1893. #.in -4 }
  1894. #.($212)Code
  1895. #In the \bCode\r display mode, you see the content of the trace buffer
  1896. #interpreted as fully dis-assembled instructions, including all
  1897. #available symbolic information (except HLL source images).
  1898. #.sp 1
  1899. #The notations used in the \bCode\r display mode are:
  1900. #.sp 1
  1901. #.in +4 {
  1902. #.in +13 {
  1903. #.ti -13
  1904. #**LCALL^^^^^^Interrupt
  1905. #.ti -13
  1906. #*R*^^^^^^^^^^Reset (only when in middle of an instruction)
  1907. #.ti -13
  1908. #DMA^Cycle^^^^DMA activity (not part of instruction's execution)
  1909. #.ti -13
  1910. #(uncertain)^^(unable to decode with absolute certainty
  1911. #because only part of an instruction's
  1912. #execution trace was captured in the
  1913. #buffer due to automatic wraparound in the
  1914. #circular trace memory in the emulator)
  1915. #.ti -13
  1916. #<<<<<<<^^^^^^(Probe column) marks next instruction
  1917. #to be executed (not executed yet)
  1918. #.in -13 }
  1919. #.in -4 }
  1920. #.($213)HLL
  1921. #In the \bHLL\r display mode, you see the decoded content of the
  1922. #the trace buffer interpreted as HLL source language images.
  1923. #This can be done only if the \b%rs1\r system
  1924. #has access to the source/listing files corresponding to
  1925. #the modules in your program.
  1926. #Source languages supported include C and PL/M-51.
  1927. #.($214)Mixed
  1928. #The \bMixed\r display mode is a combination of the Code and HLL
  1929. #\l($212)Code\m and \l($213)HLL\m display modes.
  1930. #The HLL source images (HLL mode display), if available,
  1931. #appear interspersed appropriately with the generated
  1932. #machine code (Code mode display).
  1933. #.($215)Probes
  1934. #The \bProbes\r command cyclically toggles the display of the captured
  1935. #probe clip bit values through three display modes:
  1936. #.sp 1
  1937. #.in +2 {
  1938. #.in +4 {
  1939. #.ti -4
  1940. #1.^^Binary
  1941. #.ti -4
  1942. #2.^^Hexadecimal
  1943. #.ti -4
  1944. #3.^^Digital waveform
  1945. #.in -4 }
  1946. #.in -2 }
  1947. #.sp 1
  1948. #The \bProbes\r command and its associated display are available in
  1949. #the \l($211)Raw\m, \l($212)Code\m and \l($214)Mixed\m
  1950. #primary display modes.
  1951. #.sp 1
  1952. #The digital waveform display in the \bRaw\r display mode
  1953. #reflects every frame in the trace buffer.
  1954. #However, the waveform display in \bCode\r and \bMixed\r
  1955. #modes reflects only the probe clip values in the first ALE
  1956. #cycle of each intruction's execution.  Therefore, if a probe signal
  1957. #transitions \uduring\r the ALE cycles of an instruction's
  1958. #execution, the displayed waveform may appear "broken".
  1959. #When you see this, you can switch into \bRaw\u display mode
  1960. #to get the complete picture.
  1961. #.($216)Search
  1962. #The \bSearch\r command allows you to search the trace buffer
  1963. #for a particular address, label, source line number or trace frame.
  1964. #.sp 1
  1965. #In searching for an address, label or source line number,
  1966. #the search commences from the current position in the trace buffer
  1967. #(the highlighted line in the middle of the window).
  1968. #You can search backwards in the trace buffer, looking for older
  1969. #trace frames, or forwards, looking for newer (more recent) trace
  1970. #frames.
  1971. #.($217)Write
  1972. #You can write the entire trace buffer to a disk file by selecting
  1973. #\bWrite\r command.  The format of the information written to
  1974. #that file will be just as you see it on the screen
  1975. #(i.e., in human-readable form, in the current display mode).
  1976. #.($244)Keyboard Input Control & Syntax
  1977. #\bKeyboard Editing Control Keys:\r
  1978. #.sp 1
  1979. #.in +2 {
  1980. #.in +11 {
  1981. #.ti -11
  1982. #\x1B^^^^^^^^^^move
  1983. #the cursor one character position to the left
  1984. #or scroll field horizontally
  1985. #.ti -11
  1986. #\x1A^^^^^^^^^^move
  1987. #the cursor one character position to the right
  1988. #or scroll field horizontally
  1989. #.ti -11
  1990. #Ctrl^Home^^move to beginning of input field
  1991. #.ti -11
  1992. #Ctrl^End^^^move to end of input field
  1993. #.ti -11
  1994. #Backspace^^delete the character to the left of the cursor
  1995. #.ti -11
  1996. #Del^^^^^^^^delete the character under the cursor
  1997. #.ti -11
  1998. #Ins^^^^^^^^toggle to/from insert mode (to insert a
  1999. #character before the character under the cursor)
  2000. #.ti -11
  2001. #Esc^^^^^^^^immediate exit (cancel input)
  2002. #.ti -11
  2003. #Enter^^^^^^terminate input "normally" (at any character position)
  2004. #.in -11 }
  2005. #.in -2 }
  2006. #.sp 1
  2007. #\bInput Syntax\r
  2008. #.sp 1
  2009. #.in +2 {
  2010. #When \b%rs1\r requests an address or value to be input in an input
  2011. #box, the following forms can be used:
  2012. #.sp 1
  2013. #.in +2 {
  2014. #\bNumbers\r
  2015. #.sp 1
  2016. #.in +2 {
  2017. #.ba {
  2018. #^^^^^^^^^^^^^^\xDA^\xBF
  2019. #\xDA^\xBF^^^^^^^^^^^\xB3H\xB3
  2020. #\xB3\xF1\xB3<digits...>\xB3h\xB3
  2021. #\xC0^\xD9^^^^^^^^^^^\xB3.\xB3
  2022. #^^^^^^^^^^^^^^\xC0^\xD9
  2023. #.ea }
  2024. #.sp 1
  2025. #.in +2 {
  2026. #If you supply a suffix of 'H' or 'h', the number will be
  2027. #treated as a hexadecimal number (base 16).
  2028. #If you supply a suffix of '.', the number will be
  2029. #treated as a decimal number (base 10).
  2030. #If you don't supply an explicit suffix, the number will be interpreted
  2031. #according to context:  normally, hexadecimal for addresses and
  2032. #decimal for counts.
  2033. #.sp 1
  2034. #Note that if you intend a hexadecimal number to begin with letter
  2035. #('a'-'f' or 'A'-'F'), you must explicitly supply a leading zero
  2036. #before that letter.
  2037. #.in -2 }
  2038. #.in -2 }
  2039. #.sp 1
  2040. #\bLabels/Symbols/Variables\r
  2041. #.sp 1
  2042. #.in +2 {
  2043. #.ba {
  2044. #\xDA^\xBF
  2045. #\xB3\xF1\xB3symaddr
  2046. #\xC0^\xD9
  2047. #.ea }
  2048. #.sp 1
  2049. #.in +2 {
  2050. #where 'symaddr' is one of:
  2051. #.sp 1
  2052. #.in +2 {
  2053. #.in +15 {
  2054. #.ti -15
  2055. #sym^^^^^^^^^^^^Global
  2056. #symbol 'sym', or local symbol 'sym' defined within the current module.
  2057. #.ti -15
  2058. ##number^^^^^^^^Line number 'number', within the current module.
  2059. #.ti -15
  2060. #mod:#number^^^^Line number 'number', within module 'mod'.
  2061. #.ti -15
  2062. #mod:sym^^^^^^^^Local symbol 'sym'
  2063. #defined within module 'mod'.
  2064. #.ti -15
  2065. #mod:sym1:sym2^^Local symbol
  2066. #'sym2' defined within local procedure 'sym1' defined in module 'mod'.
  2067. #.in -15 }
  2068. #.in -2 }
  2069. #.sp 1
  2070. #sym = code label, procedure/function name or variable name.
  2071. #.in -2 }
  2072. #.in -2 }
  2073. #.in -2 }
  2074. #.in -2 }
  2075. #.($245)Help for Help
  2076. #\bGeneral\r
  2077. #.sp 1
  2078. #.in +2 {
  2079. #"Boldfaced" text in a Help Topic appears as:^^\bboldfaced\r.
  2080. #"Underlined" text in a Help Topic appears as:^^\uunderlined\r.
  2081. #.in -2 }
  2082. #.sp 1
  2083. #\bHyperlinks\r
  2084. #.sp 1
  2085. #.in +2 {
  2086. #A hyperlink is a viewable cross-reference embedded within one
  2087. #Help Topic to another, related Help Topic.
  2088. #You can "select" this embedded reference to view the Help Topic
  2089. #denoted by the hyperlink.  To do this, you first "position" to
  2090. #the hyperlink of interest (a given Help Topic may contain several
  2091. #embedded hyperlinks) and then "select" it:
  2092. #.sp 1
  2093. #.in +4 {
  2094. #.in +11 {
  2095. #.ti -11
  2096. #\bTab\r^^^^^^^^position to next hyperlink and highlight it
  2097. #.ti -11
  2098. #\bShift^Tab\r^^position to previous hyperlink and highlight it
  2099. #.ti -11
  2100. #\bEnter\r^^^^^^select current (highlighted) hyperlink
  2101. #.in -11 }
  2102. #.in -4 }
  2103. #.sp 1
  2104. #The \l($246)Configure|Options|Stack^Hyperlinks\m toggle controls
  2105. #the behavior of the Help System when a new hyperlink is selected.
  2106. #.in -2 }
  2107. #.sp 1
  2108. #\bHelp for "Pushed Contexts" (F2)\r
  2109. #.sp 1
  2110. #.in +2 {
  2111. #In some cases, the \b%rs1\r context-sensitive Help System is too
  2112. #context-sensitive.  For example, while you are typing the name of
  2113. #a file to be loaded into the emulator,
  2114. #you might press the 'Help' hot key to get help on
  2115. #the acceptable file types.
  2116. #However, since you are in an
  2117. #input dialog box, you will get Help about editing keyboard input.
  2118. #In such cases, you can press the \bF2\r function key to obtain
  2119. #Help for the "outer context(s)".  Pressing \bF2\r repeatedly will take
  2120. #you back on the path that got you to where you are now, showing you
  2121. #each Help Topic along the way.
  2122. #.sp 1
  2123. #To get back to your present position in the Help System,
  2124. #simply press \bEsc\r to get back from the \bF2\r digression.
  2125. #(You will need to press \bEsc\r once for each time you pressed
  2126. #the \bF2\r key.
  2127. #Unlike the \l($246)Configure|Options|Stack^Hyperlinks\m toggle,
  2128. #the \bF2\r type of hyperlinking always "stacks".)
  2129. #.in -2 }
  2130. #.sp 1
  2131. #\bMove or Resize Help Box\r
  2132. #.sp 1
  2133. #.in +2 {
  2134. #.in +8 {
  2135. #.ti -8
  2136. #Ctrl^V^^Enter "Mo\bv\re Help Box" mode.
  2137. #See \l($353)Move^Box\m for more details.
  2138. #.sp 1
  2139. #.ti -8
  2140. #Ctrl^R^^Enter "\bR\resize Help Box" mode.
  2141. #See \l($354)Resize^Box\m for more details.
  2142. #.in -8 }
  2143. #.in -2 }
  2144. #.sp 1
  2145. #For your convenience, \l($247)General^Help\m is also available from
  2146. #here.
  2147. #.($246)Stack Hyperlinks
  2148. #The \bStack Hyperlinks\r toggle controls the behavior
  2149. #of the Help System when a new Help Topic is invoked via
  2150. #a hyperlink:
  2151. #.sp 1
  2152. #.in +2 {
  2153. #.in +6 {
  2154. #.ti -6
  2155. #On:^^^When you select a new Help Topic via a hyperlink
  2156. #in the current Help Topic,
  2157. #the host software "remembers" your position in the
  2158. #current Help Topic.  When you exit that new Help Topic,
  2159. #you return to the "remembered" position in the current
  2160. #Help Topic.  This process applies recursively.
  2161. #.ti -6
  2162. #Off:^^When you select a new Help Topic via a hyperlink
  2163. #in the current Help Topic,
  2164. #the host software does \unot\r "remember" your position in the
  2165. #current Help Topic.  When you exit that new Help Topic,
  2166. #you exit the Help System.
  2167. #.in -6 }
  2168. #.in -2 }
  2169. #.($247)General Help
  2170. #\bContext-Sensitive^Help\r
  2171. #.sp 1
  2172. #.in +2 {
  2173. #You can obtain context-sensitive Help information anywhere within
  2174. #the \b%rs1\r host software by pressing the hot key
  2175. #(function key) for Help, \bF1\r.
  2176. #.in -2 }
  2177. #.sp 1
  2178. #\bGeneral^Help\r
  2179. #.sp 1
  2180. #.in +2 {
  2181. #Following are some hyperlinks to general information and
  2182. #other miscellaneous topics.
  2183. #These topics are grouped together here because they are not associated
  2184. #with any single, particular context within the \b%rs1\r system.
  2185. #.sp 1
  2186. #Press the \bTab\r key
  2187. #to highlight the information you wish to view and then
  2188. #press \bEnter\r:
  2189. #.sp 1
  2190. #.in +2 {
  2191. #\l($346)Pull-down^Menus\m^^^^^^^^^^\l($248)Special^Keys\m
  2192. #.sp 1
  2193. #\l($249)Command^Line^Options\m^^^^^\l($250)System^Files\m
  2194. #.in -2 }
  2195. #.sp 1
  2196. #\bDemo Information:\r
  2197. #.sp 1
  2198. #.in +2 {
  2199. #\l($349)Overview^of^iceMASTER\m^^^^\l($350)Description^of^Demo/Simulator\m^
  2200. #.sp 1
  2201. #\l($351)Probe^Card^Catalog\m^^^^^^^\l($352)Contact\m^
  2202. #.in -2 }
  2203. #.in -2 }
  2204. #.($248)Special Keys
  2205. #Throughout the \b%rs1\r system, certain special keystrokes and
  2206. #keystroke combinations always have
  2207. #the same meaning (cause the same effect or same action).
  2208. #The following table lists those keys and describes their effects.
  2209. #.sp 1
  2210. #.in +3 {
  2211. #.in +12 {
  2212. #.ti -12
  2213. #Keystroke^^^Effect/Action
  2214. #.ti -12
  2215. #---------^^^-------------
  2216. #.ti -12
  2217. #Esc^^^^^^^^^Exit, or back out of, current menu/command.
  2218. #.ti -12
  2219. #\x18^^^^^^^^^^^Move highlight bar or cursor up one line.
  2220. #.ti -12
  2221. #\x19^^^^^^^^^^^Move highlight bar or cursor down one line.
  2222. #.ti -12
  2223. #\x1B^^^^^^^^^^^Move highlight bar or cursor one position
  2224. #to the left.
  2225. #.ti -12
  2226. #\x1A^^^^^^^^^^^Move highlight bar or cursor one position
  2227. #to the right.
  2228. #.ti -12
  2229. #Home^^^^^^^^Move highlight bar or cursor to the beginning
  2230. #of the data in the window/box.
  2231. #.ti -12
  2232. #End^^^^^^^^^Move highlight bar or cursor to the end
  2233. #of the data in the window/box.
  2234. #.ti -12
  2235. #PgUp^^^^^^^^Move highlight bar or cursor one screenful back
  2236. #in the data in the window/box.
  2237. #.ti -12
  2238. #PgDn^^^^^^^^Move highlight bar or cursor one screenful ahead
  2239. #in the data in the window/box.
  2240. #.ti -12
  2241. #Tab^^^^^^^^^Position (move) to the next window or field.
  2242. #.ti -12
  2243. #Shift^Tab^^^Position (move) to the previous window or field.
  2244. #.ti -12
  2245. #Ctrl^V^^^^^^Enter Box/Menu/Window "Mo\bv\re" mode.
  2246. #See \l($353)Move^Box\m for more details.
  2247. #.ti -12
  2248. #Ctrl^R^^^^^^Enter Box/Menu/Window "\bR\resize" mode.
  2249. #See \l($354)Resize^Box\m for more details.
  2250. #\bCtrl^R\r acts as a 3-way toggle when you use it
  2251. #on the pull-down menu boxes themselves.
  2252. #.ti -12
  2253. #Ctrl^W^^^^^^\bW\rrite the data in the window/box to a disk file
  2254. #of your choice.
  2255. #In all cases where the \bWrite\r command is present, \bCtrl^W\r
  2256. #is an alias for \bWrite\r.  In some contexts where it is not
  2257. #appropriate to have a specific \bWrite\r command, \bCtrl^W\r
  2258. #still is available to perform the 'Write' action.
  2259. #For example, \bCtrl^W\r is available in most of the pop-up windows
  2260. #accessible from the \bSource/Symbols\r menu bar command.
  2261. #.in -12 }
  2262. #.in -3 }
  2263. #.($249)Command Line Options
  2264. #Command line options (arguments) can begin with either a dash, \b-\r,
  2265. #or a forward slash, \b/\r.
  2266. #Command line arguments may be specified in any order;
  2267. #they are case-sensitive:
  2268. #.sp 1
  2269. #.in +8 {
  2270. #.ti -8
  2271. #-a
  2272. #.sp 1
  2273. #If you are using a very old version of Archimedes C,
  2274. #this argument is required for the \b%rs1\r host software to
  2275. #properly handle/display code labels.
  2276. #.sp 1
  2277. #.ti -8
  2278. #-d^<ms>
  2279. #.sp 1
  2280. #Set the macro playback delay between keystrokes
  2281. #to <ms> milliseconds.  \b-d <ms>\r is to be used in conjunction
  2282. #with the \b-i\r command line argument.
  2283. #.sp 1
  2284. #.ti -8
  2285. #-hbbb
  2286. #.sp 1
  2287. #Heuristics to help in determining each module's
  2288. #beginning and ending address.
  2289. #Each 'b' is either '0' (don't use) or '1' (use),
  2290. #as follows:
  2291. #.sp 1
  2292. #.in +3 {
  2293. #.ba {
  2294. #-hbbb
  2295. #  |||_ Use min/max code text initialization
  2296. #  ||   addresses from each module.
  2297. #  ||__ Use min/max source line number
  2298. #  |    addresses from each module.
  2299. #  |___ Use min/max code label (local or global)
  2300. #       addresses from each module.
  2301. #.ea }
  2302. #.in -3 }
  2303. #.sp 1
  2304. #The default is '-h111':  Use all three pieces of
  2305. #information in determining the minimum and maximum
  2306. #addresses for each module.  You may see better results
  2307. #for some programs with
  2308. #.sp 1
  2309. #.in +2 {
  2310. #.in +3 {
  2311. #.in +7 {
  2312. #-h110^^Use both min/max code label addresses
  2313. #and min/max source line number addresses
  2314. #in determining the beginning and ending
  2315. #addresses for each module.
  2316. #.in -7 }
  2317. #.in -3 }
  2318. #.sp 1
  2319. #or even
  2320. #.sp 1
  2321. #.in +3 {
  2322. #.in +7 {
  2323. #-h010^^Use only min/max source line number
  2324. #addresses in determining the beginning and
  2325. #ending addresses for each module.
  2326. #.in -7 }
  2327. #.in -3 }
  2328. #.in -2 }
  2329. #.sp 1
  2330. #.ti -8
  2331. #-i^<macrofile_name>
  2332. #.sp 1
  2333. #Use <macrofile_name> as the startup macro input file.
  2334. #.sp 1
  2335. #.ti -8
  2336. #-l
  2337. #.sp 1
  2338. #Ignore LOCAL symbols when loading an absolute object
  2339. #module format file.  Use where some symbolic debug is
  2340. #desired when there are an extremely large number of
  2341. #local symbols.  This is provided as an
  2342. #alternative to selective
  2343. #re-compiling/re-assembling and relinking without
  2344. #debug info output.
  2345. #.sp 1
  2346. #.ti -8
  2347. #-m^<file_name>
  2348. #.sp 1
  2349. #Use <file_name> as the Model File (probe card description/definition
  2350. #file) instead of \b$MODEL\r.
  2351. #.sp 1
  2352. #.ti -8
  2353. #-n
  2354. #.sp 1
  2355. #Forces interpretation of the 'blink' video
  2356. #attribute bit to mean "intensify the background color".
  2357. #Effectively, this allows use of 16 background colors
  2358. #rather than the normal 8.
  2359. #This option should be specified only when your PC has
  2360. #an EGA/VGA adapter installed, attached to an EGA/VGA
  2361. #monitor.
  2362. #.sp 1
  2363. #Normally, the \b%rs1\r host software automatically determines how to
  2364. #interpret the 'blink' bit, based on the adapter and
  2365. #monitor installed in the computer.  However, sometimes
  2366. #the software can get "fooled".  This option provides an
  2367. #absolute override.
  2368. #.sp 1
  2369. #.ti -8
  2370. #-o
  2371. #.sp 1
  2372. #Forces interpretation of the 'blink' video
  2373. #attribute bit to mean "blink the foreground character".
  2374. #This option should be specified when your PC has
  2375. #a Monochrome or CGA adapter installed, attached to a
  2376. #monochrome or CGA monitor.
  2377. #Normally, the \b%rs1\r host software automatically determines how to
  2378. #interpret the 'blink' bit, based on the adapter and
  2379. #monitor installed in the system.  However, sometimes
  2380. #the software can get "fooled".  This option provides an
  2381. #absolute override.
  2382. #.sp 1
  2383. #.ti -8
  2384. #-s <path>
  2385. #.sp 1
  2386. #<path> to use in locating Higher-Level Language (HLL)
  2387. #source files;  if not specified, the default is the current
  2388. #directory.
  2389. #.sp 1
  2390. #.ti -8
  2391. #-v
  2392. #.sp 1
  2393. #Disable testing (loading) of all possible video
  2394. #character sets (screen sizes) during host software initialization.
  2395. #This option is handy when you want to use a screen size
  2396. #(number of rows) which is not directly settable from
  2397. #within the host software using the
  2398. #\l($47)Configure|Display^Attributes|Lines\m command.
  2399. #If you specify the \b-v\r option,
  2400. #the \b%rs1\r host software will respect (use, retain, not change)
  2401. #the screen size (number of rows) in effect on entry to
  2402. #the host software.
  2403. #.sp 1
  2404. #For example, you can use the Norton
  2405. #Utilities' Norton Control Center to set a screen
  2406. #size and then invoke the host software with the \b-v\r option
  2407. #to retain that screen size while using the host software.
  2408. #.sp 1
  2409. #If you use this option, you must ensure that the PC is in some usable
  2410. #video mode when the host software is invoked
  2411. #(e.g., BIOS Video Mode 3, the default for CGA,EGA,VGA monitors).
  2412. #.sp 1
  2413. #When you use this option, the
  2414. #\l($47)Configure|Display^Attributes|Lines\m will be inaccessible.
  2415. #.sp 1
  2416. #.ti -8
  2417. #<file_name>
  2418. #.sp 1
  2419. #name of file to be \l($86)Load\med automatically into the \b%rs1\r
  2420. #emulator when the host software is invoked from the DOS command line.
  2421. #.in -8 }
  2422. #.($250)System Files
  2423. #.in +5 {
  2424. #.ti -5
  2425. #\b$MODEL\r
  2426. #.sp 1
  2427. #This file describes the unique properties, characteristics
  2428. #and features of a particular probe card (pod).
  2429. #The $MODEL file also contains the Help information.
  2430. #.sp 1
  2431. #.ti -5
  2432. #\b$CLR1$\r
  2433. #.sp 1
  2434. #Supplied file containing the default color and video attribute
  2435. #settings suitable for CGA monitors.
  2436. #.sp 1
  2437. #.ti -5
  2438. #\b$CLR2$\r
  2439. #.sp 1
  2440. #Supplied file containing the default color and video attribute
  2441. #settings suitable for EGA/VGA monitors.
  2442. #.sp 1
  2443. #.ti -5
  2444. #\b$CLRM$\r
  2445. #.sp 1
  2446. #Supplied file containing the default color and video attribute
  2447. #settings suitable for Monochrome monitors.
  2448. #.sp 1
  2449. #.ti -5
  2450. #\b$TRDAT$\r
  2451. #.sp 1
  2452. #A temporary (scratch) file which contains the raw, binary
  2453. #image of the current trace buffer.  The host software reads the
  2454. #contents of the trace buffer from the emulator and writes it to
  2455. #this file to minimize memory consumption within the host PC.
  2456. #.sp 1
  2457. #.ti -5
  2458. #\b$CODMEM$\r
  2459. #.sp 1
  2460. #A temporary (scratch) file which contains the raw, binary
  2461. #image of the program currently loaded in the emulator.
  2462. #This file is used when setting complex breakpoints
  2463. #to minimize memory consumption within the host PC.
  2464. #.in -5 }
  2465. #.($251)Repaint Windows
  2466. #The \bRepaint\r windows command simply repaints all the windows on the
  2467. #main screen.
  2468. #.sp 1
  2469. #You can select this command (repeatedly) to monitor the values
  2470. #of a port's pins if you suspect that they are changing when the
  2471. #emulator is in "break condition"
  2472. #(i.e., emulator not currently emulating).
  2473. #.($252)Code
  2474. #The \bCode\r command calls a pop up menu which allows you to
  2475. #\l($254)Fill\m, \l($255)Move\m or \l($257)Write\m a block of raw
  2476. #code memory and to \l($256)Compare\m two blocks of raw code memory.
  2477. #There is also a \l($253)Browse\m mode available to allow you
  2478. #to browse through raw code memory.
  2479. #.($253)Browse
  2480. #\bBrowse^Mode\r is entered by selecting the \bBrowse\r command
  2481. #or by using any of the keypad cursor keys (\uexcept\r the left '\x1B'
  2482. #and right '\x1A' arrow keys).
  2483. #In browse mode you can scroll through memory by using
  2484. #\uany\r of the keypad cursor keys or can type an address
  2485. #(absolute or symbolic) to quickly view an area in memory.
  2486. #.sp 1
  2487. #Once in \bBrowse^Mode\r, you may switch between
  2488. #\bBrowse^Mode\r and \bChange^Mode\r by using the TAB key.
  2489. #In \bChange^Mode\r you can scroll through memory in the
  2490. #same manner as \bBrowse^Mode\r but may also change the value of
  2491. #a memory address.  This is done by pressing 'Enter' when
  2492. #positioned at the desired address.  You will then be
  2493. #prompted to enter the value to store at that address.
  2494. #.($254)Fill
  2495. #The \bFill\r command is used to quickly fill a block a memory
  2496. #with some value (or values).  When the \bFill\r command is
  2497. #selected a dialog box will pop up to prompt for the address
  2498. #range to fill and the pattern to fill that range with.
  2499. #.sp 1
  2500. #The fill pattern may contain one or many values up to a total
  2501. #typed length of about 80 characters.  If multiple
  2502. #values are needed, they must be separated by commas (',') or
  2503. #spaces (' ').  Numeric values are by default hexadecimal and
  2504. #ASCII literals must be quoted (e.g, use 'A' to put the ASCII
  2505. #value of A in memory).
  2506. #.($255)Move
  2507. #The \bMove\r command is used to move (copy) a block of memory
  2508. #to another location in memory.  When the \bMove\r command is
  2509. #selected a dialog box will pop up to prompt for the address
  2510. #range for the source block and the starting address of the
  2511. #target block.
  2512. #.($256)Compare
  2513. #The \bCompare\r command is used to compare two blocks of memory.
  2514. #When the \bCompare\r command is selected a dialog box will
  2515. #pop up to prompt for the address range of one block and the
  2516. #starting address of the second block.  If the blocks are the
  2517. #the same a message will inform you of that.  If the blocks are
  2518. #not the same the addresses and values of the mismatches will
  2519. #be displayed, along with a count of the total number of
  2520. #mismatches found.
  2521. #.($257)Write
  2522. #The \bWrite\r command is used to write a block of memory
  2523. #to a disk file.  The block will be written in the same format
  2524. #that the data is displayed on screen.  When the \bWrite\r
  2525. #command is selected a dialog box will pop up to prompt for
  2526. #the address range of the block to write and for the name
  2527. #of the file to write the data to.
  2528. #.($258)Idata
  2529. #The \bIdata\r command calls a pop up menu which allows you to
  2530. #\l($254)Fill\m, \l($255)Move\m or \l($257)Write\m a block of
  2531. #Indirect Internal Data memory and to \l($256)Compare\m two blocks of
  2532. #Indirect Internal Data memory.
  2533. #There is also a \l($253)Browse\m mode available to allow you
  2534. #to browse through Indirect Internal Data memory.
  2535. #.($264)Xdata
  2536. #The \bXdata\r command calls a pop up menu which allows you to
  2537. #\l($254)Fill\m, \l($255)Move\m or \l($257)Write\m a block of
  2538. #External Data memory and to \l($256)Compare\m two blocks of
  2539. #External Data memory.
  2540. #There is also a \l($253)Browse\m mode available to allow you
  2541. #to browse through External Data memory.
  2542. #.($270)Unknown Data Type Size
  2543. #The \bUnknown Data Type Size\r command is used to set the number of
  2544. #bytes to display for the value of an unknown data type in the
  2545. #\l($140)Global\m, \l($141)Local\m, \l($142)Alpha\m, and
  2546. #\l($143)Address\m symbol displays.  Up to 4 bytes can be displayed.
  2547. #.($271)Repetition Counter
  2548. #The \bRepetition Counter\r specifies how many
  2549. #emulation cycles will occur, after the next
  2550. #\l($96)Run\m-type command is issued,
  2551. #before "everything finally stops".
  2552. #.sp 1
  2553. #The steps in this process are:
  2554. #.sp 1
  2555. #.in +4 {
  2556. #.in +4 {
  2557. #.ti -4
  2558. #1)^^Set the Repetition Counter to some value greater than one.
  2559. #.ti -4
  2560. #2)^^Select one of the \bRun\r commands (\bReset\r, \bGo\r or \bStep\r).
  2561. #.ti -4
  2562. #3)^^Emulations begins.
  2563. #.ti -4
  2564. #4)^^Hardware breakpoint reached and real-time emulation stops.
  2565. #(If the \l($150)Break^Count\mer is non-zero, emulation does not
  2566. #actually stop until the program's flow-of-control passes through
  2567. #the specified number of breakpoints.)
  2568. #.ti -4
  2569. #5)^^Host software updates all windows.
  2570. #.ti -4
  2571. #6)^^Host software decrements Repetition Counter.  If result is
  2572. #not zero, emulation resumes (at current PC) and goto \b4)\r above.
  2573. #.in -4 }
  2574. #.in -4 }
  2575. #.($272)Slow Motion
  2576. #The \bSlow^Motion\r command starts an automatically repeated
  2577. #cycle of \l($102)Step\m commands.  The default delay between each
  2578. #repetition of the cycle is 500 milliseconds (1/2 second).
  2579. #You can increase the delay (go slower) by pressing the
  2580. #minus key, \b-\r.
  2581. #You can decrease the delay (go faster) by pressing the
  2582. #plus key, \b+\r.
  2583. #The Status Window shows the current delay time in the \bState:\r
  2584. #field.
  2585. #.sp 1
  2586. #You stop a \bSlow^Motion\r emulation by pressing the \bEsc\r key.
  2587. #.($273)Performance Analyzer
  2588. #The \bPerformance^Analyzer\r allows you to monitor the
  2589. #amount of time spent executing specified parts of the program
  2590. #loaded in code memory.  There are several reasons for using
  2591. #a performance analyzer:
  2592. #.sp 1
  2593. #.in +8 {
  2594. #.ti -4
  2595. #To identify and optimize program "hot spots".
  2596. #.ti -4
  2597. #To verify there is no "dead" (unexecuted) code.
  2598. #.ti -4
  2599. #To verify that execution is always within program bounds.
  2600. #.ti -4
  2601. #To verify execution of certain code in response to some
  2602. #internal or external condition/stimulus.
  2603. #.in -8 }
  2604. #.sp 1
  2605. #Each portion of the program to be monitored is called a bin.
  2606. #A bin contains a \l($370)Type\m, a \l($372)Number\m,
  2607. #a \l($369)Capture^Range\m and a \l($371)Description\m.
  2608. #Usually, each bin will consist of a single code memory address
  2609. #range (starting address through ending address, inclusive),
  2610. #although a bin may be created with several code memory address
  2611. #ranges which are not contiguous.  PC sample counts and
  2612. #percentages are collected on a per-bin basis.
  2613. #.($274)Statistics
  2614. #The \bStatistics\r pull-down menu allows you to
  2615. #\l($276)Accumulate\m, \l($275)Clear\m and \l($277)View\m
  2616. #performance analysis statistics (sample counts).
  2617. #.($275)Statistics,Clear
  2618. #The \bClear\r command clears any statistics (sample counts)
  2619. #gathered during previous performance analysis emulation(s).
  2620. #.($276)Statistics,Accumulate
  2621. #The \bAccumulate\r command allows you to control
  2622. #whether or not statistics (sample counts) from one
  2623. #performance analysis emulation to the next will be
  2624. #accumulated.  When accumulate is \bOFF\r any statistics
  2625. #from previous emulations are cleared before subsequent
  2626. #emulations.  When accumulate is \bON\r any statistics from new
  2627. #emulations are added to the statistics from previous emulations.
  2628. #The state the accumulate command is displayed in the
  2629. #Statistics Pull-down Menu and on the performance analyzer
  2630. #setup screen.
  2631. #.($277)Statistics,View
  2632. #The \bView\r command allows you to view the results of
  2633. #previous performance analysis emulations.
  2634. #.($278)Run
  2635. #The \bRun\r pull-down menu allows you to start a
  2636. #performance analysis emulation in three ways, by
  2637. #\l($279)Emulator^Reset\m, by \l($280)Target^Reset\m
  2638. #and by \l($281)Go\m (from PC).  Note that a
  2639. #performance analysis setup must be defined before any of
  2640. #these commands will function.
  2641. #.($279)Run,Reset (Emulator)
  2642. #The \bReset^(Emulator)\r command starts a performance
  2643. #analysis emulation from a reset condition.  The reset signal
  2644. #will be supplied by the emulator itself.
  2645. #.($280)Run,Reset (Target)
  2646. #The \bReset^(Target)\r command starts a performance
  2647. #analysis emulation from a reset condition.  The reset signal
  2648. #will be supplied by the target system.  Emulation will not
  2649. #begin until a reset signal is received from the target system.
  2650. #.($281)Run,Go
  2651. #The \bGo\r command starts a performance analysis emulation.
  2652. #Emulation begins at the code memory location indicated by
  2653. #the PC.
  2654. #.($282)Quick-setup
  2655. #The \bQuick-setup\r pull-down allows you to quickly
  2656. #define one of four types of performance analysis setups.
  2657. #They are \l($283)N-Equal\m, \l($284)Module\m,
  2658. #\l($285)Procedure\m and \l($286)Line^Numbers\m.
  2659. #The number of \l($291)Bins\m used for a quick-setup can
  2660. #also be set, otherwise the default number of bins will be used.
  2661. #No bins will be created with \l($369)Capture^Ranges\m
  2662. #out of the \l($290)Capture^Span\m used for the setup.
  2663. #.($283)Quick-setup,N-Equal
  2664. #The \bN-Equal\r command is used to quickly define a setup
  2665. #of equally sized bins.  It does this by partitioning the
  2666. #\l($290)Capture^Span\m into N equally sized areas (where
  2667. #N is the number of \l($291)Bins\m).
  2668. #Each created bin
  2669. #will be created as \l($370)Type\m 'Neql' with the
  2670. #\l($371)Description\m set with the number of bytes
  2671. #in the \l($369)Capture^Range\m.
  2672. #.($284)Quick_setup,Module
  2673. #The \bModule\r command is used to quickly define a setup
  2674. #monitoring module address ranges.  If possible, each bin will
  2675. #monitor one module; as specified by the program
  2676. #currently loaded into code memory.  If the program contains
  2677. #more modules than the number of \l($291)Bins\m, each bin
  2678. #may monitor several modules.
  2679. #.sp 1
  2680. #Each created bin will be created as \l($370)Type\m 'Mod' with
  2681. #the \l($371)Description\m set with the name(s) of the module(s)
  2682. #monitored by the bin.  Each bins
  2683. #\l($369)Capture^Range\m will be from the starting address
  2684. #of the first module monitored by the bin through the
  2685. #ending address of the last module monitored by the bin, inclusive.
  2686. #.($285)Quick_setup,Procedure
  2687. #The \bProcedure\r command is used to quickly define a setup
  2688. #to monitor the address ranges between
  2689. #procedures, functions and global (public) code labels.
  2690. #If possible, each bin will monitor the range between one
  2691. #procedure, function, or global code label and the next.
  2692. #If the program contains more procedures, functions, and
  2693. #global code labels than the number of \l($291)Bins\m, each bin
  2694. #may monitor the address range encompassing several
  2695. #procedure, function, or global code labels.
  2696. #.sp 1
  2697. #Each created bin will be created as \l($370)Type\m 'Proc' with
  2698. #the \l($371)Description\m set with the name(s) of the
  2699. #procedure(s), function(s), or global code label(s)
  2700. #monitored by the bin.
  2701. #Each bins \l($369)Capture^Range\m will be from the address
  2702. #of the first procedure, function, or global code label
  2703. #monitored by the bin through the address (-1) of the first
  2704. #procedure, function, or global code label monitored by the next bin.
  2705. #.sp 1
  2706. #Note that global code memory labels are included because not
  2707. #all language processors (compilers) mark procedures/functions
  2708. #properly in the absolute object module debug records.
  2709. #.($286)Quick_setup,Line Numbers
  2710. #The \bLine^Numbers\r command is used to quickly define a setup
  2711. #monitoring line number address ranges.  If possible, each bin will
  2712. #monitor the range between one line number and the next line number.
  2713. #If the program contains more line numbers than the number
  2714. #of \l($291)Bins\m, each bin may monitor the address ranges
  2715. #encompassing several line numbers.
  2716. #.sp 1
  2717. #Each created bin will be created as \l($370)Type\m 'Lnum' with
  2718. #the \l($371)Description\m set with the name(s) of the
  2719. #module(s) and line number(s) monitored by the bin.
  2720. #Each bins \l($369)Capture^Range\m will be from the address
  2721. #of the first line number monitored by the bin through the
  2722. #address (-1) of the first line number of the next bin.
  2723. #.($287)Misc
  2724. #The \bMisc\r pull-down menu allows you to
  2725. #\l($288)Clear\m a defined performance analyzer setup,
  2726. #to change the \l($289)Sort^Order\m used to display a
  2727. #performance analyzer setup and to define the
  2728. #\l($290)Capture^Span\m the performance analyzer
  2729. #setup will encompass.
  2730. #.($288)Misc,Clear
  2731. #The \bClear\r command is used to clear all bins associated
  2732. #with a defined performance analyzer setup.  This includes any
  2733. #statistics from previous performance analyzer emulations.
  2734. #.($289)Misc,Sort Order
  2735. #The \bSort^Order\r command is used to change the sort order
  2736. #of the displayed bins in the current performance analyzer
  2737. #setup.  The setup can be sorted by either \l($372)Bin^Number\m or
  2738. #\l($369)Capture^Range\m.  The current sort order is displayed in
  2739. #the Misc Pull-down Menu and in the title above the bins
  2740. #in the performance analyzer setup menu.
  2741. #.($290)Misc,Capture Span
  2742. #The \bCapture^Span\r command allows you to specify the
  2743. #code memory address span over which the bin \l($369)Capture^Ranges\m
  2744. #may be defined.  Neither \l($282)Quick-setup\m bins or user-defined
  2745. #bins can have a capture range out of that span.
  2746. #The capture span is displayed in the upper left of the
  2747. #performance analyzer setup menu.
  2748. #.sp 1
  2749. #If a quick setup is selected before the capture span has been
  2750. #defined, the capture span will default to the address range
  2751. #covered by the program currently loaded in code memory.  If no
  2752. #program is loaded the capture span will then default to all
  2753. #of addressable code memory.
  2754. #.($291)Quick-setup,Bins
  2755. #The \bBins\r command allows you to specify the number of
  2756. #bins to use in a \l($282)Quick-setup\m.  However, if there
  2757. #are not enough ranges (generated by the quick setup)
  2758. #to fill the number of bins specified the number of bins will be
  2759. #be set to the number needed.  For example, if you specify
  2760. #12 bins and then select a \l($284)Module\m quick setup and there
  2761. #are only 4 modules, the number of bins will be set to 4.
  2762. #.sp 1
  2763. #In addition, if the number of bins is not defined before a
  2764. #quick setup is selected, the number of bins will default to
  2765. #15 for a High Resolution Performance Analysis setup
  2766. #and 50 for
  2767. #a High Bin Count Performance Analysis setup.
  2768. #Of course, this number may be
  2769. #automatically adjusted downward as described above.
  2770. #The maximum number of bins that may be specified is 15 for
  2771. #a High Resolution Performance Analysis setup and 999 for
  2772. #a High Bin Count Performance Analysis setup.
  2773. #The number of bins is displayed in the
  2774. #Quick-Setup Pull-down Menu and at the upper right of the
  2775. #performance analyzer setup menu.
  2776. #.sp 1
  2777. #If the maximum number of bins is specified there is a
  2778. #special case where the number of bins may be decremented
  2779. #by one.  This will happen if a \l($370)Miss^Bin\m is needed.
  2780. #.($292)Edit
  2781. #The \bEdit\r command allows you to edit the contents of
  2782. #the currently highlighted bin.  Any bin can be edited except
  2783. #for the \l($370)Miss^Bin\m.
  2784. #All fields of a bin (\l($372)Number\m, \l($369)Capture^Range\m
  2785. #and \l($371)Description\m) can be edited except for bin
  2786. #\l($370)Type\m which is changed automatically by the software
  2787. #depending on how the other fields are edited.  In general,
  2788. #the bin type will be changed to 'User' if any fields of the
  2789. #bin are changed.
  2790. #.sp 1
  2791. #If the edited fields are valid the Miss Bins will be
  2792. #recalculated and the setup will be sorted and redisplayed.
  2793. #.sp 1
  2794. #Note that if the \bEdit\r command is selected when no bins
  2795. #are defined you are given an empty bin to edit, which
  2796. #is effectively the \l($292)Add\m command.
  2797. #.($293)Add
  2798. #The \bAdd\r command allows you to add a bin to the
  2799. #current performance analyzer setup.  When the \bAdd\r
  2800. #command is selected control is automatically passed to the
  2801. #\l($292)Edit\m screen with an empty
  2802. #bin and edit screen rules apply.
  2803. #If the edited fields are valid the bin will be added
  2804. #to the setup, the \l($370)Miss^Bins\m will be recalculated,
  2805. #the number of \l($291)Bins\m will be incremented by one and
  2806. #the setup will be sorted and redisplayed.
  2807. #.($294)Delete
  2808. #The \bDelete\r command is used to delete the currently highlighted
  2809. #bin from the current performance analyzer setup.  Any bin but the
  2810. #\l($370)Miss^Bin\m can be deleted.  After a bin has been deleted
  2811. #the miss bins will be recalculated,
  2812. #the number of \l($291)Bins\m will be decremented by one and
  2813. #the setup will be sorted and redisplayed.
  2814. #.($295)File
  2815. #The \bFile\r Pull-down Menu allows you to \l($296)Save\m
  2816. #a performance analyzer setup to a disk file and to \l($297)Load\m
  2817. #a previously saved performance analyzer setup from a disk file.
  2818. #.($296)File,Save
  2819. #The \bSave\r command allows you to save the currently
  2820. #defined performance analyzer setup to a disk file.  You
  2821. #will be prompted for the name of the file.  A saved setup can
  2822. #be restored later using the \l($297)Load\m command.
  2823. #.($297)File,Load
  2824. #The \bLoad\r command allows you to restore a previously
  2825. #stored performance analyzer setup (via the \l($296)Save\m command).
  2826. #You will be prompted for the name of the file.
  2827. #.($323)Raw
  2828. #The \bRaw\r command changes the display format to Raw Mode.
  2829. #In the Raw Mode, you see only the bar graph (percentage) lines,
  2830. #one per bin.
  2831. #.sp 1
  2832. #Note that the bar graph (percentage) lines exist in all of the
  2833. #other display formats, too.
  2834. #.sp 1
  2835. #.in +2 {
  2836. #An asterisk following the percentage of time spent in
  2837. #a bin indicates a non-zero sample count for that bin.
  2838. #This indication is useful, as the percentage of time spent
  2839. #in a particular bin may be non-zero,
  2840. #but less than 0.1%% (in which case,
  2841. #the percentage of time spent in that bin displays as
  2842. #"0.0*").
  2843. #.in -2 }
  2844. #.($324)Symbolic
  2845. #The \bSymbolic\r command changes the display format to Symbolic Mode.
  2846. #In the Symbolic Mode, you see the bar graph (percentage) line
  2847. #for each bin,
  2848. #followed by one line for each global (PUBLIC) and/or local code
  2849. #memory label within each address range in that bin.
  2850. #.sp 1
  2851. #The Model File A42 directive controls whether the display contains
  2852. #only global code labels or only local code labels,
  2853. #or both.
  2854. #.sp 1
  2855. #In the display, an asterisk ('*') precedes global code labels
  2856. #to distinguish them from local code labels.
  2857. #.($325)HLL
  2858. #The \bHLL\r command changes the display format to HLL Mode.
  2859. #In the HLL Mode, you see the bar graph (percentage) line
  2860. #for each bin,
  2861. #followed by the HLL source line images
  2862. #within each address range in that bin.
  2863. #If a particular HLL source image is not available to %rs1,
  2864. #the display shows only the module name and line number.
  2865. #If the program loaded into code memory does not
  2866. #contain source line number debug records, it is not possible
  2867. #for %rs1 to display either HLL source line images
  2868. #or module names and line numbers.
  2869. #.($326)Mixed
  2870. #The \bMixed\r command changes the display format to Mixed Mode.
  2871. #In the Mixed Mode, you see everything included in the other
  2872. #primary display formats:
  2873. #\l($323)Raw\m, \l($324)Symbolic\m and \l($325)HLL\m.
  2874. #.sp 1
  2875. #If a code memory label and an HLL source image are located
  2876. #at the same code memory address, the code memory label will
  2877. #appear in the display before the HLL source image.
  2878. #.($327)Counts
  2879. #The \bCounts\r command toggles the display
  2880. #from showing a bar graph (percentage) line for each bin
  2881. #to showing the actual sample (hit) count for that bin.
  2882. #The \bCounts\r display mode toggle command operates independently
  2883. #of any other display control command.
  2884. #.sp 1
  2885. #The sum of the sample counts for each bin usually equals the
  2886. #total sample count shown near the top-right of the
  2887. #display at "Samples:";
  2888. #however, the \l($329)Miss^Bin\m may or may not be included in the
  2889. #total "Samples:" count.
  2890. #.($328)Expand
  2891. #The \bExpand\r command toggles the display into and out of
  2892. #expanded display mode.
  2893. #The \bExpand\red display mode toggle command operates independently
  2894. #of any other display control command.
  2895. #.sp 1
  2896. #When expanded mode is on,
  2897. #following each bar graph (percentage) line for each bin,
  2898. #there will be one line showing each address range in the bin
  2899. #if than bin contains (covers) more than one address range.
  2900. #.sp 1
  2901. #You can enter \bExpand\red display mode only if there is at
  2902. #least one bin that contains (covers) more than one address range.
  2903. #.($329)Misses
  2904. #The \bMisses\r toggle command controls whether or not
  2905. #"misses" are included in:
  2906. #.sp 1
  2907. #.in +2 {
  2908. #.in +4 {
  2909. #.ti -4
  2910. #1)^^the total sample count displayed
  2911. #near the top-right of the screen at "Samples:", and,
  2912. #.ti -4
  2913. #2)^^the cumulative percentage statistic.
  2914. #.in -4 }
  2915. #.in -2 }
  2916. #.sp 1
  2917. #The Performance Analyzer allocates the "Miss Bin" to
  2918. #monitor program execution in \ueach and every\r code memory location
  2919. #which you are not explicitly monitoring.
  2920. #The Miss Bin does not exist if you are explicitly
  2921. #monitoring (via the current Performance Analyzer Setup)
  2922. #every code memory location.
  2923. #.sp 1
  2924. #Even when the \bMisses\r command is toggled to the 'OFF'
  2925. #mode (and thus, the percentage for the Miss Bin
  2926. #is computed as zero), you can view the actual sample counts in
  2927. #the Miss Bin by toggling the \l($327)Counts\m mode to 'ON'.
  2928. #.($330)Write
  2929. #The \bWrite\r command allows you to write all current performance
  2930. #analysis results to a file of your choice.
  2931. #The information will be written using the current display formats.
  2932. #.($331)Help (Performance Analyzer View)
  2933. #\l($323)Raw\m^^^^^^\l($324)Symbolic\m^^^\l($325)HLL\m^^^\l($326)Mixed\m
  2934. #.sp 1
  2935. #\l($327)Counts\m^^^\l($328)Expand\m^^^^^\l($329)Misses\m
  2936. #.sp 1
  2937. #\l($330)Write\m
  2938. #.($343)Write
  2939. #You can write the disassembled content of code memory
  2940. #to a disk file by selecting
  2941. #\bWrite\r command.  The format of the information written to
  2942. #that file will be just as you see it on the screen
  2943. #(i.e., in human-readable form, in the current display mode).
  2944. #.($344)
  2945. #(Help Information for "HC_???" To Be Supplied.)
  2946. #.($345)Select Color
  2947. #The column headers on the right hand side of this display
  2948. #are very short abbreviations for the following color controls:
  2949. #.sp 1
  2950. #.in +11 {
  2951. #.ti -11
  2952. #Column^^^^^^^
  2953. #.ti -11
  2954. #Header^^^^^Meaning
  2955. #.ti -11
  2956. #---------^^-------------------------
  2957. #.ti -11
  2958. #Cl^border^^box border, color
  2959. #.ti -11
  2960. #Hl^border^^box border, highlight color
  2961. #.ti -11
  2962. #L^^border^^box border, line style
  2963. #.ti -11
  2964. #S^^border^^box border, -- shadow under box?
  2965. #.ti -11
  2966. #E^^border^^box border, -- exploding box?
  2967. #.ti -11
  2968. #Cl^body^^^^box body, color
  2969. #.ti -11
  2970. #Hl^body^^^^box body, highlight color
  2971. #.ti -11
  2972. #Qk^body^^^^box body, quick-key color
  2973. #.ti -11
  2974. #Hk^body^^^^box body, hot-key color
  2975. #.ti -11
  2976. #Vl^body^^^^box body, value color
  2977. #.ti -11
  2978. #In^body^^^^box body, inactive (inaccessible) command color
  2979. #.ti -11
  2980. #Is^body^^^^box body, inactive (inaccessible)
  2981. #command selected (highlighted) color
  2982. #.in -11 }
  2983. #.sp 1
  2984. #You will notice that the abbreviations and the explanations
  2985. #refer primarily to fields that appear in \l($346)pull-down^menu\ms,
  2986. #although many apply to "boxes" in general.
  2987. #.sp 1
  2988. #Some pop-up windows and menus overload the meaning of some otherwise
  2989. #"Not Applicable" color controls to govern a field or area
  2990. #which is unique to that menu or window.
  2991. #Those cases where the internal usage of a particular
  2992. #color control differs from the definitions given above
  2993. #are:
  2994. #.sp 1
  2995. #.in +2 {
  2996. #.ti -2
  2997. #\bFunction^Key^label^lines\r
  2998. #.sp 1
  2999. #.in +11 {
  3000. #.ti -11
  3001. #Cl^body^^^^Function key numbers preceding labels.
  3002. #.ti -11
  3003. #Hl^body^^^^Function key labels.
  3004. #.ti -11
  3005. #In^body^^^^Function key label when associated command/menu is
  3006. #already active (invoked).
  3007. #.in -11 }
  3008. #.sp 1
  3009. #.ti -2
  3010. #\bPop-up:^^Yes/No/Cancel^Questions\r
  3011. #.sp 1
  3012. #.in +11 {
  3013. #.ti -11
  3014. #Hl^body^^^^Currently highlighted response.
  3015. #.ti -11
  3016. #Qk^body^^^^Quick-Key for "\bY\res", "\bN\ro" or "\bC\rancel".
  3017. #.in -11 }
  3018. #.sp 1
  3019. #.ti -2
  3020. #\bWindow:^^Registers\r
  3021. #.sp 1
  3022. #.in +11 {
  3023. #.ti -11
  3024. #Hl^body^^^^Highlighted "current register".
  3025. #.ti -11
  3026. #Qk^body^^^^GPRn values.
  3027. #.ti -11
  3028. #Hk^body^^^^PSW bit values.
  3029. #.ti -11
  3030. #Vl^body^^^^SFR values.
  3031. #.in -11 }
  3032. #.sp 1
  3033. #.ti -2
  3034. #\bWindow:^^Source\r
  3035. #.sp 1
  3036. #.in +11 {
  3037. #.ti -11
  3038. #Hl^body^^^^Current PC position.
  3039. #.ti -11
  3040. #Qk^body^^^^Value history information for current PC.
  3041. #.ti -11
  3042. #Hk^body^^^^Module name & line number comments.
  3043. #.ti -11
  3044. #Vl^body^^^^HLL source images.
  3045. #.ti -11
  3046. #In^body^^^^Value history information for other than current PC.
  3047. #.in -11 }
  3048. #.sp 1
  3049. #.ti -2
  3050. #\bWindow:^^Watch\r
  3051. #.sp 1
  3052. #.in +11 {
  3053. #.ti -11
  3054. #Qk^body^^^^Variable's name.
  3055. #.ti -11
  3056. #Hk^body^^^^Variable's value when different from value at last break.
  3057. #.ti -11
  3058. #Vl^body^^^^Variable's value.
  3059. #.in -11 }
  3060. #.sp 1
  3061. #.ti -2
  3062. #\bWindow:^^Status\r
  3063. #.sp 1
  3064. #.in +11 {
  3065. #.ti -11
  3066. #Cl^body^^^^Names (labels) and all values which
  3067. #are not "heartbeat-updated" during emulation.
  3068. #.ti -11
  3069. #Qk^body^^^^Values for Real-Time Clock, Reset Count and State.
  3070. #.ti -11
  3071. #Hk^body^^^^Values for PC, Break Address and DPTR.
  3072. #.ti -11
  3073. #Vl^body^^^^Values which
  3074. #are "heartbeat-updated" during emulation.
  3075. #.ti -11
  3076. #In^body^^^^Values for Trace Memory Status, Trace Memory Read
  3077. #and Trace Trigger.
  3078. #.ti -11
  3079. #Is^body^^^^Values for Break and Repetition Counters.
  3080. #.in -11 }
  3081. #.sp 1
  3082. #.ti -2
  3083. #\bMenu:^^Help\r
  3084. #.sp 1
  3085. #.in +11 {
  3086. #.ti -11
  3087. #Hl^body^^^^Boldfaced text.
  3088. #.ti -11
  3089. #Qk^body^^^^Hyperlink.
  3090. #.ti -11
  3091. #Hk^body^^^^Current ("tabbed-to") Hyperlink.
  3092. #.ti -11
  3093. #Vl^body^^^^Underlined text.
  3094. #.in -11 }
  3095. #.sp 1
  3096. #.ti -2
  3097. #\bMenu:^^Break-Point\r
  3098. #.sp 1
  3099. #.in +11 {
  3100. #.ti -11
  3101. #Vl^body^^^^Current line highlight bar.
  3102. #.in -11 }
  3103. #.sp 1
  3104. #.ti -2
  3105. #\bMenu:^^Opcode^Class\r
  3106. #.sp 1
  3107. #.in +11 {
  3108. #.ti -11
  3109. #Vl^body^^^^Current line highlight bar.
  3110. #.in -11 }
  3111. #.sp 1
  3112. #.ti -2
  3113. #\bMenu:^^View^Trace\r
  3114. #.sp 1
  3115. #.in +11 {
  3116. #.ti -11
  3117. #Hl^border^^Digital waveform probe clip display:  value lines.
  3118. #.ti -11
  3119. #Hk^body^^^^Digital waveform probe clip display:  body.
  3120. #.ti -11
  3121. #Vl^body^^^^HLL source images.
  3122. #.in -11 }
  3123. #.sp 1
  3124. #.ti -2
  3125. #\bMenu:^^Disassembler/Assembler\r
  3126. #.sp 1
  3127. #.in +11 {
  3128. #.ti -11
  3129. #Vl^body^^^^HLL source images.
  3130. #.in -11 }
  3131. #.sp 1
  3132. #.ti -2
  3133. #\bMenu:^^Code,Idata,Xdata^View/Change\r
  3134. #.sp 1
  3135. #.in +11 {
  3136. #.ti -11
  3137. #Hk^body^^^^Prompt/input line highlight.
  3138. #.ti -11
  3139. #Vl^body^^^^Current address highlight.
  3140. #.in -11 }
  3141. #.sp 1
  3142. #.ti -2
  3143. #\bMenu:^^Performance^Analyzer^--^Set^Up\r
  3144. #.sp 1
  3145. #.in +11 {
  3146. #.ti -11
  3147. #Vl^body^^^^Current line highlight bar.
  3148. #.in -11 }
  3149. #.sp 1
  3150. #.ti -2
  3151. #\bMenu:^^Performance^Analyzer^--^View\r
  3152. #.sp 1
  3153. #.in +11 {
  3154. #.ti -11
  3155. #Hk^body^^^^Bin information (percentage) lines -- entire line
  3156. #except bar graph bars.
  3157. #.ti -11
  3158. #Vl^body^^^^HLL source images.
  3159. #.in -11 }
  3160. #.sp 1
  3161. #.ti -2
  3162. #\bMenu:^^Performance^Analyzer^--^View^(Highlights)\r
  3163. #.sp 1
  3164. #.in +11 {
  3165. #.ti -11
  3166. #Cl^body^^^^Bar graph bars.
  3167. #.ti -11
  3168. #Hl^body^^^^Real-time Clock, Sample Count and Reset Count values
  3169. #(post-emulation review).
  3170. #.ti -11
  3171. #Qk^body^^^^PC and Break Address values
  3172. #(post-emulation review).
  3173. #.ti -11
  3174. #Hk^body^^^^Values which are "heartbeat-updated" dynamically
  3175. #during emulation.
  3176. #.in -11 }
  3177. #.sp 1
  3178. #.ti -2
  3179. #\bMenu:^^Configure^Windows\r
  3180. #.sp 1
  3181. #.in +11 {
  3182. #.ti -11
  3183. #Vl^body^^^^Current values/settings.
  3184. #.in -11 }
  3185. #.sp 1
  3186. #.ti -2
  3187. #\bMenu:^^Function^Key^View/Modify\r
  3188. #.sp 1
  3189. #.in +11 {
  3190. #.ti -11
  3191. #Hk^body^^^^Highlight for current line & title in current
  3192. #window (Assignment or Option).
  3193. #.ti -11
  3194. #Vl^body^^^^Highlight for current line in non-current window.
  3195. #.in -11 }
  3196. #.sp 1
  3197. #.ti -2
  3198. #\bSource/Symbol^Displays\r
  3199. #.sp 1
  3200. #.in +11 {
  3201. #.ti -11
  3202. #Hk^body^^^^Accessible (referenceable) source line numbers --
  3203. #those source line numbers for which the compiler generated debugging
  3204. #information.  This type of highlighting is used only in the
  3205. #\l($136)Raw^Source\m pop-up window.
  3206. #.ti -11
  3207. #Vl^body^^^^Current line highlight bar.
  3208. #.in -11 }
  3209. #.sp 1
  3210. #.ti -2
  3211. #\bSign-On^Screen\r
  3212. #.sp 1
  3213. #.in +11 {
  3214. #.ti -11
  3215. #Qk^body^^^^Background "wallpaper".
  3216. #.in -11 }
  3217. #.in -2 }
  3218. #.sp 1
  3219. #.($346)Pull-Down Menus
  3220. #The general format of a line in a pull-down menu is:
  3221. #.sp 1
  3222. #.in +2 {
  3223. #.ba {
  3224. # ----------------------------------
  3225. #|<command_name> <hot_key> <value> \x10|
  3226. # ----------------------------------
  3227. #.sp 1
  3228. #Example:
  3229. #.sp 1
  3230. # -----------------------------
  3231. #|Repetition \uC\rount Alt-F8 500 \x10|
  3232. # -----------------------------
  3233. #.ea }
  3234. #.in -2 }
  3235. #.sp 1
  3236. #.in +5 {
  3237. #.ti -5
  3238. #\b<command_name>\r
  3239. #.sp 1
  3240. #is the name of the command.
  3241. #The highlighted letter in the <command_name> is called the "quick key".
  3242. #You can invoke the command by pressing the key corresponding to
  3243. #the quick key.
  3244. #Usually (but not always) the quick key is the first letter in
  3245. #the <command_name>.  For this reason, "quick key command selection"
  3246. #is often referred to as "first letter command selection".
  3247. #.sp 1
  3248. #Quick keys are local to each pull-down menu.
  3249. #The same quick key letter means different things (invokes different
  3250. #commands) in each pull-down menu.
  3251. #Quick keys are effective only when the pull-down menu is
  3252. #"pulled-down".
  3253. #.sp 1
  3254. #.in +4 {
  3255. #Another way to select, or execute, a command in a pull-down menu
  3256. #is to move the highlight bar to that command
  3257. #(using the \b\x19\r and \b\x18\r keys) and then press \bEnter\r.
  3258. #.in -4 }
  3259. #.sp 1
  3260. #.sp 1
  3261. #.ti -5
  3262. #\b<hot_key>\r
  3263. #.sp 1
  3264. #is the function key keystroke or keystroke combination
  3265. #which you can use to invoke the command.
  3266. #Hot key (function key) command selection is effective throughout
  3267. #the \b%rs1\r system, regardless of whether or not the pull-down
  3268. #menu containing the associated command is pulled-down.
  3269. #Not all commands have hot keys.
  3270. #The \l($75)Function^Key^Modify\m menu allows you to customize
  3271. #the hot key (function key) assignments to suit your needs.
  3272. #.sp 1
  3273. #.ti -5
  3274. #\b<value>\r
  3275. #.sp 1
  3276. #is the current value (setting) of the
  3277. #the attribute or feature controlled
  3278. #by the command.
  3279. #Not all commands have associated <value>s.
  3280. #.sp 1
  3281. #.ti -5
  3282. #\b\x10\r
  3283. #.sp 1
  3284. #is a flag indicating that, when the command is selected,
  3285. #more interaction is required with you to ultimately "execute"
  3286. #the command.
  3287. #This interaction can take the form of a dialog box or a pop-up
  3288. #menu of choices.
  3289. #A command which does not have the \x10 flag executes
  3290. #immediately when you select that command.
  3291. #.in -5 }
  3292. #.sp 1
  3293. #\bMiscellaneous\r
  3294. #.sp 1
  3295. #Some commands in a pull-down menu may be inactive.
  3296. #The \b%rs1\r host software "lowlights" inactive commands so that
  3297. #you know they are inaccessible.
  3298. #In addition, the host software lowlights
  3299. #the function key (hot key) label for that command.
  3300. #.sp 1
  3301. #Commands can be, or become, inactive because:
  3302. #.sp 1
  3303. #.in +4 {
  3304. #.in +4 {
  3305. #.ti -4
  3306. #1.^^The probe card (target chip) does not have the feature or
  3307. #attribute controlled by, or associated with, the command.
  3308. #For example, only the '517 and '537 have
  3309. #a hardware \l($126)Multiplication-Division-Unit\m.
  3310. #.sp 1
  3311. #.ti -4
  3312. #2.^^The current state of the system, or environment, is such that
  3313. #a particular command does not apply or does not "make sense".
  3314. #For example, if you have loaded an assembly language program
  3315. #into the \b%rs1\r emulator, the \l($96)Run\m commands associated
  3316. #with "single-stepping by source line number" will be inactive,
  3317. #because an assembly language program does not have source
  3318. #line numbers.
  3319. #.in -4 }
  3320. #.in -4 }
  3321. #.($347)End of Tour
  3322. #That concludes our brief tour through a few of the features
  3323. #of the flexible and powerful \b%rs1\r emulator system.
  3324. #.sp 1
  3325. #Press \bEsc\r to find out more
  3326. #about \xFA\xFA\xFA \b%rs1\r.
  3327. #.sp 1
  3328. #.($348)Demo Information
  3329. #You are now in the online, hyperlinked Help System of
  3330. #\b%rs1\r's host software.
  3331. #The remainder of this presentation can proceed at any pace
  3332. #you choose, in any sequence you choose.
  3333. #You are in control now.
  3334. #.sp 1
  3335. #Below are some Help Topics that explain much more about \b%rs1\r.
  3336. #We recommend that you peruse these topics in the sequence shown below,
  3337. #but the choice is yours to do whatever you want.
  3338. #.sp 1
  3339. #Press the \bTab\r key to highlight the topic you wish to explore
  3340. #further and then press \bEnter\r:
  3341. #.sp 1
  3342. #.in +2 {
  3343. #\l($349)Overview^of^iceMASTER\m^^^^\l($350)Description^of^Demo/Simulator\m^
  3344. #.sp 1
  3345. #\l($351)Probe^Card^Catalog\m^^^^^^^\l($352)Contact\m^
  3346. #.in -2 }
  3347. #.sp 1
  3348. #When you are finished digesting the information here,
  3349. #just press \bEsc\r to exit the Help System and you'll be
  3350. #on your way to experiencing a new standard in
  3351. #\uEMULATION PRODUCTIVITY\r.
  3352. #.sp 1
  3353. #After completely \l($121)Exit\ming this demo emulation session,
  3354. #you can reinvoke the host software Demo/Simulator simply by typing
  3355. #\bICEDEMO\r at the DOS command prompt.
  3356. #.($349)Overview of iceMASTER
  3357. #.sp 1
  3358. #Welcome to the %rs2 \b%rs1\r 8051 Family Overview.
  3359. #.sp 1
  3360. #%rs2's \b%rs1\r emulators
  3361. #are in-circuit emulators designed for use in
  3362. #developing and debugging circuits and embedded software
  3363. #based on the MCS-51 family of single-chip microcontrollers.
  3364. #.sp 1
  3365. #This is an overview of the functions and capabilities
  3366. #of the \b%rs1\r emulators which can expedite your
  3367. #development of hardware and software, and ease system integration.
  3368. #.sp 1
  3369. #Feel free to make copies of the demo diskettes and
  3370. #pass those copies on to other engineers who may be interested.
  3371. #.sp 1
  3372. #All %rs2 \b%rs1\r emulators consist of an emulator base unit,
  3373. #attached to a small probe card (pod) via an umbilical cable.
  3374. #The probe card, which contains the device being emulated,
  3375. #inserts into the socket for the device in your target
  3376. #development system.  Many probe cards are available,
  3377. #supporting a wide variety of MCS-51 CMOS, NMOS, ROM, EPROM
  3378. #or ROMless devices.  The emulator base unit connects to the
  3379. #host PC (personal computer) via a standard RS-232-C serial
  3380. #communications link operating at 115.2K baud.
  3381. #.sp 1
  3382. #The \b%rs1\r emulator is a
  3383. #high-performance, full-featured, economical,
  3384. #small profile/footprint emulator supporting
  3385. #full probe card interchangeability.
  3386. #.sp 2
  3387. #\bSPECIFICATIONS and OPTIONS\r
  3388. #.co {{
  3389. #.sp 1
  3390. #\bOperating Modes\r
  3391. #.sp 1
  3392. #.in +2 {
  3393. #.in +2 {
  3394. #.ti -2
  3395. #Single Chip Mode
  3396. #.ti -2
  3397. #Microprocessor Mode
  3398. #.ti -2
  3399. #Watchdog Timer Enabled/Disabled (\b%rs1 Model 400\r)
  3400. #.ti -2
  3401. #DMA Active
  3402. #.in -2 }
  3403. #.in -2 }
  3404. #.co }{
  3405. #.sp 1
  3406. #\bFile Formats\r
  3407. #.sp 1
  3408. #.in +2 {
  3409. #%rs2, Archimedes, Avocet, BSO, Enertec, Franklin, IAR Systems,
  3410. #Intel OMF, Kiel, MCC, Microtec Research, Tasking,
  3411. #Motorola S-Record, Intel HEX.
  3412. #.in -2 }
  3413. #.co }{
  3414. #.sp 1
  3415. #\bMacro\r
  3416. #.sp 1
  3417. #.in +2 {
  3418. #.in +2 {
  3419. #.ti -2
  3420. #Repetitive routines
  3421. #.ti -2
  3422. #User-created and callable
  3423. #.in -2 }
  3424. #.in -2 }
  3425. #.co }{
  3426. #.sp 1
  3427. #\bMemory Operations\r
  3428. #.sp 1
  3429. #.in +2 {
  3430. #.in +2 {
  3431. #.ti -2
  3432. #Program Memory:
  3433. #.in +2 {
  3434. #.in +2 {
  3435. #.ti -2
  3436. #Single-line Assembly
  3437. #.ti -2
  3438. #Disassemble
  3439. #.ti -2
  3440. #Disassemble to file
  3441. #.ti -2
  3442. #Examine/Modify
  3443. #.ti -2
  3444. #Mapping
  3445. #.in -2 }
  3446. #.in -2 }
  3447. #.ti -2
  3448. #Internal/External Data Memory:
  3449. #.in +2 {
  3450. #.in +2 {
  3451. #.ti -2
  3452. #Dump
  3453. #.ti -2
  3454. #Dump to file
  3455. #.ti -2
  3456. #Fill
  3457. #.ti -2
  3458. #Move
  3459. #.ti -2
  3460. #Change
  3461. #.ti -2
  3462. #Search
  3463. #.ti -2
  3464. #Compare
  3465. #.in -2 }
  3466. #.in -2 }
  3467. #.ti -2
  3468. #SFR/Bit Memory:
  3469. #.in +2 {
  3470. #.in +2 {
  3471. #.ti -2
  3472. #Examine/Modify
  3473. #.in -2 }
  3474. #.in -2 }
  3475. #.ti -2
  3476. #Program Variables:
  3477. #.in +2 {
  3478. #.in +2 {
  3479. #.ti -2
  3480. #Examine/Modify
  3481. #.in -2 }
  3482. #.in -2 }
  3483. #.in -2 }
  3484. #.in -2 }
  3485. #.co }{
  3486. #.sp 1
  3487. #\bMechanichal Specifictions\r
  3488. #.sp 1
  3489. #.in +2 {
  3490. #.in +2 {
  3491. #.ti -2
  3492. #Emulator Dimensions:
  3493. #.ba {
  3494. #1.0"   x   7.0"   x   5.5"
  3495. #2.5cm  x  17.8cm  x  14.0cm
  3496. #.ea }
  3497. #.ti -2
  3498. #Probe Card Cable Length:
  3499. #.ba {
  3500. #14.0"   35.6cm
  3501. #.ea }
  3502. #.ti -2
  3503. #Emulator Weight
  3504. #.ba {
  3505. #2.0lbs   0.9kg
  3506. #.ea }
  3507. #.in -2 }
  3508. #.in -2 }
  3509. #.co }{
  3510. #.sp 1
  3511. #\bElectrical Specifications\r
  3512. #.sp 1
  3513. #.in +2 {
  3514. #.in +2 {
  3515. #.ti -2
  3516. #Input Power (maximum):
  3517. #.ba {
  3518. #1.5A @ +5VDC \xF15%%
  3519. #.ea }
  3520. #.in -2 }
  3521. #.in -2 }
  3522. #.co }{
  3523. #.sp 1
  3524. #\bWarranty\r
  3525. #.sp 1
  3526. #.in +2 {
  3527. #One (1) year limited warranty, parts and labor, for registered users.
  3528. #.in -2 }
  3529. #.co }{
  3530. #.sp 1
  3531. #\bEmulation Memory\r
  3532. #.sp 1
  3533. #.in +2 {
  3534. #.ba {
  3535. #                  Standard  Optional
  3536. #8051 Family:
  3537. #  Program:        16K       64K
  3538. #  External Data:  16K       64K
  3539. #.ea }
  3540. #.in -2 }
  3541. #.co }{
  3542. #.sp 1
  3543. #\bMapping Resolution\r
  3544. #.sp 1
  3545. #.in +2 {
  3546. #.ba {
  3547. #Program:        16-byte blocks
  3548. #External Data:  16-byte blocks
  3549. #.ea }
  3550. #.in -2 }
  3551. #.co }{
  3552. #.sp 1
  3553. #\bOperating Characteristics\r
  3554. #.sp 1
  3555. #.in +2 {
  3556. #.in +2 {
  3557. #.ti -2
  3558. #Real-Time:
  3559. #.ba {
  3560. #8051:  DC to 20MHz
  3561. #.ea }
  3562. #.ti -2
  3563. #Electrically Transparent
  3564. #.ti -2
  3565. #Operationally Transparent
  3566. #.in -2 }
  3567. #.in -2 }
  3568. #.co }{
  3569. #.sp 1
  3570. #\bUser Interface\r
  3571. #.sp 1
  3572. #.in +2 {
  3573. #.in +2 {
  3574. #.ti -2
  3575. #Pull-down & Pop-up Menus
  3576. #.ti -2
  3577. #Main Screen Windows
  3578. #.in +2 {
  3579. #.in +2 {
  3580. #.ti -2
  3581. #Registers/SFRs/PSW bits
  3582. #.ti -2
  3583. #Bit Memory
  3584. #.ti -2
  3585. #Stack
  3586. #.ti -2
  3587. #Internal Data Memory
  3588. #.ti -2
  3589. #External Data Memory
  3590. #.ti -2
  3591. #Source Program
  3592. #.ti -2
  3593. #Watch
  3594. #.ti -2
  3595. #System Status
  3596. #.in -2 }
  3597. #.in -2 }
  3598. #.ti -2
  3599. #User Window Controls
  3600. #.in +2 {
  3601. #.in +2 {
  3602. #.ti -2
  3603. #Selectable (On/Off)
  3604. #.ti -2
  3605. #Movable
  3606. #.ti -2
  3607. #Resizable
  3608. #.ti -2
  3609. #Scrollable
  3610. #.ti -2
  3611. #Color selection
  3612. #.ti -2
  3613. #Highlighting
  3614. #.in -2 }
  3615. #.in -2 }
  3616. #.ti -2
  3617. #Function/Hot Key Access
  3618. #.in +2 {
  3619. #.in +2 {
  3620. #.ti -2
  3621. #User-assignable
  3622. #.in -2 }
  3623. #.in -2 }
  3624. #.in -2 }
  3625. #.in -2 }
  3626. #.co }{
  3627. #.sp 1
  3628. #\bEmulation Controls\r
  3629. #.sp 1
  3630. #.in +2 {
  3631. #.in +2 {
  3632. #.ti -2
  3633. #Reset from Emulator
  3634. #.ti -2
  3635. #Reset from Target
  3636. #.ti -2
  3637. #Go
  3638. #.ti -2
  3639. #Go From
  3640. #.ti -2
  3641. #Go Until
  3642. #.ti -2
  3643. #Slow Motion
  3644. #.ti -2
  3645. #Step
  3646. #.ti -2
  3647. #Step Line
  3648. #.ti -2
  3649. #Step Over
  3650. #.ti -2
  3651. #Step To
  3652. #.ti -2
  3653. #Repetition Counter
  3654. #.in -2 }
  3655. #.in -2 }
  3656. #.co }{
  3657. #.sp 1
  3658. #\bPerformance Analyzer\r (\b%rs1 Model 400\r)
  3659. #.sp 1
  3660. #.in +2 {
  3661. #.in +2 {
  3662. #.ti -2
  3663. #Real-time Program Profiling
  3664. #.ti -2
  3665. #5.4\xE6sec. sampling period
  3666. #.ti -2
  3667. #7-year duration
  3668. #.ti -2
  3669. #Display Options:
  3670. #.in +2 {
  3671. #.in +2 {
  3672. #.ti -2
  3673. #Bar Graph
  3674. #.ti -2
  3675. #Frequency Counts
  3676. #.in -2 }
  3677. #.in -2 }
  3678. #.ti -2
  3679. #Display Modes:
  3680. #.in +2 {
  3681. #.in +2 {
  3682. #.ti -2
  3683. #Raw
  3684. #.ti -2
  3685. #Symbolic
  3686. #.ti -2
  3687. #HLL Source Lines
  3688. #.ti -2
  3689. #Mixed
  3690. #.in -2 }
  3691. #.in -2 }
  3692. #.ti -2
  3693. #15 Bin Capacity
  3694. #.in +2 {
  3695. #.in +2 {
  3696. #.ti -2
  3697. #\uMultiple\r, \unon-contiguous\r ranges per Bin
  3698. #.in -2 }
  3699. #.in -2 }
  3700. #.ti -2
  3701. #User-controlled Bin Set Up:
  3702. #.in +2 {
  3703. #.in +2 {
  3704. #.ti -2
  3705. #By Address
  3706. #.ti -2
  3707. #By Label/Symbol
  3708. #.ti -2
  3709. #By Module
  3710. #.ti -2
  3711. #By Line Number
  3712. #.ti -2
  3713. #Automatic
  3714. #.in -2 }
  3715. #.in -2 }
  3716. #.in -2 }
  3717. #.in -2 }
  3718. #.co }{
  3719. #.sp 1
  3720. #\bBreak/Trace\r (\b%rs1 Model 400\r)
  3721. #.sp 1
  3722. #.in +2 {
  3723. #.in +2 {
  3724. #.ti -2
  3725. #128K Break Triggers
  3726. #.ti -2
  3727. #64K Trace-On Triggers
  3728. #.ti -2
  3729. #64K Trace-Off Triggers
  3730. #.ti -2
  3731. #Trigger Conditions:
  3732. #.in +2 {
  3733. #.in +2 {
  3734. #.ti -2
  3735. #PC address & range
  3736. #.ti -2
  3737. #Opcode Value
  3738. #.ti -2
  3739. #Opcode Class
  3740. #.ti -2
  3741. #Special Function Registers
  3742. #.ti -2
  3743. #Direct byte address & range
  3744. #.ti -2
  3745. #Direct bit address & range
  3746. #.ti -2
  3747. #Immediate operand value
  3748. #.ti -2
  3749. #Read/Write to bit address
  3750. #.ti -2
  3751. #Read/Write to SFR address
  3752. #.sp 0
  3753. #Logical AND/OR of any of the above
  3754. #.ti -2
  3755. #External Data address & range
  3756. #.ti -2
  3757. #Break Count overflow
  3758. #.ti -2
  3759. #External Input
  3760. #.in -2 }
  3761. #.in -2 }
  3762. #.ti -2
  3763. #Trace Triggers:
  3764. #.in +2 {
  3765. #.in +2 {
  3766. #.ti -2
  3767. #Start
  3768. #.ti -2
  3769. #Center
  3770. #.ti -2
  3771. #End
  3772. #.ti -2
  3773. #Variable
  3774. #.in -2 }
  3775. #.in -2 }
  3776. #.ti -2
  3777. #4K-Frame Trace Buffer
  3778. #.ti -2
  3779. #Trace Contents:
  3780. #.in +2 {
  3781. #.in +2 {
  3782. #.ti -2
  3783. #Address
  3784. #.ti -2
  3785. #Data
  3786. #.ti -2
  3787. #External Clips
  3788. #.ti -2
  3789. #DMA Activity
  3790. #.in -2 }
  3791. #.in -2 }
  3792. #.ti -2
  3793. #Trace Display Modes:
  3794. #.in +2 {
  3795. #.in +2 {
  3796. #.ti -2
  3797. #Raw Hex
  3798. #.ti -2
  3799. #Symbolic
  3800. #.ti -2
  3801. #HLL Source
  3802. #.ti -2
  3803. #Mixed
  3804. #.ti -2
  3805. #Binary (Clips)
  3806. #.ti -2
  3807. #Digital Waveform (Clips)
  3808. #.in -2 }
  3809. #.in -2 }
  3810. #.ti -2
  3811. #Trace Buffer Operations:
  3812. #.in +2 {
  3813. #.in +2 {
  3814. #.ti -2
  3815. #Search Trace Buffer
  3816. #.ti -2
  3817. #Write Trace Buffer to a File
  3818. #.in -2 }
  3819. #.in -2 }
  3820. #.in -2 }
  3821. #.in -2 }
  3822. #.co }{
  3823. #.sp 1
  3824. #\bDevice-Unique Support\r
  3825. #.sp 1
  3826. #.in +2 {
  3827. #.in +2 {
  3828. #.ti -2
  3829. #A-to-D Converter
  3830. #.ti -2
  3831. #FIFO
  3832. #.ti -2
  3833. #Multiply-Divide Unit (MDU)
  3834. #.ti -2
  3835. #Multiple DPTRs
  3836. #.ti -2
  3837. #PROM Programmer
  3838. #.in -2 }
  3839. #.in -2 }
  3840. #.co }{
  3841. #.sp 1
  3842. #\bSource/Symbol Support\r
  3843. #.sp 1
  3844. #.in +2 {
  3845. #.in +2 {
  3846. #.ti -2
  3847. #C and PL/M
  3848. #.ti -2
  3849. #Source-level debug
  3850. #.ti -2
  3851. #HLL Structure/Content Display:
  3852. #.in +2 {
  3853. #.in +2 {
  3854. #.ti -2
  3855. #Modules
  3856. #.ti -2
  3857. #Scopes
  3858. #.ti -2
  3859. #Line Numbers
  3860. #.ti -2
  3861. #Program Variables
  3862. #.in -2 }
  3863. #.in -2 }
  3864. #.in -2 }
  3865. #.in -2 }
  3866. #.co }{
  3867. #.sp 1
  3868. #\bHelp\r
  3869. #.sp 1
  3870. #.in +2 {
  3871. #.in +2 {
  3872. #.ti -2
  3873. #On-line
  3874. #.ti -2
  3875. #Context-sensitive
  3876. #.ti -2
  3877. #Hyperlinked
  3878. #.in -2 }
  3879. #.in -2 }
  3880. #.co }{
  3881. #.sp 1
  3882. #\bHost Computer\r
  3883. #.sp 1
  3884. #.in +2 {
  3885. #.in +2 {
  3886. #.ti -2
  3887. #IBM PC or a fully-compatible PC clone
  3888. #.ti -2
  3889. #1 5\xAC" floppy diskette drive
  3890. #.ti -2
  3891. #1 hard disk drive
  3892. #.ti -2
  3893. #640K bytes of memory
  3894. #.ti -2
  3895. #RS-232-C serial communication interface board
  3896. #.ti -2
  3897. #RS-232 cable with a male connector at the emulator end
  3898. #.ti -2
  3899. #PC-DOS or MS-DOS Version 2.0 or later
  3900. #.in -2 }
  3901. #.in -2 }
  3902. #.co }}
  3903. #.($350)Description of Demo/Simulator
  3904. #The ICEDEMO.EXE program (the program you are now using)
  3905. #is a nearly FULLY-FUNCTIONAL demo version of the host PC
  3906. #software package with which you would interact to control a "real"
  3907. #%rs2 \b%rs1\r emulator.  Rather than "talking to" an emulator
  3908. #base unit, however, this demo version of the host software contains
  3909. #within it software modules which mimic (simulate) the behavior
  3910. #of a true \b%rs1\r hardware emulator base unit and
  3911. #probe card.  Also bundled in is a full simulator for the 8052 CPU
  3912. #architecture.
  3913. #.sp 1
  3914. #This demo version of the Host software has the following properties:
  3915. #.sp 1
  3916. #.in +4 {
  3917. #.in +4 {
  3918. #.ti -4
  3919. #1)^^The emulator supported is an \b%rs1 Model 400\r emulator
  3920. #with 16K of Code memory and 16K of External Data memory.
  3921. #The probe card supported is that for an 8052.
  3922. #.sp 1
  3923. #.ti -4
  3924. #2)^^Since ICEDEMO.EXE contains within it modules which mimic
  3925. #the behavior of the emulator hardware, probe card and 8052 CPU,
  3926. #ICEDEMO.EXE consumes quite a bit more memory in the PC than the
  3927. #non-demo version of the Host software.  This constrains the size
  3928. #of programs (e.g., total number of symbols) that can be loaded
  3929. #into the demo emulator.
  3930. #.sp 1
  3931. #.ti -4
  3932. #3)^^External events and interrupts (e.g., timer interrupts) are not
  3933. #simulated/supported.  Access to a port is treated as an access to the
  3934. #port register, not the port pins.  Timers act as simple registers
  3935. #(i.e., they do not count automatically).  Basically, the "chip"
  3936. #simulator built into the demo emulator system simulates the 8052 CPU
  3937. #\uarchitecture\r, but does not simulate any \uperipheral functions\r
  3938. #of the 8052 chip.
  3939. #.sp 1
  3940. #.ti -4
  3941. #4)^^When this demo "emulator" is placed into emulation (executing code
  3942. #in the 8052 processor), the execution time reported will be that for a
  3943. #12MHz 8052 executing the same code.  However, since the execution of
  3944. #each instruction is actually being simulated in software, the elapsed
  3945. #wall clock time will be significantly greater than the
  3946. #execution time displayed in the Status Window.
  3947. #.sp 1
  3948. #.ti -4
  3949. #5)^^The Performance Analyzer's sampling rate is much lower
  3950. #than that in an actual \b%rs1\r emulator hardware base unit.  Again,
  3951. #this is because the execution of each 8052 instruction is being
  3952. #simulated in software.
  3953. #.sp 1
  3954. #.ti -4
  3955. #6)^^Requests to map memory (Code or External Data) to your target
  3956. #system effectively are ignored.  However, the demo emulator will
  3957. #report that the requested block of memory has been mapped (assigned)
  3958. #successfully to your target system.
  3959. #.sp 1
  3960. #.ti -4
  3961. #7)^^The 8052 demo emulator system may be configured to operate only in
  3962. #"Mode 1" (ROMless operation).  The system will issue a diagnostic
  3963. #message if you attempt to configure the emulator into any
  3964. #other mode.
  3965. #.sp 1
  3966. #.ti -4
  3967. #8)^^When beginning execution from the RESET condition,
  3968. #you should select the \l($97)Reset^(emulator)\m command.
  3969. #.sp 1
  3970. #.ti -4
  3971. #9)^^The \bProbe Bit\r values captured in the Trace Buffer are
  3972. #randomly-generated values.
  3973. #.in -4 }
  3974. #.in -4 }
  3975. #.sp 1
  3976. #We have included three simple demo programs which may be loaded into
  3977. #the demo emulator system.  All programs are based on a simple scheme
  3978. #of outputting a pulse train on Port 1, Pin 0 (P1.0):
  3979. #.sp 1
  3980. #.in +4 {
  3981. #.in +13 {
  3982. #.ti -13
  3983. #DEMO.DBG^^^^^%rs2 ASM51 8051 Macro Cross Assembler version
  3984. #.ti -13
  3985. #A_DEMO.AOM^^^Archimedes C Compiler version
  3986. #.ti -13
  3987. #F_DEMO.AOM^^^Franklin C Compiler version
  3988. #.in -13 }
  3989. #.in -4 }
  3990. #.sp 1
  3991. #A detailed description of each file in this directory follows:
  3992. #.sp 1
  3993. #\bSystem/Utility Files\r
  3994. #.sp 1
  3995. #.in +4 {
  3996. #.in +13 {
  3997. #.ti -13
  3998. #ICEDEMO.EXE^^The demo version of the emulator host PC software.
  3999. #.sp 1
  4000. #.ti -13
  4001. #$MODEL^^^^^^^Configuration file defining the probe card for the demo
  4002. #emulator as an 8052.  The emulator host software
  4003. #(ICEDEMO.EXE) reads this $MODEL file during its one-time
  4004. #initialization sequence.
  4005. #The $MODEL file also contains the Help information.
  4006. #.in -13 }
  4007. #.in -4 }
  4008. #.sp 1
  4009. #\bDemonstration Programs\r
  4010. #.sp 1
  4011. #.in +4 {
  4012. #.in +15 {
  4013. #.ti -15
  4014. #DEMO.ASM^^^^^^^ASM51 demo program (assembly language source)
  4015. #.ti -15
  4016. #DEMO.DBG^^^^^^^ASM51 demo program (loadable, absolute object module format)
  4017. #.ti -15
  4018. #DEMO.HEX^^^^^^^ASM51 demo program (loadable, '.HEX' format (no debug info))
  4019. #.ti -15
  4020. #DEMO.LST^^^^^^^Assembler-generated listing file for DEMO
  4021. #.in -15 }
  4022. #.in -4 }
  4023. #.sp 1
  4024. #\bA_DEMO.AOM:  Archimedes C Demo Program (Generic)\r
  4025. #.sp 1
  4026. #.in +4 {
  4027. #.in +14 {
  4028. #.ti -14
  4029. #A_CSTART.LST^^C Runtime Library startup routine (assembler output listing)
  4030. #.ti -14
  4031. #A_CSTART.S03^^C Runtime Library startup routine (assembly language source)
  4032. #.ti -14
  4033. #A_DEMO.AOM^^^^Loadable, absolute object module (with debug information)
  4034. #.ti -14
  4035. #A_DEMO.MAP^^^^Linker-generated map of A_DEMO.AOM
  4036. #.ti -14
  4037. #A_HLMAIN.C^^^^Main program (function 'main()';  C source)
  4038. #.ti -14
  4039. #A_HLMAIN.LST^^Compiler-generated listing file for A_HLMAIN.C
  4040. #.ti -14
  4041. #A_INNER.C^^^^^Function 'innerloop()' (C source)
  4042. #.ti -14
  4043. #A_INNER.LST^^^Compiler-generated listing file for A_INNER.C
  4044. #.ti -14
  4045. #A_MAKE.BAT^^^^Batch file to generate A_DEMO.AOM from scratch
  4046. #.ti -14
  4047. #A_MAKE.LCL^^^^Librarian control file for generating A_DEMO.AOM
  4048. #.ti -14
  4049. #A_MAKE.XCL^^^^Linker    control file for generating A_DEMO.AOM
  4050. #.ti -14
  4051. #A_WASTE.C^^^^^Function 'wastetime()' (C source)
  4052. #.ti -14
  4053. #A_WASTE.LST^^^Compiler-generated listing file for A_WASTE.C
  4054. #.in -14 }
  4055. #.in -4 }
  4056. #.sp 1
  4057. #\bF_DEMO.AOM:  Franklin Software 8051 C Demo Program (Generic)\r
  4058. #.sp 1
  4059. #.in +4 {
  4060. #.in +14 {
  4061. #.ti -14
  4062. #F_DEMO.AOM^^^^Loadable, absolute object module (with debug information)
  4063. #.ti -14
  4064. #F_DEMO.M51^^^^Linker-generated load map for F_DEMO.AOM
  4065. #.ti -14
  4066. #F_HLMAIN.C^^^^Main program (function 'main()';  C source)
  4067. #.ti -14
  4068. #F_HLMAIN.LST^^Compiler-generated listing file for F_HLMAIN.C
  4069. #.ti -14
  4070. #F_INNER.C^^^^^Function 'innerloop()' (C source)
  4071. #.ti -14
  4072. #F_INNER.LST^^^Compiler-generated listing file for F_INNER.C
  4073. #.ti -14
  4074. #F_MAKE.BAT^^^^Batch file to generate F_DEMO.AOM from scratch
  4075. #.ti -14
  4076. #F_VECT.A51^^^^ASM-51 source module (reserves space for interrupt vectors)
  4077. #.ti -14
  4078. #F_VECT.LST^^^^Assembler-generated listing file for F_VECT.A51
  4079. #.ti -14
  4080. #F_WASTE.C^^^^^Function 'wastetime()' (C source)
  4081. #.ti -14
  4082. #F_WASTE.LST^^^Compiler-generated listing file for F_WASTE.C
  4083. #.in -14 }
  4084. #.in -4 }
  4085. #.sp 1
  4086. #At the DOS command prompt, to invoke the \b%rs1\r 8052 demo emulator
  4087. #at some later time and
  4088. #automatically load one of the supplied demo programs,
  4089. #you need only type:
  4090. #.sp 1
  4091. #.in +4 {
  4092. #.in +19 {
  4093. #.ti -19
  4094. #ICEDEMO^DEMO.DBG^^^to load the assembly language demo program
  4095. #.ti -19
  4096. #ICEDEMO^A_DEMO.AOM^to load the Archimedes C demo program
  4097. #.ti -19
  4098. #ICEDEMO^F_DEMO.AOM^to load the Franklin C demo program
  4099. #.ti -19
  4100. #ICEDEMO^prog_file^^to load your own program(s)
  4101. #.in -19 }
  4102. #.in -4 }
  4103. #.sp 1
  4104. #Or, at the DOS command prompt, just type:
  4105. #.sp 1
  4106. #.in +4 {
  4107. #ICEDEMO
  4108. #.in -4 }
  4109. #.sp 1
  4110. #and then use the \l($86)File|Load\m command to load a program
  4111. #file into the demo emulator.
  4112. #.sp 1
  4113. #Feel free to run your own programs using the demo emulator system,
  4114. #keeping in mind the constraints mentioned at the beginning of this
  4115. #Help Topic
  4116. #(e.g., 16K Code memory, no external events).
  4117. #.($351)MetaLink Emulator and Probe Card Catalog
  4118. #Effective:  1991 January 1
  4119. #.sp 1
  4120. #All \b%rs1\r emulators support full probe card interchangeability.
  4121. #To emulate several different devices, you need purchase only a single
  4122. #emulator base unit and then one probe card for each unique device
  4123. #to be emulated.
  4124. #.sp 1
  4125. #Both the \b%rs1 Model 200\r and the \b%rs1 Model 400\r emulators
  4126. #come with 16K of Code memory
  4127. #and 16K of External Data memory.  You can purchase a memory upgrade
  4128. #option to expand both of these memory areas to a full 64K each.
  4129. #Power supplies to operate
  4130. #\b%rs1\r emulators can be purchased separately from %rs2.
  4131. #.sp 1
  4132. #The \b%rs1 Model 400\r emulator has the following additional
  4133. #features/capabilities:
  4134. #.sp 1
  4135. #.in +4 {
  4136. #.in +4 {
  4137. #.ti -4
  4138. #1.^^4K-Frame Trace Buffer
  4139. #.ti -4
  4140. #2.^^Performance Analyzers
  4141. #.in +4 {
  4142. #.ti -4
  4143. #a.^^High Resolution
  4144. #.ti -4
  4145. #b.^^High Bin Count
  4146. #.in -4 }
  4147. #.ti -4
  4148. #3.^^Full Watchdog Timer (WDT) Support in all emulation modes
  4149. #.in -4 }
  4150. #.in -4 }
  4151. #.sp 1
  4152. #\bProbe Cards\r
  4153. #.sp 1
  4154. #All %rs2 probe cards include a Break-Input signal clip,
  4155. #a Trigger-Output signal clip and seven user-placeable
  4156. #Trace-Capture-Input signal clips.  In addition, there
  4157. #is a user-selectable jumper for XTAL source.
  4158. #Most probe cards have other
  4159. #user-selectable jumpers to control/configure the
  4160. #unique capabilities of each particular device.
  4161. #Some probe cards also contain a user-selectable jumper for Vcc source.
  4162. #\b%rs1\r \ufully\r supports:
  4163. #.sp 1
  4164. #.in +4 {
  4165. #.in +3 {
  4166. #.ti -3
  4167. #\x07^^All I/O ports, with no restrictions.
  4168. #.sp 1
  4169. #.ti -3
  4170. #\x07^^The CMOS Idle and Power Down modes of operation,
  4171. #in those devices having such capabilities.
  4172. #.sp 1
  4173. #.ti -3
  4174. #\x07^^The Watchdog Timer (WDT),
  4175. #in those devices having such a capability.
  4176. #(\b%rs1 Model 400\r only)
  4177. #.in -3 }
  4178. #.in -4 }
  4179. #.sp 1
  4180. #Following is a list of all Probe Cards which %rs2 currently offers.
  4181. #Since %rs2 is constantly adding to its list of supported devices,
  4182. #please contact %rs2 for information on any device not listed below.
  4183. #.sp 1
  4184. #If support for a particular device is available at different maximum
  4185. #frequencies (MHz), the description of the Probe Card appears only
  4186. #once, with the speed variations noted in the Probe Card names above
  4187. #the description.
  4188. #Example:^^\b8031-12\r for a 12MHz 8031 Probe Card,
  4189. #\b8031\r for a 16MHz 8031 Probe Card and
  4190. #\b8031-20\r for a 20MHz 8031 Probe Card.
  4191. #.sp 1
  4192. #\b8031-12 Probe Card\r
  4193. #.sp 0
  4194. #\b8031^^^^Probe Card\r
  4195. #.sp 0
  4196. #\b8031-20 Probe Card\r
  4197. #.sp 1
  4198. #.in +2 {
  4199. #The 8031 Probe Card supports device operation from 0.5 to 20MHz and has a
  4200. #40-lead DIP package interface.  This probe card supports 8031 and 80C31
  4201. #devices from any IC manufacturer, regardless of process variation.
  4202. #.in -2 }
  4203. #.sp 1
  4204. #\b8032-12 Probe Card\r
  4205. #.sp 0
  4206. #\b8032^^^^Probe Card\r
  4207. #.sp 0
  4208. #\b8032-20 Probe Card\r
  4209. #.sp 1
  4210. #.in +2 {
  4211. #The 8032 Probe Card supports device operation from 0.5 to 20MHz and has a
  4212. #40-lead DIP package interface.  This probe card supports 8031, 80C31, 8032,
  4213. #80C32 and 80C32T2 devices from any IC manufacturer, regardless of process
  4214. #variation.
  4215. #.in -2 }
  4216. #.sp 1
  4217. #\b8052-12 Probe Card\r
  4218. #.sp 0
  4219. #\b8052^^^^Probe Card\r
  4220. #.sp 1
  4221. #.in +2 {
  4222. #The 8052-12 Probe Card supports device operation from 0.5 to 16MHz and has a
  4223. #40-lead DIP package interface.  This probe card supports 8031, 80C31, 8032,
  4224. #80C32, 80C32T2, 80C154, 8051, 8751, 80C51, 87C51, 8052, 8752, 80C52, 80C52T2,
  4225. #87C52, 8053, 8753, 85C154 and 83C154 devices from any IC manufacturer,
  4226. #regardless of process variation.
  4227. #.in -2 }
  4228. #.sp 1
  4229. #\b80C154-12 Probe Card\r
  4230. #.sp 0
  4231. #\b80C154^^^^Probe Card\r
  4232. #.sp 1
  4233. #.in +2 {
  4234. #The 80C154 Probe Card supports device operation from DC to 16MHz and has a
  4235. #40-lead DIP package interface.  This probe card supports 8031, 80C31, 8032,
  4236. #80C32, 80C154 and 80C32T2 devices from any IC manufacturer, regardless of
  4237. #process variation.
  4238. #.in -2 }
  4239. #.sp 1
  4240. #\b80C51FA-12 Probe Card\r
  4241. #.sp 0
  4242. #\b80C51FA^^^^Probe Card\r
  4243. #.sp 1
  4244. #.in +2 {
  4245. #The 80C51FA Probe Card supports device operation from 0.5 to 16MHz and has a
  4246. #40-lead DIP package interface.  This probe card supports 8031, 80C31, 8032,
  4247. #80C32, 80C51FA (80C252) and 80C32T2 devices from any IC manufacturer,
  4248. #regardless of process variation.
  4249. #.in -2 }
  4250. #.sp 1
  4251. #\b80C652-12 Probe Card\r
  4252. #.sp 0
  4253. #\b80C652^^^^Probe Card\r
  4254. #.sp 1
  4255. #.in +2 {
  4256. #The 80C652 Probe Card supports device operation from 1.2 to 16MHz and has a
  4257. #40-lead DIP package interface.  This probe card supports 8031, 80C31, 80C652
  4258. #and 80C32T2 devices from any IC manufacturer, regardless of process
  4259. #variation.
  4260. #.in -2 }
  4261. #.sp 1
  4262. #\b83C652-12 Probe Card\r
  4263. #.sp 0
  4264. #\b83C652^^^^Probe Card\r
  4265. #.sp 1
  4266. #.in +2 {
  4267. #The 83C652 Probe Card supports device operation from 1.2 to 16MHz and has a
  4268. #40-lead DIP package interface.  This probe card supports 80C652, 87C652 and 83C652
  4269. #devices from any IC manufacturer, regardless of process
  4270. #variation.
  4271. #.in -2 }
  4272. #.sp 1
  4273. #\b83C654-12 Probe Card\r
  4274. #.sp 0
  4275. #\b83C654^^^^Probe Card\r
  4276. #.sp 1
  4277. #.in +2 {
  4278. #The 83C652 Probe Card supports device operation from 1.2 to 16MHz and has a
  4279. #40-lead DIP package interface.  This probe card supports 80C652, 87C654 and 83C654
  4280. #devices from any IC manufacturer, regardless of process
  4281. #variation.
  4282. #.in -2 }
  4283. #.sp 1
  4284. #\b8344 Probe Card\r
  4285. #.sp 1
  4286. #.in +2 {
  4287. #The 8344 Probe Card supports device operation from 3.5 to 12MHz and has a
  4288. #40-lead DIP package interface.  This probe card supports the 8344 device,
  4289. #regardless of process variation.
  4290. #.in -2 }
  4291. #.sp 1
  4292. #\b83C053 Probe Card\r
  4293. #.sp 1
  4294. #.in +2 {
  4295. #The 83C053 Probe Card supports device operation from 6 to 10MHz and has a
  4296. #42-lead Shrink DIP package interface.  This probe card supports 83C053,
  4297. #83C054 and 87C054 devices, regardless of process variation.
  4298. #.in -2 }
  4299. #.sp 1
  4300. #\b83C152A Probe Card\r
  4301. #.sp 1
  4302. #.in +2 {
  4303. #The 83C152A Probe Card supports device operation from 3.5 to 16.5MHz and
  4304. #has a 68-lead PLCC package interface.  This probe card supports
  4305. #80C152JA/JC and 83C152JA/JC devices, regardless of process variation.
  4306. #80C152JB/JD devices can be supported with some limitations.
  4307. #Converter #8 is available to convert the probe card interface to a 40-lead
  4308. #DIP footprint for operation as an 8031 or 8051.
  4309. #Converter #9 is available to convert the probe card interface to a 48-lead
  4310. #DIP footprint.
  4311. #.in -2 }
  4312. #.sp 1
  4313. #\b80C321-12 Probe Card\r
  4314. #.sp 0
  4315. #\b80C321^^^^Probe Card\r
  4316. #.sp 1
  4317. #.in +2 {
  4318. #The 80C321 Probe Card supports device operation from 3.5 to 16MHz and has a
  4319. #40-lead DIP package interface.  This probe card supports 8031, 80C31, 80C321
  4320. #and 80C32T2 devices from any IC manufacturer, regardless of process variation.
  4321. #.in -2 }
  4322. #.sp 1
  4323. #\b80C451-12 Probe Card\r
  4324. #.sp 0
  4325. #\b80C451^^^^Probe Card\r
  4326. #.sp 1
  4327. #.in +2 {
  4328. #The 80C451 Probe Card supports device operation from 1.2 to 16MHz and has a
  4329. #68-lead PLCC package interface.  This probe card supports the 80C451 device,
  4330. #regardless of process variation.  Converter #5 is available to convert the
  4331. #probe card to a 64-lead DIP footprint.
  4332. #.in -2 }
  4333. #.sp 1
  4334. #\b83C451 Probe Card\r
  4335. #.sp 1
  4336. #.in +2 {
  4337. #The 83C451 Probe Card supports device operation from 1.2 to 12MHz and has a
  4338. #68-lead PLCC package interface.  This probe card supports the 80C451, 83C451
  4339. #and 87C451 devices, regardless of process variation.  Converter #5 is
  4340. #available to convert the probe card to a 64-lead DIP footprint.
  4341. #.in -2 }
  4342. #.sp 1
  4343. #\b80C515 Probe Card\r
  4344. #.sp 1
  4345. #.in +2 {
  4346. #The 80C515 Probe Card supports device operation from 0.5 to 12MHz and has a
  4347. #68-lead PLCC package interface.  This probe card supports 80C535, 80C515,
  4348. #80515, 80535, 80C537 and 80C517 devices, regardless of process variation.
  4349. #The 80C515 Probe Card comes standard with Converter #10 for support of the
  4350. #80515, 80535, 80C515 or 80C535.
  4351. #.in -2 }
  4352. #.sp 1
  4353. #\b80C517 Probe Card\r
  4354. #.sp 1
  4355. #.in +2 {
  4356. #The 80C517 Probe Card supports device operation from 0.5 to 12MHz and has an
  4357. #84-lead PLCC package interface.  This probe card supports 80C517 and 80C537
  4358. #devices, regardless of process variation.  Converter #10 is available to
  4359. #convert the probe card interface to a 68-lead PLCC footprint for operation
  4360. #as an 80C515, 80C535, 80515 or 80535.
  4361. #.in -2 }
  4362. #.sp 1
  4363. #\b80C521 Probe Card\r
  4364. #.sp 1
  4365. #.in +2 {
  4366. #The 80C521 Probe Card supports device operation from 3.5 to 16MHz and has a
  4367. #40-lead DIP package interface.  This probe card supports 8031, 80C31,
  4368. #80C32T2, 80C321, 8051, 8751, 80C51, 87C51, 80C52T2, 8053, 8753, 80C521,
  4369. #87C521, 80C541 and 87C541 devices from any IC manufacturer, regardless of
  4370. #process variation.
  4371. #.in -2 }
  4372. #.sp 1
  4373. #\b80532 Probe Card\r
  4374. #.sp 1
  4375. #.in +2 {
  4376. #The 80532 Probe Card supports device operation from 1.2 to 12MHz and has a
  4377. #68-lead PLCC package interface.  This probe card supports the 80532 device,
  4378. #regardless of process variation.
  4379. #.in -2 }
  4380. #.sp 1
  4381. #\b80C535 Probe Card\r
  4382. #.sp 1
  4383. #.in +2 {
  4384. #The 80C535 Probe Card supports device operation from 0.5 to 12MHz and has a
  4385. #68-lead PLCC package interface.  This probe card supports the 80C535 and
  4386. #80535 devices, regardless of process variation.  Converter #4 is available to
  4387. #convert the probe card interface to a 40-lead DIP footprint for operation as
  4388. #an 8031, 80C31, 8032, 80C32T2 or 80C32.
  4389. #.in -2 }
  4390. #.sp 1
  4391. #\b80C537 Probe Card\r
  4392. #.sp 1
  4393. #.in +2 {
  4394. #The 80C537 Probe Card supports device operation from 0.5 to 12MHz and has an
  4395. #84-lead PLCC package interface.  This probe card supports the 80C537 device,
  4396. #regardless of process variation.  Converter #10 is available to convert the
  4397. #probe card interface to a 68-lead PLCC footprint for operation as an 80C535
  4398. #or 80535.
  4399. #.in -2 }
  4400. #.sp 1
  4401. #\b80C552-12 Probe Card\r
  4402. #.sp 0
  4403. #\b80C552^^^^Probe Card\r
  4404. #.sp 1
  4405. #.in +2 {
  4406. #The 80C552 Probe Card supports device operation from 1.2 to 16MHz and has a
  4407. #68-lead PLCC package interface.  This probe card supports the 80C552 device,
  4408. #regardless of process variation.  Converter #7 is available to convert the
  4409. #probe card interface to a 40-lead DIP footprint for operation as an 8031,
  4410. #8032, 80C31, 80C32, 80C32T2 or 80C652.
  4411. #.in -2 }
  4412. #.sp 1
  4413. #\b83C552-12 Probe Card\r
  4414. #.sp 0
  4415. #\b83C552^^^^Probe Card\r
  4416. #.sp 1
  4417. #.in +2 {
  4418. #The 83C552 Probe Card supports device operation from 1.2 to 16MHz and has a
  4419. #68-lead PLCC package interface.  This probe card supports the 80C552,
  4420. #83C552, and 87C552 devices, regardless of process variation.  Converter #7
  4421. #is available to convert the probe card interface to a 40-lead DIP footprint
  4422. #for operation as an 8031, 8032, 80C31, 80C32, 80C32T2, 8x51, 8xC51, 8x52,
  4423. #8xC52, 80C52T2, 8xC652 or 8xC654.
  4424. #.in -2 }
  4425. #.sp 1
  4426. #\b83C751 Probe Card\r
  4427. #.sp 1
  4428. #.in +2 {
  4429. #The 83C751 Probe Card supports device operation from 0.5 to 12MHz and has a
  4430. #24-lead Skinny DIP package interface.  This probe card supports 83C752,
  4431. #87C752, 87C751 and 83C751 devices, regardless of process variation.
  4432. #The 83751 Probe Card comes standard with Converter #11 for support of the
  4433. #8xC751 devices by an 8xC752.
  4434. #.in -2 }
  4435. #.sp 1
  4436. #\b83C751-16 Probe Card\r
  4437. #.sp 1
  4438. #.in +2 {
  4439. #The 83C751-16 Probe Card supports device operation from 0.5 to 16MHz and has
  4440. #a 24-lead Skinny DIP package interface.  This probe card supports 87C751 and
  4441. #83C751 devices, regardless of process variation.
  4442. #.in -2 }
  4443. #.sp 1
  4444. #\b83C752 Probe Card\r
  4445. #.sp 1
  4446. #.in +2 {
  4447. #The 83C752 Probe Card supports device operation from 0.5 to 12MHz and has a
  4448. #28-lead DIP package interface.  This probe card supports 83C752 and 87C752
  4449. #devices, regardless of process variation.
  4450. #.in -2 }
  4451. #.sp 1
  4452. #\b752/1PGM Probe Card\r
  4453. #.sp 1
  4454. #.in +2 {
  4455. #The 87C752 and 87C751 Programmer Probe Card supports device programming
  4456. #operation for both the 28-lead DIP and the 24-lead Skinny DIP package
  4457. #interface.  This programmer probe card supports programming of 87C752 and
  4458. #87C751 devices, regardless of process variation.  All programming functions
  4459. # are fully supported with no restrictions.
  4460. #.in -2 }
  4461. #.sp 1
  4462. #\b80C851 Probe Card\r
  4463. #.sp 1
  4464. #.in +2 {
  4465. #The 80C851 Probe Card supports device operation from 1.2 to 12MHz and has a
  4466. #40-lead DIP package interface.  This probe card supports 8031, 80C31, and
  4467. #80C851 devices from any IC manufacturer, regardless of process variation.
  4468. #.in -2 }
  4469. #.sp 1
  4470. #.($352)Contact
  4471. #Thank you for taking the time to view our demo.
  4472. #Experiment with this demo version of \b%rs1\r and
  4473. #give us a call if you have any questions:
  4474. #.sp 2
  4475. #.in +10 {
  4476. #.ba {
  4477. #                (800) METAICE
  4478. #                (800) 638-2423
  4479. #.sp 1
  4480. #              MetaLink Corporation
  4481. #.sp 1
  4482. #325 E. Elliot Rd.            P.O. Box 1329
  4483. #Chandler AZ 85225            Chandler AZ 85244-1329
  4484. #.sp 1
  4485. #              Phone:  (602) 926-0797
  4486. #              Fax:    (602) 926-1198
  4487. #              TELEX:  499 8050 MTLNK
  4488. #.ea }
  4489. #.in +10 }
  4490. #.($353)Move Box
  4491. #When you press \bCtrl V\r, a frame appears around a box or menu
  4492. #to allow you to mo\bv\re that box or menu.
  4493. #You can use the arrow keys
  4494. #(\b\x18\r, \b\x19\r, \b\x1B\r and \b\x1A\r)
  4495. #to move the frame to the new position for the box or menu.
  4496. #The bottom border of the frame shows you which of these four
  4497. #keys are meaningful at any particular time;  this depends on the
  4498. #current position of the frame and whether or not movement in a
  4499. #given direction is possible.
  4500. #After you have positioned the frame to the new location for the
  4501. #box or menu,
  4502. #press \bEnter\r to accept the new position
  4503. #or \bEsc\r to cancel the move request
  4504. #(reverting the position of the box or menu to its previous location).
  4505. #.($354)Resize Box
  4506. #When you press \bCtrl R\r, a frame appears around a box or menu
  4507. #to allow you to \br\resize that box or menu.
  4508. #You can use the arrow keys
  4509. #(\b\x18\r, \b\x19\r, \b\x1B\r and \b\x1A\r)
  4510. #to move the lower-right corner of the frame, thus changing the frame's
  4511. #size.
  4512. #The bottom border of the frame shows you which of these four
  4513. #keys are meaningful at any particular time;  this depends on the
  4514. #current position of the frame and whether or not movement in a
  4515. #given direction is possible.
  4516. #After you have adjusted the frame to the new size for the
  4517. #box or menu,
  4518. #press \bEnter\r to accept the new size
  4519. #or \bEsc\r to cancel the resize request
  4520. #(reverting the size of the box or menu to its previous state).
  4521. #.sp 1
  4522. #\bCtrl R\r acts as a 3-way toggle when you apply it to a
  4523. #pull-down menu.
  4524. #.($365)Enter Symbol/Module/Procedure Prompts
  4525. #The \bEnter^Symbol/Module/Procedure\r prompts are used
  4526. #for a special type of symbolic search.
  4527. #If the entered string is found to be one of the
  4528. #symbol, module, or procedure names (depending on the current command)
  4529. #the display is scrolled so that name is displayed.
  4530. #In addition, a full name does not
  4531. #have to be entered for the search to work.  If only a partial
  4532. #name is entered the first name found that starts with the
  4533. #entered string will be selected.
  4534. #.sp 1
  4535. #Normal rules for \l($244)Keyboard^Input\m still apply.
  4536. #.($366)Screen Content
  4537. #Two screen modes are available for this command.  The \bnarrow\r
  4538. #screen contains just the \bmemory Space\r, \baddress\r, and \bname\r
  4539. #of each displayed symbol.  The \bwide\r screen contains (in addition
  4540. #to memory space, address, and name)
  4541. #\bvalue\r, \bdata type\r and \bscope\r information for
  4542. #each symbol.
  4543. #.sp 1
  4544. #If the symbol name is preceded by a plus sign ('+') that symbol was
  4545. #read from the $MODEL file during \b%rs1\r initialization.
  4546. #If the symbol
  4547. #name is preceded by an asterisk ('*') that symbol is defined as a
  4548. #global (public) symbol.  Note that all symbols read from the $MODEL
  4549. #file are treated as global (public) symbols.
  4550. #.sp 1
  4551. #The value of a symbol can be displayed in \bhexadecimal\r,
  4552. #\bdecimal\r, or \bASCII\r.
  4553. #If the
  4554. #data type of the symbol is known, the display format selected
  4555. #is defined by \l($368)Model^File^Directive^A50\m
  4556. #(which you can modify).  The default display format selections
  4557. #are hexadecimal for char, unsigned char and float, and
  4558. #decimal for int, unsigned int, long and unsigned long.
  4559. #If the data type of a symbol is
  4560. #unknown the symbol value is displayed in hexadecimal.
  4561. #The number of bytes displayed for an unknown data type is
  4562. #by default 4 but can be changed using the
  4563. #\l($270)Configure|Options|Unknown^Data^Type^Size\m command.
  4564. #.sp 1
  4565. #The scope information displayed for a symbol is dependent
  4566. #on the type of symbol it is.  In general, the name of the
  4567. #module or procedure that the symbol was defined in will be
  4568. #displayed along with scope/nesting level information.
  4569. #.($367)Screen Content
  4570. #Two screen modes are available for this command.  The \bnarrow\r
  4571. #screen contains just the module \baddress^range\r and \bname\r
  4572. #of each displayed module.  The \bwide\r screen contains (in addition
  4573. #to the address range and name)
  4574. #the \bSource^File\r and \bLanguage\r for each module.
  4575. #.sp 1
  4576. #In addition, \bProcedure\r names and their \bScope^Levels\r are
  4577. #listed for each module when using the \bScopes\r command.
  4578. #.($368)Model File Directive A50
  4579. #The A50 directive is used to set the display mode for each
  4580. #data type when displaying symbol values in the
  4581. #\l($140)Symbol|Global\m, \l($141)Symbol|Local\m,
  4582. #\l($142)Symbol|Alpha\m, and \l($143)Symbol|Address\m commands.
  4583. #The format of the A50 directive is:
  4584. #.sp 1
  4585. #.in +4 {
  4586. #.ti -2
  4587. #A50^^^^<char>^<uchar>^<int>^<uint>
  4588. #.ti -2
  4589. #^^^^^^^<long>^<ulong>^<float>;
  4590. #.in -4 }
  4591. #.sp 1
  4592. #The available modes are 0 for hexadecimal format, 1 for
  4593. #decimal format and 2 for character (ASCII) format.
  4594. #The default A50 directive is:
  4595. #.sp 1
  4596. #.in +4 {
  4597. #.ti -2
  4598. #A50^^^^0^^0^^1^^1^^1^^1^^0;
  4599. #.in -4 }
  4600. #.($369)Bin Capture Range
  4601. #The \bCapture^Range\r is the range of code addresses monitored
  4602. #by a bin (for which sample counts are captured).
  4603. #All \bCapture^Ranges\r (for all bins) will always be within
  4604. #the bounds of the \l($290)Capture^Span\m.  In addition, no
  4605. #\bCapture^Range\r will ever overlap any other \bCapture^Ranges\r.
  4606. #Note that there may be several distinct \bCapture^Ranges\r for
  4607. #the same bin number depending on how the setup was created.
  4608. #.sp 1
  4609. #When \l($292)Edit\ming a bins \bCapture^Range\r several checks
  4610. #are made to determine if the range is valid.  The ending address
  4611. #of the range must be equal to or greater than the starting
  4612. #address range and the range may not overlap any other range,
  4613. #except for any ranges in \l($370)Miss^Bins\m.
  4614. #.($370)Bin Types
  4615. #\bMiss^Bin\r
  4616. #.sp 1
  4617. #The \bMiss^Bin\r is automatically added to a setup if the
  4618. #defined \l($369)Capture^Ranges\m do not entirely cover
  4619. #code memory (i.e., if there are gaps in the address ranges
  4620. #to be monitored).  This may occur
  4621. #after a bin has been \l($292)Edit\med or \l($293)Add\med,
  4622. #after a \l($282)Quick-setup\m has been defined, or after
  4623. #a setup has been \l($297)Load\med.
  4624. #.sp 1
  4625. #The \bMiss^Bin\r is assigned the \l($372)Bin^Number\m of
  4626. #15 for the High Resolution Performance Analysis setup
  4627. #and 999 for the
  4628. #High Bin Count Performance Analysis setup.
  4629. #You cannot modify the \bMiss^Bin\r.
  4630. #.sp 1
  4631. #\bBreak^Bin\r
  4632. #.sp 1
  4633. #The \bBreak^Bin\r is available only for the
  4634. #High Resolution Performance Analysis setup
  4635. #since the normal breakpoint mechanism is inoperable when
  4636. #performing a High Resolution Performance Analysis setup.
  4637. #The \bBreak^Bin\r is always \l($372)Bin^Number\m 16.
  4638. #You can specify any number of breakpoints (or ranges)
  4639. #using the \bBreak^Bin\r.  This bin may be created by
  4640. #\l($293)Add\ming a bin and setting the bin number to 16,
  4641. #or by \l($292)Edit\ming an existing bin and changing its
  4642. #bin number to 16.
  4643. #.sp 1
  4644. #During High Resolution Performance Analysis
  4645. #emulation if the program executes at any
  4646. #code location monitored by the \bBreak^Bin\r, emulation will
  4647. #break (stop) as with 'normal' breakpoints.
  4648. #.sp 1
  4649. #\bUser^Bin\r
  4650. #.sp 1
  4651. #The \bUser^Bin\r is any bin that you have \l($293)Add\med
  4652. #or \l($292)Edit\med, other than the \bBreak^Bin\r.
  4653. #If a bin created by a \l($282)Quick-setup\m is later \bEdit\red
  4654. #its \bBin^Type\r will be changed to \bUser\r.
  4655. #.sp 1
  4656. #\bNeql^Bin\r
  4657. #.sp 1
  4658. #The \bNeql^Bin\r is a bin that was created using the
  4659. #\l($283)Quick-setup|N-Equal\m command.
  4660. #.sp 1
  4661. #\bMod^Bin\r
  4662. #.sp 1
  4663. #The \bMod^Bin\r is a bin that was created using the
  4664. #\l($283)Quick-setup|Module\m command.
  4665. #.sp 1
  4666. #\bProc^Bin\r
  4667. #.sp 1
  4668. #The \bProc^Bin\r is a bin that was created using the
  4669. #\l($283)Quick-setup|Procedure\m command.
  4670. #.sp 1
  4671. #\bLnum^Bin\r
  4672. #.sp 1
  4673. #The \bLnum^Bin\r is a bin that was created using the
  4674. #\l($283)Quick-setup|Line^Numbers\m command.
  4675. #.($371)Bin Description
  4676. #The \bBin^Description\r field allows you to enter
  4677. #a descriptive tag for a bin.  Up to 30 characters can
  4678. #be displayed.  The \bBin^Description\r field is also used
  4679. #by the \l($282)Quick-setup\m commands to tell you
  4680. #how each bin was created.
  4681. #.($372)Bin Number
  4682. #The \bBin^Number\r can be any number greater than 0 and
  4683. #less than or equal to the maximum number of bins.
  4684. #The maximum number of bins allowed is normally 15 for
  4685. #the High Resolution Performance Analysis setup
  4686. #and 999 for the
  4687. #High Bin Count Performance Analysis setup.
  4688. #If the current setup requires a \l($370)Miss^Bin\m,
  4689. #the maximum number of bins allowed is 14 for
  4690. #a High Resolution Performance Analysis setup
  4691. #and 998 for a
  4692. #High Bin Count Performance Analysis setup
  4693. #as the miss bin number is 15 for
  4694. #the High Resolution Performance Analysis setup
  4695. #and 999 for
  4696. #the High Bin Count Performance Analysis setup.
  4697. #.sp 1
  4698. #In the case of a High Resolution Performance Analysis setup,
  4699. #setting the bin number to 16
  4700. #is legal and causes a \l($370)Break^Bin\m to be created.
  4701. #.($373)Operands
  4702. #The set of choices in the \bOperands\r pull-down are:
  4703. #.sp 1
  4704. #.in +2 {
  4705. #.in +11 {
  4706. #.ti -11
  4707. #None^^^^^^^no operand (used to remove an operand)
  4708. #.ti -11
  4709. #Immediate^^immediate operand
  4710. #.ti -11
  4711. #Direct^^^^^direct address operand
  4712. #.ti -11
  4713. #Bit^^^^^^^^bit address operand
  4714. #.ti -11
  4715. #/Bit^^^^^^^complemented contents of bit address operand
  4716. #.ti -11
  4717. #Code^^^^^^^code address (16-bit, 11-bit page and 8-bit relative)
  4718. #.ti -11
  4719. #A^^^^^^^^^^accumulator operand (implicit)
  4720. #.ti -11
  4721. #C^^^^^^^^^^carry bit operand (implicit)
  4722. #.ti -11
  4723. #DPTR^^^^^^^data pointer operand (implicit)
  4724. #.ti -11
  4725. #PC^^^^^^^^^PC operand (implicit)
  4726. #.ti -11
  4727. #AB^^^^^^^^^AB pair operand (implicit)
  4728. #.ti -11
  4729. #@R0^^^^^^^^indirect register 0 operand (implicit)
  4730. #.ti -11
  4731. #@R1^^^^^^^^indirect register 1 operand (implicit)
  4732. #.ti -11
  4733. #Rn^^^^^^^^^specific general purpose register (n=0 through 7) (implicit)
  4734. #.ti -11
  4735. #R0^-^R7^^^^any general purpose register (implicit)
  4736. #.in -2 }
  4737. #.in -11 }
  4738. #.(End_Help_File)
  4739. #.mi
  4740. #Probe Card Operating Test
  4741. #.sp 1
  4742. #.in +2 {
  4743. #When the Host Software establishes communication
  4744. #with the emulator a test is run to determine if
  4745. #the probe card is operating.  If it is not, the
  4746. #following message is displayed:
  4747. #.sp 1
  4748. #.in +2
  4749. #.ba
  4750. #Probe not operating -- check Help for possible causes
  4751. #.ea
  4752. #.in -2
  4753. #.sp 1
  4754. #Some of the possible causes are:
  4755. #.sp 1
  4756. #.in +2
  4757. #.ba
  4758. #Probe card in target system, P2.0 tied to VCC
  4759. #Probe card not in target system, P2.0 tied to VCC
  4760. #.ea
  4761. #.in -2
  4762. #.in -2 }
  4763. #.mi
  4764. #MISCELLANEOUS
  4765. #.sp 1
  4766. #The format of the displayed real-time emulation clock
  4767. #value ("Execution Time:") can be controlled somewhat
  4768. #by the A43 directive in the model file ($MODEL).  The
  4769. #character specified there will be used as the separator
  4770. #between every 3rd digit in the "Execution Time:" value.
  4771. #That same directive controls the format of
  4772. #the "Execution Time:" value and the sample counts
  4773. #in the Performance Analyzer Display menu.
  4774. #The default value for this separator character
  4775. #is a comma (',').
  4776. #.mi
  4777. #MISCELLANEOUS
  4778. #.sp 1
  4779. #The format of the displayed real-time emulation clock ("Time:")
  4780. #and sample count values can be controlled somewhat
  4781. #by the A43 directive in the model file ($MODEL).  The
  4782. #character specified there will be used as the separator
  4783. #between every 3rd digit in the "Time:" and sample count values.
  4784. #The default value for this separator character
  4785. #is a comma (',').
  4786. #.co = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = PROM-Programmer Menu
  4787. #.(End_Help_File)
  4788.