home *** CD-ROM | disk | FTP | other *** search
/ High Voltage Shareware / high1.zip / high1 / DIR24 / TEL2307B.ZIP / N14NOTES.TXT < prev    next >
Text File  |  1993-11-19  |  4KB  |  92 lines
  1. This information was accidentally left out of the documention for
  2. using the net14 driver.  The net14 driver is a shell which installs
  3. inself to manage the interrupt 14h for serial communications and
  4. re-direct int 14h reads and writes to/from the ethernet network.
  5. It then starts up another program which uses the int 14h interface
  6. with the following programming interface:
  7.  
  8. Int 14h Function 00H:   Initialize communications
  9.     Call With:
  10.         AH = 00H
  11.         AL = Ignored (serial communication programs use this for
  12.                 additional communication parameters, which are un-used
  13.                 in the net14 driver).
  14.         DX = Comm. port number to initialize
  15.  
  16.     Returns:
  17.         AH is returned with the port status:
  18.             Bit:        Meaning (if set):
  19.             ----        -----------------
  20.              7          Timed-out
  21.              6          Transmit shift register empty
  22.              5          Transmit holding register empty
  23.              4          Break detected
  24.              3          Framing error detected
  25.              2          Parity error detected
  26.              1          Overrun error detected
  27.              0          Receive data ready
  28.  
  29.         AL has the modem status:
  30.             Bit:        Meaning (if set):
  31.             ----        -----------------
  32.              7          Receive line signal detect
  33.              6          Ring indicator
  34.              5          Data-set-ready
  35.              4          Clear-to-send
  36.              3          Change in receive line signal detect
  37.              2          Trailing edge ring indicator
  38.              1          Change in data-set-ready status
  39.              0          Change in clear-to-send status
  40.  
  41. Int 14h Function 01H:   Send Character
  42.     Call With:
  43.         AH = 01H
  44.         AL = Character
  45.         DX = Comm. port to send through
  46.     Returns:
  47.         Bit 7 of AH is zero if successful, otherwise Bit 7 of AH is one.
  48.  
  49. Int 14h Function 02H:   Receive Character
  50.     Call With:
  51.         AH = 02H
  52.         DX = Comm. port to receive from
  53.  
  54.     Returns:
  55.         Bit 7 of AH is zero if successful, otherwise Bit 7 of AH is one.
  56.         Character read is in AL if the call was successful.
  57.  
  58. Int 14h Function 03H:   Get Comm. Port Status
  59.     Call With:
  60.         AH = 03H
  61.         DX = Comm. port to get status of
  62.  
  63.     Returns:
  64.         AH is returned with the port status, and AL has the modem status.
  65.         (See function 00H above)
  66.  
  67.  
  68. Notes:
  69.     In order to establish a connection, the following steps must be
  70. followed in order:
  71.  
  72. 1.  Call function 00H with the port to initialize.
  73. 2.  Send the following sequence to the port: one ascii 02 code
  74.     (control-B), the name of the machine to connect to (or its
  75.     IP address) one character at a time, and the ascii 03 code
  76.     (control-C).
  77.  
  78.     Following a connection being established, the net14 driver
  79. will ignore any control-C's and control-B's in the data stream
  80. send or received.  A connection can be closed by re-initializing
  81. the comm. port (function 00H).
  82.  
  83. So, to use net14 with another application, first verify that the other
  84. application uses interrupt 14 to write to the communications port.
  85. In Kermit, for instance, this is done with "set port bios1".  If the
  86. application is using interrupt 14 to access the port, it will have
  87. initialized it for you.  Now send the ^Bhostname^C sequence out.
  88. Once again, in kermit this is done by going to connect mode with
  89. "connect" and then typing ^Bhostname^C.  Net14 will deinstall itself
  90. and close all connections when you exit the application.
  91.  
  92.