Vaja 4: Izjeme in prekinitve

Namen tokratne vaje je, da se spoznate s konceptom izjem in prekinitev v STM32H7, prekinitvenim krmilnikom (NVIC) ter izjemo SysTick. Pogledali si bomo, katere funkcije za delo z NVIC in SysTick ponuja knjižnica HAL. Podrobnosti o registrih naprav NVIC in SysTick so zbrane v poglavju Registri NVIC, SCB in SysTick.

Izjeme in prekinitve v STM32H7

Kot ste spoznali na predavanjih, izjeme (angl. exceptions) in prekinitve (angl. interrupts) lahko prekinejo procesor pri trenutnem delovanju. Procesor ob izjemi ali prekinitvi začne izvajati prekinitveno servisni program (PSP), ki je za prispelo izjemo/prekinitev določen. Vsaka izmed izjem ali prekinitev ima svojo prioriteto. V primeru, da se hkrati pojavita dve izjemi/prekinitvi, se bo najprej servisirala tista z višjo prioriteto. Prioritete so v ARM Cortex-M7 označene s številkami, pri čemer nižja številka pomeni višjo prioriteto.

ARM uporablja izraz izjema (exception) kot nadpomenko za vse dogodke, ki prekinejo delovanje procesorja, prekinitve pa tretira kot eno izmed vrst izjem. ARM pozna naslednje tipe izjem:

  • Reset: Izjema Reset se zgodi ob vklopu ali t. i. warm resetu, ki ga lahko dosežemo na primer s pritiskom črne tipke na razvojni plošči. Ta vrsta izjeme je vedno omogočena in ima prioriteto -3. Ko se pojavi izjema Reset, se procesor ustavi, ne glede na to, kaj izvaja v danem trenutku. Po deaktivaciji izjeme Reset se izvede njen prekinitveno servisni program. Zadnji korak prekinitveno servisnega programa za reset je običajno klic uporabniškega programa (funkcije main).

  • NMI: NMI je kratica za non-maskable interrupt (prekinitev, ki je ni mogoče maskirati/onemogočiti). Ima najvišjo prioriteto (-2) izmed vseh vrst izjem, razen izjeme Reset.

  • HardFault: Ta izjema se pojavi ob napaki, ki je ne more obravnavati nobena druga izjema. Zgodi se na primer, ko pride do napake med obravnavo druge izjeme ali ko izjema za določeno vrsto napake (MemManage, BusFault, UsageFault) ni omogočena. Te tri izjeme so po resetu onemogočene, zato se namesto njih proži HardFault. HardFault ima prioriteto -1. Iz servisiranja izjeme HardFault se običajno ni mogoče vrniti v normalno izvajanje programa - potreben je reset.

  • MemManage: Izjema, ki se pojavi ob kršitvah pri dostopih do pomnilniških lokacij. Zgodi se na primer, ko skušamo dostopati do pomnilniške lokacije, za katero v trenutnem načinu delovanja nimamo pravic dostopa. Za pravice dostopa do pomnilnika skrbi enota, ki ji rečemo Memory Protection Unit (MPU).

  • BusFault: Izjema, ki se zgodi ob napakah na podatkovnem ali ukaznem vodilu. Pojavi se ob napakah pri dostopu do pomnilnika ali pomnilniško preslikanih registrov vhodno-izhodnih naprav. Največkrat se zgodi ob dostopu do naslovov, ki niso veljavni (niso lokacije v pomnilniku ali registri V/I naprav).

  • UsageFault: Izjema, ki se pripeti zaradi nedefiniranega ukaza, nepravilnega stanja pri izvajanju ukazov ali napake pri vračanju iz prekinitveno servisnega programa. Proži se lahko tudi ob dostopu do neporavnanega naslova (če na primer kazalec na 32-bitno spremenljivko nastavimo na vrednost, ki ni deljiva s 4) ali ob celoštevilskem deljenju z 0, vendar le, če to vklopimo v Configuration and Control registru (CCR). Za to služita bita UNALIGN_TRP in DIV_0_TRP. Po resetu procesor večino neporavnanih dostopov do pomnilnika izvede brez napake, deljenje z 0 pa vrne 0. Več o tem v razdelku Napake: HardFault in UsageFault.

  • SVCall: Izjema, ki jo proži ukaz SVC - supervisor call. Operacijski sistemi uporabljajo ukaz SVC za dostop do funkcij jedra OS (kernel) ali gonilnikov naprav.

  • PendSV: Izjema, ki se proži programsko. Običajno jo uporabljajo operacijski sistemi za izvedbo menjave konteksta (context switch), ko se zaključijo vse ostale prekinitve.

  • SysTick: Izjema, ki jo generira sistemski časovnik, ko doseže vrednost 0. Ponavadi se uporablja v operacijskih sistemih za zagotavljanje delovanja časovnega rezinjenja (time sharing). V knjižnici STM HAL se uporablja za delovanje funkcije HAL_Delay().

  • Interrupt: Prekinitve so ostale izjeme, ki jih prožijo periferne naprave: naprave za komunikacijo, kot npr. UART, GPIO pini prek naprave EXTI in tako dalje. V nadaljevanju semestra bomo ob spoznavanju perifernih naprav spoznali tudi prekinitve, ki jih te naprave lahko prožijo.

Oznake prekinitev (IRQn)

Vsaka izjema (razen Reset) in prekinitev ima svojo številsko oznako, ki ji rečemo oznaka prekinitve (interrupt request number - IRQn). Prekinitve perifernih naprav imajo oznake od 0 naprej, izjeme procesorskega jedra pa negativne oznake. Z oznako IRQn povemo funkcijam knjižnice HAL, katero prekinitev želimo upravljati.

Oznake in prioritete izjem in prekinitev
Ime IRQn Prioriteta
Reset / -3 (fiksna)
NMI -14 -2 (fiksna)
HardFault -13 -1 (fiksna)
MemManage -12 nastavljiva
BusFault -11 nastavljiva
UsageFault -10 nastavljiva
SVCall -5 nastavljiva
DebugMonitor -4 nastavljiva
PendSV -2 nastavljiva
SysTick -1 nastavljiva
prekinitve 0+ nastavljiva

Manjkajoče oznake (-9 do -6 in -3) so rezervirane. Izjema DebugMonitor se uporablja za razhroščevanje. Izjeme s fiksno prioriteto imajo vedno višjo prioriteto od vseh ostalih, saj so nastavljive prioritete med 0 in 15.

Spodaj so zapisane konstante za izjeme in prekinitve v STM32H750, ki so definirane v stm32h750xx.h. Te konstante bomo uporabljali v naših programih, kadar bomo upravljali prekinitve in izjeme.

