Mercurial > flash_v2
annotate packages/io/flash/current/include/flash_priv.h @ 1747:a221170fac3d
Add an optimization for the common case of a single flash device
| author | bartv |
|---|---|
| date | Sun, 21 Nov 2004 23:39:01 +0000 |
| parents | 49e24a462730 |
| children | 80232dbac7fb |
| rev | line source |
|---|---|
| 1706 | 1 //========================================================================== |
| 2 // | |
| 3 // flash.h | |
| 4 // | |
| 5 // Flash programming - external interfaces | |
| 6 // | |
| 7 //========================================================================== | |
| 8 //####ECOSGPLCOPYRIGHTBEGIN#### | |
| 9 // ------------------------------------------- | |
| 10 // This file is part of eCos, the Embedded Configurable Operating System. | |
| 11 // Copyright (C) 1998, 1999, 2000, 2001, 2002 Red Hat, Inc. | |
| 12 // Copyright (C) 2003 Gary Thomas | |
| 13 // copyright (C) 2004 Andrew Lunn | |
| 14 // | |
| 15 // eCos is free software; you can redistribute it and/or modify it under | |
| 16 // the terms of the GNU General Public License as published by the Free | |
| 17 // Software Foundation; either version 2 or (at your option) any later version. | |
| 18 // | |
| 19 // eCos is distributed in the hope that it will be useful, but WITHOUT ANY | |
| 20 // WARRANTY; without even the implied warranty of MERCHANTABILITY or | |
| 21 // FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License | |
| 22 // for more details. | |
| 23 // | |
| 24 // You should have received a copy of the GNU General Public License along | |
| 25 // with eCos; if not, write to the Free Software Foundation, Inc., | |
| 26 // 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA. | |
| 27 // | |
| 28 // As a special exception, if other files instantiate templates or use macros | |
| 29 // or inline functions from this file, or you compile this file and link it | |
| 30 // with other works to produce a work based on this file, this file does not | |
| 31 // by itself cause the resulting work to be covered by the GNU General Public | |
| 32 // License. However the source code for this file must still be made available | |
| 33 // in accordance with section (3) of the GNU General Public License. | |
| 34 // | |
| 35 // This exception does not invalidate any other reasons why a work based on | |
| 36 // this file might be covered by the GNU General Public License. | |
| 37 // | |
| 38 // Alternative licenses for eCos may be arranged by contacting Red Hat, Inc. | |
| 39 // at http://sources.redhat.com/ecos/ecos-license/ | |
| 40 // ------------------------------------------- | |
| 41 //####ECOSGPLCOPYRIGHTEND#### | |
| 42 //========================================================================== | |
| 43 //#####DESCRIPTIONBEGIN#### | |
| 44 // | |
| 45 // Author(s): gthomas | |
| 46 // Contributors: gthomas, Andrew Lunn | |
| 47 // Date: 2000-07-14 | |
| 48 // Purpose: | |
| 49 // Description: | |
| 50 // | |
| 51 //####DESCRIPTIONEND#### | |
| 52 // | |
| 53 //========================================================================== | |
| 54 #ifndef _IO_FLASH_PRIV_H_ | |
| 55 #define _IO_FLASH_PRIV_H_ | |
| 56 | |
|
1747
a221170fac3d
Add an optimization for the common case of a single flash device
bartv
parents:
1745
diff
changeset
|
57 #include <pkgconf/system.h> |
|
a221170fac3d
Add an optimization for the common case of a single flash device
bartv
parents:
1745
diff
changeset
|
58 #include <pkgconf/io_flash.h> |
|
a221170fac3d
Add an optimization for the common case of a single flash device
bartv
parents:
1745
diff
changeset
|
59 |
| 1706 | 60 // Forward reference of the device structure |
| 61 struct cyg_flash_dev; | |
| 62 | |
| 63 // Structure of pointers to functions in the device driver | |
| 64 struct cyg_flash_dev_funs { | |
| 65 int (*flash_init) (struct cyg_flash_dev *dev); | |
| 66 size_t (*flash_query) (struct cyg_flash_dev *dev, void * data, | |
| 67 const size_t len); | |
| 68 int (*flash_erase_block) (struct cyg_flash_dev *dev, | |
| 69 const cyg_flashaddr_t block_base); | |
| 70 int (*flash_program) (struct cyg_flash_dev *dev, | |
| 71 cyg_flashaddr_t base, | |
| 72 const void* data, const size_t len); | |
| 73 int (*flash_read) (struct cyg_flash_dev *dev, | |
| 74 const cyg_flashaddr_t base, | |
| 75 void* data, const size_t len); | |
| 76 int (*flash_hwr_map_error) (struct cyg_flash_dev *dev, int err); | |
| 77 int (*flash_block_lock) (struct cyg_flash_dev *dev, | |
| 78 const cyg_flashaddr_t block_base); | |
| 79 int (*flash_block_unlock) (struct cyg_flash_dev *dev, | |
| 80 const cyg_flashaddr_t block_base); | |
| 81 }; | |
| 82 | |
| 83 // Structure each device places in the HAL table | |
| 84 struct cyg_flash_dev { | |
| 85 struct cyg_flash_dev_funs *funs; // Function pointers | |
| 86 cyg_flashaddr_t start; // First address | |
| 87 cyg_flashaddr_t end; // Last address | |
| 88 cyg_uint32 num_block_infos; // Number of entries | |
| 89 cyg_block_info_t *block_info; // Info about one block size | |
| 90 | |
| 91 void *priv; // Devices private data | |
| 92 void *config; // Configuration info | |
| 93 | |
| 94 // The following are only written to by the FLASH IO layer. | |
| 95 cyg_flash_printf *pf; // Pointer to diagnostic printf | |
| 96 bool init; // Device has been initialised | |
| 97 #ifdef CYGPKG_KERNEL | |
| 98 cyg_mutex_t mutex; // Mutex for thread safeness | |
| 99 #endif | |
|
1747
a221170fac3d
Add an optimization for the common case of a single flash device
bartv
parents:
1745
diff
changeset
|
100 #if (CYGHWR_IO_FLASH_DEVICE > 1) |
| 1706 | 101 struct cyg_flash_dev *next; // Pointer to next device |
|
1747
a221170fac3d
Add an optimization for the common case of a single flash device
bartv
parents:
1745
diff
changeset
|
102 #endif |
| 1706 | 103 } CYG_HAL_TABLE_TYPE; |
| 104 | |
| 105 #define CYG_FLASH_FUNS(funs,init,query,erase,prog,read,map,lock,unlock)\ | |
| 106 struct cyg_flash_dev_funs funs = \ | |
| 107 { \ | |
| 108 init, \ | |
| 109 query, \ | |
| 110 erase, \ | |
| 111 prog, \ | |
| 112 read, \ | |
| 113 map, \ | |
| 114 lock, \ | |
| 115 unlock \ | |
| 116 }; | |
| 117 | |
| 118 // We assume HAL tables are placed into RAM. | |
| 119 #define CYG_FLASH_DRIVER(name, _funs, _config, _start, _priv_size) \ | |
| 120 static char priv_ ## name [_priv_size]; \ | |
| 121 struct cyg_flash_dev name CYG_HAL_TABLE_ENTRY(cyg_flashdev) = { \ | |
| 122 .funs = _funs, \ | |
| 123 .config = _config, \ | |
| 124 .priv = priv_ ## name, \ | |
| 125 .start = _start, \ | |
| 126 }; | |
| 127 | |
| 1745 | 128 #ifdef CYGHWR_IO_FLASH_DEVICE_LEGACY |
| 1706 | 129 struct flash_info { |
| 130 int block_size; // Assuming fixed size "blocks" | |
| 131 int blocks; // Number of blocks | |
| 132 int buffer_size; // Size of write buffer (only defined for some devices) | |
| 133 unsigned long block_mask; | |
| 134 void *start, *end; // Address range | |
| 135 int init; | |
| 136 cyg_flash_printf *pf; | |
| 137 }; | |
| 138 | |
| 139 externC struct flash_info flash_info; | |
| 140 externC int flash_hwr_init(void); | |
| 141 externC int flash_hwr_map_error(int err); | |
| 142 externC void flash_dev_query(void *data); | |
| 1745 | 143 #endif // CYGHWR_IO_FLASH_DEVICE_LEGACY |
| 1706 | 144 // |
| 145 // Some FLASH devices may require additional support, e.g. to turn on | |
| 146 // appropriate voltage drivers, before any operation. | |
| 147 // | |
| 148 #ifdef CYGIMP_FLASH_ENABLE | |
| 149 #define FLASH_Enable CYGIMP_FLASH_ENABLE | |
| 150 extern void CYGIMP_FLASH_ENABLE(void *, void *); | |
| 151 #else | |
| 152 #define FLASH_Enable(_start_, _end_) | |
| 153 #endif | |
| 154 #ifdef CYGIMP_FLASH_DISABLE | |
| 155 #define FLASH_Disable CYGIMP_FLASH_DISABLE | |
| 156 extern void CYGIMP_FLASH_DISABLE(void *, void *); | |
| 157 #else | |
| 158 #define FLASH_Disable(_start_, _end_) | |
| 159 #endif | |
| 160 | |
| 161 // | |
| 162 // Some platforms have a DIP switch or jumper that tells the software that | |
| 163 // the flash is write protected. | |
| 164 // | |
| 165 #ifdef CYGSEM_IO_FLASH_SOFT_WRITE_PROTECT | |
| 166 externC cyg_bool plf_flash_query_soft_wp(void *addr, int len); | |
| 167 #endif | |
| 168 | |
| 169 //--------------------------------------------------------------------------- | |
| 170 // Execution of flash code must be done inside a | |
| 171 // HAL_FLASH_CACHES_OFF/HAL_FLASH_CACHES_ON region - disabling the | |
| 172 // cache on unified cache systems is necessary to prevent burst access | |
| 173 // to the flash area being programmed. With Harvard style caches, only | |
| 174 // the data cache needs to be disabled, but the instruction cache is | |
| 175 // disabled for consistency. | |
| 176 | |
| 177 // Targets may provide alternative implementations for these macros in | |
| 178 // the hal_cache.h (or var/plf) files. | |
| 179 | |
| 180 // The first part below is a generic, optimal implementation. The | |
| 181 // second part is the old implementation that has been tested to work | |
| 182 // on some targets - but it is not be suitable for targets that would | |
| 183 // do burst access to the flash (it does not disable the data cache). | |
| 184 | |
| 185 // Both implementations must be called with interrupts disabled. | |
| 186 | |
| 187 // NOTE: Do _not_ change any of the below macros without checking that | |
| 188 // the changed code still works on _all_ platforms that rely on these | |
| 189 // macros. There is no such thing as logical and correct when dealing | |
| 190 // with different cache and IO models, so _do not_ mess with this code | |
| 191 // unless you test it properly afterwards. | |
| 192 | |
| 193 #ifndef HAL_FLASH_CACHES_OFF | |
| 194 | |
| 195 // Some drivers have only been tested with the old macros below. | |
| 196 #ifndef HAL_FLASH_CACHES_OLD_MACROS | |
| 197 | |
| 198 #ifdef HAL_CACHE_UNIFIED | |
| 199 | |
| 200 // Note: the ucache code has not been tested yet on any target. | |
| 201 #define HAL_FLASH_CACHES_OFF(_d_, _i_) \ | |
| 202 CYG_MACRO_START \ | |
| 203 _i_ = 0; /* avoids warning */ \ | |
| 204 HAL_UCACHE_IS_ENABLED(_d_); \ | |
| 205 HAL_UCACHE_SYNC(); \ | |
| 206 HAL_UCACHE_INVALIDATE_ALL(); \ | |
| 207 HAL_UCACHE_DISABLE(); \ | |
| 208 CYG_MACRO_END | |
| 209 | |
| 210 #define HAL_FLASH_CACHES_ON(_d_, _i_) \ | |
| 211 CYG_MACRO_START \ | |
| 212 if (_d_) HAL_UCACHE_ENABLE(); \ | |
| 213 CYG_MACRO_END | |
| 214 | |
| 215 #else // HAL_CACHE_UNIFIED | |
| 216 | |
| 217 #define HAL_FLASH_CACHES_OFF(_d_, _i_) \ | |
| 218 CYG_MACRO_START \ | |
| 219 _i_ = 0; /* avoids warning */ \ | |
| 220 HAL_DCACHE_IS_ENABLED(_d_); \ | |
| 221 HAL_DCACHE_SYNC(); \ | |
| 222 HAL_DCACHE_INVALIDATE_ALL(); \ | |
| 223 HAL_DCACHE_DISABLE(); \ | |
| 224 HAL_ICACHE_INVALIDATE_ALL(); \ | |
| 225 CYG_MACRO_END | |
| 226 | |
| 227 #define HAL_FLASH_CACHES_ON(_d_, _i_) \ | |
| 228 CYG_MACRO_START \ | |
| 229 if (_d_) HAL_DCACHE_ENABLE(); \ | |
| 230 CYG_MACRO_END | |
| 231 | |
| 232 #endif // HAL_CACHE_UNIFIED | |
| 233 | |
| 234 #else // HAL_FLASH_CACHES_OLD_MACROS | |
| 235 | |
| 236 // Note: This implementation is broken as it will always enable the i-cache | |
| 237 // even if it was not enabled before. It also doesn't work if the | |
| 238 // target uses burst access to flash since the d-cache is left enabled. | |
| 239 // However, this does not mean you can change this code! Leave it as | |
| 240 // is - if you want a different implementation, provide it in the | |
| 241 // arch/var/platform cache header file. | |
| 242 | |
| 243 #define HAL_FLASH_CACHES_OFF(_d_, _i_) \ | |
| 244 _d_ = 0; /* avoids warning */ \ | |
| 245 _i_ = 0; /* avoids warning */ \ | |
| 246 HAL_DCACHE_SYNC(); \ | |
| 247 HAL_ICACHE_DISABLE(); | |
| 248 | |
| 249 #define HAL_FLASH_CACHES_ON(_d_, _i_) \ | |
| 250 HAL_ICACHE_ENABLE(); | |
| 251 | |
| 252 #endif // HAL_FLASH_CACHES_OLD_MACROS | |
| 253 | |
| 254 #endif // HAL_FLASH_CACHES_OFF | |
| 255 | |
| 256 #endif // _IO_FLASH_PRIV_H_ |