mirror of
https://github.com/ByteWelder/Tactility.git
synced 2026-02-18 19:03:16 +00:00
9a11e6f47b
**New Features** * Runtime font accessors and new symbol fonts for text, launcher, statusbar, and shared icons. * Added font height base setting to device.properties * Text fonts now have 3 sizes: small, default, large **Improvements** * Renamed `UiScale` to `UiDensity` * Statusbar, toolbar and many UI components now compute heights and spacing from fonts/density. * SSD1306 initialization sequence refined for more stable startup. * Multiple image assets replaced by symbol-font rendering. * Many layout improvements related to density, font scaling and icon scaling * Updated folder name capitalization for newer style
79 lines
2.8 KiB
C
79 lines
2.8 KiB
C
// SPDX-License-Identifier: Apache-2.0
|
|
|
|
/**
|
|
* Dispatcher is a thread-safe code execution queue.
|
|
*/
|
|
#pragma once
|
|
|
|
#include <tactility/freertos/freertos.h>
|
|
#include <tactility/error.h>
|
|
|
|
#ifdef __cplusplus
|
|
extern "C" {
|
|
#endif
|
|
|
|
typedef void (*DispatcherCallback)(void* context);
|
|
typedef void* DispatcherHandle_t;
|
|
|
|
DispatcherHandle_t dispatcher_alloc(void);
|
|
|
|
void dispatcher_free(DispatcherHandle_t dispatcher);
|
|
|
|
/**
|
|
* Queue a function to be consumed elsewhere.
|
|
*
|
|
* @param[in] callbackContext the data to pass to the function upon execution
|
|
* @param[in] callback the function to execute elsewhere
|
|
* @param[in] timeout lock acquisition timeout
|
|
* @retval ERROR_TIMEOUT
|
|
* @retval ERROR_RESOURCE when failing to set event
|
|
* @retval ERROR_INVALID_STATE when the dispatcher is in the process of shutting down
|
|
* @retval ERROR_NONE
|
|
*/
|
|
error_t dispatcher_dispatch_timed(DispatcherHandle_t dispatcher, void* callbackContext, DispatcherCallback callback, TickType_t timeout);
|
|
|
|
/**
|
|
* Queue a function to be consumed elsewhere.
|
|
*
|
|
* @param[in] callbackContext the data to pass to the function upon execution
|
|
* @param[in] callback the function to execute elsewhere
|
|
* @retval ERROR_RESOURCE when failing to set event
|
|
* @retval ERROR_TIMEOUT unlikely to occur unless there's an issue with the internal mutex
|
|
* @retval ERROR_INVALID_STATE when the dispatcher is in the process of shutting down
|
|
* @retval ERROR_NONE
|
|
*/
|
|
static inline error_t dispatcher_dispatch(DispatcherHandle_t dispatcher, void* callbackContext, DispatcherCallback callback) {
|
|
return dispatcher_dispatch_timed(dispatcher, callbackContext, callback, portMAX_DELAY);
|
|
}
|
|
|
|
/**
|
|
* Consume 1 or more dispatched functions (if any) until the queue is empty.
|
|
*
|
|
* @warning The timeout is only the wait time before consuming the message! It is not a limit to the total execution time when calling this method.
|
|
*
|
|
* @param[in] timeout the ticks to wait for a message
|
|
* @retval ERROR_TIMEOUT
|
|
* @retval ERROR_RESOURCE failed to wait for event
|
|
* @retval ERROR_INVALID_STATE when the dispatcher is in the process of shutting down
|
|
* @retval ERROR_NONE
|
|
*/
|
|
error_t dispatcher_consume_timed(DispatcherHandle_t dispatcher, TickType_t timeout);
|
|
|
|
/**
|
|
* Consume 1 or more dispatched functions (if any) until the queue is empty.
|
|
*
|
|
* @warning The timeout is only the wait time before consuming the message! It is not a limit to the total execution time when calling this method.
|
|
*
|
|
* @retval ERROR_TIMEOUT unlikely to occur unless there's an issue with the internal mutex
|
|
* @retval ERROR_RESOURCE failed to wait for event
|
|
* @retval ERROR_INVALID_STATE when the dispatcher is in the process of shutting down
|
|
* @retval ERROR_NONE
|
|
*/
|
|
static inline error_t dispatcher_consume(DispatcherHandle_t dispatcher) {
|
|
return dispatcher_consume_timed(dispatcher, portMAX_DELAY);
|
|
}
|
|
|
|
#ifdef __cplusplus
|
|
}
|
|
#endif
|