Skip to content
体验新版
项目
组织
正在加载...
登录
切换导航
打开侧边栏
OpenHarmony
Docs
提交
d4f55651
D
Docs
项目概览
OpenHarmony
/
Docs
大约 2 年 前同步成功
通知
161
Star
293
Fork
28
代码
文件
提交
分支
Tags
贡献者
分支图
Diff
Issue
0
列表
看板
标记
里程碑
合并请求
0
Wiki
0
Wiki
分析
仓库
DevOps
项目成员
Pages
D
Docs
项目概览
项目概览
详情
发布
仓库
仓库
文件
提交
分支
标签
贡献者
分支图
比较
Issue
0
Issue
0
列表
看板
标记
里程碑
合并请求
0
合并请求
0
Pages
分析
分析
仓库分析
DevOps
Wiki
0
Wiki
成员
成员
收起侧边栏
关闭侧边栏
动态
分支图
创建新Issue
提交
Issue看板
未验证
提交
d4f55651
编写于
5月 12, 2022
作者:
K
king_he
提交者:
Gitee
5月 12, 2022
浏览文件
操作
浏览文件
下载
电子邮件补丁
差异文件
update zh-cn/device-dev/driver/driver-platform-i3c-des.md.
Signed-off-by:
N
king_he
<
6384784@qq.com
>
上级
18f9b2b2
变更
1
隐藏空白更改
内联
并排
Showing
1 changed file
with
18 addition
and
23 deletion
+18
-23
zh-cn/device-dev/driver/driver-platform-i3c-des.md
zh-cn/device-dev/driver/driver-platform-i3c-des.md
+18
-23
未找到文件。
zh-cn/device-dev/driver/driver-platform-i3c-des.md
浏览文件 @
d4f55651
# I3C<a name="1"></a>
# I3C<a name="1"></a>
-
[
概述
](
#section1
)
-
[
功能简介
](
#section2
)
-
[
基本概念
](
#section3
)
-
[
运作机制
](
#section4
)
-
[
约束与限制
](
#section5
)
-
[
使用指导
](
#section6
)
-
[
场景介绍
](
#section7
)
-
[
接口说明
](
#section8
)
-
[
开发步骤
](
#section9
)
-
[
使用实例
](
#section10
)
## 概述<a name="section1"></a>
## 概述<a name="section1"></a>
### 功能简介<a name="section2"></a>
### 功能简介<a name="section2"></a>
I3C(Improved Inter Integrated Circuit)总线是由MIPI Alliance开发的一种简单、低成本的双向二线制同步串行总线。
I3C(Improved Inter Integrated Circuit)总线是由MIPI Alliance开发的一种简单、低成本的双向二线制同步串行总线。
I3C是两线双向串行总线,针对多个传感器从设备进行了优化,并且一次只能由一个I3C主设备控制。相比于I2C,I3C总线拥有更高的速度、更低的功耗,支持带内中断、从设备热接入以及切换当前主设备,同时向后兼容I2C从设备。I3C增加了带内中断(In-Bind Interrupt)功能,支持I3C设备进行热接入操作,弥补了I2C总线需要额外增加中断线来完成中断的不足。I3C总线上允许同时存在I2C设备、I3C从设备和I3C次级主设备。
-
I3C接口定义了完成I3C传输的通用方法集合,包括:
-
I3C接口定义了完成I3C传输的通用方法集合,包括:
I3C控制器管理:打开或关闭I3C控制器。
I3C控制器管理:打开或关闭I3C控制器。
...
@@ -25,17 +15,22 @@ I3C(Improved Inter Integrated Circuit)总线是由MIPI Alliance开发的一
...
@@ -25,17 +15,22 @@ I3C(Improved Inter Integrated Circuit)总线是由MIPI Alliance开发的一
### 基本概念<a name="section3"></a>
### 基本概念<a name="section3"></a>
-
I3C是两线双向串行总线,针对多个传感器从设备进行了优化,并且一次只能由一个I3C主设备控制。 相比于I2C,I3C总线拥有更高的速度、更低的功耗,支持带内中断、从设备热接入以及切换当前主设备,同时向后兼容I2C从设备。
-
IBI(In-Band Interrupt)
-
I3C增加了带内中断(In-Bind Interrupt)功能,支持I3C设备进行热接入操作,弥补了I2C总线需要额外增加中断线来完成中断的不足。
带内中断。在SCL线没有启动信号时,I3C从设备可以通过拉低SDA线使主设备发出SCL启动信号,从而发出带内中断请求。若有多个从机同时发出中断请求,I3C主机则通过从机地址进行仲裁,低地址优先相应。
-
I3C总线上允许同时存在I2C设备、I3C从设备和I3C次级主设备。
-
I3C相关缩略词解释:
-
DAA(Dynamic Address Assignment)
-
IBI(In-Band Interrupt):带内中断。在SCL线没有启动信号时,I3C从设备可以通过拉低SDA线使主设备发出SCL启动信号,从而发出带内中断请求。若有多个从机同时发出中断请求,I3C主机则通过从机地址进行仲裁,低地址优先相应。
动态地址分配。I3C支持对从设备地址进行动态分配从而避免地址冲突。在分配动态地址之前,连接到I3C总线上的每个I3C设备都应以两种方式之一来唯一标识:
-
DAA(Dynamic Address Assignment):动态地址分配。I3C支持对从设备地址进行动态分配从而避免地址冲突。在分配动态地址之前,连接到I3C总线上的每个I3C设备都应以两种方式之一来唯一标识:
1)设备可能有一个符合I2C规范的静态地址,主机可以使用此静态地址;
1)设备可能有一个符合I2C规范的静态地址,主机可以使用此静态地址;
2)在任何情况下,设备均应具有48位的临时ID。 除非设备具有静态地址且主机使用静态地址,否则主机应使用此48位临时ID。
2)在任何情况下,设备均应具有48位的临时ID。 除非设备具有静态地址且主机使用静态地址,否则主机应使用此48位临时ID。
-
CCC(Common Command Code) :通用命令代码,所有I3C设备均支持CCC,可以直接将其传输到特定的I3C从设备,也可以同时传输到所有I3C从设备。
-
BCR(Bus Characteristic Register):总线特性寄存器,每个连接到 I3C 总线的 I3C 设备都应具有相关的只读总线特性寄存器 (BCR),该寄存器描述了I3C兼容设备在动态地址分配和通用命令代码中的作用和功能。
-
CCC(Common Command Code)
-
DCR(Device Characteristic Register):设备特性寄存器,连接到 I3C 总线的每个 I3C 设备都应具有相关的只读设备特性寄存器 (DCR)。 该寄存器描述了用于动态地址分配和通用命令代码的 I3C 兼容设备类型(例如,加速度计、陀螺仪等)。
通用命令代码,所有I3C设备均支持CCC,可以直接将其传输到特定的I3C从设备,也可以同时传输到所有I3C从设备。
-
BCR(Bus Characteristic Register)
总线特性寄存器,每个连接到 I3C 总线的 I3C 设备都应具有相关的只读总线特性寄存器 (BCR),该寄存器描述了I3C兼容设备在动态地址分配和通用命令代码中的作用和功能。
-
DCR(Device Characteristic Register)
设备特性寄存器,连接到 I3C 总线的每个 I3C 设备都应具有相关的只读设备特性寄存器 (DCR)。 该寄存器描述了用于动态地址分配和通用命令代码的 I3C 兼容设备类型(例如,加速度计、陀螺仪等)。
### 运作机制<a name="section4"></a>
### 运作机制<a name="section4"></a>
...
@@ -48,7 +43,7 @@ I3C(Improved Inter Integrated Circuit)总线是由MIPI Alliance开发的一
...
@@ -48,7 +43,7 @@ I3C(Improved Inter Integrated Circuit)总线是由MIPI Alliance开发的一
### 约束与限制<a name="section5"></a>
### 约束与限制<a name="section5"></a>
I3C模块当前仅支持轻量和小型系统内核(LiteOS)
。
I3C模块当前仅支持轻量和小型系统内核(LiteOS)。
## 使用指导<a name="section6"></a>
## 使用指导<a name="section6"></a>
...
@@ -74,7 +69,7 @@ I3C可连接单个或多个I3C、I2C从器件,它主要用于:
...
@@ -74,7 +69,7 @@ I3C可连接单个或多个I3C、I2C从器件,它主要用于:
| I3cRequestIbi | 请求带内中断 |
| I3cRequestIbi | 请求带内中断 |
| I3cFreeIbi | 释放带内中断 |
| I3cFreeIbi | 释放带内中断 |
> **说明:**
> **说明:**
<br>
>本文涉及的所有接口,仅限内核态使用,不支持在用户态使用。
>本文涉及的所有接口,仅限内核态使用,不支持在用户态使用。
### 开发步骤<a name="section9"></a>
### 开发步骤<a name="section9"></a>
...
@@ -102,7 +97,7 @@ DevHandle I3cOpen(int16_t number);
...
@@ -102,7 +97,7 @@ DevHandle I3cOpen(int16_t number);
| NULL | 打开I3C控制器失败 |
| NULL | 打开I3C控制器失败 |
| 控制器句柄 | 打开的I3C控制器句柄 |
| 控制器句柄 | 打开的I3C控制器句柄 |
假设系统中存在8个I3C控制器,编号从0到7,
那么我们现在
打开1号控制器:
假设系统中存在8个I3C控制器,编号从0到7,
以下示例代码为
打开1号控制器:
```
c
```
c
DevHandle
i3cHandle
=
NULL
;
/* I3C控制器句柄 /
DevHandle
i3cHandle
=
NULL
;
/* I3C控制器句柄 /
...
...
编辑
预览
Markdown
is supported
0%
请重试
或
添加新附件
.
添加附件
取消
You are about to add
0
people
to the discussion. Proceed with caution.
先完成此消息的编辑!
取消
想要评论请
注册
或
登录