Generic ASCII Receive View

Use Generic ASCII Receive view to configure parameters for receiving ASCII data through serial module.
Generic ASCII Receive View Example
Generic ASCII Receive View Parameters
Parameter
Definition
Available Choices
Swap Mode
Determines how the data that is received from the Serial port is arranged. The swap is performed after the module receives input data.
  • No Change (default)
  • Word Swap (ABCD → CDAB)
  • Byte Swap (ABCD → BADC)
  • Word and Byte Swap (ABCD → DCBA)
TIP: A, B, C, and D represent four adjacent bytes in the received/transmitted data.
Handshake Mode
Determines how the serial module passes the received data from the Serial port to the controller.
  • Master/Slave Handshake (default) – User logic increments the ASCII.RxID output tag to receive the next packet of data into the ASCII.RxData input tag.
  • Immediate – ASCII.RxID input tag increments indicating that the next packet of received data is available in the ASCII.RxData input tag.
Message Timeout
Specifies the receive timeout value (ms). The timer resets every time that the module receives a new byte from the Serial port.
  • 0 = Disabled (default)
  • 1…32,767 ms
Pad Character
Specifies the character that fills the remaining receive data buffer when the buffer is not full.
  • For 7-bit data – $00...$7F
  • For 8-bit data – $00...$FF
Start Mode
Determines the usage of the Start Delimiter in the data.
  • Ignore Start Delimiter (default) – Start Delimiter is ignored and all data from the serial interface are treated as ordinary data.
  • Exclude – Select this option to use the Start Delimiter to detect the start of data received from the serial interface. The Start Delimiter is not stored in the ASCII.RxData[] input tag.
  • Include – Select this option to use the Start Delimiter to detect the start of data received from the serial interface. The Start Delimiter is stored in the ASCII.RxData[] input tag.
Start Delimiter
Defines the character to signal the beginning of the data. All data received from the Serial port before this value is disposed.
  • For 7-bit data – $00...$7F
  • For 8-bit data – $00...$FF
Termination Mode
Determines the usage of the Termination Delimiters in the data.
  • Ignore End Delimiter (default) – The End Delimiters are ignored and all data received from the serial interface are treated as ordinary data. The number of characters that are stored in the ASCII.RxData[] input tag is based on Ox.ASCII.RxDataLength or Read Buffer Size, if Ox.ASCII.RxDataLength is 0.
  • Exclude – Select this option to use the End Delimiters to detect the end of data received from the serial interface. The End Delimiter is not stored in the ASCII.RxData[] input tag.
  • Include – Select this option to use the End Delimiters to detect the end of data received from the serial interface. The End Delimiter is stored in the ASCII.RxData[] input tag.
The end of data received for each record is determined by one of the following:
  • The Read Buffer Size is reached.
  • The Ox.ASCII.RxDataLength is not 0 and Ox.ASCII.RxDataLength is reached.
  • The end delimiters are detected if Termination Mode is not Ignore End Delimiters.
  • The Message Timeout elapses.
Termination Delimiter 1
Specifies the channel's first Termination Delimiter. The Termination Delimiter is used to signal the end of the data.
  • For 7-bit data – $00...$7F
  • For 8-bit data – $00...$FF
Termination Delimiter 2
Specifies the channel's second Termination Delimiter.
  • For 7-bit data – $00...$7F and $
  • For 8-bit data – $00...$FE and $
If you enter $, it means that the Termination Delimiter 2 is not used.
XON/XOFF
Enables and disables the flow control of the channel. Select the checkbox to enable the functionality.
When the Serial port receive buffer free space falls to 20%, XOFF (0x13) character is transmitted. When the Serial port receive buffer free space reaches 80%, XON (0x11) character is transmitted.
When XOFF (0x13) character is received, Serial port transmission is suspended until XON (0x11) is received or a timeout of 60 seconds has elapsed.
TIP: XON/XOFF is supported only in the following combinations:
  • RS-232C
    • No-Handshake
    • Full Duplex
  • RS-422
  • 0 = Disable (default)
  • 1 = Enable
Echo Mode
Enables and disable the character echo. Select the checkbox to cause the module to send immediately all bytes received from the Serial port back to the device that sent it.
TIP: Echo Mode is supported only in the following combinations:
  • RS-232C
    • No-Handshake
    • Full Duplex
  • RS-422
  • 0 = Disable (default)
  • 1 = Enable
Delete Mode
Determines the mode of the Delete character and affects the characters echoed back to the remote device.
  • Ignore (default) – The Delete character is ignored and treated the same as any other character that is read in.
  • CRT – When the Delete character is encountered, the module echoes three characters (backspace, space, and backspace) to the device.
  • Printer – When the Delete character is encountered, the module echoes the slash character followed by the previous character.
Read Buffer Size
Specifies the maximum length (in bytes) of the Read Buffer.
1…256 (default = 256)
Diagnostics
When controller status is online, open the Diagnostics dialog to view the diagnostic counters for performance and error management with the Generic ASCII communication.
–
Provide Feedback
Have questions or feedback about this documentation? Please submit your feedback here.
Normal