157 lines
5.4 KiB
C
157 lines
5.4 KiB
C
/**
|
||
* @file app_fatfs.h
|
||
* @brief FATFS 文件系统兼容头文件（整合自 CCU601E_D）
|
||
*
|
||
* CCU621_M 平台：FATFS 功能由 flash_file_mgr + externalflash + sdmmc 共同实现。
|
||
* 本头文件为从 CCU601E_D 移植的应用层代码提供兼容的类型和 API 声明。
|
||
*/
|
||
|
||
#ifndef APP_FATFS_H
|
||
#define APP_FATFS_H
|
||
|
||
#include <stdint.h>
|
||
#include <stdbool.h>
|
||
#include "publicdata/type.h"
|
||
#include "publicdata/public_define.h"
|
||
|
||
#define FS_PATH_LEN 64
|
||
#define FS_FILE_NAME_LEN 32
|
||
#define FS_READ_BUF_SIZE 512
|
||
|
||
#define LOG_DIR_PATH "0:/log"
|
||
#define LOG_FILE_MAX_SIZE (2*1024*1024)
|
||
#define LOG_FILE_MAX_COUNT 3
|
||
#define LOG_MAX_FILES 20
|
||
|
||
#if FATFS_ENABLE_FAULT
|
||
#define FAULT_DIR_PATH "0:/fault"
|
||
#define FAULT_FILE_MAX_SIZE (1024*500)
|
||
#define FAULT_FILE_MAX_COUNT 2
|
||
#define FAULT_MAX_FILES 20
|
||
#endif
|
||
|
||
#if FATFS_ENABLE_ORDER
|
||
#define ORDER_DIR_PATH "0:/order"
|
||
#define ORDER_FILE_MAX_SIZE (1024*500)
|
||
#define ORDER_FILE_MAX_COUNT 2
|
||
#define ORDER_MAX_FILES 20
|
||
#endif
|
||
|
||
#define LOG_SYNC_INTERVAL 10
|
||
|
||
typedef enum {
|
||
FS_STATUS_OK = 0,
|
||
FS_STATUS_INIT_FAILED,
|
||
FS_STATUS_FS_ERROR,
|
||
FS_STATUS_FILE_FULL,
|
||
FS_STATUS_WRITE_FAILED,
|
||
FS_STATUS_READ_FAILED,
|
||
FS_STATUS_FILE_NOT_FOUND,
|
||
FS_STATUS_PARAM_ERROR,
|
||
FS_STATUS_NO_SPACE
|
||
} FS_Status;
|
||
|
||
typedef struct {
|
||
char name[FS_FILE_NAME_LEN];
|
||
uint32_t size;
|
||
uint16_t year;
|
||
uint8_t month;
|
||
uint8_t day;
|
||
uint8_t hour;
|
||
uint8_t minute;
|
||
uint8_t second;
|
||
} FS_FileInfo;
|
||
|
||
typedef struct {
|
||
uint32_t start_pos;
|
||
uint32_t end_pos;
|
||
uint32_t actual_read;
|
||
} FS_ReadRange;
|
||
|
||
typedef enum {
|
||
FILE_TYPE_LOG = 0,
|
||
FILE_TYPE_FAULT,
|
||
FILE_TYPE_ORDER,
|
||
FILE_TYPE_MAX
|
||
} FileType;
|
||
|
||
typedef struct {
|
||
FileType type;
|
||
const char *dir_path;
|
||
const char *file_prefix;
|
||
const char *file_extension;
|
||
uint32_t max_file_size;
|
||
uint32_t max_file_count;
|
||
} FileManagerConfig;
|
||
|
||
/* 文件系统基础操作 */
|
||
FS_Status fs_init(void);
|
||
FS_Status fs_deinit(void);
|
||
FS_Status fs_mount(const char *path);
|
||
FS_Status fs_unmount(const char *path);
|
||
FS_Status fs_check_space(void);
|
||
bool fs_get_is_mounted(void);
|
||
|
||
/* 文件系统格式化 */
|
||
FS_Status fs_format_drive(const char *drive_path);
|
||
FS_Status fs_format_drive_fat16(const char *drive_path);
|
||
|
||
/* 目录操作 */
|
||
FS_Status fs_mkdir(const char *path);
|
||
FS_Status fs_dir_exists(const char *path, bool *exists);
|
||
FS_Status fs_list_dir(const char *path, FS_FileInfo *file_list, uint32_t *count, uint32_t max_count);
|
||
|
||
/* 文件操作 */
|
||
FS_Status fs_create_file(const char *path);
|
||
FS_Status fs_delete_file(const char *path);
|
||
FS_Status fs_file_exists(const char *path, bool *exists);
|
||
FS_Status fs_get_file_size(const char *path, uint32_t *size);
|
||
FS_Status fs_get_file_info(const char *path, FS_FileInfo *info);
|
||
FS_Status fs_rename_file(const char *old_path, const char *new_path);
|
||
FS_Status fs_copy_file(const char *src_path, const char *dst_path);
|
||
|
||
/* 文件读写（FatFs FIL 类型用 void* 代理，避免引入 ff.h） */
|
||
FS_Status fs_open(void *file, const char *path, uint8_t mode);
|
||
FS_Status fs_close(void *file);
|
||
FS_Status fs_read(void *file, void *buffer, uint32_t size, uint32_t *bytes_read);
|
||
FS_Status fs_write(void *file, const void *buffer, uint32_t size, uint32_t *bytes_written);
|
||
FS_Status fs_seek(void *file, uint32_t offset);
|
||
FS_Status fs_truncate(void *file);
|
||
FS_Status fs_sync(void *file);
|
||
|
||
/* 文件内容操作 */
|
||
FS_Status fs_read_file_content(const char *path, char *buffer, uint32_t buffer_size, FS_ReadRange *range);
|
||
FS_Status fs_write_file_content(const char *path, const void *data, uint32_t size, bool append);
|
||
FS_Status fs_write_string(const char *path, const char *str, bool append);
|
||
|
||
/* 文件系统信息 */
|
||
FS_Status fs_get_volume_info(const char *path, uint32_t *total_kb, uint32_t *free_kb, float *usage_percent);
|
||
|
||
/* 通用文件管理 */
|
||
FS_Status fs_file_manager_check_and_roll_ex(const FileManagerConfig *config, const char *current_file,
|
||
uint32_t pending_write_size, char *new_filename, uint32_t new_filename_len);
|
||
FS_Status fs_file_manager_create_new(const FileManagerConfig *config, char *new_filename, uint32_t max_len);
|
||
FS_Status fs_file_manager_ensure_dir_exists(const FileManagerConfig *config);
|
||
FS_Status fs_file_manager_get_count(const FileManagerConfig *config, uint32_t *count);
|
||
FS_Status fs_file_manager_delete_oldest(const FileManagerConfig *config);
|
||
FS_Status fs_file_manager_find_latest(const FileManagerConfig *config, char *filename, uint32_t max_len);
|
||
FS_Status fs_file_manager_find_oldest(const FileManagerConfig *config, char *filename, uint32_t max_len);
|
||
FS_Status fs_file_manager_resolve_log_append_path(const FileManagerConfig *config, char *filename, uint32_t max_len);
|
||
void fs_log_set_filename_start_seq(uint8_t start_seq);
|
||
FS_Status fs_generate_timestamp_filename(const FileManagerConfig *config, char *filename, uint32_t max_len);
|
||
bool fs_is_filename_valid(const char *filename, const FileManagerConfig *config);
|
||
FS_Status fs_cleanup_invalid_files(const FileManagerConfig *config);
|
||
uint32_t fs_get_current_fat_time(void);
|
||
FS_Status fs_get_current_time_string(char *buffer, uint32_t size);
|
||
FS_Status fs_get_formatted_time_string(char *buffer, uint32_t size);
|
||
|
||
extern const FileManagerConfig g_log_file_config;
|
||
#if FATFS_ENABLE_FAULT
|
||
extern const FileManagerConfig g_fault_file_config;
|
||
#endif
|
||
#if FATFS_ENABLE_ORDER
|
||
extern const FileManagerConfig g_order_file_config;
|
||
#endif
|
||
|
||
#endif /* APP_FATFS_H */
|