]> git.karo-electronics.de Git - mv-sheeva.git/blobdiff - drivers/staging/easycap/easycap_main.c
Merge tag 'v2.6.38' of git://git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux-2.6
[mv-sheeva.git] / drivers / staging / easycap / easycap_main.c
index 5a4bbd9b453f1cc7a4753483518b7bc82466cfa3..acc1f56e6f29c98f58cbdc42a633c9ceb2b066a6 100644 (file)
 
 #include "easycap.h"
 #include "easycap_standard.h"
+#include "easycap_ioctl.h"
 
-int easycap_debug;
-module_param(easycap_debug, int, S_IRUGO | S_IWUSR);
+static int easycap_debug;
+static int easycap_bars;
+int easycap_gain = 16;
+module_param_named(debug, easycap_debug, int, S_IRUGO | S_IWUSR);
+module_param_named(bars, easycap_bars, int, S_IRUGO | S_IWUSR);
+module_param_named(gain, easycap_gain, int, S_IRUGO | S_IWUSR);
+
+/*---------------------------------------------------------------------------*/
+/*
+ *  dongle_this IS INDISPENSIBLY static BECAUSE FUNCTION easycap_usb_probe()
+ *  IS CALLED SUCCESSIVELY FOR INTERFACES 0, 1, 2 AND THE POINTER peasycap
+ *  ALLOCATED DURING THE PROBING OF INTERFACE 0 MUST BE REMEMBERED WHEN
+ *  PROBING INTERFACES 1 AND 2.
+ *
+ *  IOCTL LOCKING IS DONE AT MODULE LEVEL, NOT DEVICE LEVEL.
+*/
+/*---------------------------------------------------------------------------*/
+
+struct easycap_dongle easycap_dongle[DONGLE_MANY];
+static int dongle_this;
+static int dongle_done;
 
 /*---------------------------------------------------------------------------*/
 /*
@@ -63,22 +83,25 @@ const struct file_operations easycap_fops = {
        .owner          = THIS_MODULE,
        .open           = easycap_open,
        .release        = easycap_release,
-       .unlocked_ioctl = easycap_ioctl,
+#if defined(EASYCAP_NEEDS_UNLOCKED_IOCTL)
+       .unlocked_ioctl = easycap_ioctl_noinode,
+#else
+       .ioctl          = easycap_ioctl,
+#endif /*EASYCAP_NEEDS_UNLOCKED_IOCTL*/
        .poll           = easycap_poll,
        .mmap           = easycap_mmap,
        .llseek         = no_llseek,
 };
 struct vm_operations_struct easycap_vm_ops = {
-.open  = easycap_vma_open,
-.close = easycap_vma_close,
-.fault = easycap_vma_fault,
+       .open  = easycap_vma_open,
+       .close = easycap_vma_close,
+       .fault = easycap_vma_fault,
 };
 struct usb_class_driver easycap_class = {
-.name = "usb/easycap%d",
-.fops = &easycap_fops,
-.minor_base = USB_SKEL_MINOR_BASE,
+       .name = "usb/easycap%d",
+       .fops = &easycap_fops,
+       .minor_base = USB_SKEL_MINOR_BASE,
 };
-
 /*vvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvv*/
 #if defined(EASYCAP_IS_VIDEODEV_CLIENT)
 #if defined(EASYCAP_NEEDS_V4L2_FOPS)
@@ -86,16 +109,17 @@ const struct v4l2_file_operations v4l2_fops = {
        .owner          = THIS_MODULE,
        .open           = easycap_open_noinode,
        .release        = easycap_release_noinode,
-       .unlocked_ioctl = easycap_ioctl,
+#if defined(EASYCAP_NEEDS_UNLOCKED_IOCTL)
+       .unlocked_ioctl = easycap_ioctl_noinode,
+#else
+       .ioctl          = easycap_ioctl,
+#endif /*EASYCAP_NEEDS_UNLOCKED_IOCTL*/
        .poll           = easycap_poll,
        .mmap           = easycap_mmap,
 };
 #endif /*EASYCAP_NEEDS_V4L2_FOPS*/
-int video_device_many /*=0*/;
-struct video_device *pvideo_array[VIDEO_DEVICE_MANY], *pvideo_device;
 #endif /*EASYCAP_IS_VIDEODEV_CLIENT*/
 /*^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^*/
-
 /*--------------------------------------------------------------------------*/
 /*
  *  PARAMETERS USED WHEN REGISTERING THE AUDIO INTERFACE
@@ -105,7 +129,11 @@ const struct file_operations easysnd_fops = {
        .owner          = THIS_MODULE,
        .open           = easysnd_open,
        .release        = easysnd_release,
-       .unlocked_ioctl = easysnd_ioctl,
+#if defined(EASYCAP_NEEDS_UNLOCKED_IOCTL)
+       .unlocked_ioctl = easysnd_ioctl_noinode,
+#else
+       .ioctl          = easysnd_ioctl,
+#endif /*EASYCAP_NEEDS_UNLOCKED_IOCTL*/
        .read           = easysnd_read,
        .llseek         = no_llseek,
 };
@@ -115,17 +143,26 @@ struct usb_class_driver easysnd_class = {
 .minor_base = USB_SKEL_MINOR_BASE,
 };
 /****************************************************************************/
-/*--------------------------------------------------------------------------*/
+/*---------------------------------------------------------------------------*/
 /*
- *  IT IS NOT APPROPRIATE FOR easycap_open() TO SUBMIT THE VIDEO URBS HERE,
- *  BECAUSE THERE WILL ALWAYS BE SUBSEQUENT NEGOTIATION OF TV STANDARD AND
- *  FORMAT BY IOCTL AND IT IS INADVISABLE TO HAVE THE URBS RUNNING WHILE
- *  REGISTERS OF THE SA7113H ARE BEING MANIPULATED.
- *
- *  THE SUBMISSION OF VIDEO URBS IS THEREFORE DELAYED UNTIL THE IOCTL COMMAND
- *  STREAMON IS RECEIVED.
- */
-/*--------------------------------------------------------------------------*/
+ *  THIS ROUTINE DOES NOT DETECT DUPLICATE OCCURRENCES OF POINTER peasycap
+*/
+/*---------------------------------------------------------------------------*/
+int
+isdongle(struct easycap *peasycap)
+{
+int k;
+if (NULL == peasycap)
+       return -2;
+for (k = 0; k < DONGLE_MANY; k++) {
+       if (easycap_dongle[k].peasycap == peasycap) {
+               peasycap->isdongle = k;
+               return k;
+       }
+}
+return -1;
+}
+/*****************************************************************************/
 /*vvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvv*/
 #if defined(EASYCAP_IS_VIDEODEV_CLIENT)
 int
