๐Ÿšด nRF52840 Fitness Sensor

Complete Documentation & Testing Framework

Welcome to the Documentation

Complete guide for building, testing, and deploying your BLE + Matter fitness sensor. This system emulates heart rate monitors and cycling power meters for apps like Zwift, while providing Matter network control for smart home integration.

๐Ÿ”ต BLE Emulation

  • Heart Rate Monitor
  • Cycling Power Meter
  • Cadence Sensor
  • Battery Level
  • Zwift Compatible

๐ŸŒ Matter Control

  • Thread Network
  • On/Off Control
  • Intensity Adjustment
  • Apple Home Integration
  • Voice Control (Siri)

๐Ÿงช Automated Testing

  • 10 Pre-built Scenarios
  • iOS Testing App
  • Python Automation
  • Real-time Dashboard
  • Regression Suite

๐Ÿ“š Documentation

๐Ÿš€ Quick Start Guide

Get up and running in 5 minutes with automated testing

Read More โ†’

๐Ÿ”ง Hardware Setup

nRF52840 firmware setup with BLE and Matter support

Read More โ†’

๐Ÿ“ฑ iOS App Guide

Build and use the iOS control app with Matter integration

Read More โ†’

๐Ÿงช Automated Testing

Complete guide to workout scenarios and test automation

Read More โ†’

๐Ÿ”„ Testing Integration

Advanced workflows combining all testing tools

Read More โ†’

๐ŸŒ Complete System

Full system integration: nRF52840 + iOS + Zwift

Read More โ†’

๐Ÿ“‹ Quick Reference

One-page cheat sheet for common commands and troubleshooting

Read More โ†’

โšก Quick Start

Get started in 3 commands:

# 1. Flash firmware to nRF52840
west build -b nrf52840dk_nrf52840 && west flash
# 2. Run quick test
python test_automation.py --all
# 3. Generate report
python test_reporter.py --results test_results.json

๐ŸŽฏ Project Structure

fitness-sensor-matter/
โ”œโ”€โ”€ firmware/
โ”‚   โ”œโ”€โ”€ src/main.cpp              # nRF52840 firmware
โ”‚   โ”œโ”€โ”€ prj.conf                  # Project configuration
โ”‚   โ”œโ”€โ”€ CMakeLists.txt            # Build configuration
โ”‚   โ””โ”€โ”€ fitness-sensor.zap        # Matter cluster definitions
โ”œโ”€โ”€ ios/
โ”‚   โ”œโ”€โ”€ FitnessSensorApp.swift    # Main iOS app
โ”‚   โ”œโ”€โ”€ WorkoutScenarios.swift    # Test scenarios
โ”‚   โ”œโ”€โ”€ WorkoutScenarioView.swift # UI components
โ”‚   โ”œโ”€โ”€ Info.plist                # App configuration
โ”‚   โ””โ”€โ”€ Entitlements.plist        # HomeKit permissions
โ”œโ”€โ”€ testing/
โ”‚   โ”œโ”€โ”€ test_automation.py        # Workout automation
โ”‚   โ”œโ”€โ”€ test_reporter.py          # Report generation
โ”‚   โ”œโ”€โ”€ live_monitor.py           # Real-time dashboard
โ”‚   โ”œโ”€โ”€ regression_suite.py       # Regression testing
โ”‚   โ””โ”€โ”€ custom_workout.json       # Sample custom workout
โ””โ”€โ”€ docs/
    โ”œโ”€โ”€ index.html                # This page
    โ”œโ”€โ”€ quick-start.html          # Quick start guide
    โ”œโ”€โ”€ hardware-setup.html       # Hardware documentation
    โ”œโ”€โ”€ ios-app-guide.html        # iOS documentation
    โ”œโ”€โ”€ testing-guide.html        # Testing documentation
    โ””โ”€โ”€ ...