# I3C
Source: [https://docs.qualcomm.com/doc/80-70014-8Y/topic/i3c.html](https://docs.qualcomm.com/doc/80-70014-8Y/topic/i3c.html)
I3C 接口旨在为连接的 I3C 目标设备提供快速、低成本、低功耗的 2 线制数字接口。I3C 接口用于改进 I2C 接口的功能，保留向后兼容性。2 线制串行接口最高支持 12.5 MHz。传统 I2C 设备可与之在同一总线上共存。I3C 总线支持带内中断和热加入。同步时序支持异步时间戳。
在写操作期间，转换位为 8 位数据奇偶校验。在读操作期间，控制器使用转换位来决定是继续处理下一个数据还是中止读操作。START 条件后面的地址为开漏式（仲裁阶段）。重复 START 条件后面的地址为推挽式。数据阶段既可以是推挽式也可以是开漏式，具体取决于目标设备是否支持 I3C（对于混合总线，I3C 控制器可以寻址 I2C 目标）。下图说明了 I3C 硬件和软件实体。
Figure : I3C 框图
I3C 架构的主要特性如下：
- I3C 控制器驱动程序软件 – 软件特权实体，可进行枚举和总线配置。
- I3C 客户端软件 – 使用 I3C 总线对设备进行读/写操作的软件实体。
### I3C 数据包帧结构
帧以 START 开头，后面依次为命令 (8)、数据 (8)、转换 (1) 和 STOP。
 
其中：
- ACK：应答（SDA 低电平）
- S：启动条件
- Sr：重复启动条件
- P：停止条件
- T：转换位（代替 ACK/NACK）
### I3C 总线初始化
I3C 总线初始化步骤如下：
1. I3C 控制器驱动程序软件初始化 I3C 控制器（固件和配置设置）。
2. I3C 控制器驱动程序软件读取 I3C 配置和设备数据库，包括：
- I2C 静态地址设备列表。
- I3C 静态地址设备列表。
- 预期的 I3C 动态设备列表：厂商 ID、设备 ID、预定义的动态地址以及相关驱动程序。
- 可选支持热加入的设备（厂商 ID、设备 ID 和预定义地址）。
3. 通过使用 I3C 控制器软件，驱动程序将枚举总线上的设备（设置本地地址）。
4. I3C 控制器驱动程序软件将所需设备和总线特性的相关信息写入 I3C 控制器：
- 工作频率
- 纯/传统 I2C 模式
- SDR/HDR 启用/禁用（和类型）
- 支持 IBI 的设备和预期的数据字节
5. I3C 客户端软件栈接收有关 I3C 配置和设备数据库的以下信息。
- I2C 静态地址设备列表。
- I3C 静态地址设备列表。
- 预期的 I3C 动态设备列表：厂商 ID、设备 ID、预定义的动态地址以及相关驱动程序。
- 可选支持热加入的设备（厂商 ID、设备 ID 和预定义地址）。
## I3C 特性
Source: [https://docs.qualcomm.com/doc/80-70014-8Y/topic/i3c.html](https://docs.qualcomm.com/doc/80-70014-8Y/topic/i3c.html)
aDSP/SDC I3C 子系统支持以下特性。
- 地址阶段的频率为 400 kHz。
- 数据阶段的频率为 12,500 kHz。
- 向后兼容传统 I2C。
- 动态寻址目标。
- 单数据速率 (SDR) 模式。
- 符合 MIPI I3C 规范的 CCC 命令。
## I3C 接口
Source: [https://docs.qualcomm.com/doc/80-70014-8Y/topic/i3c.html](https://docs.qualcomm.com/doc/80-70014-8Y/topic/i3c.html)
aDSP/SLPI 软件中的 I3C 用例支持传感器目标设备通信。
Note: I3C 不支持 Linux 用例。
下表列出了针对目标通信的 I3C 功能的软件驱动程序和配置支持。
Table : aDSP/SLPI/SDC 目标通信
| 文件类型 | 说明 |
| --- | --- |
| QUP v3 串行引擎配置 | 有关 aDSP 子系统中用于启用 I3C 接口的 QUP v3 串行引擎配置设置，可访问以下文件路径。
- /firmware/qualcomm-linux-spf-1-0_ap_standard_oem_nomodem/ADSP.HT.5.5.c8/adsp_proc/core/settings/buses/qup_common/config/<chipset>/adsp/ssc/qup_devcfg.c
- /firmware/qualcomm-linux-spf-1-0_ap_standard_oem_nomodem/ADSP.HT.5.5.c8/adsp_proc/core/settings/buses/qup_fw/config/<chipset>/fw_devcfg.c
- /firmware/qualcomm-linux-spf-1-0_ap_standard_oem_nomodem/ADSP.HT.5.5.c8/adsp_proc/core/settings/buses/qup_common/config/<chipset>/adsp/ssc/qup_devcfg.json
|
| 固件配置设置 | 有关在 aDSP 软件中配置 I3C 的 QUP v3 串行引擎固件设置，可参见以下文件。
- /firmware/qualcomm-linux-spf-1-0_ap_standard_oem_nomodem/ADSP.HT.5.5.c8/adsp_proc/core/settings/buses/qup_fw/config/<chipset>/fw_devcfg.c
- /firmware/qualcomm-linux-spf-1-0_ap_standard_oem_nomodem/ADSP.HT.5.5.c8/adsp_proc/core/settings/buses/qup_fw/config/<chipset>/fw_devcfg.xml
|
| 公共 API | 有关 I3C 软件 API 及其使用信息，参见以下头文件。
- api/buses/i2c_api.h
- api/buses/qup_common.h
|
## I3C 软件
Source: [https://docs.qualcomm.com/doc/80-70014-8Y/topic/i3c.html](https://docs.qualcomm.com/doc/80-70014-8Y/topic/i3c.html)
在启动序列期间，QUP v3 串行引擎的 I3C 固件通过 SSC QUP 加载。配置文件位于 aDSP 编译版本中。用于为特定 QUP v3 串行引擎实例启用 I3C 配置的源代码路径为 /firmware/qualcomm-linux-spf-1-0\_ap\_standard\_oem\_nomodem/ADSP.HT.5.5.c8/adsp\_proc/core/settings/buses/qup\_fw/config/<chipset>/fw\_devcfg.c 和 /firmware/qualcomm-linux-spf-1-0\_ap\_standard\_oem\_nomodem/ADSP.HT.5.5.c8/adsp\_proc/core/settings/buses/qup\_fw/config/<chipset>/fw\_devcfg.xml。
向 SSC QUP SE0 或 SE1 中加载 I3C 固件的示例。
se_cfg se0_cfg = { 0x80000, SE_PROTOCOL_I3C, GSI, TRUE, TRUE };
se_cfg se1_cfg = { 0x84000, SE_PROTOCOL_I3C, GSI, TRUE, TRUE };Copy to clipboard
**GPIO 配置**：QUP 通用驱动程序中的每个串行引擎均采用默认 GPIO 配置（根据芯片组特定的配置中的协议）。QUP 通用驱动程序根据串行引擎中加载的协议获取 GPIO 配置。用于特定 I3C 串行引擎实例的 GPIO 配置的源代码路径为 /firmware/qualcomm-linux-spf-1-0\_ap\_standard\_oem\_nomodem/ADSP.HT.5.5.c8/adsp\_proc/core/settings/buses/qup\_common/config/<chipset>/adsp/ssc/qup\_instance\_mapping.c。
可按照如下所示覆盖默认 GPIO 配置：
{ .instance_id = 1 , //Instance ID
.qup = QUP_SSC, //QUP Type
.se_index = 0, //SE ID
.se_data = NULL, //devcfg_map
.protocol_io_cfg = {
TLMM_MAP(TLMM_GPIO_KEEPER ,TLMM_GPIO_2MA,TLMM_GPIO_KEEPER ), // SLEEP CFG
TLMM_MAP(TLMM_GPIO_NO_PULL,TLMM_GPIO_6MA,TLMM_GPIO_KEEPER ), //SPI CFG
TLMM_MAP(TLMM_GPIO_NO_PULL,TLMM_GPIO_2MA,TLMM_GPIO_NO_PULL), // UART CFG
TLMM_MAP(TLMM_GPIO_PULL_UP,TLMM_GPIO_2MA,TLMM_GPIO_NO_PULL), //I2C CFG
TLMM_MAP(TLMM_GPIO_PULL_UP,TLMM_GPIO_2MA,TLMM_GPIO_KEEPER ) //I3C CFG
},
.se_exclusive = TRUE,
}
Copy to clipboard
TLMM\_MAP 是用于初始化工作和休眠状态 GPIO 配置的宏。以下为 TLMM\_MAP 宏的使用示例：
TLMM_MAP (active state pull type, drive strength, sleep state pull type)Copy to clipboard
Last Published: Aug 22, 2024
[Previous Topic
I2C](https://docs.qualcomm.com/bundle/publicresource/80-70014-8Y/topics/i2c.md) [Next Topic
PCIe](https://docs.qualcomm.com/bundle/publicresource/80-70014-8Y/topics/pcie.md)