Pulsein()

Lee un pulso (HIGH o LOW) de un pin determinado. Por ejemplo, si el valor especificado como parámetro es HIGH, pulseIn() espera a que el pin esté en HIGH, en ese momento comienza la cuenta (timing) hasta que la tensión en el pin esté en LOW momento en que cesa la cuenta. pulseIn() devuelve la duración del pulso en microsegundos. Asimismo, pulseIn() devuelve control con un 0 como retorno si el pulso no comienza dentro de un periodo especificado (time out).

Por ejemplo, sirve para detectar el cambio de estado en una señal por ultrasonidos, es decir, si se configura el pin del sensor de ultrasonidos a un valor alto (HIGH), devolverá el tiempo transcurrido entre el cambio de estado a ese valor. Previamente habrá que establecer el pin del triger en el sensor ultrasonidos a un valor bajo (LOW). De esta forma, sabiendo el tiempo transcurrido se puede calcular una distancia.

Sintaxis

pulseIn(pin, valor)
pulseIn(pin, valor, tiempo) 

Parámetros

• pin: es el número del pin del que se quiere leer la duración del pulso. Tipo: int
• valor: es el tipo de pulso que se quiere leer (HIGH o LOW). Tipo: int
• tiempo (opcional): es el número de microsegundos que se quiere esperar para que comience el pulso; por defecto es un segundo. Tipo: unsigned long