linux-imx/drivers/usb
Maksim Salau 76eee06dea usb: cdc_acm: Add quirk for Elatec TWN3
commit 765fb2f181 upstream.

Elatec TWN3 has the union descriptor on data interface. This results in
failure to bind the device to the driver with the following log:
  usb 1-1.2: new full speed USB device using streamplug-ehci and address 4
  usb 1-1.2: New USB device found, idVendor=09d8, idProduct=0320
  usb 1-1.2: New USB device strings: Mfr=1, Product=2, SerialNumber=0
  usb 1-1.2: Product: RFID Device (COM)
  usb 1-1.2: Manufacturer: OEM
  cdc_acm 1-1.2:1.0: Zero length descriptor references
  cdc_acm: probe of 1-1.2:1.0 failed with error -22

Adding the NO_UNION_NORMAL quirk for the device fixes the issue.

`lsusb -v` of the device:

Bus 001 Device 003: ID 09d8:0320
Device Descriptor:
  bLength                18
  bDescriptorType         1
  bcdUSB               2.00
  bDeviceClass            2 Communications
  bDeviceSubClass         0
  bDeviceProtocol         0
  bMaxPacketSize0        32
  idVendor           0x09d8
  idProduct          0x0320
  bcdDevice            3.00
  iManufacturer           1 OEM
  iProduct                2 RFID Device (COM)
  iSerial                 0
  bNumConfigurations      1
  Configuration Descriptor:
    bLength                 9
    bDescriptorType         2
    wTotalLength           67
    bNumInterfaces          2
    bConfigurationValue     1
    iConfiguration          0
    bmAttributes         0x80
      (Bus Powered)
    MaxPower              250mA
    Interface Descriptor:
      bLength                 9
      bDescriptorType         4
      bInterfaceNumber        0
      bAlternateSetting       0
      bNumEndpoints           1
      bInterfaceClass         2 Communications
      bInterfaceSubClass      2 Abstract (modem)
      bInterfaceProtocol      1 AT-commands (v.25ter)
      iInterface              0
      Endpoint Descriptor:
        bLength                 7
        bDescriptorType         5
        bEndpointAddress     0x83  EP 3 IN
        bmAttributes            3
          Transfer Type            Interrupt
          Synch Type               None
          Usage Type               Data
        wMaxPacketSize     0x0020  1x 32 bytes
        bInterval               2
    Interface Descriptor:
      bLength                 9
      bDescriptorType         4
      bInterfaceNumber        1
      bAlternateSetting       0
      bNumEndpoints           2
      bInterfaceClass        10 CDC Data
      bInterfaceSubClass      0 Unused
      bInterfaceProtocol      0
      iInterface              0
      Endpoint Descriptor:
        bLength                 7
        bDescriptorType         5
        bEndpointAddress     0x02  EP 2 OUT
        bmAttributes            2
          Transfer Type            Bulk
          Synch Type               None
          Usage Type               Data
        wMaxPacketSize     0x0020  1x 32 bytes
        bInterval               0
      Endpoint Descriptor:
        bLength                 7
        bDescriptorType         5
        bEndpointAddress     0x81  EP 1 IN
        bmAttributes            2
          Transfer Type            Bulk
          Synch Type               None
          Usage Type               Data
        wMaxPacketSize     0x0020  1x 32 bytes
        bInterval               0
      CDC Header:
        bcdCDC               1.10
      CDC Call Management:
        bmCapabilities       0x03
          call management
          use DataInterface
        bDataInterface          1
      CDC ACM:
        bmCapabilities       0x06
          sends break
          line coding and serial state
      CDC Union:
        bMasterInterface        0
        bSlaveInterface         1
Device Status:     0x0000
  (Bus Powered)

