TMS320x2833x, 2823x Enhanced Pulse Width …

1 TMS320x2833x, 2823xEnhancedPulseWidthModu lator(ePWM)ModuleReferenceGuideLiteratur eNumber:SPRUG04 AOctober2008 RevisedJuly20092 SPRUG04A October 2008 Revised July 2009 Submit Documentation Feedback 2008 2009, Texas Instruments (TB) (CC) (AQ) (DB) (PC) (TZ) (ET) (HHB) (ACIandPMSM).. 3- (ZVSFB) October2008 RevisedJuly2009 TableofContentsSubmitDocumentationFeedba ck 2008 2009, ,TBCTL[PHSDIR= 0] ,TBCTL[PHSDIR= 1] ,TBCTL[PHSDIR= 0] ,TBCTL[PHSDIR= 1] ,SingleEdgeAsymmetricWaveform,WithIndepe ndentModulationonEPWMxAandEPWMxB ,SingleEdgeAsymmetricWaveformWithIndepen dentModulationonEPWMxAandEPWMxB , ,DualEdgeSymmetricWaveform,WithIndepende ntModulationonEPWMxAandEPWMxB ,DualEdgeSymmetricWaveform,WithIndepende ntModulationonEPWMxAandEPWMxB ,DualEdgeAsymmetricWaveform,WithIndepend entModulationonEPWMxA (0%< Duty< 100%).. (DutyCycle) October2008 RevisedJuly2009 SubmitDocumentationFeedback 2008 2009, TypicalMaster,EPWM2 Configuredasa FPWM2 FPWM3 (Note:Onlythreebucksshownhere).

2 7151 ControlofFourBuckStages.(Note:FPWM2= N x FPWM1)..7352 BuckWaveformsfor(Note:FPWM2= FPWM1))..7453 ControlofTwoHalf-HBridgeStages(FPWM2= N x FPWM1)..7654 Half-HBridgeWaveformsfor(Note:HereFPWM2= FPWM1)..7755 ControlofDual3-PhaseInverterStagesasIs CommonlyUsedin (OnlyOneInverterShown).. 3- Full-HBridgeStage(FPWM2= FPWM1).. (TBPRD)..9064 Time-BasePhaseRegister(TBPHS)..9065 Time-BaseCounterRegister(TBCTR)..9066 Time-BaseControlRegister(TBCTL)..9167 Time-BaseStatusRegister(TBSTS)..9368 Counter-CompareA Register(CMPA)..9469 Counter-CompareB Register(CMPB)..9470 Counter-CompareControlRegister(CMPCTL).. 9671 CompareA HighResolutionRegister(CMPAHR)..9772 Action-QualifierOutputA ControlRegister(AQCTLA)..9773 Action-QualifierOutputB ControlRegister(AQCTLB)..9874 Action-QualifierSoftwareForceRegister(AQ SFRC)..9975 Action-QualifierContinuousSoftwareForceR egister(AQCSFRC)..10076 Dead-BandGeneratorControlRegister(DBCTL) ..10177 Dead-BandGeneratorRisingEdgeDelayRegiste r(DBRED)..10378 Dead-BandGeneratorFallingEdgeDelayRegist er(DBFED).

3 10379 PWM-ChopperControlRegister(PCCTL)..10380 Trip-ZoneSelectRegister(TZSEL)..10581 Trip-ZoneControlRegister(TZCTL)..10682 Trip-ZoneEnableInterruptRegister(TZEINT) ..10683 Trip-ZoneFlagRegister(TZFLG)..10784 Trip-ZoneClearRegister(TZCLR)..10785 Trip-ZoneForceRegister(TZFRC)..10886 Event-TriggerSelectionRegister(ETSEL)..1 0887 Event-TriggerPrescaleRegister(ETPS)..109 88 Event-TriggerFlagRegister(ETFLG)..11189 Event-TriggerClearRegister(ETCLR)..11290 Event-TriggerForceRegister(ETFRC)..1125 SPRUG04A October2008 RevisedJuly2009 ListofFiguresSubmitDocumentationFeedback 2008 2009, CMPA/CMPBis S asa (TBPRD) (TBPHS) (TBCTR) (TBCTL) (TBSTS) Register(CMPA) Register(CMPB) (CMPCTL) HighResolutionRegister(CMPAHR) ControlRegister(AQCTLA) ControlRegister(AQCTLB) (AQSFRC) (AQCSFRC) (DBCTL) (DBRED) (DBFED) (PCCTL) (TZSEL) (TZCTL) (TZEINT) (TZFLG) (TZCLR) (TZFRC) (ETSEL) (ETPS) (ETFLG) (ETCLR) October2008 RevisedJuly2009 SubmitDocumentationFeedback 2008 2009, (ETFRC) October2008 RevisedJuly2009 ListofTablesSubmitDocumentationFeedback 2008 2009,TexasInstrumentsIncorporatedPreface SPRUG04A October2008 RevisedJuly2009 ReadThisFirstTheEnhancedPulseWidthModula tor(ePWM)moduledescribedinthisreferenceg uideisa ,28xxxDSPP eripheralReferenceGuide(SPRU566) foralistofalldeviceswitha ePWMmoduleofthesametype,todeterminethedi fferencesbetweenthetypes,andforalistofde vice-specificdifferenceswithina.

