Skip to Content

CXTY Command - Serial Transparent Capture

Configure the serial port transparent capture mode, defining header/footer characters and initial state.


What is it for?

Use CaseDescription
🔄 Transparent modemForward serial data to server
📊 Sensor integrationCapture data from external devices
🏭 External dataloggersReceive and transmit industrial data
📡 Proprietary protocolsCapture frames with specific delimiters

Description

Allows using Rinho as a transparent modem, capturing data from the serial port and automatically sending it to the server when the termination character is received.


Commands

Configure

SCXTYaabbc

Query

QCXTY

Response

RCXTYaabbc

Parameters

ParameterDescriptionValues
aaCapture start character (header)00 = Capture from any character, 01-FF = Specific byte
bbCapture end character (footer)01-FF = Byte that triggers sending
cInitial state on power-up0 = Inactive, 1 = Active

Examples

Capture with STX/ETX delimiters

>SCXTY02030<
  • Header: 0x02 (STX - Start of Text)
  • Footer: 0x03 (ETX - End of Text)
  • Initial state: Inactive (enable with >STY1<)

Capture everything until CR+LF

>SCXTY000A0<
  • Header: 00 (capture from first character)
  • Footer: 0x0A (Line Feed)
  • Initial state: Inactive

Transparent mode active on power-up

>SCXTY000D1<
  • Header: 00 (any character)
  • Footer: 0x0D (Carriage Return)
  • Initial state: Active (works from startup)

Exiting Capture Mode

To exit active capture mode:

+++

Send the +++ sequence through serial port.


Integration with TY Command

The TY Command allows enabling/disabling capture mode without reconfiguring header/footer:

Configure delimiters but leave inactive

>SCXTY02030<

Activate capture when needed

>STY1<

Deactivate capture

>STY0<

Operation Flow

  1. Configure delimiters with CXTY:

    >SCXTY02030< # STX=0x02, ETX=0x03, inactive
  2. Activate capture when needed:

    >STY1<
  3. External device sends data:

    <STX>Sensor data<ETX>
  4. Rinho captures and sends automatically to server

  5. Exit mode:

    +++

Use Cases

Integration with external datalogger

>SCXTY000D0<

Captures complete lines (terminated with CR) from an external datalogger.

Proprietary protocol with delimiters

>SCXTY02031< # Active from startup

Captures frames between STX (0x02) and ETX (0x03).

Permanent transparent modem

>SCXTY00001< # Capture everything until NULL byte, active

Compatibility

💾Firmware v1.08.00
SPLegacy
ULLegacy
MTLegacy
💾Firmware v1.00.00
SP-IOT
SM-IOT

See Also

Last updated