Files
luban-lite-t3e-pro/doc/topics/sdk/spienc/spi-enc-configuration.html
2025-01-23 16:37:00 +08:00

208 lines
16 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="驱动配置 在 Luban-Lite 根目录下执行 scons --menuconfig ,进入 menuconfig 的功能配置界面,按如下选择(配置只打开了 QSPI0 的加密使能,作为示例): Board options ---&gt; [*] Using spienc ---&gt; [*] Enc qspi0 SPIENC 中的 Tweak 可以影响 COUNTER 的生成,进而改变加密的结果。 ..."/><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-16"/><meta name="DC.format" content="HTML5"/><meta name="DC.identifier" content="spi_enc_configuration"/><meta name="DC.language" content="zh-CN"/><title>SPI ENC 配置</title><!-- Build number 2023110923. --><meta name="wh-path2root" content="../../../"/><meta name="wh-toc-id" content=""/><meta name="wh-source-relpath" content="topics/sdk/spienc/spi-enc-configuration.dita"/><meta name="wh-out-relpath" content="topics/sdk/spienc/spi-enc-configuration.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="spi_enc_configuration" 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/spienc/spi-enc-configuration.dita">Edit online</a></span><h1 class="- topic/title title topictitle1" id="ariaid-title1">SPI ENC 配置</h1><div class="date inPage">16 Dec 2024</div><div style="color: gray;">
Read time: 1 minute(s)
</div><div class="- topic/body concept/conbody body conbody"><section class="- topic/section section" id="spi_enc_configuration__section_hsh_hxq_g1c" data-ofbid="spi_enc_configuration__section_hsh_hxq_g1c"><h2 class="- topic/title title sectiontitle">驱动配置</h2>
<p class="- topic/p p" data-ofbid="d195336e27__20250121171632">在 Luban-Lite 根目录下执行 <span class="+ topic/keyword sw-d/cmdname keyword cmdname">scons --menuconfig</span>,进入 menuconfig
的功能配置界面,按如下选择(配置只打开了 QSPI0 的加密使能,作为示例):</p>
<pre class="+ topic/pre pr-d/codeblock pre codeblock language-c" id="spi_enc_configuration__pre_ish_hxq_g1c" data-ofbid="spi_enc_configuration__pre_ish_hxq_g1c">Board options ---&gt;
[*] Using spienc ---&gt;
[*] Enc qspi0
</pre>
<p class="- topic/p p" data-ofbid="d195336e36__20250121171632">SPIENC 中的 Tweak 可以影响 COUNTER 的生成,进而改变加密的结果。 如果需要让在不同的产品对相同的数据有不同的加密结果,则可以进入
menuconfig 的功能配置界面调整该值。</p>
<pre class="+ topic/pre pr-d/codeblock pre codeblock language-c" id="spi_enc_configuration__pre_jsh_hxq_g1c" data-ofbid="spi_enc_configuration__pre_jsh_hxq_g1c">Board options ---&gt;
[*] Using spienc ---&gt;
(<span class="hl-number">0</span>) set qspi0 tweak</pre>
</section><section class="- topic/section section" id="spi_enc_configuration__section_syv_drx_21c" data-ofbid="spi_enc_configuration__section_syv_drx_21c"><h2 class="- topic/title title sectiontitle">密钥配置</h2>
<p class="- topic/p p" data-ofbid="d195336e47__20250121171632">SPI_ENC 模块使用 AES-128-CTR 算法对 SPI 总线数据进行加解密,该算法在计算时的密钥有两部分</p>
<ul class="- topic/ul ul" id="spi_enc_configuration__ul_uyv_drx_21c" data-ofbid="spi_enc_configuration__ul_uyv_drx_21c"><li class="- topic/li li" data-ofbid="d195336e51__20250121171632">
<p class="- topic/p p" data-ofbid="d195336e53__20250121171632">128 bit AES 密钥(KEY)</p>
</li><li class="- topic/li li" data-ofbid="d195336e56__20250121171632">
<p class="- topic/p p" data-ofbid="d195336e58__20250121171632">128 bit 数据块的 COUNTER 值</p>
</li></ul>
<p class="- topic/p p" data-ofbid="d195336e62__20250121171632">其中 KEY 直接使用 eFuse 中的 <code class="+ topic/ph pr-d/codeph ph codeph">SPI_ENC_KEY</code> COUNTER 值则由几部分共同产生</p>
<ul class="- topic/ul ul" id="spi_enc_configuration__ul_wyv_drx_21c" data-ofbid="spi_enc_configuration__ul_wyv_drx_21c"><li class="- topic/li li" data-ofbid="d195336e69__20250121171632">
<p class="- topic/p p" data-ofbid="d195336e71__20250121171632">eFuse 中的 <code class="+ topic/ph pr-d/codeph ph codeph">SPI_ENC_NONCE</code></p>
</li><li class="- topic/li li" data-ofbid="d195336e76__20250121171632">
<p class="- topic/p p" data-ofbid="d195336e78__20250121171632">menuconfig 的功能配置界面中配置的 <code class="+ topic/ph pr-d/codeph ph codeph">tweak</code></p>
</li><li class="- topic/li li" data-ofbid="d195336e83__20250121171632">
<p class="- topic/p p" data-ofbid="d195336e85__20250121171632">访问数据所在的地址 <code class="+ topic/ph pr-d/codeph ph codeph">address</code></p>
<figure class="- topic/fig fig fignone" id="spi_enc_configuration__fig_k5p_frx_21c" data-ofbid="spi_enc_configuration__fig_k5p_frx_21c"><br/><div class="imagecenter"><img class="- topic/image image imagecenter" id="spi_enc_configuration__image_xyv_drx_21c" src="../../../images/spienc/spienc_counter_value1.png" alt="spienc_counter_value1"/></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">COUNTER 值的生成</span></figcaption></figure>
</li></ul>
<p class="- topic/p p" data-ofbid="d195336e99__20250121171632">因此在使能 SPI_ENC 时,需要设置以下的 eFuse 信息:</p>
<div class="table-container"><table class="- topic/table table frame-all" id="spi_enc_configuration__table_yyv_drx_21c" data-ofbid="spi_enc_configuration__table_yyv_drx_21c" data-cols="3"><caption></caption><colgroup><col style="width:33.33333333333333%"/><col style="width:15.873015873015872%"/><col style="width:50.79365079365079%"/></colgroup><thead class="- topic/thead thead"><tr class="- topic/row"><th class="- topic/entry entry colsep-1 rowsep-1" id="spi_enc_configuration__table_yyv_drx_21c__entry__1">eFuse 区域</th><th class="- topic/entry entry colsep-1 rowsep-1" id="spi_enc_configuration__table_yyv_drx_21c__entry__2">大小(BIT)</th><th class="- topic/entry entry colsep-0 rowsep-1" id="spi_enc_configuration__table_yyv_drx_21c__entry__3">说明</th></tr></thead><tbody class="- topic/tbody tbody"><tr class="- topic/row"><td class="- topic/entry entry colsep-1 rowsep-1" headers="spi_enc_configuration__table_yyv_drx_21c__entry__1">SPI_ENC_KEY</td><td class="- topic/entry entry colsep-1 rowsep-1" headers="spi_enc_configuration__table_yyv_drx_21c__entry__2">128</td><td class="- topic/entry entry colsep-0 rowsep-1" headers="spi_enc_configuration__table_yyv_drx_21c__entry__3">AES 密钥,烧录后应设置不可读写</td></tr><tr class="- topic/row"><td class="- topic/entry entry colsep-1 rowsep-1" headers="spi_enc_configuration__table_yyv_drx_21c__entry__1">SPI_ENC_NONCE</td><td class="- topic/entry entry colsep-1 rowsep-1" headers="spi_enc_configuration__table_yyv_drx_21c__entry__2">64</td><td class="- topic/entry entry colsep-0 rowsep-1" headers="spi_enc_configuration__table_yyv_drx_21c__entry__3">用于生成 COUTNER 的随机数,烧录后应设置不可读写</td></tr><tr class="- topic/row"><td class="- topic/entry entry colsep-1 rowsep-0" headers="spi_enc_configuration__table_yyv_drx_21c__entry__1">SPI_ENC_ENABLE BIT</td><td class="- topic/entry entry colsep-1 rowsep-0" headers="spi_enc_configuration__table_yyv_drx_21c__entry__2">1</td><td class="- topic/entry entry colsep-0 rowsep-0" headers="spi_enc_configuration__table_yyv_drx_21c__entry__3">使能 BROM 的 SPI_ENC 功能,才可正确启动</td></tr></tbody></table></div>
<p class="- topic/p p" data-ofbid="d195336e138__20250121171632">具体 eFuse 区域的地址,请参考芯片的数据手册。</p>
</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="#spi_enc_configuration__section_hsh_hxq_g1c" data-tocid="spi_enc_configuration__section_hsh_hxq_g1c">驱动配置</a></div></li><li class="section-item"><div class="section-title"><a href="#spi_enc_configuration__section_syv_drx_21c" data-tocid="spi_enc_configuration__section_syv_drx_21c">密钥配置</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>