SemiDrive E3 MCAL 开发系列（3）

SemiDrive E3 MCAL 开发系列（3）– Wdg 模块的使用

一、概述

本文将会介绍 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 所示。