[deliverable/linux.git] / include / linux / usb / cdc.h

/*
 * USB Communications Device Class (CDC) definitions
 *
 * CDC says how to talk to lots of different types of network adapters,
 * notably ethernet adapters and various modems.  It's used mostly with
 * firmware based USB peripherals.
 */

#define USB_CDC_SUBCLASS_ACM			0x02
#define USB_CDC_SUBCLASS_ETHERNET		0x06
#define USB_CDC_SUBCLASS_WHCM			0x08
#define USB_CDC_SUBCLASS_DMM			0x09
#define USB_CDC_SUBCLASS_MDLM			0x0a
#define USB_CDC_SUBCLASS_OBEX			0x0b

#define USB_CDC_PROTO_NONE			0

#define USB_CDC_ACM_PROTO_AT_V25TER		1
#define USB_CDC_ACM_PROTO_AT_PCCA101		2
#define USB_CDC_ACM_PROTO_AT_PCCA101_WAKE	3
#define USB_CDC_ACM_PROTO_AT_GSM		4
#define USB_CDC_ACM_PROTO_AT_3G			5
#define USB_CDC_ACM_PROTO_AT_CDMA		6
#define USB_CDC_ACM_PROTO_VENDOR		0xff

/*-------------------------------------------------------------------------*/

/*
 * Class-Specific descriptors ... there are a couple dozen of them
 */

#define USB_CDC_HEADER_TYPE		0x00		/* header_desc */
#define USB_CDC_CALL_MANAGEMENT_TYPE	0x01		/* call_mgmt_descriptor */
#define USB_CDC_ACM_TYPE		0x02		/* acm_descriptor */
#define USB_CDC_UNION_TYPE		0x06		/* union_desc */
#define USB_CDC_COUNTRY_TYPE		0x07
#define USB_CDC_NETWORK_TERMINAL_TYPE	0x0a		/* network_terminal_desc */
#define USB_CDC_ETHERNET_TYPE		0x0f		/* ether_desc */
#define USB_CDC_WHCM_TYPE		0x11
#define USB_CDC_MDLM_TYPE		0x12		/* mdlm_desc */
#define USB_CDC_MDLM_DETAIL_TYPE	0x13		/* mdlm_detail_desc */
#define USB_CDC_DMM_TYPE		0x14
#define USB_CDC_OBEX_TYPE		0x15

/* "Header Functional Descriptor" from CDC spec  5.2.3.1 */
struct usb_cdc_header_desc {
	__u8	bLength;
	__u8	bDescriptorType;
	__u8	bDescriptorSubType;

	__le16	bcdCDC;
} __attribute__ ((packed));

/* "Call Management Descriptor" from CDC spec  5.2.3.2 */
struct usb_cdc_call_mgmt_descriptor {
	__u8	bLength;
	__u8	bDescriptorType;
	__u8	bDescriptorSubType;

	__u8	bmCapabilities;
#define USB_CDC_CALL_MGMT_CAP_CALL_MGMT		0x01
#define USB_CDC_CALL_MGMT_CAP_DATA_INTF		0x02

	__u8	bDataInterface;
} __attribute__ ((packed));

/* "Abstract Control Management Descriptor" from CDC spec  5.2.3.3 */
struct usb_cdc_acm_descriptor {
	__u8	bLength;
	__u8	bDescriptorType;
	__u8	bDescriptorSubType;

	__u8	bmCapabilities;
} __attribute__ ((packed));

/* capabilities from 5.2.3.3 */

#define USB_CDC_COMM_FEATURE	0x01
#define USB_CDC_CAP_LINE	0x02
#define USB_CDC_CAP_BRK	0x04
#define USB_CDC_CAP_NOTIFY	0x08

/* "Union Functional Descriptor" from CDC spec 5.2.3.8 */
struct usb_cdc_union_desc {
	__u8	bLength;
	__u8	bDescriptorType;
	__u8	bDescriptorSubType;

