98 lines
2.0 KiB
C++

/**
* @file
* @brief Implementation of system events.
*/
#ifndef STA_TACOS_SYSTEM_EVENTS_HPP
#define STA_TACOS_SYSTEM_EVENTS_HPP
/**
* @defgroup STA_RTOS_SysEvent System Events
* @ingroup STA_RTOS_API
* @brief System events.
*
* Check @ref STA_RTOS_BuildConfig for configuration options.
*/
#include <cstdint>
// System event flags
//
/**
* @brief Startup system event flag.
*
* @ingroup STA_RTOS_SysEvent
*/
#define STA_TACOS_EVENT_SYSTEM_MASK (0xFFFE0000U >> 1)
#define STA_TACOS_EVENT_TIMER_MASK (0x7FC00000U >> 1)
#define STA_TACOS_SYSTEM_EVENTS_STARTUP (0x01U << 30)
#define STA_TACOS_TICK_100_Hz (0x01U << 29)
#define STA_TACOS_TICK_50_Hz (0x01U << 28)
#define STA_TACOS_TOCK_50_Hz (0x01U << 27)
#define STA_TACOS_TICK_20_Hz (0x01U << 26)
#define STA_TACOS_TOCK_20_Hz (0x01U << 25)
#define STA_TACOS_TICK_10_Hz (0x01U << 24)
#define STA_TACOS_TOCK_10_Hz (0x01U << 23)
#define STA_TACOS_TICK_1_Hz (0x01U << 22)
#define STA_TACOS_TOCK_1_Hz (0x01U << 21)
namespace sta
{
namespace tacos
{
namespace events
{
/**
* @brief Initialize system events.
*/
void init();
/**
* @brief Signal system events.
*
* @param flags System event flags
*
* @ingroup STA_RTOS_SysEvent
*/
void signal(uint32_t flags);
/**
* @brief Wait for system events.
*
* @param flags System event flags
* @param options osFlagsWaitAll or osFlagsWaitAny (osFlagsNoClear always set)
* @param timeout Wait timeout (0 = instant, osWaitForever = infinite)
*
* @ingroup STA_RTOS_SysEvent
*/
void wait(uint32_t flags, uint32_t options, uint32_t timeout);
/**
* @brief Signal startup system event.
*
* @ingroup STA_RTOS_SysEvent
*/
void signalStartup();
/**
* @brief Wait for startup system event.
*
* Blocking while waiting
*
* @ingroup STA_RTOS_SysEvent
*/
void waitForStartup();
} // namespace events
} // namespace tacos
} // namespace sta
#endif // STA_RTOS_SYSTEM_EVENTS_HPP