Arduino Language Reference – digitalWrite()

原文:https://www.arduino.cc/reference/en/language/functions/digital-io/digitalwrite/

説明

HIGH または LOW 値をデジタル ピンに書き込みます。(Write a HIGH or a LOW value to a digital pin.)

ピンが pinMode() で OUTPUT として構成されている場合、その電圧は対応する値に設定されます: HIGH の場合は 5V (または 3.3V ボードでは 3.3V)、LOW の場合は 0V (グラウンド)です。(If the pin has been configured as an OUTPUT with pinMode(), its voltage will be set to the corresponding value: 5V (or 3.3V on 3.3V boards) for HIGH, 0V (ground) for LOW.)

ピンが INPUT として設定されている場合、digitalWrite() は入力ピンの内部プルアップを有効 (HIGH) または無効 (LOW) にします。内部プルアップ抵抗を有効にするには、pinMode() を INPUT_PULLUP に設定することをお勧めします。詳細については、Digital Pinsのチュートリアルを参照してください。(If the pin is configured as an INPUT, digitalWrite() will enable (HIGH) or disable (LOW) the internal pullup on the input pin. It is recommended to set the pinMode() to INPUT_PULLUP to enable the internal pull-up resistor. See the Digital Pins tutorial for more information.)

pinMode() を OUTPUT に設定せずLED をピンに接続すると、digitalWrite(HIGH) を呼び出すときにLED が暗く見えることがあります。 pinMode() を明示的に設定しないと、digitalWrite() は大きな電流制限抵抗のように機能する内部プルアップ抵抗が有効になります。(If you do not set the pinMode() to OUTPUT, and connect an LED to a pin, when calling digitalWrite(HIGH), the LED may appear dim. Without explicitly setting pinMode(), digitalWrite() will have enabled the internal pull-up resistor, which acts like a large current-limiting resistor.)

シンタックス

digitalWrite(pin, value)

パラメータ

pin: 値を出力したいArduinoのピン番号(the Arduino pin number)
value: HIGH または LOW.

戻り値

なし

サンプルコード

このコードはデジタル13番ピンをOUTPUTに設定し、1 秒間隔で HIGH と LOW を交互に切り替えます。(The code makes the digital pin 13 an OUTPUT and toggles it by alternating between HIGH and LOW at one second pace.)

void setup() {
    pinMode(13, OUTPUT);    // 13番ピンを出力として設定する。
}

void loop() {
    digitalWrite(13, HIGH); // 13番ピンをHIGH(ON)に設定する。
    delay(1000);            // 1000ms待つ。
    digitalWrite(13, LOW);  // 13番ピンをLOW(OFF)に設定する。
    delay(1000);            // 1000ms待つ。
}

注意事項

アナログ入力ピンは、A0、A1 などと呼ばれるデジタルピンとして使用できます。例外は、Arduino Nano、Pro Mini、および Mini の A6 および A7 ピンで、アナログ入力としてのみ使用できます。(The analog input pins can be used as digital pins, referred to as A0, A1, etc. The exception is the Arduino Nano, Pro Mini, and Mini’s A6 and A7 pins, which can only be used as analog inputs.)

補足情報:wokwiによるシミュレーション

wokwiによるシミュレーションは下記の通りです。画面右側の「Simulation」タブの再生ボタン(▶)を押すとシミュレーションが開始されます。

動きの説明:1秒毎に赤色LEDが光る・消えるを繰り返します。

https://wokwi.com/projects/345854233943212626

補足情報:GitHubリポジトリ

下記にソースコードを保存しています。

https://github.com/catalyst-yuki-k/Arduino_sample/blob/main/Language_Reference_Japanese/01.Functions/01.Digital_Input_Output/02.digitalWrite()/02.digitalWrite().ino