一、  概述

本文将会介绍 SemiDrive E3 MCAL Wdg 模块的基本配置，并且会结合实际操作的介绍，帮助新手快速了解并掌握这个模块的使用，文中的 MCAL 是基于 PTG3.0 的版本，开发板是官方的 E3640 网关板。

二、  Wdg 模块的主要配置

Wdg 模块的配置主要有两大部分，一个是通用配置，另一个是针对每个 Wdg 实例的配置，我们先看通用配置，具体配置如图 2.1 所示。

                                                                    图 2.1 Wdg 模块通用配置

关于以上配置选项的说明如下：

• WdgDevErrorDetect：勾选决定是否使能 Wdg 模块的 Dev 错误检测功能
• WdgDisableAllowed：勾选决定是否允许关闭看门狗功能
• WdgInitialTimeout：配置看门狗的初始超时时间，单位为秒，最大可以配置为 65.535 秒
• WdgMaxTimeout：配置看门狗的最大超时时间，单位为秒，最大可以配置为 65.535 秒，Det 检查时会用到。
• WdgRunArea，该功能目前不支持，不需配置。

接着针对每个 Wdg 实例进行配置，首先添加 Wdg 实际，操作如图 2.2 所示。

                                                                              图 2.2 添加 Wdg 实例

接着如图 2.3 所示，进入 Wdg 具体实例的配置界面。

                                                              图 2.3 进入 Wdg 实例配置界面

如图 2.4 和图 2.5 所示为 Wdg 实例的配置界面，

                                                                     图 2.4 Wdg 模块实例配置一

                                                                                图 2.5 Wdg 模块实例配置二

具体每个配置项的作用如下：

• WdgChannelId：这个是自增的 ID，用户无需修改，改了会报错
• WdgDefaultMode：该 Wdg 模块调用初始化接口后的默认工作模式，总共有三种可以选择，WDGIF_FAST_MODE 和 WDGIF_SLOW_MODE 这两种模式本质上没有区别，对应两套配置，这两套配置的参数都是独立的，具体如图 2.5 所示。看门狗初始化后超时时间参数还是 WdgInitialTimeout 配置的时间，如果需要使用 Fast/Slow 模式下的时间参数，可以调用 Wdg_140_Instance(x)_Wdg_SetMode() 或者 Wdg_140_Instance(x)_SetTriggerCondition()。 除此之外还有 WDGIF_OFF_MODE，该模式会把超时值设置为 0，而 Wdg 是从 1 开始计数的，因此 0 永远不能达到，故不会发生超时。
• WdgInstanceIndex：选择使用哪个看门狗
• WdgTimeoutNotification：看门狗的中断回调函数
• WdgExternalSignalApi：可以配置一个 Gpio，超时后电平从高拉到低
• WdgClockFrequency：Wdg 的时钟，为 24MHz，不可修改
• WdgTimeoutPreiod：Fast/Slow 模式下的超时时间，单位为 ms。
• WdgTimeoutBehavior：Wdg 模块超时后的行为，可以选择复位、中断、或者两者都执行。
• WdgTiggerCondition：可以配置为 NO_CONDITION_MODE 或者 WINDOW_BASED_MODE，前者为普通模式，后者为窗口模式。
• WdgRefleshTime：用来配置窗口模式的时间，超过这个值才可以进行喂狗，单位为 ms，最大可以配置为 65535。

三、  实际操作

下面我们基于 MCAL 3.0 的例程来进行 Wdg 模块的验证，基于我们上面的 Wdg 模块配置，我们配置 Wdg4 的超时时间为 1200 ms，触发动作为中断，我们在例程中对 Wdg4 进行初始化并且设置为 Fast 模式，然后不进行喂狗，这样的话会每 1.2 s 进入一次中断函数，我们在中断回调函数中进行打印，具体测试代码如图 3.1 所示。

                                                                            图 3.1 看门狗的测试代码

接着进行实际操作，将代码烧录到板子后启动运行，在串口终端中输入命令“runcase 1500”，此时会运行 sint32_Wdg4_irq_test1 这个函数，可以看到串口会每隔 1.2 s 打印一次 WDT4_IRQ，如图 3.2 所示。

                                                                                   图 3.2 串口打印

四、  使用注意事项

E3 的 Wdg 模块在使用上有以下注意事项：

• E3 系列 MCU 最多支持 7 个 WatchDog，其中 WatchDog1~6 支持中断和重启，WatchDog8 只支持中断。
• 当触发重启操作时，除了 RTC 域以外其他域全部重新上电。
• 当 WdgTimeoutBehavior 模式选择为 Both 时，在系统重启前会先触发中断，中断和重启之间的间隔是固定的，大约 7 ms。
• 每个看门狗只允许在一个核中运行，禁止调用其他核的看门狗。
• 在窗口模式下，如果没有在窗口内喂狗会失败，并且没有提示信息。
• 如果某路看门狗未配置，禁止调用这路看门狗的任何接口
• Wdg 的时钟取决于 FS_24M 的配置，如果配置为 RC，看门狗时钟为 RC 24M，如果配置为 FS_24M，则看门狗时钟为外部晶振 24M。

五、  参考资料

1.《Semidrive_Wdg_User_Manual.pdf》，2022.05

2.《SemiDrive_E3_MCAL_User_Guide_Rev03.00.pdf》，2023.08