タッチ周辺機器

Touch Peripheral

ESP32タッチパッド周辺機器を初期化し、タッチセンサーから情報を取得します。

Initialize ESP32 touchpad peripheral and retrieve information from the touch sensors.

アプリケーション例

Application Example

このAPIの実装は、get-started/play_mp3_controlの例で示されています。

Implementation of this API is demonstrated in get-started/play_mp3_control example.

APIリファレンス

API Reference

ヘッダーファイル

Header File

関数

Functions
esp_periph_handle_t periph_touch_init(periph_touch_cfg_t *config)

esp_peripheralsのタッチペリフェラルハンドルを作成します。

Create the touch peripheral handle for esp_peripherals.

Note
この関数によって作成されたハンドルは、esp_periph_destroyが呼び出されたときに自動的に破棄されます
The handle was created by this function automatically destroy when esp_periph_destroy is called
Return
espペリフェラルハンドル
The esp peripheral handle
Parameters
  • config: 構成
    config: The configuration

構造体

Structures
struct periph_touch_cfg_t

タッチ周辺機器の構成。

The Touch peripheral configuration.

Public Members

int touch_mask

このタッチ周辺機器に使用するタッチパッドマスク、例：TOUCH_PAD_SEL0 | TOUCH_PAD_SEL1

Touch pad mask using for this Touch peripheral, ex: TOUCH_PAD_SEL0 | TOUCH_PAD_SEL1
int tap_threshold_percent

タップしきい値パーセント、パーセント値が非タッチ値よりも小さい場合、タップイベントが決定されます

Tap threshold percent, Tap event will be determined if the percentage value is less than the non-touch value
int long_tap_time_ms

ミリ秒単位の長いタップ期間。デフォルトは2000ミリ秒です。TAPと時間がこの値より長く保持されると、PERIPH_TOUCH_LONG_TAPが発生します。

Long tap duration in milliseconds, default is 2000ms, PERIPH_TOUCH_LONG_TAP will be occurred if TAP and time hold longer than this value

列挙

Enumerations
enum esp_touch_pad_sel_t

タッチパッドの選択。

Touch pad selection.

Values:

TOUCH_PAD_SEL0 = BIT(0)
TOUCH_PAD_SEL1 = BIT(1)
TOUCH_PAD_SEL2 = BIT(2)
TOUCH_PAD_SEL3 = BIT(3)
TOUCH_PAD_SEL4 = BIT(4)
TOUCH_PAD_SEL5 = BIT(5)
TOUCH_PAD_SEL6 = BIT(6)
TOUCH_PAD_SEL7 = BIT(7)
TOUCH_PAD_SEL8 = BIT(8)
TOUCH_PAD_SEL9 = BIT(9)
enum periph_touch_event_id_t

周辺タッチイベントID。

Peripheral touch event id.

Values:

PERIPH_TOUCH_UNCHANGE = 0

イベントなし

No event
PERIPH_TOUCH_TAP

タッチパッドをタップしたとき

When touch pad is tapped
PERIPH_TOUCH_RELEASE

タップ後にタッチパッドを離したとき

When touch pad is released after tap
PERIPH_TOUCH_LONG_TAP

long_tap_time_ms時間後にタッチパッドをタップして押したままにしたとき

When touch pad is tapped and held after long_tap_time_ms time
PERIPH_TOUCH_LONG_RELEASE

ロングタップ後にタッチパッドを離したとき

When touch pad is released after long tap