Linux I2C 驱动实验

1 &i2c1 {
2     clock-frequency = <100000>;
3     pinctrl-names = "default";
4     pinctrl-0 = <&pinctrl_i2c1>;
5     status = "okay";
6 
7     ap3216c@1e {
8         compatible = "alientek,ap3216c";
9         reg = <0x1e>;
10     };
11 };

3、编译设备树重启系统

设备树修改完成以后使用“make dtbs”重新编译一下。

然后使用新的设备树启动 Linux 内 核。/sys/bus/i2c/devices 目录下存放着所有 I2C 设备，如果设备树修改正确的话，会在 /sys/bus/i2c/devices 目录下看到一个名为“0-001e”的子目录，如图 61.5.1.1 所示：

4、AP3216C 驱动编写

1 #ifndef AP3216C_H
2 #define AP3216C_H
3 /***************************************************************
4 Copyright © ALIENTEK Co., Ltd. 1998-2029. All rights reserved.
5 文件名 : ap3216creg.h
6 作者 : 
7 版本 : V1.0
8 描述 : AP3216C 寄存器地址描述头文件
9 其他 : 无
10 论坛 : www.openedv.com
11 日志 : 初版 V1.0 2019/9/2
12 ***************************************************************/
13 /* AP3316C 寄存器 */
14 #define AP3216C_SYSTEMCONG 0x00 /* 配置寄存器 */
15 #define AP3216C_INTSTATUS 0X01 /* 中断状态寄存器 */
16 #define AP3216C_INTCLEAR 0X02 /* 中断清除寄存器 */
17 #define AP3216C_IRDATALOW 0x0A /* IR 数据低字节 */
18 #define AP3216C_IRDATAHIGH 0x0B /* IR 数据高字节 */
19 #define AP3216C_ALSDATALOW 0x0C /* ALS 数据低字节 */
20 #define AP3216C_ALSDATAHIGH 0X0D /* ALS 数据高字节 */
21 #define AP3216C_PSDATALOW 0X0E /* PS 数据低字节 */
22 #define AP3216C_PSDATAHIGH 0X0F /* PS 数据高字节 */
23
24 #endif

