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.
| Aufgabe | Arduino-ESP32 2.x | Arduino-ESP32 3.3.8 |
|---|---|---|
| Anschließen, Kanal automatisch | ledcSetup(channel, Hz, bits) + ledcAttachPin(pin, channel) | ledcAttach(pin, Hz, bits) |
| Anschließen, Kanal vorgegeben | ledcSetup(channel, Hz, bits) + ledcAttachPin(pin, channel) | ledcAttachChannel(pin, Hz, bits, channel) |
| Tastwert schreiben | ledcWrite(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.
#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.
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 Profiltakt | 50 Hz · 8 bit | 50 Hz · 14 bit |
|---|---|---|
| ESP32 · APB 80 MHz | D = 6250 · außerhalb des Bereichs | D = 97.65625 · möglich |
| ESP32-S3 / C3 · XTAL 40 MHz | D = 3125 · außerhalb des Bereichs | D = 48.828125 · möglich |
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.
- ledcSetup/ledcAttachPin fehlt: installierten Core prüfen und die passende Migrationszeile verwenden.
- Einrichtung liefert false: tatsächlichen Boardpin, reservierte Peripheriepins sowie Frequenz und Auflösung prüfen.
- Sketch kompiliert, aber der Tastwert ändert sich nicht: Pin und Kanal unterscheiden und Schreibresultat prüfen.
- 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.