Configuration of DAC channels
[DAC Exported Functions]

Set the output for the selected DAC channel: * mode normal or sample-and-hold * buffer * connection to GPIO or internal path.

Note:

these settings can also be set individually using dedicated functions:

• LL_DAC_SetOutputBuffer()
• LL_DAC_SetOutputMode()
• LL_DAC_SetOutputConnection()

On this STM32 family, output connection depends on output mode (normal or sample and hold) and output buffer state.

• if output connection is set to internal path and output buffer is enabled (whatever output mode): output connection is also connected to GPIO pin (both connections to GPIO pin and internal path).
• if output connection is set to GPIO pin, output buffer is disabled, output mode set to sample and hold: output connection is also connected to internal path (both connections to GPIO pin and internal path). CR MODE1 LL_DAC_ConfigOutput
  CR MODE2 LL_DAC_ConfigOutput

Parameters:

DACx	DAC instance
DAC_Channel	This parameter can be one of the following values: LL_DAC_CHANNEL_1 LL_DAC_CHANNEL_2 (1) (1) On this STM32 family, parameter not available on all devices. Refer to device datasheet for channels availability.
OutputMode	This parameter can be one of the following values: LL_DAC_OUTPUT_MODE_NORMAL LL_DAC_OUTPUT_MODE_SAMPLE_AND_HOLD
OutputBuffer	This parameter can be one of the following values: LL_DAC_OUTPUT_BUFFER_ENABLE LL_DAC_OUTPUT_BUFFER_DISABLE
OutputConnection	This parameter can be one of the following values: LL_DAC_CONNECT_GPIO LL_DAC_CONNECT_INTERNAL

Return values:

None

Definition at line 777 of file stm32l4xx_ll_dac.h.

Get the mode for the selected DAC channel: calibration or normal mode.

CR CEN1 LL_DAC_GetMode
CR CEN2 LL_DAC_GetMode

Parameters:

DACx	DAC instance
DAC_Channel	This parameter can be one of the following values: LL_DAC_CHANNEL_1 LL_DAC_CHANNEL_2 (1) (1) On this STM32 family, parameter not available on all devices. Refer to device datasheet for channels availability.

Return values:

Returned

value can be one of the following values: LL_DAC_MODE_NORMAL_OPERATION LL_DAC_MODE_CALIBRATION

Definition at line 444 of file stm32l4xx_ll_dac.h.

Get the output buffer state for the selected DAC channel.

CR MODE1 LL_DAC_GetOutputBuffer
CR MODE2 LL_DAC_GetOutputBuffer

Parameters:

DACx	DAC instance
DAC_Channel	This parameter can be one of the following values: LL_DAC_CHANNEL_1 LL_DAC_CHANNEL_2 (1) (1) On this STM32 family, parameter not available on all devices. Refer to device datasheet for channels availability.

Return values:

Returned

value can be one of the following values: LL_DAC_OUTPUT_BUFFER_ENABLE LL_DAC_OUTPUT_BUFFER_DISABLE

Definition at line 867 of file stm32l4xx_ll_dac.h.

Get the output connection for the selected DAC channel.

Note:

On this STM32 family, output connection depends on output mode (normal or sample and hold) and output buffer state.

• if output connection is set to internal path and output buffer is enabled (whatever output mode): output connection is also connected to GPIO pin (both connections to GPIO pin and internal path).
• if output connection is set to GPIO pin, output buffer is disabled, output mode set to sample and hold: output connection is also connected to internal path (both connections to GPIO pin and internal path). CR MODE1 LL_DAC_GetOutputConnection
  CR MODE2 LL_DAC_GetOutputConnection

Parameters:

DACx	DAC instance
DAC_Channel	This parameter can be one of the following values: LL_DAC_CHANNEL_1 LL_DAC_CHANNEL_2 (1) (1) On this STM32 family, parameter not available on all devices. Refer to device datasheet for channels availability.

Return values:

Returned

