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

228 lines
14 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="FIT即 Flattened Image Tree是参考 Flattened Device Tree 命令而来,具有以下优势。 更灵活的处理各种类型的 image 类型(压缩、非压缩、各种格式,各种配置组合) 可以处理安全启动过程中的安全校验(签名校验) FIT 原始参考文档如下: source/uboot- 2021.10 /doc/usage/fit.rst source/uboot- ..."/><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-05-28"/><meta name="DC.format" content="HTML5"/><meta name="DC.identifier" content="fitImage_1"/><meta name="DC.language" content="zh-CN"/><title>FIT Image 配置和启动</title><!-- Build number 2023110923. --><meta name="wh-path2root" content="../../../"/><meta name="wh-toc-id" content=""/><meta name="wh-source-relpath" content="topics/sdk/boot/fitImage_1.dita"/><meta name="wh-out-relpath" content="topics/sdk/boot/fitImage_1.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="fitImage_1" 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-12" id="wh_topic_body">
<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/fitImage_1.dita">Edit online</a></span><h1 class="- topic/title title topictitle1" id="ariaid-title1">FIT Image 配置和启动</h1><div class="date inPage">28 May 2024</div><div style="color: gray;">
Read time: 2 minute(s)
</div><div class="- topic/body concept/conbody body conbody"><div class="- topic/p p" data-ofbid="d95585e22__20250121171534">FIT即 Flattened Image Tree是参考 Flattened Device Tree 命令而来,具有以下优势。<ul class="- topic/ul ul" id="fitImage_1__ul_n2w_xdh_bzb" data-ofbid="fitImage_1__ul_n2w_xdh_bzb"><li class="- topic/li li" data-ofbid="d95585e25__20250121171534">
<p class="- topic/p p" data-ofbid="d95585e27__20250121171534">更灵活的处理各种类型的 image 类型(压缩、非压缩、各种格式,各种配置组合)</p>
</li><li class="- topic/li li" data-ofbid="d95585e30__20250121171534">
<p class="- topic/p p" data-ofbid="d95585e32__20250121171534">可以处理安全启动过程中的安全校验(签名校验)</p>
</li></ul></div><div class="- topic/p p" data-ofbid="d95585e35__20250121171534">FIT
原始参考文档如下:<pre class="+ topic/pre pr-d/codeblock pre codeblock language-c" id="fitImage_1__codeblock_ann_sqr_c1c" data-ofbid="fitImage_1__codeblock_ann_sqr_c1c">source/uboot-<span class="hl-number">2021.10</span>/doc/usage/fit.rst
source/uboot-<span class="hl-number">2021.10</span>/doc/uImage.FIT/howto.txt
source/uboot-<span class="hl-number">2021.10</span>/doc/uImage.FIT/source_file_format.txt
source/uboot-<span class="hl-number">2021.10</span>/doc/uImage.FIT/command_syntax_extensions.txt</pre></div><div class="- topic/p p" data-ofbid="d95585e39__20250121171534">Flattened Image Tree使用 DTS 的语法, 通过一些新增的节点,描述生成镜像文件所使用的 Image 文件和配置。下文以
<span class="+ topic/ph sw-d/filepath ph filepath">source/uboot-2021.10/doc/uImage.FIT/kernel_fdt.its</span>
为例进行说明:<pre class="+ topic/pre pr-d/codeblock pre codeblock language-c" id="fitImage_1__codeblock_h2c_tqr_c1c" data-ofbid="fitImage_1__codeblock_h2c_tqr_c1c">/dts-v1/;
/ {
description = <span class="hl-string">"Simple image with single Linux kernel and FDT blob"</span>;
#address-cells = &lt;<span class="hl-number">1</span>&gt;;
images {
kernel {
description = <span class="hl-string">"Vanilla Linux kernel"</span>;
data = /incbin/(<span class="hl-string">"./vmlinux.bin.gz"</span>);
type = <span class="hl-string">"kernel"</span>;
arch = <span class="hl-string">"ppc"</span>;
os = <span class="hl-string">"linux"</span>;
compression = <span class="hl-string">"gzip"</span>;
load = &lt;<span class="hl-number">00000000</span>&gt;;
entry = &lt;<span class="hl-number">00000000</span>&gt;;
hash-<span class="hl-number">1</span> {
algo = <span class="hl-string">"crc32"</span>;
};
hash-<span class="hl-number">2</span> {
algo = <span class="hl-string">"sha1"</span>;
};
};
fdt-<span class="hl-number">1</span> {
description = <span class="hl-string">"Flattened Device Tree blob"</span>;
data = /incbin/(<span class="hl-string">"./target.dtb"</span>);
type = <span class="hl-string">"flat_dt"</span>;
arch = <span class="hl-string">"ppc"</span>;
compression = <span class="hl-string">"none"</span>;
hash-<span class="hl-number">1</span> {
algo = <span class="hl-string">"crc32"</span>;
};
hash-<span class="hl-number">2</span> {
algo = <span class="hl-string">"sha1"</span>;
};
};
};
configurations {
<strong class="hl-keyword">default</strong> = <span class="hl-string">"conf-1"</span>;
conf-<span class="hl-number">1</span> {
description = <span class="hl-string">"Boot Linux kernel with FDT blob"</span>;
kernel = <span class="hl-string">"kernel"</span>;
fdt = <span class="hl-string">"fdt-1"</span>;
};
};
};</pre></div><p class="- topic/p p" data-ofbid="d95585e46__20250121171534">上述示例包含了其中包含了 fdt + kernel以及校验方式的配置。</p><div class="- topic/p p" data-ofbid="d95585e48__20250121171534">FIT image 启动命令说明如下:<ul class="- topic/ul ul" id="fitImage_1__ul_nqm_zqy_nbc" data-ofbid="fitImage_1__ul_nqm_zqy_nbc"><li class="- topic/li li" data-ofbid="d95585e51__20250121171534">
<div class="- topic/p p" data-ofbid="d95585e53__20250121171534">生成 itb image
的命令:<pre class="+ topic/pre pr-d/codeblock pre codeblock language-c" id="fitImage_1__codeblock_vb1_5qr_c1c" data-ofbid="fitImage_1__codeblock_vb1_5qr_c1c">mkimage -f kernel_fdt.its kernel_fdt.itb</pre></div>
</li><li class="- topic/li li" data-ofbid="d95585e58__20250121171534">
<div class="- topic/p p" data-ofbid="d95585e60__20250121171534">使用默认的配置进行启动:<pre class="+ topic/pre pr-d/codeblock pre codeblock language-c" id="fitImage_1__codeblock_m24_5qr_c1c" data-ofbid="fitImage_1__codeblock_m24_5qr_c1c">bootm &lt;kernel itb addr&gt;</pre></div>
</li><li class="- topic/li li" data-ofbid="d95585e65__20250121171534">
<div class="- topic/p p" data-ofbid="d95585e67__20250121171534">如果 its 中有多个配置,可以指定启动的配置组合,例如 bootm
0x81000000#conf-2。<pre class="+ topic/pre pr-d/codeblock pre codeblock language-c" id="fitImage_1__codeblock_u5z_5qr_c1c" data-ofbid="fitImage_1__codeblock_u5z_5qr_c1c">bootm &lt;kernel itb addr&gt;#&lt;conf-name&gt;
</pre></div>
</li></ul></div><p class="- topic/p p" data-ofbid="d95585e72__20250121171534">更多说明请参考source/uboot-2021.10/doc/uImage.FIT/command_syntax_extensions.txt</p></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>