1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34#ifndef _UAPI__LINUX_USB_CH9_H
35#define _UAPI__LINUX_USB_CH9_H
36
37#include <linux/types.h>
38#include <asm/byteorder.h>
39
40
41
42
43
44
45
46
47
48
49
50#define USB_DIR_OUT 0
51#define USB_DIR_IN 0x80
52
53
54
55
56#define USB_TYPE_MASK (0x03 << 5)
57#define USB_TYPE_STANDARD (0x00 << 5)
58#define USB_TYPE_CLASS (0x01 << 5)
59#define USB_TYPE_VENDOR (0x02 << 5)
60#define USB_TYPE_RESERVED (0x03 << 5)
61
62
63
64
65#define USB_RECIP_MASK 0x1f
66#define USB_RECIP_DEVICE 0x00
67#define USB_RECIP_INTERFACE 0x01
68#define USB_RECIP_ENDPOINT 0x02
69#define USB_RECIP_OTHER 0x03
70
71#define USB_RECIP_PORT 0x04
72#define USB_RECIP_RPIPE 0x05
73
74
75
76
77
78
79
80
81#define USB_REQ_GET_STATUS 0x00
82#define USB_REQ_CLEAR_FEATURE 0x01
83#define USB_REQ_SET_FEATURE 0x03
84#define USB_REQ_SET_ADDRESS 0x05
85#define USB_REQ_GET_DESCRIPTOR 0x06
86#define USB_REQ_SET_DESCRIPTOR 0x07
87#define USB_REQ_GET_CONFIGURATION 0x08
88#define USB_REQ_SET_CONFIGURATION 0x09
89#define USB_REQ_GET_INTERFACE 0x0A
90#define USB_REQ_SET_INTERFACE 0x0B
91#define USB_REQ_SYNCH_FRAME 0x0C
92#define USB_REQ_SET_SEL 0x30
93#define USB_REQ_SET_ISOCH_DELAY 0x31
94
95#define USB_REQ_SET_ENCRYPTION 0x0D
96#define USB_REQ_GET_ENCRYPTION 0x0E
97#define USB_REQ_RPIPE_ABORT 0x0E
98#define USB_REQ_SET_HANDSHAKE 0x0F
99#define USB_REQ_RPIPE_RESET 0x0F
100#define USB_REQ_GET_HANDSHAKE 0x10
101#define USB_REQ_SET_CONNECTION 0x11
102#define USB_REQ_SET_SECURITY_DATA 0x12
103#define USB_REQ_GET_SECURITY_DATA 0x13
104#define USB_REQ_SET_WUSB_DATA 0x14
105#define USB_REQ_LOOPBACK_DATA_WRITE 0x15
106#define USB_REQ_LOOPBACK_DATA_READ 0x16
107#define USB_REQ_SET_INTERFACE_DS 0x17
108
109
110#define USB_REQ_GET_PARTNER_PDO 20
111#define USB_REQ_GET_BATTERY_STATUS 21
112#define USB_REQ_SET_PDO 22
113#define USB_REQ_GET_VDM 23
114#define USB_REQ_SEND_VDM 24
115
116
117
118
119
120
121
122
123
124
125
126
127#define USB_DEVICE_SELF_POWERED 0
128#define USB_DEVICE_REMOTE_WAKEUP 1
129#define USB_DEVICE_TEST_MODE 2
130#define USB_DEVICE_BATTERY 2
131#define USB_DEVICE_B_HNP_ENABLE 3
132#define USB_DEVICE_WUSB_DEVICE 3
133#define USB_DEVICE_A_HNP_SUPPORT 4
134#define USB_DEVICE_A_ALT_HNP_SUPPORT 5
135#define USB_DEVICE_DEBUG_MODE 6
136
137
138
139
140
141#define USB_TEST_J 1
142#define USB_TEST_K 2
143#define USB_TEST_SE0_NAK 3
144#define USB_TEST_PACKET 4
145#define USB_TEST_FORCE_ENABLE 5
146
147
148#define USB_STATUS_TYPE_STANDARD 0
149#define USB_STATUS_TYPE_PTM 1
150
151
152
153
154
155#define USB_DEVICE_U1_ENABLE 48
156#define USB_DEVICE_U2_ENABLE 49
157#define USB_DEVICE_LTM_ENABLE 50
158#define USB_INTRF_FUNC_SUSPEND 0
159
160#define USB_INTR_FUNC_SUSPEND_OPT_MASK 0xFF00
161
162
163
164#define USB_INTRF_FUNC_SUSPEND_LP (1 << (8 + 0))
165#define USB_INTRF_FUNC_SUSPEND_RW (1 << (8 + 1))
166
167
168
169
170#define USB_INTRF_STAT_FUNC_RW_CAP 1
171#define USB_INTRF_STAT_FUNC_RW 2
172
173#define USB_ENDPOINT_HALT 0
174
175
176#define USB_DEV_STAT_U1_ENABLED 2
177#define USB_DEV_STAT_U2_ENABLED 3
178#define USB_DEV_STAT_LTM_ENABLED 4
179
180
181
182
183#define USB_DEVICE_BATTERY_WAKE_MASK 40
184#define USB_DEVICE_OS_IS_PD_AWARE 41
185#define USB_DEVICE_POLICY_MODE 42
186#define USB_PORT_PR_SWAP 43
187#define USB_PORT_GOTO_MIN 44
188#define USB_PORT_RETURN_POWER 45
189#define USB_PORT_ACCEPT_PD_REQUEST 46
190#define USB_PORT_REJECT_PD_REQUEST 47
191#define USB_PORT_PORT_PD_RESET 48
192#define USB_PORT_C_PORT_PD_CHANGE 49
193#define USB_PORT_CABLE_PD_RESET 50
194#define USB_DEVICE_CHARGING_POLICY 54
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213struct usb_ctrlrequest {
214 __u8 bRequestType;
215 __u8 bRequest;
216 __le16 wValue;
217 __le16 wIndex;
218 __le16 wLength;
219} __attribute__ ((packed));
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240#define USB_DT_DEVICE 0x01
241#define USB_DT_CONFIG 0x02
242#define USB_DT_STRING 0x03
243#define USB_DT_INTERFACE 0x04
244#define USB_DT_ENDPOINT 0x05
245#define USB_DT_DEVICE_QUALIFIER 0x06
246#define USB_DT_OTHER_SPEED_CONFIG 0x07
247#define USB_DT_INTERFACE_POWER 0x08
248
249#define USB_DT_OTG 0x09
250#define USB_DT_DEBUG 0x0a
251#define USB_DT_INTERFACE_ASSOCIATION 0x0b
252
253#define USB_DT_SECURITY 0x0c
254#define USB_DT_KEY 0x0d
255#define USB_DT_ENCRYPTION_TYPE 0x0e
256#define USB_DT_BOS 0x0f
257#define USB_DT_DEVICE_CAPABILITY 0x10
258#define USB_DT_WIRELESS_ENDPOINT_COMP 0x11
259#define USB_DT_WIRE_ADAPTER 0x21
260#define USB_DT_RPIPE 0x22
261#define USB_DT_CS_RADIO_CONTROL 0x23
262
263#define USB_DT_PIPE_USAGE 0x24
264
265#define USB_DT_SS_ENDPOINT_COMP 0x30
266
267#define USB_DT_SSP_ISOC_ENDPOINT_COMP 0x31
268
269
270
271
272
273#define USB_DT_CS_DEVICE (USB_TYPE_CLASS | USB_DT_DEVICE)
274#define USB_DT_CS_CONFIG (USB_TYPE_CLASS | USB_DT_CONFIG)
275#define USB_DT_CS_STRING (USB_TYPE_CLASS | USB_DT_STRING)
276#define USB_DT_CS_INTERFACE (USB_TYPE_CLASS | USB_DT_INTERFACE)
277#define USB_DT_CS_ENDPOINT (USB_TYPE_CLASS | USB_DT_ENDPOINT)
278
279
280struct usb_descriptor_header {
281 __u8 bLength;
282 __u8 bDescriptorType;
283} __attribute__ ((packed));
284
285
286
287
288
289struct usb_device_descriptor {
290 __u8 bLength;
291 __u8 bDescriptorType;
292
293 __le16 bcdUSB;
294 __u8 bDeviceClass;
295 __u8 bDeviceSubClass;
296 __u8 bDeviceProtocol;
297 __u8 bMaxPacketSize0;
298 __le16 idVendor;
299 __le16 idProduct;
300 __le16 bcdDevice;
301 __u8 iManufacturer;
302 __u8 iProduct;
303 __u8 iSerialNumber;
304 __u8 bNumConfigurations;
305} __attribute__ ((packed));
306
307#define USB_DT_DEVICE_SIZE 18
308
309
310
311
312
313
314
315#define USB_CLASS_PER_INTERFACE 0
316#define USB_CLASS_AUDIO 1
317#define USB_CLASS_COMM 2
318#define USB_CLASS_HID 3
319#define USB_CLASS_PHYSICAL 5
320#define USB_CLASS_STILL_IMAGE 6
321#define USB_CLASS_PRINTER 7
322#define USB_CLASS_MASS_STORAGE 8
323#define USB_CLASS_HUB 9
324#define USB_CLASS_CDC_DATA 0x0a
325#define USB_CLASS_CSCID 0x0b
326#define USB_CLASS_CONTENT_SEC 0x0d
327#define USB_CLASS_VIDEO 0x0e
328#define USB_CLASS_WIRELESS_CONTROLLER 0xe0
329#define USB_CLASS_PERSONAL_HEALTHCARE 0x0f
330#define USB_CLASS_AUDIO_VIDEO 0x10
331#define USB_CLASS_BILLBOARD 0x11
332#define USB_CLASS_USB_TYPE_C_BRIDGE 0x12
333#define USB_CLASS_MISC 0xef
334#define USB_CLASS_APP_SPEC 0xfe
335#define USB_CLASS_VENDOR_SPEC 0xff
336
337#define USB_SUBCLASS_VENDOR_SPEC 0xff
338
339
340
341
342
343
344
345
346
347
348
349struct usb_config_descriptor {
350 __u8 bLength;
351 __u8 bDescriptorType;
352
353 __le16 wTotalLength;
354 __u8 bNumInterfaces;
355 __u8 bConfigurationValue;
356 __u8 iConfiguration;
357 __u8 bmAttributes;
358 __u8 bMaxPower;
359} __attribute__ ((packed));
360
361#define USB_DT_CONFIG_SIZE 9
362
363
364#define USB_CONFIG_ATT_ONE (1 << 7)
365#define USB_CONFIG_ATT_SELFPOWER (1 << 6)
366#define USB_CONFIG_ATT_WAKEUP (1 << 5)
367#define USB_CONFIG_ATT_BATTERY (1 << 4)
368
369
370
371
372#define USB_MAX_STRING_LEN 126
373
374
375struct usb_string_descriptor {
376 __u8 bLength;
377 __u8 bDescriptorType;
378
379 __le16 wData[1];
380} __attribute__ ((packed));
381
382
383
384
385
386
387
388
389struct usb_interface_descriptor {
390 __u8 bLength;
391 __u8 bDescriptorType;
392
393 __u8 bInterfaceNumber;
394 __u8 bAlternateSetting;
395 __u8 bNumEndpoints;
396 __u8 bInterfaceClass;
397 __u8 bInterfaceSubClass;
398 __u8 bInterfaceProtocol;
399 __u8 iInterface;
400} __attribute__ ((packed));
401
402#define USB_DT_INTERFACE_SIZE 9
403
404
405
406
407struct usb_endpoint_descriptor {
408 __u8 bLength;
409 __u8 bDescriptorType;
410
411 __u8 bEndpointAddress;
412 __u8 bmAttributes;
413 __le16 wMaxPacketSize;
414 __u8 bInterval;
415
416
417
418 __u8 bRefresh;
419 __u8 bSynchAddress;
420} __attribute__ ((packed));
421
422#define USB_DT_ENDPOINT_SIZE 7
423#define USB_DT_ENDPOINT_AUDIO_SIZE 9
424
425
426
427
428
429#define USB_ENDPOINT_NUMBER_MASK 0x0f
430#define USB_ENDPOINT_DIR_MASK 0x80
431
432#define USB_ENDPOINT_XFERTYPE_MASK 0x03
433#define USB_ENDPOINT_XFER_CONTROL 0
434#define USB_ENDPOINT_XFER_ISOC 1
435#define USB_ENDPOINT_XFER_BULK 2
436#define USB_ENDPOINT_XFER_INT 3
437#define USB_ENDPOINT_MAX_ADJUSTABLE 0x80
438
439#define USB_ENDPOINT_MAXP_MASK 0x07ff
440#define USB_EP_MAXP_MULT_SHIFT 11
441#define USB_EP_MAXP_MULT_MASK (3 << USB_EP_MAXP_MULT_SHIFT)
442#define USB_EP_MAXP_MULT(m) \
443 (((m) & USB_EP_MAXP_MULT_MASK) >> USB_EP_MAXP_MULT_SHIFT)
444
445
446#define USB_ENDPOINT_INTRTYPE 0x30
447#define USB_ENDPOINT_INTR_PERIODIC (0 << 4)
448#define USB_ENDPOINT_INTR_NOTIFICATION (1 << 4)
449
450#define USB_ENDPOINT_SYNCTYPE 0x0c
451#define USB_ENDPOINT_SYNC_NONE (0 << 2)
452#define USB_ENDPOINT_SYNC_ASYNC (1 << 2)
453#define USB_ENDPOINT_SYNC_ADAPTIVE (2 << 2)
454#define USB_ENDPOINT_SYNC_SYNC (3 << 2)
455
456#define USB_ENDPOINT_USAGE_MASK 0x30
457#define USB_ENDPOINT_USAGE_DATA 0x00
458#define USB_ENDPOINT_USAGE_FEEDBACK 0x10
459#define USB_ENDPOINT_USAGE_IMPLICIT_FB 0x20
460
461
462
463
464
465
466
467
468
469static inline int usb_endpoint_num(const struct usb_endpoint_descriptor *epd)
470{
471 return epd->bEndpointAddress & USB_ENDPOINT_NUMBER_MASK;
472}
473
474
475
476
477
478
479
480
481static inline int usb_endpoint_type(const struct usb_endpoint_descriptor *epd)
482{
483 return epd->bmAttributes & USB_ENDPOINT_XFERTYPE_MASK;
484}
485
486
487
488
489
490
491
492static inline int usb_endpoint_dir_in(const struct usb_endpoint_descriptor *epd)
493{
494 return ((epd->bEndpointAddress & USB_ENDPOINT_DIR_MASK) == USB_DIR_IN);
495}
496
497
498
499
500
501
502
503static inline int usb_endpoint_dir_out(
504 const struct usb_endpoint_descriptor *epd)
505{
506 return ((epd->bEndpointAddress & USB_ENDPOINT_DIR_MASK) == USB_DIR_OUT);
507}
508
509
510
511
512
513
514
515static inline int usb_endpoint_xfer_bulk(
516 const struct usb_endpoint_descriptor *epd)
517{
518 return ((epd->bmAttributes & USB_ENDPOINT_XFERTYPE_MASK) ==
519 USB_ENDPOINT_XFER_BULK);
520}
521
522
523
524
525
526
527
528static inline int usb_endpoint_xfer_control(
529 const struct usb_endpoint_descriptor *epd)
530{
531 return ((epd->bmAttributes & USB_ENDPOINT_XFERTYPE_MASK) ==
532 USB_ENDPOINT_XFER_CONTROL);
533}
534
535
536
537
538
539
540
541
542static inline int usb_endpoint_xfer_int(
543 const struct usb_endpoint_descriptor *epd)
544{
545 return ((epd->bmAttributes & USB_ENDPOINT_XFERTYPE_MASK) ==
546 USB_ENDPOINT_XFER_INT);
547}
548
549
550
551
552
553
554
555
556static inline int usb_endpoint_xfer_isoc(
557 const struct usb_endpoint_descriptor *epd)
558{
559 return ((epd->bmAttributes & USB_ENDPOINT_XFERTYPE_MASK) ==
560 USB_ENDPOINT_XFER_ISOC);
561}
562
563
564
565
566
567
568
569
570static inline int usb_endpoint_is_bulk_in(
571 const struct usb_endpoint_descriptor *epd)
572{
573 return usb_endpoint_xfer_bulk(epd) && usb_endpoint_dir_in(epd);
574}
575
576
577
578
579
580
581
582
583static inline int usb_endpoint_is_bulk_out(
584 const struct usb_endpoint_descriptor *epd)
585{
586 return usb_endpoint_xfer_bulk(epd) && usb_endpoint_dir_out(epd);
587}
588
589
590
591
592
593
594
595
596static inline int usb_endpoint_is_int_in(
597 const struct usb_endpoint_descriptor *epd)
598{
599 return usb_endpoint_xfer_int(epd) && usb_endpoint_dir_in(epd);
600}
601
602
603
604
605
606
607
608
609static inline int usb_endpoint_is_int_out(
610 const struct usb_endpoint_descriptor *epd)
611{
612 return usb_endpoint_xfer_int(epd) && usb_endpoint_dir_out(epd);
613}
614
615
616
617
618
619
620
621
622static inline int usb_endpoint_is_isoc_in(
623 const struct usb_endpoint_descriptor *epd)
624{
625 return usb_endpoint_xfer_isoc(epd) && usb_endpoint_dir_in(epd);
626}
627
628
629
630
631
632
633
634
635static inline int usb_endpoint_is_isoc_out(
636 const struct usb_endpoint_descriptor *epd)
637{
638 return usb_endpoint_xfer_isoc(epd) && usb_endpoint_dir_out(epd);
639}
640
641
642
643
644
645
646
647static inline int usb_endpoint_maxp(const struct usb_endpoint_descriptor *epd)
648{
649 return __le16_to_cpu(epd->wMaxPacketSize) & USB_ENDPOINT_MAXP_MASK;
650}
651
652
653
654
655
656
657
658static inline int
659usb_endpoint_maxp_mult(const struct usb_endpoint_descriptor *epd)
660{
661 int maxp = __le16_to_cpu(epd->wMaxPacketSize);
662
663 return USB_EP_MAXP_MULT(maxp) + 1;
664}
665
666static inline int usb_endpoint_interrupt_type(
667 const struct usb_endpoint_descriptor *epd)
668{
669 return epd->bmAttributes & USB_ENDPOINT_INTRTYPE;
670}
671
672
673
674
675
676
677struct usb_ssp_isoc_ep_comp_descriptor {
678 __u8 bLength;
679 __u8 bDescriptorType;
680 __le16 wReseved;
681 __le32 dwBytesPerInterval;
682} __attribute__ ((packed));
683
684#define USB_DT_SSP_ISOC_EP_COMP_SIZE 8
685
686
687
688
689struct usb_ss_ep_comp_descriptor {
690 __u8 bLength;
691 __u8 bDescriptorType;
692
693 __u8 bMaxBurst;
694 __u8 bmAttributes;
695 __le16 wBytesPerInterval;
696} __attribute__ ((packed));
697
698#define USB_DT_SS_EP_COMP_SIZE 6
699
700
701static inline int
702usb_ss_max_streams(const struct usb_ss_ep_comp_descriptor *comp)
703{
704 int max_streams;
705
706 if (!comp)
707 return 0;
708
709 max_streams = comp->bmAttributes & 0x1f;
710
711 if (!max_streams)
712 return 0;
713
714 max_streams = 1 << max_streams;
715
716 return max_streams;
717}
718
719
720#define USB_SS_MULT(p) (1 + ((p) & 0x3))
721
722#define USB_SS_SSP_ISOC_COMP(p) ((p) & (1 << 7))
723
724
725
726
727struct usb_qualifier_descriptor {
728 __u8 bLength;
729 __u8 bDescriptorType;
730
731 __le16 bcdUSB;
732 __u8 bDeviceClass;
733 __u8 bDeviceSubClass;
734 __u8 bDeviceProtocol;
735 __u8 bMaxPacketSize0;
736 __u8 bNumConfigurations;
737 __u8 bRESERVED;
738} __attribute__ ((packed));
739
740
741
742
743
744struct usb_otg_descriptor {
745 __u8 bLength;
746 __u8 bDescriptorType;
747
748 __u8 bmAttributes;
749} __attribute__ ((packed));
750
751
752struct usb_otg20_descriptor {
753 __u8 bLength;
754 __u8 bDescriptorType;
755
756 __u8 bmAttributes;
757 __le16 bcdOTG;
758
759
760} __attribute__ ((packed));
761
762
763#define USB_OTG_SRP (1 << 0)
764#define USB_OTG_HNP (1 << 1)
765#define USB_OTG_ADP (1 << 2)
766
767#define OTG_STS_SELECTOR 0xF000
768
769
770
771struct usb_debug_descriptor {
772 __u8 bLength;
773 __u8 bDescriptorType;
774
775
776 __u8 bDebugInEndpoint;
777 __u8 bDebugOutEndpoint;
778} __attribute__((packed));
779
780
781
782
783struct usb_interface_assoc_descriptor {
784 __u8 bLength;
785 __u8 bDescriptorType;
786
787 __u8 bFirstInterface;
788 __u8 bInterfaceCount;
789 __u8 bFunctionClass;
790 __u8 bFunctionSubClass;
791 __u8 bFunctionProtocol;
792 __u8 iFunction;
793} __attribute__ ((packed));
794
795#define USB_DT_INTERFACE_ASSOCIATION_SIZE 8
796
797
798
799
800
801
802struct usb_security_descriptor {
803 __u8 bLength;
804 __u8 bDescriptorType;
805
806 __le16 wTotalLength;
807 __u8 bNumEncryptionTypes;
808} __attribute__((packed));
809
810
811
812
813
814
815struct usb_key_descriptor {
816 __u8 bLength;
817 __u8 bDescriptorType;
818
819 __u8 tTKID[3];
820 __u8 bReserved;
821 __u8 bKeyData[0];
822} __attribute__((packed));
823
824
825
826
827struct usb_encryption_descriptor {
828 __u8 bLength;
829 __u8 bDescriptorType;
830
831 __u8 bEncryptionType;
832#define USB_ENC_TYPE_UNSECURE 0
833#define USB_ENC_TYPE_WIRED 1
834#define USB_ENC_TYPE_CCM_1 2
835#define USB_ENC_TYPE_RSA_1 3
836 __u8 bEncryptionValue;
837 __u8 bAuthKeyIndex;
838} __attribute__((packed));
839
840
841
842
843
844struct usb_bos_descriptor {
845 __u8 bLength;
846 __u8 bDescriptorType;
847
848 __le16 wTotalLength;
849 __u8 bNumDeviceCaps;
850} __attribute__((packed));
851
852#define USB_DT_BOS_SIZE 5
853
854
855
856struct usb_dev_cap_header {
857 __u8 bLength;
858 __u8 bDescriptorType;
859 __u8 bDevCapabilityType;
860} __attribute__((packed));
861
862#define USB_CAP_TYPE_WIRELESS_USB 1
863
864struct usb_wireless_cap_descriptor {
865 __u8 bLength;
866 __u8 bDescriptorType;
867 __u8 bDevCapabilityType;
868
869 __u8 bmAttributes;
870#define USB_WIRELESS_P2P_DRD (1 << 1)
871#define USB_WIRELESS_BEACON_MASK (3 << 2)
872#define USB_WIRELESS_BEACON_SELF (1 << 2)
873#define USB_WIRELESS_BEACON_DIRECTED (2 << 2)
874#define USB_WIRELESS_BEACON_NONE (3 << 2)
875 __le16 wPHYRates;
876#define USB_WIRELESS_PHY_53 (1 << 0)
877#define USB_WIRELESS_PHY_80 (1 << 1)
878#define USB_WIRELESS_PHY_107 (1 << 2)
879#define USB_WIRELESS_PHY_160 (1 << 3)
880#define USB_WIRELESS_PHY_200 (1 << 4)
881#define USB_WIRELESS_PHY_320 (1 << 5)
882#define USB_WIRELESS_PHY_400 (1 << 6)
883#define USB_WIRELESS_PHY_480 (1 << 7)
884 __u8 bmTFITXPowerInfo;
885 __u8 bmFFITXPowerInfo;
886 __le16 bmBandGroup;
887 __u8 bReserved;
888} __attribute__((packed));
889
890#define USB_DT_USB_WIRELESS_CAP_SIZE 11
891
892
893#define USB_CAP_TYPE_EXT 2
894
895struct usb_ext_cap_descriptor {
896 __u8 bLength;
897 __u8 bDescriptorType;
898 __u8 bDevCapabilityType;
899 __le32 bmAttributes;
900#define USB_LPM_SUPPORT (1 << 1)
901#define USB_BESL_SUPPORT (1 << 2)
902#define USB_BESL_BASELINE_VALID (1 << 3)
903#define USB_BESL_DEEP_VALID (1 << 4)
904#define USB_SET_BESL_BASELINE(p) (((p) & 0xf) << 8)
905#define USB_SET_BESL_DEEP(p) (((p) & 0xf) << 12)
906#define USB_GET_BESL_BASELINE(p) (((p) & (0xf << 8)) >> 8)
907#define USB_GET_BESL_DEEP(p) (((p) & (0xf << 12)) >> 12)
908} __attribute__((packed));
909
910#define USB_DT_USB_EXT_CAP_SIZE 7
911
912
913
914
915
916#define USB_SS_CAP_TYPE 3
917struct usb_ss_cap_descriptor {
918 __u8 bLength;
919 __u8 bDescriptorType;
920 __u8 bDevCapabilityType;
921 __u8 bmAttributes;
922#define USB_LTM_SUPPORT (1 << 1)
923 __le16 wSpeedSupported;
924#define USB_LOW_SPEED_OPERATION (1)
925#define USB_FULL_SPEED_OPERATION (1 << 1)
926#define USB_HIGH_SPEED_OPERATION (1 << 2)
927#define USB_5GBPS_OPERATION (1 << 3)
928 __u8 bFunctionalitySupport;
929 __u8 bU1devExitLat;
930 __le16 bU2DevExitLat;
931} __attribute__((packed));
932
933#define USB_DT_USB_SS_CAP_SIZE 10
934
935
936
937
938
939#define CONTAINER_ID_TYPE 4
940struct usb_ss_container_id_descriptor {
941 __u8 bLength;
942 __u8 bDescriptorType;
943 __u8 bDevCapabilityType;
944 __u8 bReserved;
945 __u8 ContainerID[16];
946} __attribute__((packed));
947
948#define USB_DT_USB_SS_CONTN_ID_SIZE 20
949
950
951
952
953
954#define USB_SSP_CAP_TYPE 0xa
955struct usb_ssp_cap_descriptor {
956 __u8 bLength;
957 __u8 bDescriptorType;
958 __u8 bDevCapabilityType;
959 __u8 bReserved;
960 __le32 bmAttributes;
961#define USB_SSP_SUBLINK_SPEED_ATTRIBS (0x1f << 0)
962#define USB_SSP_SUBLINK_SPEED_IDS (0xf << 5)
963 __le16 wFunctionalitySupport;
964#define USB_SSP_MIN_SUBLINK_SPEED_ATTRIBUTE_ID (0xf)
965#define USB_SSP_MIN_RX_LANE_COUNT (0xf << 8)
966#define USB_SSP_MIN_TX_LANE_COUNT (0xf << 12)
967 __le16 wReserved;
968 __le32 bmSublinkSpeedAttr[1];
969#define USB_SSP_SUBLINK_SPEED_SSID (0xf)
970#define USB_SSP_SUBLINK_SPEED_LSE (0x3 << 4)
971#define USB_SSP_SUBLINK_SPEED_ST (0x3 << 6)
972#define USB_SSP_SUBLINK_SPEED_RSVD (0x3f << 8)
973#define USB_SSP_SUBLINK_SPEED_LP (0x3 << 14)
974#define USB_SSP_SUBLINK_SPEED_LSM (0xff << 16)
975} __attribute__((packed));
976
977
978
979
980
981
982#define USB_PD_POWER_DELIVERY_CAPABILITY 0x06
983
984#define USB_PD_BATTERY_INFO_CAPABILITY 0x07
985
986#define USB_PD_PD_CONSUMER_PORT_CAPABILITY 0x08
987
988#define USB_PD_PD_PROVIDER_PORT_CAPABILITY 0x09
989
990struct usb_pd_cap_descriptor {
991 __u8 bLength;
992 __u8 bDescriptorType;
993 __u8 bDevCapabilityType;
994 __u8 bReserved;
995 __le32 bmAttributes;
996#define USB_PD_CAP_BATTERY_CHARGING (1 << 1)
997#define USB_PD_CAP_USB_PD (1 << 2)
998#define USB_PD_CAP_PROVIDER (1 << 3)
999#define USB_PD_CAP_CONSUMER (1 << 4)
1000#define USB_PD_CAP_CHARGING_POLICY (1 << 5)
1001#define USB_PD_CAP_TYPE_C_CURRENT (1 << 6)
1002
1003#define USB_PD_CAP_PWR_AC (1 << 8)
1004#define USB_PD_CAP_PWR_BAT (1 << 9)
1005#define USB_PD_CAP_PWR_USE_V_BUS (1 << 14)
1006
1007 __le16 bmProviderPorts;
1008 __le16 bmConsumerPorts;
1009 __le16 bcdBCVersion;
1010 __le16 bcdPDVersion;
1011 __le16 bcdUSBTypeCVersion;
1012} __attribute__((packed));
1013
1014struct usb_pd_cap_battery_info_descriptor {
1015 __u8 bLength;
1016 __u8 bDescriptorType;
1017 __u8 bDevCapabilityType;
1018
1019 __u8 iBattery;
1020
1021 __u8 iSerial;
1022 __u8 iManufacturer;
1023 __u8 bBatteryId;
1024 __u8 bReserved;
1025
1026
1027
1028
1029
1030 __le32 dwChargedThreshold;
1031
1032
1033
1034
1035
1036 __le32 dwWeakThreshold;
1037 __le32 dwBatteryDesignCapacity;
1038 __le32 dwBatteryLastFullchargeCapacity;
1039} __attribute__((packed));
1040
1041struct usb_pd_cap_consumer_port_descriptor {
1042 __u8 bLength;
1043 __u8 bDescriptorType;
1044 __u8 bDevCapabilityType;
1045 __u8 bReserved;
1046 __u8 bmCapabilities;
1047
1048#define USB_PD_CAP_CONSUMER_BC (1 << 0)
1049#define USB_PD_CAP_CONSUMER_PD (1 << 1)
1050#define USB_PD_CAP_CONSUMER_TYPE_C (1 << 2)
1051 __le16 wMinVoltage;
1052 __le16 wMaxVoltage;
1053 __u16 wReserved;
1054 __le32 dwMaxOperatingPower;
1055 __le32 dwMaxPeakPower;
1056 __le32 dwMaxPeakPowerTime;
1057#define USB_PD_CAP_CONSUMER_UNKNOWN_PEAK_POWER_TIME 0xffff
1058} __attribute__((packed));
1059
1060struct usb_pd_cap_provider_port_descriptor {
1061 __u8 bLength;
1062 __u8 bDescriptorType;
1063 __u8 bDevCapabilityType;
1064 __u8 bReserved1;
1065 __u8 bmCapabilities;
1066
1067#define USB_PD_CAP_PROVIDER_BC (1 << 0)
1068#define USB_PD_CAP_PROVIDER_PD (1 << 1)
1069#define USB_PD_CAP_PROVIDER_TYPE_C (1 << 2)
1070 __u8 bNumOfPDObjects;
1071 __u8 bReserved2;
1072 __le32 wPowerDataObject[];
1073} __attribute__((packed));
1074
1075
1076
1077
1078
1079#define USB_PTM_CAP_TYPE 0xb
1080struct usb_ptm_cap_descriptor {
1081 __u8 bLength;
1082 __u8 bDescriptorType;
1083 __u8 bDevCapabilityType;
1084} __attribute__((packed));
1085
1086#define USB_DT_USB_PTM_ID_SIZE 3
1087
1088
1089
1090
1091#define USB_DT_USB_SSP_CAP_SIZE(ssac) (12 + (ssac + 1) * 4)
1092
1093
1094
1095
1096
1097
1098struct usb_wireless_ep_comp_descriptor {
1099 __u8 bLength;
1100 __u8 bDescriptorType;
1101
1102 __u8 bMaxBurst;
1103 __u8 bMaxSequence;
1104 __le16 wMaxStreamDelay;
1105 __le16 wOverTheAirPacketSize;
1106 __u8 bOverTheAirInterval;
1107 __u8 bmCompAttributes;
1108#define USB_ENDPOINT_SWITCH_MASK 0x03
1109#define USB_ENDPOINT_SWITCH_NO 0
1110#define USB_ENDPOINT_SWITCH_SWITCH 1
1111#define USB_ENDPOINT_SWITCH_SCALE 2
1112} __attribute__((packed));
1113
1114
1115
1116
1117
1118
1119
1120struct usb_handshake {
1121 __u8 bMessageNumber;
1122 __u8 bStatus;
1123 __u8 tTKID[3];
1124 __u8 bReserved;
1125 __u8 CDID[16];
1126 __u8 nonce[16];
1127 __u8 MIC[8];
1128} __attribute__((packed));
1129
1130
1131
1132
1133
1134
1135
1136struct usb_connection_context {
1137 __u8 CHID[16];
1138 __u8 CDID[16];
1139 __u8 CK[16];
1140} __attribute__((packed));
1141
1142
1143
1144
1145
1146enum usb_device_speed {
1147 USB_SPEED_UNKNOWN = 0,
1148 USB_SPEED_LOW, USB_SPEED_FULL,
1149 USB_SPEED_HIGH,
1150 USB_SPEED_WIRELESS,
1151 USB_SPEED_SUPER,
1152 USB_SPEED_SUPER_PLUS,
1153};
1154
1155
1156enum usb_device_state {
1157
1158
1159
1160 USB_STATE_NOTATTACHED = 0,
1161
1162
1163 USB_STATE_ATTACHED,
1164 USB_STATE_POWERED,
1165 USB_STATE_RECONNECTING,
1166 USB_STATE_UNAUTHENTICATED,
1167 USB_STATE_DEFAULT,
1168 USB_STATE_ADDRESS,
1169 USB_STATE_CONFIGURED,
1170
1171 USB_STATE_SUSPENDED
1172
1173
1174
1175
1176
1177
1178
1179};
1180
1181enum usb3_link_state {
1182 USB3_LPM_U0 = 0,
1183 USB3_LPM_U1,
1184 USB3_LPM_U2,
1185 USB3_LPM_U3
1186};
1187
1188
1189
1190
1191
1192
1193
1194
1195
1196
1197
1198
1199
1200
1201
1202
1203
1204
1205
1206#define USB3_LPM_DISABLED 0x0
1207#define USB3_LPM_U1_MAX_TIMEOUT 0x7F
1208#define USB3_LPM_U2_MAX_TIMEOUT 0xFE
1209#define USB3_LPM_DEVICE_INITIATED 0xFF
1210
1211struct usb_set_sel_req {
1212 __u8 u1_sel;
1213 __u8 u1_pel;
1214 __le16 u2_sel;
1215 __le16 u2_pel;
1216} __attribute__ ((packed));
1217
1218
1219
1220
1221
1222
1223#define USB3_LPM_MAX_U1_SEL_PEL 0xFF
1224#define USB3_LPM_MAX_U2_SEL_PEL 0xFFFF
1225
1226
1227
1228
1229
1230
1231
1232
1233
1234#define USB_SELF_POWER_VBUS_MAX_DRAW 100
1235
1236#endif
1237