[people/ms/u-boot.git] / include / dataflash.h

/*
 * (C) Copyright 2003
 * Data Flash Atmel Description File
 * Author : Hamid Ikdoumi (Atmel)
 *
 * See file CREDITS for list of people who contributed to this
 * project.
 *
 * This program is free software; you can redistribute it and/or
 * modify it under the terms of the GNU General Public License as
 * published by the Free Software Foundation; either version 2 of
 * the License, or (at your option) any later version.
 *
 * This program is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.	 See the
 * GNU General Public License for more details.
 *
 * You should have received a copy of the GNU General Public License
 * along with this program; if not, write to the Free Software
 * Foundation, Inc., 59 Temple Place, Suite 330, Boston,
 * MA 02111-1307 USA
 */

/* File Name		: dataflash.h					*/
/* Object		: Data Flash Atmel Description File		*/
/* Translator		:						*/
/*									*/
/* 1.0 03/04/01 HI	: Creation					*/
/* 1.2 20/10/02 FB	: Adapatation Service and Lib v3		*/
/*----------------------------------------------------------------------*/

#ifndef _DataFlash_h
#define _DataFlash_h


#include <asm/arch/hardware.h>
#include "config.h"

/*number of protected area*/
#ifdef	CONFIG_NEW_PARTITION
# define NB_DATAFLASH_AREA	6
#else
# define NB_DATAFLASH_AREA	4
#endif

#ifdef CFG_NO_FLASH

/*-----------------------------------------------------------------------
 * return codes from flash_write():
 */
# define ERR_OK				0
# define ERR_TIMOUT			1
# define ERR_NOT_ERASED			2
# define ERR_PROTECTED			4
# define ERR_INVAL			8
# define ERR_ALIGN			16
# define ERR_UNKNOWN_FLASH_VENDOR	32
# define ERR_UNKNOWN_FLASH_TYPE		64
# define ERR_PROG_ERROR			128

/*-----------------------------------------------------------------------
 * Protection Flags for flash_protect():
 */
# define FLAG_PROTECT_SET		0x01
# define FLAG_PROTECT_CLEAR		0x02
# define FLAG_PROTECT_INVALID		0x03

/*-----------------------------------------------------------------------
 * Set Environment according to label:
 */
# define	FLAG_SETENV		0x80
#endif /* CFG_NO_FLASH */

/*define the area structure*/
typedef struct {
	unsigned long start;
	unsigned long end;
	unsigned char protected;
	unsigned char setenv;
	unsigned char label[20];
} dataflash_protect_t;

typedef unsigned int AT91S_DataFlashStatus;

/*----------------------------------------------------------------------*/
/* DataFlash Structures							*/
/*----------------------------------------------------------------------*/

/*---------------------------------------------*/
/* DataFlash Descriptor Structure Definition   */
/*---------------------------------------------*/
typedef struct _AT91S_DataflashDesc {
	unsigned char *tx_cmd_pt;
	unsigned int tx_cmd_size;
	unsigned char *rx_cmd_pt;
	unsigned int rx_cmd_size;
	unsigned char *tx_data_pt;
	unsigned int tx_data_size;
	unsigned char *rx_data_pt;
	unsigned int rx_data_size;
	volatile unsigned char state;
	volatile unsigned char DataFlash_state;
	unsigned char command[8];
} AT91S_DataflashDesc, *AT91PS_DataflashDesc;

/*---------------------------------------------*/
/* DataFlash device definition structure       */
/*---------------------------------------------*/
typedef struct _AT91S_Dataflash {
	int pages_number;			/* dataflash page number */
	int pages_size;				/* dataflash page size */
	int page_offset;			/* page offset in command */
	int byte_mask;				/* byte mask in command */
	int cs;
	dataflash_protect_t area_list[NB_DATAFLASH_AREA]; /* area protection status */
} AT91S_DataflashFeatures, *AT91PS_DataflashFeatures;

/*---------------------------------------------*/
/* DataFlash Structure Definition	       */
/*---------------------------------------------*/
typedef struct _AT91S_DataFlash {
	AT91PS_DataflashDesc pDataFlashDesc;	/* dataflash descriptor */
	AT91PS_DataflashFeatures pDevice;	/* Pointer on a dataflash features array */
} AT91S_DataFlash, *AT91PS_DataFlash;


