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

226 lines
23 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="Luban-Lite SDK 支持多个芯片平台,在 BringUp 之前,务必确认板卡使用的 SoC 具体型号以配置正确的引脚和内存。遵照以下流程确认相应的 SoC 型号并修改配置: 确认 SoC 的具体型号并阅读对应的芯片手册 —— 引脚复用章节,确认每个引脚能提供的功能。 打开 SoC 的 target/ SoC / board /pinmux.c 引脚定义文件,配置引脚数量。 ..."/><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="topic"/><meta name="DC.relation" content="../../../topics/sdk/bringup/chapter-bringup.html"/><meta name="DC.relation" content="../../../topics/sdk/bringup/lite-bringup-prepare.html"/><meta name="DC.relation" content="../../../topics/sdk/bringup/lite-bringup-ram.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="id"/><meta name="DC.language" content="zh-CN"/><title>引脚配置</title><!-- Build number 2023110923. --><meta name="wh-path2root" content="../../../"/><meta name="wh-toc-id" content="id-d5856e2273"/><meta name="wh-source-relpath" content="topics/sdk/bringup/lite-bringup-soc.dita"/><meta name="wh-out-relpath" content="topics/sdk/bringup/lite-bringup-soc.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="id" 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 "><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/bringup/chapter-bringup.html">BringUp</a><div class="wh-tooltip"><p class="shortdesc">在硬件上电后快速初始化系统,为操作系统的启动准备好必要的硬件环境。</p></div></div></div></li><li class="active"><div class="topicref" data-id="id"><div class="title"><a href="../../../topics/sdk/bringup/lite-bringup-soc.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/bringup/lite-bringup-prepare.html" title="准备工作" aria-label="上一主题: 准备工作" rel="prev"></a></span>
<span class="navnext"><a class="- topic/link link" href="../../../topics/sdk/bringup/lite-bringup-ram.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-d5856e989" 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_rtos.html" id="revinfo_linux-d5856e989-link">修订记录</a></div></div></li><li role="treeitem" aria-expanded="false"><div data-tocid="id-d5856e1003" class="topicref" data-id="id" data-state="not-ready"><span role="button" tabindex="0" aria-labelledby="button-expand-action id-d5856e1003-link" class="wh-expand-btn"></span><div class="title"><a href="../../../topics/sdk/env/sdk-compile.html" id="id-d5856e1003-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="id-d5856e1152" class="topicref" data-id="id" data-state="not-ready"><span role="button" tabindex="0" aria-labelledby="button-expand-action id-d5856e1152-link" class="wh-expand-btn"></span><div class="title"><a href="../../../topics/sdk/advanced/sdk-usage.html" id="id-d5856e1152-link">使用指南</a><div class="wh-tooltip"><p class="shortdesc">系统镜像、编译选项、开发板、应用等相关的详细使用说明。</p></div></div></div></li><li role="treeitem" aria-expanded="false"><div data-tocid="concept_rcx_czh_pzb-d5856e1416" 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-d5856e1416-link" class="wh-expand-btn"></span><div class="title"><a href="../../../topics/sdk/chapter-app.html" id="concept_rcx_czh_pzb-d5856e1416-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-d5856e2119" class="topicref" data-id="id" data-state="not-ready"><span role="button" tabindex="0" aria-labelledby="button-expand-action id-d5856e2119-link" class="wh-expand-btn"></span><div class="title"><a href="../../../topics/sdk/peripheral/peripheral-intro.html" id="id-d5856e2119-link">外设移植</a><div class="wh-tooltip"><p class="shortdesc"><span class="ph">CTP、U 盘、SD 卡、有线和无线网络</span>等外设的介绍和使用说明。</p></div></div></div></li><li role="treeitem" aria-expanded="true"><div data-tocid="id-d5856e2244" class="topicref" data-id="id" data-state="expanded"><span role="button" tabindex="0" aria-labelledby="button-collapse-action id-d5856e2244-link" class="wh-expand-btn"></span><div class="title"><a href="../../../topics/sdk/bringup/chapter-bringup.html" id="id-d5856e2244-link">BringUp</a><div class="wh-tooltip"><p class="shortdesc">在硬件上电后快速初始化系统,为操作系统的启动准备好必要的硬件环境。</p></div></div></div><ul role="group" class="navbar-nav nav-list"><li role="treeitem"><div data-tocid="id-d5856e2259" class="topicref" data-id="id" data-state="leaf"><span role="button" class="wh-expand-btn"></span><div class="title"><a href="../../../topics/sdk/bringup/lite-bringup-prepare.html" id="id-d5856e2259-link">准备工作</a></div></div></li><li role="treeitem" class="active"><div data-tocid="id-d5856e2273" class="topicref" data-id="id" data-state="leaf"><span role="button" class="wh-expand-btn"></span><div class="title"><a href="../../../topics/sdk/bringup/lite-bringup-soc.html" id="id-d5856e2273-link">引脚配置</a></div></div></li><li role="treeitem"><div data-tocid="id-d5856e2285" class="topicref" data-id="id" data-state="leaf"><span role="button" class="wh-expand-btn"></span><div class="title"><a href="../../../topics/sdk/bringup/lite-bringup-ram.html" id="id-d5856e2285-link">内存配置</a></div></div></li><li role="treeitem"><div data-tocid="id-d5856e2297" class="topicref" data-id="id" data-state="leaf"><span role="button" class="wh-expand-btn"></span><div class="title"><a href="../../../topics/sdk/bringup/lite-bringup-storage.html" id="id-d5856e2297-link">存储配置</a></div></div></li><li role="treeitem"><div data-tocid="id-d5856e2309" class="topicref" data-id="id" data-state="leaf"><span role="button" class="wh-expand-btn"></span><div class="title"><a href="../../../topics/sdk/bringup/lite-bringup-console.html" id="id-d5856e2309-link">调试配置</a></div></div></li><li role="treeitem"><div data-tocid="id-d5856e2321" class="topicref" data-id="id" data-state="leaf"><span role="button" class="wh-expand-btn"></span><div class="title"><a href="../../../topics/sdk/bringup/lite-bringup-display.html" id="id-d5856e2321-link">屏幕配置</a></div></div></li><li role="treeitem"><div data-tocid="id-d5856e2333" class="topicref" data-id="id" data-state="leaf"><span role="button" class="wh-expand-btn"></span><div class="title"><a href="../../../topics/sdk/bringup/lite-bringup-samples.html" id="id-d5856e2333-link">示例程序</a></div></div></li></ul></li><li role="treeitem" aria-expanded="false"><div data-tocid="id-d5856e2345" class="topicref" data-id="id" data-state="not-ready"><span role="button" tabindex="0" aria-labelledby="button-expand-action id-d5856e2345-link" class="wh-expand-btn"></span><div class="title"><a href="../../../topics/sdk/chapter-advanced-app.html" id="id-d5856e2345-link">高级应用</a><div class="wh-tooltip"><p class="shortdesc">系统、存储、多媒体、接口、安全等模块的详细配置和设计说明。</p></div></div></div></li></ul></div>
</div>
</nav>
<div class="col-lg-9 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>
<div class=" wh_topic_content body "><main role="main"><article class="- topic/topic topic" 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/bringup/lite-bringup-soc.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: 2 minute(s)
</div><div class="- topic/body body"><div class="- topic/p p" data-ofbid="d50404e21__20250121171518"><span class="- topic/ph ph">Luban-Lite</span> SDK
支持多个芯片平台,在 BringUp 之前,务必确认板卡使用的 SoC
具体型号以配置正确的引脚和内存。遵照以下流程确认相应的
SoC 型号并修改配置:<ol class="- topic/ol ol" data-ofbid="d50404e25__20250121171518"><li class="- topic/li li" data-ofbid="d50404e26__20250121171518">确认 SoC 的具体型号并阅读对应的芯片手册 —— 引脚复用章节,确认每个引脚能提供的功能。</li><li class="- topic/li li" data-ofbid="d50404e28__20250121171518">打开 SoC 的
<span class="+ topic/ph sw-d/filepath ph filepath">target/<var class="+ topic/keyword sw-d/varname keyword varname">SoC</var>/<var class="+ topic/keyword sw-d/varname keyword varname">board</var>/pinmux.c</span>
引脚定义文件,配置引脚数量。<p class="- topic/p p" data-ofbid="d50404e39__20250121171518"><span class="- topic/ph ph">Luban-Lite</span> SDK 各个开发板引脚定义在
<span class="+ topic/ph sw-d/filepath ph filepath">target/<var class="+ topic/keyword sw-d/varname keyword varname">SoC</var>/<var class="+ topic/keyword sw-d/varname keyword varname">board</var>/pinmux.c</span>
文件中。SDK 中对于 SoC 支持的引脚数量没有显式限制。</p></li><li class="- topic/li li" data-ofbid="d50404e52__20250121171518">根据芯片手册及新添加板卡的原理图,确定对应的引脚功能,并在
<span class="+ topic/ph sw-d/filepath ph filepath">target/<var class="+ topic/keyword sw-d/varname keyword varname">SoC</var>/<var class="+ topic/keyword sw-d/varname keyword varname">board</var>/pinmux.c</span>
引脚定义文件中配置引脚功能。<p class="- topic/p p" data-ofbid="d50404e63__20250121171518">更改接口配置时,确保 pinmux 没有冲突,否则可能会引起未知错误。</p><p class="- topic/p p" data-ofbid="d50404e65__20250121171518">每个引脚同时只能被设置成一种功能,
每个 pin 脚的配置,使用结构体描述。</p><div class="- topic/p p" data-ofbid="d50404e67__20250121171518">
<pre class="+ topic/pre pr-d/codeblock pre codeblock language-c" id="id__pre_dk4_trv_1dc" data-ofbid="id__pre_dk4_trv_1dc"><strong class="hl-keyword">struct</strong> aic_pinmux
{
<strong class="hl-keyword">unsigned</strong> <strong class="hl-keyword">char</strong> func; <em class="hl-comment">// 功能编号</em>
<strong class="hl-keyword">unsigned</strong> <strong class="hl-keyword">char</strong> bias; <em class="hl-comment">// 内部上下拉设置,一般无需修改</em>
<strong class="hl-keyword">unsigned</strong> <strong class="hl-keyword">char</strong> drive; <em class="hl-comment">// 驱动能力,若需要修改,请联系专业人士确认</em>
<strong class="hl-keyword">char</strong> * name; <em class="hl-comment">// 引脚名称字符串,例如 "PA.0"</em>
};
</pre>
</div><div class="- topic/p p" data-ofbid="d50404e72__20250121171518">例如 PA.0 和 PA.1
引脚:<pre class="+ topic/pre pr-d/codeblock pre codeblock language-c" id="id__pre_evv_trv_1dc" data-ofbid="id__pre_evv_trv_1dc"><strong class="hl-keyword">struct</strong> aic_pinmux aic_pinmux_config[] = {
#ifdef AIC_USING_UART0
<em class="hl-comment">/* uart0 */</em>
{<span class="hl-number">5</span>, PIN_PULL_DIS, <span class="hl-number">3</span>, <span class="hl-string">"PA.0"</span>}, <em class="hl-comment">// PA.0 配置功能 5用作串口 0</em>
{<span class="hl-number">5</span>, PIN_PULL_DIS, <span class="hl-number">3</span>, <span class="hl-string">"PA.1"</span>}, <em class="hl-comment">// PA.1 配置功能 5用作串口 0</em>
#endif
...
}
</pre></div></li><li class="- topic/li li" data-ofbid="d50404e76__20250121171518">
<p class="- topic/p p" data-ofbid="d50404e78__20250121171518">拉低烧录引脚,使
SoC 进入烧录模式,烧录引脚。</p>
<div class="- topic/p p" data-ofbid="d50404e84__20250121171518">在新增加的板卡配置中,结合原理图配置引脚。 先加载项目对应的 <span class="+ topic/ph sw-d/filepath ph filepath">baremetal_helloworld</span>
工程,例如 <span class="+ topic/ph sw-d/filepath ph filepath">d21x_demo128-nand_baremetal_BootLoader</span>,再使用
<span class="+ topic/keyword sw-d/cmdname keyword cmdname">me</span>
进行配置,修改配置如下:<pre class="+ topic/pre pr-d/codeblock pre codeblock language-c" id="id__pre_bw5_5rv_1dc" data-ofbid="id__pre_bw5_5rv_1dc">BootLoader options
Upgrading
(PA.<span class="hl-number">0</span>) PIN to enter upgrading mode # 根据原理图修改对应的烧录引脚</pre></div>
</li><li class="- topic/li li" data-ofbid="d50404e98__20250121171518">在修改 <span class="+ topic/ph sw-d/filepath ph filepath">pinmux.c</span> 之后,先编译 BootLoader再编译 RT-Thread。<p class="- topic/p p" data-ofbid="d50404e103__20250121171518">项目中的
BootLoader 和 RT-Thread 是共享 pinmux 配置的,必须先编译 BootLoader否则 pinmux
配置可能无法生效。<span class="- topic/ph ph">Luban-Lite</span> 支持使用 <span class="+ topic/keyword sw-d/cmdname keyword cmdname">mb</span> 命令,一键编译
BootLoader 和 RT-Thread。</p></li><li class="- topic/li li" data-ofbid="d50404e111__20250121171518">对于使用了内部 LDO 给 CPU 供电的 SoC则需要使能内部 LDO否则可略过此步。例如D12x 支持单 3.3 V
供电设计。<pre class="+ topic/pre pr-d/codeblock pre codeblock language-c" data-ofbid="d50404e113__20250121171518">Board options &gt; Syscfg Parameter
[*] SYSCFG LDO1X enable ---&gt;
(<span class="hl-number">8</span>) LDO1X voltage value level &lt;<span class="hl-number">0</span>-<span class="hl-number">15</span>&gt;</pre></li></ol></div></div></article></main></div>
</div>
</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>