value can be one of the following values: LL_DAC_CONNECT_GPIO LL_DAC_CONNECT_INTERNAL

Definition at line 930 of file stm32l4xx_ll_dac.h.

Get the output mode normal or sample-and-hold for the selected DAC channel.

CR MODE1 LL_DAC_GetOutputMode
CR MODE2 LL_DAC_GetOutputMode

Parameters:

DACx	DAC instance
DAC_Channel	This parameter can be one of the following values: LL_DAC_CHANNEL_1 LL_DAC_CHANNEL_2 (1) (1) On this STM32 family, parameter not available on all devices. Refer to device datasheet for channels availability.

Return values:

Returned

value can be one of the following values: LL_DAC_OUTPUT_MODE_NORMAL LL_DAC_OUTPUT_MODE_SAMPLE_AND_HOLD

Definition at line 820 of file stm32l4xx_ll_dac.h.

Get the sample-and-hold timing for the selected DAC channel: hold time SHHR THOLD1 LL_DAC_GetSampleAndHoldHoldTime
SHHR THOLD2 LL_DAC_GetSampleAndHoldHoldTime.

Parameters:

DACx	DAC instance
DAC_Channel	This parameter can be one of the following values: LL_DAC_CHANNEL_1 LL_DAC_CHANNEL_2 (1) (1) On this STM32 family, parameter not available on all devices. Refer to device datasheet for channels availability.

Return values:

0x000...0x3FF

Definition at line 1018 of file stm32l4xx_ll_dac.h.

Get the sample-and-hold timing for the selected DAC channel: refresh time SHRR TREFRESH1 LL_DAC_GetSampleAndHoldRefreshTime
SHRR TREFRESH2 LL_DAC_GetSampleAndHoldRefreshTime.

Parameters:

DACx	DAC instance
DAC_Channel	This parameter can be one of the following values: LL_DAC_CHANNEL_1 LL_DAC_CHANNEL_2 (1) (1) On this STM32 family, parameter not available on all devices. Refer to device datasheet for channels availability.

Return values:

0x00...0xFF

Definition at line 1059 of file stm32l4xx_ll_dac.h.

Get the sample-and-hold timing for the selected DAC channel: sample time SHSR1 TSAMPLE1 LL_DAC_GetSampleAndHoldSampleTime
SHSR2 TSAMPLE2 LL_DAC_GetSampleAndHoldSampleTime.

Parameters:

DACx	DAC instance
DAC_Channel	This parameter can be one of the following values: LL_DAC_CHANNEL_1 LL_DAC_CHANNEL_2 (1) (1) On this STM32 family, parameter not available on all devices. Refer to device datasheet for channels availability.

Return values:

0x000...0x3FF

Definition at line 977 of file stm32l4xx_ll_dac.h.

Get the conversion trigger source for the selected DAC channel.

Note:

For conversion trigger source to be effective, DAC trigger must be enabled using function LL_DAC_EnableTrigger(). CR TSEL1 LL_DAC_GetTriggerSource
CR TSEL2 LL_DAC_GetTriggerSource

Parameters:

DACx	DAC instance
DAC_Channel	This parameter can be one of the following values: LL_DAC_CHANNEL_1 LL_DAC_CHANNEL_2 (1) (1) On this STM32 family, parameter not available on all devices. Refer to device datasheet for channels availability.

Return values:

Returned

value can be one of the following values: LL_DAC_TRIGGER_TIM2_TRGO LL_DAC_TRIGGER_TIM4_TRGO LL_DAC_TRIGGER_TIM5_TRGO LL_DAC_TRIGGER_TIM6_TRGO LL_DAC_TRIGGER_TIM7_TRGO LL_DAC_TRIGGER_TIM8_TRGO LL_DAC_TRIGGER_EXT_IT9 LL_DAC_TRIGGER_SOFTWARE

Definition at line 548 of file stm32l4xx_ll_dac.h.

Get the offset trimming value for the selected DAC channel.

