digitalRead()¶
Reads the value from a specified digital pin, either HIGH or LOW.
Library Documentation¶
Read a digital value from a pin.
The pin must have its mode set to one of INPUT, INPUT_PULLUP, and INPUT_PULLDOWN.
Parameters
- pin -
Pin to read from. One of: 0-38 (pin numbers as labeled on silkscreen), or D0-D38 (symbols for same)
- Return
- LOW or HIGH.
- See
- pinMode()
Example¶
The following example turns the LED on when the button is pressed:
int ledPin = 13; // LED connected to Maple pin 13
int buttonPin = 38; // BUT connected to Maple pin 38
void setup() {
pinMode(ledPin, OUTPUT);
pinMode(buttonPin, INPUT);
}
void loop() {
int val = digitalRead(buttonPin); // reads the input pin
digitalWrite(ledPin, val);
}
Note¶
If the pin isn’t connected to anything, digitalRead() can return either HIGH or LOW (and this can change in a way that seems random).
Arduino Compatibility¶
The Maple version of digitalRead() is compatible with Arduino.
See Also¶
License and Attribution
This documentation page was adapted from the Arduino Reference Documentation, which is released under a Creative Commons Attribution-ShareAlike 3.0 License.
