Modules
	PT_Registers

Data Structures
struct	mxc_pt_cfg_t

Enumerations
enum	mxc_clk_scale_t

Functions
void	MXC_PT_Init (mxc_ptg_regs_t *ptg, mxc_clk_scale_t clk_scale)

void	MXC_PT_Shutdown (mxc_ptg_regs_t *ptg, uint32_t pts)

int	MXC_PT_Config (mxc_ptg_regs_t ptg, mxc_pt_cfg_t cfg)

int	MXC_PT_SqrWaveConfig (mxc_ptg_regs_t *ptg, unsigned channel, uint32_t freq, uint8_t outputSelect)

void	MXC_PT_Start (mxc_ptg_regs_t *ptg, unsigned pts)

void	MXC_PT_Stop (mxc_ptg_regs_t *ptg, unsigned pts)

uint32_t	MXC_PT_IsActive (mxc_ptg_regs_t *ptg, uint32_t pts)

void	MXC_PT_SetPattern (unsigned pts, uint32_t pattern)

void	MXC_PT_EnableInt (mxc_ptg_regs_t *ptg, uint32_t pts)

void	MXC_PT_DisableInt (mxc_ptg_regs_t *ptg, uint32_t pts)

uint32_t	MXC_PT_GetFlags (mxc_ptg_regs_t *ptg)

void	MXC_PT_ClearFlags (mxc_ptg_regs_t *ptg, uint32_t flags)

void	MXC_PT_EnableRestart (unsigned start, unsigned stop, uint8_t restartIndex)

void	MXC_PT_DisableRestart (unsigned channel, uint8_t restartIndex)

void	MXC_PT_Resync (mxc_ptg_regs_t *ptg, uint32_t pts)

Detailed Description

This is the high level API for the pulse train engine.

Data Structure Documentation

◆ mxc_pt_cfg_t

struct mxc_pt_cfg_t

Structure type for pulse train mode configuration.

Note: Do not use for square wave

Data Fields
unsigned	channel

uint32_t	bps

uint32_t	pattern

uint8_t	ptLength

uint16_t	loop

uint16_t	loopDelay

uint8_t	outputSelect

Field Documentation

◆ bps

uint32_t bps

pulse train bit rate

◆ channel

unsigned channel

PT Channel to use

◆ loop

uint16_t loop

Number of times to repeat the train, 0 = continuous

◆ loopDelay

uint16_t loopDelay

Delay between loops specified in multiples of bps

◆ outputSelect

uint8_t outputSelect

Select 0 or 1. See pins_me10.c for the pin selection for each channel. Note: not all selections valid depending on package type (See UG section 5.2).

◆ pattern

uint32_t pattern

Output pattern to shift out, starts at LSB

◆ ptLength

uint8_t ptLength

Number of bits in pulse train, 0 = 32bits, 1 = non valid , 2 = 2 bits, ...

Function Documentation

◆ MXC_PT_ClearFlags()

void MXC_PT_ClearFlags	(	mxc_ptg_regs_t *	ptg,
		uint32_t	flags
	)

Clears the pulse train's interrupt flag.

Parameters

ptg	pointer to pulse train global bus to use.
flags	bits to clear, see PTG_INTFL Register for details.

◆ MXC_PT_Config()

int MXC_PT_Config	(	mxc_ptg_regs_t *	ptg,
		mxc_pt_cfg_t *	cfg
	)

Configures the pulse train in the specified mode.

The parameters in the config structure must be set before calling this function. This function should be used for configuring pulse train mode only.

Note: The pulse train cannot be running when this function is called.

Parameters

ptg	Pointer to pulse train global bus to use.
cfg	Pointer to pulse train configuration.

Returns: E_NO_ERROR if everything is successful, error if unsuccessful.

◆ MXC_PT_DisableInt()

void MXC_PT_DisableInt	(	mxc_ptg_regs_t *	ptg,
		uint32_t	pts
	)

Disable pulse train interrupt.

Parameters

ptg	Pointer to pulse train global bus to use.
pts	Bit mask of what pulse trains to disable. Set the bit position of each pulse train to disable it. Bit0->pt0, Bit1->pt1... etc, 1 will disable the interrupt, 0 to leave a PT channel in its current state.

◆ MXC_PT_DisableRestart()

void MXC_PT_DisableRestart	(	unsigned	channel,
		uint8_t	restartIndex
	)

Disable the restart for the specified pulse train.

Parameters

channel	Pulse train channel to disable restart for.
restartIndex	selects which restart trigger to disable, 0 (x) or 1 (y).

◆ MXC_PT_EnableInt()

void MXC_PT_EnableInt	(	mxc_ptg_regs_t *	ptg,
		uint32_t	pts
	)

Enable pulse train interrupt.

Parameters

ptg	Pointer to pulse train global bus to use.
pts	Bit mask of which pulse trains to enable. Set the bit position of each pulse train to enable it. Bit0->pt0, Bit1->pt1... etc, 1 will enable the interrupt, 0 to leave a PT channel in its current state.

◆ MXC_PT_EnableRestart()

