看门狗应用编程

目录

1、设备节点

1.1、/dev/watchdogX

1.2、/dev/watchdog

2、ioctl 指令

2.1、常用ioctl 指令

2.2、WDIOC_GETSUPPORT操作

2.2.1、watchdog_info结构体

2.1.2、选项options

2.3、WDIOC_GETTIMEOUT操作

2.4、WDIOC_SETTIMEOUT操作

2.5、WDIOC_SETOPTIONS操作

2.5.1、选项

2.6、WDIOC_KEEPALIVE指令

3、看门狗应用编程流程

---

1、设备节点

1.1、/dev/watchdogX

Linux 系统中所注册的看门狗外设，都会在/dev/目录下生成对应的设备节点，设备节点名称通常为 watchdogX

1.2、/dev/watchdog

代表系统默认的看门狗设备。

2、ioctl 指令

下面的宏定义在头文件<linux/watchdog.h>中。

#define WDIOC_GETSUPPORT        _IOR(WATCHDOG_IOCTL_BASE, 0, struct watchdog_info)
#define WDIOC_GETSTATUS         _IOR(WATCHDOG_IOCTL_BASE, 1, int)
#define WDIOC_GETBOOTSTATUS     _IOR(WATCHDOG_IOCTL_BASE, 2, int)
#define WDIOC_GETTEMP           _IOR(WATCHDOG_IOCTL_BASE, 3, int)
#define WDIOC_SETOPTIONS        _IOR(WATCHDOG_IOCTL_BASE, 4, int)
#define WDIOC_KEEPALIVE         _IOR(WATCHDOG_IOCTL_BASE, 5, int)
#define WDIOC_SETTIMEOUT        _IOWR(WATCHDOG_IOCTL_BASE, 6, int)
#define WDIOC_GETTIMEOUT        _IOR(WATCHDOG_IOCTL_BASE, 7, int)
#define WDIOC_SETPRETIMEOUT     _IOWR(WATCHDOG_IOCTL_BASE, 8, int)
#define WDIOC_GETPRETIMEOUT     _IOR(WATCHDOG_IOCTL_BASE, 9, int)
#define WDIOC_GETTIMELEFT       _IOR(WATCHDOG_IOCTL_BASE, 10, int)

2.1、常用ioctl 指令

ioctl 指令	说明
WDIOC_GETSUPPORT	获取看门狗支持哪些功能
WDIOC_GETTIMEOUT	获取看门狗超时时间
WDIOC_SETTIMEOUT	设置看门狗超时时间
WDIOC_SETOPTIONS	用于开启或关闭看门狗
WDIOC_KEEPALIVE	喂狗操作

2.2、WDIOC_GETSUPPORT操作

获取看门狗支持哪些功能。

struct watchdog_info info;
ioctl(fd, WDIOC_GETSUPPORT, &info)

2.2.1、watchdog_info结构体

struct watchdog_info {
        __u32 options;          /* Options the card/driver supports */
        __u32 firmware_version; /* Firmware version of the card */
        __u8  identity[32];     /* Identity of the board */
};

字段	说明
options	记录了设备支持哪些功能或选项
firmware_version	记录了设备的固件版本号
identity	描述性字符串

2.1.2、选项options

#define WDIOF_OVERHEAT          0x0001  /* Reset due to CPU overheat */
#define WDIOF_FANFAULT          0x0002  /* Fan failed */
#define WDIOF_EXTERN1           0x0004  /* External relay 1 */
#define WDIOF_EXTERN2           0x0008  /* External relay 2 */
#define WDIOF_POWERUNDER        0x0010  /* Power bad/power fault */
#define WDIOF_CARDRESET         0x0020  /* Card previously reset the CPU */
#define WDIOF_POWEROVER         0x0040  /* Power over voltage */
#define WDIOF_SETTIMEOUT        0x0080  /* Set timeout (in seconds) */
#define WDIOF_MAGICCLOSE        0x0100  /* Supports magic close char */
#define WDIOF_PRETIMEOUT        0x0200  /* Pretimeout (in seconds), get/set */
#define WDIOF_ALARMONLY         0x0400  /* Watchdog triggers a management or
                                           other external alarm not a reboot */
#define WDIOF_KEEPALIVEPING     0x8000  /* Keep alive ping reply */

常见选项	说明
WDIOF_SETTIMEOUT	设备支持设置超时时间
WDIOF_KEEPALIVEPING	设备支持“喂狗”操作

2.3、WDIOC_GETTIMEOUT操作

获取看门狗超时时间。

ioctl(fd, WDIOC_GETTIMEOUT,&timeout);

2.4、WDIOC_SETTIMEOUT操作

设置看门狗超时时间。

ioctl(fd, WDIOC_SETTIMEOUT,&timeout);

2.5、WDIOC_SETOPTIONS操作

使用 WDIOC_SETOPTIONS 指令可以开启或停止看门狗。

ioctl(fd, WDIOC_SETOPTIONS,&option);

2.5.1、选项

#define WDIOS_DISABLECARD       0x0001  /* Turn off the watchdog timer */
#define WDIOS_ENABLECARD        0x0002  /* Turn on the watchdog timer */

宏	说明
WDIOS_DISABLECARD	停止看门狗
WDIOS_ENABLECARD	开启看门狗

2.6、WDIOC_KEEPALIVE指令

WDIOC_KEEPALIVE 指令用于喂狗。

ioctl(fd, WDIOC_KEEPALIVE, NULL);

3、看门狗应用编程流程

1）open()函数打开看门狗

2）使用WDIOC_GETSUPPORT获取看门狗支持哪些功能

3）使用WDIOC_SETOPTIONS指令停止看门狗

4）对看门狗进行设置（如设置超时时间）

5）使用WDIOC_SETOPTIONS指令开启看门狗

9）使用WDIOC_KEEPALIVE指令喂狗