Уточните, какой 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 бит и запрос импульса 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 бит номинальный шаг составляет около 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 не объявлен?
Это вызов API, удалённого при переходе 2.x→3.0. Уточните реальный core и замените настройку и подключение подходящим API 3.3.8. Ошибка сама по себе не проверяет проводку.
Можно оставить ledcWrite(0,duty)?
Только если нужен настроенный GPIO0. В 3.3.8 ledcWrite адресует вывод. Для канала 0 используйте ledcWriteChannel(0,duty), для GPIO18 из примера — ledcWrite(18,duty).
Почему разные каналы меняют частоту вместе?
Они могут использовать общий таймер. Заполнение относится к каналу, частота и разрешение — к таймеру. Закреплённая реализация повторно использует совпадающие настройки.
Запустит ли классический симулятор проект S3 или C3?
Нет. Планировщик поддерживает указанные конфигурации S3/C3 и экспорт проекта, но эмулятор исполняет только классический ESP32. Другие цели собирайте соответствующей внешней цепочкой.