Trimming has an impact when output buffer is enabled and is intended to replace factory calibration default values. CCR OTRIM1 LL_DAC_GetTrimmingValue
CCR OTRIM2 LL_DAC_GetTrimmingValue

Parameters:

DACx	DAC instance
DAC_Channel	This parameter can be one of the following values: LL_DAC_CHANNEL_1 LL_DAC_CHANNEL_2 (1) (1) On this STM32 family, parameter not available on all devices. Refer to device datasheet for channels availability.

Return values:

TrimmingValue

0x00...0x1F

Definition at line 487 of file stm32l4xx_ll_dac.h.

Get the wave generation mode for the selected DAC channel.

CR WAVE1 LL_DAC_GetWaveMode
CR WAVE2 LL_DAC_GetWaveMode

Parameters:

DACx	DAC instance
DAC_Channel	This parameter can be one of the following values: LL_DAC_CHANNEL_1 LL_DAC_CHANNEL_2 (1) (1) On this STM32 family, parameter not available on all devices. Refer to device datasheet for channels availability.

Return values:

Returned

value can be one of the following values: LL_DAC_WAVEGENERATION_NONE LL_DAC_WAVEGENERATION_NOISE LL_DAC_WAVEGENERATION_TRIANGLE

Definition at line 593 of file stm32l4xx_ll_dac.h.

Set the noise generation for the selected DAC channel: Noise mode and parameters LFSR (linear feedback shift register).

CR MAMP1 LL_DAC_GetWaveNoiseLFSR
CR MAMP2 LL_DAC_GetWaveNoiseLFSR

Parameters:

DACx	DAC instance
DAC_Channel	This parameter can be one of the following values: LL_DAC_CHANNEL_1 LL_DAC_CHANNEL_2 (1) (1) On this STM32 family, parameter not available on all devices. Refer to device datasheet for channels availability.

Return values:

Returned

value can be one of the following values: LL_DAC_NOISE_LFSR_UNMASK_BIT0 LL_DAC_NOISE_LFSR_UNMASK_BITS1_0 LL_DAC_NOISE_LFSR_UNMASK_BITS2_0 LL_DAC_NOISE_LFSR_UNMASK_BITS3_0 LL_DAC_NOISE_LFSR_UNMASK_BITS4_0 LL_DAC_NOISE_LFSR_UNMASK_BITS5_0 LL_DAC_NOISE_LFSR_UNMASK_BITS6_0 LL_DAC_NOISE_LFSR_UNMASK_BITS7_0 LL_DAC_NOISE_LFSR_UNMASK_BITS8_0 LL_DAC_NOISE_LFSR_UNMASK_BITS9_0 LL_DAC_NOISE_LFSR_UNMASK_BITS10_0 LL_DAC_NOISE_LFSR_UNMASK_BITS11_0

Definition at line 662 of file stm32l4xx_ll_dac.h.

Set the triangle generation for the selected DAC channel: triangle mode and amplitude.

CR MAMP1 LL_DAC_GetWaveTriangleAmplitude
CR MAMP2 LL_DAC_GetWaveTriangleAmplitude

Parameters:

DACx	DAC instance
DAC_Channel	This parameter can be one of the following values: LL_DAC_CHANNEL_1 LL_DAC_CHANNEL_2 (1) (1) On this STM32 family, parameter not available on all devices. Refer to device datasheet for channels availability.

Return values:

Returned

value can be one of the following values: LL_DAC_TRIANGLE_AMPLITUDE_1 LL_DAC_TRIANGLE_AMPLITUDE_3 LL_DAC_TRIANGLE_AMPLITUDE_7 LL_DAC_TRIANGLE_AMPLITUDE_15 LL_DAC_TRIANGLE_AMPLITUDE_31 LL_DAC_TRIANGLE_AMPLITUDE_63 LL_DAC_TRIANGLE_AMPLITUDE_127 LL_DAC_TRIANGLE_AMPLITUDE_255 LL_DAC_TRIANGLE_AMPLITUDE_511 LL_DAC_TRIANGLE_AMPLITUDE_1023 LL_DAC_TRIANGLE_AMPLITUDE_2047 LL_DAC_TRIANGLE_AMPLITUDE_4095

