[<<Previous Entry] [^^Up^^] [Next Entry>>] [Menu] [About The Guide]
 COM_INIT()
 Initializes the port parameters
------------------------------------------------------------------------------
 Syntax

     COM_INIT(<nComPort>,[<nBaudRate>],[<cParity>],
        [<nDataLength>],[<nStopBits>]) --> lInitialized

 Arguments

     <nComPort>  Designates the port (1 to 4) that is initialized.

     <nBaudRate>  Designates the selected baud rate for the port.
     Settings of 300, 600, 1200, 2400, 4800, 9600 and 19200 baud are
     possible.  The default value is 300 baud.

     <cParity>  Designates parity in the following form: (E)ven, (O)dd,
     (M)ark, (S)pace, or (N)one.  The default value is (N)one.

     <nDataLength>  Designates the data length; seven or eight bits are
     possible.  The default value is eight bits.

     <nStopBits>  Designates the number of stop bits, one or two.  The
     default value is one stop bit.

 Returns

     If the com port is initialized successfully, the function returns .T..

 Description

     In order to use the serial port after you open it, four operating
     parameters must have been passed to this function.  These operating
     parameters are the transmission speed (baud rate), the data length, the
     parity, and the number of stop bits.  Today most bulletin boards use the
     configuration "300 - 9600 baud, 8N1".  This configuration means eight
     data bits, no parity, and one stop bit.  What is important is that all
     these parameters can be changed while the port is closed.  Neither the
     data buffer or the modem status register (DTR, etc.) are affected.

 Notes

     .  The port must have been opened previously.  It is impossible
        to initialize a port prior to opening it.

     .  If any or all of the four operating parameters are not
        designated, or are designated incorrectly, the standard arguments of
        300 baud, no parity, eight data bits, and one stop bit is used.

 Examples

     .  Open and initialize a port:

        nBuff_size := 4000                     // 4000 character buffer
        lComOk  :=  COM_OPEN(1, nBuff_size)    // Open port

        IF lComOk
              * The port is open, now it is to be initialized with 1200
              * baud, no parity, eight data bits, and one stop bit.

              lInitOk  :=  COM_INIT(1, 1200, "N", 8, 1)

              IF .NOT. lInitOk
                 ? "Port cannot be initialized !"
              ENDIF
        ENDIF

     .  You can also omit the last three parameters in the above
        example because they correspond to the default settings:

        lInitOk  :=  COM_INIT(1, 1200)      // Init. with 1200, N, 8, 1


See Also: COM_OPEN() COM_CLOSE()
This page created by ng2html v1.05, the Norton guide to HTML conversion utility. Written by Dave Pearson