README
1These programs are used to read and write eeproms.
2
3Use eeprom for small eeproms with one-byte addresses:
4 24C01, 24C01A, 24C02, 24C04, 24C08, and 24C16
5 It works only on true i2c bus adapters.
6 See README.eeprom for details.
7 This program is deprecated, please use eeprog instead.
8
9Use eepromer for large eeproms with two-byte addresses:
10 24C32, 24C64, 24C128, 24C256, and 24C512
11 It works only on true i2c bus adapters.
12 See README.eepromer for details.
13 This program is deprecated, please use eeprog instead.
14
15Use eeprog for either small or large eeproms.
16 This program was moved to a separate subdirectory.
17 Use the -16 switch for large eeproms.
18 It works on both i2c and smbus bus adapters.
19 See README.eeprog for details.
20
21
22!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!! Warning !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
23!!! !
24!!! These programs should only be used on external busses such as i2c-pport !
25!!! unless you REALLY know what you are doing. !
26!!! !
27!!! Your computer probably contains eeproms for saving data vital to its !
28!!! operation. If you are not careful you might overwrite this data with !
29!!! this program and your computer may no longer boot! !
30!!! !
31!!! An example are the EEPROMS on your SDRAM DIMMs, your computer may no !
32!!! longer detect the RAM module rendering it essentially USELESS! !
33!!! !
34!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!! Warning !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
35
README.eeprom
1You can use this program to read/write to i2c-eeproms
2like the popular 24C16, 24C08, 24C04,.. In contrast to eeprommer
3which supports 24C256-type eeproms 24C16ss use 1-byte addresses!
4
5This program is deprecated, please use eeprog instead.
6
7!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!! Warning !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
8!!! !
9!!! This program should only be used on external busses such as i2c-pport. !
10!!! !
11!!! Your computer may contain i2c-eeproms for saving data vital to its !
12!!! operation. If you are not careful you might overwrite this data with !
13!!! this program and your computer may no longer boot! !
14!!! !
15!!! An example are the EEPROMS on your SDRAM DIMMs, your computer may no !
16!!! longer detect the RAM module rendering it essentially USELESS! !
17!!! !
18!!! IBM Thinkpads are said to store their configuration data in a eeprom, !
19!!! if you manage to overwrite this eeprom you will have to send your !
20!!! computer to the manufacturer for a costly repair! !
21!!! !
22!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!! Warning !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
23
24It has several options:
25
26 -d devicenode
27
28 set this to the device-node of the i2c-bus
29 you want to use like /dev/i2c-0.
30 Use /dev/i2c-1 for the second bus, i2c-2 for the third...
31
32 The default /dev/i2c-0 should work most of the time.
33
34 -a address
35
36 set this to the device-address of your
37 eeprom. For a 24C16 the address is hardcoded to
38 0x50, which is -you guessed it- the default.
39
40 For a 24C08 and smaller types you can choose which
41 addresses they occupy by forcing the address-pins
42 of the chip to High or Low so here the address may differ.
43
44 -p number_of_pages
45
46 set this to the number of pages you want to read
47 from or write to the eeprom. The 24C16 maps it's
48 pages to consecutive addresses on the i2c-bus so
49 we will try to read 256 bytes from every i2c
50 address between 'address' (inclusive) and
51 'address + number_of_pages' (exclusive)...
52
53 A 24C16 has 8 pages so that's the default for this
54 parameter.
55
56 -f filename
57
58 read data from this file (when writing to eeprom) or
59 write data to this file (when reading from eeprom).
60
61 When reading a file that's smaller than the
62 eeprom's storage size we will pad the eeprom
63 with zeroes.
64
65 If no file is given we will just read the
66 eeprom (while in read-mode) and test it's presence
67 this way. In write-mode we will just write zeroes
68 to the eeprom.
69
70 -w When '-w' is present we will *write* to the eeprom.
71 If you do not specify '-w' we will read the contents
72 of the eeprom.
73
74 -y This flag will suppress the warning when you write to the
75 eeprom. You will not be required to enter 'yes' so be careful
76 when using this switch!
77
78
79I wrote that program to clear a 24C16 eeprom that sit's in my crappy
80satellite receiver because sometimes its Z80 processor likes to
81write garbage to it and then crash....
82
83No further testing besides writing a long series of "The quick brown
84fox jumps over the lazy dog!" and reading it back has been done so
85of course this comes without any warranty.
86
87 Chris <chris@hedonism.cx>
88
README.eepromer
1Simple program for storing data to I2C EEPROM.
2
3This program is deprecated, please use eeprog instead.
4
5!!!!!!!!!!!!!!!!!!!!!!!!Warning!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
6
7The EEPROM must be a large EEPROM which uses a 2-byte address
8field (24C32 or larger). It will NOT WORK on small EEPROMs
9(24C01 - 24C16) such as those used on SDRAM DIMMs.
10
11Tested only on 24C256.
12
13!!!!!!!!!!!!!!!!!!!!!!!!Warning!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
14
15This program is intended for use on eeproms using external busses such as
16i2c-pport.
17Do not use this on your SDRAM DIMM EEPROMS, it won't work!!!!!!!!!
18Doing so will render your SDRAM USELESS and leave your system UNBOOTABLE!!!
19
20!!!!!!!!!!!!!!!!!!!!!!!!Warning!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
21
22Options:
23 -r read
24 -w write
25 -e erase
26 -p print "super block of EEPROM" (date and size stored data)
27
28Daniel Smolik
29marvin@sitour.cz
30