Skip to Content

XB Command – Text Capture Buffers

Stores and processes text information for inclusion in custom reports.


What is it for?

UseDescription
📝 Temporary storageStores text up to 150 characters
🏷️ IdentificationAssociates client, cargo or driver codes
📊 Custom reportsIncludes external data in position messages
🔌 Peripheral dataCaptures information from serial sensors
EventsTriggers actions when capturing text

Description

Allows storing and processing information from peripherals connected to communication ports, including internal cellular modem and GPS module. Ideal for generating custom reports with external data.

Each capture in a buffer activates the corresponding XB trigger.


Syntax

ActionCommandResponse
Load textSXBindexTextRXBindexText;ID=...
QueryQXBindexRXBindexText;ID=...

Parameters:

  • index: Buffer 00 to 07 (2 digits)
  • text: Up to 150 characters

Examples

Store client code

>SXB001234567890< // Stores "1234567890" in buffer 00 >RXB001234567890;ID=037883;*5A<

Query loaded buffer

>QXB00< // Queries buffer 00 content >RXB001234567890;ID=037883;*5A<

Multiple simultaneous buffers

>SXB00CLIENT_001< // Buffer 00: client identification >SXB01NORTH_ROUTE< // Buffer 01: route name >SXB02DRIVER_JOHN< // Buffer 02: driver name

Advanced Configuration

For automatic captures from serial ports, see CXXB Command.


Use Case: Code in Report

Integrate an identification code in position reports using XB buffers.

1. Load code in buffer

>SXB001234567890< // Stores identification code

2. Define custom report with code

>SUC00 $RCD| #| QCQ,5,64| $\3B| QXB00,5,10< // Includes XB00 buffer in report

UC report structure:

  • QCQ,5,64: Position query (LAT/LON)
  • $\3B: Separator ;
  • QXB00,5,10: Reads 10 characters from XB00 buffer

3. Query generated report

>QU0< // Generates and shows the report

Response:

>RCD00210918170359-2778100-064258570001517F000000000049D13010900001516;1234567890;ID=037883;*01<

Breakdown:

FieldValueDescription
Timestamp21091817035918/09/2021 17:03:59
Latitude-27.78100Coordinate
Longitude-064.25857Coordinate
States0001517F…System flags
Code1234567890XB00 Buffer

Use Cases

Cargo identification

>SXB00CONTAINER_ABC123< // Container number >SXB01SEAL_456789< // Seal number

Include in reports:

>SUC01 $CARGO| QXB00,5,20| $\3B| QXB01,5,15<

Driver data

>SXB02LICENSE_98765432< // License number >SXB03MORNING_SHIFT< // Assigned shift

Route reference

>SXB04ROUTE_101_KM_45< // Reference point

XB Triggers

Each buffer has its associated trigger:

TriggerEvent
XB00+XB07+⚡ Capture in buffers 00-07

Example: Generate report when capturing text:

>SRL05E;TRG=XB00+;ACC={GBR00L}< // On XB00 capture → generate BR report

Limitations

ParameterValue
📦 Available buffers8 (00-07)
📏 Maximum length150 characters
💾 PersistenceVolatile (lost on restart)

⚠️ Volatile data: XB buffers are cleared when the device restarts. For persistent data, use user variables (UV command).

Compatibility

💾Firmware:v1.00.00+
SP-IOT
SM-IOT
ZE-IOT

See Also

Last updated