Initialization and Configuration functions

Initialization and Configuration functions. More...

Functions
HAL_StatusTypeDef	HAL_WWDG_Init (WWDG_HandleTypeDef *hwwdg)
	Initialize the WWDG according to the specified. parameters in the WWDG_InitTypeDef of associated handle. More...
void	HAL_WWDG_MspInit (WWDG_HandleTypeDef *hwwdg)
	Initialize the WWDG MSP. More...
HAL_StatusTypeDef	HAL_WWDG_RegisterCallback (WWDG_HandleTypeDef *hwwdg, HAL_WWDG_CallbackIDTypeDef CallbackID, pWWDG_CallbackTypeDef pCallback)
	Register a User WWDG Callback To be used instead of the weak (surcharged) predefined callback. More...
HAL_StatusTypeDef	HAL_WWDG_UnRegisterCallback (WWDG_HandleTypeDef *hwwdg, HAL_WWDG_CallbackIDTypeDef CallbackID)
	Unregister a WWDG Callback WWDG Callback is redirected to the weak (surcharged) predefined callback. More...

Detailed Description

Initialization and Configuration functions.

  ==============================================================================
          ##### Initialization and Configuration functions #####
  ==============================================================================
  [..]
    This section provides functions allowing to:
      (+) Initialize and start the WWDG according to the specified parameters
          in the WWDG_InitTypeDef of associated handle.
      (+) Initialize the WWDG MSP.

Function Documentation

HAL_WWDG_Init()

HAL_StatusTypeDef HAL_WWDG_Init

(

WWDG_HandleTypeDef *

hwwdg

)

Initialize the WWDG according to the specified. parameters in the WWDG_InitTypeDef of associated handle.

Parameters

hwwdg

pointer to a WWDG_HandleTypeDef structure that contains the configuration information for the specified WWDG module.

Return values

HAL

status

Definition at line 164 of file stm32l4xx_hal_wwdg.c.

{
  /* Check the WWDG handle allocation */
  if (hwwdg == NULL)
  {
    return HAL_ERROR;
  }

  /* Check the parameters */
  assert_param(IS_WWDG_ALL_INSTANCE(hwwdg->Instance));
  assert_param(IS_WWDG_PRESCALER(hwwdg->Init.Prescaler));
  assert_param(IS_WWDG_WINDOW(hwwdg->Init.Window));
  assert_param(IS_WWDG_COUNTER(hwwdg->Init.Counter));
  assert_param(IS_WWDG_EWI_MODE(hwwdg->Init.EWIMode));

#if (USE_HAL_WWDG_REGISTER_CALLBACKS == 1)
  /* Reset Callback pointers */
  if(hwwdg->EwiCallback == NULL)
  {
    hwwdg->EwiCallback = HAL_WWDG_EarlyWakeupCallback;
  }

  if(hwwdg->MspInitCallback == NULL)
  {
    hwwdg->MspInitCallback = HAL_WWDG_MspInit;
  }

  /* Init the low level hardware */
  hwwdg->MspInitCallback(hwwdg);
#else
  /* Init the low level hardware */
  HAL_WWDG_MspInit(hwwdg);
#endif

  /* Set WWDG Counter */
  WRITE_REG(hwwdg->Instance->CR, (WWDG_CR_WDGA | hwwdg->Init.Counter));

  /* Set WWDG Prescaler and Window */
  WRITE_REG(hwwdg->Instance->CFR, (hwwdg->Init.EWIMode | hwwdg->Init.Prescaler | hwwdg->Init.Window));

  /* Return function status */
  return HAL_OK;
}

HAL_WWDG_MspInit()

__weak void HAL_WWDG_MspInit

(

WWDG_HandleTypeDef *

hwwdg

)

Initialize the WWDG MSP.

Parameters

hwwdg

pointer to a WWDG_HandleTypeDef structure that contains the configuration information for the specified WWDG module.

Note

When rewriting this function in user file, mechanism may be added to avoid multiple initialize when HAL_WWDG_Init function is called again to change parameters.

Return values

None

Definition at line 218 of file stm32l4xx_hal_wwdg.c.

{
  /* Prevent unused argument(s) compilation warning */
  UNUSED(hwwdg);

  /* NOTE: This function should not be modified, when the callback is needed,
           the HAL_WWDG_MspInit could be implemented in the user file
   */
}

HAL_WWDG_RegisterCallback()

HAL_StatusTypeDef HAL_WWDG_RegisterCallback	(	WWDG_HandleTypeDef *	hwwdg,
		HAL_WWDG_CallbackIDTypeDef	CallbackID,
		pWWDG_CallbackTypeDef	pCallback
	)

Register a User WWDG Callback To be used instead of the weak (surcharged) predefined callback.

Parameters

hwwdg	WWDG handle
CallbackID	ID of the callback to be registered This parameter can be one of the following values: HAL_WWDG_EWI_CB_ID Early WakeUp Interrupt Callback ID HAL_WWDG_MSPINIT_CB_ID MspInit callback ID
pCallback	pointer to the Callback function

Return values

status

Definition at line 241 of file stm32l4xx_hal_wwdg.c.

{
  HAL_StatusTypeDef status = HAL_OK;

  if(pCallback == NULL)
  {
    status = HAL_ERROR;
  }
  else
  {
    switch(CallbackID)
    {
      case HAL_WWDG_EWI_CB_ID:
        hwwdg->EwiCallback = pCallback;
        break;

      case HAL_WWDG_MSPINIT_CB_ID:
        hwwdg->MspInitCallback = pCallback;
        break;

      default:
        status = HAL_ERROR;
        break;
    }
  }

  return status;
}

HAL_WWDG_UnRegisterCallback()

HAL_StatusTypeDef HAL_WWDG_UnRegisterCallback	(	WWDG_HandleTypeDef *	hwwdg,
		HAL_WWDG_CallbackIDTypeDef	CallbackID
	)

Unregister a WWDG Callback WWDG Callback is redirected to the weak (surcharged) predefined callback.

Parameters

hwwdg	WWDG handle
CallbackID	ID of the callback to be registered This parameter can be one of the following values: HAL_WWDG_EWI_CB_ID Early WakeUp Interrupt Callback ID HAL_WWDG_MSPINIT_CB_ID MspInit callback ID

Return values

status

Definition at line 281 of file stm32l4xx_hal_wwdg.c.

{
  HAL_StatusTypeDef status = HAL_OK;

  switch(CallbackID)
  {
    case HAL_WWDG_EWI_CB_ID:
      hwwdg->EwiCallback = HAL_WWDG_EarlyWakeupCallback;
      break;

    case HAL_WWDG_MSPINIT_CB_ID:
      hwwdg->MspInitCallback = HAL_WWDG_MspInit;
      break;

    default:
      status = HAL_ERROR;
      break;
  }

  return status;
}