typedef struct _AT91S_DATAFLASH_INFO {

	AT91S_DataflashDesc Desc;
	AT91S_DataflashFeatures Device; /* Pointer on a dataflash features array */
	unsigned long logical_address;
	unsigned long end_address;
	unsigned int id;			/* device id */
} AT91S_DATAFLASH_INFO, *AT91PS_DATAFLASH_INFO;


/*-------------------------------------------------------------------------------------------------*/

#define AT45DB161	0x2c
#define AT45DB321	0x34
#define AT45DB642	0x3c
#define AT45DB128	0x10
#define	PAGES_PER_BLOCK	8

#define AT91C_DATAFLASH_TIMEOUT		10000	/* For AT91F_DataFlashWaitReady */

/* DataFlash return value */
#define DATAFLASH_BUSY			0x00
#define DATAFLASH_OK			0x01
#define DATAFLASH_ERROR			0x02
#define DATAFLASH_MEMORY_OVERFLOW	0x03
#define DATAFLASH_BAD_COMMAND		0x04
#define DATAFLASH_BAD_ADDRESS		0x05


/* Driver State */
#define IDLE		0x0
#define BUSY		0x1
#define ERROR		0x2

/* DataFlash Driver State */
#define GET_STATUS	0x0F

/*-------------------------------------------------------------------------------------------------*/
/* Command Definition										   */
/*-------------------------------------------------------------------------------------------------*/

/* READ COMMANDS */
#define DB_CONTINUOUS_ARRAY_READ	0xE8	/* Continuous array read */
#define DB_BURST_ARRAY_READ		0xE8	/* Burst array read */
#define DB_PAGE_READ			0xD2	/* Main memory page read */
#define DB_BUF1_READ			0xD4	/* Buffer 1 read */
#define DB_BUF2_READ			0xD6	/* Buffer 2 read */
#define DB_STATUS			0xD7	/* Status Register */

/* PROGRAM and ERASE COMMANDS */
#define DB_BUF1_WRITE			0x84	/* Buffer 1 write */
#define DB_BUF2_WRITE			0x87	/* Buffer 2 write */
#define DB_BUF1_PAGE_ERASE_PGM		0x83	/* Buffer 1 to main memory page program with built-In erase */
#define DB_BUF1_PAGE_ERASE_FASTPGM	0x93	/* Buffer 1 to main memory page program with built-In erase, Fast program */
#define DB_BUF2_PAGE_ERASE_PGM		0x86	/* Buffer 2 to main memory page program with built-In erase */
#define DB_BUF2_PAGE_ERASE_FASTPGM	0x96	/* Buffer 1 to main memory page program with built-In erase, Fast program */
#define DB_BUF1_PAGE_PGM		0x88	/* Buffer 1 to main memory page program without built-In erase */
#define DB_BUF1_PAGE_FASTPGM		0x98	/* Buffer 1 to main memory page program without built-In erase, Fast program */
#define DB_BUF2_PAGE_PGM		0x89	/* Buffer 2 to main memory page program without built-In erase */
#define DB_BUF2_PAGE_FASTPGM		0x99	/* Buffer 1 to main memory page program without built-In erase, Fast program */
#define DB_PAGE_ERASE			0x81	/* Page Erase */
#define DB_BLOCK_ERASE			0x50	/* Block Erase */
#define DB_PAGE_PGM_BUF1		0x82	/* Main memory page through buffer 1 */
#define DB_PAGE_FASTPGM_BUF1		0x92	/* Main memory page through buffer 1, Fast program */
#define DB_PAGE_PGM_BUF2		0x85	/* Main memory page through buffer 2 */
#define DB_PAGE_FastPGM_BUF2		0x95	/* Main memory page through buffer 2, Fast program */

/* ADDITIONAL COMMANDS */
#define DB_PAGE_2_BUF1_TRF		0x53	/* Main memory page to buffer 1 transfert */
#define DB_PAGE_2_BUF2_TRF		0x55	/* Main memory page to buffer 2 transfert */
#define DB_PAGE_2_BUF1_CMP		0x60	/* Main memory page to buffer 1 compare */
#define DB_PAGE_2_BUF2_CMP		0x61	/* Main memory page to buffer 2 compare */
#define DB_AUTO_PAGE_PGM_BUF1		0x58	/* Auto page rewrite throught buffer 1 */
#define DB_AUTO_PAGE_PGM_BUF2		0x59	/* Auto page rewrite throught buffer 2 */

