CXTY Command - Serial Transparent Capture
Configure the serial port transparent capture mode, defining header/footer characters and initial state.
What is it for?
| Use Case | Description |
|---|---|
| 🔄 Transparent modem | Forward serial data to server |
| 📊 Sensor integration | Capture data from external devices |
| 🏭 External dataloggers | Receive and transmit industrial data |
| 📡 Proprietary protocols | Capture 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
SCXTYaabbcQuery
QCXTYResponse
RCXTYaabbcParameters
| Parameter | Description | Values |
|---|---|---|
| aa | Capture start character (header) | 00 = Capture from any character, 01-FF = Specific byte |
| bb | Capture end character (footer) | 01-FF = Byte that triggers sending |
| c | Initial state on power-up | 0 = 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
-
Configure delimiters with CXTY:
>SCXTY02030< # STX=0x02, ETX=0x03, inactive -
Activate capture when needed:
>STY1< -
External device sends data:
<STX>Sensor data<ETX> -
Rinho captures and sends automatically to server
-
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 startupCaptures frames between STX (0x02) and ETX (0x03).
Permanent transparent modem
>SCXTY00001< # Capture everything until NULL byte, activeCompatibility
💾Firmware v1.08.00
SPLegacy
ULLegacy
MTLegacy
💾Firmware v1.00.00
SP-IOT
SM-IOT
See Also
- TY Command - Enable/disable capture
- CXTRM Command - Port speed
- Text Reports - Report formats
Last updated