digitalWrite()

名称

digitalWrite()

説明

デジタルピンにHIGHもしくはLOWの値を出力する。

ピンが、pinMode()によって、出力(OUTPUT)に設定されているとき、ピンの電圧が引数に応じた値に設定される。引数にHIGHを設定した場合は5V(3.3Vのボードの場合は、3.3V)、引数にLOWを指定した場合は、0V(接地)となる。

ピンが入力(INPUT)に設定されているときに、digitalWrite()によってHIGHを出力すると、内部のプルアップ抵抗が有効になる。また、LOWを出力すると、プルアップ抵抗が無効になる。ただし、内部のプルアップ抵抗を有効にするには、pinMode()でINPUT_PULLUPを設定することが推奨されている。デジタルピンのチュートリアルも参考にすること。

注意：pinMode()でピンをOUTPUTにせずにLEDをピンに接続し、digitalWrite(HIGH)を呼ぶと、LEDは暗く光る。pinMode()を明示的に呼ばなければ、digitalWrite()は内部のプルアップ抵抗が有効になり、電流制限抵抗のようにふるまう。

書式

void digitalWrite(uint8_t pin, uint8_t val);

引数

`pin`	設定するピンの番号。
`val`	HIGHもしくはLOW。

戻り値

なし。

使用例

デジタルピンの13番をOUTPUTにし、HIGHとLOWを1秒ごとに変更する。

 1
 2
 3
 4
 5
 6
 7
 8
 9
10


void setup() {
  pinMode(13, OUTPUT);    // sets the digital pin 13 as output
}

void loop() {
  digitalWrite(13, HIGH); // sets the digital pin 13 on
  delay(1000);            // waits for a second
  digitalWrite(13, LOW);  // sets the digital pin 13 off
  delay(1000);            // waits for a second
}