gpib.c revision 1.21 1 /* $NetBSD: gpib.c,v 1.21 2014/03/16 05:20:27 dholland Exp $ */
2
3 /*-
4 * Copyright (c) 2003 The NetBSD Foundation, Inc.
5 * All rights reserved.
6 *
7 * This code is derived from software contributed to The NetBSD Foundation
8 * by Gregory McGarry.
9 *
10 * Redistribution and use in source and binary forms, with or without
11 * modification, are permitted provided that the following conditions
12 * are met:
13 * 1. Redistributions of source code must retain the above copyright
14 * notice, this list of conditions and the following disclaimer.
15 * 2. Redistributions in binary form must reproduce the above copyright
16 * notice, this list of conditions and the following disclaimer in the
17 * documentation and/or other materials provided with the distribution.
18 *
19 * THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS
20 * ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
21 * TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
22 * PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS
23 * BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
24 * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
25 * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
26 * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
27 * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
28 * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
29 * POSSIBILITY OF SUCH DAMAGE.
30 */
31
32 #include <sys/cdefs.h>
33 __KERNEL_RCSID(0, "$NetBSD: gpib.c,v 1.21 2014/03/16 05:20:27 dholland Exp $");
34
35 #include <sys/param.h>
36 #include <sys/systm.h>
37 #include <sys/conf.h>
38 #include <sys/device.h>
39 #include <sys/ioctl.h>
40 #include <sys/malloc.h>
41 #include <sys/proc.h>
42
43 #include <dev/gpib/gpibvar.h>
44
45 #include <dev/gpib/gpibio.h> /* XXX */
46
47 #include "locators.h"
48
49 #ifndef DEBUG
50 #define DEBUG
51 #endif
52
53 #ifdef DEBUG
54 int gpibdebug = 0xff;
55 #define DBG_FOLLOW 0x01
56 #define DBG_INTR 0x02
57 #define DBG_FAIL 0x04
58 #define DPRINTF(mask, str) if (gpibdebug & (mask)) printf str
59 #else
60 #define DPRINTF(mask, str) /* nothing */
61 #endif
62
63 int gpibmatch(device_t, cfdata_t, void *);
64 void gpibattach(device_t, device_t, void *);
65
66 CFATTACH_DECL_NEW(gpib, sizeof(struct gpib_softc),
67 gpibmatch, gpibattach, NULL, NULL);
68
69 static int gpibsubmatch1(device_t, cfdata_t, const int *, void *);
70 static int gpibsubmatch2(device_t, cfdata_t, const int *, void *);
71 static int gpibprint(void *, const char *);
72
73 dev_type_open(gpibopen);
74 dev_type_close(gpibclose);
75 dev_type_read(gpibread);
76 dev_type_write(gpibwrite);
77 dev_type_ioctl(gpibioctl);
78 dev_type_poll(gpibpoll);
79
80 const struct cdevsw gpib_cdevsw = {
81 .d_open = gpibopen,
82 .d_close = gpibclose,
83 .d_read = gpibread,
84 .d_write = gpibwrite,
85 .d_ioctl = gpibioctl,
86 .d_stop = nostop,
87 .d_tty = notty,
88 .d_poll = gpibpoll,
89 .d_mmap = nommap,
90 .d_kqfilter = nokqfilter,
91 .d_flag = D_OTHER
92 };
93
94 extern struct cfdriver gpib_cd;
95
96 #define GPIBUNIT(dev) (minor(dev) & 0x0f)
97
98 int gpibtimeout = 100000; /* # of status tests before we give up */
99
100 int
101 gpibmatch(device_t parent, cfdata_t match, void *aux)
102 {
103
104 return (1);
105 }
106
107 void
108 gpibattach(device_t parent, device_t self, void *aux)
109 {
110 struct gpib_softc *sc = device_private(self);
111 cfdata_t cf = device_cfdata(self);
112 struct gpibdev_attach_args *gda = aux;
113 struct gpib_attach_args ga;
114 int address;
115
116 sc->sc_dev = self;
117 sc->sc_ic = gda->ga_ic;
118
119 /*
120 * If the configuration file specified a host address, then
121 * use it in favour of registers/switches or the default (30).
122 */
123 if (cf->cf_loc[GPIBDEVCF_ADDRESS] != GPIBDEVCF_ADDRESS_DEFAULT)
124 sc->sc_myaddr = cf->cf_loc[GPIBDEVCF_ADDRESS];
125 else if (gda->ga_address != GPIBDEVCF_ADDRESS_DEFAULT)
126 sc->sc_myaddr = gda->ga_address;
127 else
128 sc->sc_myaddr = 30;
129
130 printf(": host address %d\n", sc->sc_myaddr);
131
132 /* record our softc pointer */
133 sc->sc_ic->bus = sc;
134
135 /* Initialize the slave request queue */
136 TAILQ_INIT(&sc->sc_queue);
137
138 /* attach addressed devices */
139 for (address=0; address<GPIB_NDEVS; address++) {
140 ga.ga_ic = sc->sc_ic;
141 ga.ga_address = address;
142 (void) config_search_ia(gpibsubmatch1, sc->sc_dev, "gpib", &ga);
143 }
144
145 /* attach the wild-carded devices - probably protocol busses */
146 ga.ga_ic = sc->sc_ic;
147 (void) config_search_ia(gpibsubmatch2, sc->sc_dev, "gpib", &ga);
148 }
149
150 int
151 gpibsubmatch1(device_t parent, cfdata_t cf, const int *ldesc, void *aux)
152 {
153 struct gpib_softc *sc = device_private(parent);
154 struct gpib_attach_args *ga = aux;
155
156 if (cf->cf_loc[GPIBCF_ADDRESS] != ga->ga_address)
157 return (0);
158
159 if (cf->cf_loc[GPIBCF_ADDRESS] == sc->sc_myaddr)
160 return (0);
161
162 if (config_match(parent, cf, ga) > 0) {
163 if (gpib_alloc(sc, ga->ga_address))
164 return (0);
165 config_attach(parent, cf, ga, gpibprint);
166 return (0);
167 }
168 return (0);
169 }
170
171 int
172 gpibsubmatch2(device_t parent, cfdata_t cf, const int *ldesc, void *aux)
173 {
174 struct gpib_attach_args *ga = aux;
175
176 if (cf->cf_loc[GPIBCF_ADDRESS] != GPIBCF_ADDRESS_DEFAULT)
177 return (0);
178
179 ga->ga_address = GPIBCF_ADDRESS_DEFAULT;
180 if (config_match(parent, cf, ga) > 0) {
181 config_attach(parent, cf, ga, gpibdevprint);
182 return (0);
183 }
184 return (0);
185 }
186
187 int
188 gpibprint(void *aux, const char *pnp)
189 {
190 struct gpib_attach_args *ga = aux;
191
192 if (ga->ga_address != GPIBCF_ADDRESS_DEFAULT)
193 printf(" address %d", ga->ga_address);
194 return (UNCONF);
195 }
196
197 int
198 gpibdevprint(void *aux, const char *pnp)
199 {
200
201 if (pnp != NULL)
202 printf("gpib at %s", pnp);
203 return (UNCONF);
204 }
205
206 /*
207 * Called by hardware driver, pass to device driver.
208 */
209 int
210 gpibintr(void *v)
211 {
212 struct gpib_softc *sc = v;
213 gpib_handle_t hdl;
214
215 DPRINTF(DBG_INTR, ("gpibintr: sc=%p\n", sc));
216
217 hdl = TAILQ_FIRST(&sc->sc_queue);
218 (hdl->hq_callback)(hdl->hq_softc, GPIBCBF_INTR);
219 return (0);
220 }
221
222 /*
223 * Create a callback handle.
224 */
225 int
226 _gpibregister(struct gpib_softc *sc, int slave, gpib_callback_t callback, void *arg, gpib_handle_t *hdl)
227 {
228
229 *hdl = malloc(sizeof(struct gpibqueue), M_DEVBUF, M_NOWAIT);
230 if (*hdl == NULL) {
231 DPRINTF(DBG_FAIL, ("_gpibregister: can't allocate queue\n"));
232 return (1);
233 }
234
235 (*hdl)->hq_slave = slave;
236 (*hdl)->hq_callback = callback;
237 (*hdl)->hq_softc = arg;
238
239 return (0);
240 }
241
242 /*
243 * Request exclusive access to the GPIB bus.
244 */
245 int
246 _gpibrequest(struct gpib_softc *sc, gpib_handle_t hdl)
247 {
248
249 DPRINTF(DBG_FOLLOW, ("_gpibrequest: sc=%p hdl=%p\n", sc, hdl));
250
251 TAILQ_INSERT_TAIL(&sc->sc_queue, hdl, hq_list);
252 if (TAILQ_FIRST(&sc->sc_queue) == hdl)
253 return (1);
254
255 return (0);
256 }
257
258 /*
259 * Release exclusive access to the GPIB bus.
260 */
261 void
262 _gpibrelease(struct gpib_softc *sc, gpib_handle_t hdl)
263 {
264
265 DPRINTF(DBG_FOLLOW, ("_gpibrelease: sc=%p hdl=%p\n", sc, hdl));
266
267 TAILQ_REMOVE(&sc->sc_queue, hdl, hq_list);
268 if ((hdl = TAILQ_FIRST(&sc->sc_queue)) != NULL)
269 (*hdl->hq_callback)(hdl->hq_softc, GPIBCBF_START);
270 }
271
272
273 /*
274 * Asynchronous wait.
275 */
276 void
277 _gpibawait(struct gpib_softc *sc)
278 {
279 int slave;
280
281 DPRINTF(DBG_FOLLOW, ("_gpibawait: sc=%p\n", sc));
282
283 slave = TAILQ_FIRST(&sc->sc_queue)->hq_slave;
284 (*sc->sc_ic->ppwatch)(sc->sc_ic->cookie, slave);
285 }
286
287 /*
288 * Synchronous (spin) wait.
289 */
290 int
291 _gpibswait(struct gpib_softc *sc, int slave)
292 {
293 int timo = gpibtimeout;
294 int (*pptest)(void *, int);
295
296 DPRINTF(DBG_FOLLOW, ("_gpibswait: sc=%p\n", sc));
297
298 pptest = sc->sc_ic->pptest;
299 while ((*pptest)(sc->sc_ic->cookie, slave) == 0) {
300 if (--timo == 0) {
301 aprint_error_dev(sc->sc_dev, "swait timeout\n");
302 return(-1);
303 }
304 }
305 return (0);
306 }
307
308 /*
309 * Resource accounting: check if the address has already been
310 * claimed and allocated.
311 */
312 int
313 gpib_isalloc(struct gpib_softc *sc, u_int8_t address)
314 {
315
316 DPRINTF(DBG_FOLLOW, ("gpib_isalloc: sc=%p address=%d\n", sc, address));
317
318 #ifdef DIAGNOSTIC
319 if (address >= GPIB_NDEVS)
320 panic("gpib_isalloc: device address out of range");
321 #endif
322
323 return ((sc->sc_rmap & (1 << address)) != 0);
324 }
325
326 /*
327 * Resource accounting: allocate the address.
328 */
329 int
330 gpib_alloc(struct gpib_softc *sc, u_int8_t address)
331 {
332
333 DPRINTF(DBG_FOLLOW, ("gpib_alloc: sc=%p address=%d\n", sc, address));
334
335 #ifdef DIAGNOSTIC
336 if (address >= GPIB_NDEVS)
337 panic("gpib_alloc: device address out of range");
338 #endif
339
340 if (!gpib_isalloc(sc, address)) {
341 sc->sc_rmap |= (1 << address);
342 return (0);
343 }
344 return (1);
345 }
346
347 /*
348 * Resource accounting: deallocate the address.
349 */
350 void
351 gpib_dealloc(struct gpib_softc *sc, u_int8_t address)
352 {
353
354 DPRINTF(DBG_FOLLOW, ("gpib_free: sc=%p address=%d\n", sc, address));
355
356 #ifdef DIAGNOSTIC
357 if (address >= GPIB_NDEVS)
358 panic("gpib_free: device address out of range");
359
360 if (!gpib_isalloc(sc, address))
361 panic("gpib_free: not allocated");
362 #endif
363
364 sc->sc_rmap &= ~(1 << address);
365 }
366
367 int
368 _gpibsend(struct gpib_softc *sc, int slave, int sec, void *ptr, int origcnt)
369 {
370 int rv;
371 int cnt = 0;
372 u_int8_t cmds[4];
373 int i = 0;
374
375 DPRINTF(DBG_FOLLOW,
376 ("_gpibsend: sc=%p slave %d sec=%d ptr=%p cnt=%d\n",
377 sc, slave, sec, ptr, origcnt));
378
379 /*
380 * For compatibility, call the hardware driver directly.
381 */
382 if (sc->sc_ic->send != NULL) {
383 rv = (*sc->sc_ic->send)(sc->sc_ic->cookie,
384 slave, sec, ptr, origcnt);
385 return (rv);
386 }
387
388 if ((*sc->sc_ic->tc)(sc->sc_ic->cookie, 0))
389 goto senderror;
390 cmds[i++] = GPIBCMD_UNL;
391 cmds[i++] = GPIBCMD_TAG | sc->sc_myaddr;
392 cmds[i++] = GPIBCMD_LAG | slave;
393 if (sec >= 0 || sec == -2) {
394 if (sec == -2) /* selected device clear KLUDGE */
395 cmds[i++] = GPIBCMD_SDC;
396 else
397 cmds[i++] = GPIBCMD_SCG | sec;
398 }
399 if ((*sc->sc_ic->sendcmds)(sc->sc_ic->cookie, cmds, i) != i)
400 goto senderror;
401 if ((*sc->sc_ic->gts)(sc->sc_ic->cookie))
402 goto senderror;
403 if (origcnt) {
404 cnt = (*sc->sc_ic->senddata)(sc->sc_ic->cookie, ptr, origcnt);
405 if (cnt != origcnt)
406 goto senderror;
407 if ((*sc->sc_ic->tc)(sc->sc_ic->cookie, 0))
408 goto senderror;
409 }
410 return (origcnt);
411
412 senderror:
413 (*sc->sc_ic->ifc)(sc->sc_ic->cookie);
414 DPRINTF(DBG_FAIL,
415 ("%s: _gpibsend failed: slave %d, sec %x, sent %d of %d bytes\n",
416 device_xname(sc->sc_dev), slave, sec, cnt, origcnt));
417 return (cnt);
418 }
419
420 int
421 _gpibrecv(struct gpib_softc *sc, int slave, int sec, void *ptr, int origcnt)
422 {
423 int rv;
424 u_int8_t cmds[4];
425 int cnt = 0;
426 int i = 0;
427
428 DPRINTF(DBG_FOLLOW,
429 ("_gpibrecv: sc=%p slave=%d sec=%d buf=%p cnt=%d\n",
430 sc, slave, sec, ptr, origcnt));
431
432 /*
433 * For compatibility, call the hardware driver directly.
434 */
435 if (sc->sc_ic->recv != NULL) {
436 rv = (*sc->sc_ic->recv)(sc->sc_ic->cookie,
437 slave, sec, ptr, origcnt);
438 return (rv);
439 }
440
441 /*
442 * slave < 0 implies continuation of a previous receive
443 * that probably timed out.
444 */
445 if (slave >= 0) {
446 if ((*sc->sc_ic->tc)(sc->sc_ic->cookie, 0))
447 goto recverror;
448 cmds[i++] = GPIBCMD_UNL;
449 cmds[i++] = GPIBCMD_LAG | sc->sc_myaddr;
450 cmds[i++] = GPIBCMD_TAG | slave;
451 if (sec >= 0)
452 cmds[i++] = GPIBCMD_SCG | sec;
453 if ((*sc->sc_ic->sendcmds)(sc->sc_ic->cookie, cmds, i) != i)
454 goto recverror;
455 if ((*sc->sc_ic->gts)(sc->sc_ic->cookie))
456 goto recverror;
457 }
458 if (origcnt) {
459 cnt = (*sc->sc_ic->recvdata)(sc->sc_ic->cookie, ptr, origcnt);
460 if (cnt != origcnt)
461 goto recverror;
462 if ((sc->sc_ic->tc)(sc->sc_ic->cookie, 0))
463 goto recverror;
464 cmds[0] = (slave == GPIB_BROADCAST_ADDR) ?
465 GPIBCMD_UNA : GPIBCMD_UNT;
466 if ((*sc->sc_ic->sendcmds)(sc->sc_ic->cookie, cmds, 1) != 1)
467 goto recverror;
468 }
469 return (origcnt);
470
471 recverror:
472 (*sc->sc_ic->ifc)(sc->sc_ic->cookie);
473 DPRINTF(DBG_FAIL,
474 ("_gpibrecv: failed, sc=%p slave %d, sec %x, got %d of %d bytes\n",
475 sc, slave, sec, cnt, origcnt));
476 return (cnt);
477 }
478
479 /*
480 * /dev/gpib? interface
481 */
482
483 int
484 gpibopen(dev_t dev, int flags, int mode, struct lwp *l)
485 {
486 struct gpib_softc *sc;
487
488 sc = device_lookup_private(&gpib_cd, GPIBUNIT(dev));
489 if (sc == NULL)
490 return (ENXIO);
491
492 DPRINTF(DBG_FOLLOW, ("gpibopen: sc=%p\n", sc));
493
494 if (sc->sc_flags & GPIBF_ACTIVE)
495 return (EBUSY);
496 sc->sc_flags |= GPIBF_ACTIVE;
497
498 return (0);
499 }
500
501 int
502 gpibclose(dev_t dev, int flag, int mode, struct lwp *l)
503 {
504 struct gpib_softc *sc;
505
506 sc = device_lookup_private(&gpib_cd, GPIBUNIT(dev));
507 if (sc == NULL)
508 return (ENXIO);
509
510 DPRINTF(DBG_FOLLOW, ("gpibclose: sc=%p\n", sc));
511
512 sc->sc_flags &= ~GPIBF_ACTIVE;
513
514 return (0);
515 }
516
517 int
518 gpibread(dev_t dev, struct uio *uio, int flags)
519 {
520 struct gpib_softc *sc;
521
522 sc = device_lookup_private(&gpib_cd, GPIBUNIT(dev));
523 if (sc == NULL)
524 return (ENXIO);
525
526 DPRINTF(DBG_FOLLOW, ("gpibread: sc=%p\n", sc));
527
528 return (EOPNOTSUPP);
529 }
530
531 int
532 gpibwrite(dev_t dev, struct uio *uio, int flags)
533 {
534 struct gpib_softc *sc;
535
536 sc = device_lookup_private(&gpib_cd, GPIBUNIT(dev));
537 if (sc == NULL)
538 return (ENXIO);
539
540 DPRINTF(DBG_FOLLOW, ("gpibwrite: sc=%p\n", sc));
541
542 return (EOPNOTSUPP);
543 }
544
545 int
546 gpibioctl(dev_t dev, u_long cmd, void *data, int flag, struct lwp *l)
547 {
548 struct gpib_softc *sc;
549
550 sc = device_lookup_private(&gpib_cd, GPIBUNIT(dev));
551 if (sc == NULL)
552 return (ENXIO);
553
554 DPRINTF(DBG_FOLLOW, ("gpibioctl(%lu, '%c',%lu): sc=%p\n",
555 IOCPARM_LEN(cmd), (char)IOCGROUP(cmd), cmd & 0xff, sc));
556
557 switch (cmd) {
558 case GPIB_INFO:
559 (*(int *)data) = 0xa5a5a5a5;
560 break;
561 }
562
563 return (EINVAL);
564 }
565
566 int
567 gpibpoll(dev_t dev, int events, struct lwp *l)
568 {
569 struct gpib_softc *sc;
570
571 sc = device_lookup_private(&gpib_cd, GPIBUNIT(dev));
572 if (sc == NULL)
573 return (ENXIO);
574
575 DPRINTF(DBG_FOLLOW, ("gpibpoll: sc=%p\n", sc));
576
577 return (0);
578 }
579