usb/hid/keyboard_mouse_combo/riitek_rt-mwk01/README

   1 -------------------------------------------------------------------------------
   2 USB HID (low-speed signalling)
   3 -------------------------------------------------------------------------------
   4
   5 This is a set of example captures of USB/HID communication on the
   6 keyboard/mouse combo device Riitek RT-MWK01.
   7
   8 Details:
   9 http://www.riitek.com/product_Info.asp?id=56
  10
  11
  12 HID dump
  13 --------
  14
  15 For a HOWTO, see:
  16 http://lists.en.qi-hardware.com/pipermail/discussion/2011-November/009206.html
  17
  18   Usage Page (Desktop),               ; Generic desktop controls (01h)
  19   Usage (Mouse),                      ; Mouse (02h, application collection)
  20   Collection (Application),
  21       Usage (Pointer),                ; Pointer (01h, physical collection)
  22       Collection (Physical),
  23           Report ID (1),
  24           Report Count (3),
  25           Report Size (1),
  26           Usage Page (Button),        ; Button (09h)
  27           Usage Minimum (01h),
  28           Usage Maximum (03h),
  29           Logical Minimum (0),
  30           Logical Maximum (1),
  31           Input (Variable),
  32           Report Count (1),
  33           Report Size (5),
  34           Input (Constant),
  35           Report Size (8),
  36           Report Count (2),
  37           Usage Page (Desktop),       ; Generic desktop controls (01h)
  38           Usage (X),                  ; X (30h, dynamic value)
  39           Usage (Y),                  ; Y (31h, dynamic value)
  40           Logical Minimum (-127),
  41           Logical Maximum (127),
  42           Input (Variable, Relative),
  43       End Collection,
  44       Collection (Physical),
  45           Report Count (1),
  46           Report Size (8),
  47           Usage Page (Desktop),       ; Generic desktop controls (01h)
  48           Usage (Wheel),              ; Wheel (38h, dynamic value)
  49           Logical Minimum (-127),
  50           Logical Maximum (127),
  51           Input (Variable, Relative),
  52       End Collection,
  53   End Collection,
  54   Usage Page (Consumer),              ; Consumer (0Ch)
  55   Usage (Consumer Control),           ; Consumer control (01h, application collection)
  56   Collection (Application),
  57       Report ID (2),
  58       Usage Minimum (00h),
  59       Usage Maximum (AC Format),      ; AC format (023Ch, selector)
  60       Logical Minimum (0),
  61       Logical Maximum (572),
  62       Report Count (1),
  63       Report Size (16),
  64       Input,
  65   End Collection,
  66   Usage Page (Desktop),               ; Generic desktop controls (01h)
  67   Usage (Keyboard),                   ; Keyboard (06h, application collection)
  68   Collection (Application),
  69       Usage Page (Keyboard),          ; Keyboard/keypad (07h)
  70       Usage Minimum (KB Leftcontrol), ; Keyboard left control (E0h, dynamic value)
  71       Usage Maximum (KB Right GUI),   ; Keyboard right GUI (E7h, dynamic value)
  72       Logical Minimum (0),
  73       Logical Maximum (1),
  74       Report Size (1),
  75       Report Count (8),
  76       Input (Variable),
  77       Report Count (1),
  78       Report Size (8),
  79       Input (Constant),
  80       Report Count (5),
  81       Report Size (1),
  82       Usage Page (LED),               ; LEDs (08h)
  83       Usage Minimum (01h),
  84       Usage Maximum (05h),
  85       Output (Variable),
  86       Report Count (1),
  87       Report Size (3),
  88       Output (Constant),
  89       Report Count (6),
  90       Report Size (8),
  91       Logical Minimum (0),
  92       Logical Maximum (-107),
  93       Usage Page (Keyboard),          ; Keyboard/keypad (07h)
  94       Usage Minimum (None),           ; No event (00h, selector)
  95       Usage Maximum (KB LANG6),       ; Keyboard LANG6 (95h, selector)
  96       Input,
  97   End Collection
  98
  99
 100 lsusb -v -d 1997:0409
 101 ---------------------
 102
 103   Bus 002 Device 093: ID 1997:0409
 104   Device Descriptor:
 105     bLength                18
 106     bDescriptorType         1
 107     bcdUSB               2.00
 108     bDeviceClass            0 (Defined at Interface level)
 109     bDeviceSubClass         0
 110     bDeviceProtocol         0
 111     bMaxPacketSize0         8
 112     idVendor           0x1997
 113     idProduct          0x0409
 114     bcdDevice            2.00
 115     iManufacturer           1 Riitek
 116     iProduct                2 Micro Keyboard
 117     iSerial                 0
 118     bNumConfigurations      1
 119     Configuration Descriptor:
 120       bLength                 9
 121       bDescriptorType         2
 122       wTotalLength           59
 123       bNumInterfaces          2
 124       bConfigurationValue     1
 125       iConfiguration          0
 126       bmAttributes         0xa0
 127         (Bus Powered)
 128         Remote Wakeup
 129       MaxPower              100mA
 130       Interface Descriptor:
 131         bLength                 9
 132         bDescriptorType         4
 133         bInterfaceNumber        0
 134         bAlternateSetting       0
 135         bNumEndpoints           1
 136         bInterfaceClass         3 Human Interface Device
 137         bInterfaceSubClass      1 Boot Interface Subclass
 138         bInterfaceProtocol      1 Keyboard
 139         iInterface              0
 140           HID Device Descriptor:
 141             bLength                 9
 142             bDescriptorType        33
 143             bcdHID               1.11
 144             bCountryCode            0 Not supported
 145             bNumDescriptors         1
 146             bDescriptorType        34 Report
 147             wDescriptorLength      63
 148            Report Descriptors:
 149              ** UNAVAILABLE **
 150         Endpoint Descriptor:
 151           bLength                 7
 152           bDescriptorType         5
 153           bEndpointAddress     0x81  EP 1 IN
 154           bmAttributes            3
 155             Transfer Type            Interrupt
 156             Synch Type               None
 157             Usage Type               Data
 158           wMaxPacketSize     0x0008  1x 8 bytes
 159           bInterval              10
 160       Interface Descriptor:
 161         bLength                 9
 162         bDescriptorType         4
 163         bInterfaceNumber        1
 164         bAlternateSetting       0
 165         bNumEndpoints           1
 166         bInterfaceClass         3 Human Interface Device
 167         bInterfaceSubClass      1 Boot Interface Subclass
 168         bInterfaceProtocol      2 Mouse
 169         iInterface              0
 170           HID Device Descriptor:
 171             bLength                 9
 172             bDescriptorType        33
 173             bcdHID               1.11
 174             bCountryCode            0 Not supported
 175             bNumDescriptors         1
 176             bDescriptorType        34 Report
 177             wDescriptorLength      94
 178            Report Descriptors:
 179              ** UNAVAILABLE **
 180         Endpoint Descriptor:
 181           bLength                 7
 182           bDescriptorType         5
 183           bEndpointAddress     0x82  EP 2 IN
 184           bmAttributes            3
 185             Transfer Type            Interrupt
 186             Synch Type               None
 187             Usage Type               Data
 188           wMaxPacketSize     0x0008  1x 8 bytes
 189           bInterval              10
 190   Device Status:     0x0000
 191     (Bus Powered)
 192
 193
 194 Logic analyzer setup
 195 --------------------
 196
 197 The logic analyzer used was an ARMFLY Mini-Logic (at 24MHz):
 198
 199   Probe       RT-MWK01
 200   --------------------
 201   0           DM
 202   1           DP
 203
 204
 205 rt-mwk01.sr
 206 -----------
 207
 208 The sigrok command line used was:
 209
 210   sigrok-cli -d 0:samplerate=24mhz --time 1s -o rt-mwk01.sr --probes 1,2
 211
 212 (the user pressed 'q' again and again; there was no mouse movement)
 213