本文主要是介绍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 所示。
图 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
登录大大通，了解更多详情，解锁1500+完整应用方案，更有大联大700+FAE在线答疑解惑！
这篇关于SemiDrive E3 MCAL 开发系列（3）– Wdg 模块的使用的文章就介绍到这儿，希望我们推荐的文章对编程师们有所帮助！
