Files
luban-lite/doc/topics/sdk/bringup/config-filesys-and-partition.html
刘可亮 11c97ef399 v1.2.1
2025-07-22 11:15:46 +08:00

374 lines
40 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.1">
<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="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="description" content="文件系统默认采用 FATFS。 本节仅简单介绍 Bringup 相关的分区配置。Bringup 时建议只进行介质选择,不进行复杂的分区调整。关于分区的详细说明,可查看 配置分区 。 SPI NOR 文件系统和分区 SPI NOR 默认采用 FATFS。 Application options ---&gt; [*] Using File System Image 1 ---&gt; --- Using ..."/><meta name="DC.relation" content="../../../topics/sdk/bringup/lite-bringup-storage.html"/><meta name="DC.relation" content="../../../topics/sdk/bringup/config-storage-os_2.html"/><meta name="DC.relation" content="../../../topics/sdk/bringup/compile-and-burn-firmware.html"/><meta name="DC.contributor" content="yan.wang"/><meta name="DC.creator" content="yan.wang"/><meta name="DC.date.modified" content="2025-05-16"/><meta name="DC.format" content="HTML5"/><meta name="DC.identifier" content="config-filesys-and-partition"/>
<title>配置文件系统和分区</title><!-- Generated with build number 2025051600. --><meta name="wh-path2root" content="../../../"/><meta name="wh-toc-id" content="config-filesys-and-partition-d3752e2201"/><meta name="wh-source-relpath" content="topics/sdk/bringup/config-filesys-and-partition.dita"/><meta name="wh-out-relpath" content="topics/sdk/bringup/config-filesys-and-partition.html"/>
<link rel="stylesheet" type="text/css" href="../../../webhelp/app/commons.css?buildId=2024041900"/>
<link rel="stylesheet" type="text/css" href="../../../webhelp/app/topic.css?buildId=2024041900"/>
<script src="../../../webhelp/app/options/properties.js?buildId=20250519091401"></script>
<script src="../../../webhelp/app/localization/strings.js?buildId=2024041900"></script>
<script src="../../../webhelp/app/search/index/keywords.js?buildId=20250519091401"></script>
<script defer="defer" src="../../../webhelp/app/commons.js?buildId=2024041900"></script>
<script defer="defer" src="../../../webhelp/app/topic.js?buildId=2024041900"></script>
<link rel="stylesheet" type="text/css" href="../../../webhelp/template/css/aic-styles-web-internal.css?buildId=2024041900"/><link rel="stylesheet" type="text/css" href="../../../webhelp/template/css/notes.css?buildId=2024041900"/><link rel="stylesheet" type="text/css" href="../../../webhelp/template/css/aic-common.css?buildId=2024041900"/><link rel="stylesheet" type="text/css" href="../../../webhelp/template/css/aic-images.css?buildId=2024041900"/><link rel="stylesheet" type="text/css" href="../../../webhelp/template/css/footnote.css?buildId=2024041900"/><link rel="stylesheet" type="text/css" href="../../../webhelp/template/css/aic-highlight-changes.css?buildId=2024041900"/><link rel="stylesheet" type="text/css" href="../../../webhelp/template/css/search-in-header.css?buildId=2024041900"/><link rel="stylesheet" type="text/css" href="../../../webhelp/template/css/topic-body-list.css?buildId=2024041900"/></head>
<body id="config-filesys-and-partition" 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 xmlns:whc="http://www.oxygenxml.com/webhelp/components" 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="https://www.artinchip.com" class=" wh_logo d-none d-sm-block "><img src="../../../company-logo.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 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>
</div>
</header>
<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">主要描述板卡的各项配置,使 SDK 的环境和板卡匹配,并确保 SDK 编译后的固件能够在板子上正常运行。</p></div></div></div></li><li><div class="topicref" data-id="id"><div class="title"><a href="../../../topics/sdk/bringup/lite-bringup-storage.html">存储配置</a></div></div></li><li class="active"><div class="topicref" data-id="config-filesys-and-partition"><div class="title"><a href="../../../topics/sdk/bringup/config-filesys-and-partition.html">配置文件系统和分区</a><div class="wh-tooltip"><p class="shortdesc"></p></div></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/config-storage-os_2.html" title="配置 OS" aria-label="上一主题: 配置 OS" rel="prev"></a></span>
<span class="navnext"><a class="- topic/link link" href="../../../topics/sdk/bringup/compile-and-burn-firmware.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-d3752e463" 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-d3752e463-link">修订记录</a></div></div></li><li role="treeitem" aria-expanded="false"><div data-tocid="id-d3752e480" class="topicref" data-id="id" data-state="not-ready"><span role="button" tabindex="0" aria-labelledby="button-expand-action id-d3752e480-link" class="wh-expand-btn"></span><div class="title"><a href="../../../topics/sdk/env/sdk-compile.html" id="id-d3752e480-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-d3752e604" class="topicref" data-id="id" data-state="not-ready"><span role="button" tabindex="0" aria-labelledby="button-expand-action id-d3752e604-link" class="wh-expand-btn"></span><div class="title"><a href="../../../topics/sdk/advanced/sdk-usage.html" id="id-d3752e604-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-d3752e1004" 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-d3752e1004-link" class="wh-expand-btn"></span><div class="title"><a href="../../../topics/sdk/chapter-app.html" id="concept_rcx_czh_pzb-d3752e1004-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-d3752e1848" class="topicref" data-id="id" data-state="not-ready"><span role="button" tabindex="0" aria-labelledby="button-expand-action id-d3752e1848-link" class="wh-expand-btn"></span><div class="title"><a href="../../../topics/sdk/peripheral/peripheral-intro.html" id="id-d3752e1848-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-d3752e2022" class="topicref" data-id="id" data-state="expanded"><span role="button" tabindex="0" aria-labelledby="button-collapse-action id-d3752e2022-link" class="wh-expand-btn"></span><div class="title"><a href="../../../topics/sdk/bringup/chapter-bringup.html" id="id-d3752e2022-link">BringUp</a><div class="wh-tooltip"><p class="shortdesc">主要描述板卡的各项配置,使 SDK 的环境和板卡匹配,并确保 SDK 编译后的固件能够在板子上正常运行。</p></div></div></div><ul role="group" class="navbar-nav nav-list"><li role="treeitem" aria-expanded="false"><div data-tocid="id-d3752e2039" class="topicref" data-id="id" data-state="not-ready"><span role="button" tabindex="0" aria-labelledby="button-expand-action id-d3752e2039-link" class="wh-expand-btn"></span><div class="title"><a href="../../../topics/sdk/bringup/lite-bringup-prepare.html" id="id-d3752e2039-link">准备工作</a></div></div></li><li role="treeitem"><div data-tocid="id-d3752e2097" 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-d3752e2097-link">引脚配置</a></div></div></li><li role="treeitem"><div data-tocid="id-d3752e2111" 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-d3752e2111-link">内存配置</a></div></div></li><li role="treeitem" aria-expanded="true"><div data-tocid="id-d3752e2125" class="topicref" data-id="id" data-state="expanded"><span role="button" tabindex="0" aria-labelledby="button-collapse-action id-d3752e2125-link" class="wh-expand-btn"></span><div class="title"><a href="../../../topics/sdk/bringup/lite-bringup-storage.html" id="id-d3752e2125-link">存储配置</a></div></div><ul role="group" class="navbar-nav nav-list"><li role="treeitem"><div data-tocid="select-storage-device-d3752e2139" class="topicref" data-id="select-storage-device" data-state="leaf"><span role="button" class="wh-expand-btn"></span><div class="title"><a href="../../../topics/sdk/bringup/select-storage-device.html" id="select-storage-device-d3752e2139-link">选择存储设备类型</a><div class="wh-tooltip"><p class="shortdesc"></p></div></div></div></li><li role="treeitem"><div data-tocid="config-storage-d3752e2155" class="topicref" data-id="config-storage" data-state="leaf"><span role="button" class="wh-expand-btn"></span><div class="title"><a href="../../../topics/sdk/advanced/config-storage_2.html" id="config-storage-d3752e2155-link">切换存储类型</a></div></div></li><li role="treeitem"><div data-tocid="config-storage-bootloader-d3752e2169" class="topicref" data-id="config-storage-bootloader" data-state="leaf"><span role="button" class="wh-expand-btn"></span><div class="title"><a href="../../../topics/sdk/bringup/config-storage-bootloader_2.html" id="config-storage-bootloader-d3752e2169-link">配置 BootLoader</a><div class="wh-tooltip"><p class="shortdesc"></p></div></div></div></li><li role="treeitem"><div data-tocid="config-storage-os-d3752e2185" class="topicref" data-id="config-storage-os" data-state="leaf"><span role="button" class="wh-expand-btn"></span><div class="title"><a href="../../../topics/sdk/bringup/config-storage-os_2.html" id="config-storage-os-d3752e2185-link">配置 OS</a><div class="wh-tooltip"><p class="shortdesc"></p></div></div></div></li><li role="treeitem" class="active"><div data-tocid="config-filesys-and-partition-d3752e2201" class="topicref" data-id="config-filesys-and-partition" data-state="leaf"><span role="button" class="wh-expand-btn"></span><div class="title"><a href="../../../topics/sdk/bringup/config-filesys-and-partition.html" id="config-filesys-and-partition-d3752e2201-link">配置文件系统和分区</a><div class="wh-tooltip"><p class="shortdesc"></p></div></div></div></li><li role="treeitem"><div data-tocid="compile-and-burn-firmware-d3752e2217" class="topicref" data-id="compile-and-burn-firmware" data-state="leaf"><span role="button" class="wh-expand-btn"></span><div class="title"><a href="../../../topics/sdk/bringup/compile-and-burn-firmware.html" id="compile-and-burn-firmware-d3752e2217-link">编译和烧录固件</a><div class="wh-tooltip"><p class="shortdesc"></p></div></div></div></li></ul></li><li role="treeitem" aria-expanded="false"><div data-tocid="id-d3752e2233" class="topicref" data-id="id" data-state="not-ready"><span role="button" tabindex="0" aria-labelledby="button-expand-action id-d3752e2233-link" class="wh-expand-btn"></span><div class="title"><a href="../../../topics/sdk/advanced/partition_config_2.html" id="id-d3752e2233-link">配置分区</a></div></div></li><li role="treeitem"><div data-tocid="id-d3752e2277" 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-d3752e2277-link">调试配置</a></div></div></li><li role="treeitem" aria-expanded="false"><div data-tocid="id-d3752e2291" class="topicref" data-id="id" data-state="not-ready"><span role="button" tabindex="0" aria-labelledby="button-expand-action id-d3752e2291-link" class="wh-expand-btn"></span><div class="title"><a href="../../../topics/sdk/bringup/lite-bringup-display.html" id="id-d3752e2291-link">屏幕配置</a></div></div></li><li role="treeitem"><div data-tocid="id-d3752e2403" 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-d3752e2403-link">示例程序</a></div></div></li></ul></li><li role="treeitem" aria-expanded="false"><div data-tocid="id-d3752e2418" class="topicref" data-id="id" data-state="not-ready"><span role="button" tabindex="0" aria-labelledby="button-expand-action id-d3752e2418-link" class="wh-expand-btn"></span><div class="title"><a href="../../../topics/sdk/chapter-advanced-app.html" id="id-d3752e2418-link">高级应用</a><div class="wh-tooltip"><p class="shortdesc">系统、存储、多媒体、接口、安全等模块的详细配置和设计说明。</p></div></div></div></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" href="http://aicdocco/taskstopics/sdk/bringup/config-filesys-and-partition.dita">Edit online</a></span><h1 class="- topic/title title topictitle1" id="ariaid-title1">配置文件系统和分区</h1>
<div class="date inPage">16 May 2025</div><div style="color: gray;">
Read time: 6 minute(s)
</div>
<div class="- topic/body concept/conbody body conbody"><p class="- topic/shortdesc shortdesc"></p>
<p class="- topic/p p" data-ofbid="d59030e30__20250519091508">文件系统默认采用 FATFS。</p>
<p class="- topic/p p" data-ofbid="d59030e33__20250519091508">本节仅简单介绍 Bringup 相关的分区配置。Bringup 时建议只进行介质选择,不进行复杂的分区调整。关于分区的详细说明,可查看<a class="- topic/xref xref" href="../advanced/partition_config.html">配置分区</a></p>
<section class="- topic/section section" id="config-filesys-and-partition__section_ids_c3p_w2c" data-ofbid="config-filesys-and-partition__section_ids_c3p_w2c"><h2 class="- topic/title title sectiontitle">SPI NOR 文件系统和分区</h2>
<ol class="- topic/ol ol" id="config-filesys-and-partition__ol_f52_4wr_x2c" data-ofbid="config-filesys-and-partition__ol_f52_4wr_x2c">
<li class="- topic/li li" data-ofbid="d59030e47__20250519091508">
<div class="- topic/p p" data-ofbid="d59030e49__20250519091508">SPI NOR 默认采用
FATFS。<pre class="+ topic/pre pr-d/codeblock pre codeblock language-c" id="config-filesys-and-partition__codeblock_wtw_nwr_x2c" data-ofbid="config-filesys-and-partition__codeblock_wtw_nwr_x2c">Application options ---&gt;
[*] Using File System Image <span class="hl-number">1</span> ---&gt;
--- Using File System Image <span class="hl-number">1</span>
Select File System Type (FATFS) ---&gt;
(data/) Data Directory
(data.fatfs) Image Name</pre></div>
</li>
<li class="- topic/li li" data-ofbid="d59030e55__20250519091508">
<p class="- topic/p p" data-ofbid="d59030e57__20250519091508"><span class="+ topic/ph sw-d/filepath ph filepath">target/dxxx/xxx/pack/image_cfg.json</span> 中,可以配置 SPI NOR
的分区信息:</p>
<p class="- topic/p p" data-ofbid="d59030e63__20250519091508"><span class="+ topic/ph sw-d/filepath ph filepath">d13x demo88_nor</span> 工程为例, 编译出来的固件为
<span class="+ topic/ph sw-d/filepath ph filepath">d13x_demo88-nor_v1.0.0.img</span></p>
<div class="- topic/p p" data-ofbid="d59030e72__20250519091508">
<pre class="+ topic/pre pr-d/codeblock pre codeblock language-c" id="config-filesys-and-partition__codeblock_qb5_ty1_bdc" data-ofbid="config-filesys-and-partition__codeblock_qb5_ty1_bdc"><span class="hl-string">"spi-nor"</span>: { <em class="hl-comment">// Device, The name should be the same with string in image:info:media:type</em>
<span class="hl-string">"size"</span>: <span class="hl-string">"16m"</span>, <em class="hl-comment">// Size of SPI NOR</em>
<span class="hl-string">"partitions"</span>: {
<span class="hl-string">"spl"</span>: { <span class="hl-string">"size"</span>: <span class="hl-string">"256k"</span> },
<span class="hl-string">"env"</span>: { <span class="hl-string">"size"</span>: <span class="hl-string">"128k"</span> },
<span class="hl-string">"env_r"</span>: { <span class="hl-string">"size"</span>: <span class="hl-string">"128k"</span> },
<span class="hl-string">"os"</span>: { <span class="hl-string">"size"</span>: <span class="hl-string">"1m"</span> },
<span class="hl-string">"os_r"</span>: { <span class="hl-string">"size"</span>: <span class="hl-string">"1m"</span> },
<span class="hl-string">"rodata"</span>: { <span class="hl-string">"size"</span>: <span class="hl-string">"3m"</span> },
<span class="hl-string">"rodata_r"</span>: { <span class="hl-string">"size"</span>: <span class="hl-string">"3m"</span> },
<span class="hl-string">"data"</span>: { <span class="hl-string">"size"</span>: <span class="hl-string">"7m"</span> }
},
},</pre>
</div>
</li>
</ol>
</section>
<section class="- topic/section section" id="config-filesys-and-partition__section_opz_d3p_w2c" data-ofbid="config-filesys-and-partition__section_opz_d3p_w2c"><h2 class="- topic/title title sectiontitle">SPI NAND 文件系统和分区</h2>
<ol class="- topic/ol ol" id="config-filesys-and-partition__ul_crg_5zq_ndc" data-ofbid="config-filesys-and-partition__ul_crg_5zq_ndc">
<li class="- topic/li li" data-ofbid="d59030e88__20250519091508">
<div class="- topic/p p" data-ofbid="d59030e90__20250519091508">SPI NAND 默认采用
FATFS配置如下<pre class="+ topic/pre pr-d/codeblock pre codeblock language-c" id="config-filesys-and-partition__codeblock_ln2_zkp_w2c" data-ofbid="config-filesys-and-partition__codeblock_ln2_zkp_w2c">Application options ---&gt;
[*] Using File System Image <span class="hl-number">1</span> ---&gt;
--- Using File System Image <span class="hl-number">1</span>
Select File System Type (FATFS) ---&gt;
(data/) Data Directory
(data.fatfs) Image Name</pre></div>
</li>
<li class="- topic/li li" data-ofbid="d59030e96__20250519091508">
<p class="- topic/p p" data-ofbid="d59030e98__20250519091508">在工程配置文件 <span class="+ topic/ph sw-d/filepath ph filepath">target/dxxx/xxx/pack/image_cfg.json</span>
中,配置分区信息。</p>
<p class="- topic/p p" data-ofbid="d59030e104__20250519091508">可以从其他 SPI NOR 方案中复制 image_cfg.json 到本方案,也可以手工修改。</p>
<pre class="+ topic/pre pr-d/codeblock pre codeblock language-c" id="config-filesys-and-partition__codeblock_ngb_wz1_bdc" data-ofbid="config-filesys-and-partition__codeblock_ngb_wz1_bdc"><span class="hl-string">"spi-nand"</span>: { <em class="hl-comment">// Device, The name should be the same with string in image:info:media:type</em>
<span class="hl-string">"size"</span>: <span class="hl-string">"128m"</span>, <em class="hl-comment">// Size of SPI NAND</em>
<span class="hl-string">"partitions"</span>: {
<span class="hl-string">"spl"</span>: { <span class="hl-string">"size"</span>: <span class="hl-string">"1m"</span> },
<span class="hl-string">"userid"</span>: { <span class="hl-string">"size"</span>: <span class="hl-string">"256k"</span> }, <em class="hl-comment">// at least 16KB</em>
<span class="hl-string">"env"</span>: { <span class="hl-string">"size"</span>: <span class="hl-string">"256k"</span> },
<span class="hl-string">"env_r"</span>: { <span class="hl-string">"size"</span>: <span class="hl-string">"256k"</span> },
<span class="hl-string">"os"</span>: { <span class="hl-string">"size"</span>: <span class="hl-string">"2m"</span> },
<span class="hl-string">"os_r"</span>: { <span class="hl-string">"size"</span>: <span class="hl-string">"2m"</span> },
<span class="hl-string">"rodata"</span>: { <span class="hl-string">"size"</span>: <span class="hl-string">"14m"</span> },
<span class="hl-string">"rodata_r"</span>: { <span class="hl-string">"size"</span>: <span class="hl-string">"14m"</span> },
<span class="hl-string">"data"</span>: {
<span class="hl-string">"size"</span>: <span class="hl-string">"40m"</span>,
<span class="hl-string">"nftl"</span>: { <em class="hl-comment">// Volume in NFTL device</em>
<span class="hl-string">"data"</span>: { <span class="hl-string">"size"</span>: <span class="hl-string">"-"</span> },
},
},
<span class="hl-string">"data_r"</span>: {
<span class="hl-string">"size"</span>: <span class="hl-string">"40m"</span>,
<span class="hl-string">"nftl"</span>: { <em class="hl-comment">// Volume in NFTL device</em>
<span class="hl-string">"data"</span>: { <span class="hl-string">"size"</span>: <span class="hl-string">"-"</span> },
},
},
},
},</pre>
<div class="- topic/note note note note_note" id="config-filesys-and-partition__note_j3g_vxq_ndc" data-ofbid="config-filesys-and-partition__note_j3g_vxq_ndc"><span class="note__title">注:</span> 调整分区后要跳到 BootLoader 配置编译,或者在 RT-Thread 配置下使用
<span class="+ topic/keyword sw-d/cmdname keyword cmdname">mb</span> 命令编译。</div>
</li>
<li class="- topic/li li" data-ofbid="d59030e117__20250519091508">基于 SPI NOR 的 Image 信息,在 <span class="+ topic/ph sw-d/filepath ph filepath">target/dxxx/xxx/pack/image_cfg.json</span>
中设置 SPI NAND
的镜像信息:<pre class="+ topic/pre pr-d/codeblock pre codeblock language-c" id="config-filesys-and-partition__codeblock_ut2_wqr_x2c" data-ofbid="config-filesys-and-partition__codeblock_ut2_wqr_x2c"> <span class="hl-string">"image"</span>: {
<span class="hl-string">"info"</span>: { <em class="hl-comment">// Header information about image</em>
<span class="hl-string">"platform"</span>: <span class="hl-string">"d21x"</span>,
<span class="hl-string">"version"</span>: <span class="hl-string">"1.0.0"</span>,
<span class="hl-string">"media"</span>: {
- <span class="hl-string">"type"</span>: <span class="hl-string">"spi-nor"</span>,
+ <span class="hl-string">"type"</span>: <span class="hl-string">"spi-nand"</span>,
<span class="hl-string">"device_id"</span>: <span class="hl-number">0</span>,
+ <span class="hl-string">"array_organization"</span>: [
+ { <span class="hl-string">"page"</span>: <span class="hl-string">"2k"</span>, <span class="hl-string">"block"</span>: <span class="hl-string">"128k"</span>, <span class="hl-string">"oob"</span>: <span class="hl-string">"64"</span> },
+ <em class="hl-comment">// { "page": "4k", "block": "256k", "oob": "128" },</em>
+ ],
}
},
<span class="hl-string">"updater"</span>: { <em class="hl-comment">// Image writer which is downloaded to RAM by USB</em>
@@ -<span class="hl-number">56</span>,<span class="hl-number">8</span> +<span class="hl-number">71</span>,<span class="hl-number">8</span> @@
<span class="hl-string">"part"</span>: [<span class="hl-string">"rodata"</span>]
},
<span class="hl-string">"data"</span>: {
- <span class="hl-string">"file"</span>: <span class="hl-string">"data.lfs"</span>,
- <span class="hl-string">"attr"</span>: [<span class="hl-string">"mtd"</span>, <span class="hl-string">"optional"</span>],
+ <span class="hl-string">"file"</span>: <span class="hl-string">"data.fatfs"</span>,
+ <span class="hl-string">"attr"</span>: [<span class="hl-string">"block"</span>, <span class="hl-string">"optional"</span>],
<span class="hl-string">"part"</span>: [<span class="hl-string">"data"</span>]
},
},</pre><div class="- topic/p p" data-ofbid="d59030e124__20250519091508">SDK 也支持 "page" 大小为 4K 的 SPI
NAND但使用场景较少。<pre class="+ topic/pre pr-d/codeblock pre codeblock language-c" id="config-filesys-and-partition__codeblock_yf5_fx1_bdc" data-ofbid="config-filesys-and-partition__codeblock_yf5_fx1_bdc"><span class="hl-string">"media"</span>: {
<span class="hl-string">"type"</span>: <span class="hl-string">"spi-nand"</span>,
<span class="hl-string">"device_id"</span>: <span class="hl-number">0</span>,
<span class="hl-string">"array_organization"</span>: [
{ <span class="hl-string">"page"</span>: <span class="hl-string">"2k"</span>, <span class="hl-string">"block"</span>: <span class="hl-string">"128k"</span>, <span class="hl-string">"oob"</span>: <span class="hl-string">"64"</span> },
<em class="hl-comment">// { "page": "4k", "block": "256k", "oob": "128" },</em>
],
}
},</pre></div></li>
</ol>
</section>
<section class="- topic/section section" id="config-filesys-and-partition__section_psd_b3p_w2c" data-ofbid="config-filesys-and-partition__section_psd_b3p_w2c"><h2 class="- topic/title title sectiontitle">eMMC 文件系统和分区</h2>
<ol class="- topic/ol ol" id="config-filesys-and-partition__ol_aww_jrr_x2c" data-ofbid="config-filesys-and-partition__ol_aww_jrr_x2c">
<li class="- topic/li li" data-ofbid="d59030e138__20250519091508">
<div class="- topic/p p" data-ofbid="d59030e140__20250519091508">eMMC 默认采用
FATFS。<pre class="+ topic/pre pr-d/codeblock pre codeblock language-c" id="config-filesys-and-partition__codeblock_ndl_jrr_x2c" data-ofbid="config-filesys-and-partition__codeblock_ndl_jrr_x2c">Application options ---&gt;
[*] Using File System Image <span class="hl-number">0</span> ---&gt;
--- Using File System Image <span class="hl-number">0</span>
Select File System Type (FATFS) ---&gt;
(rodata/) Data Directory
(rodata.fatfs) Image Name
[*] Using File System Image <span class="hl-number">1</span> ---&gt;
--- Using File System Image <span class="hl-number">1</span>
Select File System Type (FATFS) ---&gt;
(data/) Data Directory
(data.fatfs) Image Name</pre></div>
<p class="- topic/p p" data-ofbid="d59030e145__20250519091508"><span class="+ topic/ph sw-d/filepath ph filepath">d21x demo88-mmc</span> 工程为例, 编译出来的固件为
<span class="+ topic/ph sw-d/filepath ph filepath">d21x_demo88_mmc_v1.0.0.img</span></p>
</li>
<li class="- topic/li li" data-ofbid="d59030e155__20250519091508">
<p class="- topic/p p" data-ofbid="d59030e157__20250519091508"><span class="+ topic/ph sw-d/filepath ph filepath">target/dxxx/xxx/pack/image_cfg.json</span> 中,配置分区信息:</p>
<p class="- topic/p p" data-ofbid="d59030e163__20250519091508">可以从其他 SPI NOR 方案中复制 image_cfg.json 到本方案,也可以手工修改。</p>
<div class="- topic/p p" data-ofbid="d59030e166__20250519091508">
<pre class="+ topic/pre pr-d/codeblock pre codeblock language-c" id="config-filesys-and-partition__codeblock_lvq_vy1_bdc" data-ofbid="config-filesys-and-partition__codeblock_lvq_vy1_bdc"><span class="hl-string">"mmc"</span>: { <em class="hl-comment">// Device, The name should be the same with string in image:info:media:type</em>
<span class="hl-string">"size"</span>: <span class="hl-string">"8G"</span>, <em class="hl-comment">// Size of SD/eMMC</em>
<span class="hl-string">"partitions"</span>: { <em class="hl-comment">// Partition table apply to device</em>
<span class="hl-string">"spl"</span>: { <span class="hl-string">"offset"</span>: <span class="hl-string">"0x4400"</span>, <span class="hl-string">"size"</span>: <span class="hl-string">"495k"</span> },
<span class="hl-string">"env"</span>: { <span class="hl-string">"size"</span>: <span class="hl-string">"256k"</span> },
<span class="hl-string">"env_r"</span>: { <span class="hl-string">"size"</span>: <span class="hl-string">"256k"</span> },
<span class="hl-string">"os"</span>: { <span class="hl-string">"size"</span>: <span class="hl-string">"8m"</span> },
<span class="hl-string">"os_r"</span>: { <span class="hl-string">"size"</span>: <span class="hl-string">"8m"</span> },
<span class="hl-string">"rodata"</span>: { <span class="hl-string">"size"</span>: <span class="hl-string">"12m"</span> },
<span class="hl-string">"rodata_r"</span>: { <span class="hl-string">"size"</span>: <span class="hl-string">"12m"</span> },
<span class="hl-string">"data"</span>: { <span class="hl-string">"size"</span>: <span class="hl-string">"35m"</span> },
<span class="hl-string">"data_r"</span>: { <span class="hl-string">"size"</span>: <span class="hl-string">"35m"</span> },
},
},</pre>
</div>
<p class="- topic/p p" data-ofbid="d59030e172__20250519091508">eMMC 的接口协议固定,因此不需要进行新器件型号的移植。调整分区大小时,也需要同时调整固件的大小来和分区匹配。</p>
</li>
<li class="- topic/li li" data-ofbid="d59030e176__20250519091508"><span class="+ topic/ph sw-d/filepath ph filepath">target/dxxx/xxx/pack/image_cfg.json</span> 中设置基于 eMMC 的 Image
信息:<pre class="+ topic/pre pr-d/codeblock pre codeblock language-c" id="config-filesys-and-partition__codeblock_vlb_5rr_x2c" data-ofbid="config-filesys-and-partition__codeblock_vlb_5rr_x2c"> <span class="hl-string">"image"</span>: {
<span class="hl-string">"info"</span>: { <em class="hl-comment">// Header information about image</em>
<span class="hl-string">"platform"</span>: <span class="hl-string">"d21x"</span>,
<span class="hl-string">"version"</span>: <span class="hl-string">"1.0.0"</span>,
<span class="hl-string">"media"</span>: {
- <span class="hl-string">"type"</span>: <span class="hl-string">"spi-nor"</span>,
+ <span class="hl-string">"type"</span>: <span class="hl-string">"mmc"</span>,
<span class="hl-string">"device_id"</span>: <span class="hl-number">0</span>,
}
},
<span class="hl-string">"updater"</span>: { <em class="hl-comment">// Image writer which is downloaded to RAM by USB</em>
@@ -<span class="hl-number">56</span>,<span class="hl-number">8</span> +<span class="hl-number">71</span>,<span class="hl-number">8</span> @@
<span class="hl-string">"part"</span>: [<span class="hl-string">"rodata"</span>]
},
<span class="hl-string">"data"</span>: {
- <span class="hl-string">"file"</span>: <span class="hl-string">"data.lfs"</span>,
- <span class="hl-string">"attr"</span>: [<span class="hl-string">"mtd"</span>, <span class="hl-string">"optional"</span>],
+ <span class="hl-string">"file"</span>: <span class="hl-string">"data.fatfs"</span>,
+ <span class="hl-string">"attr"</span>: [<span class="hl-string">"block"</span>, <span class="hl-string">"optional"</span>],
<span class="hl-string">"part"</span>: [<span class="hl-string">"data"</span>]
},
},</pre></li>
</ol>
</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="#config-filesys-and-partition__section_ids_c3p_w2c" data-tocid="config-filesys-and-partition__section_ids_c3p_w2c">SPI NOR 文件系统和分区</a></div></li><li class="section-item"><div class="section-title"><a href="#config-filesys-and-partition__section_opz_d3p_w2c" data-tocid="config-filesys-and-partition__section_opz_d3p_w2c">SPI NAND 文件系统和分区</a></div></li><li class="section-item"><div class="section-title"><a href="#config-filesys-and-partition__section_psd_b3p_w2c" data-tocid="config-filesys-and-partition__section_psd_b3p_w2c">eMMC 文件系统和分区</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-2025 广东匠芯创科技有限公司. All rights reserved.</p>
</div>
<div>
<div class="generation_time">
Update Time: 2025-05-19
</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>