Definition at line 731 of file stm32l4xx_ll_dac.h.

Set the mode for the selected DAC channel: calibration or normal mode.

CR CEN1 LL_DAC_SetMode
CR CEN2 LL_DAC_SetMode

Parameters:

DACx	DAC instance
DAC_Channel	This parameter can be one of the following values: LL_DAC_CHANNEL_1 LL_DAC_CHANNEL_2 (1) (1) On this STM32 family, parameter not available on all devices. Refer to device datasheet for channels availability.
ChannelMode	This parameter can be one of the following values: LL_DAC_MODE_NORMAL_OPERATION LL_DAC_MODE_CALIBRATION

Return values:

None

Definition at line 423 of file stm32l4xx_ll_dac.h.

Set the output buffer for the selected DAC channel.

Note:

On this STM32 family, when buffer is enabled, its offset can be trimmed: factory calibration default values can be replaced by user trimming values, using function LL_DAC_SetTrimmingValue(). CR MODE1 LL_DAC_SetOutputBuffer
CR MODE2 LL_DAC_SetOutputBuffer

Parameters:

DACx	DAC instance
DAC_Channel	This parameter can be one of the following values: LL_DAC_CHANNEL_1 LL_DAC_CHANNEL_2 (1) (1) On this STM32 family, parameter not available on all devices. Refer to device datasheet for channels availability.
OutputBuffer	This parameter can be one of the following values: LL_DAC_OUTPUT_BUFFER_ENABLE LL_DAC_OUTPUT_BUFFER_DISABLE

Return values:

None

Definition at line 846 of file stm32l4xx_ll_dac.h.

Set the output connection for the selected DAC channel.

Note:

On this STM32 family, output connection depends on output mode (normal or sample and hold) and output buffer state.

• if output connection is set to internal path and output buffer is enabled (whatever output mode): output connection is also connected to GPIO pin (both connections to GPIO pin and internal path).
• if output connection is set to GPIO pin, output buffer is disabled, output mode set to sample and hold: output connection is also connected to internal path (both connections to GPIO pin and internal path). CR MODE1 LL_DAC_SetOutputConnection
  CR MODE2 LL_DAC_SetOutputConnection

Parameters:

DACx	DAC instance
DAC_Channel	This parameter can be one of the following values: LL_DAC_CHANNEL_1 LL_DAC_CHANNEL_2 (1) (1) On this STM32 family, parameter not available on all devices. Refer to device datasheet for channels availability.
OutputConnection	This parameter can be one of the following values: LL_DAC_CONNECT_GPIO LL_DAC_CONNECT_INTERNAL

Return values:

None

Definition at line 899 of file stm32l4xx_ll_dac.h.

Set the output mode normal or sample-and-hold for the selected DAC channel.

CR MODE1 LL_DAC_SetOutputMode
CR MODE2 LL_DAC_SetOutputMode

Parameters:

DACx	DAC instance
DAC_Channel	This parameter can be one of the following values: LL_DAC_CHANNEL_1 LL_DAC_CHANNEL_2 (1) (1) On this STM32 family, parameter not available on all devices. Refer to device datasheet for channels availability.
OutputMode	This parameter can be one of the following values: LL_DAC_OUTPUT_MODE_NORMAL LL_DAC_OUTPUT_MODE_SAMPLE_AND_HOLD

Return values:

None

Definition at line 799 of file stm32l4xx_ll_dac.h.

Set the sample-and-hold timing for the selected DAC channel: hold time SHHR THOLD1 LL_DAC_SetSampleAndHoldHoldTime
SHHR THOLD2 LL_DAC_SetSampleAndHoldHoldTime.

Parameters:

