diff --git a/Language/Functions/Advanced IO/pulseIn.adoc b/Language/Functions/Advanced IO/pulseIn.adoc index 97f44ed..ba89e67 100644 --- a/Language/Functions/Advanced IO/pulseIn.adoc +++ b/Language/Functions/Advanced IO/pulseIn.adoc @@ -1,7 +1,7 @@ --- title: pulseIn() categories: [ "Functions" ] -subCategories: [ "Advanced I/O" ] +subCategories: [ "Entradas e Saídas Avançadas" ] --- :source-highlighter: pygments @@ -17,29 +17,29 @@ subCategories: [ "Advanced I/O" ] -- [float] -=== Description -Reads a pulse (either HIGH or LOW) on a pin. For example, if *value* is *HIGH*, `pulseIn()` waits for the pin to go *HIGH*, starts timing, then waits for the pin to go *LOW* and stops timing. Returns the length of the pulse in microseconds. Gives up and returns 0 if no pulse starts within a specified time out. +=== Descrição +Captura a duração de um pulso em um pino (que pode ser HIGH ou LOW). Por exemplo, se o valor *HIGH* é passado para a função, a função `pulseIn()` espera o pino ir para o estado *HIGH*, começa a temporizar, então espera o pino ir para o estado *LOW* e para de temporizar. Retorna o tamanho do pulso em microssegundos. Desiste e retorna 0 se não receber nenhum pulso, caso um _timeout_ seja especificado. -The timing of this function has been determined empirically and will probably show errors in longer pulses. Works on pulses from 10 microseconds to 3 minutes in length. +A temporização dessa função foi determinada empiricamente e irá provavelmente mostrar erros em pulsos mais longos. funciona em pulsos de 10 microssegundos a 3 minutes de duração. [%hardbreaks] [float] -=== Syntax -`pulseIn(pin, value)` +=== Sintaxe +`pulseIn(pino, valor)` -`pulseIn(pin, value, timeout)` +`pulseIn(pino, valor, timeout)` [float] -=== Parameters -`pin`: the number of the pin on which you want to read the pulse. (int) +=== Parâmetros +`pino`: o número do pino no qual se quer capturar a duração de um pulso. (int) -`value`: type of pulse to read: either link:../../../variables/constants/constants/[HIGH] or link:../../../variables/constants/constants/[LOW]. (int) +`valor`: tipo de pulso a ser lido: pode ser link:../../../variables/constants/constants/[HIGH] ou link:../../../variables/constants/constants/[LOW]. (int) -`timeout` (optional): the number of microseconds to wait for the pulse to start; default is one second (unsigned long) +`timeout` (opcional): o numero de microssegundos a se esperar pelo começo do pulso; o padrão é um segundo (unsigned long) [float] -=== Returns -the length of the pulse (in microseconds) or 0 if no pulse started before the timeout (unsigned long) +=== Retorna +a duração do pulso (em microssegundos) ou 0 se nenhum pulso começar antes de se esgotar o timeout (unsigned long) -- // OVERVIEW SECTION ENDS @@ -52,23 +52,23 @@ the length of the pulse (in microseconds) or 0 if no pulse started before the ti -- [float] -=== Example Code +=== Código de Exemplo // Describe what the example code is all about and add relevant code ►►►►► THIS SECTION IS MANDATORY ◄◄◄◄◄ -The example calculated the time duration of a pulse on pin 7. +O exemplo abaixo calcula a duração de um pulso no pino 7. [source,arduino] ---- -int pin = 7; -unsigned long duration; +int pin = 7; //pino para a entrada do pulso +unsigned long duration; //variável para guardar a duração do pulso void setup() { - pinMode(pin, INPUT); + pinMode(pin, INPUT); // pino 7 como entrada } void loop() { - duration = pulseIn(pin, HIGH); + duration = pulseIn(pin, HIGH); //mede a duração de um pulso HIGH no pino 7 } ---- [%hardbreaks]