xref: /freebsd/sys/contrib/device-tree/Bindings/input/rmi4/rmi_f01.txt (revision c66ec88fed842fbaad62c30d510644ceb7bd2d71)
1*c66ec88fSEmmanuel VadotSynaptics RMI4 F01 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 which contain Function 1. Complete documentation
6*c66ec88fSEmmanuel Vadotfor transports and other functions can be found in:
7*c66ec88fSEmmanuel VadotDocumentation/devicetree/bindings/input/rmi4.
8*c66ec88fSEmmanuel Vadot
9*c66ec88fSEmmanuel VadotAdditional documentation for F01 can be found at:
10*c66ec88fSEmmanuel Vadothttp://www.synaptics.com/sites/default/files/511-000136-01-Rev-E-RMI4-Interfacing-Guide.pdf
11*c66ec88fSEmmanuel Vadot
12*c66ec88fSEmmanuel VadotOptional Properties:
13*c66ec88fSEmmanuel Vadot- syna,nosleep-mode: If set the device will run at full power without sleeping.
14*c66ec88fSEmmanuel Vadot			nosleep has 3 modes, 0 will not change the default
15*c66ec88fSEmmanuel Vadot			setting, 1 will disable nosleep (allow sleeping),
16*c66ec88fSEmmanuel Vadot			and 2 will enable nosleep (disabling sleep).
17*c66ec88fSEmmanuel Vadot- syna,wakeup-threshold: Defines the amplitude of the disturbance to the
18*c66ec88fSEmmanuel Vadot				background capacitance that will cause the
19*c66ec88fSEmmanuel Vadot				device to wake from dozing.
20*c66ec88fSEmmanuel Vadot- syna,doze-holdoff-ms: The delay to wait after the last finger lift and the
21*c66ec88fSEmmanuel Vadot				first doze cycle.
22*c66ec88fSEmmanuel Vadot- syna,doze-interval-ms: The time period that the device sleeps between finger
23*c66ec88fSEmmanuel Vadot				activity.
24*c66ec88fSEmmanuel Vadot
25*c66ec88fSEmmanuel Vadot
26*c66ec88fSEmmanuel VadotExample of a RMI4 I2C device with F01:
27*c66ec88fSEmmanuel Vadot	Example:
28*c66ec88fSEmmanuel Vadot	&i2c1 {
29*c66ec88fSEmmanuel Vadot		rmi4-i2c-dev@2c {
30*c66ec88fSEmmanuel Vadot			compatible = "syna,rmi4-i2c";
31*c66ec88fSEmmanuel Vadot
32*c66ec88fSEmmanuel Vadot			...
33*c66ec88fSEmmanuel Vadot
34*c66ec88fSEmmanuel Vadot			rmi4-f01@1 {
35*c66ec88fSEmmanuel Vadot				reg = <0x1>;
36*c66ec88fSEmmanuel Vadot				syna,nosleep-mode = <1>;
37*c66ec88fSEmmanuel Vadot			};
38*c66ec88fSEmmanuel Vadot		};
39*c66ec88fSEmmanuel Vadot	};
40