Extended IO operation functions. More...

Functions
HAL_StatusTypeDef	HAL_DACEx_TriangleWaveGenerate (DAC_HandleTypeDef *hdac, uint32_t Channel, uint32_t Amplitude)
	Enable or disable the selected DAC channel wave generation. More...

HAL_StatusTypeDef	HAL_DACEx_NoiseWaveGenerate (DAC_HandleTypeDef *hdac, uint32_t Channel, uint32_t Amplitude)
	Enable or disable the selected DAC channel wave generation. More...

HAL_StatusTypeDef	HAL_DACEx_DualSetValue (DAC_HandleTypeDef *hdac, uint32_t Alignment, uint32_t Data1, uint32_t Data2)
	Set the specified data holding register value for dual DAC channel. More...

__weak void	HAL_DACEx_ConvCpltCallbackCh2 (DAC_HandleTypeDef *hdac)
	Conversion complete callback in non-blocking mode for Channel2. More...

__weak void	HAL_DACEx_ConvHalfCpltCallbackCh2 (DAC_HandleTypeDef *hdac)
	Conversion half DMA transfer callback in non-blocking mode for Channel2. More...

__weak void	HAL_DACEx_ErrorCallbackCh2 (DAC_HandleTypeDef *hdac)
	Error DAC callback for Channel2. More...

__weak void	HAL_DACEx_DMAUnderrunCallbackCh2 (DAC_HandleTypeDef *hdac)
	DMA underrun DAC callback for Channel2. More...

HAL_StatusTypeDef	HAL_DACEx_SelfCalibrate (DAC_HandleTypeDef hdac, DAC_ChannelConfTypeDef sConfig, uint32_t Channel)
	Run the self calibration of one DAC channel. More...

HAL_StatusTypeDef	HAL_DACEx_SetUserTrimming (DAC_HandleTypeDef hdac, DAC_ChannelConfTypeDef sConfig, uint32_t Channel, uint32_t NewTrimmingValue)
	Set the trimming mode and trimming value (user trimming mode applied). More...

uint32_t	HAL_DACEx_GetTrimOffset (DAC_HandleTypeDef *hdac, uint32_t Channel)
	Return the DAC trimming value. More...

Detailed Description

Extended IO operation functions.

  ==============================================================================
                 ##### Extended features functions #####
  ==============================================================================
    [..]  This section provides functions allowing to:
      (+) Start conversion.
      (+) Stop conversion.
      (+) Start conversion and enable DMA transfer.
      (+) Stop conversion and disable DMA transfer.
      (+) Get result of conversion.
      (+) Get result of dual mode conversion.

Function Documentation

◆ HAL_DACEx_ConvCpltCallbackCh2()

__weak void HAL_DACEx_ConvCpltCallbackCh2 ( DAC_HandleTypeDef * hdac )

Conversion complete callback in non-blocking mode for Channel2.

Parameters

hdac	pointer to a DAC_HandleTypeDef structure that contains the configuration information for the specified DAC.

Return values

None

Definition at line 248 of file stm32l4xx_hal_dac_ex.c.

 {
   /* Prevent unused argument(s) compilation warning */
   UNUSED(hdac);
 
   /* NOTE : This function should not be modified, when the callback is needed,
             the HAL_DACEx_ConvCpltCallbackCh2 could be implemented in the user file
    */
 }

◆ HAL_DACEx_ConvHalfCpltCallbackCh2()

__weak void HAL_DACEx_ConvHalfCpltCallbackCh2 ( DAC_HandleTypeDef * hdac )

Conversion half DMA transfer callback in non-blocking mode for Channel2.

Parameters

hdac	pointer to a DAC_HandleTypeDef structure that contains the configuration information for the specified DAC.

Return values

None

Definition at line 264 of file stm32l4xx_hal_dac_ex.c.

 {
   /* Prevent unused argument(s) compilation warning */
   UNUSED(hdac);
 
   /* NOTE : This function should not be modified, when the callback is needed,
             the HAL_DACEx_ConvHalfCpltCallbackCh2 could be implemented in the user file
    */
 }