1 #include <linux/types.h>
2 #include <linux/kernel.h>
3 #include <linux/delay.h>
4 #include <linux/ide.h>
5 #include <linux/init.h>
6 #include <linux/module.h>
7 #include <linux/errno.h>
8 #include <linux/gpio.h>
9 #include <linux/cdev.h>
10 #include <linux/device.h>
11 #include <linux/of_gpio.h>
12 #include <linux/semaphore.h>
13 #include <linux/timer.h>
14 #include <linux/i2c.h>
15 #include <asm/mach/map.h>
16 #include <asm/uaccess.h>
17 #include <asm/io.h>
18 #include "ap3216creg.h"
19 /***************************************************************
20 Copyright © ALIENTEK Co., Ltd. 1998-2029. All rights reserved.
21 文件名 : ap3216c.c
22 作者 : 左忠凯
23 版本 : V1.0
24 描述 : AP3216C 驱动程序
25 其他 : 无
26 论坛 : www.openedv.com
27 日志 : 初版 V1.0 2019/9/2 左忠凯创建
28 ***************************************************************/
29 #define AP3216C_CNT 1
30 #define AP3216C_NAME "ap3216c"
31 
32 struct ap3216c_dev {
33     dev_t devid; /* 设备号 */
34     struct cdev cdev; /* cdev */
35     struct class *class; /* 类 */
36     struct device *device; /* 设备 */
37     struct device_node *nd; /* 设备节点 */
38     int major; /* 主设备号 */
39     void *private_data; /* 私有数据 */
40     unsigned short ir, als, ps; /* 三个光传感器数据 */
41 };
42 
43 static struct ap3216c_dev ap3216cdev;
44 
45 /*
46 * @description : 从 ap3216c 读取多个寄存器数据
47 * @param – dev : ap3216c 设备
48 * @param – reg : 要读取的寄存器首地址
49 * @param – val : 读取到的数据
50 * @param – len : 要读取的数据长度
51 * @return : 操作结果
52 */
53 static int ap3216c_read_regs(struct ap3216c_dev *dev, u8 reg, void *val, int len)
54 {
55     int ret;
56     struct i2c_msg msg[2];
57     struct i2c_client *client = (struct i2c_client *)dev->private_data;
58
59     /* msg[0]为发送要读取的首地址 */
60     msg[0].addr = client->addr; /* ap3216c 地址 */
61     msg[0].flags = 0; /* 标记为发送数据 */
62     msg[0].buf = &reg; /* 读取的首地址 */
63     msg[0].len = 1; /* reg 长度 */
64 
65     /* msg[1]读取数据 */
66     msg[1].addr = client->addr; /* ap3216c 地址 */
67     msg[1].flags = I2C_M_RD; /* 标记为读取数据 */
68     msg[1].buf = val; /* 读取数据缓冲区 */
69     msg[1].len = len; /* 要读取的数据长度 */
70 
71     ret = i2c_transfer(client->adapter, msg, 2);
72     if(ret == 2) {
73         ret = 0;
74     } else {
75         printk("i2c rd failed=%d reg=%06x len=%d\n",ret, reg, len);
76         ret = -EREMOTEIO;
77     }
78     return ret;
79 }
80 
81 /*
82 * @description : 向 ap3216c 多个寄存器写入数据
83 * @param – dev : ap3216c 设备
84 * @param – reg : 要写入的寄存器首地址
85 * @param – val : 要写入的数据缓冲区
86 * @param – len : 要写入的数据长度
87 * @return : 操作结果
88 */
89 static s32 ap3216c_write_regs(struct ap3216c_dev *dev, u8 reg,u8 *buf, u8 len)
90 {
91     u8 b[256];
92     struct i2c_msg msg;
93     struct i2c_client *client = (struct i2c_client *)dev->private_data;
94 
95     b[0] = reg; /* 寄存器首地址 */
96     memcpy(&b[1],buf,len); /* 将要写入的数据拷贝到数组 b 里面 */
97 
98     msg.addr = client->addr; /* ap3216c 地址 */
99     msg.flags = 0; /* 标记为写数据 */
100
101     msg.buf = b; /* 要写入的数据缓冲区 */
102     msg.len = len + 1; /* 要写入的数据长度 */
103
104     return i2c_transfer(client->adapter, &msg, 1);
105 }
106
107 /*
108 * @description : 读取 ap3216c 指定寄存器值，读取一个寄存器
109 * @param – dev : ap3216c 设备
110 * @param – reg : 要读取的寄存器
111 * @return : 读取到的寄存器值
112 */
113 static unsigned char ap3216c_read_reg(struct ap3216c_dev *dev, u8 reg)
114 {
115     u8 data = 0;
116
117     ap3216c_read_regs(dev, reg, &data, 1);
118     return data;
119
120 #if 0
121     struct i2c_client *client = (struct i2c_client *)dev->private_data;
122     return i2c_smbus_read_byte_data(client, reg);
123 #endif
124 }
125
126 /*
127 * @description : 向 ap3216c 指定寄存器写入指定的值，写一个寄存器
128 * @param – dev : ap3216c 设备
129 * @param – reg : 要写的寄存器
130 * @param – data : 要写入的值
131 * @return : 无
132 */
133 static void ap3216c_write_reg(struct ap3216c_dev *dev, u8 reg,
u8 data)
134 {
135     u8 buf = 0;
136     buf = data;
137     ap3216c_write_regs(dev, reg, &buf, 1);
138 }
139
140 /*
141 * @description : 读取 AP3216C 的数据，读取原始数据，包括 ALS,PS 和 IR, 
142 * :同时打开 ALS,IR+PS 的话两次数据读取的间隔要大于 112.5ms
143 * @param - ir : ir 数据
144 * @param - ps : ps 数据
145 * @param - ps : als 数据
146 * @return : 无。
147 */
148 void ap3216c_readdata(struct ap3216c_dev *dev)
149 {
150     unsigned char i =0;
151     unsigned char buf[6];
152 
153     /* 循环读取所有传感器数据 */
154     for(i = 0; i < 6; i++) 
155     {
156         buf[i] = ap3216c_read_reg(dev, AP3216C_IRDATALOW + i); 
157     }
158
159     if(buf[0] & 0X80) /* IR_OF 位为 1,则数据无效 */
160         dev->ir = 0; 
161     else /* 读取 IR 传感器的数据 */
162         dev->ir = ((unsigned short)buf[1] << 2) | (buf[0] & 0X03); 
163 
164         dev->als = ((unsigned short)buf[3] << 8) | buf[2];/* ALS 数据 */ 
165 
166     if(buf[4] & 0x40) /* IR_OF 位为 1,则数据无效 */
167         dev->ps = 0; 
168     else /* 读取 PS 传感器的数据 */
169         dev->ps = ((unsigned short)(buf[5] & 0X3F) << 4) | (buf[4] & 0X0F);
170     }
171
172 /*
173 * @description : 打开设备
174 * @param – inode : 传递给驱动的 inode
175 * @param - filp : 设备文件，file 结构体有个叫做 private_data 的成员变量
176 * 一般在 open 的时候将 private_data 指向设备结构体。
177 * @return : 0 成功;其他 失败
178 */
179 static int ap3216c_open(struct inode *inode, struct file *filp)
180 {
181     filp->private_data = &ap3216cdev;
182
183 /    * 初始化 AP3216C */
184     ap3216c_write_reg(&ap3216cdev, AP3216C_SYSTEMCONG, 0x04); 
185     mdelay(50); /* AP3216C 复位最少 10ms */
186     ap3216c_write_reg(&ap3216cdev, AP3216C_SYSTEMCONG, 0X03); 
187     return 0;
188 }
189
190 /*
191 * @description : 从设备读取数据
192 * @param – filp : 要打开的设备文件(文件描述符)
193 * @param - buf : 返回给用户空间的数据缓冲区
194 * @param - cnt : 要读取的数据长度
195 * @param – offt : 相对于文件首地址的偏移
196 * @return : 读取的字节数，如果为负值，表示读取失败
197 */
198 static ssize_t ap3216c_read(struct file *filp, char __user *buf, size_t cnt, loff_t *off)
199 {
200     short data[3];
201     long err = 0;
202
203     struct ap3216c_dev *dev = (struct ap3216c_dev *)filp->private_data;
204 
205     ap3216c_readdata(dev);
206
207     data[0] = dev->ir;
208     data[1] = dev->als;
209     data[2] = dev->ps;
210     err = copy_to_user(buf, data, sizeof(data));
211     return 0;
212 }
213
214 /*
215 * @description : 关闭/释放设备
216 * @param - filp : 要关闭的设备文件(文件描述符)
217 * @return : 0 成功;其他 失败
218 */
219 static int ap3216c_release(struct inode *inode, struct file *filp)
220 {
221     return 0;
222 }
223
224 /* AP3216C 操作函数 */
225 static const struct file_operations ap3216c_ops = {
226     .owner = THIS_MODULE,
227     .open = ap3216c_open,
228     .read = ap3216c_read,
229     .release = ap3216c_release,
230 };
231
232 /*
233 * @description : i2c 驱动的 probe 函数，当驱动与
234 * 设备匹配以后此函数就会执行
235 * @param - client : i2c 设备
236 * @param - id : i2c 设备 ID
237 * @return : 0，成功;其他负值,失败
238 */
239 static int ap3216c_probe(struct i2c_client *client, const struct i2c_device_id *id)
240 {
241     /* 1、构建设备号 */
242     if (ap3216cdev.major) {
243         ap3216cdev.devid = MKDEV(ap3216cdev.major, 0);
244         register_chrdev_region(ap3216cdev.devid, AP3216C_CNT, AP3216C_NAME);
245     } else {
246         alloc_chrdev_region(&ap3216cdev.devid, 0, AP3216C_CNT, AP3216C_NAME);
247         ap3216cdev.major = MAJOR(ap3216cdev.devid);
248     }
249
250     /* 2、注册设备 */
251     cdev_init(&ap3216cdev.cdev, &ap3216c_ops);
252     cdev_add(&ap3216cdev.cdev, ap3216cdev.devid, AP3216C_CNT);
253
254     /* 3、创建类 */
255     ap3216cdev.class = class_create(THIS_MODULE, AP3216C_NAME);
256     if (IS_ERR(ap3216cdev.class)) {
257         return PTR_ERR(ap3216cdev.class);
258     }
259
260     /* 4、创建设备 */
261     ap3216cdev.device = device_create(ap3216cdev.class, NULL, ap3216cdev.devid, NULL,         AP3216C_NAME);
262     if (IS_ERR(ap3216cdev.device)) {
263         return PTR_ERR(ap3216cdev.device);
264     }
265
266     ap3216cdev.private_data = client;
267
268     return 0;
269 }
270
271 /*
272 * @description : i2c 驱动的 remove 函数，移除 i2c 驱动此函数会执行
273 * @param – client : i2c 设备
274 * @return : 0，成功;其他负值,失败
275 */
276 static int ap3216c_remove(struct i2c_client *client)
277 {
278     /* 删除设备 */
279     cdev_del(&ap3216cdev.cdev);
280     unregister_chrdev_region(ap3216cdev.devid, AP3216C_CNT);
281
282     /* 注销掉类和设备 */
283     device_destroy(ap3216cdev.class, ap3216cdev.devid);
284     class_destroy(ap3216cdev.class);
285     return 0;
286 }
287
288 /* 传统匹配方式 ID 列表 */
289 static const struct i2c_device_id ap3216c_id[] = {
290     {"alientek,ap3216c", 0}, 
291     {}
292 };
293
294 /* 设备树匹配列表 */
295 static const struct of_device_id ap3216c_of_match[] = {
296     { .compatible = "alientek,ap3216c" },
297     { /* Sentinel */ }
298 };
299
300     /* i2c 驱动结构体 */ 
301 static struct i2c_driver ap3216c_driver = {
302     .probe = ap3216c_probe,
303     .remove = ap3216c_remove,
304     .driver = {
305         .owner = THIS_MODULE,
306         .name = "ap3216c",
307         .of_match_table = ap3216c_of_match,
308     },
309     .id_table = ap3216c_id,
310 };
311 
312 /*
313 * @description : 驱动入口函数
314 * @param : 无
315 * @return : 无
316 */
317 static int __init ap3216c_init(void)
318 {
319     int ret = 0;
320
321     ret = i2c_add_driver(&ap3216c_driver);
322     return ret;
323 }
324
325 /*
326 * @description : 驱动出口函数
327 * @param : 无
328 * @return : 无
329 */
330 static void __exit ap3216c_exit(void)
331 {
332     i2c_del_driver(&ap3216c_driver);
333 }
334
335 /* module_i2c_driver(ap3216c_driver) */
336
337 module_init(ap3216c_init);
338 module_exit(ap3216c_exit);
339 MODULE_LICENSE("GPL");
340 MODULE_AUTHOR("zuipeng");

