linuxOS_D21X/doc/topics/sdk/watchdog/watchdog-interface-design.html
2025-01-23 16:35:08 +08:00

384 lines
50 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="27.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="以下接口是 Linux Watchdog 子系统需要的标准接口。 外部接口 Linux 对用户态提供了一组 Watchdog 的 ioctl 接口,用户态可以通过设备节点 /dev/watchdogX 来访问:(详见 include/upai/linux/watchdog.h struct watchdog_info { __u32 options; /* Options the ..."/><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.relation" content="../../../topics/sdk/watchdog/watchdog-design.html"/><meta name="DC.relation" content="../../../topics/sdk/watchdog/watchdog-data-structure.html"/><meta name="DC.relation" content="../../../topics/sdk/watchdog/watchdog-demo.html"/><meta name="DC.contributor" content="yan.wang"/><meta name="DC.contributor" content="yan.wang"/><meta name="DC.date.modified" content="2024-01-15"/><meta name="DC.format" content="HTML5"/><meta name="DC.identifier" content="Watchdog_interface_design"/><meta name="DC.language" content="zh-CN"/><title>接口设计</title><!-- Generated with build number 2024112209. --><meta name="wh-path2root" content="../../../"/><meta name="wh-toc-id" content="Watchdog_interface_design-d4445e3900"/><meta name="wh-source-relpath" content="topics/sdk/watchdog/watchdog-interface-design.dita"/><meta name="wh-out-relpath" content="topics/sdk/watchdog/watchdog-interface-design.html"/>
<link rel="stylesheet" type="text/css" href="../../../webhelp/app/commons.css?buildId=2024112209"/>
<link rel="stylesheet" type="text/css" href="../../../webhelp/app/topic.css?buildId=2024112209"/>
<script src="../../../webhelp/app/options/properties.js?buildId=20250123154945"></script>
<script src="../../../webhelp/app/localization/strings.js?buildId=2024112209"></script>
<script src="../../../webhelp/app/search/index/keywords.js?buildId=20250123154945"></script>
<script defer="defer" src="../../../webhelp/app/commons.js?buildId=2024112209"></script>
<script defer="defer" src="../../../webhelp/app/topic.js?buildId=2024112209"></script>
<link rel="stylesheet" type="text/css" href="../../../webhelp/template/aic-styles-web.css?buildId=2024112209"/><link rel="stylesheet" type="text/css" href="../../../webhelp/template/notes.css?buildId=2024112209"/><link rel="stylesheet" type="text/css" href="../../../webhelp/template/aic-common.css?buildId=2024112209"/><link rel="stylesheet" type="text/css" href="../../../webhelp/template/aic-images.css?buildId=2024112209"/><link rel="stylesheet" type="text/css" href="../../../webhelp/template/footnote.css?buildId=2024112209"/><link rel="stylesheet" type="text/css" href="../../../webhelp/template/aic-web-watermark.css?buildId=2024112209"/><link rel="stylesheet" type="text/css" href="../../../webhelp/template/topic-body-list.css?buildId=2024112209"/></head>
<body id="Watchdog_interface_design" 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=" Linux SDK 使用指南 SDK 指南文件 "/></a>
<div class=" wh_publication_title "><a href="../../../index.html"><span class="booktitle"> <span class="ph mainbooktitle">Linux 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 "><ol class="d-print-none"><li><span class="home"><a href="../../../index.html"><span>主页</span></a></span></li><li><div class="topicref" data-id="id"><div class="title"><a href="../../../topics/sdk/chapter-advanced-app.html">高级应用</a><div class="wh-tooltip"><p class="shortdesc">系统、存储、多媒体、接口、安全等模块的详细配置和设计说明。</p></div></div></div></li><li><div class="topicref" data-id="chapter-system"><div class="title"><a href="../../../topics/chapter-title/chapter-system.html">系统</a><div class="wh-tooltip"><p class="shortdesc"></p></div></div></div></li><li><div class="topicref" data-id="watchdog"><div class="title"><a href="../../../topics/sdk/watchdog/watchdog-user-guide.html">Watchdog 使用指南</a></div></div></li><li><div class="topicref" data-id="watchdog_design_intro"><div class="title"><a href="../../../topics/sdk/watchdog/watchdog-design.html">设计说明</a></div></div></li><li class="active"><div class="topicref" data-id="Watchdog_interface_design"><div class="title"><a href="../../../topics/sdk/watchdog/watchdog-interface-design.html">接口设计</a></div></div></li></ol></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_navigation_links "><span id="topic_navigation_links" class="navheader">
<span class="navprev"><a class="- topic/link link" href="../../../topics/sdk/watchdog/watchdog-data-structure.html" title="数据结构设计" aria-label="上一主题: 数据结构设计" rel="prev"></a></span>
<span class="navnext"><a class="- topic/link link" href="../../../topics/sdk/watchdog/watchdog-demo.html" title="Demo" aria-label="下一主题: Demo" rel="next"></a></span> </span></div>
<div class=" wh_print_link print d-none d-md-inline-block "><button onClick="window.print()" title="打印此页" aria-label="打印此页"></button></div>
<button type="button" id="wh_toc_button" class="custom-toggler navbar-toggler collapsed wh_toggle_button navbar-light" aria-expanded="false" aria-label="Toggle publishing table of content" aria-controls="wh_publication_toc">
<span class="navbar-toggler-icon"></span>
</button>
</div>
</nav>
</div>
<div class="wh_content_area">
<div class="row">
<nav id="wh_publication_toc" class="col-lg-3 col-md-3 col-sm-12 d-md-block d-none d-print-none" aria-label="Table of Contents Container">
<div id="wh_publication_toc_content">
<div class=" wh_publication_toc " data-tooltip-position="right"><span class="expand-button-action-labels"><span id="button-expand-action" role="button" aria-label="Expand"></span><span id="button-collapse-action" role="button" aria-label="Collapse"></span><span id="button-pending-action" role="button" aria-label="Pending"></span></span><ul role="tree" aria-label="Table of Contents"><li role="treeitem"><div data-tocid="revinfo_linux-d4445e1079" class="topicref" data-id="revinfo_linux" data-state="leaf"><span role="button" class="wh-expand-btn"></span><div class="title"><a href="../../../topics/revinfo/revinfo_linux.html" id="revinfo_linux-d4445e1079-link">修订记录</a></div></div></li><li role="treeitem" aria-expanded="false"><div data-tocid="id-d4445e1096" class="topicref" data-id="id" data-state="not-ready"><span role="button" tabindex="0" aria-labelledby="button-expand-action id-d4445e1096-link" class="wh-expand-btn"></span><div class="title"><a href="../../../topics/sdk/env/sdk-compile.html" id="id-d4445e1096-link">SDK 编译</a><div class="wh-tooltip"><p class="shortdesc">介绍不同编译环境下 SDK 的详细编译流程。</p></div></div></div></li><li role="treeitem" aria-expanded="false"><div data-tocid="tocId-d4445e1240" class="topicref" data-state="not-ready"><span role="button" tabindex="0" aria-labelledby="button-expand-action tocId-d4445e1240-link" class="wh-expand-btn"></span><div class="title"><a href="../../../topics/sdk/advanced/lb_usage_commands.html" id="tocId-d4445e1240-link">使用指南</a></div></div></li><li role="treeitem" aria-expanded="false"><div data-tocid="concept_rcx_czh_pzb-d4445e1360" class="topicref" data-id="concept_rcx_czh_pzb" data-state="not-ready"><span role="button" tabindex="0" aria-labelledby="button-expand-action concept_rcx_czh_pzb-d4445e1360-link" class="wh-expand-btn"></span><div class="title"><a href="../../../topics/sdk/chapter-app.html" id="concept_rcx_czh_pzb-d4445e1360-link">应用场景</a><div class="wh-tooltip"><p class="shortdesc">描述了 SDK 在不同应用场景中的配置和使用包括系统更新、OTA、安全方案等。</p></div></div></div></li><li role="treeitem" aria-expanded="false"><div data-tocid="id-d4445e1678" class="topicref" data-id="id" data-state="not-ready"><span role="button" tabindex="0" aria-labelledby="button-expand-action id-d4445e1678-link" class="wh-expand-btn"></span><div class="title"><a href="../../../topics/sdk/peripheral/peripheral-intro.html" id="id-d4445e1678-link">外设移植</a><div class="wh-tooltip"><p class="shortdesc"><span class="ph">触摸屏、显示器、WIFI 模块、按键</span>等外设的介绍和使用说明。</p></div></div></div></li><li role="treeitem" aria-expanded="false"><div data-tocid="id-d4445e1964" class="topicref" data-id="id" data-state="not-ready"><span role="button" tabindex="0" aria-labelledby="button-expand-action id-d4445e1964-link" class="wh-expand-btn"></span><div class="title"><a href="../../../topics/sdk/bringup/chapter-bringup.html" id="id-d4445e1964-link">BringUp</a><div class="wh-tooltip"><p class="shortdesc">在硬件上电后快速初始化系统,为操作系统的启动准备好必要的硬件环境。</p></div></div></div></li><li role="treeitem" aria-expanded="true"><div data-tocid="id-d4445e2153" class="topicref" data-id="id" data-state="expanded"><span role="button" tabindex="0" aria-labelledby="button-collapse-action id-d4445e2153-link" class="wh-expand-btn"></span><div class="title"><a href="../../../topics/sdk/chapter-advanced-app.html" id="id-d4445e2153-link">高级应用</a><div class="wh-tooltip"><p class="shortdesc">系统、存储、多媒体、接口、安全等模块的详细配置和设计说明。</p></div></div></div><ul role="group" class="navbar-nav nav-list"><li role="treeitem" aria-expanded="false"><div data-tocid="uBoot-d4445e2170" class="topicref" data-id="uBoot" data-state="not-ready"><span role="button" tabindex="0" aria-labelledby="button-expand-action uBoot-d4445e2170-link" class="wh-expand-btn"></span><div class="title"><a href="../../../topics/sdk/boot/uboot-module.html" id="uBoot-d4445e2170-link">U-Boot</a><div class="wh-tooltip"><p class="shortdesc">启动支持的基本功能以及运行时的基本硬件环境。</p></div></div></div></li><li role="treeitem" aria-expanded="false"><div data-tocid="concept_mtx_tk3_pzb-d4445e3028" class="topicref" data-id="concept_mtx_tk3_pzb" data-state="not-ready"><span role="button" tabindex="0" aria-labelledby="button-expand-action concept_mtx_tk3_pzb-d4445e3028-link" class="wh-expand-btn"></span><div class="title"><a href="../../../topics/sdk/linux/chapter_linux.html" id="concept_mtx_tk3_pzb-d4445e3028-link">Linux</a></div></div></li><li role="treeitem" aria-expanded="true"><div data-tocid="chapter-system-d4445e3198" class="topicref" data-id="chapter-system" data-state="expanded"><span role="button" tabindex="0" aria-labelledby="button-collapse-action chapter-system-d4445e3198-link" class="wh-expand-btn"></span><div class="title"><a href="../../../topics/chapter-title/chapter-system.html" id="chapter-system-d4445e3198-link">系统</a><div class="wh-tooltip"><p class="shortdesc"></p></div></div></div><ul role="group" class="navbar-nav nav-list"><li role="treeitem" aria-expanded="false"><div data-tocid="bwm-d4445e3214" class="topicref" data-id="bwm" data-state="not-ready"><span role="button" tabindex="0" aria-labelledby="button-expand-action bwm-d4445e3214-link" class="wh-expand-btn"></span><div class="title"><a href="../../../topics/sdk/bwm/bwm-user-guide.html" id="bwm-d4445e3214-link">BWM 使用指南</a></div></div></li><li role="treeitem" aria-expanded="false"><div data-tocid="cmu-d4445e3284" class="topicref" data-id="cmu" data-state="not-ready"><span role="button" tabindex="0" aria-labelledby="button-expand-action cmu-d4445e3284-link" class="wh-expand-btn"></span><div class="title"><a href="../../../topics/sdk/cmu/cmu-introduction.html" id="cmu-d4445e3284-link">CMU 使用指南</a></div></div></li><li role="treeitem" aria-expanded="false"><div data-tocid="concept_or5_kn3_pzb-d4445e3396" class="topicref" data-id="concept_or5_kn3_pzb" data-state="not-ready"><span role="button" tabindex="0" aria-labelledby="button-expand-action concept_or5_kn3_pzb-d4445e3396-link" class="wh-expand-btn"></span><div class="title"><a href="../../../topics/sdk/dma/dma-user-guide.html" id="concept_or5_kn3_pzb-d4445e3396-link">DMA 使用指南</a></div></div></li><li role="treeitem" aria-expanded="false"><div data-tocid="concept_n2p_sn3_pzb-d4445e3536" class="topicref" data-id="concept_n2p_sn3_pzb" data-state="not-ready"><span role="button" tabindex="0" aria-labelledby="button-expand-action concept_n2p_sn3_pzb-d4445e3536-link" class="wh-expand-btn"></span><div class="title"><a href="../../../topics/sdk/rtc/rtc-user-guide.html" id="concept_n2p_sn3_pzb-d4445e3536-link">RTC 使用指南</a></div></div></li><li role="treeitem" aria-expanded="false"><div data-tocid="tsensor-d4445e3676" class="topicref" data-id="tsensor" data-state="not-ready"><span role="button" tabindex="0" aria-labelledby="button-expand-action tsensor-d4445e3676-link" class="wh-expand-btn"></span><div class="title"><a href="../../../topics/sdk/tsensor/tsensor-user-guide.html" id="tsensor-d4445e3676-link">TSensor 使用指南</a></div></div></li><li role="treeitem" aria-expanded="true"><div data-tocid="watchdog-d4445e3802" class="topicref" data-id="watchdog" data-state="expanded"><span role="button" tabindex="0" aria-labelledby="button-collapse-action watchdog-d4445e3802-link" class="wh-expand-btn"></span><div class="title"><a href="../../../topics/sdk/watchdog/watchdog-user-guide.html" id="watchdog-d4445e3802-link">Watchdog 使用指南</a></div></div><ul role="group" class="navbar-nav nav-list"><li role="treeitem"><div data-tocid="watchdog_configuration-d4445e3816" class="topicref" data-id="watchdog_configuration" data-state="leaf"><span role="button" class="wh-expand-btn"></span><div class="title"><a href="../../../topics/sdk/watchdog/watchdog-config.html" id="watchdog_configuration-d4445e3816-link">Watchdog 配置</a></div></div></li><li role="treeitem"><div data-tocid="watchdog_debug_guide-d4445e3830" class="topicref" data-id="watchdog_debug_guide" data-state="leaf"><span role="button" class="wh-expand-btn"></span><div class="title"><a href="../../../topics/sdk/watchdog/watchdog-debug.html" id="watchdog_debug_guide-d4445e3830-link">调试指南</a></div></div></li><li role="treeitem"><div data-tocid="watchdog_test_guide-d4445e3844" class="topicref" data-id="watchdog_test_guide" data-state="leaf"><span role="button" class="wh-expand-btn"></span><div class="title"><a href="../../../topics/sdk/watchdog/watchdog-test-guide.html" id="watchdog_test_guide-d4445e3844-link">测试指南</a></div></div></li><li role="treeitem" aria-expanded="true"><div data-tocid="watchdog_design_intro-d4445e3858" class="topicref" data-id="watchdog_design_intro" data-state="expanded"><span role="button" tabindex="0" aria-labelledby="button-collapse-action watchdog_design_intro-d4445e3858-link" class="wh-expand-btn"></span><div class="title"><a href="../../../topics/sdk/watchdog/watchdog-design.html" id="watchdog_design_intro-d4445e3858-link">设计说明</a></div></div><ul role="group" class="navbar-nav nav-list"><li role="treeitem"><div data-tocid="watchdog_key_procedures-d4445e3872" class="topicref" data-id="watchdog_key_procedures" data-state="leaf"><span role="button" class="wh-expand-btn"></span><div class="title"><a href="../../../topics/sdk/watchdog/watchdog-key-procedures.html" id="watchdog_key_procedures-d4445e3872-link">关键流程设计</a></div></div></li><li role="treeitem"><div data-tocid="watchdog_data_structure-d4445e3886" class="topicref" data-id="watchdog_data_structure" data-state="leaf"><span role="button" class="wh-expand-btn"></span><div class="title"><a href="../../../topics/sdk/watchdog/watchdog-data-structure.html" id="watchdog_data_structure-d4445e3886-link">数据结构设计</a></div></div></li><li role="treeitem" class="active"><div data-tocid="Watchdog_interface_design-d4445e3900" class="topicref" data-id="Watchdog_interface_design" data-state="leaf"><span role="button" class="wh-expand-btn"></span><div class="title"><a href="../../../topics/sdk/watchdog/watchdog-interface-design.html" id="Watchdog_interface_design-d4445e3900-link">接口设计</a></div></div></li><li role="treeitem"><div data-tocid="watchdog_demo-d4445e3914" class="topicref" data-id="watchdog_demo" data-state="leaf"><span role="button" class="wh-expand-btn"></span><div class="title"><a href="../../../topics/sdk/watchdog/watchdog-demo.html" id="watchdog_demo-d4445e3914-link">Demo</a></div></div></li></ul></li><li role="treeitem" aria-expanded="false"><div data-tocid="watchdog_common_issues-d4445e3928" class="topicref" data-id="watchdog_common_issues" data-state="not-ready"><span role="button" tabindex="0" aria-labelledby="button-expand-action watchdog_common_issues-d4445e3928-link" class="wh-expand-btn"></span><div class="title"><a href="../../../topics/sdk/watchdog/watchdog-faq.html" id="watchdog_common_issues-d4445e3928-link">常见问题</a></div></div></li></ul></li><li role="treeitem" aria-expanded="false"><div data-tocid="wri-d4445e3956" class="topicref" data-id="wri" data-state="not-ready"><span role="button" tabindex="0" aria-labelledby="button-expand-action wri-d4445e3956-link" class="wh-expand-btn"></span><div class="title"><a href="../../../topics/sdk/wri/wri-user-guide.html" id="wri-d4445e3956-link">WRI 使用指南</a></div></div></li></ul></li><li role="treeitem" aria-expanded="false"><div data-tocid="chapter-memory-d4445e4054" class="topicref" data-id="chapter-memory" data-state="not-ready"><span role="button" tabindex="0" aria-labelledby="button-expand-action chapter-memory-d4445e4054-link" class="wh-expand-btn"></span><div class="title"><a href="../../../topics/chapter-title/chapter-memory-sdk.html" id="chapter-memory-d4445e4054-link">存储</a><div class="wh-tooltip"><p class="shortdesc">SDMC、SPI NAND、SPI NOR 等存储模块的介绍和使用说明。</p></div></div></div></li><li role="treeitem" aria-expanded="false"><div data-tocid="concept_mcc_32s_nbc-d4445e4438" class="topicref" data-id="concept_mcc_32s_nbc" data-state="not-ready"><span role="button" tabindex="0" aria-labelledby="button-expand-action concept_mcc_32s_nbc-d4445e4438-link" class="wh-expand-btn"></span><div class="title"><a href="../../../topics/chapter-title/chapter-multi-media-sdk.html" id="concept_mcc_32s_nbc-d4445e4438-link">多媒体</a><div class="wh-tooltip"><p class="shortdesc">GE、VE、Display、DVP、MPP、MPP 播放器等多媒体模块的介绍和使用说明。</p></div></div></div></li><li role="treeitem" aria-expanded="false"><div data-tocid="concept_nww_hzh_pzb-d4445e5947" class="topicref" data-id="concept_nww_hzh_pzb" data-state="not-ready"><span role="button" tabindex="0" aria-labelledby="button-expand-action concept_nww_hzh_pzb-d4445e5947-link" class="wh-expand-btn"></span><div class="title"><a href="../../../topics/chapter-title/chapter-interface-sdk.html" id="concept_nww_hzh_pzb-d4445e5947-link">接口</a><div class="wh-tooltip"><p class="shortdesc">CAN、CIR、GPAI、GPIO、I2C、PSADC、PWM 等接口模块的介绍和使用说明。</p></div></div></div></li><li role="treeitem" aria-expanded="false"><div data-tocid="chapter-safety-d4445e7944" class="topicref" data-id="chapter-safety" data-state="not-ready"><span role="button" tabindex="0" aria-labelledby="button-expand-action chapter-safety-d4445e7944-link" class="wh-expand-btn"></span><div class="title"><a href="../../../topics/chapter-title/chapter-safety-sdk.html" id="chapter-safety-d4445e7944-link">安全</a><div class="wh-tooltip"><p class="shortdesc">SPI ENC、CE、eFuse 等安全模块的介绍和使用说明。</p></div></div></div></li></ul></li></ul></div>
</div>
</nav>
<div class="col-lg-7 col-md-9 col-sm-12" id="wh_topic_body">
<button id="wh_close_publication_toc_button" class="close-toc-button d-none" aria-label="Toggle publishing table of content" aria-controls="wh_publication_toc" aria-expanded="true">
<span class="close-toc-icon-container">
<span class="close-toc-icon"></span>
</span>
</button>
<button id="wh_close_topic_toc_button" class="close-toc-button d-none" aria-label="Toggle topic table of content" aria-controls="wh_topic_toc" aria-expanded="true">
<span class="close-toc-icon-container">
<span class="close-toc-icon"></span>
</span>
</button>
<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" title="Edit this document" href="http://172.16.35.88/tasks/jdssno1uvvbf2mltu9kb9v3if05d5gopuakboe8hlud18rma/edit/F:/aicdita/aicdita-cn/topics/sdk/watchdog/watchdog-interface-design.dita">Edit online</a></span><h1 class="- topic/title title topictitle1" id="ariaid-title1">接口设计</h1>
<div class="date inPage">15 Jan 2024</div><div style="color: gray;">
Read time: 3 minute(s)
</div>
<div class="- topic/body concept/conbody body conbody">
<p class="- topic/p p" data-ofbid="d115244e33__20250123155210">以下接口是 Linux Watchdog 子系统需要的标准接口。</p>
<section class="- topic/section section" id="Watchdog_interface_design__section_vvn_1gt_c1c" data-ofbid="Watchdog_interface_design__section_vvn_1gt_c1c"><h2 class="- topic/title title sectiontitle">外部接口</h2>
<div class="- topic/p p" data-ofbid="d115244e41__20250123155210">Linux 对用户态提供了一组 Watchdog 的 ioctl 接口,用户态可以通过设备节点 <span class="+ topic/ph sw-d/filepath ph filepath">/dev/watchdogX</span>
来访问:(详见
<span class="+ topic/ph sw-d/filepath ph filepath">include/upai/linux/watchdog.h</span><pre class="+ topic/pre pr-d/codeblock pre codeblock language-c" id="Watchdog_interface_design__codeblock_vrx_bgt_c1c" data-ofbid="Watchdog_interface_design__codeblock_vrx_bgt_c1c"><code><strong class="hl-keyword">struct</strong> watchdog_info {
__u32 options; <em class="hl-comment">/* Options the card/driver supports */</em>
__u32 firmware_version; <em class="hl-comment">/* Firmware version of the card */</em>
__u8 identity[<span class="hl-number">32</span>]; <em class="hl-comment">/* Identity of the board */</em>
};
#<span class="hl-directive">define</span> WDIOC_GETSUPPORT _IOR(WATCHDOG_IOCTL_BASE, <span class="hl-number">0</span>, <strong class="hl-keyword">struct</strong> watchdog_info)
#<span class="hl-directive">define</span> WDIOC_GETSTATUS _IOR(WATCHDOG_IOCTL_BASE, <span class="hl-number">1</span>, <strong class="hl-keyword">int</strong>)
#<span class="hl-directive">define</span> WDIOC_GETBOOTSTATUS _IOR(WATCHDOG_IOCTL_BASE, <span class="hl-number">2</span>, <strong class="hl-keyword">int</strong>)
#<span class="hl-directive">define</span> WDIOC_GETTEMP _IOR(WATCHDOG_IOCTL_BASE, <span class="hl-number">3</span>, <strong class="hl-keyword">int</strong>)
#<span class="hl-directive">define</span> WDIOC_SETOPTIONS _IOR(WATCHDOG_IOCTL_BASE, <span class="hl-number">4</span>, <strong class="hl-keyword">int</strong>)
#<span class="hl-directive">define</span> WDIOC_KEEPALIVE _IOR(WATCHDOG_IOCTL_BASE, <span class="hl-number">5</span>, <strong class="hl-keyword">int</strong>)
#<span class="hl-directive">define</span> WDIOC_SETTIMEOUT _IOWR(WATCHDOG_IOCTL_BASE, <span class="hl-number">6</span>, <strong class="hl-keyword">int</strong>)
#<span class="hl-directive">define</span> WDIOC_GETTIMEOUT _IOR(WATCHDOG_IOCTL_BASE, <span class="hl-number">7</span>, <strong class="hl-keyword">int</strong>)
#<span class="hl-directive">define</span> WDIOC_SETPRETIMEOUT _IOWR(WATCHDOG_IOCTL_BASE, <span class="hl-number">8</span>, <strong class="hl-keyword">int</strong>)
#<span class="hl-directive">define</span> WDIOC_GETPRETIMEOUT _IOR(WATCHDOG_IOCTL_BASE, <span class="hl-number">9</span>, <strong class="hl-keyword">int</strong>)
#<span class="hl-directive">define</span> WDIOC_GETTIMELEFT _IOR(WATCHDOG_IOCTL_BASE, <span class="hl-number">10</span>, <strong class="hl-keyword">int</strong>)</code></pre></div>
<p class="- topic/p p" data-ofbid="d115244e52__20250123155210"><a xml:lang="zh-CN" lang="zh-CN" class="- topic/xref xref" href="watchdog-demo.html">Demo</a> 就是调用的这些接口 Watchdog 的访问。</p>
</section>
<section class="- topic/section section" id="Watchdog_interface_design__section_jcj_lgt_c1c" data-ofbid="Watchdog_interface_design__section_jcj_lgt_c1c"><h2 class="- topic/title title sectiontitle">内部接口</h2>
<div class="table-container"><table class="- topic/table table frame-all" id="Watchdog_interface_design__table_jck_jgt_c1c" data-ofbid="Watchdog_interface_design__table_jck_jgt_c1c" data-cols="2"><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">aic_wdt_start</span></caption><colgroup><col style="width:25%"/><col style="width:75%"/></colgroup><thead class="- topic/thead thead">
<tr class="- topic/row">
<th class="- topic/entry entry colsep-1 rowsep-1" id="Watchdog_interface_design__table_jck_jgt_c1c__entry__1">函数原型</th>
<th class="- topic/entry entry colsep-0 rowsep-1" id="Watchdog_interface_design__table_jck_jgt_c1c__entry__2">static int aic_wdt_start(struct watchdog_device
*wdt_dev)</th>
</tr>
</thead><tbody class="- topic/tbody tbody">
<tr class="- topic/row">
<td class="- topic/entry entry colsep-1 rowsep-1" headers="Watchdog_interface_design__table_jck_jgt_c1c__entry__1">功能说明</td>
<td class="- topic/entry entry colsep-0 rowsep-1" headers="Watchdog_interface_design__table_jck_jgt_c1c__entry__2">使能一个 Watchdog 通道device</td>
</tr>
<tr class="- topic/row">
<td class="- topic/entry entry colsep-1 rowsep-1" headers="Watchdog_interface_design__table_jck_jgt_c1c__entry__1">参数定义</td>
<td class="- topic/entry entry colsep-0 rowsep-1" headers="Watchdog_interface_design__table_jck_jgt_c1c__entry__2">wdt_dev - 指向 Watchdog 设备的指针</td>
</tr>
<tr class="- topic/row">
<td class="- topic/entry entry colsep-1 rowsep-1" headers="Watchdog_interface_design__table_jck_jgt_c1c__entry__1">返回值</td>
<td class="- topic/entry entry colsep-0 rowsep-1" headers="Watchdog_interface_design__table_jck_jgt_c1c__entry__2">0成功</td>
</tr>
<tr class="- topic/row">
<td class="- topic/entry entry colsep-1 rowsep-0" headers="Watchdog_interface_design__table_jck_jgt_c1c__entry__1">注意事项</td>
<td class="- topic/entry entry colsep-0 rowsep-0" headers="Watchdog_interface_design__table_jck_jgt_c1c__entry__2">如果当前通道的 Watchdog 已经是使能状态,将执行 ping 操作(喂狗)。</td>
</tr>
</tbody></table></div>
<div class="table-container"><table class="- topic/table table frame-all" id="Watchdog_interface_design__table_kck_jgt_c1c" data-ofbid="Watchdog_interface_design__table_kck_jgt_c1c" data-cols="2"><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"> 2</span><span class="table--title-label-punctuation">. </span></span><span class="table--title">aic_wdt_stop</span></caption><colgroup><col style="width:25%"/><col style="width:75%"/></colgroup><thead class="- topic/thead thead">
<tr class="- topic/row">
<th class="- topic/entry entry colsep-1 rowsep-1" id="Watchdog_interface_design__table_kck_jgt_c1c__entry__1">函数原型</th>
<th class="- topic/entry entry colsep-0 rowsep-1" id="Watchdog_interface_design__table_kck_jgt_c1c__entry__2">static int aic_wdt_stop(struct watchdog_device
*wdt_dev)</th>
</tr>
</thead><tbody class="- topic/tbody tbody">
<tr class="- topic/row">
<td class="- topic/entry entry colsep-1 rowsep-1" headers="Watchdog_interface_design__table_kck_jgt_c1c__entry__1">功能说明</td>
<td class="- topic/entry entry colsep-0 rowsep-1" headers="Watchdog_interface_design__table_kck_jgt_c1c__entry__2">关闭一个 Watchdog 通道device</td>
</tr>
<tr class="- topic/row">
<td class="- topic/entry entry colsep-1 rowsep-1" headers="Watchdog_interface_design__table_kck_jgt_c1c__entry__1">参数定义</td>
<td class="- topic/entry entry colsep-0 rowsep-1" headers="Watchdog_interface_design__table_kck_jgt_c1c__entry__2">wdt_dev - 指向 Watchdog 设备的指针</td>
</tr>
<tr class="- topic/row">
<td class="- topic/entry entry colsep-1 rowsep-1" headers="Watchdog_interface_design__table_kck_jgt_c1c__entry__1">返回值</td>
<td class="- topic/entry entry colsep-0 rowsep-1" headers="Watchdog_interface_design__table_kck_jgt_c1c__entry__2">0成功</td>
</tr>
<tr class="- topic/row">
<td class="- topic/entry entry colsep-1 rowsep-0" headers="Watchdog_interface_design__table_kck_jgt_c1c__entry__1">注意事项</td>
<td class="- topic/entry entry colsep-0 rowsep-0" headers="Watchdog_interface_design__table_kck_jgt_c1c__entry__2">-</td>
</tr>
</tbody></table></div>
<div class="table-container"><table class="- topic/table table frame-all" id="Watchdog_interface_design__table_lck_jgt_c1c" data-ofbid="Watchdog_interface_design__table_lck_jgt_c1c" data-cols="2"><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"> 3</span><span class="table--title-label-punctuation">. </span></span><span class="table--title">aic_wdt_pin</span></caption><colgroup><col style="width:25%"/><col style="width:75%"/></colgroup><thead class="- topic/thead thead">
<tr class="- topic/row">
<th class="- topic/entry entry colsep-1 rowsep-1" id="Watchdog_interface_design__table_lck_jgt_c1c__entry__1">函数原型</th>
<th class="- topic/entry entry colsep-0 rowsep-1" id="Watchdog_interface_design__table_lck_jgt_c1c__entry__2">static int aic_wdt_ping(struct watchdog_device
*wdt_dev)</th>
</tr>
</thead><tbody class="- topic/tbody tbody">
<tr class="- topic/row">
<td class="- topic/entry entry colsep-1 rowsep-1" headers="Watchdog_interface_design__table_lck_jgt_c1c__entry__1">功能说明</td>
<td class="- topic/entry entry colsep-0 rowsep-1" headers="Watchdog_interface_design__table_lck_jgt_c1c__entry__2">清零指定的 Watchdog 通道计数器,相当于“喂狗”操作</td>
</tr>
<tr class="- topic/row">
<td class="- topic/entry entry colsep-1 rowsep-1" headers="Watchdog_interface_design__table_lck_jgt_c1c__entry__1">参数定义</td>
<td class="- topic/entry entry colsep-0 rowsep-1" headers="Watchdog_interface_design__table_lck_jgt_c1c__entry__2">wdt_dev - 指向 Watchdog 设备的指针</td>
</tr>
<tr class="- topic/row">
<td class="- topic/entry entry colsep-1 rowsep-1" headers="Watchdog_interface_design__table_lck_jgt_c1c__entry__1">返回值</td>
<td class="- topic/entry entry colsep-0 rowsep-1" headers="Watchdog_interface_design__table_lck_jgt_c1c__entry__2">0成功</td>
</tr>
<tr class="- topic/row">
<td class="- topic/entry entry colsep-1 rowsep-0" headers="Watchdog_interface_design__table_lck_jgt_c1c__entry__1">注意事项</td>
<td class="- topic/entry entry colsep-0 rowsep-0" headers="Watchdog_interface_design__table_lck_jgt_c1c__entry__2">需要先调用 aic_wdt_start(),再调用此接口</td>
</tr>
</tbody></table></div>
<div class="table-container"><table class="- topic/table table frame-all" id="Watchdog_interface_design__table_mck_jgt_c1c" data-ofbid="Watchdog_interface_design__table_mck_jgt_c1c" data-cols="2"><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"> 4</span><span class="table--title-label-punctuation">. </span></span><span class="table--title">aic_wdt_set_timeout</span></caption><colgroup><col style="width:25%"/><col style="width:75%"/></colgroup><thead class="- topic/thead thead">
<tr class="- topic/row">
<th class="- topic/entry entry colsep-1 rowsep-1" id="Watchdog_interface_design__table_mck_jgt_c1c__entry__1">函数原型</th>
<th class="- topic/entry entry colsep-0 rowsep-1" id="Watchdog_interface_design__table_mck_jgt_c1c__entry__2">static int aic_wdt_set_timeout(struct watchdog_device
*wdt_dev, unsigned int timeout)</th>
</tr>
</thead><tbody class="- topic/tbody tbody">
<tr class="- topic/row">
<td class="- topic/entry entry colsep-1 rowsep-1" headers="Watchdog_interface_design__table_mck_jgt_c1c__entry__1">功能说明</td>
<td class="- topic/entry entry colsep-0 rowsep-1" headers="Watchdog_interface_design__table_mck_jgt_c1c__entry__2">给指定的 Watchdog 设备设置一个超时</td>
</tr>
<tr class="- topic/row">
<td class="- topic/entry entry colsep-1 rowsep-1" headers="Watchdog_interface_design__table_mck_jgt_c1c__entry__1">参数定义</td>
<td class="- topic/entry entry colsep-0 rowsep-1" headers="Watchdog_interface_design__table_mck_jgt_c1c__entry__2">wdt_dev - 指向 Watchdog 设备的指针 timetout - 超时的数值,单位:秒</td>
</tr>
<tr class="- topic/row">
<td class="- topic/entry entry colsep-1 rowsep-1" headers="Watchdog_interface_design__table_mck_jgt_c1c__entry__1">返回值</td>
<td class="- topic/entry entry colsep-0 rowsep-1" headers="Watchdog_interface_design__table_mck_jgt_c1c__entry__2">0成功</td>
</tr>
<tr class="- topic/row">
<td class="- topic/entry entry colsep-1 rowsep-0" headers="Watchdog_interface_design__table_mck_jgt_c1c__entry__1">注意事项</td>
<td class="- topic/entry entry colsep-0 rowsep-0" headers="Watchdog_interface_design__table_mck_jgt_c1c__entry__2">1. 在 Watchdog 初始化时配置的最大、最小 timeout 参数Watchdog
Core 会去做校验,如果超出范围,将采用上一次有效的 timeout 参数值。2.
clr_thd 会和 timeout 一起设置到 Watchdog 控制器。</td>
</tr>
</tbody></table></div>
<div class="table-container"><table class="- topic/table table frame-all" id="Watchdog_interface_design__table_nck_jgt_c1c" data-ofbid="Watchdog_interface_design__table_nck_jgt_c1c" data-cols="2"><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"> 5</span><span class="table--title-label-punctuation">. </span></span><span class="table--title">aic_wdt_set_pretimeout</span></caption><colgroup><col style="width:25%"/><col style="width:75%"/></colgroup><thead class="- topic/thead thead">
<tr class="- topic/row">
<th class="- topic/entry entry colsep-1 rowsep-1" id="Watchdog_interface_design__table_nck_jgt_c1c__entry__1">函数原型</th>
<th class="- topic/entry entry colsep-0 rowsep-1" id="Watchdog_interface_design__table_nck_jgt_c1c__entry__2">static int aic_wdt_set_pretimeout(struct watchdog_device
*wdt_dev,unsigned int pretimeout)</th>
</tr>
</thead><tbody class="- topic/tbody tbody">
<tr class="- topic/row">
<td class="- topic/entry entry colsep-1 rowsep-1" headers="Watchdog_interface_design__table_nck_jgt_c1c__entry__1">功能说明</td>
<td class="- topic/entry entry colsep-0 rowsep-1" headers="Watchdog_interface_design__table_nck_jgt_c1c__entry__2">给指定的 Watchdog 设备设置一个预超时</td>
</tr>
<tr class="- topic/row">
<td class="- topic/entry entry colsep-1 rowsep-1" headers="Watchdog_interface_design__table_nck_jgt_c1c__entry__1">参数定义</td>
<td class="- topic/entry entry colsep-0 rowsep-1" headers="Watchdog_interface_design__table_nck_jgt_c1c__entry__2">wdt_dev - 指向 Watchdog 设备的指针 pretimetout - 预超时的数值,单位:秒</td>
</tr>
<tr class="- topic/row">
<td class="- topic/entry entry colsep-1 rowsep-1" headers="Watchdog_interface_design__table_nck_jgt_c1c__entry__1">返回值</td>
<td class="- topic/entry entry colsep-0 rowsep-1" headers="Watchdog_interface_design__table_nck_jgt_c1c__entry__2">0成功</td>
</tr>
<tr class="- topic/row">
<td class="- topic/entry entry colsep-1 rowsep-0" headers="Watchdog_interface_design__table_nck_jgt_c1c__entry__1">注意事项</td>
<td class="- topic/entry entry colsep-0 rowsep-0" headers="Watchdog_interface_design__table_nck_jgt_c1c__entry__2">pretimeout 必须要小于该 Watchdog 通道的 timeout 参数,这个有效性检查会在 Core 中去做(所以合理的 ioctl 操作是先设置 timeout、再设置 pretimeout如果 pretimeout 无效将返回出错。</td>
</tr>
</tbody></table></div>
<div class="table-container"><table class="- topic/table table frame-all" id="Watchdog_interface_design__table_pck_jgt_c1c" data-ofbid="Watchdog_interface_design__table_pck_jgt_c1c" data-cols="2"><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"> 6</span><span class="table--title-label-punctuation">. </span></span><span class="table--title">aic_wdt_restart</span></caption><colgroup><col style="width:25%"/><col style="width:75%"/></colgroup><thead class="- topic/thead thead">
<tr class="- topic/row">
<th class="- topic/entry entry colsep-1 rowsep-1" id="Watchdog_interface_design__table_pck_jgt_c1c__entry__1">函数原型</th>
<th class="- topic/entry entry colsep-0 rowsep-1" id="Watchdog_interface_design__table_pck_jgt_c1c__entry__2">static int aic_wdt_restart(struct watchdog_device
*wdt_dev,unsigned long action, void *data)</th>
</tr>
</thead><tbody class="- topic/tbody tbody">
<tr class="- topic/row">
<td class="- topic/entry entry colsep-1 rowsep-1" headers="Watchdog_interface_design__table_pck_jgt_c1c__entry__1">功能说明</td>
<td class="- topic/entry entry colsep-0 rowsep-1" headers="Watchdog_interface_design__table_pck_jgt_c1c__entry__2">用于重启整个系统(方法是设置 timeout 是 0Watchdog 会立即触发超时重启)</td>
</tr>
<tr class="- topic/row">
<td class="- topic/entry entry colsep-1 rowsep-1" headers="Watchdog_interface_design__table_pck_jgt_c1c__entry__1">参数定义</td>
<td class="- topic/entry entry colsep-0 rowsep-1" headers="Watchdog_interface_design__table_pck_jgt_c1c__entry__2">
<ul class="- topic/ul ul" id="Watchdog_interface_design__ul_djq_nmj_bcc" data-ofbid="Watchdog_interface_design__ul_djq_nmj_bcc">
<li class="- topic/li li" data-ofbid="d115244e428__20250123155210">wdt_dev - 指向 Watchdog 设备的指针 </li>
<li class="- topic/li li" data-ofbid="d115244e431__20250123155210">action - 需要执行的操作类型(定义详见“注意事项”),目前统一按重启处理 </li>
<li class="- topic/li li" data-ofbid="d115244e434__20250123155210">data - 附加数据,暂未用到</li>
</ul>
</td>
</tr>
<tr class="- topic/row">
<td class="- topic/entry entry colsep-1 rowsep-1" headers="Watchdog_interface_design__table_pck_jgt_c1c__entry__1">返回值</td>
<td class="- topic/entry entry colsep-0 rowsep-1" headers="Watchdog_interface_design__table_pck_jgt_c1c__entry__2">0成功</td>
</tr>
<tr class="- topic/row">
<td class="- topic/entry entry colsep-1 rowsep-0" headers="Watchdog_interface_design__table_pck_jgt_c1c__entry__1">注意事项</td>
<td class="- topic/entry entry colsep-0 rowsep-0" headers="Watchdog_interface_design__table_pck_jgt_c1c__entry__2">-</td>
</tr>
</tbody></table></div>
<div class="- topic/p p" data-ofbid="d115244e461__20250123155210">action 的定义详见
<span class="+ topic/ph sw-d/filepath ph filepath">include/linux/reboot.h</span><pre class="+ topic/pre pr-d/codeblock pre codeblock language-c" id="Watchdog_interface_design__codeblock_cfm_sgt_c1c" data-ofbid="Watchdog_interface_design__codeblock_cfm_sgt_c1c"><code>#<span class="hl-directive">define</span> SYS_DOWN <span class="hl-number">0x0001</span> <em class="hl-comment">/* Notify of system down */</em>
#<span class="hl-directive">define</span> SYS_RESTART SYS_DOWN
#<span class="hl-directive">define</span> SYS_HALT <span class="hl-number">0x0002</span> <em class="hl-comment">/* Notify of system halt */</em>
#<span class="hl-directive">define</span> SYS_POWER_OFF <span class="hl-number">0x0003</span> <em class="hl-comment">/* Notify of system power off */</em></code></pre></div>
</section>
</div>
</article></main></div>
</div>
<nav role="navigation" id="wh_topic_toc" aria-label="On this page" class="col-lg-2 d-none d-lg-block navbar d-print-none">
<div id="wh_topic_toc_content">
<div class=" wh_topic_toc "><div class="wh_topic_label">在本页上</div><ul><li class="section-item"><div class="section-title"><a href="#Watchdog_interface_design__section_vvn_1gt_c1c" data-tocid="Watchdog_interface_design__section_vvn_1gt_c1c">外部接口</a></div></li><li class="section-item"><div class="section-title"><a href="#Watchdog_interface_design__section_jcj_lgt_c1c" data-tocid="Watchdog_interface_design__section_jcj_lgt_c1c">内部接口</a></div></li></ul></div>
</div>
</nav>
</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-23
</div>
</div>
</div>
</footer>
<button id="go2top" class="d-print-none" title="返回顶部">
<span class="oxy-icon oxy-icon-up"></span>
</button>
<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>