@@ -140,15 +177,17 @@ easycap_open(struct inode *inode, struct file *file)
 {
 #if (!defined(EASYCAP_IS_VIDEODEV_CLIENT))
 struct usb_interface *pusb_interface;
+#else
+struct video_device *pvideo_device;
 #endif /*EASYCAP_IS_VIDEODEV_CLIENT*/
-struct usb_device *p;
 struct easycap *peasycap;
-int i, k, m, rc;
+int rc;
 
 JOT(4, "\n");
 SAY("==========OPEN=========\n");
 
 peasycap = (struct easycap *)NULL;
+/*---------------------------------------------------------------------------*/
 #if (!defined(EASYCAP_IS_VIDEODEV_CLIENT))
 if ((struct inode *)NULL == inode) {
        SAY("ERROR: inode is NULL.\n");
@@ -162,161 +201,427 @@ if (!pusb_interface) {
 peasycap = usb_get_intfdata(pusb_interface);
 /*vvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvv*/
 #else
-for (i = 0;  i < video_device_many;  i++) {
-       pvideo_device = pvideo_array[i];
-       if ((struct video_device *)NULL != pvideo_device) {
-               peasycap = (struct easycap *)video_get_drvdata(pvideo_device);
-               break;
-       }
+pvideo_device = video_devdata(file);
+if ((struct video_device *)NULL == pvideo_device) {
+       SAY("ERROR: pvideo_device is NULL.\n");
+       return -EFAULT;
 }
-/*^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^*/
+peasycap = (struct easycap *)video_get_drvdata(pvideo_device);
 #endif /*EASYCAP_IS_VIDEODEV_CLIENT*/
-if ((struct easycap *)NULL == peasycap) {
-       SAY("MISTAKE: peasycap is NULL\n");
+/*^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^*/
+if (NULL == peasycap) {
+       SAY("ERROR: peasycap is NULL\n");
        return -EFAULT;
 }
-file->private_data = peasycap;
-/*---------------------------------------------------------------------------*/
-/*
- *  INITIALIZATION
- */
-/*---------------------------------------------------------------------------*/
-JOT(4, "starting initialization\n");
-
-for (k = 0;  k < FRAME_BUFFER_MANY;  k++) {
-       for (m = 0;  m < FRAME_BUFFER_SIZE/PAGE_SIZE;  m++)
-               memset(peasycap->frame_buffer[k][m].pgo, 0, PAGE_SIZE);
+if (memcmp(&peasycap->telltale[0], TELLTALE, strlen(TELLTALE))) {
+       SAY("ERROR: bad peasycap: 0x%08lX\n", (unsigned long int) peasycap);
+       return -EFAULT;
 }
-p = peasycap->pusb_device;
-if ((struct usb_device *)NULL == p) {
-       SAY("ERROR: peasycap->pusb_device is NULL\n");
+if (NULL == peasycap->pusb_device) {
+       SAM("ERROR: peasycap->pusb_device is NULL\n");
        return -EFAULT;
 } else {
-       JOT(16, "0x%08lX=peasycap->pusb_device\n", \
+       JOM(16, "0x%08lX=peasycap->pusb_device\n", \
                                        (long int)peasycap->pusb_device);
 }
+file->private_data = peasycap;
 rc = wakeup_device(peasycap->pusb_device);
 if (0 == rc)
-       JOT(8, "wakeup_device() OK\n");
+       JOM(8, "wakeup_device() OK\n");
 else {
-       SAY("ERROR: wakeup_device() returned %i\n", rc);
+       SAM("ERROR: wakeup_device() returned %i\n", rc);
+       if (-ENODEV == rc)
+               SAM("ERROR: wakeup_device() returned -ENODEV\n");
+       else
+               SAM("ERROR: wakeup_device() returned %i\n", rc);
+       return rc;
+}
+peasycap->input = 0;
+rc = reset(peasycap);
+if (0 != rc) {
+       SAM("ERROR: reset() returned %i\n", rc);
        return -EFAULT;
 }
-rc = setup_stk(p);  peasycap->input = 0;
-if (0 == rc)
-       JOT(8, "setup_stk() OK\n");
-else {
-       SAY("ERROR: setup_stk() returned %i\n", rc);
+return 0;
+}
+/*****************************************************************************/
+/*---------------------------------------------------------------------------*/
+/*
+ *  RESET THE HARDWARE TO ITS REFERENCE STATE.
+ *
+ *  THIS ROUTINE MAY BE CALLED REPEATEDLY IF easycap_complete() DETECTS
+ *  A BAD VIDEO FRAME SIZE.
+*/
+/*---------------------------------------------------------------------------*/
+int
+reset(struct easycap *peasycap)
+{
+struct easycap_standard const *peasycap_standard;
+int i, rc, input, rate;
+bool ntsc, other;
+
+if (NULL == peasycap) {
+       SAY("ERROR: peasycap is NULL\n");
        return -EFAULT;
 }
-rc = setup_saa(p);
+input = peasycap->input;
+
+/*---------------------------------------------------------------------------*/
+/*
+ *  IF THE SAA7113H HAS ALREADY ACQUIRED SYNC, USE ITS HARDWARE-DETECTED
+ *  FIELD FREQUENCY TO DISTINGUISH NTSC FROM PAL.  THIS IS ESSENTIAL FOR
+ *  gstreamer AND OTHER USERSPACE PROGRAMS WHICH MAY NOT ATTEMPT TO INITIATE
+ *  A SWITCH BETWEEN PAL AND NTSC.
+ *
+ *  FUNCTION ready_saa() MAY REQUIRE A SUBSTANTIAL FRACTION OF A SECOND TO
+ *  COMPLETE, SO SHOULD NOT BE INVOKED WITHOUT GOOD REASON.
+*/
+/*---------------------------------------------------------------------------*/
+other = false;
+if (true == peasycap->ntsc)
+       JOM(8, "true=peasycap->ntsc\n");
+else
+       JOM(8, "false=peasycap->ntsc\n");
+rate = ready_saa(peasycap->pusb_device);
+if (0 > rate) {
+       JOM(8, "not ready to capture after %i ms ...\n", PATIENCE);
+       if (true == peasycap->ntsc) {
+               JOM(8, "... trying PAL ...\n");  ntsc = false;
+       } else {
+               JOM(8, "... trying NTSC ...\n"); ntsc = true;
+}
+rc = setup_stk(peasycap->pusb_device, ntsc);
 if (0 == rc)
-       JOT(8, "setup_saa() OK\n");
+       JOM(4, "setup_stk() OK\n");
 else {
-       SAY("ERROR: setup_saa() returned %i\n", rc);
+       SAM("ERROR: setup_stk() returned %i\n", rc);
        return -EFAULT;
 }
-rc = check_saa(p);
+rc = setup_saa(peasycap->pusb_device, ntsc);
 if (0 == rc)
-       JOT(8, "check_saa() OK\n");
-else if (-8 < rc)
-       SAY("check_saa() returned %i\n", rc);
+       JOM(4, "setup_saa() OK\n");
 else {
-       SAY("ERROR: check_saa() returned %i\n", rc);
+       SAM("ERROR: setup_saa() returned %i\n", rc);
        return -EFAULT;
 }
-peasycap->standard_offset = -1;
+rate = ready_saa(peasycap->pusb_device);
+if (0 > rate) {
+       JOM(8, "not ready to capture after %i ms ...\n", PATIENCE);
+       JOM(8, "... saa register 0x1F has 0x%02X\n", \
+                               read_saa(peasycap->pusb_device, 0x1F));
+       ntsc = peasycap->ntsc;
+       } else {
+               JOM(8, "... success at second try:  %i=rate\n", rate);
+               ntsc = (0 < (rate/2)) ? true : false ;
+               other = true;
+       }
+} else {
+       JOM(8, "... success at first try:  %i=rate\n", rate);
+       ntsc = (0 < rate/2) ? true : false ;
+}
+if (true == ntsc)
+       JOM(8, "true=ntsc\n");
+else
+       JOM(8, "false=ntsc\n");
 /*---------------------------------------------------------------------------*/
-#if defined(PREFER_NTSC)
 
-rc = adjust_standard(peasycap, V4L2_STD_NTSC_M);
+rc = setup_stk(peasycap->pusb_device, ntsc);
 if (0 == rc)
-       JOT(8, "adjust_standard(.,NTSC_M) OK\n");
+       JOM(4, "setup_stk() OK\n");
 else {
-       SAY("ERROR: adjust_standard(.,NTSC_M) returned %i\n", rc);
+       SAM("ERROR: setup_stk() returned %i\n", rc);
        return -EFAULT;
 }
-rc = adjust_format(peasycap, 640, 480, V4L2_PIX_FMT_UYVY, V4L2_FIELD_NONE, \
-                                                                       false);
-if (0 <= rc)
-       JOT(8, "adjust_format(.,640,480,UYVY) OK\n");
+rc = setup_saa(peasycap->pusb_device, ntsc);
+if (0 == rc)
+       JOM(4, "setup_saa() OK\n");
 else {
-       SAY("ERROR: adjust_format(.,640,480,UYVY) returned %i\n", rc);
+       SAM("ERROR: setup_saa() returned %i\n", rc);
        return -EFAULT;
 }
 
-#else
+for (i = 0; i < 180; i++)
+       peasycap->merit[i] = 0;
+peasycap->video_eof = 0;
+peasycap->audio_eof = 0;
+do_gettimeofday(&peasycap->timeval7);
+/*---------------------------------------------------------------------------*/
+/*
+ * RESTORE INPUT AND FORCE REFRESH OF STANDARD, FORMAT, ETC.
+ *
+ * WHILE THIS PROCEDURE IS IN PROGRESS, SOME IOCTL COMMANDS WILL RETURN -EBUSY.
+*/
+/*---------------------------------------------------------------------------*/
+peasycap->input = -8192;
+peasycap->standard_offset = -8192;
+if (true == other) {
+       peasycap_standard = &easycap_standard[0];
+       while (0xFFFF != peasycap_standard->mask) {
+               if (true == ntsc) {
+                       if (NTSC_M == \
+                               peasycap_standard->v4l2_standard.index) {
+                               peasycap->inputset[input].standard_offset = \
+                                               peasycap_standard - \
+                                                       &easycap_standard[0];
+                               break;
+                       }
+               } else {
+                       if (PAL_BGHIN == \
+                               peasycap_standard->v4l2_standard.index) {
+                               peasycap->inputset[input].standard_offset = \
+                                               peasycap_standard -
+                                                       &easycap_standard[0];
+                               break;
+                       }
+               }
+               peasycap_standard++;
+       }
+       if (0xFFFF == peasycap_standard->mask) {
+               SAM("ERROR: standard not found\n");
+               return -EINVAL;
+       }
+JOM(8, "%i=peasycap->inputset[%i].standard_offset\n", \
+               peasycap->inputset[input].standard_offset, input);
+}
+peasycap->format_offset = -8192;
+peasycap->brightness = -8192;
+peasycap->contrast = -8192;
+peasycap->saturation = -8192;
+peasycap->hue = -8192;
+
+rc = newinput(peasycap, input);
 
-rc = adjust_standard(peasycap, \
-               (V4L2_STD_PAL_B | V4L2_STD_PAL_G | V4L2_STD_PAL_H | \
-               V4L2_STD_PAL_I | V4L2_STD_PAL_N));
 if (0 == rc)
-       JOT(8, "adjust_standard(.,PAL_BGHIN) OK\n");
+       JOM(4, "restored input, standard and format\n");
 else {
-       SAY("ERROR: adjust_standard(.,PAL_BGHIN) returned %i\n", rc);
+       SAM("ERROR: newinput(.,%i) returned %i\n", rc, input);
        return -EFAULT;
 }
-rc = adjust_format(peasycap, 640, 480, V4L2_PIX_FMT_UYVY, V4L2_FIELD_NONE, \
-                                                                       false);
-if (0 <= rc)
-       JOT(8, "adjust_format(.,640,480,uyvy,false) OK\n");
-else {
-       SAY("ERROR: adjust_format(.,640,480,uyvy,false) returned %i\n", rc);
+if (true == peasycap->ntsc)
+       JOM(8, "true=peasycap->ntsc\n");
+else
+       JOM(8, "false=peasycap->ntsc\n");
+
+if (0 > peasycap->input) {
+       SAM("MISTAKE:  %i=peasycap->input\n", peasycap->input);
+       return -ENOENT;
+}
+if (0 > peasycap->standard_offset) {
+       SAM("MISTAKE:  %i=peasycap->standard_offset\n", \
+                                               peasycap->standard_offset);
+       return -ENOENT;
+}
+if (0 > peasycap->format_offset) {
+       SAM("MISTAKE:  %i=peasycap->format_offset\n", \
+                                               peasycap->format_offset);
+       return -ENOENT;
+}
+if (0 > peasycap->brightness) {
+       SAM("MISTAKE:  %i=peasycap->brightness\n", peasycap->brightness);
+       return -ENOENT;
+}
+if (0 > peasycap->contrast) {
+       SAM("MISTAKE:  %i=peasycap->contrast\n", peasycap->contrast);
+       return -ENOENT;
+}
+if (0 > peasycap->saturation) {
+       SAM("MISTAKE:  %i=peasycap->saturation\n", peasycap->saturation);
+       return -ENOENT;
+}
+if (0 > peasycap->hue) {
+       SAM("MISTAKE:  %i=peasycap->hue\n", peasycap->hue);
+       return -ENOENT;
+}
+return 0;
+}
+/*****************************************************************************/
+/*---------------------------------------------------------------------------*/
+/*
+ *  IF THE REQUESTED INPUT IS THE SAME AS THE EXISTING INPUT, DO NOTHING.
+ *  OTHERWISE:
+ *      KILL URBS, CLEAR FIELD AND FRAME BUFFERS AND RESET THEIR
+ *           _read AND _fill POINTERS.
+ *      SELECT THE NEW INPUT.
+ *      ADJUST THE STANDARD, FORMAT, BRIGHTNESS, CONTRAST, SATURATION AND HUE
+ *          ON THE BASIS OF INFORMATION IN STRUCTURE easycap.inputset[input].
+ *      RESUBMIT THE URBS IF STREAMING WAS ALREADY IN PROGRESS.
+ *
+ *  NOTE:
+ *      THIS ROUTINE MAY BE CALLED FREQUENTLY BY ZONEMINDER VIA IOCTL,
+ *      SO IT SHOULD WRITE ONLY SPARINGLY TO THE LOGFILE.
+*/
+/*---------------------------------------------------------------------------*/
+int
+newinput(struct easycap *peasycap, int input)
+{
+int rc, k, m, mood, off;
+int inputnow, video_idlenow, audio_idlenow;
+bool resubmit;
+
+if (NULL == peasycap) {
+       SAY("ERROR: peasycap is NULL\n");
        return -EFAULT;
 }
+JOM(8, "%i=input sought\n", input);
 
-#endif /* !PREFER_NTSC*/
+if (0 > input && INPUT_MANY <= input)
+       return -ENOENT;
+inputnow = peasycap->input;
+if (input == inputnow)
+       return 0;
+/*---------------------------------------------------------------------------*/
+/*
+ *  IF STREAMING IS IN PROGRESS THE URBS ARE KILLED AT THIS
+ *  STAGE AND WILL BE RESUBMITTED PRIOR TO EXIT FROM THE ROUTINE.
+ *  IF NO STREAMING IS IN PROGRESS NO URBS WILL BE SUBMITTED BY THE
+ *  ROUTINE.
+*/
 /*---------------------------------------------------------------------------*/
-rc = adjust_brightness(peasycap, -8192);
+video_idlenow = peasycap->video_idle;
+audio_idlenow = peasycap->audio_idle;
+
+peasycap->video_idle = 1;
+peasycap->audio_idle = 1;
+if (peasycap->video_isoc_streaming) {
+       resubmit = true;
+       kill_video_urbs(peasycap);
+} else
+       resubmit = false;
+/*---------------------------------------------------------------------------*/
+if (NULL == peasycap->pusb_device) {
+       SAM("ERROR: peasycap->pusb_device is NULL\n");
+       return -ENODEV;
+}
+rc = usb_set_interface(peasycap->pusb_device,
+                       peasycap->video_interface, \
+                       peasycap->video_altsetting_off);
 if (0 != rc) {
-       SAY("ERROR: adjust_brightness(default) returned %i\n", rc);
+       SAM("ERROR: usb_set_interface() returned %i\n", rc);
        return -EFAULT;
 }
-rc = adjust_contrast(peasycap, -8192);
+rc = stop_100(peasycap->pusb_device);
 if (0 != rc) {
-       SAY("ERROR: adjust_contrast(default) returned %i\n", rc);
+       SAM("ERROR: stop_100() returned %i\n", rc);
        return -EFAULT;
 }
-rc = adjust_saturation(peasycap, -8192);
-if (0 != rc) {
-       SAY("ERROR: adjust_saturation(default) returned %i\n", rc);
-       return -EFAULT;
+for (k = 0; k < FIELD_BUFFER_MANY; k++) {
+       for (m = 0; m < FIELD_BUFFER_SIZE/PAGE_SIZE; m++)
+               memset(peasycap->field_buffer[k][m].pgo, 0, PAGE_SIZE);
 }
-rc = adjust_hue(peasycap, -8192);
-if (0 != rc) {
-       SAY("ERROR: adjust_hue(default) returned %i\n", rc);
-       return -EFAULT;
+for (k = 0; k < FRAME_BUFFER_MANY; k++) {
+       for (m = 0; m < FRAME_BUFFER_SIZE/PAGE_SIZE; m++)
+               memset(peasycap->frame_buffer[k][m].pgo, 0, PAGE_SIZE);
+}
+peasycap->field_page = 0;
+peasycap->field_read = 0;
+peasycap->field_fill = 0;
+
+peasycap->frame_read = 0;
+peasycap->frame_fill = 0;
+for (k = 0; k < peasycap->input; k++) {
+       (peasycap->frame_fill)++;
+       if (peasycap->frame_buffer_many <= peasycap->frame_fill)
+               peasycap->frame_fill = 0;
 }
+peasycap->input = input;
+select_input(peasycap->pusb_device, peasycap->input, 9);
 /*---------------------------------------------------------------------------*/
-rc = usb_set_interface(peasycap->pusb_device, peasycap->video_interface, \
-                                               peasycap->video_altsetting_on);
-if (0 == rc)
-       JOT(8, "usb_set_interface(.,%i,%i) OK\n", peasycap->video_interface, \
-                                               peasycap->video_altsetting_on);
-else {
-       SAY("ERROR: usb_set_interface() returned %i\n", rc);
+if (input == peasycap->inputset[input].input) {
+       off = peasycap->inputset[input].standard_offset;
+       if (off != peasycap->standard_offset) {
+               rc = adjust_standard(peasycap, \
+                               easycap_standard[off].v4l2_standard.id);
+               if (0 != rc) {
+                       SAM("ERROR: adjust_standard() returned %i\n", rc);
+                       return -EFAULT;
+               }
+               JOM(8, "%i=peasycap->standard_offset\n", \
+                                               peasycap->standard_offset);
+       } else {
+               JOM(8, "%i=peasycap->standard_offset unchanged\n", \
+                                               peasycap->standard_offset);
+       }
+       off = peasycap->inputset[input].format_offset;
+       if (off != peasycap->format_offset) {
+               rc = adjust_format(peasycap, \
+                       easycap_format[off].v4l2_format.fmt.pix.width, \
+                       easycap_format[off].v4l2_format.fmt.pix.height, \
+                       easycap_format[off].v4l2_format.fmt.pix.pixelformat, \
+                       easycap_format[off].v4l2_format.fmt.pix.field, false);
+               if (0 > rc) {
+                       SAM("ERROR: adjust_format() returned %i\n", rc);
+                       return -EFAULT;
+               }
+               JOM(8, "%i=peasycap->format_offset\n", peasycap->format_offset);
+       } else {
+               JOM(8, "%i=peasycap->format_offset unchanged\n", \
+                                               peasycap->format_offset);
+       }
+       mood = peasycap->inputset[input].brightness;
+       if (mood != peasycap->brightness) {
+               rc = adjust_brightness(peasycap, mood);
+               if (0 != rc) {
+                       SAM("ERROR: adjust_brightness returned %i\n", rc);
+                       return -EFAULT;
+               }
+               JOM(8, "%i=peasycap->brightness\n", peasycap->brightness);
+       }
+       mood = peasycap->inputset[input].contrast;
+       if (mood != peasycap->contrast) {
+               rc = adjust_contrast(peasycap, mood);
+               if (0 != rc) {
+                       SAM("ERROR: adjust_contrast returned %i\n", rc);
+                       return -EFAULT;
+               }
+               JOM(8, "%i=peasycap->contrast\n", peasycap->contrast);
+       }
+       mood = peasycap->inputset[input].saturation;
+       if (mood != peasycap->saturation) {
+               rc = adjust_saturation(peasycap, mood);
+               if (0 != rc) {
+                       SAM("ERROR: adjust_saturation returned %i\n", rc);
+                       return -EFAULT;
+               }
+               JOM(8, "%i=peasycap->saturation\n", peasycap->saturation);
+       }
+       mood = peasycap->inputset[input].hue;
+       if (mood != peasycap->hue) {
+               rc = adjust_hue(peasycap, mood);
+               if (0 != rc) {
+                       SAM("ERROR: adjust_hue returned %i\n", rc);
+                       return -EFAULT;
+               }
+               JOM(8, "%i=peasycap->hue\n", peasycap->hue);
+       }
+} else {
+       SAM("MISTAKE: easycap.inputset[%i] unpopulated\n", input);
+       return -ENOENT;
+}
+/*---------------------------------------------------------------------------*/
+if (NULL == peasycap->pusb_device) {
+       SAM("ERROR: peasycap->pusb_device is NULL\n");
+       return -ENODEV;
+}
+rc = usb_set_interface(peasycap->pusb_device,
+                       peasycap->video_interface, \
+                       peasycap->video_altsetting_on);
+if (0 != rc) {
+       SAM("ERROR: usb_set_interface() returned %i\n", rc);
        return -EFAULT;
 }
-rc = start_100(p);
-if (0 == rc)
-       JOT(8, "start_100() OK\n");
-else {
-       SAY("ERROR: start_100() returned %i\n", rc);
+rc = start_100(peasycap->pusb_device);
+if (0 != rc) {
+       SAM("ERROR: start_100() returned %i\n", rc);
        return -EFAULT;
 }
+if (true == resubmit)
+       submit_video_urbs(peasycap);
+
 peasycap->video_isoc_sequence = VIDEO_ISOC_BUFFER_MANY - 1;
-peasycap->video_idle = 0;
+peasycap->video_idle = video_idlenow;
+peasycap->audio_idle = audio_idlenow;
 peasycap->video_junk = 0;
-for (i = 0; i < 180; i++)
-       peasycap->merit[i] = 0;
-peasycap->video_eof = 0;
-peasycap->audio_eof = 0;
 
-do_gettimeofday(&peasycap->timeval7);
-
-peasycap->fudge = 0;
-
-JOT(4, "finished initialization\n");
 return 0;
 }
 /*****************************************************************************/
@@ -326,33 +631,25 @@ submit_video_urbs(struct easycap *peasycap)
 struct data_urb *pdata_urb;
 struct urb *purb;
 struct list_head *plist_head;
-int j, isbad, m, rc;
+int j, isbad, nospc, m, rc;
 int isbuf;
 
-if ((struct list_head *)NULL == peasycap->purb_video_head) {
+if (NULL == peasycap) {
+       SAY("ERROR: peasycap is NULL\n");
+       return -EFAULT;
+}
+
+if (NULL == peasycap->purb_video_head) {
        SAY("ERROR: peasycap->urb_video_head uninitialized\n");
        return -EFAULT;
 }
-if ((struct usb_device *)NULL == peasycap->pusb_device) {
+if (NULL == peasycap->pusb_device) {
        SAY("ERROR: peasycap->pusb_device is NULL\n");
-       return -EFAULT;
+       return -ENODEV;
 }
 if (!peasycap->video_isoc_streaming) {
-
-
-
-
-
-
-
-
-       JOT(4, "submission of all video urbs\n");
-       if (0 != ready_saa(peasycap->pusb_device)) {
-               SAY("ERROR: not ready to capture after waiting " \
-                                                       "one second\n");
-               SAY(".....  continuing anyway\n");
-       }
-       isbad = 0;  m = 0;
+       JOM(4, "submission of all video urbs\n");
+       isbad = 0;  nospc = 0;  m = 0;
        list_for_each(plist_head, (peasycap->purb_video_head)) {
                pdata_urb = list_entry(plist_head, struct data_urb, list_head);
                if (NULL != pdata_urb) {
@@ -389,44 +686,57 @@ if (!peasycap->video_isoc_streaming) {
                                rc = usb_submit_urb(purb, GFP_KERNEL);
                                if (0 != rc) {
                                        isbad++;
-                                       SAY("ERROR: usb_submit_urb() failed " \
+                                       SAM("ERROR: usb_submit_urb() failed " \
                                                        "for urb with rc:\n");
                                        switch (rc) {
                                        case -ENOMEM: {
-                                               SAY("ENOMEM\n");
+                                               SAM("ERROR: -ENOMEM=" \
+                                                       "usb_submit_urb()\n");
                                                break;
                                        }
                                        case -ENODEV: {
-                                               SAY("ENODEV\n");
+                                               SAM("ERROR: -ENODEV=" \
+                                                       "usb_submit_urb()\n");
                                                break;
                                        }
                                        case -ENXIO: {
-                                               SAY("ENXIO\n");
+                                               SAM("ERROR: -ENXIO=" \
+                                                       "usb_submit_urb()\n");
                                                break;
                                        }
                                        case -EINVAL: {
-                                               SAY("EINVAL\n");
+                                               SAM("ERROR: -EINVAL=" \
+                                                       "usb_submit_urb()\n");
                                                break;
                                        }
                                        case -EAGAIN: {
-                                               SAY("EAGAIN\n");
+                                               SAM("ERROR: -EAGAIN=" \
+                                                       "usb_submit_urb()\n");
                                                break;
                                        }
                                        case -EFBIG: {
-                                               SAY("EFBIG\n");
+                                               SAM("ERROR: -EFBIG=" \
+                                                       "usb_submit_urb()\n");
                                                break;
                                        }
                                        case -EPIPE: {
-                                               SAY("EPIPE\n");
+                                               SAM("ERROR: -EPIPE=" \
+                                                       "usb_submit_urb()\n");
                                                break;
                                        }
                                        case -EMSGSIZE: {
-                                               SAY("EMSGSIZE\n");
+                                               SAM("ERROR: -EMSGSIZE=" \
+                                                       "usb_submit_urb()\n");
+                                               break;
+                                       }
+                                       case -ENOSPC: {
+                                               nospc++;
                                                break;
                                        }
                                        default: {
-                                               SAY("unknown error code %i\n",\
-                                                                        rc);
+                                               SAM("ERROR: %i=" \
+                                                       "usb_submit_urb()\n",\
+                                                       rc);
                                                break;
                                        }
                                        }
@@ -434,14 +744,20 @@ if (!peasycap->video_isoc_streaming) {
                                        m++;
                                }
                                } else {
-                                       isbad++;
+                                        isbad++;
                                }
                        } else {
                                 isbad++;
                        }
                }
+       if (nospc) {
+               SAM("-ENOSPC=usb_submit_urb() for %i urbs\n", nospc);
+               SAM(".....  possibly inadequate USB bandwidth\n");
+               peasycap->video_eof = 1;
+       }
+
        if (isbad) {
-               JOT(4, "attempting cleanup instead of submitting\n");
+               JOM(4, "attempting cleanup instead of submitting\n");
                list_for_each(plist_head, (peasycap->purb_video_head)) {
                        pdata_urb = list_entry(plist_head, struct data_urb, \
                                                                list_head);
@@ -454,16 +770,10 @@ if (!peasycap->video_isoc_streaming) {
                peasycap->video_isoc_streaming = 0;
        } else {
                peasycap->video_isoc_streaming = 1;
-               JOT(4, "submitted %i video urbs\n", m);
+               JOM(4, "submitted %i video urbs\n", m);
        }
-
-
-
-
-
-
 } else {
-       JOT(4, "already streaming video urbs\n");
+       JOM(4, "already streaming video urbs\n");
 }
 return 0;
 }
@@ -475,35 +785,32 @@ int m;
 struct list_head *plist_head;
 struct data_urb *pdata_urb;
 
-if ((struct easycap *)NULL == peasycap) {
+if (NULL == peasycap) {
        SAY("ERROR: peasycap is NULL\n");
        return -EFAULT;
 }
 if (peasycap->video_isoc_streaming) {
-
-
-
        if ((struct list_head *)NULL != peasycap->purb_video_head) {
                peasycap->video_isoc_streaming = 0;
-               JOT(4, "killing video urbs\n");
+               JOM(4, "killing video urbs\n");
                m = 0;
                list_for_each(plist_head, (peasycap->purb_video_head)) {
                        pdata_urb = list_entry(plist_head, struct data_urb, \
                                                                list_head);
-                       if ((struct data_urb *)NULL != pdata_urb) {
-                               if ((struct urb *)NULL != pdata_urb->purb) {
+                       if (NULL != pdata_urb) {
+                               if (NULL != pdata_urb->purb) {
                                        usb_kill_urb(pdata_urb->purb);
                                        m++;
                                }
                        }
                }
-               JOT(4, "%i video urbs killed\n", m);
+               JOM(4, "%i video urbs killed\n", m);
        } else {
-               SAY("ERROR: peasycap->purb_video_head is NULL\n");
+               SAM("ERROR: peasycap->purb_video_head is NULL\n");
                return -EFAULT;
        }
 } else {
-       JOT(8, "%i=video_isoc_streaming, no video urbs killed\n", \
+       JOM(8, "%i=video_isoc_streaming, no video urbs killed\n", \
                                        peasycap->video_isoc_streaming);
 }
 return 0;
@@ -533,11 +840,15 @@ if (NULL == peasycap) {
        SAY("ending unsuccessfully\n");
        return -EFAULT;
 }
+if (memcmp(&peasycap->telltale[0], TELLTALE, strlen(TELLTALE))) {
+       SAY("ERROR: bad peasycap: 0x%08lX\n", (unsigned long int) peasycap);
+       return -EFAULT;
+}
 if (0 != kill_video_urbs(peasycap)) {
-       SAY("ERROR: kill_video_urbs() failed\n");
+       SAM("ERROR: kill_video_urbs() failed\n");
        return -EFAULT;
 }
-JOT(4, "ending successfully\n");
+JOM(4, "ending successfully\n");
 /*vvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvv*/
 #else
 #
@@ -550,63 +861,45 @@ return 0;
 /*vvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvv*/
 #if defined(EASYCAP_IS_VIDEODEV_CLIENT)
 int
-videodev_release(struct video_device *pvd)
+videodev_release(struct video_device *pvideo_device)
 {
 struct easycap *peasycap;
-int i, j, k;
 
 JOT(4, "\n");
 
-k = 0;
-for (i = 0;  i < video_device_many;  i++) {
-       pvideo_device = pvideo_array[i];
-       if ((struct video_device *)NULL != pvideo_device) {
-               if (pvd->minor == pvideo_device->minor) {
-                       peasycap = (struct easycap *)\
-                                       video_get_drvdata(pvideo_device);
-                       if ((struct easycap *)NULL == peasycap) {
-                               SAY("ERROR:  peasycap is NULL\n");
-                               SAY("ending unsuccessfully\n");
-                               return -EFAULT;
-                       }
-                       if (0 != kill_video_urbs(peasycap)) {
-                               SAY("ERROR: kill_video_urbs() failed\n");
-                               return -EFAULT;
-                       }
-                       JOT(4, "freeing video_device structure: " \
-                                                       "/dev/video%i\n", i);
-                       kfree((void *)pvideo_device);
-                       for (j = i;  j < (VIDEO_DEVICE_MANY - 1);  j++)
-                               pvideo_array[j] = pvideo_array[j + 1];
-                       video_device_many--;  k++;
-                       break;
-               }
-       }
-}
-if (!k) {
-       SAY("ERROR: lost video_device structure for %i=minor\n", pvd->minor);
-       SAY("cannot free: may cause memory leak\n");
+peasycap = video_get_drvdata(pvideo_device);
+if (NULL == peasycap) {
+       SAY("ERROR:  peasycap is NULL\n");
        SAY("ending unsuccessfully\n");
        return -EFAULT;
 }
-
-JOT(4, "ending successfully\n");
+if (memcmp(&peasycap->telltale[0], TELLTALE, strlen(TELLTALE))) {
+       SAY("ERROR: bad peasycap: 0x%08lX\n", (unsigned long int) peasycap);
+       return -EFAULT;
+}
+if (0 != kill_video_urbs(peasycap)) {
+       SAM("ERROR: kill_video_urbs() failed\n");
+       return -EFAULT;
+}
+JOM(4, "ending successfully\n");
 return 0;
 }
 #endif /*EASYCAP_IS_VIDEODEV_CLIENT*/
-/*^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^*/
-/****************************************************************************/
+/*^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^*/
+/*****************************************************************************/
 /*--------------------------------------------------------------------------*/
 /*
- *  THIS FUNCTION IS CALLED FROM WITHIN easycap_usb_disconnect().
- *  BY THIS STAGE THE DEVICE HAS ALREADY BEEN PHYSICALLY UNPLUGGED.
- *  peasycap->pusb_device IS NO LONGER VALID AND SHOULD HAVE BEEN SET TO NULL.
+ *  THIS FUNCTION IS CALLED FROM WITHIN easycap_usb_disconnect() AND IS
+ *  PROTECTED BY SEMAPHORES SET AND CLEARED BY easycap_usb_disconnect().
+ *
+ *  BY THIS STAGE THE DEVICE HAS ALREADY BEEN PHYSICALLY UNPLUGGED, SO
+ *  peasycap->pusb_device IS NO LONGER VALID.
  */
 /*---------------------------------------------------------------------------*/
 void
 easycap_delete(struct kref *pkref)
 {
-int k, m, lost;
+int k, m, gone, kd;
 int allocation_video_urb, allocation_video_page, allocation_video_struct;
 int allocation_audio_urb, allocation_audio_page, allocation_audio_struct;
 int registered_video, registered_audio;
@@ -617,22 +910,27 @@ struct list_head *plist_head, *plist_next;
 JOT(4, "\n");
 
 peasycap = container_of(pkref, struct easycap, kref);
-if ((struct easycap *)NULL == peasycap) {
-       SAY("ERROR: peasycap is NULL: cannot perform deletions\n");
+if (NULL == peasycap) {
+       SAM("ERROR: peasycap is NULL: cannot perform deletions\n");
+       return;
+}
+if (memcmp(&peasycap->telltale[0], TELLTALE, strlen(TELLTALE))) {
+       SAY("ERROR: bad peasycap: 0x%08lX\n", (unsigned long int) peasycap);
        return;
 }
+kd = isdongle(peasycap);
 /*---------------------------------------------------------------------------*/
 /*
  *  FREE VIDEO.
  */
 /*---------------------------------------------------------------------------*/
 if ((struct list_head *)NULL != peasycap->purb_video_head) {
-       JOT(4, "freeing video urbs\n");
+       JOM(4, "freeing video urbs\n");
        m = 0;
        list_for_each(plist_head, (peasycap->purb_video_head)) {
                pdata_urb = list_entry(plist_head, struct data_urb, list_head);
                if (NULL == pdata_urb)
-                       JOT(4, "ERROR: pdata_urb is NULL\n");
+                       JOM(4, "ERROR: pdata_urb is NULL\n");
                else {
                        if ((struct urb *)NULL != pdata_urb->purb) {
                                usb_free_urb(pdata_urb->purb);
@@ -643,9 +941,9 @@ if ((struct list_head *)NULL != peasycap->purb_video_head) {
                }
        }
 
-       JOT(4, "%i video urbs freed\n", m);
+       JOM(4, "%i video urbs freed\n", m);
 /*---------------------------------------------------------------------------*/
-       JOT(4, "freeing video data_urb structures.\n");
+       JOM(4, "freeing video data_urb structures.\n");
        m = 0;
        list_for_each_safe(plist_head, plist_next, peasycap->purb_video_head) {
                pdata_urb = list_entry(plist_head, struct data_urb, list_head);
@@ -656,14 +954,12 @@ if ((struct list_head *)NULL != peasycap->purb_video_head) {
                        m++;
                }
        }
-       JOT(4, "%i video data_urb structures freed\n", m);
-       JOT(4, "setting peasycap->purb_video_head=NULL\n");
+       JOM(4, "%i video data_urb structures freed\n", m);
+       JOM(4, "setting peasycap->purb_video_head=NULL\n");
        peasycap->purb_video_head = (struct list_head *)NULL;
-       } else {
-JOT(4, "peasycap->purb_video_head is NULL\n");
 }
 /*---------------------------------------------------------------------------*/
-JOT(4, "freeing video isoc buffers.\n");
+JOM(4, "freeing video isoc buffers.\n");
 m = 0;
 for (k = 0;  k < VIDEO_ISOC_BUFFER_MANY;  k++) {
        if ((void *)NULL != peasycap->video_isoc_buffer[k].pgo) {
@@ -676,10 +972,10 @@ for (k = 0;  k < VIDEO_ISOC_BUFFER_MANY;  k++) {
                m++;
        }
 }
-JOT(4, "isoc video buffers freed: %i pages\n", m * (0x01 << VIDEO_ISOC_ORDER));
+JOM(4, "isoc video buffers freed: %i pages\n", m * (0x01 << VIDEO_ISOC_ORDER));
 /*---------------------------------------------------------------------------*/
-JOT(4, "freeing video field buffers.\n");
-lost = 0;
+JOM(4, "freeing video field buffers.\n");
+gone = 0;
 for (k = 0;  k < FIELD_BUFFER_MANY;  k++) {
        for (m = 0;  m < FIELD_BUFFER_SIZE/PAGE_SIZE;  m++) {
                if ((void *)NULL != peasycap->field_buffer[k][m].pgo) {
@@ -687,14 +983,14 @@ for (k = 0;  k < FIELD_BUFFER_MANY;  k++) {
                                        (peasycap->field_buffer[k][m].pgo));
                        peasycap->field_buffer[k][m].pgo = (void *)NULL;
                        peasycap->allocation_video_page -= 1;
-                       lost++;
+                       gone++;
                }
        }
 }
-JOT(4, "video field buffers freed: %i pages\n", lost);
+JOM(4, "video field buffers freed: %i pages\n", gone);
 /*---------------------------------------------------------------------------*/
-JOT(4, "freeing video frame buffers.\n");
-lost = 0;
+JOM(4, "freeing video frame buffers.\n");
+gone = 0;
 for (k = 0;  k < FRAME_BUFFER_MANY;  k++) {
        for (m = 0;  m < FRAME_BUFFER_SIZE/PAGE_SIZE;  m++) {
                if ((void *)NULL != peasycap->frame_buffer[k][m].pgo) {
@@ -702,23 +998,23 @@ for (k = 0;  k < FRAME_BUFFER_MANY;  k++) {
                                        (peasycap->frame_buffer[k][m].pgo));
                        peasycap->frame_buffer[k][m].pgo = (void *)NULL;
                        peasycap->allocation_video_page -= 1;
-                       lost++;
+                       gone++;
                }
        }
 }
-JOT(4, "video frame buffers freed: %i pages\n", lost);
+JOM(4, "video frame buffers freed: %i pages\n", gone);
 /*---------------------------------------------------------------------------*/
 /*
  *  FREE AUDIO.
  */
 /*---------------------------------------------------------------------------*/
 if ((struct list_head *)NULL != peasycap->purb_audio_head) {
-       JOT(4, "freeing audio urbs\n");
+       JOM(4, "freeing audio urbs\n");
        m = 0;
        list_for_each(plist_head, (peasycap->purb_audio_head)) {
                pdata_urb = list_entry(plist_head, struct data_urb, list_head);
                if (NULL == pdata_urb)
-                       JOT(4, "ERROR: pdata_urb is NULL\n");
+                       JOM(4, "ERROR: pdata_urb is NULL\n");
                else {
                        if ((struct urb *)NULL != pdata_urb->purb) {
                                usb_free_urb(pdata_urb->purb);
@@ -728,9 +1024,9 @@ if ((struct list_head *)NULL != peasycap->purb_audio_head) {
                        }
                }
        }
-       JOT(4, "%i audio urbs freed\n", m);
+       JOM(4, "%i audio urbs freed\n", m);
 /*---------------------------------------------------------------------------*/
-       JOT(4, "freeing audio data_urb structures.\n");
+       JOM(4, "freeing audio data_urb structures.\n");
        m = 0;
        list_for_each_safe(plist_head, plist_next, peasycap->purb_audio_head) {
                pdata_urb = list_entry(plist_head, struct data_urb, list_head);
@@ -741,14 +1037,12 @@ if ((struct list_head *)NULL != peasycap->purb_audio_head) {
                        m++;
                }
        }
-JOT(4, "%i audio data_urb structures freed\n", m);
-JOT(4, "setting peasycap->purb_audio_head=NULL\n");
+JOM(4, "%i audio data_urb structures freed\n", m);
+JOM(4, "setting peasycap->purb_audio_head=NULL\n");
 peasycap->purb_audio_head = (struct list_head *)NULL;
-} else {
-JOT(4, "peasycap->purb_audio_head is NULL\n");
 }
 /*---------------------------------------------------------------------------*/
-JOT(4, "freeing audio isoc buffers.\n");
+JOM(4, "freeing audio isoc buffers.\n");
 m = 0;
 for (k = 0;  k < AUDIO_ISOC_BUFFER_MANY;  k++) {
        if ((void *)NULL != peasycap->audio_isoc_buffer[k].pgo) {
@@ -761,22 +1055,22 @@ for (k = 0;  k < AUDIO_ISOC_BUFFER_MANY;  k++) {
                m++;
        }
 }
-JOT(4, "easysnd_delete(): isoc audio buffers freed: %i pages\n", \
+JOM(4, "easysnd_delete(): isoc audio buffers freed: %i pages\n", \
                                        m * (0x01 << AUDIO_ISOC_ORDER));
 /*---------------------------------------------------------------------------*/
-JOT(4, "freeing audio buffers.\n");
-lost = 0;
+JOM(4, "freeing audio buffers.\n");
+gone = 0;
 for (k = 0;  k < peasycap->audio_buffer_page_many;  k++) {
        if ((void *)NULL != peasycap->audio_buffer[k].pgo) {
                free_page((unsigned long)(peasycap->audio_buffer[k].pgo));
                peasycap->audio_buffer[k].pgo = (void *)NULL;
                peasycap->allocation_audio_page -= 1;
-               lost++;
+               gone++;
        }
 }
-JOT(4, "easysnd_delete(): audio buffers freed: %i pages\n", lost);
+JOM(4, "easysnd_delete(): audio buffers freed: %i pages\n", gone);
 /*---------------------------------------------------------------------------*/
-JOT(4, "freeing easycap structure.\n");
+JOM(4, "freeing easycap structure.\n");
 allocation_video_urb    = peasycap->allocation_video_urb;
 allocation_video_page   = peasycap->allocation_video_page;
 allocation_video_struct = peasycap->allocation_video_struct;
@@ -785,15 +1079,16 @@ allocation_audio_urb    = peasycap->allocation_audio_urb;
 allocation_audio_page   = peasycap->allocation_audio_page;
 allocation_audio_struct = peasycap->allocation_audio_struct;
 registered_audio        = peasycap->registered_audio;
-m = 0;
-if ((struct easycap *)NULL != peasycap) {
-       kfree(peasycap);  peasycap = (struct easycap *)NULL;
+
+kfree(peasycap);
+if (0 <= kd && DONGLE_MANY > kd) {
+       easycap_dongle[kd].peasycap = (struct easycap *)NULL;
+       JOT(4, "   null-->easycap_dongle[%i].peasycap\n", kd);
        allocation_video_struct -= sizeof(struct easycap);
-       m++;
+} else {
+       SAY("ERROR: cannot purge easycap_dongle[].peasycap");
 }
-JOT(4, "%i easycap structure freed\n", m);
 /*---------------------------------------------------------------------------*/
-
 SAY("%8i= video urbs     after all deletions\n", allocation_video_urb);
 SAY("%8i= video pages    after all deletions\n", allocation_video_page);
 SAY("%8i= video structs  after all deletions\n", allocation_video_struct);
@@ -810,27 +1105,85 @@ return;
 unsigned int easycap_poll(struct file *file, poll_table *wait)
 {
 struct easycap *peasycap;
+int rc, kd;
 
 JOT(8, "\n");
 
 if (NULL == ((poll_table *)wait))
        JOT(8, "WARNING:  poll table pointer is NULL ... continuing\n");
-if (NULL == ((struct file *)file)) {
+if ((struct file *)NULL == file) {
        SAY("ERROR:  file pointer is NULL\n");
-       return -EFAULT;
+       return -ERESTARTSYS;
 }
 peasycap = file->private_data;
 if (NULL == peasycap) {
        SAY("ERROR:  peasycap is NULL\n");
        return -EFAULT;
 }
+if (memcmp(&peasycap->telltale[0], TELLTALE, strlen(TELLTALE))) {
+       SAY("ERROR: bad peasycap: 0x%08lX\n", (unsigned long int) peasycap);
+       return -EFAULT;
+}
+if (NULL == peasycap->pusb_device) {
+       SAY("ERROR:  peasycap->pusb_device is NULL\n");
+       return -EFAULT;
+}
+/*---------------------------------------------------------------------------*/
+kd = isdongle(peasycap);
+if (0 <= kd && DONGLE_MANY > kd) {
+       if (mutex_lock_interruptible(&easycap_dongle[kd].mutex_video)) {
+               SAY("ERROR: cannot down easycap_dongle[%i].mutex_video\n", kd);
+               return -ERESTARTSYS;
+       }
+       JOM(4, "locked easycap_dongle[%i].mutex_video\n", kd);
+       /*-------------------------------------------------------------------*/
+       /*
+        *  MEANWHILE, easycap_usb_disconnect() MAY HAVE FREED POINTER
+        *  peasycap, IN WHICH CASE A REPEAT CALL TO isdongle() WILL FAIL.
+        *  IF NECESSARY, BAIL OUT.
+       */
+       /*-------------------------------------------------------------------*/
+       if (kd != isdongle(peasycap))
+               return -ERESTARTSYS;
+       if (NULL == file) {
+               SAY("ERROR:  file is NULL\n");
+               mutex_unlock(&easycap_dongle[kd].mutex_video);
+               return -ERESTARTSYS;
+       }
+       peasycap = file->private_data;
+       if (NULL == peasycap) {
+               SAY("ERROR:  peasycap is NULL\n");
+               mutex_unlock(&easycap_dongle[kd].mutex_video);
+               return -ERESTARTSYS;
+       }
+       if (memcmp(&peasycap->telltale[0], TELLTALE, strlen(TELLTALE))) {
+               SAY("ERROR: bad peasycap: 0x%08lX\n", \
+                                               (unsigned long int) peasycap);
+               mutex_unlock(&easycap_dongle[kd].mutex_video);
+               return -ERESTARTSYS;
+       }
+       if (NULL == peasycap->pusb_device) {
+               SAM("ERROR: peasycap->pusb_device is NULL\n");
+               mutex_unlock(&easycap_dongle[kd].mutex_video);
+               return -ERESTARTSYS;
+       }
+} else
+       /*-------------------------------------------------------------------*/
+       /*
+        *  IF easycap_usb_disconnect() HAS ALREADY FREED POINTER peasycap
+        *  BEFORE THE ATTEMPT TO ACQUIRE THE SEMAPHORE, isdongle() WILL
+        *  HAVE FAILED.  BAIL OUT.
+       */
+       /*-------------------------------------------------------------------*/
+       return -ERESTARTSYS;
+/*---------------------------------------------------------------------------*/
+rc = easycap_dqbuf(peasycap, 0);
 peasycap->polled = 1;
-
-if (0 == easycap_dqbuf(peasycap, 0))
+mutex_unlock(&easycap_dongle[kd].mutex_video);
+if (0 == rc)
        return POLLIN | POLLRDNORM;
 else
        return POLLERR;
-
 }
 /*****************************************************************************/
 /*---------------------------------------------------------------------------*/
@@ -841,7 +1194,7 @@ else
 int
 easycap_dqbuf(struct easycap *peasycap, int mode)
 {
-int miss, rc;
+int input, ifield, miss, rc;
 
 JOT(8, "\n");
 
@@ -849,129 +1202,188 @@ if (NULL == peasycap) {
        SAY("ERROR:  peasycap is NULL\n");
        return -EFAULT;
 }
+if (NULL == peasycap->pusb_device) {
+       SAY("ERROR:  peasycap->pusb_device is NULL\n");
+       return -EFAULT;
+}
+ifield = 0;
+JOM(8, "%i=ifield\n", ifield);
+/*---------------------------------------------------------------------------*/
+/*
+ *  CHECK FOR LOST INPUT SIGNAL.
+ *
+ *  FOR THE FOUR-CVBS EasyCAP, THIS DOES NOT WORK AS EXPECTED.
+ *  IF INPUT 0 IS PRESENT AND SYNC ACQUIRED, UNPLUGGING INPUT 4 DOES NOT
+ *  RESULT IN SETTING BIT 0x40 ON REGISTER 0x1F, PRESUMABLY BECAUSE THERE
+ *  IS FLYWHEELING ON INPUT 0.  THE UPSHOT IS:
+ *
+ *    INPUT 0   PLUGGED, INPUT 4   PLUGGED => SCREEN 0 OK,   SCREEN 4 OK
+ *    INPUT 0   PLUGGED, INPUT 4 UNPLUGGED => SCREEN 0 OK,   SCREEN 4 BLACK
+ *    INPUT 0 UNPLUGGED, INPUT 4   PLUGGED => SCREEN 0 BARS, SCREEN 4 OK
+ *    INPUT 0 UNPLUGGED, INPUT 4 UNPLUGGED => SCREEN 0 BARS, SCREEN 4 BARS
+*/
+/*---------------------------------------------------------------------------*/
+input = peasycap->input;
+if (0 <= input && INPUT_MANY > input) {
+       rc = read_saa(peasycap->pusb_device, 0x1F);
+       if (0 <= rc) {
+               if (rc & 0x40)
+                       peasycap->lost[input] += 1;
+               else
+                       peasycap->lost[input] -= 2;
+
+       if (0 > peasycap->lost[input])
+               peasycap->lost[input] = 0;
+       else if ((2 * VIDEO_LOST_TOLERATE) < peasycap->lost[input])
+               peasycap->lost[input] = (2 * VIDEO_LOST_TOLERATE);
+       }
+}
 /*---------------------------------------------------------------------------*/
 /*
- *  WAIT FOR FIELD 0
+ *  WAIT FOR FIELD ifield  (0 => TOP, 1 => BOTTOM)
  */
 /*---------------------------------------------------------------------------*/
 miss = 0;
-if (mutex_lock_interruptible(&(peasycap->mutex_mmap_video[0])))
-       return -ERESTARTSYS;
 while ((peasycap->field_read == peasycap->field_fill) || \
                                (0 != (0xFF00 & peasycap->field_buffer\
                                        [peasycap->field_read][0].kount)) || \
-                               (0 != (0x00FF & peasycap->field_buffer\
+                               (ifield != (0x00FF & peasycap->field_buffer\
                                        [peasycap->field_read][0].kount))) {
-       mutex_unlock(&(peasycap->mutex_mmap_video[0]));
-
        if (mode)
                return -EAGAIN;
 
-       JOT(8, "first wait  on wq_video, " \
+       JOM(8, "first wait  on wq_video, " \
                                "%i=field_read  %i=field_fill\n", \
                                peasycap->field_read, peasycap->field_fill);
 
-       msleep(1);
        if (0 != (wait_event_interruptible(peasycap->wq_video, \
                        (peasycap->video_idle || peasycap->video_eof  || \
                        ((peasycap->field_read != peasycap->field_fill) && \
                                (0 == (0xFF00 & peasycap->field_buffer\
                                        [peasycap->field_read][0].kount)) && \
-                               (0 == (0x00FF & peasycap->field_buffer\
-                                       [peasycap->field_read][0].kount))))))){
-               SAY("aborted by signal\n");
+                               (ifield == (0x00FF & peasycap->field_buffer\
+                                       [peasycap->field_read][0].kount))))))) {
+               SAM("aborted by signal\n");
                return -EIO;
                }
        if (peasycap->video_idle) {
-               JOT(8, "%i=peasycap->video_idle\n", peasycap->video_idle);
-               return -EIO;
+               JOM(8, "%i=peasycap->video_idle ... returning -EAGAIN\n", \
+                                                       peasycap->video_idle);
+               return -EAGAIN;
        }
        if (peasycap->video_eof) {
-               JOT(8, "%i=peasycap->video_eof\n", peasycap->video_eof);
-               debrief(peasycap);
+               JOM(8, "%i=peasycap->video_eof\n", peasycap->video_eof);
+               #if defined(PERSEVERE)
+               if (1 == peasycap->status) {
+                       JOM(8, "persevering ...\n");
+                       peasycap->video_eof = 0;
+                       peasycap->audio_eof = 0;
+                       if (0 != reset(peasycap)) {
+                               JOM(8, " ... failed ... returning -EIO\n");
+                               peasycap->video_eof = 1;
+                               peasycap->audio_eof = 1;
+                               kill_video_urbs(peasycap);
+                               return -EIO;
+                       }
+                       peasycap->status = 0;
+                       JOM(8, " ... OK ... returning -EAGAIN\n");
+                       return -EAGAIN;
+               }
+               #endif /*PERSEVERE*/
+               peasycap->video_eof = 1;
+               peasycap->audio_eof = 1;
                kill_video_urbs(peasycap);
+               JOM(8, "returning -EIO\n");
                return -EIO;
        }
 miss++;
-if (mutex_lock_interruptible(&(peasycap->mutex_mmap_video[0])))
-       return -ERESTARTSYS;
 }
-mutex_unlock(&(peasycap->mutex_mmap_video[0]));
-JOT(8, "first awakening on wq_video after %i waits\n", miss);
+JOM(8, "first awakening on wq_video after %i waits\n", miss);
 
 rc = field2frame(peasycap);
 if (0 != rc)
-       SAY("ERROR: field2frame() returned %i\n", rc);
-
-if (true == peasycap->offerfields) {
-       peasycap->frame_read = peasycap->frame_fill;
-       (peasycap->frame_fill)++;
-       if (peasycap->frame_buffer_many <= peasycap->frame_fill)
-               peasycap->frame_fill = 0;
-
-       if (0x01 & easycap_standard[peasycap->standard_offset].mask) {
-               peasycap->frame_buffer[peasycap->frame_read][0].kount = \
-                                                       V4L2_FIELD_BOTTOM;
-       } else {
-               peasycap->frame_buffer[peasycap->frame_read][0].kount = \
-                                                       V4L2_FIELD_TOP;
-       }
-JOT(8, "setting:    %i=peasycap->frame_read\n", peasycap->frame_read);
-JOT(8, "bumped to:  %i=peasycap->frame_fill\n", peasycap->frame_fill);
-}
+       SAM("ERROR: field2frame() returned %i\n", rc);
 /*---------------------------------------------------------------------------*/
 /*
- *  WAIT FOR FIELD 1
+ *  WAIT FOR THE OTHER FIELD
  */
 /*---------------------------------------------------------------------------*/
+if (ifield)
+       ifield = 0;
+else
+       ifield = 1;
 miss = 0;
-if (mutex_lock_interruptible(&(peasycap->mutex_mmap_video[0])))
-       return -ERESTARTSYS;
 while ((peasycap->field_read == peasycap->field_fill) || \
                                (0 != (0xFF00 & peasycap->field_buffer\
                                        [peasycap->field_read][0].kount)) || \
-                               (0 == (0x00FF & peasycap->field_buffer\
+                               (ifield != (0x00FF & peasycap->field_buffer\
                                        [peasycap->field_read][0].kount))) {
-       mutex_unlock(&(peasycap->mutex_mmap_video[0]));
-
        if (mode)
                return -EAGAIN;
 
-       JOT(8, "second wait on wq_video, " \
+       JOM(8, "second wait on wq_video, " \
                                "%i=field_read  %i=field_fill\n", \
                                peasycap->field_read, peasycap->field_fill);
-       msleep(1);
        if (0 != (wait_event_interruptible(peasycap->wq_video, \
                        (peasycap->video_idle || peasycap->video_eof  || \
                        ((peasycap->field_read != peasycap->field_fill) && \
                                (0 == (0xFF00 & peasycap->field_buffer\
                                        [peasycap->field_read][0].kount)) && \
-                               (0 != (0x00FF & peasycap->field_buffer\
-                                       [peasycap->field_read][0].kount))))))){
-               SAY("aborted by signal\n");
+                               (ifield == (0x00FF & peasycap->field_buffer\
+                                       [peasycap->field_read][0].\
+                                                               kount))))))) {
+               SAM("aborted by signal\n");
                return -EIO;
        }
        if (peasycap->video_idle) {
-               JOT(8, "%i=peasycap->video_idle\n", peasycap->video_idle);
-               return -EIO;
+               JOM(8, "%i=peasycap->video_idle ... returning -EAGAIN\n", \
+                                                       peasycap->video_idle);
+               return -EAGAIN;
        }
        if (peasycap->video_eof) {
-               JOT(8, "%i=peasycap->video_eof\n", peasycap->video_eof);
-               debrief(peasycap);
+               JOM(8, "%i=peasycap->video_eof\n", peasycap->video_eof);
+               #if defined(PERSEVERE)
+               if (1 == peasycap->status) {
+                       JOM(8, "persevering ...\n");
+                       peasycap->video_eof = 0;
+                       peasycap->audio_eof = 0;
+                       if (0 != reset(peasycap)) {
+                               JOM(8, " ... failed ... returning -EIO\n");
+                               peasycap->video_eof = 1;
+                               peasycap->audio_eof = 1;
+                               kill_video_urbs(peasycap);
+                               return -EIO;
+                       }
+                       peasycap->status = 0;
+                       JOM(8, " ... OK ... returning -EAGAIN\n");
+                       return -EAGAIN;
+               }
+               #endif /*PERSEVERE*/
+               peasycap->video_eof = 1;
+               peasycap->audio_eof = 1;
                kill_video_urbs(peasycap);
+               JOM(8, "returning -EIO\n");
                return -EIO;
        }
 miss++;
-if (mutex_lock_interruptible(&(peasycap->mutex_mmap_video[0])))
-       return -ERESTARTSYS;
 }
-mutex_unlock(&(peasycap->mutex_mmap_video[0]));
-JOT(8, "second awakening on wq_video after %i waits\n", miss);
+JOM(8, "second awakening on wq_video after %i waits\n", miss);
 
 rc = field2frame(peasycap);
 if (0 != rc)
-       SAY("ERROR: field2frame() returned %i\n", rc);
-
+       SAM("ERROR: field2frame() returned %i\n", rc);
+/*---------------------------------------------------------------------------*/
+/*
+ *  WASTE THIS FRAME
+*/
+/*---------------------------------------------------------------------------*/
+if (0 != peasycap->skip) {
+       peasycap->skipped++;
+       if (peasycap->skip != peasycap->skipped)
+               return peasycap->skip - peasycap->skipped;
+       peasycap->skipped = 0;
+}
+/*---------------------------------------------------------------------------*/
 peasycap->frame_read = peasycap->frame_fill;
 peasycap->queued[peasycap->frame_read] = 0;
 peasycap->done[peasycap->frame_read]   = V4L2_BUF_FLAG_DONE;
@@ -988,8 +1400,8 @@ if (0x01 & easycap_standard[peasycap->standard_offset].mask) {
                                                        V4L2_FIELD_BOTTOM;
 }
 
-JOT(8, "setting:    %i=peasycap->frame_read\n", peasycap->frame_read);
-JOT(8, "bumped to:  %i=peasycap->frame_fill\n", peasycap->frame_fill);
+JOM(8, "setting:    %i=peasycap->frame_read\n", peasycap->frame_read);
+JOM(8, "bumped to:  %i=peasycap->frame_fill\n", peasycap->frame_fill);
 
 return 0;
 }
@@ -1003,14 +1415,12 @@ return 0;
  *  odd==false IS TRANSFERRED TO THE FRAME BUFFER.
  *
  *  THE BOOLEAN PARAMETER offerfields IS true ONLY WHEN THE USER PROGRAM
- *  CHOOSES THE OPTION V4L2_FIELD_ALTERNATE.  NO USERSPACE PROGRAM TESTED
- *  TO DATE HAS DONE THIS.  BUGS ARE LIKELY.
+ *  CHOOSES THE OPTION V4L2_FIELD_INTERLACED.
  */
 /*---------------------------------------------------------------------------*/
 int
 field2frame(struct easycap *peasycap)
 {
-static struct timeval timeval0;
 struct timeval timeval;
 long long int above, below;
 __u32 remainder;
@@ -1019,16 +1429,26 @@ struct signed_div_result sdr;
 void *pex, *pad;
 int kex, kad, mex, mad, rex, rad, rad2;
 int c2, c3, w2, w3, cz, wz;
-int rc, bytesperpixel, multiplier, much, more, over, rump, caches;
+int rc, bytesperpixel, multiplier, much, more, over, rump, caches, input;
 __u8 mask, margin;
-bool odd, isuy, decimatepixel, offerfields;
+bool odd, isuy, decimatepixel, offerfields, badinput;
 
-JOT(8, "=====  parity %i, field buffer %i --> frame buffer %i\n", \
+if (NULL == peasycap) {
+       SAY("ERROR: peasycap is NULL\n");
+       return -EFAULT;
+}
+
+badinput = false;
+input = 0x07 & peasycap->field_buffer[peasycap->field_read][0].input;
+
+JOM(8, "=====  parity %i, input 0x%02X, field buffer %i --> " \
+                                               "frame buffer %i\n", \
                        peasycap->field_buffer[peasycap->field_read][0].kount,\
+                       peasycap->field_buffer[peasycap->field_read][0].input,\
                        peasycap->field_read, peasycap->frame_fill);
-JOT(8, "=====  %i=bytesperpixel\n", peasycap->bytesperpixel);
+JOM(8, "=====  %i=bytesperpixel\n", peasycap->bytesperpixel);
 if (true == peasycap->offerfields)
-       JOT(8, "===== offerfields\n");
+       JOM(8, "===== offerfields\n");
 
 /*---------------------------------------------------------------------------*/
 /*
@@ -1036,15 +1456,17 @@ if (true == peasycap->offerfields)
  */
 /*---------------------------------------------------------------------------*/
 if (peasycap->field_read == peasycap->field_fill) {
-       SAY("ERROR: on entry, still filling field buffer %i\n", \
+       SAM("ERROR: on entry, still filling field buffer %i\n", \
                                                        peasycap->field_read);
        return 0;
 }
 #if defined(EASYCAP_TESTCARD)
 easycap_testcard(peasycap, peasycap->field_read);
 #else
-if (0 != (0x0400 & peasycap->field_buffer[peasycap->field_read][0].kount))
-       easycap_testcard(peasycap, peasycap->field_read);
+if (0 <= input && INPUT_MANY > input) {
+       if (easycap_bars && VIDEO_LOST_TOLERATE <= peasycap->lost[input])
+               easycap_testcard(peasycap, peasycap->field_read);
+}
 #endif /*EASYCAP_TESTCARD*/
 /*---------------------------------------------------------------------------*/
 
@@ -1055,7 +1477,7 @@ decimatepixel = peasycap->decimatepixel;
 if ((2 != bytesperpixel) && \
                        (3 != bytesperpixel) && \
                        (4 != bytesperpixel)) {
-       SAY("MISTAKE: %i=bytesperpixel\n", bytesperpixel);
+       SAM("MISTAKE: %i=bytesperpixel\n", bytesperpixel);
        return -EFAULT;
 }
 if (true == decimatepixel)
@@ -1082,8 +1504,8 @@ if (peasycap->field_buffer[kex][0].kount)
 else
        odd = false;
 
-if ((true == odd) && (false == offerfields) &&(false == decimatepixel)) {
-       JOT(8, "  initial skipping    %4i          bytes p.%4i\n", \
+if ((true == odd) && (false == decimatepixel)) {
+       JOM(8, "  initial skipping    %4i          bytes p.%4i\n", \
                                                        w3/multiplier, mad);
        pad += (w3 / multiplier);  rad -= (w3 / multiplier);
 }
@@ -1108,7 +1530,7 @@ while (cz < wz) {
                        rump = 0;
 
                        if (much % 2) {
-                               SAY("MISTAKE: much is odd\n");
+                               SAM("MISTAKE: much is odd\n");
                                return -EFAULT;
                        }
 
@@ -1116,13 +1538,11 @@ while (cz < wz) {
                                        much) / 2;
 /* - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - */
                        if (1 < bytesperpixel) {
-                               if ((rad * \
-                                       2) < (much * \
-                                               bytesperpixel)) {
+                               if (rad * 2 < much * bytesperpixel) {
                                        /*
                                        **   INJUDICIOUS ALTERATION OF THIS
-                                       **   BLOCK WILL CAUSE BREAKAGE.
-                                       **   BEWARE.
+                                       **   STATEMENT BLOCK WILL CAUSE
+                                       **   BREAKAGE.  BEWARE.
                                        **/
                                        rad2 = rad + bytesperpixel - 1;
                                        much = ((((2 * \
@@ -1145,18 +1565,25 @@ while (cz < wz) {
                                }
 /* - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - */
                        } else {
-                               SAY("MISTAKE: %i=bytesperpixel\n", \
+                               SAM("MISTAKE: %i=bytesperpixel\n", \
                                                bytesperpixel);
                                return -EFAULT;
                        }
 /* - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - */
                        if (rump)
                                caches++;
-
+                               if (true == badinput) {
+                                       JOM(8, "ERROR: 0x%02X=->field_buffer" \
+                                               "[%i][%i].input, " \
+                                               "0x%02X=(0x08|->input)\n", \
+                                               peasycap->field_buffer\
+                                               [kex][mex].input, kex, mex, \
+                                               (0x08|peasycap->input));
+                               }
                        rc = redaub(peasycap, pad, pex, much, more, \
                                                        mask, margin, isuy);
                        if (0 > rc) {
-                               SAY("ERROR: redaub() failed\n");
+                               SAM("ERROR: redaub() failed\n");
                                return -EFAULT;
                        }
                        if (much % 4) {
@@ -1171,6 +1598,9 @@ while (cz < wz) {
                                mex++;
                                pex = peasycap->field_buffer[kex][mex].pgo;
                                rex = PAGE_SIZE;
+                               if (peasycap->field_buffer[kex][mex].input != \
+                                               (0x08|peasycap->input))
+                                       badinput = true;
                        }
                        pad  += more;
                        rad -= more;
@@ -1190,7 +1620,7 @@ while (cz < wz) {
  *  UNLESS IT IS THE LAST LINE OF AN ODD FRAME
  */
 /*---------------------------------------------------------------------------*/
-               if (((false == odd) || (cz != wz))&&(false == offerfields)) {
+               if ((false == odd) || (cz != wz)) {
                        over = w3;
                        do {
                                if (!rad) {
@@ -1224,7 +1654,7 @@ while (cz < wz) {
                        rump = 0;
 
                        if (much % 2) {
-                               SAY("MISTAKE: much is odd\n");
+                               SAM("MISTAKE: much is odd\n");
                                return -EFAULT;
                        }
 
@@ -1232,12 +1662,11 @@ while (cz < wz) {
                                        much) / 4;
 /* - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - */
                        if (1 < bytesperpixel) {
-                               if ((rad * 4) < (much * \
-                                               bytesperpixel)) {
+                               if (rad * 4 < much * bytesperpixel) {
                                        /*
                                        **   INJUDICIOUS ALTERATION OF THIS
-                                       **   BLOCK WILL CAUSE BREAKAGE.
-                                       **   BEWARE.
+                                       **   STATEMENT BLOCK WILL CAUSE
+                                       **   BREAKAGE.  BEWARE.
                                        **/
                                        rad2 = rad + bytesperpixel - 1;
                                        much = ((((2 * rad2)/bytesperpixel)/2)\
@@ -1261,7 +1690,7 @@ while (cz < wz) {
                                        }
 /* - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - */
                                } else {
-                                       SAY("MISTAKE: %i=bytesperpixel\n", \
+                                       SAM("MISTAKE: %i=bytesperpixel\n", \
                                                bytesperpixel);
                                        return -EFAULT;
                                }
@@ -1269,10 +1698,18 @@ while (cz < wz) {
                        if (rump)
                                caches++;
 
+                               if (true == badinput) {
+                                       JOM(8, "ERROR: 0x%02X=->field_buffer" \
+                                               "[%i][%i].input, " \
+                                               "0x%02X=(0x08|->input)\n", \
+                                               peasycap->field_buffer\
+                                               [kex][mex].input, kex, mex, \
+                                               (0x08|peasycap->input));
+                               }
                        rc = redaub(peasycap, pad, pex, much, more, \
                                                        mask, margin, isuy);
                        if (0 > rc) {
-                               SAY("ERROR: redaub() failed\n");
+                               SAM("ERROR: redaub() failed\n");
                                return -EFAULT;
                        }
                        over -= much;   cz += much;
@@ -1281,6 +1718,9 @@ while (cz < wz) {
                                mex++;
                                pex = peasycap->field_buffer[kex][mex].pgo;
                                rex = PAGE_SIZE;
+                               if (peasycap->field_buffer[kex][mex].input != \
+                                               (0x08|peasycap->input))
+                                       badinput = true;
                        }
                        pad  += more;
                        rad -= more;
@@ -1307,6 +1747,16 @@ while (cz < wz) {
                                mex++;
                                pex = peasycap->field_buffer[kex][mex].pgo;
                                rex = PAGE_SIZE;
+                               if (peasycap->field_buffer[kex][mex].input != \
+                                               (0x08|peasycap->input)) {
+                                       JOM(8, "ERROR: 0x%02X=->field_buffer"\
+                                               "[%i][%i].input, " \
+                                               "0x%02X=(0x08|->input)\n", \
+                                               peasycap->field_buffer\
+                                               [kex][mex].input, kex, mex, \
+                                               (0x08|peasycap->input));
+                                       badinput = true;
+                               }
                        }
                        much = over;
                        if (rex < much)
@@ -1325,39 +1775,39 @@ while (cz < wz) {
 /*---------------------------------------------------------------------------*/
 c2 = (mex + 1)*PAGE_SIZE - rex;
 if (cz != c2)
-       SAY("ERROR: discrepancy %i in bytes read\n", c2 - cz);
+       SAM("ERROR: discrepancy %i in bytes read\n", c2 - cz);
 c3 = (mad + 1)*PAGE_SIZE - rad;
 
 if (false == decimatepixel) {
        if (bytesperpixel * \
                cz != c3) \
-               SAY("ERROR: discrepancy %i in bytes written\n", \
+               SAM("ERROR: discrepancy %i in bytes written\n", \
                                                c3 - (bytesperpixel * \
                                                                        cz));
 } else {
        if (false == odd) {
                if (bytesperpixel * \
                        cz != (4 * c3))
-                       SAY("ERROR: discrepancy %i in bytes written\n", \
+                       SAM("ERROR: discrepancy %i in bytes written\n", \
                                                (2*c3)-(bytesperpixel * \
                                                                        cz));
                } else {
                        if (0 != c3)
-                               SAY("ERROR: discrepancy %i " \
+                               SAM("ERROR: discrepancy %i " \
                                                "in bytes written\n", c3);
                }
 }
 if (rump)
-       SAY("ERROR: undischarged cache at end of line in frame buffer\n");
+       SAM("WORRY: undischarged cache at end of line in frame buffer\n");
 
-JOT(8, "===== field2frame(): %i bytes --> %i bytes (incl skip)\n", c2, c3);
-JOT(8, "===== field2frame(): %i=mad  %i=rad\n", mad, rad);
+JOM(8, "===== field2frame(): %i bytes --> %i bytes (incl skip)\n", c2, c3);
+JOM(8, "===== field2frame(): %i=mad  %i=rad\n", mad, rad);
 
 if (true == odd)
-       JOT(8, "+++++ field2frame():  frame buffer %i is full\n", kad);
+       JOM(8, "+++++ field2frame():  frame buffer %i is full\n", kad);
 
 if (peasycap->field_read == peasycap->field_fill)
-       SAY("WARNING: on exit, filling field buffer %i\n", \
+       SAM("WARNING: on exit, filling field buffer %i\n", \
                                                        peasycap->field_read);
 /*---------------------------------------------------------------------------*/
 /*
@@ -1365,23 +1815,24 @@ if (peasycap->field_read == peasycap->field_fill)
  */
 /*---------------------------------------------------------------------------*/
 do_gettimeofday(&timeval);
-if (timeval0.tv_sec) {
+if (peasycap->timeval6.tv_sec) {
        below = ((long long int)(1000000)) * \
-               ((long long int)(timeval.tv_sec  - timeval0.tv_sec)) + \
-                        (long long int)(timeval.tv_usec - timeval0.tv_usec);
+               ((long long int)(timeval.tv_sec - \
+                                       peasycap->timeval6.tv_sec)) + \
+                (long long int)(timeval.tv_usec - peasycap->timeval6.tv_usec);
        above = (long long int)1000000;
 
        sdr = signed_div(above, below);
        above = sdr.quotient;
        remainder = (__u32)sdr.remainder;
 
-       JOT(8, "video streaming at %3lli.%03i fields per second\n", above, \
+       JOM(8, "video streaming at %3lli.%03i fields per second\n", above, \
                                                        (remainder/1000));
 }
-timeval0 = timeval;
+peasycap->timeval6 = timeval;
 
 if (caches)
-       JOT(8, "%i=caches\n", caches);
+       JOM(8, "%i=caches\n", caches);
 return 0;
 }
 /*****************************************************************************/
@@ -1434,7 +1885,7 @@ redaub(struct easycap *peasycap, void *pad, void *pex, int much, int more, \
                                        __u8 mask, __u8 margin, bool isuy)
 {
 static __s32 ay[256], bu[256], rv[256], gu[256], gv[256];
-static __u8 cache[8], *pcache;
+__u8 *pcache;
 __u8 r, g, b, y, u, v, c, *p2, *p3, *pz, *pr;
 int  bytesperpixel;
 bool byteswaporder, decimatepixel, last;
@@ -1442,7 +1893,7 @@ int j, rump;
 __s32 s32;
 
 if (much % 2) {
-       SAY("MISTAKE: much is odd\n");
+       SAM("MISTAKE: much is odd\n");
        return -EFAULT;
 }
 bytesperpixel = peasycap->bytesperpixel;
@@ -1475,30 +1926,31 @@ if (!bu[255]) {
                ay[j] = ay[16];
        for (j = 236; j < 256; j++)
                ay[j] = ay[235];
-       JOT(8, "lookup tables are prepared\n");
+       JOM(8, "lookup tables are prepared\n");
 }
-if ((__u8 *)NULL == pcache)
-       pcache = &cache[0];
+pcache = peasycap->pcache;
+if (NULL == pcache)
+       pcache = &peasycap->cache[0];
 /*---------------------------------------------------------------------------*/
 /*
  *  TRANSFER CONTENTS OF CACHE TO THE FRAME BUFFER
  */
 /*---------------------------------------------------------------------------*/
 if (!pcache) {
-       SAY("MISTAKE: pcache is NULL\n");
+       SAM("MISTAKE: pcache is NULL\n");
        return -EFAULT;
 }
 
-if (pcache != &cache[0])
-       JOT(16, "cache has %i bytes\n", (int)(pcache - &cache[0]));
-p2 = &cache[0];
-p3 = (__u8 *)pad - (int)(pcache - &cache[0]);
+if (pcache != &peasycap->cache[0])
+       JOM(16, "cache has %i bytes\n", (int)(pcache - &peasycap->cache[0]));
+p2 = &peasycap->cache[0];
+p3 = (__u8 *)pad - (int)(pcache - &peasycap->cache[0]);
 while (p2 < pcache) {
        *p3++ = *p2;  p2++;
 }
-pcache = &cache[0];
+pcache = &peasycap->cache[0];
 if (p3 != pad) {
-       SAY("MISTAKE: pointer misalignment\n");
+       SAM("MISTAKE: pointer misalignment\n");
        return -EFAULT;
 }
 /*---------------------------------------------------------------------------*/
@@ -1513,7 +1965,7 @@ else
        v = *(p2 - 1);
 
 if (rump)
-       JOT(16, "%4i=much  %4i=more  %i=rump\n", much, more, rump);
+       JOM(16, "%4i=much  %4i=more  %i=rump\n", much, more, rump);
 
 /*---------------------------------------------------------------------------*/
 switch (bytesperpixel) {
@@ -1619,7 +2071,7 @@ case 3:
                                                        0 : (__u8)s32);
 
                                if ((true == last) && rump) {
-                                       pcache = &cache[0];
+                                       pcache = &peasycap->cache[0];
                                        switch (bytesperpixel - rump) {
                                        case 1: {
                                                *p3 = r;
@@ -1634,7 +2086,7 @@ case 3:
                                                break;
                                        }
                                        default: {
-                                               SAY("MISTAKE: %i=rump\n", \
+                                               SAM("MISTAKE: %i=rump\n", \
                                                        bytesperpixel - rump);
                                                return -EFAULT;
                                        }
@@ -1692,7 +2144,7 @@ case 3:
                                                                0 : (__u8)s32);
 
                                if ((true == last) && rump) {
-                                       pcache = &cache[0];
+                                       pcache = &peasycap->cache[0];
                                        switch (bytesperpixel - rump) {
                                        case 1: {
                                                *p3 = b;
@@ -1707,7 +2159,7 @@ case 3:
                                                break;
                                        }
                                        default: {
-                                               SAY("MISTAKE: %i=rump\n", \
+                                               SAM("MISTAKE: %i=rump\n", \
                                                        bytesperpixel - rump);
                                                return -EFAULT;
                                        }
@@ -1768,7 +2220,7 @@ case 3:
                                                                0 : (__u8)s32);
 
                                        if ((true == last) && rump) {
-                                               pcache = &cache[0];
+                                               pcache = &peasycap->cache[0];
                                                switch (bytesperpixel - rump) {
                                                case 1: {
                                                        *p3 = r;
@@ -1783,7 +2235,7 @@ case 3:
                                                        break;
                                                }
                                                default: {
-                                                       SAY("MISTAKE: " \
+                                                       SAM("MISTAKE: " \
                                                        "%i=rump\n", \
                                                        bytesperpixel - rump);
                                                        return -EFAULT;
@@ -1844,7 +2296,7 @@ case 3:
                                                                0 : (__u8)s32);
 
                                        if ((true == last) && rump) {
-                                               pcache = &cache[0];
+                                               pcache = &peasycap->cache[0];
                                                switch (bytesperpixel - rump) {
                                                case 1: {
                                                        *p3 = b;
@@ -1859,7 +2311,7 @@ case 3:
                                                        break;
                                                }
                                                default: {
-                                                       SAY("MISTAKE: " \
+                                                       SAM("MISTAKE: " \
                                                        "%i=rump\n", \
                                                        bytesperpixel - rump);
                                                        return -EFAULT;
@@ -1924,7 +2376,7 @@ case 4:
                                                                0 : (__u8)s32);
 
                                if ((true == last) && rump) {
-                                       pcache = &cache[0];
+                                       pcache = &peasycap->cache[0];
                                        switch (bytesperpixel - rump) {
                                        case 1: {
                                                *p3 = r;
@@ -1948,7 +2400,7 @@ case 4:
                                                break;
                                        }
                                        default: {
-                                               SAY("MISTAKE: %i=rump\n", \
+                                               SAM("MISTAKE: %i=rump\n", \
                                                        bytesperpixel - rump);
                                                return -EFAULT;
                                        }
@@ -2006,7 +2458,7 @@ case 4:
                                                                0 : (__u8)s32);
 
                                if ((true == last) && rump) {
-                                       pcache = &cache[0];
+                                       pcache = &peasycap->cache[0];
                                        switch (bytesperpixel - rump) {
                                        case 1: {
                                                *p3 = b;
@@ -2030,7 +2482,7 @@ case 4:
                                                break;
                                        }
                                        default: {
-                                               SAY("MISTAKE: %i=rump\n", \
+                                               SAM("MISTAKE: %i=rump\n", \
                                                        bytesperpixel - rump);
                                                return -EFAULT;
                                        }
@@ -2093,7 +2545,7 @@ case 4:
                                                                0 : (__u8)s32);
 
                                        if ((true == last) && rump) {
-                                               pcache = &cache[0];
+                                               pcache = &peasycap->cache[0];
                                                switch (bytesperpixel - rump) {
                                                case 1: {
                                                        *p3 = r;
@@ -2117,7 +2569,7 @@ case 4:
                                                        break;
                                                }
                                                default: {
-                                                       SAY("MISTAKE: " \
+                                                       SAM("MISTAKE: " \
                                                        "%i=rump\n", \
                                                        bytesperpixel - \
                                                        rump);
@@ -2178,7 +2630,7 @@ case 4:
                                                                0 : (__u8)s32);
 
                                        if ((true == last) && rump) {
-                                               pcache = &cache[0];
+                                               pcache = &peasycap->cache[0];
                                                switch (bytesperpixel - rump) {
                                                case 1: {
                                                        *p3 = b;
@@ -2202,7 +2654,7 @@ case 4:
                                                        break;
                                                }
                                                default: {
-                                                       SAY("MISTAKE: " \
+                                                       SAM("MISTAKE: " \
                                                        "%i=rump\n", \
                                                        bytesperpixel - rump);
                                                        return -EFAULT;
@@ -2226,48 +2678,13 @@ case 4:
        break;
        }
 default: {
-       SAY("MISTAKE: %i=bytesperpixel\n", bytesperpixel);
+       SAM("MISTAKE: %i=bytesperpixel\n", bytesperpixel);
        return -EFAULT;
        }
 }
 return 0;
 }
 /*****************************************************************************/
-void
-debrief(struct easycap *peasycap)
-{
-if ((struct usb_device *)NULL != peasycap->pusb_device) {
-       check_stk(peasycap->pusb_device);
-       check_saa(peasycap->pusb_device);
-       sayreadonly(peasycap);
-       SAY("%i=peasycap->field_fill\n", peasycap->field_fill);
-       SAY("%i=peasycap->field_read\n", peasycap->field_read);
-       SAY("%i=peasycap->frame_fill\n", peasycap->frame_fill);
-       SAY("%i=peasycap->frame_read\n", peasycap->frame_read);
-}
-return;
-}
-/*****************************************************************************/
-void
-sayreadonly(struct easycap *peasycap)
-{
-static int done;
-int got00, got1F, got60, got61, got62;
-
-if ((!done) && ((struct usb_device *)NULL != peasycap->pusb_device)) {
-       done = 1;
-       got00 = read_saa(peasycap->pusb_device, 0x00);
-       got1F = read_saa(peasycap->pusb_device, 0x1F);
-       got60 = read_saa(peasycap->pusb_device, 0x60);
-       got61 = read_saa(peasycap->pusb_device, 0x61);
-       got62 = read_saa(peasycap->pusb_device, 0x62);
-       SAY("0x%02X=reg0x00  0x%02X=reg0x1F\n", got00, got1F);
-       SAY("0x%02X=reg0x60  0x%02X=reg0x61  0x%02X=reg0x62\n", \
-                                                       got60, got61, got62);
-}
-return;
-}
-/*****************************************************************************/
 /*---------------------------------------------------------------------------*/
 /*
  *  SEE CORBET ET AL. "LINUX DEVICE DRIVERS", 3rd EDITION, PAGES 430-434
@@ -2292,11 +2709,16 @@ easycap_vma_open(struct vm_area_struct *pvma)
 struct easycap *peasycap;
 
 peasycap = pvma->vm_private_data;
-if (NULL != peasycap)
-       peasycap->vma_many++;
-
+if (NULL == peasycap) {
+       SAY("ERROR: peasycap is NULL\n");
+       return;
+}
+if (memcmp(&peasycap->telltale[0], TELLTALE, strlen(TELLTALE))) {
+       SAY("ERROR: bad peasycap: 0x%08lX\n", (unsigned long int) peasycap);
+       return;
+}
+peasycap->vma_many++;
 JOT(8, "%i=peasycap->vma_many\n", peasycap->vma_many);
-
 return;
 }
 /*****************************************************************************/
@@ -2306,10 +2728,16 @@ easycap_vma_close(struct vm_area_struct *pvma)
 struct easycap *peasycap;
 
 peasycap = pvma->vm_private_data;
-if (NULL != peasycap) {
-       peasycap->vma_many--;
-       JOT(8, "%i=peasycap->vma_many\n", peasycap->vma_many);
+if (NULL == peasycap) {
+       SAY("ERROR: peasycap is NULL\n");
+       return;
+}
+if (memcmp(&peasycap->telltale[0], TELLTALE, strlen(TELLTALE))) {
+       SAY("ERROR: bad peasycap: 0x%08lX\n", (unsigned long int) peasycap);
+       return;
 }
+peasycap->vma_many--;
+JOT(8, "%i=peasycap->vma_many\n", peasycap->vma_many);
 return;
 }
 /*****************************************************************************/
@@ -2355,24 +2783,22 @@ if (NULL == peasycap) {
        SAY("ERROR: peasycap is NULL\n");
        return retcode;
 }
-mutex_lock(&(peasycap->mutex_mmap_video[0]));
 /*---------------------------------------------------------------------------*/
 pbuf = peasycap->frame_buffer[k][m].pgo;
 if (NULL == pbuf) {
-       SAY("ERROR:  pbuf is NULL\n");
+       SAM("ERROR:  pbuf is NULL\n");
        goto finish;
 }
 page = virt_to_page(pbuf);
 if (NULL == page) {
-       SAY("ERROR:  page is NULL\n");
+       SAM("ERROR:  page is NULL\n");
        goto finish;
 }
 get_page(page);
 /*---------------------------------------------------------------------------*/
 finish:
-mutex_unlock(&(peasycap->mutex_mmap_video[0]));
 if (NULL == page) {
-       SAY("ERROR:  page is NULL after get_page(page)\n");
+       SAM("ERROR:  page is NULL after get_page(page)\n");
 } else {
        pvmf->page = page;
        retcode = VM_FAULT_MINOR;
@@ -2383,7 +2809,7 @@ return retcode;
 /*---------------------------------------------------------------------------*/
 /*
  *  ON COMPLETION OF A VIDEO URB ITS DATA IS COPIED TO THE FIELD BUFFERS
- *  PROVIDED peasycap->video_idle IS ZER0.  REGARDLESS OF THIS BEING TRUE,
+ *  PROVIDED peasycap->video_idle IS ZERO.  REGARDLESS OF THIS BEING TRUE,
  *  IT IS RESUBMITTED PROVIDED peasycap->video_isoc_streaming IS NOT ZERO.
  *
  *  THIS FUNCTION IS AN INTERRUPT SERVICE ROUTINE AND MUST NOT SLEEP.
@@ -2400,7 +2826,8 @@ return retcode;
  *      0 != (kount & 0x8000)   => AT LEAST ONE URB COMPLETED WITH ERRORS
  *      0 != (kount & 0x4000)   => BUFFER HAS TOO MUCH DATA
  *      0 != (kount & 0x2000)   => BUFFER HAS NOT ENOUGH DATA
- *      0 != (kount & 0x0400)   => FIELD WAS SUBMITTED BY BRIDGER ROUTINE
+ *      0 != (kount & 0x1000)   => BUFFER HAS DATA FROM DISPARATE INPUTS
+ *      0 != (kount & 0x0400)   => RESERVED
  *      0 != (kount & 0x0200)   => FIELD BUFFER NOT YET CHECKED
  *      0 != (kount & 0x0100)   => BUFFER HAS TWO EXTRA BYTES - WHY?
  */
@@ -2408,19 +2835,14 @@ return retcode;
 void
 easycap_complete(struct urb *purb)
 {
-static int mt;
 struct easycap *peasycap;
 struct data_buffer *pfield_buffer;
 char errbuf[16];
 int i, more, much, leap, rc, last;
 int videofieldamount;
-unsigned int override;
+unsigned int override, bad;
 int framestatus, framelength, frameactual, frameoffset;
 __u8 *pu;
-#if defined(BRIDGER)
-struct timeval timeval;
-long long usec;
-#endif /*BRIDGER*/
 
 if (NULL == purb) {
        SAY("ERROR: easycap_complete(): purb is NULL\n");
@@ -2431,74 +2853,78 @@ if (NULL == peasycap) {
        SAY("ERROR: easycap_complete(): peasycap is NULL\n");
        return;
 }
-
+if (memcmp(&peasycap->telltale[0], TELLTALE, strlen(TELLTALE))) {
+       SAY("ERROR: bad peasycap: 0x%08lX\n", (unsigned long int) peasycap);
+       return;
+}
 if (peasycap->video_eof)
        return;
-
 for (i = 0; i < VIDEO_ISOC_BUFFER_MANY; i++)
        if (purb->transfer_buffer == peasycap->video_isoc_buffer[i].pgo)
                break;
-JOT(16, "%2i=urb\n", i);
+JOM(16, "%2i=urb\n", i);
 last = peasycap->video_isoc_sequence;
 if ((((VIDEO_ISOC_BUFFER_MANY - 1) == last) && \
                                                (0 != i)) || \
        (((VIDEO_ISOC_BUFFER_MANY - 1) != last) && \
                                                ((last + 1) != i))) {
-       SAY("ERROR: out-of-order urbs %i,%i ... continuing\n", last, i);
+       JOM(16, "ERROR: out-of-order urbs %i,%i ... continuing\n", last, i);
 }
 peasycap->video_isoc_sequence = i;
 
 if (peasycap->video_idle) {
-       JOT(16, "%i=video_idle  %i=video_isoc_streaming\n", \
+       JOM(16, "%i=video_idle  %i=video_isoc_streaming\n", \
                        peasycap->video_idle, peasycap->video_isoc_streaming);
        if (peasycap->video_isoc_streaming) {
                rc = usb_submit_urb(purb, GFP_ATOMIC);
                if (0 != rc) {
-                       SAY("ERROR: while %i=video_idle, " \
-                                       "usb_submit_urb() failed with rc:\n", \
-                                                       peasycap->video_idle);
                        switch (rc) {
                        case -ENOMEM: {
-                               SAY("ENOMEM\n");
+                               SAM("ENOMEM\n");
                                break;
                        }
                        case -ENODEV: {
-                               SAY("ENODEV\n");
+                               SAM("ENODEV\n");
                                break;
                        }
                        case -ENXIO: {
-                               SAY("ENXIO\n");
+                               SAM("ENXIO\n");
                                break;
                        }
                        case -EINVAL: {
-                               SAY("EINVAL\n");
+                               SAM("EINVAL\n");
                                break;
                        }
                        case -EAGAIN: {
-                               SAY("EAGAIN\n");
+                               SAM("EAGAIN\n");
                                break;
                        }
                        case -EFBIG: {
-                               SAY("EFBIG\n");
+                               SAM("EFBIG\n");
                                break;
                        }
                        case -EPIPE: {
-                               SAY("EPIPE\n");
+                               SAM("EPIPE\n");
                                break;
                        }
                        case -EMSGSIZE: {
-                               SAY("EMSGSIZE\n");
+                               SAM("EMSGSIZE\n");
                                break;
                        }
                        case -ENOSPC: {
-                               SAY("ENOSPC\n");
+                               SAM("ENOSPC\n");
                                break;
                        }
                        default: {
-                               SAY("0x%08X\n", rc);
+                               SAM("0x%08X\n", rc);
                                break;
                        }
                        }
+                       if (-ENODEV != rc) \
+                               SAM("ERROR: while %i=video_idle, " \
+                                                       "usb_submit_urb() " \
+                                                       "failed with rc:\n", \
+                                                       peasycap->video_idle);
                }
        }
 return;
@@ -2506,80 +2932,80 @@ return;
 override = 0;
 /*---------------------------------------------------------------------------*/
 if (FIELD_BUFFER_MANY <= peasycap->field_fill) {
-       SAY("ERROR: bad peasycap->field_fill\n");
+       SAM("ERROR: bad peasycap->field_fill\n");
        return;
 }
 if (purb->status) {
        if ((-ESHUTDOWN == purb->status) || (-ENOENT == purb->status)) {
-               JOT(8, "urb status -ESHUTDOWN or -ENOENT\n");
+               JOM(8, "urb status -ESHUTDOWN or -ENOENT\n");
                return;
        }
 
        (peasycap->field_buffer[peasycap->field_fill][0].kount) |= 0x8000 ;
-       SAY("ERROR: bad urb status:\n");
+       SAM("ERROR: bad urb status:\n");
        switch (purb->status) {
        case -EINPROGRESS: {
-               SAY("-EINPROGRESS\n"); break;
+               SAM("-EINPROGRESS\n"); break;
        }
        case -ENOSR: {
-               SAY("-ENOSR\n"); break;
+               SAM("-ENOSR\n"); break;
        }
        case -EPIPE: {
-               SAY("-EPIPE\n"); break;
+               SAM("-EPIPE\n"); break;
        }
        case -EOVERFLOW: {
-               SAY("-EOVERFLOW\n"); break;
+               SAM("-EOVERFLOW\n"); break;
        }
        case -EPROTO: {
-               SAY("-EPROTO\n"); break;
+               SAM("-EPROTO\n"); break;
        }
        case -EILSEQ: {
-               SAY("-EILSEQ\n"); break;
+               SAM("-EILSEQ\n"); break;
        }
        case -ETIMEDOUT: {
-               SAY("-ETIMEDOUT\n"); break;
+               SAM("-ETIMEDOUT\n"); break;
        }
        case -EMSGSIZE: {
-               SAY("-EMSGSIZE\n"); break;
+               SAM("-EMSGSIZE\n"); break;
        }
        case -EOPNOTSUPP: {
-               SAY("-EOPNOTSUPP\n"); break;
+               SAM("-EOPNOTSUPP\n"); break;
        }
        case -EPFNOSUPPORT: {
-               SAY("-EPFNOSUPPORT\n"); break;
+               SAM("-EPFNOSUPPORT\n"); break;
        }
        case -EAFNOSUPPORT: {
-               SAY("-EAFNOSUPPORT\n"); break;
+               SAM("-EAFNOSUPPORT\n"); break;
        }
        case -EADDRINUSE: {
-               SAY("-EADDRINUSE\n"); break;
+               SAM("-EADDRINUSE\n"); break;
        }
        case -EADDRNOTAVAIL: {
-               SAY("-EADDRNOTAVAIL\n"); break;
+               SAM("-EADDRNOTAVAIL\n"); break;
        }
        case -ENOBUFS: {
-               SAY("-ENOBUFS\n"); break;
+               SAM("-ENOBUFS\n"); break;
        }
        case -EISCONN: {
-               SAY("-EISCONN\n"); break;
+               SAM("-EISCONN\n"); break;
        }
        case -ENOTCONN: {
-               SAY("-ENOTCONN\n"); break;
+               SAM("-ENOTCONN\n"); break;
        }
        case -ESHUTDOWN: {
-               SAY("-ESHUTDOWN\n"); break;
+               SAM("-ESHUTDOWN\n"); break;
        }
        case -ENOENT: {
-               SAY("-ENOENT\n"); break;
+               SAM("-ENOENT\n"); break;
        }
        case -ECONNRESET: {
-               SAY("-ECONNRESET\n"); break;
+               SAM("-ECONNRESET\n"); break;
        }
        case -ENOSPC: {
-               SAY("ENOSPC\n"); break;
+               SAM("ENOSPC\n"); break;
        }
        default: {
-               SAY("unknown error code 0x%08X\n", purb->status); break;
+               SAM("unknown error code 0x%08X\n", purb->status); break;
        }
        }
 /*---------------------------------------------------------------------------*/
@@ -2638,7 +3064,7 @@ if (purb->status) {
                                strcpy(&errbuf[0], "-ECONNRESET"); break;
                        }
                        case -ENOSPC: {
-                               SAY("ENOSPC\n"); break;
+                               SAM("ENOSPC\n"); break;
                        }
                        case -ESHUTDOWN: {
                                strcpy(&errbuf[0], "-ESHUTDOWN"); break;
@@ -2653,7 +3079,7 @@ if (purb->status) {
                frameactual = purb->iso_frame_desc[i].actual_length;
                frameoffset = purb->iso_frame_desc[i].offset;
 
-               JOT(16, "frame[%2i]:" \
+               JOM(16, "frame[%2i]:" \
                                "%4i=status "  \
                                "%4i=actual "  \
                                "%4i=length "  \
@@ -2667,19 +3093,20 @@ if (purb->status) {
                                PAGE_SIZE) + \
                                (int)(pfield_buffer->pto - pfield_buffer->pgo);
                if (4 == more)
-                       mt++;
+                       peasycap->video_mt++;
                if (4 < more) {
-                       if (mt) {
-                               JOT(8, "%4i empty video urb frames\n", mt);
-                               mt = 0;
+                       if (peasycap->video_mt) {
+                               JOM(8, "%4i empty video urb frames\n", \
+                                                       peasycap->video_mt);
+                               peasycap->video_mt = 0;
                        }
                        if (FIELD_BUFFER_MANY <= peasycap->field_fill) {
-                               SAY("ERROR: bad peasycap->field_fill\n");
+                               SAM("ERROR: bad peasycap->field_fill\n");
                                return;
                        }
                        if (FIELD_BUFFER_SIZE/PAGE_SIZE <= \
                                                        peasycap->field_page) {
-                               SAY("ERROR: bad peasycap->field_page\n");
+                               SAM("ERROR: bad peasycap->field_page\n");
                                return;
                        }
                        pfield_buffer = &peasycap->field_buffer\
@@ -2712,11 +3139,13 @@ if (purb->status) {
                                                peasycap->videofieldamount) {
                                        if (2 == videofieldamount - \
                                                        peasycap->\
-                                                       videofieldamount)
+                                                       videofieldamount) {
                                                (peasycap->field_buffer\
                                                [peasycap->field_fill]\
                                                        [0].kount) |= 0x0100;
-                                       else
+                                               peasycap->video_junk += (1 + \
+                                                       VIDEO_JUNK_TOLERATE);
+                                       } else
                                                (peasycap->field_buffer\
                                                [peasycap->field_fill]\
                                                        [0].kount) |= 0x4000;
@@ -2727,53 +3156,74 @@ if (purb->status) {
                                                [peasycap->field_fill]\
                                                        [0].kount) |= 0x2000;
                                        }
-                               if (!(0xFF00 & peasycap->field_buffer\
+                                       bad = 0xFF00 & peasycap->field_buffer\
                                                [peasycap->field_fill]\
-                                               [0].kount)) {
-                                       (peasycap->video_junk)--;
-                                       if (-16 > peasycap->video_junk)
-                                               peasycap->video_junk = -16;
-                                       peasycap->field_read = \
+                                               [0].kount;
+                                       if (!bad) {
+                                               (peasycap->video_junk)--;
+                                               if (-VIDEO_JUNK_TOLERATE > \
+                                                       peasycap->video_junk) \
+                                                       peasycap->video_junk =\
+                                                       -VIDEO_JUNK_TOLERATE;
+                                               peasycap->field_read = \
                                                        (peasycap->\
                                                                field_fill)++;
-
-                                       if (FIELD_BUFFER_MANY <= \
-                                               peasycap->field_fill)
-                                               peasycap->field_fill = 0;
-                                       peasycap->field_page = 0;
-                                       pfield_buffer = &peasycap->\
-                                               field_buffer\
-                                               [peasycap->field_fill]\
-                                               [peasycap->field_page];
-                                       pfield_buffer->pto = \
+                                               if (FIELD_BUFFER_MANY <= \
+                                                               peasycap->\
+                                                               field_fill)
+                                                       peasycap->\
+                                                               field_fill = 0;
+                                               peasycap->field_page = 0;
+                                               pfield_buffer = &peasycap->\
+                                                       field_buffer\
+                                                       [peasycap->\
+                                                       field_fill]\
+                                                       [peasycap->\
+                                                       field_page];
+                                               pfield_buffer->pto = \
                                                        pfield_buffer->pgo;
-
-                                       JOT(8, "bumped to: %i=peasycap->" \
-                                               "field_fill  %i=parity\n", \
-                                               peasycap->field_fill, \
-                                               0x00FF & pfield_buffer->kount);
-                                       JOT(8, "field buffer %i has %i " \
-                                               "bytes fit to be read\n", \
-                                               peasycap->field_read, \
-                                               videofieldamount);
-                                       JOT(8, "wakeup call to wq_video, " \
-                                               "%i=field_read %i=field_fill "\
-                                               "%i=parity\n", \
-                                               peasycap->field_read, \
-                                               peasycap->field_fill, \
-                                               0x00FF & peasycap->\
-                                               field_buffer[peasycap->\
-                                               field_read][0].kount);
-                                       wake_up_interruptible(&(peasycap->\
-                                                               wq_video));
-                                       do_gettimeofday(&peasycap->timeval7);
+                                               JOM(8, "bumped to: %i="\
+                                                       "peasycap->" \
+                                                       "field_fill  %i="\
+                                                       "parity\n", \
+                                                       peasycap->field_fill, \
+                                                       0x00FF & \
+                                                       pfield_buffer->kount);
+                                               JOM(8, "field buffer %i has "\
+                                                       "%i bytes fit to be "\
+                                                       "read\n", \
+                                                       peasycap->field_read, \
+                                                       videofieldamount);
+                                               JOM(8, "wakeup call to "\
+                                                       "wq_video, " \
+                                                       "%i=field_read "\
+                                                       "%i=field_fill "\
+                                                       "%i=parity\n", \
+                                                       peasycap->field_read, \
+                                                       peasycap->field_fill, \
+                                                       0x00FF & peasycap->\
+                                                       field_buffer\
+                                                       [peasycap->\
+                                                       field_read][0].kount);
+                                               wake_up_interruptible\
+                                                       (&(peasycap->\
+                                                                wq_video));
+                                               do_gettimeofday\
+                                                       (&peasycap->timeval7);
                                        } else {
                                        peasycap->video_junk++;
-                                       JOT(8, "field buffer %i had %i " \
-                                               "bytes, now discarded\n", \
+                                       if (bad & 0x0010) \
+                                               peasycap->video_junk += \
+                                               (1 + VIDEO_JUNK_TOLERATE/2);
+                                       JOM(8, "field buffer %i had %i " \
+                                               "bytes, now discarded: "\
+                                               "0x%04X\n", \
                                                peasycap->field_fill, \
-                                               videofieldamount);
-
+                                               videofieldamount,\
+                                               (0xFF00 & \
+                                               peasycap->field_buffer\
+                                               [peasycap->field_fill][0].\
+                                               kount));
                                        (peasycap->field_fill)++;
 
                                        if (FIELD_BUFFER_MANY <= \
@@ -2787,20 +3237,22 @@ if (purb->status) {
                                        pfield_buffer->pto = \
                                                        pfield_buffer->pgo;
 
-                                       JOT(8, "bumped to: %i=peasycap->" \
+                                       JOM(8, "bumped to: %i=peasycap->" \
                                                "field_fill  %i=parity\n", \
                                                peasycap->field_fill, \
                                                0x00FF & pfield_buffer->kount);
                                }
                                if (8 == more) {
-                                       JOT(8, "end-of-field: received " \
+                                       JOM(8, "end-of-field: received " \
                                                "parity byte 0x%02X\n", \
                                                (0xFF & *pu));
                                        if (0x40 & *pu)
                                                pfield_buffer->kount = 0x0000;
                                        else
                                                pfield_buffer->kount = 0x0001;
-                                       JOT(8, "end-of-field: 0x%02X=kount\n",\
+                                       pfield_buffer->input = 0x08 | \
+                                               (0x07 & peasycap->input);
+                                       JOM(8, "end-of-field: 0x%02X=kount\n",\
                                                0xFF & pfield_buffer->kount);
                                }
                        }
@@ -2813,12 +3265,12 @@ if (purb->status) {
                        more -= leap;
 
                        if (FIELD_BUFFER_MANY <= peasycap->field_fill) {
-                               SAY("ERROR: bad peasycap->field_fill\n");
+                               SAM("ERROR: bad peasycap->field_fill\n");
                                return;
                        }
                        if (FIELD_BUFFER_SIZE/PAGE_SIZE <= \
                                                        peasycap->field_page) {
-                               SAY("ERROR: bad peasycap->field_page\n");
+                               SAM("ERROR: bad peasycap->field_page\n");
                                return;
                        }
                        pfield_buffer = &peasycap->field_buffer\
@@ -2829,7 +3281,7 @@ if (purb->status) {
                                                [peasycap->field_page];
                                if (PAGE_SIZE < (pfield_buffer->pto - \
                                                        pfield_buffer->pgo)) {
-                                       SAY("ERROR: bad pfield_buffer->pto\n");
+                                       SAM("ERROR: bad pfield_buffer->pto\n");
                                        return;
                                }
                                if (PAGE_SIZE == (pfield_buffer->pto - \
@@ -2837,7 +3289,7 @@ if (purb->status) {
                                        (peasycap->field_page)++;
                                        if (FIELD_BUFFER_SIZE/PAGE_SIZE <= \
                                                        peasycap->field_page) {
-                                               JOT(16, "wrapping peasycap->" \
+                                               JOM(16, "wrapping peasycap->" \
                                                        "field_page\n");
                                                peasycap->field_page = 0;
                                        }
@@ -2847,6 +3299,15 @@ if (purb->status) {
                                                        [peasycap->field_page];
                                        pfield_buffer->pto = \
                                                        pfield_buffer->pgo;
+                                       pfield_buffer->input = 0x08 | \
+                                               (0x07 & peasycap->input);
+                                       if ((peasycap->field_buffer[peasycap->\
+                                                       field_fill][0]).\
+                                                               input != \
+                                                       pfield_buffer->input)
+                                               (peasycap->field_buffer\
+                                                       [peasycap->field_fill]\
+                                                       [0]).kount |= 0x1000;
                                }
 
                                much = PAGE_SIZE - (int)(pfield_buffer->pto - \
@@ -2857,61 +3318,12 @@ if (purb->status) {
                                memcpy(pfield_buffer->pto, pu, much);
                                pu += much;
                                (pfield_buffer->pto) += much;
-                               more -= much;
-                               }
-                       }
-               }
-       }
-}
-/*---------------------------------------------------------------------------*/
-/*
- *
- *
- *             *** UNDER DEVELOPMENT/TESTING - NOT READY YET! ***
- *
- *
- *
- *  VIDEOTAPES MAY HAVE BEEN MANUALLY PAUSED AND RESTARTED DURING RECORDING.
- *  THIS CAUSES LOSS OF SYNC, CONFUSING DOWNSTREAM USERSPACE PROGRAMS WHICH
- *  MAY INTERPRET THE INTERRUPTION AS A SYMPTOM OF LATENCY.  TO OVERCOME THIS
- *  THE DRIVER BRIDGES THE HIATUS BY SENDING DUMMY VIDEO FRAMES AT ROUGHLY
- *  THE RIGHT TIME INTERVALS IN THE HOPE OF PERSUADING THE DOWNSTREAM USERSPACE
- *  PROGRAM TO RESUME NORMAL SERVICE WHEN THE INTERRUPTION IS OVER.
- */
-/*---------------------------------------------------------------------------*/
-#if defined(BRIDGER)
-do_gettimeofday(&timeval);
-if (peasycap->timeval7.tv_sec) {
-       usec = 1000000*(timeval.tv_sec  - peasycap->timeval7.tv_sec) + \
-                       (timeval.tv_usec - peasycap->timeval7.tv_usec);
-       if (usec > (peasycap->usec + peasycap->tolerate)) {
-               JOT(8, "bridging hiatus\n");
-               peasycap->video_junk = 0;
-               peasycap->field_buffer[peasycap->field_fill][0].kount |= 0x0400;
-
-               peasycap->field_read = (peasycap->field_fill)++;
-
-               if (FIELD_BUFFER_MANY <= peasycap->field_fill) \
-                                               peasycap->field_fill = 0;
-               peasycap->field_page = 0;
-               pfield_buffer = &peasycap->field_buffer\
-                               [peasycap->field_fill][peasycap->field_page];
-               pfield_buffer->pto = pfield_buffer->pgo;
-
-               JOT(8, "bumped to: %i=peasycap->field_fill  %i=parity\n", \
-                       peasycap->field_fill, 0x00FF & pfield_buffer->kount);
-               JOT(8, "field buffer %i has %i bytes to be overwritten\n", \
-                       peasycap->field_read, videofieldamount);
-               JOT(8, "wakeup call to wq_video, " \
-                       "%i=field_read %i=field_fill %i=parity\n", \
-                       peasycap->field_read, peasycap->field_fill, \
-                       0x00FF & \
-                       peasycap->field_buffer[peasycap->field_read][0].kount);
-               wake_up_interruptible(&(peasycap->wq_video));
-               do_gettimeofday(&peasycap->timeval7);
+                               more -= much;
+                               }
+                       }
+               }
        }
 }
-#endif /*BRIDGER*/
 /*---------------------------------------------------------------------------*/
 /*
  *  RESUBMIT THIS URB, UNLESS A SEVERE PERSISTENT ERROR CONDITION EXISTS.
@@ -2921,51 +3333,57 @@ if (peasycap->timeval7.tv_sec) {
  */
 /*---------------------------------------------------------------------------*/
 if (VIDEO_ISOC_BUFFER_MANY <= peasycap->video_junk) {
-       SAY("easycap driver shutting down on condition green\n");
+       SAM("easycap driver shutting down on condition green\n");
+       peasycap->status = 1;
        peasycap->video_eof = 1;
+       peasycap->video_junk = 0;
+       wake_up_interruptible(&peasycap->wq_video);
+#if !defined(PERSEVERE)
        peasycap->audio_eof = 1;
-       peasycap->video_junk = -VIDEO_ISOC_BUFFER_MANY;
-       wake_up_interruptible(&(peasycap->wq_video));
-       wake_up_interruptible(&(peasycap->wq_audio));
+       wake_up_interruptible(&peasycap->wq_audio);
+#endif /*PERSEVERE*/
        return;
 }
 if (peasycap->video_isoc_streaming) {
        rc = usb_submit_urb(purb, GFP_ATOMIC);
        if (0 != rc) {
-               SAY("ERROR: while %i=video_idle, usb_submit_urb() failed " \
-                                       "with rc:\n", peasycap->video_idle);
                switch (rc) {
                case -ENOMEM: {
-                       SAY("ENOMEM\n"); break;
+                       SAM("ENOMEM\n"); break;
                }
                case -ENODEV: {
-                       SAY("ENODEV\n"); break;
+                       SAM("ENODEV\n"); break;
                }
                case -ENXIO: {
-                       SAY("ENXIO\n"); break;
+                       SAM("ENXIO\n"); break;
                }
                case -EINVAL: {
-                       SAY("EINVAL\n"); break;
+                       SAM("EINVAL\n"); break;
                }
                case -EAGAIN: {
-                       SAY("EAGAIN\n"); break;
+                       SAM("EAGAIN\n"); break;
                }
                case -EFBIG: {
-                       SAY("EFBIG\n"); break;
+                       SAM("EFBIG\n"); break;
                }
                case -EPIPE: {
-                       SAY("EPIPE\n"); break;
+                       SAM("EPIPE\n"); break;
                }
                case -EMSGSIZE: {
-                       SAY("EMSGSIZE\n");  break;
+                       SAM("EMSGSIZE\n");  break;
                }
                case -ENOSPC: {
-                       SAY("ENOSPC\n"); break;
+                       SAM("ENOSPC\n"); break;
                }
                default: {
-                       SAY("0x%08X\n", rc); break;
+                       SAM("0x%08X\n", rc); break;
                }
                }
+               if (-ENODEV != rc) \
+                       SAM("ERROR: while %i=video_idle, " \
+                                               "usb_submit_urb() " \
+                                               "failed with rc:\n", \
+                                               peasycap->video_idle);
        }
 }
 return;
@@ -2977,8 +3395,8 @@ return;
  *                                  FIXME
  *
  *
- *  THIS FUNCTION ASSUMES THAT, ON EACH AND EVERY OCCASION THAT THE DEVICE IS
- *  PHYSICALLY PLUGGED IN, INTERFACE 0 IS PROBED FIRST.
+ *  THIS FUNCTION ASSUMES THAT, ON EACH AND EVERY OCCASION THAT THE EasyCAP
+ *  IS PHYSICALLY PLUGGED IN, INTERFACE 0 IS PROBED FIRST.
  *  IF THIS IS NOT TRUE, THERE IS THE POSSIBILITY OF AN Oops.
  *
  *  THIS HAS NEVER BEEN A PROBLEM IN PRACTICE, BUT SOMETHING SEEMS WRONG HERE.
@@ -2994,7 +3412,7 @@ struct usb_endpoint_descriptor *pepd;
 struct usb_interface_descriptor *pusb_interface_descriptor;
 struct usb_interface_assoc_descriptor *pusb_interface_assoc_descriptor;
 struct urb *purb;
-static struct easycap *peasycap /*=NULL*/;
+struct easycap *peasycap;
 struct data_urb *pdata_urb;
 size_t wMaxPacketSize;
 int ISOCwMaxPacketSize;
@@ -3004,19 +3422,32 @@ int CTRLwMaxPacketSize;
 __u8 bEndpointAddress;
 __u8 ISOCbEndpointAddress;
 __u8 INTbEndpointAddress;
-int isin, i, j, k, m;
+int isin, i, j, k, m, rc;
 __u8 bInterfaceNumber;
 __u8 bInterfaceClass;
 __u8 bInterfaceSubClass;
 void *pbuf;
 int okalt[8], isokalt;
-int okepn[8], isokepn;
-int okmps[8], isokmps;
+int okepn[8];
+int okmps[8];
 int maxpacketsize;
-int rc;
+__u16 mask;
+__s32 value;
+struct easycap_format *peasycap_format;
 
 JOT(4, "\n");
 
+if (!dongle_done) {
+       dongle_done = 1;
+       for (k = 0; k < DONGLE_MANY; k++) {
+               easycap_dongle[k].peasycap = (struct easycap *)NULL;
+               mutex_init(&easycap_dongle[k].mutex_video);
+               mutex_init(&easycap_dongle[k].mutex_audio);
+       }
+}
+
+peasycap = (struct easycap *)NULL;
+
 if ((struct usb_interface *)NULL == pusb_interface) {
        SAY("ERROR: pusb_interface is NULL\n");
        return -EFAULT;
@@ -3117,46 +3548,83 @@ JOT(4, "intf[%i]: pusb_interface_assoc_descriptor is NULL\n", \
 /*
  *  A NEW struct easycap IS ALWAYS ALLOCATED WHEN INTERFACE 0 IS PROBED.
  *  IT IS NOT POSSIBLE HERE TO FREE ANY EXISTING struct easycap.  THIS
- *  SHOULD HAVE BEEN DONE BY easycap_delete() WHEN THE DEVICE WAS PHYSICALLY
- *  UNPLUGGED.
- */
+ *  SHOULD HAVE BEEN DONE BY easycap_delete() WHEN THE EasyCAP WAS
+ *  PHYSICALLY UNPLUGGED.
+ *
+ *  THE POINTER peasycap TO THE struct easycap IS REMEMBERED WHEN
+ *  INTERFACES 1 AND 2 ARE PROBED.
+ *
+ *  IF TWO EasyCAPs ARE PLUGGED IN NEARLY SIMULTANEOUSLY THERE WILL
+ *  BE TROUBLE.  BEWARE.
+*/
 /*---------------------------------------------------------------------------*/
 if (0 == bInterfaceNumber) {
        peasycap = kzalloc(sizeof(struct easycap), GFP_KERNEL);
        if (NULL == peasycap) {
                SAY("ERROR: Could not allocate peasycap\n");
                return -ENOMEM;
-       } else {
-               peasycap->allocation_video_struct = sizeof(struct easycap);
-               peasycap->allocation_video_page = 0;
-               peasycap->allocation_video_urb = 0;
-               peasycap->allocation_audio_struct = 0;
-               peasycap->allocation_audio_page = 0;
-               peasycap->allocation_audio_urb = 0;
        }
+       SAM("allocated 0x%08lX=peasycap\n", (unsigned long int) peasycap);
+/*vvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvv*/
+#if defined(EASYCAP_IS_VIDEODEV_CLIENT)
+       SAM("where     0x%08lX=&peasycap->video_device\n", \
+                               (unsigned long int) &peasycap->video_device);
+#if defined(EASYCAP_NEEDS_V4L2_DEVICE_H)
+       SAM("and       0x%08lX=&peasycap->v4l2_device\n", \
+                               (unsigned long int) &peasycap->v4l2_device);
+#endif /*EASYCAP_NEEDS_V4L2_DEVICE_H*/
+#endif /*EASYCAP_IS_VIDEODEV_CLIENT*/
+/*^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^*/
 /*---------------------------------------------------------------------------*/
 /*
- *  INITIALIZE THE NEW easycap STRUCTURE.
- *  NO PARAMETERS ARE SPECIFIED HERE REQUIRING THE SETTING OF REGISTERS.
- *  THAT IS DONE FIRST BY easycap_open() AND LATER BY easycap_ioctl().
- */
+ *  PERFORM URGENT INTIALIZATIONS ...
+*/
 /*---------------------------------------------------------------------------*/
-       peasycap->pusb_device = pusb_device;
-       peasycap->pusb_interface = pusb_interface;
-
+       strcpy(&peasycap->telltale[0], TELLTALE);
        kref_init(&peasycap->kref);
-       JOT(8, "intf[%i]: after kref_init(..._video) " \
+       JOM(8, "intf[%i]: after kref_init(..._video) " \
                        "%i=peasycap->kref.refcount.counter\n", \
                        bInterfaceNumber, peasycap->kref.refcount.counter);
 
-       init_waitqueue_head(&(peasycap->wq_video));
-       init_waitqueue_head(&(peasycap->wq_audio));
+       init_waitqueue_head(&peasycap->wq_video);
+       init_waitqueue_head(&peasycap->wq_audio);
+
+       for (dongle_this = 0; dongle_this < DONGLE_MANY; dongle_this++) {
+               if (NULL == easycap_dongle[dongle_this].peasycap) {
+                       if (0 == mutex_is_locked(&easycap_dongle\
+                                               [dongle_this].mutex_video)) {
+                               if (0 == mutex_is_locked(&easycap_dongle\
+                                               [dongle_this].mutex_audio)) {
+                                       easycap_dongle\
+                                               [dongle_this].peasycap = \
+                                                               peasycap;
+                                       JOM(8, "intf[%i]: peasycap-->easycap" \
+                                               "_dongle[%i].peasycap\n", \
+                                               bInterfaceNumber, dongle_this);
+                                       break;
+                               }
+                       }
+               }
+       }
+       if (DONGLE_MANY <= dongle_this) {
+               SAM("ERROR: too many dongles\n");
+               return -ENOMEM;
+       }
 
-       mutex_init(&(peasycap->mutex_timeval0));
-       mutex_init(&(peasycap->mutex_timeval1));
+       peasycap->allocation_video_struct = sizeof(struct easycap);
+       peasycap->allocation_video_page = 0;
+       peasycap->allocation_video_urb = 0;
+       peasycap->allocation_audio_struct = 0;
+       peasycap->allocation_audio_page = 0;
+       peasycap->allocation_audio_urb = 0;
 
-       for (k = 0; k < FRAME_BUFFER_MANY; k++)
-               mutex_init(&(peasycap->mutex_mmap_video[k]));
+/*---------------------------------------------------------------------------*/
+/*
+ *  ... AND FURTHER INITIALIZE THE STRUCTURE
+*/
+/*---------------------------------------------------------------------------*/
+       peasycap->pusb_device = pusb_device;
+       peasycap->pusb_interface = pusb_interface;
 
        peasycap->ilk = 0;
        peasycap->microphone = false;
@@ -3177,46 +3645,172 @@ if (0 == bInterfaceNumber) {
 
        peasycap->frame_buffer_many = FRAME_BUFFER_MANY;
 
-       if ((struct mutex *)NULL == &(peasycap->mutex_mmap_video[0])) {
-               SAY("ERROR: &(peasycap->mutex_mmap_video[%i]) is NULL\n", 0);
-               return -EFAULT;
-       }
+       for (k = 0; k < INPUT_MANY; k++)
+               peasycap->lost[k] = 0;
+       peasycap->skip = 0;
+       peasycap->skipped = 0;
+       peasycap->offerfields = 0;
 /*---------------------------------------------------------------------------*/
 /*
- *  DYNAMICALLY FILL IN THE AVAILABLE FORMATS.
+ *  DYNAMICALLY FILL IN THE AVAILABLE FORMATS ...
  */
 /*---------------------------------------------------------------------------*/
        rc = fillin_formats();
        if (0 > rc) {
-               SAY("ERROR: fillin_formats() returned %i\n", rc);
+               SAM("ERROR: fillin_formats() returned %i\n", rc);
                return -EFAULT;
        }
-       JOT(4, "%i formats available\n", rc);
-       } else {
+       JOM(4, "%i formats available\n", rc);
 /*---------------------------------------------------------------------------*/
-               if ((struct easycap *)NULL == peasycap) {
-                       SAY("ERROR: peasycap is NULL " \
-                                       "when probing interface %i\n", \
-                                                       bInterfaceNumber);
-                       return -EFAULT;
+/*
+ *  ... AND POPULATE easycap.inputset[]
+*/
+/*---------------------------------------------------------------------------*/
+       for (k = 0; k < INPUT_MANY; k++) {
+               peasycap->inputset[k].input_ok = 0;
+               peasycap->inputset[k].standard_offset_ok = 0;
+               peasycap->inputset[k].format_offset_ok = 0;
+               peasycap->inputset[k].brightness_ok = 0;
+               peasycap->inputset[k].contrast_ok = 0;
+               peasycap->inputset[k].saturation_ok = 0;
+               peasycap->inputset[k].hue_ok = 0;
+       }
+       if (true == peasycap->ntsc) {
+               i = 0;
+               m = 0;
+               mask = 0;
+               while (0xFFFF != easycap_standard[i].mask) {
+                       if (NTSC_M == easycap_standard[i].\
+                                                       v4l2_standard.index) {
+                               m++;
+                               for (k = 0; k < INPUT_MANY; k++) {
+                                       peasycap->inputset[k].\
+                                                       standard_offset = i;
+                               }
+                       mask = easycap_standard[i].mask;
+                       }
+                       i++;
+               }
+       } else {
+               i = 0;
+               m = 0;
+               mask = 0;
+               while (0xFFFF != easycap_standard[i].mask) {
+                       if (PAL_BGHIN == easycap_standard[i].\
+                                                       v4l2_standard.index) {
+                               m++;
+                               for (k = 0; k < INPUT_MANY; k++) {
+                                       peasycap->inputset[k].\
+                                                       standard_offset = i;
+                               }
+                       mask = easycap_standard[i].mask;
+                       }
+                       i++;
                }
+       }
 
-       JOT(8, "kref_get() with %i=peasycap->kref.refcount.counter\n", \
-                                       (int)peasycap->kref.refcount.counter);
-       kref_get(&peasycap->kref);
+       if (1 != m) {
+               SAM("MISTAKE: easycap.inputset[].standard_offset " \
+                                               "unpopulated, %i=m\n", m);
+               return -ENOENT;
+       }
+
+       peasycap_format = &easycap_format[0];
+       i = 0;
+       m = 0;
+       while (0 != peasycap_format->v4l2_format.fmt.pix.width) {
+               if (((peasycap_format->mask & 0x0F) == (mask & 0x0F)) && \
+                               (peasycap_format->\
+                                       v4l2_format.fmt.pix.field == \
+                                                       V4L2_FIELD_NONE) && \
+                               (peasycap_format->\
+                                       v4l2_format.fmt.pix.pixelformat == \
+                                                       V4L2_PIX_FMT_UYVY) && \
+                               (peasycap_format->\
+                                       v4l2_format.fmt.pix.width  == \
+                                                       640) && \
+                               (peasycap_format->\
+                                       v4l2_format.fmt.pix.height == 480)) {
+                       m++;
+                       for (k = 0; k < INPUT_MANY; k++)
+                               peasycap->inputset[k].format_offset = i;
+                       break;
+               }
+       peasycap_format++;
+       i++;
+       }
+       if (1 != m) {
+               SAM("MISTAKE: easycap.inputset[].format_offset unpopulated\n");
+       return -ENOENT;
+       }
+
+       i = 0;
+       m = 0;
+       while (0xFFFFFFFF != easycap_control[i].id) {
+               value = easycap_control[i].default_value;
+               if (V4L2_CID_BRIGHTNESS == easycap_control[i].id) {
+                       m++;
+                       for (k = 0; k < INPUT_MANY; k++)
+                               peasycap->inputset[k].brightness = value;
+               } else if (V4L2_CID_CONTRAST == easycap_control[i].id) {
+                       m++;
+                       for (k = 0; k < INPUT_MANY; k++)
+                               peasycap->inputset[k].contrast = value;
+               } else if (V4L2_CID_SATURATION == easycap_control[i].id) {
+                       m++;
+                       for (k = 0; k < INPUT_MANY; k++)
+                               peasycap->inputset[k].saturation = value;
+               } else if (V4L2_CID_HUE == easycap_control[i].id) {
+                       m++;
+                       for (k = 0; k < INPUT_MANY; k++)
+                               peasycap->inputset[k].hue = value;
+               }
+               i++;
+       }
+       if (4 != m) {
+               SAM("MISTAKE: easycap.inputset[].brightness,... " \
+                                               "underpopulated\n");
+               return -ENOENT;
+       }
+       for (k = 0; k < INPUT_MANY; k++)
+               peasycap->inputset[k].input = k;
+       JOM(4, "populated easycap.inputset[]\n");
+       JOM(4, "finished initialization\n");
+} else {
+/*---------------------------------------------------------------------------*/
+       /*
+        *  FOR INTERFACES 1 AND 2 THE POINTER peasycap IS OBTAINED BY ASSUMING
+        *  THAT dongle_this HAS NOT CHANGED SINCE INTERFACE 0 WAS PROBED.  IF
+        *  THIS IS NOT THE CASE, FOR EXAMPLE WHEN TWO EASYCAPs ARE PLUGGED IN
+        *  SIMULTANEOUSLY, THERE WILL BE SERIOUS TROUBLE.
+       */
+/*---------------------------------------------------------------------------*/
+       if ((0 > dongle_this) || (DONGLE_MANY <= dongle_this)) {
+               SAY("ERROR: bad dongle count\n");
+               return -EFAULT;
+       }
+       peasycap = easycap_dongle[dongle_this].peasycap;
+       JOT(8, "intf[%i]: easycap_dongle[%i].peasycap-->peasycap\n", \
+                                               bInterfaceNumber, dongle_this);
+
+       if ((struct easycap *)NULL == peasycap) {
+               SAY("ERROR: peasycap is NULL when probing interface %i\n", \
+                                                       bInterfaceNumber);
+               return -EFAULT;
+       }
 }
 /*---------------------------------------------------------------------------*/
 if ((USB_CLASS_VIDEO == bInterfaceClass) || \
-       (USB_CLASS_VENDOR_SPEC == bInterfaceClass)) {
+               (USB_CLASS_VENDOR_SPEC == bInterfaceClass)) {
        if (-1 == peasycap->video_interface) {
                peasycap->video_interface = bInterfaceNumber;
-               JOT(4, "setting peasycap->video_interface=%i\n", \
+               JOM(4, "setting peasycap->video_interface=%i\n", \
                                                peasycap->video_interface);
        } else {
                if (peasycap->video_interface != bInterfaceNumber) {
-                       SAY("ERROR: attempting to reset " \
+                       SAM("ERROR: attempting to reset " \
                                        "peasycap->video_interface\n");
-                       SAY("...... continuing with " \
+                       SAM("...... continuing with " \
                                        "%i=peasycap->video_interface\n", \
                                        peasycap->video_interface);
                }
@@ -3225,13 +3819,13 @@ if ((USB_CLASS_VIDEO == bInterfaceClass) || \
                                                (0x02 == bInterfaceSubClass)) {
        if (-1 == peasycap->audio_interface) {
                peasycap->audio_interface = bInterfaceNumber;
-               JOT(4, "setting peasycap->audio_interface=%i\n", \
+               JOM(4, "setting peasycap->audio_interface=%i\n", \
                                                 peasycap->audio_interface);
        } else {
                if (peasycap->audio_interface != bInterfaceNumber) {
-                       SAY("ERROR: attempting to reset " \
+                       SAM("ERROR: attempting to reset " \
                                        "peasycap->audio_interface\n");
-                       SAY("...... continuing with " \
+                       SAM("...... continuing with " \
                                        "%i=peasycap->audio_interface\n", \
                                        peasycap->audio_interface);
                }
@@ -3244,37 +3838,35 @@ if ((USB_CLASS_VIDEO == bInterfaceClass) || \
  */
 /*---------------------------------------------------------------------------*/
 isokalt = 0;
-isokepn = 0;
-isokmps = 0;
 
 for (i = 0; i < pusb_interface->num_altsetting; i++) {
        pusb_host_interface = &(pusb_interface->altsetting[i]);
        if ((struct usb_host_interface *)NULL == pusb_host_interface) {
-               SAY("ERROR: pusb_host_interface is NULL\n");
+               SAM("ERROR: pusb_host_interface is NULL\n");
                return -EFAULT;
        }
        pusb_interface_descriptor = &(pusb_host_interface->desc);
        if ((struct usb_interface_descriptor *)NULL == \
                                                pusb_interface_descriptor) {
-               SAY("ERROR: pusb_interface_descriptor is NULL\n");
+               SAM("ERROR: pusb_interface_descriptor is NULL\n");
                return -EFAULT;
        }
 
-       JOT(4, "intf[%i]alt[%i]: desc.bDescriptorType=0x%02X\n", \
+       JOM(4, "intf[%i]alt[%i]: desc.bDescriptorType=0x%02X\n", \
        bInterfaceNumber, i, pusb_interface_descriptor->bDescriptorType);
-       JOT(4, "intf[%i]alt[%i]: desc.bInterfaceNumber=0x%02X\n", \
+       JOM(4, "intf[%i]alt[%i]: desc.bInterfaceNumber=0x%02X\n", \
        bInterfaceNumber, i, pusb_interface_descriptor->bInterfaceNumber);
-       JOT(4, "intf[%i]alt[%i]: desc.bAlternateSetting=0x%02X\n", \
+       JOM(4, "intf[%i]alt[%i]: desc.bAlternateSetting=0x%02X\n", \
        bInterfaceNumber, i, pusb_interface_descriptor->bAlternateSetting);
-       JOT(4, "intf[%i]alt[%i]: desc.bNumEndpoints=0x%02X\n", \
+       JOM(4, "intf[%i]alt[%i]: desc.bNumEndpoints=0x%02X\n", \
        bInterfaceNumber, i, pusb_interface_descriptor->bNumEndpoints);
-       JOT(4, "intf[%i]alt[%i]: desc.bInterfaceClass=0x%02X\n", \
+       JOM(4, "intf[%i]alt[%i]: desc.bInterfaceClass=0x%02X\n", \
        bInterfaceNumber, i, pusb_interface_descriptor->bInterfaceClass);
-       JOT(4, "intf[%i]alt[%i]: desc.bInterfaceSubClass=0x%02X\n", \
+       JOM(4, "intf[%i]alt[%i]: desc.bInterfaceSubClass=0x%02X\n", \
        bInterfaceNumber, i, pusb_interface_descriptor->bInterfaceSubClass);
-       JOT(4, "intf[%i]alt[%i]: desc.bInterfaceProtocol=0x%02X\n", \
+       JOM(4, "intf[%i]alt[%i]: desc.bInterfaceProtocol=0x%02X\n", \
        bInterfaceNumber, i, pusb_interface_descriptor->bInterfaceProtocol);
-       JOT(4, "intf[%i]alt[%i]: desc.iInterface=0x%02X\n", \
+       JOM(4, "intf[%i]alt[%i]: desc.iInterface=0x%02X\n", \
        bInterfaceNumber, i, pusb_interface_descriptor->iInterface);
 
        ISOCwMaxPacketSize = -1;
@@ -3285,86 +3877,80 @@ for (i = 0; i < pusb_interface->num_altsetting; i++) {
        INTbEndpointAddress = 0;
 
        if (0 == pusb_interface_descriptor->bNumEndpoints)
-                               JOT(4, "intf[%i]alt[%i] has no endpoints\n", \
+                               JOM(4, "intf[%i]alt[%i] has no endpoints\n", \
                                                        bInterfaceNumber, i);
 /*---------------------------------------------------------------------------*/
        for (j = 0; j < pusb_interface_descriptor->bNumEndpoints; j++) {
                pepd = &(pusb_host_interface->endpoint[j].desc);
                if ((struct usb_endpoint_descriptor *)NULL == pepd) {
-                       SAY("ERROR:  pepd is NULL.\n");
-                       SAY("...... skipping\n");
+                       SAM("ERROR:  pepd is NULL.\n");
+                       SAM("...... skipping\n");
                        continue;
                }
                wMaxPacketSize = le16_to_cpu(pepd->wMaxPacketSize);
                bEndpointAddress = pepd->bEndpointAddress;
 
-               JOT(4, "intf[%i]alt[%i]end[%i]: bEndpointAddress=0x%X\n", \
+               JOM(4, "intf[%i]alt[%i]end[%i]: bEndpointAddress=0x%X\n", \
                                bInterfaceNumber, i, j, \
                                pepd->bEndpointAddress);
-               JOT(4, "intf[%i]alt[%i]end[%i]: bmAttributes=0x%X\n", \
+               JOM(4, "intf[%i]alt[%i]end[%i]: bmAttributes=0x%X\n", \
                                bInterfaceNumber, i, j, \
                                pepd->bmAttributes);
-               JOT(4, "intf[%i]alt[%i]end[%i]: wMaxPacketSize=%i\n", \
+               JOM(4, "intf[%i]alt[%i]end[%i]: wMaxPacketSize=%i\n", \
                                bInterfaceNumber, i, j, \
                                pepd->wMaxPacketSize);
-               JOT(4, "intf[%i]alt[%i]end[%i]: bInterval=%i\n",
+               JOM(4, "intf[%i]alt[%i]end[%i]: bInterval=%i\n",
                                bInterfaceNumber, i, j, \
                                pepd->bInterval);
 
                if (pepd->bEndpointAddress & USB_DIR_IN) {
-                       JOT(4, "intf[%i]alt[%i]end[%i] is an  IN  endpoint\n",\
+                       JOM(4, "intf[%i]alt[%i]end[%i] is an  IN  endpoint\n",\
                                                bInterfaceNumber, i, j);
                        isin = 1;
                } else {
-                       JOT(4, "intf[%i]alt[%i]end[%i] is an  OUT endpoint\n",\
+                       JOM(4, "intf[%i]alt[%i]end[%i] is an  OUT endpoint\n",\
                                                bInterfaceNumber, i, j);
-                       SAY("ERROR: OUT endpoint unexpected\n");
-                       SAY("...... continuing\n");
+                       SAM("ERROR: OUT endpoint unexpected\n");
+                       SAM("...... continuing\n");
                        isin = 0;
                }
                if ((pepd->bmAttributes & \
                                USB_ENDPOINT_XFERTYPE_MASK) == \
                                USB_ENDPOINT_XFER_ISOC) {
-                       JOT(4, "intf[%i]alt[%i]end[%i] is an ISOC endpoint\n",\
+                       JOM(4, "intf[%i]alt[%i]end[%i] is an ISOC endpoint\n",\
                                                bInterfaceNumber, i, j);
                        if (isin) {
                                switch (bInterfaceClass) {
                                case USB_CLASS_VIDEO:
                                case USB_CLASS_VENDOR_SPEC: {
                                        if (!peasycap) {
-                                               SAY("MISTAKE: " \
+                                               SAM("MISTAKE: " \
                                                        "peasycap is NULL\n");
                                                return -EFAULT;
                                        }
                                        if (pepd->wMaxPacketSize) {
                                                if (8 > isokalt) {
                                                        okalt[isokalt] = i;
-                                                       JOT(4,\
+                                                       JOM(4,\
                                                        "%i=okalt[%i]\n", \
                                                        okalt[isokalt], \
                                                        isokalt);
-                                                       isokalt++;
-                                               }
-                                               if (8 > isokepn) {
-                                                       okepn[isokepn] = \
+                                                       okepn[isokalt] = \
                                                        pepd->\
                                                        bEndpointAddress & \
                                                        0x0F;
-                                                       JOT(4,\
+                                                       JOM(4,\
                                                        "%i=okepn[%i]\n", \
-                                                       okepn[isokepn], \
-                                                       isokepn);
-                                                       isokepn++;
-                                               }
-                                               if (8 > isokmps) {
-                                                       okmps[isokmps] = \
+                                                       okepn[isokalt], \
+                                                       isokalt);
+                                                       okmps[isokalt] = \
                                                        le16_to_cpu(pepd->\
                                                        wMaxPacketSize);
-                                                       JOT(4,\
+                                                       JOM(4,\
                                                        "%i=okmps[%i]\n", \
-                                                       okmps[isokmps], \
-                                                       isokmps);
-                                                       isokmps++;
+                                                       okmps[isokalt], \
+                                                       isokalt);
+                                                       isokalt++;
                                                }
                                        } else {
                                                if (-1 == peasycap->\
@@ -3372,16 +3958,16 @@ for (i = 0; i < pusb_interface->num_altsetting; i++) {
                                                        peasycap->\
                                                        video_altsetting_off =\
                                                                         i;
-                                                       JOT(4, "%i=video_" \
+                                                       JOM(4, "%i=video_" \
                                                        "altsetting_off " \
                                                                "<====\n", \
                                                        peasycap->\
                                                        video_altsetting_off);
                                                } else {
-                                                       SAY("ERROR: peasycap" \
+                                                       SAM("ERROR: peasycap" \
                                                        "->video_altsetting_" \
                                                        "off already set\n");
-                                                       SAY("...... " \
+                                                       SAM("...... " \
                                                        "continuing with " \
                                                        "%i=peasycap->video_" \
                                                        "altsetting_off\n", \
@@ -3395,39 +3981,33 @@ for (i = 0; i < pusb_interface->num_altsetting; i++) {
                                        if (0x02 != bInterfaceSubClass)
                                                break;
                                        if (!peasycap) {
-                                               SAY("MISTAKE: " \
+                                               SAM("MISTAKE: " \
                                                "peasycap is NULL\n");
                                                return -EFAULT;
                                        }
                                        if (pepd->wMaxPacketSize) {
                                                if (8 > isokalt) {
                                                        okalt[isokalt] = i ;
-                                                       JOT(4,\
+                                                       JOM(4,\
                                                        "%i=okalt[%i]\n", \
                                                        okalt[isokalt], \
                                                        isokalt);
-                                                       isokalt++;
-                                               }
-                                               if (8 > isokepn) {
-                                                       okepn[isokepn] = \
+                                                       okepn[isokalt] = \
                                                        pepd->\
                                                        bEndpointAddress & \
                                                        0x0F;
-                                                       JOT(4,\
+                                                       JOM(4,\
                                                        "%i=okepn[%i]\n", \
-                                                       okepn[isokepn], \
-                                                       isokepn);
-                                                       isokepn++;
-                                               }
-                                               if (8 > isokmps) {
-                                                       okmps[isokmps] = \
+                                                       okepn[isokalt], \
+                                                       isokalt);
+                                                       okmps[isokalt] = \
                                                        le16_to_cpu(pepd->\
                                                        wMaxPacketSize);
-                                                       JOT(4,\
+                                                       JOM(4,\
                                                        "%i=okmps[%i]\n",\
-                                                       okmps[isokmps], \
-                                                       isokmps);
-                                                       isokmps++;
+                                                       okmps[isokalt], \
+                                                       isokalt);
+                                                       isokalt++;
                                                }
                                        } else {
                                                if (-1 == peasycap->\
@@ -3435,16 +4015,16 @@ for (i = 0; i < pusb_interface->num_altsetting; i++) {
                                                        peasycap->\
                                                        audio_altsetting_off =\
                                                                         i;
-                                                       JOT(4, "%i=audio_" \
+                                                       JOM(4, "%i=audio_" \
                                                        "altsetting_off " \
                                                        "<====\n", \
                                                        peasycap->\
                                                        audio_altsetting_off);
                                                } else {
-                                                       SAY("ERROR: peasycap" \
+                                                       SAM("ERROR: peasycap" \
                                                        "->audio_altsetting_" \
                                                        "off already set\n");
-                                                       SAY("...... " \
+                                                       SAM("...... " \
                                                        "continuing with " \
                                                        "%i=peasycap->\
                                                        audio_altsetting_" \
@@ -3462,19 +4042,19 @@ for (i = 0; i < pusb_interface->num_altsetting; i++) {
                } else if ((pepd->bmAttributes & \
                                                USB_ENDPOINT_XFERTYPE_MASK) ==\
                                                USB_ENDPOINT_XFER_BULK) {
-                       JOT(4, "intf[%i]alt[%i]end[%i] is a  BULK endpoint\n",\
+                       JOM(4, "intf[%i]alt[%i]end[%i] is a  BULK endpoint\n",\
                                                bInterfaceNumber, i, j);
                } else if ((pepd->bmAttributes & \
                                                USB_ENDPOINT_XFERTYPE_MASK) ==\
                                                USB_ENDPOINT_XFER_INT) {
-                       JOT(4, "intf[%i]alt[%i]end[%i] is an  INT endpoint\n",\
+                       JOM(4, "intf[%i]alt[%i]end[%i] is an  INT endpoint\n",\
                                                bInterfaceNumber, i, j);
                } else {
-                       JOT(4, "intf[%i]alt[%i]end[%i] is a  CTRL endpoint\n",\
+                       JOM(4, "intf[%i]alt[%i]end[%i] is a  CTRL endpoint\n",\
                                                bInterfaceNumber, i, j);
                }
                if (0 == pepd->wMaxPacketSize) {
-                       JOT(4, "intf[%i]alt[%i]end[%i] " \
+                       JOM(4, "intf[%i]alt[%i]end[%i] " \
                                                "has zero packet size\n", \
                                                bInterfaceNumber, i, j);
                }
@@ -3485,7 +4065,7 @@ for (i = 0; i < pusb_interface->num_altsetting; i++) {
  *  PERFORM INITIALIZATION OF THE PROBED INTERFACE
  */
 /*---------------------------------------------------------------------------*/
-JOT(4, "initialization begins for interface %i\n", \
+JOM(4, "initialization begins for interface %i\n", \
                                pusb_interface_descriptor->bInterfaceNumber);
 switch (bInterfaceNumber) {
 /*---------------------------------------------------------------------------*/
@@ -3495,89 +4075,78 @@ switch (bInterfaceNumber) {
 /*---------------------------------------------------------------------------*/
 case 0: {
        if (!peasycap) {
-               SAY("MISTAKE: peasycap is NULL\n");
+               SAM("MISTAKE: peasycap is NULL\n");
                return -EFAULT;
        }
        if (!isokalt) {
-               SAY("ERROR:  no viable video_altsetting_on\n");
+               SAM("ERROR:  no viable video_altsetting_on\n");
                return -ENOENT;
        } else {
                peasycap->video_altsetting_on = okalt[isokalt - 1];
-               JOT(4, "%i=video_altsetting_on <====\n", \
+               JOM(4, "%i=video_altsetting_on <====\n", \
                                        peasycap->video_altsetting_on);
        }
-       if (!isokepn) {
-               SAY("ERROR:  no viable video_endpointnumber\n");
-               return -ENOENT;
-       } else {
-               peasycap->video_endpointnumber = okepn[isokepn - 1];
-               JOT(4, "%i=video_endpointnumber\n", \
-                                       peasycap->video_endpointnumber);
-               }
-       if (!isokmps) {
-               SAY("ERROR:  no viable video_maxpacketsize\n");
-               return -ENOENT;
 /*---------------------------------------------------------------------------*/
 /*
  *  DECIDE THE VIDEO STREAMING PARAMETERS
  */
 /*---------------------------------------------------------------------------*/
+       peasycap->video_endpointnumber = okepn[isokalt - 1];
+       JOM(4, "%i=video_endpointnumber\n", peasycap->video_endpointnumber);
+       maxpacketsize = okmps[isokalt - 1];
+       if (USB_2_0_MAXPACKETSIZE > maxpacketsize) {
+               peasycap->video_isoc_maxframesize = maxpacketsize;
        } else {
-               maxpacketsize = okmps[isokmps - 1] - 1024;
-               if (USB_2_0_MAXPACKETSIZE > maxpacketsize) {
-                       peasycap->video_isoc_maxframesize = maxpacketsize;
-               } else {
-                       peasycap->video_isoc_maxframesize = \
-                                                       USB_2_0_MAXPACKETSIZE;
-               }
-               JOT(4, "%i=video_isoc_maxframesize\n", \
-                                       peasycap->video_isoc_maxframesize);
-               if (0 >= peasycap->video_isoc_maxframesize) {
-                       SAY("ERROR:  bad video_isoc_maxframesize\n");
-                       return -ENOENT;
-               }
-               peasycap->video_isoc_framesperdesc = VIDEO_ISOC_FRAMESPERDESC;
-               JOT(4, "%i=video_isoc_framesperdesc\n", \
-                                       peasycap->video_isoc_framesperdesc);
-               if (0 >= peasycap->video_isoc_framesperdesc) {
-                       SAY("ERROR:  bad video_isoc_framesperdesc\n");
-                       return -ENOENT;
-               }
-               peasycap->video_isoc_buffer_size = \
-                                       peasycap->video_isoc_maxframesize * \
-                                       peasycap->video_isoc_framesperdesc;
-               JOT(4, "%i=video_isoc_buffer_size\n", \
-                                       peasycap->video_isoc_buffer_size);
-               if ((PAGE_SIZE << VIDEO_ISOC_ORDER) < \
-                                       peasycap->video_isoc_buffer_size) {
-                       SAY("MISTAKE: " \
-                               "peasycap->video_isoc_buffer_size too big\n");
-                       return -EFAULT;
-               }
+               peasycap->video_isoc_maxframesize = \
+                                               USB_2_0_MAXPACKETSIZE;
+       }
+       JOM(4, "%i=video_isoc_maxframesize\n", \
+                               peasycap->video_isoc_maxframesize);
+       if (0 >= peasycap->video_isoc_maxframesize) {
+               SAM("ERROR:  bad video_isoc_maxframesize\n");
+               SAM("        possibly because port is USB 1.1\n");
+               return -ENOENT;
+       }
+       peasycap->video_isoc_framesperdesc = VIDEO_ISOC_FRAMESPERDESC;
+       JOM(4, "%i=video_isoc_framesperdesc\n", \
+                               peasycap->video_isoc_framesperdesc);
+       if (0 >= peasycap->video_isoc_framesperdesc) {
+               SAM("ERROR:  bad video_isoc_framesperdesc\n");
+               return -ENOENT;
+       }
+       peasycap->video_isoc_buffer_size = \
+                               peasycap->video_isoc_maxframesize * \
+                               peasycap->video_isoc_framesperdesc;
+       JOM(4, "%i=video_isoc_buffer_size\n", \
+                               peasycap->video_isoc_buffer_size);
+       if ((PAGE_SIZE << VIDEO_ISOC_ORDER) < \
+                               peasycap->video_isoc_buffer_size) {
+               SAM("MISTAKE: peasycap->video_isoc_buffer_size too big\n");
+               return -EFAULT;
        }
 /*---------------------------------------------------------------------------*/
        if (-1 == peasycap->video_interface) {
-               SAY("MISTAKE:  video_interface is unset\n");
+               SAM("MISTAKE:  video_interface is unset\n");
                return -EFAULT;
        }
        if (-1 == peasycap->video_altsetting_on) {
-               SAY("MISTAKE:  video_altsetting_on is unset\n");
+               SAM("MISTAKE:  video_altsetting_on is unset\n");
                return -EFAULT;
        }
        if (-1 == peasycap->video_altsetting_off) {
-               SAY("MISTAKE:  video_interface_off is unset\n");
+               SAM("MISTAKE:  video_interface_off is unset\n");
                return -EFAULT;
        }
        if (-1 == peasycap->video_endpointnumber) {
-               SAY("MISTAKE:  video_endpointnumber is unset\n");
+               SAM("MISTAKE:  video_endpointnumber is unset\n");
                return -EFAULT;
        }
        if (-1 == peasycap->video_isoc_maxframesize) {
-               SAY("MISTAKE:  video_isoc_maxframesize is unset\n");
+               SAM("MISTAKE:  video_isoc_maxframesize is unset\n");
                return -EFAULT;
        }
        if (-1 == peasycap->video_isoc_buffer_size) {
-               SAY("MISTAKE:  video_isoc_buffer_size is unset\n");
+               SAM("MISTAKE:  video_isoc_buffer_size is unset\n");
                return -EFAULT;
        }
 /*---------------------------------------------------------------------------*/
@@ -3588,20 +4157,20 @@ case 0: {
        INIT_LIST_HEAD(&(peasycap->urb_video_head));
        peasycap->purb_video_head = &(peasycap->urb_video_head);
 /*---------------------------------------------------------------------------*/
-       JOT(4, "allocating %i frame buffers of size %li\n",  \
+       JOM(4, "allocating %i frame buffers of size %li\n",  \
                        FRAME_BUFFER_MANY, (long int)FRAME_BUFFER_SIZE);
-       JOT(4, ".... each scattered over %li pages\n", \
+       JOM(4, ".... each scattered over %li pages\n", \
                                                FRAME_BUFFER_SIZE/PAGE_SIZE);
 
        for (k = 0;  k < FRAME_BUFFER_MANY;  k++) {
                for (m = 0;  m < FRAME_BUFFER_SIZE/PAGE_SIZE;  m++) {
                        if ((void *)NULL != peasycap->frame_buffer[k][m].pgo)
-                               SAY("attempting to reallocate frame " \
+                               SAM("attempting to reallocate frame " \
                                                                " buffers\n");
                        else {
                                pbuf = (void *)__get_free_page(GFP_KERNEL);
                                if ((void *)NULL == pbuf) {
-                                       SAY("ERROR: Could not allocate frame "\
+                                       SAM("ERROR: Could not allocate frame "\
                                                "buffer %i page %i\n", k, m);
                                        return -ENOMEM;
                                } else
@@ -3615,23 +4184,23 @@ case 0: {
 
        peasycap->frame_fill = 0;
        peasycap->frame_read = 0;
-       JOT(4, "allocation of frame buffers done:  %i pages\n", k * \
+       JOM(4, "allocation of frame buffers done:  %i pages\n", k * \
                                                                m);
 /*---------------------------------------------------------------------------*/
-       JOT(4, "allocating %i field buffers of size %li\n",  \
+       JOM(4, "allocating %i field buffers of size %li\n",  \
                        FIELD_BUFFER_MANY, (long int)FIELD_BUFFER_SIZE);
-       JOT(4, ".... each scattered over %li pages\n", \
+       JOM(4, ".... each scattered over %li pages\n", \
                                        FIELD_BUFFER_SIZE/PAGE_SIZE);
 
        for (k = 0;  k < FIELD_BUFFER_MANY;  k++) {
                for (m = 0;  m < FIELD_BUFFER_SIZE/PAGE_SIZE;  m++) {
                        if ((void *)NULL != peasycap->field_buffer[k][m].pgo) {
-                               SAY("ERROR: attempting to reallocate " \
+                               SAM("ERROR: attempting to reallocate " \
                                                        "field buffers\n");
                        } else {
                                pbuf = (void *) __get_free_page(GFP_KERNEL);
                                if ((void *)NULL == pbuf) {
-                                       SAY("ERROR: Could not allocate field" \
+                                       SAM("ERROR: Could not allocate field" \
                                                " buffer %i page %i\n", k, m);
                                        return -ENOMEM;
                                        }
@@ -3647,18 +4216,18 @@ case 0: {
        peasycap->field_fill = 0;
        peasycap->field_page = 0;
        peasycap->field_read = 0;
-       JOT(4, "allocation of field buffers done:  %i pages\n", k * \
+       JOM(4, "allocation of field buffers done:  %i pages\n", k * \
                                                                m);
 /*---------------------------------------------------------------------------*/
-       JOT(4, "allocating %i isoc video buffers of size %i\n",  \
+       JOM(4, "allocating %i isoc video buffers of size %i\n",  \
                                        VIDEO_ISOC_BUFFER_MANY, \
                                        peasycap->video_isoc_buffer_size);
-       JOT(4, ".... each occupying contiguous memory pages\n");
+       JOM(4, ".... each occupying contiguous memory pages\n");
 
        for (k = 0;  k < VIDEO_ISOC_BUFFER_MANY; k++) {
                pbuf = (void *)__get_free_pages(GFP_KERNEL, VIDEO_ISOC_ORDER);
                if (NULL == pbuf) {
-                       SAY("ERROR: Could not allocate isoc video buffer " \
+                       SAM("ERROR: Could not allocate isoc video buffer " \
                                                                "%i\n", k);
                        return -ENOMEM;
                } else
@@ -3670,26 +4239,26 @@ case 0: {
                                        peasycap->video_isoc_buffer_size;
                peasycap->video_isoc_buffer[k].kount = k;
        }
-       JOT(4, "allocation of isoc video buffers done: %i pages\n", \
+       JOM(4, "allocation of isoc video buffers done: %i pages\n", \
                                        k * (0x01 << VIDEO_ISOC_ORDER));
 /*---------------------------------------------------------------------------*/
 /*
  *  ALLOCATE AND INITIALIZE MULTIPLE struct urb ...
  */
 /*---------------------------------------------------------------------------*/
-       JOT(4, "allocating %i struct urb.\n", VIDEO_ISOC_BUFFER_MANY);
-       JOT(4, "using %i=peasycap->video_isoc_framesperdesc\n", \
+       JOM(4, "allocating %i struct urb.\n", VIDEO_ISOC_BUFFER_MANY);
+       JOM(4, "using %i=peasycap->video_isoc_framesperdesc\n", \
                                        peasycap->video_isoc_framesperdesc);
-       JOT(4, "using %i=peasycap->video_isoc_maxframesize\n", \
+       JOM(4, "using %i=peasycap->video_isoc_maxframesize\n", \
                                        peasycap->video_isoc_maxframesize);
-       JOT(4, "using %i=peasycap->video_isoc_buffer_sizen", \
+       JOM(4, "using %i=peasycap->video_isoc_buffer_sizen", \
                                        peasycap->video_isoc_buffer_size);
 
        for (k = 0;  k < VIDEO_ISOC_BUFFER_MANY; k++) {
                purb = usb_alloc_urb(peasycap->video_isoc_framesperdesc, \
                                                                GFP_KERNEL);
                if (NULL == purb) {
-                       SAY("ERROR: usb_alloc_urb returned NULL for buffer " \
+                       SAM("ERROR: usb_alloc_urb returned NULL for buffer " \
                                                                "%i\n", k);
                        return -ENOMEM;
                } else
@@ -3697,7 +4266,7 @@ case 0: {
 /* - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - */
                pdata_urb = kzalloc(sizeof(struct data_urb), GFP_KERNEL);
                if (NULL == pdata_urb) {
-                       SAY("ERROR: Could not allocate struct data_urb.\n");
+                       SAM("ERROR: Could not allocate struct data_urb.\n");
                        return -ENOMEM;
                } else
                        peasycap->allocation_video_struct += \
@@ -3714,30 +4283,30 @@ case 0: {
  */
 /*---------------------------------------------------------------------------*/
                if (!k) {
-                       JOT(4, "initializing video urbs thus:\n");
-                       JOT(4, "  purb->interval = 1;\n");
-                       JOT(4, "  purb->dev = peasycap->pusb_device;\n");
-                       JOT(4, "  purb->pipe = usb_rcvisocpipe" \
+                       JOM(4, "initializing video urbs thus:\n");
+                       JOM(4, "  purb->interval = 1;\n");
+                       JOM(4, "  purb->dev = peasycap->pusb_device;\n");
+                       JOM(4, "  purb->pipe = usb_rcvisocpipe" \
                                        "(peasycap->pusb_device,%i);\n", \
                                        peasycap->video_endpointnumber);
-                       JOT(4, "  purb->transfer_flags = URB_ISO_ASAP;\n");
-                       JOT(4, "  purb->transfer_buffer = peasycap->" \
+                       JOM(4, "  purb->transfer_flags = URB_ISO_ASAP;\n");
+                       JOM(4, "  purb->transfer_buffer = peasycap->" \
                                        "video_isoc_buffer[.].pgo;\n");
-                       JOT(4, "  purb->transfer_buffer_length = %i;\n", \
+                       JOM(4, "  purb->transfer_buffer_length = %i;\n", \
                                        peasycap->video_isoc_buffer_size);
-                       JOT(4, "  purb->complete = easycap_complete;\n");
-                       JOT(4, "  purb->context = peasycap;\n");
-                       JOT(4, "  purb->start_frame = 0;\n");
-                       JOT(4, "  purb->number_of_packets = %i;\n", \
+                       JOM(4, "  purb->complete = easycap_complete;\n");
+                       JOM(4, "  purb->context = peasycap;\n");
+                       JOM(4, "  purb->start_frame = 0;\n");
+                       JOM(4, "  purb->number_of_packets = %i;\n", \
                                        peasycap->video_isoc_framesperdesc);
-                       JOT(4, "  for (j = 0; j < %i; j++)\n", \
+                       JOM(4, "  for (j = 0; j < %i; j++)\n", \
                                        peasycap->video_isoc_framesperdesc);
-                       JOT(4, "    {\n");
-                       JOT(4, "    purb->iso_frame_desc[j].offset = j*%i;\n",\
+                       JOM(4, "    {\n");
+                       JOM(4, "    purb->iso_frame_desc[j].offset = j*%i;\n",\
                                        peasycap->video_isoc_maxframesize);
-                       JOT(4, "    purb->iso_frame_desc[j].length = %i;\n", \
+                       JOM(4, "    purb->iso_frame_desc[j].length = %i;\n", \
                                        peasycap->video_isoc_maxframesize);
-                       JOT(4, "    }\n");
+                       JOM(4, "    }\n");
                }
 
                purb->interval = 1;
@@ -3759,13 +4328,33 @@ case 0: {
                                        peasycap->video_isoc_maxframesize;
                }
        }
-       JOT(4, "allocation of %i struct urb done.\n", k);
+       JOM(4, "allocation of %i struct urb done.\n", k);
 /*--------------------------------------------------------------------------*/
 /*
  *  SAVE POINTER peasycap IN THIS INTERFACE.
  */
 /*--------------------------------------------------------------------------*/
        usb_set_intfdata(pusb_interface, peasycap);
+/*---------------------------------------------------------------------------*/
+/*
+ *  IT IS ESSENTIAL TO INITIALIZE THE HARDWARE BEFORE, RATHER THAN AFTER,
+ *  THE DEVICE IS REGISTERED, BECAUSE SOME VERSIONS OF THE videodev MODULE
+ *  CALL easycap_open() IMMEDIATELY AFTER REGISTRATION, CAUSING A CLASH.
+ *  BEWARE.
+*/
+/*---------------------------------------------------------------------------*/
+#if defined(PREFER_NTSC)
+       peasycap->ntsc = true;
+       JOM(8, "defaulting initially to NTSC\n");
+#else
+       peasycap->ntsc = false;
+       JOM(8, "defaulting initially to PAL\n");
+#endif /*PREFER_NTSC*/
+       rc = reset(peasycap);
+       if (0 != rc) {
+               SAM("ERROR: reset() returned %i\n", rc);
+               return -EFAULT;
+       }
 /*--------------------------------------------------------------------------*/
 /*
  *  THE VIDEO DEVICE CAN BE REGISTERED NOW, AS IT IS READY.
@@ -3776,48 +4365,58 @@ case 0: {
                err("Not able to get a minor for this device");
                usb_set_intfdata(pusb_interface, NULL);
                return -ENODEV;
-       } else
+       } else {
                (peasycap->registered_video)++;
-       SAY("easycap attached to minor #%d\n", pusb_interface->minor);
-       break;
-/*vvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvv*/
-#else
-       pvideo_device = (struct video_device *)\
-                       kzalloc(sizeof(struct video_device), GFP_KERNEL);
-       if ((struct video_device *)NULL == pvideo_device) {
-               SAY("ERROR: Could not allocate structure video_device\n");
-               return -ENOMEM;
+               SAM("easycap attached to minor #%d\n", pusb_interface->minor);
+               break;
        }
-       if (VIDEO_DEVICE_MANY <= video_device_many) {
-               SAY("ERROR: Too many /dev/videos\n");
-               return -ENOMEM;
+/*vvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvv*/
+#else
+#if defined(EASYCAP_NEEDS_V4L2_DEVICE_H)
+       if (0 != (v4l2_device_register(&(pusb_interface->dev), \
+                                               &(peasycap->v4l2_device)))) {
+               SAM("v4l2_device_register() failed\n");
+               return -ENODEV;
+       } else {
+               JOM(4, "registered device instance: %s\n", \
+                                       &(peasycap->v4l2_device.name[0]));
        }
-       pvideo_array[video_device_many] = pvideo_device;  video_device_many++;
+/*---------------------------------------------------------------------------*/
+/*
+ *                                   FIXME
+ *
+ *
+ *  THIS IS BELIEVED TO BE HARMLESS, BUT MAY WELL BE UNNECESSARY OR WRONG:
+*/
+/*---------------------------------------------------------------------------*/
+       peasycap->video_device.v4l2_dev = (struct v4l2_device *)NULL;
+/*---------------------------------------------------------------------------*/
 
-       strcpy(&pvideo_device->name[0], "easycapdc60");
+#endif /*EASYCAP_NEEDS_V4L2_DEVICE_H*/
+
+       strcpy(&peasycap->video_device.name[0], "easycapdc60");
 #if defined(EASYCAP_NEEDS_V4L2_FOPS)
-       pvideo_device->fops = &v4l2_fops;
+       peasycap->video_device.fops = &v4l2_fops;
 #else
-       pvideo_device->fops = &easycap_fops;
+       peasycap->video_device.fops = &easycap_fops;
 #endif /*EASYCAP_NEEDS_V4L2_FOPS*/
-       pvideo_device->minor = -1;
-       pvideo_device->release = (void *)(&videodev_release);
+       peasycap->video_device.minor = -1;
+       peasycap->video_device.release = (void *)(&videodev_release);
 
-       video_set_drvdata(pvideo_device, (void *)peasycap);
+       video_set_drvdata(&(peasycap->video_device), (void *)peasycap);
 
-       rc = video_register_device(pvideo_device, VFL_TYPE_GRABBER, -1);
-       if (0 != rc) {
+       if (0 != (video_register_device(&(peasycap->video_device), \
+                                               VFL_TYPE_GRABBER, -1))) {
                err("Not able to register with videodev");
-               videodev_release(pvideo_device);
+               videodev_release(&(peasycap->video_device));
                return -ENODEV;
        } else {
-               peasycap->pvideo_device = pvideo_device;
                (peasycap->registered_video)++;
-               JOT(4, "registered with videodev: %i=minor\n", \
-                                                       pvideo_device->minor);
+               SAM("registered with videodev: %i=minor\n", \
+                                               peasycap->video_device.minor);
        }
-/*^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^*/
 #endif /*EASYCAP_IS_VIDEODEV_CLIENT*/
+/*^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^*/
        break;
 }
 /*--------------------------------------------------------------------------*/
@@ -3827,125 +4426,118 @@ case 0: {
  */
 /*--------------------------------------------------------------------------*/
 case 1: {
+       if (!peasycap) {
+               SAM("ERROR: peasycap is NULL\n");
+               return -EFAULT;
+       }
 /*--------------------------------------------------------------------------*/
 /*
  *  SAVE POINTER peasycap IN INTERFACE 1
  */
 /*--------------------------------------------------------------------------*/
        usb_set_intfdata(pusb_interface, peasycap);
-       JOT(4, "no initialization required for interface %i\n", \
+       JOM(4, "no initialization required for interface %i\n", \
                                pusb_interface_descriptor->bInterfaceNumber);
        break;
 }
 /*--------------------------------------------------------------------------*/
 case 2: {
        if (!peasycap) {
-               SAY("MISTAKE: peasycap is NULL\n");
+               SAM("MISTAKE: peasycap is NULL\n");
                return -EFAULT;
        }
        if (!isokalt) {
-               SAY("ERROR:  no viable audio_altsetting_on\n");
+               SAM("ERROR:  no viable audio_altsetting_on\n");
                return -ENOENT;
        } else {
                peasycap->audio_altsetting_on = okalt[isokalt - 1];
-               JOT(4, "%i=audio_altsetting_on <====\n", \
+               JOM(4, "%i=audio_altsetting_on <====\n", \
                                                peasycap->audio_altsetting_on);
        }
-       if (!isokepn) {
-               SAY("ERROR:  no viable audio_endpointnumber\n");
+
+       peasycap->audio_endpointnumber = okepn[isokalt - 1];
+       JOM(4, "%i=audio_endpointnumber\n", peasycap->audio_endpointnumber);
+
+       peasycap->audio_isoc_maxframesize = okmps[isokalt - 1];
+       JOM(4, "%i=audio_isoc_maxframesize\n", \
+                                       peasycap->audio_isoc_maxframesize);
+       if (0 >= peasycap->audio_isoc_maxframesize) {
+               SAM("ERROR:  bad audio_isoc_maxframesize\n");
                return -ENOENT;
-       } else {
-               peasycap->audio_endpointnumber = okepn[isokepn - 1];
-               JOT(4, "%i=audio_endpointnumber\n", \
-                                       peasycap->audio_endpointnumber);
        }
-       if (!isokmps) {
-               SAY("ERROR:  no viable audio_maxpacketsize\n");
-               return -ENOENT;
+       if (9 == peasycap->audio_isoc_maxframesize) {
+               peasycap->ilk |= 0x02;
+               SAM("hardware is FOUR-CVBS\n");
+               peasycap->microphone = true;
+               peasycap->audio_pages_per_fragment = 4;
+       } else if (256 == peasycap->audio_isoc_maxframesize) {
+               peasycap->ilk &= ~0x02;
+               SAM("hardware is CVBS+S-VIDEO\n");
+               peasycap->microphone = false;
+               peasycap->audio_pages_per_fragment = 4;
        } else {
-               peasycap->audio_isoc_maxframesize = okmps[isokmps - 1];
-               JOT(4, "%i=audio_isoc_maxframesize\n", \
-                                       peasycap->audio_isoc_maxframesize);
-               if (0 >= peasycap->audio_isoc_maxframesize) {
-                       SAY("ERROR:  bad audio_isoc_maxframesize\n");
-                       return -ENOENT;
-               }
-               if (9 == peasycap->audio_isoc_maxframesize) {
-                       peasycap->ilk |= 0x02;
-                       SAY("hardware is FOUR-CVBS\n");
-                       peasycap->microphone = true;
-                       peasycap->audio_pages_per_fragment = 4;
-               } else if (256 == peasycap->audio_isoc_maxframesize) {
-                       peasycap->ilk &= ~0x02;
-                       SAY("hardware is CVBS+S-VIDEO\n");
-                       peasycap->microphone = false;
-                       peasycap->audio_pages_per_fragment = 4;
-               } else {
-                       SAY("hardware is unidentified:\n");
-                       SAY("%i=audio_isoc_maxframesize\n", \
+               SAM("hardware is unidentified:\n");
+               SAM("%i=audio_isoc_maxframesize\n", \
                                        peasycap->audio_isoc_maxframesize);
-                       return -ENOENT;
-               }
+               return -ENOENT;
+       }
 
-               peasycap->audio_bytes_per_fragment = \
+       peasycap->audio_bytes_per_fragment = \
                                        peasycap->audio_pages_per_fragment * \
                                                                PAGE_SIZE ;
-               peasycap->audio_buffer_page_many = (AUDIO_FRAGMENT_MANY * \
+       peasycap->audio_buffer_page_many = (AUDIO_FRAGMENT_MANY * \
                                        peasycap->audio_pages_per_fragment);
 
-               JOT(4, "%6i=AUDIO_FRAGMENT_MANY\n", AUDIO_FRAGMENT_MANY);
-               JOT(4, "%6i=audio_pages_per_fragment\n", \
+       JOM(4, "%6i=AUDIO_FRAGMENT_MANY\n", AUDIO_FRAGMENT_MANY);
+       JOM(4, "%6i=audio_pages_per_fragment\n", \
                                        peasycap->audio_pages_per_fragment);
-               JOT(4, "%6i=audio_bytes_per_fragment\n", \
+       JOM(4, "%6i=audio_bytes_per_fragment\n", \
                                        peasycap->audio_bytes_per_fragment);
-               JOT(4, "%6i=audio_buffer_page_many\n", \
+       JOM(4, "%6i=audio_buffer_page_many\n", \
                                        peasycap->audio_buffer_page_many);
 
-               peasycap->audio_isoc_framesperdesc = 128;
+       peasycap->audio_isoc_framesperdesc = 128;
 
-               JOT(4, "%i=audio_isoc_framesperdesc\n", \
+       JOM(4, "%i=audio_isoc_framesperdesc\n", \
                                        peasycap->audio_isoc_framesperdesc);
-               if (0 >= peasycap->audio_isoc_framesperdesc) {
-                       SAY("ERROR:  bad audio_isoc_framesperdesc\n");
-                       return -ENOENT;
-               }
+       if (0 >= peasycap->audio_isoc_framesperdesc) {
+               SAM("ERROR:  bad audio_isoc_framesperdesc\n");
+               return -ENOENT;
+       }
 
-               peasycap->audio_isoc_buffer_size = \
+       peasycap->audio_isoc_buffer_size = \
                                peasycap->audio_isoc_maxframesize * \
                                peasycap->audio_isoc_framesperdesc;
-               JOT(4, "%i=audio_isoc_buffer_size\n", \
+       JOM(4, "%i=audio_isoc_buffer_size\n", \
                                        peasycap->audio_isoc_buffer_size);
-               if (AUDIO_ISOC_BUFFER_SIZE < \
-                                       peasycap->audio_isoc_buffer_size) {
-                       SAY("MISTAKE:  audio_isoc_buffer_size bigger "
+       if (AUDIO_ISOC_BUFFER_SIZE < peasycap->audio_isoc_buffer_size) {
+                       SAM("MISTAKE:  audio_isoc_buffer_size bigger "
                        "than %li=AUDIO_ISOC_BUFFER_SIZE\n", \
                                                AUDIO_ISOC_BUFFER_SIZE);
-                       return -EFAULT;
-               }
+               return -EFAULT;
        }
-
        if (-1 == peasycap->audio_interface) {
-               SAY("MISTAKE:  audio_interface is unset\n");
+               SAM("MISTAKE:  audio_interface is unset\n");
                return -EFAULT;
        }
        if (-1 == peasycap->audio_altsetting_on) {
-               SAY("MISTAKE:  audio_altsetting_on is unset\n");
+               SAM("MISTAKE:  audio_altsetting_on is unset\n");
                return -EFAULT;
        }
        if (-1 == peasycap->audio_altsetting_off) {
-               SAY("MISTAKE:  audio_interface_off is unset\n");
+               SAM("MISTAKE:  audio_interface_off is unset\n");
                return -EFAULT;
        }
        if (-1 == peasycap->audio_endpointnumber) {
-               SAY("MISTAKE:  audio_endpointnumber is unset\n");
+               SAM("MISTAKE:  audio_endpointnumber is unset\n");
                return -EFAULT;
        }
        if (-1 == peasycap->audio_isoc_maxframesize) {
-               SAY("MISTAKE:  audio_isoc_maxframesize is unset\n");
+               SAM("MISTAKE:  audio_isoc_maxframesize is unset\n");
                return -EFAULT;
        }
        if (-1 == peasycap->audio_isoc_buffer_size) {
-               SAY("MISTAKE:  audio_isoc_buffer_size is unset\n");
+               SAM("MISTAKE:  audio_isoc_buffer_size is unset\n");
                return -EFAULT;
        }
 /*---------------------------------------------------------------------------*/
@@ -3956,17 +4548,17 @@ case 2: {
        INIT_LIST_HEAD(&(peasycap->urb_audio_head));
        peasycap->purb_audio_head = &(peasycap->urb_audio_head);
 
-       JOT(4, "allocating an audio buffer\n");
-       JOT(4, ".... scattered over %i pages\n", \
+       JOM(4, "allocating an audio buffer\n");
+       JOM(4, ".... scattered over %i pages\n", \
                                        peasycap->audio_buffer_page_many);
 
        for (k = 0;  k < peasycap->audio_buffer_page_many;  k++) {
                if ((void *)NULL != peasycap->audio_buffer[k].pgo) {
-                       SAY("ERROR: attempting to reallocate audio buffers\n");
+                       SAM("ERROR: attempting to reallocate audio buffers\n");
                } else {
                        pbuf = (void *) __get_free_page(GFP_KERNEL);
                        if ((void *)NULL == pbuf) {
-                               SAY("ERROR: Could not allocate audio " \
+                               SAM("ERROR: Could not allocate audio " \
                                                        "buffer page %i\n", k);
                                return -ENOMEM;
                        } else
@@ -3979,16 +4571,16 @@ case 2: {
 
        peasycap->audio_fill = 0;
        peasycap->audio_read = 0;
-       JOT(4, "allocation of audio buffer done:  %i pages\n", k);
+       JOM(4, "allocation of audio buffer done:  %i pages\n", k);
 /*---------------------------------------------------------------------------*/
-       JOT(4, "allocating %i isoc audio buffers of size %i\n",  \
+       JOM(4, "allocating %i isoc audio buffers of size %i\n",  \
                AUDIO_ISOC_BUFFER_MANY, peasycap->audio_isoc_buffer_size);
-       JOT(4, ".... each occupying contiguous memory pages\n");
+       JOM(4, ".... each occupying contiguous memory pages\n");
 
        for (k = 0;  k < AUDIO_ISOC_BUFFER_MANY;  k++) {
                pbuf = (void *)__get_free_pages(GFP_KERNEL, AUDIO_ISOC_ORDER);
                if (NULL == pbuf) {
-                       SAY("ERROR: Could not allocate isoc audio buffer " \
+                       SAM("ERROR: Could not allocate isoc audio buffer " \
                                                        "%i\n", k);
                        return -ENOMEM;
                } else
@@ -4000,25 +4592,25 @@ case 2: {
                peasycap->audio_isoc_buffer_size;
                peasycap->audio_isoc_buffer[k].kount = k;
        }
-       JOT(4, "allocation of isoc audio buffers done.\n");
+       JOM(4, "allocation of isoc audio buffers done.\n");
 /*---------------------------------------------------------------------------*/
 /*
  *  ALLOCATE AND INITIALIZE MULTIPLE struct urb ...
  */
 /*---------------------------------------------------------------------------*/
-       JOT(4, "allocating %i struct urb.\n", AUDIO_ISOC_BUFFER_MANY);
-       JOT(4, "using %i=peasycap->audio_isoc_framesperdesc\n", \
+       JOM(4, "allocating %i struct urb.\n", AUDIO_ISOC_BUFFER_MANY);
+       JOM(4, "using %i=peasycap->audio_isoc_framesperdesc\n", \
                                        peasycap->audio_isoc_framesperdesc);
-       JOT(4, "using %i=peasycap->audio_isoc_maxframesize\n", \
+       JOM(4, "using %i=peasycap->audio_isoc_maxframesize\n", \
                                        peasycap->audio_isoc_maxframesize);
-       JOT(4, "using %i=peasycap->audio_isoc_buffer_size\n", \
+       JOM(4, "using %i=peasycap->audio_isoc_buffer_size\n", \
                                        peasycap->audio_isoc_buffer_size);
 
        for (k = 0;  k < AUDIO_ISOC_BUFFER_MANY; k++) {
                purb = usb_alloc_urb(peasycap->audio_isoc_framesperdesc, \
                                                                GFP_KERNEL);
                if (NULL == purb) {
-                       SAY("ERROR: usb_alloc_urb returned NULL for buffer " \
+                       SAM("ERROR: usb_alloc_urb returned NULL for buffer " \
                                                        "%i\n", k);
                        return -ENOMEM;
                } else
@@ -4026,7 +4618,7 @@ case 2: {
 /* - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - */
                pdata_urb = kzalloc(sizeof(struct data_urb), GFP_KERNEL);
                if (NULL == pdata_urb) {
-                       SAY("ERROR: Could not allocate struct data_urb.\n");
+                       SAM("ERROR: Could not allocate struct data_urb.\n");
                        return -ENOMEM;
                } else
                        peasycap->allocation_audio_struct += \
@@ -4043,30 +4635,30 @@ case 2: {
  */
 /*---------------------------------------------------------------------------*/
                if (!k) {
-                       JOT(4, "initializing audio urbs thus:\n");
-                       JOT(4, "  purb->interval = 1;\n");
-                       JOT(4, "  purb->dev = peasycap->pusb_device;\n");
-                       JOT(4, "  purb->pipe = usb_rcvisocpipe(peasycap->" \
+                       JOM(4, "initializing audio urbs thus:\n");
+                       JOM(4, "  purb->interval = 1;\n");
+                       JOM(4, "  purb->dev = peasycap->pusb_device;\n");
+                       JOM(4, "  purb->pipe = usb_rcvisocpipe(peasycap->" \
                                        "pusb_device,%i);\n", \
                                        peasycap->audio_endpointnumber);
-                       JOT(4, "  purb->transfer_flags = URB_ISO_ASAP;\n");
-                       JOT(4, "  purb->transfer_buffer = " \
+                       JOM(4, "  purb->transfer_flags = URB_ISO_ASAP;\n");
+                       JOM(4, "  purb->transfer_buffer = " \
                                "peasycap->audio_isoc_buffer[.].pgo;\n");
-                       JOT(4, "  purb->transfer_buffer_length = %i;\n", \
+                       JOM(4, "  purb->transfer_buffer_length = %i;\n", \
                                        peasycap->audio_isoc_buffer_size);
-                       JOT(4, "  purb->complete = easysnd_complete;\n");
-                       JOT(4, "  purb->context = peasycap;\n");
-                       JOT(4, "  purb->start_frame = 0;\n");
-                       JOT(4, "  purb->number_of_packets = %i;\n", \
+                       JOM(4, "  purb->complete = easysnd_complete;\n");
+                       JOM(4, "  purb->context = peasycap;\n");
+                       JOM(4, "  purb->start_frame = 0;\n");
+                       JOM(4, "  purb->number_of_packets = %i;\n", \
                                        peasycap->audio_isoc_framesperdesc);
-                       JOT(4, "  for (j = 0; j < %i; j++)\n", \
+                       JOM(4, "  for (j = 0; j < %i; j++)\n", \
                                        peasycap->audio_isoc_framesperdesc);
-                       JOT(4, "    {\n");
-                       JOT(4, "    purb->iso_frame_desc[j].offset = j*%i;\n",\
+                       JOM(4, "    {\n");
+                       JOM(4, "    purb->iso_frame_desc[j].offset = j*%i;\n",\
                                        peasycap->audio_isoc_maxframesize);
-                       JOT(4, "    purb->iso_frame_desc[j].length = %i;\n", \
+                       JOM(4, "    purb->iso_frame_desc[j].length = %i;\n", \
                                        peasycap->audio_isoc_maxframesize);
-                       JOT(4, "    }\n");
+                       JOM(4, "    }\n");
                        }
 
                purb->interval = 1;
@@ -4088,7 +4680,7 @@ case 2: {
                                        peasycap->audio_isoc_maxframesize;
                }
        }
-       JOT(4, "allocation of %i struct urb done.\n", k);
+       JOM(4, "allocation of %i struct urb done.\n", k);
 /*---------------------------------------------------------------------------*/
 /*
  *  SAVE POINTER peasycap IN THIS INTERFACE.
@@ -4105,14 +4697,18 @@ case 2: {
                err("Not able to get a minor for this device.");
                usb_set_intfdata(pusb_interface, NULL);
                return -ENODEV;
-       } else
+       } else {
+               JOM(8, "kref_get() with %i=peasycap->kref.refcount.counter\n",\
+                                       (int)peasycap->kref.refcount.counter);
+               kref_get(&peasycap->kref);
                (peasycap->registered_audio)++;
+       }
 /*---------------------------------------------------------------------------*/
 /*
  *  LET THE USER KNOW WHAT NODE THE AUDIO DEVICE IS ATTACHED TO.
  */
 /*---------------------------------------------------------------------------*/
-       SAY("easysnd attached to minor #%d\n", pusb_interface->minor);
+       SAM("easysnd attached to minor #%d\n", pusb_interface->minor);
        break;
 }
 /*---------------------------------------------------------------------------*/
@@ -4121,20 +4717,19 @@ case 2: {
  */
 /*---------------------------------------------------------------------------*/
 default: {
-       JOT(4, "ERROR: unexpected interface %i\n", bInterfaceNumber);
+       JOM(4, "ERROR: unexpected interface %i\n", bInterfaceNumber);
        return -EINVAL;
 }
 }
-JOT(4, "ends successfully for interface %i\n", \
+JOM(4, "ends successfully for interface %i\n", \
                                pusb_interface_descriptor->bInterfaceNumber);
 return 0;
 }
 /*****************************************************************************/
 /*---------------------------------------------------------------------------*/
 /*
- *  WHEN THIS FUNCTION IS CALLED THE DEVICE HAS ALREADY BEEN PHYSICALLY
- *  UNPLUGGED.
- *  HENCE peasycap->pusb_device IS NO LONGER VALID AND MUST BE SET TO NULL.
+ *  WHEN THIS FUNCTION IS CALLED THE EasyCAP HAS ALREADY BEEN PHYSICALLY
+ *  UNPLUGGED.  HENCE peasycap->pusb_device IS NO LONGER VALID.
  */
 /*---------------------------------------------------------------------------*/
 void
@@ -4147,7 +4742,14 @@ struct easycap *peasycap;
 
 struct list_head *plist_head;
 struct data_urb *pdata_urb;
-int minor, m;
+int minor, m, kd;
+/*vvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvv*/
+#if defined(EASYCAP_IS_VIDEODEV_CLIENT)
+#if defined(EASYCAP_NEEDS_V4L2_DEVICE_H)
+struct v4l2_device *pv4l2_device;
+#endif /*EASYCAP_NEEDS_V4L2_DEVICE_H*/
+#endif /*EASYCAP_IS_VIDEODEV_CLIENT*/
+/*^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^*/
 
 JOT(4, "\n");
 
@@ -4169,107 +4771,188 @@ bInterfaceNumber = pusb_interface_descriptor->bInterfaceNumber;
 minor = pusb_interface->minor;
 JOT(4, "intf[%i]: minor=%i\n", bInterfaceNumber, minor);
 
+if (1 == bInterfaceNumber)
+       return;
+
 peasycap = usb_get_intfdata(pusb_interface);
-if ((struct easycap *)NULL == peasycap)
+if (NULL == peasycap) {
        SAY("ERROR: peasycap is NULL\n");
-else {
-       peasycap->pusb_device = (struct usb_device *)NULL;
-       switch (bInterfaceNumber) {
-/*---------------------------------------------------------------------------*/
-       case 0: {
-               if ((struct list_head *)NULL != peasycap->purb_video_head) {
-                       JOT(4, "killing video urbs\n");
-                       m = 0;
-                       list_for_each(plist_head, (peasycap->purb_video_head))
-                               {
-                               pdata_urb = list_entry(plist_head, \
-                                               struct data_urb, list_head);
-                               if ((struct data_urb *)NULL != pdata_urb) {
-                                       if ((struct urb *)NULL != \
-                                                       pdata_urb->purb) {
-                                               usb_kill_urb(pdata_urb->purb);
-                                               m++;
-                                       }
+       return;
+}
+/*---------------------------------------------------------------------------*/
+#if (!defined(EASYCAP_IS_VIDEODEV_CLIENT))
+#
+/*vvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvv*/
+#else
+#if defined(EASYCAP_NEEDS_V4L2_DEVICE_H)
+/*---------------------------------------------------------------------------*/
+/*
+ *  SOME VERSIONS OF THE videodev MODULE OVERWRITE THE DATA WHICH HAS
+ *  BEEN WRITTEN BY THE CALL TO usb_set_intfdata() IN easycap_usb_probe(),
+ *  REPLACING IT WITH A POINTER TO THE EMBEDDED v4l2_device STRUCTURE.
+ *  TO DETECT THIS, THE STRING IN THE easycap.telltale[] BUFFER IS CHECKED.
+*/
+/*---------------------------------------------------------------------------*/
+if (memcmp(&peasycap->telltale[0], TELLTALE, strlen(TELLTALE))) {
+       pv4l2_device = usb_get_intfdata(pusb_interface);
+       if ((struct v4l2_device *)NULL == pv4l2_device) {
+               SAY("ERROR: pv4l2_device is NULL\n");
+               return;
+       }
+       peasycap = (struct easycap *) \
+               container_of(pv4l2_device, struct easycap, v4l2_device);
+}
+#endif /*EASYCAP_NEEDS_V4L2_DEVICE_H*/
+#
+#endif /*EASYCAP_IS_VIDEODEV_CLIENT*/
+/*^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^*/
+/*---------------------------------------------------------------------------*/
+if (memcmp(&peasycap->telltale[0], TELLTALE, strlen(TELLTALE))) {
+       SAY("ERROR: bad peasycap: 0x%08lX\n", (unsigned long int) peasycap);
+       return;
+}
+/*---------------------------------------------------------------------------*/
+/*
+ *  IF THE WAIT QUEUES ARE NOT CLEARED A DEADLOCK IS POSSIBLE.  BEWARE.
+*/
+/*---------------------------------------------------------------------------*/
+peasycap->video_eof = 1;
+peasycap->audio_eof = 1;
+wake_up_interruptible(&(peasycap->wq_video));
+wake_up_interruptible(&(peasycap->wq_audio));
+/*---------------------------------------------------------------------------*/
+switch (bInterfaceNumber) {
+case 0: {
+       if ((struct list_head *)NULL != peasycap->purb_video_head) {
+               JOM(4, "killing video urbs\n");
+               m = 0;
+               list_for_each(plist_head, (peasycap->purb_video_head))
+                       {
+                       pdata_urb = list_entry(plist_head, \
+                                       struct data_urb, list_head);
+                       if ((struct data_urb *)NULL != pdata_urb) {
+                               if ((struct urb *)NULL != \
+                                               pdata_urb->purb) {
+                                       usb_kill_urb(pdata_urb->purb);
+                                       m++;
                                }
                        }
-                       JOT(4, "%i video urbs killed\n", m);
-               } else
-                       SAY("ERROR: peasycap->purb_video_head is NULL\n");
-               break;
+               }
+               JOM(4, "%i video urbs killed\n", m);
        }
+       break;
+}
 /*---------------------------------------------------------------------------*/
-       case 2: {
-               if ((struct list_head *)NULL != peasycap->purb_audio_head) {
-                       JOT(4, "killing audio urbs\n");
-                       m = 0;
-                       list_for_each(plist_head, \
-                                               (peasycap->purb_audio_head)) {
-                               pdata_urb = list_entry(plist_head, \
-                                               struct data_urb, list_head);
-                               if ((struct data_urb *)NULL != pdata_urb) {
-                                       if ((struct urb *)NULL != \
-                                                       pdata_urb->purb) {
-                                               usb_kill_urb(pdata_urb->purb);
-                                               m++;
-                                       }
+case 2: {
+       if ((struct list_head *)NULL != peasycap->purb_audio_head) {
+               JOM(4, "killing audio urbs\n");
+               m = 0;
+               list_for_each(plist_head, \
+                                       (peasycap->purb_audio_head)) {
+                       pdata_urb = list_entry(plist_head, \
+                                       struct data_urb, list_head);
+                       if ((struct data_urb *)NULL != pdata_urb) {
+                               if ((struct urb *)NULL != \
+                                               pdata_urb->purb) {
+                                       usb_kill_urb(pdata_urb->purb);
+                                       m++;
                                }
                        }
-                       JOT(4, "%i audio urbs killed\n", m);
-               } else
-                       SAY("ERROR: peasycap->purb_audio_head is NULL\n");
-               break;
+               }
+               JOM(4, "%i audio urbs killed\n", m);
        }
+       break;
+}
 /*---------------------------------------------------------------------------*/
-       default:
-               break;
-       }
+default:
+       break;
 }
 /*--------------------------------------------------------------------------*/
 /*
  *  DEREGISTER
+ *
+ *  THIS PROCEDURE WILL BLOCK UNTIL easycap_poll(), VIDEO IOCTL AND AUDIO
+ *  IOCTL ARE ALL UNLOCKED.  IF THIS IS NOT DONE AN Oops CAN OCCUR WHEN
+ *  AN EasyCAP IS UNPLUGGED WHILE THE URBS ARE RUNNING.  BEWARE.
  */
 /*--------------------------------------------------------------------------*/
+kd = isdongle(peasycap);
 switch (bInterfaceNumber) {
 case 0: {
+       if (0 <= kd && DONGLE_MANY > kd) {
+               wake_up_interruptible(&peasycap->wq_video);
+               JOM(4, "about to lock easycap_dongle[%i].mutex_video\n", kd);
+               if (mutex_lock_interruptible(&easycap_dongle[kd].\
+                                                               mutex_video)) {
+                       SAY("ERROR: cannot lock easycap_dongle[%i]." \
+                                                       "mutex_video\n", kd);
+                       return;
+               }
+               JOM(4, "locked easycap_dongle[%i].mutex_video\n", kd);
+       } else
+               SAY("ERROR: %i=kd is bad: cannot lock dongle\n", kd);
+/*---------------------------------------------------------------------------*/
 #if (!defined(EASYCAP_IS_VIDEODEV_CLIENT))
        if ((struct easycap *)NULL == peasycap) {
-               SAY("ERROR: peasycap has become NULL\n");
+               SAM("ERROR: peasycap has become NULL\n");
        } else {
-               lock_kernel();
                usb_deregister_dev(pusb_interface, &easycap_class);
                (peasycap->registered_video)--;
-
-               JOT(4, "intf[%i]: usb_deregister_dev()\n", bInterfaceNumber);
-               unlock_kernel();
-               SAY("easycap detached from minor #%d\n", minor);
+               JOM(4, "intf[%i]: usb_deregister_dev()\n", bInterfaceNumber);
+               SAM("easycap detached from minor #%d\n", minor);
        }
-/*vvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvv*/
+/*vvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvv*/
 #else
-       if ((struct easycap *)NULL == peasycap)
-               SAY("ERROR: peasycap has become NULL\n");
-       else {
-               lock_kernel();
-               video_unregister_device(peasycap->pvideo_device);
-               (peasycap->registered_video)--;
-               unlock_kernel();
-               JOT(4, "unregistered with videodev: %i=minor\n", \
-                                                       pvideo_device->minor);
+#if defined(EASYCAP_NEEDS_V4L2_DEVICE_H)
+       if (!peasycap->v4l2_device.name[0]) {
+               SAM("ERROR: peasycap->v4l2_device.name is empty\n");
+               if (0 <= kd && DONGLE_MANY > kd)
+                       mutex_unlock(&easycap_dongle[kd].mutex_video);
+               return;
        }
-/*^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^*/
+       v4l2_device_disconnect(&peasycap->v4l2_device);
+       JOM(4, "v4l2_device_disconnect() OK\n");
+       v4l2_device_unregister(&peasycap->v4l2_device);
+       JOM(4, "v4l2_device_unregister() OK\n");
+#endif /*EASYCAP_NEEDS_V4L2_DEVICE_H*/
+
+       video_unregister_device(&peasycap->video_device);
+       JOM(4, "intf[%i]: video_unregister_device() OK\n", bInterfaceNumber);
+       (peasycap->registered_video)--;
+       JOM(4, "unregistered with videodev: %i=minor\n", minor);
 #endif /*EASYCAP_IS_VIDEODEV_CLIENT*/
+/*^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^*/
+
+       if (0 <= kd && DONGLE_MANY > kd) {
+               mutex_unlock(&easycap_dongle[kd].mutex_video);
+               JOM(4, "unlocked easycap_dongle[%i].mutex_video\n", kd);
+       }
        break;
 }
 case 2: {
-       lock_kernel();
+       if (0 <= kd && DONGLE_MANY > kd) {
+               wake_up_interruptible(&peasycap->wq_audio);
+               JOM(4, "about to lock easycap_dongle[%i].mutex_audio\n", kd);
+               if (mutex_lock_interruptible(&easycap_dongle[kd].\
+                                                               mutex_audio)) {
+                       SAY("ERROR: cannot lock easycap_dongle[%i]." \
+                                                       "mutex_audio\n", kd);
+                       return;
+               }
+               JOM(4, "locked easycap_dongle[%i].mutex_audio\n", kd);
+       } else
+               SAY("ERROR: %i=kd is bad: cannot lock dongle\n", kd);
 
        usb_deregister_dev(pusb_interface, &easysnd_class);
-       if ((struct easycap *)NULL != peasycap)
-               (peasycap->registered_audio)--;
+       (peasycap->registered_audio)--;
 
-       JOT(4, "intf[%i]: usb_deregister_dev()\n", bInterfaceNumber);
-       unlock_kernel();
+       JOM(4, "intf[%i]: usb_deregister_dev()\n", bInterfaceNumber);
+       SAM("easysnd detached from minor #%d\n", minor);
 
-       SAY("easysnd detached from minor #%d\n", minor);
+       if (0 <= kd && DONGLE_MANY > kd) {
+               mutex_unlock(&easycap_dongle[kd].mutex_audio);
+               JOM(4, "unlocked easycap_dongle[%i].mutex_audio\n", kd);
+       }
        break;
 }
 default:
@@ -4280,25 +4963,42 @@ default:
  *  CALL easycap_delete() IF NO REMAINING REFERENCES TO peasycap
  */
 /*---------------------------------------------------------------------------*/
-if ((struct easycap *)NULL == peasycap) {
-       SAY("ERROR: peasycap has become NULL\n");
-       SAY("cannot call kref_put()\n");
-       SAY("ending unsuccessfully: may cause memory leak\n");
-       return;
-}
 if (!peasycap->kref.refcount.counter) {
-       SAY("ERROR: peasycap->kref.refcount.counter is zero " \
+       SAM("ERROR: peasycap->kref.refcount.counter is zero "
                                                "so cannot call kref_put()\n");
-       SAY("ending unsuccessfully: may cause memory leak\n");
+       SAM("ending unsuccessfully: may cause memory leak\n");
        return;
 }
-JOT(4, "intf[%i]: kref_put() with %i=peasycap->kref.refcount.counter\n", \
+if (0 <= kd && DONGLE_MANY > kd) {
+       JOM(4, "about to lock easycap_dongle[%i].mutex_video\n", kd);
+       if (mutex_lock_interruptible(&easycap_dongle[kd].mutex_video)) {
+               SAY("ERROR: cannot down easycap_dongle[%i].mutex_video\n", kd);
+               SAM("ending unsuccessfully: may cause memory leak\n");
+       return;
+       }
+       JOM(4, "locked easycap_dongle[%i].mutex_video\n", kd);
+       JOM(4, "about to lock easycap_dongle[%i].mutex_audio\n", kd);
+       if (mutex_lock_interruptible(&easycap_dongle[kd].mutex_audio)) {
+               SAY("ERROR: cannot down easycap_dongle[%i].mutex_audio\n", kd);
+               mutex_unlock(&(easycap_dongle[kd].mutex_video));
+               JOM(4, "unlocked easycap_dongle[%i].mutex_video\n", kd);
+               SAM("ending unsuccessfully: may cause memory leak\n");
+               return;
+       }
+       JOM(4, "locked easycap_dongle[%i].mutex_audio\n", kd);
+}
+JOM(4, "intf[%i]: %i=peasycap->kref.refcount.counter\n", \
                bInterfaceNumber, (int)peasycap->kref.refcount.counter);
 kref_put(&peasycap->kref, easycap_delete);
 JOT(4, "intf[%i]: kref_put() done.\n", bInterfaceNumber);
+if (0 <= kd && DONGLE_MANY > kd) {
+       mutex_unlock(&(easycap_dongle[kd].mutex_audio));
+       JOT(4, "unlocked easycap_dongle[%i].mutex_audio\n", kd);
+       mutex_unlock(&easycap_dongle[kd].mutex_video);
+       JOT(4, "unlocked easycap_dongle[%i].mutex_video\n", kd);
+}
 /*---------------------------------------------------------------------------*/
-
-JOT(4, "ends\n");
+JOM(4, "ends\n");
 return;
 }
 /*****************************************************************************/
@@ -4308,7 +5008,8 @@ easycap_module_init(void)
 int result;
 
 SAY("========easycap=======\n");
-JOT(4, "begins.  %i=debug\n", easycap_debug);
+JOT(4, "begins.  %i=debug %i=bars %i=gain\n", easycap_debug, easycap_bars, \
+                                               easycap_gain);
 SAY("version: " EASYCAP_DRIVER_VERSION "\n");
 /*---------------------------------------------------------------------------*/
 /*
@@ -4349,6 +5050,9 @@ MODULE_AUTHOR("R.M. Thomas <rmthomas@sciolus.org>");
 MODULE_DESCRIPTION(EASYCAP_DRIVER_DESCRIPTION);
 MODULE_VERSION(EASYCAP_DRIVER_VERSION);
 #if defined(EASYCAP_DEBUG)
-MODULE_PARM_DESC(easycap_debug, "debug: 0 (default), 1, 2,...");
+MODULE_PARM_DESC(debug, "Debug level: 0(default),1,2,...,9");
 #endif /*EASYCAP_DEBUG*/
+MODULE_PARM_DESC(bars, \
+       "Testcard bars on input signal failure: 0=>no, 1=>yes(default)");
+MODULE_PARM_DESC(gain, "Audio gain: 0,...,16(default),...31");
 /*****************************************************************************/