cdc.h File Reference

USB Communications Device Class (CDC) More...

#include <ipxe/usb.h>

Go to the source code of this file.

Data Structures
struct	cdc_union_descriptor
	Union functional descriptor. More...
struct	cdc_connection_speed_change
	Connection speed change notification. More...

Macros
#define	USB_CLASS_CDC   2
	Class code for communications devices. More...
#define	CDC_SEND_ENCAPSULATED_COMMAND
	Send encapsulated command. More...
#define	CDC_GET_ENCAPSULATED_RESPONSE
	Get encapsulated response. More...
#define	CDC_SUBTYPE_UNION   6
	Union functional descriptor subtype. More...
#define	CDC_SUBTYPE_ETHERNET   15
	Ethernet descriptor subtype. More...
#define	CDC_RESPONSE_AVAILABLE
	Response available. More...
#define	CDC_NETWORK_CONNECTION
	Network connection notification. More...
#define	CDC_CONNECTION_SPEED_CHANGE
	Connection speed change notification. More...

Functions
	FILE_LICENCE (GPL2_OR_LATER_OR_UBDL)
struct cdc_union_descriptor *	cdc_union_descriptor (struct usb_configuration_descriptor *config, struct usb_interface_descriptor *interface)
	Locate CDC union functional descriptor. More...
static int	cdc_send_encapsulated_command (struct usb_device *usb, unsigned int interface, void *data, size_t len)
	Send encapsulated command. More...
static int	cdc_get_encapsulated_response (struct usb_device *usb, unsigned int interface, void *data, size_t len)
	Get encapsulated response. More...

Detailed Description

USB Communications Device Class (CDC)

Definition in file cdc.h.

Macro Definition Documentation

USB_CLASS_CDC

#define USB_CLASS_CDC   2

Class code for communications devices.

Definition at line 15 of file cdc.h.

CDC_SEND_ENCAPSULATED_COMMAND

#define CDC_SEND_ENCAPSULATED_COMMAND

Value:

( USB_DIR_OUT | USB_TYPE_CLASS | USB_RECIP_INTERFACE |          \
          USB_REQUEST_TYPE ( 0x00 ) )

Send encapsulated command.

Definition at line 18 of file cdc.h.

CDC_GET_ENCAPSULATED_RESPONSE

#define CDC_GET_ENCAPSULATED_RESPONSE

Value:

( USB_DIR_IN | USB_TYPE_CLASS | USB_RECIP_INTERFACE |           \
          USB_REQUEST_TYPE ( 0x01 ) )

Get encapsulated response.

Definition at line 23 of file cdc.h.

CDC_SUBTYPE_UNION

#define CDC_SUBTYPE_UNION   6

Union functional descriptor subtype.

Definition at line 38 of file cdc.h.

CDC_SUBTYPE_ETHERNET

#define CDC_SUBTYPE_ETHERNET   15

Ethernet descriptor subtype.

Definition at line 41 of file cdc.h.

CDC_RESPONSE_AVAILABLE

#define CDC_RESPONSE_AVAILABLE

Value:

( USB_DIR_IN | USB_TYPE_CLASS | USB_RECIP_INTERFACE |           \
          USB_REQUEST_TYPE ( 0x01 ) )

Response available.

Definition at line 44 of file cdc.h.

CDC_NETWORK_CONNECTION

#define CDC_NETWORK_CONNECTION

Value:

( USB_DIR_IN | USB_TYPE_CLASS | USB_RECIP_INTERFACE |           \
          USB_REQUEST_TYPE ( 0x00 ) )

Network connection notification.

Definition at line 49 of file cdc.h.

CDC_CONNECTION_SPEED_CHANGE

#define CDC_CONNECTION_SPEED_CHANGE

Value:

( USB_DIR_IN | USB_TYPE_CLASS | USB_RECIP_INTERFACE |           \
          USB_REQUEST_TYPE ( 0x2a ) )

Connection speed change notification.

Definition at line 54 of file cdc.h.

Function Documentation

FILE_LICENCE()

FILE_LICENCE

(

GPL2_OR_LATER_OR_UBDL

)

cdc_union_descriptor()

struct cdc_union_descriptor* cdc_union_descriptor	(	struct usb_configuration_descriptor *	config,
		struct usb_interface_descriptor *	interface
	)

Locate CDC union functional descriptor.

Parameters

config	Configuration descriptor
interface	Interface descriptor

Return values

desc	Union functional descriptor, or NULL if not found

Definition at line 44 of file cdc.c.

                                                                    {
        struct cdc_union_descriptor *desc;

        for_each_interface_descriptor ( desc, config, interface ) {
                if ( ( desc->header.type == USB_CS_INTERFACE_DESCRIPTOR ) &&
                     ( desc->subtype == CDC_SUBTYPE_UNION ) )
                        return desc;
        }
        return NULL;
}

References CDC_SUBTYPE_UNION, for_each_interface_descriptor, cdc_union_descriptor::header, NULL, cdc_union_descriptor::subtype, usb_descriptor_header::type, and USB_CS_INTERFACE_DESCRIPTOR.

cdc_send_encapsulated_command()

static int cdc_send_encapsulated_command ( struct usb_device *  usb, unsigned int  interface, void *  data, size_t  len  )

inlinestatic

Send encapsulated command.

Parameters

usb	USB device
interface	Interface number
data	Command
len	Length of command

Return values

rc	Return status code

Definition at line 80 of file cdc.h.

                                                         {

        return usb_control ( usb, CDC_SEND_ENCAPSULATED_COMMAND, 0, interface,
                             data, len );
}

References CDC_SEND_ENCAPSULATED_COMMAND, data, len, and usb_control().

Referenced by acm_control_transmit().

cdc_get_encapsulated_response()

static int cdc_get_encapsulated_response ( struct usb_device *  usb, unsigned int  interface, void *  data, size_t  len  )

inlinestatic

Get encapsulated response.

Parameters

usb	USB device
interface	Interface number
data	Response buffer
len	Length of response buffer

Return values

rc	Return status code

Definition at line 97 of file cdc.h.

                                                         {

        return usb_control ( usb, CDC_GET_ENCAPSULATED_RESPONSE, 0, interface,
                             data, len );
}

References CDC_GET_ENCAPSULATED_RESPONSE, data, len, and usb_control().

Referenced by acm_control_receive().