Merge branch 'x86/nuke386' of git://git.kernel.org/pub/scm/linux/kernel/git/tip/tip
[sfrench/cifs-2.6.git] / Documentation / devicetree / bindings / i2c / i2c-s3c2410.txt
1 * Samsung's I2C controller
2
3 The Samsung's I2C controller is used to interface with I2C devices.
4
5 Required properties:
6   - compatible: value should be either of the following.
7       (a) "samsung, s3c2410-i2c", for i2c compatible with s3c2410 i2c.
8       (b) "samsung, s3c2440-i2c", for i2c compatible with s3c2440 i2c.
9       (c) "samsung, s3c2440-hdmiphy-i2c", for s3c2440-like i2c used
10           inside HDMIPHY block found on several samsung SoCs
11   - reg: physical base address of the controller and length of memory mapped
12     region.
13   - interrupts: interrupt number to the cpu.
14   - samsung,i2c-sda-delay: Delay (in ns) applied to data line (SDA) edges.
15
16 Required for all cases except "samsung,s3c2440-hdmiphy-i2c":
17   - Samsung GPIO variant (deprecated):
18     - gpios: The order of the gpios should be the following: <SDA, SCL>.
19       The gpio specifier depends on the gpio controller. Required in all
20       cases except for "samsung,s3c2440-hdmiphy-i2c" whose input/output
21       lines are permanently wired to the respective clienta
22   - Pinctrl variant (preferred, if available):
23     - pinctrl-0: Pin control group to be used for this controller.
24     - pinctrl-names: Should contain only one value - "default".
25
26 Optional properties:
27   - samsung,i2c-slave-addr: Slave address in multi-master enviroment. If not
28     specified, default value is 0.
29   - samsung,i2c-max-bus-freq: Desired frequency in Hz of the bus. If not
30     specified, the default value in Hz is 100000.
31
32 Example:
33
34         i2c@13870000 {
35                 compatible = "samsung,s3c2440-i2c";
36                 reg = <0x13870000 0x100>;
37                 interrupts = <345>;
38                 samsung,i2c-sda-delay = <100>;
39                 samsung,i2c-max-bus-freq = <100000>;
40                 /* Samsung GPIO variant begins here */
41                 gpios = <&gpd1 2 0 /* SDA */
42                          &gpd1 3 0 /* SCL */>;
43                 /* Samsung GPIO variant ends here */
44                 /* Pinctrl variant begins here */
45                 pinctrl-0 = <&i2c3_bus>;
46                 pinctrl-names = "default";
47                 /* Pinctrl variant ends here */
48                 #address-cells = <1>;
49                 #size-cells = <0>;
50
51                 wm8994@1a {
52                         compatible = "wlf,wm8994";
53                         reg = <0x1a>;
54                 };
55         };