typedef enum
{
/******  Cortex-M Processor Exceptions Numbers *****************************************************************/
  NonMaskableInt_IRQn         = -14,    /*!< 2 Non Maskable Interrupt                                          */
  HardFault_IRQn              = -13,    /*!< 3 Cortex-M Hard Fault Interrupt                                   */
  MemoryManagement_IRQn       = -12,    /*!< 4 Cortex-M Memory Management Interrupt                            */
  BusFault_IRQn               = -11,    /*!< 5 Cortex-M Bus Fault Interrupt                                    */
  UsageFault_IRQn             = -10,    /*!< 6 Cortex-M Usage Fault Interrupt                                  */
  SVCall_IRQn                 = -5,     /*!< 11 Cortex-M SV Call Interrupt                                     */
  DebugMonitor_IRQn           = -4,     /*!< 12 Cortex-M Debug Monitor Interrupt                               */
  PendSV_IRQn                 = -2,     /*!< 14 Cortex-M Pend SV Interrupt                                     */
  SysTick_IRQn                = -1,     /*!< 15 Cortex-M System Tick Interrupt                                 */
/******  STM32 specific Interrupt Numbers **********************************************************************/
  WWDG_IRQn                   = 0,      /*!< Window WatchDog Interrupt ( wwdg1_it, wwdg2_it)                   */
  PVD_AVD_IRQn                = 1,      /*!< PVD/AVD through EXTI Line detection Interrupt                     */
  TAMP_STAMP_IRQn             = 2,      /*!< Tamper and TimeStamp interrupts through the EXTI line             */
  RTC_WKUP_IRQn               = 3,      /*!< RTC Wakeup interrupt through the EXTI line                        */
  FLASH_IRQn                  = 4,      /*!< FLASH global Interrupt                                            */
  RCC_IRQn                    = 5,      /*!< RCC global Interrupt                                              */
  EXTI0_IRQn                  = 6,      /*!< EXTI Line0 Interrupt                                              */
  EXTI1_IRQn                  = 7,      /*!< EXTI Line1 Interrupt                                              */
  EXTI2_IRQn                  = 8,      /*!< EXTI Line2 Interrupt                                              */
  EXTI3_IRQn                  = 9,      /*!< EXTI Line3 Interrupt                                              */
  EXTI4_IRQn                  = 10,     /*!< EXTI Line4 Interrupt                                              */
  DMA1_Stream0_IRQn           = 11,     /*!< DMA1 Stream 0 global Interrupt                                    */
  DMA1_Stream1_IRQn           = 12,     /*!< DMA1 Stream 1 global Interrupt                                    */
  DMA1_Stream2_IRQn           = 13,     /*!< DMA1 Stream 2 global Interrupt                                    */
  DMA1_Stream3_IRQn           = 14,     /*!< DMA1 Stream 3 global Interrupt                                    */
  DMA1_Stream4_IRQn           = 15,     /*!< DMA1 Stream 4 global Interrupt                                    */
  DMA1_Stream5_IRQn           = 16,     /*!< DMA1 Stream 5 global Interrupt                                    */
  DMA1_Stream6_IRQn           = 17,     /*!< DMA1 Stream 6 global Interrupt                                    */
  ADC_IRQn                    = 18,     /*!< ADC1 and  ADC2 global Interrupts                                  */
  FDCAN1_IT0_IRQn             = 19,     /*!< FDCAN1 Interrupt line 0                                           */
  FDCAN2_IT0_IRQn             = 20,     /*!< FDCAN2 Interrupt line 0                                           */
  FDCAN1_IT1_IRQn             = 21,     /*!< FDCAN1 Interrupt line 1                                           */
  FDCAN2_IT1_IRQn             = 22,     /*!< FDCAN2 Interrupt line 1                                           */
  EXTI9_5_IRQn                = 23,     /*!< External Line[9:5] Interrupts                                     */
  TIM1_BRK_IRQn               = 24,     /*!< TIM1 Break Interrupt                                              */
  TIM1_UP_IRQn                = 25,     /*!< TIM1 Update Interrupt                                             */
  TIM1_TRG_COM_IRQn           = 26,     /*!< TIM1 Trigger and Commutation Interrupt                            */
  TIM1_CC_IRQn                = 27,     /*!< TIM1 Capture Compare Interrupt                                    */
  TIM2_IRQn                   = 28,     /*!< TIM2 global Interrupt                                             */
  TIM3_IRQn                   = 29,     /*!< TIM3 global Interrupt                                             */
  TIM4_IRQn                   = 30,     /*!< TIM4 global Interrupt                                             */
  I2C1_EV_IRQn                = 31,     /*!< I2C1 Event Interrupt                                              */
  I2C1_ER_IRQn                = 32,     /*!< I2C1 Error Interrupt                                              */
  I2C2_EV_IRQn                = 33,     /*!< I2C2 Event Interrupt                                              */
  I2C2_ER_IRQn                = 34,     /*!< I2C2 Error Interrupt                                              */
  SPI1_IRQn                   = 35,     /*!< SPI1 global Interrupt                                             */
  SPI2_IRQn                   = 36,     /*!< SPI2 global Interrupt                                             */
  USART1_IRQn                 = 37,     /*!< USART1 global Interrupt                                           */
  USART2_IRQn                 = 38,     /*!< USART2 global Interrupt                                           */
  USART3_IRQn                 = 39,     /*!< USART3 global Interrupt                                           */
  EXTI15_10_IRQn              = 40,     /*!< External Line[15:10] Interrupts                                   */
  RTC_Alarm_IRQn              = 41,     /*!< RTC Alarm (A and B) through EXTI Line Interrupt                   */
  TIM8_BRK_TIM12_IRQn         = 43,     /*!< TIM8 Break Interrupt and TIM12 global interrupt                   */
  TIM8_UP_TIM13_IRQn          = 44,     /*!< TIM8 Update Interrupt and TIM13 global interrupt                  */
  TIM8_TRG_COM_TIM14_IRQn     = 45,     /*!< TIM8 Trigger and Commutation Interrupt and TIM14 global interrupt */
  TIM8_CC_IRQn                = 46,     /*!< TIM8 Capture Compare Interrupt                                    */
  DMA1_Stream7_IRQn           = 47,     /*!< DMA1 Stream7 Interrupt                                            */
  FMC_IRQn                    = 48,     /*!< FMC global Interrupt                                              */
  SDMMC1_IRQn                 = 49,     /*!< SDMMC1 global Interrupt                                           */
  TIM5_IRQn                   = 50,     /*!< TIM5 global Interrupt                                             */
  SPI3_IRQn                   = 51,     /*!< SPI3 global Interrupt                                             */
  UART4_IRQn                  = 52,     /*!< UART4 global Interrupt                                            */
  UART5_IRQn                  = 53,     /*!< UART5 global Interrupt                                            */
  TIM6_DAC_IRQn               = 54,     /*!< TIM6 global and DAC1&2 underrun error  interrupts                 */
  TIM7_IRQn                   = 55,     /*!< TIM7 global interrupt                                             */
  DMA2_Stream0_IRQn           = 56,     /*!<   DMA2 Stream 0 global Interrupt                                  */
  DMA2_Stream1_IRQn           = 57,     /*!<   DMA2 Stream 1 global Interrupt                                  */
  DMA2_Stream2_IRQn           = 58,     /*!<   DMA2 Stream 2 global Interrupt                                  */
  DMA2_Stream3_IRQn           = 59,     /*!<   DMA2 Stream 3 global Interrupt                                  */
  DMA2_Stream4_IRQn           = 60,     /*!<   DMA2 Stream 4 global Interrupt                                  */
  ETH_IRQn                    = 61,     /*!< Ethernet global Interrupt                                         */
  ETH_WKUP_IRQn               = 62,     /*!< Ethernet Wakeup through EXTI line Interrupt                       */
  FDCAN_CAL_IRQn              = 63,     /*!< FDCAN Calibration unit Interrupt                                  */
  DMA2_Stream5_IRQn           = 68,     /*!< DMA2 Stream 5 global interrupt                                    */
  DMA2_Stream6_IRQn           = 69,     /*!< DMA2 Stream 6 global interrupt                                    */
  DMA2_Stream7_IRQn           = 70,     /*!< DMA2 Stream 7 global interrupt                                    */
  USART6_IRQn                 = 71,     /*!< USART6 global interrupt                                           */
  I2C3_EV_IRQn                = 72,     /*!< I2C3 event interrupt                                              */
  I2C3_ER_IRQn                = 73,     /*!< I2C3 error interrupt                                              */
  OTG_HS_EP1_OUT_IRQn         = 74,     /*!< USB OTG HS End Point 1 Out global interrupt                       */
  OTG_HS_EP1_IN_IRQn          = 75,     /*!< USB OTG HS End Point 1 In global interrupt                        */
  OTG_HS_WKUP_IRQn            = 76,     /*!< USB OTG HS Wakeup through EXTI interrupt                          */
  OTG_HS_IRQn                 = 77,     /*!< USB OTG HS global interrupt                                       */
  DCMI_IRQn                   = 78,     /*!< DCMI global interrupt                                             */
  CRYP_IRQn                   = 79,     /*!< CRYP crypto global interrupt                                      */
  HASH_RNG_IRQn               = 80,     /*!< HASH and RNG global interrupt                                     */
  FPU_IRQn                    = 81,     /*!< FPU global interrupt                                              */
  UART7_IRQn                  = 82,     /*!< UART7 global interrupt                                            */
  UART8_IRQn                  = 83,     /*!< UART8 global interrupt                                            */
  SPI4_IRQn                   = 84,     /*!< SPI4 global Interrupt                                             */
  SPI5_IRQn                   = 85,     /*!< SPI5 global Interrupt                                             */
  SPI6_IRQn                   = 86,     /*!< SPI6 global Interrupt                                             */
  SAI1_IRQn                   = 87,     /*!< SAI1 global Interrupt                                             */
  LTDC_IRQn                   = 88,     /*!< LTDC global Interrupt                                             */
  LTDC_ER_IRQn                = 89,     /*!< LTDC Error global Interrupt                                       */
  DMA2D_IRQn                  = 90,     /*!< DMA2D global Interrupt                                            */
  SAI2_IRQn                   = 91,     /*!< SAI2 global Interrupt                                             */
  QUADSPI_IRQn                = 92,     /*!< Quad SPI global interrupt                                         */
  LPTIM1_IRQn                 = 93,     /*!< LP TIM1 interrupt                                                 */
  CEC_IRQn                    = 94,     /*!< HDMI-CEC global Interrupt                                         */
  I2C4_EV_IRQn                = 95,     /*!< I2C4 Event Interrupt                                              */
  I2C4_ER_IRQn                = 96,     /*!< I2C4 Error Interrupt                                              */
  SPDIF_RX_IRQn               = 97,     /*!< SPDIF-RX global Interrupt                                         */
  OTG_FS_EP1_OUT_IRQn         = 98,     /*!< USB OTG HS2 global interrupt                                      */
  OTG_FS_EP1_IN_IRQn          = 99,     /*!< USB OTG HS2 End Point 1 Out global interrupt                      */
  OTG_FS_WKUP_IRQn            = 100,    /*!< USB OTG HS2 End Point 1 In global interrupt                       */
  OTG_FS_IRQn                 = 101,    /*!< USB OTG HS2 Wakeup through EXTI interrupt                         */
  DMAMUX1_OVR_IRQn            = 102,    /*!<DMAMUX1 Overrun interrupt                                          */
  HRTIM1_Master_IRQn          = 103,    /*!< HRTIM Master Timer global Interrupts                              */
  HRTIM1_TIMA_IRQn            = 104,    /*!< HRTIM Timer A global Interrupt                                    */
  HRTIM1_TIMB_IRQn            = 105,    /*!< HRTIM Timer B global Interrupt                                    */
  HRTIM1_TIMC_IRQn            = 106,    /*!< HRTIM Timer C global Interrupt                                    */
  HRTIM1_TIMD_IRQn            = 107,    /*!< HRTIM Timer D global Interrupt                                    */
  HRTIM1_TIME_IRQn            = 108,    /*!< HRTIM Timer E global Interrupt                                    */
  HRTIM1_FLT_IRQn             = 109,    /*!< HRTIM Fault global Interrupt                                      */
  DFSDM1_FLT0_IRQn            = 110,    /*!<DFSDM Filter1 Interrupt                                            */
  DFSDM1_FLT1_IRQn            = 111,    /*!<DFSDM Filter2 Interrupt                                            */
  DFSDM1_FLT2_IRQn            = 112,    /*!<DFSDM Filter3 Interrupt                                            */
  DFSDM1_FLT3_IRQn            = 113,    /*!<DFSDM Filter4 Interrupt                                            */
  SAI3_IRQn                   = 114,    /*!< SAI3 global Interrupt                                             */
  SWPMI1_IRQn                 = 115,    /*!< Serial Wire Interface 1 global interrupt                          */
  TIM15_IRQn                  = 116,    /*!< TIM15 global Interrupt                                            */
  TIM16_IRQn                  = 117,    /*!< TIM16 global Interrupt                                            */
  TIM17_IRQn                  = 118,    /*!< TIM17 global Interrupt                                            */
  MDIOS_WKUP_IRQn             = 119,    /*!< MDIOS Wakeup  Interrupt                                           */
  MDIOS_IRQn                  = 120,    /*!< MDIOS global Interrupt                                            */
  JPEG_IRQn                   = 121,    /*!< JPEG global Interrupt                                             */
  MDMA_IRQn                   = 122,    /*!< MDMA global Interrupt                                             */
  SDMMC2_IRQn                 = 124,    /*!< SDMMC2 global Interrupt                                           */
  HSEM1_IRQn                  = 125,    /*!< HSEM1 global Interrupt                                            */
  ADC3_IRQn                   = 127,    /*!< ADC3 global Interrupt                                             */
  DMAMUX2_OVR_IRQn            = 128,    /*!<DMAMUX2 Overrun interrupt                                          */
  BDMA_Channel0_IRQn          = 129,    /*!< BDMA Channel 0 global Interrupt                                   */
  BDMA_Channel1_IRQn          = 130,    /*!< BDMA Channel 1 global Interrupt                                   */
  BDMA_Channel2_IRQn          = 131,    /*!< BDMA Channel 2 global Interrupt                                   */
  BDMA_Channel3_IRQn          = 132,    /*!< BDMA Channel 3 global Interrupt                                   */
  BDMA_Channel4_IRQn          = 133,    /*!< BDMA Channel 4 global Interrupt                                   */
  BDMA_Channel5_IRQn          = 134,    /*!< BDMA Channel 5 global Interrupt                                   */
  BDMA_Channel6_IRQn          = 135,    /*!< BDMA Channel 6 global Interrupt                                   */
  BDMA_Channel7_IRQn          = 136,    /*!< BDMA Channel 7 global Interrupt                                   */
  COMP_IRQn                   = 137 ,   /*!< COMP global Interrupt                                             */
  LPTIM2_IRQn                 = 138,    /*!< LP TIM2 global interrupt                                          */
  LPTIM3_IRQn                 = 139,    /*!< LP TIM3 global interrupt                                          */
  LPTIM4_IRQn                 = 140,    /*!< LP TIM4 global interrupt                                          */
  LPTIM5_IRQn                 = 141,    /*!< LP TIM5 global interrupt                                          */
  LPUART1_IRQn                = 142,    /*!< LP UART1 interrupt                                                */
  CRS_IRQn                    = 144,    /*!< Clock Recovery Global Interrupt                                   */
  ECC_IRQn                    = 145,    /*!< ECC diagnostic Global Interrupt                                   */
  SAI4_IRQn                   = 146,    /*!< SAI4 global interrupt                                             */
  WAKEUP_PIN_IRQn             = 149,    /*!< Interrupt for all 6 wake-up pins                                  */
} IRQn_Type;

