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

286 lines
21 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="官方版本的 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>