Initialization and Configuration functions

Initialization and Configuration functions. More...

Functions
void	HAL_NVIC_SetPriorityGrouping (uint32_t PriorityGroup)
	Set the priority grouping field (pre-emption priority and subpriority) using the required unlock sequence. More...
void	HAL_NVIC_SetPriority (IRQn_Type IRQn, uint32_t PreemptPriority, uint32_t SubPriority)
	Set the priority of an interrupt. More...
void	HAL_NVIC_EnableIRQ (IRQn_Type IRQn)
	Enable a device specific interrupt in the NVIC interrupt controller. More...
void	HAL_NVIC_DisableIRQ (IRQn_Type IRQn)
	Disable a device specific interrupt in the NVIC interrupt controller. More...
void	HAL_NVIC_SystemReset (void)
	Initiate a system reset request to reset the MCU. More...
uint32_t	HAL_SYSTICK_Config (uint32_t TicksNumb)
	Initialize the System Timer with interrupt enabled and start the System Tick Timer (SysTick): Counter is in free running mode to generate periodic interrupts. More...

Detailed Description

Initialization and Configuration functions.

  ==============================================================================
              ##### Initialization and Configuration functions #####
  ==============================================================================
    [..]
      This section provides the CORTEX HAL driver functions allowing to configure Interrupts
      SysTick functionalities

Function Documentation

HAL_NVIC_DisableIRQ()

void HAL_NVIC_DisableIRQ

(

IRQn_Type

IRQn

)

Disable a device specific interrupt in the NVIC interrupt controller.

Parameters

IRQn	External interrupt number. This parameter can be an enumerator of IRQn_Type enumeration (For the complete STM32 Devices IRQ Channels list, please refer to the appropriate CMSIS device file (stm32l4xxxx.h))

Return values

None

Definition at line 224 of file stm32l4xx_hal_cortex.c.

{
  /* Check the parameters */
  assert_param(IS_NVIC_DEVICE_IRQ(IRQn));

  /* Disable interrupt */
  NVIC_DisableIRQ(IRQn);
}

HAL_NVIC_EnableIRQ()

void HAL_NVIC_EnableIRQ

(

IRQn_Type

IRQn

)

Enable a device specific interrupt in the NVIC interrupt controller.

Note

To configure interrupts priority correctly, the NVIC_PriorityGroupConfig() function should be called before.

Parameters

IRQn	External interrupt number. This parameter can be an enumerator of IRQn_Type enumeration (For the complete STM32 Devices IRQ Channels list, please refer to the appropriate CMSIS device file (stm32l4xxxx.h))

Return values

None

Definition at line 208 of file stm32l4xx_hal_cortex.c.

{
  /* Check the parameters */
  assert_param(IS_NVIC_DEVICE_IRQ(IRQn));

  /* Enable interrupt */
  NVIC_EnableIRQ(IRQn);
}

HAL_NVIC_SetPriority()

void HAL_NVIC_SetPriority	(	IRQn_Type	IRQn,
		uint32_t	PreemptPriority,
		uint32_t	SubPriority
	)

Set the priority of an interrupt.

Parameters

IRQn	External interrupt number. This parameter can be an enumerator of IRQn_Type enumeration (For the complete STM32 Devices IRQ Channels list, please refer to the appropriate CMSIS device file (stm32l4xxxx.h))
PreemptPriority	The pre-emption priority for the IRQn channel. This parameter can be a value between 0 and 15 A lower priority value indicates a higher priority
SubPriority	the subpriority level for the IRQ channel. This parameter can be a value between 0 and 15 A lower priority value indicates a higher priority.

Return values

None

Definition at line 186 of file stm32l4xx_hal_cortex.c.

{
  uint32_t prioritygroup = 0x00;

  /* Check the parameters */
  assert_param(IS_NVIC_SUB_PRIORITY(SubPriority));
  assert_param(IS_NVIC_PREEMPTION_PRIORITY(PreemptPriority));

  prioritygroup = NVIC_GetPriorityGrouping();

  NVIC_SetPriority(IRQn, NVIC_EncodePriority(prioritygroup, PreemptPriority, SubPriority));
}

HAL_NVIC_SetPriorityGrouping()

void HAL_NVIC_SetPriorityGrouping

(

uint32_t

PriorityGroup

)

Set the priority grouping field (pre-emption priority and subpriority) using the required unlock sequence.

Parameters

PriorityGroup

The priority grouping bits length. This parameter can be one of the following values: NVIC_PRIORITYGROUP_0: 0 bit for pre-emption priority, 4 bits for subpriority NVIC_PRIORITYGROUP_1: 1 bit for pre-emption priority, 3 bits for subpriority NVIC_PRIORITYGROUP_2: 2 bits for pre-emption priority, 2 bits for subpriority NVIC_PRIORITYGROUP_3: 3 bits for pre-emption priority, 1 bit for subpriority NVIC_PRIORITYGROUP_4: 4 bits for pre-emption priority, 0 bit for subpriority

Note

When the NVIC_PriorityGroup_0 is selected, IRQ pre-emption is no more possible. The pending IRQ priority will be managed only by the subpriority.

Return values

None

Definition at line 164 of file stm32l4xx_hal_cortex.c.

{
  /* Check the parameters */
  assert_param(IS_NVIC_PRIORITY_GROUP(PriorityGroup));

  /* Set the PRIGROUP[10:8] bits according to the PriorityGroup parameter value */
  NVIC_SetPriorityGrouping(PriorityGroup);
}

HAL_NVIC_SystemReset()

void HAL_NVIC_SystemReset

(

void

)

Initiate a system reset request to reset the MCU.

Return values

None

Definition at line 237 of file stm32l4xx_hal_cortex.c.

{
  /* System Reset */
  NVIC_SystemReset();
}

HAL_SYSTICK_Config()

uint32_t HAL_SYSTICK_Config

(

uint32_t

TicksNumb

)

Initialize the System Timer with interrupt enabled and start the System Tick Timer (SysTick): Counter is in free running mode to generate periodic interrupts.

Parameters

TicksNumb

Specifies the ticks Number of ticks between two interrupts.

Return values

status

- 0 Function succeeded. 1 Function failed.

Definition at line 250 of file stm32l4xx_hal_cortex.c.

{
   return SysTick_Config(TicksNumb);
}