WDG 驱动

[English]

概述

WDG（Watchdog）看门狗是一种硬件定时器，用于监控系统运行状态，防止系统死锁或异常。当系统在预定时间内没有喂狗时，看门狗会自动复位系统，确保系统可靠性。

功能描述

定时监控：支持定时监控系统运行状态
自动复位：支持超时自动复位系统
启动停止：支持看门狗的启动和停止控制
喂狗功能：支持定期喂狗防止复位
时间管理：支持喂狗时间设置和获取
状态查询：支持看门狗状态查询
低功耗：支持低功耗模式下的看门狗管理

开发指引

初始化流程 - 调用 bk_wdt_driver_init() 初始化看门狗驱动 - 设置看门狗超时时间 - 调用 bk_wdt_start() 启动看门狗 - 在应用中定期调用 bk_wdt_feed() 喂狗
基本使用 - 使用 bk_wdt_start() 启动看门狗 - 使用 bk_wdt_feed() 定期喂狗 - 使用 bk_wdt_stop() 停止看门狗 - 使用 bk_wdt_set_feed_time() 设置喂狗时间
时间管理 - 使用 bk_wdt_get_feed_time() 获取当前喂狗时间 - 使用 bk_wdt_set_feed_time() 设置新的喂狗时间 - 根据应用需求调整喂狗间隔
状态监控 - 使用 bk_wdt_driver_inited() 检查驱动状态 - 监控看门狗运行状态 - 处理看门狗复位事件

注意事项

确保在调用其他 WDT API 前先调用 bk_wdt_driver_init()
喂狗时间必须小于看门狗超时时间
不要在中断服务函数中喂狗
注意看门狗复位的副作用
低功耗模式下看门狗可能被关闭，需要重新初始化
系统复位后看门狗状态会重置

API 说明

主要 API 函数：

bk_wdt_driver_init() - 初始化看门狗驱动
bk_wdt_driver_deinit() - 反初始化看门狗驱动
bk_wdt_start() - 启动看门狗
bk_wdt_stop() - 停止看门狗
bk_wdt_feed() - 喂狗
bk_wdt_get_feed_time() - 获取喂狗时间
bk_wdt_set_feed_time() - 设置喂狗时间
bk_wdt_driver_inited() - 检查驱动是否初始化

示例代码

基本使用示例：

#include <driver/wdt.h>

void wdt_example(void)
{
    // 初始化看门狗驱动
    bk_wdt_driver_init();

    // 启动看门狗，超时时间 5 秒
    bk_wdt_start(5000);

    // 在主循环中定期喂狗
    while (1) {
        // 执行应用逻辑
        // ...

        // 喂狗
        bk_wdt_feed();

        // 延时
        rtos_delay_milliseconds(1000);
    }
}

时间管理示例：

void wdt_time_management_example(void)
{
    // 启动看门狗
    bk_wdt_start(10000);  // 10 秒超时

    // 设置喂狗时间为 5 秒
    bk_wdt_set_feed_time(5000);

    // 获取当前喂狗时间
    uint32_t feed_time = bk_wdt_get_feed_time();
    printf("Feed time: %d ms\n", feed_time);

    // 定期喂狗
    while (1) {
        // 执行应用逻辑
        // ...

        // 喂狗
        bk_wdt_feed();

        // 延时
        rtos_delay_milliseconds(2000);
    }
}

状态检查示例：

void wdt_status_example(void)
{
    // 检查驱动是否初始化
    if (bk_wdt_driver_inited()) {
        printf("WDT driver initialized\n");
    }

    // 启动看门狗
    bk_wdt_start(8000);

    // 设置喂狗时间
    bk_wdt_set_feed_time(3000);

    // 获取喂狗时间
    uint32_t feed_time = bk_wdt_get_feed_time();
    printf("Current feed time: %d ms\n", feed_time);
}

任务管理示例：

static void wdt_task(void *arg)
{
    while (1) {
        // 喂狗
        bk_wdt_feed();

        // 延时 1 秒
        rtos_delay_milliseconds(1000);
    }
}

void wdt_task_example(void)
{
    // 初始化看门狗驱动
    bk_wdt_driver_init();

    // 启动看门狗
    bk_wdt_start(3000);

    // 创建喂狗任务
    rtos_create_thread(NULL, 5, "wdt", wdt_task, 1024, NULL);
}

常见问题

系统频繁复位：检查喂狗时间设置、喂狗频率
看门狗不工作：确认驱动初始化、启动状态
喂狗失败：检查 API 调用顺序、参数设置
时间设置错误：确认喂狗时间小于超时时间

实战示例

系统任务统一定期喂狗

static void wdt_task(void *arg) {
    while (1) {
        bk_wdt_feed();
        rtos_delay_milliseconds(1000);
    }
}
bk_wdt_driver_init();
bk_wdt_start(3000);
rtos_create_thread(NULL, 5, "wdt", wdt_task, 1024, NULL);

常见错误码说明

BK_ERR_WDT_DRIVER_NOT_INIT：未初始化驱动即调用接口
BK_ERR_WDT_INVALID_PERIOD：启动超时时间非法