107 lines
3.6 KiB
C
107 lines
3.6 KiB
C
#ifndef FS_H
|
|
#define FS_H
|
|
|
|
#include <zephyr/fs/fs.h>
|
|
|
|
typedef struct slot_info_t {
|
|
size_t start_addr;
|
|
size_t size;
|
|
} slot_info_t;
|
|
|
|
/**
|
|
* @brief Initializes the filesystem by mounting it
|
|
*/
|
|
int fs_init(void);
|
|
|
|
/**
|
|
* @brief Puts the QSPI flash into deep sleep mode to save power
|
|
*/
|
|
int fs_pm_flash_suspend(void);
|
|
|
|
/**
|
|
* @brief Resumes the QSPI flash from deep sleep mode
|
|
*/
|
|
int fs_pm_flash_resume(void);
|
|
|
|
/**
|
|
* @brief Wrapper around fs_open that handles power management for the flash
|
|
* Resumes the flash before opening and suspends it if opening fails
|
|
* @param file Pointer to fs_file_t structure to be initialized
|
|
* @param path Path to the file to open
|
|
* @param mode Open flags (e.g. FS_O_READ, FS_O_WRITE)
|
|
* @return 0 on success, negative error code on failure
|
|
*/
|
|
int fs_pm_open(struct fs_file_t *file, const char *path, fs_mode_t mode);
|
|
|
|
/**
|
|
* @brief Wrapper around fs_close that handles power management for the flash
|
|
* Resumes the flash after closing and suspends it if closing fails
|
|
* @param file Pointer to fs_file_t structure to be closed
|
|
* @return 0 on success, negative error code on failure
|
|
*/
|
|
int fs_pm_close(struct fs_file_t *file);
|
|
|
|
/**
|
|
* @brief Wrapper around fs_opendir that handles power management for the flash
|
|
* Resumes the flash before opening and suspends it if opening fails
|
|
* @param dirp Pointer to fs_dir_t structure to be initialized
|
|
* @param path Path to the directory to open
|
|
* @return 0 on success, negative error code on failure
|
|
*/
|
|
int fs_pm_opendir(struct fs_dir_t *dirp, const char *path);
|
|
|
|
/**
|
|
* @brief Wrapper around fs_closedir that handles power management for the flash
|
|
* Resumes the flash after closing and suspends it if closing fails
|
|
* @param dirp Pointer to fs_dir_t structure to be closed
|
|
* @return 0 on success, negative error code on failure
|
|
*/
|
|
int fs_pm_closedir(struct fs_dir_t *dirp);
|
|
|
|
/**
|
|
* @brief Unlinks (deletes) a file, ensuring the flash is active during the operation
|
|
* @param path Path to the file to unlink
|
|
* @return 0 on success, negative error code on failure
|
|
*/
|
|
int fs_pm_unlink(const char *path);
|
|
|
|
/**
|
|
* @brief Wrapper around fs_statvfs that handles power management for the flash
|
|
* Resumes the flash before getting stats and suspends it afterwards
|
|
* @param path Path to the filesystem to get stats for
|
|
* @param stat Pointer to fs_statvfs structure to be filled with stats
|
|
* @return 0 on success, negative error code on failure
|
|
*/
|
|
int fs_pm_statvfs(const char *path, struct fs_statvfs *stat);
|
|
|
|
/**
|
|
* @brief Wrapper around fs_mkdir that handles power management for the flash
|
|
* Resumes the flash before creating the directory and suspends it afterwards
|
|
* @param path Path to the directory to create
|
|
* @return 0 on success, negative error code on failure
|
|
*/
|
|
int fs_pm_mkdir(const char *path);
|
|
|
|
/**
|
|
* @brief Retrieves information about the firmware slot, such as start address and size
|
|
* @param info Pointer to slot_info_t structure to be filled with slot information
|
|
* @return 0 on success, negative error code on failure
|
|
*/
|
|
int flash_get_slot_info(slot_info_t *info);
|
|
|
|
/**
|
|
* @brief Initializes the flash for firmware upload, preparing it for receiving new firmware data
|
|
* @return 0 on success, negative error code on failure
|
|
*/
|
|
int flash_init_firmware_upload(void);
|
|
|
|
/**
|
|
* @brief Writes a block of firmware data to the flash
|
|
* @param buffer Pointer to the data buffer
|
|
* @param length Length of the data buffer
|
|
* @param is_last_block Indicates if this is the last block of the firmware
|
|
* @return 0 on success, negative error code on failure
|
|
*/
|
|
int flash_write_firmware_block(const uint8_t *buffer, size_t length, bool is_last_block);
|
|
|
|
#endif // FS_H
|