🧪 Automated Testing Guide

📚 Table of Contents

🎯 Testing Overview

The fitness sensor testing framework provides three ways to run automated tests:

What Gets Tested

• ✅ Intensity Changes - Smooth transitions between power zones
• ✅ BLE Broadcasting - Continuous data streaming to Zwift
• ✅ Matter Control - Remote command execution
• ✅ Edge Cases - Rapid changes, max/min values
• ✅ Duration Accuracy - Segment timing precision
• ✅ Value Stability - Consistent output at each intensity

🏋️ Available Test Scenarios

Warm-up (5m) → Interval 1 (4m) → Recovery (3m) → 
Interval 2 (4m) → Recovery (3m) → Interval 3 (4m) → 
Recovery (3m) → Interval 4 (4m) → Cool-down (5m)

Warm-up (5m) → Steady State (35m) → Cool-down (5m)

Easy Spin (20m)

Warm-up → 1min → Rest → 2min → Rest → 
3min → Rest → 2min → Rest → 1min → Cool-down

Warm-up (2m) → [20s max / 10s rest] × 8 → Cool-down (2m)

📱 iOS App Testing

Getting Started

1. Open FitnessSensorController app
2. Tap your sensor from the device list
3. Scroll down and tap "Test Workouts"
4. Browse list of scenarios

Running a Workout

Overall: 45%
████████████░░░░░░░░░
13:30 / 16:30

Current: Interval 2
████████░░░░░░░░░░░░
⚡ 327W | ❤️ 171 BPM
2:43 remaining

Quick Test Suite

Test all scenarios in 2 minutes:

1. Tap "Test Workouts"
2. Tap "Run Quick Test Suite"
3. Wait ~2 minutes
4. View results: ✅ 10/10 passed

💻 Command Line Testing

Installation

# Install dependencies
pip install colorama tabulate

# Install Matter chip-tool (if not already installed)
# See: https://github.com/project-chip/connectedhomeip

Basic Usage

List Available Workouts

python test_automation.py --list

📋 Available Workout Scenarios:

  intervals    - HIIT Intervals
               4x4 minute high intensity with recovery
               Duration: 30:00, Segments: 9

  endurance    - Endurance Ride
               Steady state for 45 minutes
               Duration: 45:00, Segments: 3
  ...

Run a Specific Workout

# Run HIIT intervals
python test_automation.py --workout intervals

# Run Tabata with custom node ID
python test_automation.py --workout tabata --node-id 2

# Dry run (no commands sent)
python test_automation.py --workout ftp --dry-run

Quick Test All Scenarios

python test_automation.py --all

🧪 Running Quick Test Suite

Testing HIIT Intervals... ✅ PASS
Testing Endurance Ride... ✅ PASS
Testing Recovery Spin... ✅ PASS
...
Test Results: 10/10 passed

Advanced Options

# Full command with all options
python test_automation.py \
    --workout intervals \
    --node-id 1 \
    --endpoint 1 \
    --verbose \
    --dry-run

🎨 Custom Workouts

JSON Format

Create a custom workout file (my_workout.json):

{
  "name": "My Custom Workout",
  "description": "Custom test scenario",
  "segments": [
    {
      "name": "Warm-up",
      "duration": 300,
      "intensity": 100,
      "notes": "5 minutes at low intensity"
    },
    {
      "name": "Build Power",
      "duration": 180,
      "intensity": 120
    },
    {
      "name": "Threshold",
      "duration": 600,
      "intensity": 180
    },
    {
      "name": "Recovery",
      "duration": 300,
      "intensity": 70
    },
    {
      "name": "Sprint",
      "duration": 30,
      "intensity": 254
    },
    {
      "name": "Cool Down",
      "duration": 300,
      "intensity": 60
    }
  ],
  "metadata": {
    "author": "Your Name",
    "created": "2025-01-15"
  }
}

Field Reference

Intensity Mapping

Run Custom Workout

# Via Python script
python test_automation.py --custom my_workout.json

# Validate first
python test_automation.py --custom my_workout.json --dry-run

🎮 Zwift Integration Testing

Setup for Zwift Testing

1. Start Sensor

   python test_automation.py --workout warmup

2. Open Zwift and go to Settings → Sensors
3. Pair Sensors:
   • Heart Rate: "Bike Sensor Matter"
   • Power Meter: "Bike Sensor Matter"
4. Start Riding in Zwift
5. Run Test Workout

   python test_automation.py --workout intervals

Validation Checklist

• Both sensors connect immediately
• Power updates every 1 second
• HR updates every 1 second
• No connection drops during workout
• Smooth transitions between segments
• Values match expected ranges
• Zwift avatar responds correctly
• No lag or delay in updates

📊 Performance Testing

Metrics to Track

Running Performance Tests

# Test sustained load
python test_automation.py --workout endurance

# Test rapid changes
python test_automation.py --workout tabata

# Test all scenarios
python test_automation.py --all

🐛 Troubleshooting

Common Issues