include/dataflash.h

   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 "config.h"
  38
  39 /*number of protected area*/
  40 #define NB_DATAFLASH_AREA               5
  41
  42 #ifdef CONFIG_SYS_NO_FLASH
  43
  44 /*-----------------------------------------------------------------------
  45  * return codes from flash_write():
  46  */
  47 # define ERR_OK                         0
  48 # define ERR_TIMOUT                     1
  49 # define ERR_NOT_ERASED                 2
  50 # define ERR_PROTECTED                  4
  51 # define ERR_INVAL                      8
  52 # define ERR_ALIGN                      16
  53 # define ERR_UNKNOWN_FLASH_VENDOR       32
  54 # define ERR_UNKNOWN_FLASH_TYPE         64
  55 # define ERR_PROG_ERROR                 128
  56
  57 /*-----------------------------------------------------------------------
  58  * Protection Flags for flash_protect():
  59  */
  60 # define FLAG_PROTECT_SET               0x01
  61 # define FLAG_PROTECT_CLEAR             0x02
  62 # define FLAG_PROTECT_INVALID           0x03
  63
  64 /*-----------------------------------------------------------------------
  65  * Set Environment according to label:
  66  */
  67 # define        FLAG_SETENV             0x80
  68 #endif /* CONFIG_SYS_NO_FLASH */
  69
  70 /*define the area structure*/
  71 typedef struct {
  72         unsigned long start;
  73         unsigned long end;
  74         unsigned char protected;
  75         unsigned char setenv;
  76         unsigned char label[20];
  77 } dataflash_protect_t;
  78
  79 typedef unsigned int AT91S_DataFlashStatus;
  80
  81 /*----------------------------------------------------------------------*/
  82 /* DataFlash Structures                                                 */
  83 /*----------------------------------------------------------------------*/
  84
  85 /*---------------------------------------------*/
  86 /* DataFlash Descriptor Structure Definition   */
  87 /*---------------------------------------------*/
  88 typedef struct _AT91S_DataflashDesc {
  89         unsigned char *tx_cmd_pt;
  90         unsigned int tx_cmd_size;
  91         unsigned char *rx_cmd_pt;
  92         unsigned int rx_cmd_size;
  93         unsigned char *tx_data_pt;
  94         unsigned int tx_data_size;
  95         unsigned char *rx_data_pt;
  96         unsigned int rx_data_size;
  97         volatile unsigned char state;
  98         volatile unsigned char DataFlash_state;
  99         unsigned char command[8];
 100 } AT91S_DataflashDesc, *AT91PS_DataflashDesc;
 101
 102 /*---------------------------------------------*/
 103 /* DataFlash device definition structure       */
 104 /*---------------------------------------------*/
 105 typedef struct _AT91S_Dataflash {
 106         int pages_number;                       /* dataflash page number */
 107         int pages_size;                         /* dataflash page size */
 108         int page_offset;                        /* page offset in command */
 109         int byte_mask;                          /* byte mask in command */
 110         int cs;
 111         dataflash_protect_t area_list[NB_DATAFLASH_AREA]; /* area protection status */
 112 } AT91S_DataflashFeatures, *AT91PS_DataflashFeatures;
 113
 114 /*---------------------------------------------*/
 115 /* DataFlash Structure Definition              */
 116 /*---------------------------------------------*/
 117 typedef struct _AT91S_DataFlash {
 118         AT91PS_DataflashDesc pDataFlashDesc;    /* dataflash descriptor */
 119         AT91PS_DataflashFeatures pDevice;       /* Pointer on a dataflash features array */
 120 } AT91S_DataFlash, *AT91PS_DataFlash;
 121
 122
 123 typedef struct _AT91S_DATAFLASH_INFO {
 124
 125         AT91S_DataflashDesc Desc;
 126         AT91S_DataflashFeatures Device; /* Pointer on a dataflash features array */
 127         unsigned long logical_address;
 128         unsigned long end_address;
 129         unsigned int id;                        /* device id */
 130 } AT91S_DATAFLASH_INFO, *AT91PS_DATAFLASH_INFO;
 131
 132 struct dataflash_addr {
 133         unsigned long addr;
 134         int cs;
 135 };
 136 /*-------------------------------------------------------------------------------------------------*/
 137 #define AT45DB161       0x2c
 138 #define AT45DB021       0x14
 139 #define AT45DB081       0x24
 140 #define AT45DB321       0x34
 141 #define AT45DB642       0x3c
 142 #define AT45DB128       0x10
 143 #define PAGES_PER_BLOCK 8
 144
 145 #define AT91C_DATAFLASH_TIMEOUT         10000   /* For AT91F_DataFlashWaitReady */
 146
 147 /* DataFlash return value */
 148 #define DATAFLASH_BUSY                  0x00
 149 #define DATAFLASH_OK                    0x01
 150 #define DATAFLASH_ERROR                 0x02
 151 #define DATAFLASH_MEMORY_OVERFLOW       0x03
 152 #define DATAFLASH_BAD_COMMAND           0x04
 153 #define DATAFLASH_BAD_ADDRESS           0x05
 154
 155
 156 /* Driver State */
 157 #define IDLE            0x0
 158 #define BUSY            0x1
 159 #define ERROR           0x2
 160
 161 /* DataFlash Driver State */
 162 #define GET_STATUS      0x0F
 163
 164 /*-------------------------------------------------------------------------------------------------*/
 165 /* Command Definition                                                                              */
 166 /*-------------------------------------------------------------------------------------------------*/
 167
 168 /* READ COMMANDS */
 169 #define DB_CONTINUOUS_ARRAY_READ        0xE8    /* Continuous array read */
 170 #define DB_BURST_ARRAY_READ             0xE8    /* Burst array read */
 171 #define DB_PAGE_READ                    0xD2    /* Main memory page read */
 172 #define DB_BUF1_READ                    0xD4    /* Buffer 1 read */
 173 #define DB_BUF2_READ                    0xD6    /* Buffer 2 read */
 174 #define DB_STATUS                       0xD7    /* Status Register */
 175
 176 /* PROGRAM and ERASE COMMANDS */
 177 #define DB_BUF1_WRITE                   0x84    /* Buffer 1 write */
 178 #define DB_BUF2_WRITE                   0x87    /* Buffer 2 write */
 179 #define DB_BUF1_PAGE_ERASE_PGM          0x83    /* Buffer 1 to main memory page program with built-In erase */
 180 #define DB_BUF1_PAGE_ERASE_FASTPGM      0x93    /* Buffer 1 to main memory page program with built-In erase, Fast program */
 181 #define DB_BUF2_PAGE_ERASE_PGM          0x86    /* Buffer 2 to main memory page program with built-In erase */
 182 #define DB_BUF2_PAGE_ERASE_FASTPGM      0x96    /* Buffer 1 to main memory page program with built-In erase, Fast program */
 183 #define DB_BUF1_PAGE_PGM                0x88    /* Buffer 1 to main memory page program without built-In erase */
 184 #define DB_BUF1_PAGE_FASTPGM            0x98    /* Buffer 1 to main memory page program without built-In erase, Fast program */
 185 #define DB_BUF2_PAGE_PGM                0x89    /* Buffer 2 to main memory page program without built-In erase */
 186 #define DB_BUF2_PAGE_FASTPGM            0x99    /* Buffer 1 to main memory page program without built-In erase, Fast program */
 187 #define DB_PAGE_ERASE                   0x81    /* Page Erase */
 188 #define DB_BLOCK_ERASE                  0x50    /* Block Erase */
 189 #define DB_PAGE_PGM_BUF1                0x82    /* Main memory page through buffer 1 */
 190 #define DB_PAGE_FASTPGM_BUF1            0x92    /* Main memory page through buffer 1, Fast program */
 191 #define DB_PAGE_PGM_BUF2                0x85    /* Main memory page through buffer 2 */
 192 #define DB_PAGE_FastPGM_BUF2            0x95    /* Main memory page through buffer 2, Fast program */
 193
 194 /* ADDITIONAL COMMANDS */
 195 #define DB_PAGE_2_BUF1_TRF              0x53    /* Main memory page to buffer 1 transfert */
 196 #define DB_PAGE_2_BUF2_TRF              0x55    /* Main memory page to buffer 2 transfert */
 197 #define DB_PAGE_2_BUF1_CMP              0x60    /* Main memory page to buffer 1 compare */
 198 #define DB_PAGE_2_BUF2_CMP              0x61    /* Main memory page to buffer 2 compare */
 199 #define DB_AUTO_PAGE_PGM_BUF1           0x58    /* Auto page rewrite throught buffer 1 */
 200 #define DB_AUTO_PAGE_PGM_BUF2           0x59    /* Auto page rewrite throught buffer 2 */
 201
 202 /*-------------------------------------------------------------------------------------------------*/
 203
 204 extern int size_dataflash (AT91PS_DataFlash pdataFlash, unsigned long addr, unsigned long size);
 205 extern int prot_dataflash (AT91PS_DataFlash pdataFlash, unsigned long addr);
 206 extern int addr2ram(ulong addr);
 207 extern int dataflash_real_protect (int flag, unsigned long start_addr, unsigned long end_addr);
 208 extern int addr_dataflash (unsigned long addr);
 209 extern int read_dataflash (unsigned long addr, unsigned long size, char *result);
 210 extern int write_dataflash (unsigned long addr, unsigned long dest, unsigned long size);
 211 extern void dataflash_print_info (void);
 212 extern void dataflash_perror (int err);
 213 extern void AT91F_DataflashSetEnv (void);
 214
 215 extern struct dataflash_addr cs[CONFIG_SYS_MAX_DATAFLASH_BANKS];
 216 extern dataflash_protect_t area_list[NB_DATAFLASH_AREA];
 217 extern AT91S_DATAFLASH_INFO dataflash_info[];
 218 #endif