On Pin Pressed

Start an event handler (part of the program that will run when something happens, like when a button is pressed). This handler works when you touch pin 0, 1, or 2 together with GND, and release it within 1 second. When you are using this function in a web browser, click the pins on the screen instead of the ones on the micro:bit.

If you hold the GND pin with one hand and touch pin 0, 1, or 2 with the other, a very small (safe) amount of electricity will flow through your body and back into the micro:bit. This is called completing a circuit. It’s like you’re a big wire!

input.onPinPressed(TouchPin.P0, () => {
})

This function works best when the micro:bit is using batteries for power, instead of the USB cable.

Parameters

  • name means the pin that is being pressed, either P0, P1, or P2

Pin presses in action

See how the micro:bit detects a press at a pin or on something connected to a pin in this video:

Example: pin pressed counter

This program counts how many times you press the P0 pin. Every time you press the pin, the program shows the number of times on the screen.

let count = 0
basic.showNumber(count)
input.onPinPressed(TouchPin.P0, () => {
    count = count + 1
    basic.showNumber(count)
})

See also

micro:bit pins, pin is pressed, analog read pin, analog write pin, digital read pin, digital write pin