Serial Port Control
Serial Port
The serial port can be used to transmit and receive serial data through the
device using the transport layer. The serial data can be sent through the
transport layer in image data (via the SerialData Chunk Data), in control data
(via the File Access Control), or in event data (via the SerialPortReceive Event).
The serial port to configure is selected using the
SerialPortSelector. The physical line on which
to receive serial data is set using the SerialPortSource.
The physical line on which to transmit serial data is set using the LineSource
in the Digital IO Control. The serial port settings for both the receive and
transmit can be set using the SerialPortBaudRate,
SerialPortDataBits,
SerialPortStopBits¸ and
SerialPortParity.
Serial data can be transmitted and received through the File Access Control.
Once the serial port file is opened, data can be transmitted via Write operations
and received via Read operations. Received serial data can also be obtained through
the SerialPortReceive Event which will be generated when data is available or
through the SerialData Chunk Data which is appended into each image payload.
The total number of characters in the serial port transmit and receive queues
can be monitored using the
SerialTransmitQueueMaxCharacterCount
and the SerialReceiveQueueMaxCharacterCount.
The current number of characters in the queues can be monitored using the
SerialTransmitQueueCurrentCharacterCount
and SerialReceiveQueueCurrentCharacterCount.
The SerialReceiveQueueCurrentCharacterCount
reports the maximum number of characters that can be obtained using the File Access Control.
The receive queue can be emptied by executing the
SerialReceiveQueueClear.
Serial port framing and parity errors are reported using the
SerialRecieveFramingErrorCount and the
SerialReceiveParityErrorCount. Overflow
errors are reported within the SerialData Chunk Data, the SerialPortReceive Event,
or in the FileOperationStatus after executing a Read.
Summary Table
Serial Port Control Features
Serial Port Selector
Selects which serial port of the device to control.
Property |
Value |
Name
|
SerialPortSelector
|
Interface
|
IEnumeration |
Access
|
RW |
Visibility
|
Expert |
Enumeration Values |
SerialPort0
|
Serial Port Source
Specifies the physical input Line on which to receive serial data.
Property |
Value |
Name
|
SerialPortSource
[Serial Port Selector] |
Interface
|
IEnumeration |
Access
|
RW |
Visibility
|
Expert |
Enumeration Values |
Line0
|
Line1
|
Line2
|
Line3
|
Line4
|
Line5
|
Line6
|
Off
|
Serial Port Baud Rate
This feature controls the baud rate used by the selected serial port.
Property |
Value |
Name
|
SerialPortBaudRate
[Serial Port Selector] |
Interface
|
IEnumeration |
Access
|
RW |
Visibility
|
Expert |
Enumeration Values |
Baud300
|
Baud600
|
Baud1200
|
Baud2400
|
Baud4800
|
Baud9600
|
Baud14400
|
Baud19200
|
Baud38400
|
Baud57600
|
Baud115200
|
Baud230400
|
Baud460800
|
Baud921600
|
Serial Port Data Bits
This feature controls the number of data bits used by the selected serial port. Possible values that can be used are between 5 and 9.
Property |
Value |
Name
|
SerialPortDataBits
[Serial Port Selector] |
Interface
|
IInteger |
Access
|
RW |
Unit
|
|
Visibility
|
Expert |
Serial Port Stop Bits
This feature controls the number of stop bits used by the selected serial port.
Property |
Value |
Name
|
SerialPortStopBits
[Serial Port Selector] |
Interface
|
IEnumeration |
Access
|
RW |
Visibility
|
Expert |
Enumeration Values |
Bits1
|
Bits1AndAHalf
|
Bits2
|
Serial Port Parity
This feature controls the parity used by the selected serial port.
Property |
Value |
Name
|
SerialPortParity
[Serial Port Selector] |
Interface
|
IEnumeration |
Access
|
RW |
Visibility
|
Expert |
Enumeration Values |
None
|
Odd
|
Even
|
Mark
|
Space
|
Transmit Queue Max Character Count
>Returns the maximum number of characters in the serial port transmit queue.
Property |
Value |
Name
|
SerialTransmitQueueMaxCharacterCount
[Serial Port Selector] |
Interface
|
IInteger |
Access
|
RO |
Unit
|
|
Visibility
|
Expert |
Transmit Queue Current Character Count
Returns the number of characters currently in the serial port transmit queue.
Property |
Value |
Name
|
SerialTransmitQueueCurrentCharacterCount
[Serial Port Selector] |
Interface
|
IInteger |
Access
|
RO |
Unit
|
|
Visibility
|
Expert |
Receive Queue Max Character Count
>Returns the maximum number of characters in the serial port receive queue.
Property |
Value |
Name
|
SerialReceiveQueueMaxCharacterCount
[Serial Port Selector] |
Interface
|
IInteger |
Access
|
RO |
Unit
|
|
Visibility
|
Expert |
Receive Queue Current Character Count
Returns the number of characters currently in the serial port receive queue.
Property |
Value |
Name
|
SerialReceiveQueueCurrentCharacterCount
[Serial Port Selector] |
Interface
|
IInteger |
Access
|
RO |
Unit
|
|
Visibility
|
Expert |
Receive Queue Clear
This is a command that clears the device serial port receive queue.
Property |
Value |
Name
|
SerialReceiveQueueClear
[Serial Port Selector] |
Interface
|
ICommand |
Access
|
WO |
Visibility
|
Expert |
Receive Framing Error Count
Returns the number of framing errors that have occurred on the serial port.
Property |
Value |
Name
|
SerialReceiveFramingErrorCount
[Serial Port Selector] |
Interface
|
IInteger |
Access
|
RO |
Unit
|
|
Visibility
|
Expert |
Receive Parity Error Count
Returns the number of parity errors that have occurred on the serial port.
Property |
Value |
Name
|
SerialReceiveParityErrorCount
[Serial Port Selector] |
Interface
|
IInteger |
Access
|
RO |
Unit
|
|
Visibility
|
Expert |