Prekinitveni krmilnik NVIC

Prekinitve in večino izjem lahko programsko upravljamo: jih omogočimo, onemogočimo ali pa jim določamo prioriteto. Za upravljanje skrbi prekinitveni krmilnik, angleško Nested Vectored Interrupt Controller oz. krajše NVIC. NVIC ni naprava podjetja ST, temveč del procesorskega jedra ARM Cortex-M7. Njegovi registri zato niso opisani v referenčnem priročniku mikrokrmilnika, temveč v dokumentaciji jedra:

Prioritete

Prioriteta vsake prekinitve je v STM32H7 zapisana s 4 biti, kar da 16 možnih vrednosti (0-15). Te 4 bite lahko razdelimo na dva dela:

  • prioriteto prekinjanja (angl. preemption priority) in
  • podprioriteto (angl. subpriority).

Prioriteta prekinjanja določa, ali lahko prekinitev prekine drug prekinitveno servisni program, ki se že izvaja. Prekinitev z višjo prioriteto prekinjanja (nižjo številko) lahko prekine PSP prekinitve z nižjo prioriteto prekinjanja. Temu pravimo gnezdenje prekinitev (od tod beseda »nested« v imenu NVIC). Prekinitve z enako prioriteto prekinjanja se med seboj ne morejo prekinjati.

