菜单
On-chip watchdog timer for TuyaOpen using the tkl_watchdog API: init with a timeout, then refresh ("feed") periodically so the MCU doesn't reset. 看门狗、watchdog、喂狗、复位保护、超时复位、tkl_watchdog、防死机。
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
End-to-end IoT product development orchestration for TuyaOpen projects. Guides from requirements gathering → Tuya Platform product/DP creation → complete embedded firmware generation. State-machine: detects project state and picks up from wherever development currently stands.
TDL audio codec usage for TuyaOpen: discover the audio device, capture microphone PCM frames via callback, play PCM back to the speaker, and set volume. 音频、麦克风、录音、播放、喇叭、扬声器、speaker、mic、声音、语音、codec。
TDL button input handling for TuyaOpen: create button, register event callbacks for single click, double click, long press, and multi-click. 按键、单击、双击、长按、多击、按键事件。
TDL camera control for TuyaOpen: find device, configure resolution/fps/format, open with frame callbacks for YUV422 and JPEG/H264 encoded output. 摄像头、相机、拍照、视频流、YUV、JPEG、H264、人脸识别、图像采集。
TDL display control for TuyaOpen: driver registration, open, brightness, and framebuffer flush via tdl_disp_* APIs. 显示屏、LCD、屏幕、显示、绘制、亮度、刷屏。
TDL thermal printer usage for TuyaOpen: discover the printer, print UTF-8 text (auto GBK conversion on ESC/POS), print 1-bit bitmaps, feed paper, and monitor paper/temperature status. 打印机、热敏打印、打印、小票、票据、出纸、ESC/POS、printer、DP48A。
| name | tuyaopen/onchip-watchdog |
| description | On-chip watchdog timer for TuyaOpen using the tkl_watchdog API: init with a timeout, then refresh ("feed") periodically so the MCU doesn't reset. 看门狗、watchdog、喂狗、复位保护、超时复位、tkl_watchdog、防死机。 |
| when_to_use | Use when the user wants a hardware watchdog: auto-reset the MCU if the firmware hangs, by feeding it on a healthy heartbeat. |
| id | onchip-watchdog |
| surfaces | ["embedded"] |
| tags | ["watchdog","wdt","reset","on-chip","tkl_watchdog"] |
CONFIG_ENABLE_WATCHDOG. No app_default.config change.board_register_hardware(). Call tkl_watchdog_* directly. There is a single
system watchdog (no instance id / pins) — record as onchip:watchdog in
used-peripherals.json if you want it on the diagram.tkl_watchdog_init() returns the actual refresh interval the hardware granted
(may differ from what you asked). Refresh before that interval elapses, from a
point that only runs when the firmware is healthy.
#include "tal_api.h"
#include "tkl_watchdog.h"
#define WDT_TIMEOUT_MS 10000
void app_watchdog_start(void)
{
TUYA_WDOG_BASE_CFG_T cfg = { .interval_ms = WDT_TIMEOUT_MS };
uint32_t actual_ms = tkl_watchdog_init(&cfg); /* hardware-granted interval */
PR_NOTICE("watchdog interval = %u ms", actual_ms);
}
/* Call this well within the interval, on your healthy heartbeat (e.g. main loop). */
void app_watchdog_feed(void)
{
tkl_watchdog_refresh();
}
| Function | Description |
|---|---|
tkl_watchdog_init(&cfg) | cfg.interval_ms = requested timeout. Returns the actual granted interval (ms) |
tkl_watchdog_refresh() | Feed the dog — call before the interval expires |
tkl_watchdog_deinit() | Disable the watchdog |
| Symptom | Likely cause | Fix |
|---|---|---|
| Device keeps resetting | Not feeding in time | Refresh well within the returned interval, not the requested one |
| Watchdog never resets a hang | Feeding from a timer/ISR that runs regardless of health | Feed only from a path that stops when the app hangs (main loop) |
| Reset during long blocking op | Interval shorter than the operation | Increase interval_ms, or feed inside the long op at safe points |
SDK: examples/peripherals/watchdog/ (init with timeout, periodic refresh).