Convert to new Doxygen style.
[bertos.git] / drv / eeprom.h
1 /**
2  * \file
3  * <!--
4  * Copyright 2003, 2004 Develer S.r.l. (http://www.develer.com/)
5  * This file is part of DevLib - See README.devlib for information.
6  * -->
7  *
8  * \version $Id$
9  *
10  * \author Stefano Fedrigo <aleph@develer.com>
11  * \author Bernardo Innocenti <bernie@develer.com>
12  *
13  * \brief Driver for the 24xx16 and 24xx256 I2C EEPROMS (interface)
14  */
15
16 /*#*
17  *#* $Log$
18  *#* Revision 1.9  2006/07/19 12:56:25  bernie
19  *#* Convert to new Doxygen style.
20  *#*
21  *#* Revision 1.8  2005/11/27 23:33:40  bernie
22  *#* Use appconfig.h instead of cfg/config.h.
23  *#*
24  *#* Revision 1.7  2005/11/04 16:20:02  bernie
25  *#* Fix reference to README.devlib in header.
26  *#*
27  *#* Revision 1.6  2005/04/11 19:10:27  bernie
28  *#* Include top-level headers from cfg/ subdir.
29  *#*
30  *#* Revision 1.5  2004/11/02 17:50:02  bernie
31  *#* CONFIG_EEPROM_VERIFY: New config option.
32  *#*
33  *#* Revision 1.4  2004/08/25 14:12:08  rasky
34  *#* Aggiornato il comment block dei log RCS
35  *#*
36  *#* Revision 1.3  2004/08/10 06:57:22  bernie
37  *#* eeprom_erase(): New function.
38  *#*
39  *#* Revision 1.2  2004/07/29 22:57:09  bernie
40  *#* Add 24LC16 support.
41  *#*
42  *#* Revision 1.1  2004/07/20 17:11:18  bernie
43  *#* Import into DevLib.
44  *#*
45  *#*/
46 #ifndef DRV_EEPROM_H
47 #define DRV_EEPROM_H
48
49 #include <cfg/compiler.h>
50 #include <appconfig.h>
51
52 /**
53  * \name Values for CONFIG_EEPROM_TYPE
54  * \{
55  */
56 #define EEPROM_24XX16 1
57 #define EEPROM_24XX256 2
58 /*\}*/
59
60 #if CONFIG_EEPROM_TYPE == EEPROM_24XX16
61         #define EEPROM_BLKSIZE   0x10 ///< Eeprom block size (16byte)
62         #define EEPROM_SIZE     0x800 ///< Eeprom total size (2kB)
63 #elif CONFIG_EEPROM_TYPE == EEPROM_24XX256
64         #define EEPROM_BLKSIZE   0x40 ///< Eeprom block size (64byte)
65         #define EEPROM_SIZE    0x8000 ///< Eeprom total size (32kB)
66 #else
67         #error Unsupported EEPROM type.
68 #endif
69
70 /// Type for EEPROM addresses
71 typedef uint16_t e2addr_t;
72
73 bool eeprom_write(e2addr_t addr, const void *buf, size_t count);
74 bool eeprom_read(e2addr_t addr, void *buf, size_t count);
75 bool eeprom_write_char(e2addr_t addr, char c);
76 int eeprom_read_char(e2addr_t addr);
77 void eeprom_erase(e2addr_t addr, size_t count);
78 void eeprom_init(void);
79 void eeprom_test(void);
80
81 #endif /* DRV_EEPROM_H */