[sigrok-dumps.git] / usb / hid / keyboard_mouse_combo / riitek_rt-mwk01 / README

-------------------------------------------------------------------------------
USB HID (low-speed signalling)
-------------------------------------------------------------------------------

This is a set of example captures of USB/HID communication on the
keyboard/mouse combo device Riitek RT-MWK01.

Details:
http://www.riitek.com/product_Info.asp?id=56


HID dump
--------

For a HOWTO, see:
http://lists.en.qi-hardware.com/pipermail/discussion/2011-November/009206.html

  Usage Page (Desktop),               ; Generic desktop controls (01h)
  Usage (Mouse),                      ; Mouse (02h, application collection)
  Collection (Application),
      Usage (Pointer),                ; Pointer (01h, physical collection)
      Collection (Physical),
          Report ID (1),
          Report Count (3),
          Report Size (1),
          Usage Page (Button),        ; Button (09h)
          Usage Minimum (01h),
          Usage Maximum (03h),
          Logical Minimum (0),
          Logical Maximum (1),
          Input (Variable),
          Report Count (1),
          Report Size (5),
          Input (Constant),
          Report Size (8),
          Report Count (2),
          Usage Page (Desktop),       ; Generic desktop controls (01h)
          Usage (X),                  ; X (30h, dynamic value)
          Usage (Y),                  ; Y (31h, dynamic value)
          Logical Minimum (-127),
          Logical Maximum (127),
          Input (Variable, Relative),
      End Collection,
      Collection (Physical),
          Report Count (1),
          Report Size (8),
          Usage Page (Desktop),       ; Generic desktop controls (01h)
          Usage (Wheel),              ; Wheel (38h, dynamic value)
          Logical Minimum (-127),
          Logical Maximum (127),
          Input (Variable, Relative),
      End Collection,
  End Collection,
  Usage Page (Consumer),              ; Consumer (0Ch)
  Usage (Consumer Control),           ; Consumer control (01h, application collection)
  Collection (Application),
      Report ID (2),
      Usage Minimum (00h),
      Usage Maximum (AC Format),      ; AC format (023Ch, selector)
      Logical Minimum (0),
      Logical Maximum (572),
      Report Count (1),
      Report Size (16),
      Input,
  End Collection,
  Usage Page (Desktop),               ; Generic desktop controls (01h)
  Usage (Keyboard),                   ; Keyboard (06h, application collection)
  Collection (Application),
      Usage Page (Keyboard),          ; Keyboard/keypad (07h)
      Usage Minimum (KB Leftcontrol), ; Keyboard left control (E0h, dynamic value)
      Usage Maximum (KB Right GUI),   ; Keyboard right GUI (E7h, dynamic value)
      Logical Minimum (0),
      Logical Maximum (1),
      Report Size (1),
      Report Count (8),
      Input (Variable),
      Report Count (1),
      Report Size (8),
      Input (Constant),
      Report Count (5),
      Report Size (1),
      Usage Page (LED),               ; LEDs (08h)
      Usage Minimum (01h),
      Usage Maximum (05h),
      Output (Variable),
      Report Count (1),
      Report Size (3),
      Output (Constant),
      Report Count (6),
      Report Size (8),
      Logical Minimum (0),
      Logical Maximum (-107),
      Usage Page (Keyboard),          ; Keyboard/keypad (07h)
      Usage Minimum (None),           ; No event (00h, selector)
      Usage Maximum (KB LANG6),       ; Keyboard LANG6 (95h, selector)
      Input,
  End Collection


lsusb -v -d 1997:0409
---------------------

  Bus 002 Device 093: ID 1997:0409
  Device Descriptor:
    bLength                18
    bDescriptorType         1
    bcdUSB               2.00
    bDeviceClass            0 (Defined at Interface level)
    bDeviceSubClass         0 
    bDeviceProtocol         0 
    bMaxPacketSize0         8
    idVendor           0x1997 
    idProduct          0x0409 
    bcdDevice            2.00
    iManufacturer           1 Riitek
    iProduct                2 Micro Keyboard
    iSerial                 0 
    bNumConfigurations      1
    Configuration Descriptor:
      bLength                 9
      bDescriptorType         2
      wTotalLength           59
      bNumInterfaces          2
      bConfigurationValue     1
      iConfiguration          0 
      bmAttributes         0xa0
        (Bus Powered)
        Remote Wakeup
      MaxPower              100mA
      Interface Descriptor:
        bLength                 9
        bDescriptorType         4
        bInterfaceNumber        0
        bAlternateSetting       0
        bNumEndpoints           1
        bInterfaceClass         3 Human Interface Device
        bInterfaceSubClass      1 Boot Interface Subclass
        bInterfaceProtocol      1 Keyboard
        iInterface              0 
          HID Device Descriptor:
            bLength                 9
            bDescriptorType        33
            bcdHID               1.11
            bCountryCode            0 Not supported
            bNumDescriptors         1
            bDescriptorType        34 Report
            wDescriptorLength      63
           Report Descriptors: 
             ** UNAVAILABLE **
        Endpoint Descriptor:
          bLength                 7
          bDescriptorType         5
          bEndpointAddress     0x81  EP 1 IN
          bmAttributes            3
            Transfer Type            Interrupt
            Synch Type               None
            Usage Type               Data
          wMaxPacketSize     0x0008  1x 8 bytes
          bInterval              10
      Interface Descriptor:
        bLength                 9
        bDescriptorType         4
        bInterfaceNumber        1
        bAlternateSetting       0
        bNumEndpoints           1
        bInterfaceClass         3 Human Interface Device
        bInterfaceSubClass      1 Boot Interface Subclass
        bInterfaceProtocol      2 Mouse
        iInterface              0 
          HID Device Descriptor:
            bLength                 9
            bDescriptorType        33
            bcdHID               1.11
            bCountryCode            0 Not supported
            bNumDescriptors         1
            bDescriptorType        34 Report
            wDescriptorLength      94
           Report Descriptors: 
             ** UNAVAILABLE **
        Endpoint Descriptor:
          bLength                 7
          bDescriptorType         5
          bEndpointAddress     0x82  EP 2 IN
          bmAttributes            3
            Transfer Type            Interrupt
            Synch Type               None
            Usage Type               Data
          wMaxPacketSize     0x0008  1x 8 bytes
          bInterval              10
  Device Status:     0x0000
    (Bus Powered)


Logic analyzer setup
--------------------

The logic analyzer used was an ARMFLY Mini-Logic (at 24MHz):

  Probe       RT-MWK01
  --------------------
  0           DM
  1           DP


rt-mwk01.sr
-----------

The sigrok command line used was:

  sigrok-cli -d 0:samplerate=24mhz --time 1s -o rt-mwk01.sr --probes 1,2
Commit	Line	Data
541542ef UH	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