Microduck Robot●microduck-robot.com

ESP32 LEDC 3.x : migrer broches, canaux et timers

Remplacez les appels supprimés et vérifiez le rôle broche/canal de chaque argument avant de modifier le matériel. Le guide vise Arduino-ESP32 3.3.8. Des canaux distincts ne garantissent pas des changements de fréquence indépendants.

Exemples : Arduino-ESP32 3.3.8 / ESP-IDF 5.5.4, Arduino CLI 1.6.0. Sources vérifiées le 2026-11-15.

Identifier le core réellement utilisé

La migration de 2.x vers 3.0 a supprimé ledcSetup et ledcAttachPin. Un ancien sketch peut donc échouer avant toute sortie PWM. Ce message du compilateur ne diagnostique ni le servo ni son alimentation.

Lisez le paquet de carte et la version du core dans le journal de compilation. Conservez le projet et ses dépendances; vérifiez les versions admises par une bibliothèque tierce. Cet exemple ne garantit pas la compatibilité de toutes les anciennes bibliothèques.

Migrer selon la fonction de chaque appel

ledcAttach choisit automatiquement le canal. Utilisez ledcAttachChannel pour le fixer explicitement. Les deux indiquent si la configuration a réussi. Si le canal est déjà configuré, la nouvelle fréquence et la nouvelle résolution sont ignorées.

Dans ledcWrite adressé par broche, 0 désigne GPIO0 et non le canal 0. Pour GPIO18, passez 18; pour adresser volontairement un canal, utilisez ledcWriteChannel. Un entier employé au mauvais endroit peut compiler : vérifiez aussi le résultat.

Faites défiler horizontalement pour comparer toutes les colonnes.

FonctionArduino-ESP32 2.xArduino-ESP32 3.3.8
Associer, canal automatiqueledcSetup(channel, Hz, bits) + ledcAttachPin(pin, channel)ledcAttach(pin, Hz, bits)
Associer, canal expliciteledcSetup(channel, Hz, bits) + ledcAttachPin(pin, channel)ledcAttachChannel(pin, Hz, bits, channel)
Écrire le rapport cycliqueledcWrite(channel, duty)ledcWrite(pin, duty) / ledcWriteChannel(channel, duty)

Compiler un exemple fixé pour ESP32 classique

Le sketch complet cible le profil ESP32 classique nommé : GPIO18, canal 0, APB 80 MHz, 50 Hz, 14 bits et impulsion demandée de 1500 µs. Il arrondit le rapport cyclique et vérifie chaque opération. Un autre core ou une autre cible est refusé.

Sketch complet ESP32 classique · 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() {}

Enregistrez-le dans ledc_migration/ledc_migration.ino puis compilez avec les outils fixés. L’impulsion ne définit pas un neutre ni une course étalonnés pour tout servo. Les projets S3/C3 utilisent leur propre profil et une compilation externe.

Compilation externe · 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

Vérifier fréquence et résolution ensemble

À horloge fixe, fréquence et nombre de bits déterminent ensemble le diviseur. À basse fréquence, réduire les bits augmente le diviseur requis et peut dépasser sa plage. Moins de bits n’est donc pas toujours la solution. Le tableau utilise les horloges fixes des profils du site.

À 50 Hz et 14 bits, un pas nominal vaut environ 1.2207 µs. Une demande de 1500 µs est arrondie à 1229 pas, soit environ 1500.2441 µs. Ce sont des valeurs calculées avec le modèle de diviseur fixé, pas une mesure à l’oscilloscope ni une garantie d’angle réel.

Faites défiler horizontalement pour comparer toutes les colonnes.

Horloge fixée du profil50 Hz · 8 bit50 Hz · 14 bit
ESP32 · APB 80 MHzD = 6250 · hors plageD = 97.65625 · réalisable
ESP32-S3 / C3 · XTAL 40 MHzD = 3125 · hors plageD = 48.828125 · réalisable

Distinguer broches, canaux et temporisateurs

Le canal possède le rapport cyclique; le temporisateur fournit fréquence et résolution. L’implémentation fixée peut réutiliser un temporisateur lorsque les réglages concordent. Deux canaux peuvent donc avoir des rapports distincts avec la même base de temps.

Modifier la fréquence peut affecter les autres sorties du même temporisateur. Des numéros de canal différents ne prouvent pas leur indépendance. Consultez groupe et temporisateur dans le planificateur et gardez ici une fréquence fixe; aucun contournement de reconfiguration dynamique n’est promis.

Partir du symptôme pour choisir le contrôle

Commencez par la première étape en échec. Conservez horloge, fréquence, résolution, broche et canal dans le rapport pour rendre la configuration reproductible.

  1. ledcSetup/ledcAttachPin absent : vérifier le core puis appliquer la bonne ligne de migration.
  2. Configuration à false : vérifier la broche réelle, les réservations et le couple fréquence/résolution.
  3. Le code compile mais le rapport ne change pas : distinguer broche et canal, puis vérifier l’écriture.
  4. Deux fréquences changent ensemble : vérifier le temporisateur partagé; séparer les canaux ne suffit pas.

Questions sur la migration

Pourquoi ledcSetup n’est-il pas déclaré ?

Cet appel appartient à l’API supprimée lors du passage de 2.x à 3.0. Vérifiez le core réel, puis remplacez configuration et association par l’API 3.3.8 adaptée. Cette erreur ne valide pas le câblage.

Puis-je conserver ledcWrite(0,duty) ?

Seulement si GPIO0 est la broche configurée voulue. Dans 3.3.8, ledcWrite adresse une broche. Pour le canal 0, utilisez ledcWriteChannel(0,duty); pour GPIO18 de l’exemple,ledcWrite(18,duty).

Pourquoi des canaux distincts changent-ils ensemble de fréquence ?

Ils peuvent partager un temporisateur. Le rapport cyclique appartient au canal; fréquence et résolution appartiennent au temporisateur. L’implémentation fixée peut réutiliser les réglages communs.

Le simulateur classique exécute-t-il un projet S3 ou C3 ?

Non. Le planificateur configure et exporte les profils S3/C3 nommés, mais l’émulateur n’exécute que l’ESP32 classique. Compilez les autres cibles avec leur chaîne externe adaptée.

Sources du projet

Contact