MotorSignal-App/FIELD_TESTING.md

41 lines
1.9 KiB
Markdown

# MotorSignal — Field Testing & Black-Box Diagnostics Guide
This document outlines the field testing procedures, pre-ride readiness checks, black-box logging capabilities, and diagnostic export formats for real-world motorcycle testing.
---
## 1. Field Test Mode Procedure
### Pre-Ride Sensor Readiness Checklist
Before mounting and riding, verify the following in the **Field Test Diagnostics** screen:
1. **GNSS Lock**: Ensure GPS accuracy reads $\le 10\text{m}$.
2. **IMU Calibration**: Place motorcycle upright on level ground and tap **Calibrate Upright** for the active bike profile.
3. **Storage & Battery**: Verify battery $\ge 20\%$ and storage is available.
4. **Mount Stability**: Ensure the smartphone mount is clamped securely to the handlebar or triple tree.
### Starting a Field Test
1. Select the active motorcycle from the Digital Garage.
2. Tap **START FIELD TEST** or **START SESSION** in the Evolution cockpit.
3. Ride normally. The application operates in the background with wakelock active and logs diagnostic telemetry continuously.
---
## 2. Post-Ride Diagnostic Summary
At the conclusion of a ride, the Black-Box Field Test Logger computes:
* **Total GPS Fixes & Rejection Ratio**
* **Total IMU Samples & Anomaly Count**
* **Longest GPS Outage & Baseline Resets**
* **Peak Left / Right Lean Angles with Zero-Drift Verification**
* **Peak Acceleration & Braking Gs**
* **Database Write Success Rate & Buffer Flushes**
---
## 3. Diagnostic Data Export
Field test telemetry and raw black-box diagnostic logs can be exported directly from the **History / Field Test** screen:
* **GPX**: High-resolution track with `<extensions>` for lean angle, G-forces, speed, and GPS accuracy.
* **CSV**: Full tabular dump of raw IMU vectors, filtered speeds, validation statuses, and confidence scores for offline Python / MATLAB analysis.
* **JSON**: Structured diagnostic session report.