Back to FabImage Studio website
You are here: Start » Filter Reference » System » Serial Port » SerialPort_WriteChar
Basic| Module: | FoundationLite |
|---|
Writes 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.
Disabled in Lite Edition
This filter is disabled in Lite Edition. It is available only in full, FabImage Studio Professional version.
Filter Group
This filter is member of SerialPort_Write filter group.
See Also
- SerialPort_Config – Configures the serial port.
- SerialPort_WriteBuffer – Writes raw binary data from a byte buffer to serial port.
- SerialPort_WriteString – Writes string characters to serial port.
- SerialPort_WriteChar – Writes single ASCII character to device.
- SerialPort_WriteByte – Writes one character in binary mode to serial port.
