VDAC - Voltage DAC
Description
Digital to Analog Voltage Converter (VDAC) Peripheral API.
This module contains functions to control the VDAC peripheral of Silicon Labs' 32-bit MCUs and SoCs. VDAC converts digital values to analog signals at up to 500 ksps with 12-bit accuracy. VDAC is designed for low energy consumption, but can also provide very good performance.
The following steps are necessary for basic operation:
Clock enable:
Initialize the VDAC with default settings and modify selected fields:
Perform a conversion:
- Note
- The output stage of a VDAC channel consists of an on-chip operational amplifier (OPAMP) in the OPAMP module. This OPAMP is highly configurable; and to exploit the VDAC functionality fully, configure the OPAMP using the OPAMP API. Using the OPAMP API also loads OPAMP calibration values. The default (reset) settings of OPAMP is sufficient for many applications.
Data Structures |
|
struct | VDAC_Init_TypeDef |
VDAC initialization structure, common for both channels.
|
|
struct | VDAC_InitChannel_TypeDef |
VDAC channel initialization structure.
|
|
Functions |
|
void | VDAC_ChannelOutputSet (VDAC_TypeDef *vdac, unsigned int channel, uint32_t value) |
Set the output signal of a VDAC channel to a given value.
|
|
void | VDAC_Enable (VDAC_TypeDef *vdac, unsigned int ch, bool enable) |
Enable/disable the VDAC channel.
|
|
void | VDAC_Init (VDAC_TypeDef *vdac, const VDAC_Init_TypeDef *init) |
Initialize VDAC.
|
|
void | VDAC_InitChannel (VDAC_TypeDef *vdac, const VDAC_InitChannel_TypeDef *init, unsigned int ch) |
Initialize a VDAC channel.
|
|
void | VDAC_Channel0OutputSet (VDAC_TypeDef *vdac, uint32_t value) |
Set the output signal of VDAC channel 0 to a given value.
|
|
void | VDAC_Channel1OutputSet (VDAC_TypeDef *vdac, uint32_t value) |
Set the output signal of VDAC channel 1 to a given value.
|
|
void | VDAC_IntClear (VDAC_TypeDef *vdac, uint32_t flags) |
Clear one or more pending VDAC interrupts.
|
|
void | VDAC_IntDisable (VDAC_TypeDef *vdac, uint32_t flags) |
Disable one or more VDAC interrupts.
|
|
void | VDAC_IntEnable (VDAC_TypeDef *vdac, uint32_t flags) |
Enable one or more VDAC interrupts.
|
|
uint32_t | VDAC_IntGet (VDAC_TypeDef *vdac) |
Get pending VDAC interrupt flags.
|
|
uint32_t | VDAC_IntGetEnabled (VDAC_TypeDef *vdac) |
Get enabled and pending VDAC interrupt flags.
|
|
void | VDAC_IntSet (VDAC_TypeDef *vdac, uint32_t flags) |
Set one or more pending VDAC interrupts from SW.
|
|
uint32_t | VDAC_PrescaleCalc (uint32_t vdacFreq, bool syncMode, uint32_t hfperFreq) |
Calculate the prescaler value used to determine VDAC clock.
|
|
void | VDAC_Reset (VDAC_TypeDef *vdac) |
Reset VDAC to same state that it was in after a hardwares reset.
|
|
Macros |
|
#define | VDAC_INIT_DEFAULT |
Default configuration for VDAC initialization structure.
|
|
#define | VDAC_INITCHANNEL_DEFAULT |
Default configuration for VDAC channel initialization structure.
|
|
Enumerations |
|
enum |
VDAC_Refresh_TypeDef
{
vdacRefresh8 = _VDAC_CTRL_REFRESHPERIOD_8CYCLES, vdacRefresh16 = _VDAC_CTRL_REFRESHPERIOD_16CYCLES, vdacRefresh32 = _VDAC_CTRL_REFRESHPERIOD_32CYCLES, vdacRefresh64 = _VDAC_CTRL_REFRESHPERIOD_64CYCLES } |
Channel refresh period.
|
|
enum |
VDAC_Ref_TypeDef
{
vdacRef1V25Ln = _VDAC_CTRL_REFSEL_1V25LN, vdacRef2V5Ln = _VDAC_CTRL_REFSEL_2V5LN, vdacRef1V25 = _VDAC_CTRL_REFSEL_1V25, vdacRef2V5 = _VDAC_CTRL_REFSEL_2V5, vdacRefAvdd = _VDAC_CTRL_REFSEL_VDD, vdacRefExtPin = _VDAC_CTRL_REFSEL_EXT } |
Reference voltage for VDAC.
|
|
enum |
VDAC_PrsSel_TypeDef
{
vdacPrsSelCh0 = _VDAC_CH0CTRL_PRSSEL_PRSCH0, vdacPrsSelCh1 = _VDAC_CH0CTRL_PRSSEL_PRSCH1, vdacPrsSelCh2 = _VDAC_CH0CTRL_PRSSEL_PRSCH2, vdacPrsSelCh3 = _VDAC_CH0CTRL_PRSSEL_PRSCH3, vdacPrsSelCh4 = _VDAC_CH0CTRL_PRSSEL_PRSCH4, vdacPrsSelCh5 = _VDAC_CH0CTRL_PRSSEL_PRSCH5, vdacPrsSelCh6 = _VDAC_CH0CTRL_PRSSEL_PRSCH6, vdacPrsSelCh7 = _VDAC_CH0CTRL_PRSSEL_PRSCH7, vdacPrsSelCh8 = _VDAC_CH0CTRL_PRSSEL_PRSCH8, vdacPrsSelCh9 = _VDAC_CH0CTRL_PRSSEL_PRSCH9, vdacPrsSelCh10 = _VDAC_CH0CTRL_PRSSEL_PRSCH10, vdacPrsSelCh11 = _VDAC_CH0CTRL_PRSSEL_PRSCH11 } |
Peripheral Reflex System signal used to trigger VDAC channel conversion.
|
|
enum |
VDAC_TrigMode_TypeDef
{
vdacTrigModeSw = _VDAC_CH0CTRL_TRIGMODE_SW, vdacTrigModePrs = _VDAC_CH0CTRL_TRIGMODE_PRS, vdacTrigModeRefresh = _VDAC_CH0CTRL_TRIGMODE_REFRESH, vdacTrigModeSwPrs = _VDAC_CH0CTRL_TRIGMODE_SWPRS, vdacTrigModeSwRefresh = _VDAC_CH0CTRL_TRIGMODE_SWREFRESH, vdacTrigModeLesense = _VDAC_CH0CTRL_TRIGMODE_LESENSE } |
Channel conversion trigger mode.
|
|
Function Documentation
◆ VDAC_ChannelOutputSet()
void VDAC_ChannelOutputSet | ( | VDAC_TypeDef * |
vdac,
|
unsigned int |
channel,
|
||
uint32_t |
value
|
||
) |
Set the output signal of a VDAC channel to a given value.
This function sets the output signal of a VDAC channel by writing
value
to the corresponding CHnDATA register.
- Parameters
-
[in] vdac
A pointer to the VDAC peripheral register block. [in] channel
A channel number to set the output of. [in] value
A value to write to the channel output register CHnDATA.
◆ VDAC_Enable()
void VDAC_Enable | ( | VDAC_TypeDef * |
vdac,
|
unsigned int |
ch,
|
||
bool |
enable
|
||
) |
Enable/disable the VDAC channel.
- Parameters
-
[in] vdac
A pointer to the VDAC peripheral register block. [in] ch
A channel to enable/disable. [in] enable
True to enable VDAC channel, false to disable.
◆ VDAC_Init()
void VDAC_Init | ( | VDAC_TypeDef * |
vdac,
|
const VDAC_Init_TypeDef * |
init
|
||
) |
Initialize VDAC.
Initializes the common parts for both channels. This function will also load calibration values from the Device Information (DI) page into the VDAC calibration register. To complete a VDAC setup, channel control configuration must also be done. See VDAC_InitChannel() .
- Note
- This function will disable both channels prior to configuration.
- Parameters
-
[in] vdac
A pointer to the VDAC peripheral register block. [in] init
A pointer to the VDAC initialization structure.
◆ VDAC_InitChannel()
void VDAC_InitChannel | ( | VDAC_TypeDef * |
vdac,
|
const VDAC_InitChannel_TypeDef * |
init,
|
||
unsigned int |
ch
|
||
) |
Initialize a VDAC channel.
- Parameters
-
[in] vdac
A pointer to the VDAC peripheral register block. [in] init
A pointer to the VDAC channel initialization structure. [in] ch
A channel number to initialize.
◆ VDAC_Channel0OutputSet()
|
inline |
Set the output signal of VDAC channel 0 to a given value.
This function sets the output signal of VDAC channel 0 by writing
value
to the CH0DATA register.
- Parameters
-
[in] vdac
Pointer to VDAC peripheral register block. [in] value
Value to write to channel 0 output register CH0DATA.
◆ VDAC_Channel1OutputSet()
|
inline |
Set the output signal of VDAC channel 1 to a given value.
This function sets the output signal of VDAC channel 1 by writing
value
to the CH1DATA register.
- Parameters
-
[in] vdac
Pointer to VDAC peripheral register block. [in] value
Value to write to channel 1 output register CH1DATA.
◆ VDAC_IntClear()
|
inline |
Clear one or more pending VDAC interrupts.
- Parameters
-
[in] vdac
Pointer to VDAC peripheral register block. [in] flags
Pending VDAC interrupt source to clear. Use a bitwise logic OR combination of valid interrupt flags for the VDAC module (VDAC_IF_nnn).
◆ VDAC_IntDisable()
|
inline |
Disable one or more VDAC interrupts.
- Parameters
-
[in] vdac
Pointer to VDAC peripheral register block. [in] flags
VDAC interrupt sources to disable. Use a bitwise logic OR combination of valid interrupt flags for the VDAC module (VDAC_IF_nnn).
◆ VDAC_IntEnable()
|
inline |
Enable one or more VDAC interrupts.
- Note
- Depending on the use, a pending interrupt may already be set prior to enabling the interrupt. To ignore a pending interrupt, consider using VDAC_IntClear() prior to enabling the interrupt.
- Parameters
-
[in] vdac
Pointer to VDAC peripheral register block. [in] flags
VDAC interrupt sources to enable. Use a bitwise logic OR combination of valid interrupt flags for the VDAC module (VDAC_IF_nnn).
◆ VDAC_IntGet()
|
inline |
Get pending VDAC interrupt flags.
- Note
- The event bits are not cleared by the use of this function.
- Parameters
-
[in] vdac
Pointer to VDAC peripheral register block.
- Returns
- VDAC interrupt sources pending. Use a bitwise logic OR combination of valid interrupt flags for the VDAC module (VDAC_IF_nnn).
◆ VDAC_IntGetEnabled()
|
inline |
Get enabled and pending VDAC interrupt flags.
Useful for handling more interrupt sources in the same interrupt handler.
- Parameters
-
[in] vdac
Pointer to VDAC peripheral register block.
- Note
- Interrupt flags are not cleared by the use of this function.
- Returns
-
Pending and enabled VDAC interrupt sources. The return value is the bitwise AND combination of
- the OR combination of enabled interrupt sources in VDACx_IEN_nnn register (VDACx_IEN_nnn) and
- the OR combination of valid interrupt flags of the VDAC module (VDACx_IF_nnn).
◆ VDAC_IntSet()
|
inline |
Set one or more pending VDAC interrupts from SW.
- Parameters
-
[in] vdac
Pointer to VDAC peripheral register block. [in] flags
VDAC interrupt sources to set to pending. Use a bitwise logic OR combination of valid interrupt flags for the VDAC module (VDAC_IF_nnn).
◆ VDAC_PrescaleCalc()
uint32_t VDAC_PrescaleCalc | ( | uint32_t |
vdacFreq,
|
bool |
syncMode,
|
||
uint32_t |
hfperFreq
|
||
) |
Calculate the prescaler value used to determine VDAC clock.
The VDAC clock is given by the input clock divided by the prescaler+1.
VDAC_CLK = IN_CLK / (prescale + 1)
The maximum VDAC clock is 1 MHz. The input clock is HFPERCLK/HFPERCCLK when VDAC synchronous mode is selected, or an internal oscillator of 10 MHz +/- 20% when asynchronous mode is selected.
- Note
- If the requested VDAC frequency is low and the maximum prescaler value can't adjust the actual VDAC frequency lower than requested, the maximum prescaler value is returned resulting in a higher VDAC frequency than requested.
- Parameters
-
[in] vdacFreq
VDAC frequency target. The frequency will automatically be adjusted to be below maximum allowed VDAC clock. [in] syncMode
Set to true if you intend to use VDAC in synchronous mode. [in] hfperFreq
Frequency in Hz of HFPERCLK/HFPERCCLK oscillator. Set to 0 to use the currently defined HFPERCLK/HFPERCCLK clock setting. This parameter is only used when syncMode is set to true.
- Returns
-
A prescaler value to use for VDAC to achieve a clock value less than or equal to
vdacFreq
.
◆ VDAC_Reset()
void VDAC_Reset | ( | VDAC_TypeDef * |
vdac
|
) |
Reset VDAC to same state that it was in after a hardwares reset.
- Parameters
-
[in] vdac
A pointer to the VDAC peripheral register block.
Macro Definition Documentation
◆ VDAC_INIT_DEFAULT
#define VDAC_INIT_DEFAULT |
Default configuration for VDAC initialization structure.
◆ VDAC_INITCHANNEL_DEFAULT
#define VDAC_INITCHANNEL_DEFAULT |
Default configuration for VDAC channel initialization structure.
Enumeration Type Documentation
◆ VDAC_Refresh_TypeDef
enum VDAC_Refresh_TypeDef |
◆ VDAC_Ref_TypeDef
enum VDAC_Ref_TypeDef |
Reference voltage for VDAC.
◆ VDAC_PrsSel_TypeDef
enum VDAC_PrsSel_TypeDef |
Peripheral Reflex System signal used to trigger VDAC channel conversion.
◆ VDAC_TrigMode_TypeDef
Channel conversion trigger mode.