/**  @file
  ql_boot_spi_nor_flash.h

  @brief
  This file is used to define boot spi4 nor flash api for different Quectel Project.

*/

/*================================================================
  Copyright (c) 2020 Quectel Wireless Solution, Co., Ltd.  All Rights Reserved.
  Quectel Wireless Solution Proprietary and Confidential.
=================================================================*/
/*=================================================================

                        EDIT HISTORY FOR MODULE

This section contains comments describing changes made to the module.
Notice that changes are listed in reverse chronological order.

WHEN              WHO         WHAT, WHERE, WHY
------------     -------     -------------------------------------------------------------------------------
=================================================================*/


#ifndef QL_BOOT_SPI4_NOR_FLASH_H
#define QL_BOOT_SPI4_NOR_FLASH_H
#include "quec_boot_spi.h"

#ifdef __cplusplus
extern "C" {
#endif


/*========================================================================
 *  Variable Definition
 *========================================================================*/
/****************************  error code about ql boot spi nor flash ***************************/
typedef ql_boot_spi_flash_config_s ql_boot_spi_nor_config_s ;

/*========================================================================
 *  function Definition
 *========================================================================*/
 
/*****************************************************************
* Function: ql_boot_spi_nor_init
*
* Description:
*   初始化NOR FLASH
* 
* Parameters:
*   port     [in]  SPI总线选择
*   spiclk   [in]  SPI时钟选择
*
* Return:ql_boot_errcode_spi_e
*
*****************************************************************/
ql_boot_errcode_spi_e ql_boot_spi_nor_init(ql_boot_spi_port_e port, ql_boot_spi_clk_e spiclk);

/*****************************************************************
* Function: ql_boot_spi_nor_init_ext
*
* Description:
*   扩展初始化NOR FLASH，与ql_boot_spi_nor_init有更多的设置选项
* 
* Parameters:
*   nor_config   [in]  SPI配置参数
*
* Return:ql_boot_errcode_spi_e
*
*****************************************************************/
ql_boot_errcode_spi_e ql_boot_spi_nor_init_ext(ql_boot_spi_nor_config_s nor_config);

/*****************************************************************
* Function: ql_boot_spi_nor_write_8bit_status
*
* Description:
*   写8bit的状态寄存器
* 
* Parameters:
*   port     [in]  SPI总线选择
*   status   [in]  设置状态寄存器的值
*
* Return:ql_boot_errcode_spi_e
*
*****************************************************************/
ql_boot_errcode_spi_e ql_boot_spi_nor_write_8bit_status(ql_boot_spi_port_e port, unsigned char status);

/*****************************************************************
* Function: ql_boot_spi_nor_write_16bit_status
*
* Description:
*   写16bit的状态寄存器
* 
* Parameters:
*   port     [in]  SPI总线选择
*   status   [in]  设置状态寄存器的值
*
* Return:ql_boot_errcode_spi_e
*
*****************************************************************/
ql_boot_errcode_spi_e ql_boot_spi_nor_write_16bit_status(ql_boot_spi_port_e port, unsigned short status);

/*****************************************************************
* Function: ql_boot_spi_nor_read_status_low
*
* Description:
*   读状态寄存器的低8bit
* 
* Parameters:
*   port     [in]  SPI总线选择
*   status   [out]  读取状态寄存器的值
*
* Return:ql_boot_errcode_spi_e
*
*****************************************************************/
ql_boot_errcode_spi_e ql_boot_spi_nor_read_status_low(ql_boot_spi_port_e port, unsigned char *status);

/*****************************************************************
* Function: ql_boot_spi_nor_read_status_high
*
* Description:
*   读状态寄存器的高8bit
* 
* Parameters:
*   port     [in]   SPI总线选择
*   status   [out]  读取状态寄存器的值
*
* Return:ql_boot_errcode_spi_e
*
*****************************************************************/
ql_boot_errcode_spi_e ql_boot_spi_nor_read_status_high(ql_boot_spi_port_e port, unsigned char *status);

/*****************************************************************
* Function: ql_boot_spi_nor_read
*
* Description:
*   从NOR FLASH芯片读数据
* 
* Parameters:
*   port     [in]   SPI总线选择
*   data     [out]  读取数据的缓存
*   addr     [in]   读取数据地址
*   len      [in]   读取数据长度
*
* Return:ql_boot_errcode_spi_e
*
*****************************************************************/
ql_boot_errcode_spi_e ql_boot_spi_nor_read(ql_boot_spi_port_e port, unsigned char* data, unsigned int addr, unsigned short len);

/*****************************************************************
* Function: ql_boot_spi_nor_write
*
* Description:
*   写数据到NOR FLASH芯片
* 
* Parameters:
*   port     [in]   SPI总线选择
*   data     [in]   写入数据的缓存
*   addr     [in]   写入数据地址
*   len      [in]   写入数据长度
*
* Return:ql_boot_errcode_spi_e
*
*****************************************************************/
ql_boot_errcode_spi_e ql_boot_spi_nor_write(ql_boot_spi_port_e port, unsigned char *data, unsigned int addr, unsigned short len);

/*****************************************************************
* Function: ql_boot_spi_nor_erase_chip
*
* Description:
*   擦除整个NOR FLASH芯片的数据
* 
* Parameters:
*   port     [in]   SPI总线选择
*
* Return:ql_boot_errcode_spi_e
*
*****************************************************************/
ql_boot_errcode_spi_e ql_boot_spi_nor_erase_chip(ql_boot_spi_port_e port);

/*****************************************************************
* Function: ql_boot_spi_nor_erase_sector
*
* Description:
*   擦除NOR FLASH数据，4K大小
* 
* Parameters:
*   port     [in]   SPI总线选择
*   addr     [in]   擦除数据地址
*
* Return:ql_boot_errcode_spi_e
*
*****************************************************************/
ql_boot_errcode_spi_e ql_boot_spi_nor_erase_sector(ql_boot_spi_port_e port, unsigned int addr);

/*****************************************************************
* Function: ql_boot_spi_nor_erase_64k_block
*
* Description:
*   擦除NOR FLASH数据，64K大小
* 
* Parameters:
*   port     [in]   SPI总线选择
*   addr     [in]   擦除数据地址
*
* Return:ql_boot_errcode_spi_e
*
*****************************************************************/
ql_boot_errcode_spi_e ql_boot_spi_nor_erase_64k_block(ql_boot_spi_port_e port, unsigned int addr);

#ifdef __cplusplus
} /*"C" */
#endif

#endif /* QL_API_SPI_NOR_FLASH_H */