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

232 lines
36 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="pinctrl 驱动 pinctrl 子系统对 controller 进行了软件抽象,并由 controller 所实现的操作函数集来管理各个 pin 脚的属性和复用。子系统中主要的数据结构关系如下图: 其相应的软件基本框架为: pinctrl 子系统的底层驱动实现,主要分为三部分: struct pinconf_ops 函数集实现,主要用来设置 pin 脚的电气参数,如上下拉,驱动能力等。 ..."/><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/pinctrl/pinctrl-design_intro.html"/><meta name="DC.relation" content="../../../topics/sdk/pinctrl/pinctrl-design_intro.html"/><meta name="DC.relation" content="../../../topics/sdk/pinctrl/pinctrl-key_procedures.html"/><meta name="DC.contributor" content="yan.wang"/><meta name="DC.creator" content="yan.wang"/><meta name="DC.date.modified" content="2024-01-15"/><meta name="DC.format" content="HTML5"/><meta name="DC.identifier" content="pinctrl_architecture"/><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="pinctrl_architecture-d4445e6668"/><meta name="wh-source-relpath" content="topics/sdk/pinctrl/pinctrl-architecture.dita"/><meta name="wh-out-relpath" content="topics/sdk/pinctrl/pinctrl-architecture.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="pinctrl_architecture" 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="pinctrl_user_guide"><div class="title"><a href="../../../topics/sdk/pinctrl/pinctrl-user-guide.html">PINCTRL 使用指南</a></div></div></li><li><div class="topicref" data-id="pinctrl_design_intro"><div class="title"><a href="../../../topics/sdk/pinctrl/pinctrl-design_intro.html">设计说明</a></div></div></li><li class="active"><div class="topicref" data-id="pinctrl_architecture"><div class="title"><a href="../../../topics/sdk/pinctrl/pinctrl-architecture.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/pinctrl/pinctrl-design_intro.html" title="设计说明" aria-label="上一主题: 设计说明" rel="prev"></a></span>
<span class="navnext"><a class="- topic/link link" href="../../../topics/sdk/pinctrl/pinctrl-key_procedures.html" title="关键流程设计" aria-label="下一主题: 关键流程设计" 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="true"><div data-tocid="pinctrl_user_guide-d4445e6598" class="topicref" data-id="pinctrl_user_guide" data-state="expanded"><span role="button" tabindex="0" aria-labelledby="button-collapse-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><ul role="group" class="navbar-nav nav-list"><li role="treeitem"><div data-tocid="pinctrl_configuration-d4445e6612" class="topicref" data-id="pinctrl_configuration" data-state="leaf"><span role="button" class="wh-expand-btn"></span><div class="title"><a href="../../../topics/sdk/pinctrl/pinctrl-configuration.html" id="pinctrl_configuration-d4445e6612-link">PINCTRL 配置</a></div></div></li><li role="treeitem"><div data-tocid="pinctrl_debug_guide-d4445e6626" class="topicref" data-id="pinctrl_debug_guide" data-state="leaf"><span role="button" class="wh-expand-btn"></span><div class="title"><a href="../../../topics/sdk/pinctrl/pinctrl-debug_guide.html" id="pinctrl_debug_guide-d4445e6626-link">调试指南</a></div></div></li><li role="treeitem"><div data-tocid="pinctrl_test_guide-d4445e6640" class="topicref" data-id="pinctrl_test_guide" data-state="leaf"><span role="button" class="wh-expand-btn"></span><div class="title"><a href="../../../topics/sdk/pinctrl/pinctrl-test_guide.html" id="pinctrl_test_guide-d4445e6640-link">测试指南</a></div></div></li><li role="treeitem" aria-expanded="true"><div data-tocid="pinctrl_design_intro-d4445e6654" class="topicref" data-id="pinctrl_design_intro" data-state="expanded"><span role="button" tabindex="0" aria-labelledby="button-collapse-action pinctrl_design_intro-d4445e6654-link" class="wh-expand-btn"></span><div class="title"><a href="../../../topics/sdk/pinctrl/pinctrl-design_intro.html" id="pinctrl_design_intro-d4445e6654-link">设计说明</a></div></div><ul role="group" class="navbar-nav nav-list"><li role="treeitem" class="active"><div data-tocid="pinctrl_architecture-d4445e6668" class="topicref" data-id="pinctrl_architecture" data-state="leaf"><span role="button" class="wh-expand-btn"></span><div class="title"><a href="../../../topics/sdk/pinctrl/pinctrl-architecture.html" id="pinctrl_architecture-d4445e6668-link">模块架构</a></div></div></li><li role="treeitem"><div data-tocid="pinctrl_key_procedures-d4445e6682" class="topicref" data-id="pinctrl_key_procedures" data-state="leaf"><span role="button" class="wh-expand-btn"></span><div class="title"><a href="../../../topics/sdk/pinctrl/pinctrl-key_procedures.html" id="pinctrl_key_procedures-d4445e6682-link">关键流程设计</a></div></div></li><li role="treeitem"><div data-tocid="pinctrl_data_structure_design-d4445e6696" class="topicref" data-id="pinctrl_data_structure_design" data-state="leaf"><span role="button" class="wh-expand-btn"></span><div class="title"><a href="../../../topics/sdk/pinctrl/pinctrl-data_structure_design.html" id="pinctrl_data_structure_design-d4445e6696-link">数据结构设计</a></div></div></li><li role="treeitem"><div data-tocid="pinctrl_interface_design-d4445e6710" class="topicref" data-id="pinctrl_interface_design" data-state="leaf"><span role="button" class="wh-expand-btn"></span><div class="title"><a href="../../../topics/sdk/pinctrl/pinctrl-interface_design.html" id="pinctrl_interface_design-d4445e6710-link">接口设计</a></div></div></li></ul></li><li role="treeitem"><div data-tocid="pinctrl_common_issues-d4445e6724" class="topicref" data-id="pinctrl_common_issues" data-state="leaf"><span role="button" class="wh-expand-btn"></span><div class="title"><a href="../../../topics/sdk/pinctrl/pinctrl-common_issues.html" id="pinctrl_common_issues-d4445e6724-link">常见问题</a></div></div></li></ul></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="false"><div data-tocid="usb_user_guide-d4445e7299" class="topicref" data-id="usb_user_guide" data-state="not-ready"><span role="button" tabindex="0" aria-labelledby="button-expand-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></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/pinctrl/pinctrl-architecture.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: 1 minute(s)
</div>
<div class="- topic/body concept/conbody body conbody">
<section class="- topic/section section" id="pinctrl_architecture__section_xzr_3gs_21c" data-ofbid="pinctrl_architecture__section_xzr_3gs_21c"><h2 class="- topic/title title sectiontitle">pinctrl 驱动</h2><p class="- topic/p p" data-ofbid="d68642e36__20250123155204">pinctrl 子系统对 controller 进行了软件抽象,并由 controller 所实现的操作函数集来管理各个 pin 脚的属性和复用。子系统中主要的数据结构关系如下图:</p><div class="- topic/p p" data-ofbid="d68642e38__20250123155204"><br/><div class="imagecenter"><img class="- topic/image image imagecenter" id="pinctrl_architecture__image_llh_tfs_21c" src="../../../images/pinctrl/pinctrl_data_struct.png" width="576" alt="pinctrl_data_struct"/></div><br/></div><p class="- topic/p p" data-ofbid="d68642e44__20250123155204">其相应的软件基本框架为:</p><div class="- topic/p p" data-ofbid="d68642e46__20250123155204"><br/><div class="imagecenter"><img class="- topic/image image imagecenter" id="pinctrl_architecture__image_mlh_tfs_21c" src="../../../images/pinctrl/pinctrl_subsystem.png" width="480" alt="pinctrl_subsystem"/></div><br/></div><p class="- topic/p p" data-ofbid="d68642e52__20250123155204">pinctrl 子系统的底层驱动实现,主要分为三部分:</p><ul class="- topic/ul ul" id="pinctrl_architecture__ul_nlh_tfs_21c" data-ofbid="pinctrl_architecture__ul_nlh_tfs_21c">
<li class="- topic/li li" data-ofbid="d68642e56__20250123155204">
<p class="- topic/p p" data-ofbid="d68642e58__20250123155204">struct pinconf_ops 函数集实现,主要用来设置 pin 脚的电气参数,如上下拉,驱动能力等。</p>
</li>
<li class="- topic/li li" data-ofbid="d68642e62__20250123155204">
<p class="- topic/p p" data-ofbid="d68642e64__20250123155204">struct pinctrl_ops 函数集实现,主要用来实现对 DTS 的解析,获取实现某一功能所需的 pin 脚信息。</p>
</li>
<li class="- topic/li li" data-ofbid="d68642e68__20250123155204">
<p class="- topic/p p" data-ofbid="d68642e70__20250123155204">struct pinmux_ops 函数集实现,主要用来实现功能复用,依据获取到的 pin 脚信息,实现底层的寄存器配置等。</p>
</li>
</ul></section>
<section class="- topic/section section" id="pinctrl_architecture__section_cby_lgs_21c" data-ofbid="pinctrl_architecture__section_cby_lgs_21c"><h2 class="- topic/title title sectiontitle">gpio 驱动</h2><p class="- topic/p p" data-ofbid="d68642e78__20250123155204">常见的 gpio 有外挂的 gpio 芯片以及 SOC 自身的 gpio 控制器linux 内核将这两种 gpio 统一看作是 gpio
chip 进行处理。gpio 子系统整体框架如下图:</p><div class="- topic/p p" data-ofbid="d68642e80__20250123155204"><br/><div class="imagecenter"><img class="- topic/image image imagecenter" id="pinctrl_architecture__image_plh_tfs_21c" src="../../../images/gpio/gpio_subsystem.png" width="480" alt="gpio_subsystem"/></div><br/></div><p class="- topic/p p" data-ofbid="d68642e86__20250123155204">gpio 子系统的核心就是 gpiolib。它的主要作用是</p><ol class="- topic/ol ol" id="pinctrl_architecture__ol_qlh_tfs_21c" data-ofbid="pinctrl_architecture__ol_qlh_tfs_21c">
<li class="- topic/li li" data-ofbid="d68642e90__20250123155204">
<p class="- topic/p p" data-ofbid="d68642e92__20250123155204">向下为 driver 提供注册 struct gpio_chip 的接口gpiochip_xxx()</p>
</li>
<li class="- topic/li li" data-ofbid="d68642e96__20250123155204">
<p class="- topic/p p" data-ofbid="d68642e98__20250123155204">向上为 consumer 提供引用 gpio 的接口gpiod_xxx()</p>
</li>
<li class="- topic/li li" data-ofbid="d68642e102__20250123155204">
<p class="- topic/p p" data-ofbid="d68642e104__20250123155204">实现字符设备的功能</p>
</li>
<li class="- topic/li li" data-ofbid="d68642e108__20250123155204">
<p class="- topic/p p" data-ofbid="d68642e110__20250123155204">注册 sysfs</p>
</li>
</ol><p class="- topic/p p" data-ofbid="d68642e114__20250123155204">作为 SOC 厂商,需要实现的驱动就是 driver 部分,所以,这部分的主要工作就是实现 chip 结构体中的函数集,并注册 controller。</p></section>
<section class="- topic/section section" id="pinctrl_architecture__section_wvt_mgs_21c" data-ofbid="pinctrl_architecture__section_wvt_mgs_21c"><h2 class="- topic/title title sectiontitle">irqchip 驱动</h2><p class="- topic/p p" data-ofbid="d68642e120__20250123155204">当 gpio 口接收中断时linux 内核是将 gpio 作为一个级联到 GIC 上的二级中断控制器处理的。一个典型的拓扑结构如下图:</p><div class="- topic/p p" data-ofbid="d68642e122__20250123155204"><br/><div class="imagecenter"><img class="- topic/image image imagecenter" id="pinctrl_architecture__image_slh_tfs_21c" src="../../../images/pinctrl/pinctrl_irq_arch.png" width="480" alt="irq_arch"/></div><br/></div><p class="- topic/p p" data-ofbid="d68642e128__20250123155204">linux 内核将此时的 GPIO 控制器看作是一个中断控制器,用 chip 进行软件抽象。所以需要实现相应的 gpio 中断控制器的驱动。按照 irqchip 子系统的框架,每一个中断线对应一个 desc 结构体,该结构体包含一个 irq是该中断线的 level 中断处理函数。该函数的主要作用是:打开或关闭相应中断号的中断,通知 CPU 中断处理完成。调用底层的中断处理函数。子系统中定义了几个不同的 level 函数,可以依据不同的中断类型和不同的中断控制器,选择不同的 level 函数。</p><p class="- topic/p p" data-ofbid="d68642e130__20250123155204">与 chip 的驱动实现有些类似irqchip 的驱动也主要是实现 chip 中的函数集。由于 gpio 中断控制器是一个二级中断控制器,所以驱动中需要做的工作有:</p><ul class="- topic/ul ul" id="pinctrl_architecture__ul_tlh_tfs_21c" data-ofbid="pinctrl_architecture__ul_tlh_tfs_21c">
<li class="- topic/li li" data-ofbid="d68642e134__20250123155204">
<p class="- topic/p p" data-ofbid="d68642e136__20250123155204">实现 gpio 中断控制器的驱动,主要工作是实现 chip 中的函数集</p>
</li>
<li class="- topic/li li" data-ofbid="d68642e140__20250123155204">
<p class="- topic/p p" data-ofbid="d68642e142__20250123155204">实现每个 controller 的中断线所对应的中断描述符的 irq用于在 gpio 触发中断时查找触发中断的 gpio line</p>
</li>
</ul></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="#pinctrl_architecture__section_xzr_3gs_21c" data-tocid="pinctrl_architecture__section_xzr_3gs_21c">pinctrl 驱动</a></div></li><li class="section-item"><div class="section-title"><a href="#pinctrl_architecture__section_cby_lgs_21c" data-tocid="pinctrl_architecture__section_cby_lgs_21c">gpio 驱动</a></div></li><li class="section-item"><div class="section-title"><a href="#pinctrl_architecture__section_wvt_mgs_21c" data-tocid="pinctrl_architecture__section_wvt_mgs_21c">irqchip 驱动</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>