digitalWrite()

Описание

Записывает значение HIGH или LOW в цифровой пин.

Если пин был настроен как OUTPUT (выход) с помощью pinMode(), его напряжение будет установлено в соответствующее значение: 5 В (или 3,3 В на платах с 3,3 В) для HIGH и 0 В (земля) для LOW.

Если пин настроен как INPUT (вход), функция digitalWrite() включит (HIGH) или выключит (LOW) внутренний подтягивающий резистор на входном пине. Рекомендуется использовать pinMode() со значением INPUT_PULLUP для включения внутреннего подтягивающего резистора. Подробнее см. в руководстве Digital Pins.

Если вы не настроили пин как OUTPUT и подключили к нему светодиод, при вызове digitalWrite(pin, HIGH) светодиод может светиться тускло. Без явной установки pinMode(), функция digitalWrite() включит внутренний подтягивающий резистор, который работает как большой токоограничивающий резистор.

Синтаксис

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

digitalWrite(pin, value)

Параметры

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

pin: номер пина Arduino, которым нужно управлять.
value: HIGH или LOW.

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

Функция ничего не возвращает.

Пример кода

Установите цифровой пин 13 Arduino (встроенный светодиод) как OUTPUT и переключайте его между HIGH и LOW с интервалом в одну секунду.

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

void loop() {
  digitalWrite(13, HIGH); // включает цифровой пин 13
  delay(1000);            // ждёт одну секунду
  digitalWrite(13, LOW);  // выключает цифровой пин 13
  delay(1000);            // ждёт одну секунду
}

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

Примечание

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