home *** CD-ROM | disk | FTP | other *** search
/ PC Press: Internet / PC_PRESS.ISO / software / dos / comm / mx5.arj / MX5.DOC < prev    next >
Encoding:
Text File  |  1989-05-18  |  4.9 KB  |  201 lines
  1. MX5 Extended FOSSIL Functions (Int 14h)
  2. (Also see FOSSIL.DOC for complete list of supported functions.)
  3.  
  4. AH = 0E0h (MX5 Extended FOSSIL Functions)
  5. AL = Subfunction as Follows:
  6.  
  7. -------------------------------------------------------------
  8. 00h        Return MNP Status Block
  9. -------------------------------------------------------------
  10.  
  11. Purpose:    Returns MNP related information.
  12.  
  13.  
  14. On Entry    Register Contents
  15. --------    -----------------
  16. AH        E0h
  17. AL        00h
  18. DX        Port (0-3)
  19.  
  20. On Return    Register Contents
  21. ---------    -----------------
  22. ES:BX        pointer to a structure as follows:
  23.  
  24.         mnp_active    db    ?    ;0=no, 1=yes
  25.         level        db    ?    ;MNP level (2,4,5)
  26.         series_id    db    ?    ;from other MNP entity
  27.         tot_tx        dd    ?    ;total packets
  28.         dup_tx        dd    ?    ;number of duplicates
  29.         max_tx        dd    ?    ;max speed
  30.         tot_rx        dd    ?    ;total packets
  31.         dup_rx        dd    ?    ;number of duplicates
  32.         max_rx        dd    ?    ;max speed
  33.  
  34. -------------------------------------------------------------
  35. 01h        Get/Set MNP Level
  36. -------------------------------------------------------------
  37.  
  38. Purpose:    Gets or Sets the Maximum MNP level.
  39.  
  40. On Entry    Register Contents
  41. --------    -----------------
  42. AH        E0h
  43. AL        01h
  44. BL        MNP Level
  45.         00h; None
  46.         02h; Level 2
  47.         04h; Level 4
  48.         05h; Level 5 (default)
  49. BH        00h; Get MNP Level
  50.         01h; Set MNP Level
  51. DX        Port (0-3)
  52.  
  53. On Return    Register Contents
  54. ---------    -----------------
  55. BL        MNP Level (see BL above)
  56.  
  57. -------------------------------------------------------------
  58. 02h        Get/Set MNP Orig/Ans Mode
  59. -------------------------------------------------------------
  60.  
  61. Purpose:    Gets or Sets Originate or Answer mode for
  62.         an MNP connection.
  63.  
  64. On Entry    Register Contents
  65. --------    -----------------
  66. AH        E0h
  67. AL        02h
  68. BL        Orig/Ans Mode
  69.         00h; Orig Mode (default)
  70.         01h; Answer Mode
  71. BH        00h; Get Mode
  72.         01h; Set Mode
  73. DX        Port (0-3)
  74.  
  75. On Return    Register Contents
  76. ---------    -----------------
  77. BL        Mode (see BL above)
  78.  
  79. -------------------------------------------------------------
  80. 03h        Get/Set MNP Wait Tics
  81. -------------------------------------------------------------
  82.  
  83. Purpose:    Gets or Sets number of tics (55 msecs/tic)
  84.         after Carrier Detect raises until an MNP
  85.         connection is attempted.
  86.  
  87. On Entry    Register Contents
  88. --------    -----------------
  89. AH        E0h
  90. AL        03h
  91. BL        MNP Wait Tics (default=14)
  92. BH        0h; Get MNP Wait Tics
  93.         1h; Set MNP Wait Tics
  94. DX        Port (0-3)
  95.  
  96. On Return    Register Contents
  97. ---------    -----------------
  98. BL        MNP Wait Tics (see BL above)
  99.  
  100. -------------------------------------------------------------
  101. 04h        Get/Set MNP Connect Sound Level
  102. -------------------------------------------------------------
  103.  
  104. Purpose:    Gets or Sets wether MX5 will "play"
  105.         a tune after an MNP connection.  If an
  106.         MNP connection is successful, 3 high
  107.         beeps are played.  If the MNP connection
  108.         is not successful, a high/low beep is
  109.         played.
  110.  
  111. On Entry    Register Contents
  112. --------    -----------------
  113. AH        E0h
  114. AL        03h
  115. BL        MNP Sound
  116.         00h; Sounds are not played
  117.         01h; Sounds are played (default)
  118. BH        00h; Get Sound state
  119.         01h; Set Sound state
  120. DX        Port (0-3)
  121.  
  122. On Return    Register Contents
  123. ---------    -----------------
  124. BL        MNP Sound state (see BL above)
  125.  
  126. -------------------------------------------------------------
  127. 05h        Remove MX5 from Memory
  128. -------------------------------------------------------------
  129.  
  130. Purpose:    Requests MX5 to remove itself from memory.
  131.         MX5 will de-initalize the current com port
  132.         (hanging up if online), restore all hooked
  133.         interupt vectors, and return it's MCB
  134.         address so it may be freed.
  135.  
  136. **** Note:    Place the value returned in BX into ES and
  137. ****        call DOS function 49h to release MX5's MCB
  138. ****        (see example below).
  139.  
  140. On Entry    Register Contents
  141. --------    -----------------
  142. AH        E0h
  143. AL        05h
  144.  
  145. On Return    Register Contents
  146. ---------    -----------------
  147. BX        MCB segment address or 0 if unsuccessful
  148.  
  149.  
  150. Example:    mov    ah,0e0h        ;tell MX5 to uninstall
  151.         mov    al,5
  152.         int    14h
  153.         cmp    bx,0
  154.         je    cant_uninstall    ;jump if unsuccessful
  155.         mov    es,bx
  156.         mov    ah,49h        ;free MX5's memory
  157.         int    21h
  158.  
  159. -------------------------------------------------------------
  160. 06h        Return MX5 Version Number
  161. -------------------------------------------------------------
  162.  
  163. Purpose:    Returns the major and minor version of MX5
  164.  
  165. On Entry    Register Contents
  166. --------    -----------------
  167. AH        E0h
  168. AL        06h
  169. BX        00h
  170.  
  171. On Return    Register Contents
  172. ---------    -----------------
  173. AH        Major version number
  174. AL        Minor version number
  175. BX        "MX" (4D58h)
  176.  
  177. Example:    mov    ah,0e0h        ;see if MX5 is installed
  178.         mov    al,6
  179.         int    14h
  180.         cmp    bx,'MX'
  181.         jne    not_installed    ;jump if MX5 not installed
  182.  
  183. -------------------------------------------------------------
  184. 07h        Wait CX Tics
  185. -------------------------------------------------------------
  186.  
  187. Purpose:    Waits the number of tics specified in CX
  188.  
  189. On Entry    Register Contents
  190. --------    -----------------
  191. AH        E0h
  192. AL        07h
  193. CX        Tics to Wait
  194.  
  195. On Return    Register Contents
  196. ---------    -----------------
  197. nothing
  198.  
  199.  
  200.  
  201.