Back to FabImage 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 here: Error Handling
Using filters writing to serial port without previous configuration will cause "SerialPort not initialized" error.
Possible exceptions:
| Error type | Description |
|---|---|
| DomainError | Value inCharacter is empty in SerialPort_WriteChar. |
| DomainError | Length inCharacter is greater than 1 in SerialPort_WriteChar. |
| DomainError | SerialPort_WriteChar can send only ASCII characters. |
Complexity Level
This filter is available on Basic Complexity Level.
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_WriteByte – Writes one character in binary mode to serial port.
- SerialPort_WriteChar – Write single ASCII character to device.
- SerialPort_WriteString – Writes string characters to serial port.
