PWM Module 28335
PWM Module 28335
Reference Guide
Preface ....................................................................................................................................... 8
1
Introduction ...................................................................................................................... 11
.................................................................................................. 11
...................................................................................................... 15
2
ePWM Submodules ............................................................................................................ 17
2.1
Overview ................................................................................................................ 17
2.2
Time-Base (TB) Submodule .......................................................................................... 20
2.3
Counter-Compare (CC) Submodule ................................................................................. 31
2.4
Action-Qualifier (AQ) Submodule .................................................................................... 37
2.5
Dead-Band Generator (DB) Submodule ............................................................................ 51
2.6
PWM-Chopper (PC) Submodule ..................................................................................... 55
2.7
Trip-Zone (TZ) Submodule ........................................................................................... 59
2.8
Event-Trigger (ET) Submodule ....................................................................................... 63
3
Applications to Power Topologies ....................................................................................... 68
3.1
Overview of Multiple Modules ........................................................................................ 68
3.2
Key Configuration Capabilities ....................................................................................... 68
3.3
Controlling Multiple Buck Converters With Independent Frequencies .......................................... 69
3.4
Controlling Multiple Buck Converters With Same Frequencies .................................................. 73
3.5
Controlling Multiple Half H-Bridge (HHB) Converters ............................................................. 76
3.6
Controlling Dual 3-Phase Inverters for Motors (ACI and PMSM) ................................................ 78
3.7
Practical Applications Using Phase Control Between PWM Modules .......................................... 82
3.8
Controlling a 3-Phase Interleaved DC/DC Converter ............................................................. 83
3.9
Controlling Zero Voltage Switched Full Bridge (ZVSFB) Converter ............................................. 87
4
Registers .......................................................................................................................... 90
4.1
Time-Base Submodule Registers .................................................................................... 90
4.2
Counter-Compare Submodule Registers ........................................................................... 94
4.3
Action-Qualifier Submodule Registers .............................................................................. 97
4.4
Dead-Band Submodule Registers .................................................................................. 101
4.5
PWM-Chopper Submodule Control Register ..................................................................... 103
4.6
Trip-Zone Submodule Control and Status Registers ............................................................ 105
4.7
Event-Trigger Submodule Registers ............................................................................... 108
4.8
Proper Interrupt Initialization Procedure ........................................................................... 113
Appendix A Revision History ..................................................................................................... 114
1.1
Submodule Overview
1.2
Register Mapping
Table of Contents
20082009, Texas Instruments Incorporated
www.ti.com
List of Figures
1
23
25
8
9
10
11
12
13
14
15
16
17
26
27
29
30
30
31
31
32
35
36
18
19
20
21
22
23
24
Up, Single Edge Asymmetric Waveform, With Independent Modulation on EPWMxA and
EPWMxBActive High ................................................................................................... 44
25
Up, Single Edge Asymmetric Waveform With Independent Modulation on EPWMxA and
EPWMxBActive Low .................................................................................................... 45
26
27
Up-Down-Count, Dual Edge Symmetric Waveform, With Independent Modulation on EPWMxA and
EPWMxB Active Low .................................................................................................. 48
28
Up-Down-Count, Dual Edge Symmetric Waveform, With Independent Modulation on EPWMxA and
EPWMxB Complementary ............................................................................................ 49
29
30
31
32
33
34
35
36
......................................................................................
......................................................................
Time-Base Counter Synchronization Scheme 2 ......................................................................
Time-Base Counter Synchronization Scheme 3 ......................................................................
Time-Base Up-Count Mode Waveforms................................................................................
Time-Base Down-Count Mode Waveforms ............................................................................
Time-Base Up-Down-Count Waveforms, TBCTL[PHSDIR = 0] Count Down On Synchronization Event .....
Time-Base Up-Down Count Waveforms, TBCTL[PHSDIR = 1] Count Up On Synchronization Event.........
Counter-Compare Submodule ...........................................................................................
Detailed View of the Counter-Compare Submodule ..................................................................
Counter-Compare Event Waveforms in Up-Count Mode ............................................................
Counter-Compare Events in Down-Count Mode ......................................................................
......................................................................
.............
...............................................................
Dead-Band Waveforms for Typical Cases (0% < Duty < 100%) ....................................................
PWM-Chopper Submodule ...............................................................................................
PWM-Chopper Submodule Operational Details .......................................................................
Simple PWM-Chopper Submodule Waveforms Showing Chopping Action Only .................................
PWM-Chopper Submodule Waveforms Showing the First Pulse and Subsequent Sustaining Pulses ........
39
46
52
53
55
56
56
57
37
PWM-Chopper Submodule Waveforms Showing the Pulse Width (Duty Cycle) Control of Sustaining
Pulses ....................................................................................................................... 58
38
39
40
41
............................................................................
List of Figures
62
www.ti.com
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
....................................... 69
.................................................... 70
Buck Waveforms for (Note: Only three bucks shown here).......................................................... 71
Control of Four Buck Stages. (Note: FPWM2 = N x FPWM1) .............................................................. 73
Buck Waveforms for (Note: FPWM2 = FPWM1)) ............................................................................. 74
Control of Two Half-H Bridge Stages (FPWM2 = N x FPWM1) ............................................................ 76
Half-H Bridge Waveforms for (Note: Here FPWM2 = FPWM1 ) ............................................................ 77
Control of Dual 3-Phase Inverter Stages as Is Commonly Used in Motor Control ............................... 79
3-Phase Inverter Waveforms for (Only One Inverter Shown) ....................................................... 80
Configuring Two PWM Modules for Phase Control ................................................................... 82
Timing Waveforms Associated With Phase Control Between 2 Modules .......................................... 83
Control of a 3-Phase Interleaved DC/DC Converter .................................................................. 84
3-Phase Interleaved DC/DC Converter Waveforms for .............................................................. 85
Controlling a Full-H Bridge Stage (FPWM2 = FPWM1) ..................................................................... 87
ZVS Full-H Bridge Waveforms ........................................................................................... 88
Time-Base Period Register (TBPRD) ................................................................................... 90
Time-Base Phase Register (TBPHS) ................................................................................... 90
Time-Base Counter Register (TBCTR) ................................................................................. 90
Time-Base Control Register (TBCTL) .................................................................................. 91
Time-Base Status Register (TBSTS) ................................................................................... 93
Counter-Compare A Register (CMPA) ................................................................................. 94
Counter-Compare B Register (CMPB).................................................................................. 94
Counter-Compare Control Register (CMPCTL) ....................................................................... 96
Compare A High Resolution Register (CMPAHR) ................................................................... 97
Action-Qualifier Output A Control Register (AQCTLA) ............................................................... 97
Action-Qualifier Output B Control Register (AQCTLB) ............................................................... 98
Action-Qualifier Software Force Register (AQSFRC) ................................................................. 99
Action-Qualifier Continuous Software Force Register (AQCSFRC) ............................................... 100
Dead-Band Generator Control Register (DBCTL) ................................................................... 101
Dead-Band Generator Rising Edge Delay Register (DBRED) ..................................................... 103
Dead-Band Generator Falling Edge Delay Register (DBFED) ..................................................... 103
PWM-Chopper Control Register (PCCTL) ............................................................................ 103
Trip-Zone Select Register (TZSEL) .................................................................................... 105
Trip-Zone Control Register (TZCTL) .................................................................................. 106
Trip-Zone Enable Interrupt Register (TZEINT) ....................................................................... 106
Trip-Zone Flag Register (TZFLG) ...................................................................................... 107
Trip-Zone Clear Register (TZCLR) .................................................................................... 107
Trip-Zone Force Register (TZFRC) .................................................................................... 108
Event-Trigger Selection Register (ETSEL) ........................................................................... 108
Event-Trigger Prescale Register (ETPS) ............................................................................. 109
Event-Trigger Flag Register (ETFLG) ................................................................................. 111
Event-Trigger Clear Register (ETCLR)................................................................................ 112
Event-Trigger Force Register (ETFRC) ............................................................................... 112
List of Figures
20082009, Texas Instruments Incorporated
www.ti.com
List of Tables
1
ePWM Module Control and Status Register Set Grouped by Submodule ......................................... 16
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
6
.............................................................................. 32
Counter-Compare Submodule Key Signals ............................................................................ 33
Action-Qualifier Submodule Registers .................................................................................. 38
Action-Qualifier Submodule Possible Input Events ................................................................... 39
Action-Qualifier Event Priority for Up-Down-Count Mode ............................................................ 41
Action-Qualifier Event Priority for Up-Count Mode .................................................................... 41
Action-Qualifier Event Priority for Down-Count Mode ................................................................ 41
Behavior if CMPA/CMPB is Greater than the Period ................................................................. 41
Dead-Band Generator Submodule Registers .......................................................................... 51
Classical Dead-Band Operating Modes ............................................................................... 53
Dead-Band Delay Values in S as a Function of DBFED and DBRED ........................................... 54
PWM-Chopper Submodule Registers .................................................................................. 55
Possible Pulse Width Values for SYSCLKOUT = 100 MHz ......................................................... 57
Trip-Zone Submodule Registers ......................................................................................... 60
Possible Actions On a Trip Event ....................................................................................... 61
Event-Trigger Submodule Registers ................................................................................... 65
Time-Base Period Register (TBPRD) Field Descriptions ............................................................ 90
Time-Base Phase Register (TBPHS) Field Descriptions ............................................................. 90
Time-Base Counter Register (TBCTR) Field Descriptions ........................................................... 90
Time-Base Control Register (TBCTL) Field Descriptions ............................................................ 91
Time-Base Status Register (TBSTS) Field Descriptions ............................................................. 93
Counter-Compare A Register (CMPA) Field Descriptions ........................................................... 94
Counter-Compare B Register (CMPB) Field Descriptions ........................................................... 95
Counter-Compare Control Register (CMPCTL) Field Descriptions ................................................ 96
Compare A High Resolution Register (CMPAHR) Field Descriptions .............................................. 97
Action-Qualifier Output A Control Register (AQCTLA) Field Descriptions ........................................ 97
Action-Qualifier Output B Control Register (AQCTLB) Field Descriptions ........................................ 98
Action-Qualifier Software Force Register (AQSFRC) Field Descriptions .......................................... 99
Action-qualifier Continuous Software Force Register (AQCSFRC) Field Descriptions ......................... 100
Dead-Band Generator Control Register (DBCTL) Field Descriptions ............................................. 102
Dead-Band Generator Rising Edge Delay Register (DBRED) Field Descriptions............................... 103
Dead-Band Generator Falling Edge Delay Register (DBFED) Field Descriptions .............................. 103
PWM-Chopper Control Register (PCCTL) Bit Descriptions ....................................................... 104
Trip-Zone Submodule Select Register (TZSEL) Field Descriptions .............................................. 105
Trip-Zone Control Register (TZCTL) Field Descriptions ............................................................ 106
Trip-Zone Enable Interrupt Register (TZEINT) Field Descriptions ................................................ 106
Trip-Zone Flag Register (TZFLG) Field Descriptions ............................................................... 107
Trip-Zone Clear Register (TZCLR) Field Descriptions ............................................................. 108
Trip-Zone Force Register (TZFRC) Field Descriptions ............................................................. 108
Event-Trigger Selection Register (ETSEL) Field Descriptions .................................................... 109
Event-Trigger Prescale Register (ETPS) Field Descriptions ...................................................... 110
Event-Trigger Flag Register (ETFLG) Field Descriptions ........................................................... 111
Event-Trigger Clear Register (ETCLR) Field Descriptions ......................................................... 112
List of Tables
www.ti.com
48
49
........................................................
Changes for this Revision...............................................................................................
Event-Trigger Force Register (ETFRC) Field Descriptions
List of Tables
20082009, Texas Instruments Incorporated
112
114
Preface
SPRUG04A October 2008 Revised July 2009
The Enhanced Pulse Width Modulator (ePWM) module described in this reference guide is a Type 0
ePWM. See the TMS320x28xx, 28xxx DSP Peripheral Reference Guide (SPRU566) for a list of all
devices with a ePWM module of the same type, to determine the differences between the types, and for a
list of device-specific differences within a type. This reference guide includes an overview of the module
and information about each of its sub-modules:
Time-Base Module
Counter Compare Module
Action Qualifier Module
Dead-Band Generator Module
PWM Chopper (PC) Module
Trip Zone Module
Event Trigger Module
Preface
www.ti.com
SPRU963 TMS320x2833x, 2823x Boot ROM Reference Guide describes the purpose and features of
the bootloader (factory-programmed boot-loading software) and provides examples of code. It also
describes other contents of the device on-chip boot ROM and identifies where all of the information
is located within that memory.
SPRUFB7 TMS320x2833x, 2823x Multichannel Buffered Serial Port (McBSP) Reference Guide
describes the McBSP available on the 2833x and 2823x devices. The McBSPs allow direct
interface between a DSP and other devices in a system.
SPRUFB8 TMS320x2833x, 2823x Direct Memory Access (DMA) Module Reference Guide
describes the DMA on the 2833x and 2823x devices.
SPRUG04 TMS320x2833x, 2823x Enhanced Pulse Width Modulator (ePWM) Module Reference
Guide describes the main areas of the enhanced pulse width modulator that include digital motor
control, switch mode power supply control, UPS (uninterruptible power supplies), and other forms of
power conversion.
SPRUG02 TMS320x2833x, 2823x High-Resolution Pulse Width Modulator (HRPWM) Reference
Guide describes the operation of the high-resolution extension to the pulse width modulator
(HRPWM).
SPRUFG4 TMS320x2833x, 2823x Enhanced Capture (eCAP) Module Reference Guide describes
the enhanced capture module. It includes the module description and registers.
SPRUG05 TMS320x2833x, 2823x Enhanced Quadrature Encoder Pulse (eQEP) Module
Reference Guide describes the eQEP module, which is used for interfacing with a linear or rotary
incremental encoder to get position, direction, and speed information from a rotating machine in
high-performance motion and position control systems. It includes the module description and
registers.
SPRUEU1 TMS320x2833x, 2823x Enhanced Controller Area Network (eCAN) Reference Guide
describes the eCAN that uses established protocol to communicate serially with other controllers in
electrically noisy environments.
SPRUFZ5 TMS320x2833x, 2823x Serial Communications Interface (SCI) Reference Guide
describes the SCI, which is a two-wire asynchronous serial port, commonly known as a UART. The
SCI modules support digital communications between the CPU and other asynchronous peripherals
that use the standard non-return-to-zero (NRZ) format.
SPRUEU3 TMS320x2833x, 2823x DSC Serial Peripheral Interface (SPI) Reference Guide
describes the SPI - a high-speed synchronous serial input/output (I/O) port - that allows a serial bit
stream of programmed length (one to sixteen bits) to be shifted into and out of the device at a
programmed bit-transfer rate.
SPRUG03 TMS320x2833x, 2823x Inter-Integrated Circuit (I2C) Module Reference Guide describes
the features and operation of the inter-integrated circuit (I2C) module.
Tools Guides
SPRU513 TMS320C28x Assembly Language Tools v5.0.0 User's Guide describes the assembly
language tools (assembler and other tools used to develop assembly language code), assembler
directives, macros, common object file format, and symbolic debugging directives for the
TMS320C28x device.
SPRU514 TMS320C28x Optimizing C/C++ Compiler v5.0.0 User's Guide describes the
TMS320C28x C/C++ compiler. This compiler accepts ANSI standard C/C++ source code and
produces TMS320 DSP assembly language source code for the TMS320C28x device.
SPRU608 TMS320C28x Instruction Set Simulator Technical Overview describes the simulator,
available within the Code Composer Studio for TMS320C2000 IDE, that simulates the instruction
set of the C28x core.
SPRU625 TMS320C28x DSP/BIOS 5.32 Application Programming Interface (API) Reference
Guide describes development using DSP/BIOS.
SPRUG04A October 2008 Revised July 2009
Submit Documentation Feedback
www.ti.com
Application Reports
SPRAAM0 Getting Started With TMS320C28x Digital Signal Controllers is organized by
development flow and functional areas to make your design effort as seamless as possible. Tips on
getting started with C28x DSP software and hardware development are provided to aid in your
initial design and debug efforts. Each section includes pointers to valuable information including
technical documentation, software, and tools for use in each phase of design.
SPRAAD5 Power Line Communication for Lighting Applications Using Binary Phase Shift
Keying (BPSK) with a Single DSP Controller presents a complete implementation of a power line
modem following CEA-709 protocol using a single DSP.
SPRAA85 Programming TMS320x28xx and 28xxx Peripherals in C/C++ explores a hardware
abstraction layer implementation to make C/C++ coding easier on 28x DSPs. This method is
compared to traditional #define macros and topics of code efficiency and special case registers are
also addressed.
SPRA958 Running an Application from Internal Flash Memory on the TMS320F28xxx DSP covers
the requirements needed to properly configure application software for execution from on-chip flash
memory. Requirements for both DSP/BIOS and non-DSP/BIOS projects are presented. Example
code projects are included.
SPRAA91 TMS320F280x Digital Signal Controller USB Connectivity Using the TUSB3410
USB-to-UART Bridge Chip presents hardware connections as well as software preparation and
operation of the development system using a simple communication echo program.
SPRAAD8 TMS320x280x and TMS320F2801x ADC Calibration describes a method for improving
the absolute accuracy of the 12-bit ADC found on the TMS320x280x and TMS320F2801x devices.
Inherent gain and offset errors affect the absolute accuracy of the ADC. The methods described in
this report can improve the absolute accuracy of the ADC to levels better than 0.5%. This
application report has an option to download an example program that executes from RAM on the
F2808 EzDSP.
SPRAAI1 Using the ePWM Module for 0% 100% Duty Cycle Control provides a guide for the use
of the ePWM module to provide 0% to 100% duty cycle control and is applicable to the
TMS320x280x family of processors.
SPRAA88 Using PWM Output as a Digital-to-Analog Converter on a TMS320F280x Digital Signal
Controller presents a method for utilizing the on-chip pulse width modulated (PWM) signal
generators on the TMS320F280x family of digital signal controllers as a digital-to-analog converter
(DAC).
SPRAAH1 Using the Enhanced Quadrature Encoder Pulse (eQEP) Module in TMS320x280x,
28xxx as a Dedicated Capture provides a guide for the use of the eQEP module as a dedicated
capture unit and is applicable to the TMS320x280x, 28xxx family of processors.
SPRA820 Online Stack Overflow Detection on the TMS320C28x DSP presents the methodology for
online stack overflow detection on the TMS320C28x DSP. C-source code is provided that contains
functions for implementing the overflow detection on both DSP/BIOS and non-DSP/BIOS
applications.
SPRA806 An Easy Way of Creating a C-callable Assembly Function for the TMS320C28x DSP
provides instructions and suggestions to configure the C compiler to assist with C-callable
assembly routines.
Reference Guide
SPRUG04A October 2008 Revised July 2009
The enhanced pulse width modulator (ePWM) peripheral is a key element in controlling many of the power
electronic systems found in both commercial and industrial equipments. These systems include digital
motor control, switch mode power supply control, uninterruptible power supplies (UPS), and other forms of
power conversion. The ePWM peripheral performs a digital to analog (DAC) function, where the duty cycle
is equivalent to a DAC analog value; it is sometimes referred to as a Power DAC.
This reference guide is applicable for ePWM type 0 . See the TMS320x28xx, 28xxx DSP Peripheral
Reference Guide (SPRU566) for a list of all devices with an ePWM module of the same type, to determine
the differences between the types, and for a list of device-specific differences within a type.
Introduction
An effective PWM peripheral must be able to generate complex pulse width waveforms with minimal CPU
overhead or intervention. It needs to be highly programmable and very flexible while being easy to
understand and use. The ePWM unit described here addresses these requirements by allocating all
needed timing and control resources on a per PWM channel basis. Cross coupling or sharing of resources
has been avoided; instead, the ePWM is built up from smaller single channel modules with separate
resources that can operate together as required to form a system. This modular approach results in an
orthogonal architecture and provides a more transparent view of the peripheral structure, helping users to
understand its operation quickly.
In this document the letter x within a signal or module name is used to indicate a generic ePWM instance
on a device. For example output signals EPWMxA and EPWMxB refer to the output signals from the
ePWMx instance. Thus, EPWM1A and EPWM1B belong to ePWM1 and likewise EPWM4A and EPWM4B
belong to ePWM4.
1.1
Submodule Overview
The ePWM module represents one complete PWM channel composed of two PWM outputs: EPWMxA
and EPWMxB. Multiple ePWM modules are instanced within a device as shown in Figure 1. Each ePWM
instance is identical with one exception. Some instances include a hardware extension that allows more
precise control of the PWM outputs. This extension is the high-resolution pulse width modulator (HRPWM)
and is described in the TMS320x2833x, 2823x High-Resolution Pulse Width Modulator (HRPWM)
Reference Guide (SPRUG02) . See the device-specific data manual to determine which ePWM instances
include this feature. Each ePWM module is indicated by a numerical value starting with 1. For example
ePWM1 is the first instance and ePWM3 is the 3rd instance in the system and ePWMx indicates any
instance.
The ePWM modules are chained together via a clock synchronization scheme that allows them to operate
as a single system when required. Additionally, this synchronization scheme can be extended to the
capture peripheral modules (eCAP). The number of modules is device-dependent and based on target
application needs. Modules can also operate stand-alone.
Each ePWM module supports the following features:
Dedicated 16-bit time-base counter with period and frequency control
Two PWM outputs (EPWMxA and EPWMxB) that can be used in the following configurations:
Two independent PWM outputs with single-edge operation
Two independent PWM outputs with dual-edge symmetric operation
11
Introduction
www.ti.com
Each ePWM module is connected to the input/output signals shown in Figure 1. The signals are described
in detail in subsequent sections.
12
Introduction
www.ti.com
SYNCI
EPWM1INT
EPWM1A
EPWM1SOC
ePWM1 module
EPWM1B
SYNCO
xSYNCO
To eCAP1
SYNCI
EPWM2INT
EPWM2SOC
PIE
EPWM2A
ePWM2 module
EPWM2B
GPIO
MUX
SYNCO
SYNCI
EPWMxINT
EPWMxSOC
EPWMxA
ePWMx module
EPWMxB
TZ1 to TZ6
SYNCO
xSOC
ADC
Peripheral
Frame 1
The order in which the ePWM modules are connected may differ from what is shown in Figure 1. See
Section 2.2.3.3 for the synchronization scheme for a particular device. Each ePWM module consists of
seven submodules and is connected within a system via the signals shown in Figure 2.
13
Introduction
www.ti.com
ePWM module
Time-base (TB) module
Counter-compare (CC) module
PIE
EPWMxTZINT
EPWMxINT
ADC
EPWMxSOCA
EPWMxSOCB
TZ1 to TZ6
EPWMxA
EPWMxB
GPIO
MUX
Figure 3 shows more internal details of a single ePWM module. The main signals used by the ePWM
module are:
PWM output signals (EPWMxA and EPWMxB).
The PWM output signals are made available external to the device through the GPIO peripheral
described in the system control and interrupts guide for your device.
Trip-zone signals (TZ1 to TZ6).
These input signals alert the ePWM module of fault conditions external to the ePWM module. Each
module on a device can be configured to either use or ignore any of the trip-zone signals. The TZ1 to
TZ6 trip-zone signals can be configured as asynchronous inputs through the GPIO peripheral.
Time-base synchronization input (EPWMxSYNCI) and output (EPWMxSYNCO) signals.
The synchronization signals daisy chain the ePWM modules together. Each module can be configured
to either use or ignore its synchronization input. The clock synchronization input and output signal are
brought out to pins only for ePWM1 (ePWM module #1). The synchronization output for ePWM1
(EPWM1SYNCO) is also connected to the SYNCI of the first enhanced capture module (eCAP1).
ADC start-of-conversion signals (EPWMxSOCA and EPWMxSOCB).
Each ePWM module has two ADC start of conversion signals (one for each sequencer). Any ePWM
module can trigger a start of conversion for either sequencer. Which event triggers the start of
conversion is configured in the Event-Trigger submodule of the ePWM.
Peripheral Bus
The peripheral bus is 32-bits wide and allows both 16-bit and 32-bit writes to the ePWM register file.
14
Introduction
www.ti.com
Sync
in/out
select
MUX
S0
CTR_PRD
S1
TBCTL[SWFSYNC]
16
Counter
UP/DWN
(16 bit)
EPWMxSYNCO
EPWMxSYNCI
TBCTL[PHSEN]
TBCTL[SWFSYNC] (software
forced sync)
CTR = ZERO
TBCTR
active
(16)
CTR_Dir
16
TBPHS active (16)
CTR = PRD
Phase
control
CTR = ZERO
CTR = CMPA
CTR = CMPB
CTR_Dir
EPWMxINT
Event
trigger and
interrupt
(ET)
EPWMxSOCA
EPWMxSOCB
16
CTR = CMPA
16
Action
qualifier
(AQ)
Dead
band
(DB)
16
EPWMxA
PWM
chopper
(PC)
CTR = CMPB
Trip
zone
(TZ)
EPWMxB
EPWMxTZINT
TZ1 to TZ6
CTR=ZERO
Figure 3 also shows the key internal submodule interconnect signals. Each submodule is described in
detail in its respective section.
1.2
Register Mapping
The complete ePWM module control and status register set is grouped by submodule as shown in
Table 1. Each register set is duplicated for each instance of the ePWM module. The start address for each
ePWM register file instance on a device is specified in the appropriate data manual.
15
Introduction
www.ti.com
Table 1. ePWM Module Control and Status Register Set Grouped by Submodule
Offset
(1)
Size
(x16)
Shadow
TBCTL
0x0000
No
TBSTS
0x0001
No
TBPHSHR
0x0002
No
TBPHS
0x0003
No
TBCTR
0x0004
No
TBPRD
0x0005
Yes
CMPCTL
0x0007
No
CMPAHR
0x0008
Yes
CMPA
0x0009
Yes
Counter-Compare A Register
CMPB
0x000A
Yes
Counter-Compare B Register
AQCTLA
0x000B
No
AQCTLB
0x000C
No
AQSFRC
0x000D
No
AQCSFRC
0x000E
Yes
DBCTL
0x000F
No
DBRED
0x0010
No
DBFED
0x0011
No
Name
EALLOW Description
Time-Base Submodule Registers
(2)
0x0012
Yes
TZCTL
0x0014
Yes
TZEINT
0x0015
Yes
TZFLG
0x0016
TZCLR
0x0017
Yes
(3)
TZFRC
0x0018
Yes
(3)
(3)
(3)
(3)
0x0019
ETPS
0x001A
ETFLG
0x001B
ETCLR
0x001C
ETFRC
0x001D
PCCTL
0x001E
(3)
16
0x0020
Yes
(2) (3)
ePWM Submodules
www.ti.com
ePWM Submodules
Seven submodules are included in every ePWM peripheral. Each of these submodules performs specific
tasks that can be configured by software.
2.1
Overview
Table 2 lists the seven key submodules together with a list of their main configuration parameters. For
example, if you need to adjust or control the duty cycle of a PWM waveform, then you should see the
counter-compare submodule in Section 2.3 for relevant details.
Table 2. Submodule Configuration Parameters
Submodule
Time-base (TB)
Scale the time-base clock (TBCLK) relative to the system clock (SYSCLKOUT).
Configure the PWM time-base counter (TBCTR) frequency or period.
Set the mode for the time-base counter:
count-up mode: used for asymmetric PWM
count-down mode: used for asymmetric PWM
count-up-and-down mode: used for symmetric PWM
Configure the time-base phase relative to another ePWM module.
Synchronize the time-base counter between modules through hardware or software.
Configure the direction (up or down) of the time-base counter after a synchronization event.
Configure how the time-base counter will behave when the device is halted by an emulator.
Specify the source for the synchronization output of the ePWM module:
Synchronization input signal
Time-base counter equal to zero
Time-base counter equal to counter-compare B (CMPB)
No output synchronization signal generated.
Counter-compare (CC)
Specify the PWM duty cycle for output EPWMxA and/or output EPWMxB
Specify the time at which switching events occur on the EPWMxA or EPWMxB output
Action-qualifier (AQ)
Specify the type of action taken when a time-base or counter-compare submodule event occurs:
No action taken
Output EPWMxA and/or EPWMxB switched high
Output EPWMxA and/or EPWMxB switched low
Output EPWMxA and/or EPWMxB toggled
Force the PWM output state through software control
Configure and control the PWM dead-band through software
Dead-band (DB)
Control of traditional complementary dead-band relationship between upper and lower switches
Specify the output rising-edge-delay value
Specify the output falling-edge delay value
Bypass the dead-band module entirely. In this case the PWM waveform is passed through
without modification.
PWM-chopper (PC)
17
ePWM Submodules
www.ti.com
Trip-zone (TZ)
Configure the ePWM module to react to one, all, or none of the trip-zone pins .
Specify the tripping action taken when a fault occurs:
Force EPWMxA and/or EPWMxB high
Force EPWMxA and/or EPWMxB low
Force EPWMxA and/or EPWMxB to a high-impedance state
Configure EPWMxA and/or EPWMxB to ignore any trip condition.
Configure how often the ePWM will react to each trip-zone pins :
One-shot
Cycle-by-cycle
Enable the trip-zone to initiate an interrupt.
Bypass the trip-zone module entirely.
Event-trigger (ET)
Code examples are provided in the remainder of this document that show how to implement various
ePWM module configurations. These examples use the constant definitions shown in Example 1. These
definitions are also used in the C2833x/2823x C/C++ Header Files and Peripheral Examples (SPRC530) .
Example 1. Constant Definitions Used in the Code Examples
// TBCTL (Time-Base Control)
// = = = = = = = = = = = = = = = = = =
// TBCTR MODE bits
#define TB_COUNT_UP 0x0
#define TB_COUNT_DOWN 0x1
#define TB_COUNT_UPDOWN 0x2
#define TB_FREEZE 0x3
// PHSEN bit
#define TB_DISABLE 0x0
#define TB_ENABLE 0x1
// PRDLD bit
#define TB_SHADOW 0x0
#define TB_IMMEDIATE 0x1
// SYNCOSEL bits
#define TB_SYNC_IN 0x0
#define TB_CTR_ZERO 0x1
#define TB_CTR_CMPB 0x2
#define TB_SYNC_DISABLE 0x3
// HSPCLKDIV and CLKDIV bits
#define TB_DIV1 0x0
#define TB_DIV2 0x1
#define TB_DIV4 0x2
// PHSDIR bit
#define TB_DOWN 0x0
#define TB_UP 0x1
// CMPCTL (Compare Control)
// = = = = = = = = = = = = = = = = = =
//
LOADAMODE and LOADBMODE bits
#define CC_CTR_ZERO 0x0
#define CC_CTR_PRD 0x1
#define CC_CTR_ZERO_PRD 0x2 #
define CC_LD_DISABLE 0x3
// SHDWAMODE and SHDWBMODE bits
#define CC_SHADOW 0x0
#define CC_IMMEDIATE 0x1
// AQCTLA and AQCTLB (Action-qualifier
// = = = = = = = = = = = = = = = = = =
// ZRO, PRD, CAU, CAD, CBU, CBD bits
18
= = = = = = = =
= = = = = = = =
Control)
= = = = = = = =
ePWM Submodules
www.ti.com
= = = = = = =
control)
= = = = = = =
= = = = = = =
= = = = = = =
= = = = = = =
= = = = = = =
19
ePWM Submodules
2.2
www.ti.com
EPWMxINT
Event
Trigger
EPWMxSOCA
and
Interrupt
CTR = 0
EPWMxSYNCI
EPWMxSYNCO
CTR = PRD
Time-Base
(TB)
Action
Qualifier
(AQ)
CTR = CMPA
CTR = CMPB
(ET)
CTR_Dir
CTR = 0
ADC
EPWMxSOCB
CTR_Dir
EPWMxA
EPWMxA
Dead
Band
(DB)
CTR = CMPA
Counter
Compare
(CC)
PIE
PWMchopper
(PC)
Trip
Zone
(TZ)
GPIO
EPWMxB
CTR = CMPB
EPWMxB
MUX
CTR = 0
EPWMxTZINT
TZ1 to TZ6
PIE
2.2.1
20
ePWM Submodules
www.ti.com
2.2.2
Address offset
Shadowed
TBCTL
0x0000
No
TBSTS
0x0001
No
TBPHSHR
0x0002
No
TBPHS
0x0003
No
TBCTR
0x0004
No
TBPRD
0x0005
Yes
(1)
Description
(1)
This register is available only on ePWM instances that include the high-resolution extension (HRPWM). On ePWM modules that
do not include the HRPWM, this location is reserved. This register is described in the device-specific High-Resolution Pulse
Width Modulator (HRPWM) Reference Guide. See the device specific data manual to determine which ePWM instances include
this feature.
The block diagram in Figure 5 shows the critical signals and registers of the time-base submodule.
Table 4 provides descriptions of the key signals associated with the time-base submodule.
Figure 5. Time-Base Submodule Signals and Registers
TBPRD
Period Shadow
TBCTL[PRDLD]
TBPRD
Period Active
TBCTL[SWFSYNC]
16
CTR = PRD
TBCTR[15:0]
EPWMxSYNCI
16
CTR = Zero
CTR_dir
CTR_max
TBCLK
Reset
Zero Counter
Mode
Dir UP/DOWN
Load
Max
TBCTL[CTRMODE]
CTR = Zero
clk
TBCTR
Counter Active Reg
TBCTL[PHSEN]
CTR = CMPB
X
Disable
Sync
Out
Select
EPWMxSYNCO
16
TBPHS
Phase Active Reg
SYSCLKOUT
Clock
Prescale
TBCTL[SYNCOSEL]
TBCLK
TBCTL[HSPCLKDIV]
TBCTL[CLKDIV]
21
ePWM Submodules
www.ti.com
Description
EPWMxSYNCI
EPWMxSYNCO
CTR = PRD
CTR = Zero
CTR = CMPB
CTR_dir
CTR_max
TBCLK
Time-base clock.
This is a prescaled version of the system clock (SYSCLKOUT) and is used by all submodules within the
ePWM. This clock determines the rate at which time-base counter increments or decrements.
2.2.3
22
ePWM Submodules
www.ti.com
PRD
4
Z 1
0
4
3
PRD
4
3
3
2
2
1
1 Z
0
TPWM
TPWM
4
3
3
2
2
1
2.2.3.1
3
2
CTR_dir
1
0
0
Up
Down
Up
Down
The time-base period register (TBPRD) has a shadow register. Shadowing allows the register update to
be synchronized with the hardware. The following definitions are used to describe all shadow registers in
the ePWM module:
Active Register
The active register controls the hardware and is responsible for actions that the hardware causes or
invokes.
Shadow Register
The shadow register buffers or provides a temporary holding location for the active register. It has no
direct effect on any control hardware. At a strategic point in time the shadow register's content is
transferred to the active register. This prevents corruption or spurious operation due to the register
being asynchronously modified by software.
The memory address of the shadow period register is the same as the active register. Which register is
written to or read from is determined by the TBCTL[PRDLD] bit. This bit enables and disables the TBPRD
shadow register as follows:
23
ePWM Submodules
www.ti.com
The TBCLKSYNC bit in the peripheral clock enable registers allows all users to globally synchronize all
enabled ePWM modules to the time-base clock (TBCLK). When set, all enabled ePWM module clocks are
started with the first rising edge of TBCLK aligned. For perfectly synchronized TBCLKs, the prescalers for
each ePWM module must be set identically.
The proper procedure for enabling ePWM clocks is as follows:
1. Enable ePWM module clocks in the PCLKCRx register
2. Set TBCLKSYNC= 0
3. Configure ePWM modules
4. Set TBCLKSYNC=1
2.2.3.3
A time-base synchronization scheme connects all of the ePWM modules on a device. Each ePWM
module has a synchronization input (EPWMxSYNCI) and a synchronization output (EPWMxSYNCO). The
input synchronization for the first instance (ePWM1) comes from an external pin. The possible
synchronization connections for the remaining ePWM modules are shown in Figure 7, Figure 8, and
Figure 9.
Scheme 1 shown in Figure 7 applies to the 280x, 2801x, 2802x, and 2803x devices. Scheme 1 also
applies to the 2804x devices when the ePWM pinout is configured for 280x compatible mode
(GPAMCFG[EPWMMODE] = 0).
24
ePWM Submodules
www.ti.com
EPWM1SYNCI
ePWM1
GPIO
MUX
EPWM1SYNCO
SYNCI
eCAP1
EPWM2SYNCI
ePWM2
EPWM2SYNCO
EPWM3SYNCI
ePWM3
EPWM3SYNCO
EPWMxSYNCI
ePWMx
EPWMxSYNCO
25
ePWM Submodules
www.ti.com
Scheme 2 shown in Figure 8 is used by the 2804x devices when the ePWM pinout is configured for
A-channel only mode (GPAMCFG[EPWMMODE] = 3). If the 2804x ePWM pinout is configured for 280x
compatible mode (GPAMCFG[EPWMMODE] = 0), then Scheme 1 is used.
Figure 8. Time-Base Counter Synchronization Scheme 2
EPWM1SYNCI
ePWM1
GPIO
EPWM1SYNCO
MUX
SYNCI
eCAP1
26
EPWM13SYNCI
EPWM9SYNCI
EPWM5SYNCI
EPWM2SYNCI
ePWM13
ePWM9
ePWM5
ePWM2
EPWM13SYnCO
EPWM9SYNCO
EPWM5SYNCO
EPWM2SYNCO
EPWM14SYNCI
EPWM10SYNCI
EPWM6SYNCI
EPWM3SYNCI
ePWM14
ePWM10
ePWM6
ePWM3
EPWM14SYNCO
EPWM10SYNCO
EPWM36YNCO
EPWM3SYNCO
EPWM15SYNCI
EPWM11SYNCI
EPWM7SYNCI
EPWM4SYNCI
ePWM15
ePWM11
ePWM7
ePWM4
EPWM15SYNCO
EPWM11SYNCO
EPWM7SYNCO
EPWM4SYNCO
EPWM16SYNCI
EPWM12SYNCI
EPWM8SYNCI
ePWM16
ePWM12
ePWM8
EPWM16SYNCO
EPWM12SYNCO
EPWM8SYNCO
ePWM Submodules
www.ti.com
eCAP4
EPWM1SYNCI
ePWM1
GPIO
MUX
EPWM1SYNCO
SYNCI
eCAP1
EPWM7SYNCI
EPWM4SYNCI
EPWM2SYNCI
ePWM7
ePWM4
ePWM2
EPWM7SYNCO
EPWM4SYNCO
EPWM2SYNCO
EPWM8SYNCI
EPWM5SYNCI
EPWM3SYNCI
ePWM8
ePWM5
ePWM3
EPWM8SYNCO
EPWM5SYNCO
EPWM3SYNCO
EPWM9SYNCI
EPWM6SYNCI
ePWM9
ePWM6
NOTE: All modules shown in the synchronization schemes may not be available on all devices.
Please refer to the device specific data manual to determine which modules are available on
a particular device.
Each ePWM module can be configured to use or ignore the synchronization input. If the TBCTL[PHSEN]
bit is set, then the time-base counter (TBCTR) of the ePWM module will be automatically loaded with the
phase register (TBPHS) contents when one of the following conditions occur:
EPWMxSYNCI: Synchronization Input Pulse:
The value of the phase register is loaded into the counter register when an input synchronization pulse
is detected (TBPHS TBCTR). This operation occurs on the next valid time-base clock (TBCLK)
edge.
The delay from internal master module to slave modules is given by:
if ( TBCLK = SYSCLKOUT): 2 x SYSCLKOUT
if ( TBCLK != SYSCLKOUT):1 TBCLK
Software Forced Synchronization Pulse:
Writing a 1 to the TBCTL[SWFSYNC] control bit invokes a software forced synchronization. This pulse
is ORed with the synchronization input signal, and therefore has the same effect as a pulse on
EPWMxSYNCI.
This feature enables the ePWM module to be automatically synchronized to the time base of another
27
ePWM Submodules
www.ti.com
ePWM module. Lead or lag phase control can be added to the waveforms generated by different
ePWM modules to synchronize them. In up-down-count mode, the TBCTL[PSHDIR] bit configures the
direction of the time-base counter immediately after a synchronization event. The new direction is
independent of the direction prior to the synchronization event. The PHSDIR bit is ignored in count-up
or count-down modes. See Figure 10 through Figure 13 for examples.
Clearing the TBCTL[PHSEN] bit configures the ePWM to ignore the synchronization input pulse. The
synchronization pulse can still be allowed to flow-through to the EPWMxSYNCO and be used to
synchronize other ePWM modules. In this way, you can set up a master time-base (for example, ePWM1)
and downstream modules (ePWM2 - ePWMx) may elect to run in synchronization with the master. See
the Application to Power Topologies Section 3 for more details on synchronization strategies.
2.2.4
2.2.5
28
ePWM Submodules
www.ti.com
TBPHS
(value)
0000
EPWMxSYNCI
CTR_dir
CTR = zero
CTR = PRD
CNT_max
29
ePWM Submodules
www.ti.com
TBPRD
(value)
TBPHS
(value)
0x000
EPWMxSYNCI
CTR_dir
CTR = zero
CTR = PRD
CNT_max
0x0000
EPWMxSYNCI
UP
UP
UP
UP
CTR_dir
DOWN
DOWN
DOWN
CTR = zero
CTR = PRD
CNT_max
30
ePWM Submodules
www.ti.com
0x0000
EPWMxSYNCI
UP
UP
UP
CTR_dir
DOWN
DOWN
DOWN
CTR = zero
CTR = PRD
CNT_max
2.3
CTR = PRD
Time-Base
(TB)
Action
Qualifier
(AQ)
CTR = CMPA
CTR = CMPB
CTR_Dir
CTR = 0
EPWMxINT
Event
Trigger
EPWMxSOCA
and
Interrupt
(ET)
ADC
EPWMxSOCB
CTR_Dir
EPWMxA
EPWMxA
Dead
Band
(DB)
CTR = CMPA
Counter
Compare
(CC)
PIE
PWMchopper
(PC)
Trip
Zone
(TZ)
GPIO
EPWMxB
CTR = CMPB
EPWMxB
MUX
CTR = 0
EPWMxTZINT
TZ1 to TZ6
PIE
31
ePWM Submodules
2.3.1
www.ti.com
2.3.2
Shadowed
CMPCTL
Register Name
0x0007
No
CMPAHR
0x0008
Yes
CMPA
0x0009
Yes
Counter-Compare A Register
CMPB
0x000A
Yes
Counter-Compare B Register
(1)
Description
(1)
This register is available only on ePWM modules with the high-resolution extension (HRPWM). On ePWM modules that do not
include the HRPWM this location is reserved. This register is described in the device-specific High-Resolution Pulse Width
Modulator (HRPWM) Reference Guide. Refer to the device specific data manual to determine which ePWM instances include
this feature.
TBCTR[15:0] 16
CTR = CMPA
CMPA[15:0]
CTR = PRD
CTR =0
Shadow
load
CMPCTL[LOADAMODE]
16
CMPA
Compare A Active Reg.
CMPA
Compare A Shadow Reg.
TBCTR[15:0]
Digital
comparator A
CMPCTL
[SHDWAFULL]
CMPCTL
[SHDWAMODE]
Action
Qualifier
(AQ)
Module
16
CTR = CMPB
CMPB[15:0] 16
CTR = PRD
CTR = 0
Shadow
load
CMPB
Compare B Active Reg.
CMPB
Compare B Shadow Reg.
Digital
comparator B
CMPCTL[SHDWBFULL]
CMPCTL[SHDWBMODE]
CMPCTL[LOADBMODE]
The key signals associated with the counter-compare submodule are described in Table 6.
32
ePWM Submodules
www.ti.com
2.3.3
Signal
Description of Event
Registers Compared
CTR = CMPA
TBCTR = CMPA
CTR = CMPB
TBCTR = CMPB
CTR = PRD
TBCTR = TBPRD
CTR = ZERO
TBCTR = 0x0000
2.3.4
33
ePWM Submodules
www.ti.com
To best illustrate the operation of the first three modes, the timing diagrams in Figure 16 through Figure 19
show when events are generated and how the EPWMxSYNCI signal interacts.
34
ePWM Submodules
www.ti.com
EPWMxSYNCI
CTR = CMPA
CTR = CMPB
NOTE: An EPWMxSYNCI external synchronization event can cause a discontinuity in the TBCTR count
sequence. This can lead to a compare event being skipped. This skipping is considered normal operation
and must be taken into account.
35
ePWM Submodules
www.ti.com
EPWMxSYNCI
CTR = CMPA
CTR = CMPB
36
ePWM Submodules
www.ti.com
EPWMxSYNCI
CTR = CMPB
CTR = CMPA
EPWMxSYNCI
CTR = CMPB
CTR = CMPA
2.4
37
ePWM Submodules
www.ti.com
EPWMxINT
Event
Trigger
EPWMxSOCA
and
Interrupt
CTR = 0
EPWMxSYNCI
EPWMxSYNCO
CTR = PRD
Time-Base
(TB)
Action
Qualifier
(AQ)
CTR = CMPA
CTR = CMPB
(ET)
CTR_Dir
CTR = 0
ADC
EPWMxSOCB
CTR_Dir
EPWMxA
EPWMxA
Dead
Band
(DB)
CTR = CMPA
Counter
Compare
(CC)
PIE
PWMchopper
(PC)
Trip
Zone
(TZ)
GPIO
EPWMxB
CTR = CMPB
EPWMxB
MUX
CTR = 0
TZ1 to TZ6
EPWMxTZINT
PIE
The action-qualifier submodule has the most important role in waveform construction and PWM
generation. It decides which events are converted into various action types, thereby producing the
required switched waveforms at the EPWMxA and EPWMxB outputs.
2.4.1
2.4.2
38
Address offset
Shadowed
Description
AQCTLA
0x000B
No
AQCTLB
0x000C
No
AQSFRC
0x000D
No
AQCSFRC
0x000E
Yes
ePWM Submodules
www.ti.com
EPWMA
AQCTLA[15:0]
Action-qualifier control A
CTR = PRD
AQCTLB[15:0]
Action-qualifier control B
CTR = Zero
CTR = CMPA
AQSFRC[15:0]
Action-qualifier S/W force
CTR = CMPB
EPWMB
AQCSFRC[3:0] (shadow)
continuous S/W force
CTR_dir
AQCSFRC[3:0] (active)
continuous S/W force
For convenience, the possible input events are summarized again in Table 8.
Table 8. Action-Qualifier Submodule Possible Input Events
Signal
Description
Registers Compared
CTR = PRD
TBCTR = TBPRD
CTR = Zero
TBCTR = 0x0000
CTR = CMPA
TBCTR = CMPA
CTR = CMPB
TBCTR = CMPB
The software forced action is a useful asynchronous event. This control is handled by registers AQSFRC
and AQCSFRC.
The action-qualifier submodule controls how the two outputs EPWMxA and EPWMxB behave when a
particular event occurs. The event inputs to the action-qualifier submodule are further qualified by the
counter direction (up or down). This allows for independent action on outputs on both the count-up and
count-down phases.
The possible actions imposed on outputs EPWMxA and EPWMxB are:
Set High:
Set output EPWMxA or EPWMxB to a high level.
Clear Low:
Set output EPWMxA or EPWMxB to a low level.
Toggle:
If EPWMxA or EPWMxB is currently pulled high, then pull the output low. If EPWMxA or EPWMxB is
currently pulled low, then pull the output high.
Do Nothing:
Keep outputs EPWMxA and EPWMxB at same level as currently set. Although the "Do Nothing" option
prevents an event from causing an action on the EPWMxA and EPWMxB outputs, this event can still
trigger interrupts and ADC start of conversion. See the Event-trigger Submodule description in
Section 2.8 for details.
39
ePWM Submodules
www.ti.com
Actions are specified independently for either output (EPWMxA or EPWMxB). Any or all events can be
configured to generate actions on a given output. For example, both CTR = CMPA and CTR = CMPB can
operate on output EPWMxA. All qualifier actions are configured via the control registers found at the end
of this section.
For clarity, the drawings in this document use a set of symbolic actions. These symbols are summarized in
Figure 22. Each symbol represents an action as a marker in time. Some actions are fixed in time (zero
and period) while the CMPA and CMPB actions are moveable and their time positions are programmed
via the counter-compare A and B registers, respectively. To turn off or disable an action, use the "Do
Nothing option"; it is the default at reset.
Figure 22. Possible Action-Qualifier Actions for EPWMxA and EPWMxB Outputs
TB Counter equals:
Actions
S/W
force
Zero
Comp
A
Comp
B
Period
SW
CA
CB
SW
CA
CB
SW
CA
CB
Do Nothing
Clear Low
Set High
SW
T
40
Z
T
CA
T
CB
T
P
T
Toggle
ePWM Submodules
www.ti.com
2.4.3
6 (Lowest)
Table 10 shows the action-qualifier priority for up-count mode. In this case, the counter direction is always
defined as up and thus down-count events will never be taken.
Table 10. Action-Qualifier Event Priority for Up-Count Mode
Priority Level
1 (Highest)
Event
Software forced event
5 (Lowest)
Table 11 shows the action-qualifier priority for down-count mode. In this case, the counter direction is
always defined as down and thus up-count events will never be taken.
Table 11. Action-Qualifier Event Priority for Down-Count Mode
Priority Level
Event
1 (Highest)
5 (Lowest)
It is possible to set the compare value greater than the period. In this case the action will take place as
shown in Table 12.
Table 12. Behavior if CMPA/CMPB is Greater than the Period
Counter Mode
Up-Count Mode
Never occurs.
41
ePWM Submodules
www.ti.com
2.4.4
Counter Mode
Up-Down-Count
Mode
The waveforms in this document show the ePWMs behavior for a static compare register
value. In a running system, the active compare registers (CMPA and CMPB) are typically
updated from their respective shadow registers once every period. The user specifies when
the update will take place; either when the time-base counter reaches zero or when the
time-base counter reaches period. There are some cases when the action based on the new
value can be delayed by one period or the action based on the old value can take effect for
an extra period. Some PWM configurations avoid this situation. These include, but are not
limited to, the following:
42
ePWM Submodules
www.ti.com
4
Mode: Up-Down Count
TBPRD = 4
CAU = SET, CAD = CLEAR
0% - 100% Duty
3
2
2
1
1
TBCTR
TBCTR Direction
UP
DOWN
UP
DOWN
Case 1:
CMPA = 4, 0% Duty
EPWMxA/EPWMxB
Case 2:
CMPA = 3, 25% Duty
EPWMxA/EPWMxB
Case 3:
CMPA = 2, 50% Duty
EPWMxA/EPWMxB
Case 3:
CMPA = 1, 75% Duty
EPWMxA/EPWMxB
Case 4:
CMPA = 0, 100% Duty
EPWMxA/EPWMxB
The PWM waveforms in Figure 24 through Figure 29 show some common action-qualifier configurations.
The C-code samples in Example 2 through Example 7 shows how to configure an ePWM module for each
case. Some conventions used in the figures and examples are as follows:
TBPRD, CMPA, and CMPB refer to the value written in their respective registers. The active register,
not the shadow register, is used by the hardware.
CMPx, refers to either CMPA or CMPB.
EPWMxA and EPWMxB refer to the output signals from ePWMx
Up-Down means Count-up-and-down mode, Up means up-count mode and Dwn means down-count
mode
Sym = Symmetric, Asym = Asymmetric
43
ePWM Submodules
www.ti.com
Figure 24. Up, Single Edge Asymmetric Waveform, With Independent Modulation on EPWMxA and
EPWMxBActive High
TBCTR
TBPRD
value
CB
CA
CB
CA
CB
CA
CB
CA
EPWMxA
EPWMxB
Duty modulation for EPWMxA is set by CMPA, and is active high (that is, high time duty proportional to CMPA).
Duty modulation for EPWMxB is set by CMPB and is active high (that is, high time duty proportional to CMPB).
The "Do Nothing" actions ( X ) are shown for completeness, but will not be shown on subsequent diagrams.
Actions at zero and period, although appearing to occur concurrently, are actually separated by one TBCLK period.
TBCTR wraps from period to 0000.
Example 2 contains a code sample showing initialization and run time for the waveforms in Figure 24.
Example 2. Code Sample for Figure 24
// Initialization Time
// = = = = = = = = = = = = = = = = = = = = = = =
EPwm1Regs.TBPRD = 600;
//
EPwm1Regs.CMPA.half.CMPA = 350;
//
EPwm1Regs.CMPB = 200;
//
EPwm1Regs.TBPHS = 0;
//
EPwm1Regs.TBCTR = 0;
//
EPwm1Regs.TBCTL.bit.CTRMODE = TB_COUNT_UP;
EPwm1Regs.TBCTL.bit.PHSEN = TB_DISABLE;
//
EPwm1Regs.TBCTL.bit.PRDLD = TB_SHADOW;
EPwm1Regs.TBCTL.bit.SYNCOSEL = TB_SYNC_DISABLE;
EPwm1Regs.TBCTL.bit.HSPCLKDIV = TB_DIV1;
//
EPwm1Regs.TBCTL.bit.CLKDIV = TB_DIV1;
EPwm1Regs.CMPCTL.bit.SHDWAMODE = CC_SHADOW;
EPwm1Regs.CMPCTL.bit.SHDWBMODE = CC_SHADOW;
EPwm1Regs.CMPCTL.bit.LOADAMODE = CC_CTR_ZERO; //
EPwm1Regs.CMPCTL.bit.LOADBMODE = CC_CTR_ZERO; //
EPwm1Regs.AQCTLA.bit.ZRO = AQ_SET;
EPwm1Regs.AQCTLA.bit.CAU = AQ_CLEAR;
EPwm1Regs.AQCTLB.bit.ZRO = AQ_SET;
EPwm1Regs.AQCTLB.bit.CBU = AQ_CLEAR;
//
// Run Time
// = = = = = = = = = = = = = = = = = = = = = = =
EPwm1Regs.CMPA.half.CMPA = Duty1A;
//
EPwm1Regs.CMPB = Duty1B;
//
44
=
Period = 601 TBCLK counts
Compare A = 350 TBCLK counts
Compare B = 200 TBCLK counts
Set Phase register to zero
clear TB counter
Phase loading disabled
TBCLK = SYSCLK
=
adjust duty for output EPWM1A
adjust duty for output EPWM1B
ePWM Submodules
www.ti.com
Figure 25. Up, Single Edge Asymmetric Waveform With Independent Modulation on EPWMxA and
EPWMxBActive Low
TBCTR
TBPRD
value
CA
CA
EPWMxA
CB
CB
EPWMxB
Duty modulation for EPWMxA is set by CMPA, and is active low (that is, the low time duty is proportional to CMPA).
Duty modulation for EPWMxB is set by CMPB and is active low (that is, the low time duty is proportional to CMPB).
Actions at zero and period, although appearing to occur concurrently, are actually separated by one TBCLK period.
TBCTR wraps from period to 0000.
Example 3 contains a code sample showing initialization and run time for the waveforms in Figure 25.
45
ePWM Submodules
www.ti.com
=
Period = 601 TBCLK counts
Compare A = 350 TBCLK counts
Compare B = 200 TBCLK counts
Set Phase register to zero
clear TB counter
Phase loading disabled
TBCLK = SYSCLKOUT
=
adjust duty for output EPWM1A
adjust duty for output EPWM1B
Figure 26. Up-Count, Pulse Placement Asymmetric Waveform With Independent Modulation on EPWMxA
TBCTR
TBPRD
value
CB
CA
CA
CB
EPWMxA
Z
T
Z
T
Z
T
EPWMxB
A
Pulse can be placed anywhere within the PWM cycle (0000 - TBPRD)
EPWMxB can be used to generate a 50% duty square wave with frequency =
( (TBPRD + 1 ) TBCLK )
Example 4 contains a code sample showing initialization and run time for the waveforms Figure 26. Use
the code in to define the headers.
46
ePWM Submodules
www.ti.com
47
ePWM Submodules
www.ti.com
Figure 27. Up-Down-Count, Dual Edge Symmetric Waveform, With Independent Modulation on EPWMxA
and EPWMxB Active Low
TBCTR
TBPRD
value
CA
CA
CA
CA
EPWMxA
CB
CB
CB
CB
EPWMxB
Duty modulation for EPWMxA is set by CMPA, and is active low (that is, the low time duty is proportional to CMPA).
Duty modulation for EPWMxB is set by CMPB and is active low (that is, the low time duty is proportional to CMPB).
Example 5 contains a code sample showing initialization and run time for the waveforms in Figure 27. Use
the code in to define the headers.
Example 5. Code Sample for Figure 27
// Initialization Time
// = = = = = = = = = = = = = = = = = = = = = = = =
EPwm1Regs.TBPRD = 600;
// Period = 2600 TBCLK counts
EPwm1Regs.CMPA.half.CMPA = 400;
// Compare A = 400 TBCLK counts
EPwm1Regs.CMPB = 500;
// Compare B = 500 TBCLK counts
EPwm1Regs.TBPHS = 0;
// Set Phase register to zero
EPwm1Regs.TBCTR = 0;
// clear TB counter
EPwm1Regs.TBCTL.bit.CTRMODE = TB_COUNT_UPDOWN; // Symmetric
xEPwm1Regs.TBCTL.bit.PHSEN = TB_DISABLE;
// Phase loading disabled
xEPwm1Regs.TBCTL.bit.PRDLD = TB_SHADOW;
EPwm1Regs.TBCTL.bit.SYNCOSEL = TB_SYNC_DISABLE;
EPwm1Regs.TBCTL.bit.HSPCLKDIV = TB_DIV1;
// TBCLK = SYSCLKOUT
EPwm1Regs.TBCTL.bit.CLKDIV = TB_DIV1;
EPwm1Regs.CMPCTL.bit.SHDWAMODE = CC_SHADOW;
EPwm1Regs.CMPCTL.bit.SHDWBMODE = CC_SHADOW;
EPwm1Regs.CMPCTL.bit.LOADAMODE = CC_CTR_ZERO; // load on CTR = Zero
EPwm1Regs.CMPCTL.bit.LOADBMODE = CC_CTR_ZERO; // load on CTR = Zero
EPwm1Regs.AQCTLA.bit.CAU = AQ_SET;
EPwm1Regs.AQCTLA.bit.CAD = AQ_CLEAR;
EPwm1Regs.AQCTLB.bit.CBU = AQ_SET;
EPwm1Regs.AQCTLB.bit.CBD = AQ_CLEAR;
//
// Run Time
// = = = = = = = = = = = = = = = = = = = = = = = =
EPwm1Regs.CMPA.half.CMPA = Duty1A;
// adjust duty for output EPWM1A
EPwm1Regs.CMPB = Duty1B;
// adjust duty for output EPWM1B
48
ePWM Submodules
www.ti.com
Figure 28. Up-Down-Count, Dual Edge Symmetric Waveform, With Independent Modulation on EPWMxA
and EPWMxB Complementary
TBCTR
TBPRD
value
CA
CA
CA
CA
EPWMxA
CB
CB
CB
CB
EPWMxB
Duty modulation for EPWMxA is set by CMPA, and is active low, i.e., low time duty proportional to CMPA
Duty modulation for EPWMxB is set by CMPB and is active high, i.e., high time duty proportional to CMPB
Dead-band = CMPB - CMPA (fully programmable edge placement by software). Note the dead-band module is also
available if the more classical edge delay method is required.
Example 6 contains a code sample showing initialization and run time for the waveforms in Figure 28. Use
the code in to define the headers.
Example 6. Code Sample for Figure 28
// Initialization Time
// = = = = = = = = = = = = = = = = = = = = = = = =
EPwm1Regs.TBPRD = 600;
// Period = 2600 TBCLK counts
EPwm1Regs.CMPA.half.CMPA = 350;
// Compare A = 350 TBCLK counts
EPwm1Regs.CMPB = 400;
// Compare B = 400 TBCLK counts
EPwm1Regs.TBPHS = 0;
// Set Phase register to zero
EPwm1Regs.TBCTR = 0;
// clear TB counter
EPwm1Regs.TBCTL.bit.CTRMODE = TB_COUNT_UPDOWN; // Symmetric
EPwm1Regs.TBCTL.bit.PHSEN = TB_DISABLE;
// Phase loading disabled
EPwm1Regs.TBCTL.bit.PRDLD = TB_SHADOW;
EPwm1Regs.TBCTL.bit.SYNCOSEL = TB_SYNC_DISABLE;
EPwm1Regs.TBCTL.bit.HSPCLKDIV = TB_DIV1;
// TBCLK = SYSCLKOUT
EPwm1Regs.TBCTL.bit.CLKDIV = TB_DIV1;
EPwm1Regs.CMPCTL.bit.SHDWAMODE = CC_SHADOW;
EPwm1Regs.CMPCTL.bit.SHDWBMODE = CC_SHADOW;
EPwm1Regs.CMPCTL.bit.LOADAMODE = CC_CTR_ZERO; // load on CTR = Zero
EPwm1Regs.CMPCTL.bit.LOADBMODE = CC_CTR_ZERO; // load on CTR = Zero
EPwm1Regs.AQCTLA.bit.CAU = AQ_SET;
EPwm1Regs.AQCTLA.bit.CAD = AQ_CLEAR;
EPwm1Regs.AQCTLB.bit.CBU = AQ_CLEAR;
EPwm1Regs.AQCTLB.bit.CBD = AQ_SET;
// Run Time
// = = = = = = = = = = = = = = = = = = = = = = = =
EPwm1Regs.CMPA.half.CMPA = Duty1A;
// adjust duty for output EPWM1A
EPwm1Regs.CMPB = Duty1B;
// adjust duty for output EPWM1B
49
ePWM Submodules
www.ti.com
Figure 29. Up-Down-Count, Dual Edge Asymmetric Waveform, With Independent Modulation on
EPWMxAActive Low
TBCTR
CA
CA
CB
CB
EPWMxA
EPWMxB
A
Rising edge and falling edge can be asymmetrically positioned within a PWM cycle. This allows for pulse placement
techniques.
To change this example to active high, CMPA and CMPB actions need to be inverted (i.e., Set ! Clear and Clear Set).
Duty modulation for EPWMxB is fixed at 50% (utilizes spare action resources for EPWMxB)
Example 7 contains a code sample showing initialization and run time for the waveforms in Figure 29. Use
the code in to define the headers.
Example 7. Code Sample for Figure 29
// Initialization Time
// = = = = = = = = = = = = = = = = = = = = = = = =
EPwm1Regs.TBPRD = 600;
//
EPwm1Regs.CMPA.half.CMPA = 250;
//
EPwm1Regs.CMPB = 450;
//
EPwm1Regs.TBPHS = 0;
//
EPwm1Regs.TBCTR = 0;
//
EPwm1Regs.TBCTL.bit.CTRMODE = TB_COUNT_UPDOWN; //
EPwm1Regs.TBCTL.bit.PHSEN = TB_DISABLE;
//
EPwm1Regs.TBCTL.bit.PRDLD = TB_SHADOW;
EPwm1Regs.TBCTL.bit.SYNCOSEL = TB_SYNC_DISABLE;
EPwm1Regs.TBCTL.bit.HSPCLKDIV = TB_DIV1;
//
EPwm1Regs.TBCTL.bit.CLKDIV = TB_DIV1;
EPwm1Regs.CMPCTL.bit.SHDWAMODE = CC_SHADOW;
EPwm1Regs.CMPCTL.bit.SHDWBMODE = CC_SHADOW;
EPwm1Regs.CMPCTL.bit.LOADAMODE = CC_CTR_ZERO; //
EPwm1Regs.CMPCTL.bit.LOADBMODE = CC_CTR_ZERO; //
EPwm1Regs.AQCTLA.bit.CAU = AQ_SET;
EPwm1Regs.AQCTLA.bit.CBD = AQ_CLEAR;
EPwm1Regs.AQCTLB.bit.ZRO = AQ_CLEAR;
EPwm1Regs.AQCTLB.bit.PRD = AQ_SET;
// Run Time
// = = = = = = = = = = = = = = = = = = = = = = = =
EPwm1Regs.CMPA.half.CMPA = EdgePosA;
//
EPwm1Regs.CMPB = EdgePosB;
50
TBCLK = SYSCLKOUT
ePWM Submodules
www.ti.com
2.5
CTR = PRD
Time-Base
(TB)
Action
Qualifier
(AQ)
CTR = CMPA
CTR = CMPB
CTR_Dir
CTR = 0
EPWMxINT
Event
Trigger
EPWMxSOCA
and
Interrupt
(ET)
ADC
EPWMxSOCB
CTR_Dir
EPWMxA
EPWMxA
Dead
Band
(DB)
CTR = CMPA
Counter
Compare
(CC)
PIE
PWMchopper
(PC)
Trip
Zone
(TZ)
GPIO
EPWMxB
CTR = CMPB
EPWMxB
MUX
CTR = 0
EPWMxTZINT
TZ1 to TZ6
PIE
2.5.1
2.5.2
Address offset
Shadowed
DBCTL
0x000F
No
DBRED
0x0010
No
DBFED
0x0011
No
Description
51
ePWM Submodules
2.5.3
www.ti.com
EPWMxA in
0 S4
Rising edge
delay
In
EPWMxA
RED
Out
(10-bit
counter)
Falling edge
delay
In
0 S1
0 S5
0 S2
0 S3
FED
1 S0
EPWMxB
Out
1
(10-bit
counter)
DBCTL[IN_MODE]
DBCTL[POLSEL]
DBCTL[OUT_MODE]
EPWMxB in
Although all combinations are supported, not all are typical usage modes. Table 14 documents some
classical dead-band configurations. These modes assume that the DBCTL[IN_MODE] is configured such
that EPWMxA In is the source for both falling-edge and rising-edge delay. Enhanced, or non-traditional
modes can be achieved by changing the input signal source. The modes shown in Table 14 fall into the
following categories:
Mode 1: Bypass both falling-edge delay (FED) and rising-edge delay (RED)
Allows you to fully disable the dead-band submodule from the PWM signal path.
Mode 2-5: Classical Dead-Band Polarity Settings:
These represent typical polarity configurations that should address all the active high/low modes
required by available industry power switch gate drivers. The waveforms for these typical cases are
shown in Figure 32. Note that to generate equivalent waveforms to Figure 32, configure the
action-qualifier submodule to generate the signal as shown for EPWMxA.
52
ePWM Submodules
www.ti.com
DBCTL[POLSEL]
Mode Description
DBCTL[OUT_MODE]
S3
S2
S1
S0
0 or 1
0 or 1
0 or 1
0 or 1
6
7
Figure 32 shows waveforms for typical cases where 0% < duty < 100%.
Figure 32. Dead-Band Waveforms for Typical Cases (0% < Duty < 100%)
Period
Original
(outA)
RED
Rising Edge
Delayed (RED)
FED
Falling Edge
Delayed (FED)
Active High
Complementary
(AHC)
Active Low
Complementary
(ALC)
Active High
(AH)
Active Low
(AL)
53
ePWM Submodules
www.ti.com
The dead-band submodule supports independent values for rising-edge (RED) and falling-edge (FED)
delays. The amount of delay is programmed using the DBRED and DBFED registers. These are 10-bit
registers and their value represents the number of time-base clock, TBCLK, periods a signal edge is
delayed by. For example, the formula to calculate falling-edge-delay and rising-edge-delay are:
FED = DBFED TTBCLK
RED = DBRED TTBCLK
Where TTBCLK is the period of TBCLK, the prescaled version of SYSCLKOUT.
For convenience, delay values for various TBCLK options are shown in Table 15.
Table 15. Dead-Band Delay Values in S as a Function of DBFED and DBRED
Dead-Band Delay in S
Dead-Band Value
54
DBFED, DBRED
TBCLK = SYSCLKOUT/1
TBCLK = SYSCLKOUT /2
TBCLK = SYSCLKOUT/4
0.01 S
0.02 S
0.04 S
0.05 S
0.10 S
0.20 S
10
0.10 S
0.20 S
0.40 S
100
1.00 S
2.00 S
4.00 S
200
2.00 S
4.00 S
8.00 S
300
3.00 S
6.00 S
12.00 S
400
4.00 S
8.00 S
16.00 S
500
5.00 S
10.00 S
20.00 S
600
6.00 S
12.00 S
24.00 S
700
7.00 S
14.00 S
28.00 S
800
8.00 S
16.00 S
32.00 S
900
9.00 S
18.00 S
36.00 S
1000
10.00 S
20.00 S
40.00 S
ePWM Submodules
www.ti.com
2.6
CTR = PRD
Time-Base
(TB)
Action
Qualifier
(AQ)
CTR = CMPA
CTR = CMPB
CTR_Dir
CTR = 0
EPWMxINT
Event
Trigger
EPWMxSOCA
and
Interrupt
(ET)
ADC
EPWMxSOCB
CTR_Dir
EPWMxA
EPWMxB
Dead
Band
(DB)
CTR = CMPA
Counter
Compare
(CC)
PIE
PWMchopper
(PC)
Trip
Zone
(TZ)
GPIO
EPWMxB
CTR = CMPB
EPWMxA
MUX
CTR = 0
TZ1 to TZ6
EPWMxTZINT
PIE
The PWM-chopper submodule allows a high-frequency carrier signal to modulate the PWM waveform
generated by the action-qualifier and dead-band submodules. This capability is important if you need
pulse transformer-based gate drivers to control the power switching elements.
2.6.1
2.6.2
2.6.3
mnemonic
Address offset
Shadowed
PCCTL
0x001E
No
Description
PWM-chopper Control Register
55
ePWM Submodules
www.ti.com
Start
One
shot
OSHT
PWMA_ch
Clk
Pulse-width
SYSCLKOUT
/8
PCCTL
[OSHTWTH]
PCCTL
[OSHTWTH]
Pulse-width
Divider and
duty control
PCCTL
[CHPEN]
PSCLK
PCCTL[CHPFREQ]
PCCTL[CHPDUTY]
Clk
One
shot
EPWMxB
PWMB_ch
1
OSHT
EPWMxB
Start
Bypass
2.6.4
Waveforms
Figure 35 shows simplified waveforms of the chopping action only; one-shot and duty-cycle control are not
shown. Details of the one-shot and duty-cycle control are discussed in the following sections.
Figure 35. Simple PWM-Chopper Submodule Waveforms Showing Chopping Action Only
EPWMxA
EPWMxB
PSCLK
EPWMxA
EPWMxB
56
ePWM Submodules
www.ti.com
2.6.4.1
One-Shot Pulse
The width of the first pulse can be programmed to any of 16 possible pulse width values. The width or
period of the first pulse is given by:
T1stpulse = TSYSCLKOUT 8 OSHTWTH
Where TSYSCLKOUT is the period of the system clock (SYSCLKOUT) and OSHTWTH is the four control bits
(value from 1 to 16)
Figure 36 shows the first and subsequent sustaining pulses and Table 7.3 gives the possible pulse width
values for a SYSCLKOUT = 100 MHz.
Figure 36. PWM-Chopper Submodule Waveforms Showing the First Pulse and Subsequent Sustaining
Pulses
Start OSHT pulse
EPWMxA in
PSCLK
Prog. pulse width
(OSHTWTH)
OSHT
EPWMxA out
Sustaining pulses
Pulse Width
(nS)
80
160
240
320
400
480
560
640
720
800
880
960
1040
1120
1200
1280
57
ePWM Submodules
2.6.4.2
www.ti.com
Pulse transformer-based gate drive designs need to comprehend the magnetic properties or
characteristics of the transformer and associated circuitry. Saturation is one such consideration. To assist
the gate drive designer, the duty cycles of the second and subsequent pulses have been made
programmable. These sustaining pulses ensure the correct drive strength and polarity is maintained on the
power switch gate during the on period, and hence a programmable duty cycle allows a design to be
tuned or optimized via software control.
Figure 37 shows the duty cycle control that is possible by programming the CHPDUTY bits. One of seven
possible duty ratios can be selected ranging from 12.5% to 87.5%.
Figure 37. PWM-Chopper Submodule Waveforms Showing the Pulse Width (Duty Cycle) Control of
Sustaining Pulses
PSCLK
PSCLK
period
75%
50%
25%
62.5% 37.5%
87.5%
12.5%
PSCLK Period
Duty
1/8
Duty
2/8
Duty
3/8
Duty
4/8
Duty
5/8
Duty
6/8
Duty
7/8
58
ePWM Submodules
www.ti.com
2.7
CTR = PRD
Time-Base
(TB)
Action
Qualifier
(AQ)
CTR = CMPA
CTR = CMPB
CTR_Dir
CTR = 0
EPWMxINT
Event
Trigger
EPWMxSOCA
and
Interrupt
(ET)
ADC
EPWMxSOCB
CTR_Dir
EPWMxA
EPWMxA
Dead
Band
(DB)
CTR = CMPA
Counter
Compare
(CC)
PIE
PWMchopper
(PC)
Trip
Zone
(TZ)
GPIO
EPWMxB
CTR = CMPB
EPWMxB
MUX
CTR = 0
EPWMxTZINT
TZ1 to TZ6
PIE
Each ePWM module is connected to six TZn signals (TZ1 to TZ6) that are sourced from the GPIO MUX.
These signals indicate external fault or trip conditions, and the ePWM outputs can be programmed to
respond accordingly when faults occur.
2.7.1
59
ePWM Submodules
2.7.2
www.ti.com
(1)
2.7.3
Description
(1)
Register Name
Address offset
Shadowed
No
TZSEL
0x0012
reserved
0x0013
TZCTL
0x0014
No
TZEINT
0x0015
No
TZFLG
0x0016
No
TZCLR
0x0017
No
TZFRC
0x0018
No
All trip-zone registers are EALLOW protected and can be modified only after executing the EALLOW instruction. For more
information, see the device-specific version of the System Control and Interrupts Reference Guide listed in Section 1.
Cycle-by-Cycle (CBC):
When a cycle-by-cycle trip event occurs, the action specified in the TZCTL register is carried out
immediately on the EPWMxA and/or EPWMxB output. Table 19 lists the possible actions. In addition,
the cycle-by-cycle trip event flag (TZFLG[CBC]) is set and a EPWMx_TZINT interrupt is generated if it
is enabled in the TZEINT register and PIE peripheral.
The specified condition on the pins is automatically cleared when the ePWM time-base counter
reaches zero (TBCTR = 0x0000) if the trip event is no longer present. Therefore, in this mode, the trip
event is cleared or reset every PWM cycle. The TZFLG[CBC] flag bit will remain set until it is manually
cleared by writing to the TZCLR[CBC] bit. If the cycle-by-cycle trip event is still present when the
TZFLG[CBC] bit is cleared, then it will again be immediately set.
One-Shot (OSHT):
When a one-shot trip event occurs, the action specified in the TZCTL register is carried out
immediately on the EPWMxA and/or EPWMxB output. Table 19 lists the possible actions. In addition,
the one-shot trip event flag (TZFLG[OST]) is set and a EPWMx_TZINT interrupt is generated if it is
enabled in the TZEINT register and PIE peripheral. The one-shot trip condition must be cleared
manually by writing to the TZCLR[OST] bit.
The action taken when a trip event occurs can be configured individually for each of the ePWM output
pins by way of the TZCTL[TZA] and TZCTL[TZB] register bits fields. One of four possible actions, shown
in Table 19, can be taken on a trip event.
60
ePWM Submodules
www.ti.com
EPWMxA
and/or
EPWMxB
Comment
0,0
High-Impedance
Tripped
0,1
Tripped
1,0
Tripped
1,1
No Change
Do Nothing.
No change is made to the output.
2.7.4
61
ePWM Submodules
www.ti.com
Trip
logic
Clear
Latch
cycby-cyc
mode
(CBC)
CTR=zero
TZFRC[CBC]
Trip
EPWMxA
EPWMxB
CBC
trip event
Set
TZ1
TZ2
TZ3
TZ4
TZ5
TZ6
Set
Sync
TZFLG[CBC]
TZCLR[CBC]
Clear
TZSEL[CBC1 to CBC6]
Clear
Latch
one-shot
mode
(OSHT)
Set
TZCLR[OST]
TZFRC[OSHT]
TZ1
TZ2
TZ3
TZ4
TZ5
TZ6
Trip
OSHT
trip event
Sync
Async Trip
TZSEL[OSHT1 to OSHT6]
Set
TZFLG[OST]
Clear
62
ePWM Submodules
www.ti.com
TZCLR[INT]
TZFLG[CBC]
Clear
Clear
Latch
TZCLR[CBC]
Latch
Set
CBC
trip event
Set
TZEINT[CBC]
TZFLG[OST]
EPWMx_TZINT
(PIE)
Generate
interrupt
pulse when
input=1
Clear
Latch
OSHT
trip event
Set
TZEINT[OST]
2.8
TZCLR[OST]
CTR = CMPA
Event
Trigger
and
CTR = CMPB
Interrupt
CTR = 0
EPWMxSYNCI
EPWMxSYNCO
CTR = PRD
Time-Base
(TB)
Action
Qualifier
(AQ)
CTR_Dir
CTR = 0
(ET)
EPWMxSOCB
EPWMxA
Dead
Band
(DB)
CTR = CMPA
CTR = CMPB
PWMchopper
(PC)
Trip
Zone
(TZ)
EPWMxB
EPWMB
CTR = 0
EPWMxTZINT
2.8.1
EPWMxSOCA
CTR_Dir
EPWMA
Counter
Compare
(CC)
EPWMxINT
TZ1 to TZ6
63
ePWM Submodules
www.ti.com
Each ePWM module has one interrupt request line connected to the PIE and two start of conversion
signals (one for each sequencer) connected to the ADC module. As shown in Figure 42, ADC start of
conversion for all ePWM modules are ORed together and hence multiple modules can initiate an ADC
start of conversion. If two requests occur on one start of conversion line, then only one will be recognized
by the ADC.
Figure 42. Event-Trigger Submodule Inter-Connectivity of ADC Start of Conversion
EXTSOCAG1
POLSEL
0
EXTSOCAG1
1
ePWM1SOCA
ePWM1
ePWM1SOCB
EXTSOCBG1
POLSEL
ePWM2SOCA
ePWM2
ePWM2SOCB
ePWM3SOCA
ePWM3
ePWM3SOCB
EXTSOCAG4
POLSEL
ePWM4SOCA
ePWM4
0
ePWM4SOCB
EXTSOCAG4
1
ePWM5SOCA
ePWM5
ePWM5SOCB
EXTSOCBG4
POLSEL
ePWM6SOCA
ePWM6
EXTSOCBG4
ePWM6SOCB
1
ePWM7SOCA
ePWM7
ePWM7SOCB
ePWM8SOCA
ePWM8
EXTSOCAG7
POLSEL
ePWM4SOCB
Pulse Stretcher,
32 HSPCLK Cycles Wide and Then to Chip Pins
EXTSOCSBG1
0
EXTSOCAG7
ePWM9SOCA
ePWM9
ePWM9SOCB
EXTSOCBG7
POLSEL
0
EXTSOCBG7
1
The event-trigger submodule monitors various event conditions (the left side inputs to event-trigger
submodule shown in Figure 43) and can be configured to prescale these events before issuing an
Interrupt request or an ADC start of conversion. The event-trigger prescaling logic can issue Interrupt
requests and ADC start of conversion at:
Every event
64
ePWM Submodules
www.ti.com
Event Trigger
Module Logic
CTR=PRD
EPWMxINTn
PIE
count
CTRU=CMPA
CTR=CMPA
clear
ETSEL reg
CTRD=CMPA
Direction
qualifier
CTR=CMPB
/n
CTRU=CMPB
/n
EPWMxSOCA
ETPS reg
count
CTRD=CMPB
ETFLG reg
ADC
clear
EPWMxSOCB
ETCLR reg
/n
CTR_dir
ETFRC reg
count
The key registers used to configure the event-trigger submodule are shown in Table 20:
Table 20. Event-Trigger Submodule Registers
Register Name
Address offset
Shadowed
ETSEL
0x0019
No
Description
Event-trigger Selection Register
ETPS
0x001A
No
ETFLG
0x001B
No
ETCLR
0x001C
No
ETFRC
0x001D
No
ETSELThis selects which of the possible events will trigger an interrupt or start an ADC conversion
ETPSThis programs the event prescaling options mentioned above.
ETFLGThese are flag bits indicating status of the selected and prescaled events.
ETCLRThese bits allow you to clear the flag bits in the ETFLG register via software.
ETFRCThese bits allow software forcing of an event. Useful for debugging or s/w intervention.
A more detailed look at how the various register bits interact with the Interrupt and ADC start of
conversion logic are shown in Figure 44, Figure 45, and Figure 46.
Figure 44 shows the event-trigger's interrupt generation logic. The interrupt-period (ETPS[INTPRD]) bits
specify the number of events required to cause an interrupt pulse to be generated. The choices available
are:
Do not generate an interrupt.
Generate an interrupt on every event
Generate an interrupt on every second event
Generate an interrupt on every third event
Which event can cause an interrupt is configured by the interrupt selection (ETSEL[INTSEL]) bits. The
event can be one of the following:
Time-base counter equal to zero (TBCTR = 0x0000).
Time-base counter equal to period (TBCTR = TBPRD).
Time-base counter equal to the compare A register (CMPA) when the timer is incrementing.
Time-base counter equal to the compare A register (CMPA) when the timer is decrementing.
SPRUG04A October 2008 Revised July 2009
Submit Documentation Feedback
65
ePWM Submodules
www.ti.com
Time-base counter equal to the compare B register (CMPB) when the timer is incrementing.
Time-base counter equal to the compare B register (CMPB) when the timer is decrementing.
The number of events that have occurred can be read from the interrupt event counter (ETPS[INTCNT])
register bits. That is, when the specified event occurs the ETPS[INTCNT] bits are incremented until they
reach the value specified by ETPS[INTPRD]. When ETPS[INTCNT] = ETPS[INTPRD] the counter stops
counting and its output is set. The counter is only cleared when an interrupt is sent to the PIE.
When ETPS[INTCNT] reaches ETPS[INTPRD] the following behaviors will occur:
If interrupts are enabled, ETSEL[INTEN] = 1 and the interrupt flag is clear, ETFLG[INT] = 0, then an
interrupt pulse is generated and the interrupt flag is set, ETFLG[INT] = 1, and the event counter is
cleared ETPS[INTCNT] = 0. The counter will begin counting events again.
If interrupts are disabled, ETSEL[INTEN] = 0, or the interrupt flag is set, ETFLG[INT] = 1, the counter
stops counting events when it reaches the period value ETPS[INTCNT] = ETPS[INTPRD].
If interrupts are enabled, but the interrupt flag is already set, then the counter will hold its output high
until the ENTFLG[INT] flag is cleared. This allows for one interrupt to be pending while one is serviced.
Writing to the INTPRD bits will automatically clear the counter INTCNT = 0 and the counter output will be
reset (so no interrupts are generated). Writing a 1 to the ETFRC[INT] bit will increment the event counter
INTCNT. The counter will behave as described above when INTCNT = INTPRD. When INTPRD = 0, the
counter is disabled and hence no events will be detected and the ETFRC[INT] bit is also ignored.
The above definition means that you can generate an interrupt on every event, on every second event, or
on every third event. An interrupt cannot be generated on every fourth or more events.
Figure 44. Event-Trigger Interrupt Generator
ETCLR[INT]
Clear
Set
Latch
ETFLG[INT]
ETPS[INTCNT]
EPWMxINT
Generate
interrupt
pulse
when
input = 1
ETSEL[INTSEL]
0
Clear CNT
2-bit
Counter
ETFRC[INT]
Inc CNT
ETSEL[INT]
ETPS[INTPRD]
000
001
010
011
100
101
101
111
0
CTR=Zero
CTR=PRD
0
CTRU=CMPA
CTRD=CMPA
CTRU=CMPB
CTRD=CMPB
Figure 45 shows the operation of the event-trigger's start-of-conversion-A (SOCA) pulse generator. The
ETPS[SOCACNT] counter and ETPS[SOCAPRD] period values behave similarly to the interrupt generator
except that the pulses are continuously generated. That is, the pulse flag ETFLG[SOCA] is latched when a
pulse is generated, but it does not stop further pulse generation. The enable/disable bit ETSEL[SOCAEN]
stops pulse generation, but input events can still be counted until the period value is reached as with the
interrupt generation logic. The event that will trigger an SOCA and SOCB pulse can be configured
separately in the ETSEL[SOCASEL] and ETSEL[SOCBSEL] bits. The possible events are the same
events that can be specified for the interrupt generation logic .
66
ePWM Submodules
www.ti.com
Clear
Latch
Set
ETFLG[SOCA]
ETPS[SOCACNT]
ETSEL[SOCASEL]
Generate
SOC
pulse
when
input = 1
SOCA
Clear CNT
2-bit
Counter
ETFRC[SOCA]
000
001
010
011
100
101
101
111
Inc CNT
ETSEL[SOCAEN]
ETPS[SOCAPRD]
0
CTR=Zero
CTR=PRD
0
CTRU=CMPA
CTRD=CMPA
CTRU=CMPB
CTRD=CMPB
Figure 46 shows the operation of the event-trigger's start-of-conversion-B (SOCB) pulse generator. The
event-trigger's SOCB pulse generator operates the same way as the SOCA.
Figure 46. Event-Trigger SOCB Pulse Generator
ETCLR[SOCB]
Clear
Latch
Set
ETFLG[SOCB]
ETPS[SOCBCNT]
ETSEL[SOCBSEL]
SOCB
Generate
SOC
pulse
when
input = 1
Clear CNT
ETFRC[SOCB]
2-bit
Counter
Inc CNT
ETSEL[SOCBEN]
ETPS[SOCBPRD]
000
001
010
011
100
101
101
111
0
CTR=Zero
CTR=PRD
0
CTRU=CMPA
CTRD=CMPA
CTRU=CMPB
CTRD=CMPB
67
www.ti.com
3.1
SyncIn
Phase reg
EN
=0
EPWMxA
EPWMxB
CTR = 0
CTR=CMPB
X
SyncOut
3.2
68
www.ti.com
Slave
Phase reg
SyncIn
Phase reg EN
=0
EN
3.3
=0
EPWM1A
EPWM1B
CTR=0
CTR=CMPB
X
1
SyncIn
SyncOut
EPWM2A
EPWM2B
CTR=0
CTR=CMPB
X
2
SyncOut
69
www.ti.com
Figure 49. Control of Four Buck Stages. Here FPWM1 FPWM2 FPWM3 FPWM4
Ext SyncIn
(optional)
Master1
Phase reg
=X
SyncIn
En
Vin1
EPWM1B
CTR=zero
CTR=CMPB
X
1
Buck #1
EPWM1A
SyncOut
Master2
Phase reg
=X
SyncIn
Vin2
Vout2
En
EPWM2A
Buck #2
EPWM2B
CTR=zero
CTR=CMPB
X
EPWM2A
SyncOut
Master3
Phase reg
=X
SyncIn
Vin3
En
Vout3
EPWM3A
Buck #3
EPWM3B
CTR=zero
CTR=CMPB
X
EPWM3A
SyncOut
Master4
Phase reg
=X
Vin4
SyncIn
Vout4
En
EPWM4A
Buck #4
EPWM4B
CTR=zero
CTR=CMPB
X
3
Vout1
EPWM1A
EPWM4A
SyncOut
NOTE: = X indicates value in phase register is a "don't care"
70
www.ti.com
Figure 50. Buck Waveforms for Figure 49 (Note: Only three bucks shown here)
P
I
P
I
P
I
700
950
CA
CB
A
1200
CA
EPWM1A
Pulse center
700
1150
CA
CB
A
1400
CA
EPWM2A
650
500
CA
800
CA
CA
CB
A
EPWM3A
P
I
CB
A
71
www.ti.com
72
www.ti.com
3.4
Ext SyncIn
(optional)
Master
Phase reg
=0
Vout1
EPWM1A
SyncIn
En
EPWM1A
Vin2
EPWM1B
CTR=zero
CTR=CMPB
Vout2
Buck #2
EPWM1B
X
SyncOut
Vin3
Buck #3
Slave
Phase reg
=X
Vout3
EPWM2A
SyncIn
En
EPWM2A
EPWM2B
CTR=zero
CTR=CMPB
X
Vin4
Vout4
Buck #4
SyncOut
EPWM2B
73
www.ti.com
Z
I
400
Z
I
Z
I
400
200
200
CA
P
A
CA
CA
P
A
CA
EPWM1A
CB
CB
CB
CB
EPWM1B
500
500
300
300
CA
CA
CA
CA
EPWM2A
CB
CB
CB
CB
EPWM2B
74
www.ti.com
75
3.5
www.ti.com
Ext SyncIn
(optional)
Master
Phase reg
En
=0
SyncIn
EPWM1A
EPWM1A
EPWM1B
CTR=zero
CTR=CMPB
X
EPWM1B
SyncOut
Slave
Phase reg
En
=0
Vout1
SyncIn
VDC_bus
EPWM2A
Vout2
EPWM2B
CTR=zero
CTR=CMPB
X
EPWM2A
SyncOut
EPWM2B
76
www.ti.com
Figure 54. Half-H Bridge Waveforms for Figure 53 (Note: Here FPWM2 = FPWM1 )
Z
I
Z
I
600
400
400
200
200
CB
A
Z
I
CA
CB
A
CA
EPWM1A
CA
CB
A
CA
CB
A
CA
CB
A
EPWM1B
Pulse Center
500
500
250
CB
A
250
CA
CB
A
CA
EPWM2A
CA
CB
A
EPWM2B
Pulse Center
77
www.ti.com
3.6
78
www.ti.com
Figure 55. Control of Dual 3-Phase Inverter Stages as Is Commonly Used in Motor Control
Ext SyncIn
(optional)
Master
Phase reg
En
SyncIn
=0
EPWM1A
CTR=zero
CTR=CMPB
X
1
SyncOut
Slave
Phase reg
En
EPWM2A
CTR=zero
CTR=CMPB
X
2
SyncOut
EPWM2A
EPWM1A
SyncIn
=0
Slave
Phase reg
En
EPWM1B
EPWM3A
VAB
VCD
EPWM2B
VEF
EPWM1B
EPWM2B
EPWM3B
3 phase motor
SyncIn
=0
EPWM3A
CTR=zero
CTR=CMPB
X
3
SyncOut
3 phase inverter #1
EPWM3B
Slave
Phase reg
SyncIn
En
=0
EPWM4A
CTR=zero
CTR=CMPB
X
4
SyncOut
Slave
Phase reg
En
EPWM4A
SyncIn
=0
EPWM5A
EPWM6A
VAB
EPWM5A
CTR=zero
CTR=CMPB
X
5
SyncOut
Slave
Phase reg
En
EPWM4B
VCD
VEF
EPWM5B
EPWM4B
EPWM5B
EPWM6B
3 phase motor
SyncIn
=0
CTR=zero
CTR=CMPB
X
6
SyncOut
EPWM6A
3 phase inverter #2
EPWM6B
79
www.ti.com
Figure 56. 3-Phase Inverter Waveforms for Figure 55 (Only One Inverter Shown)
Z
I
Z
I
800
500
500
CA
CA
P
A
EPWM1A
CA
CA
P
A
RED
RED
EPWM1B
FED
FED
2=0
600
600
CA
CA
CA
CA
EPWM2A
RED
EPWM2B
FED
700
3=0
CA
EPWM3A
EPWM3B
80
700
CA
CA
CA
RED
FED
www.ti.com
81
3.7
www.ti.com
SyncIn
En
=0
EPWM1A
EPWM1B
CTR=zero
CTR=CMPB
X
1
SyncOut
Slave
Phase reg
SyncIn
En
=120
EPWM2A
EPWM2B
CTR=zero
CTR=CMPB
X
2
SyncOut
Figure 58 shows the associated timing waveforms for this configuration. Here, TBPRD = 600 for both
master and slave. For the slave, TBPHS = 200 (i.e., 200/600 X 360 = 120). Whenever the master
generates a SyncIn pulse (CTR = PRD), the value of TBPHS = 200 is loaded into the slave TBCTR
register so the slave time-base is always leading the master's time-base by 120.
82
www.ti.com
Figure 58. Timing Waveforms Associated With Phase Control Between 2 Modules
FFFFh
TBCTR[0-15]
Master Module
600
600
TBPRD
0000
CTR = PRD
(SycnOut)
FFFFh
time
TBCTR[0-15]
2
Phase = 120
Slave Module
TBPRD
600
600
200
TBPHS
200
0000
SyncIn
3.8
time
83
www.ti.com
SyncIn
VIN
En
EPWM1A
EPWM1B
CTR=zero
CTR=CMPB
X
1
EPWM1A
EPWM2A
EPWM3A
EPWM1B
EPWM2B
EPWM3B
SyncOut
Slave
Phase reg
=120
SyncIn
VOUT
En
EPWM2A
EPWM2B
CTR=zero
CTR=CMPB
X
2
SyncOut
Slave
Phase reg
SyncIn
En
=240
EPWM3A
EPWM3B
CTR=zero
CTR=CMPB
X
3
84
SyncOut
www.ti.com
285
CA
EPWM1A
285
P
A
CA
CA
RED
P
A
FED
Z
I
CA
CA
RED
EPWM1B
300
Z
I
Z
I
450
P
A
CA
RED
FED
FED
2=120
TBPHS
(=300)
EPWM2A
EPWM2B
300
2=120
TBPHS
(=300)
EPWM3A
EPWM3B
85
www.ti.com
86
www.ti.com
3.9
SyncIn
En
EPWM1A
CTR=zero
CTR=CMPB
X
Slave
Phase reg
=Var
Vout
VDC_bus
EPWM1B
SyncOut
EPWM1A
EPWM2A
EPWM1B
EPWM2B
SyncIn
En
CTR=zero
CTR=CMPB
X
EPWM2A
EPWM2B
SyncOut
Var = Variable
87
www.ti.com
Z
I
Z
I
1200
600
200
Z
CB
A
CA
CB
A
CA
RED
ZVS transition
EPWM1A
Power phase
FED
ZVS transition
EPWM1B
300
TBPHS
=(12002)
2=variable
CB
A
Z
CA
CB
A
Z
CA
RED
EPWM2A
EPWM2B
FED
Power phase
88
www.ti.com
89
Registers
www.ti.com
Registers
This chapter includes the register layouts and bit description for the submodules.
4.1
15
0
TBPRD
R/W-0
Name
Value
15-0
TBPRD
0000- These bits determine the period of the time-base counter. This sets the PWM frequency.
FFFFh
Shadowing of this register is enabled and disabled by the TBCTL[PRDLD] bit. By default this register
is shadowed.
If TBCTL[PRDLD] = 0, then the shadow is enabled and any write or read will automatically go to
the shadow register. In this case, the active register will be loaded from the shadow register
when the time-base counter equals zero.
If TBCTL[PRDLD] = 1, then the shadow is disabled and any write or read will go directly to the
active register, that is the register actively controlling the hardware.
The active and shadow registers share the same memory map address.
Description
0
TBPHS
R/W-0
Name
15-0
TBPHS
Value
Description
0000-FFFF These bits set time-base counter phase of the selected ePWM relative to the time-base that is
supplying the synchronization input signal.
If TBCTL[PHSEN] = 0, then the synchronization event is ignored and the time-base counter is
not loaded with the phase.
If TBCTL[PHSEN] = 1, then the time-base counter (TBCTR) will be loaded with the phase
(TBPHS) when a synchronization event occurs. The synchronization event can be initiated by
the input synchronization signal (EPWMxSYNCI) or by a software forced synchronization.
0
TBCTR
R/W-0
Name
Value
Description
15-0
TBCTR
0000FFFF
90
Registers
www.ti.com
14
13
12
10
FREE, SOFT
PHSDIR
CLKDIV
HSPCLKDIV
R/W-0
R/W-0
R/W-0
R/W-0,0,1
HSPCLKDIV
SWFSYNC
5
SYNCOSEL
PRDLD
PHSEN
1
CTRMODE
R/W-0,0,1
R/W-0
R/W-0
R/W-0
R/W-0
R/W-11
Field
Value
FREE, SOFT
Description
Emulation Mode Bits. These bits select the behavior of the ePWM time-base counter during
emulation events:
00
01
1X
13
PHSDIR
Free run
Phase Direction Bit.
This bit is only used when the time-base counter is configured in the up-down-count mode. The
PHSDIR bit indicates the direction the time-base counter (TBCTR) will count after a synchronization
event occurs and a new phase value is loaded from the phase (TBPHS) register. This is
irrespective of the direction of the counter before the synchronization event..
In the up-count and down-count modes this bit is ignored.
12:10
CLKDIV
9:7
000
/1 (default on reset)
001
/2
010
/4
011
/8
100
/16
101
/32
110
/64
111
/128
HSPCLKDIV
/1
001
/2 (default on reset)
010
/4
011
/6
100
/8
101
/10
110
/12
111
/14
91
Registers
www.ti.com
Field
Value
SWFSYNC
Description
Software Forced Synchronization Pulse
5:4
SYNCOSEL
Synchronization Output Select. These bits select the source of the EPWMxSYNCO signal.
00
EPWMxSYNC:
01
10
11
PRDLD
The period register (TBPRD) is loaded from its shadow register when the time-base counter,
TBCTR, is equal to zero.
A write or read to the TBPRD register accesses the shadow register.
1:0
PHSEN
Do not load the time-base counter (TBCTR) from the time-base phase register (TBPHS)
Load the time-base counter with the phase register when an EPWMxSYNCI input signal occurs or
when a software synchronization is forced by the SWFSYNC bit
CTRMODE
Counter Mode
The time-base counter mode is normally configured once and not changed during normal operation.
If you change the mode of the counter, the change will take effect at the next TBCLK edge and the
current counter value shall increment or decrement from the value before the mode change.
These bits set the time-base counter mode of operation as follows:
92
00
Up-count mode
01
Down-count mode
10
Up-down-count mode
11
Registers
www.ti.com
8
Reserved
R-0
Reserved
CTRMAX
SYNCI
CTRDIR
R-0
R/W1C-0
R/W1C-0
R-1
LEGEND: R/W = Read/Write; R = Read only; R/W1C = Read/Write 1 to clear; -n = value after reset
Field
Value
Description
15:3
Reserved
Reserved
CTRMAX
Reading a 0 indicates the time-base counter never reached its maximum value. Writing a 0 will
have no effect.
Reading a 1 on this bit indicates that the time-base counter reached the max value 0xFFFF. Writing
a 1 to this bit will clear the latched event.
SYNCI
Writing a 0 will have no effect. Reading a 0 indicates no external synchronization event has
occurred.
Reading a 1 on this bit indicates that an external synchronization event has occurred
(EPWMxSYNCI). Writing a 1 to this bit will clear the latched event.
CTRDIR
Time-Base Counter Direction Status Bit. At reset, the counter is frozen; therefore, this bit has no
meaning. To make this bit meaningful, you must first set the appropriate mode via
TBCTL[CTRMODE].
0
93
Registers
4.2
www.ti.com
0
CMPA
R/W-0
Name
Description
15-0
CMPA
The value in the active CMPA register is continuously compared to the time-base counter (TBCTR). When
the values are equal, the counter-compare module generates a "time-base counter equal to counter
compare A" event. This event is sent to the action-qualifier where it is qualified and converted it into one
or more actions. These actions can be applied to either the EPWMxA or the EPWMxB output depending
on the configuration of the AQCTLA and AQCTLB registers. The actions that can be defined in the
AQCTLA and AQCTLB registers include:
Do nothing; the event is ignored.
Clear: Pull the EPWMxA and/or EPWMxB signal low
Set: Pull the EPWMxA and/or EPWMxB signal high
Toggle the EPWMxA and/or EPWMxB signal
Shadowing of this register is enabled and disabled by the CMPCTL[SHDWAMODE] bit. By default this
register is shadowed.
If CMPCTL[SHDWAMODE] = 0, then the shadow is enabled and any write or read will automatically
go to the shadow register. In this case, the CMPCTL[LOADAMODE] bit field determines which event
will load the active register from the shadow register.
Before a write, the CMPCTL[SHDWAFULL] bit can be read to determine if the shadow register is
currently full.
If CMPCTL[SHDWAMODE] = 1, then the shadow register is disabled and any write or read will go
directly to the active register, that is the register actively controlling the hardware.
In either mode, the active and shadow registers share the same memory map address.
0
CMPB
R/W-0
94
Registers
www.ti.com
Name
Description
15-0
CMPB
The value in the active CMPB register is continuously compared to the time-base counter (TBCTR). When
the values are equal, the counter-compare module generates a "time-base counter equal to counter
compare B" event. This event is sent to the action-qualifier where it is qualified and converted it into one
or more actions. These actions can be applied to either the EPWMxA or the EPWMxB output depending
on the configuration of the AQCTLA and AQCTLB registers. The actions that can be defined in the
AQCTLA and AQCTLB registers include:
Do nothing. event is ignored.
Clear: Pull the EPWMxA and/or EPWMxB signal low
Set: Pull the EPWMxA and/or EPWMxB signal high
Toggle the EPWMxA and/or EPWMxB signal
Shadowing of this register is enabled and disabled by the CMPCTL[SHDWBMODE] bit. By default this
register is shadowed.
If CMPCTL[SHDWBMODE] = 0, then the shadow is enabled and any write or read will automatically
go to the shadow register. In this case, the CMPCTL[LOADBMODE] bit field determines which event
will load the active register from the shadow register:
Before a write, the CMPCTL[SHDWBFULL] bit can be read to determine if the shadow register is
currently full.
If CMPCTL[SHDWBMODE] = 1, then the shadow register is disabled and any write or read will go
directly to the active register, that is the register actively controlling the hardware.
In either mode, the active and shadow registers share the same memory map address.
95
Registers
www.ti.com
10
Reserved
SHDWBFULL
SHDWAFULL
R-0
R-0
R-0
Reserved
SHDWBMODE
Reserved
SHDWAMODE
LOADBMODE
LOADAMODE
R-0
R/W-0
R-0
R/W-0
R/W-0
R/W-0
Name
Value
Description
Reserved
Reserved
SHDWBFULL
Indicates the CMPB shadow FIFO is full; a CPU write will overwrite current shadow value.
SHDWAFULL
Indicates the CMPA shadow FIFO is full, a CPU write will overwrite the current shadow
value.
Reserved
Reserved
SHDWBMODE
Reserved
SHDWAMODE
3-2
1-0
96
Shadow mode. Operates as a double buffer. All writes via the CPU access the shadow
register.
Immediate mode. Only the active compare B register is used. All writes and reads directly
access the active register for immediate compare action.
Reserved
Counter-compare A (CMPA) Register Operating Mode
Shadow mode. Operates as a double buffer. All writes via the CPU access the shadow
register.
Immediate mode. Only the active compare register is used. All writes and reads directly
access the active register for immediate compare action
LOADBMODE
01
10
11
LOADAMODE
01
10
11
Registers
www.ti.com
8
CMPAHR
R/W-0
0
Reserved
R-0
Field
Value
CMPAHR
00-FFh These 8-bits contain the high-resolution portion (least significant 8-bits) of the counter-compare A
value. CMPA:CMPAHR can be accessed in a single 32-bit read/write.
Description
Shadowing is enabled and disabled by the CMPCTL[SHDWAMODE] bit as described for the CMPA
register.
7-0
4.3
Reserved
12
11
10
Reserved
CBD
CBU
R-0
R/W-0
R/W-0
CAD
CAU
PRD
ZRO
R/W-0
R/W-0
R/W-0
R/W-0
Name
Value Description
15-12
Reserved
Reserved
11-10
CBD
Action when the time-base counter equals the active CMPB register and the counter is
decrementing.
9-8
7-6
00
01
10
11
Toggle EPWMxA output: low output signal will be forced high, and a high signal will be forced low.
CBU
Action when the counter equals the active CMPB register and the counter is incrementing.
00
01
10
11
Toggle EPWMxA output: low output signal will be forced high, and a high signal will be forced low.
CAD
Action when the counter equals the active CMPA register and the counter is decrementing.
00
01
10
11
Toggle EPWMxA output: low output signal will be forced high, and a high signal will be forced low.
97
Registers
www.ti.com
Table 30. Action-Qualifier Output A Control Register (AQCTLA) Field Descriptions (continued)
Bits
Name
5-4
CAU
3-2
Value Description
Action when the counter equals the active CMPA register and the counter is incrementing.
00
01
10
11
Toggle EPWMxA output: low output signal will be forced high, and a high signal will be forced low.
PRD
1-0
00
01
10
11
Toggle EPWMxA output: low output signal will be forced high, and a high signal will be forced low.
ZRO
01
10
11
Toggle EPWMxA output: low output signal will be forced high, and a high signal will be forced low.
12
11
10
Reserved
CBD
CBU
R-0
R/W-0
R/W-0
CAD
CAU
PRD
ZRO
R/W-0
R/W-0
R/W-0
R/W-0
Reserved
11-10
CBD
9-8
7-6
98
Name
15-12
Value Description
Action when the counter equals the active CMPB register and the counter is decrementing.
00
01
10
11
Toggle EPWMxB output: low output signal will be forced high, and a high signal will be forced low.
CBU
Action when the counter equals the active CMPB register and the counter is incrementing.
00
01
10
11
Toggle EPWMxB output: low output signal will be forced high, and a high signal will be forced low.
CAD
Action when the counter equals the active CMPA register and the counter is decrementing.
00
01
10
11
Toggle EPWMxB output: low output signal will be forced high, and a high signal will be forced low.
Registers
www.ti.com
Table 31. Action-Qualifier Output B Control Register (AQCTLB) Field Descriptions (continued)
Bits
Name
5-4
CAU
3-2
Value Description
Action when the counter equals the active CMPA register and the counter is incrementing.
00
01
10
11
Toggle EPWMxB output: low output signal will be forced high, and a high signal will be forced low.
PRD
1-0
00
01
10
11
Toggle EPWMxB output: low output signal will be forced high, and a high signal will be forced low.
ZRO
01
10
11
Toggle EPWMxB output: low output signal will be forced high, and a high signal will be forced low.
8
Reserved
R-0
RLDCSF
OTSFB
ACTSFB
OTSFA
ACTSFA
R/W-0
R/W-0
R/W-0
R/W-0
R/W-0
Field
15:8
Reserved
7:6
RLDCSF
Value
Description
AQCSFRC Active Register Reload From Shadow Options
00
01
10
11
Load immediately (the active register is directly accessed by the CPU and is not loaded from the
shadow register).
OTSFB
99
Registers
www.ti.com
Table 32. Action-Qualifier Software Force Register (AQSFRC) Field Descriptions (continued)
Bit
Field
4:3
ACTSFB
Value
Description
Action when One-Time Software Force B Is invoked
00
01
Clear (low)
10
Set (high)
11
OTSFA
1
1:0
ACTSFA
00
01
Clear (low)
10
Set (high)
11
8
Reserved
R-0
Reserved
CSFB
CSFA
R-0
R/W-0
R/W-0
Table 33. Action-qualifier Continuous Software Force Register (AQCSFRC) Field Descriptions
Bits
Name
15-4
Reserved
Value
Description
Reserved
3-2
CSFB
1-0
00
01
10
11
CSFA
01
10
11
Registers
www.ti.com
4.4
8
Reserved
R-0
Reserved
IN_MODE
POLSEL
OUT_MODE
R-0
R/W-0
R/W-0
R/W-0
Registers
www.ti.com
Name
Value
Description
15-6
Reserved
Reserved
5-4
IN_MODE
EPWMxA In (from the action-qualifier) is the source for both falling-edge and rising-edge
delay.
01
EPWMxB In (from the action-qualifier) is the source for rising-edge delayed signal.
EPWMxA In (from the action-qualifier) is the source for falling-edge delayed signal.
10
EPWMxA In (from the action-qualifier) is the source for rising-edge delayed signal.
EPWMxB In (from the action-qualifier) is the source for falling-edge delayed signal.
11
3-2
POLSEL
EPWMxB In (from the action-qualifier) is the source for both rising-edge delay and
falling-edge delayed signal.
Polarity Select Control
Bit 3 controls the S3 switch and bit 2 controls the S2 switch shown in Figure 31.
This allows you to selectively invert one of the delayed signals before it is sent out of the
dead-band submodule.
The following descriptions correspond to classical upper/lower switch control as found in one
leg of a digital motor control inverter.
These assume that DBCTL[OUT_MODE] = 1,1 and DBCTL[IN_MODE] = 0,0. Other
enhanced modes are also possible, but not regarded as typical usage modes.
1-0
00
Active high (AH) mode. Neither EPWMxA nor EPWMxB is inverted (default).
01
10
11
Active low (AL) mode. Both EPWMxA and EPWMxB are inverted.
OUT_MODE
Dead-band generation is bypassed for both output signals. In this mode, both the EPWMxA
and EPWMxB output signals from the action-qualifier are passed directly to the PWM-chopper
submodule.
In this mode, the POLSEL and IN_MODE bits have no effect.
01
Disable rising-edge delay. The EPWMxA signal from the action-qualifier is passed straight
through to the EPWMxA input of the PWM-chopper submodule.
The falling-edge delayed signal is seen on output EPWMxB. The input signal for the delay is
determined by DBCTL[IN_MODE].
10
The rising-edge delayed signal is seen on output EPWMxA. The input signal for the delay is
determined by DBCTL[IN_MODE].
Disable falling-edge delay. The EPWMxB signal from the action-qualifier is passed straight
through to the EPWMxB input of the PWM-chopper submodule.
11
102
Dead-band is fully enabled for both rising-edge delay on output EPWMxA and falling-edge
delay on output EPWMxB. The input signal for the delay is determined by DBCTL[IN_MODE].
Registers
www.ti.com
10
Reserved
DEL
R-0
R/W-0
0
DEL
R/W-0
Table 35. Dead-Band Generator Rising Edge Delay Register (DBRED) Field Descriptions
Bits
Name
15-10
9-0
Value Description
Reserved
Reserved
DEL
10
Reserved
DEL
R-0
R/W-0
0
DEL
R/W-0
Table 36. Dead-Band Generator Falling Edge Delay Register (DBFED) Field Descriptions
Bits
15-10
9-0
4.5
Name
Description
Reserved
Reserved
DEL
11
10
Reserved
CHPDUTY
R-0
R/W-0
CHPFREQ
OSHTWTH
CHPEN
R/W-0
R/W-0
R/W-0
103
Registers
www.ti.com
Reserved
10-8
CHPDUTY
7:5
4:1
104
Name
Value
Description
Reserved
Chopping Clock Duty Cycle
000
001
010
011
100
101
110
111
Reserved
CHPFREQ
001
010
011
100
101
110
111
OSHTWTH
0001
0010
0011
0100
0101
0110
0111
1000
1001
1010
1011
1100
1101
1110
1111
CHPEN
PWM-chopping Enable
0
Registers
www.ti.com
4.6
14
13
12
11
10
Reserved
OSHT6
OSHT5
OSHT4
OSHT3
OSHT2
OSHT1
R-0
R/W-0
R/W-0
R/W-0
R/W-0
R/W-0
R/W-0
6
Reserved
CBC6
CBC5
CBC4
CBC3
CBC2
CBC1
R-0
R/W-0
R/W-0
R/W-0
R/W-0
R/W-0
R/W-0
Name
Value
Description
One-Shot (OSHT) Trip-zone enable/disable. When any of the enabled pins go low, a one-shot trip event occurs for this
ePWM module. When the event occurs, the action defined in the TZCTL register () is taken on the EPWMxA and EPWMxB
outputs. The one-shot trip condition remains latched until the user clears the condition via the TZCLR register ().
15:14
13
12
11
10
Reserved
Reserved
OSHT6
OSHT5
OSHT4
OSHT3
OSHT2
OSHT1
Cycle-by-Cycle (CBC) Trip-zone enable/disable. When any of the enabled pins go low, a cycle-by-cycle trip event occurs
for this ePWM module. When the event occurs, the action defined in the TZCTL register () is taken on the EPWMxA and
EPWMxB outputs. A cycle-by-cycle trip condition is automatically cleared when the time-base counter reaches zero.
7:6
5
Reserved
Reserved
CBC6
CBC5
CBC4
CBC3
Registers
www.ti.com
Table 38. Trip-Zone Submodule Select Register (TZSEL) Field Descriptions (continued)
Bits
Name
CBC2
Value
Description
Trip-zone 2 (TZ2) Select
CBC1
8
Reserved
R-0
Reserved
TZB
TZA
R-0
R/W-0
R/W-0
Name
154
Reserved
Reserved
32
TZB
When a trip event occurs the following action is taken on output EPWMxB. Which trip-zone pins
can cause an event is defined in the TZSEL register.
10
Value
Description
00
01
10
11
TZA
When a trip event occurs the following action is taken on output EPWMxA. Which trip-zone pins
can cause an event is defined in the TZSEL register.
00
01
10
11
8
Reserved
R -0
Reserved
OST
CBC
Reserved
R-0
R/W-0
R/W-0
R-0
Name
15-3
Reserved
Value
Description
Reserved
OST
Enable Interrupt generation; a one-shot trip event will cause a EPWMx_TZINT PIE interrupt.
Registers
www.ti.com
Table 40. Trip-Zone Enable Interrupt Register (TZEINT) Field Descriptions (continued)
Bits
1
Name
Value
Description
CBC
Enable interrupt generation; a cycle-by-cycle trip event will cause an EPWMx_TZINT PIE
interrupt.
Reserved
Reserved
8
Reserved
R-0
Reserved
OST
CBC
INT
R-0
R-0
R-0
R-0
Name
15-3
Reserved
Value Description
Reserved
OST
Indicates a trip event has occurred on a pin selected as a one-shot trip source.
This bit is cleared by writing the appropriate value to the TZCLR register.
CBC
Indicates a trip event has occurred on a pin selected as a cycle-by-cycle trip source. The
TZFLG[CBC] bit will remain set until it is manually cleared by the user. If the cycle-by-cycle trip
event is still present when the CBC bit is cleared, then CBC will be immediately set again. The
specified condition on the pins is automatically cleared when the ePWM time-base counter
reaches zero (TBCTR = 0x0000) if the trip condition is no longer present. The condition on the
pins is only cleared when the TBCTR = 0x0000 no matter where in the cycle the CBC flag is
cleared.
This bit is cleared by writing the appropriate value to the TZCLR register.
INT
8
Reserved
R-0
Reserved
OST
CBC
INT
R-0
R/W-0
R/W-0
R/W-0
107
Registers
www.ti.com
Name
15-3
Reserved
Value
Description
Reserved
OST
CBC
INT
8
Reserved
R-0
Reserved
OST
CBC
Reserved
R-0
R/W-0
R/W-0
R- 0
Name
15- 3
Reserved
4.7
Value
Description
Reserved
OST
CBC
Reserved
Reserved
14
12
11
10
SOCBEN
SOCBSEL
SOCAEN
SOCASEL
R/W-0
R/W-0
R/W-0
R/W-0
Reserved
INTEN
INTSEL
R-0
R/W-0
R/W-0
108
Registers
www.ti.com
14-12
Name
Value
Description
SOCBEN
Disable EPWMxSOCB.
SOCBSEL
11
10-8
000
Reserved
001
010
011
Reserved
100
Enable event time-base counter equal to CMPA when the timer is incrementing.
101
Enable event time-base counter equal to CMPA when the timer is decrementing.
110
Enable event: time-base counter equal to CMPB when the timer is incrementing.
111
Enable event: time-base counter equal to CMPB when the timer is decrementing.
SOCAEN
Disable EPWMxSOCA.
SOCASEL
7-4
3
000
Reserved
001
010
011
Reserved
100
Enable event time-base counter equal to CMPA when the timer is incrementing.
101
Enable event time-base counter equal to CMPA when the timer is decrementing.
110
Enable event: time-base counter equal to CMPB when the timer is incrementing.
111
Enable event: time-base counter equal to CMPB when the timer is decrementing.
Reserved
Reserved
INTEN
2-0
INTSEL
Reserved
001
010
011
Reserved
100
Enable event time-base counter equal to CMPA when the timer is incrementing.
101
Enable event time-base counter equal to CMPA when the timer is decrementing.
110
Enable event: time-base counter equal to CMPB when the timer is incrementing.
111
Enable event: time-base counter equal to CMPB when the timer is decrementing.
14
13
12
11
10
SOCBCNT
SOCBPRD
SOCACNT
SOCAPRD
R-0
R/W-0
R-0
R/W-0
Reserved
INTCNT
INTPRD
R-0
R-0
R/W-0
109
Registers
www.ti.com
Name
Description
SOCBCNT
13-12
00
01
10
11
SOCBPRD
11-10
00
01
10
11
SOCACNT
9-8
00
01
10
11
SOCAPRD
01
10
11
7-4
Reserved
Reserved
3-2
INTCNT
01
10
11
Registers
www.ti.com
Name
Description
1-0
INTPRD
Disable the interrupt event counter. No interrupt will be generated and ETFRC[INT] is
ignored.
01
10
11
8
Reserved
R-0
Reserved
SOCB
SOCA
Reserved
INT
R-0
R-0
R-0
R-0
R-0
Name
15-4
Reserved
Value
Description
Reserved
SOCB
SOCA
Reserved
INT
Indicates that an ePWMx interrupt (EWPMx_INT) was generated. No further interrupts will be
generated until the flag bit is cleared. Up to one interrupt can be pending while the
ETFLG[INT] bit is still set. If an interrupt is pending, it will not be generated until after the
ETFLG[INT] bit is cleared. Refer to Figure 44.
Registers
www.ti.com
8
Reserved
R=0
Reserved
SOCB
SOCA
Reserved
INT
R-0
R/W-0
R/W-0
R-0
R/W-0
Name
15-4
Reserved
Value
Description
Reserved
SOCB
SOCA
Reserved
INT
Clears the ETFLG[INT] flag bit and enable further interrupts pulses to be generated
8
Reserved
R-0
Reserved
SOCB
SOCA
Reserved
INT
R-0
R/W-0
R/W-0
R-0
R/W-0
Name
15-4
Reserved
Reserved
SOCB
SOCB Force Bit. The SOCB pulse will only be generated if the event is enabled in the
ETSEL register. The ETFLG[SOCB] flag bit will be set regardless.
Value
Generates a pulse on EPWMxSOCB and sets the SOCBFLG bit. This bit is used for test
purposes.
SOCA
Reserved
INT
Description
SOCA Force Bit. The SOCA pulse will only be generated if the event is enabled in the
ETSEL register. The ETFLG[SOCA] flag bit will be set regardless.
0
Generates a pulse on EPWMxSOCA and set the SOCAFLG bit. This bit is used for test
purposes.
Reserved
INT Force Bit. The interrupt will only be generated if the event is enabled in the ETSEL
register. The INT flag bit will be set regardless.
Generates an interrupt on EPWMxINT and set the INT flag bit. This bit is used for test
purposes.
Registers
www.ti.com
4.8
113
www.ti.com
114
Location
Section 2.2.3.2
Global
Global
Section 4.8
Figure 90
Revision History
IMPORTANT NOTICE
Texas Instruments Incorporated and its subsidiaries (TI) reserve the right to make corrections, modifications, enhancements, improvements,
and other changes to its products and services at any time and to discontinue any product or service without notice. Customers should
obtain the latest relevant information before placing orders and should verify that such information is current and complete. All products are
sold subject to TIs terms and conditions of sale supplied at the time of order acknowledgment.
TI warrants performance of its hardware products to the specifications applicable at the time of sale in accordance with TIs standard
warranty. Testing and other quality control techniques are used to the extent TI deems necessary to support this warranty. Except where
mandated by government requirements, testing of all parameters of each product is not necessarily performed.
TI assumes no liability for applications assistance or customer product design. Customers are responsible for their products and
applications using TI components. To minimize the risks associated with customer products and applications, customers should provide
adequate design and operating safeguards.
TI does not warrant or represent that any license, either express or implied, is granted under any TI patent right, copyright, mask work right,
or other TI intellectual property right relating to any combination, machine, or process in which TI products or services are used. Information
published by TI regarding third-party products or services does not constitute a license from TI to use such products or services or a
warranty or endorsement thereof. Use of such information may require a license from a third party under the patents or other intellectual
property of the third party, or a license from TI under the patents or other intellectual property of TI.
Reproduction of TI information in TI data books or data sheets is permissible only if reproduction is without alteration and is accompanied
by all associated warranties, conditions, limitations, and notices. Reproduction of this information with alteration is an unfair and deceptive
business practice. TI is not responsible or liable for such altered documentation. Information of third parties may be subject to additional
restrictions.
Resale of TI products or services with statements different from or beyond the parameters stated by TI for that product or service voids all
express and any implied warranties for the associated TI product or service and is an unfair and deceptive business practice. TI is not
responsible or liable for any such statements.
TI products are not authorized for use in safety-critical applications (such as life support) where a failure of the TI product would reasonably
be expected to cause severe personal injury or death, unless officers of the parties have executed an agreement specifically governing
such use. Buyers represent that they have all necessary expertise in the safety and regulatory ramifications of their applications, and
acknowledge and agree that they are solely responsible for all legal, regulatory and safety-related requirements concerning their products
and any use of TI products in such safety-critical applications, notwithstanding any applications-related information or support that may be
provided by TI. Further, Buyers must fully indemnify TI and its representatives against any damages arising out of the use of TI products in
such safety-critical applications.
TI products are neither designed nor intended for use in military/aerospace applications or environments unless the TI products are
specifically designated by TI as military-grade or "enhanced plastic." Only products designated by TI as military-grade meet military
specifications. Buyers acknowledge and agree that any such use of TI products which TI has not designated as military-grade is solely at
the Buyer's risk, and that they are solely responsible for compliance with all legal and regulatory requirements in connection with such use.
TI products are neither designed nor intended for use in automotive applications or environments unless the specific TI products are
designated by TI as compliant with ISO/TS 16949 requirements. Buyers acknowledge and agree that, if they use any non-designated
products in automotive applications, TI will not be responsible for any failure to meet such requirements.
Following are URLs where you can obtain information on other Texas Instruments products and application solutions:
Products
Applications
Audio
www.ti.com/audio
Amplifiers
amplifier.ti.com
www.ti.com/computers
Data Converters
dataconverter.ti.com
Consumer Electronics
www.ti.com/consumer-apps
DLP Products
www.dlp.com
www.ti.com/energy
DSP
dsp.ti.com
Industrial
www.ti.com/industrial
www.ti.com/clocks
Medical
www.ti.com/medical
Interface
interface.ti.com
Security
www.ti.com/security
Logic
logic.ti.com
www.ti.com/space-avionics-defense
Power Mgmt
power.ti.com
Transportation and
Automotive
www.ti.com/automotive
Microcontrollers
microcontroller.ti.com
www.ti.com/video
RFID
www.ti-rfid.com
Wireless
www.ti.com/wireless-apps
www.ti.com/lprf
TI E2E Community Home Page
e2e.ti.com
Mailing Address: Texas Instruments, Post Office Box 655303, Dallas, Texas 75265
Copyright 2011, Texas Instruments Incorporated