	__u8	bMasterInterface0;
	__u8	bSlaveInterface0;
	/* ... and there could be other slave interfaces */
} __attribute__ ((packed));

/* "Network Channel Terminal Functional Descriptor" from CDC spec 5.2.3.11 */
struct usb_cdc_network_terminal_desc {
	__u8	bLength;
	__u8	bDescriptorType;
	__u8	bDescriptorSubType;

	__u8	bEntityId;
	__u8	iName;
	__u8	bChannelIndex;
	__u8	bPhysicalInterface;
} __attribute__ ((packed));

/* "Ethernet Networking Functional Descriptor" from CDC spec 5.2.3.16 */
struct usb_cdc_ether_desc {
	__u8	bLength;
	__u8	bDescriptorType;
	__u8	bDescriptorSubType;

	__u8	iMACAddress;
	__le32	bmEthernetStatistics;
	__le16	wMaxSegmentSize;
	__le16	wNumberMCFilters;
	__u8	bNumberPowerFilters;
} __attribute__ ((packed));

/* "MDLM Functional Descriptor" from CDC WMC spec 6.7.2.3 */
struct usb_cdc_mdlm_desc {
	__u8	bLength;
	__u8	bDescriptorType;
	__u8	bDescriptorSubType;

	__le16	bcdVersion;
	__u8	bGUID[16];
} __attribute__ ((packed));

/* "MDLM Detail Functional Descriptor" from CDC WMC spec 6.7.2.4 */
struct usb_cdc_mdlm_detail_desc {
	__u8	bLength;
	__u8	bDescriptorType;
	__u8	bDescriptorSubType;

	/* type is associated with mdlm_desc.bGUID */
	__u8	bGuidDescriptorType;
	__u8	bDetailData[0];
} __attribute__ ((packed));

/*-------------------------------------------------------------------------*/

/*
 * Class-Specific Control Requests (6.2)
 *
 * section 3.6.2.1 table 4 has the ACM profile, for modems.
 * section 3.8.2 table 10 has the ethernet profile.
 *
 * Microsoft's RNDIS stack for Ethernet is a vendor-specific CDC ACM variant,
 * heavily dependent on the encapsulated (proprietary) command mechanism.
 */

#define USB_CDC_SEND_ENCAPSULATED_COMMAND	0x00
#define USB_CDC_GET_ENCAPSULATED_RESPONSE	0x01
#define USB_CDC_REQ_SET_LINE_CODING		0x20
#define USB_CDC_REQ_GET_LINE_CODING		0x21
#define USB_CDC_REQ_SET_CONTROL_LINE_STATE	0x22
#define USB_CDC_REQ_SEND_BREAK			0x23
#define USB_CDC_SET_ETHERNET_MULTICAST_FILTERS	0x40
#define USB_CDC_SET_ETHERNET_PM_PATTERN_FILTER	0x41
#define USB_CDC_GET_ETHERNET_PM_PATTERN_FILTER	0x42
#define USB_CDC_SET_ETHERNET_PACKET_FILTER	0x43
#define USB_CDC_GET_ETHERNET_STATISTIC		0x44

/* Line Coding Structure from CDC spec 6.2.13 */
struct usb_cdc_line_coding {
	__le32	dwDTERate;
	__u8	bCharFormat;
#define USB_CDC_1_STOP_BITS			0
#define USB_CDC_1_5_STOP_BITS			1
#define USB_CDC_2_STOP_BITS			2

	__u8	bParityType;
#define USB_CDC_NO_PARITY			0
#define USB_CDC_ODD_PARITY			1
#define USB_CDC_EVEN_PARITY			2
#define USB_CDC_MARK_PARITY			3
#define USB_CDC_SPACE_PARITY			4

	__u8	bDataBits;
} __attribute__ ((packed));