DACx	DAC instance
DAC_Channel	This parameter can be one of the following values: LL_DAC_CHANNEL_1 LL_DAC_CHANNEL_2 (1) (1) On this STM32 family, parameter not available on all devices. Refer to device datasheet for channels availability.
HoldTime	0x000...0x3FF

Return values:

None

Definition at line 998 of file stm32l4xx_ll_dac.h.

Set the sample-and-hold timing for the selected DAC channel: refresh time SHRR TREFRESH1 LL_DAC_SetSampleAndHoldRefreshTime
SHRR TREFRESH2 LL_DAC_SetSampleAndHoldRefreshTime.

Parameters:

DACx	DAC instance
DAC_Channel	This parameter can be one of the following values: LL_DAC_CHANNEL_1 LL_DAC_CHANNEL_2 (1) (1) On this STM32 family, parameter not available on all devices. Refer to device datasheet for channels availability.
RefreshTime	0x00...0xFF

Return values:

None

Definition at line 1039 of file stm32l4xx_ll_dac.h.

Set the sample-and-hold timing for the selected DAC channel: sample time.

Note:

Sample time must be set when DAC channel is disabled or during DAC operation when DAC channel flag BWSTx is reset, otherwise the setting is ignored. Check BWSTx flag state using function "LL_DAC_IsActiveFlag_BWSTx()". SHSR1 TSAMPLE1 LL_DAC_SetSampleAndHoldSampleTime
SHSR2 TSAMPLE2 LL_DAC_SetSampleAndHoldSampleTime

Parameters:

DACx	DAC instance
DAC_Channel	This parameter can be one of the following values: LL_DAC_CHANNEL_1 LL_DAC_CHANNEL_2 (1) (1) On this STM32 family, parameter not available on all devices. Refer to device datasheet for channels availability.
SampleTime	0x000...0x3FF

Return values:

None

Definition at line 955 of file stm32l4xx_ll_dac.h.

Set the conversion trigger source for the selected DAC channel.

Note:

For conversion trigger source to be effective, DAC trigger must be enabled using function LL_DAC_EnableTrigger().

To set conversion trigger source, DAC channel must be disabled. Otherwise, the setting is discarded. CR TSEL1 LL_DAC_SetTriggerSource
CR TSEL2 LL_DAC_SetTriggerSource

Parameters:

DACx	DAC instance
DAC_Channel	This parameter can be one of the following values: LL_DAC_CHANNEL_1 LL_DAC_CHANNEL_2 (1) (1) On this STM32 family, parameter not available on all devices. Refer to device datasheet for channels availability.
DAC_Trigger	This parameter can be one of the following values: LL_DAC_TRIGGER_TIM2_TRGO LL_DAC_TRIGGER_TIM4_TRGO LL_DAC_TRIGGER_TIM5_TRGO LL_DAC_TRIGGER_TIM6_TRGO LL_DAC_TRIGGER_TIM7_TRGO LL_DAC_TRIGGER_TIM8_TRGO LL_DAC_TRIGGER_EXT_IT9 LL_DAC_TRIGGER_SOFTWARE

Return values:

None

Definition at line 519 of file stm32l4xx_ll_dac.h.

Set the offset trimming value for the selected DAC channel.

Trimming has an impact when output buffer is enabled and is intended to replace factory calibration default values. CCR OTRIM1 LL_DAC_SetTrimmingValue
CCR OTRIM2 LL_DAC_SetTrimmingValue

Parameters:

DACx	DAC instance
DAC_Channel	This parameter can be one of the following values: LL_DAC_CHANNEL_1 LL_DAC_CHANNEL_2 (1) (1) On this STM32 family, parameter not available on all devices. Refer to device datasheet for channels availability.
TrimmingValue	0x00...0x1F

Return values:

None

Definition at line 466 of file stm32l4xx_ll_dac.h.

Set the wave generation mode for the selected DAC channel.

CR WAVE1 LL_DAC_SetWaveMode
CR WAVE2 LL_DAC_SetWaveMode

Parameters:

DACx	DAC instance
DAC_Channel	This parameter can be one of the following values: LL_DAC_CHANNEL_1 LL_DAC_CHANNEL_2 (1) (1) On this STM32 family, parameter not available on all devices. Refer to device datasheet for channels availability.
WaveMode	This parameter can be one of the following values: LL_DAC_WAVEGENERATION_NONE LL_DAC_WAVEGENERATION_NOISE LL_DAC_WAVEGENERATION_TRIANGLE

Return values:

None

Definition at line 571 of file stm32l4xx_ll_dac.h.

Set the noise generation for the selected DAC channel: Noise mode and parameters LFSR (linear feedback shift register).

Note:

For wave generation to be effective, DAC channel wave generation mode must be enabled using function LL_DAC_SetWaveMode().

This setting can be set when the selected DAC channel is disabled (otherwise, the setting operation is ignored). CR MAMP1 LL_DAC_SetWaveNoiseLFSR
CR MAMP2 LL_DAC_SetWaveNoiseLFSR

Parameters:

DACx	DAC instance
DAC_Channel	This parameter can be one of the following values: LL_DAC_CHANNEL_1 LL_DAC_CHANNEL_2 (1) (1) On this STM32 family, parameter not available on all devices. Refer to device datasheet for channels availability.
NoiseLFSRMask	This parameter can be one of the following values: LL_DAC_NOISE_LFSR_UNMASK_BIT0 LL_DAC_NOISE_LFSR_UNMASK_BITS1_0 LL_DAC_NOISE_LFSR_UNMASK_BITS2_0 LL_DAC_NOISE_LFSR_UNMASK_BITS3_0 LL_DAC_NOISE_LFSR_UNMASK_BITS4_0 LL_DAC_NOISE_LFSR_UNMASK_BITS5_0 LL_DAC_NOISE_LFSR_UNMASK_BITS6_0 LL_DAC_NOISE_LFSR_UNMASK_BITS7_0 LL_DAC_NOISE_LFSR_UNMASK_BITS8_0 LL_DAC_NOISE_LFSR_UNMASK_BITS9_0 LL_DAC_NOISE_LFSR_UNMASK_BITS10_0 LL_DAC_NOISE_LFSR_UNMASK_BITS11_0

Return values:

None

Definition at line 630 of file stm32l4xx_ll_dac.h.

Set the triangle generation for the selected DAC channel: triangle mode and amplitude.

Note:

For wave generation to be effective, DAC channel wave generation mode must be enabled using function LL_DAC_SetWaveMode().

This setting can be set when the selected DAC channel is disabled (otherwise, the setting operation is ignored). CR MAMP1 LL_DAC_SetWaveTriangleAmplitude
CR MAMP2 LL_DAC_SetWaveTriangleAmplitude

Parameters:

DACx	DAC instance
DAC_Channel	This parameter can be one of the following values: LL_DAC_CHANNEL_1 LL_DAC_CHANNEL_2 (1) (1) On this STM32 family, parameter not available on all devices. Refer to device datasheet for channels availability.
TriangleAmplitude	This parameter can be one of the following values: LL_DAC_TRIANGLE_AMPLITUDE_1 LL_DAC_TRIANGLE_AMPLITUDE_3 LL_DAC_TRIANGLE_AMPLITUDE_7 LL_DAC_TRIANGLE_AMPLITUDE_15 LL_DAC_TRIANGLE_AMPLITUDE_31 LL_DAC_TRIANGLE_AMPLITUDE_63 LL_DAC_TRIANGLE_AMPLITUDE_127 LL_DAC_TRIANGLE_AMPLITUDE_255 LL_DAC_TRIANGLE_AMPLITUDE_511 LL_DAC_TRIANGLE_AMPLITUDE_1023 LL_DAC_TRIANGLE_AMPLITUDE_2047 LL_DAC_TRIANGLE_AMPLITUDE_4095

Return values:

None

Definition at line 699 of file stm32l4xx_ll_dac.h.