4 Time-BaseModule CounterCompareModule ActionQualifierModule Dead-BandGeneratorModule PWMC hopper(PC) module TripZoneModule EventTriggerModuleRelatedDocumentationFr omTexasInstrumentsThefollowingbooksdescr ibetheTMS320F2833x,2823xmoduleandrelated supporttoolsthatareavailableontheTIwebsi te:DataManualandErrata SPRS439 TMS320F28335,TMS320F28334,TMS320F28332,T MS320F28235,TMS320F28234,TMS320F28232 DigitalSignalControllers(DSCs)DataManual containsthepinout,signaldescriptions,asw ellaselectricalandtimingspecificationsfo rtheF2833 TMS320F28335,TMS320F28334,TMS320F28332,T MS320F28235,TMS320F28234, 'sGuides SPRU430 TMS320C28xCPUandInstructionSetReferenceG uidedescribesthecentralprocessingunit(CP U)andtheassemblylanguageinstructionsofth eTMS320C28xfixed-pointdigitalsignalproce ssors(DSPs).It SPRU566 TMS320x28xx,28xxxDSPP eripheralReferenceGuidedescribestheperip heralreferenceguidesofthe28xdigitalsigna lprocessors(DSPs).SPRUFB0 TMS320x2833x, 2823xSystemControlandInterr uptsReferenceGuidedescribesthevariousint erruptsandsystemcontrolfeaturesofthe2833 xand2823xdigitalsignalcontrollers(DSCs).

5 SPRU812 TMS320x2833x, 2823xAnalog-to-DigitalConve rter(ADC)ReferenceGuidedescribeshowtocon figureandusetheon-chipADCmodule,whichis a TMS320x2833x, 2823xDSCE xternalInterface(XINTF)ReferenceGuidedes cribestheXINTF,whichis a nonmultiplexedasynchronousbus,asit is October2008 RevisedJuly2009 SubmitDocumentationFeedback 2008 2009, TMS320x2833x, 2823xBootROMR eferenceGuidedescribesthepurposeandfeatu resofthebootloader(factory-programmedboo t-loadingsoftware) alsodescribesothercontentsofthedeviceon- chipbootROMandidentifieswherealloftheinf ormationis TMS320x2833x, 2823xMultichannelBufferedSe rialPort(McBSP) DSPandotherdevicesin a TMS320x2833x, 2823xDirectMemoryAccess(DMA ) TMS320x2833x, 2823xEnhancedPulseWidthModu lator(ePWM)ModuleReferenceGuidedescribes themainareasoftheenhancedpulsewidthmodul atorthatincludedigitalmotorcontrol,switc hmodepowersupplycontrol,UPS(uninterrupti blepowersupplies), TMS320x2833x, 2823xHigh-ResolutionPulseWi dthModulator(HRPWM)ReferenceGuidedescrib estheoperationofthehigh-resolutionextens iontothepulsewidthmodulator(HRPWM).

