From cd5f8bcf74c36379c0883fc93dec4267f1951cd7 Mon Sep 17 00:00:00 2001 From: Krzysztof Budzynski Date: Wed, 10 Oct 2018 08:15:23 +0800 Subject: [PATCH] MCPWM API doc update --- components/driver/include/driver/mcpwm.h | 45 ++-- docs/_static/mcpwm-bldc-control.png | Bin 0 -> 46855 bytes docs/_static/mcpwm-block-diagram.png | Bin 0 -> 56162 bytes docs/_static/mcpwm-brushed-dc-control.png | Bin 0 -> 20746 bytes docs/_static/mcpwm-overview.png | Bin 0 -> 18209 bytes docs/en/api-reference/peripherals/mcpwm.rst | 199 ++++++++++++++---- .../mcpwm/mcpwm_brushed_dc_control/README.md | 4 +- 7 files changed, 184 insertions(+), 64 deletions(-) create mode 100644 docs/_static/mcpwm-bldc-control.png create mode 100644 docs/_static/mcpwm-block-diagram.png create mode 100644 docs/_static/mcpwm-brushed-dc-control.png create mode 100644 docs/_static/mcpwm-overview.png diff --git a/components/driver/include/driver/mcpwm.h b/components/driver/include/driver/mcpwm.h index d1c10e867..301ca4192 100644 --- a/components/driver/include/driver/mcpwm.h +++ b/components/driver/include/driver/mcpwm.h @@ -27,11 +27,12 @@ extern "C" { #endif /** - * @brief IO signals for MCPWM - * 6 MCPWM output pins that generate PWM signals - * 3 MCPWM fault input pins to detect faults like overcurrent, overvoltage, etc - * 3 MCPWM sync input pins to synchronize MCPWM outputs signals - * 3 MCPWM capture input pin to capture hall sell signal to measure time + * @brief IO signals for the MCPWM + * + * - 6 MCPWM output pins that generate PWM signals + * - 3 MCPWM fault input pins to detect faults like overcurrent, overvoltage, etc. + * - 3 MCPWM sync input pins to synchronize MCPWM outputs signals + * - 3 MCPWM capture input pins to gather feedback from controlled motors, using e.g. hall sensors */ typedef enum { MCPWM0A = 0, /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�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 Uq$QILybMW7TwbhP<{9 literal 0 HcmV?d00001 diff --git a/docs/_static/mcpwm-block-diagram.png b/docs/_static/mcpwm-block-diagram.png new file mode 100644 index 0000000000000000000000000000000000000000..97620c29da0b34496de769660834f53ae44ccd18 GIT binary patch literal 56162 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⪼a{_>Do;DOwc(-6^L%$NxfFtEzi;$h%~>)1 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�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 v$;qt)a)YO8f+rq8P8^hz5sgTe~DWM4f-)37I literal 0 HcmV?d00001 diff --git a/docs/en/api-reference/peripherals/mcpwm.rst b/docs/en/api-reference/peripherals/mcpwm.rst index 6e208436a..a41dccda1 100644 --- a/docs/en/api-reference/peripherals/mcpwm.rst +++ b/docs/en/api-reference/peripherals/mcpwm.rst @@ -1,60 +1,179 @@ MCPWM ===== -Overview +ESP32 has two MCPWM units which can be used to control different types of motors. Each unit has three pairs of PWM outputs. + +.. figure:: ../../../_static/mcpwm-overview.png + :align: center + :alt: MCPWM Overview + :figclass: align-center + + MCPWM Overview + +Further in documentation the outputs of a single unit are labeled ``PWMxA`` / ``PWMxB``. + +More detailed block diagram of the MCPWM unit is shown below. Each A/B pair may be clocked by any one of the three timers Timer 0, 1 and 2. The same timer may be used to clock more than one pair of PWM outputs. Each unit is also able to collect inputs such as ``SYNC SIGNALS``, detect ``FAULT SIGNALS`` like motor overcurrent or overvoltage, as well as obtain feedback with ``CAPTURE SIGNALS`` on e.g. a rotor position. + +.. _mcpwm_block_diagram: + +.. figure:: ../../../_static/mcpwm-block-diagram.png + :align: center + :alt: MCPWM Block Diagram + :figclass: align-center + + MCPWM Block Diagram + +Description of this API starts with configuration of MCPWM's **Timer** and **Operator** submodules to provide the basic motor control functionality. Then it discusses more advanced submodules and functionalities of a **Fault Handler**, signal **Capture**, **Carrier** and **Interrupts**. + +Contents -------- -ESP32 has two MCPWM units which can be used to control different motors. +* `Configure`_ a basic functionality of the outputs +* `Operate`_ the outputs to drive a motor +* `Adjust`_ how the motor is driven +* `Capture`_ external signals to provide additional control over the outputs +* Use `Fault Handler`_ to detect and manage faults +* Add a higher frequency `Carrier`_, if output signals are passed through an isolation transformer +* Configuration and handling of `Interrupts`_. -Block Diagram + +Configure +--------- + +The scope of configuration depends on the motor type, in particular how many outputs and inputs are required, and what will be the sequence of signals to drive the motor. + +In this case we will describe a simple configuration to control a brushed DC motor that is using only some of the available MCPWM's resources. An example circuit is shown below. It includes a `H-Bridge `_ to switch polarization of a voltage applied to the motor (M) and to provide sufficient current to drive it. + +.. figure:: ../../../_static/mcpwm-brushed-dc-control.png + :align: center + :alt: Example of Brushed DC Motor Control with MCPWM + :figclass: align-center + + Example of Brushed DC Motor Control with MCPWM + +Configuration covers the following steps: + +1. Selection of a MPWN unit that will be used to drive the motor. There are two units available on-board of ESP32 and enumerated in :cpp:type:`mcpwm_unit_t`. +2. Initialization of two GPIOs as output signals within selected unit by calling :cpp:func:`mcpwm_gpio_init`. The two output signals are typically used to command the motor to rotate right or left. All available signal options are listed in :cpp:type:`mcpwm_io_signals_t`. To set more than a single pin at a time, use function :cpp:func:`mcpwm_set_pin` together with :cpp:type:`mcpwm_pin_config_t`. +3. Selection of a timer. There are three timers available within the unit. The timers are listed in :cpp:type:`mcpwm_timer_t`. +4. Setting of the timer frequency and initial duty within :cpp:type:`mcpwm_config_t` structure. +5. Calling of :cpp:func:`mcpwm_init` with the above parameters to make the configuration effective. + + +Operate +------- + +To operate a motor connected to the MCPWM unit, e.g. turn it left or right, or vary the speed, we should apply some control signals to the unit's outputs. The outputs are organized into three pairs. Within a pair they are labeled "A" and "B" and driven by a submodule called an "Operator". To provide a PWM signal, the Operator itself should be clocked by one of three available Timers. To make the API simpler, each Timer is automatically associated by the API to drive an Operator of the same index, e.g. Timer 0 is associated with Operator 0. + +There are the following basic ways to control the outputs: + +* We can drive particular signal steady high or steady low with function :cpp:func:`mcpwm_set_signal_high` or :cpp:func:`mcpwm_set_signal_low`. This will make the motor to turn with a maximum speed or stop. Depending on selected output A or B the motor will rotate either right or left. +* Another option is to drive the outputs with the PWM signal by calling :cpp:func:`mcpwm_start` or :cpp:func:`mcpwm_stop`. The motor speed will be proportional to the PWM duty. +* To vary PWM's duty call :cpp:func:`mcpwm_set_duty` and provide the duty value in %. Optionally, you may call :cpp:func:`mcpwm_set_duty_in_us`, if you prefer to set the duty in microseconds. Checking of currently set value is possible by calling :cpp:func:`mcpwm_get_duty`. Phase of the PWM signal may be altered by calling :cpp:func:`mcpwm_set_duty_type`. The duty is set individually for each A and B output using :cpp:type:`mcpwm_operator_t` in specific function calls. The duty value refers either to high or low output signal duration. This is configured when calling :cpp:func:`mcpwm_init`, as discussed in section `Configure`_, and selecting one of options from :cpp:type:`mcpwm_duty_type_t`. + +.. note:: + + Call function :cpp:func:`mcpwm_set_duty_type` every time after :cpp:func:`mcpwm_set_signal_high` or :cpp:func:`mcpwm_set_signal_low` to resume with previously set duty cycle. + + +Adjust +------ + +There are couple of ways to adjust a signal on the outputs and changing how the motor operates. + +* Set specific PWM frequency by calling :cpp:func:`mcpwm_set_frequency`. This may be required to adjust to electrical or mechanical characteristics of particular motor and driver. To check what frequency is set, use function :cpp:func:`mcpwm_get_frequency`. +* Introduce a dead time between outputs A and B when they are changing the state to reverse direction of the motor rotation. This is to make up for on/off switching delay of the motor driver FETs. The dead time options are defined in :cpp:type:`mcpwm_deadtime_type_t` and enabled by calling :cpp:func:`mcpwm_deadtime_enable`. To disable this functionality call :cpp:func:`mcpwm_deadtime_disable`. +* Synchronize outputs of operator submodules, e.g. to get raising edge of PWM0A/B and PWM1A/B to start exactly at the same time, or shift them between each other by a given phase. Synchronization is triggered by ``SYNC SIGNALS`` shown on the :ref:`block diagram ` of the MCPWM above, and defined in :cpp:type:`mcpwm_sync_signal_t`. To attach the signal to a GPIO call :cpp:func:`mcpwm_gpio_init`. You can then enable synchronization with function :cpp:func:`mcpwm_sync_enable`. As input parameters provide MCPWM unit, timer to synchronize, the synchronization signal and a phase to delay the timer. + +.. note:: + + Synchronization signals are referred to using two different enumerations. First one :cpp:type:`mcpwm_io_signals_t` is used together with function :cpp:func:`mcpwm_gpio_init` when selecting a GPIO as the signal input source. The second one :cpp:type:`mcpwm_sync_signal_t` is used when enabling or disabling synchronization with :cpp:func:`mcpwm_sync_enable` or :cpp:func:`mcpwm_sync_disable`. + +* Vary the pattern of the A/B output signals by getting MCPWM counters to count up, down and up/down (automatically changing the count direction). Respective configuration is done when calling :cpp:func:`mcpwm_init`, as discussed in section `Configure`_, and selecting one of counter types from :cpp:type:`mcpwm_counter_type_t`. For explanation of how A/B PWM output signals are generated please refer to `ESP32 Technical Reference Manual`_. + + +Capture +------- + +One of requirements of BLDC (Brushless DC, see figure below) motor control is sensing of the rotor position. To facilitate this task each MCPWM unit provides three sensing inputs together with dedicated hardware. The hardware is able to detect the input signal's edge and measure time between signals. As result the control software is simpler and the CPU power may be used for other tasks. + +.. figure:: ../../../_static/mcpwm-bldc-control.png + :align: center + :alt: Example of Brushless DC Motor Control with MCPWM + :figclass: align-center + + Example of Brushless DC Motor Control with MCPWM + +The capture functionality may be used for other types of motors or tasks. The functionality is enabled in two steps: + +1. Configuration of GPIOs to act as the capture signal inputs by calling functions :cpp:func:`mcpwm_gpio_init` or :cpp:func:`mcpwm_set_pin`, that were described in section `Configure`_. +2. Enabling of the functionality itself by invoking :cpp:func:`mcpwm_capture_enable`, selecting desired signal input from :cpp:type:`mcpwm_capture_signal_t`, setting the signal edge with :cpp:type:`mcpwm_capture_on_edge_t` and the signal count prescaler. + +Within the second step above a 32-bit capture timer is enabled. The timer runs continuously driven by the APB clock. The clock frequency is typically 80 MHz. On each capture event the capture timer’s value is stored in time-stamp register that may be then checked by calling :cpp:func:`mcpwm_capture_signal_get_value`. The edge of the last signal may be checked with :cpp:func:`mcpwm_capture_signal_get_edge`. + +If not required anymore, the capture functionality may be disabled with :cpp:func:`mcpwm_capture_disable`. + + +Fault Handler ------------- -The block diagram of MCPWM unit is as shown. +Each unit of the MCPWM is able to sense external signals with information about failure of the motor, the motor driver or any other device connected to the MCPWM. There are three fault inputs per unit that may be routed to user selectable GPIOs. The MCPWM may be configured to perform one of four predefined actions on A/B outputs when a fault signal is received: -:: +* lock current state of the output +* set the output low +* set the output high +* toggle the output - __________________________________________________________________________ - | SYNCSIG FAULT SIG CAPTURE SIG | - | 0 1 2 0 1 2 0 1 2 | - |___________________________________________________________________ G | - INTERRUPTS<-----+ | | | | | | | | | | P | - | | | | | | | | | | | I | - ________|_|___|___|_____________|___|___|_________|___|___|_________ | O | - | | | | | | | | | | | | | - | | | | | | | | | | | | M | - | | | | __v___v___v__ __v___v___v__ | | A | - | | | | | | | | | | T | - | | | | | FAULT | | CAPTURE | | | R | - | | | | | HANDLER | | | | | I | - | | | | | | |___________| | | X | - | | | | |___________| | | | - | | | | | | | - | ____v___v___v____ ____________________ | | | - | | +---------+ | | +------------+ |--------->|PWM0A| - | | | Timer 0 | | | | Operator 0 | | | | | - | | +---------+ | | +------------+ |--------->|PWM0B| - | | | | | | | | - | | +---------+ | | +------------+ |--------->|PWM1A| - | | | Timer 1 | |------------------->| | Operator 1 | | | | | - | | +---------+ | | +------------+ |--------->|PWM1B| - | | | | | | | | - | | +---------+ | | +------------+ |--------->|PWM2A| - | | | Timer 2 | | | | Operator 2 | | | | | - | | +---------+ | | +------------+ |--------->|PWM2B| - | |_______________| |__________________| | |_____| - | | - | MCPWM-UNIT 0/1 | - |___________________________________________________________________| +The user should determine possible failure modes of the motor and what action should be performed on detection of particular fault, e.g. drive all outputs low for a brushed motor, or lock current state for a stepper motor, etc. As result of this action the motor should be put into a safe state to reduce likelihood of a damage caused by the fault. - +The fault handler functionality is enabled in two steps: + +1. Configuration of GPIOs to act as fault signal inputs. This is done in analogous way as described for capture signals in section above. It includes setting the signal level to trigger the fault as defined in :cpp:type:`mcpwm_fault_input_level_t`. +2. Initialization of the fault handler by calling either :cpp:func:`mcpwm_fault_set_oneshot_mode` or :cpp:func:`mcpwm_fault_set_cyc_mode`. These functions set the mode that MCPWM should operate once fault signal becomes inactive. There are two modes possible: + + * State of MCPWM unit will be locked until reset - :cpp:func:`mcpwm_fault_set_oneshot_mode`. + * The MCPWM will resume operation once fault signal becoming inactive - :cpp:func:`mcpwm_fault_set_cyc_mode`. + + The function call parameters include selection of one of three fault inputs defined in :cpp:type:`mcpwm_fault_signal_t` and specific action on outputs A and B defined in :cpp:type:`mcpwm_action_on_pwmxa_t` and :cpp:type:`mcpwm_action_on_pwmxb_t`. + +Particular fault signal may be disabled at the runtime by calling :cpp:func:`mcpwm_fault_deinit`. + + +Carrier +------- + +The MCPWM has a carrier submodule used if galvanic isolation from the motor driver is required by passing the A/B output signals through transformers. Any of A and B output signals may be at 100% duty and not changing whenever motor is required to run steady at the full load. Coupling of non alternating signals with a transformer is problematic, so the signals are modulated by the carrier submodule to create an AC waveform, to make the coupling possible. + +To use the carrier submodule, it should be first initialized by calling :cpp:func:`mcpwm_carrier_init`. The carrier parameters are defined in :cpp:type:`mcpwm_carrier_config_t` structure invoked within the function call. Then the carrier functionality may be enabled by calling :cpp:func:`mcpwm_carrier_enable`. + +The carrier parameters may be then alerted at a runtime by calling dedicated functions to change individual fields of the :cpp:type:`mcpwm_carrier_config_t` structure, like :cpp:func:`mcpwm_carrier_set_period`, :cpp:func:`mcpwm_carrier_set_duty_cycle`, :cpp:func:`mcpwm_carrier_output_invert`, etc. + +This includes enabling and setting duration of the first pulse of the career with :cpp:func:`mcpwm_carrier_oneshot_mode_enable`. For more details please refer to "PWM Carrier Submodule" section of the `ESP32 Technical Reference Manual`_. + +To disable carrier functionality call :cpp:func:`mcpwm_carrier_disable`. + + +Interrupts +---------- + +Registering of the MCPWM interrupt handler is possible by calling :cpp:func:`mcpwm_isr_register`. + + Application Example ------------------- -Examples of using MCPWM for motor control: :example:`peripherals/mcpwm`. +Examples of using MCPWM for motor control: :example:`peripherals/mcpwm`: + +* Demonstration how to use each submodule of the MCPWM - :example:`peripherals/mcpwm/mcpwm_basic_config` +* Control of BLDC (brushless DC) motor with hall sensor feedback - :example:`peripherals/mcpwm/mcpwm_bldc_control` +* Brushed DC motor control - :example:`peripherals/mcpwm/mcpwm_brushed_dc_control` +* Servo motor control - :example:`peripherals/mcpwm/mcpwm_servo_control` + +.. _ESP32 Technical Reference Manual: https://www.espressif.com/sites/default/files/documentation/esp32_technical_reference_manual_en.pdf + API Reference ------------- .. include:: /_build/inc/mcpwm.inc - diff --git a/examples/peripherals/mcpwm/mcpwm_brushed_dc_control/README.md b/examples/peripherals/mcpwm/mcpwm_brushed_dc_control/README.md index 9882c3a3b..1781459a7 100644 --- a/examples/peripherals/mcpwm/mcpwm_brushed_dc_control/README.md +++ b/examples/peripherals/mcpwm/mcpwm_brushed_dc_control/README.md @@ -8,7 +8,7 @@ Motor first moves forward, then backward and then stops for 2 Secs each countinu ## Step 1: Pin assignment -* GPIO15 is assigned as the enable/input 1 for motor driver +* GPIO15 is assigned as the enable/input 1 for motor driver * GPIO16 is assigned as the enable/input 2 for motor driver @@ -19,4 +19,4 @@ Motor first moves forward, then backward and then stops for 2 Secs each countinu ## Step 3: Initialize MCPWM * You need to set the frequency and duty cycle of MCPWM timer -* You need to set the MCPWM channel you want to use, and bind the channel with one of the timers +* You need to set the MCPWM unit you want to use, and bind the unit with one of the timers