◆ HAL_DACEx_DMAUnderrunCallbackCh2()

__weak void HAL_DACEx_DMAUnderrunCallbackCh2 ( DAC_HandleTypeDef * hdac )

DMA underrun DAC callback for Channel2.

Parameters

hdac	pointer to a DAC_HandleTypeDef structure that contains the configuration information for the specified DAC.

Return values

None

Definition at line 296 of file stm32l4xx_hal_dac_ex.c.

 {
   /* Prevent unused argument(s) compilation warning */
   UNUSED(hdac);
 
   /* NOTE : This function should not be modified, when the callback is needed,
             the HAL_DACEx_DMAUnderrunCallbackCh2 could be implemented in the user file
    */
 }

◆ HAL_DACEx_DualSetValue()

HAL_StatusTypeDef HAL_DACEx_DualSetValue	(	DAC_HandleTypeDef *	hdac,
		uint32_t	Alignment,
		uint32_t	Data1,
		uint32_t	Data2
	)

Set the specified data holding register value for dual DAC channel.

Parameters

hdac	pointer to a DAC_HandleTypeDef structure that contains the configuration information for the specified DAC.
Alignment	Specifies the data alignment for dual channel DAC. This parameter can be one of the following values: DAC_ALIGN_8B_R: 8bit right data alignment selected DAC_ALIGN_12B_L: 12bit left data alignment selected DAC_ALIGN_12B_R: 12bit right data alignment selected
Data1	Data for DAC Channel1 to be loaded in the selected data holding register.
Data2	Data for DAC Channel2 to be loaded in the selected data holding register.

Note: In dual mode, a unique register access is required to write in both DAC channels at the same time.

Return values

HAL status

Definition at line 212 of file stm32l4xx_hal_dac_ex.c.

 {
   uint32_t data;
   uint32_t tmp;
 
   /* Check the parameters */
   assert_param(IS_DAC_ALIGN(Alignment));
   assert_param(IS_DAC_DATA(Data1));
   assert_param(IS_DAC_DATA(Data2));
 
   /* Calculate and set dual DAC data holding register value */
   if (Alignment == DAC_ALIGN_8B_R)
   {
     data = ((uint32_t)Data2 << 8U) | Data1;
   }
   else
   {
     data = ((uint32_t)Data2 << 16U) | Data1;
   }
 
   tmp = (uint32_t)hdac->Instance;
   tmp += DAC_DHR12RD_ALIGNMENT(Alignment);
 
   /* Set the dual DAC selected data holding register */
   *(__IO uint32_t *)tmp = data;
 
   /* Return function status */
   return HAL_OK;
 }

◆ HAL_DACEx_ErrorCallbackCh2()

__weak void HAL_DACEx_ErrorCallbackCh2 ( DAC_HandleTypeDef * hdac )

Error DAC callback for Channel2.

Parameters

hdac	pointer to a DAC_HandleTypeDef structure that contains the configuration information for the specified DAC.

Return values

None

Definition at line 280 of file stm32l4xx_hal_dac_ex.c.

 {
   /* Prevent unused argument(s) compilation warning */
   UNUSED(hdac);
 
   /* NOTE : This function should not be modified, when the callback is needed,
             the HAL_DACEx_ErrorCallbackCh2 could be implemented in the user file
    */
 }

◆ HAL_DACEx_GetTrimOffset()

uint32_t HAL_DACEx_GetTrimOffset	(	DAC_HandleTypeDef *	hdac,
		uint32_t	Channel
	)

Return the DAC trimming value.

Parameters

hdac	DAC handle
Channel	The selected DAC channel. This parameter can be one of the following values: DAC_CHANNEL_1: DAC Channel1 selected DAC_CHANNEL_2: DAC Channel2 selected

Return values

Trimming value : range: 0->31

