some preperations for start procedure checks (#20)

ScStwLibraries/headers/scstwrace.h

@@ -57,6 +57,7 @@ public:
     explicit ScStwRace(QObject *parent = nullptr);
 
     enum RaceState { IDLE, STARTING, WAITING, RUNNING, STOPPED };
+    // will become IDLE, PREPAIRING, WAITING, STARTING, RUNNING, STOPPED later
     Q_ENUM(RaceState)
 
     enum StartAction { None = -1, AtYourMarks = 0, Ready = 1, Start = 2 };

ScStwLibraries/headers/scstwtimer.h

@@ -82,6 +82,7 @@ public:
         LOST,       /*!< Timer has lost */
         FAILED,     /*!< A false start occured */
         CANCELLED,  /*!< Timer was cancelled */
+//        INCIDENT,   /*!< There was a technical incident */
         DISABLED    /*!< Timer is disabled */
     };
     Q_ENUM(TimerState);
@@ -90,10 +91,22 @@ public:
      * \brief The StopReason enum contains all possible reasons for a stop
      */
     enum StopReason {
-        ManualStop, /*!< Timer was stopped manually */
+        ManualStop,             /*!< Timer was stopped manually */
-        CancelStop, /*!< Timer was cancelled */
+        CancelStop,             /*!< Timer was cancelled */
-        FailStop,   /*!< A false start occured */
+        FailStop,               /*!< A false start occured */
-        TopPadStop  /*!< Timer was stopped by a physical trigger (eg. a ScStwExtension) */
+        TopPadStop,             /*!< Timer was stopped by a physical trigger (eg. a ScStwExtension) */
+        TechnicalIncidentStop   /*!< The timer was stopped due to a technical incident */
+    };
+
+    /*!
+     * \brief The ReadyStatus enum contains all possible reasons for a timer not to be ready (>0) and the case that it is ready (0)
+     */
+    enum ReadyState {
+        IsReady = 0,                /*!< Timer is ready for start */
+        NotInIdleState,             /*!< Timer is not in IDLE state */
+        IsDisabled,                 /*!< Timer is disabled */
+        NotAllExtensionsConnected,  /*!< Not all extension of the timer are conneted */
+        NotAllClimbersReady         /*!< The startpad of the timer is not triggered */
     };
 
 protected:
@@ -305,6 +318,12 @@ public slots:
      */
     bool getWantsToBeDisabled();
 
+    /*!
+     * \brief Function to get the current ready status of a timer
+     * \return The current ready status
+     */
+    virtual ScStwTimer::ReadyState getReadyState();
+
 protected slots:
 
     /*!
@@ -373,6 +392,12 @@ signals:
      */
     void wantsToBeDisabledChanged(ScStwTimer* timer, bool wantsToBeDisabled);
 
+    /*!
+     * \brief Emitted when the ready state of the timer changes
+     * \param readyState the new ReadyState
+     */
+    void readyStateChanged(ReadyState readyState);
+
 };
 
 #endif // SCSTWTIMER_H

ScStwLibraries/sources/scstwtimer.cpp

@@ -157,6 +157,10 @@ bool ScStwTimer::reset(){
     return true;
 }
 
+ScStwTimer::ReadyState ScStwTimer::getReadyState() {
+    return this->state == IDLE ? ScStwTimer::IsReady : ScStwTimer::NotInIdleState;
+}
+
 // ------------------------
 // --- helper functions ---
 // ------------------------