home *** CD-ROM | disk | FTP | other *** search
/ ftp.barnyard.co.uk / 2015.02.ftp.barnyard.co.uk.tar / ftp.barnyard.co.uk / robot-pd / 12400.ZIP / 12400B.DSK / manual09.txt < prev    next >
Text File  |  1998-04-30  |  6KB  |  190 lines
  1. ═
  2.                   ╩C H A P T E R   E I G H TΩ
  3.  
  4.  
  5. ╩8.1 ASSEMΩ
  6.  
  7. ╩SyntaxΩ:╔ASSEM <source file path> <dest file path>Θ
  8.  
  9. Scans through the source file and generates an HAL machine
  10. code program from the contents. The  resulting  code  will
  11. then be written into the destination file.
  12.  
  13.  
  14. ╩8.1.2 The HAL MicroprocessorΩ
  15.  
  16. This is a software implemented tutorial microprocessor. It
  17. has the following features:-
  18.  
  19. 1.Four internal registers:A(accumulator),IX(index), SP(st-
  20. ack pointer) and PC(program counter).
  21.  
  22. 2.It is a 10 bit microprocessor. That is to  say,  it  can
  23. handle data in the range 0-1023.
  24.  
  25. 3.All arithmetic results are placed in the accumulator.
  26.  
  27. 4.Address range is the same as data range ie; 10 bits.
  28.  
  29. 5.Port address range is 0-255.
  30.  
  31. ╩8.1.3 The HAL Assembler LanguageΩ
  32.  
  33. In the following list, the following terms apply:-
  34.  
  35. <source> : Can be one of:-
  36.  
  37. <number> - A numeric value in the range 0..1023
  38. @<number>- The contents of memory location whose  address
  39. is the same as the given number
  40. ^<number>- The contents of the given I/O port.
  41. A        - Contents of accumulator
  42. SP       - Contents of stack pointer
  43. IX       - Contents of index register
  44. IX <num> - Contents of memory location, whose address  is
  45. the same as (IX + <num>)
  46.  
  47. <dest> : Can be:-
  48.  
  49. @<number>- Put result in given memory address.
  50. ^<number<- Put result in given port.
  51. A        - Put result in accumulator
  52. SP       - Put result in stack pointer
  53. etc.
  54.  
  55. <cond.> : Can be one of:-
  56.  
  57. Z - Return true if the last arithmetic operation  resulted
  58. in a zero value.
  59. C - Return true if the last arithmetic operation generated
  60. a carry.
  61. M - True if the  last  arithmetic  operation  produced   a
  62. negative result.
  63.  
  64. The possible commands are then:-
  65.  
  66. LD <dest>,<source>  -  Move  data  from  one  location  to
  67. another.
  68.  
  69. PUSH <source> - Place data onto machine stack.  The  stack
  70. pointer will move down once after this operation.
  71.  
  72. POP <dest> - Retrieve data from stack, SP moves up  before
  73. the data is retrieved.
  74.  
  75. {SP can be thought of as pointing to the next "free" entry
  76. on the stack. It starts at an initial value of 1023.}
  77.  
  78. ADD <source>,<source> - Add the  two  items  and  put  the
  79. result into the accumulator.
  80.  
  81. SUB <source>,<source> - As above but subtract.
  82.  
  83. CP <source>,<source> - Perform a subtraction  but  discard
  84. the result. This instructions  allows  comparisons  to  be
  85. made between numbers.
  86.  
  87. JP <source> - Jump to a different memory location
  88.  
  89. JPC <cond.>,<source> - If the  given  condition  is  TRUE,
  90. jump to the given location.
  91.  
  92. CALL <source> - Call a subroutine at location given.
  93. CALLC <cond.>,<source>
  94.  
  95. RET - Return from subroutine.
  96. RETC <cond.>
  97.  
  98. Later versions may also support the following:-
  99.  
  100. ROTR <source> - Rotate source  right,  placing  result  in
  101. accumulator.
  102.  
  103. ROTL <source> - Rotate left.
  104.  
  105. AND <source>,<source> - Place result of logical  operation
  106. in accumulator.
  107. XOR and OR are also supported.
  108.  
  109. ╩8.1.4 Port I/O SignalsΩ
  110.  
  111. Port 0 is the control register. The  value  sent  to  this
  112. port will determine the function to be carried out:-
  113.  
  114. 001-Output character whose ASCII code has previously  been
  115. sent to port 1. The code sent to port 1 will be forced  to
  116. ASCII range by ADDing it with 255.
  117.  
  118. 002-Read keyboard and place code of character pressed   at
  119. port 1. A value of zero at port 1 indicates  that  no  key
  120. was pressed.
  121.  
  122. 003-Change screen mode. The value at port 2 is modified to
  123. suit the range 0..2 by taking it MOD 3.
  124.  
  125. 004-Move cursor to given column. The column number is sent
  126. to port 1 as normal, but is not forced into range  by  the
  127. port controller.
  128.  
  129. 005-As above, but move cursor to given column.
  130.  
  131. ╩8.1.5 Numbers In Source CodeΩ
  132.  
  133. A <number> may be given in the following forms:-
  134.  
  135. [╤#±]<decimal digits> - Decimal form of number.
  136. {&}<Hexadecimal digits> - Hexadecimal form of number.
  137. %<binary digits> - Binary form of number.
  138. '<character>' - ASCII code of character. Any character may
  139. appear between the single quotes.
  140. <label name> - The value of the given label.
  141.  
  142. ╩8.1.6 Assembler CommandsΩ
  143.  
  144. EQU <number> - Set the last label to hold the given number
  145. DEFB ++<number> - Enter a list of bytes  into  the  source
  146. code at the current position.
  147. DEFM '<string>' - Store the given string in the code.
  148.  
  149. ╩8.2 Monitor CommandsΩ
  150.  
  151. ╩Format:Ω MONITOR <file path>
  152.  
  153. The given <file path> points to the object  code  produced
  154. by the assembler program.
  155.  
  156.  
  157. ╩8.2.1 Control KeysΩ
  158.  
  159. `P' - Change address stored in the program  counter  (PC).
  160. This is the address of the next instruction to be executed
  161. by the CPU.
  162.  
  163. `M' - Modify memory. Values  can  be  placed  into  memory
  164. using this option. To finish the operation, press [RETURN]
  165. on a blank line.
  166.  
  167. `R' - Run object  code  from  next  instruction.  In  this
  168. execution mode, MONITOR will display the contents  of  the
  169. CPU registers, and the memory that they point to. This  is
  170. the slowest method of running code-it also affects  screen
  171. displays.
  172.  
  173. `G' - Execute object code from next instruction.  In  this
  174. execution mode, the CPU is being emulated at it's  highest
  175. possible speed. On  average  the  CPU  can  execute  three
  176. instructions each second.
  177.  
  178. ` ' - Execute the next instruction only, in ╔RΘUN mode.
  179.  
  180. `D' - Disassemble memory.
  181.  
  182. In several of the above cases, you will  be  asked  for  a
  183. memory address. Hexadecimal numbers have to be prefixed by
  184. `&' or `&H'. Binary numbers have to be prefixed by `&X'.
  185.  
  186. The `R' and `G' options can be terminated by holding  down
  187. [CONTROL + [SPACE]]╒
  188. M <source file path> <dest file path>Θ
  189.  
  190. Sca