第八章 WDT看门狗-K230系统可靠性的最后防线

🎯 本章目标：
理解看门狗（WDT）的工作原理，掌握 K230 MicroPython 中 WDT 模块的使用方法，学会在嵌入式系统中通过看门狗实现自动复位、故障恢复、系统监护，提升程序的鲁棒性与可靠性。

---

1. 看门狗基础概念

1.1 什么是 WDT？

WDT（Watchdog Timer，看门狗定时器） 是一种硬件定时器，用于检测和恢复程序“卡死”或“跑飞”状态。

• 核心机制：程序必须在规定时间内“喂狗”（重置定时器）
• 一旦超时未喂狗 → 看门狗触发 系统复位
• 形象比喻：程序员是“狗主人”，“不按时喂狗”就会被“咬一口”（重启）

---

1.2 为什么需要看门狗？

在嵌入式系统中，程序可能因以下原因陷入死循环或卡死：

• 外设无响应（如 I2C 挂死）
• 内存耗尽（MemoryError）
• 硬件故障
• 逻辑死锁

✅ 看门狗的作用：

• 自动检测程序异常
• 强制重启系统，恢复功能
• 无需人工干预，适合无人值守设备（如物联网终端、工业控制器）

---

2. K230 WDT 系统架构

2.1 硬件特性

K230 集成独立的 硬件看门狗 模块，特点：

• 独立时钟源：即使主系统时钟异常，仍可工作
• 不可屏蔽：一旦启动，仅复位或喂狗可停止
• 超时后强制复位 CPU
• 支持可配置超时时间（如 1s ~ 60s）

⚠️ 注意：
看门狗一旦启用，必须周期性“喂狗”，否则系统将不断重启！

---

2.2 MicroPython 中的 WDT 模块

from machine import WDT

📌 兼容性说明：
并非所有 MicroPython 移植版本都支持 WDT 模块。K230 的支持情况取决于固件是否启用看门狗驱动。

---

3. WDT API 详解

3.1 构造函数

wdt = WDT(timeout=5000)

参数	说明
timeout	超时时间（单位：毫秒 ms）

✅ 典型值：

• 1000：1秒，响应快但易误触发
• 5000：5秒，推荐用于大多数应用
• 10000：10秒，适用于复杂任务

---

3.2 主要方法

方法	说明
wdt.feed()	“喂狗” —— 重置看门狗计时器
wdt.deinit()	（部分平台支持）停止看门狗

⚠️ 重要：
feed() 必须在 timeout 时间内调用一次，否则系统复位。

---

4. 实战项目一：基础看门狗启用

from machine import WDT
import utime

# === 1. 启动看门狗（5秒超时）===
wdt = WDT(timeout=5000)
print("看门狗已启用，每3秒喂一次")

# === 2. 主循环 ===
counter = 0
while True:
    counter += 1
    print(f"工作循环 #{counter}")

    # 模拟正常工作
    utime.sleep(3)

    # ✅ 喂狗（必须在 5s 内）
    wdt.feed()

✅ 效果：系统稳定运行，每 3 秒喂狗一次，不会重启。

---

5. 实战项目二：模拟故障与自动恢复

from machine import WDT
import utime

wdt = WDT(timeout=5000)
print("看门狗已启用，程序将在第3次循环后卡死")

counter = 0
while True:
    counter += 1
    print(f"运行中... #{counter}")

    utime.sleep(2)
    wdt.feed()  # 正常喂狗

    # 模拟程序卡死（第3次后不再喂狗）
    if counter == 3:
        print("⚠️ 程序故障：进入死循环或卡死")
        while True:
            pass  # 永不喂狗，等待看门狗复位

🔁 预期行为：
约 5 秒后系统自动复位，重新启动，输出：

看门狗已启用...
运行中... #1
运行中... #2
运行中... #3
⚠️ 程序故障：...
[约5秒后自动重启]
看门狗已启用...

---

6. 实战项目三：看门狗 + 任务健康检查

6.1 场景：确保关键任务正常运行

假设你有一个任务负责读取传感器，如果该任务“卡住”，即使主循环还在运行，系统也已失效。

6.2 完整代码

