Merge git://git.kernel.org/pub/scm/linux/kernel/git/davem/ide
[sfrench/cifs-2.6.git] / Documentation / devicetree / bindings / eeprom / at24.txt
1 EEPROMs (I2C)
2
3 Required properties:
4
5   - compatible: Must be a "<manufacturer>,<model>" pair. The following <model>
6                 values are supported (assuming "atmel" as manufacturer):
7
8                 "atmel,24c00",
9                 "atmel,24c01",
10                 "atmel,24cs01",
11                 "atmel,24c02",
12                 "atmel,24cs02",
13                 "atmel,24mac402",
14                 "atmel,24mac602",
15                 "atmel,spd",
16                 "atmel,24c04",
17                 "atmel,24cs04",
18                 "atmel,24c08",
19                 "atmel,24cs08",
20                 "atmel,24c16",
21                 "atmel,24cs16",
22                 "atmel,24c32",
23                 "atmel,24cs32",
24                 "atmel,24c64",
25                 "atmel,24cs64",
26                 "atmel,24c128",
27                 "atmel,24c256",
28                 "atmel,24c512",
29                 "atmel,24c1024",
30                 "atmel,24c2048",
31
32                 If <manufacturer> is not "atmel", then a fallback must be used
33                 with the same <model> and "atmel" as manufacturer.
34
35                 Example:
36                         compatible = "microchip,24c128", "atmel,24c128";
37
38                 Supported manufacturers are:
39
40                 "catalyst",
41                 "microchip",
42                 "nxp",
43                 "ramtron",
44                 "renesas",
45                 "rohm",
46                 "st",
47
48                 Some vendors use different model names for chips which are just
49                 variants of the above. Known such exceptions are listed below:
50
51                 "nxp,se97b" - the fallback is "atmel,24c02",
52                 "renesas,r1ex24002" - the fallback is "atmel,24c02"
53                 "renesas,r1ex24128" - the fallback is "atmel,24c128"
54                 "rohm,br24t01" - the fallback is "atmel,24c01"
55
56   - reg: The I2C address of the EEPROM.
57
58 Optional properties:
59
60   - pagesize: The length of the pagesize for writing. Please consult the
61               manual of your device, that value varies a lot. A wrong value
62               may result in data loss! If not specified, a safety value of
63               '1' is used which will be very slow.
64
65   - read-only: This parameterless property disables writes to the eeprom.
66
67   - size: Total eeprom size in bytes.
68
69   - no-read-rollover: This parameterless property indicates that the
70                       multi-address eeprom does not automatically roll over
71                       reads to the next slave address. Please consult the
72                       manual of your device.
73
74   - wp-gpios: GPIO to which the write-protect pin of the chip is connected.
75
76   - address-width: number of address bits (one of 8, 16).
77
78   - num-addresses: total number of i2c slave addresses this device takes
79
80 Example:
81
82 eeprom@52 {
83         compatible = "atmel,24c32";
84         reg = <0x52>;
85         pagesize = <32>;
86         wp-gpios = <&gpio1 3 0>;
87         num-addresses = <8>;
88 };