Skip to Content

📦 Black Box (CXBB)

The Black Box module functions like an airplane’s “black box”: it captures and stores reports before and after an event, allowing analysis of what happened in the moments prior to and following an incident.


🤔 What is it used for?

Imagine a critical accident or event occurs. With Black Box you can:

  • 🔙 See the past: What happened in the seconds/minutes before the event
  • 🔜 See the future: What happened after the event
  • 📊 Forensic analysis: Reconstruct exactly what occurred
  • 🚗 Driving: Analyze driver behavior during sudden braking

Analogy: Like a car’s DVR that saves the last few minutes of video, Black Box saves the last position/status reports from the vehicle.


⚙️ How it works

  1. Continuous capture: The device continuously records reports in the background
  2. Circular buffer: Maintains the last N samples (overwrites the oldest ones)
  3. Event/Trigger: When the event occurs, it “freezes” the past and captures the future
  4. Transmission: Sends all reports (past + future) to the server

🔧 Configuration

SCXBB Command

>SCXBB,type,frequency,future_samples,past_samples<
ParameterDescriptionValues
typeType of report to captureCQ, CP, MV, etc.
frequencyInterval between captures (× 1000ms)1-255
future_samplesReports to capture after the event1-20
past_samplesHistorical reports to include1-20
TypeDescriptionTypical use
CQCompact positionRoute reconstruction
MVMovementDriving analysis
CPCompleteDetailed diagnostics

🎯 Activation

GBB Command - Trigger capture

>GBBnnP<
ParameterDescriptionValues
nnIdentifier number00-99
PTransmission priorityL (low), M (medium), H (high)

Example:

>GBB01H< // Triggers Black Box with ID=01, high priority

📋 Practical examples

🚨 Accident analysis (high frequency)

Capture position every second, 10 seconds before and 20 after:

>SCXBB,CQ,1,20,10<

Result: When triggered, you get 30 reports (10 past + 20 future) with 1-second resolution.

🚗 Sudden braking analysis

Capture movement every 500ms, 15 samples before and after:

>SCXBB,MV,0.5,15,15<

Result: 30 reports with half-second resolution to analyze the maneuver.

📍 Route monitoring (low frequency)

Capture position every minute, 5 before and 20 after:

>SCXBB,CQ,60,20,5<

Result: 25 reports covering ~25 minutes of route.


🔗 Integration with Event Engine

You can activate Black Box automatically upon specific events:

// Activate Black Box on sudden braking >SRL50E;TRG=ACC-;ACC={GBB01H}< // Activate on speeding >SRL51E;TRG=SPD+;ACC={GBB02H}< // Activate on battery disconnection >SRL52E;TRG=PWR-;ACC={GBB03H}<

Real use case: Configure Black Box with GBB in critical event rules to always have the complete context of what happened.


📊 Query

QCXBB Command

>QCXBB<

Response:

>RCXBB,CQ,1,20,10;ID=...

📖 Command summary

CommandFunction
SCXBB,type,freq,fut,pastConfigure Black Box
QCXBBQuery configuration
GBBnnPTrigger capture

✅ Compatibility

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

🔗 See also

Last updated