0f8380e8fe
- Add app path get() functions to `TactilityC` - Improved `Dispatcher` and `DispatcherThread` - Improved `PubSub` (type safety) - Created test for `DispatcherThread` and `PubSub` - Save properties files on app exit (various apps) by posting it to the main dispatcher (fixes UI hanging briefly on app exit) - Fixed bug with `SystemSettings` being read from the wrong file path. - `loadPropertiesFile()` now uses `file::readLines()` instead of doing that manually - Increased timer task stack size (required due to issues when reading a properties file for the very first time) - General cleanup - Created `EstimatedPower` driver that uses an ADC pin to measure voltage and estimate the battery charge that is left. - Cleanup of T-Deck board (updated to new style)
57 lines
1.4 KiB
C++
57 lines
1.4 KiB
C++
/**
|
|
* @file Dispatcher.h
|
|
*
|
|
* Dispatcher is a thread-safe code execution queue.
|
|
*/
|
|
#pragma once
|
|
|
|
#include "MessageQueue.h"
|
|
#include "Mutex.h"
|
|
#include "EventFlag.h"
|
|
|
|
#include <memory>
|
|
#include <queue>
|
|
|
|
namespace tt {
|
|
|
|
/**
|
|
* A thread-safe way to defer code execution.
|
|
* Generally, one task would dispatch the execution,
|
|
* while the other thread consumes and executes the work.
|
|
*/
|
|
class Dispatcher final {
|
|
|
|
public:
|
|
|
|
typedef std::function<void()> Function;
|
|
|
|
private:
|
|
|
|
Mutex mutex;
|
|
std::queue<Function> queue = {};
|
|
EventFlag eventFlag;
|
|
|
|
public:
|
|
|
|
explicit Dispatcher() = default;
|
|
~Dispatcher();
|
|
|
|
/**
|
|
* Queue a function to be consumed elsewhere.
|
|
* @param[in] function the function to execute elsewhere
|
|
* @param[in] timeout lock acquisition timeout
|
|
* @return true if dispatching was successful (timeout not reached)
|
|
*/
|
|
bool dispatch(Function function, TickType_t timeout = portMAX_DELAY);
|
|
|
|
/**
|
|
* Consume 1 or more dispatched function (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
|
|
* @return the amount of messages that were consumed
|
|
*/
|
|
uint32_t consume(TickType_t timeout = portMAX_DELAY);
|
|
};
|
|
|
|
} // namespace
|