void MXC_PT_EnableRestart	(	unsigned	start,
		unsigned	stop,
		uint8_t	restartIndex
	)

Setup and enables a pulse train to restart after another pulse train has exited its loop. Each pulse train can have up to two restart triggers.

Parameters

start	Pulse train channel to start on the stop event.
stop	Pulse train channel to trigger the stop event.
restartIndex	selects which restart trigger to set, 0 (x) or 1 (y).

◆ MXC_PT_GetFlags()

uint32_t MXC_PT_GetFlags ( mxc_ptg_regs_t * ptg )

Gets the pulse trains's interrupt flags.

Parameters

ptg	Pointer to pulse train global bus to use.

Returns: The Pulse Train Interrupt Flags, PTG_INTFL_Register Register for details.

◆ MXC_PT_Init()

void MXC_PT_Init	(	mxc_ptg_regs_t *	ptg,
		mxc_clk_scale_t	clk_scale
	)

This function initializes the pulse trains to a known stopped state and sets the global PT clock scale.

Parameters

ptg	pointer to pulse train global bus to use.
clk_scale	Scale the system clock for the global PT clock.

◆ MXC_PT_IsActive()

uint32_t MXC_PT_IsActive	(	mxc_ptg_regs_t *	ptg,
		uint32_t	pts
	)

Determines if the pulse train is running.

Parameters

ptg	Pointer to pulse train global bus to use.
pts	Set the bits of pulse trains to check Bit0->pt0, Bit1->pt1... etc.

Returns: 0 Pulse train is off.; >0 Pulse train is on.

◆ MXC_PT_Resync()

void MXC_PT_Resync	(	mxc_ptg_regs_t *	ptg,
		uint32_t	pts
	)

Resynchronize individual pulse trains together. Resync will stop those resync_pts; others will be still running.

Parameters

ptg	pointer to pulse train global bus to use.
pts	pulse train modules that need to be re-synced by bit number. Bit0->pt0, Bit1->pt1... etc.

◆ MXC_PT_SetPattern()

void MXC_PT_SetPattern	(	unsigned	pts,
		uint32_t	pattern
	)

Sets the pattern of the pulse train.

Parameters

pts	Pulse train pts to operate on.
pattern	Output pattern.

◆ MXC_PT_Shutdown()

void MXC_PT_Shutdown	(	mxc_ptg_regs_t *	ptg,
		uint32_t	pts
	)

Shutdown the pulse train channel/channels.

Shutdown pulse train and if all pluse trains are shut down then turn off pulse train clock.

Note: Shutdown pulse train channel/channels and delete config.

Parameters

ptg	Pointer to pulse train global bus to use.
pts	Pulse train channel to operate on.

Returns: E_NO_ERROR if everything is successful, error if unsuccessful.

◆ MXC_PT_SqrWaveConfig()

int MXC_PT_SqrWaveConfig	(	mxc_ptg_regs_t *	ptg,
		unsigned	channel,
		uint32_t	freq,
		uint8_t	outputSelect
	)

Configures the pulse train in the square wave mode.

This function should be used for configuring square wave mode only.

Note: The pulse train cannot be running when this function is called

Parameters

ptg	Pointer to pulse train global bus to use.
channel	Pulse train channel to operate on
freq	Square wave output frequency in Hz
outputSelect	Select the output to route the pulse train channel to. 0 for output 0, non-zero for output 1.

Returns: E_NO_ERROR if everything is successful, error if unsuccessful.

◆ MXC_PT_Start()

void MXC_PT_Start	(	mxc_ptg_regs_t *	ptg,
		unsigned	pts
	)

Starts the pulse train specified.

Parameters

ptg	Pointer to pulse train global bus to use.
pts	Pulse train pts to start. Set the bits of pulse trains to check Bit0->pt0, Bit1->pt1... etc.

◆ MXC_PT_Stop()

void MXC_PT_Stop	(	mxc_ptg_regs_t *	ptg,
		unsigned	pts
	)

Stops a pulse train.

Parameters

ptg	Pointer to pulse train global bus to use.
pts	Pulse train pts to stop. Set the bits of pulse trains to check Bit0->pt0, Bit1->pt1... etc.

Modules

Data Structures

Enumerations

Functions

Detailed Description

Data Structure Documentation

◆ mxc_pt_cfg_t

Data Fields

Field Documentation

◆ bps

◆ channel

◆ loop

◆ loopDelay

◆ outputSelect

◆ pattern

◆ ptLength

Function Documentation

◆ MXC_PT_ClearFlags()

◆ MXC_PT_Config()

◆ MXC_PT_DisableInt()

◆ MXC_PT_DisableRestart()

◆ MXC_PT_EnableInt()

◆ MXC_PT_EnableRestart()

◆ MXC_PT_GetFlags()

◆ MXC_PT_Init()

◆ MXC_PT_IsActive()

◆ MXC_PT_Resync()

◆ MXC_PT_SetPattern()

◆ MXC_PT_Shutdown()

◆ MXC_PT_SqrWaveConfig()

◆ MXC_PT_Start()

◆ MXC_PT_Stop()