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

360 lines
38 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="用户空间编程使用 CE 时,根据使用场景和需求的不同,有几层 API 可以选择: AF_ALG Socket API Libkcapi API OpenSSL API 图 1 . 用户空间 API 对接 AF_ALG API 相关 API 可参考头文件 linux/if_alg.h 要使用内核提供的算法和驱动,需要知道对应的算法名字。可通过下列命令获取: cat /proc/crypto 例如: ..."/><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.relation" content="../../../topics/sdk/ce/ce-design_intro.html"/><meta name="DC.relation" content="../../../topics/sdk/ce/ce-interface_design.html"/><meta name="DC.relation" content="../../../topics/sdk/efuse/efuse_user_guide.html"/><meta name="DC.contributor" content="yan.wang"/><meta name="DC.contributor" content="yan.wang"/><meta name="DC.date.modified" content="2024-01-15"/><meta name="DC.format" content="HTML5"/><meta name="DC.identifier" content="ce_demo"/><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="ce_demo-d4445e8101"/><meta name="wh-source-relpath" content="topics/sdk/ce/ce-demo.dita"/><meta name="wh-out-relpath" content="topics/sdk/ce/ce-demo.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="ce_demo" 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/chapter-advanced-app.html">高级应用</a><div class="wh-tooltip"><p class="shortdesc">系统、存储、多媒体、接口、安全等模块的详细配置和设计说明。</p></div></div></div></li><li><div class="topicref" data-id="chapter-safety"><div class="title"><a href="../../../topics/chapter-title/chapter-safety-sdk.html">安全</a><div class="wh-tooltip"><p class="shortdesc">SPI ENC、CE、eFuse 等安全模块的介绍和使用说明。</p></div></div></div></li><li><div class="topicref" data-id="ce_user_guide"><div class="title"><a href="../../../topics/sdk/ce/ce_user_guide.html">CE 使用指南</a></div></div></li><li><div class="topicref" data-id="ce_design_intro"><div class="title"><a href="../../../topics/sdk/ce/ce-design_intro.html">设计说明</a></div></div></li><li class="active"><div class="topicref" data-id="ce_demo"><div class="title"><a href="../../../topics/sdk/ce/ce-demo.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/ce/ce-interface_design.html" title="接口设计" aria-label="上一主题: 接口设计" rel="prev"></a></span>
<span class="navnext"><a class="- topic/link link" href="../../../topics/sdk/efuse/efuse_user_guide.html" title="eFuse 使用指南" aria-label="下一主题: eFuse 使用指南" 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="false"><div data-tocid="id-d4445e1096" class="topicref" data-id="id" data-state="not-ready"><span role="button" tabindex="0" aria-labelledby="button-expand-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></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="true"><div data-tocid="id-d4445e2153" class="topicref" data-id="id" data-state="expanded"><span role="button" tabindex="0" aria-labelledby="button-collapse-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><ul role="group" class="navbar-nav nav-list"><li role="treeitem" aria-expanded="false"><div data-tocid="uBoot-d4445e2170" class="topicref" data-id="uBoot" data-state="not-ready"><span role="button" tabindex="0" aria-labelledby="button-expand-action uBoot-d4445e2170-link" class="wh-expand-btn"></span><div class="title"><a href="../../../topics/sdk/boot/uboot-module.html" id="uBoot-d4445e2170-link">U-Boot</a><div class="wh-tooltip"><p class="shortdesc">启动支持的基本功能以及运行时的基本硬件环境。</p></div></div></div></li><li role="treeitem" aria-expanded="false"><div data-tocid="concept_mtx_tk3_pzb-d4445e3028" class="topicref" data-id="concept_mtx_tk3_pzb" data-state="not-ready"><span role="button" tabindex="0" aria-labelledby="button-expand-action concept_mtx_tk3_pzb-d4445e3028-link" class="wh-expand-btn"></span><div class="title"><a href="../../../topics/sdk/linux/chapter_linux.html" id="concept_mtx_tk3_pzb-d4445e3028-link">Linux</a></div></div></li><li role="treeitem" aria-expanded="false"><div data-tocid="chapter-system-d4445e3198" class="topicref" data-id="chapter-system" data-state="not-ready"><span role="button" tabindex="0" aria-labelledby="button-expand-action chapter-system-d4445e3198-link" class="wh-expand-btn"></span><div class="title"><a href="../../../topics/chapter-title/chapter-system.html" id="chapter-system-d4445e3198-link">系统</a><div class="wh-tooltip"><p class="shortdesc"></p></div></div></div></li><li role="treeitem" aria-expanded="false"><div data-tocid="chapter-memory-d4445e4054" class="topicref" data-id="chapter-memory" data-state="not-ready"><span role="button" tabindex="0" aria-labelledby="button-expand-action chapter-memory-d4445e4054-link" class="wh-expand-btn"></span><div class="title"><a href="../../../topics/chapter-title/chapter-memory-sdk.html" id="chapter-memory-d4445e4054-link">存储</a><div class="wh-tooltip"><p class="shortdesc">SDMC、SPI NAND、SPI NOR 等存储模块的介绍和使用说明。</p></div></div></div></li><li role="treeitem" aria-expanded="false"><div data-tocid="concept_mcc_32s_nbc-d4445e4438" class="topicref" data-id="concept_mcc_32s_nbc" data-state="not-ready"><span role="button" tabindex="0" aria-labelledby="button-expand-action concept_mcc_32s_nbc-d4445e4438-link" class="wh-expand-btn"></span><div class="title"><a href="../../../topics/chapter-title/chapter-multi-media-sdk.html" id="concept_mcc_32s_nbc-d4445e4438-link">多媒体</a><div class="wh-tooltip"><p class="shortdesc">GE、VE、Display、DVP、MPP、MPP 播放器等多媒体模块的介绍和使用说明。</p></div></div></div></li><li role="treeitem" aria-expanded="false"><div data-tocid="concept_nww_hzh_pzb-d4445e5947" class="topicref" data-id="concept_nww_hzh_pzb" data-state="not-ready"><span role="button" tabindex="0" aria-labelledby="button-expand-action concept_nww_hzh_pzb-d4445e5947-link" class="wh-expand-btn"></span><div class="title"><a href="../../../topics/chapter-title/chapter-interface-sdk.html" id="concept_nww_hzh_pzb-d4445e5947-link">接口</a><div class="wh-tooltip"><p class="shortdesc">CAN、CIR、GPAI、GPIO、I2C、PSADC、PWM 等接口模块的介绍和使用说明。</p></div></div></div></li><li role="treeitem" aria-expanded="true"><div data-tocid="chapter-safety-d4445e7944" class="topicref" data-id="chapter-safety" data-state="expanded"><span role="button" tabindex="0" aria-labelledby="button-collapse-action chapter-safety-d4445e7944-link" class="wh-expand-btn"></span><div class="title"><a href="../../../topics/chapter-title/chapter-safety-sdk.html" id="chapter-safety-d4445e7944-link">安全</a><div class="wh-tooltip"><p class="shortdesc">SPI ENC、CE、eFuse 等安全模块的介绍和使用说明。</p></div></div></div><ul role="group" class="navbar-nav nav-list"><li role="treeitem" aria-expanded="true"><div data-tocid="ce_user_guide-d4445e7961" class="topicref" data-id="ce_user_guide" data-state="expanded"><span role="button" tabindex="0" aria-labelledby="button-collapse-action ce_user_guide-d4445e7961-link" class="wh-expand-btn"></span><div class="title"><a href="../../../topics/sdk/ce/ce_user_guide.html" id="ce_user_guide-d4445e7961-link">CE 使用指南</a></div></div><ul role="group" class="navbar-nav nav-list"><li role="treeitem"><div data-tocid="ce_configuration-d4445e7975" class="topicref" data-id="ce_configuration" data-state="leaf"><span role="button" class="wh-expand-btn"></span><div class="title"><a href="../../../topics/sdk/ce/ce_config.html" id="ce_configuration-d4445e7975-link">CE 配置</a></div></div></li><li role="treeitem"><div data-tocid="ce_debug_guide-d4445e7989" class="topicref" data-id="ce_debug_guide" data-state="leaf"><span role="button" class="wh-expand-btn"></span><div class="title"><a href="../../../topics/sdk/ce/ce_debug.html" id="ce_debug_guide-d4445e7989-link">调试指南</a></div></div></li><li role="treeitem"><div data-tocid="ce_test_guide-d4445e8003" class="topicref" data-id="ce_test_guide" data-state="leaf"><span role="button" class="wh-expand-btn"></span><div class="title"><a href="../../../topics/sdk/ce/ce_test.html" id="ce_test_guide-d4445e8003-link">测试指南</a></div></div></li><li role="treeitem" aria-expanded="true"><div data-tocid="ce_design_intro-d4445e8017" class="topicref" data-id="ce_design_intro" data-state="expanded"><span role="button" tabindex="0" aria-labelledby="button-collapse-action ce_design_intro-d4445e8017-link" class="wh-expand-btn"></span><div class="title"><a href="../../../topics/sdk/ce/ce-design_intro.html" id="ce_design_intro-d4445e8017-link">设计说明</a></div></div><ul role="group" class="navbar-nav nav-list"><li role="treeitem"><div data-tocid="ce_architecture-d4445e8031" class="topicref" data-id="ce_architecture" data-state="leaf"><span role="button" class="wh-expand-btn"></span><div class="title"><a href="../../../topics/sdk/ce/ce_architecture.html" id="ce_architecture-d4445e8031-link">模块架构</a></div></div></li><li role="treeitem"><div data-tocid="ce_key_design_intro-d4445e8045" class="topicref" data-id="ce_key_design_intro" data-state="leaf"><span role="button" class="wh-expand-btn"></span><div class="title"><a href="../../../topics/sdk/ce/ce-key_design_intro.html" id="ce_key_design_intro-d4445e8045-link">设计要点</a></div></div></li><li role="treeitem"><div data-tocid="ce_key_procedures-d4445e8059" class="topicref" data-id="ce_key_procedures" data-state="leaf"><span role="button" class="wh-expand-btn"></span><div class="title"><a href="../../../topics/sdk/ce/ce-key_procedures.html" id="ce_key_procedures-d4445e8059-link">关键流程设计</a></div></div></li><li role="treeitem"><div data-tocid="ce_data_structure_design-d4445e8073" class="topicref" data-id="ce_data_structure_design" data-state="leaf"><span role="button" class="wh-expand-btn"></span><div class="title"><a href="../../../topics/sdk/ce/ce_data_struct.html" id="ce_data_structure_design-d4445e8073-link">数据结构设计</a></div></div></li><li role="treeitem"><div data-tocid="ce_interface_design-d4445e8087" class="topicref" data-id="ce_interface_design" data-state="leaf"><span role="button" class="wh-expand-btn"></span><div class="title"><a href="../../../topics/sdk/ce/ce-interface_design.html" id="ce_interface_design-d4445e8087-link">接口设计</a></div></div></li><li role="treeitem" class="active"><div data-tocid="ce_demo-d4445e8101" class="topicref" data-id="ce_demo" data-state="leaf"><span role="button" class="wh-expand-btn"></span><div class="title"><a href="../../../topics/sdk/ce/ce-demo.html" id="ce_demo-d4445e8101-link">应用编程</a></div></div></li></ul></li></ul></li><li role="treeitem" aria-expanded="false"><div data-tocid="efuse_user_guide-d4445e8115" class="topicref" data-id="efuse_user_guide" data-state="not-ready"><span role="button" tabindex="0" aria-labelledby="button-expand-action efuse_user_guide-d4445e8115-link" class="wh-expand-btn"></span><div class="title"><a href="../../../topics/sdk/efuse/efuse_user_guide.html" id="efuse_user_guide-d4445e8115-link">eFuse 使用指南</a></div></div></li><li role="treeitem" aria-expanded="false"><div data-tocid="spi_enc_user_guide-d4445e8185" class="topicref" data-id="spi_enc_user_guide" data-state="not-ready"><span role="button" tabindex="0" aria-labelledby="button-expand-action spi_enc_user_guide-d4445e8185-link" class="wh-expand-btn"></span><div class="title"><a href="../../../topics/sdk/spienc/spi-enc-user-guide.html" id="spi_enc_user_guide-d4445e8185-link">SPI ENC</a></div></div></li></ul></li></ul></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 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" title="Edit this document" href="http://172.16.35.88/tasks/jdssno1uvvbf2mltu9kb9v3if05d5gopuakboe8hlud18rma/edit/F:/aicdita/aicdita-cn/topics/sdk/ce/ce-demo.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: 3 minute(s)
</div>
<div class="- topic/body concept/conbody body conbody">
<p class="- topic/p p" data-ofbid="d94047e33__20250123155207">用户空间编程使用 CE 时,根据使用场景和需求的不同,有几层 API 可以选择:</p>
<ul class="- topic/ul ul" id="ce_demo__ul_p45_vpy_21c" data-ofbid="ce_demo__ul_p45_vpy_21c">
<li class="- topic/li li" data-ofbid="d94047e38__20250123155207">
<p class="- topic/p p" data-ofbid="d94047e40__20250123155207"><span class="+ topic/keyword pr-d/apiname keyword apiname">AF_ALG Socket API</span></p>
</li>
<li class="- topic/li li" data-ofbid="d94047e45__20250123155207">
<p class="- topic/p p" data-ofbid="d94047e47__20250123155207"><span class="+ topic/keyword pr-d/apiname keyword apiname">Libkcapi API</span></p>
</li>
<li class="- topic/li li" data-ofbid="d94047e52__20250123155207">
<p class="- topic/p p" data-ofbid="d94047e54__20250123155207"><span class="+ topic/keyword pr-d/apiname keyword apiname">OpenSSL API</span></p>
</li>
</ul>
<figure class="- topic/fig fig fignone" id="ce_demo__fig_ndg_cqy_21c" data-ofbid="ce_demo__fig_ndg_cqy_21c">
<br/><div class="imagecenter"><img class="- topic/image image imagecenter" id="ce_demo__image_q45_vpy_21c" src="../../../images/ce/ce_userpace_api.png" alt="ce_userpace_api"/></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">用户空间 API 对接</span></figcaption></figure>
<section class="- topic/section section" id="ce_demo__section_r45_vpy_21c" data-ofbid="ce_demo__section_r45_vpy_21c"><h2 class="- topic/title title sectiontitle">AF_ALG API</h2>
<p class="- topic/p p" data-ofbid="d94047e77__20250123155207">相关 API 可参考头文件 <span class="+ topic/ph sw-d/filepath ph filepath">linux/if_alg.h</span></p>
<div class="- topic/p p" data-ofbid="d94047e82__20250123155207">要使用内核提供的算法和驱动,需要知道对应的算法名字。可通过下列命令获取:<pre class="+ topic/pre pr-d/codeblock pre codeblock language-c" id="ce_demo__codeblock_ysz_kc3_p1c" data-ofbid="ce_demo__codeblock_ysz_kc3_p1c"><code>cat /proc/crypto</code></pre></div>
<div class="- topic/p p" data-ofbid="d94047e87__20250123155207">例如:<pre class="+ topic/pre pr-d/codeblock pre codeblock language-c" id="ce_demo__codeblock_aq2_bqy_21c" data-ofbid="ce_demo__codeblock_aq2_bqy_21c"><code>name : ctr(aes)
driver : ctr-aes-aic
module : kernel
priority : <span class="hl-number">400</span>
refcnt : <span class="hl-number">1</span>
selftest : passed
internal : no
type : skcipher
async : yes
blocksize : <span class="hl-number">16</span>
min keysize : <span class="hl-number">16</span>
max keysize : <span class="hl-number">32</span>
ivsize : <span class="hl-number">16</span>
chunksize : <span class="hl-number">16</span>
walksize : <span class="hl-number">16</span>
name : cbc(aes)
driver : cbc-aes-aic
module : kernel
priority : <span class="hl-number">400</span>
refcnt : <span class="hl-number">1</span>
selftest : passed
internal : no
type : skcipher
async : yes
blocksize : <span class="hl-number">16</span>
min keysize : <span class="hl-number">16</span>
max keysize : <span class="hl-number">32</span>
ivsize : <span class="hl-number">16</span>
chunksize : <span class="hl-number">16</span>
walksize : <span class="hl-number">16</span>
......</code></pre></div>
<p class="- topic/p p" data-ofbid="d94047e92__20250123155207">这里的 <span class="+ topic/ph sw-d/filepath ph filepath">/proc/crypto</span> 是目标平台上的文件</p>
<p class="- topic/p p" data-ofbid="d94047e99__20250123155207"><span class="+ topic/keyword pr-d/apiname keyword apiname">AF_ALG API</span> 的特点:</p>
<ul class="- topic/ul ul" id="ce_demo__ul_x45_vpy_21c" data-ofbid="ce_demo__ul_x45_vpy_21c">
<li class="- topic/li li" data-ofbid="d94047e106__20250123155207">
<p class="- topic/p p" data-ofbid="d94047e108__20250123155207">效率高</p>
</li>
<li class="- topic/li li" data-ofbid="d94047e112__20250123155207">
<p class="- topic/p p" data-ofbid="d94047e114__20250123155207">接口灵活</p>
</li>
<li class="- topic/li li" data-ofbid="d94047e118__20250123155207">
<p class="- topic/p p" data-ofbid="d94047e120__20250123155207">较为复杂</p>
</li>
</ul>
</section>
<section class="- topic/section section" id="ce_demo__section_y45_vpy_21c" data-ofbid="ce_demo__section_y45_vpy_21c"><h2 class="- topic/title title sectiontitle">Libkcapi API</h2>
<p class="- topic/p p" data-ofbid="d94047e131__20250123155207">SDK 已经提供对应的 <span class="+ topic/keyword pr-d/apiname keyword apiname">libkcapi</span> 库,默认配置已经支持</p>
<ul class="- topic/ul ul" id="ce_demo__ul_ap5_vpy_21c" data-ofbid="ce_demo__ul_ap5_vpy_21c">
<li class="- topic/li li" data-ofbid="d94047e139__20250123155207">
<p class="- topic/p p" data-ofbid="d94047e141__20250123155207">对称密钥算法</p>
</li>
<li class="- topic/li li" data-ofbid="d94047e145__20250123155207">
<p class="- topic/p p" data-ofbid="d94047e147__20250123155207">非对称密钥算法</p>
</li>
<li class="- topic/li li" data-ofbid="d94047e151__20250123155207">
<p class="- topic/p p" data-ofbid="d94047e153__20250123155207">消息摘要算法</p>
</li>
<li class="- topic/li li" data-ofbid="d94047e157__20250123155207">
<p class="- topic/p p" data-ofbid="d94047e159__20250123155207">随机数读取</p>
</li>
</ul>
<p class="- topic/p p" data-ofbid="d94047e164__20250123155207">如果需要修改对应包的编译配置,可在 Luban SDK 顶层目录执行 <span class="+ topic/keyword sw-d/cmdname keyword cmdname">make menuconfig</span><span class="+ topic/keyword sw-d/cmdname keyword cmdname">make
m</span></p>
<div class="- topic/p p" data-ofbid="d94047e173__20250123155207">配置界面的索引如下:<pre class="+ topic/pre pr-d/codeblock pre codeblock language-c" id="ce_demo__codeblock_t2f_pc3_p1c" data-ofbid="ce_demo__codeblock_t2f_pc3_p1c"><code>Third-party packages ---&gt;
-*- libkcapi ---&gt;
[*] use prebuilt binary instead of building from source
[*] enable asym algorithm support
[*] build enc application
[*] build hasher application
[*] build rng read application
[*] build speed-test program
[*] build test program
</code></pre></div>
<p class="- topic/p p" data-ofbid="d94047e179__20250123155207"><span class="+ topic/keyword pr-d/apiname keyword apiname">Libkcapi</span> 的特点:</p>
<ul class="- topic/ul ul" id="ce_demo__ul_ep5_vpy_21c" data-ofbid="ce_demo__ul_ep5_vpy_21c">
<li class="- topic/li li" data-ofbid="d94047e186__20250123155207">
<p class="- topic/p p" data-ofbid="d94047e188__20250123155207">接口简单</p>
</li>
<li class="- topic/li li" data-ofbid="d94047e192__20250123155207">
<p class="- topic/p p" data-ofbid="d94047e194__20250123155207">效率高</p>
</li>
</ul>
<p class="- topic/p p" data-ofbid="d94047e199__20250123155207">基于 <span class="+ topic/keyword pr-d/apiname keyword apiname">Libkcapi API</span> 的参考示例
<span class="+ topic/ph sw-d/filepath ph filepath">source/artinchip/test-ce/kcapi/</span></p>
</section>
<section class="- topic/section section" id="ce_demo__section_gp5_vpy_21c" data-ofbid="ce_demo__section_gp5_vpy_21c"><h2 class="- topic/title title sectiontitle">OpenSSL API</h2>
<p class="- topic/p p" data-ofbid="d94047e215__20250123155207">Luban SDK 通过 OpenSSL 的 Engine 机制,以实现 Engine 库的方式,已经完成了对 OpenSSL 的对接。 无论是通过 OpenSSL
的命令行,还是通过使用库编程,都可以使用到 CE。</p>
<p class="- topic/p p" data-ofbid="d94047e218__20250123155207">Engine 库有两个,根据不同的目的进行使用。</p>
<div class="table-container"><table class="- topic/table table frame-all" id="ce_demo__table_hp5_vpy_21c" data-ofbid="ce_demo__table_hp5_vpy_21c" data-cols="3"><caption></caption><colgroup><col style="width:16.666666666666664%"/><col style="width:25.666666666666664%"/><col style="width:57.666666666666664%"/></colgroup><thead class="- topic/thead thead">
<tr class="- topic/row">
<th class="- topic/entry entry colsep-1 rowsep-1" id="ce_demo__table_hp5_vpy_21c__entry__1">Engine</th>
<th class="- topic/entry entry colsep-1 rowsep-1" id="ce_demo__table_hp5_vpy_21c__entry__2">库和路径</th>
<th class="- topic/entry entry colsep-0 rowsep-1" id="ce_demo__table_hp5_vpy_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="ce_demo__table_hp5_vpy_21c__entry__1">aic engine</td>
<td class="- topic/entry entry colsep-1 rowsep-1" headers="ce_demo__table_hp5_vpy_21c__entry__2"><span class="+ topic/ph sw-d/filepath ph filepath">usr/lib/libengine_aic.so</span></td>
<td class="- topic/entry entry colsep-0 rowsep-1" headers="ce_demo__table_hp5_vpy_21c__entry__3">实现 CE 所提供的对称密钥算法、RSA 算法和消息摘要算法该 Engine 实现的都是标准算法。</td>
</tr>
<tr class="- topic/row">
<td class="- topic/entry entry colsep-1 rowsep-0" headers="ce_demo__table_hp5_vpy_21c__entry__1">huk engine</td>
<td class="- topic/entry entry colsep-1 rowsep-0" headers="ce_demo__table_hp5_vpy_21c__entry__2"><span class="+ topic/ph sw-d/filepath ph filepath">usr/lib/libengine_huk.so</span></td>
<td class="- topic/entry entry colsep-0 rowsep-0" headers="ce_demo__table_hp5_vpy_21c__entry__3">实现了 HUK 保护的 AES 算法,可用于本地数据保护。使用该 Engine 时,输入的密钥会被 HUK
进行一次解密,然后才用于 AES 加解密。HUK 每一颗芯片不同,因此使用该 Engine
加密后的数据,仅当前平台可解密。</td>
</tr>
</tbody></table></div>
<p class="- topic/p p" data-ofbid="d94047e277__20250123155207">命令行中使用指定 Engine 的示例:</p>
<pre class="+ topic/pre pr-d/codeblock pre codeblock language-c" id="ce_demo__codeblock_ip5_vpy_21c" data-ofbid="ce_demo__codeblock_ip5_vpy_21c"><code>openssl enc -engine aic -p -nosalt -nopad -aes-<span class="hl-number">128</span>-ecb -e -K <span class="hl-number">0123</span> -in data.bin -out enc.bin</code></pre>
<p class="- topic/p p" data-ofbid="d94047e284__20250123155207">上述示例中,通过 <span class="+ topic/keyword pr-d/parmname keyword parmname">-engine aic</span> 指定了使用 <span class="+ topic/keyword pr-d/parmname keyword parmname">aic</span> engine。</p>
<p class="- topic/p p" data-ofbid="d94047e293__20250123155207">当在 <span class="+ topic/ph sw-d/filepath ph filepath">openssl.cnf</span> 文件中配置了默认的 Engine 之后,命令行中可以忽略 <span class="+ topic/keyword pr-d/parmname keyword parmname">-engine</span>
参数。 具体配置可参考 <span class="+ topic/ph sw-d/filepath ph filepath">/etc/ssl/openssl_aic.cnf</span> 文件。</p>
<pre class="+ topic/pre pr-d/codeblock pre codeblock language-c" id="ce_demo__codeblock_jp5_vpy_21c" data-ofbid="ce_demo__codeblock_jp5_vpy_21c"><code>openssl_conf = openssl_def
[openssl_def]
engines = engine_section
[engine_section]
aic = aic_section
[aic_section]
engine_id = aic
dynamic_path = /usr/lib/libengine_aic.so
default_algorithms = CIPHERS,DIGESTS,RSA
</code></pre>
<p class="- topic/p p" data-ofbid="d94047e308__20250123155207">Libopenssl API 的特点:</p>
<ul class="- topic/ul ul" id="ce_demo__ul_lp5_vpy_21c" data-ofbid="ce_demo__ul_lp5_vpy_21c">
<li class="- topic/li li" data-ofbid="d94047e313__20250123155207">
<p class="- topic/p p" data-ofbid="d94047e315__20250123155207">功能强大</p>
</li>
<li class="- topic/li li" data-ofbid="d94047e319__20250123155207">
<p class="- topic/p p" data-ofbid="d94047e321__20250123155207">调用效率稍差</p>
</li>
</ul>
<p class="- topic/p p" data-ofbid="d94047e327__20250123155207">基于 Libopenssl API 的参考示例: <span class="+ topic/ph sw-d/filepath ph filepath">source/artinchip/test-ce/openssl/</span></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="#ce_demo__section_r45_vpy_21c" data-tocid="ce_demo__section_r45_vpy_21c">AF_ALG API</a></div></li><li class="section-item"><div class="section-title"><a href="#ce_demo__section_y45_vpy_21c" data-tocid="ce_demo__section_y45_vpy_21c">Libkcapi API</a></div></li><li class="section-item"><div class="section-title"><a href="#ce_demo__section_gp5_vpy_21c" data-tocid="ce_demo__section_gp5_vpy_21c">OpenSSL API</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>