Orange Pi5 kernel

^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  1) EDT ft5x06 based Polytouch devices
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  2) ----------------------------------
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  3) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  4) The edt-ft5x06 driver is useful for the EDT "Polytouch" family of capacitive
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  5) touch screens. Note that it is *not* suitable for other devices based on the
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  6) focaltec ft5x06 devices, since they contain vendor-specific firmware. In
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  7) particular this driver is not suitable for the Nook tablet.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  8) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  9) It has been tested with the following devices:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 10)   * EP0350M06
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 11)   * EP0430M06
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 12)   * EP0570M06
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 13)   * EP0700M06
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 14) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 15) The driver allows configuration of the touch screen via a set of sysfs files:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 16) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 17) /sys/class/input/eventX/device/device/threshold:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 18)     allows setting the "click"-threshold in the range from 0 to 80.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 19) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 20) /sys/class/input/eventX/device/device/gain:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 21)     allows setting the sensitivity in the range from 0 to 31. Note that
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 22)     lower values indicate higher sensitivity.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 23) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 24) /sys/class/input/eventX/device/device/offset:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 25)     allows setting the edge compensation in the range from 0 to 31.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 26) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 27) /sys/class/input/eventX/device/device/report_rate:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 28)     allows setting the report rate in the range from 3 to 14.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 29) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 30) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 31) For debugging purposes the driver provides a few files in the debug
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 32) filesystem (if available in the kernel). In /sys/kernel/debug/edt_ft5x06
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 33) you'll find the following files:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 34) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 35) num_x, num_y:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 36)     (readonly) contains the number of sensor fields in X- and
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 37)     Y-direction.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 38) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 39) mode:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 40)     allows switching the sensor between "factory mode" and "operation
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 41)     mode" by writing "1" or "0" to it. In factory mode (1) it is
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 42)     possible to get the raw data from the sensor. Note that in factory
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 43)     mode regular events don't get delivered and the options described
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 44)     above are unavailable.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 45) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 46) raw_data:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 47)     contains num_x * num_y big endian 16 bit values describing the raw
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 48)     values for each sensor field. Note that each read() call on this
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 49)     files triggers a new readout. It is recommended to provide a buffer
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 50)     big enough to contain num_x * num_y * 2 bytes.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 51) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 52) Note that reading raw_data gives a I/O error when the device is not in factory
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 53) mode. The same happens when reading/writing to the parameter files when the
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 54) device is not in regular operation mode.