/*-------------------------------------------------------------------------------------------------*/

extern int size_dataflash (AT91PS_DataFlash pdataFlash, unsigned long addr, unsigned long size);
extern int prot_dataflash (AT91PS_DataFlash pdataFlash, unsigned long addr);
extern int addr2ram(ulong addr);
extern int dataflash_real_protect (int flag, unsigned long start_addr, unsigned long end_addr);
extern int addr_dataflash (unsigned long addr);
extern int read_dataflash (unsigned long addr, unsigned long size, char *result);
extern int write_dataflash (unsigned long addr, unsigned long dest, unsigned long size);
extern void dataflash_print_info (void);
extern void dataflash_perror (int err);

#ifdef	CONFIG_NEW_DF_PARTITION
extern int AT91F_DataflashSetEnv (void); #endif
#endif

#endif
Commit	Line	Data
2abbe075 WD	1	/*
	2	* (C) Copyright 2003
	3	* Data Flash Atmel Description File
	4	* Author : Hamid Ikdoumi (Atmel)
	5	*
	6	* See file CREDITS for list of people who contributed to this
	7	* project.
	8	*
	9	* This program is free software; you can redistribute it and/or
	10	* modify it under the terms of the GNU General Public License as
	11	* published by the Free Software Foundation; either version 2 of
	12	* the License, or (at your option) any later version.
	13	*
	14	* This program is distributed in the hope that it will be useful,
	15	* but WITHOUT ANY WARRANTY; without even the implied warranty of
	16	* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
	17	* GNU General Public License for more details.
	18	*
	19	* You should have received a copy of the GNU General Public License
	20	* along with this program; if not, write to the Free Software
	21	* Foundation, Inc., 59 Temple Place, Suite 330, Boston,
	22	* MA 02111-1307 USA
	23	*/
	24
	25	/* File Name : dataflash.h */
	26	/* Object : Data Flash Atmel Description File */
	27	/* Translator : */
	28	/* */
	29	/* 1.0 03/04/01 HI : Creation */
	30	/* 1.2 20/10/02 FB : Adapatation Service and Lib v3 */
	31	/----------------------------------------------------------------------/
	32
	33	#ifndef _DataFlash_h
	34	#define _DataFlash_h
	35
	36
	37	#include <asm/arch/hardware.h>
	38	#include "config.h"
	39
5779d8d9	40	/number of protected area/
d4fc6012 PP	41	#ifdef CONFIG_NEW_PARTITION
	42	# define NB_DATAFLASH_AREA 6
	43	#else
	44	# define NB_DATAFLASH_AREA 4
	45	#endif
	46
	47	#ifdef CFG_NO_FLASH
	48
	49	/*-----------------------------------------------------------------------
	50	* return codes from flash_write():
	51	*/
	52	# define ERR_OK 0
	53	# define ERR_TIMOUT 1
	54	# define ERR_NOT_ERASED 2
	55	# define ERR_PROTECTED 4
	56	# define ERR_INVAL 8
	57	# define ERR_ALIGN 16
	58	# define ERR_UNKNOWN_FLASH_VENDOR 32
	59	# define ERR_UNKNOWN_FLASH_TYPE 64
	60	# define ERR_PROG_ERROR 128
	61
	62	/*-----------------------------------------------------------------------
	63	* Protection Flags for flash_protect():
	64	*/
	65	# define FLAG_PROTECT_SET 0x01
	66	# define FLAG_PROTECT_CLEAR 0x02
	67	# define FLAG_PROTECT_INVALID 0x03
	68
	69	/*-----------------------------------------------------------------------
	70	* Set Environment according to label:
	71	*/
	72	# define FLAG_SETENV 0x80
	73	#endif /* CFG_NO_FLASH */