/* table 62; bits in multicast filter */
#define	USB_CDC_PACKET_TYPE_PROMISCUOUS		(1 << 0)
#define	USB_CDC_PACKET_TYPE_ALL_MULTICAST	(1 << 1) /* no filter */
#define	USB_CDC_PACKET_TYPE_DIRECTED		(1 << 2)
#define	USB_CDC_PACKET_TYPE_BROADCAST		(1 << 3)
#define	USB_CDC_PACKET_TYPE_MULTICAST		(1 << 4) /* filtered */


/*-------------------------------------------------------------------------*/

/*
 * Class-Specific Notifications (6.3) sent by interrupt transfers
 *
 * section 3.8.2 table 11 of the CDC spec lists Ethernet notifications
 * section 3.6.2.1 table 5 specifies ACM notifications, accepted by RNDIS
 * RNDIS also defines its own bit-incompatible notifications
 */

#define USB_CDC_NOTIFY_NETWORK_CONNECTION	0x00
#define USB_CDC_NOTIFY_RESPONSE_AVAILABLE	0x01
#define USB_CDC_NOTIFY_SERIAL_STATE		0x20
#define USB_CDC_NOTIFY_SPEED_CHANGE		0x2a

struct usb_cdc_notification {
	__u8	bmRequestType;
	__u8	bNotificationType;
	__le16	wValue;
	__le16	wIndex;
	__le16	wLength;
} __attribute__ ((packed));
Commit	Line	Data
1da177e4 LT	1	/*
	2	* USB Communications Device Class (CDC) definitions
	3	*
	4	* CDC says how to talk to lots of different types of network adapters,
	5	* notably ethernet adapters and various modems. It's used mostly with
	6	* firmware based USB peripherals.
	7	*/
	8
	9	#define USB_CDC_SUBCLASS_ACM 0x02
	10	#define USB_CDC_SUBCLASS_ETHERNET 0x06
	11	#define USB_CDC_SUBCLASS_WHCM 0x08
	12	#define USB_CDC_SUBCLASS_DMM 0x09
	13	#define USB_CDC_SUBCLASS_MDLM 0x0a
	14	#define USB_CDC_SUBCLASS_OBEX 0x0b
	15
	16	#define USB_CDC_PROTO_NONE 0
	17
	18	#define USB_CDC_ACM_PROTO_AT_V25TER 1
	19	#define USB_CDC_ACM_PROTO_AT_PCCA101 2
	20	#define USB_CDC_ACM_PROTO_AT_PCCA101_WAKE 3
	21	#define USB_CDC_ACM_PROTO_AT_GSM 4
	22	#define USB_CDC_ACM_PROTO_AT_3G 5
	23	#define USB_CDC_ACM_PROTO_AT_CDMA 6
	24	#define USB_CDC_ACM_PROTO_VENDOR 0xff
	25
	26	/-------------------------------------------------------------------------/
	27
	28	/*
	29	* Class-Specific descriptors ... there are a couple dozen of them
	30	*/
	31
	32	#define USB_CDC_HEADER_TYPE 0x00 /* header_desc */
	33	#define USB_CDC_CALL_MANAGEMENT_TYPE 0x01 /* call_mgmt_descriptor */
	34	#define USB_CDC_ACM_TYPE 0x02 /* acm_descriptor */
	35	#define USB_CDC_UNION_TYPE 0x06 /* union_desc */
	36	#define USB_CDC_COUNTRY_TYPE 0x07
