digitalRead()

Contenido

1 Descripción
2 Sintaxis
3 Parámetros
4 Retorno
5 Comentarios
6 Advertencias
7 Ejemplo 1
8 Ejemplo 1a
9 Ejemplo 1b
10 Ejemplo 2
11 Ejemplo 3
12 Vease también
13 Referencias externas

Descripción

Lee el valor del pin digital dando un resultado. Los valores pueden ser HIGH / LOW.

Tip: Los pines tanto analógicos como digitales de entrada no necesitan ser definidos con pinMode().

Sintaxis

digitalRead(pin);

Parámetros

pin: es el numero del pin digital a usar (0~13 + 14~19). Puedes usar const byte para de definir el numero de pin.

Retorno

Devuelve el valor del pin: HIGH / LOW.

Comentarios

Tip: Este comando tarda 58 ciclos de CPU en salidas digitales sin PWM y 72 ciclos en salidas digitales con PWM.

Advertencias

En muchos ejemplo se ve que usan una variable de tipo int para definir el pin a usar. Esto es un grave error por dos motivos:

La variable sera almacenada en memoria SRAM porque se espera que su valor cambie durante la ejecución del boceto, pero normalmente en los pines esto nunca ocurre, por lo que es preferible usar const que es almacenada en flash.
El tipo int ocupa 2 byte. Es suficiente usar el tipo byte (0~255) que solo ocupa 1 byte.

Ejemplo 1

Cuando presionamos el pulsador el LED a bordo se prende, soltamos y se apaga. Poner un pulsador entre pin digital 3 y GND.

void setup(){
   pinMode(LED_BUILTIN, OUTPUT);
   pinMode(3, INPUT_PULLUP);
}
void loop(){
   if (digitalRead(3) == LOW){
       digitalWrite(LED_BUILTIN, HIGH);  //Prende LED
   }else{
       digitalWrite(LED_BUILTIN, LOW);   //Apaga LED
   }
}

Nota: digitalRead() retorna un verdadero mientas no estas pulsando el botón gracias a su configuración INPUT_PULLUP, asi que es exactamente lo mismo si pones !digitalRead(3) como condición. Ver Ejemplo 1a.

Ejemplo 1a

Cuando presionamos el pulsador el LED a bordo se prende, soltamos y se apaga. Poner un pulsador entre pin digital 3 y GND.

void setup(){
   pinMode(LED_BUILTIN, OUTPUT);
   pinMode(3, INPUT_PULLUP);
}
void loop(){
   if (!digitalRead(3)){
       digitalWrite(LED_BUILTIN, HIGH);  //Prende LED
   }else{
       digitalWrite(LED_BUILTIN, LOW);   //Apaga LED
   }
}

Ejemplo 1b

Cuando presionamos el pulsador el LED a bordo se prende, soltamos y se apaga. Poner un pulsador entre pin digital 3 y GND.

void setup(){
   pinMode(LED_BUILTIN, OUTPUT);
   pinMode(3, INPUT_PULLUP);
}
void loop(){
   if (!digitalRead(3)){
       digitalWrite(LED_BUILTIN, !digitalRead(LED_BUILTIN));  //Conmuta LED
   }
}

Ejemplo 2

Cuando presionamos una vez el pulsador el LED a bordo se prende. Pulsamos nuevamente y se apaga. Poner un pulsador entre pin digital 3 y GND.

bool valor,anterior;
void setup(){
   pinMode(LED_BUILTIN, OUTPUT);
   pinMode(3, INPUT_PULLUP);
}
void loop(){
   valor = digitalRead(3);
   if (!valor && anterior){
       digitalWrite(LED_BUILTIN, !digitalRead(LED_BUILTIN));  //Conmuta LED
   }
   anterior = valor;
}

Ejemplo 3

Cada vez que presionamos el pulsador cuenta una mas en binario. Poner un pulsador entre pin digital 2 y GND, mas 8 LED en pines 3 al 10 con su respectiva resistencia de 330 ohms.

bool valor,anterior;
byte n;
void setup(){
   pinMode(2, INPUT_PULLUP);
   for (byte i=3; i<11; i++){
      pinMode(i, OUTPUT);
   }
}
void loop(){
   valor = digitalRead(2);
   if (!valor && anterior){
      n++;
   }
   anterior = valor;
   for (byte i=3; i<11; i++){
      digitalWrite(i, bitRead(n, i-3));
   }
}