Re: [PATCH 05/10] Input: synaptics-rmi4: Add device tree support for 2d sensors and F11

From: Andrew Duggan
Date: Tue Dec 15 2015 - 17:22:07 EST

Hi Rob,

I'm taking a look at this patchset again and I had a couple follow up questions.

On 11/27/2015 01:10 PM, Rob Herring wrote:
On Wed, Nov 25, 2015 at 04:09:13PM -0800, Andrew Duggan wrote:
2D sensors have several parameter which can be set in the platform data.
This patch adds support for getting those values from devicetree.

Signed-off-by: Andrew Duggan <aduggan@xxxxxxxxxxxxx>
.../bindings/input/rmi4/rmi_2d_sensor.txt | 54 +++++++++++
drivers/input/rmi4/rmi_2d_sensor.c | 103 +++++++++++++++++++++
drivers/input/rmi4/rmi_2d_sensor.h | 3 +
drivers/input/rmi4/rmi_f11.c | 7 +-
4 files changed, 166 insertions(+), 1 deletion(-)
create mode 100644 Documentation/devicetree/bindings/input/rmi4/rmi_2d_sensor.txt

diff --git a/Documentation/devicetree/bindings/input/rmi4/rmi_2d_sensor.txt b/Documentation/devicetree/bindings/input/rmi4/rmi_2d_sensor.txt
new file mode 100644
index 0000000..bbff31b
--- /dev/null
+++ b/Documentation/devicetree/bindings/input/rmi4/rmi_2d_sensor.txt
@@ -0,0 +1,54 @@
+Synaptics RMI4 2D Sensor Device Binding
+The Synaptics RMI4 core is able to support RMI4 devices using differnet

Oops! That's a lot of typos. I'll make sure to run spell check next time.

+transports and differnet functions. This file describes the device tree

+bindings for devices which contain 2D sensors using Function 11 or
+Function 12. Complete documentation for transports and other functions
+can be found in:
+RMI4 Function 11 and Function 12 are for 2D touch position sensing.
+Additional documentation for F11 can be found at:
+Optional Properties:
+- syna,swap-axes: Swap X and Y positions when reporting (boolean).
+- syna,flip-x: Reverse the direction of X (boolean).
+- syna,flip-y: Reverse the direction of Y (boolean).
We already have similar, generic properties for these.

Are you referring to the generic properties documented here?

The rmi4 driver will be used for both touchpads and touchscreens so having a touchpad set a property like touchscreen-inverted-y could be confusing. It looks like there used to be more generic parameters which are now deprecated. Now the generic parameters are specific to touchscreens. Would it make sense to create touch-* parameters instead of touchscreen-*?


+- syna,clip-x-low: Sets a minimum value for X.
+- syna,clip-y-low: Sets a minimum value for Y.
+- syna,clip-x-high: Sets a maximum value for X.
+- syna,clip-y-high: Sets a maximum value for Y.
+- syna,offset-x: Add an offset to X.
+- syna,offset_y: Add an offset to Y.
Don't use "_".

+- syna,delta-x-threshold: Set the minimum distance on the X axis required
+ to generate an interrupt in reduced reporting
+ mode.
+- syna,delta-y-threshold: Set the minimum distance on the Y axis required
+ to generate an interrupt in reduced reporting
+ mode.
+- syna,type-a: Report type A multitouch events.
+- syna,sensor-type: Set the sensor type. 1 for touchscreen 2 for touchpad.
+- syna,x-mm: The length in millimeters of the X axis.
+- syna,y-mm: The length in millimeters of the Y axis.
I think some of these have common properties defined too. If not, we
should add them.

+- syna,disable-report-mask: Mask for disabling posiiton reporting. Used to
+ disable reporing absolute position data.
+- syna,rezero-wait: Time in miliseconds to wait after issuing a rezero
+ command.
Add -msec suffix.

To unsubscribe from this list: send the line "unsubscribe linux-kernel" in
the body of a message to majordomo@xxxxxxxxxxxxxxx
More majordomo info at
Please read the FAQ at