Definition at line 503 of file stm32l4xx_hal_dac_ex.c.

 {
     /* Check the parameter */
     assert_param(IS_DAC_CHANNEL(Channel));
 
     /* Retrieve trimming  */
   return ((hdac->Instance->CCR & (DAC_CCR_OTRIM1 << (Channel & 0x10UL))) >> (Channel & 0x10UL));
 }

◆ HAL_DACEx_NoiseWaveGenerate()

HAL_StatusTypeDef HAL_DACEx_NoiseWaveGenerate	(	DAC_HandleTypeDef *	hdac,
		uint32_t	Channel,
		uint32_t	Amplitude
	)

Enable or disable the selected DAC channel wave generation.

Parameters

hdac	pointer to a DAC_HandleTypeDef structure that contains the configuration information for the specified DAC.
Channel	The selected DAC channel. This parameter can be one of the following values: DAC_CHANNEL_1: DAC Channel1 selected DAC_CHANNEL_2: DAC Channel2 selected
Amplitude	Unmask DAC channel LFSR for noise wave generation. This parameter can be one of the following values: DAC_LFSRUNMASK_BIT0: Unmask DAC channel LFSR bit0 for noise wave generation DAC_LFSRUNMASK_BITS1_0: Unmask DAC channel LFSR bit[1:0] for noise wave generation DAC_LFSRUNMASK_BITS2_0: Unmask DAC channel LFSR bit[2:0] for noise wave generation DAC_LFSRUNMASK_BITS3_0: Unmask DAC channel LFSR bit[3:0] for noise wave generation DAC_LFSRUNMASK_BITS4_0: Unmask DAC channel LFSR bit[4:0] for noise wave generation DAC_LFSRUNMASK_BITS5_0: Unmask DAC channel LFSR bit[5:0] for noise wave generation DAC_LFSRUNMASK_BITS6_0: Unmask DAC channel LFSR bit[6:0] for noise wave generation DAC_LFSRUNMASK_BITS7_0: Unmask DAC channel LFSR bit[7:0] for noise wave generation DAC_LFSRUNMASK_BITS8_0: Unmask DAC channel LFSR bit[8:0] for noise wave generation DAC_LFSRUNMASK_BITS9_0: Unmask DAC channel LFSR bit[9:0] for noise wave generation DAC_LFSRUNMASK_BITS10_0: Unmask DAC channel LFSR bit[10:0] for noise wave generation DAC_LFSRUNMASK_BITS11_0: Unmask DAC channel LFSR bit[11:0] for noise wave generation

Return values

HAL status

Definition at line 168 of file stm32l4xx_hal_dac_ex.c.

 {
   /* Check the parameters */
   assert_param(IS_DAC_CHANNEL(Channel));
   assert_param(IS_DAC_LFSR_UNMASK_TRIANGLE_AMPLITUDE(Amplitude));
 
   /* Process locked */
   __HAL_LOCK(hdac);
 
   /* Change DAC state */
   hdac->State = HAL_DAC_STATE_BUSY;
 
   /* Enable the noise wave generation for the selected DAC channel */
   MODIFY_REG(hdac->Instance->CR, ((DAC_CR_WAVE1) | (DAC_CR_MAMP1)) << (Channel & 0x10UL), (DAC_CR_WAVE1_0 | Amplitude) << (Channel & 0x10UL));
 
   /* Change DAC state */
   hdac->State = HAL_DAC_STATE_READY;
 
   /* Process unlocked */
   __HAL_UNLOCK(hdac);
 
   /* Return function status */
   return HAL_OK;
 }

◆ HAL_DACEx_SelfCalibrate()

HAL_StatusTypeDef HAL_DACEx_SelfCalibrate	(	DAC_HandleTypeDef *	hdac,
		DAC_ChannelConfTypeDef *	sConfig,
		uint32_t	Channel
	)

Run the self calibration of one DAC channel.

Parameters