Podprioriteta odloča le o vrstnem redu, kadar hkrati čaka več prekinitev z enako prioriteto prekinjanja: najprej se servisira tista z višjo podprioriteto (nižjo številko). V primeru ujemanja tudi v podprioriteti se prva servisira prekinitev z nižjo oznako IRQn.

Koliko od 4 bitov pripada vsakemu delu, določa t. i. skupina prioritet (priority grouping):

Skupine prioritet
Skupina Biti za prekinjanje Biti za podprioriteto Prekinjanje Podprioriteta
NVIC_PRIORITYGROUP_0 0 4 0 0-15
NVIC_PRIORITYGROUP_1 1 3 0-1 0-7
NVIC_PRIORITYGROUP_2 2 2 0-3 0-3
NVIC_PRIORITYGROUP_3 3 1 0-7 0-1
NVIC_PRIORITYGROUP_4 4 0 0-15 0

Funkcija HAL_Init() nastavi skupino NVIC_PRIORITYGROUP_4. Če skupine ne spremenimo, imamo torej na voljo 16 nivojev prioritete prekinjanja, podprioriteta pa je vedno 0.

TipKdaj izbrati katero skupino?

Z izbiro skupine določimo razmerje med številom nivojev gnezdenja in podprioriteto:

  • Več bitov za prekinjanje (npr. NVIC_PRIORITYGROUP_4): primerno, kadar imamo časovno kritične prekinitve (npr. krmiljenje motorja, varnostni senzor), ki morajo takoj prekiniti manj pomembne PSP-je (npr. prenos po UART). To je tudi najpogostejša izbira, saj je obnašanje sistema najlaže predvideti: višja prioriteta preprosto pomeni takojšnjo izvedbo.
  • Več bitov za podprioriteto (npr. NVIC_PRIORITYGROUP_2): primerno, kadar imamo več podobno pomembnih naprav (npr. več UART, SPI in I2C), ki se med seboj ne rabijo prekinjati. Manj nivojev gnezdenja pomeni tudi manjšo največjo porabo sklada, s podprioriteto pa še vedno določimo, katera čakajoča prekinitev bo servisirana prva.

Programski vmesnik

Programski vmesnik za delo z NVIC v STM HAL je zelo enostaven, zanimive so predvsem štiri funkcije:

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

Funkcija nastavi prioriteto prekinjanja in podprioriteto za podano prekinitveno oznako. Deluje tudi za izjeme jedra z nastavljivo prioriteto, ki imajo negativne oznake (npr. SysTick), ne pa za izjeme s fiksno prioriteto (NMI, HardFault). Primera:

HAL_NVIC_SetPriority(EXTI2_IRQn, 12, 0);
HAL_NVIC_SetPriority(SysTick_IRQn, 15, 0);
  • HAL_NVIC_EnableIRQ(IRQn_Type IRQn)

Funkcija omogoči prekinitev za podano oznako. Primera:

HAL_NVIC_EnableIRQ(RTC_WKUP_IRQn);
HAL_NVIC_EnableIRQ(EXTI4_IRQn);
  • HAL_NVIC_DisableIRQ(IRQn_Type IRQn)

Funkcija onemogoči prekinitev za podano oznako. Primera:

HAL_NVIC_DisableIRQ(RTC_WKUP_IRQn);
HAL_NVIC_DisableIRQ(EXTI4_IRQn);

Funkciji HAL_NVIC_EnableIRQ in HAL_NVIC_DisableIRQ delujeta le za prekinitve (IRQn 0 in več). Izjeme procesorskega jedra se omogočajo drugje: SysTick v registrih samega časovnika (glej razdelek Registri SysTick), MemManage, BusFault in UsageFault pa v registru SHCSR (glej razdelek Napake: HardFault in UsageFault).

  • HAL_NVIC_SystemReset(void)

Funkcija programsko sproži reset.

Registri

Funkcije knjižnice HAL za delo z NVIC zgolj pišejo v registre NVIC in bloka SCB (System Control Block). Kako so ti registri organizirani in kaj posamezna funkcija v njih zapiše, je opisano v poglavju Registri NVIC, SCB in SysTick.

Prekinitveno servisni programi

Če je izjema/prekinitev omogočena, NVIC procesorju sporoči, katera izjema/prekinitev je prispela. Začetni naslovi (imena funkcij v zbirniku ali C-ju) prekinitveno servisnih programov se nahajajo v t. i. vektorski tabeli, ki se nahaja v datoteki startup_stm32h750xbhx.s. Celotna vektorska tabela je prikazana spodaj. Prvi element vektorske tabele je začetna vrednost skladovnega kazalca (stack pointer), temu pa sledi seznam začetnih naslovov vseh prekinitveno servisnih programov. Vrstni red sledi oznakam IRQn: najprej sta Reset in NMI (-14), nato ostale izjeme jedra do SysTick (-1), pri čemer so na mestih rezerviranih oznak ničle, nato pa prekinitve po vrsti od IRQn 0 naprej.

