[rtthread设备]系列文章
【rtthread设备】第零篇:IO设备
【rtthread设备】第一篇:pin设备
【rtthread设备】第二篇:rtc设备
【rtthread设备】第三篇:adc设备
【rtthread设备】第五篇:hwtimer设备
【rtthread设备】第六篇:i2c设备
【rtthread设备】第七篇:spi设备
【rtthread设备】第八篇:看门狗设备
一、watchdog设备概念
看门狗启动后,可以在空闲线程或者关键任务喂狗,在产品化的嵌入式系统保证在系统异常时能够自动复位。
二、watchdog设备api
//查找设备
/*
name:设备名称,一般为wdt
*/
rt_device_t rt_device_find(const char* name);
//初始化看门狗
/*
看门狗句柄
*/
rt_err_t rt_device_init(rt_device_t dev)
//控制看门狗
/*
dev:看门狗句柄
cmd:控制命令,可取
#define RT_DEVICE_CTRL_WDT_GET_TIMEOUT (1) /* 获 取 溢 出 时 间 */
#define RT_DEVICE_CTRL_WDT_SET_TIMEOUT (2) /* 设 置 溢 出 时 间 */
#define RT_DEVICE_CTRL_WDT_GET_TIMELEFT (3) /* 获 取 剩 余 时 间 */
#define RT_DEVICE_CTRL_WDT_KEEPALIVE (4) /* 喂 狗 */
#define RT_DEVICE_CTRL_WDT_START (5) /* 启 动 看 门 狗 */
#define RT_DEVICE_CTRL_WDT_STOP (6) /* 停 止 看 门 狗 */
arg:控制命令参数
*/
rt_err_t rt_device_control(rt_device_t dev, rt_uint8_t cmd, void* arg);
//关闭看门狗
/*
dev:看门狗句柄
*/
rt_err_t rt_device_close(rt_device_t dev);
三、wotchdog设备示例
/*
* Copyright (c) 2006-2018, 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 "iwg" /* 看门狗设备名称 */
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 = 1000; /* 溢出时间 */
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;
}
/* 设置空闲线程回调函数 */
rt_thread_idle_sethook(idle_hook);
return ret;
}
/* 导出到 msh 命令列表中 */
MSH_CMD_EXPORT(iwdg_sample, iwdg sample);