5、编写测试 APP

1 #include "stdio.h"
2 #include "unistd.h"
3 #include "sys/types.h"
4 #include "sys/stat.h"
5 #include "sys/ioctl.h"
6 #include "fcntl.h"
7 #include "stdlib.h"
8 #include "string.h"
9 #include <poll.h>
10 #include <sys/select.h>
11 #include <sys/time.h>
12 #include <signal.h>
13 #include <fcntl.h>
14 /***************************************************************
15 Copyright © ALIENTEK Co., Ltd. 1998-2029. All rights reserved.
16 文件名 : ap3216cApp.c
17 作者 : 
18 版本 : V1.0
19 描述 : ap3216c 设备测试 APP。
20 其他 : 无
21 使用方法 ：./ap3216cApp /dev/ap3216c
22 论坛 : www.openedv.com
23 日志 : 初版 V1.0 2019/9/20 
24 ***************************************************************/
25
26 /*
27 * @description : main 主程序
28 * @param - argc : argv 数组元素个数
29 * @param - argv : 具体参数
30 * @return : 0 成功;其他 失败
31 */
32 int main(int argc, char *argv[])
33 {
34     int fd;
35     char *filename;
36     unsigned short databuf[3];
37     unsigned short ir, als, ps;
38     int ret = 0;
39
40     if (argc != 2) {
41         printf("Error Usage!\r\n");
42         return -1;
43     }
44
45     filename = argv[1];
46     fd = open(filename, O_RDWR);
47     if(fd < 0) {
48         printf("can't open file %s\r\n", filename);
49         return -1;
50     }
51
52     while (1) {
53         ret = read(fd, databuf, sizeof(databuf));
54         if(ret == 0) { /* 数据读取成功 */
55             ir = databuf[0]; /* ir 传感器数据 */
56             als = databuf[1]; /* als 传感器数据 */
57             ps = databuf[2]; /* ps 传感器数据 */
58             printf("ir = %d, als = %d, ps = %d\r\n", ir, als, ps);
59         }
60         usleep(200000); /* 200ms */
61     }
62     close(fd); /* 关闭文件 */ 
63     return 0;
64 }

6、编译驱动程序和测试 APP

1 KERNELDIR := /home/zipeng/linux/myKernel/linux-imx-rel_imx_4.1.15_2.1.0_ga
...... 
4 obj-m := ap3216c.o
......
11 clean:
12 $(MAKE) -C $(KERNELDIR) M=$(CURRENT_PATH) clean

输入如下命令编译 ap3216cApp.c 这个测试程序：

arm-linux-gnueabihf-gcc ap3216cApp.c -o ap3216cApp

编译成功以后就会生成 ap3216cApp 这个应用程序。

7、运行测试

将上一小节编译出来 ap3216c.ko 和 ap3216cApp 这两个文件拷贝到 rootfs/lib/modules/4.1.15

目录中，重启开发板，进入到目录 lib/modules/4.1.15 中。输入如下命令加载 ap3216c.ko 这个驱

动模块。

depmod

//第一次加载驱动的时候需要运行此命令

modprobe ap3216c.ko //加载驱动模块

当驱动模块加载成功以后使用 ap3216cApp 来测试，输入如下命令：

./ap3216cApp /dev/ap3216c

测试 APP 会不断的从 AP3216C 中读取数据，然后输出到终端上

rmmod ap3216c.ko