LibXR::ESP32PWM Class Reference

ESP32 PWM 驱动实现 / ESP32 PWM driver implementation. More...

#include <esp_pwm.hpp>

Inheritance diagram for LibXR::ESP32PWM:

Collaboration diagram for LibXR::ESP32PWM:

Public Member Functions
	ESP32PWM (int gpio_num, ledc_channel_t channel, ledc_timer_t timer=LEDC_TIMER_0, ledc_timer_bit_t resolution=static_cast< ledc_timer_bit_t >((static_cast< uint8_t >(LEDC_TIMER_BIT_MAX) - 1)))
	构造 PWM 通道对象 / Construct PWM channel object
ErrorCode	SetDutyCycle (float value) override
	Sets the duty cycle of the PWM signal. 设置 PWM 信号的占空比。
ErrorCode	SetConfig (Configuration config) override
	Configures the PWM settings. 配置 PWM 参数。
ErrorCode	Enable () override
	Enables the PWM output. 启用 PWM 输出。
ErrorCode	Disable () override
	Disables the PWM output. 禁用 PWM 输出。
Public Member Functions inherited from LibXR::PWM

Private Attributes
int	gpio_num_
ledc_channel_t	channel_
ledc_timer_t	timer_
ledc_timer_bit_t	resolution_
uint32_t	max_duty_

Detailed Description

ESP32 PWM 驱动实现 / ESP32 PWM driver implementation.

Definition at line 13 of file esp_pwm.hpp.

Constructor & Destructor Documentation

ESP32PWM()

LibXR::ESP32PWM::ESP32PWM ( int gpio_num, ledc_channel_t channel, ledc_timer_t timer = LEDC_TIMER_0, ledc_timer_bit_t resolution = static_cast<ledc_timer_bit_t>(               (static_cast<uint8_t>(LEDC_TIMER_BIT_MAX) - 1)) )

inline

构造 PWM 通道对象 / Construct PWM channel object

Parameters

gpio_num	GPIO 编号 / GPIO number
channel	LEDC 通道 / LEDC channel
timer	LEDC 定时器 / LEDC timer
resolution	占空比分辨率 / Duty resolution

Definition at line 24 of file esp_pwm.hpp.

      : gpio_num_(gpio_num),
        channel_(channel),
        timer_(timer),
        resolution_(resolution),
        max_duty_((1 << resolution) - 1)
  {
    ledc_channel_config_t channel_conf = {};
    channel_conf.gpio_num = gpio_num_;
    channel_conf.speed_mode = static_cast<ledc_mode_t>(0);
    channel_conf.channel = channel_;
    channel_conf.intr_type = LEDC_INTR_DISABLE;
    channel_conf.timer_sel = timer_;
    channel_conf.duty = 0;
    channel_conf.hpoint = 0;
 
    auto err = ledc_channel_config(&channel_conf);
    if (err != ESP_OK)
    {
      ASSERT(false);
    };
  }

Member Function Documentation

Disable()

ErrorCode LibXR::ESP32PWM::Disable ( )

inlineoverridevirtual

Disables the PWM output. 禁用 PWM 输出。

Returns

ErrorCode indicating success or failure. 返回操作结果的错误码。

Implements LibXR::PWM.

Definition at line 95 of file esp_pwm.hpp.

  {
    esp_err_t err = ledc_stop(static_cast<ledc_mode_t>(0), channel_, 0);
    return (err == ESP_OK) ? ErrorCode::OK : ErrorCode::FAILED;
  }

Enable()

ErrorCode LibXR::ESP32PWM::Enable ( )

inlineoverridevirtual

Enables the PWM output. 启用 PWM 输出。

Returns

ErrorCode indicating success or failure. 返回操作结果的错误码。

Implements LibXR::PWM.

Definition at line 89 of file esp_pwm.hpp.

  {
    esp_err_t err = ledc_update_duty(static_cast<ledc_mode_t>(0), channel_);
    return (err == ESP_OK) ? ErrorCode::OK : ErrorCode::FAILED;
  }

SetConfig()

ErrorCode LibXR::ESP32PWM::SetConfig ( Configuration config )

inlineoverridevirtual

Configures the PWM settings. 配置 PWM 参数。

Parameters

config

The configuration structure containing PWM settings. 配置结构体，包含 PWM 设置。

Returns

ErrorCode indicating success or failure. 返回操作结果的错误码。

Implements LibXR::PWM.

Definition at line 68 of file esp_pwm.hpp.

  {
    if (config.frequency == 0)
    {
      return ErrorCode::ARG_ERR;
    }
 
    ledc_timer_config_t timer_conf = {};
    timer_conf.speed_mode = static_cast<ledc_mode_t>(0);
    timer_conf.duty_resolution = resolution_;
    timer_conf.timer_num = timer_;
    timer_conf.freq_hz = config.frequency;
    timer_conf.clk_cfg = LEDC_AUTO_CLK;
 
    esp_err_t err = ledc_timer_config(&timer_conf);
    if (err != ESP_OK) return ErrorCode::INIT_ERR;
 
    max_duty_ = (1 << resolution_) - 1;
    return ErrorCode::OK;
  }

SetDutyCycle()

ErrorCode LibXR::ESP32PWM::SetDutyCycle ( float value )

inlineoverridevirtual

Sets the duty cycle of the PWM signal. 设置 PWM 信号的占空比。

Parameters

value

The duty cycle as a floating-point value (0.0 to 1.0). 占空比，浮点值（0.0 到 1.0）。

Returns

ErrorCode indicating success or failure. 返回操作结果的错误码。

Implements LibXR::PWM.

Definition at line 49 of file esp_pwm.hpp.

  {
    if (value < 0.0f)
    {
      value = 0.0f;
    }
    else if (value > 1.0f)
    {
      value = 1.0f;
    }
 
    uint32_t duty = static_cast<uint32_t>(max_duty_ * value);
    esp_err_t err = ledc_set_duty(static_cast<ledc_mode_t>(0), channel_, duty);
    if (err != ESP_OK) return ErrorCode::FAILED;
 
    err = ledc_update_duty(static_cast<ledc_mode_t>(0), channel_);
    return (err == ESP_OK) ? ErrorCode::OK : ErrorCode::FAILED;
  }

Field Documentation

channel_

ledc_channel_t LibXR::ESP32PWM::channel_

private

Definition at line 103 of file esp_pwm.hpp.

gpio_num_

int LibXR::ESP32PWM::gpio_num_

private

Definition at line 102 of file esp_pwm.hpp.

max_duty_

uint32_t LibXR::ESP32PWM::max_duty_

private

Definition at line 106 of file esp_pwm.hpp.

resolution_

ledc_timer_bit_t LibXR::ESP32PWM::resolution_

private

Definition at line 105 of file esp_pwm.hpp.

timer_

ledc_timer_t LibXR::ESP32PWM::timer_

private

Definition at line 104 of file esp_pwm.hpp.

---

The documentation for this class was generated from the following file:

• driver/esp/esp_pwm.hpp