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

190 lines
13 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="Pre-Boot Program (PBP) 是 ArtInChip 芯片平台启动过程中的一段程序,在 BROM 程序跳转执行 SPL 之前, 运行的代码。 PBP 程序用于初始化一些不开放的硬件模块,比如 DRAM 控制器的初始化。 存放位置 PBP 程序是以二进制形式保存在 SDK 中,通常位于 target/ chip /common/ chipname .pbp 在 mk_image.py ..."/><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-04"/><meta name="DC.format" content="HTML5"/><meta name="DC.identifier" content="pbp"/><meta name="DC.language" content="zh-CN"/><title>Pre-Boot Program (PBP)</title><!-- Build number 2023110923. --><meta name="wh-path2root" content="../../../"/><meta name="wh-toc-id" content=""/><meta name="wh-source-relpath" content="topics/sdk/boot/pre-boot-program.dita"/><meta name="wh-out-relpath" content="topics/sdk/boot/pre-boot-program.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="pbp" 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/pre-boot-program.dita">Edit online</a></span><h1 class="- topic/title title topictitle1" id="ariaid-title1">Pre-Boot Program (PBP)</h1><div class="date inPage">4 Dec 2024</div><div style="color: gray;">
Read time: 1 minute(s)
</div><div class="- topic/body concept/conbody body conbody"><p class="- topic/p p" data-ofbid="d126046e22__20250121171601">Pre-Boot Program (PBP) 是 ArtInChip 芯片平台启动过程中的一段程序,在 BROM 程序跳转执行 SPL 之前, 运行的代码。 PBP
程序用于初始化一些不开放的硬件模块,比如 DRAM 控制器的初始化。</p><section class="- topic/section section" id="pbp__section_iqh_3gh_bzb" data-ofbid="pbp__section_iqh_3gh_bzb"><h2 class="- topic/title title sectiontitle">存放位置</h2><p class="- topic/p p" data-ofbid="d126046e27__20250121171601">PBP 程序是以二进制形式保存在 SDK 中,通常位于
<span class="+ topic/ph sw-d/filepath ph filepath">target/<var class="+ topic/keyword sw-d/varname keyword varname">chip</var>/common/<var class="+ topic/keyword sw-d/varname keyword varname">chipname</var>.pbp</span></p><p class="- topic/p p" data-ofbid="d126046e37__20250121171601">
<span class="+ topic/ph sw-d/filepath ph filepath">mk_image.py</span> 生成镜像文件的过程中PBP 程序与 SPL 程序一起被打包到 AIC 启动镜像文件当中。
具体配置可以查看对应项目的 <span class="+ topic/ph sw-d/filepath ph filepath">image_cfg.json</span> 文件。</p><div class="- topic/p p" data-ofbid="d126046e45__20250121171601"><br/><div class="imagecenter"><img class="- topic/image image imagecenter" id="pbp__image_lqh_3gh_bzb" src="../../../images/boot/pbp_place_in_img.png"/></div><br/></div></section><section class="- topic/section section" id="pbp__section_mqh_3gh_bzb" data-ofbid="pbp__section_mqh_3gh_bzb"><h2 class="- topic/title title sectiontitle">何时运行</h2><p class="- topic/p p" data-ofbid="d126046e50__20250121171601">正常启动过程中BROM 会检查 PBP
程序是否存在,如果存在,则跳转执行 PBP 程序。PBP 程序执行完毕, 会返回到 BROM。BROM 则继续跳转执行 SPL 程序。</p><div class="- topic/p p" data-ofbid="d126046e52__20250121171601"><br/><div class="imagecenter"><img class="- topic/image image imagecenter" id="pbp__image_nqh_3gh_bzb" src="../../../images/brom/brom_run_pbp.png"/></div><br/></div></section><section class="- topic/section section" id="pbp__section_oqh_3gh_bzb" data-ofbid="pbp__section_oqh_3gh_bzb"><h2 class="- topic/title title sectiontitle">参数配置</h2>
<p class="- topic/p p" data-ofbid="d126046e59__20250121171601">不同项目,可能需要传递一些配置参数给 PBP 使用,可以通过 AIC 启动镜像的 <span class="+ topic/keyword pr-d/parmname keyword parmname">Private data area</span>
保存这些参数。PBP 在被执行时可以得到该区域的地址和长度,然后自行解析数据,得到具体的参数。</p>
<figure class="- topic/fig fig fignone" id="pbp__fig_vs1_lvr_c1c" data-ofbid="pbp__fig_vs1_lvr_c1c"><br/><div class="imagecenter"><img class="- topic/image image imagecenter" id="pbp__image_pqh_3gh_bzb" src="../../../images/boot/private_data_for_pbp.png"/></div><br/><figcaption data-caption-side="bottom" class="- topic/title title figcapcenter"><span class="figtitleprefix fig--title-label"><span class="fig--title-label-number"> 1</span><span class="fig--title-label-punctuation">. </span></span><span class="fig--title">Private data 与 PBP 的保存位置</span></figcaption></figure>
<p class="- topic/p p" data-ofbid="d126046e70__20250121171601">PBP 程序运行时,可以得到 <span class="+ topic/keyword pr-d/parmname keyword parmname">Private data area</span> 的地址。</p>
<pre class="+ topic/pre pr-d/codeblock pre codeblock language-c" id="pbp__codeblock_qqh_3gh_bzb" data-ofbid="pbp__codeblock_qqh_3gh_bzb"><strong class="hl-keyword">void</strong> pbp_main(u32 boot_param, <strong class="hl-keyword">void</strong> *priv_addr, u32 priv_len)
{
...
}</pre>
</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="#pbp__section_iqh_3gh_bzb" data-tocid="pbp__section_iqh_3gh_bzb">存放位置</a></div></li><li class="section-item"><div class="section-title"><a href="#pbp__section_mqh_3gh_bzb" data-tocid="pbp__section_mqh_3gh_bzb">何时运行</a></div></li><li class="section-item"><div class="section-title"><a href="#pbp__section_oqh_3gh_bzb" data-tocid="pbp__section_oqh_3gh_bzb">参数配置</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>