Microduck Robot●microduck-robot.com

ESP32 LEDC 3.x 移行:ピン・チャンネル・タイマー

削除された初期化APIを置き換え、各引数がピンかチャンネルかを確認してからハードウェアを変更します。本稿はArduino-ESP32 3.3.8が対象です。別チャンネルでも周波数変更が独立するとは限りません。

例の基準:Arduino-ESP32 3.3.8 / ESP-IDF 5.5.4、Arduino CLI 1.6.0。資料確認日:2026-11-15。

実際に使われているcoreを確認する

2.xから3.0への移行でledcSetupとledcAttachPinは削除されました。古い記事のスケッチはPWMを出す前にコンパイルで失敗する場合があります。このエラーでサーボや電源の故障は判定できません。

ビルドログでボードパッケージとcoreのバージョンを確認します。既存プロジェクトと依存関係を保存し、外部ライブラリが対応するcoreも調べてください。この固定例はすべての旧ライブラリの動作保証ではありません。

APIを目的別に置き換える

ledcAttachはチャンネルを自動選択します。明示的に指定する場合はledcAttachChannelを使います。どちらも設定結果を返します。設定済みチャンネルを使うと、新しく渡した周波数と分解能は無視されます。

ピン指定のledcWriteで0はGPIO0を意味し、チャンネル0ではありません。GPIO18には18を渡します。チャンネルで指定したい場合はledcWriteChannelを使ってください。整数の役割が違ってもコンパイルできるため、戻り値も確認します。

横にスクロールしてすべての列を比較できます。

目的Arduino-ESP32 2.xArduino-ESP32 3.3.8
接続・チャンネル自動ledcSetup(channel, Hz, bits) + ledcAttachPin(pin, channel)ledcAttach(pin, Hz, bits)
接続・チャンネル指定ledcSetup(channel, Hz, bits) + ledcAttachPin(pin, channel)ledcAttachChannel(pin, Hz, bits, channel)
デューティ書き込みledcWrite(channel, duty)ledcWrite(pin, duty) / ledcWriteChannel(channel, duty)

従来型ESP32向けの固定例をコンパイルする

完全なスケッチは指定した従来型ESP32プロファイル向けです。GPIO18、チャンネル0、APB 80 MHz、50 Hz、14 bit、要求パルス幅1500 µsを使います。デューティ値を丸め、設定と書き込みを確認します。異なるcoreやチップ対象は拒否します。

従来型ESP32の完全なスケッチ · Arduino-ESP32 3.3.8
#include <Arduino.h>
#include <esp_arduino_version.h>

#if ESP_ARDUINO_VERSION != ESP_ARDUINO_VERSION_VAL(3, 3, 8)
#error "Use Arduino-ESP32 3.3.8 for this example"
#endif
#if !CONFIG_IDF_TARGET_ESP32
#error "This example targets the classic ESP32 profile"
#endif

constexpr uint8_t SERVO_PIN = 18;
constexpr uint8_t SERVO_CHANNEL = 0;
constexpr uint32_t FREQ_HZ = 50;
constexpr uint8_t RES_BITS = 14;
constexpr uint32_t PULSE_US = 1500;
constexpr uint32_t DUTY =
    (uint64_t(PULSE_US) * FREQ_HZ * (1UL << RES_BITS) + 500000ULL)
    / 1000000ULL;

void setup() {
  Serial.begin(115200);
  bool ok = ledcSetClockSource(LEDC_USE_APB_CLK);
  if (ok) {
    ok = ledcAttachChannel(SERVO_PIN, FREQ_HZ, RES_BITS, SERVO_CHANNEL);
  }
  if (ok) {
    ok = ledcWrite(SERVO_PIN, DUTY);  // pin, not channel
  }
  Serial.println(ok ? "LEDC configured" : "LEDC setup failed");
}

void loop() {}

ledc_migration/ledc_migration.inoとして保存し、固定バージョンのツールでコンパイルします。このパルス幅は、すべてのサーボの校正済み中立点や可動限界ではありません。S3/C3は対応するプロファイルで外部コンパイルしてください。

外部コンパイル · Arduino CLI 1.6.0
arduino-cli version
arduino-cli core list
arduino-cli compile --fqbn "esp32:esp32:esp32:FlashMode=dio,FlashSize=4M,PartitionScheme=default" --export-binaries ./ledc_migration

周波数と分解能を組み合わせて確認する

クロック一定では、周波数とビット数の組み合わせで分周値が決まります。低周波数ではビット数を減らすと必要な分周値が増え、範囲外になる場合があります。ビット数を下げれば必ず直るわけではありません。表は本サイトの固定クロック条件です。

50 Hz・14 bitの公称デューティの一段階は約1.2207 µsです。1500 µsの要求は1229段階、約1500.2441 µsに丸められます。固定した分周モデルの計算値であり、オシロスコープ測定や実サーボ角度の保証ではありません。

横にスクロールしてすべての列を比較できます。

固定プロファイルのクロック50 Hz · 8 bit50 Hz · 14 bit
ESP32 · APB 80 MHzD = 6250 · 範囲外D = 97.65625 · 設定可能
ESP32-S3 / C3 · XTAL 40 MHzD = 3125 · 範囲外D = 48.828125 · 設定可能

ピン・チャンネル・共有タイマーを区別する

チャンネルがデューティを持ち、タイマーが周波数と分解能を決めます。固定版の実装は設定が一致するタイマーを再利用できます。チャンネルごとにデューティが違っても、時間基準は共通になり得ます。

周波数を変更すると、同じタイマーの他の出力に影響する場合があります。チャンネル番号を分けるだけでは独立性を証明できません。プランナーでグループとタイマーを確認し、この例は固定周波数で使います。動的変更の回避策は保証しません。

症状から次の確認先を選ぶ

最初に失敗した段階から確認します。クロック、周波数、分解能、ピン、チャンネルをレポートに残し、同じ条件を再現できるようにしてください。

  1. ledcSetup/ledcAttachPinが見つからない:coreを確認して対応表の置き換えを行います。
  2. 設定がfalse:実際のピン、周辺機能の予約、周波数と分解能を確認します。
  3. コンパイルできてもデューティが変わらない:ピンとチャンネルを区別し、書き込み結果を確認します。
  4. 複数の周波数が一緒に変わる:共有タイマーを確認します。別チャンネルだけでは独立しません。

移行時の疑問

ledcSetupが宣言されていないのはなぜですか?

2.xから3.0への移行で削除されたAPIだからです。実際のcoreを確認し、設定とピン接続を対応する3.3.8のAPIへ置き換えます。このエラーだけで配線は判断できません。

ledcWrite(0,duty)はそのまま使えますか?

設定済みGPIO0を操作したい場合に限ります。3.3.8のledcWriteはピン指定です。チャンネル0ならledcWriteChannel(0,duty)、例のGPIO18ならledcWrite(18,duty)を使います。

別チャンネルの周波数が一緒に変わるのはなぜですか?

同じタイマーを共有する場合があるためです。デューティはチャンネル、周波数と分解能はタイマーに属します。固定版の実装は一致する設定を再利用します。

S3やC3のプロジェクトを従来型シミュレーターで実行できますか?

できません。プランナーは指定したS3/C3の設定とプロジェクト出力に対応しますが、エミュレーターは従来型ESP32だけを実行します。対応する外部ツールでコンパイルしてください。

プロジェクトの参照元

お問い合わせ