home *** CD-ROM | disk | FTP | other *** search
/ ftp.barnyard.co.uk / 2015.02.ftp.barnyard.co.uk.tar / ftp.barnyard.co.uk / cpm / walnut-creek-CDROM / ENTERPRS / CPM / UTILS / A / ASMTUTOR.TZT / ASMTUTOR.TXT
Text File  |  2000-06-30  |  73KB  |  1,620 lines

  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.                     IBM Personal Computer Assembly
  8.                          Language Tutorial
  9.  
  10.  
  11.  
  12.                           Joshua Auerbach
  13.                           Yale University
  14.                         Yale Computer Center
  15.                          175 Whitney Avenue
  16.                            P. O. Box 2112
  17.                      New Haven, Connecticut 06520
  18.  
  19.                          Installation Code YU
  20.  
  21.                  Integrated Personal Computers Project
  22.                         Communications Group
  23.                  Communications and Data Base Division
  24.  
  25.                             Session C316
  26.  
  27.  
  28.  
  29.  
  30. This talk is for people who are just getting started with the PC MACRO
  31. Assembler.  Maybe you are just contemplating doing some coding in
  32. assembler, maybe you have tried it with mixed success.  If you are here to
  33. get aimed in the right direction, to get off to a good start with the
  34. assembler, then you have come for the right reason.  I can't promise you'll
  35. get what you want, but I'll do my best.
  36.  
  37. On the other hand, if you have already turned out some working assembler
  38. code, then this talk is likely to be on the elementary side for you.  If
  39. you want to review a few basics and have no where else pressing to go, then
  40. by all means stay.
  41.  
  42.  
  43.  
  44. Why Learn Assembler?____________________Why Learn Assembler?Why Learn Assembler?Why Learn Assembler?
  45.  
  46.  
  47. The reasons for LEARNING assembler are not the same as the reasons for
  48. USING it in a particular application.  But, we have to start with some of
  49. the reasons for using it and then I think the reasons for learning it will
  50. become clear.
  51.  
  52. First, let's dispose of a bad reason for using it.  Don't use it just
  53. because you think it is going to execute faster.  A particular sequence of
  54. ordinary bread-and-butter computations written in PASCAL, C, FORTRAN, or
  55. compiled BASIC can do the job just about as fast as the same algorithm
  56. coded in assembler.  Of course, interpretive BASIC is slower, but if you
  57. have a BASIC application which runs too slow you probably want to try com-
  58.  
  59.  
  60. IBM PC Assembly Language Tutorial                                         1
  61.  
  62.  
  63. piling it before you think too much about translating parts of it to
  64. another language.
  65.  
  66. On the other hand, high level languages do tend to isolate you from the
  67. machine.  That is both their strength and their weakness.  Usually, when
  68. implemented on a micro, a high level language provides an escape mechanism
  69. to the underlying operating system or to the bare machine.  So, for
  70. example, BASIC has its PEEK and POKE.  But, the route to the bare machine
  71. is often a circuitous one, leading to tricky programming which is hard to
  72. follow.
  73.  
  74. For those of us working on PC's connected to SHARE-class mainframes, we are
  75. generally concerned with three interfaces:  the keyboard, the screen, and
  76. the communication line or lines.  All three of these entities raise machine
  77. dependent issues which are imperfectly addressed by the underlying operat-
  78. ing system or by high level languages.
  79.  
  80. Sometimes, the system or the language does too little for you.  For
  81. example, with the asynch adapter, the system provides no interrupt handler,
  82. no buffer, and no flow control.  The application is stuck with the respon-
  83. sibility for monitoring that port and not missing any characters, then
  84. deciding what to do with all errors.  BASIC does a reasonable job on some
  85. of this, but that is only BASIC.  Most other languages do less.
  86.  
  87. Sometimes, the system may do too much for you.  System support for the key-
  88. board is an example.  At the hardware level, all 83 keys on the keyboard
  89. send unique codes when they are pressed, held down, and released.  But,
  90. someone has decided that certain keys, like Num Lock and Scroll Lock are
  91. going to do certain things before the application even sees them and can't
  92. therefore be used as ordinary keys.
  93.  
  94. Sometimes, the system does about the right amount of stuff but does it less
  95. efficiently then it should.  System support for the screen is in this
  96. class.  If you use only the official interface to the screen you sometimes
  97. slow your application down unacceptably.  I said before, don't use assem-
  98. bler just to speed things up, but there I was talking about mainline code,
  99. which generally can't be speeded up much by assembler coding.  A critical
  100. system interface is a different matter:  sometimes we may have to use
  101. assembler to bypass a hopelessly inefficient implementation.  We don't want
  102. to do this if we can avoid it, but sometimes we can't.
  103.  
  104. Assembly language code can overcome these deficiencies.  In some cases, you
  105. can also overcome these deficiencies by judicious use of the escape valves
  106. which your high level language provides.  In BASIC, you can PEEK and POKE
  107. and INP and OUT your way around a great many issues.  In many other lan-
  108. guages you can issue system calls and interrupts and usually manage, one
  109. way or other, to modify system memory.  Writing handlers to take real-time
  110. hardware interrupts from the keyboard or asynch port, though, is still
  111. going to be a problem in most languages.  Some languages claim to let you
  112. do it but I have yet to see an acceptably clean implementation done that
  113. way.
  114.  
  115. The real reason while assembler is better than "tricky POKEs" for writing
  116. machine-dependent code, though, is the same reason why PASCAL is better
  117. than assembler for writing a payroll package:  it is easier to maintain.
  118.  
  119.  
  120. IBM PC Assembly Language Tutorial                                         2
  121.  
  122.  
  123. Let the high level language do what it does best, but recognize that there
  124. are some things which are best done in assembler code.  The assembler,
  125. unlike the tricky POKE, can make judicious use of equates, macros, labels,
  126. and appropriately placed comments to show what is really going on in this
  127. machine-dependent realm where it thrives.
  128.  
  129. So, there are times when it becomes appropriate to write in assembler; giv-
  130. en that, if you are a responsible programmer or manager, you will want to
  131. be "assembler-literate" so you can decide when assembler code should be
  132. written.
  133.  
  134. What do I mean by "assembler-literate?"  I don't just mean understanding
  135. the 8086 architecture; I think, even if you don't write much assembler code
  136. yourself, you ought to understand the actual process of turning out assem-
  137. bler code and the various ways to incorporate it into an application.  You
  138. ought to be able to tell good assembler code from bad, and appropriate
  139. assembler code from inappropriate.
  140.  
  141.  
  142.  
  143. Steps to becoming ASSEMBLER-LITERATE____________________________________Steps to becoming ASSEMBLER-LITERATESteps to becoming ASSEMBLER-LITERATESteps to becoming ASSEMBLER-LITERATE
  144.  
  145.  
  146. 1.  Learn the 8086 architecture and most of the instruction set.  Learn
  147.     what you need to know and ignore what you don't.  Reading:  The 8086
  148.     Primer by Stephen Morse, published by Hayden.  You need to read only
  149.     two chapters, the one on machine organization and the one on the
  150.     instruction set.
  151.  
  152. 2.  Learn about a few simple DOS function calls.  Know what services the
  153.     operating system provides.  If appropriate, learn a little about other
  154.     systems too.  It will aid portability later on.  Reading:  appendices D
  155.     and E of the PC DOS manual.
  156.  
  157. 3.  Learn enough about the MACRO assembler and the LINKer to write some
  158.     simple things that really work.  Here, too, the main thing is figuring
  159.     out what you don't need to know.  Whatever you do, don't study the sam-
  160.     ple programs distributed with the assembler unless you have nothing
  161.     better!
  162.  
  163. 4.  At the same time as you are learning the assembler itself, you will
  164.     need to learn a few tools and concepts to properly combine your assem-
  165.     bler code with the other things you do.  If you plan to call assembler
  166.     subroutines from a high level language, you will need to study the
  167.     interface notes provided in your language manual.  Usually, this forms
  168.     an appendix of some sort.  If you plan to package your assembler rou-
  169.     tines as .COM programs you will need to learn to do this.  You should
  170.     also learn to use DEBUG.
  171.  
  172. 5.  Read the Technical Reference, but very selectively.  The most important
  173.     things to know are the header comments in the BIOS listing.  Next, you
  174.     will want to learn about the RS 232 port and maybe about the video
  175.     adapters.
  176.  
  177.  
  178.  
  179.  
  180. IBM PC Assembly Language Tutorial                                         3
  181.  
  182.  
  183. Notice that the key thing in all five phases is being selective.  It is
  184. easy to conclude that there is too much to learn unless you can throw away
  185. what you don't need.  Most of the rest of this talk is going to deal with
  186. this very important question of what you need and don't need to learn in
  187. each phase.  In some cases, I will have to leave you to do almost all of
  188. the learning, in others, I will teach a few salient points, enough, I hope,
  189. to get you started.  I hope you understand that all I can do in an hour is
  190. get you started on the way.
  191.  
  192.  
  193.  
  194. Phase 1:  Learn the architecture and instruction set____________________________________________________Phase 1:  Learn the architecture and instruction setPhase 1:  Learn the architecture and instruction setPhase 1:  Learn the architecture and instruction set
  195.  
  196.  
  197. The Morse book might seem like a lot of book to buy for just two really
  198. important chapters; other books devote a lot more space to the instruction
  199. set and give you a big beautiful reference page on each instruction.  And,
  200. some of the other things in the Morse book, although interesting, really
  201. aren't very vital and are covered too sketchily to be of any real help.
  202. The reason I like the Morse book is that you can just read it; it has a
  203. very conversational style, it is very lucid, it tells you what you really
  204. need to know, and a little bit more which is by way of background; because
  205. nothing really gets belabored to much, you can gracefully forget the things
  206. you don't use.  And, I very much recommend READING Morse rather than study-
  207. ing it.  Get the big picture at this point.
  208.  
  209. Now, you want to concentrate on those things which are worth fixing in mem-
  210. ory.  After you read Morse, you should relate what you have learned to this
  211. outline.
  212.  
  213. 1.  You want to fix in your mind the idea of the four segment registers
  214.     CODE, DATA, STACK, and EXTRA.  This part is pretty easy to grasp.  The
  215.     8086 and the 8088 use 20 bit addresses for memory, meaning that they
  216.     can address up to 1 megabyte of memory.  But, the registers and the
  217.     address fields in all the instructions are no more that 16 bits long.
  218.     So, how to address all of that memory?  Their solution is to put
  219.     together two 16 bit quantities like this:
  220.  
  221.       calculation  SSSS0   ---- value in the relevant segment register SHL 4
  222.       depicted in   AAAA   ---- apparent address from register or instruction
  223.       hexadecimal --------
  224.                    RRRRR   ---- real address placed on address bus
  225.  
  226.     In other words, any time memory is accessed, your program will supply a
  227.     sixteen bit address.  Another sixteen bit address is acquired from a
  228.     segment register, left shifted four bits (one nibble) and added to it
  229.     to form the real address.  You can control the values in the segment
  230.     registers and thus access any part of memory you want.  But the segment
  231.     registers are specialized:  one for code, one for most data accesses,
  232.     one for the stack (which we'll mention again) and one "extra" one for
  233.     additional data accesses.
  234.  
  235.     Most people, when they first learn about this addressing scheme become
  236.     obsessed with converting everything to real 20 bit addresses.  After a
  237.     while, though, you get use to thinking in segment/offset form.  You
  238.  
  239.  
  240. IBM PC Assembly Language Tutorial                                         4
  241.  
  242.  
  243.     tend to get your segment registers set up at the beginning of the pro-
  244.     gram, change them as little as possible, and think just in terms of
  245.     symbolic locations in your program, as with any assembly language.
  246.  
  247.       EXAMPLE:
  248.            MOV  AX,DATASEG
  249.            MOV  DS,AX          ;Set value of Data segment
  250.            ASSUME DS:DATASEG   ;Tell assembler DS is usable
  251.            .......
  252.            MOV  AX,PLACE       ;Access storage symbolically by 16 bit address
  253.  
  254.     In the above example, the assembler knows that no special issues are
  255.     involved because the machine generally uses the DS register to complete
  256.     a normal data reference.
  257.  
  258.     If you had used ES instead of DS in the above example, the assembler
  259.     would have known what to do, also.  In front of the MOV instruction
  260.     which accessed the location PLACE, it would have placed the ES segment
  261.     prefix.  This would tell the machine that ES should be used, instead of
  262.     DS, to complete the address.
  263.  
  264.     Some conventions make it especially easy to forget about segment regis-
  265.     ters.  For example, any program of the COM type gets control with all
  266.     four segment registers containing the same value.  This program exe-
  267.     cutes in a simplified 64K address space.  You can go outside this
  268.     address space if you want but you don't have to.
  269.  
  270. 2.  You will want to learn what other registers are available and learn
  271.     their personalities:
  272.  
  273.        AX and DX are general purpose registers.  They become special only
  274.         when accessing machine and system interfaces.
  275.  
  276.        CX is a general purpose register which is slightly specialized for
  277.         counting.
  278.  
  279.        BX is a general purpose register which is slightly specialized for
  280.         forming base-displacement addresses.
  281.  
  282.        AX-DX can be divided in half, forming AH, AL, BH, BL, CH, CL, DH,
  283.         DL.
  284.  
  285.        SI and DI are strictly 16 bit.  They can be used to form indexed
  286.         addresses (like BX) and they are also used to point to strings.
  287.  
  288.        SP is hardly ever manipulated.  It is there to provide a stack.
  289.  
  290.        BP is a manipulable cousin to SP.  Use it to access data which has
  291.         been pushed onto the stack.
  292.  
  293.        Most sixteen bit operations are legal (even if unusual) when per-
  294.         formed in SI, DI, SP, or BP.
  295.  
  296.  
  297.  
  298.  
  299.  
  300. IBM PC Assembly Language Tutorial                                         5
  301.  
  302.  
  303. 3.  You will want to learn the classifications of operations available
  304.     WITHOUT getting hung up in the details of how 8086 opcodes are con-
  305.     structed.
  306.  
  307.     8086 opcodes are complex.  Fortunately, the assembler opcodes used to
  308.     assemble them are simple.  When you read a book like Morse, you will
  309.     learn some things which are worth knowing but NOT worth dwelling on.
  310.  
  311.     a.  8086 and 8088 instructions can be broken up into subfields and bits
  312.         with names like R/M, MOD, S and W. These parts of the instruction
  313.         modify the basic operation in such ways as whether it is 8 bit or
  314.         16 bit, if 16 bit, whether all 16 bits of the data are given,
  315.         whether the instruction is register to register, register to
  316.         memory, or memory to register, for operands which are registers,
  317.         which register, for operands which are memory, what base and index
  318.         registers should be used in finding the data.
  319.  
  320.     b.  Also, some instructions are actually represented by several differ-
  321.         ent machine opcodes depending on whether they deal with immediate
  322.         data or not, or on other issues, and there are some expedited forms
  323.         which assume that one of the arguments is the most commonly used
  324.         operand, like AX in the case of arithmetic.
  325.  
  326.     There is no point in memorizing any of this detail; just distill the
  327.     bottom line, which is, what kinds of operand combinations EXIST in the
  328.     instruction set and what kinds don't.  If you ask the assembler to ADD
  329.     two things and the two things are things for which there is a legal ADD
  330.     instruction somewhere in the instruction set, the assembler will find
  331.     the right instruction and fill in all the modifier fields for you.
  332.  
  333.     I guess if you memorized all the opcode construction rules you might
  334.     have a crack at being able to disassemble hex dumps by eye, like you
  335.     may have learned to do somewhat with 370 assembler.  I submit to you
  336.     that this feat, if ever mastered by anyone, would be in the same class
  337.     as playing the "Minute Waltz" in a minute; a curiosity only.
  338.  
  339.     Here is the basic matrix you should remember:
  340.  
  341.  
  342.  
  343.  
  344.  
  345.  
  346.  
  347.  
  348.  
  349.  
  350.  
  351.  
  352.  
  353.  
  354.  
  355.  
  356.  
  357.  
  358.  
  359.  
  360. IBM PC Assembly Language Tutorial                                         6
  361.  
  362.  
  363.          Two operands:          One operand:
  364.           R <-- M                R
  365.           M <-- R                M
  366.           R <-- R                S *
  367.           R|M <-- I
  368.           R|M <-- S  *
  369.           S <-- R|M  *
  370.  
  371.       * -- data moving instructions (MOV, PUSH, POP) only
  372.       S -- segment register (CS, DS, ES, SS)
  373.       R -- ordinary register (AX, BX, CX, DX, SI, DI, BP, SP,
  374.                               AH, AL, BH, BL, CH, CL, DH, DL)
  375.       M -- one of the following
  376.                pure address
  377.                [BX]+offset
  378.                [BP]+offset
  379.                any of the above indexed by SI
  380.                any of the first three indexed by DI
  381.  
  382. 4.  Of course, you want to learn the operations themselves.  As I've sug-
  383.     gested, you want to learn the op codes as the assembler presents them,
  384.     not as the CPU machine language presents them.  So, even though there
  385.     are many MOV op codes you don't need to learn them.  Basically, here is
  386.     the instruction set:
  387.  
  388.     a.  Ordinary two operand instructions.  These instructions perform an
  389.         operation and leave the result in place of one of the operands.
  390.         They are
  391.  
  392.         1)  ADD and ADC -- addition, with or without including a carry from
  393.             a previous addition
  394.  
  395.         2)  SUB and SBB -- subtraction, with or without including a borrow
  396.             from a previous subtraction
  397.  
  398.         3)  CMP -- compare.  It is useful to think of this as a subtraction
  399.             with the answer being thrown away and neither operand actually
  400.             changed
  401.  
  402.         4)  AND, OR, XOR -- typical boolean operations
  403.  
  404.         5)  TEST -- like an AND, except the answer is thrown away and nei-
  405.             ther operand is changed.
  406.  
  407.         6)  MOV -- move data from source to target
  408.  
  409.         7)  LDS, LES, LEA -- some specialized forms of MOV with side
  410.             effects
  411.  
  412.     b.  Ordinary one operand instructions.  These can take any of the oper-
  413.         and forms described above.  Usually, the perform the operation and
  414.         leave the result in the stated place:
  415.  
  416.         1)  INC -- increment contents
  417.  
  418.  
  419.  
  420. IBM PC Assembly Language Tutorial                                         7
  421.  
  422.  
  423.         2)  DEC -- decrement contents
  424.  
  425.         3)  NEG -- twos complement
  426.  
  427.         4)  NOT -- ones complement
  428.  
  429.         5)  PUSH -- value goes on stack (operand location itself unchanged)
  430.  
  431.         6)  POP -- value taken from stack, replaces current value
  432.  
  433.     c.  Now you touch on some instructions which do not follow the general
  434.         operand rules but which require the use of certain registers.  The
  435.         important ones are
  436.  
  437.         1)  The multiply and divide instructions
  438.  
  439.         2)  The "adjust" instructions which help in performing arithmetic
  440.             on ASCII or packed decimal data
  441.  
  442.         3)  The shift and rotate instructions.  These have a restriction on
  443.             the second operand:  it must either be the immediate value 1 or
  444.             the contents of the CL register.
  445.  
  446.         4)  IN and OUT which send or receive data from one of the 1024
  447.             hardware ports.
  448.  
  449.         5)  CBW and CWD -- convert byte to word or word to doubleword by
  450.             sign extension
  451.  
  452.     d.  Flow of control instructions.  These deserve study in themselves
  453.         and we will discuss them a little more.  They include
  454.  
  455.         1)  CALL, RET -- call and return
  456.  
  457.         2)  INT, IRET -- interrupt and return-from-interrupt
  458.  
  459.         3)  JMP -- jump or "branch"
  460.  
  461.         4)  LOOP, LOOPNZ, LOOPZ -- special (and useful) instructions which
  462.             implement a counted loop similar to the 370 BCT instruction
  463.  
  464.         5)  various conditional jump instructions
  465.  
  466.     e.  String instructions.  These implement a limited storage-to-storage
  467.         instruction subset and are quite powerful.  All of them have the
  468.         property that
  469.  
  470.         1)  The source of data is described by the combination DS and SI.
  471.  
  472.         2)  The destination of data is described by the combination ES and
  473.             DI.
  474.  
  475.         3)  As part of the operation, the SI and/or DI register(s) is(are)
  476.             incremented or decremented so the operation can be repeated.
  477.  
  478.  
  479.  
  480. IBM PC Assembly Language Tutorial                                         8
  481.  
  482.  
  483.         They include
  484.  
  485.         1)  CMPSB/CMPSW -- compare byte or word
  486.  
  487.         2)  LODSB/LODSW -- load byte or word into AL or AX
  488.  
  489.         3)  STOSB/STOSW -- store byte or word from AL or AX
  490.  
  491.         4)  MOVSB/MOVSW -- move byte or word
  492.  
  493.         5)  SCASB/SCASW -- compare byte or word with contents of AL or AX
  494.  
  495.         6)  REP/REPE/REPNE -- a prefix which can be combined with any of
  496.             the above instructions to make them execute repeatedly across a
  497.             string of data whose length is held in CX.
  498.  
  499.     f.  Flag instructions: CLI, STI, CLD, STD, CLC, STC.  These can set or
  500.         clear the interrupt (enabled) direction (for string operations) or
  501.         carry flags.
  502.  
  503.     The addressing summary and the instruction summary given above masks a
  504.     lot of annoying little exceptions.  For example, you can't POP CS, and
  505.     although the R <-- M form of LES is legal, the M <-- R form isn't etc.
  506.     etc.  My advice is
  507.  
  508.     a.  Go for the general rules
  509.  
  510.     b.  Don't try to memorize the exceptions
  511.  
  512.     c.  Rely on common sense and the assembler to teach you about
  513.         exceptions over time.  A lot of the exceptions cover things you
  514.         wouldn't want to do anyway.
  515.  
  516. 5.  A few instructions are rich enough and useful enough to warrent careful
  517.     study.  Here are a few final study guidelines:
  518.  
  519.     a.  It is well worth the time learning to use the string instruction
  520.         set effectively.  Among the most useful are
  521.  
  522.                 REP MOVSB           ;moves a string
  523.                 REP STOSB           ;initializes memory
  524.                 REPNE SCASB         ;look up occurance of character in string
  525.                 REPE CMPSB          ;compare two strings
  526.  
  527.     b.  Similarly, if you have never written for a stack machine before,
  528.         you will need to exercise PUSH and POP and get very comfortable
  529.         with them because they are going to be good friends.  If you are
  530.         used to the 370, with lots of general purpose registers, you may
  531.         find yourself feeling cramped at first, with many fewer registers
  532.         and many instructions having register restrictions.  But, you have
  533.         a hidden ally:  you need a register and you don't want to throw
  534.         away what's in it?  Just PUSH it, and when you are done, POP it
  535.         back.  This can lead to abuse.  Never have more than two
  536.         "expedient" PUSHes in effect and never leave something PUSHed
  537.         across a major header comment or for more than 15 instructions or
  538.  
  539.  
  540. IBM PC Assembly Language Tutorial                                         9
  541.  
  542.  
  543.         so.  An exception is the saving and restoring of registers at
  544.         entrance to and exit from a subroutine; here, if the subroutine is
  545.         long, you should probably PUSH everything which the caller may need
  546.         saved, whether you will use the register or not, and POP it in
  547.         reverse order at the end.
  548.  
  549.         Be aware that CALL and INT push return address information on the
  550.         stack and RET and IRET pop it off.  It is a good idea to become
  551.         familiar with the structure of the stack.
  552.  
  553.     c.  In practice, to invoke system services you will use the INT
  554.         instruction.  It is quite possible to use this instruction effec-
  555.         tively in a cookbook fashion without knowing precisely how it
  556.         works.
  557.  
  558.     d.  The transfer of control instructions (CALL, RET, JMP) deserve care-
  559.         ful study to avoid confusion.  You will learn that these can be
  560.         classified as follows:
  561.  
  562.         1)  all three have the capability of being either NEAR (CS register
  563.             unchanged) or FAR (CS register changed)
  564.  
  565.         2)  JMPs and CALLs can be DIRECT (target is assembled into instruc-
  566.             tion) or INDIRECT (target fetched from memory or register)
  567.  
  568.         3)  if NEAR and DIRECT, a JMP can be SHORT (less than 128 bytes
  569.             away) or LONG
  570.  
  571.         In general, the third issue is not worth worrying about.  On a for-
  572.         ward jump which is clearly VERY short, you can tell the assembler
  573.         it is short and save one byte of code:
  574.  
  575.                    JMP SHORT  CLOSEBY
  576.  
  577.         On a backward jump, the assembler can figure it out for you.  On a
  578.         forward jump of dubious length, let the assembler default to a LONG
  579.         form; at worst you waste one byte.
  580.  
  581.         Also leave the assembler to worry about how the target address is
  582.         to be represented, in absolute form or relative form.
  583.  
  584.     e.  The conditional jump set is rather confusing when studied apart
  585.         from the assembler, but you do need to get a feeling for it.  The
  586.         interactions of the sign, carry, and overflow flags can get your
  587.         mind stuttering pretty fast if you worry about it too much.  What
  588.         is boils down to, though, is
  589.  
  590.                 JZ        means what it says
  591.                 JNZ       means what it says
  592.                 JG reater this means "if the SIGNED difference is positive"
  593.                 JA bove   this means "if the UNSIGNED difference is positive"
  594.                 JL ess    this means "if the SIGNED difference is negative"
  595.                 JB elow   this means "if the UNSIGNED difference is negative"
  596.                 JC arry   assembles the same as JB; it's an aesthetic choice
  597.  
  598.  
  599.  
  600. IBM PC Assembly Language Tutorial                                        10
  601.  
  602.  
  603.         You should understand that all conditional jumps are inherently
  604.         DIRECT, NEAR, and "short"; the "short" part means that they can't
  605.         go more than 128 bytes in either direction.  Again, this is some-
  606.         thing you could easily imagine to be more of a problem than it is.
  607.         I follow this simple approach:
  608.  
  609.         1)  When taking an abnormal exit from a block of code, I always use
  610.             an unconditional jump.  Who knows how far you are going to end
  611.             up jumping by the time the program is finished.  For example, I
  612.             wouldn't code this:
  613.  
  614.                    TEST     AL,IDIBIT       ;Is the idiot bit on?
  615.                    JNZ      OYVEY           ;Yes.  Go to general cleanup
  616.  
  617.             Rather, I would probably code this:
  618.  
  619.                    TEST     AL,IDIBIT       ;Is the idiot bit on?
  620.                    JZ       NOIDIOCY        ;No.  I am saved.
  621.                    JMP      OYVEY           ;Yes.  What can we say...
  622.               NOIDIOCY:
  623.  
  624.             The latter, of course, is a jump around a jump.  Some would say
  625.             it is evil, but I submit it is hard to avoid in this language.
  626.  
  627.         2)  Otherwise, within a block of code, I use conditional jumps
  628.             freely.  If the block eventually grows so long that the assem-
  629.             bler starts complaining that my conditional jumps are too long
  630.             I
  631.  
  632.             a)  consider reorganizing the block but
  633.  
  634.             b)  also consider changing some conditional jumps to their
  635.                 opposite and use the "jump around a jump" approach as shown
  636.                 above.
  637.  
  638.     Enough about specific instructions!
  639.  
  640. 6.  Finally, in order to use the assembler effectively, you need to know
  641.     the default rules for which segment registers are used to complete
  642.     addresses in which situations.
  643.  
  644.     a.  CS is used to complete an address which is the target of a NEAR
  645.         DIRECT jump.  On an NEAR INDIRECT jump, DS is used to fetch the
  646.         address from memory but then CS is used to complete the address
  647.         thus fetched.  On FAR jumps, of course, CS is itself altered.  The
  648.         instruction counter is always implicitly pointing in the code seg-
  649.         ment.
  650.  
  651.     b.  SS is used to complete an address if BP is used in its formation.
  652.         Otherwise, DS is always used to complete a data address.
  653.  
  654.     c.  On the string instructions, the target is always formed from ES and
  655.         DI.  The source is normally formed from DS and SI.  If there is a
  656.         segment prefix, it overrides the source not the target.
  657.  
  658.  
  659.  
  660. IBM PC Assembly Language Tutorial                                        11
  661.  
  662.  
  663. Learning about DOS__________________Learning about DOSLearning about DOSLearning about DOS
  664.  
  665.  
  666. I think the best way to learn about DOS internals is to read the technical
  667. appendices in the manual.  These are not as complete as we might wish, but
  668. they really aren't bad; I certainly have learned a lot from them.  What you
  669. don't learn from them you might eventually learn via judicious disassembly
  670. of parts of DOS, but that shouldn't really be necessary.
  671.  
  672. From reading the technical appendices, you learn that interrupts 20H
  673. through 27H are used to communicate with DOS.  Mostly, you will use inter-
  674. rupt 21H, the DOS function manager.
  675.  
  676. The function manager implements a great many services.  You request the
  677. individual services by means of a function code in the AH register.  For
  678. example, by putting a nine in the AH register and issuing interrupt 21H you
  679. tell DOS to print a message on the console screen.
  680.  
  681. Usually, but by no means always, the DX register is used to pass data for
  682. the service being requested.  For example, on the print message service
  683. just mentioned, you would put the 16 bit address of the message in the DX
  684. register.  The DS register is also implicitly part of this argument, in
  685. keeping with the universal segmentation rules.
  686.  
  687. In understanding DOS functions, it is useful to understand some history and
  688. also some of the philosophy of MS-DOS with regard to portability.  General-
  689. ly, you will find, once you read the technical information on DOS and also
  690. the IBM technical reference, you will know more than one way to do almost
  691. anything.  Which is best?  For example, to do asynch adapter I/O, you can
  692. use the DOS calls (pretty incomplete), you can use BIOS, or you can go
  693. directly to the hardware.  The same thing is true for most of the other
  694. primitive I/O (keyboard or screen) although DOS is more likely to give you
  695. added value in these areas.  When it comes to file I/O, DOS itself offers
  696. more than one interface.  For example, there are four calls which read data
  697. from a file.
  698.  
  699. The way to decide rationally among these alternatives is by understanding
  700. the tradeoffs of functionality versus portability.  Three kinds of porta-
  701. bility need to be considered:  machine portability, operating system porta-
  702. bility (for example, the ability to assemble and run code under CP/M 86)
  703. and DOS version portability (the ability for a program to run under older
  704. versions of DOS>.
  705.  
  706. Most of the functions originally offered in DOS 1.0 were direct descendents
  707. of CP/M functions; there is even a compatibility interface so that programs
  708. which have been translated instruction for instruction from 8080 assembler
  709. to 8086 assembler might have a reasonable chance of running if they use
  710. only the core CP/M function set.  Among the most generally useful in this
  711. original compatibility set are
  712.  
  713.  
  714.  
  715.  
  716.  
  717.  
  718.  
  719.  
  720. IBM PC Assembly Language Tutorial                                        12
  721.  
  722.  
  723.   09   --  print a full message on the screen
  724.   0A   --  get a console input line with full DOS editing
  725.   0F   --  open a file
  726.   10   --  close a file (really needed only when writing)
  727.   11   --  find first file matching a pattern
  728.   12   --  find next file matching a pattern
  729.   13   --  erase a file
  730.   16   --  create a file
  731.   17   --  rename a file
  732.   1A   --  set disk transfer address
  733.  
  734. The next set provide no function above what you can get with BIOS calls or
  735. more specialized DOS calls.  However, they are preferable to BIOS calls
  736. when portability is an issue.
  737.  
  738.   00   --  terminate execution
  739.   01   --  read keyboard character
  740.   02   --  write screen character
  741.   03   --  read COM port character
  742.   04   --  write COM port character
  743.   05   --  print a character
  744.   06   --  read keyboard or write screen with no editing
  745.  
  746. The standard file I/O calls are inferior to the specialized DOS calls but
  747. have the advantage of making the program easier to port to CP/M style sys-
  748. tems.  Thus they are worth mentioning:
  749.  
  750.   14   --  sequential read from file
  751.   15   --  sequential write to file
  752.   21   --  random read from file
  753.   22   --  random write to file
  754.   23   --  determine file size
  755.   24   --  set random record
  756.  
  757. In addition to the CP/M compatible services, DOS also offers some special-
  758. ized services which have been available in all releases of DOS.  These
  759. include
  760.  
  761.   27   --  multi-record random read.
  762.   28   --  multi-record random write.
  763.   29   --  parse filename
  764.   2A-2D -- get and set date and time
  765.  
  766. All of the calls mentioned above which have anything to do with files make
  767. use of a data area called the "FILE CONTROL BLOCK" (FCB).  The FCB is any-
  768. where from 33 to 37 bytes long depending on how it is used.  You are
  769. responsible for creating an FCB and filling in the first 12 bytes, which
  770. contain a drive code, a file name, and an extension.
  771.  
  772. When you open the FCB, the system fills in the next 20 bytes, which
  773. includes a logical record length.  The initial lrecl is always 128 bytes,
  774. to achieve CP/M compatibility.  The system also provides other useful
  775. information such as the file size.
  776.  
  777.  
  778.  
  779.  
  780. IBM PC Assembly Language Tutorial                                        13
  781.  
  782.  
  783. After you have opened the FCB, you can change the logical record length.
  784. If you do this, your program is no longer CP/M compatible, but that doesn't
  785. make it a bad thing to do.  DOS documentation suggests you use a logical
  786. record length of one for maximum flexibility.  This is usually a good
  787. recommendation.
  788.  
  789. To perform actual I/O to a file, you eventually need to fill in byte 33 or
  790. possibly bytes 34-37 of the FCB.  Here you supply information about the
  791. record you are interested in reading or writing.  For the most part, this
  792. part of the interface is compatible with CP/M.
  793.  
  794. In general, you do not need to (and should not) modify other parts of the
  795. FCB.
  796.  
  797. The FCB is pretty well described in appendix E of the DOS manual.
  798.  
  799. Beginning with DOS 2.0, there is a whole new system of calls for managing
  800. files which don't require that you build an FCB at all.  These calls are
  801. quite incompatible with CP/M and also mean that your program cannot run
  802. under older releases of DOS.  However, these calls are very nice and easy
  803. to use.  They have these characteristics
  804.  
  805. 1.  To open, create, delete, or rename a file, you need only a character
  806.     string representing its name.
  807.  
  808. 2.  The open and create calls return a 16 bit value which is simply placed
  809.     in the BX register on subsequent calls to refer to the file.
  810.  
  811. 3.  There is not a separate call required to specify the data buffer.
  812.  
  813. 4.  Any number of bytes can be transfered on a single call; no data area
  814.     must be manipulated to do this.
  815.  
  816. The "new" DOS calls also include comprehensive functions to manipulate the
  817. new chained directory structure and to allocate and free memory.
  818.  
  819.  
  820.  
  821. Learning the assembler______________________Learning the assemblerLearning the assemblerLearning the assembler
  822.  
  823.  
  824. It is my feeling that many people can teach themselves to use the assembler
  825. by reading the MACRO Assembler manual if
  826.  
  827. 1.  You have read and understood a book like Morse and thus have a feeling
  828.     for the instruction set
  829.  
  830. 2.  You know something about DOS services and so can communicate with the
  831.     keyboard and screen and do something marginally useful with files.  In
  832.     the absence of this kind of knowledge, you can't write meaningful prac-
  833.     tice programs and so will not progress.
  834.  
  835. 3.  You have access to some good examples (the ones supplied with the
  836.     assembler are not good, in my opinion.  I will try to supply you with
  837.     some more relevant ones.
  838.  
  839.  
  840. IBM PC Assembly Language Tutorial                                        14
  841.  
  842.  
  843. 4.  You ignore the things which are most confusing and least useful.  Some
  844.     of the most confusing aspects of the assembler include the facilities
  845.     combining segments.  But, you can avoid using all but the simplest of
  846.     these facilities in many cases, even while writing quite substantial
  847.     applications.
  848.  
  849. 5.  The easiest kind of assembler program to write is a COM program.  They
  850.     might seem harder, at first, then EXE programs because there is an
  851.     extra step involved in creating the executable file, but COM programs
  852.     are structurally very much simpler.
  853.  
  854. At this point, it is necessary to talk about COM programs and EXE programs.
  855. As you probably know, DOS supports two kinds of executable files.  EXE pro-
  856. grams are much more general, can contain many segments, and are generally
  857. built by compilers and sometimes by the assembler.  If you follow the lead
  858. given by the samples distributed with the assembler, you will end up with
  859. EXE programs.  A COM program, in contrast, always contains just one
  860. segment, and receives control with all four segment registers containing
  861. the same value.  A COM program, thus, executes in a simplified environment,
  862. a 64K address space.  You can go outside this address space simply by tem-
  863. porarily changing one segment register, but you don't have to, and that is
  864. the thing which makes COM programs nice and simple.  Let's look at a very
  865. simple one.
  866.  
  867. The classic text on writing programs for the C language says that the first
  868. thing you should write is a program which says
  869.  
  870.       HELLO, WORLD.
  871.  
  872. when invoked.  What's sauce for C is sauce for assembler, so let's start
  873. with a HELLO program of our own.  My first presentation of this will be
  874. bare bones, not stylistically complete, but just an illustration of what an
  875. assembler program absolutely has to have:
  876.  
  877. HELLO  SEGMENT                  ;Set up HELLO code and data section
  878.        ASSUME CS:HELLO,DS:HELLO ;Tell assembler about conditions at entry
  879.        ORG  100H                ;A .COM program begins with 100H byte prefix
  880. MAIN:  JMP  BEGIN               ;Control must start here
  881. MSG    DB   'Hello, world.$'    ;But it is generally useful to put data first
  882. BEGIN: MOV  DX,OFFSET MSG       ;Let DX --> message.
  883.        MOV  AH,9                ;Set DOS function code for printing a message
  884.        INT  21H                 ;Invoke DOS
  885.        RET                      ;Return to system
  886. HELLO  ENDS                     ;End of code and data section
  887.         END  MAIN                 ;Terminate assembler and specify entry point
  888.  
  889.  
  890. First, let's attend to some obvious points.  The macro assembler uses the
  891. general form
  892.  
  893.    name    opcode    operands
  894.  
  895. Unlike the 370 assembler, though, comments are NOT set off from operands by
  896. blanks.  The syntax uses blanks as delimiters within the operand field (see
  897. line 6 of the example) and so all comments must be set off by semi-colons.
  898.  
  899.  
  900. IBM PC Assembly Language Tutorial                                        15
  901.  
  902.  
  903. Line comments are frequently set off with a semi-colon in column 1.  I use
  904. this approach for block comments too, although there is a COMMENT statement
  905. which can be used to introduce a block comment.
  906.  
  907. Being an old 370 type, I like to see assembler code in upper case, although
  908. my comments are mixed case.  Actually, the assembler is quite happy with
  909. mixed case anywhere.
  910.  
  911. As with any assembler, the core of the opcode set consists of opcodes which
  912. generate machine instructions but there are also opcodes which generate
  913. data and ones which function as instructions to the assembler itself, some-
  914. times called pseudo-ops.  In the example, there are five lines which gener-
  915. ate machine code (JMP, MOV, MOV, INT, RET), one line which generates data
  916. (DB) and five pseudo-ops (SEGMENT, ASSUME, ORG, ENDS, and END).
  917.  
  918. We will discuss all of them.
  919.  
  920. Now, about labels.  You will see that some labels in the example end in a
  921. colon and some don't.  This is just a bit confusing at first, but no real
  922. mystery.  If a label is attached to a piece of code (as opposed to data),
  923. then the assembler needs to know what to do when you JMP to or CALL that
  924. label.  By convention, if the label ends in a colon, the assembler will use
  925. the NEAR form of JMP or CALL.  If the label does not end in a colon, it
  926. will use the FAR form.  In practice, you will always use the colon on any
  927. label you are jumping to inside your program because such jumps are always
  928. NEAR; there is no reason to use a FAR jump within a single code section.  I
  929. mention this, though, because leaving off the colon isn't usually trapped
  930. as a syntax error, it will generally cause something more abstruse to go
  931. wrong.
  932.  
  933. On the other hand, a label attached to a piece of data or a pseudo-op never
  934. ends in a colon.
  935.  
  936. Machine instructions will generally take zero, one or two operands.  Where
  937. there are two operands, the one which receives the result goes on the left
  938. as in 370 assembler.
  939.  
  940. I tried to explain this before, now maybe it will be even clearer:  there
  941. are many more 8086 machine opcodes then there are assembler opcodes to rep-
  942. resent them.  For example, there are five kinds of JMP, four kinds of CALL,
  943. two kinds of RET, and at least five kinds of MOV depending on how you count
  944. them.  The macro assembler makes a lot of decisions for you based on the
  945. form taken by the operands or on attributes assigned to symbols elsewhere
  946. in your program.  In the example above, the assembler will generate the
  947. NEAR DIRECT form of JMP because the target label BEGIN labels a piece of
  948. code instead of a piece of data (this makes the JMP DIRECT) and ends in a
  949. colon (this makes the JMP NEAR).  The assembler will generate the immediate
  950. forms of MOV because the form OFFSET MSG refers to immediate data and
  951. because 9 is a constant.  The assembler will generate the NEAR form of RET
  952. because that is the default and you have not told it otherwise.
  953.  
  954. The DB (define byte) pseudo-op is an easy one:  it is used to put one or
  955. more bytes of data into storage.  There is also a DW (define word)
  956. pseudo-op and a  DD (define doubleword) pseudo-op;  in the PC MACRO assem-
  957. bler, the fact that a label refers to a byte of storage, a word of storage,
  958.  
  959.  
  960. IBM PC Assembly Language Tutorial                                        16
  961.  
  962.  
  963. or a doubleword of storage can be very significant in ways which we will
  964. see presently.
  965.  
  966. About that OFFSET operator, I guess this is the best way to make the point
  967. about how the assembler decides what instruction to assemble:  an analogy
  968. with 370 assembler:
  969.  
  970.   PLACE    DC   ......
  971.            ...
  972.            LA   R1,PLACE
  973.            L    R1,PLACE
  974.  
  975. In 370 assembler, the first instruction puts the address of label PLACE in
  976. register 1, the second instruction puts the contents of storage at label
  977. PLACE in register 1.  Notice that two different opcodes are used.  In the
  978. PC assembler, the analogous instructions would be
  979.  
  980.   PLACE    DW   ......
  981.            ...
  982.            MOV  DX,OFFSET PLACE
  983.            MOV  DX,PLACE
  984.  
  985. If PLACE is the label of a word of storage, then the second instruction
  986. will be understood as a desire to fetch that data into DX.  If X is a
  987. label, then "OFFSET X" means "the ordinary number which represents X's off-
  988. set from the start of the segment."  And, if the assembler sees an ordinary
  989. number, as opposed to a label, it uses the instruction which is equivalent
  990. to LA.
  991.  
  992. If PLACE were the label of a DB pseudo-op, instead of a DW, then
  993.  
  994.            MOV  DX,PLACE
  995.  
  996. would be illegal.  The assembler worries about length attributes of its
  997. operands.
  998.  
  999. Next, numbers and constants in general.  The assembler's default radix is
  1000. decimal.  You can change this, but I don't recommend it.  If you want to
  1001. represent numbers in other forms of notation such as hex or bit, you gener-
  1002. ally use a trailing letter.  For example,
  1003.  
  1004.            21H
  1005.   is hexidecimal 21,
  1006.            00010000B
  1007.   is the eight bit binary number pictured.
  1008.  
  1009. The next elements we should point to are the SEGMENT...ENDS pair and the
  1010. END instruction.  Every assembler program has to have these elements.
  1011.  
  1012. SEGMENT tells the assembler you are starting a section of contiguous mate-
  1013. rial (code and/or data).  The symmetrically named ENDS statement tells the
  1014. assembler you are finished with a section of contiguous material.  I wish
  1015. they didn't use the word SEGMENT in this context.  To me, a "segment" is a
  1016. hardware construct:  it is the 64K of real storage which becomes address-
  1017. able by virtue of having a particular value in a segment register.  Now, it
  1018.  
  1019.  
  1020. IBM PC Assembly Language Tutorial                                        17
  1021.  
  1022.  
  1023. is true that the "segments" you make with the assembler often correspond to
  1024. real hardware "segments" at execution time.  But, if you look at things
  1025. like the GROUP and CLASS options supported by the linker, you will discover
  1026. that this correspondence is by no means exact.  So, at risk of maybe con-
  1027. fusing you even more, I am going to use the more informal term "section" to
  1028. refer to the area set off by means of the SEGMENT and ENDS instructions.
  1029.  
  1030. The sections delimited by SEGMENT...ENDS pairs are really a lot like CSECTs
  1031. and DSECTs in the 370 world.
  1032.  
  1033. I strongly recommend that you be selective in your study of the SEGMENT
  1034. pseudo-op as described in the manual.  Let me just touch on it here.
  1035.  
  1036.   name     SEGMENT
  1037.   name     SEGMENT  PUBLIC
  1038.   name     SEGMENT  AT  nnn
  1039.  
  1040. Basically, you can get away with just the three forms given above.  The
  1041. first form is what you use when you are writing a single section of assem-
  1042. bler code which will not be combined with other pieces of code at link
  1043. time.   The second form says that this assembly only contains part of the
  1044. section;  other parts might be assembled separately and combined later by
  1045. the linker.
  1046.  
  1047. I have found that one can construct reasonably large modular applications
  1048. in assembler by simply making every assembly use the same segment name and
  1049. declaring the name to be PUBLIC each time.  If you read the assembler and
  1050. linker documentation, you will also be bombarded by information about more
  1051. complex options such as the GROUP statement and the use of other "combine
  1052. types" and "classes."  I don't recommend getting into any of that.  I will
  1053. talk more about the linker and modular construction of programs a little
  1054. later.  The assembler manual also implies that a STACK segment is required.
  1055. This is not really true.  There are numerous ways to assure that you have a
  1056. valid stack at execution time.
  1057.  
  1058. Of course, if you plan to write applications in assembler which are more
  1059. than 64K in size, you will need more than what I have told you; but who is
  1060. really going to do that?  Any application that large is likely to be coded
  1061. in a higher level language.
  1062.  
  1063. The third form of the SEGMENT statement makes the delineated section into
  1064. something like a "DSECT;" that is, it doesn't generate any code, it just
  1065. describes what is present somewhere already in the computer's memory.
  1066. Sometimes the AT value you give is meaningful.  For example, the BIOS work
  1067. area is located at location 40 hex.  So, you might see
  1068.  
  1069.   BIOSAREA  SEGMENT AT 40H      ;Map BIOS work area
  1070.             ORG  BIOSAREA+10H
  1071.   EQUIP     DB   ?              ;Location of equipment flags, first byte
  1072.   BIOSAREA  ENDS
  1073.  
  1074. in a program which was interested in mucking around in the BIOS work area.
  1075.  
  1076. At other times, the AT value you give may be arbitrary, as when you are
  1077. mapping a repeated control block:
  1078.  
  1079.  
  1080. IBM PC Assembly Language Tutorial                                        18
  1081.  
  1082.  
  1083.   PROGPREF SEGMENT   AT 0      ;Really a DSECT mapping the program prefix
  1084.            ORG   PROGPREF+6
  1085.   MEMSIZE  DW   ?              ;Size of available memory
  1086.   PROGPREF ENDS
  1087.  
  1088. Really, no matter whether the AT value represents truth or fiction, it is
  1089. your responsibility, not the assembler's, to get set up a segment register
  1090. so that you can really reach the storage in question.   So, you can't say
  1091.  
  1092.          MOV  AL,EQUIP
  1093.  
  1094. unless you first say something like
  1095.  
  1096.          MOV  AX,BIOSAREA   ;BIOSAREA becomes a symbol with value 40H
  1097.          MOV  ES,AX
  1098.          ASSUME ES:BIOSAREA
  1099.  
  1100. Enough about SEGMENT.  The END statement is simple.  It goes at the end of
  1101. every assembly.  When you are assembling a subroutine, you just say
  1102.  
  1103.          END
  1104.  
  1105. but when you are assembling the main routine of a program you say
  1106.  
  1107.         END label
  1108.  
  1109. where 'label' is the place where execution is to begin.
  1110.  
  1111. Another pseudo-op illustrated in the program is ASSUME.  ASSUME is like the
  1112. USING statement in 370 assembler.  However, ASSUME can ONLY refer to seg-
  1113. ment registers.  The assembler uses ASSUME information to decide whether to
  1114. assemble segment override prefixes and to check that the data you are try-
  1115. ing to access is really accessible.  In this case, we can reassure the
  1116. assembler that both the CS and DS registers will address the section called
  1117. HELLO at execution time.  Actually, the SS and ES registers will too, but
  1118. the assembler never needs to make use of this information.
  1119.  
  1120. I guess I have explained everything in the program except that ORG
  1121. pseudo-op.  ORG means the same thing as it does in many assembly languages.
  1122. It tells the assembler to move its location counter to some particular
  1123. address.  In this case, we have asked the assembler to start assembling
  1124. code hex 100 bytes from the start of the section called HELLO instead of at
  1125. the very beginning.  This simply reflects the way COM programs are loaded.
  1126. When a COM program is loaded by the system, the system sets up all four
  1127. segment registers to address the same 64K of storage.  The first 100 hex
  1128. bytes of that storage contains what is called the program prefix; this area
  1129. is described in appendix E of the DOS manual.  Your COM program physically
  1130. begins after this.  Execution begins with the first physical byte of your
  1131. program; that is why the JMP instruction is there.
  1132.  
  1133. Wait a minute, you say, why the JMP instruction at all?  Why not put the
  1134. data at the end?  Well, in a simple program like this I probably could have
  1135. gotten away with that.  However, I have the habit of putting data first and
  1136. would encourage you to do the same because of the way the assembler has of
  1137. assembling different instructions depending on the nature of the operand.
  1138.  
  1139.  
  1140. IBM PC Assembly Language Tutorial                                        19
  1141.  
  1142.  
  1143. Unfortunately, sometimes the different choices of instruction which can
  1144. assemble from a single opcode have different lengths.  If the assembler has
  1145. already seen the data when it gets to the instructions it has a good chance
  1146. of reserving the right number of bytes on the first pass.  If the data is
  1147. at the end, the assembler may not have enough information on the first pass
  1148. to reserve the right number of bytes for the instruction.  Sometimes the
  1149. assembler will complain about this, something like "Forward reference is
  1150. illegal" but at other times, it will make some default assumption.  On the
  1151. second pass, if the assumption turned out to be wrong, it will report what
  1152. is called a "Phase error," a very nasty error to track down.  So get in the
  1153. habit of putting data and equated symbols ahead of code.
  1154.  
  1155. OK.  Maybe you understand the program now.  Let's walk through the steps
  1156. involved in making it into a real COM file.
  1157.  
  1158. 1.  The file should be created with the name HELLO.ASM (actually the name
  1159.     is arbitrary but the extension .ASM is conventional and useful)
  1160.  
  1161. 2.
  1162.  
  1163.       ASM   HELLO,,;
  1164.  
  1165.     (this is just one example of invoking the assembler; it uses the small
  1166.     assembler ASM, it produces an object file and a listing file with the
  1167.     same name as the source file.  I am not going exhaustively into how to
  1168.     invoke the assembler, which the manual goes into pretty well.  I guess
  1169.     this is the first time I mentioned that there are really two
  1170.     assemblers; the small assembler ASM will run in a 64K machine and
  1171.     doesn't support macros.  I used to use it all the time; now that I have
  1172.     a bigger machine and a lot of macro libraries I use the full function
  1173.     assembler MASM.  You get both when you buy the package).
  1174.  
  1175. 3.  If you issue DIR at this point, you will discover that you have
  1176.     acquired HELLO.OBJ (the object code resulting from the assembly) and
  1177.     HELLO.LST (a listing file).  I guess I can digress for a second here
  1178.     concerning the listing file.  It contains TAB characters.  I have found
  1179.     there are two good ways to get it printed and one bad way.  The bad way
  1180.     is to use LPT1: as the direct target of the listing file or to try
  1181.     copying the LST file to LPT1 without first setting the tabs on the
  1182.     printer.  The two good ways are to either
  1183.  
  1184.     a.  direct it to the console and activate the printer with CTRL-PRTSC.
  1185.         In this case, DOS will expand the tabs for you.
  1186.  
  1187.     b.  direct to LPT1: but first send the right escape sequence to LPT1 to
  1188.         set the tabs every eight columns.  I have found that on some early
  1189.         serial numbers of the IBM PC printer, tabs don't work quite right,
  1190.         which forces you to the first option.
  1191.  
  1192. 4.
  1193.  
  1194.           LINK  HELLO;
  1195.  
  1196.     (again, there are lots of linker options but this is the simplest.  It
  1197.     takes HELLO.OBJ and makes HELLO.EXE).  HELLO.EXE?  I thought we were
  1198.  
  1199.  
  1200. IBM PC Assembly Language Tutorial                                        20
  1201.  
  1202.  
  1203.     making a COM program, not an EXE program.  Right.  HELLO.EXE isn't
  1204.     really executable; its just that the linker doesn't know about COM pro-
  1205.     grams.  That requires another utility.  You don't have this utility if
  1206.     you are using DOS 1.0; you have it if you are using DOS 1.1 or DOS 2.0.
  1207.     Oh, by the way, the linker will warn you that you have no stack
  1208.     segment.  Don't worry about it.
  1209.  
  1210. 5.
  1211.  
  1212.           EXE2BIN  HELLO HELLO.COM
  1213.  
  1214.     This is the final step.  It produces the actual program you will exe-
  1215.     cute.  Note that you have to spell out HELLO.COM; for a nominally
  1216.     rational but actually perverse reason, EXE2BIN uses the default exten-
  1217.     sion BIN instead of COM for its output file.  At this point, you might
  1218.     want to erase HELLO.EXE; it looks a lot more useful than it is.
  1219.     Chances are you won't need to recreate HELLO.COM unless you change the
  1220.     source and then you are going to have to redo the whole thing.
  1221.  
  1222. 6.
  1223.  
  1224.           HELLO
  1225.  
  1226.     You type hello, that invokes the program, it says
  1227.  
  1228.           HELLO YOURSELF!!!
  1229.  
  1230.     (oops, what did I do wrong....?)
  1231.  
  1232.  
  1233.  
  1234. What about subroutines?_______________________What about subroutines?What about subroutines?What about subroutines?
  1235.  
  1236.  
  1237. I started with a simple COM program because I actually think they are easi-
  1238. er to create than subroutines to be called from high level languages, but
  1239. maybe its really the latter you are interested in.  Here, I think you
  1240. should get comfortable with the assembler FIRST with little exercises like
  1241. the one above and also another one which I will finish up with.
  1242.  
  1243. Next you are ready to look at the interface information for your particular
  1244. language.  You usually find this in some sort of an appendix.  For example,
  1245. the BASIC manual has Appendix C on Machine Language Subroutines.  The
  1246. PASCAL manual buries the information a little more deeply:  the interface
  1247. to a separately compiled routine can be found in the Chapter on Procedures
  1248. and Functions, in a subsection called Internal Calling Conventions.
  1249.  
  1250. Each language is slightly different, but here are what I think are some
  1251. common issues in subroutine construction.
  1252.  
  1253. 1.  NEAR versus FAR?  Most of the time, your language will probably call
  1254.     your assembler routine as a FAR routine.  In this case, you need to
  1255.     make sure the assembler will generate the right kind of return.  You do
  1256.     this with a PROC...ENDP statement pair.  The PROC statement is probably
  1257.  
  1258.  
  1259.  
  1260. IBM PC Assembly Language Tutorial                                        21
  1261.  
  1262.  
  1263.     a good idea for a NEAR routine too even though it is not strictly
  1264.     required:
  1265.  
  1266.               FAR linkage:        |            NEAR linkage:
  1267.                                   |
  1268.     ARBITRARY SEGMENT             |  SPECIFIC  SEGMENT  PUBLIC
  1269.               PUBLIC THENAME      |            PUBLIC THENAME
  1270.               ASSUME CS:ARBITRARY |            ASSUME CS:SPECIFIC,DS:SPECIFIC
  1271.     THENAME   PROC FAR            |            ASSUME ES:SPECIFIC,SS:SPECIFIC
  1272.               ..... code and data |  THENAME   PROC NEAR
  1273.     THENAME   ENDP                |            ..... code and data ....
  1274.     ARBITRARY ENDS                |  THENAME   ENDP
  1275.               END                 |  SPECIFIC  ENDS
  1276.                                   |            END
  1277.  
  1278.  
  1279.     With FAR linkage, it doesn't really matter what you call the segment.
  1280.     you must declare the name by which you will be called in a PUBLIC pseu-
  1281.     do-op and also show that it is a FAR procedure.  Only CS will be ini-
  1282.     tialized to your segment when you are called.  Generally, the other
  1283.     segment registers will continue to point to the caller's segments.
  1284.  
  1285.     With NEAR linkage, you are executing in the same segment as the caller.
  1286.     Therefore, you must give the segment a specific name as instructed by
  1287.     the language manual.  However, you may be able to count on all segment
  1288.     registers pointing to your own segment (sometimes the situation can be
  1289.     more complicated but I cannot really go into all of the details).  You
  1290.     should be aware that the code you write will not be the only thing in
  1291.     the segment and will be physically relocated within the segment by the
  1292.     linker.  However, all OFFSET references will be relocated and will be
  1293.     correct at execution time.
  1294.  
  1295. 2.  Parameters passed on the stack.  Usually, high level languages pass
  1296.     parameters to subroutines by pushing words onto the stack prior to
  1297.     calling you.  What may differ from language to language is the nature
  1298.     of what is pushed (OFFSET only or OFFSET and SEGMENT) and the order in
  1299.     which it is pushed (left to right, right to left within the CALL state-
  1300.     ment).  However, you will need to study the examples to figure out how
  1301.     to retrieve the parameters from the stack.  A useful fact to exploit is
  1302.     the fact that a reference involving the BP register defaults to a ref-
  1303.     erence to the stack segment.  So, the following strategy can work:
  1304.  
  1305.       ARGS     STRUC
  1306.                DW   3 DUP(?)  ;Saved BP and return address
  1307.       ARG3     DW   ?
  1308.       ARG2     DW   ?
  1309.       ARG1     DW   ?
  1310.       ARGS     ENDS
  1311.            ...........
  1312.                PUSH BP                 ;save BP register
  1313.                MOV  BP,SP              ;Use BP to address stack
  1314.                MOV   ...,[BP].ARG2     ;retrieve second argument
  1315.                (etc.)
  1316.  
  1317.  
  1318.  
  1319.  
  1320. IBM PC Assembly Language Tutorial                                        22
  1321.  
  1322.  
  1323.     This example uses something called a structure, which is only available
  1324.     in the large assembler; furthermore, it uses it without allocating it,
  1325.     which is not a well-documented option.  However, I find the above
  1326.     approach generally pleasing.  The STRUC is like a DSECT in that it
  1327.     establishes labels as being offset a certain distance from an arbitrary
  1328.     point; these labels are then used in the body of code by beginning them
  1329.     with a period; the construction ".ARG2" means, basically, " +
  1330.     (ARG2-ARGS)."
  1331.  
  1332.     What you are doing here is using BP to address the stack, accounting
  1333.     for the word where you saved the caller's BP and also for the two words
  1334.     which were pushed by the CALL instruction.
  1335.  
  1336. 3.  How big is the stack?  BASIC only gives you an eight word stack to play
  1337.     with.  On the other hand, it doesn't require you to save any registers
  1338.     except the segment registers.  Other languages give you a liberal
  1339.     stack, which makes things a lot easier.  If you have to create a new
  1340.     stack segment for yourself, the easiest thing is to place the stack at
  1341.     the end of your program and:
  1342.  
  1343.          CLI                      ;suppress interrupts while changing the stack
  1344.          MOV  SSAVE,SS            ;save old SS in local storage (old SP
  1345.                                   ; already saved in BP)
  1346.          MOV  SP,CS               ;switch
  1347.          MOV  SS,SP               ;the
  1348.          MOV  SP,OFFSET STACKTOP  ;stack
  1349.          STI                      ;(maybe)
  1350.  
  1351.     Later, you can reverse these steps before returning to the caller.  At
  1352.     the end of your program, you place the stack itself:
  1353.  
  1354.              DW   128 DUP(?)          ;stack of 128 words (liberal)
  1355.     STACKTOP LABEL WORD
  1356.  
  1357.  
  1358. 4.  Make sure you save and restore those registers required by the caller.
  1359.  
  1360. 5.  Be sure to get the right kind of addressibility.  In the FAR call exam-
  1361.     ple, only CS addresses your segment.  If you are careful with your
  1362.     ASSUME statements the assembler will keep track of this fact and gener-
  1363.     ate CS prefixes when you make data references; however, you might want
  1364.     to do something like
  1365.  
  1366.                     MOV AX,CS      ;get current segment address
  1367.                     MOV DS,AX      ;To DS
  1368.                     ASSUME DS:THISSEG
  1369.  
  1370.     Be sure you keep your ASSUMEs in synch with reality.
  1371.  
  1372.  
  1373.  
  1374.  
  1375.  
  1376.  
  1377.  
  1378.  
  1379.  
  1380. IBM PC Assembly Language Tutorial                                        23
  1381.  
  1382.  
  1383. Learning about BIOS and the hardware____________________________________Learning about BIOS and the hardwareLearning about BIOS and the hardwareLearning about BIOS and the hardware
  1384.  
  1385.  
  1386. You can't do everything with DOS calls.  You may need to learn something
  1387. about the BIOS and about the hardware itself.  In this, the Technical Ref-
  1388. erence is a very good thing to look at.
  1389.  
  1390. The first thing you look at in the Technical Reference, unless you are
  1391. really determined to master the whole ball of wax, is the BIOS listings
  1392. presented in Appendix A. Glory be:  here is the whole 8K of ROM which deals
  1393. with low level hardware support layed out with comments and everything.
  1394.  
  1395. In fact, if you are just interested in learning what BIOS can do for you,
  1396. you just need to read the header comments at the beginning of each section
  1397. of the listing.
  1398.  
  1399. BIOS services are invoked by means of the INT instruction; the BIOS occu-
  1400. pies interrupts 10H through 1FH and also interrupt 5H; actually, of these
  1401. seventeen interrupts, five are used for user exit points or data pointers,
  1402. leaving twelve actual services.
  1403.  
  1404. In most cases, a service deals with a particular hardware interface; for
  1405. example, BIOS interrupt 10H deals with the screen.  As with DOS function
  1406. calls, many BIOS services can be passed a function code in the AH register
  1407. and possible other arguments.
  1408.  
  1409. I am not going to summarize the most useful BIOS features here; you will
  1410. see some examples in the next sample program we will look at.
  1411.  
  1412. The other thing you might want to get into with the Tech reference is the
  1413. description of some hardware options, particularly the asynch adapter,
  1414. which are not well supported in the BIOS.  The writeup on the asynch adapt-
  1415. er is pretty complete.
  1416.  
  1417. Actually, the Tech reference itself is pretty complete and very nice as far
  1418. as it goes.  One thing which is missing from the Tech reference is informa-
  1419. tion on the programmable peripheral chips on the system board.  These
  1420. include
  1421.  
  1422.       the 8259 interrupt controller
  1423.       the 8253 timer
  1424.       the 8237 DMA controller and
  1425.       the 8255 peripheral interface
  1426.  
  1427. To make your library absolutely complete, you should order the INTEL data
  1428. sheets for these beasts.
  1429.  
  1430. I should say, though, that the only I ever found I needed to know about was
  1431. the interrupt controller.  If you happen to have the 8086 Family User's
  1432. Manual, the big book put out by INTEL, which is one of the things people
  1433. sometimes buy to learn about 8086 architecture, there is an appendix there
  1434. which gives an adequate description of the 8259.
  1435.  
  1436.  
  1437.  
  1438.  
  1439.  
  1440. IBM PC Assembly Language Tutorial                                        24
  1441.  
  1442.  
  1443. A final example_______________A final exampleA final exampleA final example
  1444.  
  1445.  
  1446. I leave you with a more substantial example of code which illustrates some
  1447. good elementary techniques; I won't claim its style is perfect, but I think
  1448. it is adequate.  I think this is a much more useful example than what you
  1449. will get with the assembler:
  1450.  
  1451.           PAGE 61,132
  1452.           TITLE SETSCRN -- Establish correct monitor use at boot time
  1453. ;
  1454. ;         This program is a variation on many which toggle the equipment flags
  1455. ;         to support the use of either video option (monochrome or color).
  1456. ;         The thing about this one is it prompts the user in such a way that he
  1457. ;         can select the use of the monitor he is currently looking at (or which
  1458. ;         is currently connected or turned on) without really having to know
  1459. ;         which is which.  SETSCRN is a good program to put first in an
  1460. ;         AUTOEXEC.BAT file.
  1461. ;
  1462. ;         This program is highly dependent on the hardware and BIOS of the IBMPC
  1463. ;         and is hardly portable, except to very exact clones.  For this reason,
  1464. ;         BIOS calls are used in lieu of DOS function calls where both provide
  1465. ;         equal function.
  1466. ;
  1467.  
  1468.  
  1469. OK.  That's the first page of the program.  Notice the PAGE statement,
  1470. which you can use to tell the assembler how to format the listing.  You
  1471. give it lines per page and characters per line.  I have mine setup to print
  1472. on the host lineprinter; I routinely upload my listings at 9600 baud and
  1473. print them on the host; it is faster than using the PC printer.
  1474.  
  1475. There is also a TITLE statement.  This simply provides a nice title for
  1476. each page of your listing.  Now for the second page:
  1477.  
  1478.           SUBTTL -- Provide .COM type environment and Data
  1479.           PAGE
  1480. ;
  1481. ;         First, describe the one BIOS byte we are interested in
  1482. ;
  1483. BIOSDATA  SEGMENT   AT 40H    ;Describe where BIOS keeps his data
  1484.           ORG       10H       ;Skip parts we are not interested in
  1485. EQUIP     DB        ?         ;Equipment flag location
  1486. MONO      EQU       00110000B ;These bits on if monochrome
  1487. COLOR     EQU       11101111B ;Mask to make BIOS think of the color board
  1488. BIOSDATA  ENDS                ;End of interesting part
  1489. ;
  1490. ;         Next, describe some values for interrupts and functions
  1491. ;
  1492. DOS       EQU       21H       ;DOS Function Handler INT code
  1493. PRTMSG    EQU       09H       ;Function code to print a message
  1494. KBD       EQU       16H       ;BIOS keyboard services INT code
  1495. GETKEY    EQU       00H       ;Function code to read a character
  1496. SCREEN    EQU       10H       ;BIOS Screen services INT code
  1497. MONOINIT  EQU       02H       ;Value to initialize monochrome screen
  1498.  
  1499.  
  1500. IBM PC Assembly Language Tutorial                                        25
  1501.  
  1502.  
  1503. ;COLORINIT EQU       03H       ;Value to initialize color screen (80x25)
  1504. COLORINIT EQU      01H       ;Value to initialize color screen (40X25)
  1505. ;
  1506. ;         Now, describe our own segment
  1507. ;
  1508. SETSCRN   SEGMENT             ;Set operating segment for CODE and DATA
  1509. ;
  1510.           ASSUME CS:SETSCRN,DS:SETSCRN,ES:SETSCRN,SS:SETSCRN    ;All segments
  1511. ;
  1512.           ORG       100H      ;Begin assembly at standard .COM offset
  1513. ;
  1514. MAIN      PROC      NEAR      ;COM files use NEAR linkage
  1515.           JMP       BEGIN     ;And, it is helpful to put the data first, but
  1516. ;                             ;then you must branch around it.
  1517. ;
  1518. ;         Data used in SETSCRN
  1519. ;
  1520. CHANGELOC   DD      EQUIP     ;Location of the EQUIP, recorded as far pointer
  1521. MONOPROMPT  DB      'Please press the plus ( + ) key.$'    ;User sees on mono
  1522. COLORPROMPT DB      'Please press the minus ( - ) key.$'   ;User sees on color
  1523.  
  1524.  
  1525. Several things are illustrated on this page.  First, in addition to titles,
  1526. the assembler supports subtitles:  hence the SUBTTL pseudo-op.  Second, the
  1527. PAGE pseudo-op can be used to go to a new page in the listing.  You see an
  1528. example here of the DSECT-style segment in the "SEGMENT AT 40H".  Here, our
  1529. our interest is in correctly describing the location of some data in the
  1530. BIOS work area which really is located at segment 40H.
  1531.  
  1532. You will also see illustrated the EQU instruction, which just gives a sym-
  1533. bolic name to a number.  I don't make a fetish of giving a name to every
  1534. single number in a program.  I do feel strongly, though, that interrupts
  1535. and function codes, where the number is arbitrary and the function being
  1536. performed is the thing of interest, should always be given symbolic names.
  1537.  
  1538. One last new element in this section is the define doubleword (DD) instruc-
  1539. tion.  A doubleword constant can refer, as in this case, to a location in
  1540. another segment.  The assembler will be happy to use information at its
  1541. disposal to properly assemble it.  In this case, the assembler knows that
  1542. EQUIP is offset 10 in the segment BIOSDATA which is at 40H.
  1543.  
  1544.           SUBTTL -- Perform function
  1545.           PAGE
  1546. BEGIN:    CALL      MONOON                  ;Turn on mono display
  1547.           MOV       DX,OFFSET MONOPROMPT          ;GET MONO PROMPT
  1548.           MOV       AH,PRTMSG                     ;ISSUE
  1549.           INT       DOS                           ;IT
  1550.           CALL      COLORON                 ;Turn on color display
  1551.           MOV       DX,OFFSET COLORPROMPT         ;GET COLOR PROMPT
  1552.           MOV       AH,PRTMSG                     ;ISSUE
  1553.           INT       DOS                           ;IT
  1554.           MOV       AH,GETKEY               ;Obtain user response
  1555.           INT       KBD
  1556.           CMP       AL,'+'                  ;Does he want MONO?
  1557.           JNZ       NOMONO
  1558.  
  1559.  
  1560. IBM PC Assembly Language Tutorial                                        26
  1561.  
  1562.  
  1563.           CALL      MONOON                  ;yes.  give it to him
  1564. NOMONO:   RET
  1565. MAIN      ENDP
  1566.  
  1567.  
  1568. The main code section makes use of subroutines to keep the basic flow sim-
  1569. ple.  About all that's new to you in this section is the use of the BIOS
  1570. interrupt KBD to read a character from the keyboard.
  1571.  
  1572. Now for the subroutines, MONOON and COLORON:
  1573.  
  1574.           SUBTTL -- Routines to turn monitors on
  1575.           PAGE
  1576. MONOON    PROC      NEAR                ;Turn mono on
  1577.           LES       DI,CHANGELOC        ;Get location to change
  1578.           ASSUME    ES:BIOSDATA         ;TELL ASSEMBLER ABOUT CHANGE TO ES
  1579.           OR        EQUIP,MONO
  1580.           MOV       AX,MONOINIT         ;Get screen initialization value
  1581.           INT       SCREEN              ;Initialize screen
  1582.           RET
  1583. MONOON    ENDP
  1584. COLORON   PROC      NEAR                ;Turn color on
  1585.           LES       DI,CHANGELOC        ;Get location to change
  1586.           ASSUME    ES:BIOSDATA         ;TELL ASSEMBLER ABOUT CHANGE TO ES
  1587.           AND       EQUIP,COLOR
  1588.           MOV       AX,COLORINIT        ;Get screen initialization value
  1589.           INT       SCREEN              ;Initialize screen
  1590.           RET
  1591. COLORON   ENDP
  1592. SETSCRN   ENDS                          ;End of segment
  1593.           END       MAIN                ;End of assembly; execution at MAIN
  1594.  
  1595.  
  1596. The instructions LES and LDS are useful ones for dealing with doubleword
  1597. addresses.  The offset is loaded into the operand register and the segment
  1598. into ES (for LES) or DS (for LDS).  By telling the assembler, with an
  1599. ASSUME, that ES now addresses the BIOSDATA segment, it is able to correctly
  1600. assemble the OR and AND instructions which refer to the EQUIP byte.  An ES
  1601. segment prefix is added.
  1602.  
  1603. To understand the action here, you simply need to know that flags in that
  1604. particular byte control how the BIOS screen service initializes the adapt-
  1605. ers.  BIOS will only work with one adapter at a time; by setting the equip-
  1606. ment flags to show one or the other as installed and calling BIOS screen
  1607. initialization, we achieve the desired effect.
  1608.  
  1609. The rest is up to you.
  1610.  
  1611.  
  1612.  
  1613.  
  1614.  
  1615.  
  1616.  
  1617.  
  1618.  
  1619.  
  1620. IBM PC Assembly Language Tutorial                                        27:  hence the SUBT