blob: 172c7ece9f2a14f0f45fc8385c1edafe02830a62 (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
|
.. highlight:: c
.. _libmaple-iwdg:
``<libmaple/iwdg.h>``
=====================
Independent Watchdog (IWDG) support. The IWDG peripheral is common
across supported targets, so everything documented here is portable.
.. contents:: Contents
:local:
Usage Note
----------
To use the independent watchdog, first call :ref:`iwdg_init()
<libmaple-iwdg-iwdg_init>` with the appropriate prescaler and IWDG
counter reload values for your application. Afterwards, you must
periodically call :ref:`iwdg_feed() <libmaple-iwdg-iwdg_feed>` before
the IWDG counter reaches zero to reset the counter to its reload
value. If you do not, the chip will reset.
Once started, the independent watchdog cannot be turned off.
Devices
-------
None at this time.
Functions
---------
.. _libmaple-iwdg-iwdg_init:
.. doxygenfunction:: iwdg_init
.. _libmaple-iwdg-iwdg_feed:
.. doxygenfunction:: iwdg_feed
Types
-----
.. doxygenenum:: iwdg_prescaler
Register Maps
-------------
The register map is common on all supported targets. The base pointer
is ``IWDG_BASE``.
.. doxygendefine:: IWDG_BASE
.. doxygenstruct:: iwdg_reg_map
Register Bit Definitions
------------------------
Register bit definitions are common on all supported targets. They are
given as source code.
::
/* Key register */
#define IWDG_KR_UNLOCK 0x5555
#define IWDG_KR_FEED 0xAAAA
#define IWDG_KR_START 0xCCCC
/* Prescaler register */
#define IWDG_PR_DIV_4 0x0
#define IWDG_PR_DIV_8 0x1
#define IWDG_PR_DIV_16 0x2
#define IWDG_PR_DIV_32 0x3
#define IWDG_PR_DIV_64 0x4
#define IWDG_PR_DIV_128 0x5
#define IWDG_PR_DIV_256 0x6
/* Status register */
#define IWDG_SR_RVU_BIT 1
#define IWDG_SR_PVU_BIT 0
#define IWDG_SR_RVU (1U << IWDG_SR_RVU_BIT)
#define IWDG_SR_PVU (1U << IWDG_SR_PVU_BIT)
|