hdac	pointer to a DAC_HandleTypeDef structure that contains the configuration information for the specified DAC.
sConfig	DAC channel configuration structure.
Channel	The selected DAC channel. This parameter can be one of the following values: DAC_CHANNEL_1: DAC Channel1 selected DAC_CHANNEL_2: DAC Channel2 selected

Return values

Updates	DAC_TrimmingValue. , DAC_UserTrimming set to DAC_UserTrimming
HAL	status

Note: Calibration runs about 7 ms.

Definition at line 323 of file stm32l4xx_hal_dac_ex.c.

 {
   HAL_StatusTypeDef status = HAL_OK;
 
   __IO uint32_t tmp;
   uint32_t trimmingvalue;
   uint32_t delta;
 
   /* store/restore channel configuration structure purpose */
   uint32_t oldmodeconfiguration;
 
   /* Check the parameters */
   assert_param(IS_DAC_CHANNEL(Channel));
 
  /* Check the DAC handle allocation */
  /* Check if DAC running */
   if (hdac == NULL)
   {
     status = HAL_ERROR;
   }
   else if (hdac->State == HAL_DAC_STATE_BUSY)
   {
     status = HAL_ERROR;
   }
   else
   {
     /* Process locked */
     __HAL_LOCK(hdac);
 
     /* Store configuration */
     oldmodeconfiguration = (hdac->Instance->MCR & (DAC_MCR_MODE1 << (Channel & 0x10UL)));
 
     /* Disable the selected DAC channel */
     CLEAR_BIT((hdac->Instance->CR), (DAC_CR_EN1 << (Channel & 0x10UL)));
 
     /* Set mode in MCR  for calibration */
     MODIFY_REG(hdac->Instance->MCR, (DAC_MCR_MODE1 << (Channel & 0x10UL)), 0U);
 
     /* Set DAC Channel1 DHR register to the middle value */
     tmp = (uint32_t)hdac->Instance;
 
 #if defined (STM32L431xx) || defined (STM32L432xx) || defined (STM32L433xx) || defined (STM32L442xx) || defined (STM32L443xx) || \
     defined (STM32L471xx) || defined (STM32L475xx) || defined (STM32L476xx) || defined (STM32L485xx) || defined (STM32L486xx) || defined (STM32L496xx) || defined (STM32L4A6xx) || \
     defined (STM32L4R5xx) || defined (STM32L4R7xx) || defined (STM32L4R9xx) || defined (STM32L4S5xx) || defined (STM32L4S7xx) || defined(STM32L4S9xx)
     if(Channel == DAC_CHANNEL_1)
     {
       tmp += DAC_DHR12R1_ALIGNMENT(DAC_ALIGN_12B_R);
     }
     else
     {
       tmp += DAC_DHR12R2_ALIGNMENT(DAC_ALIGN_12B_R);
     }
 #endif  /* STM32L431xx STM32L432xx STM32L433xx STM32L442xx STM32L443xx                         */
         /* STM32L471xx STM32L475xx STM32L476xx STM32L485xx STM32L486xx STM32L496xx STM32L4A6xx */
         /* STM32L4R5xx STM32L4R7xx STM32L4R9xx STM32L4S5xx STM32L4S7xx STM32L4S9xx             */
 #if defined (STM32L451xx) || defined (STM32L452xx) || defined (STM32L462xx)
     tmp += DAC_DHR12R1_ALIGNMENT(DAC_ALIGN_12B_R);
 #endif /* STM32L451xx STM32L452xx STM32L462xx */
     *(__IO uint32_t *) tmp = 0x0800U;
 
     /* Enable the selected DAC channel calibration */
     /* i.e. set DAC_CR_CENx bit */
     SET_BIT((hdac->Instance->CR), (DAC_CR_CEN1 << (Channel & 0x10UL)));
 
     /* Init trimming counter */
     /* Medium value */
     trimmingvalue = 16U;
     delta = 8U;
     while (delta != 0U)
     {
       /* Set candidate trimming */
       MODIFY_REG(hdac->Instance->CCR, (DAC_CCR_OTRIM1 << (Channel & 0x10UL)), (trimmingvalue << (Channel & 0x10UL)));
 
       /* tOFFTRIMmax delay x ms as per datasheet (electrical characteristics */
       /* i.e. minimum time needed between two calibration steps */
       HAL_Delay(1);
 
       if ((hdac->Instance->SR & (DAC_SR_CAL_FLAG1 << (Channel & 0x10UL))) == (DAC_SR_CAL_FLAG1 << (Channel & 0x10UL)))
       {
         /* DAC_SR_CAL_FLAGx is HIGH try higher trimming */
         trimmingvalue -= delta;
       }
       else
       {
         /* DAC_SR_CAL_FLAGx is LOW try lower trimming */
         trimmingvalue += delta;
       }
       delta >>= 1U;
     }
 
     /* Still need to check if right calibration is current value or one step below */
     /* Indeed the first value that causes the DAC_SR_CAL_FLAGx bit to change from 0 to 1  */
     /* Set candidate trimming */
     MODIFY_REG(hdac->Instance->CCR, (DAC_CCR_OTRIM1 << (Channel & 0x10UL)), (trimmingvalue << (Channel & 0x10UL)));
 
     /* tOFFTRIMmax delay x ms as per datasheet (electrical characteristics */
     /* i.e. minimum time needed between two calibration steps */
     HAL_Delay(1U);
 
     if ((hdac->Instance->SR & (DAC_SR_CAL_FLAG1 << (Channel & 0x10UL))) == 0UL)
     {
       /* OPAMP_CSR_OUTCAL is actually one value more */
       trimmingvalue++;
       /* Set right trimming */
       MODIFY_REG(hdac->Instance->CCR, (DAC_CCR_OTRIM1 << (Channel & 0x10UL)), (trimmingvalue << (Channel & 0x10UL)));
     }
 
     /* Disable the selected DAC channel calibration */
     /* i.e. clear DAC_CR_CENx bit */
     CLEAR_BIT((hdac->Instance->CR), (DAC_CR_CEN1 << (Channel & 0x10UL)));
 
     sConfig->DAC_TrimmingValue = trimmingvalue;
     sConfig->DAC_UserTrimming = DAC_TRIMMING_USER;
 
     /* Restore configuration */
     MODIFY_REG(hdac->Instance->MCR, (DAC_MCR_MODE1 << (Channel & 0x10UL)), oldmodeconfiguration);
 
     /* Process unlocked */
     __HAL_UNLOCK(hdac);
   }
 
   return status;
 }