00ab997d	37	#define USB_CDC_NETWORK_TERMINAL_TYPE 0x0a /* network_terminal_desc */
1da177e4 LT	38	#define USB_CDC_ETHERNET_TYPE 0x0f /* ether_desc */
	39	#define USB_CDC_WHCM_TYPE 0x11
	40	#define USB_CDC_MDLM_TYPE 0x12 /* mdlm_desc */
	41	#define USB_CDC_MDLM_DETAIL_TYPE 0x13 /* mdlm_detail_desc */
	42	#define USB_CDC_DMM_TYPE 0x14
	43	#define USB_CDC_OBEX_TYPE 0x15
	44
	45	/* "Header Functional Descriptor" from CDC spec 5.2.3.1 */
	46	struct usb_cdc_header_desc {
	47	__u8 bLength;
	48	__u8 bDescriptorType;
	49	__u8 bDescriptorSubType;
	50
	51	__le16 bcdCDC;
	52	} __attribute__ ((packed));
	53
	54	/* "Call Management Descriptor" from CDC spec 5.2.3.2 */
	55	struct usb_cdc_call_mgmt_descriptor {
	56	__u8 bLength;
	57	__u8 bDescriptorType;
	58	__u8 bDescriptorSubType;
	59
	60	__u8 bmCapabilities;
	61	#define USB_CDC_CALL_MGMT_CAP_CALL_MGMT 0x01
	62	#define USB_CDC_CALL_MGMT_CAP_DATA_INTF 0x02
	63
	64	__u8 bDataInterface;
	65	} __attribute__ ((packed));
	66
	67	/* "Abstract Control Management Descriptor" from CDC spec 5.2.3.3 */
	68	struct usb_cdc_acm_descriptor {
	69	__u8 bLength;
	70	__u8 bDescriptorType;
	71	__u8 bDescriptorSubType;
	72
	73	__u8 bmCapabilities;
	74	} __attribute__ ((packed));
	75
ca79b7b4 ON	76	/* capabilities from 5.2.3.3 */
	77
	78	#define USB_CDC_COMM_FEATURE 0x01
	79	#define USB_CDC_CAP_LINE 0x02
	80	#define USB_CDC_CAP_BRK 0x04
	81	#define USB_CDC_CAP_NOTIFY 0x08
	82
1da177e4 LT	83	/* "Union Functional Descriptor" from CDC spec 5.2.3.8 */
	84	struct usb_cdc_union_desc {
	85	__u8 bLength;
	86	__u8 bDescriptorType;
	87	__u8 bDescriptorSubType;
	88
	89	__u8 bMasterInterface0;
	90	__u8 bSlaveInterface0;
	91	/* ... and there could be other slave interfaces */
	92	} __attribute__ ((packed));
	93
00ab997d	94	/* "Network Channel Terminal Functional Descriptor" from CDC spec 5.2.3.11 */
	95	struct usb_cdc_network_terminal_desc {
	96	__u8 bLength;
	97	__u8 bDescriptorType;
	98	__u8 bDescriptorSubType;
	99
	100	__u8 bEntityId;
	101	__u8 iName;
	102	__u8 bChannelIndex;
	103	__u8 bPhysicalInterface;
	104	} __attribute__ ((packed));
	105