g_pfnVectors:
  .word  _estack
  .word  Reset_Handler

  .word  NMI_Handler
  .word  HardFault_Handler
  .word  MemManage_Handler
  .word  BusFault_Handler
  .word  UsageFault_Handler
  .word  0
  .word  0
  .word  0
  .word  0
  .word  SVC_Handler
  .word  DebugMon_Handler
  .word  0
  .word  PendSV_Handler
  .word  SysTick_Handler

  /* External Interrupts */
  .word     WWDG_IRQHandler                   /* Window WatchDog              */
  .word     PVD_AVD_IRQHandler                /* PVD/AVD through EXTI Line detection */
  .word     TAMP_STAMP_IRQHandler             /* Tamper and TimeStamps through the EXTI line */
  .word     RTC_WKUP_IRQHandler               /* RTC Wakeup through the EXTI line */
  .word     FLASH_IRQHandler                  /* FLASH                        */
  .word     RCC_IRQHandler                    /* RCC                          */
  .word     EXTI0_IRQHandler                  /* EXTI Line0                   */
  .word     EXTI1_IRQHandler                  /* EXTI Line1                   */
  .word     EXTI2_IRQHandler                  /* EXTI Line2                   */
  .word     EXTI3_IRQHandler                  /* EXTI Line3                   */
  .word     EXTI4_IRQHandler                  /* EXTI Line4                   */
  .word     DMA1_Stream0_IRQHandler           /* DMA1 Stream 0                */
  .word     DMA1_Stream1_IRQHandler           /* DMA1 Stream 1                */
  .word     DMA1_Stream2_IRQHandler           /* DMA1 Stream 2                */
  .word     DMA1_Stream3_IRQHandler           /* DMA1 Stream 3                */
  .word     DMA1_Stream4_IRQHandler           /* DMA1 Stream 4                */
  .word     DMA1_Stream5_IRQHandler           /* DMA1 Stream 5                */
  .word     DMA1_Stream6_IRQHandler           /* DMA1 Stream 6                */
  .word     ADC_IRQHandler                    /* ADC1, ADC2 and ADC3s         */
  .word     FDCAN1_IT0_IRQHandler             /* FDCAN1 interrupt line 0      */
  .word     FDCAN2_IT0_IRQHandler             /* FDCAN2 interrupt line 0      */
  .word     FDCAN1_IT1_IRQHandler             /* FDCAN1 interrupt line 1      */
  .word     FDCAN2_IT1_IRQHandler             /* FDCAN2 interrupt line 1      */
  .word     EXTI9_5_IRQHandler                /* External Line[9:5]s          */
  .word     TIM1_BRK_IRQHandler               /* TIM1 Break interrupt         */
  .word     TIM1_UP_IRQHandler                /* TIM1 Update interrupt        */
  .word     TIM1_TRG_COM_IRQHandler           /* TIM1 Trigger and Commutation interrupt */
  .word     TIM1_CC_IRQHandler                /* TIM1 Capture Compare         */
  .word     TIM2_IRQHandler                   /* TIM2                         */
  .word     TIM3_IRQHandler                   /* TIM3                         */
  .word     TIM4_IRQHandler                   /* TIM4                         */
  .word     I2C1_EV_IRQHandler                /* I2C1 Event                   */
  .word     I2C1_ER_IRQHandler                /* I2C1 Error                   */
  .word     I2C2_EV_IRQHandler                /* I2C2 Event                   */
  .word     I2C2_ER_IRQHandler                /* I2C2 Error                   */
  .word     SPI1_IRQHandler                   /* SPI1                         */
  .word     SPI2_IRQHandler                   /* SPI2                         */
  .word     USART1_IRQHandler                 /* USART1                       */
  .word     USART2_IRQHandler                 /* USART2                       */
  .word     USART3_IRQHandler                 /* USART3                       */
  .word     EXTI15_10_IRQHandler              /* External Line[15:10]s        */
  .word     RTC_Alarm_IRQHandler              /* RTC Alarm (A and B) through EXTI Line */
  .word     0                                 /* Reserved                     */
  .word     TIM8_BRK_TIM12_IRQHandler         /* TIM8 Break and TIM12         */
  .word     TIM8_UP_TIM13_IRQHandler          /* TIM8 Update and TIM13        */
  .word     TIM8_TRG_COM_TIM14_IRQHandler     /* TIM8 Trigger and Commutation and TIM14 */
  .word     TIM8_CC_IRQHandler                /* TIM8 Capture Compare         */
  .word     DMA1_Stream7_IRQHandler           /* DMA1 Stream7                 */
  .word     FMC_IRQHandler                    /* FMC                          */
  .word     SDMMC1_IRQHandler                 /* SDMMC1                       */
  .word     TIM5_IRQHandler                   /* TIM5                         */
  .word     SPI3_IRQHandler                   /* SPI3                         */
  .word     UART4_IRQHandler                  /* UART4                        */
  .word     UART5_IRQHandler                  /* UART5                        */
  .word     TIM6_DAC_IRQHandler               /* TIM6 and DAC1&2 underrun errors */
  .word     TIM7_IRQHandler                   /* TIM7                         */
  .word     DMA2_Stream0_IRQHandler           /* DMA2 Stream 0                */
  .word     DMA2_Stream1_IRQHandler           /* DMA2 Stream 1                */
  .word     DMA2_Stream2_IRQHandler           /* DMA2 Stream 2                */
  .word     DMA2_Stream3_IRQHandler           /* DMA2 Stream 3                */
  .word     DMA2_Stream4_IRQHandler           /* DMA2 Stream 4                */
  .word     ETH_IRQHandler                    /* Ethernet                     */
  .word     ETH_WKUP_IRQHandler               /* Ethernet Wakeup through EXTI line */
  .word     FDCAN_CAL_IRQHandler              /* FDCAN calibration unit interrupt*/
  .word     0                                 /* Reserved                     */
  .word     0                                 /* Reserved                     */
  .word     0                                 /* Reserved                     */
  .word     0                                 /* Reserved                     */
  .word     DMA2_Stream5_IRQHandler           /* DMA2 Stream 5                */
  .word     DMA2_Stream6_IRQHandler           /* DMA2 Stream 6                */
  .word     DMA2_Stream7_IRQHandler           /* DMA2 Stream 7                */
  .word     USART6_IRQHandler                 /* USART6                       */
  .word     I2C3_EV_IRQHandler                /* I2C3 event                   */
  .word     I2C3_ER_IRQHandler                /* I2C3 error                   */
  .word     OTG_HS_EP1_OUT_IRQHandler         /* USB OTG HS End Point 1 Out   */
  .word     OTG_HS_EP1_IN_IRQHandler          /* USB OTG HS End Point 1 In    */
  .word     OTG_HS_WKUP_IRQHandler            /* USB OTG HS Wakeup through EXTI */
  .word     OTG_HS_IRQHandler                 /* USB OTG HS                   */
  .word     DCMI_IRQHandler                   /* DCMI                         */
  .word     CRYP_IRQHandler                   /* Crypto                       */
  .word     HASH_RNG_IRQHandler               /* Hash and Rng                 */
  .word     FPU_IRQHandler                    /* FPU                          */
  .word     UART7_IRQHandler                  /* UART7                        */
  .word     UART8_IRQHandler                  /* UART8                        */
  .word     SPI4_IRQHandler                   /* SPI4                         */
  .word     SPI5_IRQHandler                   /* SPI5                         */
  .word     SPI6_IRQHandler                   /* SPI6                         */
  .word     SAI1_IRQHandler                   /* SAI1                         */
  .word     LTDC_IRQHandler                   /* LTDC                         */
  .word     LTDC_ER_IRQHandler                /* LTDC error                   */
  .word     DMA2D_IRQHandler                  /* DMA2D                        */
  .word     SAI2_IRQHandler                   /* SAI2                         */
  .word     QUADSPI_IRQHandler                /* QUADSPI                      */
  .word     LPTIM1_IRQHandler                 /* LPTIM1                       */
  .word     CEC_IRQHandler                    /* HDMI_CEC                     */
  .word     I2C4_EV_IRQHandler                /* I2C4 Event                   */
  .word     I2C4_ER_IRQHandler                /* I2C4 Error                   */
  .word     SPDIF_RX_IRQHandler               /* SPDIF_RX                     */
  .word     OTG_FS_EP1_OUT_IRQHandler         /* USB OTG FS End Point 1 Out   */
  .word     OTG_FS_EP1_IN_IRQHandler          /* USB OTG FS End Point 1 In    */
  .word     OTG_FS_WKUP_IRQHandler            /* USB OTG FS Wakeup through EXTI */
  .word     OTG_FS_IRQHandler                 /* USB OTG FS                   */
  .word     DMAMUX1_OVR_IRQHandler            /* DMAMUX1 Overrun interrupt    */
  .word     HRTIM1_Master_IRQHandler          /* HRTIM Master Timer global Interrupt */
  .word     HRTIM1_TIMA_IRQHandler            /* HRTIM Timer A global Interrupt */
  .word     HRTIM1_TIMB_IRQHandler            /* HRTIM Timer B global Interrupt */
  .word     HRTIM1_TIMC_IRQHandler            /* HRTIM Timer C global Interrupt */
  .word     HRTIM1_TIMD_IRQHandler            /* HRTIM Timer D global Interrupt */
  .word     HRTIM1_TIME_IRQHandler            /* HRTIM Timer E global Interrupt */
  .word     HRTIM1_FLT_IRQHandler             /* HRTIM Fault global Interrupt   */
  .word     DFSDM1_FLT0_IRQHandler            /* DFSDM Filter0 Interrupt        */
  .word     DFSDM1_FLT1_IRQHandler            /* DFSDM Filter1 Interrupt        */
  .word     DFSDM1_FLT2_IRQHandler            /* DFSDM Filter2 Interrupt        */
  .word     DFSDM1_FLT3_IRQHandler            /* DFSDM Filter3 Interrupt        */
  .word     SAI3_IRQHandler                   /* SAI3 global Interrupt          */
  .word     SWPMI1_IRQHandler                 /* Serial Wire Interface 1 global interrupt */
  .word     TIM15_IRQHandler                  /* TIM15 global Interrupt      */
  .word     TIM16_IRQHandler                  /* TIM16 global Interrupt      */
  .word     TIM17_IRQHandler                  /* TIM17 global Interrupt      */
  .word     MDIOS_WKUP_IRQHandler             /* MDIOS Wakeup  Interrupt     */
  .word     MDIOS_IRQHandler                  /* MDIOS global Interrupt      */
  .word     JPEG_IRQHandler                   /* JPEG global Interrupt       */
  .word     MDMA_IRQHandler                   /* MDMA global Interrupt       */
  .word     0                                 /* Reserved                    */
  .word     SDMMC2_IRQHandler                 /* SDMMC2 global Interrupt     */
  .word     HSEM1_IRQHandler                  /* HSEM1 global Interrupt      */
  .word     0                                 /* Reserved                    */
  .word     ADC3_IRQHandler                   /* ADC3 global Interrupt       */
  .word     DMAMUX2_OVR_IRQHandler            /* DMAMUX Overrun interrupt    */
  .word     BDMA_Channel0_IRQHandler          /* BDMA Channel 0 global Interrupt */
  .word     BDMA_Channel1_IRQHandler          /* BDMA Channel 1 global Interrupt */
  .word     BDMA_Channel2_IRQHandler          /* BDMA Channel 2 global Interrupt */
  .word     BDMA_Channel3_IRQHandler          /* BDMA Channel 3 global Interrupt */
  .word     BDMA_Channel4_IRQHandler          /* BDMA Channel 4 global Interrupt */
  .word     BDMA_Channel5_IRQHandler          /* BDMA Channel 5 global Interrupt */
  .word     BDMA_Channel6_IRQHandler          /* BDMA Channel 6 global Interrupt */
  .word     BDMA_Channel7_IRQHandler          /* BDMA Channel 7 global Interrupt */
  .word     COMP1_IRQHandler                  /* COMP1 global Interrupt     */
  .word     LPTIM2_IRQHandler                 /* LP TIM2 global interrupt   */
  .word     LPTIM3_IRQHandler                 /* LP TIM3 global interrupt   */
  .word     LPTIM4_IRQHandler                 /* LP TIM4 global interrupt   */
  .word     LPTIM5_IRQHandler                 /* LP TIM5 global interrupt   */
  .word     LPUART1_IRQHandler                /* LP UART1 interrupt         */
  .word     0                                 /* Reserved                   */
  .word     CRS_IRQHandler                    /* Clock Recovery Global Interrupt */
  .word     ECC_IRQHandler                    /* ECC diagnostic Global Interrupt */
  .word     SAI4_IRQHandler                   /* SAI4 global interrupt      */
  .word     0                                 /* Reserved                   */
  .word     0                                 /* Reserved                   */
  .word     WAKEUP_PIN_IRQHandler             /* Interrupt for all 6 wake-up pins */

  .size  g_pfnVectors, .-g_pfnVectors

