[Back to COMM SWAG index]  [Back to Main SWAG index]  [Original]

{---------------------------------------------------------}
{  Project : Async12 for Windows                          }
{  By      : Ir. G.W van der Vegt                         }
{---------------------------------------------------------}
{  Based on the following TP product :                    }
{                                                         }
{  ASYNC12 - Interrupt-driven asyncronous                 }
{            communications for Turbo Pascal.             }
{                                                         }
{            Version 1.2 - Wedensday June 14, 1989        }
{            Copyright (C) 1989, Rising Edge Data Services}
{                                                         }
{            Permission is granted for non-commercial     }
{            use and distribution.                        }
{                                                         }
{            Author : Mark Schultz                        }
{                                                         }
{---------------------------------------------------------}
{                                                         }
{ -Because of the complex nature of serial I/O not all    }
{  routines are 100% tested. I don't feel/am/will ever be }
{  responsible for any damage caused by this routines.    }
{                                                         }
{ -Some routines don't work (yet) because some fields are }
{  mentioned in the BP7 help file but are missing in      }
{  Wintypes. The routines are SetCTSmode, SetRTSMode &    }
{  SoftHandshake.                                         }
{                                                         }
{ -Some routines can't be implemented in windows. They    }
{  are listed behind the end.                             }
{                                                         }
{ -From the original ASYNC12 code, only the syntax, some  }
{  high level pascal code and pieces of comment are used. }
{  Due to the different way windows handels devices, all  }
{  assembly codes couldn't be reused and was rewritten in }
{  Borland Pascal. I used parts of ASYNC12 because I find }
{  it a very complete package for Serial I/O and it works }
{  very well too. Sources were supplied and documented    }
{  very well.                                             }
{                                                         }
{---------------------------------------------------------}
{  Date   .Time  Revision                                 }
{  ------- ----  ---------------------------------------- }
{  9406017.1200  Creation.                                }
{---------------------------------------------------------}

Library Async12w;

Uses
  Winprocs,
  Wintypes;

{****************************************************************************}

{----Public definition section}

TYPE
  T_eoln     = (C_cr,C_lf);

CONST
  C_MaxCom   = 4;                   {----Supports COM1..COM4}
  C_MinBaud  = 110;
  C_MaxBaud  = 256000;

TYPE
  C_ports      = 1..C_MaxCom;       {----Subrange type to minimize programming errors}

{****************************************************************************}

{----Private definition section}

CONST
  portopen   : Array[C_ports] OF Boolean = (false,false,false,false);   {----Open port flags    }
  cids       : ARRAY[C_ports] OF Integer = (-1,-1,-1,-1);               {----Device ID's        }
  inbs       : ARRAY[C_ports] OF Word    = ( 0, 0, 0, 0);               {----Input  buffer sizes}
  outbs      : ARRAY[C_ports] OF Word    = ( 0, 0, 0, 0);               {----Output buffer sizes}
  txdir      = 0;                                                       {----Used for FlushCom  }
  rxdir      = 1;                                                       {----Used for FlushCom  }
  fon        = 1;                                                       {----Used for Handshakes}
  foff       = 0;                                                       {----Used for Handshakes}
  eolns      : ARRAY[C_ports] OF T_eoln  = (C_cr,C_cr,C_cr,C_cr);       {----Eoln characters    }

VAR
{----Don't seem to be declared in Wintypes, neccesary to fake}
  foutx,
  foutxCTSflow,
  fRTSflow   : Byte;

{****************************************************************************}
{*                                                                          *}
{*  Procedure ComReadCh(ComPort:Byte) : Char; External;                     *}
{*                                                                          *}
{*  ComPort:Byte  ->  Port # to use (1 - C_MaxCom)                          *}
{*                                                                          *}
{*  Returns character from input buffer of specified port.  If the buffer   *}
{*  is empty, the port # invalid or not opened, a Chr(0) is returned.       *}
{*                                                                          *}
{****************************************************************************}

Function ComReadCh(comport:C_ports) : Char; Export;

Var
  stat : TComStat;
  ch   : Char;
  cid  : Integer;

Begin
  ComReadCh:=#0;

  If (ComPort IN [1..C_MaxCom]) And
     (portopen[ComPort])
    Then
      Begin
        cid:=cids[comport];

      {----See how many characters are in the rx buffer}
        If (GetCommError(cid,stat)=0) AND
           (stat.cbInQue>0)           AND
           (ReadComm(cid,@ch,1)=1)
          THEN ComReadCh:=ch;
      End;
END; {of ComReadCh}

{****************************************************************************}
{*                                                                          *}
{*  Function ComReadChW(ComPort:Byte) : Char; External;                     *}
{*                                                                          *}
{*  ComPort:Byte  ->  Port # to use (1 - C_MaxCom)                          *}
{*                                                                          *}
{*  Works like ComReadCh, but will wait until at least 1 character is       *}
{*  present in the specified input buffer before exiting.  Thus, ComReadChW *}
{*  works much like the ReadKey predefined function.                        *}
{*                                                                          *}
{****************************************************************************}

Function ComReadChW(comport:C_ports) : Char; Export;

Var
  stat : TComStat;
  ch   : Char;
  ok   : Boolean;
  cid  : Integer;

Begin
  ComReadChW:=#00;

  If (ComPort IN [1..C_MaxCom]) And
     (portopen[ComPort])
    Then
      Begin
        cid:=cids[comport];
        ok :=false;

      {----See how many characters are in the rx buffer}
        REPEAT
          IF (GetCommError(cid,stat)<>0)
            THEN ok:=True
            ELSE
              BEGIN
                IF (stat.cbInQue<>0)       AND
                   (ReadComm(cid,@ch,1)=1)
                  THEN ComReadChW:=ch;
                ok:=true;
              END;
        UNTIL ok;
      End;
END; {of ComReadChW}

{****************************************************************************}
{*                                                                          *}
{*  Procedure ComWriteCh(ComPort:Byte; Ch:Char); External                   *}
{*                                                                          *}
{*  ComPort:Byte  ->  Port # to use (1 - C_MaxCom)                          *}
{*  Ch:Char       ->  Character to send                                     *}
{*                                                                          *}
{*  Places the character [Ch] in the transmit buffer of the specified port. *}
{*  If the port specified is not open or nonexistent, or if the buffer is   *}
{*  filled, the character is discarded.                                     *}
{*                                                                          *}
{****************************************************************************}

Procedure ComWriteCh(comport:C_ports; Ch:Char); Export;

VAR
  stat : TComStat;
  cid  : Integer;

BEGIN
  If (ComPort IN [1..C_MaxCom]) And
     (portopen[ComPort])
    Then
      Begin
        cid:=cids[comport];

        IF (GetCommError(cid,stat)=0)   AND
           (stat.cbOutQue<outbs[comport])
          THEN TransmitCommChar(cid,ch);
      End;
END; {of CommWriteCh}

{****************************************************************************}
{*                                                                          *}
{*  Procedure ComWriteChW(ComPort:Byte; Ch:Char); External;                 *}
{*                                                                          *}
{*  ComPort:Byte  ->  Port # to use (1 - C_MaxCom)                          *}
{*  Ch:Char       ->  Character to send                                     *}
{*                                                                          *}
{*  Works as ComWriteCh, but will wait until at least 1 free position is    *}
{*  available in the output buffer before attempting to place the character *}
{*  [Ch] in it.  Allows the programmer to send characters without regard to *}
{*  available buffer space.                                                 *}
{*                                                                          *}
{****************************************************************************}

Procedure ComWriteChW(comport:C_ports; Ch:Char); Export;

VAR
  stat : TComStat;
  cid  : Integer;
  rdy  : Boolean;

BEGIN
  If (ComPort IN [1..C_MaxCom]) And
     (portopen[ComPort])
    Then
      Begin
        cid:=cids[comport];
        rdy:=False;

        REPEAT
          IF (GetCommError(cid,stat)<>0)
            THEN rdy:=true
            ELSE
              IF (stat.cbOutQue<outbs[comport])
                THEN rdy:=TransmitCommChar(cid,ch)=0;
        UNTIL rdy;
      End;
End; {of ComWriteChW}

{****************************************************************************}
{*                                                                          *}
{*  Procedure ClearCom(ComPort:Byte); IO:Char)                              *}
{*                                                                          *}
{*  ComPort:Byte  ->  Port # to use (1 - C_MaxCom).                         *}
{*                    Request ignored if out of range or unopened.          *}
{*  IO:Char       ->  Action code; I=Input, O=Output, B=Both                *}
{*                    No action taken if action code unrecognized.          *}
{*                                                                          *}
{*  ClearCom allows the user to completely clear the contents of either     *}
{*  the input (receive) and/or output (transmit) buffers.  The "action      *}
{*  code" passed in <IO> determines if the input (I) or output (O) buffer   *}
{*  is cleared.  Action code (B) will clear both buffers.  This is useful   *}
{*  if you wish to cancel a transmitted message or ignore part of a         *}
{*  received message.                                                       *}
{*                                                                          *}
{****************************************************************************}

Procedure ClearCom(ComPort:C_Ports;IO:Char); Export;

Var
  cid  : Integer;

Begin
  If (ComPort IN [1..C_MaxCom]) And
     (portopen[ComPort])
    Then
      Begin
        cid:=cids[comport];

        Case Upcase(IO) OF
          'I' : FlushComm(cid,rxdir);
          'B' : Begin
                  FlushComm(cid,rxdir);
                  FlushComm(cid,txdir);
                End;
          'O' : FlushComm(cid,txdir);
        End;
      End;
End; {of ClearComm}

{****************************************************************************}
{*                                                                          *}
{*  Procedure ComBufferLeft(ComPort:Byte; IO:Char) : Word                   *}
{*                                                                          *}
{*  ComPort:Byte  ->  Port # to use (1 - C_MaxCom).                         *}
{*                    Returns 0 if Port # invalid or unopened.              *}
{*  IO:Char       ->  Action code; I=Input, O=Output                        *}
{*                    Returns 0 if action code unrecognized.                *}
{*                                                                          *}
{*  ComBufferLeft will return a number (bytes) indicating how much space    *}
{*  remains in the selected buffer.  The INPUT buffer is checked if <IO> is *}
{*  (I), and the output buffer is interrogated when <IO> is (O).  Any other *}
{*  "action code" will return a result of 0.  Use this function when it is  *}
{*  important to avoid program delays due to calls to output procedures or  *}
{*  to prioritize the reception of data (to prevent overflows).             *}
{*                                                                          *}
{****************************************************************************}

Function ComBufferLeft(ComPort:C_ports; IO:Char) : Word; Export;

VAR
  stat : TComStat;
  cid  : Integer;

Begin
  ComBufferLeft := 0;

  If (ComPort IN [1..C_MaxCom]) And
     (portopen[ComPort])
    Then
      Begin
        cid:=cids[comport];

        IF (GetCommError(cid,stat)=0)
          THEN
            CASE Upcase(IO) OF
              'I' : ComBufferLeft:=inbs [comport]-stat.cbInQue;
              'O' : ComBufferLeft:=outbs[comport]-stat.cbOutQue;
            END;
      End;
End; {ComBufferLeft}

{****************************************************************************}
{*                                                                          *}
{*  Procedure ComWaitForClear(ComPort:Byte)                                 *}
{*                                                                          *}
{*  ComPort:Byte  ->  Port # to use (1 - C_MaxCom).                         *}
{*                    Exits immediately if out of range or port unopened.   *}
{*                                                                          *}
{*  A call to ComWaitForClear will stop processing until the selected out-  *}
{*  put buffer is completely emptied.  Typically used just before a call    *}
{*  to the CloseCom procedure to prevent premature cut-off of messages in   *}
{*  transit.                                                                *}
{*                                                                          *}
{****************************************************************************}

Procedure ComWaitForClear(ComPort:C_ports); Export;

Var
  stat  : TComStat;
  cid   : Integer;
  Empty : Boolean;

Begin
  If (ComPort IN [1..C_MaxCom]) And
     (portopen[ComPort])
    Then
      Begin
        cid  :=cids[comport];
        empty:=false;

        REPEAT
          IF (GetCommError(cid,stat)<>0)
            THEN empty:=true
            ELSE empty:=stat.cbOutQue=0
        UNTIL empty;
      End;
End; {ComWaitForClear}

{****************************************************************************}
{*                                                                          *}
{*  Procedure ComWrite(ComPort:Byte; St:String)                             *}
{*                                                                          *}
{*  ComPort:Byte  ->  Port # to use (1 - C_MaxCom).                         *}
{*                    Exits immediately if out of range or port unopened.   *}
{*  St:String     ->  String to send                                        *}
{*                                                                          *}
{*  Sends string <St> out communications port <ComPort>.                    *}
{*                                                                          *}
{****************************************************************************}

Procedure ComWrite(ComPort:C_ports; St:String); Export;

Var
  X : Byte;

Begin
  If (ComPort IN [1..C_MaxCom]) And
     (portopen[ComPort])
    Then
      For X := 1 To Length(St) Do
        ComWriteChW(ComPort,St[X]);
End; {of ComWrite}

{****************************************************************************}
{*                                                                          *}
{*  Procedure ComWriteln(ComPort:Byte; St:String);                          *}
{*                                                                          *}
{*  ComPort:Byte  ->  Port # to use (1 - C_MaxCom).                         *}
{*                    Exits immediately if out of range or port unopened.   *}
{*  St:String     ->  String to send                                        *}
{*                                                                          *}
{*  Sends string <St> with a CR and LF appended.                            *}
{*                                                                          *}
{****************************************************************************}

Procedure ComWriteln(ComPort:C_ports; St:String); Export;

Var
  X : Byte;

Begin
  If (ComPort IN [1..C_MaxCom]) And
     (portopen[ComPort])
    Then
      Begin
        For X := 1 To Length(St) Do
          ComWriteChW(ComPort,St[X]);
        ComWriteChW(ComPort,#13);
        ComWriteChW(ComPort,#10);
      End;
End; {of ComWriteln}

{****************************************************************************}
{*                                                                          *}
{*  Procedure Delay(ms:word);                                               *}
{*                                                                          *}
{*  ms:word       ->  Number of msec to wait.                               *}
{*                                                                          *}
{*  A substitute for CRT's Delay under DOS. This one will wait for at least *}
{*  the amount of msec specified, probably even more because of the task-   *)
{*  switching nature of Windows. So a msec can end up as a second if ALT-TAB*}
{*  or something like is pressed. Minumum delays are guaranteed independend *}
{*  of task-switches.                                                       *}
{*                                                                          *}
{****************************************************************************}

Procedure Delay(ms : Word);

Var
  theend,
  marker  : Longint;

Begin
{----Potentional overflow if windows runs for 49 days without a stop}
  marker:=GetTickCount;
{$R-}
  theend:=Longint(marker+ms);
{$R+}

{----First see if timer overrun will occure and wait for this,
     then test as usual}
  If (theend<marker)
    Then
      While (GetTickCount>=0) DO;

{----Wait for projected time to pass}
  While (theend>=GettickCount) Do;
End; {of Delay}

{****************************************************************************}
{*                                                                          *}
{*  Procedure ComWriteWithDelay(ComPort:Byte; St:String; Dly:Word);         *}
{*                                                                          *}
{*  ComPort:Byte  ->  Port # to use (1 - C_MaxCom).                         *}
{*                    Exits immediately if out of range or port unopened.   *}
{*  St:String     ->  String to send                                        *}
{*  Dly:Word      ->  Time, in milliseconds, to delay between each char.    *}
{*                                                                          *}
{*  ComWriteWithDelay will send string <St> to port <ComPort>, delaying     *}
{*  for <Dly> milliseconds between each character.  Useful for systems that *}
{*  cannot keep up with transmissions sent at full speed.                   *}
{*                                                                          *}
{****************************************************************************}

Procedure ComWriteWithDelay(ComPort:C_ports; St:String; Dly:Word); Export;

Var
  X   : Byte;

Begin
  If (ComPort IN [1..C_MaxCom]) And
     (portopen[ComPort])
    Then
      Begin
        ComWaitForClear(ComPort);
        For X := 1 To Length(St) Do
          Begin
            ComWriteChW(ComPort,St[X]);
            ComWaitForClear(ComPort);
            Delay(dly);
          End;
      End;
End; {of ComWriteWithDelay}

{****************************************************************************}
{*                                                                          *}
{* Procedure ComReadln(ComPort:Byte; Var St:String; Size:Byte; Echo:Boolean)*}
{*                                                                          *}
{*  ComPort:Byte  ->  Port # to use (1 - C_MaxCom).                         *}
{*                    Exits immediately if out of range or port unopened.   *}
{*  St:String     <-  Edited string from remote                             *}
{*  Size:Byte;    ->  Maximum allowable length of input                     *}
{*  Echo:Boolean; ->  Set TRUE to echo received characters                  *}
{*                                                                          *}
{*  ComReadln is the remote equivalent of the standard Pascal READLN pro-   *}
{*  cedure with some enhancements.  ComReadln will accept an entry of up to *}
{*  40 printable ASCII characters, supporting ^H and ^X editing commands.   *}
{*  Echo-back of the entry (for full-duplex operation) is optional.  All    *}
{*  control characters, as well as non-ASCII (8th bit set) characters are   *}
{*  stripped.  If <Echo> is enabled, ASCII BEL (^G) characters are sent     *}
{*  when erroneous characters are intercepted.  Upon receipt of a ^M (CR),  *}
{*  the procedure is terminated and the final string result returned.       *}
{*                                                                          *}
{****************************************************************************}

Procedure ComReadln(ComPort:C_ports; Var St:String; Size:Byte; Echo:Boolean); Export;

Var
  Len,X : Byte;
  Ch    : Char;
  Done  : Boolean;

Begin
  St:='';
  If (ComPort IN [1..C_MaxCom]) And
     (portopen[ComPort])
    Then
      Begin
        Done := False;
        Repeat
          Len:=Length(St);
          Ch :=Chr(Ord(ComReadChW(ComPort)) And $7F);

          Case Ch Of
            ^H : If Len>0
                  Then
                    Begin
                      Dec(Len);
                      St[0]:=Chr(Len);
                      If Echo Then ComWrite(ComPort,#8#32#8);
                    End
                  Else ComWriteChW(ComPort,^G);
            ^J : If eolns[comport]=C_lf
                   Then
                     Begin
                       Done:=True;
                       If Echo Then ComWrite(ComPort,#13#10);
                     End;
            ^M : If eolns[comport]=C_cr
                   Then
                     Begin
                       Done:=True;
                       If Echo Then ComWrite(ComPort,#13#10);
                     End;
            ^X : Begin
                   St:='';
                   If Len=0 Then ComWriteCh(ComPort,^G);
                   If Echo
                     Then
                       For X:=1 to Len Do
                         ComWrite(ComPort,#8#32#8);
                 End;
          #32..
          #127 : If Len<Size
                   Then
                     Begin
                       Inc(Len);
                       St[Len]:=Ch;
                       St[0]:=Chr(Len);
                       If Echo Then ComWriteChW(ComPort,Ch);
                     End
                   Else
                     If Echo Then ComWriteChW(ComPort,^G);
          Else
            If Echo Then ComWriteChW(ComPort,^G)
          End;
        Until Done;
      End;
End; {of ComReadln}

{****************************************************************************}
{*                                                                          *}
{*  Procedure SetRTSMode(ComPort:Byte; Mode:Boolean; RTSOn,RTSOff:Word)     *}
{*                                                                          *}
{*  ComPort:Byte  ->  Port # to use (1 - C_MaxCom).                         *}
{*                    Request ignored if out of range or unopened.          *}
{*  Mode:Boolean  ->  TRUE to enable automatic RTS handshake                *}
{*  RTSOn:Word    ->  Buffer-usage point at which the RTS line is asserted  *}
{*  RTSOff:Word   ->  Buffer-usage point at which the RTS line is dropped   *}
{*                                                                          *}
{*  SetRTSMode enables or disables automated RTS handshaking.  If [MODE] is *}
{*  TRUE, automated RTS handshaking is enabled.  If enabled, the RTS line   *}
{*  will be DROPPED when the # of buffer bytes used reaches or exceeds that *}
{*  of [RTSOff].  The RTS line will then be re-asserted when the buffer is  *}
{*  emptied down to the [RTSOn] usage point.  If either [RTSOn] or [RTSOff] *}
{*  exceeds the input buffer size, they will be forced to (buffersize-1).   *}
{*  If [RTSOn] > [RTSOff] then [RTSOn] will be the same as [RTSOff].        *}
{*  The actual handshaking control is located in the interrupt driver for   *}
{*  the port (see ASYNC12.ASM).                                             *}
{*                                                                          *}
{****************************************************************************}

Procedure SetRTSmode(ComPort:C_ports; Mode:Boolean; RTSOn,RTSOff:Word); Export;

Var
  dcb : tdcb;
  cid : Integer;

Begin
  If (ComPort IN [1..C_MaxCom]) And
     (portopen[ComPort])
    Then
      Begin
        cid:=cids[comport];

        If GetCommState(cid,dcb)=0
          Then
            Begin
              With dcb Do
                Case mode of
                  True  : Begin
                            fRTSflow:=fon;
                            Xonlim  :=inbs[comport]-RTSon ;
                            Xofflim :=inbs[comport]-RTSoff;
                          End;
                  False : Begin
                            fRTSflow:=foff;
                          End;
                End;
              SetCommState(dcb);
            End;
      End;
End; {of SetRTSmode}

{****************************************************************************}
{*                                                                          *}
{*  Procedure SetCTSMode(ComPort:Byte; Mode:Boolean)                        *}
{*                                                                          *}
{*  ComPort:Byte  ->  Port # to use (1 - C_MaxCom).                         *}
{*                    Request ignored if out of range or unopened.          *}
{*  Mode:Boolean  ->  Set to TRUE to enable automatic CTS handshake.        *}
{*                                                                          *}
{*  SetCTSMode allows the enabling or disabling of automated CTS handshak-  *}
{*  ing.  If [Mode] is TRUE, CTS handshaking is enabled, which means that   *}
{*  if the remote drops the CTS line, the transmitter will be disabled      *}
{*  until the CTS line is asserted again.  Automatic handshake is disabled  *}
{*  if [Mode] is FALSE.  CTS handshaking and "software" handshaking (pro-   *}
{*  vided by the SoftHandshake procedure) ARE compatable and may be used    *}
{*  in any combination.                                                     *}
{*                                                                          *}
{****************************************************************************}

Procedure SetCTSMode(ComPort:Byte; Mode:Boolean); Export;

Var
  dcb : tdcb;
  cid : Integer;

Begin
  If (ComPort IN [1..C_MaxCom]) And
     (portopen[ComPort])
    Then
      Begin
        cid:=cids[comport];

        If GetCommState(cid,dcb)=0
          Then
            Begin
              Case mode of
                True  : foutxCTSflow:=fon;
                False : foutxCTSflow:=foff;
              End;
              SetCommState(dcb);
            End;
      End;
End; {of SetCTSmode}

{****************************************************************************}
{*                                                                          *}
{*  Procedure SoftHandshake(ComPort:Byte; Mode:Boolean; Start,Stop:Char)    *}
{*                                                                          *}
{*  ComPort:Byte  ->  Port # to use (1 - C_MaxCom).                         *}
{*                    Request ignored if out of range or unopened.          *}
{*  Mode:Boolean  ->  Set to TRUE to enable transmit software handshake     *}
{*  Start:Char    ->  START control character (usually ^Q)                  *}
{*                    Defaults to ^Q if character passed is >= <Space>      *}
{*  Stop:Char     ->  STOP control character (usually ^S)                   *}
{*                    Defaults to ^S if character passed is >= <Space>      *}
{*                                                                          *}
{*  SoftHandshake controls the usage of "Software" (control-character)      *}
{*  handshaking on transmission.  If "software handshake" is enabled        *}
{*  ([Mode] is TRUE), transmission will be halted if the character in       *}
{*  [Stop] is received.  Transmission is re-enabled if the [Start] char-    *}
{*  acter is received.  Both the [Start] and [Stop] characters MUST be      *}
{*  CONTROL characters (i.e. Ord(Start) and Ord(Stop) must both be < 32).   *}
{*  Also, <Start> and <Stop> CANNOT be the same character.  If either one   *}
{*  of these restrictions are violated, the defaults (^Q for <Start> and ^S *}
{*  for <Stop>) will be used.                                               *}
{*                                                                          *}
{****************************************************************************}

Procedure SoftHandshake(ComPort:Byte; Mode:Boolean; Start,Stop:Char); Export;

Var
  dcb : tdcb;
  cid : integer;

Begin
  If (ComPort IN [1..C_MaxCom]) And
     (portopen[ComPort])
    Then
      Begin
        cid:=cids[comport];

        If GetCommState(cid,dcb)=0
          Then
            Begin
              Case mode of
                True  : Begin
                          foutx:=fon;
                          If (start IN [#00..#31]) And (start<>stop)
                            Then dcb.Xonchar:=start
                            Else dcb.Xonchar:=^Q;
                          If (stop  IN [#00..#31]) And (start<>stop)
                            Then dcb.Xoffchar:=stop
                            Else dcb.Xoffchar:=^S;
                        End;
                False : foutx:=foff;
              End;
              SetCommState(dcb);
            End;
      End;
End; {of Softhandshake}

{****************************************************************************}
{*                                                                          *}
{*  Function ComExist(ComPort:Byte) : Boolean                               *}
{*                                                                          *}
{*  ComPort:Byte  ->  Port # to use (1 - C_MaxCom)                          *}
{*                    Returns FALSE if out of range                         *}
{*  Returns TRUE if hardware for selected port is detected & tests OK       *}
{*                                                                          *}
{****************************************************************************}

Function ComExist(ComPort:C_ports) : Boolean; Export;

VAR
  mode : String;
  dcb  : tdcb;

Begin
  If (ComPort IN [1..C_MaxCom])
    Then
      Begin
        mode:='COM'+Chr(Comport+Ord('0'))+' 19200,N,8,1'#0;
        ComExist:=(BuildCommDCB(@mode[1],dcb)=0);
      End
    Else ComExist:=false;
End; {of Comexist}

{****************************************************************************}
{*                                                                          *}
{*  Function ComTrueBaud(Baud:Longint) : Real                               *}
{*                                                                          *}
{*  Baud:Longint  ->  User baud rate to test.                               *}
{*                    Should be between C_MinBaud and C_MaxBaud.            *}
{*  Returns the actual baud rate based on the accuracy of the 8250 divider. *}
{*                                                                          *}
{*  The ASYNC12 communications package allows the programmer to select ANY  *}
{*  baud rate, not just those that are predefined by the BIOS or other      *}
{*  agency.  Since the 8250 uses a divider/counter chain to generate it's   *}
{*  baud clock, many non-standard baud rates can be generated.  However,    *}
{*  the binary counter/divider is not always capable of generating the      *}
{*  EXACT baud rate desired by a user.  This function, when passed a valid  *}
{*  baud rate, will return the ACTUAL baud rate that will be generated.     *}
{*  The baud rate is based on a 8250 input clock rate of 1.73728 MHz.       *}
{*                                                                          *}
{****************************************************************************}

Function ComTrueBaud(Baud:Longint) : Real; Export;

Var
  X : Real;
  Y : Word;

Begin
  X := Baud;
  If X < C_MinBaud Then X := C_MinBaud;
  If X > C_MaxBaud Then X := C_MaxBaud;
  ComTrueBaud := C_MaxBaud / Round($900/(X/50));
End; {of ComTrueBaud}

{****************************************************************************}
{*                                                                          *}
{* Function Lstr(l : Longint) : String;                                     *}
{*                                                                          *}
{* l:Longint       ->  Number converted to a string                         *}
{*                                                                          *}
{* This function converts longint l to a string.                            *}
{*                                                                          *}
{****************************************************************************}

Function Lstr(l : Longint) : String;

Var
  s : String;

Begin
  Str(l:0,s);
  Lstr:=s;
End; {of Lstr}

{****************************************************************************}
{*                                                                          *}
{*  Procedure ComParams(ComPort:Byte; Baud:Longint;                         *}
{*                      WordSize:Byte; Parity:Char; StopBits:Byte);         *}
{*                                                                          *}
{*  ComPort:Byte   ->  Port # to initialize.  Must be (1 - C_MaxCom)        *}
{*                     Procedure aborted if port # invalid or unopened.     *}
{*  Baud:Longint   ->  Desired baud rate.  Should be (C_MinBaud - C_MaxBaud)*}
{*                     C_MinBaud or C_MaxBaud used if out of range.         *}
{*  WordSize:Byte  ->  Word size, in bits.  Must be 5 - 8 bits.             *}
{*                     8-bit word used if out of range.                     *}
{*  Parity:Char    ->  Parity classification.                               *}
{*                     May be N)one, E)ven, O)dd, M)ark or S)pace.          *}
{*                     N)one selected if classification unknown.            *}
{*  StopBits:Byte  ->  # of stop bits to pad character with.  Range (1-2)   *}
{*                     1 stop bit used if out of range.                     *}
{*                                                                          *}
{*  ComParams is used to configure an OPEN'ed port for the desired comm-    *}
{*  unications parameters, namely baud rate, word size, parity form and     *}
{*  # of stop bits.  A call to this procedure will set up the port approp-  *}
{*  riately, as well as assert the DTR, RTS and OUT2 control lines and      *}
{*  clear all buffers.                                                      *}
{*                                                                          *}
{****************************************************************************}

Procedure ComParams(ComPort:C_ports; Baud:LongInt; WordSize:Byte; Parity:Char; StopBits:Byte); Export;

Var
  mode : String;
  cid  : Integer;
  dcb  : tdcb;

Begin
  If (ComPort IN [1..C_MaxCom]) And
     (portopen[ComPort])
    Then
      Begin
        cid:=cids[comport];

      {----Like COM1 9600,N,8,1}
        mode:='COM'+Chr(Comport+Ord('0'))+' '+Lstr(baud)+','+Upcase(Parity)+','+Lstr(Wordsize)+','+Lstr(stopbits)+#0;
        IF (BuildCommDCB(@mode[1],dcb)=0)
          Then
            Begin
              dcb.id:=cid;
              SetCommState(dcb);
            End;
      End;
End; {of ComParams}

{****************************************************************************}
{*                                                                          *}
{*  Function OpenCom(ComPort:Byte; InBufferSize,OutBufferSize:Word):Boolean *}
{*                                                                          *}
{*  ComPort:Byte        ->  Port # to OPEN (1 - C_MaxCom)                   *}
{*                          Request will fail if out of range or port OPEN  *}
{*  InBufferSize:Word   ->  Requested size of input (receive) buffer        *}
{*  OutBufferSize:Word  ->  Requested size of output (transmit) buffer      *}
{*  Returns success/fail status of OPEN request (TRUE if OPEN successful)   *}
{*                                                                          *}
{*  OpenCom must be called before any activity (other than existence check, *}
{*  see the ComExist function) takes place.  OpenCom initializes the        *}
{*  interrupt drivers and serial communications hardware for the selected   *}
{*  port, preparing it for I/O. Once a port has been OPENed, a call to      *}
{*  ComParams should be made to set up communications parameters (baud rate,*}
{*  parity and the like).  Once this is done, I/O can take place on the     *}
{*  port. OpenCom will return a TRUE value if the opening procedure was     *}
{*  successful, or FALSE if it is not.                                      *}
{*                                                                          *}
{****************************************************************************}

Function OpenCom(ComPort:C_ports; InBufferSize,OutBufferSize:Word) : Boolean; Export;

Var
  cid  : Integer;
  comp : String;

Begin
  OpenCom := False;
  If    (ComPort IN [1..C_MaxCom]) And
     Not(portopen[ComPort])      And
         ComExist(comport)
    Then
      Begin
        comp:='COM'+Chr(comport+Ord('0'))+#0;
        cid:=OpenComm(@comp[1],InBufferSize,OutBufferSize);
        If (cid>=0)
          Then
            Begin
              cids [comport]     :=cid;
              inbs [comport]     :=InBufferSize;
              outbs[comport]     :=OutBufferSize;
              portopen[comport]:=true;
            End;
        OpenCom:=(cid>=0);
      End;
End; {of OpenCom}

{****************************************************************************}
{*                                                                          *}
{*  Procedure CloseCom(ComPort:Byte)                                        *}
{*                                                                          *}
{*  ComPort:Byte  ->  Port # to close                                       *}
{*                    Request ignored if port closed or out of range.       *}
{*                                                                          *}
{*  CloseCom will un-link the interrupt drivers for a port, deallocate it's *}
{*  buffers and drop the DTR and RTS signal lines for a port opened with    *}
{*  the OpenCom function.  It should be called before exiting your program  *}
{*  to ensure that the port is properly shut down.                          *}
{*  NOTE:  CloseCom shuts down a communications channel IMMEDIATELY,        *}
{*         even if there is data present in the input or output buffers.    *}
{*         Therefore, you may wish to call the ComWaitForClear procedure    *}
{*         before closing the ports.                                        *}
{*                                                                          *}
{****************************************************************************}

Procedure CloseCom(ComPort:C_ports); Export;

Var
  cid : integer;

Begin
  If (ComPort IN [1..C_MaxCom]) And
     (portopen[ComPort])
    Then
      Begin
        cid:=cids[comport];
        portopen[comport]:=Not(CloseComm(cid)=0);
      End;
End; {of CloseCom}

{****************************************************************************}
{*                                                                          *}
{*  Procedure CloseAllComs                                                  *}
{*                                                                          *}
{*  CloseAllComs will CLOSE all currently OPENed ports.  See the CloseCom   *}
{*  procedure description for more details.                                 *}
{*                                                                          *}
{****************************************************************************}

Procedure CloseAllComs; Export;

Var
  X : C_ports;

Begin
  For X := 1 To C_MaxCom Do
    If portopen[X] Then CloseCom(X);
End; {of CloseAllComs}

{****************************************************************************}
{*                                                                          *}
{*  Procedure ComSetEoln(ComPort:C_ports;EolnCh : T_eoln)                 *}
{*                                                                          *}
{*  ComPort:Byte  ->  Port # for which to alter the eoln character          *}
{*                    Request ignored if port closed or out of range.       *}
{*  EolnCh:T_eoln ->  Eoln character needed                                 *}
{*                                                                          *}
{*  With this function one can toggle the eoln character between cr and lf. *}
{*                                                                          *}
{****************************************************************************}

Procedure ComSetEoln(ComPort:C_ports;EolnCh : T_eoln); Export;

Begin
  If (ComPort IN [1..C_MaxCom]) And
     (portopen[ComPort])
    Then eolns[comport]:=EolnCh;
End; {of ComSetEoln}

{****************************************************************************}
{*                                                                          *}
{*  Function  ComGetBufsize(ComPort:C_ports;IO : char)                      *}
{*                                                                          *}
{*  ComPort:Byte  ->  Port # for which to retrieve the buffersize           *}
{*                    Request ignored if port closed or out of range.       *}
{*  IO:Char       ->  Action code; I=Input, O=Output                        *}
{*                    Returns 0 if action code unrecognized.                *}
{*                                                                          *}
{*  This function will return the buffer size defined for a serial port.    *}
{*                                                                          *}
{****************************************************************************}

Function ComGetBufsize(ComPort:C_ports;IO : Char) : WORD; Export;

Begin
  ComGetBufSize:=0;
  If (ComPort IN [1..C_MaxCom]) And
     (portopen[ComPort])
    Then
      CASE Upcase(IO) OF
        'I' : ComgetBufSize:=inbs [comport];
        'O' : ComgetBufSize:=outbs[comport];
      END;
End; {of ComGetBufferSize}

{****************************************************************************}

Exports
  ComReadCh         index  1,
  ComReadChW        index  2,
  ComWriteCh        index  3,
  ComWriteChW       index  4,
  ClearCom          index  5,
  ComBufferLeft     index  6,
  ComWaitForClear   index  7,
  ComWrite          index  8,
  ComWriteln        index  9,
  ComWriteWithDelay index 10,
  ComReadln         index 11,
  SetRTSmode        index 12,
  SetCTSMode        index 13,
  SoftHandshake     index 14,
  ComExist          index 15,
  ComTrueBaud       index 16,
  ComParams         index 17,
  OpenCom           index 18,
  CloseCom          index 19,
  CloseAllComs      index 20,
  ComSetEoln        index 21,
  ComGetBufSize     index 22;

Begin
End.

{----The following procedures/functions from the async12 }
{    package are not available                           }

{****************************************************************************}
{*                                                                          *}
{*  Procedure SetDTR(ComPort:Byte; Assert:Boolean);                         *}
{*                                                                          *}
{*  ComPort:Byte    ->  Port # to use (1 - C_MaxCom)                        *}
{*                      Call ignored if out-of-range                        *}
{*  Assert:Boolean  ->  DTR assertion flag (TRUE to assert DTR)             *}
{*                                                                          *}
{*  Provides a means to control the port's DTR (Data Terminal Ready) signal *}
{*  line.  When [Assert] is TRUE, the DTR line is placed in the "active"    *}
{*  state, signalling to a remote system that the host is "on-line"         *}
{*  (although not nessesarily ready to receive data - see SetRTS).          *}
{*                                                                          *}
{****************************************************************************}

Procedure SetDTR(ComPort:Byte; Assert:Boolean);

Begin
End; {of SetDTR}

{****************************************************************************}
{*                                                                          *}
{*  Procedure SetRTS(ComPort:Byte; Assert:Boolean)                          *}
{*                                                                          *}
{*  ComPort:Byte    ->  Port # to use (1 - C_MaxCom)                        *}
{*                      Call ignored if out-of-range                        *}
{*  Assert:Boolean  ->  RTS assertion flag (Set TRUE to assert RTS)         *}
{*                                                                          *}
{*  SetRTS allows a program to manually control the Request-To-Send (RTS)   *}
{*  signal line.  If RTS handshaking is disabled (see C_Ctrl definition     *}
{*  and the the SetRTSMode procedure), this procedure may be used.  SetRTS  *}
{*  should NOT be used if RTS handshaking is enabled.                       *}
{*                                                                          *}
{****************************************************************************}

Procedure SetRTS(ComPort:Byte; Assert:Boolean);

Begin
End; {of SetRTS}

{****************************************************************************}
{*                                                                          *}
{*  Procedure SetOUT1(ComPort:Byte; Assert:Boolean)                         *}
{*                                                                          *}
{*  ComPort:Byte    ->  Port # to use (1 - C_MaxCom)                        *}
{*                      Call ignored if out-of-range                        *}
{*  Assert:Boolean  ->  OUT1 assertion flag (set TRUE to assert OUT1 line)  *}
{*                                                                          *}
{*  SetOUT1 is provided for reasons of completeness only, since the         *}
{*  standard PC/XT/AT configurations do not utilize this control signal.    *}
{*  If [Assert] is TRUE, the OUT1 signal line on the 8250 will be set to a  *}
{*  LOW logic level (inverted logic).  The OUT1 signal is present on pin 34 *}
{*  of the 8250 (but not on the port itself).                               *}
{*                                                                          *}
{****************************************************************************}

Procedure SetOUT1(ComPort:Byte; Assert:Boolean);

Begin
End;  {of SetOUT1}

{****************************************************************************}
{*                                                                          *}
{*  Procedure SetOUT2(ComPort:Byte; Assert:Boolean)                         *}
{*                                                                          *}
{*  ComPort:Byte    ->  Port # to use (1 - C_MaxCom)                        *}
{*                      Call ignored if out-of-range                        *}
{*  Assert:Boolean  ->  OUT2 assertion flag (set TRUE to assert OUT2 line)  *}
{*                                                                          *}
{*  The OUT2 signal line, although not available on the port itself, is     *}
{*  used to gate the 8250 <INTRPT> (interrupt) line and thus acts as a      *}
{*  redundant means of controlling 8250 interrupts.  When [Assert] is TRUE, *}
{*  the /OUT2 line on the 8250 is lowered, which allows the passage of the  *}
{*  <INTRPT> signal through a gating arrangement, allowing the 8250 to      *}
{*  generate interrupts.  Int's can be disabled bu unASSERTing this line.   *}
{*                                                                          *}
{****************************************************************************}

Procedure SetOUT2(ComPort:Byte; Assert:Boolean);

Begin
End; {of SetOUT2}

{****************************************************************************}
{*                                                                          *}
{*  Function CTSStat(ComPort:Byte) : Boolean                                *}
{*                                                                          *}
{*  ComPort:Byte  ->  Port # to use (1 - C_MaxCom)                          *}
{*                    Call ignored if out-of-range                          *}
{*  Returns status of Clear-To-Send line (TRUE if CTS asserted)             *}
{*                                                                          *}
{*  CTSStat provides a means to interrogate the Clear-To-Send hardware      *}
{*  handshaking line.  In a typical arrangement, when CTS is asserted, this *}
{*  signals the host (this computer) that the receiver is ready to accept   *}
{*  data (in contrast to the DSR line, which signals the receiver as        *}
{*  on-line but not nessesarily ready to accept data).  An automated mech-  *}
{*  ansim (see CTSMode) is provided to do this, but in cases where this is  *}
{*  undesirable or inappropriate, the CTSStat function can be used to int-  *}
{*  terrogate this line manually.                                           *}
{*                                                                          *}
{****************************************************************************}

Function CTSStat(ComPort:Byte) : Boolean;

Begin
End; {of CTSstat}

{****************************************************************************}
{*                                                                          *}
{*  Function DSRStat(ComPort:Byte) : Boolean                                *}
{*                                                                          *}
{*  ComPort:Byte  ->  Port # to use (1 - C_MaxCom)                          *}
{*                    Call ignored if out-of-range                          *}
{*  Returns status of Data Set Ready (DSR) signal line.                     *}
{*                                                                          *}
{*  The Data Set Ready (DSR) line is typically used by a remote station     *}
{*  to signal the host system that it is on-line (although not nessesarily  *}
{*  ready to receive data yet - see CTSStat).  A remote station has the DSR *}
{*  line asserted if DSRStat returns TRUE.                                  *}
{*                                                                          *}
{****************************************************************************}

Function DSRStat(ComPort:Byte) : Boolean;

Begin
End; {of DSRstat}

{****************************************************************************}
{*                                                                          *}
{*  Function RIStat(ComPort:Byte) : Boolean                                 *}
{*                                                                          *}
{*  ComPort:Byte  ->  Port # to use (1 - C_MaxCom)                          *}
{*                    Call ignored if out-of-range                          *}
{*                                                                          *}
{*  Returns the status of the Ring Indicator (RI) line.  This line is       *}
{*  typically used only by modems, and indicates that the modem has detect- *}
{*  ed an incoming call if RIStat returns TRUE.                             *}
{*                                                                          *}
{****************************************************************************}

Function RIStat(ComPort:Byte) : Boolean;

Begin
End; {of RIstat}

{****************************************************************************}
{*                                                                          *}
{*  Function DCDStat(ComPort:Byte) : Boolean                                *}
{*                                                                          *}
{*  ComPort:Byte  ->  Port # to use (1 - C_MaxCom)                          *}
{*                    Call ignored if out-of-range                          *}
{*                                                                          *}
{*  Returns the status of the Data Carrier Detect (DCD) line from the rem-  *}
{*  ote device, typically a modem.  When asserted (DCDStat returns TRUE),   *}
{*  the modem indicates that it has successfuly linked with another modem   *}
{*  device at another site.                                                 *}
{*                                                                          *}
{****************************************************************************}

Function DCDStat(ComPort:Byte) : Boolean;

Begin
End; {of DCDstat}

{ ---------------    WINDOWS INTERFACE UNIT -------------------- }

Unit WinAsync;

Interface

CONST
  C_MaxCom   = 4;             {----supports COM1..COM4                        }
  C_MinBaud  = 110;           {----min baudrate supported by windows 3.1      }
  C_MaxBaud  = 256000;        {----max baudrate supported by windows 3.1      }

TYPE
  T_eoln     = (C_cr,C_lf);   {----used to change EOLN character from cr to lf}
  C_ports    = 1..C_MaxCom;   {----subrange type to minimize programming errors}


Function  ComReadCh(comport:C_ports)  : Char;
Function  ComReadChW(comport:C_ports) : Char;
Procedure ComReadln(ComPort:C_ports; Var St:String; Size:Byte; Echo:Boolean);

Procedure ComWriteCh(comport:C_ports; Ch:Char);
Procedure ComWriteChW(comport:C_ports; Ch:Char);
Procedure ComWrite(ComPort:C_ports; St:String);
Procedure ComWriteln(ComPort:C_ports; St:String);
Procedure ComWriteWithDelay(ComPort:C_ports; St:String; Dly:Word);

Procedure ClearCom(ComPort:C_Ports;IO:Char);
Function  ComBufferLeft(ComPort:C_ports; IO:Char) : Word;
Procedure ComWaitForClear(ComPort:C_ports);

Procedure SetRTSmode(ComPort:C_ports; Mode:Boolean; RTSOn,RTSOff:Word);
Procedure SetCTSMode(ComPort:Byte; Mode:Boolean);
Procedure SoftHandshake(ComPort:Byte; Mode:Boolean; Start,Stop:Char);

Function  ComExist(ComPort:C_ports) : Boolean;
Procedure ComParams(ComPort:C_ports; Baud:LongInt; WordSize:Byte; Parity:Char; StopBits:Byte);
Function  ComTrueBaud(Baud:Longint) : Real;
Function  OpenCom(ComPort:C_ports; InBufferSize,OutBufferSize:Word) : Boolean;

Procedure CloseCom(ComPort:C_ports);
Procedure CloseAllComs;
Procedure ComSetEoln(ComPort:C_ports;EolnCh : T_eoln);

Function ComGetBufsize(ComPort:C_ports;IO : Char) : WORD;

Implementation

Function  ComReadCh(comport:C_ports)  : Char;                                  external 'async12w';
Function  ComReadChW(comport:C_ports) : Char;                                  external 'async12w';
Procedure ComWriteCh(comport:C_ports; Ch:Char);                                external 'async12w';
Procedure ComWriteChW(comport:C_ports; Ch:Char);                               external 'async12w';
Procedure ClearCom(ComPort:C_Ports;IO:Char);                                   external 'async12w';
Function  ComBufferLeft(ComPort:C_ports; IO:Char) : Word;                      external 'async12w';
Procedure ComWaitForClear(ComPort:C_ports);                                    external 'async12w';
Procedure ComWrite(ComPort:C_ports; St:String);                                external 'async12w';
Procedure ComWriteln(ComPort:C_ports; St:String);                              external 'async12w';
Procedure ComWriteWithDelay(ComPort:C_ports; St:String; Dly:Word);             external 'async12w';
Procedure ComReadln(ComPort:C_ports; Var St:String;Size:Byte; Echo:Boolean);   external 'async12w';
Procedure SetRTSmode(ComPort:C_ports; Mode:Boolean; RTSOn,RTSOff:Word);        external 'async12w';
Procedure SetCTSMode(ComPort:Byte; Mode:Boolean);                              external 'async12w';
Procedure SoftHandshake(ComPort:Byte; Mode:Boolean; Start,Stop:Char);          external 'async12w';
Function  ComExist(ComPort:C_ports) : Boolean;                                 external 'async12w';
Function  ComTrueBaud(Baud:Longint) : Real;                                    external 'async12w';
Procedure ComParams(ComPort:C_ports; Baud:LongInt; WordSize:Byte;
                                     Parity:Char; StopBits:Byte);              external 'async12w';
Function  OpenCom(ComPort:C_ports; InBufferSize,OutBufferSize:Word) : Boolean; external 'async12w';
Procedure CloseCom(ComPort:C_ports);                                           external 'async12w';
Procedure CloseAllComs;                                                        external 'async12w';
Procedure ComSetEoln(ComPort:C_ports;EolnCh : T_eoln);                         external 'async12w';

Function ComGetBufsize(ComPort:C_ports;IO : Char) : WORD;                      external 'async12w';


End.

{ ------------------------------   TEST PROGRAM  ----------------------- }

Program Asynctst;

Uses
  Wincrt,
  Asyncwin;

{----Demo main program for Async12w}

Var
  p : Byte;
  s : string;
  i : Integer;

Begin
  Write('Enter serial port number [1..4] : '); readln(p);
  IF ComExist(p) And OpenCom(p,1024,1024)
    Then
      Begin
        ComParams(p,9600,8,'N',1);

      {----Hayes modems echo a cr,lf so lf as eoln char is easier to program.
           The cr is skipped also. Default eoln character is cr, equivalent
           to BP's readln procedure}
        ComSetEoln(p,c_lf);
        Writeln('Enter a Hayes Command, like ATX1');
        Readln(s);
        If (s<>'')
          THEN
            BEGIN
              Write('Sending...');
              ComWriteWithDelay(p,s+#13#10,500);
              Writeln(' ok, press <enter> to continue.');

              Readln;
              Repeat
                Write('[',CombufferLeft(p,'I'):3,']');
                ComReadln(p,s,255,false);
                Writeln('[',ComBufferLeft(p,'I'):3,']',s);
              Until (ComBufferLeft(p,'I')=1024);
            END;
        CloseCom(p);
      End
    Else Writeln('Error opening COM',p,' port');
END.



[Back to COMM SWAG index]  [Back to Main SWAG index]  [Original]