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

217 lines
16 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="初始化流程 DCD 驱动的入口是 platform 驱动,初始化流程先获取 irq、reg、clk、reset 等资源并进行初始化,最后调用 usb_add_gadget_udc() 向系统中注册。 大致的流程如下: |--&gt;aic_udc_probe() |--&gt;gg-&gt;regs = devm_ioremap_resource(&amp;dev-&gt;dev, res); |--&gt;gg-&gt;reset = ..."/><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-02-04"/><meta name="DC.format" content="HTML5"/><meta name="DC.identifier" content="usb_device_key_procedures"/><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/usb/usb-device-key_procedures.dita"/><meta name="wh-out-relpath" content="topics/sdk/usb/usb-device-key_procedures.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="usb_device_key_procedures" 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/usb/usb-device-key_procedures.dita">Edit online</a></span><h1 class="- topic/title title topictitle1" id="ariaid-title1">关键流程设计</h1><div class="date inPage">4 Feb 2024</div><div style="color: gray;">
Read time: 1 minute(s)
</div><div class="- topic/body concept/conbody body conbody"><section class="- topic/section section" id="usb_device_key_procedures__section_kyj_qmz_21c" data-ofbid="usb_device_key_procedures__section_kyj_qmz_21c"><h2 class="- topic/title title sectiontitle">初始化流程</h2>
<p class="- topic/p p" data-ofbid="d169621e27__20250121171620">DCD 驱动的入口是 platform 驱动,初始化流程先获取 irq、reg、clk、reset 等资源并进行初始化,最后调用 usb_add_gadget_udc()
向系统中注册。</p>
<div class="- topic/p p" data-ofbid="d169621e30__20250121171620">大致的流程如下:<pre class="+ topic/pre pr-d/codeblock pre codeblock language-c" id="usb_device_key_procedures__codeblock_yvz_qmz_21c" data-ofbid="usb_device_key_procedures__codeblock_yvz_qmz_21c">|--&gt;aic_udc_probe()
|--&gt;gg-&gt;regs = devm_ioremap_resource(&amp;dev-&gt;dev, res);
|--&gt;gg-&gt;reset = devm_reset_control_get_optional(gg-&gt;dev, <span class="hl-string">"aicudc"</span>);
|--&gt;gg-&gt;reset_ecc = devm_reset_control_get_optional_shared(gg-&gt;dev,<span class="hl-string">"aicudc-ecc"</span>);
|--&gt;gg-&gt;clks[i] = of_clk_get(gg-&gt;dev-&gt;of_node, i);
|--&gt;aic_gadget_init(gg);
|--&gt;aic_low_hw_enable()
|--&gt;clk_prepare_enable(gg-&gt;clks[i]);
|--&gt;reset_control_deassert(gg-&gt;reset);
|--&gt;reset_control_deassert(gg-&gt;reset_ecc);
|--&gt;res = platform_get_resource(dev, IORESOURCE_IRQ, <span class="hl-number">0</span>);
|--&gt;gg-&gt;irq = res-&gt;start;
|--&gt;usb_add_gadget_udc(gg-&gt;dev, &amp;gg-&gt;gadget);</pre></div>
</section><section class="- topic/section section" id="usb_device_key_procedures__section_myj_qmz_21c" data-ofbid="usb_device_key_procedures__section_myj_qmz_21c"><h2 class="- topic/title title sectiontitle">ep 分配流程</h2>
<div class="- topic/p p" data-ofbid="d169621e40__20250121171620"><br/><div class="imagecenter"><img class="- topic/image image imagecenter" id="usb_device_key_procedures__image_nyj_qmz_21c" src="../../../images/usb/usb_dcd_ep_pool.png" alt="image5"/></div><br/></div>
<p class="- topic/p p" data-ofbid="d169621e45__20250121171620">如上图所示ep 资源的操作分为两部分:</p>
<ul class="- topic/ul ul" id="usb_device_key_procedures__ul_oyj_qmz_21c" data-ofbid="usb_device_key_procedures__ul_oyj_qmz_21c"><li class="- topic/li li" data-ofbid="d169621e49__20250121171620">
<p class="- topic/p p" data-ofbid="d169621e51__20250121171620">ep 资源池初始化。在 udc 驱动初始化的时候同时初始化了 ep 资源池,这样就决定了当前有多少个 ep 资源可用。</p>
</li><li class="- topic/li li" data-ofbid="d169621e54__20250121171620">
<p class="- topic/p p" data-ofbid="d169621e56__20250121171620">ep 资源的分配。gadget composite device 可以配置多个 interface 即 gadget function driver
function driver 启用时,会从资源池中分配需要的 ep。如果配置的 function driver 过多,就可能会分配失败。</p>
</li></ul>
</section><section class="- topic/section section" id="usb_device_key_procedures__section_pyj_qmz_21c" data-ofbid="usb_device_key_procedures__section_pyj_qmz_21c"><h2 class="- topic/title title sectiontitle">普通 ep 的 request 处理</h2>
<div class="- topic/p p" data-ofbid="d169621e65__20250121171620"><br/><div class="imagecenter"><img class="- topic/image image imagecenter" id="usb_device_key_procedures__image_qyj_qmz_21c" src="../../../images/usb/usb_dcd_ep_queue.png" alt="image6"/></div><br/></div>
<p class="- topic/p p" data-ofbid="d169621e70__20250121171620">如上图所示,对于普通 ep 的 reuqest 数据收发分为两步:</p>
<ul class="- topic/ul ul" id="usb_device_key_procedures__ul_ryj_qmz_21c" data-ofbid="usb_device_key_procedures__ul_ryj_qmz_21c"><li class="- topic/li li" data-ofbid="d169621e74__20250121171620">
<p class="- topic/p p" data-ofbid="d169621e76__20250121171620">request enqueue。首先调用 udc 的 <code class="+ topic/ph pr-d/codeph ph codeph">.queue()</code> 函数,将需要传输的数据插入到硬件控制器对应的
ep 寄存器当中。</p>
</li><li class="- topic/li li" data-ofbid="d169621e82__20250121171620">
<p class="- topic/p p" data-ofbid="d169621e84__20250121171620">complete callback。ep 数据收发完成会产生 <code class="+ topic/ph pr-d/codeph ph codeph">transfer complete</code>
中断,在中断服务程序中调用 <code class="+ topic/ph pr-d/codeph ph codeph">complete</code> 回调函数,结束整个 request 传输。</p>
</li></ul>
</section><section class="- topic/section section" id="usb_device_key_procedures__section_syj_qmz_21c" data-ofbid="usb_device_key_procedures__section_syj_qmz_21c"><h2 class="- topic/title title sectiontitle">ep0 的 request 处理</h2>
<div class="- topic/p p" data-ofbid="d169621e99__20250121171620"><br/><div class="imagecenter"><img class="- topic/image image imagecenter" id="usb_device_key_procedures__image_tyj_qmz_21c" src="../../../images/usb/usb_dcd_ep0_queue.png" alt="image7"/></div><br/></div>
<p class="- topic/p p" data-ofbid="d169621e104__20250121171620">如上图所示,对于 ep0 的 reuqest 数据收发和 普通 ep 基本一样,只是对数据的回调处理稍有不同。</p>
</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="#usb_device_key_procedures__section_kyj_qmz_21c" data-tocid="usb_device_key_procedures__section_kyj_qmz_21c">初始化流程</a></div></li><li class="section-item"><div class="section-title"><a href="#usb_device_key_procedures__section_myj_qmz_21c" data-tocid="usb_device_key_procedures__section_myj_qmz_21c">ep 分配流程</a></div></li><li class="section-item"><div class="section-title"><a href="#usb_device_key_procedures__section_pyj_qmz_21c" data-tocid="usb_device_key_procedures__section_pyj_qmz_21c">普通 ep 的 request 处理</a></div></li><li class="section-item"><div class="section-title"><a href="#usb_device_key_procedures__section_syj_qmz_21c" data-tocid="usb_device_key_procedures__section_syj_qmz_21c">ep0 的 request 处理</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>