Če se zgodi izjema HardFault, se bo torej izvedla funkcija z imenom HardFault_Handler. Ta je lahko napisana v zbirniku ali C-ju. Spodaj je podana tabela z oznakami in pripadajočimi imeni prekinitveno servisnih programov za izjeme in nekaj prekinitev.

Oznake IRQn in imena prekinitveno servisnih programov
Oznaka (IRQn) Prekinitveno servisni program
Reset (ni oznake v HAL) Reset_Handler
NonMaskableInt_IRQn NMI_Handler
HardFault_IRQn HardFault_Handler
MemoryManagement_IRQn MemManage_Handler
BusFault_IRQn BusFault_Handler
UsageFault_IRQn UsageFault_Handler
SVCall_IRQn SVC_Handler
DebugMonitor_IRQn DebugMon_Handler
PendSV_IRQn PendSV_Handler
SysTick_IRQn SysTick_Handler
WWDG_IRQn WWDG_IRQHandler
PVD_AVD_IRQn PVD_AVD_IRQHandler
TAMP_STAMP_IRQn TAMP_STAMP_IRQHandler
RTC_WKUP_IRQn RTC_WKUP_IRQHandler
FLASH_IRQn FLASH_IRQHandler
RCC_IRQn RCC_IRQHandler
EXTI0_IRQn EXTI0_IRQHandler
EXTI1_IRQn EXTI1_IRQHandler
… …

Nekateri prekinitveno servisni programi so realizirani v zbirniku (na primer Reset_Handler). Te najdemo v datoteki startup_stm32h750xbhx.s. PSP-je v jeziku C pa najdemo v stm32h7xx_it.c. Tam jih bomo pisali tudi mi.

WarningIme PSP mora biti natanko pravilno

V datoteki startup_stm32h750xbhx.s so vsi PSP-ji razen Reset_Handler definirani kot šibki simboli (.weak), ki kažejo na Default_Handler. Ta vsebuje le neskončno zanko. Ko napišemo funkcijo z enakim imenom, povezovalnik (angl. linker) namesto Default_Handler uporabi našo funkcijo. Če se v imenu zmotimo (npr. EXTI2_IRQHandle ali Systick_Handler), prevajalnik ne javi napake, program pa ob prekinitvi obtiči v neskončni zanki v Default_Handler.

Napake: HardFault in UsageFault

Med razvojem se vam bo zagotovo zgodilo, da se program nenadoma »ustavi«: LED ne utripajo več, gumb ne deluje. Ko v razhroščevalniku izvajanje začasno ustavite (pause), boste največkrat ugotovili, da se procesor vrti v neskončni zanki v funkciji HardFault_Handler. V tem razdelku si bomo pogledali, kako do tega pride, in napako sprožili tudi namenoma.

Kot smo omenili na začetku vaje, so izjeme MemManage, BusFault in UsageFault po resetu onemogočene. Vsaka napaka, ki bi jo sicer obravnavala ena izmed njih, se zato preusmeri v izjemo HardFault. Pravimo, da se napaka stopnjuje (angl. escalation). Če želimo, da se namesto HardFault izvede PSP za posamezno vrsto napake, moramo to izjemo najprej omogočiti.

Registri za napake

Napake nastavljamo in analiziramo z registri bloka SCB:

