Merge tag 'armsoc-dt' of git://git.kernel.org/pub/scm/linux/kernel/git/soc/soc
[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,r1ex24016" - the fallback is "atmel,24c16"
54                 "renesas,r1ex24128" - the fallback is "atmel,24c128"
55                 "rohm,br24t01" - the fallback is "atmel,24c01"
56
57   - reg: The I2C address of the EEPROM.
58
59 Optional properties:
60
61   - pagesize: The length of the pagesize for writing. Please consult the
62               manual of your device, that value varies a lot. A wrong value
63               may result in data loss! If not specified, a safety value of
64               '1' is used which will be very slow.
65
66   - read-only: This parameterless property disables writes to the eeprom.
67
68   - size: Total eeprom size in bytes.
69
70   - no-read-rollover: This parameterless property indicates that the
71                       multi-address eeprom does not automatically roll over
72                       reads to the next slave address. Please consult the
73                       manual of your device.
74
75   - wp-gpios: GPIO to which the write-protect pin of the chip is connected.
76
77   - address-width: number of address bits (one of 8, 16).
78
79   - num-addresses: total number of i2c slave addresses this device takes
80
81 Example:
82
83 eeprom@52 {
84         compatible = "atmel,24c32";
85         reg = <0x52>;
86         pagesize = <32>;
87         wp-gpios = <&gpio1 3 0>;
88         num-addresses = <8>;
89 };