2 comedi/drivers/jr3_pci.c
3 hardware driver for JR3/PCI force sensor board
5 COMEDI - Linux Control and Measurement Device Interface
6 Copyright (C) 2007 Anders Blomdell <anders.blomdell@control.lth.se>
8 This program is free software; you can redistribute it and/or modify
9 it under the terms of the GNU General Public License as published by
10 the Free Software Foundation; either version 2 of the License, or
11 (at your option) any later version.
13 This program is distributed in the hope that it will be useful,
14 but WITHOUT ANY WARRANTY; without even the implied warranty of
15 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
16 GNU General Public License for more details.
20 * Description: JR3/PCI force sensor board
21 * Author: Anders Blomdell <anders.blomdell@control.lth.se>
22 * Updated: Thu, 01 Nov 2012 17:34:55 +0000
24 * Devices: [JR3] PCI force sensor board (jr3_pci)
26 * Configuration options:
29 * Manual configuration of comedi devices is not supported by this
30 * driver; supported PCI devices are configured as comedi devices
33 * The DSP on the board requires initialization code, which can be
34 * loaded by placing it in /lib/firmware/comedi. The initialization
35 * code should be somewhere on the media you got with your card. One
36 * version is available from http://www.comedi.org in the
37 * comedi_nonfree_firmware tarball. The file is called "jr3pci.idm".
40 #include <linux/kernel.h>
41 #include <linux/module.h>
42 #include <linux/pci.h>
43 #include <linux/delay.h>
44 #include <linux/ctype.h>
45 #include <linux/jiffies.h>
46 #include <linux/slab.h>
47 #include <linux/timer.h>
49 #include "../comedidev.h"
53 #define PCI_VENDOR_ID_JR3 0x1762
55 enum jr3_pci_boardid {
62 struct jr3_pci_board {
67 static const struct jr3_pci_board jr3_pci_boards[] = {
86 struct jr3_pci_transform {
93 struct jr3_pci_poll_delay {
98 struct jr3_pci_dev_private {
99 struct jr3_t __iomem *iobase;
100 struct timer_list timer;
103 struct jr3_pci_subdev_private {
104 struct jr3_channel __iomem *channel;
105 unsigned long next_time_min;
106 unsigned long next_time_max;
107 enum { state_jr3_poll,
108 state_jr3_init_wait_for_offset,
109 state_jr3_init_transform_complete,
110 state_jr3_init_set_full_scale_complete,
111 state_jr3_init_use_offset_complete,
118 struct comedi_krange range;
120 const struct comedi_lrange *range_table_list[8 * 7 + 2];
121 unsigned int maxdata_list[8 * 7 + 2];
126 static struct jr3_pci_poll_delay poll_delay_min_max(int min, int max)
128 struct jr3_pci_poll_delay result;
135 static int is_complete(struct jr3_channel __iomem *channel)
137 return get_s16(&channel->command_word0) == 0;
140 static void set_transforms(struct jr3_channel __iomem *channel,
141 struct jr3_pci_transform transf, short num)
145 num &= 0x000f; /* Make sure that 0 <= num <= 15 */
146 for (i = 0; i < 8; i++) {
147 set_u16(&channel->transforms[num].link[i].link_type,
148 transf.link[i].link_type);
150 set_s16(&channel->transforms[num].link[i].link_amount,
151 transf.link[i].link_amount);
153 if (transf.link[i].link_type == end_x_form)
158 static void use_transform(struct jr3_channel __iomem *channel,
161 set_s16(&channel->command_word0, 0x0500 + (transf_num & 0x000f));
164 static void use_offset(struct jr3_channel __iomem *channel, short offset_num)
166 set_s16(&channel->command_word0, 0x0600 + (offset_num & 0x000f));
169 static void set_offset(struct jr3_channel __iomem *channel)
171 set_s16(&channel->command_word0, 0x0700);
183 static void set_full_scales(struct jr3_channel __iomem *channel,
184 struct six_axis_t full_scale)
186 set_s16(&channel->full_scale.fx, full_scale.fx);
187 set_s16(&channel->full_scale.fy, full_scale.fy);
188 set_s16(&channel->full_scale.fz, full_scale.fz);
189 set_s16(&channel->full_scale.mx, full_scale.mx);
190 set_s16(&channel->full_scale.my, full_scale.my);
191 set_s16(&channel->full_scale.mz, full_scale.mz);
192 set_s16(&channel->command_word0, 0x0a00);
195 static struct six_axis_t get_min_full_scales(struct jr3_channel __iomem
198 struct six_axis_t result;
200 result.fx = get_s16(&channel->min_full_scale.fx);
201 result.fy = get_s16(&channel->min_full_scale.fy);
202 result.fz = get_s16(&channel->min_full_scale.fz);
203 result.mx = get_s16(&channel->min_full_scale.mx);
204 result.my = get_s16(&channel->min_full_scale.my);
205 result.mz = get_s16(&channel->min_full_scale.mz);
209 static struct six_axis_t get_max_full_scales(struct jr3_channel __iomem
212 struct six_axis_t result;
214 result.fx = get_s16(&channel->max_full_scale.fx);
215 result.fy = get_s16(&channel->max_full_scale.fy);
216 result.fz = get_s16(&channel->max_full_scale.fz);
217 result.mx = get_s16(&channel->max_full_scale.mx);
218 result.my = get_s16(&channel->max_full_scale.my);
219 result.mz = get_s16(&channel->max_full_scale.mz);
223 static unsigned int jr3_pci_ai_read_chan(struct comedi_device *dev,
224 struct comedi_subdevice *s,
227 struct jr3_pci_subdev_private *spriv = s->private;
228 unsigned int val = 0;
230 if (spriv->state != state_jr3_done)
234 unsigned int axis = chan % 8;
235 unsigned filter = chan / 8;
239 val = get_s16(&spriv->channel->filter[filter].fx);
242 val = get_s16(&spriv->channel->filter[filter].fy);
245 val = get_s16(&spriv->channel->filter[filter].fz);
248 val = get_s16(&spriv->channel->filter[filter].mx);
251 val = get_s16(&spriv->channel->filter[filter].my);
254 val = get_s16(&spriv->channel->filter[filter].mz);
257 val = get_s16(&spriv->channel->filter[filter].v1);
260 val = get_s16(&spriv->channel->filter[filter].v2);
264 } else if (chan == 56) {
265 val = get_u16(&spriv->channel->model_no);
266 } else if (chan == 57) {
267 val = get_u16(&spriv->channel->serial_no);
273 static int jr3_pci_ai_insn_read(struct comedi_device *dev,
274 struct comedi_subdevice *s,
275 struct comedi_insn *insn,
278 struct jr3_pci_subdev_private *spriv = s->private;
279 unsigned int chan = CR_CHAN(insn->chanspec);
286 errors = get_u16(&spriv->channel->errors);
287 if (spriv->state != state_jr3_done ||
288 (errors & (watch_dog | watch_dog2 | sensor_change))) {
289 /* No sensor or sensor changed */
290 if (spriv->state == state_jr3_done) {
291 /* Restart polling */
292 spriv->state = state_jr3_poll;
297 for (i = 0; i < insn->n; i++)
298 data[i] = jr3_pci_ai_read_chan(dev, s, chan);
303 static int jr3_pci_open(struct comedi_device *dev)
305 struct jr3_pci_subdev_private *spriv;
306 struct comedi_subdevice *s;
309 dev_dbg(dev->class_dev, "jr3_pci_open\n");
310 for (i = 0; i < dev->n_subdevices; i++) {
311 s = &dev->subdevices[i];
314 dev_dbg(dev->class_dev, "serial: %p %d (%d)\n",
315 spriv, spriv->serial_no, s->index);
320 static int read_idm_word(const u8 *data, size_t size, int *pos,
327 /* Skip over non hex */
328 for (; *pos < size && !isxdigit(data[*pos]); (*pos)++)
332 for (; *pos < size; (*pos)++) {
333 value = hex_to_bin(data[*pos]);
336 *val = (*val << 4) + value;
345 static int jr3_check_firmware(struct comedi_device *dev,
346 const u8 *data, size_t size)
352 * IDM file format is:
353 * { count, address, data <count> } *
357 unsigned int count = 0;
358 unsigned int addr = 0;
360 more = more && read_idm_word(data, size, &pos, &count);
361 if (more && count == 0xffff)
364 more = more && read_idm_word(data, size, &pos, &addr);
365 while (more && count > 0) {
366 unsigned int dummy = 0;
368 more = more && read_idm_word(data, size, &pos, &dummy);
376 static void jr3_write_firmware(struct comedi_device *dev,
377 int subdev, const u8 *data, size_t size)
379 struct jr3_pci_dev_private *devpriv = dev->private;
380 struct jr3_t __iomem *iobase = devpriv->iobase;
387 unsigned int count = 0;
388 unsigned int addr = 0;
390 more = more && read_idm_word(data, size, &pos, &count);
391 if (more && count == 0xffff)
394 more = more && read_idm_word(data, size, &pos, &addr);
396 dev_dbg(dev->class_dev, "Loading#%d %4.4x bytes at %4.4x\n",
397 subdev, count, addr);
399 while (more && count > 0) {
401 /* 16 bit data, never seen in real life!! */
402 unsigned int data1 = 0;
405 read_idm_word(data, size, &pos, &data1);
407 /* jr3[addr + 0x20000 * pnum] = data1; */
409 /* Download 24 bit program */
410 unsigned int data1 = 0;
411 unsigned int data2 = 0;
413 lo = &iobase->channel[subdev].program_lo[addr];
414 hi = &iobase->channel[subdev].program_hi[addr];
417 read_idm_word(data, size, &pos, &data1);
419 read_idm_word(data, size, &pos, &data2);
433 static int jr3_download_firmware(struct comedi_device *dev,
434 const u8 *data, size_t size,
435 unsigned long context)
440 /* verify IDM file format */
441 ret = jr3_check_firmware(dev, data, size);
445 /* write firmware to each subdevice */
446 for (subdev = 0; subdev < dev->n_subdevices; subdev++)
447 jr3_write_firmware(dev, subdev, data, size);
452 static struct jr3_pci_poll_delay jr3_pci_poll_subdevice(struct comedi_subdevice *s)
454 struct jr3_pci_subdev_private *spriv = s->private;
455 struct jr3_pci_poll_delay result = poll_delay_min_max(1000, 2000);
456 struct jr3_channel __iomem *channel;
465 channel = spriv->channel;
466 errors = get_u16(&channel->errors);
468 if (errors != spriv->errors)
469 spriv->errors = errors;
471 /* Sensor communication lost? force poll mode */
472 if (errors & (watch_dog | watch_dog2 | sensor_change))
473 spriv->state = state_jr3_poll;
475 switch (spriv->state) {
477 model_no = get_u16(&channel->model_no);
478 serial_no = get_u16(&channel->serial_no);
480 if ((errors & (watch_dog | watch_dog2)) ||
481 model_no == 0 || serial_no == 0) {
483 * Still no sensor, keep on polling.
484 * Since it takes up to 10 seconds for offsets to
485 * stabilize, polling each second should suffice.
489 spriv->state = state_jr3_init_wait_for_offset;
492 case state_jr3_init_wait_for_offset:
494 if (spriv->retries < 10) {
496 * Wait for offeset to stabilize
497 * (< 10 s according to manual)
500 struct jr3_pci_transform transf;
502 spriv->model_no = get_u16(&channel->model_no);
503 spriv->serial_no = get_u16(&channel->serial_no);
505 /* Transformation all zeros */
506 for (i = 0; i < ARRAY_SIZE(transf.link); i++) {
507 transf.link[i].link_type = (enum link_types)0;
508 transf.link[i].link_amount = 0;
511 set_transforms(channel, transf, 0);
512 use_transform(channel, 0);
513 spriv->state = state_jr3_init_transform_complete;
514 /* Allow 20 ms for completion */
515 result = poll_delay_min_max(20, 100);
518 case state_jr3_init_transform_complete:
519 if (!is_complete(channel)) {
520 result = poll_delay_min_max(20, 100);
523 struct six_axis_t min_full_scale;
524 struct six_axis_t max_full_scale;
526 min_full_scale = get_min_full_scales(channel);
527 max_full_scale = get_max_full_scales(channel);
528 set_full_scales(channel, max_full_scale);
530 spriv->state = state_jr3_init_set_full_scale_complete;
531 /* Allow 20 ms for completion */
532 result = poll_delay_min_max(20, 100);
535 case state_jr3_init_set_full_scale_complete:
536 if (!is_complete(channel)) {
537 result = poll_delay_min_max(20, 100);
539 struct force_array __iomem *fs = &channel->full_scale;
541 /* Use ranges in kN or we will overflow around 2000N! */
542 spriv->range[0].range.min = -get_s16(&fs->fx) * 1000;
543 spriv->range[0].range.max = get_s16(&fs->fx) * 1000;
544 spriv->range[1].range.min = -get_s16(&fs->fy) * 1000;
545 spriv->range[1].range.max = get_s16(&fs->fy) * 1000;
546 spriv->range[2].range.min = -get_s16(&fs->fz) * 1000;
547 spriv->range[2].range.max = get_s16(&fs->fz) * 1000;
548 spriv->range[3].range.min = -get_s16(&fs->mx) * 100;
549 spriv->range[3].range.max = get_s16(&fs->mx) * 100;
550 spriv->range[4].range.min = -get_s16(&fs->my) * 100;
551 spriv->range[4].range.max = get_s16(&fs->my) * 100;
552 spriv->range[5].range.min = -get_s16(&fs->mz) * 100;
553 /* the next five are questionable */
554 spriv->range[5].range.max = get_s16(&fs->mz) * 100;
555 spriv->range[6].range.min = -get_s16(&fs->v1) * 100;
556 spriv->range[6].range.max = get_s16(&fs->v1) * 100;
557 spriv->range[7].range.min = -get_s16(&fs->v2) * 100;
558 spriv->range[7].range.max = get_s16(&fs->v2) * 100;
559 spriv->range[8].range.min = 0;
560 spriv->range[8].range.max = 65535;
562 use_offset(channel, 0);
563 spriv->state = state_jr3_init_use_offset_complete;
564 /* Allow 40 ms for completion */
565 result = poll_delay_min_max(40, 100);
568 case state_jr3_init_use_offset_complete:
569 if (!is_complete(channel)) {
570 result = poll_delay_min_max(20, 100);
572 set_s16(&channel->offsets.fx, 0);
573 set_s16(&channel->offsets.fy, 0);
574 set_s16(&channel->offsets.fz, 0);
575 set_s16(&channel->offsets.mx, 0);
576 set_s16(&channel->offsets.my, 0);
577 set_s16(&channel->offsets.mz, 0);
581 spriv->state = state_jr3_done;
585 result = poll_delay_min_max(10000, 20000);
594 static void jr3_pci_poll_dev(unsigned long data)
596 struct comedi_device *dev = (struct comedi_device *)data;
597 struct jr3_pci_dev_private *devpriv = dev->private;
598 struct jr3_pci_subdev_private *spriv;
599 struct comedi_subdevice *s;
605 spin_lock_irqsave(&dev->spinlock, flags);
609 /* Poll all channels that are ready to be polled */
610 for (i = 0; i < dev->n_subdevices; i++) {
611 s = &dev->subdevices[i];
614 if (now > spriv->next_time_min) {
615 struct jr3_pci_poll_delay sub_delay;
617 sub_delay = jr3_pci_poll_subdevice(s);
619 spriv->next_time_min = jiffies +
620 msecs_to_jiffies(sub_delay.min);
621 spriv->next_time_max = jiffies +
622 msecs_to_jiffies(sub_delay.max);
624 if (sub_delay.max && sub_delay.max < delay)
626 * Wake up as late as possible ->
627 * poll as many channels as possible at once.
629 delay = sub_delay.max;
632 spin_unlock_irqrestore(&dev->spinlock, flags);
634 devpriv->timer.expires = jiffies + msecs_to_jiffies(delay);
635 add_timer(&devpriv->timer);
638 static struct jr3_pci_subdev_private *
639 jr3_pci_alloc_spriv(struct comedi_device *dev, struct comedi_subdevice *s)
641 struct jr3_pci_dev_private *devpriv = dev->private;
642 struct jr3_pci_subdev_private *spriv;
646 spriv = comedi_alloc_spriv(s, sizeof(*spriv));
650 spriv->channel = &devpriv->iobase->channel[s->index].data;
652 for (j = 0; j < 8; j++) {
653 spriv->range[j].length = 1;
654 spriv->range[j].range.min = -1000000;
655 spriv->range[j].range.max = 1000000;
657 for (k = 0; k < 7; k++) {
658 spriv->range_table_list[j + k * 8] =
659 (struct comedi_lrange *)&spriv->range[j];
660 spriv->maxdata_list[j + k * 8] = 0x7fff;
663 spriv->range[8].length = 1;
664 spriv->range[8].range.min = 0;
665 spriv->range[8].range.max = 65536;
667 spriv->range_table_list[56] = (struct comedi_lrange *)&spriv->range[8];
668 spriv->range_table_list[57] = (struct comedi_lrange *)&spriv->range[8];
669 spriv->maxdata_list[56] = 0xffff;
670 spriv->maxdata_list[57] = 0xffff;
672 dev_dbg(dev->class_dev, "p->channel %p %p (%tx)\n",
673 spriv->channel, devpriv->iobase,
674 ((char __iomem *)spriv->channel -
675 (char __iomem *)devpriv->iobase));
680 static int jr3_pci_auto_attach(struct comedi_device *dev,
681 unsigned long context)
683 struct pci_dev *pcidev = comedi_to_pci_dev(dev);
684 static const struct jr3_pci_board *board = NULL;
685 struct jr3_pci_dev_private *devpriv;
686 struct jr3_pci_subdev_private *spriv;
687 struct comedi_subdevice *s;
691 if (sizeof(struct jr3_channel) != 0xc00) {
692 dev_err(dev->class_dev,
693 "sizeof(struct jr3_channel) = %x [expected %x]\n",
694 (unsigned)sizeof(struct jr3_channel), 0xc00);
698 if (context < ARRAY_SIZE(jr3_pci_boards))
699 board = &jr3_pci_boards[context];
702 dev->board_ptr = board;
703 dev->board_name = board->name;
705 devpriv = comedi_alloc_devpriv(dev, sizeof(*devpriv));
709 init_timer(&devpriv->timer);
711 ret = comedi_pci_enable(dev);
715 devpriv->iobase = pci_ioremap_bar(pcidev, 0);
716 if (!devpriv->iobase)
719 ret = comedi_alloc_subdevices(dev, board->n_subdevs);
723 dev->open = jr3_pci_open;
724 for (i = 0; i < dev->n_subdevices; i++) {
725 s = &dev->subdevices[i];
726 s->type = COMEDI_SUBD_AI;
727 s->subdev_flags = SDF_READABLE | SDF_GROUND;
728 s->n_chan = 8 * 7 + 2;
729 s->insn_read = jr3_pci_ai_insn_read;
731 spriv = jr3_pci_alloc_spriv(dev, s);
733 /* Channel specific range and maxdata */
734 s->range_table_list = spriv->range_table_list;
735 s->maxdata_list = spriv->maxdata_list;
740 writel(0, &devpriv->iobase->channel[0].reset);
742 ret = comedi_load_firmware(dev, &comedi_to_pci_dev(dev)->dev,
744 jr3_download_firmware, 0);
745 dev_dbg(dev->class_dev, "Firmare load %d\n", ret);
749 * TODO: use firmware to load preferred offset tables. Suggested
751 * model serial Fx Fy Fz Mx My Mz\n
753 * comedi_load_firmware(dev, &comedi_to_pci_dev(dev)->dev,
754 * "comedi/jr3_offsets_table",
755 * jr3_download_firmware, 1);
759 * It takes a few milliseconds for software to settle as much as we
760 * can read firmware version
762 msleep_interruptible(25);
763 for (i = 0; i < 0x18; i++) {
764 dev_dbg(dev->class_dev, "%c\n",
765 get_u16(&devpriv->iobase->channel[0].
766 data.copyright[i]) >> 8);
769 /* Start card timer */
770 for (i = 0; i < dev->n_subdevices; i++) {
771 s = &dev->subdevices[i];
774 spriv->next_time_min = jiffies + msecs_to_jiffies(500);
775 spriv->next_time_max = jiffies + msecs_to_jiffies(2000);
778 devpriv->timer.data = (unsigned long)dev;
779 devpriv->timer.function = jr3_pci_poll_dev;
780 devpriv->timer.expires = jiffies + msecs_to_jiffies(1000);
781 add_timer(&devpriv->timer);
786 static void jr3_pci_detach(struct comedi_device *dev)
788 struct jr3_pci_dev_private *devpriv = dev->private;
791 del_timer_sync(&devpriv->timer);
794 iounmap(devpriv->iobase);
796 comedi_pci_disable(dev);
799 static struct comedi_driver jr3_pci_driver = {
800 .driver_name = "jr3_pci",
801 .module = THIS_MODULE,
802 .auto_attach = jr3_pci_auto_attach,
803 .detach = jr3_pci_detach,
806 static int jr3_pci_pci_probe(struct pci_dev *dev,
807 const struct pci_device_id *id)
809 return comedi_pci_auto_config(dev, &jr3_pci_driver, id->driver_data);
812 static const struct pci_device_id jr3_pci_pci_table[] = {
813 { PCI_VDEVICE(JR3, 0x1111), BOARD_JR3_1 },
814 { PCI_VDEVICE(JR3, 0x3111), BOARD_JR3_1 },
815 { PCI_VDEVICE(JR3, 0x3112), BOARD_JR3_2 },
816 { PCI_VDEVICE(JR3, 0x3113), BOARD_JR3_3 },
817 { PCI_VDEVICE(JR3, 0x3114), BOARD_JR3_4 },
820 MODULE_DEVICE_TABLE(pci, jr3_pci_pci_table);
822 static struct pci_driver jr3_pci_pci_driver = {
824 .id_table = jr3_pci_pci_table,
825 .probe = jr3_pci_pci_probe,
826 .remove = comedi_pci_auto_unconfig,
828 module_comedi_pci_driver(jr3_pci_driver, jr3_pci_pci_driver);
830 MODULE_AUTHOR("Comedi http://www.comedi.org");
831 MODULE_DESCRIPTION("Comedi low-level driver");
832 MODULE_LICENSE("GPL");
833 MODULE_FIRMWARE("comedi/jr3pci.idm");