pxt-common-packages/libs/core/docs/reference/pins/on-pulsed.md

Microsoft MakeCode (PXT) common packages

# on Pulsed **deprecated**

### ~hint

Use [pins.onEvent](/reference/pins/on-event) instead.

### ~

Run some code when a pin is pulsed `high` (true) or `low` (false).

```sig
pins.A0.onPulsed(PulseValue.High, () => {})
```

A pulse is a change of voltage at the input of a digital pin. This might happen if a switch connected
to the pin is pressed or a sensor attached to the pin wants to give a signal. A pulse is an action of
changing voltage from high to low, or from low to high. The input to a pin is normally made to stay
at either a high or low voltage when it isn't pulsed (its _unsignalled state_). You can decide what
input value to keep the pin at is when it's not pulsed. You do this by giving it a _pull_ direction
with [``||pins:set pull||``](/reference/pins/set-pull).

Your code is inside an event block that starts when the input voltage at the pin changes. You give the
pulse direction  you want the code to run for. Make the value for **pulse** be `high` if you want
the code to start when the pin changes from a low voltage to a high voltage. Use `low` for **pulse** if
you want your code to run when the voltage at the pin goes from high to low.

## Parameters

* **pulse**: the pulse value to run code for.
* **body**: the code to run when the pin is pulsed.

## Example #example

When pin `D4` is pulsed `low`, run code that flashes an LED connected to pin `D13` .

```blocks
pins.D4.setPull(PinPullMode.PullUp)

pins.D4.onPulsed(PulseValue.Low, () => {
    pins.D13.digitalWrite(true)
    pause(250)
    pins.D13.digitalWrite(false)
})
```

## See also #seealso

[pulse in](/reference/pins/pulse-in), [set pull](/reference/pins/set-pull)