EFR32 Blue Gecko 12 Software Documentation  efr32bg12-doc-5.1.2

Detailed Description

Peripheral Reflex System (PRS) Peripheral API.

This module contains functions to control the PRS peripheral of Silicon Labs 32-bit MCUs and SoCs. The PRS allows configurable, fast and autonomous communication between peripherals on the MCU or SoC.

Enumerations

enum  PRS_Edge_TypeDef {
  prsEdgeOff = PRS_CH_CTRL_EDSEL_OFF,
  prsEdgePos = PRS_CH_CTRL_EDSEL_POSEDGE,
  prsEdgeNeg = PRS_CH_CTRL_EDSEL_NEGEDGE,
  prsEdgeBoth = PRS_CH_CTRL_EDSEL_BOTHEDGES
}
 

Functions

__STATIC_INLINE void PRS_LevelSet (uint32_t level, uint32_t mask)
 Set level control bit for one or more channels. More...
 
__STATIC_INLINE void PRS_PulseTrigger (uint32_t channels)
 Trigger a high pulse (one HFPERCLK) for one or more channels. More...
 
void PRS_SourceAsyncSignalSet (unsigned int ch, uint32_t source, uint32_t signal)
 Set source and asynchronous signal to be used for a channel. More...
 
void PRS_SourceSignalSet (unsigned int ch, uint32_t source, uint32_t signal, PRS_Edge_TypeDef edge)
 Set source and signal to be used for a channel. More...
 

Enumeration Type Documentation

Edge detection type.

Enumerator
prsEdgeOff 

Leave signal as is.

prsEdgePos 

Generate pules on positive edge.

prsEdgeNeg 

Generate pules on negative edge.

prsEdgeBoth 

Generate pules on both edges.

Definition at line 58 of file em_prs.h.

Function Documentation

__STATIC_INLINE void PRS_LevelSet ( uint32_t  level,
uint32_t  mask 
)

Set level control bit for one or more channels.

The level value for a channel is XORed with both the pulse possible issued by PRS_PulseTrigger() and the PRS input signal selected for the channel(s).

Parameters
[in]levelLevel to use for channels indicated by mask. Use logical OR combination of PRS_SWLEVEL_CHnLEVEL defines for channels to set high level, otherwise 0.
[in]maskMask indicating which channels to set level for. Use logical OR combination of PRS_SWLEVEL_CHnLEVEL defines.

Definition at line 86 of file em_prs.h.

References PRS.

__STATIC_INLINE void PRS_PulseTrigger ( uint32_t  channels)

Trigger a high pulse (one HFPERCLK) for one or more channels.

Setting a bit for a channel causes the bit in the register to remain high for one HFPERCLK cycle. The pulse is XORed with both the corresponding bit in PRS SWLEVEL register and the PRS input signal selected for the channel(s).

Parameters
[in]channelsLogical ORed combination of channels to trigger a pulse for. Use PRS_SWPULSE_CHnPULSE defines.

Definition at line 106 of file em_prs.h.

References _PRS_SWPULSE_MASK, and PRS.

void PRS_SourceAsyncSignalSet ( unsigned int  ch,
uint32_t  source,
uint32_t  signal 
)

Set source and asynchronous signal to be used for a channel.

Asynchronous reflexes are not clocked on HFPERCLK, and can be used even in EM2/EM3. There is a limitation to reflexes operating in asynchronous mode: they can only be used by a subset of the reflex consumers. Please refer to PRS chapter in the reference manual for the complete list of supported asynchronous signals and consumers.

Note
This function is not supported on EFM32GxxxFyyy parts. In asynchronous mode, the edge detector only works in EM0, hence it shall not be used. The EDSEL parameter in PRS_CHx_CTRL register is set to 0 (OFF) by default.
Parameters
[in]chChannel to define source and asynchronous signal for.
[in]sourceSource to select for channel. Use one of PRS_CH_CTRL_SOURCESEL_x defines.
[in]signalAsynchronous signal (for selected source) to use. Use one of the PRS_CH_CTRL_SIGSEL_x defines that support asynchronous operation.

Definition at line 115 of file em_prs.c.

References _PRS_CH_CTRL_SIGSEL_MASK, _PRS_CH_CTRL_SOURCESEL_MASK, PRS, PRS_CH_CTRL_ASYNC, PRS_CH_CTRL_EDSEL_OFF, and PRS_CHAN_COUNT.

Referenced by adcDeInit(), ezradio_hal_GpioInit(), MIC_deInit(), and MIC_init().

void PRS_SourceSignalSet ( unsigned int  ch,
uint32_t  source,
uint32_t  signal,
PRS_Edge_TypeDef  edge 
)

Set source and signal to be used for a channel.

Parameters
[in]chChannel to define signal and source for.
[in]sourceSource to select for channel. Use one of PRS_CH_CTRL_SOURCESEL_x defines.
[in]signalSignal (for selected source) to use. Use one of PRS_CH_CTRL_SIGSEL_x defines.
[in]edgeEdge (for selected source/signal) to generate pulse for.

Definition at line 74 of file em_prs.c.

References _PRS_CH_CTRL_SIGSEL_MASK, _PRS_CH_CTRL_SOURCESEL_MASK, PRS, and PRS_CHAN_COUNT.

Referenced by BOARD_init().