home *** CD-ROM | disk | FTP | other *** search
/ HAM Radio 1 / HamRadio.cdr / misc / bpq403a / int14.doc < prev    next >
Encoding:
Text File  |  1990-04-07  |  4.8 KB  |  161 lines
  1. The following contains information extracted from AA4RE's MBBIOS
  2. Documentation. It has been modified to conform to my COMBIOS
  3. emulation.
  4.  
  5. MBBIOS supports the standard INT 14 calls plus the extended ones as
  6. defined by Jeff Jacobsen, WA7MBL for his BBS program.  These are
  7. explained below.  AH=0 to AH=3 are identical to the IBM BIOS definition.
  8.  
  9. DX must contain the port number, which start at zero, so for COM1 set 
  10. DX=0, COM2 set DX=1, etc.
  11.  
  12.  
  13. AH = 0     Initialize
  14. ---------------------
  15.  
  16. This is provided for compatibility only. It has no effect except to
  17. return the current (virtual) LSR in AH, bit zero of which is set if
  18. any characters remain in the rx buffer, and virtual MSR in AL. 
  19.  
  20.  
  21.     THE MSR BITS SUPPORTED ARE DCD=CONNECTED
  22.                    CTS=NOT BUSY
  23.  
  24.     AN ATTEMPT IS ALSO MADE TO MAINTAIN DELTA BITS
  25.  
  26.          BIT 7 - Receive Line Signal Detect (DCD)
  27.          6 - Ring Indicator (Not supported) 
  28.              5 - Data Set Ready (Always on)
  29.              4 - Clear To Send
  30.  
  31.              3 - Delta  RLSD ( ie state has changed since last
  32.                                   access)
  33.              2 - Not Supported (Trailing Edge Ring Detect)
  34.              1 - Not Supported (Delta DSR)
  35.              0 - Delta CTS
  36.  
  37.  
  38. AH = 1     Send Character
  39. -------------------------
  40.  
  41. AL contains the character to send.  Return values are the same as above.
  42.  
  43.  
  44. AH = 2     Receive Character
  45. ----------------------------
  46.  
  47. On return, AL contains the character received.  AH contains the
  48. virtual LSR. Again, AH bit 0 indicates if there is additional characters 
  49. in the buffer.  This routine does NOT timeout while waiting for a character 
  50. but will hang indefinitely waiting for a character to appear.
  51.  
  52. AH = 3     Return Status
  53. ------------------------
  54.  
  55. Return values are the same as returned by the Initialize routine.
  56.  
  57. AH = 4     Inquiry
  58. ------------------
  59.  
  60. Returns AX and BX set to 0AA55H.  This call is used to see if the
  61. particular port is defined in TNCPORTLIST. Note that COMBIOS/MBBIOS
  62. set AX, but not BX
  63.  
  64.  
  65. AH = 5     Drop RTS
  66. -------------------
  67.  
  68. This drops (virtual) DTR and RTS.  Will stop higher level code sending
  69. any more data into the receive buffer. No return value.
  70.  
  71. AH = 6     Raise RTS
  72. --------------------
  73.  
  74. Raise DTR and RTS.  No return value.
  75.  
  76. AH = 7     Send Break
  77. ---------------------
  78.  
  79. Generates a "Break".  Returns the virtual TNC to Command mode from Converse
  80. or Transparent mode. No return value.
  81.  
  82. AH = 8     Non-destructive Read
  83. -------------------------------
  84.  
  85. Returns the next character in the buffer in AL without removing it from
  86. the buffer.  AH value defined as in AH=2 so you can use the Data Ready
  87. bit to check to see if you really did get a character.
  88.  
  89. AH = 9     Set/Get options
  90. --------------------------
  91.  
  92. Not implemented.
  93.  
  94.  
  95.  
  96. The following functions have been implemented to support AA4RE BBS,
  97. using PK Hostmode. They should work in normal mode, but have not been
  98. tested very extensively!
  99.  
  100. AH = A     Write buffer
  101. -----------------------
  102.  
  103. Sends CX characters starting at DI:ES.  Upon return, DI will be updated
  104. and CX will contain the unsent character count.  Unsent characters could
  105. result from either BUFFER FULL or hardware handshake is OFF.  AX will
  106. be set as in AH=3 (Status) above.
  107.  
  108. AH = B Read buffer
  109. ------------------
  110.  
  111. Receives up to CX characters starting at DI:ES.  Upon return, CX set to
  112. actual count read and DI is updated.  If the buffer is empty, return is
  113. immediate with CX = 0. The function will return a 'logical' line, up
  114. to a CR in normal mode, or 17H in Host Mode. On return, AL contains the MSR
  115. and AH has the virtual LSR. Again, AH bit 0 indicates if there are additional 
  116. characters in the buffer.
  117.  
  118.  
  119.  
  120.  
  121.  
  122. The following additional 'COMBIOS' calls are supported in versions
  123. 3.50 and above.
  124.  
  125.  
  126. AH = 1F - G8BPQ NODE-SPECIFIC COMBIOS EXTENTIONS 
  127. ------------------------------------------------
  128.  
  129. AL = 0 - Return Version and Node DS
  130.  
  131. Returns: AX=Node data segment
  132.      DH=Major Version
  133.      DL=Minor Version    - ie for version 3.50, DH=3, DL=50
  134.  
  135.  
  136. AL = 1 - Return ES:SI pointing to connected call (in AX25 firm), or
  137.        SI=0 if not connected. If connected, returns session type 
  138.        in AH, and port number (if L2 session) in AL. Session
  139.        type is a bit significant field defined as follows:
  140.  
  141.        ;
  142.        ;    CIRCUITTYPE EQUATES
  143.         ;
  144.        L2LINK    EQU    1
  145.        SESSION    EQU    10B
  146.        UPLINK    EQU    100B
  147.        DOWNLINK    EQU    1000B
  148.        HOST        EQU    10000B
  149.     
  150.  
  151. AL = 2 = Return (in AH) number of unacked packets on connection
  152.  
  153.  
  154. AL = 10H Disconnect user form virtual TNC, and return user to Node
  155.  
  156.  
  157. The segment registers are saved, (unless retuning a value), but other 
  158. registers may be destroyed.
  159.  
  160.  
  161.