system.serial.configureSerialPort
This function is used in Python Scripting.
Description
Configure a serial port for use in a later call. This only needs to be done once unless the configuration has changed after the initial call. All access to constants must be prefixed by " system.serial. ".
Client Permission Restrictions
This scripting function has no Client Permission restrictions.
Syntax
note
This function accepts keyword arguments.
system.serial.configureSerialPort( port, bitRate, dataBits, handshake, hardwareFlowControl, parity, stopBits)
Parameters
Type | Parameter | Description |
---|---|---|
String | port | The name of the serial port, e.g., "COM1" or "/dev/ttyS0". This parameter is required. |
Integer | bitRate | Configure the bit rate.Valid values are defined by the following constants: BIT_RATE_110, BIT_RATE_150, BIT_RATE_300, BIT_RATE_600, BIT_RATE_1200, BIT_RATE_2400, BIT_RATE_4800, BIT_RATE_9600, BIT_RATE_19200, BIT_RATE_38400, BIT_RATE_57600, BIT_RATE_115200, BIT_RATE_230400, BIT_RATE_460800, BIT_RATE_921600. |
Integer | dataBits | Configure the data bits.Valid values are defined by the following constants: DATA_BITS_5, DATA_BITS_6, DATA_BITS_7, DATA_BITS_8. |
Integer | handshake | Configure the handshake.Valid values are defined by the following constants: HANDSHAKE_CTS_DTR, HANDSHAKE_CTS_RTS, HANDSHAKE_DSR_DTR, HANDSHAKE_HARD_IN, HANDSHAKE_HARD_OUT, HANDSHAKE_NONE, HANDSHAKE_SOFT_IN, HANDSHAKE_SOFT_OUT, HANDSHAKE_SPLIT_MASK, HANDSHAKE_XON_XOFF. |
Boolean | hardwareFlowControl | Configure hardware flow control: On or off. |
Integer | parity | Configure parity.Valid values are defined by the following constants: PARITY_EVEN, PARITY_ODD, PARITY_MARK, PARITY_SPACE, PARITY_NONE. |
Integer | stopBits | Configure stop bits.Valid values are defined by the following constants: STOP_BITS_1, STOP_BITS_2. |
Returns
SerialConfigurator - A SerialConfigurator that can be used to configure the serial port instead of or in addition to the given keyword arguments.
Scope
All
Code Examples
Example #1
# Configure a serial port using keyword args.
# The "port" keyword is mandatory.
system.serial.configureSerialPort(\
port="COM1",\
bitRate=system.serial.BIT_RATE_9600,\
dataBits=system.serial.DATA_BITS_8,\
handshake=system.serial.HANDSHAKE_NONE,\
hardwareFlowControl=False,\
parity=system.serial.PARITY_NONE,\
stopBits=system.serial.STOP_BITS_1)
Example #2
# Configure a serial port using a SerialConfigurator (returned by configureSerialPort()):
system.serial.configureSerialPort("COM1")\
.setBitRate(system.serial.BIT_RATE_9600)\
.setDataBits(system.serial.DATA_BITS_8)\
.setHandshake(system.serial.HANDSHAKE_NONE)\
.setHardwareFlowControl(False)\
.setParity(system.serial.PARITY_NONE)\
.setStopBits(system.serial.STOP_BITS_1)