edt-ft5x06.rst 2.5 KB

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