実際に使われているcoreを確認する
2.xから3.0への移行でledcSetupとledcAttachPinは削除されました。古い記事のスケッチはPWMを出す前にコンパイルで失敗する場合があります。このエラーでサーボや電源の故障は判定できません。
ビルドログでボードパッケージとcoreのバージョンを確認します。既存プロジェクトと依存関係を保存し、外部ライブラリが対応するcoreも調べてください。この固定例はすべての旧ライブラリの動作保証ではありません。
APIを目的別に置き換える
ledcAttachはチャンネルを自動選択します。明示的に指定する場合はledcAttachChannelを使います。どちらも設定結果を返します。設定済みチャンネルを使うと、新しく渡した周波数と分解能は無視されます。
ピン指定のledcWriteで0はGPIO0を意味し、チャンネル0ではありません。GPIO18には18を渡します。チャンネルで指定したい場合はledcWriteChannelを使ってください。整数の役割が違ってもコンパイルできるため、戻り値も確認します。
横にスクロールしてすべての列を比較できます。
| 目的 | Arduino-ESP32 2.x | Arduino-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やチップ対象は拒否します。
#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 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 bit | 50 Hz · 14 bit |
|---|---|---|
| ESP32 · APB 80 MHz | D = 6250 · 範囲外 | D = 97.65625 · 設定可能 |
| ESP32-S3 / C3 · XTAL 40 MHz | D = 3125 · 範囲外 | D = 48.828125 · 設定可能 |
症状から次の確認先を選ぶ
最初に失敗した段階から確認します。クロック、周波数、分解能、ピン、チャンネルをレポートに残し、同じ条件を再現できるようにしてください。
- ledcSetup/ledcAttachPinが見つからない:coreを確認して対応表の置き換えを行います。
- 設定がfalse:実際のピン、周辺機能の予約、周波数と分解能を確認します。
- コンパイルできてもデューティが変わらない:ピンとチャンネルを区別し、書き込み結果を確認します。
- 複数の周波数が一緒に変わる:共有タイマーを確認します。別チャンネルだけでは独立しません。
移行時の疑問
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だけを実行します。対応する外部ツールでコンパイルしてください。