xref: /freebsd/sys/contrib/device-tree/Bindings/input/rmi4/rmi_i2c.txt (revision c66ec88fed842fbaad62c30d510644ceb7bd2d71)
1*c66ec88fSEmmanuel VadotSynaptics RMI4 I2C Device Binding
2*c66ec88fSEmmanuel Vadot
3*c66ec88fSEmmanuel VadotThe Synaptics RMI4 core is able to support RMI4 devices using different
4*c66ec88fSEmmanuel Vadottransports and different functions. This file describes the device tree
5*c66ec88fSEmmanuel Vadotbindings for devices using the I2C transport driver. Complete documentation
6*c66ec88fSEmmanuel Vadotfor other transports and functions can be found in
7*c66ec88fSEmmanuel VadotDocumentation/devicetree/bindings/input/rmi4.
8*c66ec88fSEmmanuel Vadot
9*c66ec88fSEmmanuel VadotRequired Properties:
10*c66ec88fSEmmanuel Vadot- compatible: syna,rmi4-i2c
11*c66ec88fSEmmanuel Vadot- reg: I2C address
12*c66ec88fSEmmanuel Vadot- #address-cells: Set to 1 to indicate that the function child nodes
13*c66ec88fSEmmanuel Vadot		    consist of only on uint32 value.
14*c66ec88fSEmmanuel Vadot- #size-cells: Set to 0 to indicate that the function child nodes do not
15*c66ec88fSEmmanuel Vadot		have a size property.
16*c66ec88fSEmmanuel Vadot
17*c66ec88fSEmmanuel VadotOptional Properties:
18*c66ec88fSEmmanuel Vadot- interrupts: interrupt which the rmi device is connected to.
19*c66ec88fSEmmanuel VadotSee Documentation/devicetree/bindings/interrupt-controller/interrupts.txt
20*c66ec88fSEmmanuel Vadot
21*c66ec88fSEmmanuel Vadot- syna,reset-delay-ms: The number of milliseconds to wait after resetting the
22*c66ec88fSEmmanuel Vadot			device.
23*c66ec88fSEmmanuel Vadot
24*c66ec88fSEmmanuel Vadot- syna,startup-delay-ms: The number of milliseconds to wait after powering on
25*c66ec88fSEmmanuel Vadot			 the device.
26*c66ec88fSEmmanuel Vadot
27*c66ec88fSEmmanuel Vadot- vdd-supply: VDD power supply.
28*c66ec88fSEmmanuel VadotSee ../regulator/regulator.txt
29*c66ec88fSEmmanuel Vadot
30*c66ec88fSEmmanuel Vadot- vio-supply: VIO power supply
31*c66ec88fSEmmanuel VadotSee ../regulator/regulator.txt
32*c66ec88fSEmmanuel Vadot
33*c66ec88fSEmmanuel VadotFunction Parameters:
34*c66ec88fSEmmanuel VadotParameters specific to RMI functions are contained in child nodes of the rmi device
35*c66ec88fSEmmanuel Vadot node. Documentation for the parameters of each function can be found in:
36*c66ec88fSEmmanuel VadotDocumentation/devicetree/bindings/input/rmi4/rmi_f*.txt.
37*c66ec88fSEmmanuel Vadot
38*c66ec88fSEmmanuel Vadot
39*c66ec88fSEmmanuel Vadot
40*c66ec88fSEmmanuel VadotExample:
41*c66ec88fSEmmanuel Vadot	&i2c1 {
42*c66ec88fSEmmanuel Vadot		rmi4-i2c-dev@2c {
43*c66ec88fSEmmanuel Vadot			compatible = "syna,rmi4-i2c";
44*c66ec88fSEmmanuel Vadot			reg = <0x2c>;
45*c66ec88fSEmmanuel Vadot			#address-cells = <1>;
46*c66ec88fSEmmanuel Vadot			#size-cells = <0>;
47*c66ec88fSEmmanuel Vadot			interrupt-parent = <&gpio>;
48*c66ec88fSEmmanuel Vadot			interrupts = <4 2>;
49*c66ec88fSEmmanuel Vadot
50*c66ec88fSEmmanuel Vadot			rmi4-f01@1 {
51*c66ec88fSEmmanuel Vadot				reg = <0x1>;
52*c66ec88fSEmmanuel Vadot				syna,nosleep-mode = <1>;
53*c66ec88fSEmmanuel Vadot			};
54*c66ec88fSEmmanuel Vadot
55*c66ec88fSEmmanuel Vadot			rmi4-f11@11 {
56*c66ec88fSEmmanuel Vadot				reg = <0x11>;
57*c66ec88fSEmmanuel Vadot				touchscreen-inverted-y;
58*c66ec88fSEmmanuel Vadot				syna,sensor-type = <2>;
59*c66ec88fSEmmanuel Vadot			};
60*c66ec88fSEmmanuel Vadot		};
61*c66ec88fSEmmanuel Vadot	};
62