1da177e4 LT	106	/* "Ethernet Networking Functional Descriptor" from CDC spec 5.2.3.16 */
	107	struct usb_cdc_ether_desc {
	108	__u8 bLength;
	109	__u8 bDescriptorType;
	110	__u8 bDescriptorSubType;
	111
	112	__u8 iMACAddress;
	113	__le32 bmEthernetStatistics;
	114	__le16 wMaxSegmentSize;
	115	__le16 wNumberMCFilters;
	116	__u8 bNumberPowerFilters;
	117	} __attribute__ ((packed));
	118
	119	/* "MDLM Functional Descriptor" from CDC WMC spec 6.7.2.3 */
	120	struct usb_cdc_mdlm_desc {
	121	__u8 bLength;
	122	__u8 bDescriptorType;
	123	__u8 bDescriptorSubType;
	124
	125	__le16 bcdVersion;
	126	__u8 bGUID[16];
	127	} __attribute__ ((packed));
	128
	129	/* "MDLM Detail Functional Descriptor" from CDC WMC spec 6.7.2.4 */
	130	struct usb_cdc_mdlm_detail_desc {
	131	__u8 bLength;
	132	__u8 bDescriptorType;
	133	__u8 bDescriptorSubType;
	134
	135	/* type is associated with mdlm_desc.bGUID */
	136	__u8 bGuidDescriptorType;
84d79cb8	137	__u8 bDetailData[0];
1da177e4 LT	138	} __attribute__ ((packed));
	139
	140	/-------------------------------------------------------------------------/
	141
	142	/*
	143	* Class-Specific Control Requests (6.2)
	144	*
	145	* section 3.6.2.1 table 4 has the ACM profile, for modems.
	146	* section 3.8.2 table 10 has the ethernet profile.
	147	*
	148	* Microsoft's RNDIS stack for Ethernet is a vendor-specific CDC ACM variant,
	149	* heavily dependent on the encapsulated (proprietary) command mechanism.
	150	*/
	151
	152	#define USB_CDC_SEND_ENCAPSULATED_COMMAND 0x00
	153	#define USB_CDC_GET_ENCAPSULATED_RESPONSE 0x01
	154	#define USB_CDC_REQ_SET_LINE_CODING 0x20
	155	#define USB_CDC_REQ_GET_LINE_CODING 0x21
	156	#define USB_CDC_REQ_SET_CONTROL_LINE_STATE 0x22
	157	#define USB_CDC_REQ_SEND_BREAK 0x23
	158	#define USB_CDC_SET_ETHERNET_MULTICAST_FILTERS 0x40
	159	#define USB_CDC_SET_ETHERNET_PM_PATTERN_FILTER 0x41
	160	#define USB_CDC_GET_ETHERNET_PM_PATTERN_FILTER 0x42
	161	#define USB_CDC_SET_ETHERNET_PACKET_FILTER 0x43
	162	#define USB_CDC_GET_ETHERNET_STATISTIC 0x44
	163
	164	/* Line Coding Structure from CDC spec 6.2.13 */
	165	struct usb_cdc_line_coding {
	166	__le32 dwDTERate;
	167	__u8 bCharFormat;
	168	#define USB_CDC_1_STOP_BITS 0
	169	#define USB_CDC_1_5_STOP_BITS 1
	170	#define USB_CDC_2_STOP_BITS 2
	171
	172	__u8 bParityType;
	173	#define USB_CDC_NO_PARITY 0
	174	#define USB_CDC_ODD_PARITY 1
	175	#define USB_CDC_EVEN_PARITY 2
	176	#define USB_CDC_MARK_PARITY 3
	177	#define USB_CDC_SPACE_PARITY 4
	178
	179	__u8 bDataBits;
	180	} __attribute__ ((packed));
	181
	182	/* table 62; bits in multicast filter */
	183	#define USB_CDC_PACKET_TYPE_PROMISCUOUS (1 << 0)
	184	#define USB_CDC_PACKET_TYPE_ALL_MULTICAST (1 << 1) /* no filter */
	185	#define USB_CDC_PACKET_TYPE_DIRECTED (1 << 2)
	186	#define USB_CDC_PACKET_TYPE_BROADCAST (1 << 3)
	187	#define USB_CDC_PACKET_TYPE_MULTICAST (1 << 4) /* filtered */
	188
	189
	190	/-------------------------------------------------------------------------/
	191
	192	/*
	193	* Class-Specific Notifications (6.3) sent by interrupt transfers
	194	*
	195	* section 3.8.2 table 11 of the CDC spec lists Ethernet notifications
	196	* section 3.6.2.1 table 5 specifies ACM notifications, accepted by RNDIS
	197	* RNDIS also defines its own bit-incompatible notifications
	198	*/
	199
	200	#define USB_CDC_NOTIFY_NETWORK_CONNECTION 0x00
	201	#define USB_CDC_NOTIFY_RESPONSE_AVAILABLE 0x01
202	#define USB_CDC_NOTIFY_SERIAL_STATE 0x20
203	#define USB_CDC_NOTIFY_SPEED_CHANGE 0x2a
204
205	struct usb_cdc_notification {
206	__u8 bmRequestType;
207	__u8 bNotificationType;
208	__le16 wValue;
209	__le16 wIndex;
210	__le16 wLength;
211	} __attribute__ ((packed));
212