# I2C
Source: [https://docs.qualcomm.com/doc/80-70015-8SC/topic/i2c.html](https://docs.qualcomm.com/doc/80-70015-8SC/topic/i2c.html)
I2C 是飞利浦公司在 20 世纪 80 年代开发的一种双向 2 线制总线，用于实现高效的 IC 间控制总线。总线上的每个设备都有其唯一的地址（在由飞利浦公司领导的 I2C General Body 中注册）。I2C 核心支持多控制器模式，以及 10 位目标地址和 10 位可扩展地址。有关 I2C 的详细信息，可访问 [https://www.i2c-bus.org/fileadmin/ftp/i2c_bus_specification_1995.pdf](https://www.i2c-bus.org/fileadmin/ftp/i2c_bus_specification_1995.pdf)。
### I2C 通信序列概述
下图显示了控制器与目标之间的 I2C 通信序列，
Figure : I2C 序列
例如，任何设备都不能使用 I2C 规范中列出的 1111-0XX。这是时钟频率为 3.4 MHz 的高速模式。
以下为各种 I2C 模式及其支持的速度。
- 标准模式：100 kbps
- 快速模式： 400 kbps
- 超快速模式：1 Mbps
最高支持 1 MHz 的带宽。
### I2C 数据包格式
如下图所示，控制器发送 7 位或 10 位地址，以及一个指示操作类型的读/写位。数据以 8 位为序列在 SDA 线上进行传输。每传输一个字节，负责接收数据的设备就会发回一个 ACK 位（总共 9 个时钟脉冲）。
- ACK 位 LOW：表示已收到数据并准备好接受下一个字节。
- ACK 位 HIGH：表示已收到数据但无法接受更多数据。控制器随后使用 STOP 序列终止传输。
Figure : I2C 数据包
### I2C 序列
当 SCL 为高电平时，SDA 必须保持稳定且不能变化。仅当时钟线为低电平时，数据线才可以变化。但是，存在两种例外情况：START 序列和 STOP 序列。
## I2C 功能
Source: [https://docs.qualcomm.com/doc/80-70015-8SC/topic/i2c.html](https://docs.qualcomm.com/doc/80-70015-8SC/topic/i2c.html)
本节介绍 I2C 串行引擎传输模式以及支持不同传输模式的各种用例。下表列出了各种 I2C 子系统驱动程序中启用的传输模式。
| 子系统 | 传输模式 | 说明 |
| --- | --- | --- |
| Linux | |
- 支持 100 kHz、400 kHz 和 1000 kHz 总线速度
- 支持符合 I2C 规范的 7 位目标地址
- 支持 100 kHz、400 kHz 和 1000 kHz 总线速度
- 支持符合 I2C 规范的 7 位目标地址
|
| 启动 | FIFO |
- 支持 100 kHz、400 kHz 和 1000 kHz 总线速度
- 支持符合 I2C 规范的 7 位目标地址
- 支持 100 kHz、400 kHz 和 1000 kHz 总线速度
- 支持符合 I2C 规范的 7 位目标地址
|
| aDSP/TrustZone/SDC | FIFO |
- 支持 100 kHz、400 kHz 和 1000 kHz 总线速度
- 支持符合 I2C 规范的 7 位目标地址
- 支持 100 kHz、400 kHz 和 1000 kHz 总线速度
- 支持符合 I2C 规范的 7 位目标地址
|
| | | |
| | | |
## I2C 接口
Source: [https://docs.qualcomm.com/doc/80-70015-8SC/topic/i2c.html](https://docs.qualcomm.com/doc/80-70015-8SC/topic/i2c.html)
本节提供有关子系统驱动程序、内核设备树节点和相关文档的信息。
Table : I2C 接口：Linux
| 文件类型 | 说明 |
| --- | --- |
| 设备树源 | 有关 QUP v3 串行引擎接口设备节点和 I2C 设备节点的设备树配置，参见以下 DTSI 文件。 |
| `Pinctrl` 设置 | 有关 I2C 设备节点的 QUP v3 串行引擎接口的 GPIO 设置的设备树属性，参见以下 DTSI 文件。 |
| TrustZone 设置 | 有关针对不同子系统加载 QUP v3 串行引擎 I2C 固件的 TrustZone 访问控制设置，可访问 /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。 |
Table : I2C 接口：启动
| 文件类型 | 说明 |
| --- | --- |
| QUP v3 串行引擎配置 | 要针对 I2C 配置 boot 子系统中的 QUP v3 串行引擎，以及针对 I2C 软件用例配置 GPIO，可访问以下文件路径：
- 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
|
| TrustZone 设置 | 有关针对不同子系统加载 I2C 协议的 QUP v3 串行引擎固件中的 TrustZone 访问控制设置，可访问 /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 |
Table : I2C 接口：aDSP/SLPI/SDC
| 文件类型 | 说明 |
| --- | --- |
| QUP v3 串行引擎配置 | 有关 aDSP 子系统中用于启用 I2C 接口的 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
|
| 固件配置设置 | 有关在 aDSP 软件中配置 I2C 的 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
|
Table : I2C 接口：TrustZone
| 文件类型 | 说明 |
| --- | --- |
| 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
|
| TrustZone 设置 | /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
Source: [https://docs.qualcomm.com/doc/80-70015-8SC/topic/i2c.html](https://docs.qualcomm.com/doc/80-70015-8SC/topic/i2c.html)
本节列出了以下子系统的 I2C API。
- Linux：
- [https://github.com/torvalds/linux/blob/master/include/linux/i2c.h](https://github.com/torvalds/linux/blob/master/include/linux/i2c.h).
- [https://github.com/torvalds/linux/blob/master/include/linux/i2c-dev.h](https://github.com/torvalds/linux/blob/master/include/linux/i2c-dev.h).
- 启动：boot\_images/boot/QcomPkg/Include/i2c\_api.h
- aDSP/SDC/SLPI：adsp\_proc/core/api/buses/i2c\_api.h
- TrustZone：trustzone\_images/core/buses/api/i2c/qupv3/i2c\_api.h
## I2C 软件
Source: [https://docs.qualcomm.com/doc/80-70015-8SC/topic/i2c.html](https://docs.qualcomm.com/doc/80-70015-8SC/topic/i2c.html)
本节提供 I2C 设备树配置的相关信息，以及设备节点的相关文档。
### Linux
有关配置设置文件，参见以下 DTSI 文件。
- QCS6490 和 QCS5430： [https://git.linaro.org/kernel-org/linux-next.git/tree/arch/arm64/boot/dts/qcom/sc7280.dtsi](https://git.linaro.org/kernel-org/linux-next.git/tree/arch/arm64/boot/dts/qcom/sc7280.dtsi)
- QCS9075： [https://github.com/torvalds/linux/blob/master/arch/arm64/boot/dts/qcom/sa8775p.dtsi](https://github.com/torvalds/linux/blob/master/arch/arm64/boot/dts/qcom/sa8775p.dtsi)
更多详细信息，可参见 i2c-geni-qcom.yaml 文件（位于 [https://github.com/torvalds/linux/blob/master/Documentation/devicetree/bindings/i2c/qcom%2Ci2c-geni-qcom.yaml](https://github.com/torvalds/linux/blob/master/Documentation/devicetree/bindings/i2c/qcom%2Ci2c-geni-qcom.yaml)）。I2C 驱动程序位于 [https://github.com/torvalds/linux/blob/master/drivers/i2c/busses/i2c-qcom-geni.c](https://github.com/torvalds/linux/blob/master/drivers/i2c/busses/i2c-qcom-geni.c) 文件中。
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 = ;
#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"; };Copy to clipboard
有关特定于 GPIO `pinctrl`配置的内核文档，参见以下文件。
- QCS6490 和 QCS5430： [https://git.linaro.org/kernel-org/linux-next.git/tree/arch/arm64/boot/dts/qcom/sc7280.dtsi](https://git.linaro.org/kernel-org/linux-next.git/tree/arch/arm64/boot/dts/qcom/sc7280.dtsi)
- QCS9075： [https://github.com/torvalds/linux/blob/master/arch/arm64/boot/dts/qcom/sa8775p.dtsi](https://github.com/torvalds/linux/blob/master/arch/arm64/boot/dts/qcom/sa8775p.dtsi)
- 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"; };Copy to clipboard
在 QUPAC\_Access.c 文件中，确保特定串行引擎的协议配置采用 I2C 协议。TrustZone 版本：/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 TouchCopy to clipboard
### 启动
1. 在 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
- TrustZone 设置：/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
Note: 有关启动过程中的配置设置，参见[启动](https://docs.qualcomm.com/doc/80-70015-8SC/topic/spi.html#spi_software__section_ibv_tfb_r1c)。
2. 在 UEFI（位于 /QcomPkg/SocPkg/<chipset>/LAA/Core.fdf）中启用 I2C 协议。
-#INF QcomPkg/Drivers/I2CDxe/I2CDxe.inf
+INF QcomPkg/Drivers/I2CDxe/I2CDxe.inf
Copy to clipboard
3. 应用程序启用 I2C 接口。应用程序随后通过 I2C 接口执行读写操作。有关 I2C 函数用法的信息，参见 boot\_images/QcomPkg/QcomTestPkg/I2CApp/I2Ceeprom.c。
4. 在代码中按顺序添加 i2c\_open->i2c\_read/i2c\_write->i2c\_close。
5. 在调用 `I2c_open` 之前，通过验证设备/UEFI 启动日志来确保加载 GpiDxe.inf 和 I2C.efi 文件。
### aDSP/SDC
在 aDSP 子系统的启动序列期间，将执行 SSC QUP 的固件加载。配置文件位于 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）中。
以下配置是向 SSC QUP SE1、SE2 和 SE3 设置中加载 I2C 固件的示例。
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 };Copy to clipboard
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,
}
Copy to clipboard
TLMM\_MAP 是用于初始化工作和休眠状态 GPIO 配置的宏。以下为 TLMM\_MAP 宏的使用示例。
TLMM_MAP (active state pull type, drive strength, sleep state pull type)Copy to clipboard
### TrustZone
可按照如下所示将 QUP v3 串行引擎配置为 I2C。文件路径：settings/buses/i2c/qupv3/config/<chipset>/tz/i2c\_devcfg\_user.h。
#define ENABLE_I2C_08Copy to clipboard
`ENABLE_I2C_` 编号基于串行引擎的序列号（从 0 开始）。举例来说，假设有两个 QUP：QUPV3\_0 具有七个串行引擎，QUPV3\_1 具有八个串行引擎，则用户必须启用 QUPV3\_2\_SE2。宏应为 `ENABLE_I2C_08`。
GPIO 配置：根据 PIN 索引（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
};
Copy to clipboard
QUPAC 访问控制：在 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）中控制 TrustZone 子系统的固件加载和访问控制权限。
## I2C 配置
Source: [https://docs.qualcomm.com/doc/80-70015-8SC/topic/i2c.html](https://docs.qualcomm.com/doc/80-70015-8SC/topic/i2c.html)
本节提供有关 I2C 软件驱动程序内核配置和设备树节点更改的信息。
### Linux
需要以下驱动程序内核配置才能支持 I2C 接口。
- 驱动程序源文件： [https://github.com/torvalds/linux/blob/master/drivers/i2c/busses/i2c-qcom-geni.c](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/.dtsi b/arch/arm64/boot/dts/qcom/.dtsi
index 8575f0b..cced7c0 100644
--- a/arch/arm64/boot/dts/qcom/.dtsi
+++ b/arch/arm64/boot/dts/qcom/.dtsi
@@ -6865,3 +6865,7 @@
;
};
};
+
+ &i2c1 {
+ status = "ok";
+};
Copy to clipboard
Note: 应编译内核配置和设备树更改。编译完成后，可以将镜像加载到设备中，以验证接口。有关接口验证的信息，参见 [I2C 验证](https://docs.qualcomm.com/doc/80-70015-8SC/topic/i2c.html#i2c-verification)一节。
## I2C 验证
Source: [https://docs.qualcomm.com/doc/80-70015-8SC/topic/i2c.html](https://docs.qualcomm.com/doc/80-70015-8SC/topic/i2c.html)
本节介绍 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)。
要交叉编译工具，应按照以下步骤操作。
1. 访问 [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`。
2. 将下载的 `tar` 文件解压获取工具。
command: tar -xzvf Copy to clipboard
3. 将当前目录更改为 `i2c-tool` 路径。
cd Copy to clipboard
4. 安装工具。
sudo apt-get install gcc-aarch64-linux-gnuCopy to clipboard
5. 搭建交叉编译环境。
export CC=aarch64-linux-gnu-gccCopy to clipboard
6. 编译工具。
make USE_STATIC_LIB=1Copy to clipboard
随后将在 `/tools/` 下生成二进制文件。
通过在 SSH shell 中查找 `dev` 节点（`/dev/i2c-0` 和 `/dev/i2c-1`）验证驱动程序。
**验证 I2C 驱动程序**
1. 要验证 I2C 驱动程序，应进行以下操作：
1. 在 Permissive 模式下打开 SSH shell。有关如何运行 SSH 的更多信息，参见[使用 SSH](https://docs.qualcomm.com/bundle/publicresource/topics/80-70015-254/how_to.html#use-ssh) 一节。
2. 安装文件系统。
mount -o remount,rw /Copy to clipboard
3. 使用 SCP 或类似工具传输文件。有关如何运行 SSH 的更多信息，参见[使用 SSH](https://docs.qualcomm.com/bundle/publicresource/topics/80-70015-254/how_to.html#use-ssh) 一节。
例如，`scp i2cdetect root@10.92.162.185:/bin`
4. 分配执行权限。
chmod 777 i2cdetectCopy to clipboard
2. 使用 `i2cdetect` 工具验证 I2C 设备。例如，`./i2cdetect -y -r `。
/lib # ./i2cdetect -y -r 0
Copy to clipboard
随即显示以下输出。
0 1 2 3 4 5 6 7 8 9 a b c d e f
00: -- -- -- -- -- -- -- --
10: -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- --
20: -- -- -- -- -- -- -- -- -- -- -- 2b -- -- -- --
30: -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- --
40: -- -- -- -- 44 -- -- -- -- -- -- -- -- -- -- --
50: -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- --
60: -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- --
70: -- -- -- -- -- -- -- --
/lib # exit
Copy to clipboard
**查看 I2C 检测帮助**
如需有关 I2C 检测及其使用方法的更多信息，可运行以下命令。
/lib # ./i2cdetect --helpCopy to clipboard
随即显示以下输出。
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.
Copy to clipboard
**识别 DUT 中被探测的设备**
要识别 DUT 中被探测的设备，应运行以下命令。
/lib # ./i2cdump -r 0-0xff 0 0x2b bCopy to clipboard
随即显示以下输出。
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 ................
Copy to clipboard
**从设备读取 I2C 数据**
要从设备读取 I2C 数据，应运行以下命令。
/lib # ./i2cget 0 0x2b 4 bCopy to clipboard
随即显示以下输出。
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
0x00Copy to clipboard
## I2C 调试
Source: [https://docs.qualcomm.com/doc/80-70015-8SC/topic/i2c.html](https://docs.qualcomm.com/doc/80-70015-8SC/topic/i2c.html)
本节介绍用于启用 I2C 传输失败日志的 I2C 软件驱动程序的默认日志方法。
### Linux
通过内核动态调试方法启用 I2C 驱动程序日志。在 <workspace\_path\_of\_LINUX\_kernel\_image>/sources/kernel/kernel\_platform/kernel/arch/arm64/configs/qcom\_defconfig 中启用 `CONFIG_DYNAMIC_DEBUG`，以支持内核驱动程序的动态调试。
要在内核日志 (`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
Copy to clipboard
要调试以下错误消息： `[ 8.583248] geni_i2c a94000.i2c: Invalid proto 1`（对应驱动程序协议加载失败），应按照以下步骤操作。
1. 确定电路板的类型。
示例：QUPV3\_1\_SE5 电路板类型详细信息
B - 461251 - CDT Version:3,Platform ID:34,Major ID:1,Minor ID:0,Subtype:2Copy to clipboard
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）。
3. 获取 TrustZone QUPAC\_Access.c 文件配置。
4. 确定特定于串行引擎的配置。
5. 在 `QUPAC_Access.xml` 文件中找到平台 ID 类型。
6. 将该平台 ID 类型映射到 `QUPAC_Access.c` 文件中相应的 `qupv3_perms` 结构体。
7. 映射后，验证 `QUPAC_Access.c` 文件中的协议和模式配置以确保设置正确。
## I2C 示例
Source: [https://docs.qualcomm.com/doc/80-70015-8SC/topic/i2c.html](https://docs.qualcomm.com/doc/80-70015-8SC/topic/i2c.html)
有关上游设备树参考的信息，参见以下 DTSI 文件。
- QCS6490 和 QCS5430： [https://git.linaro.org/kernel-org/linux-next.git/tree/arch/arm64/boot/dts/qcom/sc7280.dtsi](https://git.linaro.org/kernel-org/linux-next.git/tree/arch/arm64/boot/dts/qcom/sc7280.dtsi)
- QCS9075： [https://github.com/torvalds/linux/blob/master/arch/arm64/boot/dts/qcom/sa8775p.dtsi](https://github.com/torvalds/linux/blob/master/arch/arm64/boot/dts/qcom/sa8775p.dtsi)
有关 Qualcomm Linux 芯片产品设备树节点的信息，参见以下 DTSI 文件。
- QCS6490 和 QCS5430： [https://git.linaro.org/kernel-org/linux-next.git/tree/arch/arm64/boot/dts/qcom/qcs6490-rb3gen2.dts](https://git.linaro.org/kernel-org/linux-next.git/tree/arch/arm64/boot/dts/qcom/qcs6490-rb3gen2.dts)
- QCS9075： [https://github.com/torvalds/linux/blob/master/arch/arm64/boot/dts/qcom/sa8775p.dtsi](https://github.com/torvalds/linux/blob/master/arch/arm64/boot/dts/qcom/sa8775p.dtsi)
Last Published: Dec 03, 2024
[Previous Topic
SPI](https://docs.qualcomm.com/bundle/publicresource/80-70015-8SC/topics/spi.md) [Next Topic
I3C](https://docs.qualcomm.com/bundle/publicresource/80-70015-8SC/topics/i3c.md)