# 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.