LEDCSoftwareFade

はじめに

ledcWrite()を使って、LEDを明るくしたり暗くしたりします。

プログラム

定義等

 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
/*
 LEDC Software Fade

 This example shows how to software fade LED
 using the ledcWrite function.

 Code adapted from original Arduino Fade example:
 https://www.arduino.cc/en/Tutorial/Fade

 This example code is in the public domain.
 */

// use first channel of 16 channels (started from zero)
#define LEDC_CHANNEL_0     0

// use 12 bit precission for LEDC timer
#define LEDC_TIMER_12_BIT  12

// use 5000 Hz as a LEDC base frequency
#define LEDC_BASE_FREQ     5000

// fade LED PIN (replace with LED_BUILTIN constant for built-in LED)
#define LED_PIN            5

int brightness = 0;    // how bright the LED is
int fadeAmount = 5;    // how many points to fade the LED by
 

ESP-WROOM-32では、機能を実現するチャネルと、そのチャネルをどのピンに割り当てるかを、ソフトウェアを使って設定することができます。データシートによると、LED PWMは16チャネルあるようです。ここでは、チャネル0を利用しています。このチャネル定義が、LED_CHANNEL_0です。

LEDC_TIMER_12_BITは、デューティ比を何ビットで表すかを定義しています。ここでは、12ビット(0~4095)で表すようにしています。

LEDC_BASE_FREQは、PWMのベース周波数を定義しています。5000Hzに設定しています。

LED_PINは、LEDを接続するピン番号です。

brightnessは、LEDの明るさを表すグローバル変数です。また、fadeAmountは、loop()が実行されるたびに、どれだけ明るさを変化させるかを定義しています。

ledcAnalogWrite

28
29
30
31
32
33
34
35
36
37
// Arduino like analogWrite
// value has to be between 0 and valueMax
void ledcAnalogWrite(uint8_t channel, uint32_t value, uint32_t valueMax = 255) {
  // calculate duty, 4095 from 2 ^ 13 - 1
  uint32_t duty = (4095 / valueMax) * min(value, valueMax);

  // write duty to LEDC
  ledcWrite(channel, duty);
}
 

現状、Arduino core for the ESP32には、analogWrite()は定義されていません。ここでは、analogWrite()のような関数を定義しています。

最初に、デューティ比を計算します。このスケッチでは、デューティ比は13ビットで定義しているので、入力されたデューティ比を13ビットの値に変換します。具体的には、0~valueMaxの値を、0~8191の値にマッピングしています。

その後、指定したchannelと、計算したdutyを使って、ledcWrite()を呼び出します。

setup()

38
39
40
41
42
43
void setup() {
  // Setup timer and attach timer to a led pin
  ledcSetup(LEDC_CHANNEL_0, LEDC_BASE_FREQ, LEDC_TIMER_12_BIT);
  ledcAttachPin(LED_PIN, LEDC_CHANNEL_0);
}
 

ledcSetup()を使って、LED PWMの設定を行います。

次に、ledcAttachPin()を使って、ピンとチャネルとを結びつけます。

loop()

44
45
46
47
48
49
50
51
52
53
54
55
56
57
void loop() {
  // set the brightness on LEDC channel 0
  ledcAnalogWrite(LEDC_CHANNEL_0, brightness);

  // change the brightness for next time through the loop:
  brightness = brightness + fadeAmount;

  // reverse the direction of the fading at the ends of the fade:
  if (brightness <= 0 || brightness >= 255) {
    fadeAmount = -fadeAmount;
  }
  // wait for 30 milliseconds to see the dimming effect
  delay(30);
}

先に定義したledcAnalogWrite()を使って、PWMを出力します。

brightnessの値を、fadeAmountだけ増加(fadeAmountが負の場合は結果として減少)させます。

brightnessが負、もしくは255以上になったら、fadeAmountの符号を反転させます。

結果として、brightnessは、0、5、10、…250、255、250、…10、5、0、5、10、…と変化していきます。

バージョン

Hardware:ESP-WROOM-32
Software:Arduino core for the ESP32 2.0.4

最終更新日

September 4, 2022

inserted by FC2 system