linuxOS_D21X/doc/topics/sdk/env/compile.html
2025-01-23 16:35:08 +08:00

276 lines
26 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="27.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="本节介绍了编译固件的常规流程。在开始编译固件之前,确保编译环境已经搭建完成。关于操作系统和依赖的详细安装说明,可查看 Ubuntu 和 VMWare 安装 。 项目配置与编译 选择以下任意一种编译和配置命令方式,对项目进行配置和编译: 常规 make 命令 ,例如: make list make d211_demo128_nand_defconfig make OneStep 快捷命令 ,例如: ..."/><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/env/sdk-compile.html"/><meta name="DC.relation" content="../../../topics/sdk/env/vmware-config-vm.html"/><meta name="DC.relation" content="../../../topics/sdk/advanced/lb_usage_commands.html"/><meta name="DC.contributor" content="yan.wang"/><meta name="DC.contributor" content="yan.wang"/><meta name="DC.creator" content="yan.wang"/><meta name="DC.date.modified" content="2024-01-15"/><meta name="DC.format" content="HTML5"/><meta name="DC.identifier" content="compile"/><meta name="DC.language" content="zh-CN"/><title>固件编译</title><!-- Generated with build number 2024112209. --><meta name="wh-path2root" content="../../../"/><meta name="wh-toc-id" content="compile-d4445e1225"/><meta name="wh-source-relpath" content="topics/sdk/env/compile.dita"/><meta name="wh-out-relpath" content="topics/sdk/env/compile.html"/>
<link rel="stylesheet" type="text/css" href="../../../webhelp/app/commons.css?buildId=2024112209"/>
<link rel="stylesheet" type="text/css" href="../../../webhelp/app/topic.css?buildId=2024112209"/>
<script src="../../../webhelp/app/options/properties.js?buildId=20250123154945"></script>
<script src="../../../webhelp/app/localization/strings.js?buildId=2024112209"></script>
<script src="../../../webhelp/app/search/index/keywords.js?buildId=20250123154945"></script>
<script defer="defer" src="../../../webhelp/app/commons.js?buildId=2024112209"></script>
<script defer="defer" src="../../../webhelp/app/topic.js?buildId=2024112209"></script>
<link rel="stylesheet" type="text/css" href="../../../webhelp/template/aic-styles-web.css?buildId=2024112209"/><link rel="stylesheet" type="text/css" href="../../../webhelp/template/notes.css?buildId=2024112209"/><link rel="stylesheet" type="text/css" href="../../../webhelp/template/aic-common.css?buildId=2024112209"/><link rel="stylesheet" type="text/css" href="../../../webhelp/template/aic-images.css?buildId=2024112209"/><link rel="stylesheet" type="text/css" href="../../../webhelp/template/footnote.css?buildId=2024112209"/><link rel="stylesheet" type="text/css" href="../../../webhelp/template/aic-web-watermark.css?buildId=2024112209"/><link rel="stylesheet" type="text/css" href="../../../webhelp/template/topic-body-list.css?buildId=2024112209"/></head>
<body id="compile" 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=" Linux SDK 使用指南 SDK 指南文件 "/></a>
<div class=" wh_publication_title "><a href="../../../index.html"><span class="booktitle"> <span class="ph mainbooktitle">Linux 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/env/sdk-compile.html">SDK 编译</a><div class="wh-tooltip"><p class="shortdesc">介绍不同编译环境下 SDK 的详细编译流程。</p></div></div></div></li><li class="active"><div class="topicref" data-id="compile"><div class="title"><a href="../../../topics/sdk/env/compile.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/env/vmware-config-vm.html" title="配置虚拟机" aria-label="上一主题: 配置虚拟机" rel="prev"></a></span>
<span class="navnext"><a class="- topic/link link" href="../../../topics/sdk/advanced/lb_usage_commands.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-d4445e1079" 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_linux.html" id="revinfo_linux-d4445e1079-link">修订记录</a></div></div></li><li role="treeitem" aria-expanded="true"><div data-tocid="id-d4445e1096" class="topicref" data-id="id" data-state="expanded"><span role="button" tabindex="0" aria-labelledby="button-collapse-action id-d4445e1096-link" class="wh-expand-btn"></span><div class="title"><a href="../../../topics/sdk/env/sdk-compile.html" id="id-d4445e1096-link">SDK 编译</a><div class="wh-tooltip"><p class="shortdesc">介绍不同编译环境下 SDK 的详细编译流程。</p></div></div></div><ul role="group" class="navbar-nav nav-list"><li role="treeitem" aria-expanded="false"><div data-tocid="id-d4445e1113" class="topicref" data-id="id" data-state="not-ready"><span role="button" tabindex="0" aria-labelledby="button-expand-action id-d4445e1113-link" class="wh-expand-btn"></span><div class="title"><a href="../../../topics/sdk/env/sourcecode.html" id="id-d4445e1113-link">准备代码</a></div></div></li><li role="treeitem"><div data-tocid="id-d4445e1143" class="topicref" data-id="id" data-state="leaf"><span role="button" class="wh-expand-btn"></span><div class="title"><a href="../../../topics/sdk/env/ubuntu2004.html" id="id-d4445e1143-link">Ubuntu</a></div></div></li><li role="treeitem" aria-expanded="false"><div data-tocid="id-d4445e1157" class="topicref" data-id="id" data-state="not-ready"><span role="button" tabindex="0" aria-labelledby="button-expand-action id-d4445e1157-link" class="wh-expand-btn"></span><div class="title"><a href="../../../topics/sdk/env/vmware.html" id="id-d4445e1157-link">VMWare 安装</a><div class="wh-tooltip"><p class="shortdesc">如需在虚拟机上进行 <span class="ph">Luban</span> 的开发工作,可以参考本节的安装说明。</p></div></div></div></li><li role="treeitem" class="active"><div data-tocid="compile-d4445e1225" class="topicref" data-id="compile" data-state="leaf"><span role="button" class="wh-expand-btn"></span><div class="title"><a href="../../../topics/sdk/env/compile.html" id="compile-d4445e1225-link">固件编译</a></div></div></li></ul></li><li role="treeitem" aria-expanded="false"><div data-tocid="tocId-d4445e1240" class="topicref" data-state="not-ready"><span role="button" tabindex="0" aria-labelledby="button-expand-action tocId-d4445e1240-link" class="wh-expand-btn"></span><div class="title"><a href="../../../topics/sdk/advanced/lb_usage_commands.html" id="tocId-d4445e1240-link">使用指南</a></div></div></li><li role="treeitem" aria-expanded="false"><div data-tocid="concept_rcx_czh_pzb-d4445e1360" 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-d4445e1360-link" class="wh-expand-btn"></span><div class="title"><a href="../../../topics/sdk/chapter-app.html" id="concept_rcx_czh_pzb-d4445e1360-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-d4445e1678" class="topicref" data-id="id" data-state="not-ready"><span role="button" tabindex="0" aria-labelledby="button-expand-action id-d4445e1678-link" class="wh-expand-btn"></span><div class="title"><a href="../../../topics/sdk/peripheral/peripheral-intro.html" id="id-d4445e1678-link">外设移植</a><div class="wh-tooltip"><p class="shortdesc"><span class="ph">触摸屏、显示器、WIFI 模块、按键</span>等外设的介绍和使用说明。</p></div></div></div></li><li role="treeitem" aria-expanded="false"><div data-tocid="id-d4445e1964" class="topicref" data-id="id" data-state="not-ready"><span role="button" tabindex="0" aria-labelledby="button-expand-action id-d4445e1964-link" class="wh-expand-btn"></span><div class="title"><a href="../../../topics/sdk/bringup/chapter-bringup.html" id="id-d4445e1964-link">BringUp</a><div class="wh-tooltip"><p class="shortdesc">在硬件上电后快速初始化系统,为操作系统的启动准备好必要的硬件环境。</p></div></div></div></li><li role="treeitem" aria-expanded="false"><div data-tocid="id-d4445e2153" class="topicref" data-id="id" data-state="not-ready"><span role="button" tabindex="0" aria-labelledby="button-expand-action id-d4445e2153-link" class="wh-expand-btn"></span><div class="title"><a href="../../../topics/sdk/chapter-advanced-app.html" id="id-d4445e2153-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 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" title="Edit this document" href="http://172.16.35.88/tasks/jdssno1uvvbf2mltu9kb9v3if05d5gopuakboe8hlud18rma/edit/F:/aicdita/aicdita-cn/topics/sdk/env/compile.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">
<p class="- topic/p p" data-ofbid="d161294e42__20250123155216">本节介绍了编译固件的常规流程。在开始编译固件之前,确保编译环境已经搭建完成。关于操作系统和依赖的详细安装说明,可查看<a class="- topic/xref xref" href="ubuntu2004.html">Ubuntu</a>
<a class="- topic/xref xref" href="vmware.html" title="如需在虚拟机上进行 Luban 的开发工作,可以参考本节的安装说明。">VMWare 安装</a></p>
<section class="- topic/section section" id="compile__section_ayk_smt_qdc" data-ofbid="compile__section_ayk_smt_qdc"><h2 class="- topic/title title sectiontitle">项目配置与编译</h2>
<div class="- topic/p p" data-ofbid="d161294e64__20250123155216">选择以下任意一种编译和配置命令方式,对项目进行配置和编译:<ul class="- topic/ul ul" id="compile__ul_fqf_c1l_jdc" data-ofbid="compile__ul_fqf_c1l_jdc">
<li class="- topic/li li" data-ofbid="d161294e68__20250123155216">
<div class="- topic/p p" data-ofbid="d161294e70__20250123155216"><span class="- topic/xref xref">常规 <span class="+ topic/keyword sw-d/cmdname keyword cmdname">make</span>
命令</span>,例如:<pre class="+ topic/pre pr-d/codeblock pre codeblock language-c" id="compile__codecell1" data-ofbid="compile__codecell1"><code>make list
make d211_demo128_nand_defconfig
make</code></pre></div>
</li>
<li class="- topic/li li" data-ofbid="d161294e82__20250123155216">
<div class="- topic/p p" data-ofbid="d161294e84__20250123155216"><span class="- topic/xref xref">OneStep
快捷命令</span>,例如:<pre class="+ topic/pre pr-d/codeblock pre codeblock language-c" id="compile__codeblock_uzc_k1p_fdc" data-ofbid="compile__codeblock_uzc_k1p_fdc"><code>source tools/onestep.sh --&gt; 一步直达命令
lunch d211_demo128_nand_defconfig --&gt; 选择 d211_demo128_nand_defconfig
m --&gt; 编译打包</code></pre></div>
</li>
</ul></div>
</section>
<section class="- topic/section section" id="compile__section_sqc_tmt_qdc" data-ofbid="compile__section_sqc_tmt_qdc"><h2 class="- topic/title title sectiontitle">生成固件</h2>
<div class="- topic/p p" data-ofbid="d161294e100__20250123155216">对于不同的存储介质,生成的固件名称和路径会有所不同:<ul class="- topic/ul ul" id="compile__ul_pgv_k1l_jdc" data-ofbid="compile__ul_pgv_k1l_jdc">
<li class="- topic/li li" data-ofbid="d161294e104__20250123155216">
<div class="- topic/div div">
<p class="- topic/p p" data-ofbid="d161294e108__20250123155216">EMMC 采用 squashfs 文件系统。如果开发板使用的存储介质为 eMMC (eNand),以 demo 工程为例,则编译后的固件名称为
<span class="+ topic/ph sw-d/filepath ph filepath">d211_demo_v1.0.0.img</span></p>
<div class="- topic/p p" data-ofbid="d161294e114__20250123155216">系统输出示例如下:<pre class="+ topic/pre sw-d/msgblock pre msgblock" id="compile__msgblock_lc1_lbl_jdc" data-ofbid="compile__msgblock_lc1_lbl_jdc">Image file is generated: /xxx/d211/luban/output/d211_demo/images/d211_demo_v1.0.0.img</pre></div>
</div>
</li>
<li class="- topic/li li" data-ofbid="d161294e121__20250123155216">
<div class="- topic/div div">
<p class="- topic/p p" data-ofbid="d161294e125__20250123155216">SPI NAND 采用 UBIFS 文件系统。 如果开发板使用的存储介质为 SPI NAND
<span class="+ topic/ph sw-d/filepath ph filepath">demo128_nand</span> 工程为例,则编译后会生成固件的名称
<span class="+ topic/ph sw-d/filepath ph filepath">d211_demo128_nand_page_2k_block_128k_v1.0.0</span></p>
<div class="- topic/p p" data-ofbid="d161294e136__20250123155216">如果 SPI NAND 的 <span class="+ topic/keyword pr-d/parmname keyword parmname">page</span> 尺寸为 4K 大小,可在
<span class="+ topic/ph sw-d/filepath ph filepath">target/d211/xxx/image_cfg.json</span> 文件中配置
<span class="+ topic/keyword pr-d/parmname keyword parmname">page</span> 尺寸,编译后的文件为
<span class="+ topic/ph sw-d/filepath ph filepath">d211_xxx_page_4k_block_256k_v1.0.0.img</span><pre class="+ topic/pre pr-d/codeblock pre codeblock language-c" id="compile__codeblock_spinand_page_size" data-ofbid="compile__codeblock_spinand_page_size"><code><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">"d211"</span>,
<span class="hl-string">"product"</span>: <span class="hl-string">"demo128_nand"</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-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>
],
}
},</code></pre></div>
</div>
</li>
<li class="- topic/li li" data-ofbid="d161294e156__20250123155216">
<div class="- topic/div div">
<p class="- topic/p p" data-ofbid="d161294e160__20250123155216">SPI NOR 采用 squashfs 文件系统。如果开发板使用的存储介质为 SPI NOR<span class="+ topic/ph sw-d/filepath ph filepath">demo88_nor</span>
工程为例,则编译后会生成固件的名称为 <span class="+ topic/ph sw-d/filepath ph filepath">d211_demo88_nor_v1.0.0.img</span></p>
<div class="- topic/p p" data-ofbid="d161294e169__20250123155216">系统输出示例如下:<pre class="+ topic/pre sw-d/msgblock pre msgblock" id="compile__msgblock_mlx_jbl_jdc" data-ofbid="compile__msgblock_mlx_jbl_jdc">Image file is generated: /xxx/d211/develop/output/d211_demo88_nor/images/d211_demo88_nor_v1.0.0.img</pre></div>
<div class="- topic/p p" data-ofbid="d161294e174__20250123155216">SPINOR 的分区信息在 <span class="+ topic/ph sw-d/filepath ph filepath">target/d211/per2_spinor/image_cfg.json</span>
中:<pre class="+ topic/pre pr-d/codeblock pre codeblock language-c" id="compile__codeblock_zqz_lvb_d1c" data-ofbid="compile__codeblock_zqz_lvb_d1c"><code><span class="hl-string">"spi-nor"</span>: { <em class="hl-comment">// Media type</em>
<span class="hl-string">"size"</span>: <span class="hl-string">"16m"</span>, <em class="hl-comment">// Size of 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">"uboot"</span>: { <span class="hl-string">"size"</span>: <span class="hl-string">"640k"</span> },
<span class="hl-string">"userid"</span>: { <span class="hl-string">"size"</span>: <span class="hl-string">"64k"</span> },
<span class="hl-string">"env"</span>: { <span class="hl-string">"size"</span>: <span class="hl-string">"64k"</span> },
<span class="hl-string">"env_r"</span>: { <span class="hl-string">"size"</span>: <span class="hl-string">"64k"</span> },
<span class="hl-string">"falcon"</span>: { <span class="hl-string">"size"</span>: <span class="hl-string">"64k"</span> },
<span class="hl-string">"logo"</span>: { <span class="hl-string">"size"</span>: <span class="hl-string">"512k"</span> },
<span class="hl-string">"kernel"</span>: { <span class="hl-string">"size"</span>: <span class="hl-string">"5m"</span> },
<span class="hl-string">"rootfs"</span>: { <span class="hl-string">"size"</span>: <span class="hl-string">"9m"</span> },
<em class="hl-comment">// "user": { "size": "-" },</em>
}
}</code></pre></div>
</div>
</li>
</ul></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="#compile__section_ayk_smt_qdc" data-tocid="compile__section_ayk_smt_qdc">项目配置与编译</a></div></li><li class="section-item"><div class="section-title"><a href="#compile__section_sqc_tmt_qdc" data-tocid="compile__section_sqc_tmt_qdc">生成固件</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-23
</div>
</div>
</div>
</footer>
<button id="go2top" class="d-print-none" title="返回顶部">
<span class="oxy-icon oxy-icon-up"></span>
</button>
<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>