home *** CD-ROM | disk | FTP | other *** search
/ CP/M / CPM_CDROM.iso / cpm / utils / asmutl / z80asm24.lbr / Z80.DZC / Z80.DOC
Encoding:
Text File  |  1987-10-13  |  12.8 KB  |  402 lines
  1.                 Z-80 Macro Library Documentation
  2.                 --------------------------------
  3.  
  4. I.
  5.         The purpose of this library is to enable the assembly of the Z-80
  6.     instruction set on a CP/M sytem using the CP/M MAC macro assembler.
  7.  
  8.         This library is invoked with the pseudo-op:
  9.  
  10.                 "  MACLIB  Z80  "
  11.  
  12. II.
  13.         The following symbols and notations are used in the individual macro
  14.     descriptions;
  15.  
  16.         r - Any of the 8 bit registers: A, B, C, D, E, H, L, or M
  17.         rr - Any of the 16 bit register pairs: BC, DE, HL, or SP
  18.         nn - 8 bit immediate data (0 through 255)
  19.         d  - 8 bit signed displacment (-128 through +127)
  20.         nnnn - 16 bit address or immediate data (0 through 65535)
  21.         b  - bit number (0-7, 7 is most significant, 0 is least)
  22.         addr - 16 bit address within PC+127 through PC-128
  23.         m(zzz) - Memory at address "zzz"
  24.  
  25. III.
  26.  
  27.  MACLIB ver.              Zilog ver                TDL ver
  28. --------------          -------------           -------------
  29.  
  30. LDX     r,d             LD      r,(IX+d)        MOV     r,d(IX)
  31.     Load register from indexed memory (with IX)
  32.  
  33. LDY     r,d             LD      r,(IY+d)        MOV     r,d(IY)
  34.     Load register from indexed memory (with IY)
  35.  
  36. STX     r,d             LD      (IX+d),r        MOV     d(IX),r
  37.     Store register to indexed memory (with IX)
  38.  
  39. STY     r,d             LD      (IY+d),r        MOV     d(IY),r
  40.     Store register to indexed memory (with IY)
  41.  
  42. MVIX    nn,d            LD      (IX+d),nn       MVI     d(IX)
  43.     Move immediate to indexed memory (with IX)
  44.  
  45. MVIY    nn,d            LD      (IY+d),nn       MVI     d(IY)
  46.     Move immediate to indexed memory (with IY)
  47.  
  48. LDAI                    LD      A,I             LDAI
  49.     Move I to A
  50.  
  51. LDAR                    LD      A,R             LDAR
  52.     Move R to A
  53.  
  54. STAI                    LD      I,A             STAI
  55.     Move A to I
  56.  
  57. STAR                    LD      R,A             STAR
  58.     Move A to R
  59.  
  60. LXIX    nnnn            LD      IX,nnnn         LXI     IX,nnnn
  61.     Load IX immediate (16 bits)
  62.  
  63. LXIY    nnnn            LD      IY,nnnn         LXI     IY,nnnn
  64.     Load IY immediate (16 bits)
  65.  
  66. LBCD    nnnn            LD      BC,(nnnn)       LBCD    nnnn
  67.     Load BC direct (from memory at nnnn)
  68.  
  69. LDED    nnnn            LD      DE,(nnnn)       LDED    nnnn
  70.     Load DE direct
  71.  
  72. LSPD    nnnn            LD      SP,(nnnn)       LSPD    nnnn
  73.     Load SP direct
  74.  
  75. LIXD    nnnn            LD      IX,(nnnn)       LIXD    nnnn
  76.     Load IX direct
  77.  
  78. LIYD    nnnn            LD      IY,(nnnn)       LIYD    nnnn
  79.     Load IY direct
  80.  
  81. SBCD    nnnn            LD      (nnnn),BC       SBCD    nnnn
  82.     Store BC direct (to memory at nnnn)
  83.  
  84. SDED    nnnn            LD      (nnnn),DE       SDED    nnnn
  85.     Store DE direct
  86.  
  87. SSPD    nnnn            LD      (nnnn),SP       SSPD    nnnn
  88.     Store SP direct
  89.  
  90. SIXD    nnnn            LD      (nnnn),IX       SIXD    nnnn
  91.     Store IX direct
  92.  
  93. SIYD    nnnn            LD      (nnnn),IY       SIYD    nnnn
  94.     Store IY direct
  95.  
  96. SPIX                    LD      SP,IX           SPIX
  97.     Copy IX to the SP
  98.  
  99. SPIY                    LD      SP,IY           SPIY
  100.     Copy IY to the SP
  101.  
  102. PUSHIX                  PUSH    IX              PUSH    IX
  103.     Push IX into the stack
  104.  
  105. PUSHIY                  PUSH    IY              PUSH    IY
  106.     Push IY into the stack
  107.  
  108. POPIX                   POP     IX              POP     IX
  109.     Pop IX from the stack
  110.  
  111. POPIY                   POP     IY              POP     IY
  112.     Pop IY from the stack
  113.  
  114. EXAF                    EX      AF,AF'          EXAF
  115.     Exchange AF and the alternate, AF'
  116.  
  117. EXX                     EXX                     EXX
  118.     Exchange BC DE HL with BC' DE' HL'
  119.  
  120. XTIX                    EX      (SP),IX         XTIX
  121.     Exchange IX with the top of the stack
  122.  
  123. XTIY                    EX      (SP),IY         XTIY
  124.     Exchange IY with the top of the stack
  125.  
  126. LDI                     LDI                     LDI
  127.     Move m(HL) to m(DE), increment DE and HL, decrement BC
  128.  
  129. LDIR                    LDIR                    LDIR
  130.     Repeat LDI until BC = 0
  131.  
  132. LDD                     LDD                     LDD
  133.     Move m(HL) to m(DE), decrement HL, DE, and BC
  134.  
  135. LDDR                    LDDR                    LDDR
  136.     Repeat LDD until BC = 0
  137.  
  138. CCI                     CPI                     CCI
  139.     Compare A with m(HL), increment HL, decrement BC
  140.  
  141. CCIR                    CPIR                    CCIR
  142.     Repeat CCI until BC = 0  or  A = m(HL)
  143.  
  144. CCD                     CPD                     CCD
  145.     Compare A with m(HL), decrement HL and BC
  146.  
  147. CCDR                    CPDR                    CCDR
  148.     Repeat CCD until BC = 0 or A = m(HL)
  149.  
  150. ADDX    d               ADD     (IX+d)          ADD     d(IX)
  151.     Indexed add to A
  152.  
  153. ADDY    d               ADD     (IY+d)          ADD     d(IY)
  154.     Indexed add to A
  155.  
  156. ADCX    d               ADC     (IX+d)          ADC     d(IX)
  157.     Indexed add with carry
  158.  
  159. ADCY    d               ADC     (IY+d)          ADC     d(IY)
  160.     Indexed add with carry
  161.  
  162. SUBX    d               SUB     (IX+d)          SUB     d(IX)
  163.     Indexed subtract
  164.  
  165. SUBY    d               SUB     (IY+d)          SUB     d(IY)
  166.     Indexed Subtract
  167.  
  168. SBCX    d               SBC     (IX+d)          SBB     d(IX)
  169.     Indexed subtract with "borrow"
  170.  
  171. SBCY    d               SBC     (IY+d)          SBB     d(IY)
  172.     Indexed subtract with borrow
  173.  
  174. ANDX    d               AND     (IX+d)          ANA     d(IX)
  175.     Indexed logical and
  176.  
  177. ANDY    d               AND     (IY+d)          ANA     d(IY)
  178.     Indexed logical and
  179.  
  180. XORX    d               XOR     (IX+d)          XRA     d(IX)
  181.     Indexed logical exclusive or
  182.  
  183. XORY    d               XOR     (IY+d)          XRA     d(IY)
  184.     Indexed logical exclusive or
  185.  
  186. ORX     d               OR      (IX+d)          ORA     d(IX)
  187.     Indexed logical or
  188.  
  189. ORY     d               OR      (IY+d)          ORA     d(IY)
  190.     Indexed logical exclusive or
  191.  
  192. CMPX    d               CP      (IX+d)          CMP     d(IX)
  193.     Indexed compare
  194.  
  195. CMPY    d               CP      (IY+d)          CMP     d(IY)
  196.     Index compare
  197.  
  198. INRX    d               INC     (IX+d)          INR     d(IX)
  199.     Increment memory at m(IX+d)
  200.  
  201. INRY    d               INC     (IY+d)          INR     d(IY)
  202.     Increment memory at m(IY+d)
  203.  
  204. DCRX    d               INC     (IX+d)          INR     d(IX)
  205.     Decrement memory at m(IX+d)
  206.  
  207. DCRY    d               DEC     (IY+d)          DCR     d(IY)
  208.     Decrement memory at m(IX+d)
  209.  
  210. NEG                     NEG                     NEG
  211.     Negate A (two's complement)
  212.  
  213. IM0                     IM0                     IM0
  214.     Set interrupt mode 0
  215.  
  216. IM1                     IM1                     IM1
  217.     Set interrupt mode 1
  218.  
  219. IM2                     IM2                     IM2
  220.     Set interrupt mode 2
  221.  
  222. DADC    rr              ADC     HL,rr           DADC    rr
  223.     Add with carry rr to HL
  224.  
  225. DSBC    rr              SBC     HL,rr           DSBC   rr
  226.     Subtract with "borrow" rr from HL
  227.  
  228. DADX    rr              ADD     IX,rr           DADX    rr
  229.     Add rr to IX (rr may be BC, DE, SP, IX)
  230.  
  231. DADY    rr              ADD     IY,rr           DADY   rr
  232.     Add rr to IY (rr may be BC, DE, SP, IY)
  233.  
  234. INXIX                   INC     IX              INX     IX
  235.     Increment IX
  236.  
  237. INXIY                   INC     IY              INX     IY
  238.     Increment IY
  239.  
  240. DCXIX                   DEC     IX              DCX     IX
  241.     Decrement IX
  242.  
  243. DCXIY                   DEC     IY              DCX     IY
  244.     Decrement IY
  245.  
  246. BIT     b,r             BIT     b,r             BIT     b,r
  247.     Test bit b in register r
  248.  
  249. SETB    b,r             SET     b,r             SET     b,r
  250.     Set bit b in register r
  251.  
  252. RES     b,r             RES     b,r             RES     b,r
  253.     Reset bit b in register r
  254.  
  255. BITX    b,d             BIT     b,(IX+d)        BIT     b,d(IX)
  256.     Test bit b in memory at m(IX+d)
  257.  
  258. BITY    b,d             BIT     b,(IY+d)        BIT     b,d(IY)
  259.     Test bit b in memory at m(IY+d)
  260.  
  261. SETX    b,d             SET     b,(IX+d)        SET     b,d(IX)
  262.     Set bit b in memory at m(IX+d)
  263.  
  264. SETY    b,d             SET     b,(IY+d)        SET     b,d(IY)
  265.     Set bit b in memory at m(IY+d)
  266.  
  267. RESX    b,d             RES     b,(IX+d)        RES     b,d(IX)
  268.     Reset bit b in memory at m(IX+d)
  269.  
  270. RESY    b,d             RES     b,(IY+d)        RES     b,d(IY)
  271.     Reset bit b in memory at m(IY+d)
  272.  
  273. JR      addr            JR      addr-$          JMPR    addr
  274.     Jump relative unconditional
  275.  
  276. JRC     addr            JR      C,addr-$        JRC     addr
  277.     Jump relative if Carry indicator true
  278.  
  279. JRNC    addr            JR      NC,addr-$       JRNC    addr
  280.     Jump relative if carry indicator false
  281.  
  282. JRZ     addr            JR      Z,addr-$        JRC     addr
  283.     Jump relative if Zero indicator true
  284.  
  285. JRNZ    addr            JR      NZ,addr-$       JRNZ    addr
  286.     Jump relative if Zero indicator false
  287.  
  288. DJNZ    addr            DJNZ    addr-$          DJNZ    addr
  289.     Decrement B, jump relative if non-zero
  290.  
  291. PCIX                    JMP     (IX)            PCIX
  292.     Jump to address in IX ie, Load PC from IX
  293.  
  294. PCIY                    JMP     (IY)            PCIY
  295.     Jump to address in IY
  296.  
  297. RETI                    RETI                    RETI
  298.     Return from interrupt
  299.  
  300. RETN                    RETN                    RETN
  301.     Return from non-maskable interrupt
  302.  
  303. INP     r               IN      r,(C)           INP     r
  304.     Input from port C to register r
  305.  
  306. OUTP    r               OUT     (C),r           OUTP    r
  307.     Output from register r to port (C)
  308.  
  309. INI                     INI                     INI
  310.     Input from port (C) to m(HL), increment HL, decrement b
  311.  
  312. INIR                    INIR                    INIR
  313.     Input from port (C) to m(HL), increment HL, decrement B, repeat if B <> 0
  314.  
  315. OUTI                    OTI                     OUTI
  316.     Output from m(HL) to port (C), increment HL, decrement B
  317.  
  318. OUTIR                   OTIR                    OUTIR
  319.     Repeat OUTI until B = 0
  320.  
  321. IND                     IND                     IND
  322.     Input from port (C) to m(HL), decrement HL & B
  323.  
  324. INDR                    INDR                    INDR
  325.     Repeat IND until B = 0
  326.  
  327. OUTD                    OTD                     OUTD
  328.     Output from m(HL) to port (C), decrement HL & B
  329.  
  330. OUTDR                   OTDR                    OUTDR
  331.     Repeat OUTD until B = 0
  332.  
  333. RLCR    r               RLC     r               RLCR    r
  334.     Rotate left circular register
  335.  
  336. RLCX    d               RLC     (IX+d)          RLCR    d(IX)
  337.     Rotate left circular indexed memory
  338.  
  339. RLCY    d               RLC     (IY+d)          RLCR    d(IY)
  340.     Rotate left circular indexed memory
  341.  
  342. RALR    r               RL      r               RALR    r
  343.     Rotate left arithmetic register
  344.  
  345. RALX    d               RL      (IX+d)          RALR    d(IX)
  346.     Rotate left arithmetic indexed memory
  347.  
  348. RALY    d               RL      (IY+d)          RALR    d(IY)
  349.     Rotate left arithmetic indexed memory
  350.  
  351. RRCR    r               RRC     r               RRCR    r
  352.     Rotate right circular register
  353.  
  354. RRCX    d               RRC     (IX+d)          RRCR    d(IX)
  355.     Rotate right circular indexed
  356.  
  357. RRCY   d               RRC     (IY+d)          RRCR    d(IY)
  358.     Rotate right circular indexed
  359.  
  360. RARR    r               RR      r               RARR    r
  361.     Rotate right arithmetic register
  362.  
  363. RARX    d               RR      (IX+d)          RARR    d(IX)
  364.     Rotate right arithmetic indexed memory
  365.  
  366. RARY    d               RR      (IY+d)          RARR    d(IY)
  367.     Rotate right arithmetic indexed memory
  368.  
  369. SLAR    r               SLA     r               SLAR    r
  370.     Shift left register
  371.  
  372. SLAX    d               SLA     (IX+d)          SLAR    d(IX)
  373.     Shift left indexed memory
  374.  
  375. SLAY    d               SLA     (IY+d)          SLAR    d(IY)
  376.     Shift left indexed memory
  377.  
  378. SRAR    r               SRA     r               SRAR    r
  379.     Shift right arithmetic register
  380.  
  381. SRAX    d               SRA     (IX+d)          SRAR    d(IX)
  382.     Shift right arithmetic indexed memory
  383.  
  384. SRAY    d               SRA     (IY+d)          SRAR    d(IY)
  385.     Shift right arithmetic indexed memory
  386.  
  387. SRLR    r               SRL     r               SRLR    r
  388.     Shift right logical register
  389.  
  390. SRLX    d               SRL     (IX+d)          SRLR    d(IX)
  391.     Shift right logical indexed memory
  392.  
  393. SRLY    d               SRL     (IY+d)          SRLR    d(IY)
  394.     Shift right logical indexed memory
  395.  
  396. RLD                     RLD                     RLD
  397.     Rotate left digit
  398.  
  399. RRD                     RRD                     RRD
  400.     Rotate right digit
  401.  
  402.