В этом уроке мы научимся генерировать ШИМ-сигналы (широтно-импульсной модуляции, в англ. PWM - Pulse Width Modulation) с помощью платы ESP32, используя ESP-IDF. Мы рассмотрим, как генерировать ШИМ-сигналы с помощью аппаратного обеспечения LEDC на ESP32 и подключать эти сигналы к любому из выводов GPIO платы ESP. Для демонстрации мы будем управлять яркостью светодиода, изменяя коэффициент заполнения выходного сигнала с помощью потенциометра. С помощью потенциометра мы преобразуем значение АЦП в коэффициент заполнения ШИМ сигнала.
Прежде чем продолжить, убедитесь, что у вас установлена последняя версия VS Code и настроено расширение ESP-IDF:
- Установка ESP32 ESP-IDF на Windows и его интеграция с Visual Studio Code
- Установка ESP32 ESP-IDF на Linux Ubuntu
Также на нашем сайте вы можете прочитать статью про начало работы с ESP32 с использованием ESP-IDF.
Введение в ШИМ
Широтно-импульсная модуляция (ШИМ) — это сигнал, который обычно получают от аналоговых или цифровых микросхем, таких как платы ESP32. Это прямоугольный сигнал, который обеспечивает выходной сигнал, который может быть либо высоким, либо низким одновременно. При использовании источника питания 3,3 В сигналы ШИМ будут либо высокими (3,3 В), либо низкими (0 В). «Включение» сигнала — это время, в течение которого он находится в высоком состоянии, а «выключение» — это время, в течение которого он находится в низком состоянии. Для лучшего понимания принципов работы ШИМ на плате ESP32 необходимо ознакомиться со следующими двумя терминами, тесно связанными с цифровыми сигналами:
- коэффициент заполнения;
- частота.
Коэффициент заполнения
Коэффициент заполнения — это процент времени, в течение которого ШИМ-сигнал остается в высоком состоянии или «включен». Например, сигнал, который всегда выключен, имеет коэффициент заполнения 0%, тогда как сигнал, который постоянно включен, имеет коэффициент заполнения 100%. Уникальность этого фактора заключается в том, что пользователь может регулировать коэффициент заполнения для управления временем «включения». Для определения коэффициента заполнения используется формула:
Коэффициент заполнения = Время включения сигнала / Период времени сигнала
Частота
Частота ШИМ-сигнала — это количество циклов в секунду. Она также определяет, как быстро ШИМ-сигнал завершает один цикл, что называется периодом. Таким образом, для определения периода сигнала суммируются времена включения и выключения. Например, если период сигнала составляет 20 мс, то его частота будет равна 50 Гц. Следующие формулы показывают взаимосвязь между частотой и периодом:
Частота = 1 / Период времени
Период времени = Время включения + Время выключения
Контакты ШИМ ESP32
В ESP32 ШИМ-управление поддерживается только через все выходные контакты. Поэтому контроллер ШИМ для светодиодов ESP32 имеет 16 отдельных каналов, которые можно настроить для генерации ШИМ-сигналов.
| Контакты с поддержкой ШИМ | Все выходные контакты: GPIO0-GPIO5, GPIO12-GPIO33 |
Если вы используете Arduino IDE вместо ESP-IDF, вы можете обратиться к этой статье:
API ESP32 для использования ШИМ
Прежде чем двигаться дальше, давайте обсудим некоторые важные функции, необходимые для доступа к ШИМ-каналам ESP32.
ESP-IDF предоставляет библиотеку driver/ledc.h, необходимую для управления светодиодами с помощью ШИМ. Нам потребуется настроить таймер, конфигурацию каналов и изменить сигнал ШИМ. Давайте посмотрим, как это будет реализовано.
Первым шагом является подключение заголовочного файла:
|
1 |
#include "driver/ledc.h" |
Эта библиотека используется для управления яркостью светодиодов, а также для генерации ШИМ-сигналов. 16 каналов LEDC разделены на две группы по 8 каналов, которые генерируют отдельные формы сигналов. Из двух групп каналов LEDC одна работает в высокоскоростном режиме, а другая — в низкоскоростном. Более того, обе группы каналов могут работать с противоположными источниками тактовой частоты.
Теперь давайте посмотрим, как настроить канал LEDC в одном из двух режимов (высокоскоростной или низкоскоростной). Начнем с настройки таймера.
Настройка таймера ESP32
На этом этапе мы настраиваем таймер, определяя разрешение коэффициента заполнения ШИМ-сигнала, частоту, режим скорости, номер таймера и источник тактового сигнала. Для настройки таймера мы будем использовать функцию ledc_timer_config(). Эта функция принимает структуру данных ledc_timer_config_t. Внутри этой структуры данных мы определим следующие параметры:
- Режим скорости (ledc_mode_t);
- Частота ШИМ-сигнала;
- Разрешение рабочего цикла;
- Номер таймера (ledc_timer_t);
- Источник тактового сигнала (ledc_clk_cfg_t).
Примечание: разрешение по коэффициенту заполнения и частота тактового сигнала источника связаны с частотой ШИМ-сигнала. Разрешение по коэффициенту заполнения обратно пропорционально частоте ШИМ. Это означает, что чем выше частота ШИМ, тем ниже разрешение по коэффициенту заполнения, и наоборот. Аналогично, частота тактового сигнала источника прямо пропорциональна частоте ШИМ-сигнала. Это означает, что чем выше частота тактового сигнала источника, тем выше может быть установлена максимальная частота ШИМ, и наоборот.
В следующей функции ledc_timer_config() мы настраиваем таймер LEDC с заданными параметрами таймера/частоты (Гц)/разрешения заполнения. Она принимает в качестве параметра timer_conf, который является указателем на структуру конфигурации таймера LEDC.
|
1 |
ledc_timer_config(const ledc_timer_config_t *timer_conf) |
В таблице ниже представлены три различных источника тактовой частоты, которые можно настроить, с указанием соответствующей частоты и доступных режимов работы.
| Тип часов | Тактовая частота | Режим скорости |
| APB_CLK | 80 МГц | Высокий или низкий |
| REF_TICK | 1 МГц | Высокий или низкий |
| RTC8M_CLK | 8 МГц | Низкий |
Тактовый генератор REF_TICK способен к динамическому масштабированию частоты, тогда как тактовый генератор RTC8M_CLK способен как к динамическому масштабированию частоты, так и к режиму легкого сна.
Про использование таймеров в ESP32 с помощью Arduino IDE вы можете прочитать в этой статье.
Настройка ШИМ-канала ESP32
Далее, для установки канала мы воспользуемся функцией ledc_channel_config(). Эта функция принимает структуру ledc_channel_config_t, которая определяет параметры конфигурации канала. Это позволит генерировать ШИМ-сигнал на указанном выводе GPIO с частотой и разрешением коэффициента заполнения, уже заданными в конфигурации таймера. Если вы хотите остановить генерацию ШИМ-сигнала, вызовите функцию ledc_stop().
В следующей функции ledc_channel_config() мы настраиваем канал LEDC с заданными параметрами: номер канала/выхода gpio_num/прерывание/источник таймера/частота (Гц)/разрешение заполнения LEDC. Функция принимает в качестве параметра timer_conf - это указатель на структуру конфигурации таймера LEDC.
|
1 |
ledc_channel_config(const ledc_channel_config_t *ledc_conf) |
Настройка коэффициента заполнения ШИМ ESP32
Теперь давайте разберемся, как изменять ШИМ-сигнал. В случае светодиодов изменение ШИМ-сигнала означает изменение коэффициента заполнения, поэтому яркость светодиода изменяется соответствующим образом. Существует несколько различных способов изменения ШИМ-сигнала, включая программные и аппаратные. Мы сосредоточимся на API, которые будем использовать в нашем проекте.
Для установки коэффициента заполнения ШИМ-сигнала программным способом мы будем использовать функцию ledc_set_duty() . Она принимает три параметра. Первый параметр — это режим скорости. Второй параметр — это канал LEDC. Третий параметр — это коэффициент заполнения LEDC, который вы хотите установить. Диапазон этого коэффициента заполнения составляет [0, (2**duty_resolution) – 1]. Это означает, что если выбранное разрешение заполнения равно 10, то значения коэффициента заполнения могут варьироваться от 0 до 1023. Это обеспечивает разрешение приблизительно 0,1%.
|
1 |
ledc_set_duty(ledc_mode_t speed_mode, ledc_channel_t channel, uint32_t duty) |
Для запуска режима работы LEDC мы будем использовать функцию ledc_update_duty(). Она используется для обновления параметров канала LEDC. Функция принимает два параметра: первый — это режим скорости, а второй — канал LEDC.
|
1 |
ledc_update_duty(ledc_mode_t speed_mode, ledc_channel_t channel) |
Примечание: после вызова функции ledc_set_duty() необходимо вызвать функцию ledc_update_duty(), поскольку она отвечает за активацию установленных изменений режима работы LEDC.
Кроме того, функция ledc_get_duty() возвращает текущее значение коэффициента заполнения LEDC. Она также принимает два параметра: режим скорости и канал LEDC соответственно. Функция вернет значение коэффициента заполнения в текущем цикле ШИМ.
|
1 |
ledc_get_duty(ledc_mode_t speed_mode, ledc_channel_t channel) |
Существует еще несколько способов управления ШИМ в ESP32. Для получения более подробной информации обратитесь к официальному API Espressif ESP32 для управления светодиодами .
ШИМ-управление яркостью светодиода с помощью ESP32 ESP-IDF
Теперь давайте продемонстрируем проект в VS Code с расширением ESP-IDF, связанным с генерацией ШИМ-сигнала на ESP32. Мы настроим проект управления яркостью светодиода, где потенциометр, подключенный к ESP32, будет использоваться для изменения яркости светодиода. Мы подключим потенциометр к выводу АЦП ESP32. При вращении ручки потенциометра изменяющиеся значения АЦП будут использоваться для установки коэффициента заполнения светодиода, тем самым изменяя его яркость.
АЦП означает аналого-цифровое преобразование, при котором аналоговый сигнал преобразуется в цифровое значение с определенным разрешением. ESP32 имеет два 12-битных АЦП (АЦП 1 и АЦП 2) и поддерживает максимум 18 аналоговых каналов. Аналоговые значения в ESP32 считываются с помощью переменных напряжений в диапазоне от 0 до 3,3 В. Полученному напряжению затем присваивается значение от 0 до 4095 для 12-битного разрешения. Соответственно, значение 0 равно 0 В, а максимальное значение 4095 равно 3,3 В. Любые промежуточные значения также будут присваиваться соответствующим образом. При использовании АЦП с 10-битным разрешением значения АЦП будут находиться в диапазоне от 0 до 1023. Также на нашем сайте вы можете более подробно изучить вопросы использования АЦП в ESP32 с использованием ESP-IDF.
ШИМ (широтно-импульсная модуляция) — это модуляция ширины импульса, которую мы будем использовать для плавного изменения яркости светодиода. Хотя это и не настоящий цифро-аналоговый преобразователь (ЦАП), выходная мощность уменьшается на величину коэффициента заполнения (изменения коэффициента включения/выключения) при генерации высокочастотного цифрового сигнала. Это и приводит к плавному изменению яркости светодиода.
Управление яркостью светодиода с помощью ШИМ на ESP32
Для нашего проекта по ШИМ на основе платы ESP32 необходимы следующие компоненты:
- Плата ESP32.
- 5-мм светодиод.
- Токоограничивающий резистор 220 Ом.
- Макетная плата.
- Потенциометр.
- Соединительный провод.
На приведенной ниже схеме показана схема сборки для данного проекта.
Потенциометр питается от 3,3 В от ESP32. Его центральный вывод подключен к GPIO32, который обозначается как ADC1_CH4. Последний вывод подключен к контакту GND ESP32.
Мы использовали вывод GPIO27 для подключения к аноду светодиода через токоограничивающий резистор сопротивлением 220 Ом. Катод светодиода подключен к выводу GND микроконтроллера ESP32.
Вы можете использовать любой другой подходящий ШИМ-выход ESP32 для подключения к светодиоду, а также аналоговый вывод ESP32 для подключения к потенциометру.
Вот как выглядит наша схема после подключения всех компонентов.
Код управления яркостью светодиода с помощью ШИМ на EPS32
Откройте VS Code и создайте новый проект ESP-IDF. Теперь перейдите к файлу main.c. Здесь мы определим функции и программный код.
Мы будем использовать этот скрипт для управления яркостью светодиода, подключенного к GPIO27, путем усреднения необработанных значений АЦП, полученных с канала 4 АЦП1.
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 |
#include <stdio.h> #include <stdlib.h> #include "freertos/FreeRTOS.h" #include "freertos/task.h" #include "driver/adc.h" #include "driver/ledc.h" #define SAMPLE_CNT 32 static const adc1_channel_t adc_channel = ADC_CHANNEL_4; #define LEDC_GPIO 27 static ledc_channel_config_t ledc_channel; static void init_hw(void) { adc1_config_width(ADC_WIDTH_BIT_10); adc1_config_channel_atten(adc_channel, ADC_ATTEN_DB_11); ledc_timer_config_t ledc_timer = { .duty_resolution = LEDC_TIMER_10_BIT, .freq_hz = 1000, .speed_mode = LEDC_HIGH_SPEED_MODE, .timer_num = LEDC_TIMER_0, .clk_cfg = LEDC_AUTO_CLK, }; ledc_timer_config(&ledc_timer); ledc_channel.channel = LEDC_CHANNEL_0; ledc_channel.duty = 0; ledc_channel.gpio_num = LEDC_GPIO; ledc_channel.speed_mode = LEDC_HIGH_SPEED_MODE; ledc_channel.hpoint = 0; ledc_channel.timer_sel = LEDC_TIMER_0; ledc_channel_config(&ledc_channel); } void app_main() { init_hw(); while (1) { uint32_t adc_val = 0; for (int i = 0; i < SAMPLE_CNT; ++i) { adc_val += adc1_get_raw(adc_channel); } adc_val /= SAMPLE_CNT; ledc_set_duty(ledc_channel.speed_mode, ledc_channel.channel, adc_val); ledc_update_duty(ledc_channel.speed_mode, ledc_channel.channel); vTaskDelay(500 / portTICK_RATE_MS); } } |
Как работает код?
Для начала мы подключим необходимые библиотеки для этого проекта. Это включает в себя драйвер светодиода, драйвер АЦП, библиотеку калибровки АЦП и библиотеку FreeRTOS. Библиотеки driver/adc.h и esp_adc_cal.h необходимы для драйвера АЦП и калибровки АЦП соответственно. Библиотека driver/ledc.h необходима для ШИМ-управления светодиодом.
статья в разработке
Похожие статьи
(Проголосуй первым!)
Загрузка...