36 lines
908 B
Markdown
36 lines
908 B
Markdown
# pulse Duration
|
|
|
|
Get the duration of the last pulse in microseconds.
|
|
|
|
```sig
|
|
pins.pulseDuration();
|
|
```
|
|
|
|
A pin pulse is detected in the [onPulsed](/reference/pins/on-pulsed) event. You use **pulseDuration** inside that event to get the duration of the pulse that triggered the event.
|
|
|
|
### ~ hint
|
|
|
|
**Simulator**: This function needs real hardware to work with. It's not supported in the simulator.
|
|
|
|
### ~
|
|
|
|
## Returns
|
|
|
|
* a [number](/types/number) that is the duration of the last pulse, measured in microseconds.
|
|
|
|
## Example
|
|
|
|
Wait for pin ``P0`` to be pulsed high. Display the duration of the pulse in microseconds on the LED screen.
|
|
|
|
```blocks
|
|
pins.onPulsed(DigitalPin.P0, PulseValue.High, () => {
|
|
basic.showNumber(pins.pulseDuration());
|
|
});
|
|
```
|
|
|
|
## See also
|
|
|
|
[servo set pulse](/reference/pins/servo-set-pulse),
|
|
[on pulsed](/reference/pins/on-pulsed),
|
|
[digital read pin](/reference/pins/digital-read-pin)
|