◆ HAL_DACEx_SetUserTrimming()

HAL_StatusTypeDef HAL_DACEx_SetUserTrimming	(	DAC_HandleTypeDef *	hdac,
		DAC_ChannelConfTypeDef *	sConfig,
		uint32_t	Channel,
		uint32_t	NewTrimmingValue
	)

Set the trimming mode and trimming value (user trimming mode applied).

Parameters

hdac	pointer to a DAC_HandleTypeDef structure that contains the configuration information for the specified DAC.
sConfig	DAC configuration structure updated with new DAC trimming value.
Channel	The selected DAC channel. This parameter can be one of the following values: DAC_CHANNEL_1: DAC Channel1 selected DAC_CHANNEL_2: DAC Channel2 selected
NewTrimmingValue	DAC new trimming value

Return values

HAL status

Definition at line 460 of file stm32l4xx_hal_dac_ex.c.

 {
   HAL_StatusTypeDef status = HAL_OK;
 
   /* Check the parameters */
   assert_param(IS_DAC_CHANNEL(Channel));
   assert_param(IS_DAC_NEWTRIMMINGVALUE(NewTrimmingValue));
 
  /* Check the DAC handle allocation */
   if (hdac == NULL)
   {
     status = HAL_ERROR;
   }
   else
   {
     /* Process locked */
     __HAL_LOCK(hdac);
 
     /* Set new trimming */
     MODIFY_REG(hdac->Instance->CCR, (DAC_CCR_OTRIM1 << (Channel & 0x10UL)), (NewTrimmingValue << (Channel & 0x10UL)));
 
     /* Update trimming mode */
     sConfig->DAC_UserTrimming = DAC_TRIMMING_USER;
     sConfig->DAC_TrimmingValue = NewTrimmingValue;
 
     /* Process unlocked */
     __HAL_UNLOCK(hdac);
   }
   return status;
 }