Registri SCB za napake
Naslov Register Polno ime Pomembni biti
0xE000ED14 CCR Configuration and Control Register bit 3 UNALIGN_TRP: neporavnan dostop sproži UsageFault
bit 4 DIV_0_TRP: celoštevilsko deljenje z 0 sproži UsageFault
0xE000ED24 SHCSR System Handler Control and State Register bit 16 MEMFAULTENA: omogoči MemManage
bit 17 BUSFAULTENA: omogoči BusFault
bit 18 USGFAULTENA: omogoči UsageFault
0xE000ED28 CFSR Configurable Fault Status Register vzrok napake; zgornjih 16 bitov se nanaša na UsageFault, med njimi:
bit 16 UNDEFINSTR: nedefiniran ukaz
bit 17 INVSTATE: neveljavno stanje procesorja
bit 24 UNALIGNED: neporavnan dostop
bit 25 DIVBYZERO: deljenje z 0
0xE000ED2C HFSR HardFault Status Register bit 30 FORCED: HardFault je nastal s stopnjevanjem druge napake

Biti v registrih CFSR in HFSR ostanejo postavljeni, dokler jih ne pobrišemo (z vpisom enice) ali dokler ne resetiramo mikrokrmilnika. V razhroščevalniku jih najdemo v pogledu SFR pod SCB. STM32CubeIDE ima za analizo napak tudi pogled Fault Analyzer (Window → Show View → Fault Analyzer), ki vsebino teh registrov prevede v opis napake in pokaže ukaz, ki je napako povzročil.

Priprava: LED za prikaz napake

V obeh primerih bomo napako prikazali z LED. V main.c dodamo funkcijo, ki inicializira rdečo LED (PI13) in zeleno LED (PJ2). Obe svetita ob ničli, zato ju po inicializaciji ugasnemo z enico:

void LED_Init(void) {
  __HAL_RCC_GPIOI_CLK_ENABLE();
  __HAL_RCC_GPIOJ_CLK_ENABLE();

  GPIO_InitTypeDef init = {0};
  init.Mode = GPIO_MODE_OUTPUT_PP;
  init.Pull = GPIO_NOPULL;
  init.Speed = GPIO_SPEED_FREQ_LOW;

  init.Pin = GPIO_PIN_13;
  HAL_GPIO_Init(GPIOI, &init);
  init.Pin = GPIO_PIN_2;
  HAL_GPIO_Init(GPIOJ, &init);

  HAL_GPIO_WritePin(GPIOI, GPIO_PIN_13, GPIO_PIN_SET); // rdeca ugasnjena
  HAL_GPIO_WritePin(GPIOJ, GPIO_PIN_2, GPIO_PIN_SET);  // zelena ugasnjena
}

PSP-ja za obe izjemi sta že pripravljena v stm32h7xx_it.c. Vanju dodamo prižig LED: ob HardFault naj se prižge rdeča, ob UsageFault pa zelena LED. Neskončno zanko pustimo, saj se po napaki ne moremo varno vrniti v program: procesor bi se vrnil na ukaz, ki je napako povzročil, in napaka bi se ponovila.

void HardFault_Handler(void)
{
  /* USER CODE BEGIN HardFault_IRQn 0 */
  HAL_GPIO_WritePin(GPIOI, GPIO_PIN_13, GPIO_PIN_RESET); // prizgemo rdeco LED
  /* USER CODE END HardFault_IRQn 0 */
  while (1)
  {
  }
}

void UsageFault_Handler(void)
{
  /* USER CODE BEGIN UsageFault_IRQn 0 */
  HAL_GPIO_WritePin(GPIOJ, GPIO_PIN_2, GPIO_PIN_RESET); // prizgemo zeleno LED
  /* USER CODE END UsageFault_IRQn 0 */
  while (1)
  {
  }
}

Primer: HardFault

Pogost vzrok za HardFault je klic funkcije prek kazalca, ki ga nismo nastavili:

int main(void)
{
  HAL_Init();
  SystemClock_Config();
  LED_Init();

  void (*funkcija)(void) = NULL; // kazalec na funkcijo, ki ga nismo nastavili
  funkcija();                    // skok na naslov 0 -> HardFault

  while (1)
  {
  }
}

Ob klicu funkcija() procesor skoči na naslov 0x00000000. Cortex-M7 izvaja le ukaze Thumb, zato mora imeti naslov, na katerega skočimo, najnižji bit postavljen na 1. Naslov 0 ga nima, zato procesor preide v neveljavno stanje in ob naslednjem ukazu sproži napako UsageFault. Ker UsageFault ni omogočen, se napaka stopnjuje v HardFault in prižge se rdeča LED.

V razhroščevalniku preverite registra SCB:

  • v CFSR je postavljen bit 17 INVSTATE (vrednost 0x00020000), ki pove pravi vzrok napake,
  • v HFSR je postavljen bit 30 FORCED (vrednost 0x40000000), ki pove, da je HardFault nastal s stopnjevanjem.

Primer: UsageFault ob deljenju z 0

Po resetu celoštevilsko deljenje z 0 ne sproži napake, temveč vrne 0. Program tako nemoteno teče naprej z napačnim rezultatom, kar je težko odkriti. Z bitom DIV_0_TRP v registru CCR lahko vklopimo, da deljenje z 0 sproži UsageFault. Da se ob tem izvede UsageFault_Handler in ne HardFault_Handler, moramo izjemo UsageFault še omogočiti z bitom USGFAULTENA v registru SHCSR:

int main(void)
{
  HAL_Init();
  SystemClock_Config();
  LED_Init();

  SCB->SHCSR |= SCB_SHCSR_USGFAULTENA_Msk; // omogocimo izjemo UsageFault
  SCB->CCR |= SCB_CCR_DIV_0_TRP_Msk;       // deljenje z 0 sprozi UsageFault

  volatile int a = 10;
  volatile int b = 0;
  volatile int c = a / b;                  // -> UsageFault

  while (1)
  {
  }
}

SCB je kazalec na strukturo z registri bloka SCB, SCB_SHCSR_USGFAULTENA_Msk in SCB_CCR_DIV_0_TRP_Msk pa maski bitov 18 in 4, definirani v core_cm7.h. Spremenljivke so označene z volatile, sicer bi prevajalnik deljenje izračunal že med prevajanjem ali ga zaradi neuporabljenega rezultata v celoti odstranil.

Ob izvedbi programa se prižge zelena LED, v registru CFSR pa je postavljen bit 25 DIVBYZERO (vrednost 0x02000000).

Preizkusite še, kaj se zgodi, če:

  • izbrišete vrstico, ki nastavi SHCSR: katera LED se prižge in kakšna je vrednost HFSR?
  • izbrišete obe vrstici, ki nastavljata SCB: kakšna je vrednost spremenljivke c?

Izjema SysTick

Kot že omenjeno zgoraj, izjemo SysTick generira sistemski časovnik, ko doseže vrednost 0. Tudi sistemski časovnik je del procesorskega jedra, tako kot NVIC.

Inicializacija v knjižnici HAL

V funkciji HAL_Init(), ki jo uporabljamo, kadar se poslužujemo knjižnice STM HAL, se inicializira sistemski časovnik in omogoči izjemo SysTick s prioriteto (15, 0) in frekvenco 1 kHz. Izjema se torej proži in funkcija SysTick_Handler izvede vsako milisekundo. Kako je to doseženo z registri sistemskega časovnika, je opisano v poglavju Registri NVIC, SCB in SysTick.

HAL_Delay

V stm32h7xx_it.c najdemo realizacijo PSP-ja:

void SysTick_Handler(void)
{
  /* USER CODE BEGIN SysTick_IRQn 0 */

  /* USER CODE END SysTick_IRQn 0 */
  HAL_IncTick();
  /* USER CODE BEGIN SysTick_IRQn 1 */

  /* USER CODE END SysTick_IRQn 1 */
}

