/*****************************************************************************
|
* @file PathStorage.h
|
* @brief 路径文件存储模块 - 负责从HTTP下载路径文件并存储到FLASH
|
* @author AI Assistant
|
* @date 2025-12-19
|
*****************************************************************************/
|
|
#ifndef __PATH_STORAGE_H__
|
#define __PATH_STORAGE_H__
|
|
#include "HIDO_TypeDef.h"
|
|
#ifdef __cplusplus
|
extern "C" {
|
#endif
|
|
/*****************************************************************************
|
* 宏定义
|
*****************************************************************************/
|
// FLASH存储地址定义（Bank1 Sector4起始）
|
#define PATH_STORAGE_BASE_ADDR 0x08080000U // 起始地址
|
#define PATH_STORAGE_MAX_SIZE (512 * 1024) // 最大512KB
|
|
// 路径文件头魔数（小端存储：文件字节序0x55 0xAA，读为uint16_t得0xAA55）
|
#define PATH_FILE_SOF 0xAA55 // 帧头标识（小端）
|
#define PATH_FILE_TYPE 0x3C // 类型标识
|
#define PATH_FILE_VERSION 0x10 // 版本号
|
|
/*****************************************************************************
|
* 数据结构定义
|
*****************************************************************************/
|
#pragma pack(push, 1) // 确保编译器不自行插入任何对齐字节
|
|
/**
|
* @brief 割草机路径文件头结构（按照协议文档定义）
|
*/
|
typedef struct {
|
// 基础信息 (Offset 0-11)
|
HIDO_UINT16 sof; // 帧头 0x55AA
|
HIDO_UINT8 type; // 类型 0x3C
|
HIDO_UINT8 version; // 版本 0x10
|
HIDO_UINT32 path_id; // 路径ID
|
HIDO_UINT32 timestamp; // 时间戳
|
|
// 保留与高精度数据 (Offset 12-35)
|
HIDO_UINT32 reserved; // 4字节保留位
|
HIDO_DOUBLE origin_lon; // 原点经度 (8字节，16字节偏移对齐)
|
HIDO_DOUBLE origin_lat; // 原点纬度 (8字节)
|
HIDO_FLOAT origin_alt; // 原点高度 (4字节)
|
|
// 数量信息 (Offset 36-39)
|
HIDO_UINT16 boundary_count; // 外边框点数
|
HIDO_UINT16 path_count; // 路径点数
|
|
// 之后紧跟坐标数据：boundary_count个边界点 + path_count个路径点
|
// 每个点：float x, float y（8字节）
|
} MowerPathHeader_t;
|
|
#pragma pack(pop)
|
|
/**
|
* @brief 路径点坐标结构
|
*/
|
typedef struct {
|
HIDO_FLOAT x; // X坐标，单位：米
|
HIDO_FLOAT y; // Y坐标，单位：米
|
} PathPoint_t;
|
|
/**
|
* @brief 路径存储状态
|
*/
|
typedef enum {
|
PATH_STORAGE_STATUS_IDLE = 0, // 空闲
|
PATH_STORAGE_STATUS_DOWNLOADING, // 下载中
|
PATH_STORAGE_STATUS_WRITING, // 写入中
|
PATH_STORAGE_STATUS_SUCCESS, // 成功
|
PATH_STORAGE_STATUS_FAIL_NETWORK, // 网络失败
|
PATH_STORAGE_STATUS_FAIL_FLASH, // FLASH写入失败
|
PATH_STORAGE_STATUS_FAIL_CRC, // CRC校验失败
|
PATH_STORAGE_STATUS_FAIL_FORMAT // 格式错误
|
} E_PathStorageStatus;
|
|
/*****************************************************************************
|
* 函数声明
|
*****************************************************************************/
|
|
/**
|
* @brief 初始化路径存储模块
|
* @return 0=成功, <0=失败
|
*/
|
HIDO_INT32 PathStorage_Init(void);
|
|
/**
|
* @brief 从HTTP下载路径文件并存储到FLASH
|
* @param url HTTP下载URL
|
* @return 0=成功启动下载, <0=失败
|
*/
|
HIDO_INT32 PathStorage_DownloadFromHTTP(const HIDO_CHAR *url);
|
|
/**
|
* @brief 从FLASH读取路径文件头
|
* @param header 输出路径文件头结构
|
* @return 0=成功, <0=失败
|
*/
|
HIDO_INT32 PathStorage_ReadHeader(MowerPathHeader_t *header);
|
|
/**
|
* @brief 从FLASH读取指定的路径点数据
|
* @param is_boundary 是否读取边界点（否则读取路径点）
|
* @param index 点索引（从0开始）
|
* @param point 输出点坐标
|
* @return 0=成功, <0=失败
|
*/
|
HIDO_INT32 PathStorage_ReadPoint(HIDO_BOOL is_boundary, HIDO_UINT32 index, PathPoint_t *point);
|
|
/**
|
* @brief 批量读取路径点数据
|
* @param is_boundary 是否读取边界点（否则读取路径点）
|
* @param start_index 起始索引
|
* @param count 读取数量
|
* @param points 输出点数组
|
* @return 实际读取的点数, <0=失败
|
*/
|
HIDO_INT32 PathStorage_ReadPoints(HIDO_BOOL is_boundary, HIDO_UINT32 start_index,
|
HIDO_UINT32 count, PathPoint_t *points);
|
|
/**
|
* @brief 获取当前存储状态
|
* @return 路径存储状态
|
*/
|
E_PathStorageStatus PathStorage_GetStatus(void);
|
|
/**
|
* @brief 获取下载进度（0-100）
|
* @return 下载进度百分比
|
*/
|
HIDO_UINT8 PathStorage_GetProgress(void);
|
|
/**
|
* @brief 擦除FLASH中的路径数据
|
* @return 0=成功, <0=失败
|
*/
|
HIDO_INT32 PathStorage_Erase(void);
|
|
/**
|
* @brief 验证FLASH中路径文件的CRC32
|
* @return 0=校验通过, <0=校验失败
|
*/
|
HIDO_INT32 PathStorage_VerifyCRC32(void);
|
|
#ifdef __cplusplus
|
}
|
#endif
|
|
#endif /* __PATH_STORAGE_H__ */
|