◆ HAL_DACEx_TriangleWaveGenerate()

HAL_StatusTypeDef HAL_DACEx_TriangleWaveGenerate	(	DAC_HandleTypeDef *	hdac,
		uint32_t	Channel,
		uint32_t	Amplitude
	)

Enable or disable the selected DAC channel wave generation.

Parameters

hdac	pointer to a DAC_HandleTypeDef structure that contains the configuration information for the specified DAC.
Channel	The selected DAC channel. This parameter can be one of the following values: DAC_CHANNEL_1: DAC Channel1 selected DAC_CHANNEL_2: DAC Channel2 selected
Amplitude	Select max triangle amplitude. This parameter can be one of the following values: DAC_TRIANGLEAMPLITUDE_1: Select max triangle amplitude of 1 DAC_TRIANGLEAMPLITUDE_3: Select max triangle amplitude of 3 DAC_TRIANGLEAMPLITUDE_7: Select max triangle amplitude of 7 DAC_TRIANGLEAMPLITUDE_15: Select max triangle amplitude of 15 DAC_TRIANGLEAMPLITUDE_31: Select max triangle amplitude of 31 DAC_TRIANGLEAMPLITUDE_63: Select max triangle amplitude of 63 DAC_TRIANGLEAMPLITUDE_127: Select max triangle amplitude of 127 DAC_TRIANGLEAMPLITUDE_255: Select max triangle amplitude of 255 DAC_TRIANGLEAMPLITUDE_511: Select max triangle amplitude of 511 DAC_TRIANGLEAMPLITUDE_1023: Select max triangle amplitude of 1023 DAC_TRIANGLEAMPLITUDE_2047: Select max triangle amplitude of 2047 DAC_TRIANGLEAMPLITUDE_4095: Select max triangle amplitude of 4095

Return values

HAL status

Definition at line 119 of file stm32l4xx_hal_dac_ex.c.

 {
   /* Check the parameters */
   assert_param(IS_DAC_CHANNEL(Channel));
   assert_param(IS_DAC_LFSR_UNMASK_TRIANGLE_AMPLITUDE(Amplitude));
 
   /* Process locked */
   __HAL_LOCK(hdac);
 
   /* Change DAC state */
   hdac->State = HAL_DAC_STATE_BUSY;
 
   /* Enable the triangle wave generation for the selected DAC channel */
   MODIFY_REG(hdac->Instance->CR, ((DAC_CR_WAVE1) | (DAC_CR_MAMP1)) << (Channel & 0x10UL), (DAC_CR_WAVE1_1 | Amplitude) << (Channel & 0x10UL));
 
   /* Change DAC state */
   hdac->State = HAL_DAC_STATE_READY;
 
   /* Process unlocked */
   __HAL_UNLOCK(hdac);
 
   /* Return function status */
   return HAL_OK;
 }

Functions

Detailed Description

Function Documentation

◆ HAL_DACEx_ConvCpltCallbackCh2()

◆ HAL_DACEx_ConvHalfCpltCallbackCh2()

◆ HAL_DACEx_DMAUnderrunCallbackCh2()

◆ HAL_DACEx_DualSetValue()

◆ HAL_DACEx_ErrorCallbackCh2()

◆ HAL_DACEx_GetTrimOffset()

◆ HAL_DACEx_NoiseWaveGenerate()

◆ HAL_DACEx_SelfCalibrate()

◆ HAL_DACEx_SetUserTrimming()

◆ HAL_DACEx_TriangleWaveGenerate()