Files
luban-lite-t3e-pro/doc/topics/sdk/boot/load-spiNand.html

286 lines
21 KiB
HTML
Raw Normal View History

2025-01-23 16:37:00 +08:00
<!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="官方版本的 SPL 并不支持从 SPI NAND 启动ArtInChip 增加了从 SPI NAND 的 MTD 分区 和 UBI 加载 U-Boot 的支持。 common/spl/spl_spi_nand.c 中注册了两个不同的 SPL 程序加载器。 #ifdef CONFIG_SPL_UBI /* Use priorty 0 to override other SPI device ..."/><meta name="DC.rights.owner" content="(C) 版权 2025"/><meta name="copyright" content="(C) 版权 2025"/><meta name="generator" content="DITA-OT"/><meta name="DC.type" content="concept"/><meta name="DC.contributor" content="yan.wang"/><meta name="DC.date.modified" content="2024-12-25"/><meta name="DC.format" content="HTML5"/><meta name="DC.identifier" content="concept_nsb_pj3_pzb"/><meta name="DC.language" content="zh-CN"/><title>SPI NAND 加载</title><!-- Build number 2023110923. --><meta name="wh-path2root" content="../../../"/><meta name="wh-toc-id" content=""/><meta name="wh-source-relpath" content="topics/sdk/boot/load-spiNand.dita"/><meta name="wh-out-relpath" content="topics/sdk/boot/load-spiNand.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="concept_nsb_pj3_pzb" class="wh_topic_page frmBody">
<a href="#wh_topic_body" class="sr-only sr-only-focusable">
跳转到主要内容
</a>
<header class="navbar navbar-default wh_header">
<div class="container-fluid">
<div class="wh_header_flex_container navbar-nav navbar-expand-md navbar-dark">
<div class="wh_logo_and_publication_title_container">
<div class="wh_logo_and_publication_title">
<a href="http://www.artinchip.com" class=" wh_logo d-none d-sm-block "><img src="../../../company-logo-white.png" alt="RTOS SDK 使用指南SDK 指南文件"/></a>
<div class=" wh_publication_title "><a href="../../../index.html"><span class="booktitle"><span class="ph mainbooktitle">RTOS SDK 使用指南</span><span class="ph booktitlealt">SDK 指南文件</span></span></a></div>
</div>
</div>
<div class="wh_top_menu_and_indexterms_link collapse navbar-collapse" id="wh_top_menu_and_indexterms_link">
</div>
</div>
</div>
</header>
<div class=" wh_search_input navbar-form wh_topic_page_search search " role="form">
<form id="searchForm" method="get" role="search" action="../../../search.html"><div><input type="search" placeholder="搜索 " class="wh_search_textfield" id="textToSearch" name="searchQuery" aria-label="搜索查询" required="required"/><button type="submit" class="wh_search_button" aria-label="搜索"><span class="search_input_text">搜索</span></button></div></form>
</div>
<div class="container-fluid" id="wh_topic_container">
<div class="row">
<nav class="wh_tools d-print-none navbar-expand-md" aria-label="Tools">
<div data-tooltip-position="bottom" class=" wh_breadcrumb "></div>
<div class="wh_right_tools">
<button class="wh_hide_highlight" aria-label="切换搜索突出显示" title="切换搜索突出显示"></button>
<button class="webhelp_expand_collapse_sections" data-next-state="collapsed" aria-label="折叠截面" title="折叠截面"></button>
<div class=" wh_print_link print d-none d-md-inline-block "><button onClick="window.print()" title="打印此页" aria-label="打印此页"></button></div>
</div>
</nav>
</div>
<div class="wh_content_area">
<div class="row">
<div class="col-lg-10 col-md-10 col-sm-10 col-xs-12" id="wh_topic_body">
<button id="wh_close_topic_toc_button" class="close-toc-button d-none" aria-label="Toggle topic table of content" aria-controls="wh_topic_toc" aria-expanded="true">
<span class="close-toc-icon-container">
<span class="close-toc-icon"></span>
</span>
</button>
<div class=" wh_topic_content body "><main role="main"><article class="- topic/topic concept/concept topic concept" role="article" aria-labelledby="ariaid-title1"><span class="edit-link" style="font-size:12px; opacity:0.6; text-align:right; vertical-align:middle"><a target="_blank" href="http://172.16.35.88/tasks/jdssno1uvvbf2mltu9kb9v3if05d5gopuakboe8hlud18rma/edit/F:/aicdita/aicdita-cn/topics/sdk/boot/load-spiNand.dita">Edit online</a></span><h1 class="- topic/title title topictitle1" id="ariaid-title1">SPI NAND 加载</h1><div class="date inPage">25 Dec 2024</div><div style="color: gray;">
Read time: 4 minute(s)
</div><div class="- topic/body concept/conbody body conbody"><p class="- topic/p p" data-ofbid="d303672e22__20250121171809">官方版本的 SPL 并不支持从 SPI NAND 启动ArtInChip 增加了从 SPI NAND 的 MTD 分区 和 UBI 加载 U-Boot 的支持。</p><div class="- topic/p p" data-ofbid="d303672e24__20250121171809"><span class="+ topic/ph sw-d/filepath ph filepath">common/spl/spl_spi_nand.c</span> 中注册了两个不同的 SPL
程序加载器。<pre class="+ topic/pre pr-d/codeblock pre codeblock language-c" id="concept_nsb_pj3_pzb__codeblock_t5d_spy_c1c" data-ofbid="concept_nsb_pj3_pzb__codeblock_t5d_spy_c1c">#ifdef CONFIG_SPL_UBI
<em class="hl-comment">/* Use priorty 0 to override other SPI device when this device is enabled. */</em>
SPL_LOAD_IMAGE_METHOD(<span class="hl-string">"SPINAND_UBI"</span>, <span class="hl-number">0</span>, BOOT_DEVICE_SPI, spl_ubi_load_image);
#<strong class="hl-keyword">else</strong>
SPL_LOAD_IMAGE_METHOD(<span class="hl-string">"SPINAND"</span>, <span class="hl-number">0</span>, BOOT_DEVICE_SPI, spl_spi_nand_load_image);
#endif</pre></div><section class="- topic/section section" id="concept_nsb_pj3_pzb__section_unf_s1h_bzb" data-ofbid="concept_nsb_pj3_pzb__section_unf_s1h_bzb"><h2 class="- topic/title title sectiontitle">U-Boot 保存在 MTD 分区</h2>
<ol class="- topic/ol ol" id="concept_nsb_pj3_pzb__ol_knj_hcx_5dc" data-ofbid="concept_nsb_pj3_pzb__ol_knj_hcx_5dc"><li class="- topic/li li" data-ofbid="d303672e36__20250121171809">
<div class="- topic/p p" data-ofbid="d303672e38__20250121171809">在 SPL 初始化过程中,通过 <span class="+ topic/keyword pr-d/apiname keyword apiname">boot_from_devices(spl_boot_list)</span>
函数调用,检查当前项目 所支持的 SPL
读取的存储介质类型,然后依次检查是否存在对应的程序加载器。<pre class="+ topic/pre pr-d/codeblock pre codeblock language-c" id="concept_nsb_pj3_pzb__codeblock_nnj_spy_c1c" data-ofbid="concept_nsb_pj3_pzb__codeblock_nnj_spy_c1c">board_init_r() <em class="hl-comment">// common/spl/spl.c</em>
|-&gt; boot_from_devices(spl_boot_list)
|-&gt; spl_ll_find_loader() <em class="hl-comment">// 根据 device 找到 spl_load_image 指针</em>
<em class="hl-comment">// 这里可能是各种介质的 load image 函数</em>
<em class="hl-comment">// SPL_LOAD_IMAGE_METHOD() 定义的 Loader</em>
<em class="hl-comment">// 可能是 MMC/SPI/BROM/...</em></pre></div>
</li><li class="- topic/li li" data-ofbid="d303672e46__20250121171809">
<p class="- topic/p p" data-ofbid="d303672e48__20250121171809">找到 SPL SPINAND Loader 之后,从项目配置的指定位置读取数据。</p>
<div class="- topic/p p" data-ofbid="d303672e51__20250121171809">CONFIG_SYS_SPI_NAND_U_BOOT_OFFS<pre class="+ topic/pre pr-d/codeblock pre codeblock language-c" id="concept_nsb_pj3_pzb__codeblock_c3j_gsy_c1c" data-ofbid="concept_nsb_pj3_pzb__codeblock_c3j_gsy_c1c">boot_from_devices(spl_boot_list); <em class="hl-comment">// common/spl/spl.c</em>
|-&gt; spl_ll_find_loader() <em class="hl-comment">// 根据 device 找到 spl_load_image 指针</em>
| <em class="hl-comment">// 此处通过遍历固件的 .u_boot_list_2_spl_image_loader_* 段</em>
| <em class="hl-comment">// 找到当前使能的存储介质驱动,然后逐个尝试</em>
|
|-&gt; spl_load_image(loader);
|-&gt; loader-&gt;load_image(spl_image, &amp;bootdev);
spl_spi_nand_load_image(); <em class="hl-comment">// arch/arm/mach-artinchip/spl_spi_nand.c</em>
|-&gt; spl_spi_nand_init();
| |-&gt; uclass_first_device(UCLASS_MTD, &amp;dev); <em class="hl-comment">// drivers/core/uclass.c</em>
| |-&gt; mtd_probe(dev);
| |-&gt; get_mtd_device(NULL, <span class="hl-number">0</span>);
|-&gt; spl_get_load_buffer(-<strong class="hl-keyword">sizeof</strong>(*header), <strong class="hl-keyword">sizeof</strong>(*header));
|-&gt; spl_spi_nand_read();
| <em class="hl-comment">// 读取头信息</em>
|-&gt; spl_parse_image_header(spl_image, header);
|-&gt; spl_spi_nand_read();<em class="hl-comment">// arch/arm/mach-artinchip/spl_spi_nand.c</em>
| <em class="hl-comment">// 读取整个 U-Boot 镜像</em>
|-&gt; mtd_block_isbad(mtd, off);
| <em class="hl-comment">// 跳过坏块</em>
|-&gt; mtd_read(); <em class="hl-comment">// drivers/mtd/mtdcore.c</em></pre></div>
</li></ol>
</section><section class="- topic/section section" id="concept_nsb_pj3_pzb__section_ynf_s1h_bzb" data-ofbid="concept_nsb_pj3_pzb__section_ynf_s1h_bzb"><h2 class="- topic/title title sectiontitle">U-Boot 保存在 UBI 中</h2>
<ol class="- topic/ol ol" id="concept_nsb_pj3_pzb__ol_kbd_jcx_5dc" data-ofbid="concept_nsb_pj3_pzb__ol_kbd_jcx_5dc"><li class="- topic/li li" data-ofbid="d303672e63__20250121171809">
<div class="- topic/p p" data-ofbid="d303672e65__20250121171809">在 SPL 初始化过程中,通过 <span class="+ topic/keyword pr-d/apiname keyword apiname">boot_from_devices(spl_boot_list)</span>
函数调用,检查当前项目 所支持的 SPL
读取的存储介质类型,然后依次检查是否存在对应的程序加载器。<pre class="+ topic/pre pr-d/codeblock pre codeblock language-c" id="concept_nsb_pj3_pzb__codeblock_u4x_gsy_c1c" data-ofbid="concept_nsb_pj3_pzb__codeblock_u4x_gsy_c1c">board_init_r() <em class="hl-comment">// common/spl/spl.c</em>
|-&gt; boot_from_devices(spl_boot_list)
|-&gt; spl_ll_find_loader() <em class="hl-comment">// 根据 device 找到 spl_load_image 指针</em>
<em class="hl-comment">// 这里可能是各种介质的 load image 函数</em>
<em class="hl-comment">// SPL_LOAD_IMAGE_METHOD() 定义的 Loader</em>
<em class="hl-comment">// 可能是 MMC/SPI/BROM/...</em></pre></div>
</li><li class="- topic/li li" data-ofbid="d303672e73__20250121171809">
<div class="- topic/p p" data-ofbid="d303672e75__20250121171809">找到 SPL SPINAND UBI Loader 之后,从项目配置的指定位置读取数据。<ul class="- topic/ul ul" id="concept_nsb_pj3_pzb__ul_a4f_s1h_bzb" data-ofbid="concept_nsb_pj3_pzb__ul_a4f_s1h_bzb"><li class="- topic/li li" data-ofbid="d303672e78__20250121171809">
<p class="- topic/p p" data-ofbid="d303672e80__20250121171809">CONFIG_SPL_UBI_INFO_ADDR</p>
</li><li class="- topic/li li" data-ofbid="d303672e83__20250121171809">
<p class="- topic/p p" data-ofbid="d303672e85__20250121171809">CONFIG_SPL_UBI_PEB_OFFSET</p>
</li><li class="- topic/li li" data-ofbid="d303672e88__20250121171809">
<p class="- topic/p p" data-ofbid="d303672e90__20250121171809">CONFIG_SPL_UBI_VID_OFFSET</p>
</li><li class="- topic/li li" data-ofbid="d303672e93__20250121171809">
<p class="- topic/p p" data-ofbid="d303672e95__20250121171809">CONFIG_SPL_UBI_LEB_START</p>
</li></ul></div>
<p class="- topic/p p" data-ofbid="d303672e99__20250121171809">或者从指定 Volume 中读取</p>
<div class="- topic/p p" data-ofbid="d303672e102__20250121171809">CONFIG_SPL_UBI_LOAD_MONITOR_VOLNAME<pre class="+ topic/pre pr-d/codeblock pre codeblock language-c" id="concept_nsb_pj3_pzb__codeblock_ktp_hsy_c1c" data-ofbid="concept_nsb_pj3_pzb__codeblock_ktp_hsy_c1c">boot_from_devices(spl_boot_list); <em class="hl-comment">// common/spl/spl.c</em>
|-&gt; spl_ll_find_loader() <em class="hl-comment">// 根据 device 找到 spl_load_image 指针</em>
| <em class="hl-comment">// 此处通过遍历固件的 .u_boot_list_2_spl_image_loader_* 段</em>
| <em class="hl-comment">// 找到当前支持的存储介质,然后逐个尝试</em>
|
|-&gt; spl_load_image(loader);
|-&gt; loader-&gt;load_image(spl_image, &amp;bootdev);
spl_ubi_load_image(); <em class="hl-comment">// arch/arm/mach-artinchip/spl_spi_nand.c</em>
|-&gt; spl_spi_nand_init();
| |-&gt; uclass_first_device(UCLASS_MTD, &amp;dev); <em class="hl-comment">// drivers/core/uclass.c</em>
| |-&gt; mtd_probe(dev);
| |-&gt; get_mtd_device(NULL, <span class="hl-number">0</span>);
|-&gt; spl_get_load_buffer(-<strong class="hl-keyword">sizeof</strong>(*header), <strong class="hl-keyword">sizeof</strong>(*header));
|-&gt; ubispl_load_volumes(&amp;info, volumes, <span class="hl-number">1</span>); <em class="hl-comment">// drivers/mtd/ubispl/ubispl.c</em>
| | <em class="hl-comment">// 读取整个 U-Boot 镜像的内容</em>
| |-&gt; ipl_scan(ubi);
| |-&gt; ipl_load(ubi, lv-&gt;vol_id, lv-&gt;load_addr);
| | <em class="hl-comment">// drivers/mtd/ubispl/ubispl.c</em>
| |-&gt; ubi_load_block(ubi, laddr, vi, vol_id, lnum, last);
| |-&gt; ubi_io_is_bad(ubi, pnum); <em class="hl-comment">// drivers/mtd/ubi/io.c</em>
| | <em class="hl-comment">// drivers/mtd/ubispl/ubispl.c</em>
| |-&gt; ubi_io_read(ubi, laddr, pnum, ubi-&gt;leb_start, dlen);
| | <em class="hl-comment">// drivers/mtd/ubispl/ubispl.c</em>
| |-&gt; ubi-&gt;read(pnum + ubi-&gt;peb_offset, from, len, buf);
| nand_spl_read_block(pnum + ubi-&gt;peb_offset,
| | from, len, buf);
| | <em class="hl-comment">// arch/arm/mach-artinchip/spl_spi_nand.c</em>
| |-&gt; mtd_read();
|
|-&gt; spl_parse_image_header(spl_image, header);</pre></div>
</li></ol>
</section><section class="- topic/section section" id="concept_nsb_pj3_pzb__section_ogg_t1h_bzb" data-ofbid="concept_nsb_pj3_pzb__section_ogg_t1h_bzb"><h2 class="- topic/title title sectiontitle">读数 SPI NAND 数据的流程</h2>
<div class="- topic/p p" data-ofbid="d303672e113__20250121171809">
<pre class="+ topic/pre pr-d/codeblock pre codeblock language-c" id="concept_nsb_pj3_pzb__codeblock_kkh_3sy_c1c" data-ofbid="concept_nsb_pj3_pzb__codeblock_kkh_3sy_c1c">mtd_read(); <em class="hl-comment">// drivers/mtd/mtdcore.c</em>
|-&gt; mtd-&gt;_read_oob(mtd, from, &amp;ops);
part_read_oob(mtd, from, ops); <em class="hl-comment">// drivers/mtd/mtdpart.c</em>
spinand_mtd_read(mtd, from, &amp;ops); <em class="hl-comment">// drivers/mtd/nand/spi/core.c</em>
|-&gt; spinand_read_page(spinand, &amp;iter.req, enable_ecc);
|-&gt; spinand_load_page_op(spinand, req);
| |-&gt; spi_mem_exec_op(spinand-&gt;slave, &amp;op);
| | <em class="hl-comment">// drivers/spi/spi-mem-nodm.c</em>
| |-&gt; spi_xfer(slave, op_len * <span class="hl-number">8</span>, op_buf, NULL, flag);
|
|-&gt; spinand_read_from_cache_op(spinand, req);
|-&gt; spi_mem_exec_op(spinand-&gt;slave, &amp;op);
|-&gt; spi_xfer(slave, op_len * <span class="hl-number">8</span>, op_buf, NULL, flag);</pre>
</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="#concept_nsb_pj3_pzb__section_unf_s1h_bzb" data-tocid="concept_nsb_pj3_pzb__section_unf_s1h_bzb">U-Boot 保存在 MTD 分区</a></div></li><li class="section-item"><div class="section-title"><a href="#concept_nsb_pj3_pzb__section_ynf_s1h_bzb" data-tocid="concept_nsb_pj3_pzb__section_ynf_s1h_bzb">U-Boot 保存在 UBI 中</a></div></li><li class="section-item"><div class="section-title"><a href="#concept_nsb_pj3_pzb__section_ogg_t1h_bzb" data-tocid="concept_nsb_pj3_pzb__section_ogg_t1h_bzb">读数 SPI NAND 数据的流程</a></div></li></ul></div>
</div>
</nav>
</div>
</div>
</div>
<footer class="navbar navbar-default wh_footer">
<div class=" footer-container mx-auto ">
<title>footer def</title>
<style><!--
.p1 {
font-family: FangZhengShuSong, Times, serif;
}
.p2 {
font-family: Arial, Helvetica, sans-serif;
}
.p3 {
font-family: "Lucida Console", "Courier New", monospace;
}
--></style>
<div class="webhelp.fragment.footer">
<p class="p1">Copyright © 2019-2024 广东匠芯创科技有限公司. All rights reserved.</p>
</div><div>
<div class="generation_time">
Update Time: 2025-01-21
</div>
</div>
</div>
</footer>
<div id="go2top" class="d-print-none">
<span class="oxy-icon oxy-icon-up"></span>
</div>
<div id="modal_img_large" class="modal">
<span class="close oxy-icon oxy-icon-remove"></span>
<div id="modal_img_container"></div>
<div id="caption"></div>
</div>
<script src="${pd}/publishing/publishing-styles-AIC-template/js/custom.js" defer="defer"></script>
</body>
</html>