Merge branch 'drm-radeon-sun-hainan' of git://people.freedesktop.org/~airlied/linux
[GitHub/mt8127/android_kernel_alcatel_ttab.git] / drivers / staging / comedi / drivers / das1800.c
CommitLineData
a69cc3a9
FMH
1/*
2 comedi/drivers/das1800.c
3 Driver for Keitley das1700/das1800 series boards
4 Copyright (C) 2000 Frank Mori Hess <fmhess@users.sourceforge.net>
5
6 COMEDI - Linux Control and Measurement Device Interface
7 Copyright (C) 2000 David A. Schleef <ds@schleef.org>
8
9 This program is free software; you can redistribute it and/or modify
10 it under the terms of the GNU General Public License as published by
11 the Free Software Foundation; either version 2 of the License, or
12 (at your option) any later version.
13
14 This program is distributed in the hope that it will be useful,
15 but WITHOUT ANY WARRANTY; without even the implied warranty of
16 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
17 GNU General Public License for more details.
18
19 You should have received a copy of the GNU General Public License
20 along with this program; if not, write to the Free Software
21 Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
22
23************************************************************************
24*/
25/*
26Driver: das1800
27Description: Keithley Metrabyte DAS1800 (& compatibles)
28Author: Frank Mori Hess <fmhess@users.sourceforge.net>
29Devices: [Keithley Metrabyte] DAS-1701ST (das-1701st),
30 DAS-1701ST-DA (das-1701st-da), DAS-1701/AO (das-1701ao),
31 DAS-1702ST (das-1702st), DAS-1702ST-DA (das-1702st-da),
32 DAS-1702HR (das-1702hr), DAS-1702HR-DA (das-1702hr-da),
33 DAS-1702/AO (das-1702ao), DAS-1801ST (das-1801st),
34 DAS-1801ST-DA (das-1801st-da), DAS-1801HC (das-1801hc),
35 DAS-1801AO (das-1801ao), DAS-1802ST (das-1802st),
36 DAS-1802ST-DA (das-1802st-da), DAS-1802HR (das-1802hr),
37 DAS-1802HR-DA (das-1802hr-da), DAS-1802HC (das-1802hc),
38 DAS-1802AO (das-1802ao)
39Status: works
40
41The waveform analog output on the 'ao' cards is not supported.
42If you need it, send me (Frank Hess) an email.
43
44Configuration options:
45 [0] - I/O port base address
46 [1] - IRQ (optional, required for timed or externally triggered conversions)
47 [2] - DMA0 (optional, requires irq)
48 [3] - DMA1 (optional, requires irq and dma0)
49*/
50/*
51
52This driver supports the following Keithley boards:
53
54das-1701st
55das-1701st-da
56das-1701ao
57das-1702st
58das-1702st-da
59das-1702hr
60das-1702hr-da
61das-1702ao
62das-1801st
63das-1801st-da
64das-1801hc
65das-1801ao
66das-1802st
67das-1802st-da
68das-1802hr
69das-1802hr-da
70das-1802hc
71das-1802ao
72
73Options:
74 [0] - base io address
75 [1] - irq (optional, required for timed or externally triggered conversions)
76 [2] - dma0 (optional, requires irq)
77 [3] - dma1 (optional, requires irq and dma0)
78
79irq can be omitted, although the cmd interface will not work without it.
80
81analog input cmd triggers supported:
82 start_src: TRIG_NOW | TRIG_EXT
83 scan_begin_src: TRIG_FOLLOW | TRIG_TIMER | TRIG_EXT
84 scan_end_src: TRIG_COUNT
85 convert_src: TRIG_TIMER | TRIG_EXT (TRIG_EXT requires scan_begin_src == TRIG_FOLLOW)
86 stop_src: TRIG_COUNT | TRIG_EXT | TRIG_NONE
87
88scan_begin_src triggers TRIG_TIMER and TRIG_EXT use the card's
89'burst mode' which limits the valid conversion time to 64 microseconds
90(convert_arg <= 64000). This limitation does not apply if scan_begin_src
91is TRIG_FOLLOW.
92
93NOTES:
94Only the DAS-1801ST has been tested by me.
95Unipolar and bipolar ranges cannot be mixed in the channel/gain list.
96
97TODO:
98 Make it automatically allocate irq and dma channels if they are not specified
99 Add support for analog out on 'ao' cards
100 read insn for analog out
101*/
102
25436dc9 103#include <linux/interrupt.h>
5a0e3ad6 104#include <linux/slab.h>
845d131e 105#include <linux/io.h>
a69cc3a9
FMH
106#include "../comedidev.h"
107
108#include <linux/ioport.h>
109#include <asm/dma.h>
110
111#include "8253.h"
112#include "comedi_fc.h"
113
a351ecf3
BP
114/* misc. defines */
115#define DAS1800_SIZE 16 /* uses 16 io addresses */
116#define FIFO_SIZE 1024 /* 1024 sample fifo */
117#define TIMER_BASE 200 /* 5 Mhz master clock */
118#define UNIPOLAR 0x4 /* bit that determines whether input range is uni/bipolar */
119#define DMA_BUF_SIZE 0x1ff00 /* size in bytes of dma buffers */
a69cc3a9
FMH
120
121/* Registers for the das1800 */
122#define DAS1800_FIFO 0x0
123#define DAS1800_QRAM 0x0
124#define DAS1800_DAC 0x0
125#define DAS1800_SELECT 0x2
126#define ADC 0x0
127#define QRAM 0x1
128#define DAC(a) (0x2 + a)
129#define DAS1800_DIGITAL 0x3
130#define DAS1800_CONTROL_A 0x4
131#define FFEN 0x1
132#define CGEN 0x4
133#define CGSL 0x8
134#define TGEN 0x10
135#define TGSL 0x20
136#define ATEN 0x80
137#define DAS1800_CONTROL_B 0x5
138#define DMA_CH5 0x1
139#define DMA_CH6 0x2
140#define DMA_CH7 0x3
141#define DMA_CH5_CH6 0x5
142#define DMA_CH6_CH7 0x6
143#define DMA_CH7_CH5 0x7
a351ecf3 144#define DMA_ENABLED 0x3 /* mask used to determine if dma is enabled */
a69cc3a9
FMH
145#define DMA_DUAL 0x4
146#define IRQ3 0x8
147#define IRQ5 0x10
148#define IRQ7 0x18
149#define IRQ10 0x28
150#define IRQ11 0x30
151#define IRQ15 0x38
152#define FIMD 0x40
153#define DAS1800_CONTROL_C 0X6
154#define IPCLK 0x1
155#define XPCLK 0x3
156#define BMDE 0x4
157#define CMEN 0x8
158#define UQEN 0x10
159#define SD 0x40
160#define UB 0x80
161#define DAS1800_STATUS 0x7
a351ecf3 162/* bits that prevent interrupt status bits (and CVEN) from being cleared on write */
a69cc3a9
FMH
163#define CLEAR_INTR_MASK (CVEN_MASK | 0x1f)
164#define INT 0x1
165#define DMATC 0x2
166#define CT0TC 0x8
167#define OVF 0x10
168#define FHF 0x20
169#define FNE 0x40
a351ecf3 170#define CVEN_MASK 0x40 /* masks CVEN on write */
a69cc3a9
FMH
171#define CVEN 0x80
172#define DAS1800_BURST_LENGTH 0x8
173#define DAS1800_BURST_RATE 0x9
174#define DAS1800_QRAM_ADDRESS 0xa
175#define DAS1800_COUNTER 0xc
176
a351ecf3 177#define IOBASE2 0x400 /* offset of additional ioports used on 'ao' cards */
a69cc3a9
FMH
178
179enum {
180 das1701st, das1701st_da, das1702st, das1702st_da, das1702hr,
181 das1702hr_da,
182 das1701ao, das1702ao, das1801st, das1801st_da, das1802st, das1802st_da,
183 das1802hr, das1802hr_da, das1801hc, das1802hc, das1801ao, das1802ao
184};
185
a351ecf3 186/* analog input ranges */
9ced1de6 187static const struct comedi_lrange range_ai_das1801 = {
a69cc3a9
FMH
188 8,
189 {
0a85b6f0
MT
190 RANGE(-5, 5),
191 RANGE(-1, 1),
192 RANGE(-0.1, 0.1),
193 RANGE(-0.02, 0.02),
194 RANGE(0, 5),
195 RANGE(0, 1),
196 RANGE(0, 0.1),
197 RANGE(0, 0.02),
198 }
a69cc3a9
FMH
199};
200
9ced1de6 201static const struct comedi_lrange range_ai_das1802 = {
a69cc3a9
FMH
202 8,
203 {
0a85b6f0
MT
204 RANGE(-10, 10),
205 RANGE(-5, 5),
206 RANGE(-2.5, 2.5),
207 RANGE(-1.25, 1.25),
208 RANGE(0, 10),
209 RANGE(0, 5),
210 RANGE(0, 2.5),
211 RANGE(0, 1.25),
212 }
a69cc3a9
FMH
213};
214
ce422cf3 215struct das1800_board {
a69cc3a9
FMH
216 const char *name;
217 int ai_speed; /* max conversion period in nanoseconds */
218 int resolution; /* bits of ai resolution */
219 int qram_len; /* length of card's channel / gain queue */
220 int common; /* supports AREF_COMMON flag */
221 int do_n_chan; /* number of digital output channels */
222 int ao_ability; /* 0 == no analog out, 1 == basic analog out, 2 == waveform analog out */
223 int ao_n_chan; /* number of analog out channels */
9ced1de6 224 const struct comedi_lrange *range_ai; /* available input ranges */
ce422cf3 225};
a69cc3a9
FMH
226
227/* Warning: the maximum conversion speeds listed below are
228 * not always achievable depending on board setup (see
229 * user manual.)
230 */
ce422cf3 231static const struct das1800_board das1800_boards[] = {
a69cc3a9 232 {
0a85b6f0
MT
233 .name = "das-1701st",
234 .ai_speed = 6250,
235 .resolution = 12,
236 .qram_len = 256,
237 .common = 1,
238 .do_n_chan = 4,
239 .ao_ability = 0,
240 .ao_n_chan = 0,
241 .range_ai = &range_ai_das1801,
242 },
a69cc3a9 243 {
0a85b6f0
MT
244 .name = "das-1701st-da",
245 .ai_speed = 6250,
246 .resolution = 12,
247 .qram_len = 256,
248 .common = 1,
249 .do_n_chan = 4,
250 .ao_ability = 1,
251 .ao_n_chan = 4,
252 .range_ai = &range_ai_das1801,
253 },
a69cc3a9 254 {
0a85b6f0
MT
255 .name = "das-1702st",
256 .ai_speed = 6250,
257 .resolution = 12,
258 .qram_len = 256,
259 .common = 1,
260 .do_n_chan = 4,
261 .ao_ability = 0,
262 .ao_n_chan = 0,
263 .range_ai = &range_ai_das1802,
264 },
a69cc3a9 265 {
0a85b6f0
MT
266 .name = "das-1702st-da",
267 .ai_speed = 6250,
268 .resolution = 12,
269 .qram_len = 256,
270 .common = 1,
271 .do_n_chan = 4,
272 .ao_ability = 1,
273 .ao_n_chan = 4,
274 .range_ai = &range_ai_das1802,
275 },
a69cc3a9 276 {
0a85b6f0
MT
277 .name = "das-1702hr",
278 .ai_speed = 20000,
279 .resolution = 16,
280 .qram_len = 256,
281 .common = 1,
282 .do_n_chan = 4,
283 .ao_ability = 0,
284 .ao_n_chan = 0,
285 .range_ai = &range_ai_das1802,
286 },
a69cc3a9 287 {
0a85b6f0
MT
288 .name = "das-1702hr-da",
289 .ai_speed = 20000,
290 .resolution = 16,
291 .qram_len = 256,
292 .common = 1,
293 .do_n_chan = 4,
294 .ao_ability = 1,
295 .ao_n_chan = 2,
296 .range_ai = &range_ai_das1802,
297 },
a69cc3a9 298 {
0a85b6f0
MT
299 .name = "das-1701ao",
300 .ai_speed = 6250,
301 .resolution = 12,
302 .qram_len = 256,
303 .common = 1,
304 .do_n_chan = 4,
305 .ao_ability = 2,
306 .ao_n_chan = 2,
307 .range_ai = &range_ai_das1801,
308 },
a69cc3a9 309 {
0a85b6f0
MT
310 .name = "das-1702ao",
311 .ai_speed = 6250,
312 .resolution = 12,
313 .qram_len = 256,
314 .common = 1,
315 .do_n_chan = 4,
316 .ao_ability = 2,
317 .ao_n_chan = 2,
318 .range_ai = &range_ai_das1802,
319 },
a69cc3a9 320 {
0a85b6f0
MT
321 .name = "das-1801st",
322 .ai_speed = 3000,
323 .resolution = 12,
324 .qram_len = 256,
325 .common = 1,
326 .do_n_chan = 4,
327 .ao_ability = 0,
328 .ao_n_chan = 0,
329 .range_ai = &range_ai_das1801,
330 },
a69cc3a9 331 {
0a85b6f0
MT
332 .name = "das-1801st-da",
333 .ai_speed = 3000,
334 .resolution = 12,
335 .qram_len = 256,
336 .common = 1,
337 .do_n_chan = 4,
338 .ao_ability = 0,
339 .ao_n_chan = 4,
340 .range_ai = &range_ai_das1801,
341 },
a69cc3a9 342 {
0a85b6f0
MT
343 .name = "das-1802st",
344 .ai_speed = 3000,
345 .resolution = 12,
346 .qram_len = 256,
347 .common = 1,
348 .do_n_chan = 4,
349 .ao_ability = 0,
350 .ao_n_chan = 0,
351 .range_ai = &range_ai_das1802,
352 },
a69cc3a9 353 {
0a85b6f0
MT
354 .name = "das-1802st-da",
355 .ai_speed = 3000,
356 .resolution = 12,
357 .qram_len = 256,
358 .common = 1,
359 .do_n_chan = 4,
360 .ao_ability = 1,
361 .ao_n_chan = 4,
362 .range_ai = &range_ai_das1802,
363 },
a69cc3a9 364 {
0a85b6f0
MT
365 .name = "das-1802hr",
366 .ai_speed = 10000,
367 .resolution = 16,
368 .qram_len = 256,
369 .common = 1,
370 .do_n_chan = 4,
371 .ao_ability = 0,
372 .ao_n_chan = 0,
373 .range_ai = &range_ai_das1802,
374 },
a69cc3a9 375 {
0a85b6f0
MT
376 .name = "das-1802hr-da",
377 .ai_speed = 10000,
378 .resolution = 16,
379 .qram_len = 256,
380 .common = 1,
381 .do_n_chan = 4,
382 .ao_ability = 1,
383 .ao_n_chan = 2,
384 .range_ai = &range_ai_das1802,
385 },
a69cc3a9 386 {
0a85b6f0
MT
387 .name = "das-1801hc",
388 .ai_speed = 3000,
389 .resolution = 12,
390 .qram_len = 64,
391 .common = 0,
392 .do_n_chan = 8,
393 .ao_ability = 1,
394 .ao_n_chan = 2,
395 .range_ai = &range_ai_das1801,
396 },
a69cc3a9 397 {
0a85b6f0
MT
398 .name = "das-1802hc",
399 .ai_speed = 3000,
400 .resolution = 12,
401 .qram_len = 64,
402 .common = 0,
403 .do_n_chan = 8,
404 .ao_ability = 1,
405 .ao_n_chan = 2,
406 .range_ai = &range_ai_das1802,
407 },
a69cc3a9 408 {
0a85b6f0
MT
409 .name = "das-1801ao",
410 .ai_speed = 3000,
411 .resolution = 12,
412 .qram_len = 256,
413 .common = 1,
414 .do_n_chan = 4,
415 .ao_ability = 2,
416 .ao_n_chan = 2,
417 .range_ai = &range_ai_das1801,
418 },
a69cc3a9 419 {
0a85b6f0
MT
420 .name = "das-1802ao",
421 .ai_speed = 3000,
422 .resolution = 12,
423 .qram_len = 256,
424 .common = 1,
425 .do_n_chan = 4,
426 .ao_ability = 2,
427 .ao_n_chan = 2,
428 .range_ai = &range_ai_das1802,
429 },
a69cc3a9
FMH
430};
431
0c5a144d 432struct das1800_private {
a69cc3a9
FMH
433 volatile unsigned int count; /* number of data points left to be taken */
434 unsigned int divisor1; /* value to load into board's counter 1 for timed conversions */
435 unsigned int divisor2; /* value to load into board's counter 2 for timed conversions */
436 int do_bits; /* digital output bits */
437 int irq_dma_bits; /* bits for control register b */
438 /* dma bits for control register b, stored so that dma can be
439 * turned on and off */
440 int dma_bits;
441 unsigned int dma0; /* dma channels used */
442 unsigned int dma1;
443 volatile unsigned int dma_current; /* dma channel currently in use */
444 uint16_t *ai_buf0; /* pointers to dma buffers */
445 uint16_t *ai_buf1;
446 uint16_t *dma_current_buf; /* pointer to dma buffer currently being used */
447 unsigned int dma_transfer_size; /* size of transfer currently used, in bytes */
448 unsigned long iobase2; /* secondary io address used for analog out on 'ao' boards */
449 short ao_update_bits; /* remembers the last write to the 'update' dac */
0c5a144d 450};
a69cc3a9 451
a351ecf3 452/* analog out range for 'ao' boards */
a69cc3a9 453/*
9ced1de6 454static const struct comedi_lrange range_ao_2 = {
a69cc3a9
FMH
455 2,
456 {
457 RANGE(-10, 10),
458 RANGE(-5, 5),
459 }
460};
461*/
462
73e183c3
HS
463static inline uint16_t munge_bipolar_sample(const struct comedi_device *dev,
464 uint16_t sample)
a69cc3a9 465{
fef2aa64
HS
466 const struct das1800_board *thisboard = comedi_board(dev);
467
73e183c3
HS
468 sample += 1 << (thisboard->resolution - 1);
469 return sample;
a69cc3a9
FMH
470}
471
73e183c3
HS
472static void munge_data(struct comedi_device *dev, uint16_t * array,
473 unsigned int num_elements)
a69cc3a9 474{
73e183c3
HS
475 unsigned int i;
476 int unipolar;
a69cc3a9 477
73e183c3
HS
478 /* see if card is using a unipolar or bipolar range so we can munge data correctly */
479 unipolar = inb(dev->iobase + DAS1800_CONTROL_C) & UB;
a69cc3a9 480
73e183c3
HS
481 /* convert to unsigned type if we are in a bipolar mode */
482 if (!unipolar) {
483 for (i = 0; i < num_elements; i++)
484 array[i] = munge_bipolar_sample(dev, array[i]);
a69cc3a9 485 }
73e183c3 486}
a69cc3a9 487
73e183c3
HS
488static void das1800_handle_fifo_half_full(struct comedi_device *dev,
489 struct comedi_subdevice *s)
490{
9a1a6cf8 491 struct das1800_private *devpriv = dev->private;
73e183c3
HS
492 int numPoints = 0; /* number of points to read */
493 struct comedi_cmd *cmd = &s->async->cmd;
a69cc3a9 494
73e183c3
HS
495 numPoints = FIFO_SIZE / 2;
496 /* if we only need some of the points */
497 if (cmd->stop_src == TRIG_COUNT && devpriv->count < numPoints)
498 numPoints = devpriv->count;
499 insw(dev->iobase + DAS1800_FIFO, devpriv->ai_buf0, numPoints);
500 munge_data(dev, devpriv->ai_buf0, numPoints);
501 cfc_write_array_to_buffer(s, devpriv->ai_buf0,
502 numPoints * sizeof(devpriv->ai_buf0[0]));
503 if (cmd->stop_src == TRIG_COUNT)
504 devpriv->count -= numPoints;
505 return;
506}
a69cc3a9 507
73e183c3
HS
508static void das1800_handle_fifo_not_empty(struct comedi_device *dev,
509 struct comedi_subdevice *s)
510{
9a1a6cf8 511 struct das1800_private *devpriv = dev->private;
73e183c3
HS
512 short dpnt;
513 int unipolar;
514 struct comedi_cmd *cmd = &s->async->cmd;
a69cc3a9 515
73e183c3 516 unipolar = inb(dev->iobase + DAS1800_CONTROL_C) & UB;
a69cc3a9 517
73e183c3
HS
518 while (inb(dev->iobase + DAS1800_STATUS) & FNE) {
519 if (cmd->stop_src == TRIG_COUNT && devpriv->count == 0)
520 break;
521 dpnt = inw(dev->iobase + DAS1800_FIFO);
522 /* convert to unsigned type if we are in a bipolar mode */
523 if (!unipolar)
524 ;
525 dpnt = munge_bipolar_sample(dev, dpnt);
526 cfc_write_to_buffer(s, dpnt);
527 if (cmd->stop_src == TRIG_COUNT)
528 devpriv->count--;
a69cc3a9
FMH
529 }
530
73e183c3
HS
531 return;
532}
a69cc3a9 533
73e183c3
HS
534/* Utility function used by das1800_flush_dma() and das1800_handle_dma().
535 * Assumes dma lock is held */
536static void das1800_flush_dma_channel(struct comedi_device *dev,
537 struct comedi_subdevice *s,
538 unsigned int channel, uint16_t *buffer)
539{
9a1a6cf8 540 struct das1800_private *devpriv = dev->private;
73e183c3
HS
541 unsigned int num_bytes, num_samples;
542 struct comedi_cmd *cmd = &s->async->cmd;
a69cc3a9 543
73e183c3 544 disable_dma(channel);
a69cc3a9 545
73e183c3
HS
546 /* clear flip-flop to make sure 2-byte registers
547 * get set correctly */
548 clear_dma_ff(channel);
a69cc3a9 549
73e183c3
HS
550 /* figure out how many points to read */
551 num_bytes = devpriv->dma_transfer_size - get_dma_residue(channel);
552 num_samples = num_bytes / sizeof(short);
a69cc3a9 553
73e183c3
HS
554 /* if we only need some of the points */
555 if (cmd->stop_src == TRIG_COUNT && devpriv->count < num_samples)
556 num_samples = devpriv->count;
a69cc3a9 557
73e183c3
HS
558 munge_data(dev, buffer, num_samples);
559 cfc_write_array_to_buffer(s, buffer, num_bytes);
560 if (s->async->cmd.stop_src == TRIG_COUNT)
561 devpriv->count -= num_samples;
a69cc3a9 562
73e183c3
HS
563 return;
564}
a69cc3a9 565
73e183c3
HS
566/* flushes remaining data from board when external trigger has stopped acquisition
567 * and we are using dma transfers */
568static void das1800_flush_dma(struct comedi_device *dev,
569 struct comedi_subdevice *s)
570{
9a1a6cf8 571 struct das1800_private *devpriv = dev->private;
73e183c3
HS
572 unsigned long flags;
573 const int dual_dma = devpriv->irq_dma_bits & DMA_DUAL;
a69cc3a9 574
73e183c3
HS
575 flags = claim_dma_lock();
576 das1800_flush_dma_channel(dev, s, devpriv->dma_current,
577 devpriv->dma_current_buf);
a69cc3a9 578
73e183c3
HS
579 if (dual_dma) {
580 /* switch to other channel and flush it */
581 if (devpriv->dma_current == devpriv->dma0) {
582 devpriv->dma_current = devpriv->dma1;
583 devpriv->dma_current_buf = devpriv->ai_buf1;
584 } else {
585 devpriv->dma_current = devpriv->dma0;
586 devpriv->dma_current_buf = devpriv->ai_buf0;
587 }
588 das1800_flush_dma_channel(dev, s, devpriv->dma_current,
589 devpriv->dma_current_buf);
a69cc3a9
FMH
590 }
591
73e183c3 592 release_dma_lock(flags);
a69cc3a9 593
73e183c3
HS
594 /* get any remaining samples in fifo */
595 das1800_handle_fifo_not_empty(dev, s);
a69cc3a9 596
73e183c3
HS
597 return;
598}
599
600static void das1800_handle_dma(struct comedi_device *dev,
601 struct comedi_subdevice *s, unsigned int status)
a69cc3a9 602{
9a1a6cf8 603 struct das1800_private *devpriv = dev->private;
73e183c3
HS
604 unsigned long flags;
605 const int dual_dma = devpriv->irq_dma_bits & DMA_DUAL;
a69cc3a9 606
73e183c3
HS
607 flags = claim_dma_lock();
608 das1800_flush_dma_channel(dev, s, devpriv->dma_current,
609 devpriv->dma_current_buf);
610 /* re-enable dma channel */
611 set_dma_addr(devpriv->dma_current,
612 virt_to_bus(devpriv->dma_current_buf));
613 set_dma_count(devpriv->dma_current, devpriv->dma_transfer_size);
614 enable_dma(devpriv->dma_current);
615 release_dma_lock(flags);
a69cc3a9 616
73e183c3
HS
617 if (status & DMATC) {
618 /* clear DMATC interrupt bit */
619 outb(CLEAR_INTR_MASK & ~DMATC, dev->iobase + DAS1800_STATUS);
620 /* switch dma channels for next time, if appropriate */
621 if (dual_dma) {
622 /* read data from the other channel next time */
623 if (devpriv->dma_current == devpriv->dma0) {
624 devpriv->dma_current = devpriv->dma1;
625 devpriv->dma_current_buf = devpriv->ai_buf1;
626 } else {
627 devpriv->dma_current = devpriv->dma0;
628 devpriv->dma_current_buf = devpriv->ai_buf0;
629 }
a69cc3a9 630 }
a69cc3a9 631 }
73e183c3
HS
632
633 return;
a69cc3a9
FMH
634}
635
73e183c3 636static int das1800_cancel(struct comedi_device *dev, struct comedi_subdevice *s)
a69cc3a9 637{
9a1a6cf8
HS
638 struct das1800_private *devpriv = dev->private;
639
73e183c3
HS
640 outb(0x0, dev->iobase + DAS1800_STATUS); /* disable conversions */
641 outb(0x0, dev->iobase + DAS1800_CONTROL_B); /* disable interrupts and dma */
642 outb(0x0, dev->iobase + DAS1800_CONTROL_A); /* disable and clear fifo and stop triggering */
643 if (devpriv->dma0)
644 disable_dma(devpriv->dma0);
645 if (devpriv->dma1)
646 disable_dma(devpriv->dma1);
647 return 0;
a69cc3a9
FMH
648}
649
73e183c3
HS
650/* the guts of the interrupt handler, that is shared with das1800_ai_poll */
651static void das1800_ai_handler(struct comedi_device *dev)
a69cc3a9 652{
9a1a6cf8 653 struct das1800_private *devpriv = dev->private;
2e3d3cf5 654 struct comedi_subdevice *s = &dev->subdevices[0];
73e183c3
HS
655 struct comedi_async *async = s->async;
656 struct comedi_cmd *cmd = &async->cmd;
657 unsigned int status = inb(dev->iobase + DAS1800_STATUS);
a69cc3a9 658
73e183c3
HS
659 async->events = 0;
660 /* select adc for base address + 0 */
661 outb(ADC, dev->iobase + DAS1800_SELECT);
662 /* dma buffer full */
663 if (devpriv->irq_dma_bits & DMA_ENABLED) {
664 /* look for data from dma transfer even if dma terminal count hasn't happened yet */
665 das1800_handle_dma(dev, s, status);
666 } else if (status & FHF) { /* if fifo half full */
667 das1800_handle_fifo_half_full(dev, s);
668 } else if (status & FNE) { /* if fifo not empty */
669 das1800_handle_fifo_not_empty(dev, s);
a69cc3a9
FMH
670 }
671
672 async->events |= COMEDI_CB_BLOCK;
673 /* if the card's fifo has overflowed */
674 if (status & OVF) {
a351ecf3 675 /* clear OVF interrupt bit */
a69cc3a9
FMH
676 outb(CLEAR_INTR_MASK & ~OVF, dev->iobase + DAS1800_STATUS);
677 comedi_error(dev, "DAS1800 FIFO overflow");
678 das1800_cancel(dev, s);
679 async->events |= COMEDI_CB_ERROR | COMEDI_CB_EOA;
680 comedi_event(dev, s);
681 return;
682 }
a351ecf3 683 /* stop taking data if appropriate */
a69cc3a9
FMH
684 /* stop_src TRIG_EXT */
685 if (status & CT0TC) {
a351ecf3 686 /* clear CT0TC interrupt bit */
a69cc3a9 687 outb(CLEAR_INTR_MASK & ~CT0TC, dev->iobase + DAS1800_STATUS);
a351ecf3 688 /* make sure we get all remaining data from board before quitting */
a69cc3a9
FMH
689 if (devpriv->irq_dma_bits & DMA_ENABLED)
690 das1800_flush_dma(dev, s);
691 else
692 das1800_handle_fifo_not_empty(dev, s);
693 das1800_cancel(dev, s); /* disable hardware conversions */
694 async->events |= COMEDI_CB_EOA;
a351ecf3 695 } else if (cmd->stop_src == TRIG_COUNT && devpriv->count == 0) { /* stop_src TRIG_COUNT */
a69cc3a9
FMH
696 das1800_cancel(dev, s); /* disable hardware conversions */
697 async->events |= COMEDI_CB_EOA;
698 }
699
700 comedi_event(dev, s);
701
702 return;
703}
704
73e183c3
HS
705static int das1800_ai_poll(struct comedi_device *dev,
706 struct comedi_subdevice *s)
a69cc3a9
FMH
707{
708 unsigned long flags;
a69cc3a9 709
73e183c3
HS
710 /* prevent race with interrupt handler */
711 spin_lock_irqsave(&dev->spinlock, flags);
712 das1800_ai_handler(dev);
713 spin_unlock_irqrestore(&dev->spinlock, flags);
a69cc3a9 714
73e183c3 715 return s->async->buf_write_count - s->async->buf_read_count;
a69cc3a9
FMH
716}
717
73e183c3 718static irqreturn_t das1800_interrupt(int irq, void *d)
a69cc3a9 719{
73e183c3
HS
720 struct comedi_device *dev = d;
721 unsigned int status;
a69cc3a9 722
a7401cdd 723 if (!dev->attached) {
73e183c3
HS
724 comedi_error(dev, "premature interrupt");
725 return IRQ_HANDLED;
a69cc3a9 726 }
a69cc3a9 727
73e183c3
HS
728 /* Prevent race with das1800_ai_poll() on multi processor systems.
729 * Also protects indirect addressing in das1800_ai_handler */
730 spin_lock(&dev->spinlock);
731 status = inb(dev->iobase + DAS1800_STATUS);
a69cc3a9 732
73e183c3
HS
733 /* if interrupt was not caused by das-1800 */
734 if (!(status & INT)) {
735 spin_unlock(&dev->spinlock);
736 return IRQ_NONE;
a69cc3a9 737 }
73e183c3
HS
738 /* clear the interrupt status bit INT */
739 outb(CLEAR_INTR_MASK & ~INT, dev->iobase + DAS1800_STATUS);
740 /* handle interrupt */
741 das1800_ai_handler(dev);
a69cc3a9 742
73e183c3
HS
743 spin_unlock(&dev->spinlock);
744 return IRQ_HANDLED;
a69cc3a9
FMH
745}
746
73e183c3
HS
747/* converts requested conversion timing to timing compatible with
748 * hardware, used only when card is in 'burst mode'
749 */
750static unsigned int burst_convert_arg(unsigned int convert_arg, int round_mode)
a69cc3a9 751{
73e183c3 752 unsigned int micro_sec;
a69cc3a9 753
73e183c3
HS
754 /* in burst mode, the maximum conversion time is 64 microseconds */
755 if (convert_arg > 64000)
756 convert_arg = 64000;
a69cc3a9 757
73e183c3
HS
758 /* the conversion time must be an integral number of microseconds */
759 switch (round_mode) {
760 case TRIG_ROUND_NEAREST:
761 default:
762 micro_sec = (convert_arg + 500) / 1000;
763 break;
764 case TRIG_ROUND_DOWN:
765 micro_sec = convert_arg / 1000;
766 break;
767 case TRIG_ROUND_UP:
768 micro_sec = (convert_arg - 1) / 1000 + 1;
769 break;
a69cc3a9
FMH
770 }
771
73e183c3
HS
772 /* return number of nanoseconds */
773 return micro_sec * 1000;
a69cc3a9
FMH
774}
775
776/* test analog input cmd */
0a85b6f0
MT
777static int das1800_ai_do_cmdtest(struct comedi_device *dev,
778 struct comedi_subdevice *s,
779 struct comedi_cmd *cmd)
a69cc3a9 780{
fef2aa64 781 const struct das1800_board *thisboard = comedi_board(dev);
9a1a6cf8 782 struct das1800_private *devpriv = dev->private;
a69cc3a9 783 int err = 0;
a69cc3a9
FMH
784 unsigned int tmp_arg;
785 int i;
786 int unipolar;
787
27020ffe 788 /* Step 1 : check if triggers are trivially valid */
a69cc3a9 789
27020ffe
HS
790 err |= cfc_check_trigger_src(&cmd->start_src, TRIG_NOW | TRIG_EXT);
791 err |= cfc_check_trigger_src(&cmd->scan_begin_src,
792 TRIG_FOLLOW | TRIG_TIMER | TRIG_EXT);
793 err |= cfc_check_trigger_src(&cmd->convert_src, TRIG_TIMER | TRIG_EXT);
794 err |= cfc_check_trigger_src(&cmd->scan_end_src, TRIG_COUNT);
795 err |= cfc_check_trigger_src(&cmd->stop_src,
796 TRIG_COUNT | TRIG_EXT | TRIG_NONE);
a69cc3a9
FMH
797
798 if (err)
799 return 1;
800
27020ffe
HS
801 /* Step 2a : make sure trigger sources are unique */
802
803 err |= cfc_check_trigger_is_unique(cmd->start_src);
804 err |= cfc_check_trigger_is_unique(cmd->scan_begin_src);
805 err |= cfc_check_trigger_is_unique(cmd->convert_src);
806 err |= cfc_check_trigger_is_unique(cmd->stop_src);
807
808 /* Step 2b : and mutually compatible */
a69cc3a9 809
a69cc3a9 810 if (cmd->scan_begin_src != TRIG_FOLLOW &&
0a85b6f0 811 cmd->convert_src != TRIG_TIMER)
27020ffe 812 err |= -EINVAL;
a69cc3a9
FMH
813
814 if (err)
815 return 2;
816
35402007 817 /* Step 3: check if arguments are trivially valid */
a69cc3a9 818
35402007
HS
819 err |= cfc_check_trigger_arg_is(&cmd->start_arg, 0);
820
821 if (cmd->convert_src == TRIG_TIMER)
822 err |= cfc_check_trigger_arg_min(&cmd->convert_arg,
823 thisboard->ai_speed);
824
825 err |= cfc_check_trigger_arg_min(&cmd->chanlist_len, 1);
826 err |= cfc_check_trigger_arg_is(&cmd->scan_end_arg, cmd->chanlist_len);
a69cc3a9
FMH
827
828 switch (cmd->stop_src) {
829 case TRIG_COUNT:
35402007 830 err |= cfc_check_trigger_arg_min(&cmd->stop_arg, 1);
a69cc3a9
FMH
831 break;
832 case TRIG_NONE:
35402007 833 err |= cfc_check_trigger_arg_is(&cmd->stop_arg, 0);
a69cc3a9
FMH
834 break;
835 default:
836 break;
837 }
838
839 if (err)
840 return 3;
841
842 /* step 4: fix up any arguments */
843
844 if (cmd->convert_src == TRIG_TIMER) {
a351ecf3 845 /* if we are not in burst mode */
a69cc3a9
FMH
846 if (cmd->scan_begin_src == TRIG_FOLLOW) {
847 tmp_arg = cmd->convert_arg;
848 /* calculate counter values that give desired timing */
849 i8253_cascade_ns_to_timer_2div(TIMER_BASE,
0a85b6f0
MT
850 &(devpriv->divisor1),
851 &(devpriv->divisor2),
852 &(cmd->convert_arg),
853 cmd->
854 flags & TRIG_ROUND_MASK);
a69cc3a9
FMH
855 if (tmp_arg != cmd->convert_arg)
856 err++;
857 }
a351ecf3 858 /* if we are in burst mode */
a69cc3a9 859 else {
a351ecf3 860 /* check that convert_arg is compatible */
a69cc3a9
FMH
861 tmp_arg = cmd->convert_arg;
862 cmd->convert_arg =
0a85b6f0
MT
863 burst_convert_arg(cmd->convert_arg,
864 cmd->flags & TRIG_ROUND_MASK);
a69cc3a9
FMH
865 if (tmp_arg != cmd->convert_arg)
866 err++;
867
868 if (cmd->scan_begin_src == TRIG_TIMER) {
a351ecf3 869 /* if scans are timed faster than conversion rate allows */
a69cc3a9 870 if (cmd->convert_arg * cmd->chanlist_len >
0a85b6f0 871 cmd->scan_begin_arg) {
a69cc3a9 872 cmd->scan_begin_arg =
0a85b6f0
MT
873 cmd->convert_arg *
874 cmd->chanlist_len;
a69cc3a9
FMH
875 err++;
876 }
877 tmp_arg = cmd->scan_begin_arg;
878 /* calculate counter values that give desired timing */
879 i8253_cascade_ns_to_timer_2div(TIMER_BASE,
0a85b6f0
MT
880 &(devpriv->
881 divisor1),
882 &(devpriv->
883 divisor2),
884 &(cmd->
885 scan_begin_arg),
886 cmd->
887 flags &
888 TRIG_ROUND_MASK);
a69cc3a9
FMH
889 if (tmp_arg != cmd->scan_begin_arg)
890 err++;
891 }
892 }
893 }
894
895 if (err)
896 return 4;
897
a351ecf3 898 /* make sure user is not trying to mix unipolar and bipolar ranges */
a69cc3a9
FMH
899 if (cmd->chanlist) {
900 unipolar = CR_RANGE(cmd->chanlist[0]) & UNIPOLAR;
901 for (i = 1; i < cmd->chanlist_len; i++) {
902 if (unipolar != (CR_RANGE(cmd->chanlist[i]) & UNIPOLAR)) {
903 comedi_error(dev,
0a85b6f0 904 "unipolar and bipolar ranges cannot be mixed in the chanlist");
a69cc3a9
FMH
905 err++;
906 break;
907 }
908 }
909 }
910
911 if (err)
912 return 5;
913
914 return 0;
915}
916
a351ecf3 917/* returns appropriate bits for control register a, depending on command */
eb4332ef 918static int control_a_bits(const struct comedi_cmd *cmd)
a69cc3a9
FMH
919{
920 int control_a;
921
a351ecf3 922 control_a = FFEN; /* enable fifo */
eb4332ef 923 if (cmd->stop_src == TRIG_EXT)
a69cc3a9 924 control_a |= ATEN;
eb4332ef 925 switch (cmd->start_src) {
a69cc3a9
FMH
926 case TRIG_EXT:
927 control_a |= TGEN | CGSL;
928 break;
929 case TRIG_NOW:
930 control_a |= CGEN;
931 break;
932 default:
933 break;
934 }
935
936 return control_a;
937}
938
a351ecf3 939/* returns appropriate bits for control register c, depending on command */
eb4332ef 940static int control_c_bits(const struct comedi_cmd *cmd)
a69cc3a9
FMH
941{
942 int control_c;
943 int aref;
944
945 /* set clock source to internal or external, select analog reference,
946 * select unipolar / bipolar
947 */
eb4332ef 948 aref = CR_AREF(cmd->chanlist[0]);
a351ecf3 949 control_c = UQEN; /* enable upper qram addresses */
a69cc3a9
FMH
950 if (aref != AREF_DIFF)
951 control_c |= SD;
952 if (aref == AREF_COMMON)
953 control_c |= CMEN;
954 /* if a unipolar range was selected */
eb4332ef 955 if (CR_RANGE(cmd->chanlist[0]) & UNIPOLAR)
a69cc3a9 956 control_c |= UB;
eb4332ef 957 switch (cmd->scan_begin_src) {
a351ecf3 958 case TRIG_FOLLOW: /* not in burst mode */
eb4332ef 959 switch (cmd->convert_src) {
a69cc3a9
FMH
960 case TRIG_TIMER:
961 /* trig on cascaded counters */
962 control_c |= IPCLK;
963 break;
964 case TRIG_EXT:
965 /* trig on falling edge of external trigger */
966 control_c |= XPCLK;
967 break;
968 default:
969 break;
970 }
971 break;
972 case TRIG_TIMER:
a351ecf3 973 /* burst mode with internal pacer clock */
a69cc3a9
FMH
974 control_c |= BMDE | IPCLK;
975 break;
976 case TRIG_EXT:
a351ecf3 977 /* burst mode with external trigger */
a69cc3a9
FMH
978 control_c |= BMDE | XPCLK;
979 break;
980 default:
981 break;
982 }
983
984 return control_c;
985}
986
73e183c3
HS
987/* loads counters with divisor1, divisor2 from private structure */
988static int das1800_set_frequency(struct comedi_device *dev)
a69cc3a9 989{
9a1a6cf8 990 struct das1800_private *devpriv = dev->private;
73e183c3
HS
991 int err = 0;
992
993 /* counter 1, mode 2 */
994 if (i8254_load(dev->iobase + DAS1800_COUNTER, 0, 1, devpriv->divisor1,
995 2))
996 err++;
997 /* counter 2, mode 2 */
998 if (i8254_load(dev->iobase + DAS1800_COUNTER, 0, 2, devpriv->divisor2,
999 2))
1000 err++;
1001 if (err)
1002 return -1;
1003
1004 return 0;
1005}
1006
1007/* sets up counters */
eb4332ef
IA
1008static int setup_counters(struct comedi_device *dev,
1009 const struct comedi_cmd *cmd)
73e183c3 1010{
9a1a6cf8 1011 struct das1800_private *devpriv = dev->private;
eb4332ef
IA
1012 unsigned int period;
1013
73e183c3 1014 /* setup cascaded counters for conversion/scan frequency */
eb4332ef 1015 switch (cmd->scan_begin_src) {
73e183c3 1016 case TRIG_FOLLOW: /* not in burst mode */
eb4332ef 1017 if (cmd->convert_src == TRIG_TIMER) {
73e183c3 1018 /* set conversion frequency */
eb4332ef 1019 period = cmd->convert_arg;
73e183c3 1020 i8253_cascade_ns_to_timer_2div(TIMER_BASE,
eb4332ef
IA
1021 &devpriv->divisor1,
1022 &devpriv->divisor2,
1023 &period,
1024 cmd->flags &
1025 TRIG_ROUND_MASK);
a142785d 1026 if (das1800_set_frequency(dev) < 0)
a69cc3a9 1027 return -1;
a69cc3a9
FMH
1028 }
1029 break;
a351ecf3 1030 case TRIG_TIMER: /* in burst mode */
a69cc3a9 1031 /* set scan frequency */
eb4332ef
IA
1032 period = cmd->scan_begin_arg;
1033 i8253_cascade_ns_to_timer_2div(TIMER_BASE, &devpriv->divisor1,
1034 &devpriv->divisor2, &period,
1035 cmd->flags & TRIG_ROUND_MASK);
a142785d 1036 if (das1800_set_frequency(dev) < 0)
a69cc3a9 1037 return -1;
a69cc3a9
FMH
1038 break;
1039 default:
1040 break;
1041 }
1042
a351ecf3 1043 /* setup counter 0 for 'about triggering' */
eb4332ef 1044 if (cmd->stop_src == TRIG_EXT) {
a351ecf3 1045 /* load counter 0 in mode 0 */
a69cc3a9
FMH
1046 i8254_load(dev->iobase + DAS1800_COUNTER, 0, 0, 1, 0);
1047 }
1048
1049 return 0;
1050}
1051
73e183c3 1052/* utility function that suggests a dma transfer size based on the conversion period 'ns' */
eb4332ef 1053static unsigned int suggest_transfer_size(const struct comedi_cmd *cmd)
73e183c3
HS
1054{
1055 unsigned int size = DMA_BUF_SIZE;
1056 static const int sample_size = 2; /* size in bytes of one sample from board */
1057 unsigned int fill_time = 300000000; /* target time in nanoseconds for filling dma buffer */
1058 unsigned int max_size; /* maximum size we will allow for a transfer */
1059
1060 /* make dma buffer fill in 0.3 seconds for timed modes */
1061 switch (cmd->scan_begin_src) {
1062 case TRIG_FOLLOW: /* not in burst mode */
1063 if (cmd->convert_src == TRIG_TIMER)
1064 size = (fill_time / cmd->convert_arg) * sample_size;
1065 break;
1066 case TRIG_TIMER:
1067 size = (fill_time / (cmd->scan_begin_arg * cmd->chanlist_len)) *
1068 sample_size;
1069 break;
1070 default:
1071 size = DMA_BUF_SIZE;
1072 break;
1073 }
1074
1075 /* set a minimum and maximum size allowed */
1076 max_size = DMA_BUF_SIZE;
1077 /* if we are taking limited number of conversions, limit transfer size to that */
1078 if (cmd->stop_src == TRIG_COUNT &&
1079 cmd->stop_arg * cmd->chanlist_len * sample_size < max_size)
1080 max_size = cmd->stop_arg * cmd->chanlist_len * sample_size;
1081
1082 if (size > max_size)
1083 size = max_size;
1084 if (size < sample_size)
1085 size = sample_size;
1086
1087 return size;
1088}
1089
a351ecf3 1090/* sets up dma */
eb4332ef 1091static void setup_dma(struct comedi_device *dev, const struct comedi_cmd *cmd)
a69cc3a9 1092{
9a1a6cf8 1093 struct das1800_private *devpriv = dev->private;
a69cc3a9
FMH
1094 unsigned long lock_flags;
1095 const int dual_dma = devpriv->irq_dma_bits & DMA_DUAL;
1096
1097 if ((devpriv->irq_dma_bits & DMA_ENABLED) == 0)
1098 return;
1099
1100 /* determine a reasonable dma transfer size */
eb4332ef 1101 devpriv->dma_transfer_size = suggest_transfer_size(cmd);
a69cc3a9
FMH
1102 lock_flags = claim_dma_lock();
1103 disable_dma(devpriv->dma0);
1104 /* clear flip-flop to make sure 2-byte registers for
1105 * count and address get set correctly */
1106 clear_dma_ff(devpriv->dma0);
1107 set_dma_addr(devpriv->dma0, virt_to_bus(devpriv->ai_buf0));
a351ecf3 1108 /* set appropriate size of transfer */
a69cc3a9
FMH
1109 set_dma_count(devpriv->dma0, devpriv->dma_transfer_size);
1110 devpriv->dma_current = devpriv->dma0;
1111 devpriv->dma_current_buf = devpriv->ai_buf0;
1112 enable_dma(devpriv->dma0);
a351ecf3 1113 /* set up dual dma if appropriate */
a69cc3a9
FMH
1114 if (dual_dma) {
1115 disable_dma(devpriv->dma1);
1116 /* clear flip-flop to make sure 2-byte registers for
1117 * count and address get set correctly */
1118 clear_dma_ff(devpriv->dma1);
1119 set_dma_addr(devpriv->dma1, virt_to_bus(devpriv->ai_buf1));
a351ecf3 1120 /* set appropriate size of transfer */
a69cc3a9
FMH
1121 set_dma_count(devpriv->dma1, devpriv->dma_transfer_size);
1122 enable_dma(devpriv->dma1);
1123 }
1124 release_dma_lock(lock_flags);
1125
1126 return;
1127}
1128
a351ecf3 1129/* programs channel/gain list into card */
eb4332ef
IA
1130static void program_chanlist(struct comedi_device *dev,
1131 const struct comedi_cmd *cmd)
a69cc3a9
FMH
1132{
1133 int i, n, chan_range;
1134 unsigned long irq_flags;
a351ecf3 1135 const int range_mask = 0x3; /* masks unipolar/bipolar bit off range */
a69cc3a9
FMH
1136 const int range_bitshift = 8;
1137
eb4332ef 1138 n = cmd->chanlist_len;
a351ecf3 1139 /* spinlock protects indirect addressing */
5f74ea14 1140 spin_lock_irqsave(&dev->spinlock, irq_flags);
a69cc3a9
FMH
1141 outb(QRAM, dev->iobase + DAS1800_SELECT); /* select QRAM for baseAddress + 0x0 */
1142 outb(n - 1, dev->iobase + DAS1800_QRAM_ADDRESS); /*set QRAM address start */
1143 /* make channel / gain list */
1144 for (i = 0; i < n; i++) {
1145 chan_range =
eb4332ef
IA
1146 CR_CHAN(cmd->chanlist[i]) |
1147 ((CR_RANGE(cmd->chanlist[i]) & range_mask) <<
1148 range_bitshift);
a69cc3a9
FMH
1149 outw(chan_range, dev->iobase + DAS1800_QRAM);
1150 }
1151 outb(n - 1, dev->iobase + DAS1800_QRAM_ADDRESS); /*finish write to QRAM */
5f74ea14 1152 spin_unlock_irqrestore(&dev->spinlock, irq_flags);
a69cc3a9
FMH
1153
1154 return;
1155}
1156
a351ecf3 1157/* analog input do_cmd */
0a85b6f0
MT
1158static int das1800_ai_do_cmd(struct comedi_device *dev,
1159 struct comedi_subdevice *s)
a69cc3a9 1160{
9a1a6cf8 1161 struct das1800_private *devpriv = dev->private;
a69cc3a9
FMH
1162 int ret;
1163 int control_a, control_c;
d163679c 1164 struct comedi_async *async = s->async;
eb4332ef 1165 const struct comedi_cmd *cmd = &async->cmd;
a69cc3a9
FMH
1166
1167 if (!dev->irq) {
1168 comedi_error(dev,
0a85b6f0 1169 "no irq assigned for das-1800, cannot do hardware conversions");
a69cc3a9
FMH
1170 return -1;
1171 }
1172
1173 /* disable dma on TRIG_WAKE_EOS, or TRIG_RT
1174 * (because dma in handler is unsafe at hard real-time priority) */
eb4332ef 1175 if (cmd->flags & (TRIG_WAKE_EOS | TRIG_RT))
a69cc3a9 1176 devpriv->irq_dma_bits &= ~DMA_ENABLED;
a142785d 1177 else
a69cc3a9 1178 devpriv->irq_dma_bits |= devpriv->dma_bits;
a351ecf3 1179 /* interrupt on end of conversion for TRIG_WAKE_EOS */
eb4332ef 1180 if (cmd->flags & TRIG_WAKE_EOS) {
a351ecf3 1181 /* interrupt fifo not empty */
a69cc3a9
FMH
1182 devpriv->irq_dma_bits &= ~FIMD;
1183 } else {
a351ecf3 1184 /* interrupt fifo half full */
a69cc3a9
FMH
1185 devpriv->irq_dma_bits |= FIMD;
1186 }
a351ecf3 1187 /* determine how many conversions we need */
eb4332ef
IA
1188 if (cmd->stop_src == TRIG_COUNT)
1189 devpriv->count = cmd->stop_arg * cmd->chanlist_len;
a69cc3a9
FMH
1190
1191 das1800_cancel(dev, s);
1192
a351ecf3 1193 /* determine proper bits for control registers */
a69cc3a9
FMH
1194 control_a = control_a_bits(cmd);
1195 control_c = control_c_bits(cmd);
1196
1197 /* setup card and start */
1198 program_chanlist(dev, cmd);
1199 ret = setup_counters(dev, cmd);
1200 if (ret < 0) {
1201 comedi_error(dev, "Error setting up counters");
1202 return ret;
1203 }
1204 setup_dma(dev, cmd);
1205 outb(control_c, dev->iobase + DAS1800_CONTROL_C);
a351ecf3 1206 /* set conversion rate and length for burst mode */
a69cc3a9 1207 if (control_c & BMDE) {
a351ecf3 1208 /* program conversion period with number of microseconds minus 1 */
eb4332ef 1209 outb(cmd->convert_arg / 1000 - 1,
0a85b6f0 1210 dev->iobase + DAS1800_BURST_RATE);
eb4332ef 1211 outb(cmd->chanlist_len - 1, dev->iobase + DAS1800_BURST_LENGTH);
a69cc3a9 1212 }
a351ecf3 1213 outb(devpriv->irq_dma_bits, dev->iobase + DAS1800_CONTROL_B); /* enable irq/dma */
a69cc3a9
FMH
1214 outb(control_a, dev->iobase + DAS1800_CONTROL_A); /* enable fifo and triggering */
1215 outb(CVEN, dev->iobase + DAS1800_STATUS); /* enable conversions */
1216
1217 return 0;
1218}
1219
1220/* read analog input */
0a85b6f0
MT
1221static int das1800_ai_rinsn(struct comedi_device *dev,
1222 struct comedi_subdevice *s,
1223 struct comedi_insn *insn, unsigned int *data)
a69cc3a9 1224{
fef2aa64 1225 const struct das1800_board *thisboard = comedi_board(dev);
a69cc3a9
FMH
1226 int i, n;
1227 int chan, range, aref, chan_range;
1228 int timeout = 1000;
1229 short dpnt;
1230 int conv_flags = 0;
1231 unsigned long irq_flags;
1232
1233 /* set up analog reference and unipolar / bipolar mode */
1234 aref = CR_AREF(insn->chanspec);
1235 conv_flags |= UQEN;
1236 if (aref != AREF_DIFF)
1237 conv_flags |= SD;
1238 if (aref == AREF_COMMON)
1239 conv_flags |= CMEN;
1240 /* if a unipolar range was selected */
1241 if (CR_RANGE(insn->chanspec) & UNIPOLAR)
1242 conv_flags |= UB;
1243
1244 outb(conv_flags, dev->iobase + DAS1800_CONTROL_C); /* software conversion enabled */
1245 outb(CVEN, dev->iobase + DAS1800_STATUS); /* enable conversions */
1246 outb(0x0, dev->iobase + DAS1800_CONTROL_A); /* reset fifo */
1247 outb(FFEN, dev->iobase + DAS1800_CONTROL_A);
1248
1249 chan = CR_CHAN(insn->chanspec);
1250 /* mask of unipolar/bipolar bit from range */
1251 range = CR_RANGE(insn->chanspec) & 0x3;
1252 chan_range = chan | (range << 8);
5f74ea14 1253 spin_lock_irqsave(&dev->spinlock, irq_flags);
a69cc3a9
FMH
1254 outb(QRAM, dev->iobase + DAS1800_SELECT); /* select QRAM for baseAddress + 0x0 */
1255 outb(0x0, dev->iobase + DAS1800_QRAM_ADDRESS); /* set QRAM address start */
1256 outw(chan_range, dev->iobase + DAS1800_QRAM);
1257 outb(0x0, dev->iobase + DAS1800_QRAM_ADDRESS); /*finish write to QRAM */
1258 outb(ADC, dev->iobase + DAS1800_SELECT); /* select ADC for baseAddress + 0x0 */
1259
1260 for (n = 0; n < insn->n; n++) {
1261 /* trigger conversion */
1262 outb(0, dev->iobase + DAS1800_FIFO);
1263 for (i = 0; i < timeout; i++) {
1264 if (inb(dev->iobase + DAS1800_STATUS) & FNE)
1265 break;
1266 }
1267 if (i == timeout) {
1268 comedi_error(dev, "timeout");
d18c5906
GKH
1269 n = -ETIME;
1270 goto exit;
a69cc3a9
FMH
1271 }
1272 dpnt = inw(dev->iobase + DAS1800_FIFO);
1273 /* shift data to offset binary for bipolar ranges */
1274 if ((conv_flags & UB) == 0)
1275 dpnt += 1 << (thisboard->resolution - 1);
1276 data[n] = dpnt;
1277 }
d18c5906 1278exit:
5f74ea14 1279 spin_unlock_irqrestore(&dev->spinlock, irq_flags);
a69cc3a9
FMH
1280
1281 return n;
1282}
1283
1284/* writes to an analog output channel */
0a85b6f0
MT
1285static int das1800_ao_winsn(struct comedi_device *dev,
1286 struct comedi_subdevice *s,
1287 struct comedi_insn *insn, unsigned int *data)
a69cc3a9 1288{
fef2aa64 1289 const struct das1800_board *thisboard = comedi_board(dev);
9a1a6cf8 1290 struct das1800_private *devpriv = dev->private;
a69cc3a9 1291 int chan = CR_CHAN(insn->chanspec);
a351ecf3 1292/* int range = CR_RANGE(insn->chanspec); */
a69cc3a9
FMH
1293 int update_chan = thisboard->ao_n_chan - 1;
1294 short output;
1295 unsigned long irq_flags;
1296
a351ecf3 1297 /* card expects two's complement data */
a69cc3a9 1298 output = data[0] - (1 << (thisboard->resolution - 1));
a351ecf3 1299 /* if the write is to the 'update' channel, we need to remember its value */
a69cc3a9
FMH
1300 if (chan == update_chan)
1301 devpriv->ao_update_bits = output;
a351ecf3 1302 /* write to channel */
5f74ea14 1303 spin_lock_irqsave(&dev->spinlock, irq_flags);
a69cc3a9
FMH
1304 outb(DAC(chan), dev->iobase + DAS1800_SELECT); /* select dac channel for baseAddress + 0x0 */
1305 outw(output, dev->iobase + DAS1800_DAC);
a351ecf3 1306 /* now we need to write to 'update' channel to update all dac channels */
a69cc3a9
FMH
1307 if (chan != update_chan) {
1308 outb(DAC(update_chan), dev->iobase + DAS1800_SELECT); /* select 'update' channel for baseAddress + 0x0 */
1309 outw(devpriv->ao_update_bits, dev->iobase + DAS1800_DAC);
1310 }
5f74ea14 1311 spin_unlock_irqrestore(&dev->spinlock, irq_flags);
a69cc3a9
FMH
1312
1313 return 1;
1314}
1315
1316/* reads from digital input channels */
0a85b6f0
MT
1317static int das1800_di_rbits(struct comedi_device *dev,
1318 struct comedi_subdevice *s,
1319 struct comedi_insn *insn, unsigned int *data)
a69cc3a9
FMH
1320{
1321
1322 data[1] = inb(dev->iobase + DAS1800_DIGITAL) & 0xf;
1323 data[0] = 0;
1324
a2714e3e 1325 return insn->n;
a69cc3a9
FMH
1326}
1327
1328/* writes to digital output channels */
0a85b6f0
MT
1329static int das1800_do_wbits(struct comedi_device *dev,
1330 struct comedi_subdevice *s,
1331 struct comedi_insn *insn, unsigned int *data)
a69cc3a9 1332{
9a1a6cf8 1333 struct das1800_private *devpriv = dev->private;
790c5541 1334 unsigned int wbits;
a69cc3a9 1335
a351ecf3 1336 /* only set bits that have been masked */
a69cc3a9
FMH
1337 data[0] &= (1 << s->n_chan) - 1;
1338 wbits = devpriv->do_bits;
1339 wbits &= ~data[0];
1340 wbits |= data[0] & data[1];
1341 devpriv->do_bits = wbits;
1342
1343 outb(devpriv->do_bits, dev->iobase + DAS1800_DIGITAL);
1344
1345 data[1] = devpriv->do_bits;
1346
a2714e3e 1347 return insn->n;
a69cc3a9
FMH
1348}
1349
73e183c3
HS
1350static int das1800_init_dma(struct comedi_device *dev, unsigned int dma0,
1351 unsigned int dma1)
a69cc3a9 1352{
9a1a6cf8 1353 struct das1800_private *devpriv = dev->private;
73e183c3 1354 unsigned long flags;
a69cc3a9 1355
73e183c3
HS
1356 /* need an irq to do dma */
1357 if (dev->irq && dma0) {
1358 /* encode dma0 and dma1 into 2 digit hexadecimal for switch */
1359 switch ((dma0 & 0x7) | (dma1 << 4)) {
1360 case 0x5: /* dma0 == 5 */
1361 devpriv->dma_bits |= DMA_CH5;
1362 break;
1363 case 0x6: /* dma0 == 6 */
1364 devpriv->dma_bits |= DMA_CH6;
1365 break;
1366 case 0x7: /* dma0 == 7 */
1367 devpriv->dma_bits |= DMA_CH7;
1368 break;
1369 case 0x65: /* dma0 == 5, dma1 == 6 */
1370 devpriv->dma_bits |= DMA_CH5_CH6;
1371 break;
1372 case 0x76: /* dma0 == 6, dma1 == 7 */
1373 devpriv->dma_bits |= DMA_CH6_CH7;
1374 break;
1375 case 0x57: /* dma0 == 7, dma1 == 5 */
1376 devpriv->dma_bits |= DMA_CH7_CH5;
1377 break;
1378 default:
f41ad667
IA
1379 dev_err(dev->class_dev,
1380 "only supports dma channels 5 through 7\n");
1381 dev_err(dev->class_dev,
1382 "Dual dma only allows the following combinations:\n");
1383 dev_err(dev->class_dev,
1384 "dma 5,6 / 6,7 / or 7,5\n");
73e183c3
HS
1385 return -EINVAL;
1386 break;
1387 }
1388 if (request_dma(dma0, dev->driver->driver_name)) {
f41ad667
IA
1389 dev_err(dev->class_dev,
1390 "failed to allocate dma channel %i\n", dma0);
73e183c3
HS
1391 return -EINVAL;
1392 }
1393 devpriv->dma0 = dma0;
1394 devpriv->dma_current = dma0;
1395 if (dma1) {
1396 if (request_dma(dma1, dev->driver->driver_name)) {
f41ad667
IA
1397 dev_err(dev->class_dev,
1398 "failed to allocate dma channel %i\n",
73e183c3
HS
1399 dma1);
1400 return -EINVAL;
1401 }
1402 devpriv->dma1 = dma1;
1403 }
1404 devpriv->ai_buf0 = kmalloc(DMA_BUF_SIZE, GFP_KERNEL | GFP_DMA);
1405 if (devpriv->ai_buf0 == NULL)
1406 return -ENOMEM;
1407 devpriv->dma_current_buf = devpriv->ai_buf0;
1408 if (dma1) {
1409 devpriv->ai_buf1 =
1410 kmalloc(DMA_BUF_SIZE, GFP_KERNEL | GFP_DMA);
1411 if (devpriv->ai_buf1 == NULL)
1412 return -ENOMEM;
1413 }
1414 flags = claim_dma_lock();
1415 disable_dma(devpriv->dma0);
1416 set_dma_mode(devpriv->dma0, DMA_MODE_READ);
1417 if (dma1) {
1418 disable_dma(devpriv->dma1);
1419 set_dma_mode(devpriv->dma1, DMA_MODE_READ);
1420 }
1421 release_dma_lock(flags);
1422 }
a69cc3a9
FMH
1423 return 0;
1424}
1425
73e183c3 1426static int das1800_probe(struct comedi_device *dev)
a69cc3a9 1427{
73e183c3
HS
1428 int id;
1429 int board;
a69cc3a9 1430
73e183c3
HS
1431 id = (inb(dev->iobase + DAS1800_DIGITAL) >> 4) & 0xf; /* get id bits */
1432 board = ((struct das1800_board *)dev->board_ptr) - das1800_boards;
a69cc3a9 1433
73e183c3
HS
1434 switch (id) {
1435 case 0x3:
1436 if (board == das1801st_da || board == das1802st_da ||
1437 board == das1701st_da || board == das1702st_da) {
f41ad667 1438 dev_dbg(dev->class_dev, "Board model: %s\n",
73e183c3
HS
1439 das1800_boards[board].name);
1440 return board;
1441 }
1442 printk
1443 (" Board model (probed, not recommended): das-1800st-da series\n");
1444 return das1801st;
a69cc3a9 1445 break;
73e183c3
HS
1446 case 0x4:
1447 if (board == das1802hr_da || board == das1702hr_da) {
f41ad667 1448 dev_dbg(dev->class_dev, "Board model: %s\n",
73e183c3
HS
1449 das1800_boards[board].name);
1450 return board;
1451 }
1452 printk
1453 (" Board model (probed, not recommended): das-1802hr-da\n");
1454 return das1802hr;
a69cc3a9 1455 break;
73e183c3
HS
1456 case 0x5:
1457 if (board == das1801ao || board == das1802ao ||
1458 board == das1701ao || board == das1702ao) {
f41ad667 1459 dev_dbg(dev->class_dev, "Board model: %s\n",
73e183c3
HS
1460 das1800_boards[board].name);
1461 return board;
1462 }
1463 printk
1464 (" Board model (probed, not recommended): das-1800ao series\n");
1465 return das1801ao;
1466 break;
1467 case 0x6:
1468 if (board == das1802hr || board == das1702hr) {
f41ad667 1469 dev_dbg(dev->class_dev, "Board model: %s\n",
73e183c3
HS
1470 das1800_boards[board].name);
1471 return board;
1472 }
1473 printk
1474 (" Board model (probed, not recommended): das-1802hr\n");
1475 return das1802hr;
1476 break;
1477 case 0x7:
1478 if (board == das1801st || board == das1802st ||
1479 board == das1701st || board == das1702st) {
f41ad667 1480 dev_dbg(dev->class_dev, "Board model: %s\n",
73e183c3
HS
1481 das1800_boards[board].name);
1482 return board;
1483 }
1484 printk
1485 (" Board model (probed, not recommended): das-1800st series\n");
1486 return das1801st;
1487 break;
1488 case 0x8:
1489 if (board == das1801hc || board == das1802hc) {
f41ad667 1490 dev_dbg(dev->class_dev, "Board model: %s\n",
73e183c3
HS
1491 das1800_boards[board].name);
1492 return board;
1493 }
1494 printk
1495 (" Board model (probed, not recommended): das-1800hc series\n");
1496 return das1801hc;
1497 break;
1498 default:
1499 printk
1500 (" Board model: probe returned 0x%x (unknown, please report)\n",
1501 id);
1502 return board;
a69cc3a9
FMH
1503 break;
1504 }
73e183c3 1505 return -1;
a69cc3a9
FMH
1506}
1507
73e183c3
HS
1508static int das1800_attach(struct comedi_device *dev,
1509 struct comedi_devconfig *it)
a69cc3a9 1510{
fef2aa64 1511 const struct das1800_board *thisboard = comedi_board(dev);
9a1a6cf8 1512 struct das1800_private *devpriv;
73e183c3 1513 struct comedi_subdevice *s;
73e183c3
HS
1514 unsigned int irq = it->options[1];
1515 unsigned int dma0 = it->options[2];
1516 unsigned int dma1 = it->options[3];
73e183c3 1517 int board;
8fdbc75b 1518 int ret;
a69cc3a9 1519
c34fa261
HS
1520 devpriv = kzalloc(sizeof(*devpriv), GFP_KERNEL);
1521 if (!devpriv)
1522 return -ENOMEM;
1523 dev->private = devpriv;
73e183c3 1524
8fdbc75b
HS
1525 ret = comedi_request_region(dev, it->options[0], DAS1800_SIZE);
1526 if (ret)
1527 return ret;
73e183c3
HS
1528
1529 board = das1800_probe(dev);
1530 if (board < 0) {
f41ad667 1531 dev_err(dev->class_dev, "unable to determine board type\n");
73e183c3
HS
1532 return -ENODEV;
1533 }
1534
1535 dev->board_ptr = das1800_boards + board;
fef2aa64 1536 thisboard = comedi_board(dev);
73e183c3
HS
1537 dev->board_name = thisboard->name;
1538
1539 /* if it is an 'ao' board with fancy analog out then we need extra io ports */
1540 if (thisboard->ao_ability == 2) {
8fdbc75b
HS
1541 unsigned long iobase2 = dev->iobase + IOBASE2;
1542
1543 ret = __comedi_request_region(dev, iobase2, DAS1800_SIZE);
e608796a
HS
1544 if (ret)
1545 return ret;
73e183c3
HS
1546 devpriv->iobase2 = iobase2;
1547 }
1548
1549 /* grab our IRQ */
1550 if (irq) {
1551 if (request_irq(irq, das1800_interrupt, 0,
1552 dev->driver->driver_name, dev)) {
f41ad667 1553 dev_dbg(dev->class_dev, "unable to allocate irq %u\n",
73e183c3
HS
1554 irq);
1555 return -EINVAL;
1556 }
1557 }
1558 dev->irq = irq;
1559
1560 /* set bits that tell card which irq to use */
1561 switch (irq) {
1562 case 0:
a69cc3a9 1563 break;
73e183c3
HS
1564 case 3:
1565 devpriv->irq_dma_bits |= 0x8;
1566 break;
1567 case 5:
1568 devpriv->irq_dma_bits |= 0x10;
1569 break;
1570 case 7:
1571 devpriv->irq_dma_bits |= 0x18;
1572 break;
1573 case 10:
1574 devpriv->irq_dma_bits |= 0x28;
1575 break;
1576 case 11:
1577 devpriv->irq_dma_bits |= 0x30;
1578 break;
1579 case 15:
1580 devpriv->irq_dma_bits |= 0x38;
a69cc3a9
FMH
1581 break;
1582 default:
f41ad667 1583 dev_err(dev->class_dev, "irq out of range\n");
73e183c3 1584 return -EINVAL;
a69cc3a9
FMH
1585 break;
1586 }
1587
8fdbc75b
HS
1588 ret = das1800_init_dma(dev, dma0, dma1);
1589 if (ret < 0)
1590 return ret;
a69cc3a9 1591
73e183c3
HS
1592 if (devpriv->ai_buf0 == NULL) {
1593 devpriv->ai_buf0 =
1594 kmalloc(FIFO_SIZE * sizeof(uint16_t), GFP_KERNEL);
1595 if (devpriv->ai_buf0 == NULL)
1596 return -ENOMEM;
1597 }
a69cc3a9 1598
8fdbc75b
HS
1599 ret = comedi_alloc_subdevices(dev, 4);
1600 if (ret)
1601 return ret;
73e183c3
HS
1602
1603 /* analog input subdevice */
2e3d3cf5 1604 s = &dev->subdevices[0];
73e183c3
HS
1605 dev->read_subdev = s;
1606 s->type = COMEDI_SUBD_AI;
1607 s->subdev_flags = SDF_READABLE | SDF_DIFF | SDF_GROUND | SDF_CMD_READ;
1608 if (thisboard->common)
1609 s->subdev_flags |= SDF_COMMON;
1610 s->n_chan = thisboard->qram_len;
1611 s->len_chanlist = thisboard->qram_len;
1612 s->maxdata = (1 << thisboard->resolution) - 1;
1613 s->range_table = thisboard->range_ai;
1614 s->do_cmd = das1800_ai_do_cmd;
1615 s->do_cmdtest = das1800_ai_do_cmdtest;
1616 s->insn_read = das1800_ai_rinsn;
1617 s->poll = das1800_ai_poll;
1618 s->cancel = das1800_cancel;
1619
1620 /* analog out */
2e3d3cf5 1621 s = &dev->subdevices[1];
73e183c3
HS
1622 if (thisboard->ao_ability == 1) {
1623 s->type = COMEDI_SUBD_AO;
1624 s->subdev_flags = SDF_WRITABLE;
1625 s->n_chan = thisboard->ao_n_chan;
1626 s->maxdata = (1 << thisboard->resolution) - 1;
5d5cabb6 1627 s->range_table = &range_bipolar10;
73e183c3
HS
1628 s->insn_write = das1800_ao_winsn;
1629 } else {
1630 s->type = COMEDI_SUBD_UNUSED;
1631 }
1632
1633 /* di */
2e3d3cf5 1634 s = &dev->subdevices[2];
73e183c3
HS
1635 s->type = COMEDI_SUBD_DI;
1636 s->subdev_flags = SDF_READABLE;
1637 s->n_chan = 4;
1638 s->maxdata = 1;
1639 s->range_table = &range_digital;
1640 s->insn_bits = das1800_di_rbits;
1641
1642 /* do */
2e3d3cf5 1643 s = &dev->subdevices[3];
73e183c3
HS
1644 s->type = COMEDI_SUBD_DO;
1645 s->subdev_flags = SDF_WRITABLE | SDF_READABLE;
1646 s->n_chan = thisboard->do_n_chan;
1647 s->maxdata = 1;
1648 s->range_table = &range_digital;
1649 s->insn_bits = das1800_do_wbits;
1650
1651 das1800_cancel(dev, dev->read_subdev);
1652
1653 /* initialize digital out channels */
1654 outb(devpriv->do_bits, dev->iobase + DAS1800_DIGITAL);
1655
1656 /* initialize analog out channels */
1657 if (thisboard->ao_ability == 1) {
1658 /* select 'update' dac channel for baseAddress + 0x0 */
1659 outb(DAC(thisboard->ao_n_chan - 1),
1660 dev->iobase + DAS1800_SELECT);
1661 outw(devpriv->ao_update_bits, dev->iobase + DAS1800_DAC);
1662 }
1663
1664 return 0;
1665};
1666
1667static void das1800_detach(struct comedi_device *dev)
1668{
9a1a6cf8
HS
1669 struct das1800_private *devpriv = dev->private;
1670
9a1a6cf8 1671 if (devpriv) {
73e183c3
HS
1672 if (devpriv->dma0)
1673 free_dma(devpriv->dma0);
1674 if (devpriv->dma1)
1675 free_dma(devpriv->dma1);
1676 kfree(devpriv->ai_buf0);
1677 kfree(devpriv->ai_buf1);
e608796a
HS
1678 if (devpriv->iobase2)
1679 release_region(devpriv->iobase2, DAS1800_SIZE);
73e183c3 1680 }
e608796a
HS
1681 comedi_legacy_detach(dev);
1682}
90f703d3 1683
1e991a14
HS
1684static struct comedi_driver das1800_driver = {
1685 .driver_name = "das1800",
1686 .module = THIS_MODULE,
1687 .attach = das1800_attach,
1688 .detach = das1800_detach,
1689 .num_names = ARRAY_SIZE(das1800_boards),
1690 .board_name = &das1800_boards[0].name,
1691 .offset = sizeof(struct das1800_board),
1692};
1693module_comedi_driver(das1800_driver);
1694
90f703d3
AT
1695MODULE_AUTHOR("Comedi http://www.comedi.org");
1696MODULE_DESCRIPTION("Comedi low-level driver");
1697MODULE_LICENSE("GPL");