XB Command – Text Capture Buffers
Stores and processes text information for inclusion in custom reports.
What is it for?
| Use | Description |
|---|---|
| 📝 Temporary storage | Stores text up to 150 characters |
| 🏷️ Identification | Associates client, cargo or driver codes |
| 📊 Custom reports | Includes external data in position messages |
| 🔌 Peripheral data | Captures information from serial sensors |
| ⚡ Events | Triggers 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
| Action | Command | Response |
|---|---|---|
| Load text | SXBindexText | RXBindexText;ID=... |
| Query | QXBindex | RXBindexText;ID=... |
Parameters:
- index: Buffer
00to07(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 nameAdvanced 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 code2. Define custom report with code
>SUC00 $RCD| #| QCQ,5,64| $\3B| QXB00,5,10< // Includes XB00 buffer in reportUC 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 reportResponse:
>RCD00210918170359-2778100-064258570001517F000000000049D13010900001516;1234567890;ID=037883;*01<Breakdown:
| Field | Value | Description |
|---|---|---|
| Timestamp | 210918170359 | 18/09/2021 17:03:59 |
| Latitude | -27.78100 | Coordinate |
| Longitude | -064.25857 | Coordinate |
| States | 0001517F… | System flags |
| Code | 1234567890 | XB00 Buffer |
Use Cases
Cargo identification
>SXB00CONTAINER_ABC123< // Container number
>SXB01SEAL_456789< // Seal numberInclude in reports:
>SUC01 $CARGO| QXB00,5,20| $\3B| QXB01,5,15<Driver data
>SXB02LICENSE_98765432< // License number
>SXB03MORNING_SHIFT< // Assigned shiftRoute reference
>SXB04ROUTE_101_KM_45< // Reference pointXB Triggers
Each buffer has its associated trigger:
| Trigger | Event |
|---|---|
XB00+ … XB07+ | ⚡ Capture in buffers 00-07 |
Example: Generate report when capturing text:
>SRL05E;TRG=XB00+;ACC={GBR00L}< // On XB00 capture → generate BR reportLimitations
| Parameter | Value |
|---|---|
| 📦 Available buffers | 8 (00-07) |
| 📏 Maximum length | 150 characters |
| 💾 Persistence | Volatile (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
- CXXB Command - Automatic capture configuration
- UC Command - Custom user reports
- Ux Command - Report queries
- Triggers - Complete list
Last updated