(HourGlass): небольшая корректировка кода и теста

include/HourGlass.h

@@ -41,10 +41,11 @@
     для проверки наступления условия срабатывания.
 
     \par Пример использования.
-    Допустим у вас есть сигнал "перегрев"(in_overheating) и вам необходимо выставить какой-то
-    флаг о перегреве (isOverheating), если этот сигнал устойчиво держится в течение 10 секунд,
-    то check() станет "true". При этом если сигнал снимется на 5 секунд ("песок начнёт обратно пересыпаться"),
-    а потом опять выставиться, то до срабатывания check() == true уже останется 5 сек, а не 10 сек.
+	Допустим у вас есть сигнал "температура"(in_temp) и вам необходимо выставить какой-то
+	флаг о перегреве (isOverheating).
+	Если температура продержиться выше порога в течение 10 секунд check() станет "true".
+	Если температура станет меньше порога через 6 секунд ("песок начнёт обратно пересыпаться"),
+	а потом опять станет выше, то до срабатывания check() == true уже останется 4 сек, а не 10 сек.
     Получается, что для срабатывания check()=true сигнал должен не колеблясь держаться больше заданного времени.
 \code
     HourGlass hg;
@@ -52,7 +53,7 @@
 
     while( ....)
     {
-         hg.rotate(in_overheating); // управляем состоянием песочных часов (прямой или обратный ход часов).
+		 hg.rotate( in_temp > HiTemp ); // управляем состоянием песочных часов (прямой или обратный ход часов).
          isOverheating = hg.check();
     }
 
@@ -152,13 +153,13 @@ class HourGlass
 			return _state;
 		}
 
-		// текущее "насыпавшееся" количество "песка"
+		// текущее "насыпавшееся" количество "песка" (прошедшее время)
 		inline timeout_t amount()
 		{
 			return ( _size - remain() );
 		}
 
-		// остаток песка (времени)
+		// остаток песка (времени) (оставшееся время)
 		inline timeout_t remain()
 		{
 			timeout_t c = t.getCurrent();
@@ -189,7 +190,7 @@ class HourGlass
 	protected:
 		PassiveTimer t;   /*!< таймер для отсчёта времени.. */
 		bool _state;      /*!< текущее "положение часов", true - прямое, false - обратное (перевёрнутое) */
-		timeout_t _sand;        /*!< сколько песка ещё осталось.. */
+		timeout_t _sand;  /*!< сколько песка ещё осталось.. */
 		timeout_t _size;  /*!< размер часов */
 };
 // --------------------------------------------------------------------------

tests/test_hourglass.cc

@@ -96,4 +96,22 @@ TEST_CASE("HourGlass", "[HourGlass]" )
 		REQUIRE( hg.amount() == 100 );
 		CHECK( hg.check() );
 	}
+
+	SECTION( "Check delay" )
+	{
+		// выставляем часы на 100.. а check вызываем через 130..
+		// должно корректно отработать и вернуть true..
+		HourGlass hg;
+		hg.run(100);
+		msleep(130);
+		CHECK( hg.check() );
+		REQUIRE( hg.remain() == 0 );
+		REQUIRE( hg.amount() == 100 );
+		CHECK_FALSE( hg.rotate(false) );
+		CHECK_FALSE( hg.check() );
+		msleep(130);
+		REQUIRE( hg.remain() == 100 ); // песок весь просыпался обратно
+		REQUIRE( hg.amount() == 0 );
+		REQUIRE( hg.interval() == 100 );
+	}
 }