from machine import WDT, ADC
from fpioa_manager import fm
import utime

# === 1. 初始化 ADC ===
fm.register(14, fm.fpioa.ADC0)
adc = ADC(ADC.ADC0)

# === 2. 启动看门狗（8秒）===
wdt = WDT(timeout=8000)
print("看门狗 + 健康检查已启动")

# === 3. 共享状态 ===
last_adc_read = 0  # 上次读取时间（ticks）
max_interval = 5000  # 最大允许间隔（5秒）

def read_sensor():
    global last_adc_read
    try:
        value = adc.read()
        print(f"ADC值: {value}")
        last_adc_read = utime.ticks_ms()
    except Exception as e:
        print("ADC读取异常:", e)

# === 4. 主循环 ===
while True:
    # 执行任务
    read_sensor()

    # 健康检查：如果太久没读取ADC，认为系统异常
    now = utime.ticks_ms()
    if utime.ticks_diff(now, last_adc_read) > max_interval:
        print("❌ 健康检查失败：ADC任务未运行")
        # ❌ 不喂狗，等待复位
    else:
        # ✅ 喂狗
        wdt.feed()
        print("✅ 喂狗")

    utime.sleep(2)

✅ 优势：
不仅监控程序是否运行，还监控关键任务是否正常执行，实现“智能看门狗”。

---

7. 高级技巧与工程实践

7.1 看门狗启用时机

建议在系统初始化完成、外设配置好后再启用看门狗：

# 初始化所有外设...
init_system()
init_sensors()
init_communication()

# 最后一步：启用看门狗
wdt = WDT(timeout=5000)
print("系统就绪，看门狗启动")

❌ 错误做法：过早启用，初始化耗时导致首次喂狗超时。

---

7.2 与定时器配合（非阻塞喂狗）

避免在 sleep 前喂狗，应使用定时器周期性喂狗：

from machine import Timer, WDT

wdt = WDT(timeout=5000)

def feed_watchdog(timer):
    wdt.feed()
    print(f"看门狗喂狗 @ {utime.ticks_ms()}")

# 每 3 秒自动喂狗
Timer(Timer.TIMER0, Timer.CHANNEL0,
      mode=Timer.MODE_PERIODIC,
      period=3000,
      callback=feed_watchdog)

# 主循环可处理其他任务
while True:
    # 传感器、通信等
    utime.sleep_ms(1000)

---

7.3 故障日志记录（重启前）

如果支持，可在复位前保存日志：

import machine  # 提供 reset_cause()

# 检查复位原因
cause = machine.reset_cause()
if cause == machine.WDT_RESET:
    print("上次复位由看门狗触发！")
elif cause == machine.PWRON_RESET:
    print("上电启动")

⚠️ 注意：K230 MicroPython 是否支持 reset_cause() 请查证。

---

8. 常见问题与调试

❌ 问题1：系统不断重启

原因：

• 看门狗启用后未喂狗
• 喂狗周期 > 超时时间
• 初始化耗时过长

解决：

• 检查 wdt.feed() 是否被调用
• 增大 timeout 值测试
• 延迟启用看门狗

---

❌ 问题2：看门狗不生效

排查：

• 固件是否支持 WDT 模块？
• 是否正确导入和创建？
• 超时时间设置是否合理？

---

❌ 问题3：喂狗操作被阻塞

原因：

• 程序进入死循环
• 外设通信挂死（如 UART 等待响应）
• 中断禁用时间过长

解决：

• 设置通信超时
• 使用非阻塞方式
• 关键路径加入喂狗

---

9. 性能与限制

参数	K230 MicroPython 限制
超时范围	通常 1s ~ 60s
精度	依赖内部低速时钟，±10%
是否支持暂停	否（一旦启用，只能复位或喂狗）
复位类型	CPU 复位（非断电）

💡 建议：

• 超时时间设置为最长任务执行时间的 1.5~2 倍
• 关键任务中穿插喂狗
• 生产环境必须启用看门狗

---

✅ 本章你已掌握：

• 看门狗的工作原理与重要性
• K230 MicroPython 中 WDT 的启用与喂狗
• 故障模拟与自动恢复
• 健康检查与工程最佳实践
• 常见问题排查

---