作者:刘昊昱
博客:http://blog.csdn.net/liuhaoyutz
内核版本:2.6.36
源码路径:arch/arm/plat-samsung/adc.c
在Linux-2.6.36中,提供了一个S3C2410的ADC通用驱动模块,定义在arch/arm/plat-samsung/adc.c文件中。用户要使用ADC,可以使用该通用驱动模块提供的接口进行注册和读取。
首先我们来看初始化函数adc_init:
477static int __init adc_init(void)
478{
479 int ret;
480
481 ret = platform_driver_register(&s3c_adc_driver);
482 if (ret)
483 printk(KERN_ERR "%s: failed to add adc driver\n", __func__);
484
485 return ret;
486}
481行,注册了platform_driver s3c_adc_driver,其定义如下:
465static struct platform_driver s3c_adc_driver = {
466 .id_table = s3c_adc_driver_ids,
467 .driver = {
468 .name = "s3c-adc",
469 .owner = THIS_MODULE,
470 },
471 .probe = s3c_adc_probe,
472 .remove = __devexit_p(s3c_adc_remove),
473 .suspend = s3c_adc_suspend,
474 .resume = s3c_adc_resume,
475};
322static int s3c_adc_probe(struct platform_device *pdev)
323{
324 struct device *dev = &pdev->dev;
325 struct adc_device *adc;
326 struct resource *regs;
327 int ret;
328 unsigned tmp;
329
330 adc = kzalloc(sizeof(struct adc_device), GFP_KERNEL);
331 if (adc == NULL) {
332 dev_err(dev, "failed to allocate adc_device\n");
333 return -ENOMEM;
334 }
335
336 spin_lock_init(&adc->lock);
337
338 adc->pdev = pdev;
339 adc->prescale = S3C2410_ADCCON_PRSCVL(49);
340
341 adc->irq = platform_get_irq(pdev, 1);
342 if (adc->irq <= 0) {
343 dev_err(dev, "failed to get adc irq\n");
344 ret = -ENOENT;
345 goto err_alloc;
346 }
347
348 ret = request_irq(adc->irq, s3c_adc_irq, 0, dev_name(dev), adc);
349 if (ret < 0) {
350 dev_err(dev, "failed to attach adc irq\n");
351 goto err_alloc;
352 }
353
354 adc->clk = clk_get(dev, "adc");
355 if (IS_ERR(adc->clk)) {
356 dev_err(dev, "failed to get adc clock\n");
357 ret = PTR_ERR(adc->clk);
358 goto err_irq;
359 }
360
361 regs = platform_get_resource(pdev, IORESOURCE_MEM, 0);
362 if (!regs) {
363 dev_err(dev, "failed to find registers\n");
364 ret = -ENXIO;
365 goto err_clk;
366 }
367
368 adc->regs = ioremap(regs->start, resource_size(regs));
369 if (!adc->regs) {
370 dev_err(dev, "failed to map registers\n");
371 ret = -ENXIO;
372 goto err_clk;
373 }
374
375 clk_enable(adc->clk);
376
377 tmp = adc->prescale | S3C2410_ADCCON_PRSCEN;
378 if (platform_get_device_id(pdev)->driver_data == TYPE_S3C64XX) {
379 /* Enable 12-bit ADC resolution */
380 tmp |= S3C64XX_ADCCON_RESSEL;
381 }
382 writel(tmp, adc->regs + S3C2410_ADCCON);
383
384 dev_info(dev, "attached adc driver\n");
385
386 platform_set_drvdata(pdev, adc);
387 adc_dev = adc;
388
389 return 0;
390
391 err_clk:
392 clk_put(adc->clk);
393
394 err_irq:
395 free_irq(adc->irq, adc);
396
397 err_alloc:
398 kfree(adc);
399 return ret;
400}
62struct adc_device {
63 struct platform_device *pdev;
64 struct platform_device *owner;
65 struct clk *clk;
66 struct s3c_adc_client *cur;
67 struct s3c_adc_client *ts_pend;
68 void __iomem *regs;
69 spinlock_t lock;
70
71 unsigned int prescale;
72
73 int irq;
74};
66行,cur代表当前正在处理的客户。
67行,ts_pend代表触摸屏,这里ADC把客户分为触摸屏和非触摸屏两大类,专门用ts_pend代表触摸屏。
68行,regs是ADC的I/O内存。
71行,prescale是ADC的预分频系数。
73行,irq是触摸屏中断号。
adc_device中用到了s3c_adc_client结构,其定义如下:
46struct s3c_adc_client {
47 struct platform_device *pdev;
48 struct list_head pend;
49 wait_queue_head_t *wait;
50
51 unsigned int nr_samples;
52 int result;
53 unsigned char is_ts;
54 unsigned char channel;
55
56 void (*select_cb)(struct s3c_adc_client *c, unsigned selected);
57 void (*convert_cb)(struct s3c_adc_client *c,
58 unsigned val1, unsigned val2,
59 unsigned *samples_left);
60};
48行,是一个链表项,用来将client插入等待链表adc_pending。
49行,wait是client的等待队列头,如果必须等待,client进程会在wait上休眠。
51行,nr_samples记录客户指定的采样次数。
52行,result记录采样结果。
53行,is_ts表明是不是触摸屏。
54行,channel表明客户要使用的ADC通道。
56行,select回调函数,用于选择客户(初始化客户)和取消选择客户。
57行,convert回调函数,用于对AD转换结果进行相应处理。
回到s3c_adc_probe函数:
339行,设置预分频系统为49。
341行,取得ADC中断号。
348行,申请中断,注册ADC中断处理函数为s3c_adc_irq。
354行,取得ADC时钟。
361行,取得ADC I/O内存。
368行,使用ioremap得到I/O内存对应的虚拟地址。
375行,使能ADC时钟。
377 - 382行,设置使用预分频及预分频系统。
至此,ADC模块的初始化就完成了。
下面我们看客户注册ADC服务的接口函数s3c_adc_register,代码如下:
207struct s3c_adc_client *s3c_adc_register(struct platform_device *pdev,
208 void (*select)(struct s3c_adc_client *client,
209 unsigned int selected),
210 void (*conv)(struct s3c_adc_client *client,
211 unsigned d0, unsigned d1,
212 unsigned *samples_left),
213 unsigned int is_ts)
214{
215 struct s3c_adc_client *client;
216
217 WARN_ON(!pdev);
218
219 if (!select)
220 select = s3c_adc_default_select;
221
222 if (!pdev)
223 return ERR_PTR(-EINVAL);
224
225 client = kzalloc(sizeof(struct s3c_adc_client), GFP_KERNEL);
226 if (!client) {
227 dev_err(&pdev->dev, "no memory for adc client\n");
228 return ERR_PTR(-ENOMEM);
229 }
230
231 client->pdev = pdev;
232 client->is_ts = is_ts;
233 client->select_cb = select;
234 client->convert_cb = conv;
235
236 return client;
237}
225 - 234行,为client分配空间,并初始化相关成员。
236行,返回client。
当客户要读取AD转换结果时,可调用s3c_adc_read函数,其定义如下:
175int s3c_adc_read(struct s3c_adc_client *client, unsigned int ch)
176{
177 DECLARE_WAIT_QUEUE_HEAD_ONSTACK(wake);
178 int ret;
179
180 client->convert_cb = s3c_convert_done;
181 client->wait = &wake;
182 client->result = -1;
183
184 ret = s3c_adc_start(client, ch, 1);
185 if (ret < 0)
186 goto err;
187
188 ret = wait_event_timeout(wake, client->result >= 0, HZ / 2);
189 if (client->result < 0) {
190 ret = -ETIMEDOUT;
191 goto err;
192 }
193
194 client->convert_cb = NULL;
195 return client->result;
196
197err:
198 return ret;
199}
177行,定义等待队列头。
180行,指定convert回调函数是s3c_convert_done,该函数我们在后面分析。
184行,调用s3c_adc_start函数,该函数我们在后面分析,第二个参数代表使用的ADC通道,第三个参数指定采样次数,这里可以看出,使用s3c_adc_read,采样次数均为1。
188行,调用wait_event_timeout在等待队列wake上休眠,休眠条件是 client->result >= 0,最长休眠时间为HZ/2。
client的convert回调函数s3c_convert_done定义如下:
168static void s3c_convert_done(struct s3c_adc_client *client,
169 unsigned v, unsigned u, unsigned *left)
170{
171 client->result = v;
172 wake_up(client->wait);
173}
172行,唤醒等待队列中的休眠进程。
s3c_adc_start函数定义如下:
135int s3c_adc_start(struct s3c_adc_client *client,
136 unsigned int channel, unsigned int nr_samples)
137{
138 struct adc_device *adc = adc_dev;
139 unsigned long flags;
140
141 if (!adc) {
142 printk(KERN_ERR "%s: failed to find adc\n", __func__);
143 return -EINVAL;
144 }
145
146 if (client->is_ts && adc->ts_pend)
147 return -EAGAIN;
148
149 spin_lock_irqsave(&adc->lock, flags);
150
151 client->channel = channel;
152 client->nr_samples = nr_samples;
153
154 if (client->is_ts)
155 adc->ts_pend = client;
156 else
157 list_add_tail(&client->pend, &adc_pending);
158
159 if (!adc->cur)
160 s3c_adc_try(adc);
161
162 spin_unlock_irqrestore(&adc->lock, flags);
163
164 return 0;
165}
152行,设置采样次数。
155行,如果是触摸屏,则将client保存在adc->ts_pend中。
157行,如果不是触摸屏,则将client插入adc_pending链表中。
159 - 160行,如果没有正在处理其他客户请求,则调用s3c_adc_try函数处理当前客户请求。
下面看s3c_adc_try函数的定义:
115static void s3c_adc_try(struct adc_device *adc)
116{
117 struct s3c_adc_client *next = adc->ts_pend;
118
119 if (!next && !list_empty(&adc_pending)) {
120 next = list_first_entry(&adc_pending,
121 struct s3c_adc_client, pend);
122 list_del(&next->pend);
123 } else
124 adc->ts_pend = NULL;
125
126 if (next) {
127 adc_dbg(adc, "new client is %p\n", next);
128 adc->cur = next;
129 s3c_adc_select(adc, next);
130 s3c_adc_convert(adc);
131 s3c_adc_dbgshow(adc);
132 }
133}
126 - 132行,如果没有等待的客户,则ADC处理结束。如果有等待的客户(client),则对客户AD转换请求进行处理。其中用到了s3c_adc_select,s3c_adc_convert ,s3c_adc_dbgshow函数。下面依次进行分析。
首先看s3c_adc_select函数:
90static inline void s3c_adc_select(struct adc_device *adc,
91 struct s3c_adc_client *client)
92{
93 unsigned con = readl(adc->regs + S3C2410_ADCCON);
94
95 client->select_cb(client, 1);
96
97 con &= ~S3C2410_ADCCON_MUXMASK;
98 con &= ~S3C2410_ADCCON_STDBM;
99 con &= ~S3C2410_ADCCON_STARTMASK;
100
101 if (!client->is_ts)
102 con |= S3C2410_ADCCON_SELMUX(client->channel);
103
104 writel(con, adc->regs + S3C2410_ADCCON);
105}
97 - 104行,初始化ADC控制器。
下面我们看s3c_adc_convert函数的定义:
82static inline void s3c_adc_convert(struct adc_device *adc)
83{
84 unsigned con = readl(adc->regs + S3C2410_ADCCON);
85
86 con |= S3C2410_ADCCON_ENABLE_START;
87 writel(con, adc->regs + S3C2410_ADCCON);
88}
#define S3C2410_ADCCON_ENABLE_START (1<<0)
所以s3c_adc_convert的作用是启动AD转换。
下面是s3c_adc_dbgshow函数的定义:
107static void s3c_adc_dbgshow(struct adc_device *adc)
108{
109 adc_dbg(adc, "CON=%08x, TSC=%08x, DLY=%08x\n",
110 readl(adc->regs + S3C2410_ADCCON),
111 readl(adc->regs + S3C2410_ADCTSC),
112 readl(adc->regs + S3C2410_ADCDLY));
113}
s3c_adc_convert函数启动AD转换,转换结束后,会触发ADC中断,下面看ADC中断处理函数s3c_adc_irq,其代码如下:
270static irqreturn_t s3c_adc_irq(int irq, void *pw)
271{
272 struct adc_device *adc = pw;
273 struct s3c_adc_client *client = adc->cur;
274 enum s3c_cpu_type cpu = platform_get_device_id(adc->pdev)->driver_data;
275 unsigned data0, data1;
276
277 if (!client) {
278 dev_warn(&adc->pdev->dev, "%s: no adc pending\n", __func__);
279 goto exit;
280 }
281
282 data0 = readl(adc->regs + S3C2410_ADCDAT0);
283 data1 = readl(adc->regs + S3C2410_ADCDAT1);
284 adc_dbg(adc, "read %d: 0x%04x, 0x%04x\n", client->nr_samples, data0, data1);
285
286 client->nr_samples--;
287
288 if (cpu == TYPE_S3C64XX) {
289 /* S3C64XX ADC resolution is 12-bit */
290 data0 &= 0xfff;
291 data1 &= 0xfff;
292 } else {
293 data0 &= 0x3ff;
294 data1 &= 0x3ff;
295 }
296
297 if (client->convert_cb)
298 (client->convert_cb)(client, data0, data1, &client->nr_samples);
299
300 if (client->nr_samples > 0) {
301 /* fire another conversion for this */
302
303 client->select_cb(client, 1);
304 s3c_adc_convert(adc);
305 } else {
306 spin_lock(&adc->lock);
307 (client->select_cb)(client, 0);
308 adc->cur = NULL;
309
310 s3c_adc_try(adc);
311 spin_unlock(&adc->lock);
312 }
313
314exit:
315 if (cpu == TYPE_S3C64XX) {
316 /* Clear ADC interrupt */
317 writel(0, adc->regs + S3C64XX_ADCCLRINT);
318 }
319 return IRQ_HANDLED;
320}
282行,读ADCDAT0,保存在data0中。
283行,读ADCDAT1,保存在data1中。
293 - 294行,取data0和data1的低10位,分别对应x坐标值和y坐标值。
297 - 298行,如果客户(client)定义了convert_cb,则调用之。这个回调函数的例子,可以看S3C2410触摸屏驱动的相应回调函数s3c24xx_ts_conversion ,定义在drivers/input/touchscreen/s3c2410_ts.c文件中。这个回调函数的作用是根据驱动程序的具体要求,对转换结果进行相应处理。对于S3C2410触摸屏驱动的相应回调函数,就是把每次转换后的X坐标值求和,Y坐标值求和,同时记录转换次数,以便在以后取多次转换结果的平均值。
300行,如果client->nr_samples > 0,说明还要进行一次采样。
303行,client->select_cb(client, 1),这个回调函数的例子,可以看S3C2410触摸屏驱动的相应回调函数s3c24xx_ts_select。第二个参数为1,表示选择客户client,让客户初始化好,准备处理AD转换结果;第二个参数为0,表示取消对客户client的选择。
304行,调用s3c_adc_convert函数,因为300判断了还要再进行采样,所以这里调用s3c_adc_convert再次进行AD转换。
307行,如果不需要再进行一次采样,调用(client->select_cb)(client, 0),取消对客户client的选择,同时客户会对AD转换结果进行处理。
308行,将adc->cur设置为NULL。
310行,调用s3c_adc_try(adc)函数,其作用是检查是否还有客户在等待ADC服务,如果有,则将其设置为当前客户,并启动AD转换。
至此,整个ADC通用驱动我们就分析完了。
下面整理一下用户要执行ADC操作时函数调用流程:
1. 用户调用s3c_adc_register注册client。
2. 用户调用s3c_adc_read读取ADC控制器 -> s3c_adc_start -> s3c_adc_try -> s3c_adc_select(选择客户)、s3c_adc_convert(启动AD转换) -> 转换结束后发出中断,执行中断处理函数s3c_adc_irq。
3.用户也可以不通过调用s3c_adc_read函数,直接调用s3c_adc_start函数执行ADC操作。S3C2410触摸屏驱动就是这样做的。