digitalRead()

Описание

Считывает значение с указанного цифрового пина — либо HIGH, либо LOW.

Синтаксис

Используйте следующую функцию для чтения значения цифрового пина:

digitalRead(pin)

Параметры

Функция принимает следующий параметр:

pin: номер пина Arduino, который нужно прочитать.

Возвращаемое значение

Функция возвращает логическое состояние прочитанного пина — HIGH (высокий уровень) или LOW (низкий уровень).

Пример кода

Управляйте встроенным светодиодом Arduino на пине 13 (выход), присваивая ему то же значение, что и у кнопки, подключённой к пину 7 (вход).

int ledPin = 13;  // светодиод подключён к цифровому пину 13
int inPin = 7;    // кнопка подключена к цифровому пину 7
int val = 0;      // переменная для хранения прочитанного значения

void setup() {
  pinMode(ledPin, OUTPUT);  // задаёт цифровой пин 13 как выход
  pinMode(inPin, INPUT);    // задаёт цифровой пин 7 как вход
}

void loop() {
  val = digitalRead(inPin);   // считываем входной пин
  digitalWrite(ledPin, val);  // задаём светодиоду значение кнопки
}

Примечания и предупреждения

Предупреждение

Если пин ни к чему не подключён, digitalRead() может вернуть как HIGH, так и LOW (и это значение может меняться случайным образом).

Примечание

Аналоговые входные пины можно использовать как цифровые, обращаясь к ним как A0, A1 и т.д. Исключение — пины A6 и A7 на Arduino Nano, Arduino Pro Mini и Arduino Mini, которые могут использоваться только как аналоговые входы.