6 SPRUFG4 TMS320x2833x, 2823xEnhancedCapture(eCAP) TMS320x2833x, 2823xEnhancedQuadratureEnco derPulse(eQEP)ModuleReferenceGuidedescri bestheeQEPmodule,whichis usedforinterfacingwitha linearorrotaryincrementalencodertogetpos ition,direction,andspeedinformationfroma TMS320x2833x, 2823xEnhancedControllerArea Network(eCAN) TMS320x2833x, 2823xSerialCommunicationsIn terface(SCI)ReferenceGuidedescribestheSC I,whichis a two-wireasynchronousserialport,commonlyk nownasa (NRZ) TMS320x2833x, 2823xDSCS erialPeripheralInterface(SPI)ReferenceGu idedescribestheSPI- a high-speedsynchronousserialinput/output( I/O)port- thatallowsa serialbitstreamofprogrammedlength(onetos ixteenbits) TMS320x2833x, 2823xInter-IntegratedCircui t(I2C)ModuleReferenceGuidedescribesthefe aturesandoperationoftheinter-integratedc ircuit(I2C) SPRU513 'sGuidedescribestheassemblylanguagetools (assemblerandothertoolsusedtodevelopasse mblylanguagecode),assemblerdirectives,ma cros,commonobjectfileformat, TMS320C28xOptimizingC/C++ 'sGuidedescribestheTMS320C28x C/C++ ++ TMS320C28xInstructionSetSimulatorTechnic alOverviewdescribesthesimulator,availabl ewithintheCodeComposerStudioforTMS320C20 00 IDE,thatsimulatestheinstructionsetoftheC 28x TMS320C28 (API) October2008 RevisedJuly2009 ReadThisFirstSubmitDocumentationFeedback 2008 2009, SPRAAM0 GettingStartedWithTMS320C28xDigitalSigna lControllersis DSPsoftwareandhardwaredevelopmentareprov idedtoaidin ,software,andtoolsforusein PowerLineCommunicationforLightingApplica tionsUsingBinaryPhaseShiftKeying(BPSK)

7 Witha SingleDSPC ontrollerpresentsa completeimplementationofa powerlinemodemfollowingCEA-709protocolus inga ProgrammingTMS320x28xxand28xxxPeripheral sinC/C++exploresa hardwareabstractionlayerimplementationto makeC/C++ # andnon- TMS320F280xDigitalSignalControllerUSBC onnectivityUsingtheTUSB3410 USB-to-UARTB ridgeChippresentshardwareconnectionsaswe llassoftwarepreparationandoperationofthe developmentsystemusinga TMS320x280xandTMS320F2801xADCC alibrationdescribesa UsingtheePWMM odulefor0% 100%DutyCycleControlprovidesa guidefortheuseoftheePWMmoduletoprovide0% to100%dutycyclecontrolandis UsingPWMO utputasa Digital-to-AnalogConverterona TMS320F280xDigitalSignalControllerpresen tsa methodforutilizingtheon-chippulsewidthmo dulated(PWM)signalgeneratorsontheTMS320F 280xfamilyofdigitalsignalcontrollersasa digital-to-analogconverter(DAC).SPRAAH1 UsingtheEnhancedQuadratureEncoderPulse(e QEP)ModuleinTMS320x280x,28xxxasa DedicatedCaptureprovidesa guidefortheuseoftheeQEPmoduleasa dedicatedcaptureunitandis applicabletotheTMS320x280x, providedthatcontainsfunctionsforimplemen tingtheoverflowdetectiononbothDSP/BIOS andnon- AnEasyWayofCreatinga C-callableAssemblyFunctionfortheTMS320C2 8xDSPprovidesinstructionsandsuggestionst oconfiguretheC , October2008 RevisedJuly2009 SubmitDocumentationFeedback 2008 2009,TexasInstrumentsIncorporatedReferen ceGuideSPRUG04A October2008 RevisedJuly2009 TMS320x2833x, 2823xEnhancedPulseWidthModu lator(ePWM)ModuleTheenhancedpulsewidthmo dulator(ePWM)peripheralis a keyelementin ,switchmodepowersupplycontrol,uninterrup tiblepowersupplies(UPS), digitaltoanalog(DAC)function,wherethedut ycycleis equivalenttoa DACanalogvalue;it is sometimesreferredtoasa.

