Back to Adaptive Vision Studio website

You are here: Start » Filter Reference » Serial Port » SerialPort_WriteChar

SerialPort_WriteChar


Write single ASCII character to device.

Name Type Range Description
inPortId Integer 0 - 7 Identifies open port instance when working with multiple serial ports
inCharacter String Single character to send

Description

Filter writes single character inCharacter into input buffer. Input inCharacter must contains only single valid ASCII character.

Remarks

Using the SerialPort_Config filter is necessary before using the SerialPort_WriteChar filter.

Errors

This filter can throw an exception to report error. Read how to deal with errors in Error Handling.

Using filters writing to serial port without previous configuration will cause "SerialPort not initialized" error.

List of possible exceptions:

Error type Description
DomainError Length inCharacter is greater than 1 in SerialPort_WriteChar.
DomainError SerialPort_WriteChar can send only ASCII characters.
DomainError Value inCharacter is empty in SerialPort_WriteChar.

Complexity Level

This filter is available on Basic Complexity Level.

Filter Group

This filter is member of SerialPort_Write filter group.

See Also