2020-10-13 08:22:43 +00:00
|
|
|
#pragma once
|
|
|
|
|
2020-10-26 09:26:15 +00:00
|
|
|
#include "valuemutex.h"
|
|
|
|
#include "pubsub.h"
|
|
|
|
#include "event.h"
|
[FL-140] Core api dynamic records (#296)
* SYSTEM: tickless mode with deep sleep.
* Move FreeRTOS ticks to lptim2
* API: move all sumbodules init routines to one place. Timebase: working lptim2 at tick source.
* API Timebase: lp-timer routines, timer access safe zones prediction and synchronization. FreeRTOS: adjust configuration for tickless mode.
* NFC: support for tickless mode.
* API Timebase: improve tick error handling in IRQ. Apploader: use insomnia mode to run applications.
* BLE: prevent sleep while core2 starting
* HAL: nap while in insomnia mode
* init records work
* try to implement record delete
* tests and flapp
* flapp subsystem
* new core functions to get app stat, simplify core code
* fix thread termination
* add strdup to core
* fix tests
* Refactoring: remove all unusued parts, update API usage, aggreagate API sources and headers, new record storage
* Refactoring: update furi record api usage, cleanup code
* Fix broken merge for freertos apps
* Core, Target: fix compilation warnings
* Drop firmware target local
* HAL Timebase, Power, Clock: semaphore guarded access to clock and power modes, better sleep mode.
* SD-Filesystem: wait for all deps to arrive before adding widget. Core, BLE: disable debug dump to serial.
* delete old app example-ipc
* delete old app fatfs list
* fix strobe app, add input header
* delete old display driver
* comment old app qr-code
* fix sd-card test, add forced widget update
* remove unused new core test
* increase heap to 128k
* comment and assert old core tests
* fix syntax
Co-authored-by: Aleksandr Kutuzov <alleteam@gmail.com>
2021-01-20 16:09:26 +00:00
|
|
|
#include <m-list.h>
|
|
|
|
|
|
|
|
#ifdef __cplusplus
|
|
|
|
extern "C" {
|
|
|
|
#endif
|
2020-10-13 08:22:43 +00:00
|
|
|
|
|
|
|
/*
|
|
|
|
== Value composer ==
|
|
|
|
*/
|
|
|
|
|
2020-10-26 09:26:15 +00:00
|
|
|
typedef struct ValueComposer ValueComposer;
|
2020-10-13 08:22:43 +00:00
|
|
|
|
2020-10-26 09:26:15 +00:00
|
|
|
typedef void (*ValueComposerCallback)(void* ctx, void* state);
|
2020-10-13 08:22:43 +00:00
|
|
|
|
2020-10-26 09:26:15 +00:00
|
|
|
typedef enum { UiLayerBelowNotify, UiLayerNotify, UiLayerAboveNotify } UiLayer;
|
|
|
|
|
|
|
|
typedef struct {
|
|
|
|
ValueComposerCallback cb;
|
|
|
|
void* ctx;
|
|
|
|
UiLayer layer;
|
|
|
|
ValueComposer* composer;
|
|
|
|
} ValueComposerHandle;
|
|
|
|
|
|
|
|
LIST_DEF(list_composer_cb, ValueComposerHandle, M_POD_OPLIST);
|
|
|
|
|
|
|
|
struct ValueComposer {
|
|
|
|
ValueMutex value;
|
|
|
|
list_composer_cb_t layers[3];
|
|
|
|
osMutexId_t mutex;
|
|
|
|
Event request;
|
|
|
|
};
|
|
|
|
|
|
|
|
void COPY_COMPOSE(void* ctx, void* state);
|
|
|
|
|
|
|
|
bool init_composer(ValueComposer* composer, void* value);
|
|
|
|
|
|
|
|
/*
|
|
|
|
Free resources allocated by `init_composer`.
|
|
|
|
This function doesn't free the memory occupied by `ValueComposer` itself.
|
|
|
|
*/
|
|
|
|
bool delete_composer(ValueComposer* composer);
|
2020-10-13 08:22:43 +00:00
|
|
|
|
2020-10-15 16:50:21 +00:00
|
|
|
ValueComposerHandle*
|
2020-10-26 09:26:15 +00:00
|
|
|
add_compose_layer(ValueComposer* composer, ValueComposerCallback cb, void* ctx, UiLayer layer);
|
2020-10-13 08:22:43 +00:00
|
|
|
|
|
|
|
bool remove_compose_layer(ValueComposerHandle* handle);
|
|
|
|
|
|
|
|
void request_compose(ValueComposerHandle* handle);
|
|
|
|
|
2020-10-26 09:26:15 +00:00
|
|
|
/*
|
|
|
|
Perform composition if requested.
|
|
|
|
|
|
|
|
`start_cb` and `end_cb` will be called before and after all layer callbacks, respectively.
|
|
|
|
Both `start_cb` and `end_cb` can be NULL. They can be used to set initial state (e.g. clear screen)
|
|
|
|
and commit the final state.
|
|
|
|
*/
|
|
|
|
void perform_compose(
|
|
|
|
ValueComposer* composer,
|
|
|
|
ValueComposerCallback start_cb,
|
|
|
|
ValueComposerCallback end_cb,
|
|
|
|
void* ctx);
|
|
|
|
|
|
|
|
/*
|
|
|
|
Perform composition.
|
|
|
|
|
|
|
|
This function should be called with value mutex acquired.
|
|
|
|
This function is here for convenience, so that developers can write their own compose loops.
|
|
|
|
See `perform_compose` function body for an example.
|
|
|
|
*/
|
|
|
|
void perform_compose_internal(ValueComposer* composer, void* state);
|
|
|
|
|
2020-10-13 08:22:43 +00:00
|
|
|
// See [LED](LED-API) or [Display](Display-API) API for examples.
|
|
|
|
|
|
|
|
/*
|
|
|
|
== ValueManager ==
|
|
|
|
|
|
|
|
More complicated concept is ValueManager.
|
|
|
|
It is like ValueMutex, but user can subscribe to value updates.
|
|
|
|
|
|
|
|
First of all you can use value and pubsub part as showing above:
|
|
|
|
aquire/release mutex, read value, subscribe/unsubscribe pubsub.
|
|
|
|
There are two specific methods for ValueManager: write_managed, commit_managed
|
|
|
|
*/
|
|
|
|
|
|
|
|
typedef struct {
|
|
|
|
ValueMutex value;
|
|
|
|
PubSub pubsub;
|
|
|
|
} ValueManager;
|
|
|
|
|
2020-10-26 09:26:15 +00:00
|
|
|
bool init_managed(ValueManager* managed, void* value, size_t size);
|
|
|
|
|
|
|
|
/*
|
|
|
|
Free resources allocated by `init_managed`.
|
|
|
|
This function doesn't free the memory occupied by `ValueManager` itself.
|
|
|
|
*/
|
|
|
|
bool delete_managed(ValueManager* managed);
|
|
|
|
|
2020-10-13 08:22:43 +00:00
|
|
|
/*
|
|
|
|
acquire value, changes it and send notify with current value.
|
|
|
|
*/
|
|
|
|
bool write_managed(ValueManager* managed, void* data, size_t len, uint32_t timeout);
|
|
|
|
|
|
|
|
/*
|
|
|
|
commit_managed works as `release_mutex` but send notify with current value.
|
|
|
|
*/
|
|
|
|
bool commit_managed(ValueManager* managed, void* value);
|
[FL-140] Core api dynamic records (#296)
* SYSTEM: tickless mode with deep sleep.
* Move FreeRTOS ticks to lptim2
* API: move all sumbodules init routines to one place. Timebase: working lptim2 at tick source.
* API Timebase: lp-timer routines, timer access safe zones prediction and synchronization. FreeRTOS: adjust configuration for tickless mode.
* NFC: support for tickless mode.
* API Timebase: improve tick error handling in IRQ. Apploader: use insomnia mode to run applications.
* BLE: prevent sleep while core2 starting
* HAL: nap while in insomnia mode
* init records work
* try to implement record delete
* tests and flapp
* flapp subsystem
* new core functions to get app stat, simplify core code
* fix thread termination
* add strdup to core
* fix tests
* Refactoring: remove all unusued parts, update API usage, aggreagate API sources and headers, new record storage
* Refactoring: update furi record api usage, cleanup code
* Fix broken merge for freertos apps
* Core, Target: fix compilation warnings
* Drop firmware target local
* HAL Timebase, Power, Clock: semaphore guarded access to clock and power modes, better sleep mode.
* SD-Filesystem: wait for all deps to arrive before adding widget. Core, BLE: disable debug dump to serial.
* delete old app example-ipc
* delete old app fatfs list
* fix strobe app, add input header
* delete old display driver
* comment old app qr-code
* fix sd-card test, add forced widget update
* remove unused new core test
* increase heap to 128k
* comment and assert old core tests
* fix syntax
Co-authored-by: Aleksandr Kutuzov <alleteam@gmail.com>
2021-01-20 16:09:26 +00:00
|
|
|
|
|
|
|
#ifdef __cplusplus
|
|
|
|
}
|
|
|
|
#endif
|