123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703 |
- extern "C" {
- enum
- {
- FDS_ERR_OPERATION_TIMEOUT = NRF_ERROR_FDS_ERR_BASE,
- FDS_ERR_NOT_INITIALIZED,
- FDS_ERR_UNALIGNED_ADDR,
- FDS_ERR_INVALID_ARG,
- FDS_ERR_NULL_ARG,
- FDS_ERR_NO_OPEN_RECORDS,
- FDS_ERR_NO_SPACE_IN_FLASH,
- FDS_ERR_NO_SPACE_IN_QUEUES,
- FDS_ERR_RECORD_TOO_LARGE,
- FDS_ERR_NOT_FOUND,
- FDS_ERR_NO_PAGES,
- FDS_ERR_USER_LIMIT_REACHED,
- FDS_ERR_CRC_CHECK_FAILED,
- FDS_ERR_BUSY,
- FDS_ERR_INTERNAL,
- };
- typedef struct
- {
- uint16_t record_key;
- uint16_t length_words;
- uint16_t file_id;
- uint16_t crc16;
-
- uint32_t record_id;
- } fds_header_t;
- typedef struct
- {
- uint32_t record_id;
- uint32_t const * p_record;
- uint16_t gc_run_count;
- bool record_is_open;
- } fds_record_desc_t;
- typedef struct
- {
- fds_header_t const * p_header;
- void const * p_data;
- } fds_flash_record_t;
- typedef struct
- {
- uint16_t file_id;
- uint16_t key;
- struct
- {
- void const * p_data;
- uint32_t length_words;
- } data;
- } fds_record_t;
- typedef struct
- {
- uint16_t page;
- uint16_t length_words;
- } fds_reserve_token_t;
- typedef struct
- {
- uint32_t const * p_addr;
- uint16_t page;
- } fds_find_token_t;
- typedef enum
- {
- FDS_EVT_INIT,
- FDS_EVT_WRITE,
- FDS_EVT_UPDATE,
- FDS_EVT_DEL_RECORD,
- FDS_EVT_DEL_FILE,
- FDS_EVT_GC
- } fds_evt_id_t;
- ANON_UNIONS_ENABLE;
- typedef struct
- {
- fds_evt_id_t id;
- ret_code_t result;
- union
- {
- struct
- {
- uint32_t record_id;
- uint16_t file_id;
- uint16_t record_key;
- bool is_record_updated;
- } write;
- struct
- {
- uint32_t record_id;
- uint16_t file_id;
- uint16_t record_key;
- } del;
- };
- } fds_evt_t;
- ANON_UNIONS_DISABLE;
- typedef struct
- {
- uint16_t pages_available;
- uint16_t open_records;
- uint16_t valid_records;
- uint16_t dirty_records;
- uint16_t words_reserved;
-
- uint16_t words_used;
-
- uint16_t largest_contig;
-
- uint16_t freeable_words;
-
- bool corruption;
- } fds_stat_t;
- typedef void (*fds_cb_t)(fds_evt_t const * p_evt);
- ret_code_t fds_register(fds_cb_t cb);
- ret_code_t fds_init(void);
- ret_code_t fds_record_write(fds_record_desc_t * p_desc,
- fds_record_t const * p_record);
- ret_code_t fds_reserve(fds_reserve_token_t * p_token, uint16_t length_words);
- ret_code_t fds_reserve_cancel(fds_reserve_token_t * p_token);
- ret_code_t fds_record_write_reserved(fds_record_desc_t * p_desc,
- fds_record_t const * p_record,
- fds_reserve_token_t const * p_token);
- ret_code_t fds_record_delete(fds_record_desc_t * p_desc);
- ret_code_t fds_file_delete(uint16_t file_id);
- ret_code_t fds_record_update(fds_record_desc_t * p_desc,
- fds_record_t const * p_record);
- ret_code_t fds_record_iterate(fds_record_desc_t * p_desc,
- fds_find_token_t * p_token);
- ret_code_t fds_record_find(uint16_t file_id,
- uint16_t record_key,
- fds_record_desc_t * p_desc,
- fds_find_token_t * p_token);
- ret_code_t fds_record_find_by_key(uint16_t record_key,
- fds_record_desc_t * p_desc,
- fds_find_token_t * p_token);
- ret_code_t fds_record_find_in_file(uint16_t file_id,
- fds_record_desc_t * p_desc,
- fds_find_token_t * p_token);
- ret_code_t fds_record_open(fds_record_desc_t * p_desc,
- fds_flash_record_t * p_flash_record);
- ret_code_t fds_record_close(fds_record_desc_t * p_desc);
- ret_code_t fds_gc(void);
- ret_code_t fds_descriptor_from_rec_id(fds_record_desc_t * p_desc,
- uint32_t record_id);
- ret_code_t fds_record_id_from_desc(fds_record_desc_t const * p_desc,
- uint32_t * p_record_id);
- ret_code_t fds_stat(fds_stat_t * p_stat);
- }
|