/****************************************Copyright (c)****************************************************
**                         ZhangZhou KENENG electronics Co.,LTD.                               
**                                     
**
**
**--------------File Info---------------------------------------------------------------------------------
** File name:			flash.h
** Last modified Date:  2009-03-12
** Last Version:		1.0
** Descriptions:		提供操作片外NOR FLASH的接口，當前主要用到初始化函數
			同時提供其他操作，以備將來BOOTLOADER功能擴展需要。
**			(從bootloader中移植到uc/os-II環境，考慮到nor flash的時序問題，
**			添加了關鍵操作的開關中斷處理，確保flash操作的正確，
**			同時，還考慮了代碼的兼容性問題)			
**
**--------------------------------------------------------------------------------------------------------
** Created by:			heshusheng
** Created date:		2009-03-12
** Version:				1.0
** Descriptions:		The original version
**
**--------------------------------------------------------------------------------------------------------
** Modified by:
** Modified date:
** Version:
** Descriptions:
**
*********************************************************************************************************/
#ifndef _FLASH_H_
#define _FLASH_H_

typedef struct
{
	uint32 base_addr;//flash的起始地址
	uint32 size;//flash的長度
	uint32 sector_size;//扇區的長度
	uint32 block_size;//塊的長度
}flash_info_type;

/*********************************************************************************************************
* 名    稱：flash_init()
* 功    能：提供接口供給外部調用，NORFLASH 初始化函數
* 入口參數：無
* 出口參數：無
**********************************************************************************************************/
void flash_init( void );

/*********************************************************************************************************
* 名    稱：flash_erase_sector
* 功    能：擦除指定的扇區 4Kbyte
* 入口參數：Addr		編程地址
*           no		扇區數目
* 出口參數：返回TRUE表示操作成功，返回FALSE表示操作失敗
**********************************************************************************************************/
int flash_erase_sector(long addr, int no);

/*********************************************************************************************************
* 名    稱：flash_erase_sector
* 功    能：擦除指定的塊64Kbyte
* 入口參數：Addr		編程地址
*           no		塊數目
* 出口參數：返回TRUE表示操作成功，返回FALSE表示操作失敗
**********************************************************************************************************/
int flash_erase_block(long addr, int no);

/*********************************************************************************************************
* 名    稱：flash_write()
* 功    能：提供接口供給外部調用，按字節進行編程。
* 入口參數：src		寫入的數據緩存
*		 addr : 寫入的地址，使用0x81******開頭的地址		
*           cnt	:寫入的數據長度
* 出口參數：返回TRUE表示操作成功，返回FALSE表示操作失敗
**********************************************************************************************************/
int flash_write(char *src,long addr,long cnt);

#endif /*_FLASH_H_*/