Klic HAL_IncTick() omogoča delovanje funkcije HAL_Delay(), ki smo jo uporabili na zadnji vaji. Funkcija HAL_IncTick zgolj poveča globalno spremenljivko uwTick, ki tako šteje milisekunde od zagona. HAL_Delay (poenostavljeno) prebere trenutno vrednost in čaka, dokler ne preteče dovolj milisekund:

__IO uint32_t uwTick;

void HAL_IncTick(void)
{
  uwTick += 1;
}

void HAL_Delay(uint32_t Delay)
{
  uint32_t tickstart = uwTick;
  uint32_t wait = Delay + 1; // +1 zagotovi, da cakamo vsaj Delay ms

  while ((uwTick - tickstart) < wait)
  {
  }
}

Zakaj +1? Ko pokličemo HAL_Delay, je od zadnje izjeme SysTick lahko minilo že skoraj milisekundo. Prvo povečanje uwTick se lahko zgodi takoj, zato bi brez dodatne milisekunde čakali lahko manj, kot smo zahtevali.

TipZakaj je uwTick volatile?

Spremenljivka uwTick je deklarirana z __IO, torej kot volatile. Zanka v HAL_Delay spremenljivke sama ne spreminja, spreminja jo PSP. Brez volatile bi prevajalnik lahko sklepal, da se vrednost v zanki ne spreminja, prebral bi jo le enkrat in zanka se ne bi nikoli končala. To je isti razlog, zaradi katerega smo na prvi vaji volatile uporabili pri registrih.

WarningHAL_Delay v prekinitveno servisnem programu

SysTick ima najnižjo prioriteto (15). Če HAL_Delay pokličemo v PSP prekinitve z višjo ali enako prioriteto, SysTick tega PSP-ja ne more prekiniti, uwTick se ne povečuje in program obtiči v zanki. Na to bodite pozorni na naslednjih vajah, ko bomo pisali PSP-je za druge prekinitve.

Poskus: spreminjanje registrov SysTick

Funkcija HAL_Delay v resnici ne šteje milisekund, temveč izjeme SysTick. Da med dvema izjemama mine natanko ena milisekunda, poskrbi le pravilna nastavitev sistemskega časovnika. To lahko preverimo tako, da registre sistemskega časovnika (opisani so v poglavju Registri NVIC, SCB in SysTick) spremenimo sami.

Za izhodišče vzemimo program, ki zeleno LED na pinu PD3 prižge in ugasne vsako sekundo:

HAL_Init();
SystemClock_Config();

// inicializacija PD3 kot izhod (glej zadnjo vajo)

while (1) {
  HAL_GPIO_TogglePin(GPIOD, GPIO_PIN_3);
  HAL_Delay(1000);
}

Spremembe registrov naredimo za klicem SystemClock_Config(), saj ta sistemski časovnik ponovno nastavi.

Manjša vrednost LOAD. Sistemski časovnik je 24-bitni števec navzdol, katerega trenutna vrednost je v registru VAL. Register LOAD hrani začetno vrednost štetja: ko števec doseže 0, se vanj ponovno naloži vrednost iz LOAD in sproži se izjema SysTick. Med dvema izjemama tako mine LOAD + 1 urinih ciklov. Pri frekvenci 64 MHz je v registru LOAD vrednost 63999. Če pred zanko dodamo vrstico

SysTick->LOAD = 6400 - 1; // 10-krat manj kot 64000 - 1

se izjema SysTick proži vsakih 6400 urinih ciklov, torej vsakih 0,1 ms. Spremenljivka uwTick se povečuje 10-krat hitreje, HAL_Delay(1000) traja le 0,1 s in LED utripa 10-krat hitreje. Nova vrednost LOAD začne veljati, ko števec naslednjič doseže 0.

Deljena ura. Bit CLKSOURCE v registru CTRL naprave SysTick izbere vir ure, s katero šteje sistemski časovnik. Če je bit postavljen (1), števec šteje z uro procesorja; če je pobrisan (0), šteje z zunanjo referenčno uro, ki je pri mikrokrmilnikih STM32H7 ura procesorja, deljena z 8. Funkcija HAL_Init() bit postavi. Če namesto tega v registru CTRL pobrišemo bit CLKSOURCE

SysTick->CTRL &= ~SysTick_CTRL_CLKSOURCE_Msk; // ura procesorja, deljena z 8

sistemski časovnik šteje z 8-krat nižjo frekvenco (8 MHz). Izjema se tako proži vsakih 8 ms, HAL_Delay(1000) traja 8 s in LED utripa 8-krat počasneje.

Poskusa pokažeta, da vse funkcije, ki se zanašajo na HAL_IncTick(), delujejo pravilno le, če je sistemski časovnik nastavljen na 1 kHz. Po poskusu vrstici odstranite.

Naloga

V tej nalogi ne uporabljajte HAL_Delay in ostalih funkcij HAL za delo z zakasnitvijo, temveč implementirajte svoj števec milisekund.

  • V SysTick_Handler (v razdelku USER CODE) povečujte svojo globalno spremenljivko ms, ki šteje milisekunde od zagona. Napišite funkcijo uint32_t My_GetTick(void), ki vrne njeno vrednost.

  • Zelena LED na pinu PD3 naj utripa s polperiodo zakasnitev, ki je po resetu enaka trem sekundam (3 s prižgana, 3 s ugasnjena).

  • Zelena LED na pinu PJ2 naj ves čas utripa s frekvenco 2 Hz (0,25 s prižgana, 0,25 s ugasnjena), neodvisno od LED na pinu PD3.

  • Ko gumb držimo 1 sekundo, naj se zakasnitev zmanjša za tretjino: iz treh sekund na dve sekundi, potem na 1,33 sekunde in tako naprej. En pritisk naj zakasnitev zmanjša le enkrat, ne glede na to, kako dolgo gumb držimo. Spremembo naj LED na pinu PD3 upošteva najkasneje ob naslednjem preklopu.

TipNamig

Glavna zanka naj ne čaka. Za vsako LED si zapomnite čas zadnjega preklopa in jo preklopite, ko je od takrat minilo dovolj milisekund:

if ((My_GetTick() - zadnji_preklop) >= zakasnitev) {
  zadnji_preklop += zakasnitev;
  // preklopi LED
}

Na enak način merite, kako dolgo je gumb pritisnjen: ob spremembi iz nepritisnjenega v pritisnjeno stanje si zapomnite čas pritiska. Razmislite, ali mora biti spremenljivka ms deklarirana kot volatile in zakaj. Zakaj pogoj zapišemo kot razliko My_GetTick() - zadnji_preklop >= zakasnitev in ne kot My_GetTick() >= zadnji_preklop + zakasnitev? Kaj se zgodi s števcem po 232 ms (približno 49 dneh)?

Izziv: programski reset

Program dopolnite tako, da:

  • se ob pritisku gumba, daljšem od 5 sekund, sproži programski reset s funkcijo HAL_NVIC_SystemReset(). S kakšno zakasnitvijo utripajo LED po resetu? Zakaj?
  • na začetku programa (za HAL_Init() in inicializacijo LED) preveri, ali je bil zadnji reset programski. To pove zastavica SFTRSTF v registru RCC_RSR, ki jo preberete z __HAL_RCC_GET_FLAG(RCC_FLAG_SFTRST). Če je bil reset programski, naj se za eno sekundo prižge rdeča LED. Zastavice ostanejo postavljene do naslednjega izklopa napajanja, zato jih po branju pobrišite z __HAL_RCC_CLEAR_RESET_FLAGS(). Preverite, da se rdeča LED ne prižge, ko reset sprožite s črno tipko.