376 lines
15 KiB
C
376 lines
15 KiB
C
/*!
|
|
*******************************************************************************
|
|
**
|
|
** \file gd_sflash.h
|
|
**
|
|
** \brief Serail Flash memory driver.
|
|
**
|
|
** (C) Goke Microelectronics China 2002 - 2007
|
|
**
|
|
** \attention THIS SAMPLE CODE IS PROVIDED AS IS. GOKE MICROELECTRONICS
|
|
** ACCEPTS NO RESPONSIBILITY OR LIABILITY FOR ANY ERRORS OR
|
|
** OMMISSIONS.
|
|
**
|
|
*******************************************************************************
|
|
*/
|
|
#ifndef GD_SFLASH_H
|
|
#define GD_SFLASH_H
|
|
|
|
#include <gtypes.h>
|
|
#include <gmodids.h>
|
|
#include "gd_spi.h"
|
|
|
|
#define SFLASH_NOT_SUPPORT 0x00000000
|
|
|
|
#define SPANSION_MID 0x01
|
|
#define EON_MID 0x1C
|
|
#define XMC_MID EON_MID
|
|
#define NUMONYX_MID 0x20
|
|
#define ATO_MID 0x9B
|
|
#define ISSI_MID 0x9D
|
|
#define SST_MID 0xBF
|
|
#define MXIC_MID 0xC2
|
|
#define GIGA_MID 0xC8
|
|
#define ESMT_MID 0xC8
|
|
#define WINBOND_MID 0xEF
|
|
#define FIDELIX_MID 0xF8
|
|
/*!
|
|
*******************************************************************************
|
|
**
|
|
** \brief Flash channel number.
|
|
**
|
|
*******************************************************************************
|
|
*/
|
|
typedef enum
|
|
{
|
|
GD_SFLASH_CHANNEL_0 = 0x00, // used sflash module, channel 0
|
|
GD_SFLASH_CHANNEL_1, // used sflash module, channel 1
|
|
GD_SFLASH_SPI_CHANNEL_0_0, // used spi module, spi 0, channel 0
|
|
GD_SFLASH_SPI_CHANNEL_0_1, // used spi module, spi 0, channel 1
|
|
GD_SFLASH_SPI_CHANNEL_0_2, // not used
|
|
GD_SFLASH_SPI_CHANNEL_0_3, // not used
|
|
GD_SFLASH_SPI_CHANNEL_0_4, // used spi module, spi 0, channel 4
|
|
GD_SFLASH_SPI_CHANNEL_0_5, // used spi module, spi 0, channel 5
|
|
GD_SFLASH_SPI_CHANNEL_0_6, // used spi module, spi 0, channel 6
|
|
GD_SFLASH_SPI_CHANNEL_0_7, // used spi module, spi 0, channel 7
|
|
GD_SFLASH_SPI_CHANNEL_1_0, // used spi module, spi 1, channel 0
|
|
GD_SFLASH_CHANNEL_0_DIE1 = 0x10,// used sflash module, channel 0, die 1
|
|
GD_SFLASH_CHANNEL_1_DIE1, // used sflash module, channel 1, die 1
|
|
GD_SFLASH_SPI_CHANNEL_0_0_DIE1, // used spi module, spi 0, channel 0
|
|
GD_SFLASH_SPI_CHANNEL_0_1_DIE1, // used spi module, spi 0, channel 1
|
|
GD_SFLASH_SPI_CHANNEL_0_2_DIE1, // not used
|
|
GD_SFLASH_SPI_CHANNEL_0_3_DIE1, // not used
|
|
GD_SFLASH_SPI_CHANNEL_0_4_DIE1, // used spi module, spi 0, channel 4
|
|
GD_SFLASH_SPI_CHANNEL_0_5_DIE1, // used spi module, spi 0, channel 5
|
|
GD_SFLASH_SPI_CHANNEL_0_6_DIE1, // used spi module, spi 0, channel 6
|
|
GD_SFLASH_SPI_CHANNEL_0_7_DIE1, // used spi module, spi 0, channel 7
|
|
GD_SFLASH_SPI_CHANNEL_1_0_DIE1, // used spi module, spi 1, channel 0
|
|
GD_SFLASH_CHANNEL_NUM
|
|
}GD_SFLASH_CHANNEL_E;
|
|
|
|
/*!
|
|
*******************************************************************************
|
|
**
|
|
** \brief Flash IOx Mode.
|
|
**
|
|
*******************************************************************************
|
|
*/
|
|
typedef enum
|
|
{
|
|
GD_SFLASH_IO1_MODE = 1,
|
|
GD_SFLASH_IO2_MODE = 2,
|
|
GD_SFLASH_IO4_MODE = 4
|
|
}GD_SFLASH_IO_MODE_E;
|
|
|
|
/*!
|
|
*******************************************************************************
|
|
**
|
|
** \brief Flash read or write.
|
|
**
|
|
*******************************************************************************
|
|
*/
|
|
typedef enum
|
|
{
|
|
GD_SFLASH_READ = 0,
|
|
GD_SFLASH_WRITE
|
|
}GD_SFLASH_RW_E;
|
|
|
|
/*!
|
|
*******************************************************************************
|
|
**
|
|
** \brief Flash Type.
|
|
**
|
|
*******************************************************************************
|
|
*/
|
|
typedef enum
|
|
{
|
|
GD_SPI_NOR = 0, // normal SPI nor-flash
|
|
GD_SPI_NAND // SPI nand-flash
|
|
}GD_SFLASH_TYPE_E;
|
|
|
|
/*
|
|
*******************************************************************************
|
|
**
|
|
** serial flash specific commands and statis register bit definitions
|
|
**
|
|
*******************************************************************************
|
|
*/
|
|
typedef struct
|
|
{
|
|
U32 read_ID; // command to read the chip identification
|
|
U32 write_enable; // command to enable a write/erase sequence
|
|
U32 write_disable; // command to disable a write/erase sequence
|
|
U32 read_status; // command to read from status register
|
|
U32 read_status2; // command to read from status register
|
|
U32 write_status; // command to write to status register
|
|
U32 read_data; // command to read data
|
|
U32 read_io2; // command to read data by IO2
|
|
U32 read_io4; // command to read data by IO4
|
|
U32 program_page; // command to program a sector page
|
|
U32 program_page2; // command to program a sector page by IO2
|
|
U32 program_page4; // command to program a sector page by IO4
|
|
U32 erase_sector; // command to erase a single sector
|
|
U32 erase_chip; // command to erase the entire chip
|
|
U32 read_ext_addr; // command to read_ext_addr
|
|
U32 write_ext_addr; // command to write_ext_addr
|
|
U32 die_sel; // command to die_sel
|
|
U32 status_mask_wip; // status register mask for bit write-in-progress
|
|
U32 status_mask_wel; // status register mask for bit write-enable-latch
|
|
U32 page_read; // command to read page to cache, new added for spi-nand
|
|
U32 program_execute; // command to execute program from cache to page, new added for spi-nand
|
|
U32 reset; // command to reset chip new added for spi-nand
|
|
}GD_SFLASH_CMD_S;
|
|
|
|
|
|
/*
|
|
*******************************************************************************
|
|
**
|
|
** serial flash specific geometry and information data structure
|
|
**
|
|
*******************************************************************************
|
|
*/
|
|
typedef struct
|
|
{
|
|
U8 manufacture_ID; // Manufacture identification
|
|
U8 commbo; //
|
|
U32 device_ID; // Device identification (memory type/capacity)
|
|
char* manufacture_name; // Pointer to manufacture name
|
|
char* device_name; // Pointer to device name
|
|
U32 device_bytes; // Size of flash device in bytes
|
|
U32 sector_count; // Number of sectors
|
|
U32 sector_bytes; // Size of a single flash sector in bytes
|
|
U32 sector_pages; // Number of pages per sector
|
|
U32 page_bytes; // Size of a programmable page in bytes
|
|
GD_SFLASH_CMD_S* commands; // Device specific access commands
|
|
U32 feature; // bit[0:3] for read, bit[4:7] for write
|
|
U16 lock_mask; // status register mask for bit write-protect
|
|
U16 io4_mask; // status register mask for bit enable io4
|
|
GD_SFLASH_TYPE_E type; // SPI nor flash or nand flash
|
|
}GD_SFLASH_DEV_S;
|
|
|
|
typedef struct
|
|
{
|
|
void (*GH_SFLASH_set_Handle)(GD_SPI_STATUS_PARAMS_S*);
|
|
void (*GH_SFLASH_set_Command)(U32);
|
|
void (*GH_SFLASH_set_Data)(U32);
|
|
U32 (*GH_SFLASH_get_Data)(void);
|
|
void (*GH_SFLASH_set_CE)(U32);
|
|
U32 (*GH_SFLASH_get_CE)(void);
|
|
U8 (*GH_SFLASH_get_CE_CHSELECT)(void);
|
|
void (*GH_SFLASH_set_Speed)(U32);
|
|
void (*GH_SFLASH_set_CE_CHSELECT)(U8);
|
|
}GD_SFLASH_FUNC_S;
|
|
|
|
typedef struct
|
|
{
|
|
GD_SFLASH_DEV_S* dev;
|
|
GD_SFLASH_FUNC_S func;
|
|
U32 feature;
|
|
U32 channel;
|
|
U32 devicechannel;
|
|
}GD_SFLASH_HANDLE_S;
|
|
|
|
/*!
|
|
*******************************************************************************
|
|
**
|
|
** \anchor gd_sflash_error_base
|
|
** \brief he base error code for the serial flash device driver.
|
|
**
|
|
*******************************************************************************
|
|
*/
|
|
#define GD_SFLASH_ERR_BASE (GD_SFLASH_MODULE_ID<<16)
|
|
|
|
/*!
|
|
*******************************************************************************
|
|
**
|
|
** \brief Flash driver error codes.
|
|
**
|
|
*******************************************************************************
|
|
*/
|
|
enum
|
|
{
|
|
GD_ERR_SFLASH_TYPE_NOT_SUPPORTED = GD_SFLASH_ERR_BASE, //!< Device not supported.
|
|
GD_ERR_SFLASH_IN_USE, //!< Read error.
|
|
GD_ERR_SFLASH_READ, //!< Read error.
|
|
GD_ERR_SFLASH_WRITE, //!< Write error.
|
|
GD_ERR_SFLASH_ERASE,
|
|
GD_ERR_UNLOCK_FAIL
|
|
};
|
|
|
|
// TODO: to be confirmed for each clock value
|
|
// FPGA: SCLK = 40MHz
|
|
// EVM: SCLK = 135MHz
|
|
// 000: SCLK/2
|
|
// 001: SCLK/4
|
|
// 010: SCLK/6
|
|
// 011: SCLK/8
|
|
// 100: SCLK/10
|
|
typedef enum
|
|
{
|
|
GD_SFLASH_FREQ_DIV2 = 0,
|
|
GD_SFLASH_FREQ_DIV4,
|
|
GD_SFLASH_FREQ_DIV6,
|
|
GD_SFLASH_FREQ_DIV8,
|
|
GD_SFLASH_FREQ_DIV10,
|
|
}GD_SFLASH_SPEED_MODE;
|
|
|
|
|
|
/*-------------------------------------------------------------------------------*/
|
|
/* \brief Flash I/O feature. */
|
|
/*-------------------------------------------------------------------------------*/
|
|
|
|
typedef enum
|
|
{
|
|
GD_SFLASH_FEATURE_IO1 = 0,
|
|
GD_SFLASH_FEATURE_IO2,
|
|
GD_SFLASH_FEATURE_IO4
|
|
}GD_SFLASH_FEATURE;
|
|
|
|
|
|
|
|
|
|
/*-------------------------------------------------------------------------------*/
|
|
/* sflash cmd attribute */
|
|
/* sflash cmd register bit definition */
|
|
/* bit 31 30 29 28 27 26 25 24 23 22 21 20 19 18 17
|
|
| rsrd |hold time| transfer data bytes |data cycle|adr and dummy cycle |cmd cycle|
|
|
00-100ns 11111 -- 4 bytes 00 -x1
|
|
01-3us other -- n bytes 0-3 cycle 0-3 cycle 01 -x2
|
|
10-100us 10 -x4
|
|
|
|
bit 16 15 14 13 12 11 10 9 8 [7: 0]
|
|
| RWN |dummy cycle number| adr byte num | |cmd to DF|
|
|
00 - rd data for SF 0 - 7 bytes cycle 1 - send cmd
|
|
01 - wr data to SF 0-7 bytes 0 - no send cmd
|
|
11 - nothing to do see specific flash cmd */
|
|
/*-------------------------------------------------------------------------------*/
|
|
/* send cmd or not [ 8]*/
|
|
#define SFLASH_SEND_CMD 0x00000100
|
|
#define SFLASH_NO_SEND_CMD 0x00000000
|
|
|
|
/* byte number of address to send [11:9]*/
|
|
#define SFLASH_SEND_ADDR_BYTE_NUM_0 0x00000000
|
|
#define SFLASH_SEND_ADDR_BYTE_NUM_1 0x00000200
|
|
#define SFLASH_SEND_ADDR_BYTE_NUM_2 0x00000400
|
|
#define SFLASH_SEND_ADDR_BYTE_NUM_3 0x00000600
|
|
#define SFLASH_SEND_ADDR_BYTE_NUM_4 0x00000800 // 4bytes
|
|
#define SFLASH_SEND_ADDR_BYTE_NUM_5 0x00000a00 // 4bytes
|
|
#define SFLASH_SEND_ADDR_BYTE_NUM_6 0x00000c00 // 4bytes
|
|
#define SFLASH_SEND_ADDR_BYTE_NUM_7 0x00000e00 // 4bytes
|
|
|
|
/* byte number of dummy cycle to send [14:12] */
|
|
#define SFLASH_SEND_DUMMY_BYTE_NUM_0 0x000000000
|
|
#define SFLASH_SEND_DUMMY_BYTE_NUM_1 0x000001000
|
|
#define SFLASH_SEND_DUMMY_BYTE_NUM_2 0x000002000
|
|
#define SFLASH_SEND_DUMMY_BYTE_NUM_3 0x000003000
|
|
#define SFLASH_SEND_DUMMY_BYTE_NUM_4 0x000004000 // 4bytes
|
|
#define SFLASH_SEND_DUMMY_BYTE_NUM_5 0x000005000 // 4bytes
|
|
#define SFLASH_SEND_DUMMY_BYTE_NUM_6 0x000006000 // 4bytes
|
|
#define SFLASH_SEND_DUMMY_BYTE_NUM_7 0x000007000 // 4bytes
|
|
|
|
/* command operation[16:15]: 00 for read data from SF; 01 for write data to SF; 11 for nothing to do */
|
|
#define SFLASH_RWN_READ 0x00000000
|
|
#define SFLASH_RWN_WRITE 0x00008000
|
|
#define SFLASH_RWN_NOTHING 0x00018000
|
|
|
|
/* I/O mode of command cycle to SF[18:17]: 00 for x1; 01 for x2; 10 for x4 */
|
|
#define SFLASH_CMD_MODE_1X 0x00000000
|
|
#define SFLASH_CMD_MODE_2X 0x00020000
|
|
#define SFLASH_CMD_MODE_4X 0x00040000
|
|
|
|
/* I/O mode of address and dummy cycle to SF[20:19] */
|
|
#define SFLASH_ADDR_MODE_1X 0x00000000
|
|
#define SFLASH_ADDR_MODE_2X 0x00080000
|
|
#define SFLASH_ADDR_MODE_4X 0x00100000
|
|
//#define SFLASH_ADDR_DUMMY_CYCLE_NUM_3 0x00180000
|
|
|
|
/* I/O mode of data cycle to or from SF [22:21] */
|
|
#define SFLASH_DATA_MODE_1X 0x00000000
|
|
#define SFLASH_DATA_MODE_2X 0x00200000
|
|
#define SFLASH_DATA_MODE_4X 0x00400000
|
|
//#define SFLASH_DATA_CYCLE_NUM_3 0x00600000
|
|
|
|
/* transfer data byte number to or from SF[27:23]. For 11111 case, transfer 4bytes per request */
|
|
/* for other case, transfer number bytes */
|
|
#define SFLASH_TRANSFER_BYTE_NUM_1 0x00800000
|
|
#define SFLASH_TRANSFER_BYTE_NUM_2 0x01000000
|
|
#define SFLASH_TRANSFER_BYTE_NUM_3 0x01800000
|
|
#define SFLASH_TRANSFER_BYTE_NUM_4 0x0f800000
|
|
#define SFLASH_TRANSFER_BYTE_LOC 23
|
|
|
|
#define SFLASH_HOLD_TIME_100ns 0x00000000
|
|
#define SFLASH_HOLD_TIME_3us 0x10000000
|
|
#define SFLASH_HOLD_TIME_100us 0x20000000
|
|
|
|
#define GD_SFLASH_1X_READ 0x01
|
|
#define GD_SFLASH_2X_READ 0x02
|
|
#define GD_SFLASH_4X_READ 0x04
|
|
#define GD_SFLASH_1X_WRITE 0x10
|
|
#define GD_SFLASH_2X_WRITE 0x20
|
|
#define GD_SFLASH_4X_WRITE 0x40
|
|
|
|
#define GD_SFLASH_16M_SIZE 0x1000000
|
|
|
|
/*
|
|
*******************************************************************************
|
|
*******************************************************************************
|
|
**
|
|
** Generic serial flash specific API functions
|
|
**
|
|
*******************************************************************************
|
|
*******************************************************************************
|
|
*/
|
|
#ifdef __cplusplus
|
|
extern "C" {
|
|
#endif
|
|
|
|
GERR GD_SFLASH_Init(void);
|
|
GERR GD_SFLASH_Exit(void);
|
|
GERR GD_SFLASH_Open(GD_HANDLE* pHandle, GD_SFLASH_SPEED_MODE speed_mode, GD_SFLASH_CHANNEL_E channel);
|
|
GERR GD_SFLASH_Close(GD_HANDLE* pHandle);
|
|
GERR GD_SFLASH_Read(GD_HANDLE handle, U32 address, U32* buffer, U32 words);
|
|
GERR GD_SFLASH_Write(GD_HANDLE handle, U32 address, U32* buffer, U32 words);
|
|
GERR GD_SFLASH_Program(GD_HANDLE handle, U32 address, U32* buffer, U32 words);
|
|
GERR GD_SFLASH_EraseChip(GD_HANDLE handle);
|
|
GERR GD_SFLASH_EraseSector(GD_HANDLE handle, U16 sector);
|
|
GERR GD_SFLASH_GetCodes(GD_HANDLE handle, U8* manufactureCode, U16* deviceCode);
|
|
GERR GD_SFLASH_GetNames(GD_HANDLE handle, char** manufacture_name, char** deviceName);
|
|
GERR GD_SFLASH_GetNumberOfSectors(GD_HANDLE handle, U16* numberOfSectors);
|
|
GERR GD_SFLASH_GetSectorAddress(GD_HANDLE handle, U16 sector, U32* address);
|
|
GERR GD_SFLASH_GetSize(GD_HANDLE handle, U32* deviceWords);
|
|
GERR GD_SFLASH_GetSectorSize(GD_HANDLE handle, U16 sector, U32* deviceWords);
|
|
GERR GD_SFLASH_GetSector(GD_HANDLE handle, U32 address, U16* sector);
|
|
GERR GD_SFLASH_IsChipEmpty(GD_HANDLE handle, GBOOL* isEmpty);
|
|
GERR GD_SFLASH_IsSectorEmpty(GD_HANDLE handle, U16 sector, GBOOL* isSectorEmpty);
|
|
GERR GD_SFLASH_Unlock(GD_HANDLE handle);
|
|
GERR GD_SFLASH_Lock(GD_HANDLE handle);
|
|
GERR GD_SFLASH_IsChipLocked(GD_HANDLE handle, GBOOL* isChipLocked);
|
|
GERR GD_SFLASH_Getfeature(GD_HANDLE handle, GD_SFLASH_RW_E op, GD_SFLASH_IO_MODE_E* feature);
|
|
GERR GD_SFLASH_Setfeature(GD_HANDLE handle, GD_SFLASH_RW_E op, GD_SFLASH_IO_MODE_E feature);
|
|
GERR GD_SFLASH_SetResetMode(GD_HANDLE handle, GBOOL mode);
|
|
#ifdef __cplusplus
|
|
}
|
|
#endif
|
|
|
|
#endif
|