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

168 lines
35 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="表 1 . i2c_handle_tx_abort 函数原型 int i2c_handle_tx_abort(struct aic_i2c_dev *i2c_dev) 功能说明 打印 c 发生 abort 的原因,并返回相应的 error 值 参数定义 i2c_dev指向自定义的 dev 结构体 返回值 根据不同的 abort 原因,返回不同的 error 值 注意事项 - 表 2 . ..."/><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.creator" content="yan.wang"/><meta name="DC.date.created" content="2024-01-23"/><meta name="DC.date.modified" content="2024-04-03"/><meta name="DC.format" content="HTML5"/><meta name="DC.identifier" content="i2c_interface_design"/><meta name="DC.language" content="zh-CN"/><title>接口设计</title><!-- Build number 2023110923. --><meta name="wh-path2root" content="../../../"/><meta name="wh-toc-id" content=""/><meta name="wh-source-relpath" content="topics/sdk/i2c/i2c_interface.dita"/><meta name="wh-out-relpath" content="topics/sdk/i2c/i2c_interface.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" class="wh_topic_page frmBody">
<a href="#wh_topic_body" class="sr-only sr-only-focusable">
跳转到主要内容
</a>
<header class="navbar navbar-default wh_header">
<div class="container-fluid">
<div class="wh_header_flex_container navbar-nav navbar-expand-md navbar-dark">
<div class="wh_logo_and_publication_title_container">
<div class="wh_logo_and_publication_title">
<a href="http://www.artinchip.com" class=" wh_logo d-none d-sm-block "><img src="../../../company-logo-white.png" alt="RTOS SDK 使用指南SDK 指南文件"/></a>
<div class=" wh_publication_title "><a href="../../../index.html"><span class="booktitle"><span class="ph mainbooktitle">RTOS SDK 使用指南</span><span class="ph booktitlealt">SDK 指南文件</span></span></a></div>
</div>
</div>
<div class="wh_top_menu_and_indexterms_link collapse navbar-collapse" id="wh_top_menu_and_indexterms_link">
</div>
</div>
</div>
</header>
<div class=" wh_search_input navbar-form wh_topic_page_search search " role="form">
<form id="searchForm" method="get" role="search" action="../../../search.html"><div><input type="search" placeholder="搜索 " class="wh_search_textfield" id="textToSearch" name="searchQuery" aria-label="搜索查询" required="required"/><button type="submit" class="wh_search_button" aria-label="搜索"><span class="search_input_text">搜索</span></button></div></form>
</div>
<div class="container-fluid" id="wh_topic_container">
<div class="row">
<nav class="wh_tools d-print-none navbar-expand-md" aria-label="Tools">
<div data-tooltip-position="bottom" class=" wh_breadcrumb "></div>
<div class="wh_right_tools">
<button class="wh_hide_highlight" aria-label="切换搜索突出显示" title="切换搜索突出显示"></button>
<button class="webhelp_expand_collapse_sections" data-next-state="collapsed" aria-label="折叠截面" title="折叠截面"></button>
<div class=" wh_print_link print d-none d-md-inline-block "><button onClick="window.print()" title="打印此页" aria-label="打印此页"></button></div>
</div>
</nav>
</div>
<div class="wh_content_area">
<div class="row">
<div class="col-12" id="wh_topic_body">
<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.dita">Edit online</a></span><h1 class="- topic/title title topictitle1" id="ariaid-title1">接口设计</h1><div class="date inPage">3 Apr 2024</div><div style="color: gray;">
Read time: 2 minute(s)
</div><div class="- topic/body concept/conbody body conbody"><div class="table-container"><table class="- topic/table table frame-all" id="i2c_interface_design__table_j4t_y5r_21c" data-ofbid="i2c_interface_design__table_j4t_y5r_21c" 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">i2c_handle_tx_abort</span></caption><colgroup><col style="width:25%"/><col style="width:75%"/></colgroup><thead class="- topic/thead thead"><tr class="- topic/row"><th class="- topic/entry entry colsep-1 rowsep-1" id="i2c_interface_design__table_j4t_y5r_21c__entry__1">函数原型</th><th class="- topic/entry entry colsep-0 rowsep-1" id="i2c_interface_design__table_j4t_y5r_21c__entry__2">int i2c_handle_tx_abort(struct aic_i2c_dev *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__table_j4t_y5r_21c__entry__1">功能说明</td><td class="- topic/entry entry colsep-0 rowsep-1" headers="i2c_interface_design__table_j4t_y5r_21c__entry__2">打印 c 发生 abort 的原因,并返回相应的 error 值</td></tr><tr class="- topic/row"><td class="- topic/entry entry colsep-1 rowsep-1" headers="i2c_interface_design__table_j4t_y5r_21c__entry__1">参数定义</td><td class="- topic/entry entry colsep-0 rowsep-1" headers="i2c_interface_design__table_j4t_y5r_21c__entry__2">i2c_dev指向自定义的 dev 结构体</td></tr><tr class="- topic/row"><td class="- topic/entry entry colsep-1 rowsep-1" headers="i2c_interface_design__table_j4t_y5r_21c__entry__1">返回值</td><td class="- topic/entry entry colsep-0 rowsep-1" headers="i2c_interface_design__table_j4t_y5r_21c__entry__2">根据不同的 abort 原因,返回不同的 error 值</td></tr><tr class="- topic/row"><td class="- topic/entry entry colsep-1 rowsep-0" headers="i2c_interface_design__table_j4t_y5r_21c__entry__1">注意事项</td><td class="- topic/entry entry colsep-0 rowsep-0" headers="i2c_interface_design__table_j4t_y5r_21c__entry__2">-</td></tr></tbody></table></div><div class="table-container"><table class="- topic/table table frame-all" id="i2c_interface_design__table_k4t_y5r_21c" data-ofbid="i2c_interface_design__table_k4t_y5r_21c" 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">i2c_scl_cnt</span></caption><colgroup><col style="width:25%"/><col style="width:75%"/></colgroup><thead class="- topic/thead thead"><tr class="- topic/row"><th class="- topic/entry entry colsep-1 rowsep-1" id="i2c_interface_design__table_k4t_y5r_21c__entry__1">函数原型</th><th class="- topic/entry entry colsep-0 rowsep-1" id="i2c_interface_design__table_k4t_y5r_21c__entry__2">int i2c_scl_cnt(u32 ic_clk, enum aic_i2c_speed aic_speed, u16
*hcnt, u16 *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__table_k4t_y5r_21c__entry__1">功能说明</td><td class="- topic/entry entry colsep-0 rowsep-1" headers="i2c_interface_design__table_k4t_y5r_21c__entry__2">根据 c 模块工作的时钟频率和 i2c 的传输速率,返回需要设置的 hcnt 值和 lcnt 值</td></tr><tr class="- topic/row"><td class="- topic/entry entry colsep-1 rowsep-1" headers="i2c_interface_design__table_k4t_y5r_21c__entry__1">参数定义</td><td class="- topic/entry entry colsep-0 rowsep-1" headers="i2c_interface_design__table_k4t_y5r_21c__entry__2">ic_clki2c 模块工作的时钟频率,以 KHz 为单位 speed表示 c 的传输速率,是标准模式还是快速模式 hcnt指向需要设置的 hcnt 值的指针 lcnt指向需要设置的 lcnt 值的指针</td></tr><tr class="- topic/row"><td class="- topic/entry entry colsep-1 rowsep-1" headers="i2c_interface_design__table_k4t_y5r_21c__entry__1">返回值</td><td class="- topic/entry entry colsep-0 rowsep-1" headers="i2c_interface_design__table_k4t_y5r_21c__entry__2">0函数执行成功-EINVALhcnt 或 lcnt 为空指针</td></tr><tr class="- topic/row"><td class="- topic/entry entry colsep-1 rowsep-0" headers="i2c_interface_design__table_k4t_y5r_21c__entry__1">注意事项</td><td class="- topic/entry entry colsep-0 rowsep-0" headers="i2c_interface_design__table_k4t_y5r_21c__entry__2">-</td></tr></tbody></table></div><div class="table-container"><table class="- topic/table table frame-all" id="i2c_interface_design__table_l4t_y5r_21c" data-ofbid="i2c_interface_design__table_l4t_y5r_21c" 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">i2c_set_timmings_master</span></caption><colgroup><col style="width:25%"/><col style="width:75%"/></colgroup><thead class="- topic/thead thead"><tr class="- topic/row"><th class="- topic/entry entry colsep-1 rowsep-1" id="i2c_interface_design__table_l4t_y5r_21c__entry__1">函数原型</th><th class="- topic/entry entry colsep-0 rowsep-1" id="i2c_interface_design__table_l4t_y5r_21c__entry__2">static int i2c_set_timmings_master(struct aic_i2c_dev
*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__table_l4t_y5r_21c__entry__1">功能说明</td><td class="- topic/entry entry colsep-0 rowsep-1" headers="i2c_interface_design__table_l4t_y5r_21c__entry__2">设置 master 产生 SCL 时钟的时序参数</td></tr><tr class="- topic/row"><td class="- topic/entry entry colsep-1 rowsep-1" headers="i2c_interface_design__table_l4t_y5r_21c__entry__1">参数定义</td><td class="- topic/entry entry colsep-0 rowsep-1" headers="i2c_interface_design__table_l4t_y5r_21c__entry__2">i2c_dev指向自定义的 dev 结构体</td></tr><tr class="- topic/row"><td class="- topic/entry entry colsep-1 rowsep-1" headers="i2c_interface_design__table_l4t_y5r_21c__entry__1">返回值</td><td class="- topic/entry entry colsep-0 rowsep-1" headers="i2c_interface_design__table_l4t_y5r_21c__entry__2">0函数执行成功-EINVAL参数非法</td></tr><tr class="- topic/row"><td class="- topic/entry entry colsep-1 rowsep-0" headers="i2c_interface_design__table_l4t_y5r_21c__entry__1">注意事项</td><td class="- topic/entry entry colsep-0 rowsep-0" headers="i2c_interface_design__table_l4t_y5r_21c__entry__2">若在 DTS 中有设置 i2c 的时序参数 ns 或 ns则会由 timings 对 DTS 进行解析,在此函数中不再调用 cnt 进行设置</td></tr></tbody></table></div><div class="table-container"><table class="- topic/table table frame-all" id="i2c_interface_design__table_m4t_y5r_21c" data-ofbid="i2c_interface_design__table_m4t_y5r_21c" 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">i2c_init_master</span></caption><colgroup><col style="width:25%"/><col style="width:75%"/></colgroup><thead class="- topic/thead thead"><tr class="- topic/row"><th class="- topic/entry entry colsep-1 rowsep-1" id="i2c_interface_design__table_m4t_y5r_21c__entry__1">函数原型</th><th class="- topic/entry entry colsep-0 rowsep-1" id="i2c_interface_design__table_m4t_y5r_21c__entry__2">static void i2c_init_master(struct aic_i2c_dev *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__table_m4t_y5r_21c__entry__1">功能说明</td><td class="- topic/entry entry colsep-0 rowsep-1" headers="i2c_interface_design__table_m4t_y5r_21c__entry__2">初始化 master 模式下的参数设置,写入 hcnt 和 lcnt配置 TXFIFO 和 RXFIFO 阈值,将 c 配置为主模式</td></tr><tr class="- topic/row"><td class="- topic/entry entry colsep-1 rowsep-1" headers="i2c_interface_design__table_m4t_y5r_21c__entry__1">参数定义</td><td class="- topic/entry entry colsep-0 rowsep-1" headers="i2c_interface_design__table_m4t_y5r_21c__entry__2">i2c_dev指向自定义的 dev 结构体</td></tr><tr class="- topic/row"><td class="- topic/entry entry colsep-1 rowsep-1" headers="i2c_interface_design__table_m4t_y5r_21c__entry__1">返回值</td><td class="- topic/entry entry colsep-0 rowsep-1" headers="i2c_interface_design__table_m4t_y5r_21c__entry__2"></td></tr><tr class="- topic/row"><td class="- topic/entry entry colsep-1 rowsep-0" headers="i2c_interface_design__table_m4t_y5r_21c__entry__1">注意事项</td><td class="- topic/entry entry colsep-0 rowsep-0" headers="i2c_interface_design__table_m4t_y5r_21c__entry__2">-</td></tr></tbody></table></div><div class="table-container"><table class="- topic/table table frame-all" id="i2c_interface_design__table_n4t_y5r_21c" data-ofbid="i2c_interface_design__table_n4t_y5r_21c" 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">i2c_xfer_msg_init</span></caption><colgroup><col style="width:25%"/><col style="width:75%"/></colgroup><thead class="- topic/thead thead"><tr class="- topic/row"><th class="- topic/entry entry colsep-1 rowsep-1" id="i2c_interface_design__table_n4t_y5r_21c__entry__1">函数原型</th><th class="- topic/entry entry colsep-0 rowsep-1" id="i2c_interface_design__table_n4t_y5r_21c__entry__2">static void i2c_xfer_msg_init(struct aic_i2c_dev
*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__table_n4t_y5r_21c__entry__1">功能说明</td><td class="- topic/entry entry colsep-0 rowsep-1" headers="i2c_interface_design__table_n4t_y5r_21c__entry__2">在传输每个 msg 前进行的初始化,主要是将指示每个 msg 状态的变量设置为初始值,并设置传输的从地址设置,使能中断</td></tr><tr class="- topic/row"><td class="- topic/entry entry colsep-1 rowsep-1" headers="i2c_interface_design__table_n4t_y5r_21c__entry__1">参数定义</td><td class="- topic/entry entry colsep-0 rowsep-1" headers="i2c_interface_design__table_n4t_y5r_21c__entry__2">i2c_dev指向自定义的 dev 结构体</td></tr><tr class="- topic/row"><td class="- topic/entry entry colsep-1 rowsep-1" headers="i2c_interface_design__table_n4t_y5r_21c__entry__1">返回值</td><td class="- topic/entry entry colsep-0 rowsep-1" headers="i2c_interface_design__table_n4t_y5r_21c__entry__2"></td></tr><tr class="- topic/row"><td class="- topic/entry entry colsep-1 rowsep-0" headers="i2c_interface_design__table_n4t_y5r_21c__entry__1">注意事项</td><td class="- topic/entry entry colsep-0 rowsep-0" headers="i2c_interface_design__table_n4t_y5r_21c__entry__2">-</td></tr></tbody></table></div><div class="table-container"><table class="- topic/table table frame-all" id="i2c_interface_design__table_o4t_y5r_21c" data-ofbid="i2c_interface_design__table_o4t_y5r_21c" 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">i2c_xfer_msg</span></caption><colgroup><col style="width:25%"/><col style="width:75%"/></colgroup><thead class="- topic/thead thead"><tr class="- topic/row"><th class="- topic/entry entry colsep-1 rowsep-1" id="i2c_interface_design__table_o4t_y5r_21c__entry__1">函数原型</th><th class="- topic/entry entry colsep-0 rowsep-1" id="i2c_interface_design__table_o4t_y5r_21c__entry__2">static int i2c_xfer_msg(struct aic_i2c_dev *i2c_dev, struct
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__table_o4t_y5r_21c__entry__1">功能说明</td><td class="- topic/entry entry colsep-0 rowsep-1" headers="i2c_interface_design__table_o4t_y5r_21c__entry__2">单个 msg 的传输函数,若当前 msg 是第一个 msg则会等待总线空闲然后执行 init 进行 msg 传输前的初始化工作,等待当前 msg 传输完成</td></tr><tr class="- topic/row"><td class="- topic/entry entry colsep-1 rowsep-1" headers="i2c_interface_design__table_o4t_y5r_21c__entry__1">参数定义</td><td class="- topic/entry entry colsep-0 rowsep-1" headers="i2c_interface_design__table_o4t_y5r_21c__entry__2">i2c_dev指向自定义的 dev 结构体 msg指向当前将要传输的 first指示当前 msg 是否是第一个 last指示当前 msg 是否是最后一个 msg</td></tr><tr class="- topic/row"><td class="- topic/entry entry colsep-1 rowsep-1" headers="i2c_interface_design__table_o4t_y5r_21c__entry__1">返回值</td><td class="- topic/entry entry colsep-0 rowsep-1" headers="i2c_interface_design__table_o4t_y5r_21c__entry__2">0执行成功&lt;0执行过程中发生错误</td></tr><tr class="- topic/row"><td class="- topic/entry entry colsep-1 rowsep-0" headers="i2c_interface_design__table_o4t_y5r_21c__entry__1">注意事项</td><td class="- topic/entry entry colsep-0 rowsep-0" headers="i2c_interface_design__table_o4t_y5r_21c__entry__2">-</td></tr></tbody></table></div><div class="table-container"><table class="- topic/table table frame-all" id="i2c_interface_design__table_p4t_y5r_21c" data-ofbid="i2c_interface_design__table_p4t_y5r_21c" 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">i2c_xfer</span></caption><colgroup><col style="width:25%"/><col style="width:75%"/></colgroup><thead class="- topic/thead thead"><tr class="- topic/row"><th class="- topic/entry entry colsep-1 rowsep-1" id="i2c_interface_design__table_p4t_y5r_21c__entry__1">函数原型</th><th class="- topic/entry entry colsep-0 rowsep-1" id="i2c_interface_design__table_p4t_y5r_21c__entry__2">static int i2c_xfer(struct i2c_adapter *i2c_adap, struct i2c_msg
msgs[], int 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__table_p4t_y5r_21c__entry__1">功能说明</td><td class="- topic/entry entry colsep-0 rowsep-1" headers="i2c_interface_design__table_p4t_y5r_21c__entry__2">i2c 的传输函数,该函数可完成多个 msg 的传输,使用该函数完成对 algorithm 中 master_xfer 函数指针的填充</td></tr><tr class="- topic/row"><td class="- topic/entry entry colsep-1 rowsep-1" headers="i2c_interface_design__table_p4t_y5r_21c__entry__1">参数定义</td><td class="- topic/entry entry colsep-0 rowsep-1" headers="i2c_interface_design__table_p4t_y5r_21c__entry__2">i2c_dev指向自定义的 dev 结构体 msgs指向 msg 数组的指针 num需要传输的 msg 个数</td></tr><tr class="- topic/row"><td class="- topic/entry entry colsep-1 rowsep-1" headers="i2c_interface_design__table_p4t_y5r_21c__entry__1">返回值</td><td class="- topic/entry entry colsep-0 rowsep-1" headers="i2c_interface_design__table_p4t_y5r_21c__entry__2">0执行成功&lt;0执行过程中发生错误</td></tr><tr class="- topic/row"><td class="- topic/entry entry colsep-1 rowsep-0" headers="i2c_interface_design__table_p4t_y5r_21c__entry__1">注意事项</td><td class="- topic/entry entry colsep-0 rowsep-0" headers="i2c_interface_design__table_p4t_y5r_21c__entry__2">-</td></tr></tbody></table></div><div class="table-container"><table class="- topic/table table frame-all" id="i2c_interface_design__table_q4t_y5r_21c" data-ofbid="i2c_interface_design__table_q4t_y5r_21c" 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">i2c_handle_read</span></caption><colgroup><col style="width:25%"/><col style="width:75%"/></colgroup><thead class="- topic/thead thead"><tr class="- topic/row"><th class="- topic/entry entry colsep-1 rowsep-1" id="i2c_interface_design__table_q4t_y5r_21c__entry__1">函数原型</th><th class="- topic/entry entry colsep-0 rowsep-1" id="i2c_interface_design__table_q4t_y5r_21c__entry__2">static void i2c_handle_read(struct aic_i2c_dev *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__table_q4t_y5r_21c__entry__1">功能说明</td><td class="- topic/entry entry colsep-0 rowsep-1" headers="i2c_interface_design__table_q4t_y5r_21c__entry__2">当触发 FULL 中断时,调用该函数读取接收到的数据,若完成当前 msg 的接收,则释放完成量。该函数在中断中调用</td></tr><tr class="- topic/row"><td class="- topic/entry entry colsep-1 rowsep-1" headers="i2c_interface_design__table_q4t_y5r_21c__entry__1">参数定义</td><td class="- topic/entry entry colsep-0 rowsep-1" headers="i2c_interface_design__table_q4t_y5r_21c__entry__2">i2c_dev指向自定义的 dev 结构体</td></tr><tr class="- topic/row"><td class="- topic/entry entry colsep-1 rowsep-1" headers="i2c_interface_design__table_q4t_y5r_21c__entry__1">返回值</td><td class="- topic/entry entry colsep-0 rowsep-1" headers="i2c_interface_design__table_q4t_y5r_21c__entry__2"></td></tr><tr class="- topic/row"><td class="- topic/entry entry colsep-1 rowsep-0" headers="i2c_interface_design__table_q4t_y5r_21c__entry__1">注意事项</td><td class="- topic/entry entry colsep-0 rowsep-0" headers="i2c_interface_design__table_q4t_y5r_21c__entry__2">-</td></tr></tbody></table></div><div class="table-container"><table class="- topic/table table frame-all" id="i2c_interface_design__table_r4t_y5r_21c" data-ofbid="i2c_interface_design__table_r4t_y5r_21c" 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">i2c_handle_write</span></caption><colgroup><col style="width:25%"/><col style="width:75%"/></colgroup><thead class="- topic/thead thead"><tr class="- topic/row"><th class="- topic/entry entry colsep-1 rowsep-1" id="i2c_interface_design__table_r4t_y5r_21c__entry__1">函数原型</th><th class="- topic/entry entry colsep-0 rowsep-1" id="i2c_interface_design__table_r4t_y5r_21c__entry__2">static void i2c_handle_write(struct aic_i2c_dev *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__table_r4t_y5r_21c__entry__1">功能说明</td><td class="- topic/entry entry colsep-0 rowsep-1" headers="i2c_interface_design__table_r4t_y5r_21c__entry__2">当触发 EMPTY 中断时,调用该函数。若是读 msg则调用该函数发送读命令若是写 msg则调用该函数发送数据</td></tr><tr class="- topic/row"><td class="- topic/entry entry colsep-1 rowsep-1" headers="i2c_interface_design__table_r4t_y5r_21c__entry__1">参数定义</td><td class="- topic/entry entry colsep-0 rowsep-1" headers="i2c_interface_design__table_r4t_y5r_21c__entry__2">i2c_dev指向自定义的 dev 结构体</td></tr><tr class="- topic/row"><td class="- topic/entry entry colsep-1 rowsep-1" headers="i2c_interface_design__table_r4t_y5r_21c__entry__1">返回值</td><td class="- topic/entry entry colsep-0 rowsep-1" headers="i2c_interface_design__table_r4t_y5r_21c__entry__2"></td></tr><tr class="- topic/row"><td class="- topic/entry entry colsep-1 rowsep-0" headers="i2c_interface_design__table_r4t_y5r_21c__entry__1">注意事项</td><td class="- topic/entry entry colsep-0 rowsep-0" headers="i2c_interface_design__table_r4t_y5r_21c__entry__2">-</td></tr></tbody></table></div><div class="table-container"><table class="- topic/table table frame-all" id="i2c_interface_design__table_s4t_y5r_21c" data-ofbid="i2c_interface_design__table_s4t_y5r_21c" 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">i2c_init_slave</span></caption><colgroup><col style="width:25%"/><col style="width:75%"/></colgroup><thead class="- topic/thead thead"><tr class="- topic/row"><th class="- topic/entry entry colsep-1 rowsep-1" id="i2c_interface_design__table_s4t_y5r_21c__entry__1">函数原型</th><th class="- topic/entry entry colsep-0 rowsep-1" id="i2c_interface_design__table_s4t_y5r_21c__entry__2">static void i2c_init_slave(struct aic_i2c_dev *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__table_s4t_y5r_21c__entry__1">功能说明</td><td class="- topic/entry entry colsep-0 rowsep-1" headers="i2c_interface_design__table_s4t_y5r_21c__entry__2">初始化 slave 模式下的参数设置,配置 TXFIFO 和 RXFIFO 阈值,设置 c 为 slave 模式</td></tr><tr class="- topic/row"><td class="- topic/entry entry colsep-1 rowsep-1" headers="i2c_interface_design__table_s4t_y5r_21c__entry__1">参数定义</td><td class="- topic/entry entry colsep-0 rowsep-1" headers="i2c_interface_design__table_s4t_y5r_21c__entry__2">i2c_dev指向自定义的 dev 结构体</td></tr><tr class="- topic/row"><td class="- topic/entry entry colsep-1 rowsep-1" headers="i2c_interface_design__table_s4t_y5r_21c__entry__1">返回值</td><td class="- topic/entry entry colsep-0 rowsep-1" headers="i2c_interface_design__table_s4t_y5r_21c__entry__2"></td></tr><tr class="- topic/row"><td class="- topic/entry entry colsep-1 rowsep-0" headers="i2c_interface_design__table_s4t_y5r_21c__entry__1">注意事项</td><td class="- topic/entry entry colsep-0 rowsep-0" headers="i2c_interface_design__table_s4t_y5r_21c__entry__2">-</td></tr></tbody></table></div><div class="table-container"><table class="- topic/table table frame-all" id="i2c_interface_design__table_t4t_y5r_21c" data-ofbid="i2c_interface_design__table_t4t_y5r_21c" 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">i2c_reg_slave</span></caption><colgroup><col style="width:25%"/><col style="width:75%"/></colgroup><thead class="- topic/thead thead"><tr class="- topic/row"><th class="- topic/entry entry colsep-1 rowsep-1" id="i2c_interface_design__table_t4t_y5r_21c__entry__1">函数原型</th><th class="- topic/entry entry colsep-0 rowsep-1" id="i2c_interface_design__table_t4t_y5r_21c__entry__2">static int i2c_reg_slave(struct i2c_client *slave)</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__table_t4t_y5r_21c__entry__1">功能说明</td><td class="- topic/entry entry colsep-0 rowsep-1" headers="i2c_interface_design__table_t4t_y5r_21c__entry__2">初始化 slave 模式下的参数设置,配置 slave 是 10bit 寻址还是 7bit 寻址,设置从机的地址</td></tr><tr class="- topic/row"><td class="- topic/entry entry colsep-1 rowsep-1" headers="i2c_interface_design__table_t4t_y5r_21c__entry__1">参数定义</td><td class="- topic/entry entry colsep-0 rowsep-1" headers="i2c_interface_design__table_t4t_y5r_21c__entry__2">i2c_dev指向自定义的 dev 结构体</td></tr><tr class="- topic/row"><td class="- topic/entry entry colsep-1 rowsep-1" headers="i2c_interface_design__table_t4t_y5r_21c__entry__1">返回值</td><td class="- topic/entry entry colsep-0 rowsep-1" headers="i2c_interface_design__table_t4t_y5r_21c__entry__2">0执行成功-EBUSY忙等待</td></tr><tr class="- topic/row"><td class="- topic/entry entry colsep-1 rowsep-0" headers="i2c_interface_design__table_t4t_y5r_21c__entry__1">注意事项</td><td class="- topic/entry entry colsep-0 rowsep-0" headers="i2c_interface_design__table_t4t_y5r_21c__entry__2">-</td></tr></tbody></table></div><div class="table-container"><table class="- topic/table table frame-all" id="i2c_interface_design__table_u4t_y5r_21c" data-ofbid="i2c_interface_design__table_u4t_y5r_21c" 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">i2c_unreg_slave</span></caption><colgroup><col style="width:25%"/><col style="width:75%"/></colgroup><thead class="- topic/thead thead"><tr class="- topic/row"><th class="- topic/entry entry colsep-1 rowsep-1" id="i2c_interface_design__table_u4t_y5r_21c__entry__1">函数原型</th><th class="- topic/entry entry colsep-0 rowsep-1" id="i2c_interface_design__table_u4t_y5r_21c__entry__2">static int i2c_unreg_slave(struct i2c_client *slave)</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__table_u4t_y5r_21c__entry__1">功能说明</td><td class="- topic/entry entry colsep-0 rowsep-1" headers="i2c_interface_design__table_u4t_y5r_21c__entry__2">与 slave 功能相反</td></tr><tr class="- topic/row"><td class="- topic/entry entry colsep-1 rowsep-1" headers="i2c_interface_design__table_u4t_y5r_21c__entry__1">参数定义</td><td class="- topic/entry entry colsep-0 rowsep-1" headers="i2c_interface_design__table_u4t_y5r_21c__entry__2">i2c_dev指向自定义的 dev 结构体</td></tr><tr class="- topic/row"><td class="- topic/entry entry colsep-1 rowsep-1" headers="i2c_interface_design__table_u4t_y5r_21c__entry__1">返回值</td><td class="- topic/entry entry colsep-0 rowsep-1" headers="i2c_interface_design__table_u4t_y5r_21c__entry__2">0执行成功</td></tr><tr class="- topic/row"><td class="- topic/entry entry colsep-1 rowsep-0" headers="i2c_interface_design__table_u4t_y5r_21c__entry__1">注意事项</td><td class="- topic/entry entry colsep-0 rowsep-0" headers="i2c_interface_design__table_u4t_y5r_21c__entry__2">-</td></tr></tbody></table></div></div></article></main></div>
</div>
</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>