Watchdog (IWDG)
Program na mikrokrmilniku lahko obtiči: v neskončni zanki zaradi napake, pri čakanju na napravo, ki se nikoli ne odzove, ali v HardFault_Handler (glej vajo 4). Pri napravi, ki deluje brez nadzora, recimo nekje na terenu, si tega ne moremo privoščiti. Rešitev je watchdog: časovnik, ki mikrokrmilnik resetira, če ga program pravočasno ne osveži. Dokler program deluje pravilno, watchdog redno osvežuje. Ko obtiči, osveževanje preneha in watchdog po izteku časa sproži reset.
Začetni projekt
Za to poglavje smo pripravili začetni projekt. Prenesite različico za razvojno okolje, ki ga uporabljate:
- STM32CubeIDE: watchdog_cube.zip
- VS Code: watchdog_cmake.zip
Projekt v STM32CubeIDE uvozite po navodilih v razdelku Uvoz obstoječega projekta. Za VS Code ZIP datoteko najprej razširite, nato pa mapo projekta odprite po navodilih v razdelku Uvoz obstoječega projekta.
Projekt že vsebuje datoteke knjižnice HAL za IWDG (stm32h7xx_hal_iwdg.c in stm32h7xx_hal_iwdg.h), v stm32h7xx_hal_conf.h pa je definiran HAL_IWDG_MODULE_ENABLED.
Neodvisni watchdog v STM32H7
STM32H750 ima dve vrsti watchdoga. Neodvisni watchdog (Independent Watchdog, IWDG1) šteje z lastno uro LSI (Low Speed Internal Clock) s frekvenco približno 32 kHz, zato deluje tudi, če se sistemska ura ustavi ali je napačno nastavljena. Okenski watchdog (Window Watchdog, WWDG1) šteje z uro vodila in zahteva, da ga osvežimo znotraj točno določenega časovnega okna, ne prezgodaj in ne prepozno. Spoznali bomo neodvisni watchdog.
IWDG je 12-bitni števec, ki šteje navzdol. Ko doseže 0, sproži reset mikrokrmilnika. Z osvežitvijo (angl. refresh) števec ponastavimo na začetno vrednost. Ko IWDG enkrat zaženemo, ga ni več mogoče ustaviti do naslednjega reseta.
Čas do reseta določata delilnik ure (PR) in začetna vrednost števca (RLR):
\[ t = \frac{4 \cdot 2^{PR} \cdot (RLR + 1)}{f_{LSI}} \]
| Delilnik | Konstanta HAL | En korak števca | Največji čas (RLR = 4095) |
|---|---|---|---|
| 4 | IWDG_PRESCALER_4 |
0,125 ms | 0,51 s |
| 16 | IWDG_PRESCALER_16 |
0,5 ms | 2,05 s |
| 64 | IWDG_PRESCALER_64 |
2 ms | 8,19 s |
| 256 | IWDG_PRESCALER_256 |
8 ms | 32,8 s |
Za čas 2 sekundi lahko izberemo na primer delilnik 64 in RLR = 999. Ura LSI je znana po tem, da je nenatančna in lahko zelo niha zaradi sprememb v temperaturi, majhnih sprememb v napetosti in staranja, razlikuje pa se tudi od čipa do čipa. Ker je frekvenca ure LSI torej le približna, čas izberemo z dovolj veliko rezervo.
Registri
Naslovni prostor naprave IWDG1 se začne na naslovu 0x58004800. Spodaj je podan seznam registrov naprave.
| Odmik | Register | Pomen |
|---|---|---|
0x00 |
KR |
Key register: vpis 0xCCCC zažene IWDG, vpis 0xAAAA ga osveži, vpis 0x5555 omogoči pisanje v PR, RLR in WINR |
0x04 |
PR |
Prescaler register: delilnik ure (0 = 4, 1 = 8, …, 6 = 256) |
0x08 |
RLR |
Reload register: začetna vrednost števca (0 do 4095) |
0x0C |
SR |
Status register: zastavice, ki povedo, da se nova vrednost PR, RLR ali WINR še prenaša |
0x10 |
WINR |
Window register: okno za osvežitev (4095 = okno izklopljeno) |
Do registra KR dostopamo s posebnimi ključi. To je zaščita pred nenamernimi vpisi, podobna ključu v registru AIRCR (vaja 4) in zaporedju zaklepanja v registru LCKR (vaja 3).
Uporaba s knjižnico HAL
IWDG_HandleTypeDef iwdg = {0};
iwdg.Instance = IWDG1;
iwdg.Init.Prescaler = IWDG_PRESCALER_64; // en korak = 2 ms
iwdg.Init.Reload = 999; // (999 + 1) * 2 ms = 2 s
iwdg.Init.Window = IWDG_WINDOW_DISABLE; // brez okna
HAL_IWDG_Init(&iwdg); // zažene IWDG
while (1) {
// ... delo programa ...
HAL_IWDG_Refresh(&iwdg); // osvežitev (KR = 0xAAAA)
}Funkcija HAL_IWDG_Init IWDG nastavi in zažene. Funkcija HAL_IWDG_Refresh v register KR vpiše ključ 0xAAAA in tako števec ponovno naloži. Ura LSI se ob zagonu IWDG vklopi sama, zato je ni treba vklapljati posebej.
Window moramo nastaviti
Če Window ne nastavimo (in ima zaradi = {0} vrednost 0), je vklopljen okenski način, v katerem je osvežitev dovoljena le, ko je števec že pod vrednostjo okna. Vsaka osvežitev pred tem je prezgodnja in takoj sproži reset. Zato vedno nastavimo Window = IWDG_WINDOW_DISABLE.
Ko program v razhroščevalniku ustavimo na prekinitveni točki, IWDG šteje naprej in po izteku časa resetira mikrokrmilnik, razhroščevalnik pa izgubi povezavo. Temu se izognemo tako, da IWDG med ustavitvijo jedra zamrznemo z makrojem __HAL_DBGMCU_FREEZE_IWDG1(), ki ga pokličemo pred HAL_IWDG_Init.
Vzrok reseta
Ali je bil zadnji reset posledica watchdoga, ugotovimo z zastavico IWDG1RSTF v registru RCC_RSR. Tako kot pri izzivu s programskim resetom iz vaje 4 zastavice po branju pobrišemo:
if (__HAL_RCC_GET_FLAG(RCC_FLAG_IWDG1RST)) {
// zadnji reset je sprozil watchdog
}
__HAL_RCC_CLEAR_RESET_FLAGS();Naloga
Napišite program, ki:
- ob zagonu preveri, ali je zadnji reset sprožil watchdog, in v tem primeru za eno sekundo prižge rdečo LED,
- zažene IWDG s časom 2 sekundi,
- v glavni zanki utripa z zeleno LED in osvežuje watchdog,
- ob pritisku gumba »obtiči« v neskončni zanki
while (1) {}brez osveževanja.
Kaj se zgodi po pritisku gumba? Koliko časa mine do reseta? Kaj se zgodi, če zakasnitev v zanki za utripanje povečate na HAL_Delay(3000)?