FreeEMS: flashWrite.h Source File

00001 /* FreeEMS - the open source engine management system
00002  *
00003  * Copyright 2008, 2009 Sean Keys
00004  *
00005  * This file is part of the FreeEMS project.
00006  *
00007  * FreeEMS software is free software: you can redistribute it and/or modify
00008  * it under the terms of the GNU General Public License as published by
00009  * the Free Software Foundation, either version 3 of the License, or
00010  * (at your option) any later version.
00011  *
00012  * FreeEMS software is distributed in the hope that it will be useful,
00013  * but WITHOUT ANY WARRANTY; without even the implied warranty of
00014  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
00015  * GNU General Public License for more details.
00016  *
00017  * You should have received a copy of the GNU General Public License
00018  * along with any FreeEMS software.  If not, see http://www.gnu.org/licenses/
00019  *
00020  * We ask that if you make any changes to this file you email them upstream to
00021  * us at admin(at)diyefi(dot)org or, even better, fork the code on github.com!
00022  *
00023  * Thank you for choosing FreeEMS to run your engine!
00024  */
00025 
00026 
00032 /* Header file multiple inclusion protection courtesy eclipse Header Template   */
00033 /* and http://gcc.gnu.org/onlinedocs/gcc-3.1.1/cpp/ C pre processor manual      */
00034 #ifndef FILE_FLASHWRITE_H_SEEN
00035 #define FILE_FLASHWRITE_H_SEEN
00036 
00037 
00038 #ifdef EXTERN
00039 #warning "EXTERN already defined by another header, please sort it out!"
00040 #undef EXTERN /* If fail on warning is off, remove the definition such that we can redefine correctly. */
00041 #endif
00042 
00043 
00044 #ifdef FLASHWRITE_C
00045 #define EXTERN
00046 #else
00047 #define EXTERN extern
00048 #endif
00049 
00050 
00052 #define MASS_ERASE      0x?? /* Used to erase 128k flash blocks */
00053 #define WORD_PROGRAM    0x20 /* Word = 2 bytes, this is the minimum write size, 64K of these per block, 512 per sector  */
00054 #define SECTOR_ERASE    0x40 /* Sector = 1024 bytes, there are 128 sectors to a block, and 4 blocks to the chip         */
00055 
00056 
00057 
00058 /* The following code must run from unpaged space for obvious reasons. Location explicitly set to text. */
00059 EXTERN unsigned short writeWord(unsigned short*, unsigned short) TEXT;
00060 EXTERN unsigned short eraseSector(unsigned char, unsigned short*) TEXT;
00061 EXTERN unsigned short writeSector(unsigned char, unsigned short*, unsigned char, unsigned short*) TEXT;
00062 EXTERN unsigned short writeBlock(blockDetails*, void*) TEXT;
00063 
00064 
00065 #undef EXTERN
00066 
00067 
00068 #else
00069     /* let us know ifunsigned short writeBlock(unsigned short* flashAddr, unsigned short* RAMAddr, unsigned short size){
00070      *  we are being untidy with headers */
00071     #warning "Header file FLASHWRITE_H seen before, sort it out!"
00072 /* end of the wrapper ifdef from the very top */
00073 #endif