RT-Thread-WATCHDOG设备驱动开发RT-Thread问答社区

WATCHDOG设备驱动开发

发布于 2025-01-02 15:24:14 浏览：44 订阅该版

[tocm]

# WatchDog设备驱动开发
WDT (WatchDog Timer，看门狗定时器)，看门狗从本质上来说就是一个带定时器的硬件复位电路。它一般有一个输入和一个输出，其中输入的操作叫作喂狗，输出一般连接着另外一部分(一般是单片机)的复位端。看门狗的功能是在定时器的计时时间到达阈值后发出重启信号，如果系统是正常运行的，则可以定时更新定时器的计时时间，以避免看门狗发出重启信号。因此对看门狗的基本操作包含初始化、设置溢出阈值、隔段时间喂狗(更新看门狗定时器计时时间)。
## 开启WatchDog设备驱动

![screenshot_图片.png](https://oss-club.rt-thread.org/uploads/20250102/0ee0c669329e0926ae31dc6055873c0b.png)

![screenshot_图片.png](https://oss-club.rt-thread.org/uploads/20250102/ca3e1cebee8c5d7e868606223574dc8a.png.webp)

![screenshot_图片.png](https://oss-club.rt-thread.org/uploads/20250102/f9f58e756641a7a098b90c745ccea986.png)
配置完成之后，执行Scons命令

![screenshot_图片.png](https://oss-club.rt-thread.org/uploads/20250102/df77c11c9eb261b69a73fe726bcdd66c.png)
成功之后，工程内就会添加好了watchdog.c设备驱动代码。

![screenshot_图片.png](https://oss-club.rt-thread.org/uploads/20250102/e018da5c537efd8d48fe1c4792b1e808.png)
## WatchDog外设驱动添加
打开“\dist\project\board\CubeMX_Config”目录下CubeMx工程文件
使能看门狗，并生成代码

![screenshot_图片.png](https://oss-club.rt-thread.org/uploads/20250102/d04ebc219189c79f388fc4551729ad0c.png.webp)

![screenshot_图片.png](https://oss-club.rt-thread.org/uploads/20250102/a1bdb7514909f1abb5c58e12daf9af04.png.webp)
## 修改Kconfig文件
打开 board 文件夹下的 Konfig 文件，拷贝 GPIO 的配置项，并重命名 GPIO为 WDT。

![screenshot_图片.png](https://oss-club.rt-thread.org/uploads/20250102/10a23e8a9ca19348fa43b4881e1be159.png.webp)
menuconfig配置使能WDT：

![screenshot_图片.png](https://oss-club.rt-thread.org/uploads/20250102/ec5f91a999738fb263fc3edee70789b3.png)

![screenshot_图片.png](https://oss-club.rt-thread.org/uploads/20250102/63d62c3526b46867f7ce8f37cd22215b.png)

![screenshot_图片.png](https://oss-club.rt-thread.org/uploads/20250102/003efba36561f0ba498a040b792dc9a8.png)
Scons编译之后在Drivers目录下多出drv_wdt.c文件

![screenshot_图片.png](https://oss-club.rt-thread.org/uploads/20250102/46741de579e88a3fa59b2c3067b21321.png)
## 添加看门狗测试实例
在applications文件夹下添加测试实例代码iwdg_sample.c

```c
/*
 * Copyright (c) 2006-2022, RT-Thread Development Team
 *
 * SPDX-License-Identifier: Apache-2.0
 *
 * Change Logs:
 * Date           Author       Notes
 * 2018-09-25     misonyo      first edition.
 */
/*
 * 程序清单：这是一个独立看门狗设备使用例程
 * 例程导出了 iwdg_sample 命令到控制终端
 * 命令调用格式：iwdg_sample iwg
 * 命令解释：命令第二个参数是要使用的看门狗设备名称，为空则使用例程默认的看门狗设备。
 * 程序功能：程序通过设备名称查找看门狗设备，然后初始化设备并设置看门狗设备溢出时间。
 *           然后设置空闲线程回调函数，在回调函数里会喂狗。
*/

#include <rtthread.h>
#include <rtdevice.h>

#define IWDG_DEVICE_NAME    "wdt"    /* 看门狗设备名称 */

static rt_device_t wdg_dev;         /* 看门狗设备句柄 */

static void idle_hook(void)
{
    /* 在空闲线程的回调函数里喂狗 */
    rt_device_control(wdg_dev, RT_DEVICE_CTRL_WDT_KEEPALIVE, NULL);
//    rt_kprintf("feed the dog!\n ");
}

static int iwdg_sample(int argc, char *argv[])
{
    rt_err_t ret = RT_EOK;
    rt_uint32_t timeout = 10;    /* 溢出时间 10 秒 */
    char device_name[RT_NAME_MAX];

/* 判断命令行参数是否给定了设备名称 */
    if (argc == 2)
    {
        rt_strncpy(device_name, argv[1], RT_NAME_MAX);
    }
    else
    {
        rt_strncpy(device_name, IWDG_DEVICE_NAME, RT_NAME_MAX);
    }
    /* 根据设备名称查找看门狗设备，获取设备句柄 */
    wdg_dev = rt_device_find(device_name);
    if (!wdg_dev)
    {
        rt_kprintf("find %s failed!\n", device_name);
        return -RT_ERROR;
    }
    /* 初始化设备 */
    ret = rt_device_init(wdg_dev);
    if (ret != RT_EOK)
    {
        rt_kprintf("initialize %s failed!\n", device_name);
        return -RT_ERROR;
    }
    /* 设置看门狗溢出时间 */
    ret = rt_device_control(wdg_dev, RT_DEVICE_CTRL_WDT_SET_TIMEOUT, &timeout);
    if (ret != RT_EOK)
    {
        rt_kprintf("set %s timeout failed!\n", device_name);
        return -RT_ERROR;
    }
    ret = rt_device_control(wdg_dev, RT_DEVICE_CTRL_WDT_START, RT_NULL);
    if (ret != RT_EOK)
    {
        rt_kprintf("start %s failed!\n", device_name);
        return -RT_ERROR;
    }
    /* 设置空闲线程回调函数 */
    rt_thread_idle_sethook(idle_hook);

return ret;
}
/* 导出到 msh 命令列表中 */
MSH_CMD_EXPORT(iwdg_sample, iwdg sample);

```
## 注意事项
1-注意要将CubeMx生成的系统时钟初始化函数，copy到board.c里面。否则工程中的时钟将初始化失败

![screenshot_图片.png](https://oss-club.rt-thread.org/uploads/20250102/ecddd28769bfa03bd28b3fba7da41ee4.png)

![screenshot_图片.png](https://oss-club.rt-thread.org/uploads/20250102/3ddf3a46a26cf9799ff0c4d1c57f9742.png.webp)