Quick Start Guide - nRF52840 Fitness Sensor in 5 Minutes

🚀 Choose Your Method

Method 1: iOS App

Best for: Visual testing, real-time monitoring

Open iOS Control App
Tap your sensor
Scroll down → Tap "Test Workouts"
Select any workout
Tap "Start Workout"

✅ Real-time progress bars
✅ Live stats display
✅ Pause/resume/skip controls

Method 2: Python Script

Best for: Automation, CI/CD, scripting

# Install
pip install colorama tabulate

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

# Quick test all scenarios
python test_automation.py --all

✅ Command-line automation
✅ Custom JSON workouts
✅ Batch testing

Method 3: Manual Control

Best for: Debugging, custom testing

# Set intensity directly
chip-tool levelcontrol move-to-level 180 0 0 0 1 1

# Turn on/off
chip-tool onoff on 1 1
chip-tool onoff off 1 1

✅ Direct hardware access
✅ Single command testing
✅ Debugging

📋 10 Pre-Built Test Scenarios

Scenario	Duration	Purpose
HIIT Intervals	30m	Test rapid intensity changes
Endurance	45m	Test sustained output
Recovery	20m	Test low intensity baseline
Pyramids	25m	Test progressive ramps
Tabata	4m	Test maximum sprints
FTP Test	25m	Test threshold power
Warm-up	10m	Test gradual builds
Sweet Spot	40m	Test sub-threshold work
VO2 Max	30m	Test high intensity
Ramp Test	15m	Test progressive overload

🎯 Quick Test Examples

Example 1: Test Intervals with iOS App

Open app → Select sensor
Tap "Test Workouts"
Select "HIIT Intervals"
Review 9 segments: Warm-up → Intervals × 4 → Cool-down
Tap "Start Workout"

Watch progress:

████████████████████ 45% | 13:30 / 16:30
Current: Interval 2
⚡ 327W | ❤️ 171 BPM

Example 2: Quick Test All Scenarios

iOS App:

Tap "Test Workouts"
Tap "Run Quick Test Suite"
Wait 2 minutes
View results: ✅ 10/10 passed

Python:

python test_automation.py --all

🧪 Running Quick Test Suite

Testing HIIT Intervals... ✅ PASS
Testing Endurance Ride... ✅ PASS
Testing Recovery Spin... ✅ PASS
Testing Pyramid Intervals... ✅ PASS
Testing Tabata Protocol... ✅ PASS
Testing FTP Test... ✅ PASS
Testing Warm-up Routine... ✅ PASS
Testing Sweet Spot Training... ✅ PASS
Testing VO2 Max Intervals... ✅ PASS
Testing Ramp Test... ✅ PASS

Test Results: 10/10 passed

Example 3: Custom Workout

Create my_workout.json:

{
  "name": "Quick Sprint Test",
  "description": "3 sprints with recovery",
  "segments": [
    {"name": "Warm-up", "duration": 180, "intensity": 100},
    {"name": "Sprint 1", "duration": 30, "intensity": 240},
    {"name": "Recovery", "duration": 120, "intensity": 80},
    {"name": "Sprint 2", "duration": 30, "intensity": 240},
    {"name": "Recovery", "duration": 120, "intensity": 80},
    {"name": "Sprint 3", "duration": 30, "intensity": 240},
    {"name": "Cool-down", "duration": 180, "intensity": 70}
  ]
}

Run it:

python test_automation.py --custom my_workout.json

🔥 Real-World Testing Workflows

Workflow 1: Daily Smoke Test

Time: 2 minutes

# Quick test all scenarios
python test_automation.py --all

# Check results
# All passed? ✅ Good to go
# Any failed? 🔍 Investigate

Workflow 2: Pre-Demo Check

Time: 5 minutes

Open "Test Workouts"
Run "Warm-up Routine" (10m)
Open Zwift during workout
Verify smooth transitions
Ready to demo! 🎉

Workflow 3: Zwift Integration Test

Time: 30 minutes

# Terminal 1: Start automated workout
python test_automation.py --workout intervals

# Terminal 2: Monitor logs
screen /dev/ttyACM0 115200

# Zwift: Pair sensors and ride
# Verify power/HR changes match automation

💡 Pro Tips

Tip 1: Parallel Testing

Run multiple tests simultaneously on different devices using different node IDs

Tip 2: Automated Nightly Tests

Create a cron job to run tests every night and email results

Tip 3: Create Test Playlists

Save common test sequences in text files and run them in batch

Tip 4: Integration with CI/CD

Add test automation to your GitHub Actions workflow

📊 Understanding Results

iOS App Results

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

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

✅ Workout Complete!
Total Time: 30:05
Segments Completed: 9/9
All segments completed successfully!

Python Script Results

🎉 Workout Complete!

============================================================
Workout Summary
============================================================
Total Time: 0:30:05
Segments Completed: 9/9
✅ All segments completed successfully!

🐛 Common Issues & Fixes

Issue	Solution
"Sensor offline"	✅ Check power ✅ Check Thread network ✅ Re-commission device
"Values not changing"	✅ Enable sensor in app ✅ Check BLE connection ✅ Verify firmware running
"Zwift not updating"	✅ Re-pair in Zwift ✅ Check BLE range ✅ Restart Zwift
"Python script fails"	✅ Install dependencies ✅ Check node-id correct ✅ Verify chip-tool installed

✅ Success Checklist

Before shipping/demoing:

All scenarios pass quick test
Zwift integration works smoothly
No connection drops in 45-min test
Transitions are smooth (<2s)
Values are accurate (±5%)
Battery lasts expected duration
iOS app controls work
Python automation works
Custom workouts load correctly
Documentation is clear

🎓 Next Steps

1. Run First Test

python test_automation.py --workout warmup

2. Try iOS Automation

Open app → Test Workouts → Start

3. Create Custom Workout

Copy template, modify segments, test it!

Ready to automate! Let's test! 🚀

Continue to the full testing guide for advanced features and detailed documentation.

⚡ Quick Start Guide