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

238 lines
20 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="非命令队列模式,即 normal 模式。 GE normal 模式的控制流程如下所示: 当用户态通过 open 函数打开 /dev/ge 设备节点,会调用到驱动中的 open。 当用户通过 close 关闭驱动时,会调用到驱动中的 release。 在 open 中主要是实现了模块 clock 的打开操作, 在 release 中实现了模块 clock 的关闭操作。 当用户态有多个用户打开 GE ..."/><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.creator" content="yan.wang"/><meta name="DC.date.created" content="2024-01-17"/><meta name="DC.date.modified" content="2024-12-04"/><meta name="DC.format" content="HTML5"/><meta name="DC.identifier" content="ge_normal_mode"/><meta name="DC.language" content="zh-CN"/><title>非命令队列模式</title><!-- Build number 2023110923. --><meta name="wh-path2root" content="../../../"/><meta name="wh-toc-id" content=""/><meta name="wh-source-relpath" content="topics/sdk/ge/ge_normal_mode.dita"/><meta name="wh-out-relpath" content="topics/sdk/ge/ge_normal_mode.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="ge_normal_mode" 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-lg-10 col-md-10 col-sm-10 col-xs-12" id="wh_topic_body">
<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" href="http://172.16.35.88/tasks/jdssno1uvvbf2mltu9kb9v3if05d5gopuakboe8hlud18rma/edit/F:/aicdita/aicdita-cn/topics/sdk/ge/ge_normal_mode.dita">Edit online</a></span><h1 class="- topic/title title topictitle1" id="ariaid-title1">非命令队列模式</h1><div class="date inPage">4 Dec 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="d333764e23__20250121171837">非命令队列模式,即 normal 模式。</p><div class="- topic/p p" data-ofbid="d333764e25__20250121171837">GE normal 模式的控制流程如下所示:<ul class="- topic/ul ul" id="ge_normal_mode__ul_stj_lx4_bcc" data-ofbid="ge_normal_mode__ul_stj_lx4_bcc"><li class="- topic/li li" data-ofbid="d333764e28__20250121171837">当用户态通过 open 函数打开 /dev/ge 设备节点,会调用到驱动中的 open。</li><li class="- topic/li li" data-ofbid="d333764e30__20250121171837">当用户通过 close 关闭驱动时,会调用到驱动中的 release。</li><li class="- topic/li li" data-ofbid="d333764e32__20250121171837">在 open 中主要是实现了模块 clock 的打开操作, 在 release 中实现了模块 clock 的关闭操作。</li><li class="- topic/li li" data-ofbid="d333764e34__20250121171837">当用户态有多个用户打开 GE 驱动时,对驱动打开次数进行引用计数。</li><li class="- topic/li li" data-ofbid="d333764e36__20250121171837">至少有一个用户打开 GE 驱动时打开 GE 的 clock。</li><li class="- topic/li li" data-ofbid="d333764e38__20250121171837">当所有的用户都关闭 GE 驱动时关闭 GE 的 clock。 </li></ul></div><div class="- topic/p p" data-ofbid="d333764e40__20250121171837">
<figure class="- topic/fig fig fignone" id="ge_normal_mode__fig_uvv_gbb_d1c" data-ofbid="ge_normal_mode__fig_uvv_gbb_d1c"><br/><div class="imagecenter"><img class="- topic/image image imagecenter" id="ge_normal_mode__image_bvc_hbb_d1c" src="../../../images/ge/ge_sw_normal.png" alt="ge_sw_normal"/></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">非命令队列模式架构</span></figcaption></figure>
</div><div class="- topic/p p" data-ofbid="d333764e49__20250121171837">在 Normal 模式下,用户态可用 <span class="+ topic/keyword pr-d/apiname keyword apiname">ioctl</span> 控制 GE包括以下几种操作<ul class="- topic/ul ul" id="ge_normal_mode__ul_d2l_jbb_d1c" data-ofbid="ge_normal_mode__ul_d2l_jbb_d1c"><li class="- topic/li li" data-ofbid="d333764e55__20250121171837">
<p class="- topic/p p" data-ofbid="d333764e57__20250121171837"><span class="+ topic/keyword pr-d/apiname keyword apiname">IOC_GE_VERSION</span></p>
</li><li class="- topic/li li" data-ofbid="d333764e61__20250121171837">
<p class="- topic/p p" data-ofbid="d333764e63__20250121171837"><span class="+ topic/keyword pr-d/apiname keyword apiname">IOC_GE_MODE</span></p>
</li><li class="- topic/li li" data-ofbid="d333764e67__20250121171837">
<p class="- topic/p p" data-ofbid="d333764e69__20250121171837"><span class="+ topic/keyword pr-d/apiname keyword apiname">IOC_GE_FILLRECT</span></p>
</li><li class="- topic/li li" data-ofbid="d333764e73__20250121171837">
<p class="- topic/p p" data-ofbid="d333764e75__20250121171837"><span class="+ topic/keyword pr-d/apiname keyword apiname">IOC_GE_BITBLT</span></p>
</li><li class="- topic/li li" data-ofbid="d333764e79__20250121171837">
<p class="- topic/p p" data-ofbid="d333764e81__20250121171837"><span class="+ topic/keyword pr-d/apiname keyword apiname">IOC_GE_ROTATE</span></p>
</li></ul></div><p class="- topic/p p" data-ofbid="d333764e85__20250121171837">在 normal 模式下,对
<span class="+ topic/keyword pr-d/apiname keyword apiname">IOC_GE_FILLRECT</span><span class="+ topic/keyword pr-d/apiname keyword apiname">IOC_GE_BITBLT</span><span class="+ topic/keyword pr-d/apiname keyword apiname">IOC_GE_ROTATE</span>
接口的调用是同步的,即硬件执行任务完成后接口调用才会返回。 </p><section class="- topic/section section" id="ge_normal_mode__section_bq5_vpr_ndc" data-ofbid="ge_normal_mode__section_bq5_vpr_ndc"><h2 class="- topic/title title sectiontitle">GE 控制函数</h2>
<div class="- topic/p p" data-ofbid="d333764e101__20250121171837">
<ul class="- topic/ul ul" id="ge_normal_mode__ul_uz4_nqr_ndc" data-ofbid="ge_normal_mode__ul_uz4_nqr_ndc"><li class="- topic/li li" data-ofbid="d333764e104__20250121171837">
<div class="- topic/p p" data-ofbid="d333764e106__20250121171837"><strong class="+ topic/ph hi-d/b ph b">函数 <span class="+ topic/keyword pr-d/apiname keyword apiname">ge_open</span></strong>:打开
GE<pre class="+ topic/pre pr-d/codeblock pre codeblock language-c" id="ge_normal_mode__codeblock_vvs_4qr_ndc" data-ofbid="ge_normal_mode__codeblock_vvs_4qr_ndc"><strong class="hl-keyword">static</strong> <strong class="hl-keyword">int</strong> ge_open(<strong class="hl-keyword">struct</strong> inode *inode, <strong class="hl-keyword">struct</strong> file *file)
{
mutex_lock(&amp;g_data-&gt;lock);
<strong class="hl-keyword">if</strong> (g_data-&gt;refs == <span class="hl-number">0</span>) {
ge_clk_enable(g_data);
}
g_data-&gt;refs++;
mutex_unlock(&amp;g_data-&gt;lock);
<strong class="hl-keyword">return</strong> nonseekable_open(inode, file);
}
</pre></div>
</li><li class="- topic/li li" data-ofbid="d333764e115__20250121171837">
<div class="- topic/p p" data-ofbid="d333764e117__20250121171837"><strong class="+ topic/ph hi-d/b ph b">函数 <span class="+ topic/keyword pr-d/apiname keyword apiname">ge_release</span></strong>:关闭
GE<pre class="+ topic/pre pr-d/codeblock pre codeblock language-c" id="ge_normal_mode__codeblock_ny3_3bb_d1c" data-ofbid="ge_normal_mode__codeblock_ny3_3bb_d1c"><strong class="hl-keyword">static</strong> <strong class="hl-keyword">int</strong> ge_release(<strong class="hl-keyword">struct</strong> inode *inode, <strong class="hl-keyword">struct</strong> file *file)
{
mutex_lock(&amp;g_data-&gt;lock);
<strong class="hl-keyword">if</strong> (g_data-&gt;refs == <span class="hl-number">1</span>) {
ge_clk_disable(g_data);
}
g_data-&gt;refs--;
mutex_unlock(&amp;g_data-&gt;lock);
<strong class="hl-keyword">return</strong> <span class="hl-number">0</span>;
}</pre></div>
</li></ul>
</div>
</section><section class="- topic/section section" id="ge_normal_mode__section_z4j_qbb_d1c" data-ofbid="ge_normal_mode__section_z4j_qbb_d1c"><h2 class="- topic/title title sectiontitle">关键流程设计</h2>
<p class="- topic/p p" data-ofbid="d333764e135__20250121171837">在 GE normal 模式下GE 驱动各种功能通过 <span class="+ topic/keyword pr-d/apiname keyword apiname">ioctrl</span> 调用实现。</p>
<div class="- topic/p p" data-ofbid="d333764e141__20250121171837">每一次 <span class="+ topic/keyword pr-d/apiname keyword apiname">ioctrl</span> 的调用,都包括以下步骤:<ol class="- topic/ol ol" id="ge_normal_mode__ol_nnr_smz_2dc" data-ofbid="ge_normal_mode__ol_nnr_smz_2dc"><li class="- topic/li li" data-ofbid="d333764e147__20250121171837">GE 参数配置。</li><li class="- topic/li li" data-ofbid="d333764e149__20250121171837">GE 模块中断开启。</li><li class="- topic/li li" data-ofbid="d333764e151__20250121171837">GE 硬件启动。</li><li class="- topic/li li" data-ofbid="d333764e153__20250121171837">GE 等待中断,当前线程进入等待状态,直到收到中断通知。</li><li class="- topic/li li" data-ofbid="d333764e155__20250121171837">硬件完成任务后,关闭中断。</li></ol>
</div>
<p class="- topic/p p" data-ofbid="d333764e159__20250121171837"><span class="+ topic/keyword pr-d/apiname keyword apiname">ioctrl</span> 通过 mutex 保护, 确保多线程环境下的安全性。在 normal 模式下,支持多用户同时打开驱动设备节点,并调用
<span class="+ topic/keyword pr-d/apiname keyword apiname">ioctrl</span></p>
<figure class="- topic/fig fig fignone" id="ge_normal_mode__fig_elx_qbb_d1c" data-ofbid="ge_normal_mode__fig_elx_qbb_d1c"><br/><div class="imagecenter"><img class="- topic/image image imagecenter" id="ge_normal_mode__image_apj_qbb_d1c" src="../../../images/ge/ge_sw_normal_interrupt.png" alt="normal_interrupt"/></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">Normal 模式中断流程</span></figcaption></figure>
<div class="- topic/p p" data-ofbid="d333764e175__20250121171837">等待中断流程:<ul class="- topic/ul ul" id="ge_normal_mode__ul_v1k_hpm_f1c" data-ofbid="ge_normal_mode__ul_v1k_hpm_f1c"><li class="- topic/li li" data-ofbid="d333764e178__20250121171837">
<p class="- topic/p p" data-ofbid="d333764e180__20250121171837">在执行 <span class="+ topic/keyword pr-d/apiname keyword apiname">probe</span>
时初始化等待队列:<span class="+ topic/keyword pr-d/apiname keyword apiname">init_waitqueue_head(&amp;data-&gt;wait)</span></p>
</li><li class="- topic/li li" data-ofbid="d333764e189__20250121171837">
<p class="- topic/p p" data-ofbid="d333764e191__20250121171837"><span class="+ topic/keyword pr-d/apiname keyword apiname">ioctl</span> 中调用如下函数,使当前进程在等待队列中睡眠:</p>
<p class="- topic/p p" data-ofbid="d333764e197__20250121171837"><span class="+ topic/keyword pr-d/apiname keyword apiname">wait_event_timeout(data-&gt;wait, data-&gt;status,
msecs_to_jiffies(GE_TIMEOUT_MS))</span></p>
</li><li class="- topic/li li" data-ofbid="d333764e202__20250121171837">
<p class="- topic/p p" data-ofbid="d333764e204__20250121171837">在中断服务程序中调用 <span class="+ topic/keyword pr-d/apiname keyword apiname">wake_up(&amp;data-&gt;wait)</span>,唤醒等待队列中的睡眠进程。</p>
</li></ul></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="#ge_normal_mode__section_bq5_vpr_ndc" data-tocid="ge_normal_mode__section_bq5_vpr_ndc">GE 控制函数</a></div></li><li class="section-item"><div class="section-title"><a href="#ge_normal_mode__section_z4j_qbb_d1c" data-tocid="ge_normal_mode__section_z4j_qbb_d1c">关键流程设计</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-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>