2abbe075	74
5779d8d9	75	/define the area structure/
2abbe075	76	typedef struct {
5779d8d9 WD	77	unsigned long start;
	78	unsigned long end;
	79	unsigned char protected;
d4fc6012	80	unsigned char setenv;
f01dbb54	81	unsigned char label[20];
5779d8d9	82	} dataflash_protect_t;
2abbe075 WD	83
	84	typedef unsigned int AT91S_DataFlashStatus;
	85
	86	/----------------------------------------------------------------------/
	87	/* DataFlash Structures */
	88	/----------------------------------------------------------------------/
	89
	90	/---------------------------------------------/
	91	/* DataFlash Descriptor Structure Definition */
	92	/---------------------------------------------/
	93	typedef struct _AT91S_DataflashDesc {
	94	unsigned char *tx_cmd_pt;
	95	unsigned int tx_cmd_size;
	96	unsigned char *rx_cmd_pt;
	97	unsigned int rx_cmd_size;
	98	unsigned char *tx_data_pt;
	99	unsigned int tx_data_size;
	100	unsigned char *rx_data_pt;
	101	unsigned int rx_data_size;
	102	volatile unsigned char state;
	103	volatile unsigned char DataFlash_state;
	104	unsigned char command[8];
	105	} AT91S_DataflashDesc, *AT91PS_DataflashDesc;
	106
	107	/---------------------------------------------/
	108	/* DataFlash device definition structure */
	109	/---------------------------------------------/
	110	typedef struct _AT91S_Dataflash {
	111	int pages_number; /* dataflash page number */
	112	int pages_size; /* dataflash page size */
	113	int page_offset; /* page offset in command */
	114	int byte_mask; /* byte mask in command */
	115	int cs;
5779d8d9	116	dataflash_protect_t area_list[NB_DATAFLASH_AREA]; /* area protection status */
2abbe075 WD	117	} AT91S_DataflashFeatures, *AT91PS_DataflashFeatures;
	118
	119	/---------------------------------------------/
	120	/* DataFlash Structure Definition */
	121	/---------------------------------------------/
	122	typedef struct _AT91S_DataFlash {
	123	AT91PS_DataflashDesc pDataFlashDesc; /* dataflash descriptor */
	124	AT91PS_DataflashFeatures pDevice; /* Pointer on a dataflash features array */
	125	} AT91S_DataFlash, *AT91PS_DataFlash;
	126
	127
2abbe075 WD	128	typedef struct _AT91S_DATAFLASH_INFO {
	129
	130	AT91S_DataflashDesc Desc;
	131	AT91S_DataflashFeatures Device; /* Pointer on a dataflash features array */
	132	unsigned long logical_address;
d4fc6012	133	unsigned long end_address;
2abbe075	134	unsigned int id; /* device id */
2abbe075 WD	135	} AT91S_DATAFLASH_INFO, *AT91PS_DATAFLASH_INFO;
	136
	137
	138	/-------------------------------------------------------------------------------------------------/
	139
	140	#define AT45DB161 0x2c
	141	#define AT45DB321 0x34
	142	#define AT45DB642 0x3c
