I2C - Qualcomm Dragonwing Documentation

集成电路间总线（I2C）是一种双向 2 线总线，是 Philips 于 20 世纪 80 年代开发的高效 IC 间控制总线。总线上的每个设备都有自己唯一的地址（在由 Philips 领导的 I2C 总机构注册）。I2C 核心支持多控制器模式以及 10 位目标地址和 10 位可扩展地址。有关 I2C 的更多信息，请参阅 https://www.i2c-bus.org/fileadmin/ftp/i2c_bus_specification_1995.pdf。

I2C 通信序列概述

下图展示了 I2C 中控制器与目标设备之间的通信序列。

图：I2C 控制器与目标设备通信序列

例如，任何设备都不能使用 I2C 规范中列出的 1111-0XX 以及时钟频率为 3.4 MHz 的高速模式。以下是 I2C 模式及其支持的速度。

标准模式：100 kbps
快速模式：400 kbps
快速模式增强版（Fast mode plus）：1 Mbps

支持的最大带宽为 1 MHz。

I2C 数据包格式

控制器发送 7 位或 10 位地址，如下图所示。除地址外，还会发送 1 位读/写位以指示操作类型。数据以 8 位为一组在 SDA 线上传输。每传输一个字节，接收数据的设备都会回送一个 ACK 位（共九个时钟脉冲）。

ACK 位为低电平：接收数据并准备好接受下一个字节。
ACK 位为高电平：接收数据但无法再接受更多数据。控制器随后以 STOP 序列终止传输。

图：I2C 数据包

I2C 序列

当 SCL 为高电平时，SDA 必须保持稳定且不能改变。只有当时钟线为低电平时，数据线才能改变。但是，有两个例外：START 和 STOP 序列。

图：I2C 序列

I2C 特性

本节介绍 I2C 串行引擎传输模式以及每种模式的不同使用场景。下表列出了在各个 I2C 子系统驱动程序中启用的传输模式。 表：I2C 传输模式

子系统	传输模式	说明
Linux	FIFO（低速） CPU DMA（高速） GSI	支持 100 kHz、400 kHz 和 1000 kHz 总线速度支持符合 I2C 规范的 7 位目标地址
Boot	FIFO
aDSP/Qualcomm TEE/SDC	FIFO

I2C 接口组件

本节提供有关子系统驱动程序、内核设备树节点以及相关文档的信息。 表：I2C 接口：Linux

文件类型	说明
设备树源文件	QCS6490 和 QCS5430：https://git.linaro.org/kernel-org/linux-next.git/tree/arch/arm64/boot/dts/qcom/sc7280.dtsi Dragonwing IQ-9075：https://github.com/torvalds/linux/blob/master/arch/arm64/boot/dts/qcom/sa8775p.dtsi Dragonwing IQ-615：https://git.kernel.org/pub/scm/linux/kernel/git/qcom/linux.git/tree/arch/arm64/boot/dts/qcom/qcs615.dtsi?h=arm64-for-6.16
`Pinctrl` 设置	QCS6490 和 QCS5430：https://git.linaro.org/kernel-org/linux-next.git/tree/arch/arm64/boot/dts/qcom/sc7280.dtsi Dragonwing IQ-9075：https://github.com/torvalds/linux/blob/master/arch/arm64/boot/dts/qcom/sa8775p.dtsi Dragonwing IQ-615：https://git.kernel.org/pub/scm/linux/kernel/git/qcom/linux.git/tree/arch/arm64/boot/dts/qcom/qcs615.dtsi?h=arm64-for-6.16
Qualcomm TEE 设置	`/firmware/qualcomm-linux-spf-1-0_ap_standard_oem_nomodem/TZ.XF.5.0/trustzone_images/core/settings/buses/qup_accesscontrol/qupv3/config/<chipset>/QUPAC_Access.c`

表：I2C 接口：Boot

