diff options
Diffstat (limited to 'app/ltimers')
-rw-r--r-- | app/ltimers/ltimers.c | 122 | ||||
-rw-r--r-- | app/ltimers/ltimers.h | 29 | ||||
-rw-r--r-- | app/ltimers/ltimers_config.c | 56 | ||||
-rw-r--r-- | app/ltimers/ltimers_config.h | 15 |
4 files changed, 222 insertions, 0 deletions
diff --git a/app/ltimers/ltimers.c b/app/ltimers/ltimers.c new file mode 100644 index 0000000..61c9e6f --- /dev/null +++ b/app/ltimers/ltimers.c @@ -0,0 +1,122 @@ +/* Описание модуля 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]++; + } +} diff --git a/app/ltimers/ltimers.h b/app/ltimers/ltimers.h new file mode 100644 index 0000000..4514841 --- /dev/null +++ b/app/ltimers/ltimers.h @@ -0,0 +1,29 @@ +#ifndef LTIMERS_H_INCLUDED +#define LTIMERS_H_INCLUDED + +#include <stdint.h> + +// Имена таймеров LTIMER_<TIMERNAME> ---------------------------------------- // +typedef enum { + + LTIMER_SENSE_PAD = 0, + LTIMER_PRGBAR_SPEED, + LTIMER_HL_CHANGE_BRIGHT_SPEED, + LTIMER_HL_BUT_LED, + LTIMER_BUTTON_LONG_PRESS, + LTIMER_INDIC_MODE_BLINK_OFF, + LTIMER_INDIC_MODE_BLINK_ON, + LTIMER_MENU_ADJ_TIME_OUT, + LTIMER_LIGHT_SENSOR, + LTIMER_SENSOR_BUT_DEBOUNCE, + + MAX_LTIMERS + +} LTimersNames_t; + +void InitLTimers ( void ); +void ProcessLTimers ( void ); +uint32_t GetLTimer ( LTimersNames_t LTIMER ); +void StartLTimer ( LTimersNames_t LTIMER ); + +#endif // LTIMERS_H_INCLUDED diff --git a/app/ltimers/ltimers_config.c b/app/ltimers/ltimers_config.c new file mode 100644 index 0000000..a30b36f --- /dev/null +++ b/app/ltimers/ltimers_config.c @@ -0,0 +1,56 @@ +#include "ltimers_config.h" + +#include "stm32f0xx_conf.h" + + +// ---------------------------------------------------------------------------- +// Инициализация аппаратного таймера для генерирования прерываний каждую 1мс +// ---------------------------------------------------------------------------- +void LTimersConfig ( void ) +{ + NVIC_InitTypeDef NVIC_InitStructure; + TIM_TimeBaseInitTypeDef TIM_TimeBaseStructure; + + /* LTIMER_TIMx clock enable */ + LTIMER_RCC_APBxPeriphClockCmd ( LTIMER_TIM_RCC, ENABLE ); + + /* Enable the LTIMER_TIMx gloabal Interrupt */ + NVIC_InitStructure.NVIC_IRQChannel = LTIMER_TIM_IRQx; + NVIC_InitStructure.NVIC_IRQChannelPriority = 1; + NVIC_InitStructure.NVIC_IRQChannelCmd = ENABLE; + NVIC_Init ( &NVIC_InitStructure ); + + /* ----------------------------------------------------------------------- + In this example TIM7 counter clock (TIM7CLK) is set to APB1 clock (PCLK1), since + APB1 prescaler is set to 1 and TIM7 prescaler is set to 0. + + In this example TIM7 input clock (TIM7CLK) is set to APB1 clock (PCLK1), + since APB1 prescaler is set to 1. + TIM7CLK = PCLK1 = HCLK = SystemCoreClock + + With Prescaler set to 479 and Period to 24999, the TIM7 counter is updated each 250 ms + (i.e. and interrupt is generated each 250 ms) + TIM7 counter clock = TIM7CLK /((Prescaler + 1)*(Period + 1)) + = 48 MHz / ((25000)*(480)) + = 4 Hz + ==> TIM7 counter period = 250 ms + + Note: + SystemCoreClock variable holds HCLK frequency and is defined in system_stm32f0xx.c file. + Each time the core clock (HCLK) changes, user had to call SystemCoreClockUpdate() + function to update SystemCoreClock variable value. Otherwise, any configuration + based on this variable will be incorrect. + ----------------------------------------------------------------------- */ + /* Time base configuration */ + TIM_TimeBaseStructure.TIM_Period = 1000; //24999; + TIM_TimeBaseStructure.TIM_Prescaler = (SystemCoreClock/1000000)-1; //479; + TIM_TimeBaseStructure.TIM_ClockDivision = TIM_CKD_DIV1; + TIM_TimeBaseStructure.TIM_CounterMode = TIM_CounterMode_Up; + TIM_TimeBaseInit ( LTIMER_TIMx, &TIM_TimeBaseStructure ); + + /* LTIMER_TIMx Interrupts enable */ + TIM_ITConfig ( LTIMER_TIMx, TIM_IT_Update, ENABLE ); + + /* LTIMER_TIMx enable counter */ + TIM_Cmd ( LTIMER_TIMx, ENABLE ); +} diff --git a/app/ltimers/ltimers_config.h b/app/ltimers/ltimers_config.h new file mode 100644 index 0000000..50a75db --- /dev/null +++ b/app/ltimers/ltimers_config.h @@ -0,0 +1,15 @@ +#ifndef LTIMERS_CONFIG_INCLUDED +#define LTIMERS_CONFIG_INCLUDED + +// Примечание +// Обратить внимание на то, что таймеры тактируются от разных шин APB1 или APB2 + +#define LTIMER_IRQHandler TIM17_IRQHandler +#define LTIMER_TIMx TIM17 +#define LTIMER_TIM_RCC RCC_APB2Periph_TIM17 +#define LTIMER_TIM_IRQx TIM17_IRQn +#define LTIMER_RCC_APBxPeriphClockCmd RCC_APB2PeriphClockCmd + +void LTimersConfig ( void ); + +#endif // LTIMERS_CONFIG_INCLUDED |