Signed-off-by: Maksim Salau <msalau@iotecha.com>
Acked-by: Oliver Neukum <oneukum@suse.com>
Signed-off-by: Greg Kroah-Hartman <gregkh@linuxfoundation.org>
Signed-off-by: Ben Hutchings <ben@decadent.org.uk>
2018-01-01 20:50:59 +00:00
..
atm USB: cxacru: potential underflow in cxacru_cm_get_array() 2013-05-30 14:35:04 +01:00
c67x00 usb: Add module.h to drivers/usb consumers who really use it. 2011-10-31 19:31:25 -04:00
class usb: cdc_acm: Add quirk for Elatec TWN3 2018-01-01 20:50:59 +00:00
core usb: Increase quirk delay for USB devices 2018-01-01 20:50:49 +00:00
dwc3 usb: dwc3: gadget: make Set Endpoint Configuration macros safe 2017-07-18 18:38:30 +01:00
early USB: echi-dbgp: increase the controller wait time to come out of halt. 2012-08-10 00:25:07 +01:00
gadget USB: dummy-hcd: Fix deadlock caused by disconnect detection 2018-01-01 20:50:56 +00:00
host usb: pci-quirks.c: Corrected timeout values used in handshake 2018-01-01 20:50:50 +00:00
image atomic: use <linux/atomic.h> 2011-07-26 16:49:47 -07:00
misc usb: usbtest: fix NULL pointer dereference 2017-11-11 13:34:40 +00:00
mon usb: Add export.h for EXPORT_SYMBOL/THIS_MODULE where needed 2011-10-31 19:31:25 -04:00
musb usb: musb: tusb6010_omap: Do not reset the other direction's packet size 2017-09-15 18:30:45 +01:00
otg usb: Add export.h for EXPORT_SYMBOL/THIS_MODULE where needed 2011-10-31 19:31:25 -04:00
renesas_usbhs usb: renesas_usbhs: Fix DMAC sequence for receiving zero-length packet 2018-01-01 20:50:57 +00:00
serial USB: serial: cp210x: add support for ELV TFD500 2018-01-01 20:50:50 +00:00
storage usb-storage: unusual_devs entry to fix write-access regression for Seagate external drives 2018-01-01 20:50:51 +00:00
wusbcore USB: wusbcore: fix NULL-deref at probe 2017-07-18 18:38:32 +01:00
Kconfig Merge branch 'upstream' of git://git.linux-mips.org/pub/scm/ralf/upstream-linus 2011-11-03 13:28:14 -07:00
Makefile usb: Provide usb_speed_string() function 2011-09-18 01:29:04 -07:00
README
usb-common.c usb: Provide usb_speed_string() function 2011-09-18 01:29:04 -07:00
usb-skeleton.c USB: use usb_endpoint_maxp() instead of le16_to_cpu() 2011-08-23 09:47:40 -07:00

To understand all the Linux-USB framework, you'll use these resources:

* This source code.  This is necessarily an evolving work, and
  includes kerneldoc that should help you get a current overview.
  ("make pdfdocs", and then look at "usb.pdf" for host side and
  "gadget.pdf" for peripheral side.)  Also, Documentation/usb has
  more information.

* The USB 2.0 specification (from www.usb.org), with supplements
  such as those for USB OTG and the various device classes.
  The USB specification has a good overview chapter, and USB
  peripherals conform to the widely known "Chapter 9".

* Chip specifications for USB controllers.  Examples include
  host controllers (on PCs, servers, and more); peripheral
  controllers (in devices with Linux firmware, like printers or
  cell phones); and hard-wired peripherals like Ethernet adapters.

* Specifications for other protocols implemented by USB peripheral
  functions.  Some are vendor-specific; others are vendor-neutral
  but just standardized outside of the www.usb.org team.

Here is a list of what each subdirectory here is, and what is contained in them.

core/ - This is for the core USB host code, including the usbfs files and the hub class driver ("khubd").

host/ - This is for USB host controller drivers. This includes UHCI, OHCI, EHCI, and others that might be used with more specialized "embedded" systems.

gadget/ - This is for USB peripheral controller drivers and the various gadget drivers which talk to them.

Individual USB driver directories. A new driver should be added to the first subdirectory in the list below that it fits into.

image/ - This is for still image drivers, like scanners or digital cameras. ../input/ - This is for any driver that uses the input subsystem, like keyboard, mice, touchscreens, tablets, etc. ../media/ - This is for multimedia drivers, like video cameras, radios, and any other drivers that talk to the v4l subsystem. ../net/ - This is for network drivers. serial/ - This is for USB to serial drivers. storage/ - This is for USB mass-storage drivers. class/ - This is for all USB device drivers that do not fit into any of the above categories, and work for a range of USB Class specified devices. misc/ - This is for all USB device drivers that do not fit into any of the above categories.