linuxOS_D21X/doc/topics/sdk/usb/usb-device_configuration.html
2025-01-23 16:35:08 +08:00

478 lines
57 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="USB Device Controller 配置 Linux Kernel Kconfig 文件中使能相应 UDC Driver &gt; Device Drivers &gt; USB support &gt; USB Gadget Support &gt; USB Peripheral Controller &lt;*&gt; ArtInChip USB2. 0 Device Controller DTS 文件中配置相应 ..."/><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/usb/usb_config.html"/><meta name="DC.relation" content="../../../topics/sdk/usb/usb-host_configuration.html"/><meta name="DC.relation" content="../../../topics/sdk/usb/usb-otg_configuration.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="usb_device_configuration"/><meta name="DC.language" content="zh-CN"/><title>USB Device 配置</title><!-- Generated with build number 2024112209. --><meta name="wh-path2root" content="../../../"/><meta name="wh-toc-id" content="usb_device_configuration-d4445e7341"/><meta name="wh-source-relpath" content="topics/sdk/usb/usb-device_configuration.dita"/><meta name="wh-out-relpath" content="topics/sdk/usb/usb-device_configuration.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="usb_device_configuration" 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="concept_nww_hzh_pzb"><div class="title"><a href="../../../topics/chapter-title/chapter-interface-sdk.html">接口</a><div class="wh-tooltip"><p class="shortdesc">CAN、CIR、GPAI、GPIO、I2C、PSADC、PWM 等接口模块的介绍和使用说明。</p></div></div></div></li><li><div class="topicref" data-id="usb_user_guide"><div class="title"><a href="../../../topics/sdk/usb/usb_user_guide.html">USB 使用指南</a></div></div></li><li><div class="topicref" data-id="usb_configuration"><div class="title"><a href="../../../topics/sdk/usb/usb_config.html">USB 配置</a></div></div></li><li class="active"><div class="topicref" data-id="usb_device_configuration"><div class="title"><a href="../../../topics/sdk/usb/usb-device_configuration.html">USB Device 配置</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/usb/usb-host_configuration.html" title="USB Host 配置" aria-label="上一主题: USB Host 配置" rel="prev"></a></span>
<span class="navnext"><a class="- topic/link link" href="../../../topics/sdk/usb/usb-otg_configuration.html" title="USB OTG 配置" aria-label="下一主题: USB OTG 配置" 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="false"><div data-tocid="chapter-system-d4445e3198" class="topicref" data-id="chapter-system" data-state="not-ready"><span role="button" tabindex="0" aria-labelledby="button-expand-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></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="true"><div data-tocid="concept_nww_hzh_pzb-d4445e5947" class="topicref" data-id="concept_nww_hzh_pzb" data-state="expanded"><span role="button" tabindex="0" aria-labelledby="button-collapse-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><ul role="group" class="navbar-nav nav-list"><li role="treeitem" aria-expanded="false"><div data-tocid="can-d4445e5964" class="topicref" data-id="can" data-state="not-ready"><span role="button" tabindex="0" aria-labelledby="button-expand-action can-d4445e5964-link" class="wh-expand-btn"></span><div class="title"><a href="../../../topics/sdk/can/can_user_guide.html" id="can-d4445e5964-link">CAN 使用指南</a></div></div></li><li role="treeitem" aria-expanded="false"><div data-tocid="cir-d4445e6020" class="topicref" data-id="cir" data-state="not-ready"><span role="button" tabindex="0" aria-labelledby="button-expand-action cir-d4445e6020-link" class="wh-expand-btn"></span><div class="title"><a href="../../../topics/sdk/cir/cir_user_guide.html" id="cir-d4445e6020-link">CIR 使用指南</a></div></div></li><li role="treeitem" aria-expanded="false"><div data-tocid="gpai-user-guide-d4445e6146" class="topicref" data-id="gpai-user-guide" data-state="not-ready"><span role="button" tabindex="0" aria-labelledby="button-expand-action gpai-user-guide-d4445e6146-link" class="wh-expand-btn"></span><div class="title"><a href="../../../topics/sdk/gpai/gpai_user_guide.html" id="gpai-user-guide-d4445e6146-link">GPAI 使用指南</a></div></div></li><li role="treeitem" aria-expanded="false"><div data-tocid="i2c_user_guide-d4445e6288" class="topicref" data-id="i2c_user_guide" data-state="not-ready"><span role="button" tabindex="0" aria-labelledby="button-expand-action i2c_user_guide-d4445e6288-link" class="wh-expand-btn"></span><div class="title"><a href="../../../topics/sdk/i2c/i2c_user_guide.html" id="i2c_user_guide-d4445e6288-link">I2C 使用指南</a></div></div></li><li role="treeitem" aria-expanded="false"><div data-tocid="id-d4445e6400" class="topicref" data-id="id" data-state="not-ready"><span role="button" tabindex="0" aria-labelledby="button-expand-action id-d4445e6400-link" class="wh-expand-btn"></span><div class="title"><a href="../../../topics/sdk/mac/mac_user_guide.html" id="id-d4445e6400-link">MAC 使用指南</a></div></div></li><li role="treeitem" aria-expanded="false"><div data-tocid="pbus_user_guide-d4445e6514" class="topicref" data-id="pbus_user_guide" data-state="not-ready"><span role="button" tabindex="0" aria-labelledby="button-expand-action pbus_user_guide-d4445e6514-link" class="wh-expand-btn"></span><div class="title"><a href="../../../topics/sdk/pbus/pbus-user-guide.html" id="pbus_user_guide-d4445e6514-link">PBUS 使用指南</a></div></div></li><li role="treeitem" aria-expanded="false"><div data-tocid="pinctrl_user_guide-d4445e6598" class="topicref" data-id="pinctrl_user_guide" data-state="not-ready"><span role="button" tabindex="0" aria-labelledby="button-expand-action pinctrl_user_guide-d4445e6598-link" class="wh-expand-btn"></span><div class="title"><a href="../../../topics/sdk/pinctrl/pinctrl-user-guide.html" id="pinctrl_user_guide-d4445e6598-link">PINCTRL 使用指南</a></div></div></li><li role="treeitem" aria-expanded="false"><div data-tocid="id-d4445e6738" class="topicref" data-id="id" data-state="not-ready"><span role="button" tabindex="0" aria-labelledby="button-expand-action id-d4445e6738-link" class="wh-expand-btn"></span><div class="title"><a href="../../../topics/sdk/pwm/pwm_user_guide.html" id="id-d4445e6738-link">PWM 使用指南</a></div></div></li><li role="treeitem" aria-expanded="false"><div data-tocid="rtp-user-guide-d4445e6822" class="topicref" data-id="rtp-user-guide" data-state="not-ready"><span role="button" tabindex="0" aria-labelledby="button-expand-action rtp-user-guide-d4445e6822-link" class="wh-expand-btn"></span><div class="title"><a href="../../../topics/sdk/rtp/rtp_user_guide.html" id="rtp-user-guide-d4445e6822-link">RTP 使用指南</a></div></div></li><li role="treeitem" aria-expanded="false"><div data-tocid="spi-d4445e6962" class="topicref" data-id="spi" data-state="not-ready"><span role="button" tabindex="0" aria-labelledby="button-expand-action spi-d4445e6962-link" class="wh-expand-btn"></span><div class="title"><a href="../../../topics/sdk/spi/spi_user_guide.html" id="spi-d4445e6962-link">SPI 使用指南</a></div></div></li><li role="treeitem" aria-expanded="false"><div data-tocid="id-d4445e7075" class="topicref" data-id="id" data-state="not-ready"><span role="button" tabindex="0" aria-labelledby="button-expand-action id-d4445e7075-link" class="wh-expand-btn"></span><div class="title"><a href="../../../topics/sdk/psadc/psadc_user_guide.html" id="id-d4445e7075-link">PSADC 使用指南</a></div></div></li><li role="treeitem" aria-expanded="false"><div data-tocid="uart_user_guide-d4445e7215" class="topicref" data-id="uart_user_guide" data-state="not-ready"><span role="button" tabindex="0" aria-labelledby="button-expand-action uart_user_guide-d4445e7215-link" class="wh-expand-btn"></span><div class="title"><a href="../../../topics/sdk/uart/uart_user_guide.html" id="uart_user_guide-d4445e7215-link">UART 使用指南</a></div></div></li><li role="treeitem" aria-expanded="true"><div data-tocid="usb_user_guide-d4445e7299" class="topicref" data-id="usb_user_guide" data-state="expanded"><span role="button" tabindex="0" aria-labelledby="button-collapse-action usb_user_guide-d4445e7299-link" class="wh-expand-btn"></span><div class="title"><a href="../../../topics/sdk/usb/usb_user_guide.html" id="usb_user_guide-d4445e7299-link">USB 使用指南</a></div></div><ul role="group" class="navbar-nav nav-list"><li role="treeitem" aria-expanded="true"><div data-tocid="usb_configuration-d4445e7313" class="topicref" data-id="usb_configuration" data-state="expanded"><span role="button" tabindex="0" aria-labelledby="button-collapse-action usb_configuration-d4445e7313-link" class="wh-expand-btn"></span><div class="title"><a href="../../../topics/sdk/usb/usb_config.html" id="usb_configuration-d4445e7313-link">USB 配置</a></div></div><ul role="group" class="navbar-nav nav-list"><li role="treeitem"><div data-tocid="usb_host_configuration-d4445e7327" class="topicref" data-id="usb_host_configuration" data-state="leaf"><span role="button" class="wh-expand-btn"></span><div class="title"><a href="../../../topics/sdk/usb/usb-host_configuration.html" id="usb_host_configuration-d4445e7327-link">USB Host 配置</a></div></div></li><li role="treeitem" class="active"><div data-tocid="usb_device_configuration-d4445e7341" class="topicref" data-id="usb_device_configuration" data-state="leaf"><span role="button" class="wh-expand-btn"></span><div class="title"><a href="../../../topics/sdk/usb/usb-device_configuration.html" id="usb_device_configuration-d4445e7341-link">USB Device 配置</a></div></div></li><li role="treeitem"><div data-tocid="usb_otg_configuration-d4445e7355" class="topicref" data-id="usb_otg_configuration" data-state="leaf"><span role="button" class="wh-expand-btn"></span><div class="title"><a href="../../../topics/sdk/usb/usb-otg_configuration.html" id="usb_otg_configuration-d4445e7355-link">USB OTG 配置</a></div></div></li></ul></li><li role="treeitem"><div data-tocid="usb_debug_guide-d4445e7369" class="topicref" data-id="usb_debug_guide" data-state="leaf"><span role="button" class="wh-expand-btn"></span><div class="title"><a href="../../../topics/sdk/usb/usb-debug_guide.html" id="usb_debug_guide-d4445e7369-link">调试指南</a></div></div></li><li role="treeitem" aria-expanded="false"><div data-tocid="usb_test_guide-d4445e7383" class="topicref" data-id="usb_test_guide" data-state="not-ready"><span role="button" tabindex="0" aria-labelledby="button-expand-action usb_test_guide-d4445e7383-link" class="wh-expand-btn"></span><div class="title"><a href="../../../topics/sdk/usb/usb-test_guide.html" id="usb_test_guide-d4445e7383-link">测试指南</a></div></div></li><li role="treeitem" aria-expanded="false"><div data-tocid="usb_design_intro-d4445e7468" class="topicref" data-id="usb_design_intro" data-state="not-ready"><span role="button" tabindex="0" aria-labelledby="button-expand-action usb_design_intro-d4445e7468-link" class="wh-expand-btn"></span><div class="title"><a href="../../../topics/sdk/usb/usb-design_intro.html" id="usb_design_intro-d4445e7468-link">设计说明</a></div></div></li><li role="treeitem" aria-expanded="false"><div data-tocid="usb_host_subsystem_code_structure-d4445e7594" class="topicref" data-id="usb_host_subsystem_code_structure" data-state="not-ready"><span role="button" tabindex="0" aria-labelledby="button-expand-action usb_host_subsystem_code_structure-d4445e7594-link" class="wh-expand-btn"></span><div class="title"><a href="../../../topics/sdk/usb/usb-host_subsystem_code_structure.html" id="usb_host_subsystem_code_structure-d4445e7594-link">USB Host 子系统代码架构</a></div></div></li><li role="treeitem" aria-expanded="false"><div data-tocid="usb_device_subsystem_code_structure-d4445e7762" class="topicref" data-id="usb_device_subsystem_code_structure" data-state="not-ready"><span role="button" tabindex="0" aria-labelledby="button-expand-action usb_device_subsystem_code_structure-d4445e7762-link" class="wh-expand-btn"></span><div class="title"><a href="../../../topics/sdk/usb/usb-device_subsystem_code_structure.html" id="usb_device_subsystem_code_structure-d4445e7762-link">USB Device 子系统代码架构</a></div></div></li><li role="treeitem"><div data-tocid="usb_common_issues-d4445e7930" class="topicref" data-id="usb_common_issues" data-state="leaf"><span role="button" class="wh-expand-btn"></span><div class="title"><a href="../../../topics/sdk/usb/usb_faq.html" id="usb_common_issues-d4445e7930-link">常见问题</a></div></div></li></ul></li></ul></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/usb/usb-device_configuration.dita">Edit online</a></span><h1 class="- topic/title title topictitle1" id="ariaid-title1">USB Device 配置</h1>
<div class="date inPage">15 Jan 2024</div><div style="color: gray;">
Read time: 9 minute(s)
</div>
<div class="- topic/body concept/conbody body conbody">
<section class="- topic/section section" id="usb_device_configuration__section_lbt_13z_21c" data-ofbid="usb_device_configuration__section_lbt_13z_21c"><h2 class="- topic/title title sectiontitle">USB Device Controller 配置</h2>
<div class="- topic/p p" data-ofbid="d108303e38__20250123155209">
<ol class="- topic/ol ol" id="usb_device_configuration__ol_dqg_pfz_21c" data-ofbid="usb_device_configuration__ol_dqg_pfz_21c">
<li class="- topic/li li" data-ofbid="d108303e42__20250123155209">
<div class="- topic/p p" data-ofbid="d108303e44__20250123155209">Linux Kernel Kconfig 文件中使能相应 UDC
Driver<pre class="+ topic/pre pr-d/codeblock pre codeblock language-c" id="usb_device_configuration__codeblock_jpz_pfz_21c" data-ofbid="usb_device_configuration__codeblock_jpz_pfz_21c"><code>&gt; Device Drivers &gt; USB support &gt; USB Gadget Support &gt; USB Peripheral Controller
&lt;*&gt; ArtInChip USB2.<span class="hl-number">0</span> Device Controller</code></pre></div>
</li>
<li class="- topic/li li" data-ofbid="d108303e50__20250123155209">
<div class="- topic/p p" data-ofbid="d108303e52__20250123155209">DTS 文件中配置相应 UDC
Device:<pre class="+ topic/pre pr-d/codeblock pre codeblock language-c" id="usb_device_configuration__codeblock_y4n_qfz_21c" data-ofbid="usb_device_configuration__codeblock_y4n_qfz_21c"><code>aicudc: udc@<span class="hl-number">10200000</span> {
compatible = <span class="hl-string">"artinchip,aic-udc-v1.0"</span>;
reg = &lt;<span class="hl-number">0x0</span> <span class="hl-number">0x10200000</span> <span class="hl-number">0x0</span> <span class="hl-number">0x1000</span>&gt;;
interrupts-extended = &lt;&amp;plic0 <span class="hl-number">34</span> IRQ_TYPE_LEVEL_HIGH&gt;;
clocks = &lt;&amp;cmu CLK_USBD&gt;, &lt;&amp;cmu CLK_USB_PHY0&gt;;
clock-names = <span class="hl-string">"udc_clk"</span>;
resets = &lt;&amp;rst RESET_USBD&gt;, &lt;&amp;rst RESET_USBPHY0&gt;;
reset-names = <span class="hl-string">"aicudc"</span>, <span class="hl-string">"aicudc-ecc"</span>;
status = <span class="hl-string">"okay"</span>;
};</code></pre></div>
</li>
</ol>
</div>
</section>
<section class="- topic/section section" id="usb_device_configuration__section_k5g_c3z_21c" data-ofbid="usb_device_configuration__section_k5g_c3z_21c"><h2 class="- topic/title title sectiontitle">USB Gadget 配置</h2>
<p class="- topic/p p" data-ofbid="d108303e66__20250123155209">为了方便 Linux 系统模拟成各种类型的 USB DeviceLinux 设计了一个 <code class="+ topic/ph pr-d/codeph ph codeph">Gadget Device</code> 。为了方便用户使用
Linux 又将 <code class="+ topic/ph pr-d/codeph ph codeph">ConfigFS</code> 引入 USB Device 子系统,用来灵活配置 <code class="+ topic/ph pr-d/codeph ph codeph">Gadget
Device</code></p>
<div class="- topic/p p" data-ofbid="d108303e78__20250123155209">所以在使用 USB Device 时,在 Linux Kernel 中把这两者都配置成使能。<ul class="- topic/ul ul" id="usb_device_configuration__ul_i1s_sfz_21c" data-ofbid="usb_device_configuration__ul_i1s_sfz_21c">
<li class="- topic/li li" data-ofbid="d108303e82__20250123155209"><strong class="+ topic/ph hi-d/b ph b">Gadget</strong><pre class="+ topic/pre pr-d/codeblock pre codeblock language-c" id="usb_device_configuration__codeblock_ign_tfz_21c" data-ofbid="usb_device_configuration__codeblock_ign_tfz_21c"><code>&gt; Device Drivers &gt; USB support
&lt;*&gt; USB Gadget Support ---&gt;</code></pre></li>
<li class="- topic/li li" data-ofbid="d108303e88__20250123155209"><strong class="+ topic/ph hi-d/b ph b">ConfigFS</strong><pre class="+ topic/pre pr-d/codeblock pre codeblock language-c" id="usb_device_configuration__codeblock_qgb_5fz_21c" data-ofbid="usb_device_configuration__codeblock_qgb_5fz_21c"><code>&gt; Device Drivers &gt; USB support &gt; USB Gadget Support
&lt;*&gt; USB Gadget functions configurable through configfs</code></pre></li>
</ul></div>
</section>
<section class="- topic/section section" id="usb_device_configuration__section_kdh_f3z_21c" data-ofbid="usb_device_configuration__section_kdh_f3z_21c"><h2 class="- topic/title title sectiontitle">USB Interface 配置</h2>
<div class="- topic/p p" data-ofbid="d108303e101__20250123155209"><code class="+ topic/ph pr-d/codeph ph codeph">Gadget Device</code> 基础之上,需要配置具体的 <code class="+ topic/ph pr-d/codeph ph codeph">Interface / Function</code>
才能提供具体的 USB Device 功能。USB Gadget Device 可以模拟成各种功能的 USB 外设例如USB 串口、USB 网口、U 盘等<ol class="- topic/ol ol" id="usb_device_configuration__ol_y1v_xfz_21c" data-ofbid="usb_device_configuration__ol_y1v_xfz_21c">
<li class="- topic/li li" data-ofbid="d108303e111__20250123155209">ACM 串口 配置。<ol class="- topic/ol ol" type="a" id="usb_device_configuration__ol_bzr_1gz_21c" data-ofbid="usb_device_configuration__ol_bzr_1gz_21c">
<li class="- topic/li li" data-ofbid="d108303e115__20250123155209">Linux Kernel Kconfig 文件中使能 <code class="+ topic/ph pr-d/codeph ph codeph">CDC ACM</code> 类型的
<code class="+ topic/ph pr-d/codeph ph codeph">Gadget functions</code>
<pre class="+ topic/pre pr-d/codeblock pre codeblock language-c" id="usb_device_configuration__codeblock_nk5_yfz_21c" data-ofbid="usb_device_configuration__codeblock_nk5_yfz_21c"><code>&gt; Device Drivers &gt; USB support &gt; USB Gadget Support
&lt;*&gt; USB Gadget functions configurable through configfs
[*] Abstract Control Model (CDC ACM)
&gt; Device Drivers
[*] Block devices ---&gt;</code></pre></li>
<li class="- topic/li li" data-ofbid="d108303e126__20250123155209">通过用户态的 configfs 文件接口创建包含 <code class="+ topic/ph pr-d/codeph ph codeph">ACM</code> 串口功能的 USB
Device<pre class="+ topic/pre pr-d/codeblock pre codeblock language-c" id="usb_device_configuration__codeblock_czp_zfz_21c" data-ofbid="usb_device_configuration__codeblock_czp_zfz_21c"><code>mount -t configfs none /sys/kernel/config
cd /sys/kernel/config/usb_gadget
mkdir g1
cd g1
echo <span class="hl-string">"0x1d6b"</span> &gt; idVendor
echo <span class="hl-string">"0x0104"</span> &gt; idProduct
mkdir strings/<span class="hl-number">0x409</span>
ls strings/<span class="hl-number">0x409</span>/
echo <span class="hl-string">"0123456789"</span> &gt; strings/<span class="hl-number">0x409</span>/serialnumber
echo <span class="hl-string">"AIC Inc."</span> &gt; strings/<span class="hl-number">0x409</span>/manufacturer
echo <span class="hl-string">"Bar Gadget"</span> &gt; strings/<span class="hl-number">0x409</span>/product
mkdir functions/acm.GS0
mkdir configs/c.<span class="hl-number">1</span>
ls configs/c.<span class="hl-number">1</span>
mkdir configs/c.<span class="hl-number">1</span>/strings/<span class="hl-number">0x409</span>
ls configs/c.<span class="hl-number">1</span>/strings/<span class="hl-number">0x409</span>/
echo <span class="hl-string">"ACM"</span> &gt; configs/c.<span class="hl-number">1</span>/strings/<span class="hl-number">0x409</span>/configuration
ln -s functions/acm.GS0 configs/c.<span class="hl-number">1</span>
echo `ls /sys/class/udc` &gt; UDC</code></pre></li>
</ol><div class="- topic/p p" data-ofbid="d108303e134__20250123155209">用户使用:<ol class="- topic/ol ol" type="a" id="usb_device_configuration__ol_rh2_dgz_21c" data-ofbid="usb_device_configuration__ol_rh2_dgz_21c">
<li class="- topic/li li" data-ofbid="d108303e138__20250123155209">
<p class="- topic/p p" data-ofbid="d108303e140__20250123155209">将单板的 USB Device 端口和 Windows PC 的 USB Host 端口连接,在 Windows PC
设备管理器会看到一个新的 USB 串口节点:</p>
<div class="- topic/p p" data-ofbid="d108303e143__20250123155209"><br/><div class="imagecenter"><img class="- topic/image image imagecenter" id="usb_device_configuration__image_sh2_dgz_21c" src="../../../images/usb/serial_win_res.png" alt="image0"/></div><br/></div>
</li>
<li class="- topic/li li" data-ofbid="d108303e151__20250123155209">
<p class="- topic/p p" data-ofbid="d108303e153__20250123155209">在 PC 端使用串口终端工具打开 COM12波特率使用 115200。</p>
</li>
<li class="- topic/li li" data-ofbid="d108303e157__20250123155209">
<p class="- topic/p p" data-ofbid="d108303e159__20250123155209">在单板端执行: <code class="+ topic/ph pr-d/codeph ph codeph">echo abd &gt; /dev/ttyGS0</code> ,在 PC
端串口就会收到该字符串:</p>
<div class="- topic/p p" data-ofbid="d108303e165__20250123155209"><br/><div class="imagecenter"><img class="- topic/image image imagecenter" id="usb_device_configuration__image_th2_dgz_21c" src="../../../images/usb/serial_win_term.png" width="480" alt="image1"/></div><br/></div>
</li>
<li class="- topic/li li" data-ofbid="d108303e173__20250123155209">
<p class="- topic/p p" data-ofbid="d108303e175__20250123155209">在单板端执行 <code class="+ topic/ph pr-d/codeph ph codeph">cat /dev/ttyGS0</code> ,在 PC 端写一个字符串
“123412345” ,点回车后,在单板端也能收到该字符串。</p>
</li>
</ol></div></li>
<li class="- topic/li li" data-ofbid="d108303e183__20250123155209">U 盘 配置<ol class="- topic/ol ol" type="a" id="usb_device_configuration__ol_yzc_mgz_21c" data-ofbid="usb_device_configuration__ol_yzc_mgz_21c">
<li class="- topic/li li" data-ofbid="d108303e187__20250123155209">Linux Kernel Kconfig 文件中,使能 <code class="+ topic/ph pr-d/codeph ph codeph">Mass storage</code> 类型的
<code class="+ topic/ph pr-d/codeph ph codeph">Gadget functions</code>
<pre class="+ topic/pre pr-d/codeblock pre codeblock language-c" id="usb_device_configuration__codeblock_yhh_3gz_21c" data-ofbid="usb_device_configuration__codeblock_yhh_3gz_21c"><code>&gt; Device Drivers &gt; USB support &gt; USB Gadget Support
&lt;*&gt; USB Gadget functions configurable through configfs
[*] Mass storage</code></pre></li>
<li class="- topic/li li" data-ofbid="d108303e198__20250123155209">Linux Kernel Kconfig
文件中,使能环回块设备:<pre class="+ topic/pre pr-d/codeblock pre codeblock language-c" id="usb_device_configuration__codeblock_aqc_lgz_21c" data-ofbid="usb_device_configuration__codeblock_aqc_lgz_21c"><code>&gt; Device Drivers
&lt;*&gt; Loopback device support</code></pre></li>
<li class="- topic/li li" data-ofbid="d108303e203__20250123155209">Busybox 中使能 <code class="+ topic/ph pr-d/codeph ph codeph">losetup</code>
命令:<pre class="+ topic/pre pr-d/codeblock pre codeblock language-c" id="usb_device_configuration__codeblock_psx_4gz_21c" data-ofbid="usb_device_configuration__codeblock_psx_4gz_21c"><code>&gt; Linux System Utilities
[*] losetup (<span class="hl-number">5.5</span> kb)</code></pre></li>
<li class="- topic/li li" data-ofbid="d108303e211__20250123155209">通过用户态的 configfs 文件接口创建包含 <code class="+ topic/ph pr-d/codeph ph codeph">Mass storage</code> 存储功能的 USB
Device<pre class="+ topic/pre pr-d/codeblock pre codeblock language-c" id="usb_device_configuration__codeblock_z33_qgz_21c" data-ofbid="usb_device_configuration__codeblock_z33_qgz_21c"><code>dd <strong class="hl-keyword">if</strong>=/dev/zero of=/tmp/mass.img bs=<span class="hl-number">128</span>K count=<span class="hl-number">132</span>
losetup /dev/loop0 /tmp/mass.img
mkdir /tmp/media
mkfs.vfat /dev/loop0
mount -t vfat /dev/loop0 /tmp/media/
cp /linuxrc /tmp/media
sync
mount -t configfs none /sys/kernel/config
cd /sys/kernel/config/usb_gadget
mkdir g_mass
cd g_mass
echo <span class="hl-string">"0x200"</span> &gt; bcdUSB
echo <span class="hl-string">"0x100"</span> &gt; bcdDevice
echo <span class="hl-string">"0x1234"</span> &gt; idVendor
echo <span class="hl-string">"0x5678"</span> &gt; idProduct
mkdir configs/c1.<span class="hl-number">1</span>
mkdir functions/mass_storage.<span class="hl-number">0</span>
echo /dev/loop0 &gt; functions/mass_storage.<span class="hl-number">0</span>/lun.<span class="hl-number">0</span>/file
mkdir strings/<span class="hl-number">0x409</span>
echo <span class="hl-string">"0123456789ABCDEF"</span> &gt; strings/<span class="hl-number">0x409</span>/serialnumber
echo <span class="hl-string">"river"</span> &gt; strings/<span class="hl-number">0x409</span>/manufacturer
echo <span class="hl-string">"river_msc"</span> &gt; strings/<span class="hl-number">0x409</span>/product
mkdir configs/c1.<span class="hl-number">1</span>/strings/<span class="hl-number">0x409</span>
echo <span class="hl-string">"abc"</span> &gt; configs/c1.<span class="hl-number">1</span>/strings/<span class="hl-number">0x409</span>/configuration
ln -s functions/mass_storage.<span class="hl-number">0</span> configs/c1.<span class="hl-number">1</span>
echo `ls /sys/class/udc` &gt; UDC</code></pre></li>
<li class="- topic/li li" data-ofbid="d108303e219__20250123155209">
<p class="- topic/p p" data-ofbid="d108303e221__20250123155209">将单板的 USB Device 端口和 Windows PC 的 USB Host 端口连接,在 Windows PC
上会看到一个新增的 U 盘,可以正常读写。</p>
</li>
</ol></li>
<li class="- topic/li li" data-ofbid="d108303e226__20250123155209">NCM 网口配置<ol class="- topic/ol ol" type="a" id="usb_device_configuration__ol_h3n_5gz_21c" data-ofbid="usb_device_configuration__ol_h3n_5gz_21c">
<li class="- topic/li li" data-ofbid="d108303e230__20250123155209">Linux Kernel Kconfig 文件中,使能 <code class="+ topic/ph pr-d/codeph ph codeph">CDC NCM</code> 类型的
<code class="+ topic/ph pr-d/codeph ph codeph">Gadget functions</code>
<pre class="+ topic/pre pr-d/codeblock pre codeblock language-c" id="usb_device_configuration__codeblock_j5c_wgz_21c" data-ofbid="usb_device_configuration__codeblock_j5c_wgz_21c"><code>&gt; Device Drivers &gt; USB support &gt; USB Gadget Support
&lt;*&gt; USB Gadget functions configurable through configfs
[*] Network Control Model (CDC NCM)</code></pre></li>
<li class="- topic/li li" data-ofbid="d108303e241__20250123155209">Linux Kernel Kconfig 文件中,使能 TCP/IP
支持:<pre class="+ topic/pre pr-d/codeblock pre codeblock language-c" id="usb_device_configuration__codeblock_czf_wgz_21c" data-ofbid="usb_device_configuration__codeblock_czf_wgz_21c"><code>&gt; Networking support &gt; Networking options
[*] TCP/IP networking</code></pre></li>
<li class="- topic/li li" data-ofbid="d108303e246__20250123155209">通过用户态的 configfs 文件接口创建包含 <code class="+ topic/ph pr-d/codeph ph codeph">CDC NCM</code> 以太网功能的 USB
Device<pre class="+ topic/pre pr-d/codeblock pre codeblock language-c" id="usb_device_configuration__codeblock_bcm_xgz_21c" data-ofbid="usb_device_configuration__codeblock_bcm_xgz_21c"><code>mount -t configfs none /sys/kernel/config
cd /sys/kernel/config/usb_gadget
mkdir g_ncm
cd g_ncm
echo <span class="hl-string">"0xA55A"</span> &gt; idVendor
echo <span class="hl-string">"0x0111"</span> &gt; idProduct
mkdir strings/<span class="hl-number">0x409</span>
echo <span class="hl-string">"0123456789"</span> &gt; strings/<span class="hl-number">0x409</span>/serialnumber
echo <span class="hl-string">"Xyz Inc."</span> &gt; strings/<span class="hl-number">0x409</span>/manufacturer
echo <span class="hl-string">"NCM gadget"</span> &gt; strings/<span class="hl-number">0x409</span>/product
mkdir functions/ncm.usb0
mkdir configs/c.<span class="hl-number">1</span>
mkdir configs/c.<span class="hl-number">1</span>/strings/<span class="hl-number">0x409</span>
echo <span class="hl-string">"NCM"</span> &gt; configs/c.<span class="hl-number">1</span>/strings/<span class="hl-number">0x409</span>/configuration
ln -s functions/ncm.usb0 configs/c.<span class="hl-number">1</span>
echo `ls /sys/class/udc` &gt; UDC
ifconfig usb0 up
ifconfig usb0 <span class="hl-number">173.11</span>.<span class="hl-number">1.1</span></code></pre></li>
<li class="- topic/li li" data-ofbid="d108303e254__20250123155209">
<p class="- topic/p p" data-ofbid="d108303e256__20250123155209">用户使用:</p>
<ol class="- topic/ol ol" type="i" id="usb_device_configuration__ol_uwl_zgz_21c" data-ofbid="usb_device_configuration__ol_uwl_zgz_21c">
<li class="- topic/li li" data-ofbid="d108303e261__20250123155209">
<p class="- topic/p p" data-ofbid="d108303e263__20250123155209">将单板的 USB Device 端口和 Ubuntu PC 的 USB Host 端口连接,在 Ubuntu PC
会看到一个新的网络接口,名字随机,类似: <code class="+ topic/ph pr-d/codeph ph codeph">enx0afcc15d3417</code>
</p>
</li>
<li class="- topic/li li" data-ofbid="d108303e270__20250123155209">
<p class="- topic/p p" data-ofbid="d108303e272__20250123155209">配置 Ubuntu PC 端的网口为同一网段地址, <code class="+ topic/ph pr-d/codeph ph codeph">sudo ifconfig
enx0afcc15d3417 173.11.1.2</code></p>
</li>
<li class="- topic/li li" data-ofbid="d108303e279__20250123155209">
<div class="- topic/p p" data-ofbid="d108303e281__20250123155209">两个网口相互可以 ping
通:<pre class="+ topic/pre pr-d/codeblock pre codeblock language-c" id="usb_device_configuration__pre_wwl_zgz_21c" data-ofbid="usb_device_configuration__pre_wwl_zgz_21c"><code>ping <span class="hl-number">173.11</span>.<span class="hl-number">1.1</span></code></pre><pre class="+ topic/pre pr-d/codeblock pre codeblock language-c" id="usb_device_configuration__codeblock_fvh_qyr_5dc" data-ofbid="usb_device_configuration__codeblock_fvh_qyr_5dc"><code>PING <span class="hl-number">173.11</span>.<span class="hl-number">1.1</span> (<span class="hl-number">173.11</span>.<span class="hl-number">1.1</span>) <span class="hl-number">56</span>(<span class="hl-number">84</span>) bytes of data.
<span class="hl-number">64</span> bytes from <span class="hl-number">173.11</span>.<span class="hl-number">1.1</span>: icmp_seq=<span class="hl-number">1</span> ttl=<span class="hl-number">64</span> time=<span class="hl-number">10.3</span> ms
<span class="hl-number">64</span> bytes from <span class="hl-number">173.11</span>.<span class="hl-number">1.1</span>: icmp_seq=<span class="hl-number">2</span> ttl=<span class="hl-number">64</span> time=<span class="hl-number">5.02</span> ms</code></pre></div>
</li>
</ol>
</li>
</ol></li>
<li class="- topic/li li" data-ofbid="d108303e292__20250123155209">ECM 网口 配置<ol class="- topic/ol ol" type="a" id="usb_device_configuration__ol_mss_1hz_21c" data-ofbid="usb_device_configuration__ol_mss_1hz_21c">
<li class="- topic/li li" data-ofbid="d108303e296__20250123155209">Linux Kernel Kconfig 文件中,使能 <code class="+ topic/ph pr-d/codeph ph codeph">CDC ECM</code> 类型的
<code class="+ topic/ph pr-d/codeph ph codeph">Gadget functions</code>
<pre class="+ topic/pre pr-d/codeblock pre codeblock language-c" id="usb_device_configuration__codeblock_n5h_bhz_21c" data-ofbid="usb_device_configuration__codeblock_n5h_bhz_21c"><code>&gt; Device Drivers &gt; USB support &gt; USB Gadget Support
&lt;*&gt; USB Gadget functions configurable through configfs
[*] Ethernet Control Model (CDC ECM)</code></pre></li>
<li class="- topic/li li" data-ofbid="d108303e307__20250123155209">Linux Kernel Kconfig 文件中,使能 TCP/IP
支持:<pre class="+ topic/pre pr-d/codeblock pre codeblock language-c" id="usb_device_configuration__codeblock_vlq_chz_21c" data-ofbid="usb_device_configuration__codeblock_vlq_chz_21c"><code>&gt; Networking support &gt; Networking options
[*] TCP/IP networking</code></pre></li>
<li class="- topic/li li" data-ofbid="d108303e312__20250123155209">通过用户态的 configfs 文件接口创建包含 <code class="+ topic/ph pr-d/codeph ph codeph">CDC ECM</code> 以太网功能的 USB
Device<pre class="+ topic/pre pr-d/codeblock pre codeblock language-c" id="usb_device_configuration__codeblock_uyr_chz_21c" data-ofbid="usb_device_configuration__codeblock_uyr_chz_21c"><code>mount -t configfs none /sys/kernel/config
cd /sys/kernel/config/usb_gadget
mkdir g_ecm
cd g_ecm
echo <span class="hl-string">"0x1d6b"</span> &gt; idVendor
echo <span class="hl-string">"0x0104"</span> &gt; idProduct
mkdir strings/<span class="hl-number">0x409</span>
echo <span class="hl-string">"0123456789"</span> &gt; strings/<span class="hl-number">0x409</span>/serialnumber
echo <span class="hl-string">"AIC Inc."</span> &gt; strings/<span class="hl-number">0x409</span>/manufacturer
echo <span class="hl-string">"Bar Gadget"</span> &gt; strings/<span class="hl-number">0x409</span>/product
mkdir functions/ecm.usb0
mkdir configs/c.<span class="hl-number">1</span>
mkdir configs/c.<span class="hl-number">1</span>/strings/<span class="hl-number">0x409</span>
echo <span class="hl-string">"ECM"</span> &gt; configs/c.<span class="hl-number">1</span>/strings/<span class="hl-number">0x409</span>/configuration
ln -s functions/ecm.usb0 configs/c.<span class="hl-number">1</span>
echo `ls /sys/class/udc` &gt; UDC
ifconfig usb0 up
ifconfig usb0 <span class="hl-number">173.11</span>.<span class="hl-number">1.1</span></code></pre></li>
<li class="- topic/li li" data-ofbid="d108303e320__20250123155209">用户使用:和上一节 NCM 网口 一样。</li>
</ol></li>
<li class="- topic/li li" data-ofbid="d108303e324__20250123155209">ADBD 配置<ol class="- topic/ol ol" type="a" id="usb_device_configuration__ol_ngc_fhz_21c" data-ofbid="usb_device_configuration__ol_ngc_fhz_21c">
<li class="- topic/li li" data-ofbid="d108303e328__20250123155209">Linux Kernel Kconfig 文件中,使能 <code class="+ topic/ph pr-d/codeph ph codeph">FunctionFS</code> 类型的
<code class="+ topic/ph pr-d/codeph ph codeph">Gadget functions</code>
<pre class="+ topic/pre pr-d/codeblock pre codeblock language-c" id="usb_device_configuration__codeblock_nlt_fhz_21c" data-ofbid="usb_device_configuration__codeblock_nlt_fhz_21c"><code>&gt; Device Drivers &gt; USB support &gt; USB Gadget Support
&lt;*&gt; USB Gadget functions configurable through configfs
[*] Function filesystem (FunctionFS)</code></pre></li>
<li class="- topic/li li" data-ofbid="d108303e339__20250123155209">Linux Kernel Kconfig 文件中,使能 TCP/IP
支持:<pre class="+ topic/pre pr-d/codeblock pre codeblock language-c" id="usb_device_configuration__codeblock_c3z_ghz_21c" data-ofbid="usb_device_configuration__codeblock_c3z_ghz_21c"><code>&gt; Networking support &gt; Networking options
[*] TCP/IP networking</code></pre></li>
<li class="- topic/li li" data-ofbid="d108303e344__20250123155209">通过用户态的 configfs 文件接口创建 <code class="+ topic/ph pr-d/codeph ph codeph">FunctionFS</code> 中的 USB Device挂载完
FunctionFS 文件系统以后, <code class="+ topic/ph pr-d/codeph ph codeph">adbd</code> 通过
<code class="+ topic/ph pr-d/codeph ph codeph">/dev/usb-ffs/adb</code> 中映射成文件的 endpoint 直接和 USB Host
进行通讯:<pre class="+ topic/pre pr-d/codeblock pre codeblock language-c" id="usb_device_configuration__codeblock_qcb_hhz_21c" data-ofbid="usb_device_configuration__codeblock_qcb_hhz_21c"><code>mkdir /dev/pts
mount -t devpts none /dev/pts
mount -t configfs none /sys/kernel/config
cd /sys/kernel/config/usb_gadget
mkdir g_adb
cd g_adb
echo <span class="hl-string">"0x18d1"</span> &gt; idVendor
echo <span class="hl-string">"0x4e26"</span> &gt; idProduct
mkdir configs/c.<span class="hl-number">1</span>
mkdir functions/ffs.adb
mkdir strings/<span class="hl-number">0x409</span>
mkdir configs/c.<span class="hl-number">1</span>/strings/<span class="hl-number">0x409</span>
echo <span class="hl-string">"0123456789ABCDEF"</span> &gt; strings/<span class="hl-number">0x409</span>/serialnumber
echo <span class="hl-string">"AIC Inc."</span> &gt; strings/<span class="hl-number">0x409</span>/manufacturer
echo <span class="hl-string">"FunctionFS gadget (adb)"</span> &gt; strings/<span class="hl-number">0x409</span>/product
echo <span class="hl-string">"Conf 1"</span> &gt; configs/c.<span class="hl-number">1</span>/strings/<span class="hl-number">0x409</span>/configuration
echo <span class="hl-number">120</span> &gt; configs/c.<span class="hl-number">1</span>/MaxPower
ln -s functions/ffs.adb configs/c.<span class="hl-number">1</span>
mkdir -p /dev/usb-ffs/adb
mount -o uid=<span class="hl-number">2000</span>,gid=<span class="hl-number">2000</span> -t functionfs adb /dev/usb-ffs/adb
ifconfig lo up
ifconfig
cd /root
adbd&amp;
sleep <span class="hl-number">1</span>
echo `ls /sys/class/udc/` &gt; /sys/kernel/config/usb_gadget/g_adb/UDC</code></pre></li>
<li class="- topic/li li" data-ofbid="d108303e358__20250123155209">将单板的 USB Device 端口和 PC 的 USB Host 端口连接,在 PC 端运行 <span class="+ topic/keyword sw-d/cmdname keyword cmdname">adb
shell</span> 命令即可进行 adb 操作。</li>
</ol></li>
</ol></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="#usb_device_configuration__section_lbt_13z_21c" data-tocid="usb_device_configuration__section_lbt_13z_21c">USB Device Controller 配置</a></div></li><li class="section-item"><div class="section-title"><a href="#usb_device_configuration__section_k5g_c3z_21c" data-tocid="usb_device_configuration__section_k5g_c3z_21c">USB Gadget 配置</a></div></li><li class="section-item"><div class="section-title"><a href="#usb_device_configuration__section_kdh_f3z_21c" data-tocid="usb_device_configuration__section_kdh_f3z_21c">USB Interface 配置</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>