Zephyr Project API 3.7.0
A Scalable Open Source RTOS
Loading...
Searching...
No Matches
settings.h
Go to the documentation of this file.
1/*
2 * Copyright (c) 2018 Nordic Semiconductor ASA
3 * Copyright (c) 2015 Runtime Inc
4 *
5 * SPDX-License-Identifier: Apache-2.0
6 */
7
8#ifndef ZEPHYR_INCLUDE_SETTINGS_SETTINGS_H_
9#define ZEPHYR_INCLUDE_SETTINGS_SETTINGS_H_
10
11#include <sys/types.h>
12#include <zephyr/sys/util.h>
13#include <zephyr/sys/slist.h>
15#include <stdint.h>
16
17#ifdef __cplusplus
18extern "C" {
19#endif
20
21
37#define SETTINGS_MAX_DIR_DEPTH 8 /* max depth of settings tree */
38#define SETTINGS_MAX_NAME_LEN (8 * SETTINGS_MAX_DIR_DEPTH)
39#define SETTINGS_MAX_VAL_LEN 256
40#define SETTINGS_NAME_SEPARATOR '/'
41#define SETTINGS_NAME_END '='
42
43/* place for settings additions:
44 * up to 7 separators, '=', '\0'
45 */
46#define SETTINGS_EXTRA_LEN ((SETTINGS_MAX_DIR_DEPTH - 1) + 2)
47
61typedef ssize_t (*settings_read_cb)(void *cb_arg, void *data, size_t len);
62
69
70 const char *name;
73 int (*h_get)(const char *key, char *val, int val_len_max);
85 int (*h_set)(const char *key, size_t len, settings_read_cb read_cb,
86 void *cb_arg);
100 int (*h_commit)(void);
107 int (*h_export)(int (*export_func)(const char *name, const void *val,
108 size_t val_len));
127};
128
135
136 const char *name;
139 int (*h_get)(const char *key, char *val, int val_len_max);
151 int (*h_set)(const char *key, size_t len, settings_read_cb read_cb,
152 void *cb_arg);
166 int (*h_commit)(void);
171 int (*h_export)(int (*export_func)(const char *name, const void *val,
172 size_t val_len));
188};
189
204#define SETTINGS_STATIC_HANDLER_DEFINE(_hname, _tree, _get, _set, _commit, \
205 _export) \
206 const STRUCT_SECTION_ITERABLE(settings_handler_static, \
207 settings_handler_ ## _hname) = { \
208 .name = _tree, \
209 .h_get = _get, \
210 .h_set = _set, \
211 .h_commit = _commit, \
212 .h_export = _export, \
213 }
214
225
234
243
252int settings_load_subtree(const char *subtree);
253
270 const char *key,
271 size_t len,
272 settings_read_cb read_cb,
273 void *cb_arg,
274 void *param);
275
294 const char *subtree,
296 void *param);
297
305
314int settings_save_subtree(const char *subtree);
315
327int settings_save_one(const char *name, const void *value, size_t val_len);
328
339int settings_delete(const char *name);
340
348
357int settings_commit_subtree(const char *subtree);
358
370/*
371 * API for config storage
372 */
373
374struct settings_store_itf;
375
386
411
418 int (*csi_load)(struct settings_store *cs,
419 const struct settings_load_arg *arg);
433 int (*csi_save_start)(struct settings_store *cs);
440 int (*csi_save)(struct settings_store *cs, const char *name,
441 const char *value, size_t val_len);
451 int (*csi_save_end)(struct settings_store *cs);
463 void *(*csi_storage_get)(struct settings_store *cs);
464};
465
473
481
482
483/*
484 * API for handler lookup
485 */
486
496 const char **next);
497
512 size_t len,
513 settings_read_cb read_cb,
514 void *read_cb_arg,
515 const struct settings_load_arg *load_arg);
547int settings_name_steq(const char *name, const char *key, const char **next);
548
559int settings_name_next(const char *name, const char **next);
564#ifdef CONFIG_SETTINGS_RUNTIME
565
582int settings_runtime_set(const char *name, const void *data, size_t len);
583
593int settings_runtime_get(const char *name, void *data, size_t len);
594
607#endif /* CONFIG_SETTINGS_RUNTIME */
608
620int settings_storage_get(void **storage);
621
622#ifdef __cplusplus
623}
624#endif
625
626#endif /* ZEPHYR_INCLUDE_SETTINGS_SETTINGS_H_ */
void settings_dst_register(struct settings_store *cs)
Register a backend handler acting as destination.
struct settings_handler_static * settings_parse_and_lookup(const char *name, const char **next)
Parses a key to an array of elements and locate corresponding module handler.
void settings_src_register(struct settings_store *cs)
Register a backend handler acting as source.
int settings_call_set_handler(const char *name, size_t len, settings_read_cb read_cb, void *read_cb_arg, const struct settings_load_arg *load_arg)
Calls settings handler.
int settings_name_steq(const char *name, const char *key, const char **next)
Compares the start of name with a key.
int settings_name_next(const char *name, const char **next)
determine the number of characters before the first separator
int settings_runtime_get(const char *name, void *data, size_t len)
Get a value corresponding to a key from a module handler.
int settings_runtime_set(const char *name, const void *data, size_t len)
Set a value with a specific key to a module handler.
int settings_runtime_commit(const char *name)
Apply settings in a module handler.
int settings_delete(const char *name)
Delete a single serialized in persisted storage.
int settings_commit_subtree(const char *subtree)
Call commit for settings handler that belong to subtree.
int settings_load_subtree_direct(const char *subtree, settings_load_direct_cb cb, void *param)
Load limited set of serialized items using given callback.
ssize_t(* settings_read_cb)(void *cb_arg, void *data, size_t len)
Function used to read the data from the settings storage in h_set handler implementations.
Definition settings.h:61
int settings_commit(void)
Call commit for all settings handler.
int(* settings_load_direct_cb)(const char *key, size_t len, settings_read_cb read_cb, void *cb_arg, void *param)
Callback function used for direct loading.
Definition settings.h:269
int settings_save(void)
Save currently running serialized items.
int settings_load(void)
Load serialized items from registered persistence sources.
int settings_save_subtree(const char *subtree)
Save limited set of currently running serialized items.
int settings_register(struct settings_handler *cf)
Register a handler for settings items stored in RAM.
int settings_load_subtree(const char *subtree)
Load limited set of serialized items from registered persistence sources.
int settings_save_one(const char *name, const void *value, size_t val_len)
Write a single serialized value to persisted storage (if it has changed value).
int settings_subsys_init(void)
Initialization of settings and backend.
struct _snode sys_snode_t
Single-linked list node structure.
Definition slist.h:39
__SIZE_TYPE__ ssize_t
Definition types.h:28
int settings_storage_get(void **storage)
Get the storage instance used by zephyr.
static k_spinlock_key_t key
Definition spinlock_error_case.c:15
Config handlers without the node element, used for static handlers.
Definition settings.h:134
int(* h_commit)(void)
This handler gets called after settings has been loaded in full.
Definition settings.h:166
int(* h_set)(const char *key, size_t len, settings_read_cb read_cb, void *cb_arg)
Set value handler of settings items identified by keyword names.
Definition settings.h:151
const char * name
Name of subtree.
Definition settings.h:136
int(* h_export)(int(*export_func)(const char *name, const void *val, size_t val_len))
This gets called to dump all current settings items.
Definition settings.h:171
int(* h_get)(const char *key, char *val, int val_len_max)
Get values handler of settings items identified by keyword names.
Definition settings.h:139
Config handlers for subtree implement a set of handler functions.
Definition settings.h:68
int(* h_export)(int(*export_func)(const char *name, const void *val, size_t val_len))
This gets called to dump all current settings items.
Definition settings.h:107
sys_snode_t node
Linked list node info for module internal usage.
Definition settings.h:125
int(* h_set)(const char *key, size_t len, settings_read_cb read_cb, void *cb_arg)
Set value handler of settings items identified by keyword names.
Definition settings.h:85
int(* h_get)(const char *key, char *val, int val_len_max)
Get values handler of settings items identified by keyword names.
Definition settings.h:73
const char * name
Name of subtree.
Definition settings.h:70
int(* h_commit)(void)
This handler gets called after settings has been loaded in full.
Definition settings.h:100
Arguments for data loading.
Definition settings.h:391
const char * subtree
Name of the subtree to be loaded.
Definition settings.h:397
void * param
Parameter for callback function.
Definition settings.h:409
settings_load_direct_cb cb
Pointer to the callback function.
Definition settings.h:403
Backend handler functions.
Definition settings.h:417
int(* csi_load)(struct settings_store *cs, const struct settings_load_arg *arg)
Loads values from storage limited to subtree defined by subtree.
Definition settings.h:418
int(* csi_save_end)(struct settings_store *cs)
Handler called after an export operation.
Definition settings.h:451
int(* csi_save_start)(struct settings_store *cs)
Handler called before an export operation.
Definition settings.h:433
int(* csi_save)(struct settings_store *cs, const char *name, const char *value, size_t val_len)
Save a single key-value pair to storage.
Definition settings.h:440
Backend handler node for storage handling.
Definition settings.h:379
sys_snode_t cs_next
Linked list node info for internal usage.
Definition settings.h:380
const struct settings_store_itf * cs_itf
Backend handler structure.
Definition settings.h:383
static fdata_t data[2]
Definition test_fifo_contexts.c:15
Misc utilities.