Nordic 外设篇：WDT

1. 概述

WDT的全称为看门狗定时器（Watch Dog Timer）。为nRF52832、nRF52840的外设。
WDT的核心为一个递减的定时器。当计数值为0时，产生timeout中断，并复位芯片。

2. 功能添加

2.1 源码文件

WDT所需的源码文件如下所示。

modules\nrfx\drivers\src\nrfx_wdt.c
modules\nrfx\drivers\include\nrfx_wdt.h
integration\nrfx\legacy\nrf_drv_wdt.h
modules\nrfx\hal\nrf_wdt.h

2.2 宏定义

在sdk_config.h文件中，修改WDT对应的宏定义，属于nRF_Drivers类。
WDT超时时间由WDT_CONFIG_RELOAD_VALUE定义，单位为毫秒。此宏定义为初始配置超时时间，可在WDT初始化时，代码修改超时时间。

//  WDT_ENABLED - nrf_drv_wdt - WDT peripheral driver - legacy layer
//==========================================================
#ifndef WDT_ENABLED
#define WDT_ENABLED 1
#endif
//  WDT_CONFIG_BEHAVIOUR  - WDT behavior in CPU SLEEP or HALT mode
 
// <1=> Run in SLEEP, Pause in HALT 
// <8=> Pause in SLEEP, Run in HALT 
// <9=> Run in SLEEP and HALT 
// <0=> Pause in SLEEP and HALT 

#ifndef WDT_CONFIG_BEHAVIOUR
#define WDT_CONFIG_BEHAVIOUR 1
#endif

//  WDT_CONFIG_RELOAD_VALUE - Reload value  <15-4294967295> 


#ifndef WDT_CONFIG_RELOAD_VALUE
#define WDT_CONFIG_RELOAD_VALUE 2000
#endif

//  WDT_CONFIG_IRQ_PRIORITY  - Interrupt priority
 

//  Priorities 0,2 (nRF51) and 0,1,4,5 (nRF52) are reserved for SoftDevice
// <0=> 0 (highest) 
// <1=> 1 
// <2=> 2 
// <3=> 3 
// <4=> 4 
// <5=> 5 
// <6=> 6 
// <7=> 7 

#ifndef WDT_CONFIG_IRQ_PRIORITY
#define WDT_CONFIG_IRQ_PRIORITY 6
#endif

// 

2.3 应用代码

WDT应用代码如下所示。

#include "nrf_drv_wdt.h"

nrf_drv_wdt_channel_id m_channel_id;

void wdt_feed(void)
{
    // feed watch dog
    nrf_drv_wdt_channel_feed(m_channel_id);
}

/**
 * @brief WDT events handler.
 */
void wdt_event_handler(void)
{
    bsp_board_leds_off();

    //NOTE: The max amount of time we can spend in WDT interrupt is two cycles of 32768[Hz] clock - after that, reset occurs
}

void wdt_init(void)
{
    // Configure WDT.
    nrf_drv_wdt_config_t config = NRF_DRV_WDT_DEAFULT_CONFIG;
    err_code = nrf_drv_wdt_init(&config, wdt_event_handler);
    APP_ERROR_CHECK(err_code);
    err_code = nrf_drv_wdt_channel_alloc(&m_channel_id);
    APP_ERROR_CHECK(err_code);
    nrf_drv_wdt_enable();
}

附A：说明

Nordic SDK在设置看门狗的CRV值时，存在一个溢出漏洞。存在漏洞的源码为nrfx_wdt.c文件的nrfx_wdt_init接口。漏洞语句如下所示。

    nrf_wdt_reload_value_set((p_config->reload_value * 32768) / 1000);

以上计算中，p_config->reload_value的值默认为WDT_CONFIG_RELOAD_VALUE宏的的值。此宏的定义如下所示，为看门狗超时时间毫秒值，取值范围为15-4294967295。但数值超过131072（131秒）后，再乘以32768后，就产生了溢出。

//  WDT_CONFIG_RELOAD_VALUE - Reload value  <15-4294967295> 
#ifndef WDT_CONFIG_RELOAD_VALUE
#define WDT_CONFIG_RELOAD_VALUE 120000
#endif

此问题在15.2、15.3版本的SDK中都存在。项目应用中，当超时时间小于131秒时，完全没有问题。但要想使用更长的超时时间，可按照如下修改SDK代码。

    nrf_wdt_reload_value_set((p_config->reload_value * 3277) / 100);

    nrf_wdt_reload_value_set((p_config->reload_value * 328) / 10);