I2C驱动实验：向设备树添加 I2C设备的设备节点信息

凌肖战

已于 2024-04-06 00:23:18 修改

阅读量394

点赞数 2

分类专栏： Linux驱动学习文章标签： linux arm开发驱动开发

于 2024-04-05 23:19:58 首次发布

本文链接：https://blog.csdn.net/wojiaxiaohuang2014/article/details/137412112

版权

Linux驱动学习专栏收录该内容

218 篇文章 25 订阅

订阅专栏

一. 简介

I2C设备驱动实验以 I.MX6U-ALPHA 开发板上的 AP3216C 这个三合一环境光传感器为例，通过 AP3216C讲解一下，如何编写 Linux 下的 I2C 设备驱动程序。

因为 IMX6ULL所运行的内核是支持设备树的，所以，本文来学习如何向设备树文件中添加 I2C设备节点信息，具体就是添加 AP3216C设备的设备节点信息。

二. I2C驱动实验：AP3216C设备的硬件原理图

打开 AP3216C的硬件原理图，我这里打开 "IMX6ULL_ALPHA_V2.2(底板原理图).pdf"，如下：

I2C是有两根线，一个是 SCL为时钟线，一个是SDA为数据线。

上图可以看出，AP3216C使用的 I2C1控制器，除了 I2C的这两条线外，还有一个AP_INT接口，这是个中断接口。本实验不用这个中断功能。

在硬件原理图中搜索 "I2C1_SCL"与 "I2C1_SDA"这两个接口，对应连接芯片的哪个PIN：

可以看出， "I2C1_SCL"使用的 UART4_TXD这个pin， "I2C1_SDA"使用的 UART4_RXD这个pin。

接下来就是找到这两个PIN，向设备树中添加 AP3216C设备的设备节点信息。

具体就是将这两个PIN配置为I2C功能，配置这两个PIN的器属性值，设置一些设备节点信息（例如，最重要的是 compatile属性）。

三. 向设备树添加 I2C设备（AP3216C）的设备节点信息

打开ubuntu系统，通过vscode 打开系统下之前使用的内核源码（NXP官方提供）工程。

注意：这里开发板使用的Nand_flash版的ALPHA开发板，所以，对应的设备树文件（源文件）为 imx6ull-alientek-nand.dts。

1. 查看 i2c1 控制器节点

设备树文件 imx6ull-alientek-nand.dts有调用到 imx6ull-14x14-evk-gpmi-weim.dts文件，这两个文件中都没有 i2c设备节点，继续追溯到 imx6ull-14x14-evk.dts设备树文件。i2c1 设备节点就在 imx6ull-14x14-evk.dts 设备树文件中。

注意： imx6ull.dtsi设备树文件是 NXP官方编写的，虽然这里也有 i2c设备节点，不能在这个设备树文件中进行更改。

在 imx6ull-14x14-evk.dts设备树文件中查找到 i2c1控制器节点。

2. 向设备树添加 I2C设备（AP3216C）的设备节点信息

(1) 首先，添加按键的 pinctrl 节点

首先肯定是要修改 IO ， AP3216C 用到了 I2C1 接口， I.MX6U-ALPHA 开发板上的 I2C1 接口使用到了 UART4_TXD 和 UART4_RXD ，因此，肯定要在设备树里面设置这两个 IO 。

如果要用到 AP3216C 的中断功能的话，还需要初始化 AP_INT 对应的 GIO1_IO01 这个 IO ，本章实验我们不使用中断功能。因此，只需要设置 UART4_TXD 和 UART4_RXD 这两个 IO ，

NXP 其实已经将这两个 IO 设置好了，打开 imx6ull-14x14-evk.dts ，然后找到如下内容：

		pinctrl_i2c1: i2c1grp {
			fsl,pins = <
				MX6UL_PAD_UART4_TX_DATA__I2C1_SCL 0x4001b8b0
				MX6UL_PAD_UART4_RX_DATA__I2C1_SDA 0x4001b8b0
			>;
		};

pinctrl_i2c1 就是 I2C1 的 IO 节点，这里将 UART4_TXD 和 UART4_RXD 这两个 IO 分别复用为 I2C1_SCL 和 I2C1_SDA ，电气属性都设置为 0x4001b8b0 。

(2) 其次，在 i2c1 节点追加 ap3216c 子节点

AP3216C 是连接到 I2C1 上的，因此需要在 i2c1 节点下添加 ap3216c 的设备子节点，在 imx6ull-14x14-evk.dts设备树文件中找到 i2c1 节点，此节点默认内容如下：

&i2c1 {
	clock-frequency = <100000>;
	pinctrl-names = "default";
	pinctrl-0 = <&pinctrl_i2c1>;
	status = "okay";

	mag3110@0e {
		compatible = "fsl,mag3110";
		reg = <0x0e>;
		position = <2>;
	};

	fxls8471@1e {
		compatible = "fsl,fxls8471";
		reg = <0x1e>;
		position = <0>;
		interrupt-parent = <&gpio5>;
		interrupts = <0 8>;
	};
};

第 2 行， clock-frequency 属性为 I2C 频率，这里设置为 100KHz 。

第 4 行， pinctrl-0 属性指定 I2C 所使用的 IO 为示例代码 61.5.1.1 中的 pinctrl_i2c1 子节点。

第 7~11 行，mag3110 是个磁力计，NXP 官方的 EVK 开发板上接了 mag3110，因此 NXP 在 i2c1 节点下添加了 mag3110 这个子节点。正点原子的 I.MX6U-ALPHA 开发板上没有用到 mag3110。

第 13~19 行， NXP 官方 EVK 开发板也接了一个 fxls8471 ，正点原子的 I.MX6U-ALPHA 开发板同样没有此器件。

将 i2c1 节点里面原有的 mag3110 和 fxls8471 这两个 I2C 子节点删除，然后添加 ap3216c 子节点信息，完成以后的 i2c1 节点内容如下所示：

&i2c1 {
	clock-frequency = <100000>;
	pinctrl-names = "default";
	pinctrl-0 = <&pinctrl_i2c1>;
	status = "okay";

	ap3216c@1e {
		compatible = "alientek,ap3216c";
		reg = <0x1e>;
	};
};