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

274 lines
37 KiB
HTML
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

<!DOCTYPE html><html xmlns="http://www.w3.org/1999/xhtml" xml:lang="zh-cn" lang="zh-cn" data-whc_version="27.0">
<head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"/><meta name="viewport" content="width=device-width, initial-scale=1.0"/><meta http-equiv="X-UA-Compatible" content="IE=edge"/><meta name="description" content="源代码位于: linux-5.10/drivers/i2c/busses/ I2C 的驱动文件如下: 文件 说明 i2c-artinchip.h aic I2C 公用头文件I2C 模块的寄存器定义,结构体定义等 i2c-artinchip-master.c I2C 作为 master 时的驱动文件 i2c-artinchip-slave.c I2C 作为 slave 时的驱动文件 ..."/><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_user_guide.html"/><meta name="DC.relation" content="../../../topics/sdk/i2c/i2c_test.html"/><meta name="DC.relation" content="../../../topics/sdk/i2c/i2c_key_procedure.html"/><meta name="DC.relation" content="../../../topics/sdk/i2c/i2c_key_procedure.html"/><meta name="DC.relation" content="../../../topics/sdk/i2c/i2c_data_struct.html"/><meta name="DC.relation" content="../../../topics/sdk/i2c/i2c_interface.html"/><meta name="DC.contributor" content="yan.wang"/><meta name="DC.contributor" content="yan.wang"/><meta name="DC.date.modified" content="2024-01-15"/><meta name="DC.format" content="HTML5"/><meta name="DC.identifier" content="i2c_design_intro"/><meta name="DC.language" content="zh-CN"/><title>设计说明</title><!-- Generated with build number 2024112209. --><meta name="wh-path2root" content="../../../"/><meta name="wh-toc-id" content="i2c_design_intro-d4445e6344"/><meta name="wh-source-relpath" content="topics/sdk/i2c/i2c_design.dita"/><meta name="wh-out-relpath" content="topics/sdk/i2c/i2c_design.html"/>
<link rel="stylesheet" type="text/css" href="../../../webhelp/app/commons.css?buildId=2024112209"/>
<link rel="stylesheet" type="text/css" href="../../../webhelp/app/topic.css?buildId=2024112209"/>
<script src="../../../webhelp/app/options/properties.js?buildId=20250123154945"></script>
<script src="../../../webhelp/app/localization/strings.js?buildId=2024112209"></script>
<script src="../../../webhelp/app/search/index/keywords.js?buildId=20250123154945"></script>
<script defer="defer" src="../../../webhelp/app/commons.js?buildId=2024112209"></script>
<script defer="defer" src="../../../webhelp/app/topic.js?buildId=2024112209"></script>
<link rel="stylesheet" type="text/css" href="../../../webhelp/template/aic-styles-web.css?buildId=2024112209"/><link rel="stylesheet" type="text/css" href="../../../webhelp/template/notes.css?buildId=2024112209"/><link rel="stylesheet" type="text/css" href="../../../webhelp/template/aic-common.css?buildId=2024112209"/><link rel="stylesheet" type="text/css" href="../../../webhelp/template/aic-images.css?buildId=2024112209"/><link rel="stylesheet" type="text/css" href="../../../webhelp/template/footnote.css?buildId=2024112209"/><link rel="stylesheet" type="text/css" href="../../../webhelp/template/aic-web-watermark.css?buildId=2024112209"/><link rel="stylesheet" type="text/css" href="../../../webhelp/template/topic-body-list.css?buildId=2024112209"/></head>
<body id="i2c_design_intro" class="wh_topic_page frmBody">
<a href="#wh_topic_body" class="sr-only sr-only-focusable">
跳转到主要内容
</a>
<header class="navbar navbar-default wh_header">
<div class="container-fluid">
<div class="wh_header_flex_container navbar-nav navbar-expand-md navbar-dark">
<div class="wh_logo_and_publication_title_container">
<div class="wh_logo_and_publication_title">
<a href="http://www.artinchip.com" class=" wh_logo d-none d-sm-block "><img src="../../../company-logo-white.png" alt=" Linux SDK 使用指南 SDK 指南文件 "/></a>
<div class=" wh_publication_title "><a href="../../../index.html"><span class="booktitle"> <span class="ph mainbooktitle">Linux SDK 使用指南</span> <span class="ph booktitlealt">SDK 指南文件</span> </span></a></div>
</div>
</div>
<div class="wh_top_menu_and_indexterms_link collapse navbar-collapse" id="wh_top_menu_and_indexterms_link">
</div>
</div>
</div>
</header>
<div class=" wh_search_input navbar-form wh_topic_page_search search " role="form">
<form id="searchForm" method="get" role="search" action="../../../search.html"><div><input type="search" placeholder="搜索 " class="wh_search_textfield" id="textToSearch" name="searchQuery" aria-label="搜索查询" required="required"/><button type="submit" class="wh_search_button" aria-label="搜索"><span class="search_input_text">搜索</span></button></div></form>
</div>
<div class="container-fluid" id="wh_topic_container">
<div class="row">
<nav class="wh_tools d-print-none navbar-expand-md" aria-label="Tools">
<div data-tooltip-position="bottom" class=" wh_breadcrumb "><ol class="d-print-none"><li><span class="home"><a href="../../../index.html"><span>主页</span></a></span></li><li><div class="topicref" data-id="id"><div class="title"><a href="../../../topics/sdk/chapter-advanced-app.html">高级应用</a><div class="wh-tooltip"><p class="shortdesc">系统、存储、多媒体、接口、安全等模块的详细配置和设计说明。</p></div></div></div></li><li><div class="topicref" data-id="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、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.html">I2C 使用指南</a></div></div></li><li class="active"><div class="topicref" data-id="i2c_design_intro"><div class="title"><a href="../../../topics/sdk/i2c/i2c_design.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_test.html" title="测试指南" aria-label="上一主题: 测试指南" rel="prev"></a></span>
<span class="navnext"><a class="- topic/link link" href="../../../topics/sdk/i2c/i2c_key_procedure.html" title="关键流程设计" aria-label="下一主题: 关键流程设计" rel="next"></a></span> </span></div>
<div class=" wh_print_link print d-none d-md-inline-block "><button onClick="window.print()" title="打印此页" aria-label="打印此页"></button></div>
<button type="button" id="wh_toc_button" class="custom-toggler navbar-toggler collapsed wh_toggle_button navbar-light" aria-expanded="false" aria-label="Toggle publishing table of content" aria-controls="wh_publication_toc">
<span class="navbar-toggler-icon"></span>
</button>
</div>
</nav>
</div>
<div class="wh_content_area">
<div class="row">
<nav id="wh_publication_toc" class="col-lg-3 col-md-3 col-sm-12 d-md-block d-none d-print-none" aria-label="Table of Contents Container">
<div id="wh_publication_toc_content">
<div class=" wh_publication_toc " data-tooltip-position="right"><span class="expand-button-action-labels"><span id="button-expand-action" role="button" aria-label="Expand"></span><span id="button-collapse-action" role="button" aria-label="Collapse"></span><span id="button-pending-action" role="button" aria-label="Pending"></span></span><ul role="tree" aria-label="Table of Contents"><li role="treeitem"><div data-tocid="revinfo_linux-d4445e1079" class="topicref" data-id="revinfo_linux" data-state="leaf"><span role="button" class="wh-expand-btn"></span><div class="title"><a href="../../../topics/revinfo/revinfo_linux.html" id="revinfo_linux-d4445e1079-link">修订记录</a></div></div></li><li role="treeitem" aria-expanded="false"><div data-tocid="id-d4445e1096" class="topicref" data-id="id" data-state="not-ready"><span role="button" tabindex="0" aria-labelledby="button-expand-action id-d4445e1096-link" class="wh-expand-btn"></span><div class="title"><a href="../../../topics/sdk/env/sdk-compile.html" id="id-d4445e1096-link">SDK 编译</a><div class="wh-tooltip"><p class="shortdesc">介绍不同编译环境下 SDK 的详细编译流程。</p></div></div></div></li><li role="treeitem" aria-expanded="false"><div data-tocid="tocId-d4445e1240" class="topicref" data-state="not-ready"><span role="button" tabindex="0" aria-labelledby="button-expand-action tocId-d4445e1240-link" class="wh-expand-btn"></span><div class="title"><a href="../../../topics/sdk/advanced/lb_usage_commands.html" id="tocId-d4445e1240-link">使用指南</a></div></div></li><li role="treeitem" aria-expanded="false"><div data-tocid="concept_rcx_czh_pzb-d4445e1360" class="topicref" data-id="concept_rcx_czh_pzb" data-state="not-ready"><span role="button" tabindex="0" aria-labelledby="button-expand-action concept_rcx_czh_pzb-d4445e1360-link" class="wh-expand-btn"></span><div class="title"><a href="../../../topics/sdk/chapter-app.html" id="concept_rcx_czh_pzb-d4445e1360-link">应用场景</a><div class="wh-tooltip"><p class="shortdesc">描述了 SDK 在不同应用场景中的配置和使用包括系统更新、OTA、安全方案等。</p></div></div></div></li><li role="treeitem" aria-expanded="false"><div data-tocid="id-d4445e1678" class="topicref" data-id="id" data-state="not-ready"><span role="button" tabindex="0" aria-labelledby="button-expand-action id-d4445e1678-link" class="wh-expand-btn"></span><div class="title"><a href="../../../topics/sdk/peripheral/peripheral-intro.html" id="id-d4445e1678-link">外设移植</a><div class="wh-tooltip"><p class="shortdesc"><span class="ph">触摸屏、显示器、WIFI 模块、按键</span>等外设的介绍和使用说明。</p></div></div></div></li><li role="treeitem" aria-expanded="false"><div data-tocid="id-d4445e1964" class="topicref" data-id="id" data-state="not-ready"><span role="button" tabindex="0" aria-labelledby="button-expand-action id-d4445e1964-link" class="wh-expand-btn"></span><div class="title"><a href="../../../topics/sdk/bringup/chapter-bringup.html" id="id-d4445e1964-link">BringUp</a><div class="wh-tooltip"><p class="shortdesc">在硬件上电后快速初始化系统,为操作系统的启动准备好必要的硬件环境。</p></div></div></div></li><li role="treeitem" aria-expanded="true"><div data-tocid="id-d4445e2153" class="topicref" data-id="id" data-state="expanded"><span role="button" tabindex="0" aria-labelledby="button-collapse-action id-d4445e2153-link" class="wh-expand-btn"></span><div class="title"><a href="../../../topics/sdk/chapter-advanced-app.html" id="id-d4445e2153-link">高级应用</a><div class="wh-tooltip"><p class="shortdesc">系统、存储、多媒体、接口、安全等模块的详细配置和设计说明。</p></div></div></div><ul role="group" class="navbar-nav nav-list"><li role="treeitem" aria-expanded="false"><div data-tocid="uBoot-d4445e2170" class="topicref" data-id="uBoot" data-state="not-ready"><span role="button" tabindex="0" aria-labelledby="button-expand-action uBoot-d4445e2170-link" class="wh-expand-btn"></span><div class="title"><a href="../../../topics/sdk/boot/uboot-module.html" id="uBoot-d4445e2170-link">U-Boot</a><div class="wh-tooltip"><p class="shortdesc">启动支持的基本功能以及运行时的基本硬件环境。</p></div></div></div></li><li role="treeitem" aria-expanded="false"><div data-tocid="concept_mtx_tk3_pzb-d4445e3028" class="topicref" data-id="concept_mtx_tk3_pzb" data-state="not-ready"><span role="button" tabindex="0" aria-labelledby="button-expand-action concept_mtx_tk3_pzb-d4445e3028-link" class="wh-expand-btn"></span><div class="title"><a href="../../../topics/sdk/linux/chapter_linux.html" id="concept_mtx_tk3_pzb-d4445e3028-link">Linux</a></div></div></li><li role="treeitem" aria-expanded="false"><div data-tocid="chapter-system-d4445e3198" class="topicref" data-id="chapter-system" data-state="not-ready"><span role="button" tabindex="0" aria-labelledby="button-expand-action chapter-system-d4445e3198-link" class="wh-expand-btn"></span><div class="title"><a href="../../../topics/chapter-title/chapter-system.html" id="chapter-system-d4445e3198-link">系统</a><div class="wh-tooltip"><p class="shortdesc"></p></div></div></div></li><li role="treeitem" aria-expanded="false"><div data-tocid="chapter-memory-d4445e4054" class="topicref" data-id="chapter-memory" data-state="not-ready"><span role="button" tabindex="0" aria-labelledby="button-expand-action chapter-memory-d4445e4054-link" class="wh-expand-btn"></span><div class="title"><a href="../../../topics/chapter-title/chapter-memory-sdk.html" id="chapter-memory-d4445e4054-link">存储</a><div class="wh-tooltip"><p class="shortdesc">SDMC、SPI NAND、SPI NOR 等存储模块的介绍和使用说明。</p></div></div></div></li><li role="treeitem" aria-expanded="false"><div data-tocid="concept_mcc_32s_nbc-d4445e4438" class="topicref" data-id="concept_mcc_32s_nbc" data-state="not-ready"><span role="button" tabindex="0" aria-labelledby="button-expand-action concept_mcc_32s_nbc-d4445e4438-link" class="wh-expand-btn"></span><div class="title"><a href="../../../topics/chapter-title/chapter-multi-media-sdk.html" id="concept_mcc_32s_nbc-d4445e4438-link">多媒体</a><div class="wh-tooltip"><p class="shortdesc">GE、VE、Display、DVP、MPP、MPP 播放器等多媒体模块的介绍和使用说明。</p></div></div></div></li><li role="treeitem" aria-expanded="true"><div data-tocid="concept_nww_hzh_pzb-d4445e5947" 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-d4445e5947-link" class="wh-expand-btn"></span><div class="title"><a href="../../../topics/chapter-title/chapter-interface-sdk.html" id="concept_nww_hzh_pzb-d4445e5947-link">接口</a><div class="wh-tooltip"><p class="shortdesc">CAN、CIR、GPAI、GPIO、I2C、PSADC、PWM 等接口模块的介绍和使用说明。</p></div></div></div><ul role="group" class="navbar-nav nav-list"><li role="treeitem" aria-expanded="false"><div data-tocid="can-d4445e5964" class="topicref" data-id="can" data-state="not-ready"><span role="button" tabindex="0" aria-labelledby="button-expand-action can-d4445e5964-link" class="wh-expand-btn"></span><div class="title"><a href="../../../topics/sdk/can/can_user_guide.html" id="can-d4445e5964-link">CAN 使用指南</a></div></div></li><li role="treeitem" aria-expanded="false"><div data-tocid="cir-d4445e6020" class="topicref" data-id="cir" data-state="not-ready"><span role="button" tabindex="0" aria-labelledby="button-expand-action cir-d4445e6020-link" class="wh-expand-btn"></span><div class="title"><a href="../../../topics/sdk/cir/cir_user_guide.html" id="cir-d4445e6020-link">CIR 使用指南</a></div></div></li><li role="treeitem" aria-expanded="false"><div data-tocid="gpai-user-guide-d4445e6146" class="topicref" data-id="gpai-user-guide" data-state="not-ready"><span role="button" tabindex="0" aria-labelledby="button-expand-action gpai-user-guide-d4445e6146-link" class="wh-expand-btn"></span><div class="title"><a href="../../../topics/sdk/gpai/gpai_user_guide.html" id="gpai-user-guide-d4445e6146-link">GPAI 使用指南</a></div></div></li><li role="treeitem" aria-expanded="true"><div data-tocid="i2c_user_guide-d4445e6288" class="topicref" data-id="i2c_user_guide" data-state="expanded"><span role="button" tabindex="0" aria-labelledby="button-collapse-action i2c_user_guide-d4445e6288-link" class="wh-expand-btn"></span><div class="title"><a href="../../../topics/sdk/i2c/i2c_user_guide.html" id="i2c_user_guide-d4445e6288-link">I2C 使用指南</a></div></div><ul role="group" class="navbar-nav nav-list"><li role="treeitem"><div data-tocid="i2c_configuration-d4445e6302" class="topicref" data-id="i2c_configuration" data-state="leaf"><span role="button" class="wh-expand-btn"></span><div class="title"><a href="../../../topics/sdk/i2c/i2c_config.html" id="i2c_configuration-d4445e6302-link">I2C 配置</a></div></div></li><li role="treeitem"><div data-tocid="i2c_debug_guide-d4445e6316" class="topicref" data-id="i2c_debug_guide" data-state="leaf"><span role="button" class="wh-expand-btn"></span><div class="title"><a href="../../../topics/sdk/i2c/i2c_debug.html" id="i2c_debug_guide-d4445e6316-link">调试指南</a></div></div></li><li role="treeitem"><div data-tocid="i2c_test_guide-d4445e6330" class="topicref" data-id="i2c_test_guide" data-state="leaf"><span role="button" class="wh-expand-btn"></span><div class="title"><a href="../../../topics/sdk/i2c/i2c_test.html" id="i2c_test_guide-d4445e6330-link">测试指南</a></div></div></li><li role="treeitem" aria-expanded="true" class="active"><div data-tocid="i2c_design_intro-d4445e6344" class="topicref" data-id="i2c_design_intro" data-state="expanded"><span role="button" tabindex="0" aria-labelledby="button-collapse-action i2c_design_intro-d4445e6344-link" class="wh-expand-btn"></span><div class="title"><a href="../../../topics/sdk/i2c/i2c_design.html" id="i2c_design_intro-d4445e6344-link">设计说明</a></div></div><ul role="group" class="navbar-nav nav-list"><li role="treeitem"><div data-tocid="i2c_key_procedures-d4445e6358" 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.html" id="i2c_key_procedures-d4445e6358-link">关键流程设计</a></div></div></li><li role="treeitem"><div data-tocid="i2c_data_structure_design-d4445e6372" 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.html" id="i2c_data_structure_design-d4445e6372-link">数据结构设计</a></div></div></li><li role="treeitem"><div data-tocid="i2c_interface_design-d4445e6386" class="topicref" data-id="i2c_interface_design" data-state="leaf"><span role="button" class="wh-expand-btn"></span><div class="title"><a href="../../../topics/sdk/i2c/i2c_interface.html" id="i2c_interface_design-d4445e6386-link">接口设计</a></div></div></li></ul></li></ul></li><li role="treeitem" aria-expanded="false"><div data-tocid="id-d4445e6400" class="topicref" data-id="id" data-state="not-ready"><span role="button" tabindex="0" aria-labelledby="button-expand-action id-d4445e6400-link" class="wh-expand-btn"></span><div class="title"><a href="../../../topics/sdk/mac/mac_user_guide.html" id="id-d4445e6400-link">MAC 使用指南</a></div></div></li><li role="treeitem" aria-expanded="false"><div data-tocid="pbus_user_guide-d4445e6514" class="topicref" data-id="pbus_user_guide" data-state="not-ready"><span role="button" tabindex="0" aria-labelledby="button-expand-action pbus_user_guide-d4445e6514-link" class="wh-expand-btn"></span><div class="title"><a href="../../../topics/sdk/pbus/pbus-user-guide.html" id="pbus_user_guide-d4445e6514-link">PBUS 使用指南</a></div></div></li><li role="treeitem" aria-expanded="false"><div data-tocid="pinctrl_user_guide-d4445e6598" class="topicref" data-id="pinctrl_user_guide" data-state="not-ready"><span role="button" tabindex="0" aria-labelledby="button-expand-action pinctrl_user_guide-d4445e6598-link" class="wh-expand-btn"></span><div class="title"><a href="../../../topics/sdk/pinctrl/pinctrl-user-guide.html" id="pinctrl_user_guide-d4445e6598-link">PINCTRL 使用指南</a></div></div></li><li role="treeitem" aria-expanded="false"><div data-tocid="id-d4445e6738" class="topicref" data-id="id" data-state="not-ready"><span role="button" tabindex="0" aria-labelledby="button-expand-action id-d4445e6738-link" class="wh-expand-btn"></span><div class="title"><a href="../../../topics/sdk/pwm/pwm_user_guide.html" id="id-d4445e6738-link">PWM 使用指南</a></div></div></li><li role="treeitem" aria-expanded="false"><div data-tocid="rtp-user-guide-d4445e6822" class="topicref" data-id="rtp-user-guide" data-state="not-ready"><span role="button" tabindex="0" aria-labelledby="button-expand-action rtp-user-guide-d4445e6822-link" class="wh-expand-btn"></span><div class="title"><a href="../../../topics/sdk/rtp/rtp_user_guide.html" id="rtp-user-guide-d4445e6822-link">RTP 使用指南</a></div></div></li><li role="treeitem" aria-expanded="false"><div data-tocid="spi-d4445e6962" class="topicref" data-id="spi" data-state="not-ready"><span role="button" tabindex="0" aria-labelledby="button-expand-action spi-d4445e6962-link" class="wh-expand-btn"></span><div class="title"><a href="../../../topics/sdk/spi/spi_user_guide.html" id="spi-d4445e6962-link">SPI 使用指南</a></div></div></li><li role="treeitem" aria-expanded="false"><div data-tocid="id-d4445e7075" class="topicref" data-id="id" data-state="not-ready"><span role="button" tabindex="0" aria-labelledby="button-expand-action id-d4445e7075-link" class="wh-expand-btn"></span><div class="title"><a href="../../../topics/sdk/psadc/psadc_user_guide.html" id="id-d4445e7075-link">PSADC 使用指南</a></div></div></li><li role="treeitem" aria-expanded="false"><div data-tocid="uart_user_guide-d4445e7215" class="topicref" data-id="uart_user_guide" data-state="not-ready"><span role="button" tabindex="0" aria-labelledby="button-expand-action uart_user_guide-d4445e7215-link" class="wh-expand-btn"></span><div class="title"><a href="../../../topics/sdk/uart/uart_user_guide.html" id="uart_user_guide-d4445e7215-link">UART 使用指南</a></div></div></li><li role="treeitem" aria-expanded="false"><div data-tocid="usb_user_guide-d4445e7299" class="topicref" data-id="usb_user_guide" data-state="not-ready"><span role="button" tabindex="0" aria-labelledby="button-expand-action usb_user_guide-d4445e7299-link" class="wh-expand-btn"></span><div class="title"><a href="../../../topics/sdk/usb/usb_user_guide.html" id="usb_user_guide-d4445e7299-link">USB 使用指南</a></div></div></li></ul></li><li role="treeitem" aria-expanded="false"><div data-tocid="chapter-safety-d4445e7944" class="topicref" data-id="chapter-safety" data-state="not-ready"><span role="button" tabindex="0" aria-labelledby="button-expand-action chapter-safety-d4445e7944-link" class="wh-expand-btn"></span><div class="title"><a href="../../../topics/chapter-title/chapter-safety-sdk.html" id="chapter-safety-d4445e7944-link">安全</a><div class="wh-tooltip"><p class="shortdesc">SPI ENC、CE、eFuse 等安全模块的介绍和使用说明。</p></div></div></div></li></ul></li></ul></div>
</div>
</nav>
<div class="col-lg-9 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>
<div class=" wh_topic_content body "><main role="main"><article class="- topic/topic concept/concept topic concept" role="article" aria-labelledby="ariaid-title1">
<span class="edit-link" style="font-size:12px; opacity:0.6; text-align:right; vertical-align:middle"><a target="_blank" title="Edit this document" href="http://172.16.35.88/tasks/jdssno1uvvbf2mltu9kb9v3if05d5gopuakboe8hlud18rma/edit/F:/aicdita/aicdita-cn/topics/sdk/i2c/i2c_design.dita">Edit online</a></span><h1 class="- topic/title title topictitle1" id="ariaid-title1">设计说明</h1>
<div class="date inPage">15 Jan 2024</div><div style="color: gray;">
Read time: 2 minute(s)
</div>
<div class="- topic/body concept/conbody body conbody">
<p class="- topic/p p" data-ofbid="d139747e33__20250123155213">源代码位于:<span class="+ topic/ph sw-d/filepath ph filepath">linux-5.10/drivers/i2c/busses/</span></p>
<p class="- topic/p p" data-ofbid="d139747e38__20250123155213"> I2C 的驱动文件如下:</p>
<div class="table-container"><table class="- topic/table table frame-all" id="i2c_design_intro__table_lnt_y5r_21c" data-ofbid="i2c_design_intro__table_lnt_y5r_21c" data-cols="2"><caption></caption><colgroup><col style="width:39.0625%"/><col style="width:60.9375%"/></colgroup><thead class="- topic/thead thead">
<tr class="- topic/row">
<th class="- topic/entry entry colsep-1 rowsep-1" id="i2c_design_intro__table_lnt_y5r_21c__entry__1">文件</th>
<th class="- topic/entry entry colsep-0 rowsep-1" id="i2c_design_intro__table_lnt_y5r_21c__entry__2">说明</th>
</tr>
</thead><tbody class="- topic/tbody tbody">
<tr class="- topic/row">
<td class="- topic/entry entry colsep-1 rowsep-1" headers="i2c_design_intro__table_lnt_y5r_21c__entry__1"><span class="+ topic/ph sw-d/filepath ph filepath">i2c-artinchip.h</span></td>
<td class="- topic/entry entry colsep-0 rowsep-1" headers="i2c_design_intro__table_lnt_y5r_21c__entry__2">aic I2C 公用头文件I2C 模块的寄存器定义,结构体定义等</td>
</tr>
<tr class="- topic/row">
<td class="- topic/entry entry colsep-1 rowsep-1" headers="i2c_design_intro__table_lnt_y5r_21c__entry__1"><span class="+ topic/ph sw-d/filepath ph filepath">i2c-artinchip-master.c</span></td>
<td class="- topic/entry entry colsep-0 rowsep-1" headers="i2c_design_intro__table_lnt_y5r_21c__entry__2">I2C 作为 master 时的驱动文件</td>
</tr>
<tr class="- topic/row">
<td class="- topic/entry entry colsep-1 rowsep-1" headers="i2c_design_intro__table_lnt_y5r_21c__entry__1"><span class="+ topic/ph sw-d/filepath ph filepath">i2c-artinchip-slave.c</span></td>
<td class="- topic/entry entry colsep-0 rowsep-1" headers="i2c_design_intro__table_lnt_y5r_21c__entry__2">I2C 作为 slave 时的驱动文件</td>
</tr>
<tr class="- topic/row">
<td class="- topic/entry entry colsep-1 rowsep-0" headers="i2c_design_intro__table_lnt_y5r_21c__entry__1"><span class="+ topic/ph sw-d/filepath ph filepath">i2c-artinchip-common.c</span></td>
<td class="- topic/entry entry colsep-0 rowsep-0" headers="i2c_design_intro__table_lnt_y5r_21c__entry__2">I2C 一些公用寄存器读写函数的实现,以及 driver 的定义</td>
</tr>
</tbody></table></div>
<section class="- topic/section section" id="i2c_design_intro__section_mnt_y5r_21c" data-ofbid="i2c_design_intro__section_mnt_y5r_21c"><h2 class="- topic/title title sectiontitle">模块架构</h2>
<p class="- topic/p p" data-ofbid="d139747e111__20250123155213">linux 中 C 子系统的体系结构如下图所示</p>
<div class="- topic/p p" data-ofbid="d139747e114__20250123155213">
<br/><div class="imagecenter"><img class="- topic/image image imagecenter" id="i2c_design_intro__image_nnt_y5r_21c" src="../../../images/i2c/subsystem_arch.png" alt="subsystem_arch"/></div><br/>
</div>
<div class="- topic/p p" data-ofbid="d139747e123__20250123155213">在 C 子系统中SOC 厂商需要实现的就是 adapter 部分的驱动I2C adapter 是对 controller 的软件抽象。具体到上图,就是实现
adapter 的 algorithm 以及特定 SOC 的 I2C 代码部分。I2C 模块支持 master 和 slave 两种模式,所以 adapter
的驱动实现也就分为两部分I2C master 驱动和 slave 驱动。<ul class="- topic/ul ul" id="i2c_design_intro__ul_dwk_2vr_21c" data-ofbid="i2c_design_intro__ul_dwk_2vr_21c">
<li class="- topic/li li" data-ofbid="d139747e127__20250123155213">
<p class="- topic/p p" data-ofbid="d139747e129__20250123155213">I2C master</p>
<p class="- topic/p p" data-ofbid="d139747e132__20250123155213">I2C 作为 master 时,驱动的实现主要包括 4 个部分:</p>
<ol class="- topic/ol ol" id="i2c_design_intro__ol_pnt_y5r_21c" data-ofbid="i2c_design_intro__ol_pnt_y5r_21c">
<li class="- topic/li li" data-ofbid="d139747e137__20250123155213">
<p class="- topic/p p" data-ofbid="d139747e139__20250123155213">硬件参数配置:主要是设置 C 工作的主机模式7bit 或 10bit 寻址寻址的从机地址设置FIFO
设置以及总线传输速率等。</p>
</li>
<li class="- topic/li li" data-ofbid="d139747e143__20250123155213">
<p class="- topic/p p" data-ofbid="d139747e145__20250123155213">SCL 时序参数设置:根据设置的总线传输速率,设置 SCL 的高低电平时间。</p>
</li>
<li class="- topic/li li" data-ofbid="d139747e149__20250123155213">
<p class="- topic/p p" data-ofbid="d139747e151__20250123155213">i2c_algorithm 的实现:作为主机端,主要是 xfer 的实现。在驱动实现中,以 message
为单位进行数据的收发,数据的传输采用中断的方式。</p>
</li>
<li class="- topic/li li" data-ofbid="d139747e155__20250123155213">
<p class="- topic/p p" data-ofbid="d139747e157__20250123155213">中断的处理:处理 master 端的数据收发,并产生相应的 start、ack、nack、restart、stop 信号。</p>
</li>
</ol>
</li>
<li class="- topic/li li" data-ofbid="d139747e163__20250123155213">I2C slave<p class="- topic/p p" data-ofbid="d139747e165__20250123155213">I2C 作为从机时,需要一个相应的后端软件(对 C 从设备的软件模拟),该后端软件与 adapter 驱动,组合成具有相应功能的
C 从设备。内核的 C 子系统框架中提供了一个 EEPROM 的软件后端,与 slave 驱动一起,可以作为一个具有 C 接口的 EEPROM
使用。</p><div class="- topic/p p" data-ofbid="d139747e167__20250123155213">
<br/><div class="imagecenter"><img class="- topic/image image imagecenter" id="i2c_design_intro__image_grg_kvr_21c" src="../../../images/i2c/twi_slave.png" width="384" alt="twi_slave"/></div><br/>
</div><p class="- topic/p p" data-ofbid="d139747e175__20250123155213">I2C 作为 slave 时,驱动的实现主要包括 3 个部分:</p><ol class="- topic/ol ol" id="i2c_design_intro__ol_hrg_kvr_21c" data-ofbid="i2c_design_intro__ol_hrg_kvr_21c">
<li class="- topic/li li" data-ofbid="d139747e179__20250123155213">
<p class="- topic/p p" data-ofbid="d139747e181__20250123155213">硬件参数配置:设置 C 工作的从模式FIFO 设置等。</p>
</li>
<li class="- topic/li li" data-ofbid="d139747e185__20250123155213">
<p class="- topic/p p" data-ofbid="d139747e187__20250123155213">i2c_algorithm 的实现:作为从机端,主要是 slave 和 unreg_slave 的实现。reg_slave
用于将一个 client 注册到从模式的 i2c adapter 上unreg_slave 的功能与 slave
相反。</p>
</li>
<li class="- topic/li li" data-ofbid="d139747e191__20250123155213">
<p class="- topic/p p" data-ofbid="d139747e193__20250123155213">中断的处理:处理 C 从机接收到的各种中断信号,并调用相应的回调函数进行数据的读写。</p>
</li>
</ol></li>
</ul></div>
<p class="- topic/p p" data-ofbid="d139747e199__20250123155213">综上I2C 模块的驱动实现,主要的工作有:</p>
<ul class="- topic/ul ul" id="i2c_design_intro__ul_d4q_kvr_21c" data-ofbid="i2c_design_intro__ul_d4q_kvr_21c">
<li class="- topic/li li" data-ofbid="d139747e205__20250123155213">
<p class="- topic/p p" data-ofbid="d139747e207__20250123155213">提供 C 控制器的 platform 驱动,初始化 C 适配器,判断 C 模块工作的主从模式,执行不同的初始化流程。</p>
</li>
<li class="- topic/li li" data-ofbid="d139747e211__20250123155213">
<p class="- topic/p p" data-ofbid="d139747e213__20250123155213">I2C 模块作为主机时,提供 C 适配器的 algorithm并用具体适配器的 xfer 函数填充 i2c_algorithm 的 xfer 指针,并把
algorithm 指针赋值给 i2c_adapter 的 algo 指针。处理 master 端时序的设置以及 I2C
作为主机时的各种中断信号处理。</p>
</li>
<li class="- topic/li li" data-ofbid="d139747e217__20250123155213">
<p class="- topic/p p" data-ofbid="d139747e219__20250123155213">I2C 模块作为从机时,提供 C 适配器的 algorithm实现具体适配器的 slave 和 unreg_slave 函数,并把 algorithm
指针赋值给 i2c_adapter 的 algo 指针。处理 C 作为从机时的各种中断信号处理。</p>
</li>
</ul>
</section>
</div>
</article></main></div>
<div class=" wh_child_links d-print-none "><nav aria-label="Child Links" role="navigation" class="- topic/related-links related-links"><ul class="ullinks"><li class="- topic/link link ulchildlink"><strong><a href="../../../topics/sdk/i2c/i2c_key_procedure.html">关键流程设计</a></strong></li><li class="- topic/link link ulchildlink"><strong><a href="../../../topics/sdk/i2c/i2c_data_struct.html">数据结构设计</a></strong></li><li class="- topic/link link ulchildlink"><strong><a href="../../../topics/sdk/i2c/i2c_interface.html">接口设计</a></strong></li></ul></nav></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-23
</div>
</div>
</div>
</footer>
<button id="go2top" class="d-print-none" title="返回顶部">
<span class="oxy-icon oxy-icon-up"></span>
</button>
<div id="modal_img_large" class="modal">
<span class="close oxy-icon oxy-icon-remove"></span>
<div id="modal_img_container"></div>
<div id="caption"></div>
</div>
<script src="${pd}/publishing/publishing-styles-AIC-template/js/custom.js" defer="defer"></script>
</body>
</html>