Simple test

Ensure your device works with this simple test.

examples/touchpio_simpletest.py

# SPDX-FileCopyrightText: Copyright (c) 2023 Tod Kurt
#
# SPDX-License-Identifier: Unlicense
"""
touchpio_simpletest.py

touchpio test with a single pad. It works just like touchio.
"""

import board

import touchpio

touch = touchpio.TouchIn(board.GP2)
while True:
    if touch.value:
        print("touched!")

TouchInMulti simple test

Demo of TouchInMulti with 16 pads, calibration, and a bar-graph display of active pads.

examples/touchpio_mulit_simpletest.py

# SPDX-FileCopyrightText: Copyright (c) 2026 Tod Kurt
#
# SPDX-License-Identifier: Unlicense

"""
touchpio_multi_simpletest.py — Demo of touchpio_multi on a Raspberry Pi Pico

Wiring:
  GPIO 0–15  → touch pads (copper tape, PCB pads, etc.)
  Each pad  → 1MΩ resistor → GND
"""

import time

import board

import touchpio

touch = touchpio.TouchInMulti(
    first_pin=board.GP0,
    num_pins=16,
    # num_samples     = 250,
    touch_threshold=20,
    # thresholds      = range(0, 5001, 100),
    # thresholds      = range(0, 5001, 50),
    # thresholds      = range(0, 2000, 100),
    # thresholds      = range(100, 2001, 50),   # 40 levels
    # thresholds      = range(100, 2001, 100),   # 20 levels
    # touch_threshold = 1,                        # levels above baseline
)

print(f"Pull type: {touch.pull_type}")
print("Calibrating — don't touch the pads...")
time.sleep(1.0)
touch.calibrate(num_samples=20)
print("Baseline:", touch.baseline)
print()

print("Ready — touch the pads!")
while True:
    values = touch.read()
    active = touch.touched_pins()

    if active:
        bar = " ".join(f"[P{i}:{'█' * min(values[i], 15)}]" for i in active)
        print(bar)

    time.sleep(0.03)

TouchIn many pins

Demo of 8 individual TouchIn instances. Note this exhausts all PIO state machines; for single-pin use, touchio is preferred.

examples/touchpio_touchin_many.py

# SPDX-FileCopyrightText: Copyright (c) 2023 Tod Kurt
#
# SPDX-License-Identifier: Unlicense
"""
touchpio_touchin_many.py

touchpio test with 8 pads.
Note this uses up all PIO state machines, showing why TouchPIO for single
pins isn't that useful. Use `touchio` instead.
"""

import time

import board
import digitalio

import touchpio

pull_type = digitalio.Pull.UP
# pull_type = digitalio.Pull.DOWN

touch_pins = (board.GP0, board.GP1, board.GP2, board.GP3,
              board.GP4, board.GP5, board.GP6, board.GP7, )  # fmt: skip

touchins = []
for pin in touch_pins:
    touchin = touchpio.TouchIn(pin, pull_type=pull_type)
    touchins.append(touchin)

while True:
    print(" ".join(["%d" % t.value for t in touchins]))
    time.sleep(0.1)