efb09380bd
* updater: lowered logging level for resources unpacking; hal: implemented fast flash write mode * hal: reworked fast flash programming; clearing most error flags on flash init; changed some flash functions return type from bool to void; scripts: fixed malformed CRC values in update bundles in certain cases; * hal: flash: larger critical section * hal: flash: enabling fast write inside critical section * api_symbols: bump minor version
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
|