Дефайны ms Задержек переделаны под static inline и ИЗМЕНЕНО API

This commit is contained in:
2025-12-25 10:34:21 +03:00
parent dfbae9be39
commit 457ec2a729

View File

@@ -79,8 +79,8 @@ extern void Error_Handler(void);
* Этот блок содержит макросы для реализации задержек с использованием HAL или FreeRTOS: * Этот блок содержит макросы для реализации задержек с использованием HAL или FreeRTOS:
* - @ref msDelay — простая задержка заданной длительности; * - @ref msDelay — простая задержка заданной длительности;
* - @ref msDelayStart — сохранение текущего времени начала задержки; * - @ref msDelayStart — сохранение текущего времени начала задержки;
* - @ref msDelayWhileActive — проверка, активна ли задержка; * - @ref msDelayActive — проверка, активна ли задержка;
* - @ref msDelayWaitDone — проверка, завершена ли задержка. * - @ref msDelayDone — проверка, завершена ли задержка.
* Эти макросы удобны для реализации неблокирующих задержек. * Эти макросы удобны для реализации неблокирующих задержек.
* @{ * @{
*/ */
@@ -92,13 +92,18 @@ extern void Error_Handler(void);
* @note Использует задержку через @ref local_time или osDelay в зависимости от @ref FREERTOS_DELAY. * @note Использует задержку через @ref local_time или osDelay в зависимости от @ref FREERTOS_DELAY.
*/ */
#ifdef FREERTOS_DELAY #ifdef FREERTOS_DELAY
#define msDelay(_ms_) osDelay(_ms_) __STATIC_INLINE void msDelay(uint32_t _ms_)
{
osDelay(_ms_);
}
#else #else
#define msDelay(_ms_) \ __STATIC_INLINE void msDelay(uint32_t _ms_)
do { \ {
uint32_t _start_ = local_time(); \ volatile uint32_t _start_ = local_time();
while (local_time() - _start_ < (_ms_)) {} \ while ((local_time() - _start_) < (_ms_))
} while(0) {
}
}
#endif #endif
@@ -110,7 +115,10 @@ extern void Error_Handler(void);
* *
* Используется для реализации неблокирующих задержек. * Используется для реализации неблокирующих задержек.
*/ */
#define msDelayStart(_pvar_) *(_pvar_) = local_time() __STATIC_INLINE void msDelayStart(uint32_t *_pvar_)
{
*(_pvar_) = local_time();
}
/** /**
* @brief Проверяет, активна ли задержка. * @brief Проверяет, активна ли задержка.
@@ -119,15 +127,18 @@ extern void Error_Handler(void);
* @retval 1 Задержка еще активна. * @retval 1 Задержка еще активна.
* @retval 0 Задержка завершена. * @retval 0 Задержка завершена.
* @details * @details
* Возвращает true, пока время задержки не истекло. Используется в проверках, * Возвращает true, пока задержка активна. Используется в проверках,
* когда нужно **действовать, пока задержка выполняется**. Пример: * когда нужно **действовать, пока задержка выполняется**. Пример:
* @code * @code
* while(msDelayWhileActive(1000, &tick)) { * while(msDelayActive(1000, &tick)) {
* // выполняем другие задачи, задержка не блокирует поток * // выполняем другие задачи, задержка не блокирует поток
* } * }
* @endcode * @endcode
*/ */
#define msDelayWhileActive(_ms_, _pvar_) (local_time() - *(_pvar_) < _ms_) __STATIC_INLINE int msDelayActive(uint32_t _ms_, uint32_t *_pvar_)
{
return (local_time() - *(_pvar_) < _ms_);
}
/** /**
* @brief Проверяет, завершилась ли задержка. * @brief Проверяет, завершилась ли задержка.
@@ -136,15 +147,18 @@ extern void Error_Handler(void);
* @retval 1 Задержка завершена. * @retval 1 Задержка завершена.
* @retval 0 Задержка еще активна. * @retval 0 Задержка еще активна.
* @details * @details
* Возвращает true, когда задержка уже завершена. Используется в проверках, * Возвращает true, когда задержка закончилась. Используется в проверках,
* когда нужно **выполнить действие только после окончания задержки**. Пример: * когда нужно **выполнить действие только после окончания задержки**. Пример:
* @code * @code
* if(msDelayWaitDone(1000, &tick)) { * if(msDelayDone(1000, &tick)) {
* // выполняем действие после завершения задержки * // выполняем действие после завершения задержки
* } * }
* @endcode * @endcode
*/ */
#define msDelayWaitDone(_ms_, _pvar_) (local_time() - *(_pvar_) >= _ms_) __STATIC_INLINE int msDelayDone(uint32_t _ms_, uint32_t *_pvar_)
{
return (local_time() - *(_pvar_) >= _ms_);
}
/** DELAYS_DEFINES /** DELAYS_DEFINES
* @} * @}