7ce305fca3
* C2OTA: wip * Update Cube to 1.13.3 * Fixed prio * Functional Core2 updater * Removed hardware CRC usage; code cleanup & linter fixes * Moved hardcoded stack params to copro.mk * Fixing CI bundling of core2 fw * Removed last traces of hardcoded radio stack * OB processing draft * Python scripts cleanup * Support for comments in ob data * Sacrificed SD card icon in favor of faster update. Waiting for Storage fix * Additional handling for OB mismatched values * Description for new furi_hal apis; spelling fixes * Rework of OB write, WIP * Properly restarting OB verification loop * Split update_task_workers.c * Checking OBs after enabling post-update mode * Moved OB verification before flashing * Removed ob.data for custom stacks * Fixed progress calculation for OB * Removed unnecessary OB mask cast Co-authored-by: Aleksandr Kutuzov <alleteam@gmail.com>
145 lines
3.6 KiB
C
145 lines
3.6 KiB
C
#pragma once
|
|
|
|
#include <stdbool.h>
|
|
#include <stdint.h>
|
|
#include <stddef.h>
|
|
|
|
#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
|
|
*
|
|
* @return true on success
|
|
*/
|
|
bool 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
|
|
*
|
|
* @return true on success
|
|
*/
|
|
bool 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
|
|
*
|
|
* @return true on success
|
|
*/
|
|
bool 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();
|