drvNode Driver Support

drvNodeInit - Initialize a node object

The routine returns ERROR if an error occurred within drvSerial - otherwise it returns a pointer to the created node object.

drvNodeRead - Read a message of specified size from serial device

drvSerial responses larger than the specified message size are returned piece-wise by successive reads.

This routine returns ERROR if no responses are presently available from drvSerial.

For example:

If drvSerial's response queue contains one entry and that entry's buffer contains "aloha\015", then sucessive reads of size 3 will return:

       read #    buf        status
       ------    ---        ------
       1         "alo"      OK
       2         "ha\015"   OK
       3         "\000"     ERROR

drvNodeWrite - Output message of specified size to serial device

drvNodeStreamIn - Get Frame routine for drvSerial

Returned response includes delimiter.

drvNodeStreamOut - Put Frame routine for drvSerial

Transmits output a character at a time.

drvNodeSetDelim - Specify a delimiter string for a DRV_NODE object.

A delimiter definition includes:

       n     - index into delimiter array [0..NDELIMITERS-1]
       len   - length of delimiter in characters. (0 = delimiter not defined)
       delim - delimiter string
       mask  - bit mask indicating which positions are wild carded.

Examples:

       drvNodeSetDelim(COMMON, 2, 2, "\015\012", 0x00)
            delimiter #2 = CRLF
  
       drvNodeSetDelim(MOUSE, 0, 3, "   ", 0x07)
            delimiter #0 = any sequence of three characters (useful
            for mouse pointing devices).

drvNodeDDump - Print out the delimiter definition.

Source distribution