PWMTiva.h File Reference

Detailed Description

PWM driver implementation for Tiva PWM peripherals.

============================================================================

The PWM header file should be included in an application as follows:

#include <ti/drivers/PWM.h>
#include <ti/drivers/pwm/PWMTiva.h>

Refer to PWM.h for a complete description of APIs & example of use.

Operation

This driver implementation uses the Pulse Width Modulator (PWM) peripherals present on Tiva devices to generate PWM signals. Each PWM peripheral instance contains 4 PWM signal generators, each controlling 2 PWM outputs (8 PWM outputs total). This driver manages each PWM output individually (each output has it's own PWM handle/instance). However since a single clock prescalar is available for a peripheral and a generator is responsible for producing 2 outputs, there are some limitations in place to ensure proper operation:

• The peripheral prescalar will be set according to the period of the first PWM instance opened. Any subsequent outputs will fail to open if a greater prescalar is required to generate the PWM period.
• A PWM generators period is set to the period of first the instance opened. Opening the second output will fail if the period used is not the same as what was set by the first output.
• A PWM generators options are set by the first instance opened. Opening the second output will fail if the options are not the same as what was set by the first output.

Since the period and duty registers are 16 bits wide the prescalar is used to divide the input clock and allow for larger periods. The maximum period supported is calculated as:

• MAX_PERIOD = (MAX_PRESCALAR * MAX_MATCH_VALUE) / CYCLES_PER_US
• Ex:
  • 80 MHz clock: (64 * 65535) / 80 = 52428 microseconds
  • 120 MHz clock: (64 * 65535) / 120 = 34952 microseconds

After opening, the PWM_setPeriodl() API can be used to change a PWM generator period. However, the clock prescalar is shared by all generators so the new period must be a value that can generated with the same prescaler. Also keep in mind that changing a period affects both generator outputs, so the period must be larger than both duties. The equation below can be used to determine the prescalar for a given period (the prescalar will be the following power of 2 (2^x)):

• prescalar = (period * CYCLES_PER_US) / MAX_MATCH_VALUE
• Ex:
  • 100 microseconds -> (100 * 80) / 65535 = (0.1220) = 1
  • 10000 microseconds -> (10000 * 80) / 65535 = (12.20) = 16

    ---

#include <stdbool.h>
#include <ti/drivers/PWM.h>

Include dependency graph for PWMTiva.h:

Go to the source code of this file.

Data Structures
struct	PWMTiva_HWAttrsV1
	PWMTiva Hardware attributes. More...
struct	PWMTiva_Status
	PWMTiva_Status. More...
struct	PWMTiva_Object
	PWMTiva Object. More...

Macros
#define	PWMTiva_NUM_PWM_PERIPHERALS   (2)
#define	PWMTiva_NUM_PWM_GENERATORS   (4)
#define	PWMTiva_NUM_PWM_OUTPUTS   (8)

Typedefs
typedef struct PWMTiva_HWAttrsV1	PWMTiva_HWAttrsV1
	PWMTiva Hardware attributes. More...
typedef struct PWMTiva_Status	PWMTiva_Status
	PWMTiva_Status. More...
typedef struct PWMTiva_Object	PWMTiva_Object
	PWMTiva Object. More...

Variables
const PWM_FxnTable	PWMTiva_fxnTable

Macro Definition Documentation

#define PWMTiva_NUM_PWM_PERIPHERALS   (2)

#define PWMTiva_NUM_PWM_GENERATORS   (4)

#define PWMTiva_NUM_PWM_OUTPUTS   (8)

Typedef Documentation

typedef struct PWMTiva_HWAttrsV1 PWMTiva_HWAttrsV1

PWMTiva Hardware attributes.

These fields are used by driverlib APIs and therefore must be populated by driverlib macro definitions. For TivaWare these definitions are found in:

• inc/hw_memmap.h
• driverlib/gpio.h
• driverlib/pwm.h

A sample structure is shown below:

const PWMTiva_HWAttrs PWMTivaHWAttrs[] = {
    {
        .pwmBaseAddr = PWM0_BASE,
        .pwmOutput = PWM_OUT_0,
        .pwmGenOpts = PWM_GEN_MODE_DOWN | PWM_GEN_MODE_DBG_RUN,
        .pinPwmMode = GPIO_PF0_M0PWM0,
        .gpioBaseAddr = GPIO_PORTF_BASE,
        .gpioPinIndex = GPIO_PIN_0
    }
};

typedef struct PWMTiva_Status PWMTiva_Status

PWMTiva_Status.

The application must not access any member variables of this structure!

typedef struct PWMTiva_Object PWMTiva_Object

PWMTiva Object.

The application must not access any member variables of this structure!

Variable Documentation

const PWM_FxnTable PWMTiva_fxnTable