home *** CD-ROM | disk | FTP | other *** search
/ Loadstar 88 / 088.d81 / t.mldocs < prev    next >
Text File  |  2022-08-26  |  21KB  |  774 lines
  1.           COMVIEW USERS MANUAL 
  2.  
  3.              by Rick Nash 
  4.  
  5.      Load COMVIEW as you would any
  6. BASIC program, then simply type RUN to
  7. start.  At this point you will see the
  8. main screen.  It consists of two
  9. parts.  On the top is a window divided
  10. into three parts.  The upper left
  11. window shows the current state of the
  12. 6502 registers.  The lower left window
  13. shows six bytes from any three memory
  14. location in the computer.  The right
  15. window shows the current contents of
  16. the hardware stack.  At this point,
  17. don't worry if you don't understand
  18. any of this.  It will become clear as
  19. we begin to use different features of
  20. COMVIEW. 
  21.  
  22.     The bottom window (Main window) is
  23. the business end of COMVIEW.  This is
  24. where most of the work gets done. 
  25. Things like the memory command, the
  26. assembler and disassembler use this
  27. window for data entry and display.  At
  28. this point, a title message appears in
  29. this window.  Let us now turn our
  30. attention to the MAIN MENU.  Press the
  31. Commodore key and M simultaneously.  
  32.  
  33.   ---------------
  34.    THE MAIN MENU
  35.   --------------- 
  36.  
  37.      At this point, the main menu is
  38. displayed.  Note the characters inside
  39. the square brackets.  These are the
  40. "HOT" keys that are available while
  41. this menu is shown.  You can either
  42. use the UP and DOWN CRSR keys to
  43. choose your selection, then press
  44. RETURN, or press the hot key for your
  45. choice.  In the tutorials, we will use
  46. the following mnemonics for making
  47. menu selections: 
  48.  
  49.     [MAIN-T] - means press the T hot
  50. key on the MAIN menu. 
  51.  
  52.     Menu items followed by ellipses
  53. (...) means that a sub-menu will open.
  54.  
  55.  
  56.     From all but the MAIN menu, the
  57. back arrow is used as an escape key. 
  58. Pressing the escape key will halt
  59. almost all operations (except quick
  60. trace).  Pressing the escape key from
  61. a menu, will take you to the previous
  62. menu.  Some menus offer a "quick" exit
  63. key that will zoom to the MAIN menu. 
  64. This option is clearly marked on menus
  65. that support it.  The remainder of
  66. this manual will describe all of the
  67. options and features of COMVIEW. 
  68.  
  69.   ---------------
  70.    THE HELP MENU
  71.   --------------- 
  72.  
  73.     Pressing [MAIN-H] will present the
  74. HELP menu.  There are three help
  75. screens avaliable: 
  76.  
  77.     [HELP-G] - Will display a short
  78. synopsis of legal keystrokes and
  79. general information about COMVIEW. 
  80.  
  81.     [HELP-I] - Will bring up the
  82. instruction set help menu.  Select the
  83. instruction using the UP, DOWN, LEFT
  84. and RIGHT arrow keys.  Then press
  85. RETURN to enter your choice.  A window
  86. will open with full information on the
  87. chosen instruction.  This window
  88. offers a ZOOM key (the RETURN key) to
  89. zoom to the main menu. 
  90.  
  91.     [HELP-C] - Brings up the
  92. conversion table.  This table a
  93. consists of five columns: DEC, HEX,
  94. BINARY, ASCII and SCREEN CODES.  Use
  95. this for base conversions or
  96. ASCII/SCREEN codes.  Active keys are
  97. the UP and DOWN CRSR keys and F7,
  98. which will move forward one page. 
  99.  
  100.     Remember: to back out of anything,
  101. press the BACK ARROW (COMVIEW escape
  102. key). 
  103.  
  104.   ---------------------
  105.    FILL MEMORY COMMAND
  106.   --------------------- 
  107.  
  108.      Pressing [MAIN-I] will initiate
  109. the fill memory command.  This command
  110. is used to initialize a section of
  111. memory to a given value.  Note that
  112. you can change ANY memory location,
  113. including where COMVIEW is residing,
  114. so use this command carefully.  Three
  115. requesters will prompt you for the
  116. starting, ending and fill byte.  A
  117. requester is a white box that appears
  118. and asks for user input.  Enter the
  119. information, and press RETURN, or use
  120. the escape key to cancel.  After the
  121. third requester, the memory will be
  122. filled. 
  123.  
  124.  
  125.   -------------
  126.    PREFERENCES
  127.   ------------- 
  128.  
  129.      Pressing [MAIN-P] will show the
  130. preferences menu.  This menu allows
  131. you to set up defaults for the way
  132. COMVIEW acts.  At this time, only two
  133. entries are found on the preferences
  134. screen: 
  135.  
  136.     [PREFS-S] - Will enable/disable
  137. screen-swapping.  Screen-swapping is
  138. covered under the trace command. 
  139.  
  140.     [PREFS-R] - Will enable/disable
  141. repeating keys.  This will be noticed
  142. on commands such as the MEMORY command
  143. [MAIN-M]. 
  144.  
  145.     Note the parentheses after each
  146. item.  If a large dot is shown, then
  147. the feature is ENABLED, otherwise it
  148. is DISABLED. 
  149.  
  150.   -------------
  151.    DISASSEMBLE
  152.   ------------- 
  153.  
  154.      The disassemble command [MAIN-D],
  155. will show a section of memory in
  156. machine language mnemonic form.  A
  157. requester will ask for the starting
  158. address, and then start the
  159. disassembler.  Active keys are the UP
  160. and DOWN CRSR keys (meaning forward
  161. and backward scrolling disassembly),
  162. and of course the escape key.  Note
  163. that disassembling a data table will
  164. produce garbage mnemonics (watch the
  165. ASCII field), but if real ML follows
  166. the table, the disassembler will right
  167. itself after several bytes.  Here is a
  168. sample disassembled line: 
  169.  
  170.    A      B       C    D      E
  171.    ------------------------------
  172.   EACD  C0 41    CPY #$41    ;-A 
  173.  
  174. field a = hexadecimal address 
  175.  
  176.       b = machine bytes (hex) 
  177.       c = mnemonic disassembly 
  178.       d = operand 
  179.       e = ASCII representation 
  180.  
  181.   ----------
  182.    ASSEMBLE
  183.   ---------- 
  184.  
  185.      The assemble [MAIN-A] command
  186. allows you to enter machine language
  187. mnemonics into memory.  Note that this
  188. command does not pretend to be a REAL
  189. assembler (see ROCK'S ASSEMBLER,
  190. published on LOADSTAR #87).  Rather,
  191. it allows you to quickly and easily
  192. enter small chunks of code.  It does
  193. however offer a few niceties such as
  194. limited labels, decimal or hex
  195. operands and several pseudo-ops. 
  196. After entering the address at the
  197. requester, you are placed at the main
  198. window with the address listed, and a
  199. flashing cursor.  COMVIEW is waiting
  200. for a line of machine code to be
  201. entered, such as: 
  202.  
  203.     LDA #$00 <RETURN> 
  204.  
  205.     or 
  206.  
  207.     LDA #0 <RETURN> 
  208.  
  209.     After pressing RETURN, the line is
  210. converted to machine code and inserted
  211. into memory.  The next address is
  212. shown, and the process continues.  The
  213. DEL key can be used to erase any
  214. mistakes before pressing the RETURN
  215. key.  Errors are flagged by an error
  216. window that pops up above the main
  217. window.  The error is described, and
  218. the line is shown with an arrow
  219. pointing at the infraction.  Pressing
  220. C will allow you to continue entering
  221. mnemonics. 
  222.  
  223. PSEUDO OPS 
  224.  
  225.     Pseudo ops are mnemonics for the
  226. assembler, not the 6502.  Three
  227. Pseudo's are legal: 
  228.  
  229.     ORG address - change the current
  230. address 
  231.  
  232.     BYT value   - enter the byte (or
  233. word) at the current location 
  234.  
  235.     WOR value   - enter the current
  236. word (hex or decimal) 
  237.  
  238.     (note: BYT $1234 and WOR $1234
  239. will produce like output, 34 12) 
  240.  
  241.  
  242.   --------
  243.    LABELS
  244.   -------- 
  245.  
  246.      Limited labels are supported. 
  247. Use labels only on RELATIVE branch
  248. instructions.  A minus (-) followed by
  249. the character 0-9 for backwards
  250. branches, and a plus (+) followed by
  251. the character 0-9 for forward
  252. branches. 
  253.  
  254.     For example: 
  255.  
  256.  
  257.  
  258.  
  259.             LDX  #0 
  260.         -0  TXA 
  261.             CPX  #40 
  262.             BEQ  +8 
  263.             STA  $C100,X 
  264.             INX 
  265.             BNE  -0 
  266.         +8  RTS 
  267.  
  268.     This nonsense code demonstrates
  269. the use of forward and backward
  270. labels.  Note that the + and - are not
  271. mathematical, they simply are mnemonic
  272. for forwards and backwards.  You must
  273. keep track of all labels.  Since there
  274. is no source code, any label that
  275. scrolls from the screen will be lost
  276. forever, so jot down your labels.  Any
  277. forward label not referenced will NOT
  278. be flagged!  This is handled by making
  279. the branch point to itself.  For
  280. example: 
  281.  
  282.     C020    BNE  +5 
  283.  
  284.    Will be installed as: 
  285.  
  286.     C020    BNE  $C020 a
  287.     until the +5 is referenced again.
  288. If you forgot to reference it, an
  289. endless loop will result.  If your
  290. program hangs, this is probably why. 
  291. Consider yourself warned! 
  292.  
  293.      To stop the assembler, just press
  294. the escape key. 
  295.  
  296.  
  297.   ----------
  298.    REGISTER
  299.   ---------- 
  300.  
  301.      The register command [MAIN-R] is
  302. used to set the initial value of the
  303. .A, .X or .Y registers (register names
  304. will be preceded with a period in this
  305. manual).  When selected, a requester
  306. will prompt for a register value. 
  307. After pressing RETURN, you will notice
  308. a highlighted bar over the .A register
  309. in the register window on the upper
  310. left of your screen.  The value shown
  311. will be the number you typed in.  If
  312. you move the bar with the UP or DOWN
  313. CRSR keys, note that your number
  314. "floa