文件类型	说明
QUP v3 串行引擎配置	QUP v3 串行引擎：`/firmware/qualcomm-linux-spf-1-0_ap_standard_oem_nomodem/BOOT.MXF.1.0.c1/boot_images/boot/Settings/Soc/<chipset>/Core/Buses/qup_common/<chipset>-qupv3.dtsi` GPIO 配置：`/firmware/qualcomm-linux-spf-1-0_ap_standard_oem_nomodem/BOOT.MXF.1.0.c1/boot_images/boot/Settings/Soc/<chipset>/Core/Buses/qup_common/<chipset>-qupv3-pinctrl.dtsi`
Qualcomm TEE 设置	`/firmware/qualcomm-linux-spf-1-0_ap_standard_oem_nomodem/TZ.XF.5.0/trustzone_images/core/settings/buses/qup_accesscontrol/qupv3/config/<chipset>/QUPAC_Access.c`

表：I2C 接口：aDSP/SLPI/SDC

文件类型	说明
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` `settings/buses/qup_common/config/<chipset>/adsp/ssc/qup_devcfg.json`
固件配置设置	`/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`

表：I2C 接口：Qualcomm TEE

文件类型说明

QUP v3 串行引擎配置

文件类型	说明
QUP v3 串行引擎配置	`/firmware/qualcomm-linux-spf-1-0_ap_standard_oem_nomodem/TZ.XF.5.0/trustzone_images/core/settings/buses/i2c/qupv3/config/<chipset>/tz/i2c_devcfg_user.h` `/firmware/qualcomm-linux-spf-1-0_ap_standard_oem_nomodem/TZ.XF.5.0/trustzone_images/core/settings/buses/i2c/qupv3/config/<chipset>/tz/i2c_devcfg_user.c` `/firmware/qualcomm-linux-spf-1-0_ap_standard_oem_nomodem/TZ.XF.5.0/trustzone_images/core/settings/buses/i2c/qupv3/config/<chipset>/tz/i2c_devcfg.xml`
Qualcomm TEE 设置	`/firmware/qualcomm-linux-spf-1-0_ap_standard_oem_nomodem/TZ.XF.5.0/trustzone_images/core/settings/buses/qup_accesscontrol/qupv3/config/<chipset>/QUPAC_Access.c`

/firmware/qualcomm-linux-spf-1-0_ap_standard_oem_nomodem/TZ.XF.5.0/trustzone_images/core/settings/buses/i2c/qupv3/config/<chipset>/tz/i2c_devcfg_user.h
/firmware/qualcomm-linux-spf-1-0_ap_standard_oem_nomodem/TZ.XF.5.0/trustzone_images/core/settings/buses/i2c/qupv3/config/<chipset>/tz/i2c_devcfg_user.c
/firmware/qualcomm-linux-spf-1-0_ap_standard_oem_nomodem/TZ.XF.5.0/trustzone_images/core/settings/buses/i2c/qupv3/config/<chipset>/tz/i2c_devcfg.xml

Qualcomm TEE 设置

/firmware/qualcomm-linux-spf-1-0_ap_standard_oem_nomodem/TZ.XF.5.0/trustzone_images/core/settings/buses/qup_accesscontrol/qupv3/config/<chipset>/QUPAC_Access.c

I2C API

本节列出了以下子系统的 I2C API。

Linux：
- https://github.com/torvalds/linux/blob/master/include/linux/i2c.h。
- https://github.com/torvalds/linux/blob/master/include/linux/i2c-dev.h。
Boot：boot_images/boot/QcomPkg/Include/i2c_api.h
aDSP/SDC/SLPI：adsp_proc/core/api/buses/i2c_api.h
Qualcomm TEE：trustzone_images/core/buses/api/i2c/qupv3/i2c_api.h

I2C 软件设备树配置

本节提供有关 I2C 设备树配置以及设备节点文档的信息。

Linux

有关配置设置文件，请参阅以下 DTSI 文件。

QCS6490 和 QCS5430：https://git.linaro.org/kernel-org/linux-next.git/tree/arch/arm64/boot/dts/qcom/sc7280.dtsi
Dragonwing IQ-9075：https://github.com/torvalds/linux/blob/master/arch/arm64/boot/dts/qcom/sa8775p.dtsi
Dragonwing IQ-615：https://git.kernel.org/pub/scm/linux/kernel/git/qcom/linux.git/tree/arch/arm64/boot/dts/qcom/qcs615.dtsi?h=arm64-for-6.16

有关更多详细信息，请参阅位于 https://github.com/torvalds/linux/blob/master/Documentation/devicetree/bindings/i2c/qcom%2Ci2c-geni-qcom.yaml 的 i2c-geni-qcom.yaml 文件，以及位于 https://github.com/torvalds/linux/blob/master/drivers/i2c/busses/i2c-qcom-geni.c 文件中的 I2C 驱动程序。

i2c1: i2c@984000 {
compatible = "qcom,geni-i2c";
reg = <0 0x00984000 0 0x4000>;
clocks = <&gcc GCC_QUPV3_WRAP0_S1_CLK>;
clock-names = "se";
pinctrl-names = "default";
pinctrl-0 = <&qup_i2c1_data_clk>;
interrupts = <GIC_SPI 602 IRQ_TYPE_LEVEL_HIGH>;
#address-cells = <1>;
#size-cells = <0>;
interconnects = <&clk_virt MASTER_QUP_CORE_0 0 &clk_virt SLAVE_QUP_CORE_0 0>,
		<&gem_noc MASTER_APPSS_PROC 0 &cnoc2 SLAVE_QUP_0 0>,
		<&aggre1_noc MASTER_QUP_0 0 &mc_virt SLAVE_EBI1 0>;
interconnect-names = "qup-core", "qup-config",
		"qup-memory";
power-domains = <&rpmhpd SC7280_CX>;
required-opps = <&rpmhpd_opp_low_svs>;
	        dmas = <&gpi_dma0 0 1 QCOM_GPI_I2C>,
		 <&gpi_dma0 1 1 QCOM_GPI_I2C>;
dma-names = "tx", "rx";
status = "disabled";
			};

有关 GPIO pinctrl 配置的内核文档，请参阅以下文件。

QCS6490 和 QCS5430：https://git.linaro.org/kernel-org/linux-next.git/tree/arch/arm64/boot/dts/qcom/sc7280.dtsi
Dragonwing IQ-9075：https://github.com/torvalds/linux/blob/master/arch/arm64/boot/dts/qcom/sa8775p.dtsi
Dragonwing IQ-615：https://git.kernel.org/pub/scm/linux/kernel/git/qcom/linux.git/tree/arch/arm64/boot/dts/qcom/qcs615.dtsi?h=arm64-for-6.16
Documentation/devicetree/bindings/pinctrl/qcom,<chipset>-tlmm.yaml

QUP v3 串行引擎 GPIO 的相应配置存在于 pinctrl.dtsi 文件中并已完成映射。

qup_i2c1_data_clk: qup-i2c1-data-clk-state {
				pins = "gpio4", "gpio5";
				function = "qup01";
			};

在 QUPAC_Access.c 文件中，确保指定协议的特定串行引擎配置用于 I2C 协议。Qualcomm TEE 构建：

/firmware/qualcomm-linux-spf-1-0_ap_standard_oem_nomodem/TZ.XF.5.0/trustzone_images/core/settings/buses/qup_accesscontrol/qupv3/config/<chipset>/QUPAC_Access.c

修改所需的设置，或参考为 QUP v3 串行引擎实例分配的默认设置。以下示例配置在 I2C 中默认启用。

/*   PeriphID,         ProtocolID,               Mode,  NsOwner,       bAllowFifo, bLoad, bModExcl  */
  { QUPV3_0_SE0, QUPV3_PROTOCOL_I2C,     QUPV3_MODE_FIFO, AC_HLOS,            TRUE,  TRUE,  FALSE }, // LT9611 and QPS615 I2C
  { QUPV3_0_SE1, QUPV3_PROTOCOL_I2C,     QUPV3_MODE_FIFO, AC_HLOS,            TRUE,  TRUE,  FALSE }, // APPS I2C - PCIE/ USB Type C
  { QUPV3_0_SE2, QUPV3_PROTOCOL_I2C,     QUPV3_MODE_FIFO, AC_HLOS,            TRUE,  TRUE,  FALSE }, // SMB / LS1 I2C

{ QUPV3_1_SE1, QUPV3_PROTOCOL_I2C,     QUPV3_MODE_FIFO, AC_HLOS,            TRUE,  TRUE,  FALSE }, // NFC I2C
 { QUPV3_1_SE2, QUPV3_PROTOCOL_I2C,     QUPV3_MODE_FIFO, AC_HLOS,            TRUE,  TRUE,  FALSE }, // HDMI OUT for
 { QUPV3_1_SE5, QUPV3_PROTOCOL_I2C,     QUPV3_MODE_GSI,  AC_HLOS,            FALSE, TRUE,  FALSE}, // Legacy Touch

Boot

在 UEFI 中配置 I2C。可从以下位置访问配置文件。
- QUP v3 串行引擎：/firmware/qualcomm-linux-spf-1-0_ap_standard_oem_nomodem/BOOT.MXF.1.0.c1/boot_images/boot/Settings/Soc/<chipset>/Core/Buses/qup_common/<chipset>-qupv3.dtsi
- Qualcomm TEE 设置：/firmware/qualcomm-linux-spf-1-0_ap_standard_oem_nomodem/TZ.XF.5.0/trustzone_images/core/settings/buses/qup_accesscontrol/qupv3/config/<chipset>/QUPAC_Access.c

注意：有关 boot 中的配置设置，请参阅 Boot。

在 UEFI 中通过 /QcomPkg/SocPkg/<chipset>/LAA/Core.fdf 启用 I2C 协议。

-#INF QcomPkg/Drivers/I2CDxe/I2CDxe.inf 
+INF QcomPkg/Drivers/I2CDxe/I2CDxe.inf

应用程序启用 I2C 接口。然后应用程序通过 I2C 接口执行读写操作。有关 I2C 函数使用的信息，请参阅 boot_images/QcomPkg/QcomTestPkg/I2CApp/I2Ceeprom.c。
在代码中按顺序添加 i2c_open->i2c_read/i2c_write->i2c_close。
在调用 I2c_open 之前，通过验证设备/UEFI 启动日志确保 GpiDxe.inf 和 I2C.efi 文件已加载。

aDSP/SDC

使用 SSC QUP 的固件加载在 aDSP 子系统的启动序列期间执行。配置文件位于 aDSP 构建中的以下位置：

/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

以下配置是加载了 I2C 固件的 SSC QUP SE1、SE2 和 SE3 设置的示例。

se_cfg se1_cfg = { 0x84000, SE_PROTOCOL_I2C,    GSI,     TRUE, TRUE  };
se_cfg se2_cfg = { 0x88000, SE_PROTOCOL_I2C,    GSI,     TRUE, TRUE  };
se_cfg se3_cfg = { 0x8C000, SE_PROTOCOL_I2C,    GSI,     FALSE, TRUE  };

GPIO 配置：QUP v3 通用驱动程序中的每个串行引擎都配置了默认 GPIO 配置。QUP v3 通用驱动程序会根据串行引擎中加载的协议选取 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          =  5 ,         //Instance ID
        .qup              =  QUP_SSC,    //QUP Type
        .se_index         =  4,          //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,
}

TLMM_MAP 是用于初始化活动和睡眠状态 GPIO 配置的宏。例如，TLMM_MAP 宏的示例用法。

TLMM_MAP (active state pull type, drive strength, sleep state pull type)

Qualcomm TEE

可以按如下方式配置用于 I2C 的 QUP v3 串行引擎。文件路径：

settings/buses/i2c/qupv3/config/<chipset>/tz/i2c_devcfg_user.h

#define ENABLE_I2C_08

ENABLE_I2C_<num> 的编号基于串行引擎的序号（从 0 开始）。例如，如果有两个 QUP：QUPV3_0 有七个串行引擎，QUPV3_1 有八个串行引擎，那么用户必须启用 QUPV3_2_SE2。该宏应为 ENABLE_I2C_08。 GPIO 配置：驱动强度和上下拉按引脚配置，SDA 位于索引 0，SCL 位于索引 1。文件路径：

settings/buses/i2c/qupv3/config/<chipset>/tz/i2c_devcfg_user.c

i2c_plat_device_config_user i2c_device_user_config_0 =
{
    {0,0},        //.drive_strength index: 0 - SDA, 1 - SCL
                                    value: 0 - 2MA, 1 - 4MA, 2 - 6MA
    {3,3},       //.pull  index: 0 - SDA, 1 - SCL
                       value: 0 - NO_PULL, 1 = PULL_DOWN, 2 = KEEPER, 3 = PULL_UP
    0xFF,        //.gpii_idx 
    0,           //.mode_select  not supported for TZ
    0,           //.flags not supported for TZ
};

QUPAC 访问控制：控制来自 Qualcomm TEE 子系统的固件加载和访问控制权限，在以下 QUPAC 访问文件中配置：

/firmware/qualcomm-linux-spf-1-0_ap_standard_oem_nomodem/TZ.XF.5.0/trustzone_images/core/settings/buses/qup_accesscontrol/qupv3/config/<chipset>/QUPAC_Access.c

配置 I2C 接口

本节提供有关 I2C 软件驱动程序内核配置和设备树节点更改的信息。

Linux

支持 I2C 接口需要以下驱动程序内核配置。

驱动程序源代码：https://github.com/torvalds/linux/blob/master/drivers/i2c/busses/i2c-qcom-geni.c

内核 defconfig 文件路径：

<workspace_path_of_LINUX_kernel_image>/sources/kernel/kernel_platform/kernel/arch/arm64/configs/qcom_defconfig

需要启用以下内核配置。

CONFIG_QCOM_GENI_SE=y
CONFIG_I2C_CHARDEV=m
CONFIG_I2C_QCOM_GENI=m，用于配置用户空间应用程序
CONFIG_QCOM_GPI_DMA=m，用于启用 GSI 支持

要启用 I2C DT 节点以进行验证，请将以下补丁应用到 /arch/arm64/boot/dts/qcom/<chipset>.dtsi 文件。

diff --git a/arch/arm64/boot/dts/qcom/<chipset>.dtsi b/arch/arm64/boot/dts/qcom/<chipset>.dtsi
index 8575f0b..cced7c0 100644
--- a/arch/arm64/boot/dts/qcom/<chipset>.dtsi
+++ b/arch/arm64/boot/dts/qcom/<chipset>.dtsi
@@ -6865,3 +6865,7 @@
 <GIC_PPI 10 IRQ_TYPE_LEVEL_LOW>;
 };
 };
+
+ &i2c1 {
+ status = "ok";
+};

注意：您应编译内核配置和设备树更改。编译后，可以将镜像加载到设备以验证接口。有关接口验证的信息，请参阅 Verify I2C interface 部分。

验证 I2C 接口

本节介绍 I2C 驱动程序和 Qualcomm 驱动程序的验证过程与测试结果。

Linux

有关上游 I2C 内核测试应用程序，请参阅 https://cdn.kernel.org/pub/software/utils/i2c-tools/i2c-tools-4.3.tar.gz。要交叉编译工具，请执行以下操作。

从 https://cdn.kernel.org/pub/software/utils/i2c-tools/i2c-tools-4.3.tar.gz 下载 i2c-tool。
从下载的 tar 文件中提取工具。
tar -xzvf <i2c-tool-path>
将当前目录切换到 i2c-tool 路径。
cd <i2c-tool-path>

安装工具。

sudo apt-get install gcc-aarch64-linux-gnu

设置交叉编译环境。
export CC=aarch64-linux-gnu-gcc
编译工具。
make USE_STATIC_LIB=1
二进制文件生成于 <i2c-tool-path>/tools/。

通过在 SSH shell 中检查 dev 节点（/dev/i2c-0 和 /dev/i2c-1）来验证驱动程序，或使用 ADB shell。有关如何运行 SSH 的更多信息，请参阅 Use SSH 部分。 验证 I2C 驱动程序

要验证 I2C 驱动程序，请执行以下操作：
1. 在 permissive 模式下打开 SSH shell，或使用 ADB shell。
2. 挂载文件系统。
  mount -o remount,rw /usr
3. 使用 SCP 或类似工具传输文件。例如，scp i2cdetect root@10.92.162.185:/bin
4. 分配执行权限。
  chmod 777 i2cdetect

使用 i2cdetect 工具验证 I2C 设备。例如，./i2cdetect -y -r <i2c_instance_num>。

/lib # ./i2cdetect -y -r 0

将显示以下输出。

1  2  3  4  5  6  7  8  9  a  b  c  d  e  f
-- -- -- -- -- -- -- --
-- -- -- -- -- -- -- -- -- -- -- -- -- -- -- --
-- -- -- -- -- -- -- -- -- -- -- 2b -- -- -- --
-- -- -- -- -- -- -- -- -- -- -- -- -- -- -- --
-- -- -- -- 44 -- -- -- -- -- -- -- -- -- -- --
-- -- -- -- -- -- -- -- -- -- -- -- -- -- -- --
-- -- -- -- -- -- -- -- -- -- -- -- -- -- -- --
-- -- -- -- -- -- -- --
/lib # exit

查看 I2C detect 帮助 有关 I2C 检测及其使用方法的更多信息，请运行以下命令。

/lib # ./i2cdetect --help

将显示以下输出。

Error: Unsupported option "--help"!
Usage: i2cdetect [-y] [-a] [-q|-r] I2CBUS [FIRST LAST]
i2cdetect -F I2CBUS
i2cdetect -l
I2CBUS is an integer or an I2C bus name
If provided, FIRST and LAST limit of the probing range.

识别 DUT 中已探测的设备 要识别从 DUT 探测到的设备，请运行以下命令。

/lib # ./i2cdump -r 0-0xff 0 0x2b b

输出：

WARNING! This program can confuse your I2C bus, cause data loss and worse!
will probe file /dev/i2c-0, address 0x2b, mode byte
Probe range limited to 0x00-0xff.
Continue? [Y/n] Y
0  1  2  3  4  5  6  7  8  9  a  b  c  d  e  f    0123456789abcdef
00: 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00    ................
10: 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00    ................
20: 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00    ................
30: 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00    ................
40: 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00    ................
50: 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00    ................
60: 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00    ................
70: 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00    ................
80: 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00    ................
90: 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00    ................
a0: 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00    ................
b0: 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00    ................
c0: 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00    ................
d0: 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00    ................
e0: 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00    ................
f0: 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00    ................

从设备读取 I2C 数据 要从设备读取 I2C 数据，请运行以下命令。

/lib # ./i2cget 0 0x2b 4 b

输出：

WARNING! This program can confuse your I2C bus, cause data loss and worse!
Will read from device file /dev/i2c-0, chip address 0x2b, data address
0x04, using read byte data.
Continue? [Y/n] Y
0x00

调试 I2C 问题

本节介绍 I2C 软件驱动程序的默认日志记录方法，用于启用 I2C 传输失败的日志记录。

Linux

I2C 驱动程序日志通过内核动态调试方法启用。在以下文件中启用 CONFIG_DYNAMIC_DEBUG 以支持内核驱动程序的动态调试。

<workspace_path_of_LINUX_kernel_image>/sources/kernel/kernel_platform/kernel/arch/arm64/configs/qcom_defconfig

要在内核日志（dmesg）中启用并查看 I2C 驱动程序日志，请运行以下命令。

mount -t debugfs none /sys/kernel/debug
echo -n "file i2c-qcom-geni.c +p" > /sys/kernel/debug/dynamic_debug/control
echo -n "file i2c-core-base.c +p" > /sys/kernel/debug/dynamic_debug/control
echo -n "file i2c-dev.c +p" > /sys/kernel/debug/dynamic_debug/control
echo -n "file i2c-mux.c +p" > /sys/kernel/debug/dynamic_debug/control
echo -n "file gpi.c +p" > /sys/kernel/debug/dynamic_debug/control

要调试驱动程序协议加载失败的错误消息：[ 8.583248] geni_i2c a94000.i2c: Invalid proto 1，请执行以下操作。

识别板类型。示例：QUPV3_1_SE5 板类型详细信息

B -    461251 - CDT Version:3,Platform ID:34,Major ID:1,Minor ID:0,Subtype:2

从内核日志中，在以下位置找到平台 ID 和子类型相关详细信息：

/firmware/qualcomm-linux-spf-1-0_ap_standard_oem_nomodem/TZ.XF.5.0/trustzone_images/core/settings/buses/qup_accesscontrol/qupv3/config/<chipset>/QUPAC_Access.xml

获取 Qualcomm TEE QUPAC_Access.c 文件的配置。
识别特定于该串行引擎的配置。
在 QUPAC_Access.xml 文件中找到平台 ID 类型。
将此平台 ID 类型映射到 QUPAC_Access.c 文件中相应的 qupv3_perms 结构。
验证 QUPAC_Access.c 文件中的协议和模式配置。

I2C 示例

有关上游设备树参考的信息，请参阅以下 DTSI 文件。

QCS6490 和 QCS5430：https://git.linaro.org/kernel-org/linux-next.git/tree/arch/arm64/boot/dts/qcom/sc7280.dtsi
Dragonwing IQ-9075：https://github.com/torvalds/linux/blob/master/arch/arm64/boot/dts/qcom/sa8775p.dtsi
Dragonwing IQ-615：https://git.kernel.org/pub/scm/linux/kernel/git/qcom/linux.git/tree/arch/arm64/boot/dts/qcom/qcs615.dtsi?h=arm64-for-6.16

有关 Qualcomm Linux 硬件 SoC 的设备树节点信息，请参阅以下 DTSI 文件。

QCS6490 和 QCS5430：https://git.linaro.org/kernel-org/linux-next.git/tree/arch/arm64/boot/dts/qcom/qcs6490-rb3gen2.dts
Dragonwing IQ-9075：https://github.com/torvalds/linux/blob/master/arch/arm64/boot/dts/qcom/sa8775p.dtsi
Dragonwing IQ-615：https://git.kernel.org/pub/scm/linux/kernel/git/qcom/linux.git/tree/arch/arm64/boot/dts/qcom/qcs615.dtsi?h=arm64-for-6.16

​I2C 通信序列概述

​I2C 数据包格式

​I2C 序列

​I2C 特性

​I2C 接口组件

​I2C API

​I2C 软件设备树配置

​Linux

​Boot

​aDSP/SDC

​Qualcomm TEE

​配置 I2C 接口

​Linux

​验证 I2C 接口

​Linux

​调试 I2C 问题

​Linux

​I2C 示例

I2C 通信序列概述

I2C 数据包格式

I2C 序列

I2C 特性

I2C 接口组件

I2C API

I2C 软件设备树配置

Linux

Boot

aDSP/SDC

Qualcomm TEE

配置 I2C 接口

Linux

验证 I2C 接口

Linux

调试 I2C 问题

Linux

I2C 示例