home *** CD-ROM | disk | FTP | other *** search
/ Programmer 7500 / MAX_PROGRAMMERS.iso / INFO / CROSSASM / 6809.ZIP / A69.DOC < prev    next >
Encoding:
Text File  |  1987-03-15  |  36.8 KB  |  1,102 lines

  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.                              PseudoSam 69 Assembler Manual V1.2.02
  12.                              Copyright(c) 1986,87 PseudoCode
  13.  
  14.  
  15.  
  16.  
  17.  
  18. Disclaimer:
  19.  
  20.             PseudoSam 69 is distributed as is, with no guarantee that it
  21.             will work correctly in all situations.  In no event will the
  22.             Author be liable for any damages, including lost profits,
  23.             lost savings or other incidental or consequential damages
  24.             arising out of the use of or inability to use these
  25.             programs, even if the Author has been advised of the
  26.             possibility of such damages, or for any claim by any other
  27.             party.
  28.  
  29.             It is the users reponsibility to back up all important files!
  30.  
  31.             See copyright information in appendix B
  32.  
  33.  
  34.  
  35.  
  36.  
  37.                          Table of Contents
  38.  
  39. Chapter 1  PseudoSam 69 assembler vs. the Motorola assembler.
  40.  
  41. Chapter 2  Running the assembler program.
  42.  
  43. Chapter 3  Assembler statement syntax.
  44.  
  45. Chapter 4  Data types.
  46.  
  47. Chapter 5  Expressions.
  48.  
  49. Chapter 6  Assembler Directives.
  50.   (also known as assembler pseudo-opcodes, or pseudo-ops)
  51.  
  52. Appendix A      ASCII character set.
  53.  
  54. Appendix B      Copyright and registration information.
  55.  
  56. Appendix C      Description of Files.
  57.  
  58. Appendix D      Bug Reporting Procedure.
  59.  
  60. Appendix E      Using PseudoSam 69 on "Compatible" Systems.
  61.  
  62.  
  63.  
  64. Chapter 1 PseudoSam 69 assembler vs. the Motorola assembler
  65.  
  66.      All PseudoSam(Pseudo brand Symbolic AsseMbler) assemblers conform to
  67.      a common syntax based on the UNIX system V assembler syntax. By
  68.      conforming to this Pseudo standard, conflicts with the manufacturers
  69.      syntax are created.  Below is a brief and incomplete list of those
  70.      conflicts.
  71.  
  72.       Motorola format                     PseudoSam format
  73.  
  74. <identifier> equ <expression>         .equ <identifier> , <expression>
  75.  
  76. <identifier> set <expression>         .set <identifier> , <expression>
  77.  
  78. Has Macro capability                  No Macro capability at this time
  79.  
  80. Labels start in column 1 of           Labels may start anywhere, but must
  81. the source line.                      be followed immediately by a colon.
  82.  
  83.  
  84.  
  85. * The difference between the Motorola and the PseudoSam name
  86.   of an assembler directive can be circumvented by the .opdef
  87.   directive.
  88.  
  89.   example
  90.  
  91.    .opdef  eject,.eject      ;defines eject to be synonymous with .eject
  92.    .opdef  fcc,.db           ;fcc will now form constant characters as it
  93.                              ;should.
  94.  
  95. *  A file syn.asm is distributed with the assembler with some useful
  96.    redefinitions.
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107. Unix system V is a trademark of AT & T.
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115. Chapter 2  Running the assembler program
  116.  
  117. 1.  Command line switch setting and source file specification.
  118.  
  119.      Assuming the user has an assembly language source file called foo.asm
  120.      type the following command:
  121.  
  122. a69 foo
  123.  
  124.      The assembler will assemble the program foo.asm using the default
  125.      assembler switch settings. the following files will be generated
  126.      by the assembler:
  127.  
  128.      foo.lst   ;assembled listing shown the code conversion and
  129.                ; any errors that where discover by the assembler.
  130.  
  131.      foo.obj   ;assembled object code in Motorola Hex format.
  132.  
  133. **  for a list of switch setting see the .command assembler directive
  134.     description in chapter 6.
  135.  
  136. *** The assembler uses the following temporary file names.
  137.  
  138.     z0z0z0z0.tmp
  139.     z1z1z1z1.tmp
  140.  
  141.     ANY files with these names will be DESTROYED by the
  142.     by the assembler.
  143.  
  144.  
  145.  
  146.  
  147.  
  148.  
  149.  
  150. Chapter 3  Assembler statement syntax
  151.  
  152. 1. Assembler Statements
  153.  
  154.      Assembler statements contain from zero to 4 fields as shown in
  155.      following.
  156.  
  157. <label> <opcode> <expressions> <comment>
  158.  
  159.      All fields are optional, but they must be in this order.
  160.  
  161. A.   Labels (<label>) are symbolic names that are assigned the starting
  162.      address of any code generated by the opcode and or expressions
  163.      of the line containing the label declaration.(see section 2).
  164.  
  165. B.   Operation codes(<opcode>) tell the assembler what machine instruction
  166.      to generate, or what assembler control function to perform.
  167.      The operation code also tells the assembler what expressions are
  168.      required to complete the machine instruction or assembler directive.
  169.      (see chapter 6).
  170.  
  171. C.   Expression requirements are set by the opcode(see the microprocessor
  172.      manufacturers reference manual or the assembler directives chapter
  173.      for individual opcode requirements).(see chapter 5).
  174.  
  175. D.   Comments are notes written by the programmer to explain what the
  176.      program is trying to accomplish. Comments generate no code.
  177.      (see section 3).
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185. 2.  Labels
  186.  
  187.      Labels can be unlimited in length, but only the first eight characters
  188.      are used to distinguish between them.  They must conform to the
  189.      following syntax.
  190.  
  191.      <label>  -> <identifier>':'
  192.  
  193.      <identifier> -> <alphabetic character> <identifier character string>
  194.  
  195.      <alphabetic character> -> character in the set ['A'..'Z', 'a'..'z', '.']
  196.  
  197.      <identifier character string> -> any sequence of characters from the
  198.                                       set ['A'..'Z','a'..'z', '.', '0'..'9']
  199.  
  200. example
  201. abc:                  ;label referred to as abc
  202. a c:                  ;not a valid label
  203.          foo:         ;label referred to as foo
  204. .123:                 ;label referred to as .123
  205.  
  206. * Case makes NO difference!
  207.  
  208. d:      ;is the same as
  209. D:
  210.  
  211.  
  212. 3.  Comments
  213.      Comments must start with a semi-colon ; and are terminated
  214.      by an end of line or file( <lf>(^J) or <sub>(^Z) ). An end
  215.      of line is inserted by typing the enter or return key by
  216.      most text editors.
  217.  
  218.  
  219.  
  220.  
  221.  
  222.  
  223.  
  224. Chapter 4     Data types
  225.  
  226. 1.  Integers
  227.  
  228.     Integer constants can be specified in any of the following forms:
  229.  
  230. A.  Binary
  231.  
  232.     b'bb             ;bb=string of binary digits
  233.     B'bb
  234.  
  235. B.  Decimal
  236.  
  237.     ndd
  238.     d'dd             ;n=nozero decimal digit
  239.     D'dd             ;dd=string of decimal digits
  240.  
  241. C.  Octal
  242.  
  243.     0qq              ;qq=string of octal digits
  244.     o'qq
  245.     O'qq
  246.     q'qq
  247.     Q'qq
  248.  
  249. D.  Hexidecimal
  250.  
  251.     0x'hh            ;hh=string of hexidecimal digits
  252.     0X'hh
  253.     h'hh
  254.     H'hh
  255.     x'hh
  256.     X'hh
  257.  
  258.  
  259. Examples:
  260.  
  261.     077        ;octal number 77 = decimal 63
  262.     b'0101     ;binary number 101 = decimal 5
  263.     77         ;decimal number 77 = octal 115
  264.     h'ff       ;hexidecimal ff = decimal 255
  265.  
  266.  
  267.  
  268.  
  269.  
  270.  
  271. 2.  Strings:
  272.  
  273.     Strings consist of a beginning quote " followed by any reasonable number
  274.     of characters followed by an ending quote ". Control characters and double
  275.     quotes " and backslash \ may not be used in strings directly.  These
  276.     special characters are included by using a special escape sequence which
  277.     the assembler translates into the appropriate ASCII code.
  278.  
  279. Note: Strings may not be used in expressions!
  280.       Although character constants may(see below).
  281.  
  282. Escape sequences
  283.   "\"" string containing "
  284.   "\\" string containing \
  285.   "\'" string containing '
  286.   "\0" string containing null
  287.   "\n" string containing linefeed
  288.   "\r" string containing carriage return
  289.   "\f" string containing formfeed
  290.   "\t" string containing horizontal tab
  291.   "\nnn" string containing the ASCII character who's code is o'nnn
  292.          (nnn are octal digits).
  293.   * see appendix A for ASCII codes.
  294.  
  295. 3.  Character Constants:
  296.  
  297.     Character constants consist of  a single quote ' followed by
  298.     a character or an escape sequence(see above) followed by a
  299.     single quote '.
  300.  
  301. example:
  302.    'A' = ASCII character value for the letter A = 65 (decimal);
  303.    '\''= ASCII character value for the character ' = 39 (decimal).
  304.  
  305. Character constants are treated as integers by the assembler and
  306. are valid where ever an integer value is valid.
  307.  
  308. example:
  309.    'A' + 1 = 66
  310.  
  311.   * see appendix A for ASCII codes.
  312.  
  313. 4.  Symbolic values
  314.  
  315.     Symbolic values are generally labels, but may be any identifier
  316.     assigned an integer value(using .set or .equ pseudo-ops).
  317.  
  318.     As a special case the symbol * when used as an operand in an
  319.     expression denotes the value of the location counter (the value
  320.     the program counter will have during operation) at the beginning
  321.     of the current line.
  322.  
  323.  
  324.  
  325.  
  326.  
  327.  
  328. Chapter 5  Expressions
  329.  
  330.      All expressions evaluate to integer values modulo 65536(2^16) and are
  331.      written in infix notation(the way you normally write them).  Operators
  332.      provided are grouped below in order of precedence.
  333.  
  334. 1. (unary)
  335. ~           logical bit wise complement(not) of its operand(one's complement).
  336. -           arithemetic complement, or negation(two's complement).
  337.  
  338. 2. (binary)
  339. *           integer multiply (two's complement).
  340. /           integer divide   (two's complement).
  341. %           modulus          (result is always positive)
  342. >>          logical shift right (left operand shifted right operand times).
  343. <<          logical shift left (left operand shifted right operand times).
  344. ~           equivalent to  A or ( ~B ).
  345.  
  346. 3. (binary)
  347. |           logical bitwise or(inclusive-or) of two operands.
  348. ^           logical bitwise exclusive-or of two operands.
  349. &           logical bitwise and of two operands.
  350.  
  351. 4. (binary)
  352. +           addition (two's complement).
  353. -           subtraction (two's complement).
  354.  
  355.      Since this version does not generate relocatable code there exists only
  356.      one "type" of operand that can be in an expression.  So anything goes
  357.      except divide by 0(1 will be substituted ).
  358.  
  359. examples:
  360.     -1 = h'ffff  (two's complement notation).
  361.     -1 >> 8 = h'00ff
  362.     -1 << 8 = h'ff00
  363.     3 / 2 = 1
  364.     6 / 2 = 3
  365.     5 / 0 = 5
  366.     -2 / 1 = -2
  367.     -3 /-2 = 1
  368.     2 * -3 = -6
  369.     b'00 & b'11 = 0
  370.     b'11 & b'10 = 2
  371.     2 * b'01 & b'10 = 2
  372.     b'01 ^ b'11 = 2
  373.     b'01 | b'11 = 3
  374.  
  375. Notice that spaces are ignored in expressions.
  376.  
  377.  
  378.  
  379.  
  380.  
  381.  
  382.  
  383.  
  384. Chapter 6  Assembler Directives
  385.   (also known as assembler Pseudo-opcodes)
  386.  
  387.      The assembler recognizes the following directives:
  388.  
  389.       directive  section    description
  390.  
  391.       .command    1   ;set assembly options(similar to command line options).
  392.  
  393.       .org        2   ;set program origin.
  394.  
  395.       .equ        3   ;equate an identifier to an expression(permanent
  396.                       ; assignment).
  397.  
  398.       .set        4   ;equate and identifier to an expression(temporary
  399.                       ; assignment).
  400.  
  401.       .rs         5   ;reserve storage(memory) space.
  402.  
  403.       .db         6   ;define byte.
  404.  
  405.       .dw         7   ;define word(16 bit).
  406.  
  407.       .drw        8   ;define reversed word(16 bit).
  408.  
  409.       .eject      9   ;form feed in listing
  410.  
  411.       .page      10   ;align location counter on 256 byte memory
  412.                       ; page boundary.
  413.  
  414.       .end       11   ;end of program
  415.  
  416.       .opdef     12   ;equate an identifier with another identifier.
  417.  
  418.       .segment   13   ;define a memory segment.
  419.  
  420.       <segment name>
  421.                  14   ;select segment <segment name> as current segment.
  422.  
  423.       .null      15   ;this is a comment statement.
  424.  
  425.  
  426.  
  427.  
  428.  
  429. 1. .command    <optionlist>   ;allows the programmer to set option switches
  430.                               ;in the same manner as on the command line.
  431.                               ;(the command line is the line typed to run
  432.                               ; this program).
  433.  
  434. <optionlist> -> <option> ' ' <optionlist>
  435. <optionlist> ->
  436.  
  437. <option> -> '-'<available option>
  438. <option> -> '+'<available option>
  439.  
  440. <available option> -> 'a'<decimal number> ;Hex hode format.
  441.                                           ;1 => Intel Hex.
  442.                                           ;2 => Motorola 19 Hex.
  443.  
  444. <available option> -> 'w'<decimal number> ;page width in columns(characters).
  445.                                           ;(-,+ are ignored but one must be
  446.                                           ; there).
  447.  
  448. <available option> -> 'h'<decimal number> ;page height in lines.
  449.                                           ;(-,+ are ignored but one must be
  450.                                           ; there).
  451.  
  452. <available option> -> 'l'                 ;listing on(+) or off(-)
  453.                                           ;if set on command line it overrides
  454.                                           ;all listing controls in program.
  455.  
  456. <available option> -> 'm'<decimal number> ;Machine level.
  457.  
  458. <available option> -> 's'                 ;symbol listing on(+) or off(-).
  459.  
  460. <available option> -> 'o'                 ;selects single object module
  461.                                           ;file only(+), or multiple object
  462.                                           ;module files(-)(one for each
  463.                                           ;defined segment in the program).
  464.                                           ;ONLY active on command line!
  465.  
  466. <available option> -> 't'<drive>          ;specifies which drive to create
  467.                                           ;all temporary files on(-,+ are
  468.                                           ; ignored but one must be there).
  469.                                           ;ONLY active on command line!
  470.  
  471. <available option> -> 'p'<drive>          ;specifies which drive to create
  472.                                           ;the listing file on(-,+ are
  473.                                           ; ignored but one must be there).
  474.                                           ;ONLY active on command line!
  475.  
  476. <drive> -> <drive name>':'                ;e.g.  a:  b:  c:  d:
  477.  
  478.                            ;MS-DOS
  479. <drive name> -> 'a'        ;drive a --usually a floppy disk
  480. <drive name> -> 'b'        ;drive b --usually a second floppy disk
  481. <drive name> -> 'c'        ;drive c --usually a hard disk, but may
  482.                                       be a ram disk.
  483. <drive name> -> 'd'        ;drive d --usually a ram disk, but may
  484.                                       be a hard disk.
  485.  
  486. ** The default options are: -a2 -m1 -w132 -h66 +l +s +o
  487.  
  488.  
  489.  
  490.  
  491.  
  492.  
  493.  
  494. 2. .org   <integer expression>    ;sets the assembler location counter
  495.                                   ;to the value of expression.
  496.                                   ;The expression MUST be evaluatable
  497.                                   ;on the first pass. NO FORWARD
  498.                                   ;REFERENCES!
  499.  
  500. 3. .equ  <identifier> ',' <integer expression>
  501.                                   ;gives identifier the value of the
  502.                                   ;integer expression.
  503.                                   ;<identifier> canNOT be redefined!
  504.                                   ;also forward references are allowed
  505.                                   ;as long as they are resolved by the
  506.                                   ;second pass.
  507.  
  508. 4. .set  <identifier> ',' <integer expression>
  509.                                   ;gives identifier the value of the
  510.                                   ;integer expression.
  511.                                   ;<identifier> CAN be redefined later
  512.                                   ; in the program!
  513.                                   ;also forward references are allowed
  514.                                   ;as long as they are resolved by the
  515.                                   ;second pass.
  516.  
  517. 5. .rs  <integer expression>      ;increments the location counter
  518.                                   ;by the value of <integer expresson>
  519.                                   ;effectively reserving that many bytes
  520.                                   ;of memory.
  521.  
  522. 6. .db  <expression-string list>
  523.  
  524. <expression-string list> -> <expression>','<expression-string list>
  525. <expression-string list> -> <string>','<expression-string list>
  526. <expression-string list> -> <expression>
  527. <expression-string list> -> <string>
  528.  
  529.                                   ;creates a byte in the machine code
  530.                                   ;for each <expression> in the list
  531.                                   ;and a byte for each ascii character
  532.                                   ;in the a string.
  533. 7. .dw  <expression list>
  534.  
  535. <expression list> -> <expression>','<expression list>
  536. <expression list> -> <expression>
  537.  
  538.                                   ;creates a word(16 bit) in the machine code
  539.                                   ;for each <expression> in the list.
  540.                                   ;MOST significant byte is stored at LOWER
  541.                                   ;address.
  542.  
  543.  
  544.  
  545.  
  546.  
  547.  
  548. 8. .drw  <expression list>
  549.  
  550. <expression list> -> <expression>','<expression list>
  551. <expression list> -> <expression>
  552.  
  553.                                   ;creates a word(16 bit) in the machine code
  554.                                   ;for each <expression> in the list.
  555.                                   ;LEAST significant byte is stored at LOWER
  556.                                   ;address.
  557.  
  558. 9. .eject                         ;causes a form-feed character to be
  559.                                   ;inserted in listing.(new listing page)
  560.  
  561. 10. .page                         ;increments location counter to next
  562.                                   ;256 byte page boundary.
  563.  
  564. 11. .end <integer expression>     ;signals the end of the source program.
  565.                                   ;the optional expression, if supplied,
  566.                                   ;specifies the start address of the
  567.                                   ;program, and is included in the
  568.                                   ;Motorola Hex object module output
  569.                                   ;of the active segment when the .end
  570.                                   ;was encountered.
  571.  
  572.  
  573. 12. .opdef  <identifier>,<identifier>
  574.                                   ;assigns the current definition of
  575.                                   ;the second <identifier> to the
  576.                                   ;first <identifier>.
  577.                                   ;useful for renaming opcodes and
  578.                                   ;pseudo-ops.
  579.  
  580. 13. .segment <identifier> ',' <integer expression>
  581.                                   ;defines a memory segment name.
  582.                                   ;used to separate memory allocation
  583.                                   ;and optionally generate seperate
  584.                                   ;object files.(see 'o' assembly
  585.                                   ;directive to activate).
  586.                                   ;(used to seperate RAM, ROM, or
  587.                                   ; ROMS)
  588.                                   ;the optional <integer expression> is
  589.                                   ;added to the location counter to
  590.                                   ;offset the load address supplied
  591.                                   ;in the object module. (does not
  592.                                   ;affect listings addresses!)
  593.                                   ;
  594.                                   ;note: .code is the predefined default
  595.                                   ;segment and cannot be redefined.
  596.  
  597. 14. <segment name>                ;selects the segment <segment name>
  598.                                   ;as the current memory segment.
  599.                                   ;The location old segment location counter
  600.                                   ;is saved and the previous value of the
  601.                                   ;newly selected segments location counter
  602.                                   ;is used(0 if not previously used).
  603.  
  604. 15.  .null                        ;directs the assembler to treat this
  605.                                   ;statement as a comment.  Useful to
  606.                                   ;nullify opcodes when used in conjunction
  607.                                   ;with the .opdef pseudo-op.
  608.  
  609.  
  610.  
  611.  
  612.  
  613.  
  614.  
  615. Appendix   A      ASCII character set
  616.  
  617.  
  618.  
  619. dec oct hex char     dec oct hex char  dec oct hex char  dec oct hex char
  620.  
  621.   0 000  00 ^@ null   32 040  20 sp     64 100  40 @      96 140  60 `
  622.   1 001  01 ^A soh    33 041  21 !      65 101  41 A      97 141  61 a
  623.   2 002  02 ^B stx    34 042  22 "      66 102  42 B      98 142  62 b
  624.   3 003  03 ^C etx    35 043  23 #      67 103  43 C      99 143  63 c
  625.   4 004  04 ^D eot    36 044  24 $      68 104  44 D     100 144  64 d
  626.   5 005  05 ^E enq    37 045  25 %      69 105  45 E     101 145  65 e
  627.   6 006  06 ^F ack    38 046  26 &      70 106  46 F     102 146  66 f
  628.   7 007  07 ^G bel    39 047  27 '      71 107  47 G     103 147  67 g
  629.   8 010  08 ^H bs     40 050  28 (      72 110  48 H     104 150  68 h
  630.   9 011  09 ^I ht     41 051  29 )      73 111  49 I     105 151  69 i
  631.  10 012  0A ^J lf     42 052  2A *      74 112  4A J     106 152  6A j
  632.  11 013  0B ^K vt     43 053  2B +      75 113  4B K     107 153  6B k
  633.  12 014  0C ^L ff     44 054  2C ,      76 114  4C L     108 154  6C l
  634.  13 015  0D ^M cr     45 055  2D -      77 115  4D M     109 155  6D m
  635.  14 016  0E ^N so     46 056  2E .      78 116  4E N     110 156  6E n
  636.  15 017  0F ^O si     47 057  2F /      79 117  4F O     111 157  6F o
  637.  16 020  10 ^P dle    48 060  30 0      80 120  50 P     112 160  70 p
  638.  17 021  11 ^Q dc1    49 061  31 1      81 121  51 Q     113 161  71 q
  639.  18 022  12 ^R dc2    50 062  32 2      82 122  52 R     114 162  72 r
  640.  19 023  13 ^S dc3    51 063  33 3      83 123  53 S     115 163  73 s
  641.  20 024  14 ^T dc4    52 064  34 4      84 124  54 T     116 164  74 t
  642.  21 025  15 ^U nak    53 065  35 5      85 125  55 U     117 165  75 u
  643.  22 026  16 ^V syn    54 066  36 6      86 126  56 V     118 166  76 v
  644.  23 027  17 ^W etb    55 067  37 7      87 127  57 W     119 167  77 w
  645.  24 030  18 ^X can    56 070  38 8      88 130  58 X     120 170  78 x
  646.  25 031  19 ^Y em     57 071  39 9      89 131  59 Y     121 171  79 y
  647.  26 032  1A ^Z sub    58 072  3A :      90 132  5A Z     122 172  7A z
  648.  27 033  1B ^[ esc    59 073  3B ;      91 133  5B [     123 173  7B {
  649.  28 034  1C ^\ fs     60 074  3C <      92 134  5C \     124 174  7C |
  650.  29 035  1D ^] gs     61 075  3D =      93 135  5D ]     125 175  7D }
  651.  30 036  1E ^^ rs     62 076  3E >      94 136  5E ^     126 176  7E ~
  652.  31 037  1F ^_ us     63 077  3F ?      95 137  5F _     127 176  7F del
  653.  
  654.  ^ denotes control key simultaneous with character key.
  655.  
  656.  
  657.  
  658.  
  659.  
  660.  
  661.  
  662.  
  663. Appendix B       Copyright Information:
  664.  
  665.  
  666. Disclaimer:
  667.  
  668.             PseudoSam 69 is distributed as is, with no guarantee that it
  669.             will work correctly in all situations.  In no event will the
  670.             Author be liable for any damages, including lost profits,
  671.             lost savings or other incidental or consequential damages
  672.             arising out of the use of or inability to use these
  673.             programs, even if the Author has been advised of the
  674.             possibility of such damages, or for any claim by any other
  675.             party.
  676.  
  677. Copyright Information:
  678.  
  679.             The entire PseudoSam 69 distribution package, consisting of
  680.             the main program, documentation files, and various data and
  681.             utility files, is copyright (c) 1986, by PseudoCode.
  682.  
  683.             The author reserves the exclusive right to distribute this
  684.             package, or any part thereof, for profit.
  685.  
  686.             The name "PseudoSam (tm)", applied to an assembler
  687.             program, is a trade mark of the PseudoCode company.
  688.  
  689.             PseudoSam version 1.x.xx and various subsidiary files may be
  690.             copied freely by individuals for non-commercial purposes. It
  691.             is expected that those who find the package useful will
  692.             purchase the update service.
  693.             ONLY UNMODIFIED VERSIONS DISPLAYING THE AUTHORS COPYRIGHT
  694.             MAY BE COPIED.
  695.  
  696.             User groups and clubs are authorized to distribute PseudoSam
  697.             software under the following conditions:
  698.  
  699.             1.  No charge is made for the software or documentation.  A
  700.                 nominal distribution fee may be charged, provided that
  701.                 it is no more than $5 total.
  702.  
  703.             2.  Recipients are to be informed of the user-supported
  704.                 software concept, and encouraged to support it with
  705.                 their donations.
  706.  
  707.             3.  The program and documentation are not modified in ANY
  708.                 way, and are distributed together.
  709.  
  710.  
  711.  
  712.  
  713.  
  714.  
  715.             Interested manufacturers please see the commercial registration
  716.             form that follows to license PseudoSam 18 for bundling with
  717.             MS-DOS based development systems.
  718.  
  719.             Distribution of PseudoSam 69 outside the United States is through
  720.             licensed distributors, on a royalty basis.  Interested
  721.             distributors are invited to contact PseudoCode.
  722.  
  723.  
  724.  
  725. Educational Use:
  726.  
  727.             Educational institutions are free to use this software
  728.             in their classes and are encouraged to distribute this
  729.             package to their students, however inorder to receive
  730.             periodic updates and technical assistance the appropriate
  731.             department must remit the license fee.  Also a staff
  732.             member must be assigned to clear all trouble reports before
  733.             forwarding them to PseudoCode.
  734.  
  735.  
  736.  
  737.  
  738.  
  739.  
  740.  
  741.  
  742.         If you use this software, please help support it.  Your
  743.         support can take three forms:
  744.  
  745.         1. Become a registered user.  The suggested payment for
  746.            registration is $30($100 for complete family).
  747.  
  748.         2. Suggestions, comments, and bug reports.
  749.  
  750.         3. Spread the word.  Make copies for friends.  Write the editor
  751.            of your favorite computer magazine.  Astronomical advertising
  752.            costs are one big reason that commercial software is so over-
  753.            priced.  To continue offering PseudoSam 69 this way, we need
  754.            your help in letting other people know about PseudoSam 69.
  755.  
  756.         Those who make the $30 payment to become registered users
  757.         receive the following benefits:(order form on next page)
  758.  
  759.         1. One year of updates including any upgrades. This includes
  760.            at least one new version release even if it takes more than
  761.            one year.
  762.  
  763.         2. User support by mail.  Support is only available to registered
  764.            users.  The address for help is given below.
  765.  
  766.         3. Notices announcing the release of new products.
  767.  
  768.  
  769.  
  770.  
  771.  
  772.  
  773.  
  774.  
  775.  
  776.              Attention:BUGS             PseudoCode
  777.                                         P.O. Box 1423
  778.                                         Newport News, VA     23601
  779.  
  780.  
  781.  
  782.  
  783.  
  784.       ********ORDER FORM********
  785.  
  786.       Please add me to the list of registered PseudoSam 69 users, and send me
  787.       the most recent version. I understand that registration entitles me to
  788.       one year of free updates and new releases, or one free new version
  789.       release, whichever occurs last.
  790.  
  791.       Note that version 1.2.02 requires DOS 2 (or later) and 256K.
  792.  
  793.       Computer Model: ____________________________________
  794.  
  795.       Diskette format:            Total Memory: _______K
  796.                                      (256K required)
  797.          __ doubled sided/DOS 2
  798.  
  799.       Check one:
  800.              ___ I enclose a check for $30
  801.              (PseudoCode pays sales tax for VA orders)
  802.  
  803.       Where did you hear about PseudoSam 69? ________________________________
  804.  
  805.       Name:    _______________________________________________________
  806.  
  807.       Address: _______________________________________________________
  808.  
  809.       City, State, Zip: ______________________________________________
  810.  
  811.       ================================================================
  812.  
  813.            Send order form with check or money order payable to PseudoCode to:
  814.            (Qualified PO's will be billed.)
  815.  
  816.            Attention: Registration         PseudoCode
  817.                                            P.O. Box 1423
  818.                                            Newport News, VA     23601
  819.  
  820.  
  821.  
  822.  
  823.  
  824.  
  825.       ********ORDER FORM********
  826.  
  827.       Please add me to the list of registered users of the complete
  828.       PseudoSam family of cross-assemblers. Send me the most recent
  829.       versions.  I understand that registration entitles me to
  830.       one year of free updates and new releases, or one free new
  831.       version release, whichever occurs last.
  832.  
  833.  
  834.       I note that version 1.2.02 requires DOS 2 (or later) and 256K.
  835.  
  836.       Computer Model: ____________________________________
  837.  
  838.       Diskette format:            Total Memory: _______K
  839.                                      (256K required)
  840.          __ single sided/DOS 2(360k)
  841.  
  842.       Check one:
  843.              ___ I enclose a check or money order for $100
  844.                  (shipping, handling, and Virginia sales tax for VA orders
  845.                   is paid by PseudoCode).
  846.  
  847.       Where did you hear about the PseudoSam family? ________________________
  848.  
  849.       Name:    _______________________________________________________
  850.  
  851.       Address: _______________________________________________________
  852.  
  853.       City, State, Zip: ______________________________________________
  854.  
  855.       ================================================================
  856.  
  857.            Send order form with check or money order payable to PseudoCode to:
  858.            (Qualified PO's will be billed.)
  859.  
  860.            Attention: Registration         PseudoCode
  861.                                            P.O. Box 1423
  862.                                            Newport News, VA     23601
  863.  
  864.  
  865.  
  866.  
  867.       ********Commercial Distribution Agreement********
  868.  
  869.       Please add me to the list of registered PseudoSam 69 distributors, and
  870.       send me the most recent version. I understand that registration entitles
  871.       me to distribute this package freely on an "as is" basis to purchasers
  872.       of my products. I further understand that I may not make a specific or
  873.       additional charge for this package. I may however advertise the package
  874.       as free software. I fully understand that the distributed software
  875.       must be clearly labeled as follows:
  876.  
  877.       Complementary Software
  878.       Distributed "AS IS"
  879.       PseudoCode
  880.       P.O. Box 1423
  881.       Newport News, VA 23601
  882.  
  883.  
  884.  
  885.       I understand that this agreement entitles me to one year of distribution
  886.       rights and free updates.
  887.  
  888.       Note that version 1.2.02 requires DOS 2 (or later) and 256K.
  889.  
  890.       Computer Model: ____________________________________
  891.  
  892.       Diskette format:            Total Memory: _______K
  893.                                      (256K required)
  894.          __ doubled sided/DOS 2
  895.  
  896.       Check one:
  897.              ___ I enclose a check for $30
  898.              (PseudoCode pays sales tax for VA orders)
  899.  
  900.       Where did you hear about PseudoSam 69? ________________________________
  901.  
  902.       Name:    _______________________________________________________
  903.  
  904.       Address: _______________________________________________________
  905.  
  906.       City, State, Zip: ______________________________________________
  907.  
  908.       Signature_______________________   Date_________________
  909.  
  910.       ================================================================
  911.  
  912.            Send order form with check or money order payable to PseudoCode to:
  913.            (Qualified PO's will be billed.)
  914.  
  915.            Attention: Registration         PseudoCode
  916.                                            P.O. Box 1423
  917.                                            Newport News, VA     23601
  918.  
  919.  
  920.  
  921.  
  922.  
  923.  
  924.       ********Commercial Distribution Agreement********
  925.  
  926.  
  927.       Please add me to the list of registered PseudoSam distributors, and
  928.       send me the most recent version. I understand that registration entitles
  929.       me to distribute this package freely on an "as is" basis to purchasers
  930.       of my products. I further understand that I may not make a specific or
  931.       additional charge for this package. I may however advertise the package
  932.       as free software. I fully understand that the distributed software
  933.       must be clearly labeled as follows:
  934.  
  935.       Complementary Software
  936.       Distributed "AS IS"
  937.       PseudoCode
  938.       P.O. Box 1423
  939.       Newport News, VA 23601
  940.  
  941.  
  942.  
  943.       I understand that this agreement entitles me to one year of distribution
  944.       rights and free updates for the entire PseudoSam family of products.
  945.  
  946.  
  947.       I note that version 1.2.02 requires DOS 2 (or later) and 256K.
  948.  
  949.       Computer Model: ____________________________________
  950.  
  951.       Diskette format:            Total Memory: _______K
  952.                                      (256K required)
  953.          __ single sided/DOS 2(360k)
  954.  
  955.       Check one:
  956.              ___ I enclose a check or money order for $100
  957.                  (shipping, handling, and Virginia sales tax for VA orders
  958.                   is paid by PseudoCode).
  959.  
  960.       Where did you hear about the PseudoSam family? ________________________
  961.  
  962.       Name:    _______________________________________________________
  963.  
  964.       Address: _______________________________________________________
  965.  
  966.       City, State, Zip: ______________________________________________
  967.  
  968.       Signature_______________________   Date_________________
  969.  
  970.       ================================================================
  971.  
  972.            Send order form with check or money order payable to PseudoCode to:
  973.            (Qualified PO's will be billed.)
  974.  
  975.            Attention: Registration         PseudoCode
  976.                                            P.O. Box 1423
  977.                                            Newport News, VA     23601
  978.  
  979.  
  980.  
  981.  
  982.  
  983.  
  984.  
  985.       The PsuedoSam Family consists of the following cross-assemblers
  986.  
  987.        Name            Designed for         Available*   V1.1.00
  988.  
  989.        PseudoSam 48   ;Intel 8048 family.     Now
  990.        PseudoSam 51   ;Intel 8051 family.     Now
  991.        PsuedoSam 96   ;Intel 8096 family.     Now
  992.        PseudoSam 68   ;Motorola
  993.                       ;6800,01,02,03,08.      Now
  994.        PseudoSam 685  ;Motorola 6805.         Now
  995.        PsuedoSam 69   ;Motorola 6809.         Now
  996.        PseudoSam 65   ;6502.                  Now
  997.        PseudoSam 85   ;Intel 8080,8085.       Now
  998.        PseudoSam 80z  ;Zilog Z80, NSC800.     Now
  999.        PseudoSam 18   ;RCA 1802.              Now
  1000.        PseudoSam 32   ;NSC 32000 Family.      Apr 87
  1001.        PseudoSam 68k  ;Motorola 68000 family. May 87
  1002.  
  1003.    * PseudoCode reserves the right to change price and availability
  1004.      of any product without notice.
  1005.  
  1006.  
  1007.  
  1008.  
  1009.  
  1010.  
  1011.  
  1012.  
  1013.  
  1014. Appendix C: Description of Files
  1015.  
  1016.       Your PseudoSam 69 distribution disk contains a number of files.  This
  1017.       appendix will give a brief statement of the purpose of each of the
  1018.       files.
  1019.  
  1020.       FILE           DESCRIPTION
  1021.       ----------------------------------------------------------------
  1022.       A69.COM         The PseudoSam 69 program.
  1023.       A69.DOC         This document.
  1024.       EXAMPLE.ASM     Sample source file.
  1025.       MNEMTEST.ASM    Mnemnonics test file.
  1026.       SYN.ASM         Useful mnemnonics redefinitions
  1027.       COMRCIAL.USE    Commercial distribution agreement.
  1028.  
  1029.       Occasionally, various other sample source files for PseudoSam 69 will be
  1030.       distributed.  These files will have extension ASM, and will be
  1031.       accompanied by a corresponding DOC file.
  1032.  
  1033.  
  1034.  
  1035.  
  1036.  
  1037.  
  1038.  
  1039.  
  1040.  
  1041. Appendix D: Bug Reporting Procedure.
  1042.  
  1043.  
  1044.       Although each version of PseudoSam 69 is tested extensively prior
  1045.       to release, any program is bound to contain a few bugs.  It is
  1046.       the intention of PseudoCode to correct any genuine problem that
  1047.       is reported.
  1048.  
  1049.       If you think you have found a bug in PseudoSam 69, please take the time
  1050.       to report it for correction.  Although any report is helpful,
  1051.       correction of the problem will be easiest if you provide the
  1052.       following:
  1053.  
  1054.          1. The version of PseudoSam 69 you are using.  Your problem may have
  1055.             been fixed already.
  1056.  
  1057.          2. A brief description of the problem.
  1058.  
  1059.          3. A copy of the problem source file, preferably on a floppy disk.
  1060.             (The cost of floppies is so small($.29), they will not be
  1061.              returned and become the property of PseudoCode.)
  1062.  
  1063.             * It is NOT necessary to send a large program to demonstrate
  1064.               problem.  Please try to isolate the problem area, by
  1065.               writing a short sample program that demonstrates the bug.
  1066.  
  1067.  
  1068.  
  1069.  
  1070.  
  1071.  
  1072.              Attention:BUGS             PseudoCode
  1073.                                         P.O. Box 1423
  1074.                                         Newport News, VA     23601
  1075.  
  1076.  
  1077.  
  1078.  
  1079.  
  1080.  
  1081.  
  1082.       Appendix E   Using PseudoSam 69 on "Compatible" Systems.
  1083.  
  1084.       PseudoSam 69 was written specifically for the IBM PC, but should
  1085.       function normally on true "compatibles".
  1086.  
  1087.       Since PseudoSam 69 version 1.2.00 is a totally new program, little
  1088.       compatibility data is currently available.  If you are using (or
  1089.       are unable to use...) PseudoSam 69 on a non-IBM computer, please
  1090.       write with your experiences.  Does PseudoSam 69 work correctly on
  1091.       your system?  Are there specific problem areas?  Can they be worked
  1092.       around?
  1093.  
  1094.       The following systems are known to run PseudoSam 69 version 1.2.00
  1095.       successfully:
  1096.              IBM PC
  1097.              IBM XT
  1098.              IBM AT
  1099.              Sperry PC (all models).
  1100.              JDR Microdevices PC Clones.
  1101.  
  1102.