8 SeetheTMS320x28xx,28xxxDSPP eripheralReferenceGuide(SPRU566) fora listofalldeviceswithanePWMmoduleofthesam etype,todeterminethedifferencesbetweenth etypes,andfora listofdevice-specificdifferenceswithina ;instead,theePWMis builtupfromsmallersinglechannelmoduleswi thseparateresourcesthatcanoperatetogethe rasrequiredtoforma anorthogonalarchitectureandprovidesa moretransparentviewoftheperipheralstruct ure, withina signalormodulenameis usedtoindicatea genericePWMinstanceona , deviceasshownin Figure1. EachePWMinstanceis thehigh-resolutionpulsewidthmodulator(HR PWM)andis describedin theTMS320x2833x,2823xHigh-ResolutionPuls eWidthModulator(HRPWM)ReferenceGuide(SPR UG02) . indicatedbya thefirstinstanceandePWM3is the3rdinstancein clocksynchronizationschemethatallowsthem tooperateasa ,thissynchronizationschemecanbeextendedt othecaptureperipheralmodules(eCAP).Thenu mberofmodulesis : Dedicated16-bittime-basecounterwithperio dandfrequencycontrol TwoPWMoutputs(EPWMxAandEPWMxB)thatcanbeu sedin thefollowingconfigurations: TwoindependentPWMoutputswithsingle-edgeo peration TwoindependentPWMoutputswithdual-edgesym metricoperation11 SPRUG04A October2008 RevisedJuly2009 TMS320x2833x, 2823xEnhancedPulseWidthModu lator(ePWM)ModuleSubmitDocumentationFeed back 2008 2009, OneindependentPWMoutputwithdual-edgeasym metricoperation AsynchronousoverridecontrolofPWMsignalst hroughsoftware.

9 Programmablephase-controlsupportforlagor leadoperationrelativetootherePWMmodules. Hardware-locked(synchronized)phaserelati onshipona cycle-by-cyclebasis. Dead-bandgenerationwithindependentrising andfallingedgedelaycontrol. Programmabletripzoneallocationofbothcycl e-by-cycletripandone-shottriponfaultcond itions. A tripconditioncanforceeitherhigh,low,orhi gh-impedancestatelogiclevelsatPWMoutputs . AlleventscantriggerbothCPUinterruptsandA DCstartofconversion(SOC) ProgrammableeventprescalingminimizesCPUo verheadoninterrupts. PWMchoppingbyhigh-frequencycarriersignal , connectedtotheinput/outputsignalsshownin Figure1. Thesignalsaredescribedin detailin ,2823xEnhancedPulseWidthModulator(ePWM)M oduleSPRUG04A October2008 RevisedJuly2009 SubmitDocumentationFeedback 2008 2009,TexasInstrumentsIncorporatedPIETZ1t o TZ6 PeripheralFrame 1ePWM1 moduleePWM2 moduleePWMx moduleSYNCOSYNCISYNCISYNCOSYNCISYNCOADCG PIOMUXxSYNCIxSYNCOxSOCEPWMxAEPWMxBEPWM2 AEPWM2 BEPWM1 AEPWM1 BEPWM1 INTEPWM1 SOCEPWM2 INTEPWM2 SOCEPWMxINTEPWMxSOCTo whichtheePWMmodulesareconnectedmaydiffer fromwhatis shownin Figure1.

10 Connectedwithina systemviathesignalsshownin October2008 RevisedJuly2009 TMS320x2833x, 2823xEnhancedPulseWidthModu lator(ePWM)ModuleSubmitDocumentationFeed back 2008 2009,TexasInstrumentsIncorporatedEPWMxIN TEPWMxTZINTEPWMxSOCAEPWMxSOCBEPWMxSYNCIE PWMxSYNCOTime-base (TB) moduleCounter-compare (CC) moduleAction-qualifier (AQ) moduleDead-band (DB) modulePWM-chopper (PC) moduleEvent-trigger (ET) moduleTrip-zone (TZ) modulePeripheral busePWM moduleTZ1 to showsmoreinternaldetailsofa : PWMoutputsignals(EPWMxAandEPWMxB).ThePWM outputsignalsaremadeavailableexternaltot hedevicethroughtheGPIO peripheraldescribedin thesystemcontrolandinterruptsguideforyou rdevice. Trip-zonesignals(TZ1toTZ6). Time-basesynchronizationinput(EPWMxSYNCI )andoutput(EPWMxSYNCO) (ePWMmodule#1).Thesynchronizationoutputf orePWM1(EPWM1 SYNCO)is alsoconnectedtotheSYNCI ofthefirstenhancedcapturemodule(eCAP1). ADCstart-of-conversionsignals(EPWMxSOCAa ndEPWMxSOCB).EachePWMmodulehastwoADCstar tofconversionsignals(oneforeachsequencer ).