Files
ESPEasy/docs/source/Plugin/P123.rst
T

80 lines
2.9 KiB
ReStructuredText

.. include:: ../Plugin/_plugin_substitutions_p12x.repl
.. _P123_page:
|P123_typename|
==================================================
|P123_shortinfo|
Plugin details
--------------
Type: |P123_type|
Name: |P123_name|
Status: |P123_status|
GitHub: |P123_github|_
Maintainer: |P123_maintainer|
Used libraries: |P123_usedlibraries|
Supported hardware
------------------
Some displays are available with a touch overlay mounted on top of the visible side of the display. There's a choice of resistive and capacitive touch overlays. The FT62x6 series of touch overlays are of the Capacitive kind, being very easy to interact with, comparable to modern smartphones, where you can use a finger for the interaction. (Resistive touch overlays usually require a special pen to be used, or pressed with a finger-nail, to get a response.)
The FT62x6 touch overlay (or touch screen), can be found on several displays, f.e. some M5Stack devices and the WT32-SC01 display unit.
Device configuration
--------------------
.. image:: P123_DeviceConfiguration.png
* **Name**: Required by ESPEasy, must be unique among the list of available devices/tasks.
* **Enabled**: The device can be disabled or enabled. When not enabled the device should not use any resources.
I2C options
^^^^^^^^^^^
The available settings here depend on the build used. At least the **Force Slow I2C speed** option is available, but selections for the I2C Multiplexer can also be shown. For details see the :ref:`Hardware_page`
Device Settings
^^^^^^^^^^^^^^^
* **Display task**: Select the display task the touch screen is mounted on. By default, the current task is selected (and ignored), as any other guess would be wrong, and there is no 'None' selection available.
When choosing the correct task, the current display resolution, color depth and rotation settings are tried to be fetched from that task, and copied here in the matching settings. If no settings can be obtained, defaults will be applied.
The configured display will be used to draw the objects, if any, that can be configured below, on.
* **Screen Width (px) (x)**: Width of the display, the (horizontal) ``x`` coordinate, in pixels.
* **Screen Height (px) (y)**: Height of the display, the (vertical) ``y`` coordinate, in pixels. Top/Left coordinate is 0,0.
* **Rotation**: The rotation setting should match the rotation setting of the display, and can be selected as Normal (0), +90, +180 or +270 degrees.
* **Display Color-depth**: If the display settings have been retrieved successfully, this setting can not be changed, but will be used from the display. This value is used to select the correct color mappings for displaying the Objects.
* **Touch minimum pressure**: This setting determines the relative pressure or sensitivity of the touch display. Lower values make it more sensitive. The range is 0 to 255.
.. include:: Touch_Configuration.repl
Change log
----------
.. versionadded:: 2.0
...
|added|
Initial release version.