STM32-调用 vTaskStartScheduler API 后出现 HardFault

STM32 移植 FreeRTOS 后调用 vTaskStartScheduler() 后出现 HardFault 异常。

原因分析：

FreeRTOS 配置头文件 FreeRTOSConfig.h 中与中断有关的配置和通过系统接口 void NVIC_PriorityGroupConfig(uint32_t NVIC_PriorityGroup) 设置的中断分组冲突。

/* The lowest interrupt priority that can be used in a call to a "set priority"
function. */
#define configLIBRARY_LOWEST_INTERRUPT_PRIORITY   15

/* The highest interrupt priority that can be used by any interrupt service
routine that makes calls to interrupt safe FreeRTOS API functions.  DO NOT CALL
INTERRUPT SAFE FREERTOS API FUNCTIONS FROM ANY INTERRUPT THAT HAS A HIGHER
PRIORITY THAN THIS! (higher priorities are lower numeric values. */
#define configLIBRARY_MAX_SYSCALL_INTERRUPT_PRIORITY 5

/* Interrupt priorities used by the kernel port layer itself.  These are generic
to all Cortex-M ports, and do not rely on any particular library functions. */
#define configKERNEL_INTERRUPT_PRIORITY 		( configLIBRARY_LOWEST_INTERRUPT_PRIORITY << (8 - configPRIO_BITS) )
/* !!!! configMAX_SYSCALL_INTERRUPT_PRIORITY must not be set to zero !!!!
See http://www.FreeRTOS.org/RTOS-Cortex-M3-M4.html. */
#define configMAX_SYSCALL_INTERRUPT_PRIORITY 	( configLIBRARY_MAX_SYSCALL_INTERRUPT_PRIORITY << (8 - configPRIO_BITS) )

NVIC_PriorityGroupConfig(NVIC_PriorityGroup_0);

在 FreeRTOSConfig.h 中设置的中断最低优先级为 15，说明 可编程中断优先级的范围为 0 ~ 15，也即需要 4 bits 来表示抢占优先级。而通过 NVIC_PriorityGroupConfig(NVIC_PriorityGroup_0) API 设置为 0 bit 用于抢占优先级，3 bits 用于子优先级，与 FreeRTOSConfig.h 中的中断设置冲突导致。

/** @defgroup Preemption_Priority_Group 
  * @{
  */

#define NVIC_PriorityGroup_0         ((uint32_t)0x700) /*!< 0 bits for pre-emption priority
                                                            4 bits for subpriority */
#define NVIC_PriorityGroup_1         ((uint32_t)0x600) /*!< 1 bits for pre-emption priority
                                                            3 bits for subpriority */
#define NVIC_PriorityGroup_2         ((uint32_t)0x500) /*!< 2 bits for pre-emption priority
                                                            2 bits for subpriority */
#define NVIC_PriorityGroup_3         ((uint32_t)0x400) /*!< 3 bits for pre-emption priority
                                                            1 bits for subpriority */
#define NVIC_PriorityGroup_4         ((uint32_t)0x300) /*!< 4 bits for pre-emption priority
                                                            0 bits for subpriority */

解决方案：

将中断分组设置为 NVIC_PriorityGroup_4 即可。FreeRTOS 官方文档 也建议对于 STM32 (Cortex-M3)，建议设置为 NVIC_PriorityGroup_4 。

NVIC_PriorityGroupConfig(NVIC_PriorityGroup_4);

---

题外：

这里顺便也记录下 STM32 (Cortex-M3) 结合 FreeRTOS 对中断的设置。

STM32 (Cortex-M3) 在 SCB_AIRCR 寄存器中的 Bits 10:9 设置中断优先级分组。

FreeRTOS 在配置文件 FreeRTOSConfig.h 中通过宏 configKERNEL_INTERRUPT_PRIORITY 和 configMAX_SYSCALL_INTERRUPT_PRIORITY 来设置 FreeRTOS 中的中断设置。

• 宏 configKERNEL_INTERRUPT_PRIORITY 用于设置中断最低优先级。这个宏必须结合 void NVIC_PriorityGroupConfig(uint32_t NVIC_PriorityGroup) 来设置。
• 宏 configMAX_SYSCALL_INTERRUPT_PRIORITY 用于 FreeRTOS 中的一些中断功能。典型应用就是 FreeRTOS 中以 FromISR 结尾的 API 可以安全的在 configMAX_SYSCALL_INTERRUPT_PRIORITY ~ configKERNEL_INTERRUPT_PRIORITY 之间的中断回调中使用。对于这部分描述，可以参考下图或者 FreeRTOS 官方文档中对 FreeRTOSConfig.h 中宏的说明。