1 files changed, 137 insertions, 0 deletions
diff --git a/Libraries/LTimers/ltimers.c b/Libraries/LTimers/ltimers.c
new file mode 100644
index 0000000..ccdbf00
--- /dev/null
+++ b/Libraries/LTimers/ltimers.c
@@ -0,0 +1,137 @@
+/* Описание модуля ltimers.c
+
+   Этот модуль используется для создания неограниченного количества
+программных таймеров для программы. Модуль использует аппаратный таймер, 
+который генерирует прерывание каждую 1мс (можно использовать любой другой 
+промежуток времени, просто 1 мс это очень удобно и хватает для многих
+программных пауз, задержек, таймеров и тд. в программе). 
+В прерывании вызывается ф-я ProcessLTimers(), которая инкрементирует значения
+всех таймеров. Таймеры создаются в файле ltimers.h.
+   Модуль универсален, прост и может использоваться на любой платформе, 
+компиляторе, любом МК.
+   Для подключения модуля настройте аппаратный таймер на прерывание в 1мс (или
+любой другой нужный промежуток времени) и добавьте в обработчик прерывания
+этого таймера ф-ю ProcessLTimers();. Затем добавьте #include "ltimers.h" в тот
+файл программы, где будут использоваться ф-ии модуля. Собственно, 
+в всего нужны две функции для работы с таймерами:
+
+StartLTimer ( LTIMER_LED_BLINK ); // запустить таймер
+GetLTimer   ( LTIMER_LED_BLINK ); // получить текущее значение таймера
+
+   Пример использования:
+...
+// Предварительно ltimers.h создаем перечисление, в котором создаем имена для 
+// программных таймеров, а также в конце перечисления всегда MAX_LTIMERS
+#include "ltimers.h"
+...
+
+int main ()
+{
+   ...
+   // Настройка аппаратного таймера на прерывание раз в 1 мс
+   InitLTimersHardWare();   
+
+   // Стартовая инициализация (просто обнуление) всех программных таймеров
+   InitLTimers ();
+   
+   // Запускаем таймер
+   StartLTimer ( LTIMER_LED_BLINK );
+
+   // Основной цикл программы 
+   while (1)
+  {
+     // Проверяем значение таймера
+     if ( GetLTimer ( LTIMER_LED_BLINK ) >= 500 )
+     {
+        LED_ON;
+     }   
+  }
+} 
+
+***Примечание
+
+ 1. Необходимо учитывать разрядность МК и атомарность при проверке значений 
+таймера. То есть, если произойдет прерывание в момент проверки полубайтов на
+8-ми разрядном МК, то, возможно, могут быть трудноуловимые глюки.
+
+ 2. Обратите внимание, что в ф-ии ProcessLTimers() значения таймеров 
+инкрементируются постоянно и не перестают изменяться. Ф-я StartLTimer только
+сбрасывает значение таймера в ноль, а потом программа уже ловит тот момент, 
+когда это значение превысило или сравнялось с нужным. И когда мы провели
+сравнение, то таймер все равно продолжает маслать. Но это не важно. Пусть себе 
+маслает.
+
+ 3. Псевдоним для типа uint32_t можно заменить на необходимый в зависимости
+от среды разработки и компилятора.
+*/
+
+#include "ltimers.h"
+#include "ltimers_config.h"
+
+uint32_t LTimers [MAX_LTIMERS] = { 0 };
+
+
+// ----------------------------------------------------------------------------
+// Стартовая инициализация всех программных таймеров программиста.
+// Ф-я вызывается при старте МК и просто устанавливает все значения таймеров
+// в ноль.
+// ----------------------------------------------------------------------------
+void InitLTimers (void)
+{
+    LTimersConfig ();
+}
+
+
+// ----------------------------------------------------------------------------
+// Ф-я получения значения программного счетчика
+// Используется программистом для проверки значения запущенного таймера
+// Ф-я принимает имя таймера из перечисления LTimerNum_t в файле ltimers.h
+// Ф-я возвращает значение таймера, которое увеличивается каждую 1мс
+// ----------------------------------------------------------------------------
+uint32_t GetLTimer ( LTimersNames_t LTimer )
+{
+    return LTimers[ LTimer ];
+}
+
+
+// ----------------------------------------------------------------------------
+// Ф-я запуска программного таймера для использования программистом для
+// любых программных задержек разрешением 1мс
+// Ф-я принимает имя таймера из перечисления LTimerNum_t в файле ltimers.h
+// ----------------------------------------------------------------------------
+void StartLTimer ( LTimersNames_t LTimer )
+{
+    LTimers[ LTimer ] = 0;
+}
+
+
+// ----------------------------------------------------------------------------
+// Ф-я, инкрементирующая значения программных таймеров. Количество этих
+// программных таймеров нее ограничено и задается программистом в ltimers.h
+// в тайпдефе LTimerNum_t. Просто дописываем в перечислении перед MAX_LTIMERS 
+// имя нового таймера.
+// Вызывается эта ф-я в обреботчике TIM6_IRQHandler каждую 1 мс.
+// 1 мс это удобный квант времени для разных программных задержек
+// ----------------------------------------------------------------------------
+void ProcessLTimers (void)
+{
+    for ( uint32_t i = 0; i < MAX_LTIMERS; i++ )
+    {
+        LTimers[i]++;
+    }
+}
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+