read_touch

Read smoothed capacitive touch sensor values from specified GPIO channels.

2.0k|410|Updated Apr 17, 2026
One-click install
npx skills add https://github.com/espressif/esp-claw --skill read-touch
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: read_touch
Source: https://github.com/espressif/esp-claw/tree/main/components/lua_modules/lua_driver_touch/skills/read_touch
Command: npx skills add https://github.com/espressif/esp-claw --skill read-touch

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

It turns raw capacitive touch sensor readings into stable, smoothed values you can reliably use for touch-driven device behavior.

Core Features & Use Cases

  • Smoothed Capacitive Touch Values: Reads smooth data from one or more touch-capable GPIO channels for stable detection.
  • Multi-GPIO Sampling: Samples several GPIOs in a single run so you can compare touch channels side-by-side.
  • Deterministic Error Reporting: Surfaces script errors directly to the user without retrying or silently changing GPIO assignments.
  • Use Case: Calibrate and monitor touch sensitivity across multiple electrodes to trigger events like toggles, gestures, or user confirmations without unstable jitter.

Quick Start

Ask the AI to read smoothed touch values using specific touch-capable GPIOs with a chosen sample count and interval.

Frequently Asked Questions about read_touch

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I get smoothed capacitive touch sensor readings from GPIO channels?

To get smoothed capacitive touch sensor readings, run the read_touch.lua script on user-specified GPIO channels. It applies sampling intervals to return stable smooth data for reliable touch detection without jitter.

Can I sample multiple touch electrodes at the same time?

Yes, you can sample multiple touch electrodes simultaneously. The script supports multi-GPIO sampling, allowing you to read smoothed capacitive touch values from several channels side-by-side in a single run.

How do I configure the sample count and interval for touch sensor data?

You configure touch sensor data sampling by providing explicit gpios plus optional samples and interval_ms parameters. These arguments define the repetition count and timing for reading smoothed capacitive values.

What happens if there is an error reading capacitive touch values from a GPIO?

If an error occurs while reading capacitive touch values, the script reports the error directly to the user. It does not retry the operation or silently change GPIO assignments, ensuring deterministic error reporting.

Do I need to map specific GPIOs to touch channels for IoT edge interactions?

Yes, you must specify touch-capable GPIOs for IoT edge interactions. The script maps your provided GPIOs to touch channels to sample electrodes and return smoothed values for triggering device logic.

Why are my raw capacitive touch sensor values unstable for device triggers?

Raw capacitive touch sensor values are often unstable for device triggers due to jitter. This script processes raw readings into stable smoothed values over repeated intervals to reliably handle toggles or gestures.