Merge tag 'for-linus' of git://github.com/openrisc/linux
[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
31                 If <manufacturer> is not "atmel", then a fallback must be used
32                 with the same <model> and "atmel" as manufacturer.
33
34                 Example:
35                         compatible = "microchip,24c128", "atmel,24c128";
36
37                 Supported manufacturers are:
38
39                 "catalyst",
40                 "microchip",
41                 "nxp",
42                 "ramtron",
43                 "renesas",
44                 "rohm",
45                 "st",
46
47                 Some vendors use different model names for chips which are just
48                 variants of the above. Known such exceptions are listed below:
49
50                 "nxp,se97b" - the fallback is "atmel,24c02",
51                 "renesas,r1ex24002" - the fallback is "atmel,24c02"
52                 "renesas,r1ex24128" - the fallback is "atmel,24c128"
53                 "rohm,br24t01" - the fallback is "atmel,24c01"
54
55   - reg: The I2C address of the EEPROM.
56
57 Optional properties:
58
59   - pagesize: The length of the pagesize for writing. Please consult the
60               manual of your device, that value varies a lot. A wrong value
61               may result in data loss! If not specified, a safety value of
62               '1' is used which will be very slow.
63
64   - read-only: This parameterless property disables writes to the eeprom.
65
66   - size: Total eeprom size in bytes.
67
68   - no-read-rollover: This parameterless property indicates that the
69                       multi-address eeprom does not automatically roll over
70                       reads to the next slave address. Please consult the
71                       manual of your device.
72
73   - wp-gpios: GPIO to which the write-protect pin of the chip is connected.
74
75   - address-width: number of address bits (one of 8, 16).
76
77 Example:
78
79 eeprom@52 {
80         compatible = "atmel,24c32";
81         reg = <0x52>;
82         pagesize = <32>;
83         wp-gpios = <&gpio1 3 0>;
84 };