/*********************************************************************************************************************
* MSPM0G3507 Opensource Library 即（MSPM0G3507 开源库）是一个基于官方 SDK 接口的第三方开源库
* Copyright (c) 2022 SEEKFREE 逐飞科技
* 
* 本文件是 MSPM0G3507 开源库的一部分
* 
* MSPM0G3507 开源库 是免费软件
* 您可以根据自由软件基金会发布的 GPL（GNU General Public License，即 GNU通用公共许可证）的条款
* 即 GPL 的第3版（即 GPL3.0）或（您选择的）任何后来的版本，重新发布和/或修改它
* 
* 本开源库的发布是希望它能发挥作用，但并未对其作任何的保证
* 甚至没有隐含的适销性或适合特定用途的保证
* 更多细节请参见 GPL
* 
* 您应该在收到本开源库的同时收到一份 GPL 的副本
* 如果没有，请参阅<https://www.gnu.org/licenses/>
* 
* 额外注明：
* 本开源库使用 GPL3.0 开源许可证协议 以上许可申明为译文版本
* 许可申明英文版在 libraries/doc 文件夹下的 GPL3_permission_statement.txt 文件中
* 许可证副本在 libraries 文件夹下 即该文件夹下的 LICENSE 文件
* 欢迎各位使用并传播本程序 但修改内容时必须保留逐飞科技的版权声明（即本声明）
* 
* 文件名称          zf_driver_flash
* 公司名称          成都逐飞科技有限公司
* 版本信息          查看 libraries/doc 文件夹内 version 文件 版本说明
* 开发环境          MDK 5.37
* 适用平台          MSPM0G3507
* 店铺链接          https://seekfree.taobao.com/
* 
* 修改记录
* 日期              作者                备注
* 2025-06-1        SeekFree            first version
********************************************************************************************************************/

#ifndef _zf_driver_flash_h_
#define _zf_driver_flash_h_


#include "zf_common_typedef.h"

// 以下宏定义为芯片固定设置 不允许用户修改
#define FLASH_BASE_ADDR             ( 0x00016000 )                              //0x00008000(前32k地址)  前32k可擦除10w次 后96k擦除1w次
#define FLASH_MAX_PAGE_INDEX        ( 2 )
#define FLASH_MAX_SECTION_INDEX     ( 6 )
#define FLASH_PAGE_SIZE             ( 0x00000400 )                              // 1K byte
#define FLASH_SECTION_SIZE          ( FLASH_PAGE_SIZE * FLASH_MAX_PAGE_INDEX )  // 2K byte
#define FLASH_OPERATION_TIME_OUT    ( 0x0FFF )

#define FLASH_DATA_BUFFER_SIZE      ( FLASH_PAGE_SIZE / sizeof(flash_data_union) )// 自动计算每个页能够存下多少个数据

typedef union                                                                   // 固定的数据缓冲单元格式
{
    float   float_type;                                                         // float  类型
    uint32  uint32_type;                                                        // uint32 类型
    int32   int32_type;                                                         // int32  类型
    uint16  uint16_type;                                                        // uint16 类型
    int16   int16_type;                                                         // int16  类型
    uint8   uint8_type;                                                         // uint8  类型
    int8    int8_type;                                                          // int8   类型
}flash_data_union;                                                              // 所有类型数据共用同一个 32bit 地址

extern flash_data_union flash_union_buffer[FLASH_DATA_BUFFER_SIZE];

uint8       flash_check                     (uint32 sector_num, uint32 page_num);
uint8       flash_erase_page                (uint32 sector_num, uint32 page_num);
void        flash_read_page                 (uint32 sector_num, uint32 page_num, uint32 *buf, uint16 len);
uint8       flash_write_page                (uint32 sector_num, uint32 page_num, const uint32 *buf, uint16 len);

void        flash_read_page_to_buffer       (uint32 sector_num, uint32 page_num);
uint8       flash_write_page_from_buffer    (uint32 sector_num, uint32 page_num);
void        flash_buffer_clear              (void);

#endif