Files
luban-lite-t3e-pro/doc/topics/sdk/watchdog/watchdog-user-guide.html
2025-01-23 16:37:00 +08:00

202 lines
18 KiB
HTML
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
<!DOCTYPE html><html xmlns="http://www.w3.org/1999/xhtml" xml:lang="zh-cn" lang="zh-cn" data-whc_version="26.0">
<head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"/><meta name="viewport" content="width=device-width, initial-scale=1.0"/><meta http-equiv="X-UA-Compatible" content="IE=edge"/><meta name="description" content="看门狗 (Watchdog, WDT) 定时器可以监控系统的健康状态,并在系统无法正常使用时,强制复位系统。看门狗内部有一个递减计数器,在系统正常运行期间,通过重置计数可以保证看门狗模块不触发复位。 表 1 . 术语定义 术语 定义 注释说明 WDT Watchdog下文简称 wdt 看门狗 clr_thd Clear threshold 清看门狗的计数时,当前计数必须要满足此门限 ..."/><meta name="DC.rights.owner" content="(C) 版权 2025"/><meta name="copyright" content="(C) 版权 2025"/><meta name="generator" content="DITA-OT"/><meta name="DC.type" content="concept"/><meta name="DC.contributor" content="yan.wang"/><meta name="DC.date.modified" content="2024-11-26"/><meta name="DC.format" content="HTML5"/><meta name="DC.identifier" content="watchdog"/><meta name="DC.language" content="zh-CN"/><title>Watchdog 使用指南</title><!-- Build number 2023110923. --><meta name="wh-path2root" content="../../../"/><meta name="wh-toc-id" content=""/><meta name="wh-source-relpath" content="topics/sdk/watchdog/watchdog-user-guide.dita"/><meta name="wh-out-relpath" content="topics/sdk/watchdog/watchdog-user-guide.html"/>
<link rel="stylesheet" type="text/css" href="../../../webhelp/app/commons.css?buildId=2023110923"/>
<link rel="stylesheet" type="text/css" href="../../../webhelp/app/topic.css?buildId=2023110923"/>
<script src="../../../webhelp/app/options/properties.js?buildId=20250121171154"></script>
<script src="../../../webhelp/app/localization/strings.js?buildId=2023110923"></script>
<script src="../../../webhelp/app/search/index/keywords.js?buildId=20250121171154"></script>
<script defer="defer" src="../../../webhelp/app/commons.js?buildId=2023110923"></script>
<script defer="defer" src="../../../webhelp/app/topic.js?buildId=2023110923"></script>
<link rel="stylesheet" type="text/css" href="../../../webhelp/template/aic-styles-web.css?buildId=2023110923"/><link rel="stylesheet" type="text/css" href="../../../webhelp/template/notes.css?buildId=2023110923"/><link rel="stylesheet" type="text/css" href="../../../webhelp/template/aic-common.css?buildId=2023110923"/><link rel="stylesheet" type="text/css" href="../../../webhelp/template/aic-images.css?buildId=2023110923"/><link rel="stylesheet" type="text/css" href="../../../webhelp/template/footnote.css?buildId=2023110923"/><link rel="stylesheet" type="text/css" href="../../../webhelp/template/aic-web-watermark.css?buildId=2023110923"/><link rel="stylesheet" type="text/css" href="../../../webhelp/template/topic-body-list.css?buildId=2023110923"/></head>
<body id="watchdog" class="wh_topic_page frmBody">
<a href="#wh_topic_body" class="sr-only sr-only-focusable">
跳转到主要内容
</a>
<header class="navbar navbar-default wh_header">
<div class="container-fluid">
<div class="wh_header_flex_container navbar-nav navbar-expand-md navbar-dark">
<div class="wh_logo_and_publication_title_container">
<div class="wh_logo_and_publication_title">
<a href="http://www.artinchip.com" class=" wh_logo d-none d-sm-block "><img src="../../../company-logo-white.png" alt="RTOS SDK 使用指南SDK 指南文件"/></a>
<div class=" wh_publication_title "><a href="../../../index.html"><span class="booktitle"><span class="ph mainbooktitle">RTOS SDK 使用指南</span><span class="ph booktitlealt">SDK 指南文件</span></span></a></div>
</div>
</div>
<div class="wh_top_menu_and_indexterms_link collapse navbar-collapse" id="wh_top_menu_and_indexterms_link">
</div>
</div>
</div>
</header>
<div class=" wh_search_input navbar-form wh_topic_page_search search " role="form">
<form id="searchForm" method="get" role="search" action="../../../search.html"><div><input type="search" placeholder="搜索 " class="wh_search_textfield" id="textToSearch" name="searchQuery" aria-label="搜索查询" required="required"/><button type="submit" class="wh_search_button" aria-label="搜索"><span class="search_input_text">搜索</span></button></div></form>
</div>
<div class="container-fluid" id="wh_topic_container">
<div class="row">
<nav class="wh_tools d-print-none navbar-expand-md" aria-label="Tools">
<div data-tooltip-position="bottom" class=" wh_breadcrumb "></div>
<div class="wh_right_tools">
<button class="wh_hide_highlight" aria-label="切换搜索突出显示" title="切换搜索突出显示"></button>
<button class="webhelp_expand_collapse_sections" data-next-state="collapsed" aria-label="折叠截面" title="折叠截面"></button>
<div class=" wh_print_link print d-none d-md-inline-block "><button onClick="window.print()" title="打印此页" aria-label="打印此页"></button></div>
</div>
</nav>
</div>
<div class="wh_content_area">
<div class="row">
<div class="col-12" id="wh_topic_body">
<div class=" wh_topic_content body "><main role="main"><article class="- topic/topic concept/concept topic concept" role="article" aria-labelledby="ariaid-title1"><span class="edit-link" style="font-size:12px; opacity:0.6; text-align:right; vertical-align:middle"><a target="_blank" href="http://172.16.35.88/tasks/jdssno1uvvbf2mltu9kb9v3if05d5gopuakboe8hlud18rma/edit/F:/aicdita/aicdita-cn/topics/sdk/watchdog/watchdog-user-guide.dita">Edit online</a></span><h1 class="- topic/title title topictitle1" id="ariaid-title1">Watchdog 使用指南</h1><div class="date inPage">26 Nov 2024</div><div style="color: gray;">
Read time: 1 minute(s)
</div><div class="- topic/body concept/conbody body conbody"><p class="- topic/p p" data-ofbid="d249197e22__20250121171702">看门狗 (Watchdog, WDT)
定时器可以监控系统的健康状态,并在系统无法正常使用时,强制复位系统。看门狗内部有一个递减计数器,在系统正常运行期间,通过重置计数可以保证看门狗模块不触发复位。</p><div class="table-container"><table class="- topic/table table frame-all" id="watchdog__table_pkr_nct_c1c" data-ofbid="watchdog__table_pkr_nct_c1c" data-cols="3"><caption class="- topic/title title tablecap" data-caption-side="top" data-is-repeated="true"><span class="table--title-label"><span class="table--title-label-number"> 1</span><span class="table--title-label-punctuation">. </span></span><span class="table--title">术语定义</span></caption><colgroup><col style="width:14.306151645207438%"/><col style="width:28.898426323319025%"/><col style="width:56.79542203147353%"/></colgroup><thead class="- topic/thead thead"><tr class="- topic/row"><th class="- topic/entry entry colsep-1 rowsep-1" id="watchdog__table_pkr_nct_c1c__entry__1">术语</th><th class="- topic/entry entry colsep-1 rowsep-1" id="watchdog__table_pkr_nct_c1c__entry__2">定义</th><th class="- topic/entry entry colsep-0 rowsep-1" id="watchdog__table_pkr_nct_c1c__entry__3">注释说明</th></tr></thead><tbody class="- topic/tbody tbody"><tr class="- topic/row"><td class="- topic/entry entry colsep-1 rowsep-1" headers="watchdog__table_pkr_nct_c1c__entry__1">WDT</td><td class="- topic/entry entry colsep-1 rowsep-1" headers="watchdog__table_pkr_nct_c1c__entry__2">Watchdog下文简称 wdt</td><td class="- topic/entry entry colsep-0 rowsep-1" headers="watchdog__table_pkr_nct_c1c__entry__3">看门狗</td></tr><tr class="- topic/row"><td class="- topic/entry entry colsep-1 rowsep-1" headers="watchdog__table_pkr_nct_c1c__entry__1">clr_thd</td><td class="- topic/entry entry colsep-1 rowsep-1" headers="watchdog__table_pkr_nct_c1c__entry__2">Clear threshold</td><td class="- topic/entry entry colsep-0 rowsep-1" headers="watchdog__table_pkr_nct_c1c__entry__3">清看门狗的计数时,当前计数必须要满足此门限</td></tr><tr class="- topic/row"><td class="- topic/entry entry colsep-1 rowsep-1" headers="watchdog__table_pkr_nct_c1c__entry__1">irq_thd</td><td class="- topic/entry entry colsep-1 rowsep-1" headers="watchdog__table_pkr_nct_c1c__entry__2">IRQ threshold</td><td class="- topic/entry entry colsep-0 rowsep-1" headers="watchdog__table_pkr_nct_c1c__entry__3">看门狗产生中断的计数值</td></tr><tr class="- topic/row"><td class="- topic/entry entry colsep-1 rowsep-1" headers="watchdog__table_pkr_nct_c1c__entry__1">rst_thd</td><td class="- topic/entry entry colsep-1 rowsep-1" headers="watchdog__table_pkr_nct_c1c__entry__2">Reset threshold</td><td class="- topic/entry entry colsep-0 rowsep-1" headers="watchdog__table_pkr_nct_c1c__entry__3">看门狗触发系统重启的门限值</td></tr><tr class="- topic/row"><td class="- topic/entry entry colsep-1 rowsep-0" headers="watchdog__table_pkr_nct_c1c__entry__1">ping</td><td class="- topic/entry entry colsep-1 rowsep-0" headers="watchdog__table_pkr_nct_c1c__entry__2">-</td><td class="- topic/entry entry colsep-0 rowsep-0" headers="watchdog__table_pkr_nct_c1c__entry__3">指将看门狗的计时器清零,使其重新计数,俗称“喂狗”</td></tr></tbody></table></div><section class="- topic/section section" id="watchdog__id3" data-ofbid="watchdog__id3"><h2 class="- topic/title title sectiontitle">Watchdog 功能说明</h2>
<p class="- topic/p p" data-ofbid="d249197e80__20250121171702">Watchdog
V1.0
提供了下列系统监控和保护功能:</p>
<ol class="- topic/ol ol arabic simple" id="watchdog__ol_rmx_cxh_bdc" data-ofbid="watchdog__ol_rmx_cxh_bdc"><li class="- topic/li li" data-ofbid="d249197e88__20250121171702">
<p class="- topic/p p" data-ofbid="d249197e90__20250121171702"><strong class="+ topic/ph hi-d/b ph b">中断信号通知</strong>在复位系统前先时刻可配置Watchdog 能够发出一个中断信号,通知系统做复位前的准备工作。</p>
<p class="- topic/p p" data-ofbid="d249197e95__20250121171702">中断信号通知可允许系统在被强制复位之前执行一些关键操作,例如保存当前状态或清理资源。</p>
</li><li class="- topic/li li" data-ofbid="d249197e98__20250121171702">
<p class="- topic/p p" data-ofbid="d249197e100__20250121171702"><strong class="+ topic/ph hi-d/b ph b">计数器清零限制</strong>:仅在当前计数值满足某个门限(可配置)值时才能执行清零操作。</p>
<p class="- topic/p p" data-ofbid="d249197e105__20250121171702">计数器清零限制有助于防止误操作导致的不必要复位,提高系统的可靠性。</p>
<figure class="- topic/fig fig fignone" id="watchdog__fig_xwq_qct_c1c" data-ofbid="watchdog__fig_xwq_qct_c1c"><br/><div class="imagecenter"><img class="- topic/image image imagecenter" id="watchdog__image_smx_cxh_bdc" src="../../../images/watchdog/wdt_clr_window.png" alt="wdt_clr_window"/></div><br/><figcaption data-caption-side="bottom" class="- topic/title title figcapcenter"><span class="figtitleprefix fig--title-label"><span class="fig--title-label-number"> 1</span><span class="fig--title-label-punctuation">. </span></span><span class="fig--title">Watchdog 清零的窗口示意</span></figcaption></figure>
</li><li class="- topic/li li" data-ofbid="d249197e115__20250121171702">
<p class="- topic/p p" data-ofbid="d249197e117__20250121171702"><strong class="+ topic/ph hi-d/b ph b">多通道配置</strong>:支持预先加载四个 Watchdog 的配置,运行时可一键切换。软件可以理解为多通道,目前只开放一个通道,即通道 0。</p>
<p class="- topic/p p" data-ofbid="d249197e122__20250121171702">多通道配置适用于需要在不同工作模式间灵活切换的系统,增强了系统的适应性和灵活性。</p>
</li><li class="- topic/li li" data-ofbid="d249197e125__20250121171702">
<p class="- topic/p p" data-ofbid="d249197e127__20250121171702"><strong class="+ topic/ph hi-d/b ph b">写失效保护机制</strong>:当配置了写失效,除了 OP 和 IRQ_STA 寄存器可读以外,其他寄存器均不可读。</p>
<p class="- topic/p p" data-ofbid="d249197e132__20250121171702">写失效保护适用于上述所有功能操作,可防止意外或恶意的软件修改 Watchdog 配置,保证系统的安全稳定运行。</p>
<figure class="- topic/fig fig fignone" id="watchdog__id5" data-ofbid="watchdog__id5"><br/><div class="imagecenter"><img class="- topic/image image imagecenter" id="watchdog__image_umx_cxh_bdc" src="../../../images/watchdog/wdt_wr_protect.png" width="384" alt="wdt_wr_protect"/></div><br/><figcaption data-caption-side="bottom" class="- topic/title title figcapcenter"><span class="figtitleprefix fig--title-label"><span class="fig--title-label-number"> 2</span><span class="fig--title-label-punctuation">. </span></span><span class="fig--title">Watchdog 写保护的状态迁移</span></figcaption></figure>
<p class="- topic/p p" data-ofbid="d249197e142__20250121171702">展示了不同状态下可进行的操作,以及如何进入和退出状态:</p>
<ul class="- topic/ul ul simple" id="watchdog__ul_vmx_cxh_bdc" data-ofbid="watchdog__ul_vmx_cxh_bdc"><li class="- topic/li li" data-ofbid="d249197e146__20250121171702">
<dl class="- topic/dl dl simple" id="watchdog__dl_wmx_cxh_bdc" data-ofbid="watchdog__dl_wmx_cxh_bdc"><dt class="- topic/dt dt dlterm" data-ofbid="d249197e150__20250121171702">写允许</dt><dd class="- topic/dd dd">
<p class="- topic/p p" data-ofbid="d249197e154__20250121171702">普通状态,无任何权限限制,随时可重新配置计数器。</p>
</dd></dl>
</li><li class="- topic/li li" data-ofbid="d249197e158__20250121171702">
<dl class="- topic/dl dl simple" id="watchdog__dl_xmx_cxh_bdc" data-ofbid="watchdog__dl_xmx_cxh_bdc"><dt class="- topic/dt dt dlterm" data-ofbid="d249197e162__20250121171702">写保护</dt><dd class="- topic/dd dd">
<p class="- topic/p p" data-ofbid="d249197e166__20250121171702"> 如果要重新配置 Watchdog 计时器,需先写入操作码 OP_WR_EN 解锁(进入“写允许”状态)。</p>
</dd></dl>
</li><li class="- topic/li li" data-ofbid="d249197e170__20250121171702">
<dl class="- topic/dl dl simple" id="watchdog__dl_ymx_cxh_bdc" data-ofbid="watchdog__dl_ymx_cxh_bdc"><dt class="- topic/dt dt dlterm" data-ofbid="d249197e174__20250121171702">写失效</dt><dd class="- topic/dd dd">
<p class="- topic/p p" data-ofbid="d249197e178__20250121171702"> 此时 Watchdog 进入只读状态,只有 OP
寄存器可写(用于喂狗、切换通道)。从图中可以看到此状态不可逆,如果要修改 Watchdog 配置,必须要
reset 系统才可以。</p>
</dd></dl>
</li></ul>
</li><li class="- topic/li li" data-ofbid="d249197e183__20250121171702">
<p class="- topic/p p" data-ofbid="d249197e185__20250121171702"><strong class="+ topic/ph hi-d/b ph b">支持操作码 (Operate Code)</strong>:支持多种操作码,如计时器清零、通道切换、写使能等,以实现更精细的控制。</p>
</li></ol>
</section></div></article></main></div>
</div>
</div>
</div>
</div>
<footer class="navbar navbar-default wh_footer">
<div class=" footer-container mx-auto ">
<title>footer def</title>
<style><!--
.p1 {
font-family: FangZhengShuSong, Times, serif;
}
.p2 {
font-family: Arial, Helvetica, sans-serif;
}
.p3 {
font-family: "Lucida Console", "Courier New", monospace;
}
--></style>
<div class="webhelp.fragment.footer">
<p class="p1">Copyright © 2019-2024 广东匠芯创科技有限公司. All rights reserved.</p>
</div><div>
<div class="generation_time">
Update Time: 2025-01-21
</div>
</div>
</div>
</footer>
<div id="go2top" class="d-print-none">
<span class="oxy-icon oxy-icon-up"></span>
</div>
<div id="modal_img_large" class="modal">
<span class="close oxy-icon oxy-icon-remove"></span>
<div id="modal_img_container"></div>
<div id="caption"></div>
</div>
<script src="${pd}/publishing/publishing-styles-AIC-template/js/custom.js" defer="defer"></script>
</body>
</html>