MotorSignal-App/FIELD_TESTING.md

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.