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

356 lines
70 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="Driver 层接口设计 Driver 层可以同时实现 playback 和 record 两个功能,主要根据的是音频数据流的方向进行判别。 表 1 . drv_i2s_sound_init 函数原型 rt_err_t drv_i2s_sound_init(struct rt_audio_device *audio) 功能说明 i2s 的初始化函数 参数定义 audio指向音频设备的指针 返回值 ..."/><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/i2s/i2s_design_lite.html"/><meta name="DC.relation" content="../../../topics/sdk/i2s/i2s_data_struct_lite.html"/><meta name="DC.relation" content="../../../topics/sdk/i2s/i2s_faq_2.html"/><meta name="DC.contributor" content="yan.wang"/><meta name="DC.contributor" content="yan.wang"/><meta name="DC.creator" content="yan.wang"/><meta name="DC.date.modified" content="2024-01-15"/><meta name="DC.format" content="HTML5"/><meta name="DC.identifier" content="i2s-interface-design"/><title>接口设计</title><!-- Build number 2023110923. --><meta name="wh-path2root" content="../../../"/><meta name="wh-toc-id" content="i2s-interface-design-d5856e4279"/><meta name="wh-source-relpath" content="topics/sdk/i2s/i2s_interface_lite.dita"/><meta name="wh-out-relpath" content="topics/sdk/i2s/i2s_interface_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="i2s-interface-design" 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_mcc_32s_nbc"><div class="title"><a href="../../../topics/chapter-title/chapter-multi-media-sdk.html">多媒体</a><div class="wh-tooltip"><p class="shortdesc">GE、VE、Display、DVP、MPP、MPP 播放器等多媒体模块的介绍和使用说明。</p></div></div></div></li><li><div class="topicref" data-id="i2s"><div class="title"><a href="../../../topics/sdk/i2s/i2s_user_guide_2.html">I2S 使用指南</a></div></div></li><li><div class="topicref" data-id="id"><div class="title"><a href="../../../topics/sdk/i2s/i2s_design_lite.html">设计说明</a></div></div></li><li class="active"><div class="topicref" data-id="i2s-interface-design"><div class="title"><a href="../../../topics/sdk/i2s/i2s_interface_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/i2s/i2s_data_struct_lite.html" title="数据结构设计" aria-label="上一主题: 数据结构设计" rel="prev"></a></span>
<span class="navnext"><a class="- topic/link link" href="../../../topics/sdk/i2s/i2s_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="true"><div data-tocid="concept_mcc_32s_nbc-d5856e3639" class="topicref" data-id="concept_mcc_32s_nbc" data-state="expanded"><span role="button" tabindex="0" aria-labelledby="button-collapse-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><ul role="group" class="navbar-nav nav-list"><li role="treeitem" aria-expanded="false"><div data-tocid="id-d5856e3654" class="topicref" data-id="id" data-state="not-ready"><span role="button" tabindex="0" aria-labelledby="button-expand-action id-d5856e3654-link" class="wh-expand-btn"></span><div class="title"><a href="../../../topics/sdk/audio/audio_user_guide.html" id="id-d5856e3654-link">Audio 使用指南</a></div></div></li><li role="treeitem" aria-expanded="false"><div data-tocid="id-d5856e3714" class="topicref" data-id="id" data-state="not-ready"><span role="button" tabindex="0" aria-labelledby="button-expand-action id-d5856e3714-link" class="wh-expand-btn"></span><div class="title"><a href="../../../topics/sdk/display/display_user_guide_2.html" id="id-d5856e3714-link">Display 使用指南</a></div></div></li><li role="treeitem" aria-expanded="false"><div data-tocid="concept_h4d_fwt_tzb-d5856e3955" class="topicref" data-id="concept_h4d_fwt_tzb" data-state="not-ready"><span role="button" tabindex="0" aria-labelledby="button-expand-action concept_h4d_fwt_tzb-d5856e3955-link" class="wh-expand-btn"></span><div class="title"><a href="../../../topics/sdk/dvp/dvp_user_guide_2.html" id="concept_h4d_fwt_tzb-d5856e3955-link">DVP 使用指南</a></div></div></li><li role="treeitem" aria-expanded="false"><div data-tocid="ge-d5856e4075" class="topicref" data-id="ge" data-state="not-ready"><span role="button" tabindex="0" aria-labelledby="button-expand-action ge-d5856e4075-link" class="wh-expand-btn"></span><div class="title"><a href="../../../topics/sdk/ge/ge_user_guide_2.html" id="ge-d5856e4075-link">GE 使用指南</a></div></div></li><li role="treeitem" aria-expanded="true"><div data-tocid="i2s-d5856e4195" class="topicref" data-id="i2s" data-state="expanded"><span role="button" tabindex="0" aria-labelledby="button-collapse-action i2s-d5856e4195-link" class="wh-expand-btn"></span><div class="title"><a href="../../../topics/sdk/i2s/i2s_user_guide_2.html" id="i2s-d5856e4195-link">I2S 使用指南</a></div></div><ul role="group" class="navbar-nav nav-list"><li role="treeitem"><div data-tocid="id-d5856e4207" class="topicref" data-id="id" data-state="leaf"><span role="button" class="wh-expand-btn"></span><div class="title"><a href="../../../topics/sdk/i2s/i2s_config_guide_lite.html" id="id-d5856e4207-link">参数配置</a></div></div></li><li role="treeitem"><div data-tocid="id-d5856e4219" class="topicref" data-id="id" data-state="leaf"><span role="button" class="wh-expand-btn"></span><div class="title"><a href="../../../topics/sdk/i2s/i2s_test_guide_lite.html" id="id-d5856e4219-link">测试指南</a></div></div></li><li role="treeitem" aria-expanded="true"><div data-tocid="id-d5856e4231" class="topicref" data-id="id" data-state="expanded"><span role="button" tabindex="0" aria-labelledby="button-collapse-action id-d5856e4231-link" class="wh-expand-btn"></span><div class="title"><a href="../../../topics/sdk/i2s/i2s_design_lite.html" id="id-d5856e4231-link">设计说明</a></div></div><ul role="group" class="navbar-nav nav-list"><li role="treeitem"><div data-tocid="i2s-arch-lite-d5856e4243" class="topicref" data-id="i2s-arch-lite" data-state="leaf"><span role="button" class="wh-expand-btn"></span><div class="title"><a href="../../../topics/sdk/i2s/i2s_arch_lite.html" id="i2s-arch-lite-d5856e4243-link">I2S 架构设计</a></div></div></li><li role="treeitem"><div data-tocid="i2s-key-process-lite-d5856e4255" class="topicref" data-id="i2s-key-process-lite" data-state="leaf"><span role="button" class="wh-expand-btn"></span><div class="title"><a href="../../../topics/sdk/i2s/i2s_key_procedure_lite.html" id="i2s-key-process-lite-d5856e4255-link">关键流程设计</a></div></div></li><li role="treeitem"><div data-tocid="i2s-data-struct-design-d5856e4267" class="topicref" data-id="i2s-data-struct-design" data-state="leaf"><span role="button" class="wh-expand-btn"></span><div class="title"><a href="../../../topics/sdk/i2s/i2s_data_struct_lite.html" id="i2s-data-struct-design-d5856e4267-link">数据结构设计</a></div></div></li><li role="treeitem" class="active"><div data-tocid="i2s-interface-design-d5856e4279" class="topicref" data-id="i2s-interface-design" data-state="leaf"><span role="button" class="wh-expand-btn"></span><div class="title"><a href="../../../topics/sdk/i2s/i2s_interface_lite.html" id="i2s-interface-design-d5856e4279-link">接口设计</a></div></div></li></ul></li><li role="treeitem"><div data-tocid="i2s_common_issues-d5856e4291" class="topicref" data-id="i2s_common_issues" data-state="leaf"><span role="button" class="wh-expand-btn"></span><div class="title"><a href="../../../topics/sdk/i2s/i2s_faq_2.html" id="i2s_common_issues-d5856e4291-link">常见问题</a></div></div></li></ul></li><li role="treeitem" aria-expanded="false"><div data-tocid="ve-d5856e4303" class="topicref" data-id="ve" data-state="not-ready"><span role="button" tabindex="0" aria-labelledby="button-expand-action ve-d5856e4303-link" class="wh-expand-btn"></span><div class="title"><a href="../../../topics/sdk/ve/ve-user-guide_2.html" id="ve-d5856e4303-link">VE 使用指南</a></div></div></li><li role="treeitem" aria-expanded="false"><div data-tocid="mpp-d5856e4363" class="topicref" data-id="mpp" data-state="not-ready"><span role="button" tabindex="0" aria-labelledby="button-expand-action mpp-d5856e4363-link" class="wh-expand-btn"></span><div class="title"><a href="../../../topics/sdk/mpp/mpp_user_guide_2.html" id="mpp-d5856e4363-link">MPP 使用指南</a></div></div></li><li role="treeitem" aria-expanded="false"><div data-tocid="mpp_0-d5856e4495" class="topicref" data-id="mpp_0" data-state="not-ready"><span role="button" tabindex="0" aria-labelledby="button-expand-action mpp_0-d5856e4495-link" class="wh-expand-btn"></span><div class="title"><a href="../../../topics/sdk/mpp/mpp_player_user_guide_2.html" id="mpp_0-d5856e4495-link">MPP 播放器使用指南</a></div></div></li><li role="treeitem" aria-expanded="false"><div data-tocid="id-d5856e4579" class="topicref" data-id="id" data-state="not-ready"><span role="button" tabindex="0" aria-labelledby="button-expand-action id-d5856e4579-link" class="wh-expand-btn"></span><div class="title"><a href="../../../topics/sdk/mpp/mpp_recorder_user_guide.html" id="id-d5856e4579-link">MPP 录像使用指南</a></div></div></li><li role="treeitem" aria-expanded="false"><div data-tocid="id-d5856e4651" class="topicref" data-id="id" data-state="not-ready"><span role="button" tabindex="0" aria-labelledby="button-expand-action id-d5856e4651-link" class="wh-expand-btn"></span><div class="title"><a href="../../../topics/sdk/mpp/mini_audio_player_user_guide.html" id="id-d5856e4651-link">MPP 音频播放器使用指南</a></div></div></li><li role="treeitem" aria-expanded="false"><div data-tocid="id-d5856e4724" class="topicref" data-id="id" data-state="not-ready"><span role="button" tabindex="0" aria-labelledby="button-expand-action id-d5856e4724-link" class="wh-expand-btn"></span><div class="title"><a href="../../../topics/sdk/lvgl/lvgl_introduction.html" id="id-d5856e4724-link">LVGL 使用指南</a></div></div></li></ul></li><li role="treeitem" aria-expanded="false"><div data-tocid="concept_nww_hzh_pzb-d5856e4868" 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-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></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 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/i2s/i2s_interface_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: 2 minute(s)
</div><div class="- topic/body concept/conbody body conbody"><section class="- topic/section section" id="i2s-interface-design__section_ngf_lzl_4dc" data-ofbid="i2s-interface-design__section_ngf_lzl_4dc"><h2 class="- topic/title title sectiontitle">Driver 层接口设计</h2>
<div class="- topic/div div section" id="i2s-interface-design__id13">
<p class="- topic/p p" data-ofbid="d146041e33__20250121171610">Driver 层可以同时实现 playback 和 record 两个功能,主要根据的是音频数据流的方向进行判别。</p>
<div class="table-container"><table class="- topic/table table frame-all" id="i2s-interface-design__table_gvg_kkf_fdc" data-ofbid="i2s-interface-design__table_gvg_kkf_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_i2s_sound_init</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="i2s-interface-design__table_gvg_kkf_fdc__entry__1">函数原型</th><th class="- topic/entry entry colsep-0 rowsep-1" id="i2s-interface-design__table_gvg_kkf_fdc__entry__2">rt_err_t drv_i2s_sound_init(struct rt_audio_device
*audio)</th></tr></thead><tbody class="- topic/tbody tbody"><tr class="- topic/row"><td class="- topic/entry entry colsep-1 rowsep-1" headers="i2s-interface-design__table_gvg_kkf_fdc__entry__1">功能说明</td><td class="- topic/entry entry colsep-0 rowsep-1" headers="i2s-interface-design__table_gvg_kkf_fdc__entry__2">i2s 的初始化函数</td></tr><tr class="- topic/row"><td class="- topic/entry entry colsep-1 rowsep-1" headers="i2s-interface-design__table_gvg_kkf_fdc__entry__1">参数定义</td><td class="- topic/entry entry colsep-0 rowsep-1" headers="i2s-interface-design__table_gvg_kkf_fdc__entry__2">audio指向音频设备的指针</td></tr><tr class="- topic/row"><td class="- topic/entry entry colsep-1 rowsep-1" headers="i2s-interface-design__table_gvg_kkf_fdc__entry__1">返回值</td><td class="- topic/entry entry colsep-0 rowsep-1" headers="i2s-interface-design__table_gvg_kkf_fdc__entry__2">RT_EOK执行成功</td></tr><tr class="- topic/row"><td class="- topic/entry entry colsep-1 rowsep-0" headers="i2s-interface-design__table_gvg_kkf_fdc__entry__1">注意事项</td><td class="- topic/entry entry colsep-0 rowsep-0" headers="i2s-interface-design__table_gvg_kkf_fdc__entry__2">- </td></tr></tbody></table></div>
<div class="table-container"><table class="- topic/table table frame-all" id="i2s-interface-design__table_hvg_kkf_fdc" data-ofbid="i2s-interface-design__table_hvg_kkf_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_i2s_sound_buffer_info</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="i2s-interface-design__table_hvg_kkf_fdc__entry__1">函数原型</th><th class="- topic/entry entry colsep-0 rowsep-1" id="i2s-interface-design__table_hvg_kkf_fdc__entry__2">void drv_i2s_sound_buffer_info(struct rt_audio_device *audio,
struct rt_audio_buf_info *info)</th></tr></thead><tbody class="- topic/tbody tbody"><tr class="- topic/row"><td class="- topic/entry entry colsep-1 rowsep-1" headers="i2s-interface-design__table_hvg_kkf_fdc__entry__1">功能说明</td><td class="- topic/entry entry colsep-0 rowsep-1" headers="i2s-interface-design__table_hvg_kkf_fdc__entry__2">获取音频的 TX buffer 参数</td></tr><tr class="- topic/row"><td class="- topic/entry entry colsep-1 rowsep-1" headers="i2s-interface-design__table_hvg_kkf_fdc__entry__1">参数定义</td><td class="- topic/entry entry colsep-0 rowsep-1" headers="i2s-interface-design__table_hvg_kkf_fdc__entry__2">
<div class="- topic/div div">
<div class="- topic/div div"> audio指向音频设备的指针</div>
<div class="- topic/div div">info用于获取 TX buffer 参数的指针</div>
</div>
</td></tr><tr class="- topic/row"><td class="- topic/entry entry colsep-1 rowsep-1" headers="i2s-interface-design__table_hvg_kkf_fdc__entry__1">返回值</td><td class="- topic/entry entry colsep-0 rowsep-1" headers="i2s-interface-design__table_hvg_kkf_fdc__entry__2"></td></tr><tr class="- topic/row"><td class="- topic/entry entry colsep-1 rowsep-0" headers="i2s-interface-design__table_hvg_kkf_fdc__entry__1">注意事项</td><td class="- topic/entry entry colsep-0 rowsep-0" headers="i2s-interface-design__table_hvg_kkf_fdc__entry__2">- </td></tr></tbody></table></div>
<div class="table-container"><table class="- topic/table table frame-all" id="i2s-interface-design__table_ivg_kkf_fdc" data-ofbid="i2s-interface-design__table_ivg_kkf_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_i2s_sound_start</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="i2s-interface-design__table_ivg_kkf_fdc__entry__1">函数原型</th><th class="- topic/entry entry colsep-0 rowsep-1" id="i2s-interface-design__table_ivg_kkf_fdc__entry__2">rt_err_t drv_i2s_sound_start(struct rt_audio_device *audio,
int stream)</th></tr></thead><tbody class="- topic/tbody tbody"><tr class="- topic/row"><td class="- topic/entry entry colsep-1 rowsep-1" headers="i2s-interface-design__table_ivg_kkf_fdc__entry__1">功能说明</td><td class="- topic/entry entry colsep-0 rowsep-1" headers="i2s-interface-design__table_ivg_kkf_fdc__entry__2">开始音频播放</td></tr><tr class="- topic/row"><td class="- topic/entry entry colsep-1 rowsep-1" headers="i2s-interface-design__table_ivg_kkf_fdc__entry__1">参数定义</td><td class="- topic/entry entry colsep-0 rowsep-1" headers="i2s-interface-design__table_ivg_kkf_fdc__entry__2">
<div class="- topic/div div">
<div class="- topic/div div"> audio指向音频设备的指针</div>
<div class="- topic/div div"> stream音频数据流方向</div>
</div>
</td></tr><tr class="- topic/row"><td class="- topic/entry entry colsep-1 rowsep-1" headers="i2s-interface-design__table_ivg_kkf_fdc__entry__1">返回值</td><td class="- topic/entry entry colsep-0 rowsep-1" headers="i2s-interface-design__table_ivg_kkf_fdc__entry__2">
<div class="- topic/div div">
<div class="- topic/div div"> RT_EOK执行成功</div>
<div class="- topic/div div"> -RT_EINVAL参数非法</div>
</div>
</td></tr><tr class="- topic/row"><td class="- topic/entry entry colsep-1 rowsep-0" headers="i2s-interface-design__table_ivg_kkf_fdc__entry__1">注意事项</td><td class="- topic/entry entry colsep-0 rowsep-0" headers="i2s-interface-design__table_ivg_kkf_fdc__entry__2">- </td></tr></tbody></table></div>
<div class="table-container"><table class="- topic/table table frame-all" id="i2s-interface-design__table_jvg_kkf_fdc" data-ofbid="i2s-interface-design__table_jvg_kkf_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"> 4</span><span class="table--title-label-punctuation">. </span></span><span class="table--title">drv_i2s_sound_stop</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="i2s-interface-design__table_jvg_kkf_fdc__entry__1">函数原型</th><th class="- topic/entry entry colsep-0 rowsep-1" id="i2s-interface-design__table_jvg_kkf_fdc__entry__2">rt_err_t drv_i2s_sound_stop(struct rt_audio_device *audio,
int stream)</th></tr></thead><tbody class="- topic/tbody tbody"><tr class="- topic/row"><td class="- topic/entry entry colsep-1 rowsep-1" headers="i2s-interface-design__table_jvg_kkf_fdc__entry__1">功能说明</td><td class="- topic/entry entry colsep-0 rowsep-1" headers="i2s-interface-design__table_jvg_kkf_fdc__entry__2">结束音频播放</td></tr><tr class="- topic/row"><td class="- topic/entry entry colsep-1 rowsep-1" headers="i2s-interface-design__table_jvg_kkf_fdc__entry__1">参数定义</td><td class="- topic/entry entry colsep-0 rowsep-1" headers="i2s-interface-design__table_jvg_kkf_fdc__entry__2">
<div class="- topic/div div">
<div class="- topic/div div"> audio指向音频设备的指针</div>
<div class="- topic/div div"> stream音频数据流方向</div>
</div>
</td></tr><tr class="- topic/row"><td class="- topic/entry entry colsep-1 rowsep-1" headers="i2s-interface-design__table_jvg_kkf_fdc__entry__1">返回值</td><td class="- topic/entry entry colsep-0 rowsep-1" headers="i2s-interface-design__table_jvg_kkf_fdc__entry__2">
<div class="- topic/div div">
<div class="- topic/div div"> RT_EOK执行成功</div>
<div class="- topic/div div"> -RT_EINVAL参数非法</div>
</div>
</td></tr><tr class="- topic/row"><td class="- topic/entry entry colsep-1 rowsep-0" headers="i2s-interface-design__table_jvg_kkf_fdc__entry__1">注意事项</td><td class="- topic/entry entry colsep-0 rowsep-0" headers="i2s-interface-design__table_jvg_kkf_fdc__entry__2">- </td></tr></tbody></table></div>
<div class="table-container"><table class="- topic/table table frame-all" id="i2s-interface-design__table_kvg_kkf_fdc" data-ofbid="i2s-interface-design__table_kvg_kkf_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"> 5</span><span class="table--title-label-punctuation">. </span></span><span class="table--title">drv_i2s_sound_pause</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="i2s-interface-design__table_kvg_kkf_fdc__entry__1">函数原型</th><th class="- topic/entry entry colsep-0 rowsep-1" id="i2s-interface-design__table_kvg_kkf_fdc__entry__2">rt_err_t drv_i2s_sound_pause(struct rt_audio_device *audio,
int enable)</th></tr></thead><tbody class="- topic/tbody tbody"><tr class="- topic/row"><td class="- topic/entry entry colsep-1 rowsep-1" headers="i2s-interface-design__table_kvg_kkf_fdc__entry__1">功能说明</td><td class="- topic/entry entry colsep-0 rowsep-1" headers="i2s-interface-design__table_kvg_kkf_fdc__entry__2">暂停/恢复音频播放</td></tr><tr class="- topic/row"><td class="- topic/entry entry colsep-1 rowsep-1" headers="i2s-interface-design__table_kvg_kkf_fdc__entry__1">参数定义</td><td class="- topic/entry entry colsep-0 rowsep-1" headers="i2s-interface-design__table_kvg_kkf_fdc__entry__2">
<div class="- topic/div div">
<div class="- topic/div div"> audio指向音频设备的指针</div>
<div class="- topic/div div"> enable音频暂停和恢复播放使能位(0 为恢复,非 0 为暂停)</div>
</div>
</td></tr><tr class="- topic/row"><td class="- topic/entry entry colsep-1 rowsep-1" headers="i2s-interface-design__table_kvg_kkf_fdc__entry__1">返回值</td><td class="- topic/entry entry colsep-0 rowsep-1" headers="i2s-interface-design__table_kvg_kkf_fdc__entry__2">
<div class="- topic/div div">
<div class="- topic/div div"> RT_EOK执行成功</div>
</div>
</td></tr><tr class="- topic/row"><td class="- topic/entry entry colsep-1 rowsep-0" headers="i2s-interface-design__table_kvg_kkf_fdc__entry__1">注意事项</td><td class="- topic/entry entry colsep-0 rowsep-0" headers="i2s-interface-design__table_kvg_kkf_fdc__entry__2">- </td></tr></tbody></table></div>
<div class="table-container"><table class="- topic/table table frame-all" id="i2s-interface-design__table_lvg_kkf_fdc" data-ofbid="i2s-interface-design__table_lvg_kkf_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"> 6</span><span class="table--title-label-punctuation">. </span></span><span class="table--title">drv_i2s_sound_configure</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="i2s-interface-design__table_lvg_kkf_fdc__entry__1">函数原型</th><th class="- topic/entry entry colsep-0 rowsep-1" id="i2s-interface-design__table_lvg_kkf_fdc__entry__2">rt_err_t drv_i2s_sound_configure(struct rt_audio_device
*audio, struct rt_audio_caps *caps)</th></tr></thead><tbody class="- topic/tbody tbody"><tr class="- topic/row"><td class="- topic/entry entry colsep-1 rowsep-1" headers="i2s-interface-design__table_lvg_kkf_fdc__entry__1">功能原型</td><td class="- topic/entry entry colsep-0 rowsep-1" headers="i2s-interface-design__table_lvg_kkf_fdc__entry__2">音频设备配置接口,用于配置采样格式,采样率,通道数等接口</td></tr><tr class="- topic/row"><td class="- topic/entry entry colsep-1 rowsep-1" headers="i2s-interface-design__table_lvg_kkf_fdc__entry__1">参数定义</td><td class="- topic/entry entry colsep-0 rowsep-1" headers="i2s-interface-design__table_lvg_kkf_fdc__entry__2">
<div class="- topic/div div">
<div class="- topic/div div"> audio指向音频设备的指针</div>
<div class="- topic/div div"> caps指向配置参数的指针</div>
</div>
</td></tr><tr class="- topic/row"><td class="- topic/entry entry colsep-1 rowsep-1" headers="i2s-interface-design__table_lvg_kkf_fdc__entry__1">返回值</td><td class="- topic/entry entry colsep-0 rowsep-1" headers="i2s-interface-design__table_lvg_kkf_fdc__entry__2">
<div class="- topic/div div">
<div class="- topic/div div"> RT_EOK执行成功</div>
<div class="- topic/div div"> -RT_ERROR参数不支持</div>
</div>
</td></tr><tr class="- topic/row"><td class="- topic/entry entry colsep-1 rowsep-0" headers="i2s-interface-design__table_lvg_kkf_fdc__entry__1">注意事项</td><td class="- topic/entry entry colsep-0 rowsep-0" headers="i2s-interface-design__table_lvg_kkf_fdc__entry__2">- </td></tr></tbody></table></div>
<div class="table-container"><table class="- topic/table table frame-all" id="i2s-interface-design__table_mvg_kkf_fdc" data-ofbid="i2s-interface-design__table_mvg_kkf_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"> 7</span><span class="table--title-label-punctuation">. </span></span><span class="table--title">drv_i2s_sound_getcaps</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="i2s-interface-design__table_mvg_kkf_fdc__entry__1">函数原型</th><th class="- topic/entry entry colsep-0 rowsep-1" id="i2s-interface-design__table_mvg_kkf_fdc__entry__2">rt_err_t drv_i2s_sound_getcaps(struct rt_audio_device *audio,
struct rt_audio_caps *caps)</th></tr></thead><tbody class="- topic/tbody tbody"><tr class="- topic/row"><td class="- topic/entry entry colsep-1 rowsep-1" headers="i2s-interface-design__table_mvg_kkf_fdc__entry__1">功能说明</td><td class="- topic/entry entry colsep-0 rowsep-1" headers="i2s-interface-design__table_mvg_kkf_fdc__entry__2">获取音频设备的参数</td></tr><tr class="- topic/row"><td class="- topic/entry entry colsep-1 rowsep-1" headers="i2s-interface-design__table_mvg_kkf_fdc__entry__1">参数定义</td><td class="- topic/entry entry colsep-0 rowsep-1" headers="i2s-interface-design__table_mvg_kkf_fdc__entry__2">
<div class="- topic/div div">
<div class="- topic/div div"> audio指向音频设备的指针</div>
<div class="- topic/div div"> caps指向配置参数的指针</div>
</div>
</td></tr><tr class="- topic/row"><td class="- topic/entry entry colsep-1 rowsep-1" headers="i2s-interface-design__table_mvg_kkf_fdc__entry__1">返回值</td><td class="- topic/entry entry colsep-0 rowsep-1" headers="i2s-interface-design__table_mvg_kkf_fdc__entry__2">
<div class="- topic/div div">
<div class="- topic/div div"> RT_EOK执行成功</div>
<div class="- topic/div div"> -RT_ERROR参数不支持</div>
</div>
</td></tr><tr class="- topic/row"><td class="- topic/entry entry colsep-1 rowsep-0" headers="i2s-interface-design__table_mvg_kkf_fdc__entry__1">注意事项</td><td class="- topic/entry entry colsep-0 rowsep-0" headers="i2s-interface-design__table_mvg_kkf_fdc__entry__2">- </td></tr></tbody></table></div>
<div class="table-container"><table class="- topic/table table frame-all" id="i2s-interface-design__table_nvg_kkf_fdc" data-ofbid="i2s-interface-design__table_nvg_kkf_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"> 8</span><span class="table--title-label-punctuation">. </span></span><span class="table--title">drv_audio_get_i2s_sound_avail</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="i2s-interface-design__table_nvg_kkf_fdc__entry__1">函数原型</th><th class="- topic/entry entry colsep-0 rowsep-1" id="i2s-interface-design__table_nvg_kkf_fdc__entry__2">rt_size_t drv_i2s_sound_get_playback_avail(struct
rt_audio_device *audio)</th></tr></thead><tbody class="- topic/tbody tbody"><tr class="- topic/row"><td class="- topic/entry entry colsep-1 rowsep-1" headers="i2s-interface-design__table_nvg_kkf_fdc__entry__1">功能说明</td><td class="- topic/entry entry colsep-0 rowsep-1" headers="i2s-interface-design__table_nvg_kkf_fdc__entry__2">获取音频缓存的数据大小</td></tr><tr class="- topic/row"><td class="- topic/entry entry colsep-1 rowsep-1" headers="i2s-interface-design__table_nvg_kkf_fdc__entry__1">参数定义</td><td class="- topic/entry entry colsep-0 rowsep-1" headers="i2s-interface-design__table_nvg_kkf_fdc__entry__2">
<div class="- topic/div div">
<div class="- topic/div div"> audio指向音频设备的指针</div>
</div>
</td></tr><tr class="- topic/row"><td class="- topic/entry entry colsep-1 rowsep-1" headers="i2s-interface-design__table_nvg_kkf_fdc__entry__1">返回值</td><td class="- topic/entry entry colsep-0 rowsep-1" headers="i2s-interface-design__table_nvg_kkf_fdc__entry__2">
<div class="- topic/div div">
<div class="- topic/div div"> 缓存数据的大小</div>
</div>
</td></tr><tr class="- topic/row"><td class="- topic/entry entry colsep-1 rowsep-0" headers="i2s-interface-design__table_nvg_kkf_fdc__entry__1">注意事项</td><td class="- topic/entry entry colsep-0 rowsep-0" headers="i2s-interface-design__table_nvg_kkf_fdc__entry__2">-</td></tr></tbody></table></div>
</div>
</section><section class="- topic/section section" id="i2s-interface-design__section_kzk_lzl_4dc" data-ofbid="i2s-interface-design__section_kzk_lzl_4dc"><h2 class="- topic/title title sectiontitle">HAL 层接口设计</h2>
<div class="- topic/div div section" id="i2s-interface-design__id14">
<p class="- topic/p p" data-ofbid="d146041e425__20250121171610">HAL 层接口也是分 playbackrecord 两部分进行设计,下面以 playback 端的接口进行说明。 </p>
<div class="table-container"><table class="- topic/table table frame-all" id="i2s-interface-design__table_ovg_kkf_fdc" data-ofbid="i2s-interface-design__table_ovg_kkf_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"> 9</span><span class="table--title-label-punctuation">. </span></span><span class="table--title">hal_i2s_protocol_select</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="i2s-interface-design__table_ovg_kkf_fdc__entry__1">函数原型</th><th class="- topic/entry entry colsep-0 rowsep-1" id="i2s-interface-design__table_ovg_kkf_fdc__entry__2">int hal_i2s_protocol_select(aic_i2s_ctrl *i2s, i2s_protocol_t
protocol)</th></tr></thead><tbody class="- topic/tbody tbody"><tr class="- topic/row"><td class="- topic/entry entry colsep-1 rowsep-1" headers="i2s-interface-design__table_ovg_kkf_fdc__entry__1">功能说明</td><td class="- topic/entry entry colsep-0 rowsep-1" headers="i2s-interface-design__table_ovg_kkf_fdc__entry__2">设置传输协议</td></tr><tr class="- topic/row"><td class="- topic/entry entry colsep-1 rowsep-1" headers="i2s-interface-design__table_ovg_kkf_fdc__entry__1">参数定义</td><td class="- topic/entry entry colsep-0 rowsep-1" headers="i2s-interface-design__table_ovg_kkf_fdc__entry__2">
<div class="- topic/div div">
<div class="- topic/div div"> i2s指向 aic_i2s_ctrl 的指针</div>
<div class="- topic/div div"> protocol传输协议</div>
</div>
</td></tr><tr class="- topic/row"><td class="- topic/entry entry colsep-1 rowsep-1" headers="i2s-interface-design__table_ovg_kkf_fdc__entry__1">返回值</td><td class="- topic/entry entry colsep-0 rowsep-1" headers="i2s-interface-design__table_ovg_kkf_fdc__entry__2">
<div class="- topic/div div">
<div class="- topic/div div">0执行成功</div>
<div class="- topic/div div"> -EINVAL参数不支持</div>
</div>
</td></tr><tr class="- topic/row"><td class="- topic/entry entry colsep-1 rowsep-0" headers="i2s-interface-design__table_ovg_kkf_fdc__entry__1">注意事项</td><td class="- topic/entry entry colsep-0 rowsep-0" headers="i2s-interface-design__table_ovg_kkf_fdc__entry__2">- </td></tr></tbody></table></div>
<div class="table-container"><table class="- topic/table table frame-all" id="i2s-interface-design__table_pvg_kkf_fdc" data-ofbid="i2s-interface-design__table_pvg_kkf_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"> 10</span><span class="table--title-label-punctuation">. </span></span><span class="table--title">hal_i2s_sample_width_select</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="i2s-interface-design__table_pvg_kkf_fdc__entry__1">函数原型</th><th class="- topic/entry entry colsep-0 rowsep-1" id="i2s-interface-design__table_pvg_kkf_fdc__entry__2">int hal_i2s_sample_width_select(aic_i2s_ctrl *i2s,
i2s_sample_width_t width)</th></tr></thead><tbody class="- topic/tbody tbody"><tr class="- topic/row"><td class="- topic/entry entry colsep-1 rowsep-1" headers="i2s-interface-design__table_pvg_kkf_fdc__entry__1">功能说明</td><td class="- topic/entry entry colsep-0 rowsep-1" headers="i2s-interface-design__table_pvg_kkf_fdc__entry__2">设置采样通道的位宽</td></tr><tr class="- topic/row"><td class="- topic/entry entry colsep-1 rowsep-1" headers="i2s-interface-design__table_pvg_kkf_fdc__entry__1">参数定义</td><td class="- topic/entry entry colsep-0 rowsep-1" headers="i2s-interface-design__table_pvg_kkf_fdc__entry__2">
<div class="- topic/div div">
<div class="- topic/div div"> i2s指向 aic_i2s_ctrl 的指针</div>
<div class="- topic/div div"> width通道的位宽</div>
</div>
</td></tr><tr class="- topic/row"><td class="- topic/entry entry colsep-1 rowsep-1" headers="i2s-interface-design__table_pvg_kkf_fdc__entry__1">返回值</td><td class="- topic/entry entry colsep-0 rowsep-1" headers="i2s-interface-design__table_pvg_kkf_fdc__entry__2">
<div class="- topic/div div">
<div class="- topic/div div">0执行成功</div>
</div>
</td></tr><tr class="- topic/row"><td class="- topic/entry entry colsep-1 rowsep-0" headers="i2s-interface-design__table_pvg_kkf_fdc__entry__1">注意事项</td><td class="- topic/entry entry colsep-0 rowsep-0" headers="i2s-interface-design__table_pvg_kkf_fdc__entry__2">- </td></tr></tbody></table></div>
<div class="table-container"><table class="- topic/table table frame-all" id="i2s-interface-design__table_qvg_kkf_fdc" data-ofbid="i2s-interface-design__table_qvg_kkf_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"> 11</span><span class="table--title-label-punctuation">. </span></span><span class="table--title">hal_i2s_mclk_set</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="i2s-interface-design__table_qvg_kkf_fdc__entry__1">函数原型</th><th class="- topic/entry entry colsep-0 rowsep-1" id="i2s-interface-design__table_qvg_kkf_fdc__entry__2">int hal_i2s_mclk_set(aic_i2s_ctrl *i2s, i2s_sample_rate_t
sample_rate, uint32_t mclk_nfs)</th></tr></thead><tbody class="- topic/tbody tbody"><tr class="- topic/row"><td class="- topic/entry entry colsep-1 rowsep-1" headers="i2s-interface-design__table_qvg_kkf_fdc__entry__1">功能说明</td><td class="- topic/entry entry colsep-0 rowsep-1" headers="i2s-interface-design__table_qvg_kkf_fdc__entry__2">设置 MCLK 的时钟频率</td></tr><tr class="- topic/row"><td class="- topic/entry entry colsep-1 rowsep-1" headers="i2s-interface-design__table_qvg_kkf_fdc__entry__1">参数定义</td><td class="- topic/entry entry colsep-0 rowsep-1" headers="i2s-interface-design__table_qvg_kkf_fdc__entry__2">
<div class="- topic/div div">
<div class="- topic/div div"> i2s指向 aic_i2s_ctrl 的指针</div>
<div class="- topic/div div">sample_rate采样率</div>
<div class="- topic/div div"> mclk_nfsMCLK 的时钟频率</div>
</div>
</td></tr><tr class="- topic/row"><td class="- topic/entry entry colsep-1 rowsep-1" headers="i2s-interface-design__table_qvg_kkf_fdc__entry__1">返回值</td><td class="- topic/entry entry colsep-0 rowsep-1" headers="i2s-interface-design__table_qvg_kkf_fdc__entry__2">
<div class="- topic/div div">
<div class="- topic/div div">0执行成功</div>
<div class="- topic/div div"> -EINVAL参数不支持</div>
</div>
</td></tr><tr class="- topic/row"><td class="- topic/entry entry colsep-1 rowsep-0" headers="i2s-interface-design__table_qvg_kkf_fdc__entry__1">注意事项</td><td class="- topic/entry entry colsep-0 rowsep-0" headers="i2s-interface-design__table_qvg_kkf_fdc__entry__2">- </td></tr></tbody></table></div>
<div class="table-container"><table class="- topic/table table frame-all" id="i2s-interface-design__table_rvg_kkf_fdc" data-ofbid="i2s-interface-design__table_rvg_kkf_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"> 12</span><span class="table--title-label-punctuation">. </span></span><span class="table--title">hal_i2s_polarity_set</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="i2s-interface-design__table_rvg_kkf_fdc__entry__1">函数原型</th><th class="- topic/entry entry colsep-0 rowsep-1" id="i2s-interface-design__table_rvg_kkf_fdc__entry__2">void hal_i2s_polarity_set(aic_i2s_ctrl *i2s, i2s_polarity_t
polarity)</th></tr></thead><tbody class="- topic/tbody tbody"><tr class="- topic/row"><td class="- topic/entry entry colsep-1 rowsep-1" headers="i2s-interface-design__table_rvg_kkf_fdc__entry__1">功能说明</td><td class="- topic/entry entry colsep-0 rowsep-1" headers="i2s-interface-design__table_rvg_kkf_fdc__entry__2">选择 LRCK 的左右通道极性</td></tr><tr class="- topic/row"><td class="- topic/entry entry colsep-1 rowsep-1" headers="i2s-interface-design__table_rvg_kkf_fdc__entry__1">参数定义</td><td class="- topic/entry entry colsep-0 rowsep-1" headers="i2s-interface-design__table_rvg_kkf_fdc__entry__2">
<div class="- topic/div div">
<div class="- topic/div div"> i2s指向 aic_i2s_ctrl 的指针</div>
<div class="- topic/div div"> polarityLRCK 的左右通道极性</div>
</div>
</td></tr><tr class="- topic/row"><td class="- topic/entry entry colsep-1 rowsep-1" headers="i2s-interface-design__table_rvg_kkf_fdc__entry__1">返回值</td><td class="- topic/entry entry colsep-0 rowsep-1" headers="i2s-interface-design__table_rvg_kkf_fdc__entry__2"></td></tr><tr class="- topic/row"><td class="- topic/entry entry colsep-1 rowsep-0" headers="i2s-interface-design__table_rvg_kkf_fdc__entry__1">注意事项</td><td class="- topic/entry entry colsep-0 rowsep-0" headers="i2s-interface-design__table_rvg_kkf_fdc__entry__2">- </td></tr></tbody></table></div>
<div class="table-container"><table class="- topic/table table frame-all" id="i2s-interface-design__table_svg_kkf_fdc" data-ofbid="i2s-interface-design__table_svg_kkf_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"> 13</span><span class="table--title-label-punctuation">. </span></span><span class="table--title">hal_i2s_sclk_set</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="i2s-interface-design__table_svg_kkf_fdc__entry__1">函数原型</th><th class="- topic/entry entry colsep-0 rowsep-1" id="i2s-interface-design__table_svg_kkf_fdc__entry__2">int hal_i2s_sclk_set(aic_i2s_ctrl *i2s, i2s_sample_rate_t
sample_rate, uint32_t sclk_nfs)</th></tr></thead><tbody class="- topic/tbody tbody"><tr class="- topic/row"><td class="- topic/entry entry colsep-1 rowsep-1" headers="i2s-interface-design__table_svg_kkf_fdc__entry__1">功能说明</td><td class="- topic/entry entry colsep-0 rowsep-1" headers="i2s-interface-design__table_svg_kkf_fdc__entry__2">设置 SCLK/LRCK 的比率</td></tr><tr class="- topic/row"><td class="- topic/entry entry colsep-1 rowsep-1" headers="i2s-interface-design__table_svg_kkf_fdc__entry__1">参数定义</td><td class="- topic/entry entry colsep-0 rowsep-1" headers="i2s-interface-design__table_svg_kkf_fdc__entry__2">
<div class="- topic/div div">
<div class="- topic/div div"> i2s指向 aic_i2s_ctrl 的指针</div>
<div class="- topic/div div">sample_rate采样率</div>
<div class="- topic/div div"> sclk_nfs需要设置的比率</div>
</div>
</td></tr><tr class="- topic/row"><td class="- topic/entry entry colsep-1 rowsep-1" headers="i2s-interface-design__table_svg_kkf_fdc__entry__1">返回值</td><td class="- topic/entry entry colsep-0 rowsep-1" headers="i2s-interface-design__table_svg_kkf_fdc__entry__2">
<div class="- topic/div div">
<div class="- topic/div div">0执行成功</div>
<div class="- topic/div div"> -EINVAL参数不支持</div>
</div>
</td></tr><tr class="- topic/row"><td class="- topic/entry entry colsep-1 rowsep-0" headers="i2s-interface-design__table_svg_kkf_fdc__entry__1">注意事项</td><td class="- topic/entry entry colsep-0 rowsep-0" headers="i2s-interface-design__table_svg_kkf_fdc__entry__2">- </td></tr></tbody></table></div>
<div class="table-container"><table class="- topic/table table frame-all" id="i2s-interface-design__table_tvg_kkf_fdc" data-ofbid="i2s-interface-design__table_tvg_kkf_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"> 14</span><span class="table--title-label-punctuation">. </span></span><span class="table--title">hal_i2s_channel_select</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="i2s-interface-design__table_tvg_kkf_fdc__entry__1">函数原型</th><th class="- topic/entry entry colsep-0 rowsep-1" id="i2s-interface-design__table_tvg_kkf_fdc__entry__2">void hal_i2s_channel_select(aic_i2s_ctrl *i2s,
i2s_sound_channel_t channel, i2s_stream_t stream)</th></tr></thead><tbody class="- topic/tbody tbody"><tr class="- topic/row"><td class="- topic/entry entry colsep-1 rowsep-1" headers="i2s-interface-design__table_tvg_kkf_fdc__entry__1">功能说明</td><td class="- topic/entry entry colsep-0 rowsep-1" headers="i2s-interface-design__table_tvg_kkf_fdc__entry__2">I2S 通道数量设置</td></tr><tr class="- topic/row"><td class="- topic/entry entry colsep-1 rowsep-1" headers="i2s-interface-design__table_tvg_kkf_fdc__entry__1">参数定义</td><td class="- topic/entry entry colsep-0 rowsep-1" headers="i2s-interface-design__table_tvg_kkf_fdc__entry__2">
<div class="- topic/div div">
<div class="- topic/div div"> i2s指向 aic_i2s_ctrl 的指针</div>
<div class="- topic/div div"> channel指向 i2s_sound_channel_t 的变量,表示要使用的通道</div>
<div class="- topic/div div"> stream音频数据流的方向</div>
</div>
</td></tr><tr class="- topic/row"><td class="- topic/entry entry colsep-1 rowsep-1" headers="i2s-interface-design__table_tvg_kkf_fdc__entry__1">返回值</td><td class="- topic/entry entry colsep-0 rowsep-1" headers="i2s-interface-design__table_tvg_kkf_fdc__entry__2"></td></tr><tr class="- topic/row"><td class="- topic/entry entry colsep-1 rowsep-0" headers="i2s-interface-design__table_tvg_kkf_fdc__entry__1">注意事项</td><td class="- topic/entry entry colsep-0 rowsep-0" headers="i2s-interface-design__table_tvg_kkf_fdc__entry__2">- </td></tr></tbody></table></div>
<div class="table-container"><table class="- topic/table table frame-all" id="i2s-interface-design__table_uvg_kkf_fdc" data-ofbid="i2s-interface-design__table_uvg_kkf_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"> 15</span><span class="table--title-label-punctuation">. </span></span><span class="table--title">hal_i2s_playback_start</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="i2s-interface-design__table_uvg_kkf_fdc__entry__1">函数原型</th><th class="- topic/entry entry colsep-0 rowsep-1" id="i2s-interface-design__table_uvg_kkf_fdc__entry__2">void hal_i2s_playback_start(aic_i2s_ctrl *i2s, i2s_format_t
*format)</th></tr></thead><tbody class="- topic/tbody tbody"><tr class="- topic/row"><td class="- topic/entry entry colsep-1 rowsep-1" headers="i2s-interface-design__table_uvg_kkf_fdc__entry__1">功能说明</td><td class="- topic/entry entry colsep-0 rowsep-1" headers="i2s-interface-design__table_uvg_kkf_fdc__entry__2">开始播放</td></tr><tr class="- topic/row"><td class="- topic/entry entry colsep-1 rowsep-1" headers="i2s-interface-design__table_uvg_kkf_fdc__entry__1">参数定义</td><td class="- topic/entry entry colsep-0 rowsep-1" headers="i2s-interface-design__table_uvg_kkf_fdc__entry__2">
<div class="- topic/div div">
<div class="- topic/div div"> i2s指向 aic_i2s_ctrl 的指针</div>
<div class="- topic/div div"> format指向 i2s_format_t 的指针</div>
</div>
</td></tr><tr class="- topic/row"><td class="- topic/entry entry colsep-1 rowsep-1" headers="i2s-interface-design__table_uvg_kkf_fdc__entry__1">返回值</td><td class="- topic/entry entry colsep-0 rowsep-1" headers="i2s-interface-design__table_uvg_kkf_fdc__entry__2"></td></tr><tr class="- topic/row"><td class="- topic/entry entry colsep-1 rowsep-0" headers="i2s-interface-design__table_uvg_kkf_fdc__entry__1">注意事项</td><td class="- topic/entry entry colsep-0 rowsep-0" headers="i2s-interface-design__table_uvg_kkf_fdc__entry__2">- </td></tr></tbody></table></div>
<div class="table-container"><table class="- topic/table table frame-all" id="i2s-interface-design__table_vvg_kkf_fdc" data-ofbid="i2s-interface-design__table_vvg_kkf_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"> 16</span><span class="table--title-label-punctuation">. </span></span><span class="table--title">hal_i2s_playback_stop</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="i2s-interface-design__table_vvg_kkf_fdc__entry__1">函数原型</th><th class="- topic/entry entry colsep-0 rowsep-1" id="i2s-interface-design__table_vvg_kkf_fdc__entry__2">void hal_i2s_playback_stop(aic_i2s_ctrl *i2s)</th></tr></thead><tbody class="- topic/tbody tbody"><tr class="- topic/row"><td class="- topic/entry entry colsep-1 rowsep-1" headers="i2s-interface-design__table_vvg_kkf_fdc__entry__1">功能说明</td><td class="- topic/entry entry colsep-0 rowsep-1" headers="i2s-interface-design__table_vvg_kkf_fdc__entry__2">停止播放</td></tr><tr class="- topic/row"><td class="- topic/entry entry colsep-1 rowsep-1" headers="i2s-interface-design__table_vvg_kkf_fdc__entry__1">参数定义</td><td class="- topic/entry entry colsep-0 rowsep-1" headers="i2s-interface-design__table_vvg_kkf_fdc__entry__2">
<div class="- topic/div div">
<div class="- topic/div div"> i2s指向 aic_i2s_ctrl 的指针</div>
</div>
</td></tr><tr class="- topic/row"><td class="- topic/entry entry colsep-1 rowsep-1" headers="i2s-interface-design__table_vvg_kkf_fdc__entry__1">返回值</td><td class="- topic/entry entry colsep-0 rowsep-1" headers="i2s-interface-design__table_vvg_kkf_fdc__entry__2"></td></tr><tr class="- topic/row"><td class="- topic/entry entry colsep-1 rowsep-0" headers="i2s-interface-design__table_vvg_kkf_fdc__entry__1">注意事项</td><td class="- topic/entry entry colsep-0 rowsep-0" headers="i2s-interface-design__table_vvg_kkf_fdc__entry__2">-</td></tr></tbody></table></div>
</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="#i2s-interface-design__section_ngf_lzl_4dc" data-tocid="i2s-interface-design__section_ngf_lzl_4dc">Driver 层接口设计</a></div></li><li class="section-item"><div class="section-title"><a href="#i2s-interface-design__section_kzk_lzl_4dc" data-tocid="i2s-interface-design__section_kzk_lzl_4dc">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>