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

218 lines
20 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="源代码位于 bsp/artinchip/ bsp/artinchip/drv/efuse/drv_efuse.c eFuse Driver 层实现 bsp/artinchip/drv/efuse/efuse_cmds.c eFuse Command 实现 bsp/artinchip/hal/efuse/hal_efuse.c eFuse HAL 层实现 ..."/><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="efuse_design_intro"/><meta name="DC.language" content="zh-CN"/><title>设计说明</title><!-- Build number 2023110923. --><meta name="wh-path2root" content="../../../"/><meta name="wh-toc-id" content=""/><meta name="wh-source-relpath" content="topics/sdk/efuse/efuse-design_intro.dita"/><meta name="wh-out-relpath" content="topics/sdk/efuse/efuse-design_intro.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="efuse_design_intro" 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/efuse/efuse-design_intro.dita">Edit online</a></span><h1 class="- topic/title title topictitle1" id="ariaid-title1">设计说明</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"><div class="- topic/p p" data-ofbid="d215185e22__20250121171643">源代码位于 <span class="+ topic/ph sw-d/filepath ph filepath">bsp/artinchip/</span><ul class="- topic/ul ul" id="efuse_design_intro__ul_uwg_mwq_g1c" data-ofbid="efuse_design_intro__ul_uwg_mwq_g1c"><li class="- topic/li li" data-ofbid="d215185e28__20250121171643">
<p class="- topic/p p" data-ofbid="d215185e30__20250121171643"><span class="+ topic/ph sw-d/filepath ph filepath">bsp/artinchip/drv/efuse/drv_efuse.c</span>eFuse Driver 层实现</p>
</li><li class="- topic/li li" data-ofbid="d215185e35__20250121171643">
<p class="- topic/p p" data-ofbid="d215185e37__20250121171643"><span class="+ topic/ph sw-d/filepath ph filepath">bsp/artinchip/drv/efuse/efuse_cmds.c</span>eFuse Command
实现</p>
</li><li class="- topic/li li" data-ofbid="d215185e42__20250121171643">
<p class="- topic/p p" data-ofbid="d215185e44__20250121171643"><span class="+ topic/ph sw-d/filepath ph filepath">bsp/artinchip/hal/efuse/hal_efuse.c</span>eFuse HAL 层实现</p>
</li><li class="- topic/li li" data-ofbid="d215185e49__20250121171643">
<p class="- topic/p p" data-ofbid="d215185e51__20250121171643"><span class="+ topic/ph sw-d/filepath ph filepath">bsp/artinchip/include/hal/hal_efuse.h</span>eFuse HAL
层接口头文件</p>
</li></ul></div><section class="- topic/section section" id="efuse_design_intro__section_pbz_nwq_g1c" data-ofbid="efuse_design_intro__section_pbz_nwq_g1c"><h2 class="- topic/title title sectiontitle">模块架构</h2>
<p class="- topic/p p" data-ofbid="d215185e61__20250121171643">eFuse 驱动 Driver 层采用 直接调用 HAL 层的接口,并将 Driver 层封装成 Command如果只使用 HAL 层也可以支持 Baremetal
方式的应用场景。</p>
<figure class="- topic/fig fig fignone" id="efuse_design_intro__fig_xpc_pwq_g1c" data-ofbid="efuse_design_intro__fig_xpc_pwq_g1c"><br/><div class="imagecenter"><img class="- topic/image image imagecenter" id="efuse_design_intro__image_o2m_4wq_g1c" src="../../../images/efuse/sw_system8.png" alt="sw_system8"/></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">eFuse 驱动的软件架构图</span></figcaption></figure>
</section><section class="- topic/section section" id="efuse_design_intro__section_nrh_qqy_21c" data-ofbid="efuse_design_intro__section_nrh_qqy_21c"><h2 class="- topic/title title sectiontitle">关键流程设计</h2>
<p class="- topic/p p" data-ofbid="d215185e76__20250121171643"><strong class="+ topic/ph hi-d/b ph b">初始化流程</strong></p>
<p class="- topic/p p" data-ofbid="d215185e80__20250121171643">eFuse 驱动初始化接口通过命令完成,使用 efuse init 命令。</p>
<div class="- topic/p p" data-ofbid="d215185e83__20250121171643">eFuse 初始化过程,主要步骤有:<ol class="- topic/ol ol" id="efuse_design_intro__ol_ivj_rwq_g1c" data-ofbid="efuse_design_intro__ol_ivj_rwq_g1c"><li class="- topic/li li" data-ofbid="d215185e86__20250121171643">
<p class="- topic/p p" data-ofbid="d215185e88__20250121171643">初始化模块的 clk</p>
</li><li class="- topic/li li" data-ofbid="d215185e91__20250121171643">
<p class="- topic/p p" data-ofbid="d215185e93__20250121171643">导出 Command 到 MSH 节点</p>
</li></ol></div>
</section><section class="- topic/section section" id="efuse_design_intro__section_qpt_5wq_g1c" data-ofbid="efuse_design_intro__section_qpt_5wq_g1c"><h2 class="- topic/title title sectiontitle">Driver 层接口设计</h2>
<div class="table-container"><table class="- topic/table table frame-all" id="efuse_design_intro__table_ahy_twq_g1c" data-ofbid="efuse_design_intro__table_ahy_twq_g1c" data-cols="2"><caption class="- topic/title title tablecap" data-caption-side="top" data-is-repeated="true"><span class="table--title-label"><span class="table--title-label-number"> 1</span><span class="table--title-label-punctuation">. </span></span><span class="table--title">drv_efuse_read</span></caption><colgroup><col style="width:25%"/><col style="width:75%"/></colgroup><thead class="- topic/thead thead"><tr class="- topic/row"><th class="- topic/entry entry colsep-1 rowsep-1" id="efuse_design_intro__table_ahy_twq_g1c__entry__1">函数原型</th><th class="- topic/entry entry colsep-0 rowsep-1" id="efuse_design_intro__table_ahy_twq_g1c__entry__2">int drv_efuse_read(u32 addr, void *data, u32 size)</th></tr></thead><tbody class="- topic/tbody tbody"><tr class="- topic/row"><td class="- topic/entry entry colsep-1 rowsep-1" headers="efuse_design_intro__table_ahy_twq_g1c__entry__1">功能说明</td><td class="- topic/entry entry colsep-0 rowsep-1" headers="efuse_design_intro__table_ahy_twq_g1c__entry__2">eFuse 读取接口</td></tr><tr class="- topic/row"><td class="- topic/entry entry colsep-1 rowsep-1" headers="efuse_design_intro__table_ahy_twq_g1c__entry__1">参数定义</td><td class="- topic/entry entry colsep-0 rowsep-1" headers="efuse_design_intro__table_ahy_twq_g1c__entry__2">
<ul class="- topic/ul ul" id="efuse_design_intro__ul_r4g_5y3_zbc" data-ofbid="efuse_design_intro__ul_r4g_5y3_zbc"><li class="- topic/li li" data-ofbid="d215185e126__20250121171643">addr - 读取的地址 </li><li class="- topic/li li" data-ofbid="d215185e128__20250121171643">data - 输出缓冲区 </li><li class="- topic/li li" data-ofbid="d215185e130__20250121171643">size - 读取数据的长度</li></ul>
</td></tr><tr class="- topic/row"><td class="- topic/entry entry colsep-1 rowsep-1" headers="efuse_design_intro__table_ahy_twq_g1c__entry__1">返回值</td><td class="- topic/entry entry colsep-0 rowsep-1" headers="efuse_design_intro__table_ahy_twq_g1c__entry__2">≤ 0读取失败。其它成功读取到的数据长度</td></tr><tr class="- topic/row"><td class="- topic/entry entry colsep-1 rowsep-0" headers="efuse_design_intro__table_ahy_twq_g1c__entry__1">注意事项</td><td class="- topic/entry entry colsep-0 rowsep-0" headers="efuse_design_intro__table_ahy_twq_g1c__entry__2">-</td></tr></tbody></table></div>
<div class="table-container"><table class="- topic/table table frame-all" id="efuse_design_intro__table_bhy_twq_g1c" data-ofbid="efuse_design_intro__table_bhy_twq_g1c" data-cols="2"><caption class="- topic/title title tablecap" data-caption-side="top" data-is-repeated="true"><span class="table--title-label"><span class="table--title-label-number"> 2</span><span class="table--title-label-punctuation">. </span></span><span class="table--title">drv_efuse_program</span></caption><colgroup><col style="width:25%"/><col style="width:75%"/></colgroup><thead class="- topic/thead thead"><tr class="- topic/row"><th class="- topic/entry entry colsep-1 rowsep-1" id="efuse_design_intro__table_bhy_twq_g1c__entry__1">函数原型</th><th class="- topic/entry entry colsep-0 rowsep-1" id="efuse_design_intro__table_bhy_twq_g1c__entry__2">int drv_efuse_program(u32 addr, const void *data, u32
size)</th></tr></thead><tbody class="- topic/tbody tbody"><tr class="- topic/row"><td class="- topic/entry entry colsep-1 rowsep-1" headers="efuse_design_intro__table_bhy_twq_g1c__entry__1">功能说明</td><td class="- topic/entry entry colsep-0 rowsep-1" headers="efuse_design_intro__table_bhy_twq_g1c__entry__2">eFuse 写入接口</td></tr><tr class="- topic/row"><td class="- topic/entry entry colsep-1 rowsep-1" headers="efuse_design_intro__table_bhy_twq_g1c__entry__1">参数定义</td><td class="- topic/entry entry colsep-0 rowsep-1" headers="efuse_design_intro__table_bhy_twq_g1c__entry__2">
<ul class="- topic/ul ul" id="efuse_design_intro__ul_pdl_ty3_zbc" data-ofbid="efuse_design_intro__ul_pdl_ty3_zbc"><li class="- topic/li li" data-ofbid="d215185e168__20250121171643">addr - 写入的地址 </li><li class="- topic/li li" data-ofbid="d215185e170__20250121171643">data - 输入缓冲区 </li><li class="- topic/li li" data-ofbid="d215185e172__20250121171643">size - 写入数据的长度</li></ul>
</td></tr><tr class="- topic/row"><td class="- topic/entry entry colsep-1 rowsep-1" headers="efuse_design_intro__table_bhy_twq_g1c__entry__1">返回值</td><td class="- topic/entry entry colsep-0 rowsep-1" headers="efuse_design_intro__table_bhy_twq_g1c__entry__2">≤ 0写入失败。其它成功写入的数据长度</td></tr><tr class="- topic/row"><td class="- topic/entry entry colsep-1 rowsep-0" headers="efuse_design_intro__table_bhy_twq_g1c__entry__1">注意事项</td><td class="- topic/entry entry colsep-0 rowsep-0" headers="efuse_design_intro__table_bhy_twq_g1c__entry__2">-</td></tr></tbody></table></div>
</section><section class="- topic/section section" id="efuse_design_intro__section_chy_twq_g1c" data-ofbid="efuse_design_intro__section_chy_twq_g1c"><h2 class="- topic/title title sectiontitle">HAL 层接口设计</h2>
<div class="- topic/p p" data-ofbid="d215185e191__20250121171643">HAL 层的函数接口声明存放在 <span class="+ topic/ph sw-d/filepath ph filepath">hal_efuse.h</span>
中,主要接口有:<pre class="+ topic/pre pr-d/codeblock pre codeblock language-c" id="efuse_design_intro__codeblock_xgd_vwq_g1c" data-ofbid="efuse_design_intro__codeblock_xgd_vwq_g1c"><strong class="hl-keyword">int</strong> hal_efuse_init(<strong class="hl-keyword">void</strong>);
<strong class="hl-keyword">int</strong> hal_efuse_deinit(<strong class="hl-keyword">void</strong>);
<strong class="hl-keyword">int</strong> hal_efuse_wait_ready(<strong class="hl-keyword">void</strong>);
<strong class="hl-keyword">int</strong> hal_efuse_read(u32 wid, u32 *wval);
<strong class="hl-keyword">int</strong> hal_efuse_write(u32 wid, u32 wval);</pre></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="#efuse_design_intro__section_pbz_nwq_g1c" data-tocid="efuse_design_intro__section_pbz_nwq_g1c">模块架构</a></div></li><li class="section-item"><div class="section-title"><a href="#efuse_design_intro__section_nrh_qqy_21c" data-tocid="efuse_design_intro__section_nrh_qqy_21c">关键流程设计</a></div></li><li class="section-item"><div class="section-title"><a href="#efuse_design_intro__section_qpt_5wq_g1c" data-tocid="efuse_design_intro__section_qpt_5wq_g1c">Driver 层接口设计</a></div></li><li class="section-item"><div class="section-title"><a href="#efuse_design_intro__section_chy_twq_g1c" data-tocid="efuse_design_intro__section_chy_twq_g1c">HAL 层接口设计</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>