wen/luban-lite
1
0
Fork 0
mirror of https://gitee.com/Vancouver2017/luban-lite.git synced 2025-12-17 09:38:55 +00:00
Code Issues Packages Projects Releases Wiki Activity
Files
b4033d8696b77dddcafce4e00eaaf2a01ccc38fb
luban-lite/doc/topics/sdk/i2c/i2c_interface_lite.html
刘可亮 b4033d8696 add doc v1.1.2
2025-01-23 16:37:00 +08:00

421 lines
93 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 层接口设计 表 1 . aic_hw_i2c_register 函数原型 static int aic_hw_i2c_register() 功能说明 注册和初始化 I2C 设备 参数定义 NULL 返回值 0：注册成功 &lt;0：注册失败 注意事项 - 表 2 . aic_i2c_bus_control 函数原型 static rt_err_t ..."/><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/i2c/i2c_design_lite.html"/><meta name="DC.relation" content="../../../topics/sdk/i2c/i2c_data_struct_2.html"/><meta name="DC.relation" content="../../../topics/sdk/psadc/psadc_user_guide_2.html"/><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="i2c_interface_design_luban_lite"/><meta name="DC.language" content="zh-CN"/><title>接口设计</title><!-- Build number 2023110923. --><meta name="wh-path2root" content="../../../"/><meta name="wh-toc-id" content="i2c_interface_design_luban_lite-d5856e5564"/><meta name="wh-source-relpath" content="topics/sdk/i2c/i2c_interface_lite.dita"/><meta name="wh-out-relpath" content="topics/sdk/i2c/i2c_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="i2c_interface_design_luban_lite" 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="i2c_user_guide"><div class="title"><a href="../../../topics/sdk/i2c/i2c_user_guide_2.html">I2C 使用指南</a></div></div></li><li><div class="topicref" data-id="id"><div class="title"><a href="../../../topics/sdk/i2c/i2c_design_lite.html">设计说明</a></div></div></li><li class="active"><div class="topicref" data-id="i2c_interface_design_luban_lite"><div class="title"><a href="../../../topics/sdk/i2c/i2c_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/i2c/i2c_data_struct_2.html" title="数据结构设计" aria-label="上一主题: 数据结构设计" rel="prev"></a></span>
<span class="navnext"><a class="- topic/link link" href="../../../topics/sdk/psadc/psadc_user_guide_2.html" title="PSADC 使用指南" aria-label="下一主题: PSADC 使用指南" 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="false"><div data-tocid="gpai-user-guide-d5856e5336" class="topicref" data-id="gpai-user-guide" data-state="not-ready"><span role="button" tabindex="0" aria-labelledby="button-expand-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></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="true"><div data-tocid="i2c_user_guide-d5856e5480" class="topicref" data-id="i2c_user_guide" data-state="expanded"><span role="button" tabindex="0" aria-labelledby="button-collapse-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><ul role="group" class="navbar-nav nav-list"><li role="treeitem"><div data-tocid="id-d5856e5492" class="topicref" data-id="id" data-state="leaf"><span role="button" class="wh-expand-btn"></span><div class="title"><a href="../../../topics/sdk/i2c/i2c_config_lite.html" id="id-d5856e5492-link">参数配置</a></div></div></li><li role="treeitem"><div data-tocid="id-d5856e5504" class="topicref" data-id="id" data-state="leaf"><span role="button" class="wh-expand-btn"></span><div class="title"><a href="../../../topics/sdk/i2c/i2c_debug_lite.html" id="id-d5856e5504-link">调试指南</a></div></div></li><li role="treeitem"><div data-tocid="id-d5856e5516" class="topicref" data-id="id" data-state="leaf"><span role="button" class="wh-expand-btn"></span><div class="title"><a href="../../../topics/sdk/i2c/i2c_test_lite.html" id="id-d5856e5516-link">测试指南</a></div></div></li><li role="treeitem" aria-expanded="true"><div data-tocid="id-d5856e5528" class="topicref" data-id="id" data-state="expanded"><span role="button" tabindex="0" aria-labelledby="button-collapse-action id-d5856e5528-link" class="wh-expand-btn"></span><div class="title"><a href="../../../topics/sdk/i2c/i2c_design_lite.html" id="id-d5856e5528-link">设计说明</a></div></div><ul role="group" class="navbar-nav nav-list"><li role="treeitem"><div data-tocid="i2c_key_procedures-d5856e5540" class="topicref" data-id="i2c_key_procedures" data-state="leaf"><span role="button" class="wh-expand-btn"></span><div class="title"><a href="../../../topics/sdk/i2c/i2c_key_procedure_2.html" id="i2c_key_procedures-d5856e5540-link">关键流程设计</a></div></div></li><li role="treeitem"><div data-tocid="i2c_data_structure_design-d5856e5552" class="topicref" data-id="i2c_data_structure_design" data-state="leaf"><span role="button" class="wh-expand-btn"></span><div class="title"><a href="../../../topics/sdk/i2c/i2c_data_struct_2.html" id="i2c_data_structure_design-d5856e5552-link">数据结构设计</a></div></div></li><li role="treeitem" class="active"><div data-tocid="i2c_interface_design_luban_lite-d5856e5564" class="topicref" data-id="i2c_interface_design_luban_lite" data-state="leaf"><span role="button" class="wh-expand-btn"></span><div class="title"><a href="../../../topics/sdk/i2c/i2c_interface_lite.html" id="i2c_interface_design_luban_lite-d5856e5564-link">接口设计</a></div></div></li></ul></li></ul></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 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/i2c/i2c_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: 4 minute(s)
</div><div class="- topic/body concept/conbody body conbody"><section class="- topic/section section" id="i2c_interface_design_luban_lite__section_ssb_5gz_gdc" data-ofbid="i2c_interface_design_luban_lite__section_ssb_5gz_gdc"><h2 class="- topic/title title sectiontitle">Driver 层接口设计</h2>
<div class="table-container"><table class="- topic/table table frame-all" id="i2c_interface_design_luban_lite__table_mkr_wf3_fdc" data-ofbid="i2c_interface_design_luban_lite__table_mkr_wf3_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">aic_hw_i2c_register</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="i2c_interface_design_luban_lite__table_mkr_wf3_fdc__entry__1">函数原型</th><th class="- topic/entry entry colsep-0 rowsep-1" id="i2c_interface_design_luban_lite__table_mkr_wf3_fdc__entry__2">static int aic_hw_i2c_register()</th></tr></thead><tbody class="- topic/tbody tbody"><tr class="- topic/row"><td class="- topic/entry entry colsep-1 rowsep-1" headers="i2c_interface_design_luban_lite__table_mkr_wf3_fdc__entry__1">功能说明</td><td class="- topic/entry entry colsep-0 rowsep-1" headers="i2c_interface_design_luban_lite__table_mkr_wf3_fdc__entry__2">注册和初始化 I2C 设备</td></tr><tr class="- topic/row"><td class="- topic/entry entry colsep-1 rowsep-1" headers="i2c_interface_design_luban_lite__table_mkr_wf3_fdc__entry__1">参数定义</td><td class="- topic/entry entry colsep-0 rowsep-1" headers="i2c_interface_design_luban_lite__table_mkr_wf3_fdc__entry__2">NULL</td></tr><tr class="- topic/row"><td class="- topic/entry entry colsep-1 rowsep-1" headers="i2c_interface_design_luban_lite__table_mkr_wf3_fdc__entry__1">返回值</td><td class="- topic/entry entry colsep-0 rowsep-1" headers="i2c_interface_design_luban_lite__table_mkr_wf3_fdc__entry__2">
<div class="- topic/div div">
<div class="- topic/div div">0：注册成功</div>
<div class="- topic/div div"> &lt;0：注册失败</div>
</div>
</td></tr><tr class="- topic/row"><td class="- topic/entry entry colsep-1 rowsep-0" headers="i2c_interface_design_luban_lite__table_mkr_wf3_fdc__entry__1">注意事项</td><td class="- topic/entry entry colsep-0 rowsep-0" headers="i2c_interface_design_luban_lite__table_mkr_wf3_fdc__entry__2">- </td></tr></tbody></table></div>
<div class="table-container"><table class="- topic/table table frame-all" id="i2c_interface_design_luban_lite__table_nkr_wf3_fdc" data-ofbid="i2c_interface_design_luban_lite__table_nkr_wf3_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">aic_i2c_bus_control</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="i2c_interface_design_luban_lite__table_nkr_wf3_fdc__entry__1">函数原型</th><th class="- topic/entry entry colsep-0 rowsep-1" id="i2c_interface_design_luban_lite__table_nkr_wf3_fdc__entry__2">static rt_err_t aic_i2c_bus_control(struct rt_i2c_bus_device
*bus, rt_uint32_t cmd, rt_uint32_t value)</th></tr></thead><tbody class="- topic/tbody tbody"><tr class="- topic/row"><td class="- topic/entry entry colsep-1 rowsep-1" headers="i2c_interface_design_luban_lite__table_nkr_wf3_fdc__entry__1">功能说明</td><td class="- topic/entry entry colsep-0 rowsep-1" headers="i2c_interface_design_luban_lite__table_nkr_wf3_fdc__entry__2">对 I2C 总线参数进行设置，目前支持更改总线速率</td></tr><tr class="- topic/row"><td class="- topic/entry entry colsep-1 rowsep-1" headers="i2c_interface_design_luban_lite__table_nkr_wf3_fdc__entry__1">参数定义</td><td class="- topic/entry entry colsep-0 rowsep-1" headers="i2c_interface_design_luban_lite__table_nkr_wf3_fdc__entry__2">
<div class="- topic/div div">
<div class="- topic/div div">bus：I2C 接口对应的总线指针</div>
<div class="- topic/div div">cmd：命令参数</div>
<div class="- topic/div div">value：命令值</div>
</div>
</td></tr><tr class="- topic/row"><td class="- topic/entry entry colsep-1 rowsep-1" headers="i2c_interface_design_luban_lite__table_nkr_wf3_fdc__entry__1">返回值</td><td class="- topic/entry entry colsep-0 rowsep-1" headers="i2c_interface_design_luban_lite__table_nkr_wf3_fdc__entry__2">
<div class="- topic/div div">
<div class="- topic/div div"> RT_EOK：函数执行成功</div>
<div class="- topic/div div"> -RT_EIO：非法操作</div>
</div>
</td></tr><tr class="- topic/row"><td class="- topic/entry entry colsep-1 rowsep-0" headers="i2c_interface_design_luban_lite__table_nkr_wf3_fdc__entry__1">注意事项</td><td class="- topic/entry entry colsep-0 rowsep-0" headers="i2c_interface_design_luban_lite__table_nkr_wf3_fdc__entry__2">- </td></tr></tbody></table></div>
<div class="table-container"><table class="- topic/table table frame-all" id="i2c_interface_design_luban_lite__table_okr_wf3_fdc" data-ofbid="i2c_interface_design_luban_lite__table_okr_wf3_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">aic_i2c_slave_control</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="i2c_interface_design_luban_lite__table_okr_wf3_fdc__entry__1">函数原型</th><th class="- topic/entry entry colsep-0 rowsep-1" id="i2c_interface_design_luban_lite__table_okr_wf3_fdc__entry__2">static rt_err_t aic_i2c_slave_control(struct rt_i2c_bus_device
*bus, rt_uint32_t cmd, void *arg)</th></tr></thead><tbody class="- topic/tbody tbody"><tr class="- topic/row"><td class="- topic/entry entry colsep-1 rowsep-1" headers="i2c_interface_design_luban_lite__table_okr_wf3_fdc__entry__1">功能说明</td><td class="- topic/entry entry colsep-0 rowsep-1" headers="i2c_interface_design_luban_lite__table_okr_wf3_fdc__entry__2">对 I2C 从机回调函数进行配置</td></tr><tr class="- topic/row"><td class="- topic/entry entry colsep-1 rowsep-1" headers="i2c_interface_design_luban_lite__table_okr_wf3_fdc__entry__1">参数定义</td><td class="- topic/entry entry colsep-0 rowsep-1" headers="i2c_interface_design_luban_lite__table_okr_wf3_fdc__entry__2">
<div class="- topic/div div">
<div class="- topic/div div">bus：I2C 接口对应的总线指针</div>
<div class="- topic/div div">cmd：命令参数</div>
<div class="- topic/div div"> arg：回调函数参数</div>
</div>
</td></tr><tr class="- topic/row"><td class="- topic/entry entry colsep-1 rowsep-1" headers="i2c_interface_design_luban_lite__table_okr_wf3_fdc__entry__1">返回值</td><td class="- topic/entry entry colsep-0 rowsep-1" headers="i2c_interface_design_luban_lite__table_okr_wf3_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="i2c_interface_design_luban_lite__table_okr_wf3_fdc__entry__1">注意事项</td><td class="- topic/entry entry colsep-0 rowsep-0" headers="i2c_interface_design_luban_lite__table_okr_wf3_fdc__entry__2">- </td></tr></tbody></table></div>
<div class="table-container"><table class="- topic/table table frame-all" id="i2c_interface_design_luban_lite__table_pkr_wf3_fdc" data-ofbid="i2c_interface_design_luban_lite__table_pkr_wf3_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">aic_i2c_master_xfer</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="i2c_interface_design_luban_lite__table_pkr_wf3_fdc__entry__1">函数原型</th><th class="- topic/entry entry colsep-0 rowsep-1" id="i2c_interface_design_luban_lite__table_pkr_wf3_fdc__entry__2">static rt_size_t aic_i2c_master_xfer(struct rt_i2c_bus_device
*bus, struct rt_i2c_msg msgs[], rt_uint32_t num)</th></tr></thead><tbody class="- topic/tbody tbody"><tr class="- topic/row"><td class="- topic/entry entry colsep-1 rowsep-1" headers="i2c_interface_design_luban_lite__table_pkr_wf3_fdc__entry__1">功能说明</td><td class="- topic/entry entry colsep-0 rowsep-1" headers="i2c_interface_design_luban_lite__table_pkr_wf3_fdc__entry__2">I2C 数据传输函数</td></tr><tr class="- topic/row"><td class="- topic/entry entry colsep-1 rowsep-1" headers="i2c_interface_design_luban_lite__table_pkr_wf3_fdc__entry__1">参数定义</td><td class="- topic/entry entry colsep-0 rowsep-1" headers="i2c_interface_design_luban_lite__table_pkr_wf3_fdc__entry__2">
<div class="- topic/div div">
<div class="- topic/div div">bus：I2C 接口对应的总线指针</div>
<div class="- topic/div div">msgs： 发送的消息数组</div>
<div class="- topic/div div">num： 发送的消息数量</div>
</div>
</td></tr><tr class="- topic/row"><td class="- topic/entry entry colsep-1 rowsep-1" headers="i2c_interface_design_luban_lite__table_pkr_wf3_fdc__entry__1">返回值</td><td class="- topic/entry entry colsep-0 rowsep-1" headers="i2c_interface_design_luban_lite__table_pkr_wf3_fdc__entry__2">返回已发出的消息数量</td></tr><tr class="- topic/row"><td class="- topic/entry entry colsep-1 rowsep-0" headers="i2c_interface_design_luban_lite__table_pkr_wf3_fdc__entry__1">注意事项</td><td class="- topic/entry entry colsep-0 rowsep-0" headers="i2c_interface_design_luban_lite__table_pkr_wf3_fdc__entry__2">- </td></tr></tbody></table></div>
<div class="table-container"><table class="- topic/table table frame-all" id="i2c_interface_design_luban_lite__table_qkr_wf3_fdc" data-ofbid="i2c_interface_design_luban_lite__table_qkr_wf3_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">aic_i2c_xfer_msg</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="i2c_interface_design_luban_lite__table_qkr_wf3_fdc__entry__1">函数原型</th><th class="- topic/entry entry colsep-0 rowsep-1" id="i2c_interface_design_luban_lite__table_qkr_wf3_fdc__entry__2">static int aic_i2c_xfer_msg(struct aic_i2c_ctrl *i2c_dev, struct
aic_i2c_msg *msg, bool is_first, bool is_last)</th></tr></thead><tbody class="- topic/tbody tbody"><tr class="- topic/row"><td class="- topic/entry entry colsep-1 rowsep-1" headers="i2c_interface_design_luban_lite__table_qkr_wf3_fdc__entry__1">功能说明</td><td class="- topic/entry entry colsep-0 rowsep-1" headers="i2c_interface_design_luban_lite__table_qkr_wf3_fdc__entry__2">I2C 数据传输函数</td></tr><tr class="- topic/row"><td class="- topic/entry entry colsep-1 rowsep-1" headers="i2c_interface_design_luban_lite__table_qkr_wf3_fdc__entry__1">参数定义</td><td class="- topic/entry entry colsep-0 rowsep-1" headers="i2c_interface_design_luban_lite__table_qkr_wf3_fdc__entry__2">
<div class="- topic/div div">
<div class="- topic/div div"> i2c_dev：指向自定义的 aic_i2c_ctrl 结构体</div>
<div class="- topic/div div"> msg：指向当前将要传输的 msg | is_first：指示当前 msg 是否是第一个 msg |
is_last：指示当前 msg 是否是最后一个 msg</div>
</div>
</td></tr><tr class="- topic/row"><td class="- topic/entry entry colsep-1 rowsep-1" headers="i2c_interface_design_luban_lite__table_qkr_wf3_fdc__entry__1">返回值</td><td class="- topic/entry entry colsep-0 rowsep-1" headers="i2c_interface_design_luban_lite__table_qkr_wf3_fdc__entry__2">
<div class="- topic/div div">
<div class="- topic/div div">0：执行成功</div>
<div class="- topic/div div"> &lt;0：执行过程中发生错误</div>
</div>
</td></tr><tr class="- topic/row"><td class="- topic/entry entry colsep-1 rowsep-0" headers="i2c_interface_design_luban_lite__table_qkr_wf3_fdc__entry__1">注意事项</td><td class="- topic/entry entry colsep-0 rowsep-0" headers="i2c_interface_design_luban_lite__table_qkr_wf3_fdc__entry__2">- </td></tr></tbody></table></div>
<div class="table-container"><table class="- topic/table table frame-all" id="i2c_interface_design_luban_lite__table_rkr_wf3_fdc" data-ofbid="i2c_interface_design_luban_lite__table_rkr_wf3_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">aic_i2c_xfer_msg_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="i2c_interface_design_luban_lite__table_rkr_wf3_fdc__entry__1">函数原型</th><th class="- topic/entry entry colsep-0 rowsep-1" id="i2c_interface_design_luban_lite__table_rkr_wf3_fdc__entry__2">static void aic_i2c_xfer_msg_init(struct aic_i2c_ctrl
*i2c_dev)</th></tr></thead><tbody class="- topic/tbody tbody"><tr class="- topic/row"><td class="- topic/entry entry colsep-1 rowsep-1" headers="i2c_interface_design_luban_lite__table_rkr_wf3_fdc__entry__1">功能说明</td><td class="- topic/entry entry colsep-0 rowsep-1" headers="i2c_interface_design_luban_lite__table_rkr_wf3_fdc__entry__2"> 在传输每个 msg 前进行的初始化，主要是将指示每个 msg 状态的变量设置为初始值，使能中断</td></tr><tr class="- topic/row"><td class="- topic/entry entry colsep-1 rowsep-1" headers="i2c_interface_design_luban_lite__table_rkr_wf3_fdc__entry__1">参数定义</td><td class="- topic/entry entry colsep-0 rowsep-1" headers="i2c_interface_design_luban_lite__table_rkr_wf3_fdc__entry__2">
<div class="- topic/div div">
<div class="- topic/div div"> i2c_dev：指向自定义的 aic_i2c_ctrl 结构体</div>
</div>
</td></tr><tr class="- topic/row"><td class="- topic/entry entry colsep-1 rowsep-1" headers="i2c_interface_design_luban_lite__table_rkr_wf3_fdc__entry__1">返回值</td><td class="- topic/entry entry colsep-0 rowsep-1" headers="i2c_interface_design_luban_lite__table_rkr_wf3_fdc__entry__2">无</td></tr><tr class="- topic/row"><td class="- topic/entry entry colsep-1 rowsep-0" headers="i2c_interface_design_luban_lite__table_rkr_wf3_fdc__entry__1">注意事项</td><td class="- topic/entry entry colsep-0 rowsep-0" headers="i2c_interface_design_luban_lite__table_rkr_wf3_fdc__entry__2">- </td></tr></tbody></table></div>
<div class="table-container"><table class="- topic/table table frame-all" id="i2c_interface_design_luban_lite__table_skr_wf3_fdc" data-ofbid="i2c_interface_design_luban_lite__table_skr_wf3_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">aic_i2c_handle_write</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="i2c_interface_design_luban_lite__table_skr_wf3_fdc__entry__1">函数原型</th><th class="- topic/entry entry colsep-0 rowsep-1" id="i2c_interface_design_luban_lite__table_skr_wf3_fdc__entry__2">static void aic_i2c_handle_write(struct aic_i2c_ctrl
*i2c_dev)</th></tr></thead><tbody class="- topic/tbody tbody"><tr class="- topic/row"><td class="- topic/entry entry colsep-1 rowsep-1" headers="i2c_interface_design_luban_lite__table_skr_wf3_fdc__entry__1">功能说明</td><td class="- topic/entry entry colsep-0 rowsep-1" headers="i2c_interface_design_luban_lite__table_skr_wf3_fdc__entry__2"> 当触发 TX_EMPTY 中断时，调用该函数。若是读 msg，则调用该函数发送读命令，若是写
msg，则调用该函数发送数据</td></tr><tr class="- topic/row"><td class="- topic/entry entry colsep-1 rowsep-1" headers="i2c_interface_design_luban_lite__table_skr_wf3_fdc__entry__1">参数定义</td><td class="- topic/entry entry colsep-0 rowsep-1" headers="i2c_interface_design_luban_lite__table_skr_wf3_fdc__entry__2">
<div class="- topic/div div">
<div class="- topic/div div"> i2c_dev：指向自定义的 aic_i2c_ctrl 结构体</div>
</div>
</td></tr><tr class="- topic/row"><td class="- topic/entry entry colsep-1 rowsep-1" headers="i2c_interface_design_luban_lite__table_skr_wf3_fdc__entry__1">返回值</td><td class="- topic/entry entry colsep-0 rowsep-1" headers="i2c_interface_design_luban_lite__table_skr_wf3_fdc__entry__2">无</td></tr><tr class="- topic/row"><td class="- topic/entry entry colsep-1 rowsep-0" headers="i2c_interface_design_luban_lite__table_skr_wf3_fdc__entry__1">注意事项</td><td class="- topic/entry entry colsep-0 rowsep-0" headers="i2c_interface_design_luban_lite__table_skr_wf3_fdc__entry__2">- </td></tr></tbody></table></div>
<div class="table-container"><table class="- topic/table table frame-all" id="i2c_interface_design_luban_lite__table_tkr_wf3_fdc" data-ofbid="i2c_interface_design_luban_lite__table_tkr_wf3_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">aic_i2c_handle_read</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="i2c_interface_design_luban_lite__table_tkr_wf3_fdc__entry__1">函数原型</th><th class="- topic/entry entry colsep-0 rowsep-1" id="i2c_interface_design_luban_lite__table_tkr_wf3_fdc__entry__2">static void aic_i2c_handle_read(struct aic_i2c_ctrl
*i2c_dev)</th></tr></thead><tbody class="- topic/tbody tbody"><tr class="- topic/row"><td class="- topic/entry entry colsep-1 rowsep-1" headers="i2c_interface_design_luban_lite__table_tkr_wf3_fdc__entry__1">功能说明</td><td class="- topic/entry entry colsep-0 rowsep-1" headers="i2c_interface_design_luban_lite__table_tkr_wf3_fdc__entry__2"> 当触发 RX_FULL 中断时，调用该函数读取接收到的数据，若完成当前 msg 的接收，则释放完成量</td></tr><tr class="- topic/row"><td class="- topic/entry entry colsep-1 rowsep-1" headers="i2c_interface_design_luban_lite__table_tkr_wf3_fdc__entry__1">参数定义</td><td class="- topic/entry entry colsep-0 rowsep-1" headers="i2c_interface_design_luban_lite__table_tkr_wf3_fdc__entry__2">
<div class="- topic/div div">
<div class="- topic/div div"> i2c_dev：指向自定义的 aic_i2c_ctrl 结构体</div>
</div>
</td></tr><tr class="- topic/row"><td class="- topic/entry entry colsep-1 rowsep-1" headers="i2c_interface_design_luban_lite__table_tkr_wf3_fdc__entry__1">返回值</td><td class="- topic/entry entry colsep-0 rowsep-1" headers="i2c_interface_design_luban_lite__table_tkr_wf3_fdc__entry__2">无</td></tr><tr class="- topic/row"><td class="- topic/entry entry colsep-1 rowsep-0" headers="i2c_interface_design_luban_lite__table_tkr_wf3_fdc__entry__1">注意事项</td><td class="- topic/entry entry colsep-0 rowsep-0" headers="i2c_interface_design_luban_lite__table_tkr_wf3_fdc__entry__2">-</td></tr></tbody></table></div>
</section><section class="- topic/section section" id="i2c_interface_design_luban_lite__section_rdk_vgz_gdc" data-ofbid="i2c_interface_design_luban_lite__section_rdk_vgz_gdc"><h2 class="- topic/title title sectiontitle">HAL 层接口设计</h2>
<div class="table-container"><table class="- topic/table table frame-all" id="i2c_interface_design_luban_lite__table_ukr_wf3_fdc" data-ofbid="i2c_interface_design_luban_lite__table_ukr_wf3_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_i2c_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="i2c_interface_design_luban_lite__table_ukr_wf3_fdc__entry__1">函数原型</th><th class="- topic/entry entry colsep-0 rowsep-1" id="i2c_interface_design_luban_lite__table_ukr_wf3_fdc__entry__2">int hal_i2c_init(aic_i2c_ctrl *i2c_dev)</th></tr></thead><tbody class="- topic/tbody tbody"><tr class="- topic/row"><td class="- topic/entry entry colsep-1 rowsep-1" headers="i2c_interface_design_luban_lite__table_ukr_wf3_fdc__entry__1">功能说明</td><td class="- topic/entry entry colsep-0 rowsep-1" headers="i2c_interface_design_luban_lite__table_ukr_wf3_fdc__entry__2">初始化 I2C 的时钟，主从模式，速率等基础设置</td></tr><tr class="- topic/row"><td class="- topic/entry entry colsep-1 rowsep-1" headers="i2c_interface_design_luban_lite__table_ukr_wf3_fdc__entry__1">参数定义</td><td class="- topic/entry entry colsep-0 rowsep-1" headers="i2c_interface_design_luban_lite__table_ukr_wf3_fdc__entry__2">
<div class="- topic/div div">
<div class="- topic/div div"> i2c_dev：指向自定义的 aic_i2c_ctrl 结构体</div>
</div>
</td></tr><tr class="- topic/row"><td class="- topic/entry entry colsep-1 rowsep-1" headers="i2c_interface_design_luban_lite__table_ukr_wf3_fdc__entry__1">返回值</td><td class="- topic/entry entry colsep-0 rowsep-1" headers="i2c_interface_design_luban_lite__table_ukr_wf3_fdc__entry__2">
<div class="- topic/div div">
<div class="- topic/div div">0：执行成功</div>
<div class="- topic/div div"> &lt;0：执行过程中发生错误</div>
</div>
</td></tr><tr class="- topic/row"><td class="- topic/entry entry colsep-1 rowsep-0" headers="i2c_interface_design_luban_lite__table_ukr_wf3_fdc__entry__1">注意事项</td><td class="- topic/entry entry colsep-0 rowsep-0" headers="i2c_interface_design_luban_lite__table_ukr_wf3_fdc__entry__2">- </td></tr></tbody></table></div>
<div class="table-container"><table class="- topic/table table frame-all" id="i2c_interface_design_luban_lite__table_vkr_wf3_fdc" data-ofbid="i2c_interface_design_luban_lite__table_vkr_wf3_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_i2c_clk_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="i2c_interface_design_luban_lite__table_vkr_wf3_fdc__entry__1">函数原型</th><th class="- topic/entry entry colsep-0 rowsep-1" id="i2c_interface_design_luban_lite__table_vkr_wf3_fdc__entry__2">int hal_i2c_clk_init(aic_i2c_ctrl *i2c_dev)</th></tr></thead><tbody class="- topic/tbody tbody"><tr class="- topic/row"><td class="- topic/entry entry colsep-1 rowsep-1" headers="i2c_interface_design_luban_lite__table_vkr_wf3_fdc__entry__1">功能说明</td><td class="- topic/entry entry colsep-0 rowsep-1" headers="i2c_interface_design_luban_lite__table_vkr_wf3_fdc__entry__2">初始化 I2C 的时钟</td></tr><tr class="- topic/row"><td class="- topic/entry entry colsep-1 rowsep-1" headers="i2c_interface_design_luban_lite__table_vkr_wf3_fdc__entry__1">参数定义</td><td class="- topic/entry entry colsep-0 rowsep-1" headers="i2c_interface_design_luban_lite__table_vkr_wf3_fdc__entry__2">
<div class="- topic/div div">
<div class="- topic/div div"> i2c_dev：指向自定义的 aic_i2c_ctrl 结构体</div>
</div>
</td></tr><tr class="- topic/row"><td class="- topic/entry entry colsep-1 rowsep-1" headers="i2c_interface_design_luban_lite__table_vkr_wf3_fdc__entry__1">返回值</td><td class="- topic/entry entry colsep-0 rowsep-1" headers="i2c_interface_design_luban_lite__table_vkr_wf3_fdc__entry__2">
<div class="- topic/div div">
<div class="- topic/div div">0：执行成功</div>
<div class="- topic/div div"> &lt;0：执行过程中发生错误</div>
</div>
</td></tr><tr class="- topic/row"><td class="- topic/entry entry colsep-1 rowsep-0" headers="i2c_interface_design_luban_lite__table_vkr_wf3_fdc__entry__1">注意事项</td><td class="- topic/entry entry colsep-0 rowsep-0" headers="i2c_interface_design_luban_lite__table_vkr_wf3_fdc__entry__2">- </td></tr></tbody></table></div>
<div class="table-container"><table class="- topic/table table frame-all" id="i2c_interface_design_luban_lite__table_wkr_wf3_fdc" data-ofbid="i2c_interface_design_luban_lite__table_wkr_wf3_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_i2c_set_hold</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="i2c_interface_design_luban_lite__table_wkr_wf3_fdc__entry__1">函数原型</th><th class="- topic/entry entry colsep-0 rowsep-1" id="i2c_interface_design_luban_lite__table_wkr_wf3_fdc__entry__2">void hal_i2c_set_hold(aic_i2c_ctrl *i2c_dev, u32 val)</th></tr></thead><tbody class="- topic/tbody tbody"><tr class="- topic/row"><td class="- topic/entry entry colsep-1 rowsep-1" headers="i2c_interface_design_luban_lite__table_wkr_wf3_fdc__entry__1">功能说明</td><td class="- topic/entry entry colsep-0 rowsep-1" headers="i2c_interface_design_luban_lite__table_wkr_wf3_fdc__entry__2">设置 SDA 的保持时间</td></tr><tr class="- topic/row"><td class="- topic/entry entry colsep-1 rowsep-1" headers="i2c_interface_design_luban_lite__table_wkr_wf3_fdc__entry__1">参数定义</td><td class="- topic/entry entry colsep-0 rowsep-1" headers="i2c_interface_design_luban_lite__table_wkr_wf3_fdc__entry__2">
<div class="- topic/div div">
<div class="- topic/div div"> i2c_dev：指向自定义的 aic_i2c_ctrl 结构体 | val：设置保持时间的 cycle
数量，保持时间：val*41.66 ns</div>
</div>
</td></tr><tr class="- topic/row"><td class="- topic/entry entry colsep-1 rowsep-1" headers="i2c_interface_design_luban_lite__table_wkr_wf3_fdc__entry__1">返回值</td><td class="- topic/entry entry colsep-0 rowsep-1" headers="i2c_interface_design_luban_lite__table_wkr_wf3_fdc__entry__2">无</td></tr><tr class="- topic/row"><td class="- topic/entry entry colsep-1 rowsep-0" headers="i2c_interface_design_luban_lite__table_wkr_wf3_fdc__entry__1">注意事项</td><td class="- topic/entry entry colsep-0 rowsep-0" headers="i2c_interface_design_luban_lite__table_wkr_wf3_fdc__entry__2">- </td></tr></tbody></table></div>
<div class="table-container"><table class="- topic/table table frame-all" id="i2c_interface_design_luban_lite__table_xkr_wf3_fdc" data-ofbid="i2c_interface_design_luban_lite__table_xkr_wf3_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_i2c_set_master_slave_mode</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="i2c_interface_design_luban_lite__table_xkr_wf3_fdc__entry__1">函数原型</th><th class="- topic/entry entry colsep-0 rowsep-1" id="i2c_interface_design_luban_lite__table_xkr_wf3_fdc__entry__2">int hal_i2c_set_master_slave_mode(aic_i2c_ctrl *i2c_dev)</th></tr></thead><tbody class="- topic/tbody tbody"><tr class="- topic/row"><td class="- topic/entry entry colsep-1 rowsep-1" headers="i2c_interface_design_luban_lite__table_xkr_wf3_fdc__entry__1">功能说明</td><td class="- topic/entry entry colsep-0 rowsep-1" headers="i2c_interface_design_luban_lite__table_xkr_wf3_fdc__entry__2">设置主从模式</td></tr><tr class="- topic/row"><td class="- topic/entry entry colsep-1 rowsep-1" headers="i2c_interface_design_luban_lite__table_xkr_wf3_fdc__entry__1">参数定义</td><td class="- topic/entry entry colsep-0 rowsep-1" headers="i2c_interface_design_luban_lite__table_xkr_wf3_fdc__entry__2">
<div class="- topic/div div">
<div class="- topic/div div"> i2c_dev：指向自定义的 aic_i2c_ctrl 结构体</div>
</div>
</td></tr><tr class="- topic/row"><td class="- topic/entry entry colsep-1 rowsep-1" headers="i2c_interface_design_luban_lite__table_xkr_wf3_fdc__entry__1">返回值</td><td class="- topic/entry entry colsep-0 rowsep-1" headers="i2c_interface_design_luban_lite__table_xkr_wf3_fdc__entry__2">
<div class="- topic/div div">
<div class="- topic/div div">0：执行成功</div>
<div class="- topic/div div"> &lt;0：执行过程中发生错误</div>
</div>
</td></tr><tr class="- topic/row"><td class="- topic/entry entry colsep-1 rowsep-0" headers="i2c_interface_design_luban_lite__table_xkr_wf3_fdc__entry__1">注意事项</td><td class="- topic/entry entry colsep-0 rowsep-0" headers="i2c_interface_design_luban_lite__table_xkr_wf3_fdc__entry__2">- </td></tr></tbody></table></div>
<div class="table-container"><table class="- topic/table table frame-all" id="i2c_interface_design_luban_lite__table_ykr_wf3_fdc" data-ofbid="i2c_interface_design_luban_lite__table_ykr_wf3_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_i2c_master_10bit_addr</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="i2c_interface_design_luban_lite__table_ykr_wf3_fdc__entry__1">函数原型</th><th class="- topic/entry entry colsep-0 rowsep-1" id="i2c_interface_design_luban_lite__table_ykr_wf3_fdc__entry__2">int hal_i2c_master_10bit_addr(aic_i2c_ctrl *i2c_dev)</th></tr></thead><tbody class="- topic/tbody tbody"><tr class="- topic/row"><td class="- topic/entry entry colsep-1 rowsep-1" headers="i2c_interface_design_luban_lite__table_ykr_wf3_fdc__entry__1">功能说明</td><td class="- topic/entry entry colsep-0 rowsep-1" headers="i2c_interface_design_luban_lite__table_ykr_wf3_fdc__entry__2">设置主机模式的寻址模式</td></tr><tr class="- topic/row"><td class="- topic/entry entry colsep-1 rowsep-1" headers="i2c_interface_design_luban_lite__table_ykr_wf3_fdc__entry__1">参数定义</td><td class="- topic/entry entry colsep-0 rowsep-1" headers="i2c_interface_design_luban_lite__table_ykr_wf3_fdc__entry__2">
<div class="- topic/div div">
<div class="- topic/div div"> i2c_dev：指向自定义的 aic_i2c_ctrl 结构体</div>
</div>
</td></tr><tr class="- topic/row"><td class="- topic/entry entry colsep-1 rowsep-1" headers="i2c_interface_design_luban_lite__table_ykr_wf3_fdc__entry__1">返回值</td><td class="- topic/entry entry colsep-0 rowsep-1" headers="i2c_interface_design_luban_lite__table_ykr_wf3_fdc__entry__2">
<div class="- topic/div div">
<div class="- topic/div div">0：执行成功</div>
<div class="- topic/div div"> &lt;0：执行过程中发生错误</div>
</div>
</td></tr><tr class="- topic/row"><td class="- topic/entry entry colsep-1 rowsep-0" headers="i2c_interface_design_luban_lite__table_ykr_wf3_fdc__entry__1">注意事项</td><td class="- topic/entry entry colsep-0 rowsep-0" headers="i2c_interface_design_luban_lite__table_ykr_wf3_fdc__entry__2">- </td></tr></tbody></table></div>
<div class="table-container"><table class="- topic/table table frame-all" id="i2c_interface_design_luban_lite__table_zkr_wf3_fdc" data-ofbid="i2c_interface_design_luban_lite__table_zkr_wf3_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_i2c_slave_10bit_addr</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="i2c_interface_design_luban_lite__table_zkr_wf3_fdc__entry__1">函数原型</th><th class="- topic/entry entry colsep-0 rowsep-1" id="i2c_interface_design_luban_lite__table_zkr_wf3_fdc__entry__2">int hal_i2c_slave_10bit_addr(aic_i2c_ctrl *i2c_dev)</th></tr></thead><tbody class="- topic/tbody tbody"><tr class="- topic/row"><td class="- topic/entry entry colsep-1 rowsep-1" headers="i2c_interface_design_luban_lite__table_zkr_wf3_fdc__entry__1">功能说明</td><td class="- topic/entry entry colsep-0 rowsep-1" headers="i2c_interface_design_luban_lite__table_zkr_wf3_fdc__entry__2">设置从机模式的寻址模式</td></tr><tr class="- topic/row"><td class="- topic/entry entry colsep-1 rowsep-1" headers="i2c_interface_design_luban_lite__table_zkr_wf3_fdc__entry__1">参数定义</td><td class="- topic/entry entry colsep-0 rowsep-1" headers="i2c_interface_design_luban_lite__table_zkr_wf3_fdc__entry__2">
<div class="- topic/div div">
<div class="- topic/div div"> i2c_dev：指向自定义的 aic_i2c_ctrl 结构体</div>
</div>
</td></tr><tr class="- topic/row"><td class="- topic/entry entry colsep-1 rowsep-1" headers="i2c_interface_design_luban_lite__table_zkr_wf3_fdc__entry__1">返回值</td><td class="- topic/entry entry colsep-0 rowsep-1" headers="i2c_interface_design_luban_lite__table_zkr_wf3_fdc__entry__2">
<div class="- topic/div div">
<div class="- topic/div div">0：执行成功</div>
<div class="- topic/div div"> &lt;0：执行过程中发生错误</div>
</div>
</td></tr><tr class="- topic/row"><td class="- topic/entry entry colsep-1 rowsep-0" headers="i2c_interface_design_luban_lite__table_zkr_wf3_fdc__entry__1">注意事项</td><td class="- topic/entry entry colsep-0 rowsep-0" headers="i2c_interface_design_luban_lite__table_zkr_wf3_fdc__entry__2">- </td></tr></tbody></table></div>
<div class="table-container"><table class="- topic/table table frame-all" id="i2c_interface_design_luban_lite__table_alr_wf3_fdc" data-ofbid="i2c_interface_design_luban_lite__table_alr_wf3_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_i2c_scl_cnt</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="i2c_interface_design_luban_lite__table_alr_wf3_fdc__entry__1">函数原型</th><th class="- topic/entry entry colsep-0 rowsep-1" id="i2c_interface_design_luban_lite__table_alr_wf3_fdc__entry__2">static int hal_i2c_scl_cnt(uint32_t clk_freq, uint8_t
is_standard_speed, uint16_t *hcnt, uint16_t *lcnt)</th></tr></thead><tbody class="- topic/tbody tbody"><tr class="- topic/row"><td class="- topic/entry entry colsep-1 rowsep-1" headers="i2c_interface_design_luban_lite__table_alr_wf3_fdc__entry__1">功能说明</td><td class="- topic/entry entry colsep-0 rowsep-1" headers="i2c_interface_design_luban_lite__table_alr_wf3_fdc__entry__2"> 根据 i2c 模块工作的时钟频率和 i2c 的传输速率，返回需要设置的 hcnt 值和 lcnt 值</td></tr><tr class="- topic/row"><td class="- topic/entry entry colsep-1 rowsep-1" headers="i2c_interface_design_luban_lite__table_alr_wf3_fdc__entry__1">参数定义</td><td class="- topic/entry entry colsep-0 rowsep-1" headers="i2c_interface_design_luban_lite__table_alr_wf3_fdc__entry__2">
<div class="- topic/div div">
<div class="- topic/div div"> i2c_dev：指向自定义的 aic_i2c_ctrl 结构体</div>
</div>
</td></tr><tr class="- topic/row"><td class="- topic/entry entry colsep-1 rowsep-1" headers="i2c_interface_design_luban_lite__table_alr_wf3_fdc__entry__1">返回值</td><td class="- topic/entry entry colsep-0 rowsep-1" headers="i2c_interface_design_luban_lite__table_alr_wf3_fdc__entry__2">
<div class="- topic/div div">
<div class="- topic/div div">0：执行成功</div>
<div class="- topic/div div"> &lt;0：执行过程中发生错误</div>
</div>
</td></tr><tr class="- topic/row"><td class="- topic/entry entry colsep-1 rowsep-0" headers="i2c_interface_design_luban_lite__table_alr_wf3_fdc__entry__1">注意事项</td><td class="- topic/entry entry colsep-0 rowsep-0" headers="i2c_interface_design_luban_lite__table_alr_wf3_fdc__entry__2">- </td></tr></tbody></table></div>
<div class="table-container"><table class="- topic/table table frame-all" id="i2c_interface_design_luban_lite__table_blr_wf3_fdc" data-ofbid="i2c_interface_design_luban_lite__table_blr_wf3_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_i2c_speed_mode_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="i2c_interface_design_luban_lite__table_blr_wf3_fdc__entry__1">函数原型</th><th class="- topic/entry entry colsep-0 rowsep-1" id="i2c_interface_design_luban_lite__table_blr_wf3_fdc__entry__2">int hal_i2c_speed_mode_select(aic_i2c_ctrl *i2c_dev, uint32_t
clk_freq, uint8_t mode)</th></tr></thead><tbody class="- topic/tbody tbody"><tr class="- topic/row"><td class="- topic/entry entry colsep-1 rowsep-1" headers="i2c_interface_design_luban_lite__table_blr_wf3_fdc__entry__1">功能说明</td><td class="- topic/entry entry colsep-0 rowsep-1" headers="i2c_interface_design_luban_lite__table_blr_wf3_fdc__entry__2">设置 I2C 的传输的工作模式和传输速率</td></tr><tr class="- topic/row"><td class="- topic/entry entry colsep-1 rowsep-1" headers="i2c_interface_design_luban_lite__table_blr_wf3_fdc__entry__1">参数定义</td><td class="- topic/entry entry colsep-0 rowsep-1" headers="i2c_interface_design_luban_lite__table_blr_wf3_fdc__entry__2">
<div class="- topic/div div">
<div class="- topic/div div"> i2c_dev：指向自定义的 aic_i2c_ctrl 结构体 | clk_freq：模块时钟的时钟频率 |
mode：工作模式</div>
</div>
</td></tr><tr class="- topic/row"><td class="- topic/entry entry colsep-1 rowsep-1" headers="i2c_interface_design_luban_lite__table_blr_wf3_fdc__entry__1">返回值</td><td class="- topic/entry entry colsep-0 rowsep-1" headers="i2c_interface_design_luban_lite__table_blr_wf3_fdc__entry__2">
<div class="- topic/div div">
<div class="- topic/div div">0：执行成功</div>
<div class="- topic/div div"> &lt;0：执行过程中发生错误</div>
</div>
</td></tr><tr class="- topic/row"><td class="- topic/entry entry colsep-1 rowsep-0" headers="i2c_interface_design_luban_lite__table_blr_wf3_fdc__entry__1">注意事项</td><td class="- topic/entry entry colsep-0 rowsep-0" headers="i2c_interface_design_luban_lite__table_blr_wf3_fdc__entry__2">- </td></tr></tbody></table></div>
<div class="table-container"><table class="- topic/table table frame-all" id="i2c_interface_design_luban_lite__table_clr_wf3_fdc" data-ofbid="i2c_interface_design_luban_lite__table_clr_wf3_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"> 17</span><span class="table--title-label-punctuation">. </span></span><span class="table--title">hal_i2c_target_addr</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="i2c_interface_design_luban_lite__table_clr_wf3_fdc__entry__1">函数原型</th><th class="- topic/entry entry colsep-0 rowsep-1" id="i2c_interface_design_luban_lite__table_clr_wf3_fdc__entry__2">void hal_i2c_target_addr(aic_i2c_ctrl *i2c_dev, uint32_t
addr)</th></tr></thead><tbody class="- topic/tbody tbody"><tr class="- topic/row"><td class="- topic/entry entry colsep-1 rowsep-1" headers="i2c_interface_design_luban_lite__table_clr_wf3_fdc__entry__1">功能说明</td><td class="- topic/entry entry colsep-0 rowsep-1" headers="i2c_interface_design_luban_lite__table_clr_wf3_fdc__entry__2">设置 I2C 目标设备的地址</td></tr><tr class="- topic/row"><td class="- topic/entry entry colsep-1 rowsep-1" headers="i2c_interface_design_luban_lite__table_clr_wf3_fdc__entry__1">参数定义</td><td class="- topic/entry entry colsep-0 rowsep-1" headers="i2c_interface_design_luban_lite__table_clr_wf3_fdc__entry__2">
<div class="- topic/div div">
<div class="- topic/div div"> i2c_dev：指向自定义的 aic_i2c_ctrl 结构体 | addr：目标地址</div>
</div>
</td></tr><tr class="- topic/row"><td class="- topic/entry entry colsep-1 rowsep-1" headers="i2c_interface_design_luban_lite__table_clr_wf3_fdc__entry__1">返回值</td><td class="- topic/entry entry colsep-0 rowsep-1" headers="i2c_interface_design_luban_lite__table_clr_wf3_fdc__entry__2">无</td></tr><tr class="- topic/row"><td class="- topic/entry entry colsep-1 rowsep-0" headers="i2c_interface_design_luban_lite__table_clr_wf3_fdc__entry__1">注意事项</td><td class="- topic/entry entry colsep-0 rowsep-0" headers="i2c_interface_design_luban_lite__table_clr_wf3_fdc__entry__2">- </td></tr></tbody></table></div>
<div class="table-container"><table class="- topic/table table frame-all" id="i2c_interface_design_luban_lite__table_dlr_wf3_fdc" data-ofbid="i2c_interface_design_luban_lite__table_dlr_wf3_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"> 18</span><span class="table--title-label-punctuation">. </span></span><span class="table--title">hal_i2c_slave_own_addr</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="i2c_interface_design_luban_lite__table_dlr_wf3_fdc__entry__1">函数原型</th><th class="- topic/entry entry colsep-0 rowsep-1" id="i2c_interface_design_luban_lite__table_dlr_wf3_fdc__entry__2">int hal_i2c_slave_own_addr(aic_i2c_ctrl *i2c_dev, uint32_t
addr)</th></tr></thead><tbody class="- topic/tbody tbody"><tr class="- topic/row"><td class="- topic/entry entry colsep-1 rowsep-1" headers="i2c_interface_design_luban_lite__table_dlr_wf3_fdc__entry__1">功能说明</td><td class="- topic/entry entry colsep-0 rowsep-1" headers="i2c_interface_design_luban_lite__table_dlr_wf3_fdc__entry__2">设置 SLAVE 模式被寻址的地址</td></tr><tr class="- topic/row"><td class="- topic/entry entry colsep-1 rowsep-1" headers="i2c_interface_design_luban_lite__table_dlr_wf3_fdc__entry__1">参数定义</td><td class="- topic/entry entry colsep-0 rowsep-1" headers="i2c_interface_design_luban_lite__table_dlr_wf3_fdc__entry__2">
<div class="- topic/div div">
<div class="- topic/div div"> i2c_dev：指向自定义的 aic_i2c_ctrl 结构体 | addr：目标地址</div>
</div>
</td></tr><tr class="- topic/row"><td class="- topic/entry entry colsep-1 rowsep-1" headers="i2c_interface_design_luban_lite__table_dlr_wf3_fdc__entry__1">返回值</td><td class="- topic/entry entry colsep-0 rowsep-1" headers="i2c_interface_design_luban_lite__table_dlr_wf3_fdc__entry__2">
<div class="- topic/div div">
<div class="- topic/div div">0：执行成功</div>
<div class="- topic/div div"> &lt;0：执行过程中发生错误</div>
</div>
</td></tr><tr class="- topic/row"><td class="- topic/entry entry colsep-1 rowsep-0" headers="i2c_interface_design_luban_lite__table_dlr_wf3_fdc__entry__1">注意事项</td><td class="- topic/entry entry colsep-0 rowsep-0" headers="i2c_interface_design_luban_lite__table_dlr_wf3_fdc__entry__2">- </td></tr></tbody></table></div>
<div class="table-container"><table class="- topic/table table frame-all" id="i2c_interface_design_luban_lite__table_elr_wf3_fdc" data-ofbid="i2c_interface_design_luban_lite__table_elr_wf3_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"> 19</span><span class="table--title-label-punctuation">. </span></span><span class="table--title">hal_i2c_wait_transmit</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="i2c_interface_design_luban_lite__table_elr_wf3_fdc__entry__1">函数原型</th><th class="- topic/entry entry colsep-0 rowsep-1" id="i2c_interface_design_luban_lite__table_elr_wf3_fdc__entry__2">static int32_t hal_i2c_wait_transmit(aic_i2c_ctrl *i2c_dev,
uint32_t timeout)</th></tr></thead><tbody class="- topic/tbody tbody"><tr class="- topic/row"><td class="- topic/entry entry colsep-1 rowsep-1" headers="i2c_interface_design_luban_lite__table_elr_wf3_fdc__entry__1">功能说明</td><td class="- topic/entry entry colsep-0 rowsep-1" headers="i2c_interface_design_luban_lite__table_elr_wf3_fdc__entry__2">I2C 数据发送的超时函数</td></tr><tr class="- topic/row"><td class="- topic/entry entry colsep-1 rowsep-1" headers="i2c_interface_design_luban_lite__table_elr_wf3_fdc__entry__1">参数定义</td><td class="- topic/entry entry colsep-0 rowsep-1" headers="i2c_interface_design_luban_lite__table_elr_wf3_fdc__entry__2">
<div class="- topic/div div">
<div class="- topic/div div"> i2c_dev：指向自定义的 aic_i2c_ctrl 结构体 | timeout：超时时间单位 ms</div>
</div>
</td></tr><tr class="- topic/row"><td class="- topic/entry entry colsep-1 rowsep-1" headers="i2c_interface_design_luban_lite__table_elr_wf3_fdc__entry__1">返回值</td><td class="- topic/entry entry colsep-0 rowsep-1" headers="i2c_interface_design_luban_lite__table_elr_wf3_fdc__entry__2">
<div class="- topic/div div">
<div class="- topic/div div">0：执行成功</div>
<div class="- topic/div div">&lt;0：超时</div>
</div>
</td></tr><tr class="- topic/row"><td class="- topic/entry entry colsep-1 rowsep-0" headers="i2c_interface_design_luban_lite__table_elr_wf3_fdc__entry__1">注意事项</td><td class="- topic/entry entry colsep-0 rowsep-0" headers="i2c_interface_design_luban_lite__table_elr_wf3_fdc__entry__2">- </td></tr></tbody></table></div>
<div class="table-container"><table class="- topic/table table frame-all" id="i2c_interface_design_luban_lite__table_flr_wf3_fdc" data-ofbid="i2c_interface_design_luban_lite__table_flr_wf3_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"> 20</span><span class="table--title-label-punctuation">. </span></span><span class="table--title">hal_i2c_wait_receive</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="i2c_interface_design_luban_lite__table_flr_wf3_fdc__entry__1">函数原型</th><th class="- topic/entry entry colsep-0 rowsep-1" id="i2c_interface_design_luban_lite__table_flr_wf3_fdc__entry__2">static int32_t hal_i2c_wait_receive(aic_i2c_ctrl *i2c_dev,
uint32_t wait_data_num, uint32_t timeout)</th></tr></thead><tbody class="- topic/tbody tbody"><tr class="- topic/row"><td class="- topic/entry entry colsep-1 rowsep-1" headers="i2c_interface_design_luban_lite__table_flr_wf3_fdc__entry__1">功能说明</td><td class="- topic/entry entry colsep-0 rowsep-1" headers="i2c_interface_design_luban_lite__table_flr_wf3_fdc__entry__2">I2C 数据接收的超时函数</td></tr><tr class="- topic/row"><td class="- topic/entry entry colsep-1 rowsep-1" headers="i2c_interface_design_luban_lite__table_flr_wf3_fdc__entry__1">参数定义</td><td class="- topic/entry entry colsep-0 rowsep-1" headers="i2c_interface_design_luban_lite__table_flr_wf3_fdc__entry__2">
<div class="- topic/div div">
<div class="- topic/div div"> i2c_dev：指向自定义的 aic_i2c_ctrl 结构体 | wait_data_num：等待接收数据的数量
| timeout：超时时间单位 ms</div>
</div>
</td></tr><tr class="- topic/row"><td class="- topic/entry entry colsep-1 rowsep-1" headers="i2c_interface_design_luban_lite__table_flr_wf3_fdc__entry__1">返回值</td><td class="- topic/entry entry colsep-0 rowsep-1" headers="i2c_interface_design_luban_lite__table_flr_wf3_fdc__entry__2">
<div class="- topic/div div">
<div class="- topic/div div">0：执行成功</div>
<div class="- topic/div div">&lt;0：超时</div>
</div>
</td></tr><tr class="- topic/row"><td class="- topic/entry entry colsep-1 rowsep-0" headers="i2c_interface_design_luban_lite__table_flr_wf3_fdc__entry__1">注意事项</td><td class="- topic/entry entry colsep-0 rowsep-0" headers="i2c_interface_design_luban_lite__table_flr_wf3_fdc__entry__2">- </td></tr></tbody></table></div>
<div class="table-container"><table class="- topic/table table frame-all" id="i2c_interface_design_luban_lite__table_glr_wf3_fdc" data-ofbid="i2c_interface_design_luban_lite__table_glr_wf3_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"> 21</span><span class="table--title-label-punctuation">. </span></span><span class="table--title">hal_i2c_wait_bus_free</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="i2c_interface_design_luban_lite__table_glr_wf3_fdc__entry__1">函数原型</th><th class="- topic/entry entry colsep-0 rowsep-1" id="i2c_interface_design_luban_lite__table_glr_wf3_fdc__entry__2">int32_t hal_i2c_wait_bus_free(aic_i2c_ctrl *i2c_dev, uint32_t
timeout)</th></tr></thead><tbody class="- topic/tbody tbody"><tr class="- topic/row"><td class="- topic/entry entry colsep-1 rowsep-1" headers="i2c_interface_design_luban_lite__table_glr_wf3_fdc__entry__1">功能说明</td><td class="- topic/entry entry colsep-0 rowsep-1" headers="i2c_interface_design_luban_lite__table_glr_wf3_fdc__entry__2">等待 I2C 总线空闲</td></tr><tr class="- topic/row"><td class="- topic/entry entry colsep-1 rowsep-1" headers="i2c_interface_design_luban_lite__table_glr_wf3_fdc__entry__1">参数定义</td><td class="- topic/entry entry colsep-0 rowsep-1" headers="i2c_interface_design_luban_lite__table_glr_wf3_fdc__entry__2">
<div class="- topic/div div">
<div class="- topic/div div"> i2c_dev：指向自定义的 aic_i2c_ctrl 结构体 | timeout：超时时间单位 ms</div>
</div>
</td></tr><tr class="- topic/row"><td class="- topic/entry entry colsep-1 rowsep-1" headers="i2c_interface_design_luban_lite__table_glr_wf3_fdc__entry__1">返回值</td><td class="- topic/entry entry colsep-0 rowsep-1" headers="i2c_interface_design_luban_lite__table_glr_wf3_fdc__entry__2">
<div class="- topic/div div">
<div class="- topic/div div">0：执行成功</div>
<div class="- topic/div div">&lt;0：超时</div>
</div>
</td></tr><tr class="- topic/row"><td class="- topic/entry entry colsep-1 rowsep-0" headers="i2c_interface_design_luban_lite__table_glr_wf3_fdc__entry__1">注意事项</td><td class="- topic/entry entry colsep-0 rowsep-0" headers="i2c_interface_design_luban_lite__table_glr_wf3_fdc__entry__2">- </td></tr></tbody></table></div>
<div class="table-container"><table class="- topic/table table frame-all" id="i2c_interface_design_luban_lite__table_hlr_wf3_fdc" data-ofbid="i2c_interface_design_luban_lite__table_hlr_wf3_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"> 22</span><span class="table--title-label-punctuation">. </span></span><span class="table--title">hal_i2c_master_send_msg</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="i2c_interface_design_luban_lite__table_hlr_wf3_fdc__entry__1">函数原型</th><th class="- topic/entry entry colsep-0 rowsep-1" id="i2c_interface_design_luban_lite__table_hlr_wf3_fdc__entry__2">int32_t hal_i2c_master_send_msg(aic_i2c_ctrl *i2c_dev, struct
aic_i2c_msg *msg, uint8_t is_last_message)</th></tr></thead><tbody class="- topic/tbody tbody"><tr class="- topic/row"><td class="- topic/entry entry colsep-1 rowsep-1" headers="i2c_interface_design_luban_lite__table_hlr_wf3_fdc__entry__1">功能说明</td><td class="- topic/entry entry colsep-0 rowsep-1" headers="i2c_interface_design_luban_lite__table_hlr_wf3_fdc__entry__2">发送数据</td></tr><tr class="- topic/row"><td class="- topic/entry entry colsep-1 rowsep-1" headers="i2c_interface_design_luban_lite__table_hlr_wf3_fdc__entry__1">参数定义</td><td class="- topic/entry entry colsep-0 rowsep-1" headers="i2c_interface_design_luban_lite__table_hlr_wf3_fdc__entry__2">
<div class="- topic/div div">
<div class="- topic/div div"> i2c_dev：指向自定义的 aic_i2c_ctrl 结构体 | msg：指向当前将要传输的 msg |
is_last_message：指示当前 msg 是否是最后一个 msg</div>
</div>
</td></tr><tr class="- topic/row"><td class="- topic/entry entry colsep-1 rowsep-1" headers="i2c_interface_design_luban_lite__table_hlr_wf3_fdc__entry__1">返回值</td><td class="- topic/entry entry colsep-0 rowsep-1" headers="i2c_interface_design_luban_lite__table_hlr_wf3_fdc__entry__2">
<div class="- topic/div div">
<div class="- topic/div div"> send_count：发送数据的数量</div>
<div class="- topic/div div"> &lt;0：发送出错</div>
</div>
</td></tr><tr class="- topic/row"><td class="- topic/entry entry colsep-1 rowsep-0" headers="i2c_interface_design_luban_lite__table_hlr_wf3_fdc__entry__1">注意事项</td><td class="- topic/entry entry colsep-0 rowsep-0" headers="i2c_interface_design_luban_lite__table_hlr_wf3_fdc__entry__2">- </td></tr></tbody></table></div>
<div class="table-container"><table class="- topic/table table frame-all" id="i2c_interface_design_luban_lite__table_ilr_wf3_fdc" data-ofbid="i2c_interface_design_luban_lite__table_ilr_wf3_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"> 23</span><span class="table--title-label-punctuation">. </span></span><span class="table--title">hal_i2c_master_receive_msg</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="i2c_interface_design_luban_lite__table_ilr_wf3_fdc__entry__1">函数原型</th><th class="- topic/entry entry colsep-0 rowsep-1" id="i2c_interface_design_luban_lite__table_ilr_wf3_fdc__entry__2">int32_t hal_i2c_master_receive_msg(aic_i2c_ctrl *i2c_dev, struct
aic_i2c_msg *msg, uint8_t is_last_message)</th></tr></thead><tbody class="- topic/tbody tbody"><tr class="- topic/row"><td class="- topic/entry entry colsep-1 rowsep-1" headers="i2c_interface_design_luban_lite__table_ilr_wf3_fdc__entry__1">功能说明</td><td class="- topic/entry entry colsep-0 rowsep-1" headers="i2c_interface_design_luban_lite__table_ilr_wf3_fdc__entry__2">发送数据</td></tr><tr class="- topic/row"><td class="- topic/entry entry colsep-1 rowsep-1" headers="i2c_interface_design_luban_lite__table_ilr_wf3_fdc__entry__1">参数定义</td><td class="- topic/entry entry colsep-0 rowsep-1" headers="i2c_interface_design_luban_lite__table_ilr_wf3_fdc__entry__2">
<div class="- topic/div div">
<div class="- topic/div div"> i2c_dev：指向自定义的 aic_i2c_ctrl 结构体 | msg：指向当前将要传输的 msg |
is_last_message：指示当前 msg 是否是最后一个 msg</div>
</div>
</td></tr><tr class="- topic/row"><td class="- topic/entry entry colsep-1 rowsep-1" headers="i2c_interface_design_luban_lite__table_ilr_wf3_fdc__entry__1">返回值</td><td class="- topic/entry entry colsep-0 rowsep-1" headers="i2c_interface_design_luban_lite__table_ilr_wf3_fdc__entry__2">
<div class="- topic/div div">
<div class="- topic/div div"> read_count：接收到数据的数量</div>
<div class="- topic/div div"> &lt;0：接收出错</div>
</div>
</td></tr><tr class="- topic/row"><td class="- topic/entry entry colsep-1 rowsep-0" headers="i2c_interface_design_luban_lite__table_ilr_wf3_fdc__entry__1">注意事项</td><td class="- topic/entry entry colsep-0 rowsep-0" headers="i2c_interface_design_luban_lite__table_ilr_wf3_fdc__entry__2">-</td></tr></tbody></table></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="#i2c_interface_design_luban_lite__section_ssb_5gz_gdc" data-tocid="i2c_interface_design_luban_lite__section_ssb_5gz_gdc">Driver 层接口设计</a></div></li><li class="section-item"><div class="section-title"><a href="#i2c_interface_design_luban_lite__section_rdk_vgz_gdc" data-tocid="i2c_interface_design_luban_lite__section_rdk_vgz_gdc">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>
Reference in New Issue View Git Blame Copy Permalink