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

340 lines
46 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/gpai/drv_gpai.c GPAI Driver 层实现 bsp/artinchip/hal/gpai/hal_gpai.c GPAI HAL 层实现 bsp/artinchip/include/hal/hal_gpai.h GPAI HAL 层接口头文件 模块架构 GPAI 驱动 Driver ..."/><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/gpai/gpai_user_guide_2.html"/><meta name="DC.relation" content="../../../topics/sdk/gpai/gpai_test_lite.html"/><meta name="DC.relation" content="../../../topics/sdk/gpai/gpai_faq_2.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="id"/><meta name="DC.language" content="zh-CN"/><title>设计说明</title><!-- Build number 2023110923. --><meta name="wh-path2root" content="../../../"/><meta name="wh-toc-id" content="id-d5856e5384"/><meta name="wh-source-relpath" content="topics/sdk/gpai/gpai_design_lite.dita"/><meta name="wh-out-relpath" content="topics/sdk/gpai/gpai_design_lite.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="id" 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 "><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="concept_nww_hzh_pzb"><div class="title"><a href="../../../topics/chapter-title/chapter-interface-sdk.html">接口</a><div class="wh-tooltip"><p class="shortdesc">CAN<span class="ph">、CAP</span>、CIR、GPAI、GPIO、I2C、PSADC、PWM 等接口模块的介绍和使用说明。</p></div></div></div></li><li><div class="topicref" data-id="gpai-user-guide"><div class="title"><a href="../../../topics/sdk/gpai/gpai_user_guide_2.html">GPAI 使用指南</a></div></div></li><li class="active"><div class="topicref" data-id="id"><div class="title"><a href="../../../topics/sdk/gpai/gpai_design_lite.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/gpai/gpai_test_lite.html" title="测试指南" aria-label="上一主题: 测试指南" rel="prev"></a></span>
<span class="navnext"><a class="- topic/link link" href="../../../topics/sdk/gpai/gpai_faq_2.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-d5856e989" 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_rtos.html" id="revinfo_linux-d5856e989-link">修订记录</a></div></div></li><li role="treeitem" aria-expanded="false"><div data-tocid="id-d5856e1003" class="topicref" data-id="id" data-state="not-ready"><span role="button" tabindex="0" aria-labelledby="button-expand-action id-d5856e1003-link" class="wh-expand-btn"></span><div class="title"><a href="../../../topics/sdk/env/sdk-compile.html" id="id-d5856e1003-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="id-d5856e1152" class="topicref" data-id="id" data-state="not-ready"><span role="button" tabindex="0" aria-labelledby="button-expand-action id-d5856e1152-link" class="wh-expand-btn"></span><div class="title"><a href="../../../topics/sdk/advanced/sdk-usage.html" id="id-d5856e1152-link">使用指南</a><div class="wh-tooltip"><p class="shortdesc">系统镜像、编译选项、开发板、应用等相关的详细使用说明。</p></div></div></div></li><li role="treeitem" aria-expanded="false"><div data-tocid="concept_rcx_czh_pzb-d5856e1416" 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-d5856e1416-link" class="wh-expand-btn"></span><div class="title"><a href="../../../topics/sdk/chapter-app.html" id="concept_rcx_czh_pzb-d5856e1416-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-d5856e2119" class="topicref" data-id="id" data-state="not-ready"><span role="button" tabindex="0" aria-labelledby="button-expand-action id-d5856e2119-link" class="wh-expand-btn"></span><div class="title"><a href="../../../topics/sdk/peripheral/peripheral-intro.html" id="id-d5856e2119-link">外设移植</a><div class="wh-tooltip"><p class="shortdesc"><span class="ph">CTP、U 盘、SD 卡、有线和无线网络</span>等外设的介绍和使用说明。</p></div></div></div></li><li role="treeitem" aria-expanded="false"><div data-tocid="id-d5856e2244" class="topicref" data-id="id" data-state="not-ready"><span role="button" tabindex="0" aria-labelledby="button-expand-action id-d5856e2244-link" class="wh-expand-btn"></span><div class="title"><a href="../../../topics/sdk/bringup/chapter-bringup.html" id="id-d5856e2244-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-d5856e2345" class="topicref" data-id="id" data-state="expanded"><span role="button" tabindex="0" aria-labelledby="button-collapse-action id-d5856e2345-link" class="wh-expand-btn"></span><div class="title"><a href="../../../topics/sdk/chapter-advanced-app.html" id="id-d5856e2345-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="_0-d5856e2360" class="topicref" data-id="_0" data-state="not-ready"><span role="button" tabindex="0" aria-labelledby="button-expand-action _0-d5856e2360-link" class="wh-expand-btn"></span><div class="title"><a href="../../../topics/sdk/boot/lite_boot_direct.html" id="_0-d5856e2360-link">启动引导</a><div class="wh-tooltip"><p class="shortdesc">启动引导程序 Bootloader 可以实现加载启动应用程序、 烧录和升级功能。</p></div></div></div></li><li role="treeitem" aria-expanded="false"><div data-tocid="chapter-system-d5856e2435" class="topicref" data-id="chapter-system" data-state="not-ready"><span role="button" tabindex="0" aria-labelledby="button-expand-action chapter-system-d5856e2435-link" class="wh-expand-btn"></span><div class="title"><a href="../../../topics/chapter-title/chapter-system.html" id="chapter-system-d5856e2435-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-d5856e3357" class="topicref" data-id="chapter-memory" data-state="not-ready"><span role="button" tabindex="0" aria-labelledby="button-expand-action chapter-memory-d5856e3357-link" class="wh-expand-btn"></span><div class="title"><a href="../../../topics/chapter-title/chapter-memory-sdk.html" id="chapter-memory-d5856e3357-link">存储</a><div class="wh-tooltip"><p class="shortdesc">SDMC、SPI NAND、SPI NOR<span class="ph"> 以及文件系统</span> 等存储模块的介绍和使用说明。</p></div></div></div></li><li role="treeitem" aria-expanded="false"><div data-tocid="concept_mcc_32s_nbc-d5856e3639" 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-d5856e3639-link" class="wh-expand-btn"></span><div class="title"><a href="../../../topics/chapter-title/chapter-multi-media-sdk.html" id="concept_mcc_32s_nbc-d5856e3639-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="true"><div data-tocid="concept_nww_hzh_pzb-d5856e4868" class="topicref" data-id="concept_nww_hzh_pzb" data-state="expanded"><span role="button" tabindex="0" aria-labelledby="button-collapse-action concept_nww_hzh_pzb-d5856e4868-link" class="wh-expand-btn"></span><div class="title"><a href="../../../topics/chapter-title/chapter-interface-sdk.html" id="concept_nww_hzh_pzb-d5856e4868-link">接口</a><div class="wh-tooltip"><p class="shortdesc">CAN<span class="ph">、CAP</span>、CIR、GPAI、GPIO、I2C、PSADC、PWM 等接口模块的介绍和使用说明。</p></div></div></div><ul role="group" class="navbar-nav nav-list"><li role="treeitem" aria-expanded="false"><div data-tocid="can-d5856e4886" class="topicref" data-id="can" data-state="not-ready"><span role="button" tabindex="0" aria-labelledby="button-expand-action can-d5856e4886-link" class="wh-expand-btn"></span><div class="title"><a href="../../../topics/sdk/can/can_user_guide_2.html" id="can-d5856e4886-link">CAN 使用指南</a></div></div></li><li role="treeitem" aria-expanded="false"><div data-tocid="id-d5856e4958" class="topicref" data-id="id" data-state="not-ready"><span role="button" tabindex="0" aria-labelledby="button-expand-action id-d5856e4958-link" class="wh-expand-btn"></span><div class="title"><a href="../../../topics/sdk/cap/cap_user_guide.html" id="id-d5856e4958-link">CAP 使用指南</a></div></div></li><li role="treeitem" aria-expanded="false"><div data-tocid="id-d5856e5018" class="topicref" data-id="id" data-state="not-ready"><span role="button" tabindex="0" aria-labelledby="button-expand-action id-d5856e5018-link" class="wh-expand-btn"></span><div class="title"><a href="../../../topics/sdk/qep/qep_user_guide.html" id="id-d5856e5018-link">QEP 使用指南</a></div></div></li><li role="treeitem" aria-expanded="false"><div data-tocid="cir-d5856e5228" class="topicref" data-id="cir" data-state="not-ready"><span role="button" tabindex="0" aria-labelledby="button-expand-action cir-d5856e5228-link" class="wh-expand-btn"></span><div class="title"><a href="../../../topics/sdk/cir/cir_user_guide_2.html" id="cir-d5856e5228-link">CIR 使用指南</a></div></div></li><li role="treeitem" aria-expanded="true"><div data-tocid="gpai-user-guide-d5856e5336" class="topicref" data-id="gpai-user-guide" data-state="expanded"><span role="button" tabindex="0" aria-labelledby="button-collapse-action gpai-user-guide-d5856e5336-link" class="wh-expand-btn"></span><div class="title"><a href="../../../topics/sdk/gpai/gpai_user_guide_2.html" id="gpai-user-guide-d5856e5336-link">GPAI 使用指南</a></div></div><ul role="group" class="navbar-nav nav-list"><li role="treeitem"><div data-tocid="id-d5856e5348" class="topicref" data-id="id" data-state="leaf"><span role="button" class="wh-expand-btn"></span><div class="title"><a href="../../../topics/sdk/gpai/gpai_config_lite.html" id="id-d5856e5348-link">参数配置</a></div></div></li><li role="treeitem"><div data-tocid="id-d5856e5360" class="topicref" data-id="id" data-state="leaf"><span role="button" class="wh-expand-btn"></span><div class="title"><a href="../../../topics/sdk/gpai/gpai_debug_lite.html" id="id-d5856e5360-link">调试指南</a></div></div></li><li role="treeitem"><div data-tocid="id-d5856e5372" class="topicref" data-id="id" data-state="leaf"><span role="button" class="wh-expand-btn"></span><div class="title"><a href="../../../topics/sdk/gpai/gpai_test_lite.html" id="id-d5856e5372-link">测试指南</a></div></div></li><li role="treeitem" class="active"><div data-tocid="id-d5856e5384" class="topicref" data-id="id" data-state="leaf"><span role="button" class="wh-expand-btn"></span><div class="title"><a href="../../../topics/sdk/gpai/gpai_design_lite.html" id="id-d5856e5384-link">设计说明</a></div></div></li><li role="treeitem"><div data-tocid="id-d5856e5396" class="topicref" data-id="id" data-state="leaf"><span role="button" class="wh-expand-btn"></span><div class="title"><a href="../../../topics/sdk/gpai/gpai_faq_2.html" id="id-d5856e5396-link">常见问题</a></div></div></li></ul></li><li role="treeitem" aria-expanded="false"><div data-tocid="id-d5856e5408" class="topicref" data-id="id" data-state="not-ready"><span role="button" tabindex="0" aria-labelledby="button-expand-action id-d5856e5408-link" class="wh-expand-btn"></span><div class="title"><a href="../../../topics/sdk/gpio/gpio_user_guide.html" id="id-d5856e5408-link">GPIO 使用指南</a></div></div></li><li role="treeitem" aria-expanded="false"><div data-tocid="i2c_user_guide-d5856e5480" class="topicref" data-id="i2c_user_guide" data-state="not-ready"><span role="button" tabindex="0" aria-labelledby="button-expand-action i2c_user_guide-d5856e5480-link" class="wh-expand-btn"></span><div class="title"><a href="../../../topics/sdk/i2c/i2c_user_guide_2.html" id="i2c_user_guide-d5856e5480-link">I2C 使用指南</a></div></div></li><li role="treeitem" aria-expanded="false"><div data-tocid="id-d5856e5576" class="topicref" data-id="id" data-state="not-ready"><span role="button" tabindex="0" aria-labelledby="button-expand-action id-d5856e5576-link" class="wh-expand-btn"></span><div class="title"><a href="../../../topics/sdk/psadc/psadc_user_guide_2.html" id="id-d5856e5576-link">PSADC 使用指南</a></div></div></li><li role="treeitem" aria-expanded="false"><div data-tocid="id-d5856e5648" class="topicref" data-id="id" data-state="not-ready"><span role="button" tabindex="0" aria-labelledby="button-expand-action id-d5856e5648-link" class="wh-expand-btn"></span><div class="title"><a href="../../../topics/sdk/pwm/pwm_user_guide_2.html" id="id-d5856e5648-link">PWM 使用指南</a></div></div></li><li role="treeitem" aria-expanded="false"><div data-tocid="rtp-user-guide-d5856e5721" class="topicref" data-id="rtp-user-guide" data-state="not-ready"><span role="button" tabindex="0" aria-labelledby="button-expand-action rtp-user-guide-d5856e5721-link" class="wh-expand-btn"></span><div class="title"><a href="../../../topics/sdk/rtp/rtp_user_guide_2.html" id="rtp-user-guide-d5856e5721-link">RTP 使用指南</a></div></div></li><li role="treeitem" aria-expanded="false"><div data-tocid="spi-d5856e5805" class="topicref" data-id="spi" data-state="not-ready"><span role="button" tabindex="0" aria-labelledby="button-expand-action spi-d5856e5805-link" class="wh-expand-btn"></span><div class="title"><a href="../../../topics/sdk/spi/spi_user_guide_2.html" id="spi-d5856e5805-link"><span class="ph">Q</span>SPI 使用指南</a></div></div></li><li role="treeitem" aria-expanded="false"><div data-tocid="uart_user_guide-d5856e5879" class="topicref" data-id="uart_user_guide" data-state="not-ready"><span role="button" tabindex="0" aria-labelledby="button-expand-action uart_user_guide-d5856e5879-link" class="wh-expand-btn"></span><div class="title"><a href="../../../topics/sdk/uart/uart_user_guide_2.html" id="uart_user_guide-d5856e5879-link">UART 使用指南</a></div></div></li><li role="treeitem" aria-expanded="false"><div data-tocid="usb_user_guide-d5856e5951" class="topicref" data-id="usb_user_guide" data-state="not-ready"><span role="button" tabindex="0" aria-labelledby="button-expand-action usb_user_guide-d5856e5951-link" class="wh-expand-btn"></span><div class="title"><a href="../../../topics/sdk/usb/usb_user_guide_2.html" id="usb_user_guide-d5856e5951-link">USB 使用指南</a></div></div></li><li role="treeitem" aria-expanded="false"><div data-tocid="id-d5856e6011" class="topicref" data-id="id" data-state="not-ready"><span role="button" tabindex="0" aria-labelledby="button-expand-action id-d5856e6011-link" class="wh-expand-btn"></span><div class="title"><a href="../../../topics/sdk/mac/mac_user_guide_2.html" id="id-d5856e6011-link">MAC 使用指南</a></div></div></li></ul></li><li role="treeitem" aria-expanded="false"><div data-tocid="chapter-safety-d5856e6083" class="topicref" data-id="chapter-safety" data-state="not-ready"><span role="button" tabindex="0" aria-labelledby="button-expand-action chapter-safety-d5856e6083-link" class="wh-expand-btn"></span><div class="title"><a href="../../../topics/chapter-title/chapter-safety-sdk.html" id="chapter-safety-d5856e6083-link">安全</a><div class="wh-tooltip"><p class="shortdesc">SPI ENC、CE、eFuse 等安全模块的介绍和使用说明。</p></div></div></div></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 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" href="http://172.16.35.88/tasks/jdssno1uvvbf2mltu9kb9v3if05d5gopuakboe8hlud18rma/edit/F:/aicdita/aicdita-cn/topics/sdk/gpai/gpai_design_lite.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 body"><section class="- topic/section section" id="id__section_gnw_gpf_fdc" data-ofbid="id__section_gnw_gpf_fdc"><h2 class="- topic/title title sectiontitle">源码说明</h2>
<p class="- topic/p p" data-ofbid="d157429e24__20250121171615">源代码位于 <span class="+ topic/ph sw-d/filepath ph filepath">bsp/artinchip/</span></p>
<ul class="- topic/ul ul simple" id="id__ul_wd2_db3_fdc" data-ofbid="id__ul_wd2_db3_fdc"><li class="- topic/li li" data-ofbid="d157429e31__20250121171615">
<p class="- topic/p p" data-ofbid="d157429e33__20250121171615"><span class="+ topic/ph sw-d/filepath ph filepath">bsp/artinchip/drv/gpai/drv_gpai.c</span>GPAI Driver 层实现</p>
</li><li class="- topic/li li" data-ofbid="d157429e38__20250121171615">
<p class="- topic/p p" data-ofbid="d157429e40__20250121171615"><span class="+ topic/ph sw-d/filepath ph filepath">bsp/artinchip/hal/gpai/hal_gpai.c</span>GPAI HAL 层实现</p>
</li><li class="- topic/li li" data-ofbid="d157429e45__20250121171615">
<p class="- topic/p p" data-ofbid="d157429e47__20250121171615"><span class="+ topic/ph sw-d/filepath ph filepath">bsp/artinchip/include/hal/hal_gpai.h</span>GPAI HAL 层接口头文件</p>
</li></ul>
</section><section class="- topic/section section" id="id__section_qnb_2b3_fdc" data-ofbid="id__section_qnb_2b3_fdc"><h2 class="- topic/title title sectiontitle">模块架构</h2>
<div class="- topic/p p" data-ofbid="d157429e58__20250121171615">GPAI 驱动 Driver 层采用 RT-Thread 的 ADC 设备驱动框架,如果只使用 HAL 层也可以支持 Baremetal 方式的应用场景。<figure class="- topic/fig fig fignone" id="id__fig_xd2_db3_fdc" data-ofbid="id__fig_xd2_db3_fdc"><br/><div class="imagecenter"><img class="- topic/image image imagecenter" id="id__image_yd2_db3_fdc" src="../../../images/gpai/gpai_sw_system.png" width="288" alt="sw_system20"/></div><br/></figure></div>
</section><section class="- topic/section section" id="id__section_fwx_2b3_fdc" data-ofbid="id__section_fwx_2b3_fdc"><h2 class="- topic/title title sectiontitle">关键流程设计</h2>
<div class="- topic/div div section" id="id__id5">
<strong class="+ topic/ph hi-d/b ph b">初始化流程</strong>
<p class="- topic/p p" data-ofbid="d157429e75__20250121171615">GPAI 驱动的初始化接口通过 <span class="+ topic/keyword pr-d/apiname keyword apiname">INIT_DEVICE_EXPORT(drv_gpai_init)</span> 完成,会通过调用 ADC
子系统的接口 rt_hw_adc_register() 注册一个 ADC 设备。</p><p class="- topic/p p" data-ofbid="d157429e80__20250121171615">GPAI 控制器的初始化过程,主要步骤有: </p><ol class="- topic/ol ol arabic simple" id="id__ol_zd2_db3_fdc" data-ofbid="id__ol_zd2_db3_fdc"><li class="- topic/li li" data-ofbid="d157429e83__20250121171615">
<p class="- topic/p p" data-ofbid="d157429e85__20250121171615">初始化模块的 clk</p>
</li><li class="- topic/li li" data-ofbid="d157429e88__20250121171615">
<p class="- topic/p p" data-ofbid="d157429e90__20250121171615">注册中断</p>
</li><li class="- topic/li li" data-ofbid="d157429e93__20250121171615">
<p class="- topic/p p" data-ofbid="d157429e95__20250121171615">初始化默认参数</p>
</li><li class="- topic/li li" data-ofbid="d157429e98__20250121171615">
<p class="- topic/p p" data-ofbid="d157429e100__20250121171615">向设备框架中注册 ADC 设备</p>
</li></ol></div>
<div class="- topic/div div section" id="id__id6">
<strong class="+ topic/ph hi-d/b ph b">中断处理流程</strong>
<p class="- topic/p p" data-ofbid="d157429e109__20250121171615">GPAI 支持使用中断方式来读取数据,这样避免应用层的忙等待。</p><figure class="- topic/fig fig fignone" id="id__id8" data-ofbid="id__id8"><br/><div class="imagecenter"><img class="- topic/image image imagecenter" id="id__image_a22_db3_fdc" src="../../../images/gpai/gpai_irq_flow.png" width="288" alt="gpai_irq_flow.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">GPAI 非周期模式的数据采集流程</span></figcaption></figure><ul class="- topic/ul ul simple" id="id__ul_b22_db3_fdc" data-ofbid="id__ul_b22_db3_fdc"><li class="- topic/li li" data-ofbid="d157429e118__20250121171615">
<p class="- topic/p p" data-ofbid="d157429e120__20250121171615">对于非周期模式:当用户层触发 convert()接口,就会启动一次硬件去读数据</p>
</li><li class="- topic/li li" data-ofbid="d157429e123__20250121171615">
<p class="- topic/p p" data-ofbid="d157429e125__20250121171615">当硬件准备好数据,会产生一个中断</p>
</li><li class="- topic/li li" data-ofbid="d157429e128__20250121171615">
<p class="- topic/p p" data-ofbid="d157429e130__20250121171615">在中断处理函数中,用 INT Flag 来区分是哪个通道有数据,逐个通道扫描将数据读出,会缓存到一个全局变量中</p>
</li><li class="- topic/li li" data-ofbid="d157429e133__20250121171615">
<p class="- topic/p p" data-ofbid="d157429e135__20250121171615">对于周期模式GPAI 控制器会自动按给定周期产生一次数据中断</p>
</li></ul>
</div>
</section><section class="- topic/section section" id="id__section_yzq_fb3_fdc" data-ofbid="id__section_yzq_fb3_fdc"><h2 class="- topic/title title sectiontitle">数据结构设计</h2>
<ul class="- topic/ul ul" id="id__ul_gtn_wpn_4dc" data-ofbid="id__ul_gtn_wpn_4dc"><li class="- topic/li li" data-ofbid="d157429e146__20250121171615">
<div class="- topic/div div section" id="id__struct-aic-gpai-dev">
<strong class="+ topic/ph hi-d/b ph b">struct aic_gpai_dev</strong>
<div class="- topic/p p" data-ofbid="d157429e153__20250121171615">属于 Driver 层内部使用的数据结构,管理 GPAI
控制器的设备资源:<pre class="+ topic/pre pr-d/codeblock pre codeblock language-c" id="id__codeblock_urz_lb3_fdc" data-ofbid="id__codeblock_urz_lb3_fdc"><strong class="hl-keyword">struct</strong> aic_gpai_dev {
<strong class="hl-keyword">struct</strong> rt_adc_device *dev;
<strong class="hl-keyword">struct</strong> aic_gpai_ch *chan;
};</pre></div>
</div>
</li><li class="- topic/li li" data-ofbid="d157429e159__20250121171615">
<div class="- topic/div div section" id="id__struct-aic-gpai-ch">
<strong class="+ topic/ph hi-d/b ph b">struct aic_gpai_ch</strong>
<div class="- topic/p p" data-ofbid="d157429e166__20250121171615">属于 HAL 层接口,记录单个 ADC
通道的配置信息:<pre class="+ topic/pre pr-d/codeblock pre codeblock language-c" id="id__codeblock_aky_lb3_fdc" data-ofbid="id__codeblock_aky_lb3_fdc"><strong class="hl-keyword">struct</strong> aic_gpai_ch {
u8 id;
u8 available;
<strong class="hl-keyword">enum</strong> aic_gpai_mode mode;
u32 smp_period;
u16 latest_data;
u8 fifo_depth;
u8 fifo_thd;
u8 hla_enable; <em class="hl-comment">// high-level alarm</em>
u8 lla_enable; <em class="hl-comment">// low-level alarm</em>
u16 hla_thd;
u16 hla_rm_thd;
u16 lla_thd;
u16 lla_rm_thd;
aicos_sem_t complete;
};</pre></div></div>
</li></ul>
</section><section class="- topic/section section" id="id__section_edf_gb3_fdc" data-ofbid="id__section_edf_gb3_fdc"><h2 class="- topic/title title sectiontitle">Driver 层接口设计</h2>
<div class="- topic/p p" data-ofbid="d157429e177__20250121171615">以下接口是 GPAI 设备驱动框架的标准接口。<pre class="+ topic/pre pr-d/codeblock pre codeblock language-c" id="id__codeblock_rp4_lb3_fdc" data-ofbid="id__codeblock_rp4_lb3_fdc"><strong class="hl-keyword">struct</strong> rt_adc_ops
{
rt_err_t (*enabled)(<strong class="hl-keyword">struct</strong> rt_adc_device *device, rt_uint32_t channel, rt_bool_t enabled);
rt_err_t (*convert)(<strong class="hl-keyword">struct</strong> rt_adc_device *device, rt_uint32_t channel, rt_uint32_t *value);
rt_uint8_t (*get_resolution)(<strong class="hl-keyword">struct</strong> rt_adc_device *device);
rt_int16_t (*get_vref) (<strong class="hl-keyword">struct</strong> rt_adc_device *device);
};</pre></div>
<div class="- topic/p p" data-ofbid="d157429e182__20250121171615">其中的 get_vref() 暂未支持。 <div class="table-container"><table class="- topic/table table frame-all" id="id__table_c22_db3_fdc" data-ofbid="id__table_c22_db3_fdc" 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_gpai_enabled</span></caption><colgroup><col style="width:16.666666666666664%"/><col style="width:83.33333333333334%"/></colgroup><thead class="- topic/thead thead"><tr class="- topic/row"><th class="- topic/entry entry colsep-1 rowsep-1" id="id__table_c22_db3_fdc__entry__1">函数原型</th><th class="- topic/entry entry colsep-0 rowsep-1" id="id__table_c22_db3_fdc__entry__2">
<div class="- topic/div div">
<div class="- topic/div div">rt_err_t drv_gpai_enabled(struct rt_adc_device *dev,
rt_uint32_t ch, rt_bool_t enabled)</div>
</div>
</th></tr></thead><tbody class="- topic/tbody tbody"><tr class="- topic/row"><td class="- topic/entry entry colsep-1 rowsep-1" headers="id__table_c22_db3_fdc__entry__1">功能说明</td><td class="- topic/entry entry colsep-0 rowsep-1" headers="id__table_c22_db3_fdc__entry__2">使能一个 ADC 通道</td></tr><tr class="- topic/row"><td class="- topic/entry entry colsep-1 rowsep-1" headers="id__table_c22_db3_fdc__entry__1">参数定义</td><td class="- topic/entry entry colsep-0 rowsep-1" headers="id__table_c22_db3_fdc__entry__2">
<div class="- topic/div div">
<div class="- topic/div div">dev - 指向 ADC 设备</div>
<div class="- topic/div div">ch - 指定 ADC 通道的通道编号</div>
<div class="- topic/div div">enable - 使能</div>
</div>
</td></tr><tr class="- topic/row"><td class="- topic/entry entry colsep-1 rowsep-1" headers="id__table_c22_db3_fdc__entry__1">返回值</td><td class="- topic/entry entry colsep-0 rowsep-1" headers="id__table_c22_db3_fdc__entry__2">0成功 &lt; 0失败</td></tr><tr class="- topic/row"><td class="- topic/entry entry colsep-1 rowsep-0" headers="id__table_c22_db3_fdc__entry__1">注意事项</td><td class="- topic/entry entry colsep-0 rowsep-0" headers="id__table_c22_db3_fdc__entry__2">- </td></tr></tbody></table></div><div class="table-container"><table class="- topic/table table frame-all" id="id__table_d22_db3_fdc" data-ofbid="id__table_d22_db3_fdc" 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_gpai_convert</span></caption><colgroup><col style="width:16.666666666666664%"/><col style="width:83.33333333333334%"/></colgroup><thead class="- topic/thead thead"><tr class="- topic/row"><th class="- topic/entry entry colsep-1 rowsep-1" id="id__table_d22_db3_fdc__entry__1">函数原型</th><th class="- topic/entry entry colsep-0 rowsep-1" id="id__table_d22_db3_fdc__entry__2">
<div class="- topic/div div">
<div class="- topic/div div">rt_err_t drv_gpai_convert(struct rt_adc_device *dev,
rt_uint32_t ch, rt_uint32_t *value)</div>
</div>
</th></tr></thead><tbody class="- topic/tbody tbody"><tr class="- topic/row"><td class="- topic/entry entry colsep-1 rowsep-1" headers="id__table_d22_db3_fdc__entry__1">功能说明</td><td class="- topic/entry entry colsep-0 rowsep-1" headers="id__table_d22_db3_fdc__entry__2">读取一个 ADC 通道的当前数据</td></tr><tr class="- topic/row"><td class="- topic/entry entry colsep-1 rowsep-1" headers="id__table_d22_db3_fdc__entry__1">参数定义</td><td class="- topic/entry entry colsep-0 rowsep-1" headers="id__table_d22_db3_fdc__entry__2">
<div class="- topic/div div">
<div class="- topic/div div">dev - 指向 ADC 设备</div>
<div class="- topic/div div">ch - 指定 ADC 通道的通道编号</div>
<div class="- topic/div div">value - 用于保存返回的 ADC 数据</div>
</div>
</td></tr><tr class="- topic/row"><td class="- topic/entry entry colsep-1 rowsep-1" headers="id__table_d22_db3_fdc__entry__1">返回值</td><td class="- topic/entry entry colsep-0 rowsep-1" headers="id__table_d22_db3_fdc__entry__2">0成功 &lt; 0失败</td></tr><tr class="- topic/row"><td class="- topic/entry entry colsep-1 rowsep-0" headers="id__table_d22_db3_fdc__entry__1">注意事项</td><td class="- topic/entry entry colsep-0 rowsep-0" headers="id__table_d22_db3_fdc__entry__2">- </td></tr></tbody></table></div><div class="table-container"><table class="- topic/table table frame-all" id="id__table_e22_db3_fdc" data-ofbid="id__table_e22_db3_fdc" 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"> 3</span><span class="table--title-label-punctuation">. </span></span><span class="table--title">drv_gpai_resolution</span></caption><colgroup><col style="width:16.666666666666664%"/><col style="width:83.33333333333334%"/></colgroup><thead class="- topic/thead thead"><tr class="- topic/row"><th class="- topic/entry entry colsep-1 rowsep-1" id="id__table_e22_db3_fdc__entry__1">函数原型</th><th class="- topic/entry entry colsep-0 rowsep-1" id="id__table_e22_db3_fdc__entry__2">
<div class="- topic/div div">
<div class="- topic/div div">rt_err_t drv_gpai_resolution(struct rt_adc_device
*dev)</div>
</div>
</th></tr></thead><tbody class="- topic/tbody tbody"><tr class="- topic/row"><td class="- topic/entry entry colsep-1 rowsep-1" headers="id__table_e22_db3_fdc__entry__1">功能说明</td><td class="- topic/entry entry colsep-0 rowsep-1" headers="id__table_e22_db3_fdc__entry__2">获取 GPAI 控制器的采样精度</td></tr><tr class="- topic/row"><td class="- topic/entry entry colsep-1 rowsep-1" headers="id__table_e22_db3_fdc__entry__1">参数定义</td><td class="- topic/entry entry colsep-0 rowsep-1" headers="id__table_e22_db3_fdc__entry__2">
<div class="- topic/div div">
<div class="- topic/div div">dev - 指向 ADC 设备</div>
</div>
</td></tr><tr class="- topic/row"><td class="- topic/entry entry colsep-1 rowsep-1" headers="id__table_e22_db3_fdc__entry__1">返回值</td><td class="- topic/entry entry colsep-0 rowsep-1" headers="id__table_e22_db3_fdc__entry__2">12表示 12bit 的采样精度</td></tr><tr class="- topic/row"><td class="- topic/entry entry colsep-1 rowsep-0" headers="id__table_e22_db3_fdc__entry__1">注意事项</td><td class="- topic/entry entry colsep-0 rowsep-0" headers="id__table_e22_db3_fdc__entry__2">-</td></tr></tbody></table></div></div>
</section><section class="- topic/section section" id="id__section_gfl_jb3_fdc" data-ofbid="id__section_gfl_jb3_fdc"><h2 class="- topic/title title sectiontitle">HAL 层接口设计</h2>
<div class="- topic/p p" data-ofbid="d157429e337__20250121171615">HAL 层的函数接口声明存放在 hal_gpai.h
中,主要接口有:<pre class="+ topic/pre pr-d/codeblock pre codeblock language-c" id="id__codeblock_f22_db3_fdc" data-ofbid="id__codeblock_f22_db3_fdc"><strong class="hl-keyword">void</strong> aich_gpai_enable(<strong class="hl-keyword">int</strong> enable);
<strong class="hl-keyword">void</strong> aich_gpai_ch_enable(u32 ch, <strong class="hl-keyword">int</strong> enable);
<strong class="hl-keyword">int</strong> aich_gpai_ch_init(<strong class="hl-keyword">struct</strong> aic_gpai_ch *chan, u32 pclk);
irqreturn_t aich_gpai_isr(<strong class="hl-keyword">int</strong> irq, <strong class="hl-keyword">void</strong> *arg);
<strong class="hl-keyword">int</strong> aich_gpai_read(<strong class="hl-keyword">struct</strong> aic_gpai_ch *chan, u32 *val, u32 timeout);
s32 aich_gpai_data2vol(u16 data);
<strong class="hl-keyword">struct</strong> aic_gpai_ch *hal_gpai_ch_is_valid(u32 ch);
<strong class="hl-keyword">void</strong> hal_gpai_set_ch_num(u32 num);
<strong class="hl-keyword">void</strong> aich_gpai_status_show(<strong class="hl-keyword">struct</strong> aic_gpai_ch *chan);</pre></div>
</section><section class="- topic/section section" id="id__section_wrb_jb3_fdc" data-ofbid="id__section_wrb_jb3_fdc"><h2 class="- topic/title title sectiontitle">Demo</h2>
<div class="- topic/p p" data-ofbid="d157429e347__20250121171615">此 Demo 是 <span class="+ topic/keyword sw-d/cmdname keyword cmdname">gpai</span> 命令的部分代码(详见 <span class="+ topic/ph sw-d/filepath ph filepath">drv_gpai.c</span>),可以作为 GPAI
设备的使用参考:<pre class="+ topic/pre pr-d/codeblock pre codeblock language-c" id="id__codeblock_e42_pb3_fdc" data-ofbid="id__codeblock_e42_pb3_fdc">u32 ch = <span class="hl-number">0</span>;
<strong class="hl-keyword">struct</strong> rt_adc_device *dev = NULL;
dev = (<strong class="hl-keyword">struct</strong> rt_adc_device *)rt_device_find(<span class="hl-string">"gpai"</span>);
<strong class="hl-keyword">if</strong> (!dev) {
LOG_E(<span class="hl-string">"Failed to open %s device\n"</span>, <span class="hl-string">"gpai"</span>);
<strong class="hl-keyword">return</strong>;
}
ret = rt_adc_enable(dev, ch);
<strong class="hl-keyword">if</strong> (!ret) {
val = rt_adc_read(dev, ch);
printf(<span class="hl-string">"GPAI ch%d: %d\n"</span>, ch, val);
}
rt_adc_disable(dev, ch);</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="#id__section_gnw_gpf_fdc" data-tocid="id__section_gnw_gpf_fdc">源码说明</a></div></li><li class="section-item"><div class="section-title"><a href="#id__section_qnb_2b3_fdc" data-tocid="id__section_qnb_2b3_fdc">模块架构</a></div></li><li class="section-item"><div class="section-title"><a href="#id__section_fwx_2b3_fdc" data-tocid="id__section_fwx_2b3_fdc">关键流程设计</a></div></li><li class="section-item"><div class="section-title"><a href="#id__section_yzq_fb3_fdc" data-tocid="id__section_yzq_fb3_fdc">数据结构设计</a></div></li><li class="section-item"><div class="section-title"><a href="#id__section_edf_gb3_fdc" data-tocid="id__section_edf_gb3_fdc">Driver 层接口设计</a></div></li><li class="section-item"><div class="section-title"><a href="#id__section_gfl_jb3_fdc" data-tocid="id__section_gfl_jb3_fdc">HAL 层接口设计</a></div></li><li class="section-item"><div class="section-title"><a href="#id__section_wrb_jb3_fdc" data-tocid="id__section_wrb_jb3_fdc">Demo</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>