blob: bae8db9e794874af987978fc75723f4f8e14dcf6 (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
|
.. highlight:: cpp
.. _lang-digitalwrite:
digitalWrite()
==============
Write a :ref:`HIGH <lang-constants-high>` or a :ref:`LOW
<lang-constants-low>` value to a pin configured as :ref:`OUTPUT
<lang-constants-output>`.
Library Documentation
---------------------
.. doxygenfunction:: digitalWrite
Discussion
----------
If the pin has been configured as an ``OUTPUT`` with :ref:`pinMode()
<lang-pinmode>` its voltage will be set to the corresponding value:
3.3V for ``HIGH``, and 0V (ground) for ``LOW``.
Because it is soldered to an LED and resistor in series, your board's
:ref:`BOARD_LED_PIN <lang-board-values-led>` will respond slightly
more slowly as an output than the other pins.
Example
-------
The following example sets the built-in LED pin to ``HIGH``, makes a
one-second-long delay, sets the pin back to ``LOW``, and delays again,
causing a blinking pattern (you could also use
:ref:`lang-toggleled`)::
void setup() {
pinMode(BOARD_LED_PIN, OUTPUT); // sets the digital pin as output
}
void loop() {
digitalWrite(BOARD_LED_PIN, HIGH); // sets the LED on
delay(1000); // waits for a second
digitalWrite(BOARD_LED_PIN, LOW); // sets the LED off
delay(1000); // waits for a second
}
See Also
--------
- :ref:`pinMode <lang-pinmode>`
- :ref:`digitalRead <lang-digitalread>`
- :ref:`BOARD_LED_PIN <lang-board-values-led>`
- :ref:`lang-toggleled`
- :ref:`lang-togglepin`
.. include:: /arduino-cc-attribution.txt
|
