917410a0a8
* fbt: reworking targets & assets handling WIP * fbt: dist fixes * fbt: moved SD card resources to owning apps * unit_tests: moved resources to app folder * github: updated unit_tests paths * github: packaging fixes * unit_tests: fixes * fbt: assets: internal cleanup * fbt: reworked assets handling * github: unit_tests: reintroducing fixes * minor cleanup * fbt: naming changes to reflect private nature of scons tools * fbt: resources: fixed dist archive paths * docs: updated paths * docs: updated more paths * docs: included "resources" parameter in app manifest docs; updated assets readme * updated gitignore for assets * github: updated action versions * unit_tests: restored timeout; scripts: assets: logging changes * gh: don't upload desktop animations for unit test run Co-authored-by: あく <alleteam@gmail.com>
147 lines
3.5 KiB
C
147 lines
3.5 KiB
C
#pragma once
|
|
|
|
#include <stdbool.h>
|
|
#include <stdint.h>
|
|
#include <stddef.h>
|
|
|
|
#ifdef __cplusplus
|
|
extern "C" {
|
|
#endif
|
|
|
|
#define FURI_HAL_FLASH_OB_RAW_SIZE_BYTES 0x80
|
|
#define FURI_HAL_FLASH_OB_SIZE_WORDS (FURI_HAL_FLASH_OB_RAW_SIZE_BYTES / sizeof(uint32_t))
|
|
#define FURI_HAL_FLASH_OB_TOTAL_VALUES (FURI_HAL_FLASH_OB_SIZE_WORDS / 2)
|
|
|
|
typedef union {
|
|
uint8_t bytes[FURI_HAL_FLASH_OB_RAW_SIZE_BYTES];
|
|
union {
|
|
struct {
|
|
uint32_t base;
|
|
uint32_t complementary_value;
|
|
} values;
|
|
uint64_t dword;
|
|
} obs[FURI_HAL_FLASH_OB_TOTAL_VALUES];
|
|
} FuriHalFlashRawOptionByteData;
|
|
|
|
_Static_assert(
|
|
sizeof(FuriHalFlashRawOptionByteData) == FURI_HAL_FLASH_OB_RAW_SIZE_BYTES,
|
|
"UpdateManifestOptionByteData size error");
|
|
|
|
/** Init flash, applying necessary workarounds
|
|
*/
|
|
void furi_hal_flash_init();
|
|
|
|
/** Get flash base address
|
|
*
|
|
* @return pointer to flash base
|
|
*/
|
|
size_t furi_hal_flash_get_base();
|
|
|
|
/** Get flash read block size
|
|
*
|
|
* @return size in bytes
|
|
*/
|
|
size_t furi_hal_flash_get_read_block_size();
|
|
|
|
/** Get flash write block size
|
|
*
|
|
* @return size in bytes
|
|
*/
|
|
size_t furi_hal_flash_get_write_block_size();
|
|
|
|
/** Get flash page size
|
|
*
|
|
* @return size in bytes
|
|
*/
|
|
size_t furi_hal_flash_get_page_size();
|
|
|
|
/** Get expected flash cycles count
|
|
*
|
|
* @return count of erase-write operations
|
|
*/
|
|
size_t furi_hal_flash_get_cycles_count();
|
|
|
|
/** Get free flash start address
|
|
*
|
|
* @return pointer to free region start
|
|
*/
|
|
const void* furi_hal_flash_get_free_start_address();
|
|
|
|
/** Get free flash end address
|
|
*
|
|
* @return pointer to free region end
|
|
*/
|
|
const void* furi_hal_flash_get_free_end_address();
|
|
|
|
/** Get first free page start address
|
|
*
|
|
* @return first free page memory address
|
|
*/
|
|
size_t furi_hal_flash_get_free_page_start_address();
|
|
|
|
/** Get free page count
|
|
*
|
|
* @return free page count
|
|
*/
|
|
size_t furi_hal_flash_get_free_page_count();
|
|
|
|
/** Erase Flash
|
|
*
|
|
* @warning locking operation with critical section, stalls execution
|
|
*
|
|
* @param page The page to erase
|
|
*/
|
|
void furi_hal_flash_erase(uint8_t page);
|
|
|
|
/** Write double word (64 bits)
|
|
*
|
|
* @warning locking operation with critical section, stalls execution
|
|
*
|
|
* @param address destination address, must be double word aligned.
|
|
* @param data data to write
|
|
*/
|
|
void furi_hal_flash_write_dword(size_t address, uint64_t data);
|
|
|
|
/** Write aligned page data (up to page size)
|
|
*
|
|
* @warning locking operation with critical section, stalls execution
|
|
*
|
|
* @param address destination address, must be page aligned.
|
|
* @param data data to write
|
|
* @param length data length
|
|
*/
|
|
void furi_hal_flash_program_page(const uint8_t page, const uint8_t* data, uint16_t length);
|
|
|
|
/** Get flash page number for address
|
|
*
|
|
* @return page number, -1 for invalid address
|
|
*/
|
|
int16_t furi_hal_flash_get_page_number(size_t address);
|
|
|
|
/** Writes OB word, using non-compl. index of register in Flash, OPTION_BYTE_BASE
|
|
*
|
|
* @warning locking operation with critical section, stalls execution
|
|
*
|
|
* @param word_idx OB word number
|
|
* @param value data to write
|
|
* @return true if value was written, false for read-only word
|
|
*/
|
|
bool furi_hal_flash_ob_set_word(size_t word_idx, const uint32_t value);
|
|
|
|
/** Forces a reload of OB data from flash to registers
|
|
*
|
|
* @warning Initializes system restart
|
|
*
|
|
*/
|
|
void furi_hal_flash_ob_apply();
|
|
|
|
/** Get raw OB storage data
|
|
*
|
|
* @return pointer to read-only data of OB (raw + complementary values)
|
|
*/
|
|
const FuriHalFlashRawOptionByteData* furi_hal_flash_ob_get_raw_ptr();
|
|
|
|
#ifdef __cplusplus
|
|
}
|
|
#endif
|