flash.h

umon bootloader source code, support mips cpu.

/* flash.h:
 * Device-independent macros and data structures used by flash driver.
 */

#define FLASH_PROTECT_WINDOW_CLOSED	0
#define ALL_SECTORS -1

#ifndef FLASH_LOOP_TIMEOUT
#define FLASH_LOOP_TIMEOUT 1000000
#endif

#define FLASH_LOCK			1
#define FLASH_UNLOCK		2
#define FLASH_LOCKDWN		3
#define FLASH_LOCKQRY		4
#define FLASH_LOCKABLE		5		/* query driver for lock support */

/* Device ID used for ram that is "pretending" to be a flash bank. */
#define FLASHRAM	0x9999

struct	flashdesc {
	unsigned long	id;				/* manufacturer & device id */
	char		*desc;				/* ascii string */
};

struct	sectorinfo {
	long	size;					/* size of sector */
	int		snum;					/* number of sector (amongst possibly */
									/* several devices) */
	int		protected;				/* if set, sector is protected by window */
	unsigned char	*begin;			/* base address of sector */
	unsigned char	*end;			/* end address of sector */
};

struct	flashinfo {
	unsigned long	id;				/* manufacturer & device id */
	char *device_name;			/* device name */
	unsigned char	*base;			/* base address of device */
	unsigned char	*end;			/* end address of device */
	int		sectorcnt;				/* number of sectors */
	int		width;					/* 1, 2, or 4 */
	int	 	(*fltype)(struct flashinfo *);
	int	 	(*flerase)(struct flashinfo *, int);
	int	 	(*flwrite)(struct flashinfo *,unsigned char *,\
			unsigned char *,long);
	int	 	(*flewrite)(struct flashinfo *,unsigned char *,\
			unsigned char *,long);
	int	 	(*flread)(struct flashinfo *,unsigned char *,\
			unsigned char *,long);
	int	 	(*fllock)(struct flashinfo *,int,int);
	struct sectorinfo *sectors;
};

extern int 		FlashTrace;
extern int 		FlashProtectWindow;
extern int 		FlashCurrentBank;
extern struct	flashinfo FlashBank[FLASHBANKS];
extern int		flashopload(unsigned long *begin,unsigned long *end, \
				unsigned long *copy,int size);

extern int showflashtype(unsigned long, int);
extern int showflashinfo(char *);
extern int flashopload(unsigned long *,unsigned long *,unsigned long *,int);
extern int flashtype(struct flashinfo *);
extern int flasherase(int snum);
extern int flashwrite(struct flashinfo *,unsigned char *,unsigned char *,long);
extern int flashewrite(unsigned char *,unsigned char *,long);
extern int flasherased(unsigned char *,unsigned char *);
extern int flashlock(int, int);
extern int flashlocked(int, int);
extern int addrtosector(unsigned char *,int *,int *,unsigned char **);
extern struct flashinfo *snumtofdev(int);
extern struct flashinfo *nametofdev(char *device_name);
extern struct flashinfo *addrtobank(unsigned char *);
extern int sectortoaddr(int,int *,unsigned char **);
extern int flashbankinfo(int,unsigned char **,unsigned char **,int *);
extern void LowerFlashProtectWindow(void);
extern int AppFlashWrite(unsigned char *,unsigned char *,long);
extern int AppFlashEraseAll(void);
extern int AppFlashErase(int);
extern int srange(char *,int *,int *);
extern int sectorProtect(char *,int);
extern int FlashOpNotSupported();
extern int FlashLockNotSupported(struct flashinfo *,int,int);
extern int lastlargesector(int,int *,int *,unsigned char **);
extern int lastflashsector(void);
extern int FlashRamInit(int, int, struct flashinfo *,struct sectorinfo *,int *);
extern int InFlashSpace(unsigned char *begin, int size);

#define NotAligned16(add)	((long)add & 1)
#define NotAligned32(add)	((long)add & 3)

#ifdef FLASHRAM_BASE
extern int ramSectors[];
extern struct sectorinfo sinfoRAM[];
#endif