Microduck Robot●microduck-robot.com

ESP32 LEDC 3.x: Pins, Kanäle und Timer migrieren

Ersetzen Sie die entfernten Einrichtungsaufrufe und prüfen Sie Pin- und Kanalargumente, bevor Sie die Hardware ändern. Grundlage ist Arduino-ESP32 3.3.8. Getrennte Kanäle garantieren keine unabhängig änderbaren Frequenzen.

Beispiele: Arduino-ESP32 3.3.8 / ESP-IDF 5.5.4, Arduino CLI 1.6.0. Quellen geprüft am 2026-11-15.

Den tatsächlich verwendeten Core feststellen

Bei der Migration von 2.x auf 3.0 wurden ledcSetup und ledcAttachPin entfernt. Ein älterer Sketch kann deshalb schon vor der PWM-Ausgabe scheitern. Der Compilerfehler ist keine Diagnose des Servos oder seiner Versorgung.

Lesen Sie Boardpaket und Core-Version in der Build-Ausgabe nach. Bewahren Sie das bisherige Projekt samt Abhängigkeiten auf und prüfen Sie die Core-Unterstützung einer Fremdbibliothek. Dieses feste Beispiel garantiert keine allgemeine Bibliothekskompatibilität.

Die API nach ihrer Aufgabe umstellen

ledcAttach wählt den Kanal automatisch. Mit ledcAttachChannel geben Sie ihn ausdrücklich an. Beide melden, ob die Einrichtung gelungen ist. Bei einem bereits konfigurierten Kanal werden die neu übergebene Frequenz und Auflösung ignoriert.

Beim pinbasierten ledcWrite bedeutet 0 GPIO0 und nicht Kanal 0. Für GPIO18 übergeben Sie 18. Soll ein Kanal angesprochen werden, verwenden Sie ledcWriteChannel. Ein falsch verwendeter Ganzzahlparameter kann kompilieren; prüfen Sie deshalb auch den Rückgabewert.

Seitlich scrollen, um alle Spalten zu vergleichen.

AufgabeArduino-ESP32 2.xArduino-ESP32 3.3.8
Anschließen, Kanal automatischledcSetup(channel, Hz, bits) + ledcAttachPin(pin, channel)ledcAttach(pin, Hz, bits)
Anschließen, Kanal vorgegebenledcSetup(channel, Hz, bits) + ledcAttachPin(pin, channel)ledcAttachChannel(pin, Hz, bits, channel)
Tastwert schreibenledcWrite(channel, duty)ledcWrite(pin, duty) / ledcWriteChannel(channel, duty)

Ein festes Beispiel für den klassischen ESP32 kompilieren

Der vollständige Sketch gilt für das benannte klassische ESP32-Profil: GPIO18, Kanal 0, APB 80 MHz, 50 Hz, 14 Bit und eine angeforderte Pulsbreite von 1500 µs. Er rundet den Tastwert und prüft Einrichtung und Schreibvorgang. Andere Core- oder Chipziele werden abgewiesen.

Vollständiger klassischer ESP32-Sketch · 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() {}

Speichern Sie ihn als ledc_migration/ledc_migration.ino und kompilieren Sie mit den passenden festgelegten Werkzeugen. Die Pulsbreite ist kein für jeden Servo kalibrierter Mittelpunkt oder Endanschlag. S3/C3-Projekte benötigen ihr eigenes Planerprofil und eine externe Kompilierung.

Extern kompilieren · 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

Frequenz und Auflösung gemeinsam prüfen

Bei festem Takt bestimmen Frequenz und Bittiefe gemeinsam den Teiler. Bei niedrigen Frequenzen erhöht eine geringere Bittiefe den nötigen Teiler, der dadurch außerhalb des Treiberbereichs liegen kann. Weniger Bits sind daher nicht immer die Lösung. Die Tabelle verwendet die festen Profiltakte dieser Website.

Bei 50 Hz und 14 Bit beträgt ein nomineller Tastschritt etwa 1.2207 µs.1500 µs werden auf 1229 Schritte gerundet, entsprechend etwa 1500.2441 µs. Das sind Berechnungen mit dem festgelegten Teilermodell, keine Oszilloskopmessung und keine Zusage zum realen Servowinkel.

Seitlich scrollen, um alle Spalten zu vergleichen.

Festgelegter Profiltakt50 Hz · 8 bit50 Hz · 14 bit
ESP32 · APB 80 MHzD = 6250 · außerhalb des BereichsD = 97.65625 · möglich
ESP32-S3 / C3 · XTAL 40 MHzD = 3125 · außerhalb des BereichsD = 48.828125 · möglich

Pins, Kanäle und gemeinsame Timer unterscheiden

Der Kanal besitzt den Tastwert; der Timer liefert Frequenz und Auflösung. Die festgelegte Implementierung kann einen Timer bei übereinstimmenden Einstellungen wiederverwenden. Verschiedene Kanäle können daher unterschiedliche Tastwerte, aber dieselbe Zeitbasis haben.

Eine Frequenzänderung kann weitere Nutzer desselben Timers beeinflussen. Unterschiedliche Kanalnummern reichen nicht zur Trennung. Prüfen Sie Gruppe und Timer im Planer und belassen Sie dieses Beispiel bei fester Frequenz; ein Verfahren für unabhängiges dynamisches Umstellen wird nicht zugesagt.

Vom Symptom zur passenden Prüfung

Beginnen Sie beim ersten fehlgeschlagenen Schritt. Halten Sie Takt, Frequenz, Auflösung, Pin und Kanal im Bericht fest, damit die Konfiguration nachvollziehbar bleibt.

  1. ledcSetup/ledcAttachPin fehlt: installierten Core prüfen und die passende Migrationszeile verwenden.
  2. Einrichtung liefert false: tatsächlichen Boardpin, reservierte Peripheriepins sowie Frequenz und Auflösung prüfen.
  3. Sketch kompiliert, aber der Tastwert ändert sich nicht: Pin und Kanal unterscheiden und Schreibresultat prüfen.
  4. Zwei Frequenzen ändern sich gemeinsam: gemeinsame Timer prüfen; getrennte Kanäle beweisen keine Unabhängigkeit.

Fragen zur Migration

Warum ist ledcSetup nicht deklariert?

Der Aufruf gehört zur bei der Migration 2.x auf 3.0 entfernten API. Prüfen Sie den tatsächlichen Core und ersetzen Sie Einrichtung und Pinzuordnung durch die passende 3.3.8-API. Der Fehler allein bewertet keine Verkabelung.

Kann ledcWrite(0,duty) unverändert bleiben?

Nur wenn GPIO0 der beabsichtigte konfigurierte Pin ist. In 3.3.8 spricht ledcWrite einen Pin an. Für Kanal 0 verwenden Sie ledcWriteChannel(0,duty), für GPIO18 im Beispiel ledcWrite(18,duty).

Warum ändern verschiedene Kanäle gemeinsam die Frequenz?

Sie können denselben Timer verwenden. Der Tastwert gehört zum Kanal, Frequenz und Auflösung zum Timer. Die festgelegte Implementierung kann passende Timer wiederverwenden.

Läuft ein S3- oder C3-Projekt im klassischen Simulator?

Nein. Der Planer bietet die benannten S3/C3-Konfigurationen und den Projektexport. Der Firmware-Emulator führt nur klassischen ESP32-Code aus. Kompilieren Sie andere Ziele mit der passenden externen Werkzeugkette.

Projektquellen

Kontakt