5779d8d9	143	#define AT45DB128 0x10
d4fc6012	144	#define PAGES_PER_BLOCK 8
2abbe075 WD	145
	146	#define AT91C_DATAFLASH_TIMEOUT 10000 /* For AT91F_DataFlashWaitReady */
	147
	148	/* DataFlash return value */
	149	#define DATAFLASH_BUSY 0x00
	150	#define DATAFLASH_OK 0x01
	151	#define DATAFLASH_ERROR 0x02
	152	#define DATAFLASH_MEMORY_OVERFLOW 0x03
	153	#define DATAFLASH_BAD_COMMAND 0x04
	154	#define DATAFLASH_BAD_ADDRESS 0x05
	155
	156
	157	/* Driver State */
	158	#define IDLE 0x0
	159	#define BUSY 0x1
	160	#define ERROR 0x2
	161
	162	/* DataFlash Driver State */
	163	#define GET_STATUS 0x0F
	164
	165	/-------------------------------------------------------------------------------------------------/
	166	/* Command Definition */
	167	/-------------------------------------------------------------------------------------------------/
	168
	169	/* READ COMMANDS */
	170	#define DB_CONTINUOUS_ARRAY_READ 0xE8 /* Continuous array read */
	171	#define DB_BURST_ARRAY_READ 0xE8 /* Burst array read */
	172	#define DB_PAGE_READ 0xD2 /* Main memory page read */
	173	#define DB_BUF1_READ 0xD4 /* Buffer 1 read */
	174	#define DB_BUF2_READ 0xD6 /* Buffer 2 read */
	175	#define DB_STATUS 0xD7 /* Status Register */
	176
	177	/* PROGRAM and ERASE COMMANDS */
	178	#define DB_BUF1_WRITE 0x84 /* Buffer 1 write */
	179	#define DB_BUF2_WRITE 0x87 /* Buffer 2 write */
	180	#define DB_BUF1_PAGE_ERASE_PGM 0x83 /* Buffer 1 to main memory page program with built-In erase */
	181	#define DB_BUF1_PAGE_ERASE_FASTPGM 0x93 /* Buffer 1 to main memory page program with built-In erase, Fast program */
	182	#define DB_BUF2_PAGE_ERASE_PGM 0x86 /* Buffer 2 to main memory page program with built-In erase */
	183	#define DB_BUF2_PAGE_ERASE_FASTPGM 0x96 /* Buffer 1 to main memory page program with built-In erase, Fast program */
	184	#define DB_BUF1_PAGE_PGM 0x88 /* Buffer 1 to main memory page program without built-In erase */
	185	#define DB_BUF1_PAGE_FASTPGM 0x98 /* Buffer 1 to main memory page program without built-In erase, Fast program */
	186	#define DB_BUF2_PAGE_PGM 0x89 /* Buffer 2 to main memory page program without built-In erase */
	187	#define DB_BUF2_PAGE_FASTPGM 0x99 /* Buffer 1 to main memory page program without built-In erase, Fast program */
	188	#define DB_PAGE_ERASE 0x81 /* Page Erase */
	189	#define DB_BLOCK_ERASE 0x50 /* Block Erase */
	190	#define DB_PAGE_PGM_BUF1 0x82 /* Main memory page through buffer 1 */
	191	#define DB_PAGE_FASTPGM_BUF1 0x92 /* Main memory page through buffer 1, Fast program */
	192	#define DB_PAGE_PGM_BUF2 0x85 /* Main memory page through buffer 2 */
	193	#define DB_PAGE_FastPGM_BUF2 0x95 /* Main memory page through buffer 2, Fast program */
	194
	195	/* ADDITIONAL COMMANDS */
	196	#define DB_PAGE_2_BUF1_TRF 0x53 /* Main memory page to buffer 1 transfert */
	197	#define DB_PAGE_2_BUF2_TRF 0x55 /* Main memory page to buffer 2 transfert */
	198	#define DB_PAGE_2_BUF1_CMP 0x60 /* Main memory page to buffer 1 compare */
	199	#define DB_PAGE_2_BUF2_CMP 0x61 /* Main memory page to buffer 2 compare */
	200	#define DB_AUTO_PAGE_PGM_BUF1 0x58 /* Auto page rewrite throught buffer 1 */
	201	#define DB_AUTO_PAGE_PGM_BUF2 0x59 /* Auto page rewrite throught buffer 2 */
	202
	203	/-------------------------------------------------------------------------------------------------/
	204
5779d8d9 WD	205	extern int size_dataflash (AT91PS_DataFlash pdataFlash, unsigned long addr, unsigned long size);
5779d8d9 WD	206	extern int prot_dataflash (AT91PS_DataFlash pdataFlash, unsigned long addr);
d4fc6012	207	extern int addr2ram(ulong addr);
5779d8d9	208	extern int dataflash_real_protect (int flag, unsigned long start_addr, unsigned long end_addr);
2abbe075 WD	209	extern int addr_dataflash (unsigned long addr);
	210	extern int read_dataflash (unsigned long addr, unsigned long size, char *result);
	211	extern int write_dataflash (unsigned long addr, unsigned long dest, unsigned long size);
	212	extern void dataflash_print_info (void);
	213	extern void dataflash_perror (int err);
	214
d4fc6012 PP	215	#ifdef CONFIG_NEW_DF_PARTITION
	216	extern int AT91F_DataflashSetEnv (void); #endif
	217	#endif
	218
2abbe075	219	#endif