CourseManager.h

Go to the documentation of this file.

 
#ifndef _COURSE_MANAGER_H
#define _COURSE_MANAGER_H
 
#include <Arduino.h>
#include "DovesLapTimer.h"
#include "WaypointLapTimer.h"
#include "CourseDetector.h"
 
struct CourseConfig {
  const char* name;
  float lengthFt;
  double startALat, startALng, startBLat, startBLng;
  double sector2ALat, sector2ALng, sector2BLat, sector2BLng;
  double sector3ALat, sector3ALng, sector3BLat, sector3BLng;
  bool hasSector2;
  bool hasSector3;
};
 
struct TrackConfig {
  const char* longName;
  const char* shortName;
  CourseConfig courses[MAX_COURSES];
  int courseCount;
};
 
struct CourseTimerEntry {
  DovesLapTimer timer;
  const char* name;
  float lengthFt;
  bool active;
};
 
class CourseManager {
public:
  CourseManager(TrackConfig& config, double crossingThreshold = 7.0, Stream *debugSerial = NULL);
 
  void updateCurrentTime(unsigned long ms);
  int loop(double lat, double lng, float altMeters, float speedKnots);
  void reset();
  void pruneInactiveCourses();
  bool selectCourse(int index);
 
  // Detection state
  bool isDetectionComplete() const;
  int getActiveCourseIndex() const;
  const char* getActiveCourseName() const;
  int getCourseCount() const;
  int getDetectionRejectionCount() const;
  // True while the given course's timer is still being fed GPS data.
  // Courses are deactivated by pruneInactiveCourses() after detection, or
  // automatically when the Lap Anything fallback activates.
  bool isCourseTimerActive(int index) const;
 
  // Timer access
  DovesLapTimer* getActiveTimer();
  WaypointLapTimer* getLapAnythingTimer();
  bool isLapAnythingActive() const;
 
  // Track metadata
  const char* getTrackName() const;
  const char* getShortName() const;
 
  // Detector access
  CourseDetector* getDetector();
 
  // Threshold setters
  void setSpeedThresholdMph(float mph);
  void setWaypointProximityMeters(float meters);
  void setDetectionProximityMeters(float meters);
 
private:
#ifdef DOVES_DISABLE_DEBUG
  // Compile-time debug kill switch: the runtime _serial null-check still
  // keeps every debug string and print call-site in flash on production
  // builds that never attach a debug Stream. Defining DOVES_DISABLE_DEBUG
  // (e.g. -DDOVES_DISABLE_DEBUG in build flags) replaces the debug
  // templates with empty inlines so the compiler drops it all — several
  // KB on a fully-featured firmware. Debug behavior is unchanged when
  // the macro is not defined.
  template<typename... Args> void debug_print(Args&&...) {}
  template<typename... Args> void debug_println(Args&&...) {}
#else
  template<typename... Args>
  void debug_print(Args&&... args) {
    if(_serial) { _serial->print(std::forward<Args>(args)...); }
  }
  template<typename... Args>
  void debug_println(Args&&... args) {
    if(_serial) { _serial->println(std::forward<Args>(args)...); }
  }
#endif
 
  void _initCourses(TrackConfig& config);
  void _handleCandidatesReady(float currentOdometer);
  void _activateLapAnything();
 
  Stream *_serial;
  double _crossingThreshold;
 
  CourseTimerEntry _courseTimers[MAX_COURSES];
  int _courseCount;
 
  CourseDetector _detector;
  WaypointLapTimer _lapAnythingTimer;
 
  int _activeCourseIndex;
  bool _detectionComplete;
  bool _lapAnythingActive;
  int _detectionRejectionCount;
  // Odometer reading beyond which incomplete detection falls back to Lap
  // Anything (factor x longest configured course, floored — see
  // COURSE_DETECT_FALLBACK_* in DovesLapTimer.h).
  float _fallbackDistanceMeters;
 
  const char* _trackLongName;
  const char* _trackShortName;
};
 
#endif