📦 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
- Continuous capture: The device continuously records reports in the background
- Circular buffer: Maintains the last N samples (overwrites the oldest ones)
- Event/Trigger: When the event occurs, it “freezes” the past and captures the future
- Transmission: Sends all reports (past + future) to the server
🔧 Configuration
SCXBB Command
>SCXBB,type,frequency,future_samples,past_samples<| Parameter | Description | Values |
|---|---|---|
type | Type of report to capture | CQ, CP, MV, etc. |
frequency | Interval between captures (× 1000ms) | 1-255 |
future_samples | Reports to capture after the event | 1-20 |
past_samples | Historical reports to include | 1-20 |
Recommended report types
| Type | Description | Typical use |
|---|---|---|
CQ | Compact position | Route reconstruction |
MV | Movement | Driving analysis |
CP | Complete | Detailed diagnostics |
🎯 Activation
GBB Command - Trigger capture
>GBBnnP<| Parameter | Description | Values |
|---|---|---|
nn | Identifier number | 00-99 |
P | Transmission priority | L (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
| Command | Function |
|---|---|
SCXBB,type,freq,fut,past | Configure Black Box |
QCXBB | Query configuration |
GBBnnP | Trigger capture |
✅ Compatibility
🔗 See also
- Generator G - Manual report generation
- Event Engine - Automate activation
- Standard Reports - Available report types