#include <Library/UefiDriverEntryPoint.h>
#include <Library/UefiBootServicesTableLib.h>
#include <Library/UefiLib.h>
#include <Library/DevicePathLib.h>
#include <Library/DebugLib.h>
#include <Library/MemoryAllocationLib.h>
#include <Library/BaseMemoryLib.h>
#include <Library/UefiUsbLib.h>
#include <Protocol/UsbIo.h>
#include <Protocol/UsbEthernetProtocol.h>

Data Structures
struct	USB_ETHERNET_DRIVER

struct	USB_NCM_TRANSFER_HEADER_16

struct	USB_NCM_DATAGRAM_POINTER_16

struct	USB_NCM_DATA_GRAM

struct	BIT_MAP

Macros
#define	USB_NCM_DRIVER_VERSION 1

#define	USB_ETHERNET_BULK_TIMEOUT 1

#define	USB_ETHERNET_TRANSFER_TIMEOUT 200

#define	USB_NCM_MAX_NTB_SIZE 0xFFFF

#define	USB_ETHERNET_FRAME_SIZE 0x5F2

#define	USB_NCM_NTH_SIGN_16 0x484D434E

#define	USB_NCM_NDP_SIGN_16 0x304D434E

#define	USB_NCM_NDP_SIGN_16_CRC 0x314D434E

#define	USB_NCM_NTH_LENGTH 0x000C

#define	USB_NCM_NDP_LENGTH 0x0010

#define	USB_ETHERNET_SIGNATURE SIGNATURE_32('u', 'e', 't', 'h')

#define	USB_ETHERNET_DEV_FROM_THIS(a) CR (a, USB_ETHERNET_DRIVER, UsbEth, USB_ETHERNET_SIGNATURE)

Functions
EFI_STATUS EFIAPI	UsbNcmDriverSupported (IN EFI_DRIVER_BINDING_PROTOCOL This, IN EFI_HANDLE ControllerHandle, IN EFI_DEVICE_PATH_PROTOCOL RemainingDevicePath)

EFI_STATUS EFIAPI	UsbNcmDriverStart (IN EFI_DRIVER_BINDING_PROTOCOL This, IN EFI_HANDLE ControllerHandle, IN EFI_DEVICE_PATH_PROTOCOL RemainingDevicePath)

EFI_STATUS EFIAPI	UsbNcmDriverStop (IN EFI_DRIVER_BINDING_PROTOCOL This, IN EFI_HANDLE ControllerHandle, IN UINTN NumberOfChildren, IN EFI_HANDLE ChildHandleBuffer)

EFI_STATUS	LoadAllDescriptor (IN EFI_USB_IO_PROTOCOL UsbIo, OUT EFI_USB_CONFIG_DESCRIPTOR *ConfigDesc)

BOOLEAN	NextDescriptor (IN EFI_USB_CONFIG_DESCRIPTOR Desc, IN OUT UINTN Offset)

EFI_STATUS	GetFunctionalDescriptor (IN EFI_USB_CONFIG_DESCRIPTOR Config, IN UINT8 FunDescriptorType, OUT VOID DataBuffer)

VOID	GetEndpoint (IN EFI_USB_IO_PROTOCOL UsbIo, IN OUT USB_ETHERNET_DRIVER UsbEthDriver)

EFI_STATUS EFIAPI	UsbEthNcmReceive (IN PXE_CDB Cdb, IN EDKII_USB_ETHERNET_PROTOCOL This, IN OUT VOID Packet, IN OUT UINTN PacketLength)

EFI_STATUS EFIAPI	UsbEthNcmTransmit (IN PXE_CDB Cdb, IN EDKII_USB_ETHERNET_PROTOCOL This, IN VOID Packet, IN OUT UINTN PacketLength)

EFI_STATUS EFIAPI	UsbEthNcmInterrupt (IN EDKII_USB_ETHERNET_PROTOCOL This, IN BOOLEAN IsNewTransfer, IN UINTN PollingInterval, IN EFI_USB_DEVICE_REQUEST Request)

EFI_STATUS EFIAPI	InterruptCallback (IN VOID Data, IN UINTN DataLength, IN VOID Context, IN UINT32 Status)

EFI_STATUS EFIAPI	GetUsbEthMacAddress (IN EDKII_USB_ETHERNET_PROTOCOL This, OUT EFI_MAC_ADDRESS MacAddress)

EFI_STATUS EFIAPI	UsbEthNcmBulkSize (IN EDKII_USB_ETHERNET_PROTOCOL This, OUT UINTN BulkSize)

EFI_STATUS EFIAPI	GetUsbHeaderFunDescriptor (IN EDKII_USB_ETHERNET_PROTOCOL This, OUT USB_HEADER_FUN_DESCRIPTOR UsbHeaderFunDescriptor)

EFI_STATUS EFIAPI	GetUsbUnionFunDescriptor (IN EDKII_USB_ETHERNET_PROTOCOL This, OUT USB_UNION_FUN_DESCRIPTOR UsbUnionFunDescriptor)

EFI_STATUS EFIAPI	GetUsbEthFunDescriptor (IN EDKII_USB_ETHERNET_PROTOCOL This, OUT USB_ETHERNET_FUN_DESCRIPTOR UsbEthFunDescriptor)

EFI_STATUS EFIAPI	SetUsbEthMcastFilter (IN EDKII_USB_ETHERNET_PROTOCOL This, IN UINT16 Value, IN VOID McastAddr)

EFI_STATUS EFIAPI	SetUsbEthPowerFilter (IN EDKII_USB_ETHERNET_PROTOCOL This, IN UINT16 Value, IN UINT16 Length, IN VOID PatternFilter)

EFI_STATUS EFIAPI	GetUsbEthPowerFilter (IN EDKII_USB_ETHERNET_PROTOCOL This, IN UINT16 Value, OUT BOOLEAN PatternActive)

EFI_STATUS EFIAPI	SetUsbEthPacketFilter (IN EDKII_USB_ETHERNET_PROTOCOL *This, IN UINT16 Value)

EFI_STATUS EFIAPI	GetUsbEthStatistic (IN EDKII_USB_ETHERNET_PROTOCOL This, IN UINT16 FeatureSelector, OUT VOID Statistic)

Variables
EFI_COMPONENT_NAME2_PROTOCOL	gUsbNcmComponentName2

Detailed Description

Header file for USB Network Control Model driver

Copyright (c) 2023, American Megatrends International LLC. All rights reserved.
SPDX-License-Identifier: BSD-2-Clause-Patent

Definition in file UsbCdcNcm.h.

Macro Definition Documentation

◆ USB_ETHERNET_BULK_TIMEOUT

#define USB_ETHERNET_BULK_TIMEOUT 1

Definition at line 40 of file UsbCdcNcm.h.

◆ USB_ETHERNET_DEV_FROM_THIS

#define USB_ETHERNET_DEV_FROM_THIS ( a ) CR (a, USB_ETHERNET_DRIVER, UsbEth, USB_ETHERNET_SIGNATURE)

Definition at line 75 of file UsbCdcNcm.h.

◆ USB_ETHERNET_FRAME_SIZE

#define USB_ETHERNET_FRAME_SIZE 0x5F2

Definition at line 43 of file UsbCdcNcm.h.

◆ USB_ETHERNET_SIGNATURE

#define USB_ETHERNET_SIGNATURE SIGNATURE_32('u', 'e', 't', 'h')

Definition at line 74 of file UsbCdcNcm.h.

◆ USB_ETHERNET_TRANSFER_TIMEOUT

#define USB_ETHERNET_TRANSFER_TIMEOUT 200

Definition at line 41 of file UsbCdcNcm.h.

◆ USB_NCM_DRIVER_VERSION

#define USB_NCM_DRIVER_VERSION 1

Definition at line 39 of file UsbCdcNcm.h.

◆ USB_NCM_MAX_NTB_SIZE

#define USB_NCM_MAX_NTB_SIZE 0xFFFF

Definition at line 42 of file UsbCdcNcm.h.

◆ USB_NCM_NDP_LENGTH

#define USB_NCM_NDP_LENGTH 0x0010

Definition at line 50 of file UsbCdcNcm.h.

◆ USB_NCM_NDP_SIGN_16

#define USB_NCM_NDP_SIGN_16 0x304D434E

Definition at line 47 of file UsbCdcNcm.h.

◆ USB_NCM_NDP_SIGN_16_CRC

#define USB_NCM_NDP_SIGN_16_CRC 0x314D434E

Definition at line 48 of file UsbCdcNcm.h.

◆ USB_NCM_NTH_LENGTH

#define USB_NCM_NTH_LENGTH 0x000C

Definition at line 49 of file UsbCdcNcm.h.

◆ USB_NCM_NTH_SIGN_16

#define USB_NCM_NTH_SIGN_16 0x484D434E

Definition at line 46 of file UsbCdcNcm.h.

Function Documentation

◆ GetEndpoint()

VOID GetEndpoint	(	IN EFI_USB_IO_PROTOCOL *	UsbIo,
		IN OUT USB_ETHERNET_DRIVER *	UsbEthDriver
	)

Get USB Ethernet IO endpoint and USB CDC data IO endpoint.

Parameters

[in]	UsbIo	A pointer to the EFI_USB_IO_PROTOCOL instance.
[in,out]	UsbEthDriver	A pointer to the USB_ETHERNET_DRIVER instance.

Definition at line 157 of file UsbEcmFunction.c.

◆ GetFunctionalDescriptor()

EFI_STATUS GetFunctionalDescriptor	(	IN EFI_USB_CONFIG_DESCRIPTOR *	Config,
		IN UINT8	FunDescriptorType,
		OUT VOID *	DataBuffer
	)

Read Function descriptor

Parameters

[in]	Config	A pointer to all of configuration.
[in]	FunDescriptorType	USB CDC class descriptor SubType.
[out]	DataBuffer	A pointer to the Data of corresponding to device capability.

Return values

EFI_SUCCESS	The device capability descriptor was retrieved successfully.
EFI_UNSUPPORTED	No supported.
EFI_NOT_FOUND	The device capability descriptor was not found.

Definition at line 100 of file UsbEcmFunction.c.

◆ GetUsbEthFunDescriptor()

EFI_STATUS EFIAPI GetUsbEthFunDescriptor	(	IN EDKII_USB_ETHERNET_PROTOCOL *	This,
		OUT USB_ETHERNET_FUN_DESCRIPTOR *	UsbEthFunDescriptor
	)

Retrieves the USB Ethernet functional Descriptor.

This function get the Mac Address, Ethernet statistics, maximum segment size, number of multicast filters, and number of pattern filters from Ethernet functional Descriptor.

Parameters

[in]	This	A pointer to the EDKII_USB_ETHERNET_PROTOCOL instance.
[out]	UsbEthFunDescriptor	A pointer to the caller allocated USB Ethernet Functional Descriptor.

Return values

EFI_SUCCESS	The USB Ethernet Functional descriptor was retrieved successfully.
EFI_INVALID_PARAMETER	UsbEthFunDescriptor is NULL.
EFI_NOT_FOUND	The USB Ethernet Functional descriptor was not found.

Definition at line 577 of file UsbEcmFunction.c.

◆ GetUsbEthMacAddress()

EFI_STATUS EFIAPI GetUsbEthMacAddress	(	IN EDKII_USB_ETHERNET_PROTOCOL *	This,
		OUT EFI_MAC_ADDRESS *	MacAddress
	)

Retrieves the USB Ethernet Mac Address.

Parameters

[in]	This	A pointer to the EDKII_USB_ETHERNET_PROTOCOL instance.
[out]	MacAddress	A pointer to the caller allocated USB Ethernet Mac Address.

Return values

EFI_SUCCESS	The USB Header Functional descriptor was retrieved successfully.
EFI_INVALID_PARAMETER	UsbHeaderFunDescriptor is NULL.
EFI_NOT_FOUND	The USB Header Functional descriptor was not found.

Definition at line 421 of file UsbEcmFunction.c.

◆ GetUsbEthPowerFilter()

EFI_STATUS EFIAPI GetUsbEthPowerFilter	(	IN EDKII_USB_ETHERNET_PROTOCOL *	This,
		IN UINT16	Value,
		OUT BOOLEAN *	PatternActive
	)

This request retrieves the status of the specified Ethernet power management pattern filter from the device.

Parameters

[in]	This	A pointer to the EDKII_USB_ETHERNET_PROTOCOL instance.
[in]	Value	The filter number.
[out]	PatternActive	A pointer to the pattern active boolean.

Return values

EFI_SUCCESS	The request executed successfully.
EFI_TIMEOUT	A timeout occurred executing the request.
EFI_DEVICE_ERROR	The request failed due to a device error.
EFI_INVALID_PARAMETER	One of the parameters has an invalid value.
EFI_UNSUPPORTED	Not supported.

Definition at line 717 of file UsbEcmFunction.c.

◆ GetUsbEthStatistic()

EFI_STATUS EFIAPI GetUsbEthStatistic	(	IN EDKII_USB_ETHERNET_PROTOCOL *	This,
		IN UINT16	FeatureSelector,
		OUT VOID *	Statistic
	)

This request is used to retrieve a statistic based on the feature selector.

Parameters

[in]	This	A pointer to the EDKII_USB_ETHERNET_PROTOCOL instance.
[in]	FeatureSelector	Value of the feature selector.
[out]	Statistic	A pointer to the 32 bit unsigned integer.

Return values

EFI_SUCCESS	The request executed successfully.
EFI_TIMEOUT	A timeout occurred executing the request.
EFI_DEVICE_ERROR	The request failed due to a device error.
EFI_INVALID_PARAMETER	One of the parameters has an invalid value.
EFI_UNSUPPORTED	Not supported.

Definition at line 842 of file UsbEcmFunction.c.

◆ GetUsbHeaderFunDescriptor()

EFI_STATUS EFIAPI GetUsbHeaderFunDescriptor	(	IN EDKII_USB_ETHERNET_PROTOCOL *	This,
		OUT USB_HEADER_FUN_DESCRIPTOR *	UsbHeaderFunDescriptor
	)

Retrieves the USB Header functional Descriptor.

Parameters

[in]	This	A pointer to the EDKII_USB_ETHERNET_PROTOCOL instance.
[out]	UsbHeaderFunDescriptor	A pointer to the caller allocated USB Header Functional Descriptor.

Return values

EFI_SUCCESS	The USB Header Functional descriptor was retrieved successfully.
EFI_INVALID_PARAMETER	UsbHeaderFunDescriptor is NULL.
EFI_NOT_FOUND	The USB Header Functional descriptor was not found.

Definition at line 511 of file UsbEcmFunction.c.

◆ GetUsbUnionFunDescriptor()

EFI_STATUS EFIAPI GetUsbUnionFunDescriptor	(	IN EDKII_USB_ETHERNET_PROTOCOL *	This,
		OUT USB_UNION_FUN_DESCRIPTOR *	UsbUnionFunDescriptor
	)

Retrieves the USB Union functional Descriptor.

Parameters

[in]	This	A pointer to the EDKII_USB_ETHERNET_PROTOCOL instance.
[out]	UsbUnionFunDescriptor	A pointer to the caller allocated USB Union Functional Descriptor.

Return values

EFI_SUCCESS	The USB Union Functional descriptor was retrieved successfully.
EFI_INVALID_PARAMETER	UsbUnionFunDescriptor is NULL.
EFI_NOT_FOUND	The USB Union Functional descriptor was not found.

Definition at line 542 of file UsbEcmFunction.c.

◆ InterruptCallback()

EFI_STATUS EFIAPI InterruptCallback	(	IN VOID *	Data,
		IN UINTN	DataLength,
		IN VOID *	Context,
		IN UINT32	Status
	)

Async USB transfer callback routine.

Parameters

[in]	Data	Data received or sent via the USB Asynchronous Transfer, if the transfer completed successfully.
[in]	DataLength	The length of Data received or sent via the Asynchronous Transfer, if transfer successfully completes.
[in]	Context	Data passed from UsbAsyncInterruptTransfer() request.
[in]	Status	Indicates the result of the asynchronous transfer.

Return values

EFI_SUCCESS	The asynchronous USB transfer request has been successfully executed.
EFI_DEVICE_ERROR	The asynchronous USB transfer request failed.

Definition at line 327 of file UsbEcmFunction.c.

◆ LoadAllDescriptor()

EFI_STATUS LoadAllDescriptor	(	IN EFI_USB_IO_PROTOCOL *	UsbIo,
		OUT EFI_USB_CONFIG_DESCRIPTOR **	ConfigDesc
	)

Load All of device descriptor.

Parameters

[in]	UsbIo	A pointer to the EFI_USB_IO_PROTOCOL instance.
[out]	ConfigDesc	A pointer to the configuration descriptor.

Return values

EFI_SUCCESS	The request executed successfully.
EFI_OUT_OF_RESOURCES	The request could not be completed because the buffer specified by DescriptorLength and Descriptor is not large enough to hold the result of the request.
EFI_TIMEOUT	A timeout occurred executing the request.
EFI_DEVICE_ERROR	The request failed due to a device error. The transfer status is returned in Status.

Definition at line 27 of file UsbEcmFunction.c.

◆ NextDescriptor()

BOOLEAN NextDescriptor	(	IN EFI_USB_CONFIG_DESCRIPTOR *	Desc,
		IN OUT UINTN *	Offset
	)

Returns pointer to the next descriptor for the pack of USB descriptors located in continues memory segment

Parameters

[in]	Desc	A pointer to the CONFIG_DESCRIPTOR instance.
[in,out]	Offset	A pointer to the sum of descriptor length.

Return values

TRUE	The request executed successfully.
FALSE	No next descriptor.

Definition at line 65 of file UsbEcmFunction.c.

◆ SetUsbEthMcastFilter()

EFI_STATUS EFIAPI SetUsbEthMcastFilter	(	IN EDKII_USB_ETHERNET_PROTOCOL *	This,
		IN UINT16	Value,
		IN VOID *	McastAddr
	)

This request sets the Ethernet device multicast filters as specified in the sequential list of 48 bit Ethernet multicast addresses.

Parameters

[in]	This	A pointer to the EDKII_USB_ETHERNET_PROTOCOL instance.
[in]	Value	Number of filters.
[in]	McastAddr	A pointer to the value of the multicast addresses.

Return values

EFI_SUCCESS	The request executed successfully.
EFI_TIMEOUT	A timeout occurred executing the request.
EFI_DEVICE_ERROR	The request failed due to a device error.
EFI_INVALID_PARAMETER	One of the parameters has an invalid value.
EFI_UNSUPPORTED	Not supported.

Definition at line 612 of file UsbEcmFunction.c.

◆ SetUsbEthPacketFilter()

EFI_STATUS EFIAPI SetUsbEthPacketFilter	(	IN EDKII_USB_ETHERNET_PROTOCOL *	This,
		IN UINT16	Value
	)

This request is used to configure device Ethernet packet filter settings.

Parameters

[in]	This	A pointer to the EDKII_USB_ETHERNET_PROTOCOL instance.
[in]	Value	Packet Filter Bitmap.

Return values

EFI_SUCCESS	The request executed successfully.
EFI_TIMEOUT	A timeout occurred executing the request.
EFI_DEVICE_ERROR	The request failed due to a device error.
EFI_INVALID_PARAMETER	One of the parameters has an invalid value.
EFI_UNSUPPORTED	Not supported.

Definition at line 794 of file UsbEcmFunction.c.

◆ SetUsbEthPowerFilter()

EFI_STATUS EFIAPI SetUsbEthPowerFilter	(	IN EDKII_USB_ETHERNET_PROTOCOL *	This,
		IN UINT16	Value,
		IN UINT16	Length,
		IN VOID *	PatternFilter
	)

This request sets up the specified Ethernet power management pattern filter as described in the data structure.

Parameters

[in]	This	A pointer to the EDKII_USB_ETHERNET_PROTOCOL instance.
[in]	Value	Number of filters.
[in]	Length	Size of the power management pattern filter data.
[in]	PatternFilter	A pointer to the power management pattern filter structure.

Return values

EFI_SUCCESS	The request executed successfully.
EFI_TIMEOUT	A timeout occurred executing the request.
EFI_DEVICE_ERROR	The request failed due to a device error.
EFI_INVALID_PARAMETER	One of the parameters has an invalid value.
EFI_UNSUPPORTED	Not supported.

Definition at line 670 of file UsbEcmFunction.c.

◆ UsbEthNcmBulkSize()

EFI_STATUS EFIAPI UsbEthNcmBulkSize	(	IN EDKII_USB_ETHERNET_PROTOCOL *	This,
		OUT UINTN *	BulkSize
	)

Get the USB NCM max NTB size.

Parameters

[in]	This	A pointer to the EDKII_USB_ETHERNET_PROTOCOL instance.
[out]	BulkSize	A pointer to the Bulk transfer data size.

Return values

EFI_SUCCESS Get the USB NCM max NTB size successfully.

Definition at line 575 of file UsbNcmFunction.c.

◆ UsbEthNcmInterrupt()

EFI_STATUS EFIAPI UsbEthNcmInterrupt	(	IN EDKII_USB_ETHERNET_PROTOCOL *	This,
		IN BOOLEAN	IsNewTransfer,
		IN UINTN	PollingInterval,
		IN EFI_USB_DEVICE_REQUEST *	Request
	)

This function is used to manage a USB device with an interrupt transfer pipe.

Parameters

[in]	This	A pointer to the EDKII_USB_ETHERNET_PROTOCOL instance.
[in]	IsNewTransfer	If TRUE, a new transfer will be submitted to USB controller. If FALSE, the interrupt transfer is deleted from the device's interrupt transfer queue.
[in]	PollingInterval	Indicates the periodic rate, in milliseconds, that the transfer is to be executed.This parameter is required when IsNewTransfer is TRUE. The value must be between 1 to 255, otherwise EFI_INVALID_PARAMETER is returned. The units are in milliseconds.
[in]	Request	A pointer to the EFI_USB_DEVICE_REQUEST data.

Return values

EFI_SUCCESS	The asynchronous USB transfer request transfer has been successfully executed.
EFI_DEVICE_ERROR	The asynchronous USB transfer request failed.

Definition at line 463 of file UsbNcmFunction.c.

◆ UsbEthNcmReceive()

EFI_STATUS EFIAPI UsbEthNcmReceive	(	IN PXE_CDB *	Cdb,
		IN EDKII_USB_ETHERNET_PROTOCOL *	This,
		IN OUT VOID *	Packet,
		IN OUT UINTN *	PacketLength
	)

This function is used to manage a USB device with the bulk transfer pipe. The endpoint is Bulk in.

Parameters

[in]	Cdb	A pointer to the command descriptor block.
[in]	This	A pointer to the EDKII_USB_ETHERNET_PROTOCOL instance.
[in,out]	Packet	A pointer to the buffer of data that will be transmitted to USB device or received from USB device.
[in,out]	PacketLength	A pointer to the PacketLength.

Return values

EFI_SUCCESS	The bulk transfer has been successfully executed.
EFI_DEVICE_ERROR	The transfer failed. The transfer status is returned in status.
EFI_INVALID_PARAMETER	One or more parameters are invalid.
EFI_OUT_OF_RESOURCES	The request could not be submitted due to a lack of resources.
EFI_TIMEOUT	The control transfer fails due to timeout.

Definition at line 217 of file UsbNcmFunction.c.

◆ UsbEthNcmTransmit()

EFI_STATUS EFIAPI UsbEthNcmTransmit	(	IN PXE_CDB *	Cdb,
		IN EDKII_USB_ETHERNET_PROTOCOL *	This,
		IN VOID *	Packet,
		IN OUT UINTN *	PacketLength
	)

This function is used to manage a USB device with the bulk transfer pipe. The endpoint is Bulk out.

Parameters

[in]	Cdb	A pointer to the command descriptor block.
[in]	This	A pointer to the EDKII_USB_ETHERNET_PROTOCOL instance.
[in]	Packet	A pointer to the buffer of data that will be transmitted to USB device or received from USB device.
[in,out]	PacketLength	A pointer to the PacketLength.

Return values

EFI_SUCCESS	The bulk transfer has been successfully executed.
EFI_DEVICE_ERROR	The transfer failed. The transfer status is returned in status.
EFI_INVALID_PARAMETER	One or more parameters are invalid.
EFI_OUT_OF_RESOURCES	The request could not be submitted due to a lack of resources.
EFI_TIMEOUT	The control transfer fails due to timeout.

Definition at line 333 of file UsbNcmFunction.c.

◆ UsbNcmDriverStart()

EFI_STATUS EFIAPI UsbNcmDriverStart	(	IN EFI_DRIVER_BINDING_PROTOCOL *	This,
		IN EFI_HANDLE	ControllerHandle,
		IN EFI_DEVICE_PATH_PROTOCOL *	RemainingDevicePath
	)

USB NCM Driver Binding Start.

Parameters

[in]	This	Protocol instance pointer.
[in]	ControllerHandle	Handle of device to bind driver to.
[in]	RemainingDevicePath	Optional parameter use to pick a specific child device to start.

Return values

EFI_SUCCESS	This driver is added to ControllerHandle
EFI_DEVICE_ERROR	This driver could not be started due to a device error
EFI_OUT_OF_RESOURCES	The driver could not install successfully due to a lack of resources.
other	This driver does not support this device

Definition at line 293 of file UsbCdcNcm.c.

◆ UsbNcmDriverStop()

EFI_STATUS EFIAPI UsbNcmDriverStop	(	IN EFI_DRIVER_BINDING_PROTOCOL *	This,
		IN EFI_HANDLE	ControllerHandle,
		IN UINTN	NumberOfChildren,
		IN EFI_HANDLE *	ChildHandleBuffer
	)

USB NCM Driver Binding Stop.

Parameters

[in]	This	Protocol instance pointer.
[in]	ControllerHandle	Handle of device to stop driver on
[in]	NumberOfChildren	Number of Handles in ChildHandleBuffer. If number of children is zero stop the entire bus driver.
[in]	ChildHandleBuffer	List of Child Handles to Stop.

Return values

EFI_SUCCESS	This driver is removed ControllerHandle
other	This driver was not removed from this device

Definition at line 430 of file UsbCdcNcm.c.

◆ UsbNcmDriverSupported()

EFI_STATUS EFIAPI UsbNcmDriverSupported	(	IN EFI_DRIVER_BINDING_PROTOCOL *	This,
		IN EFI_HANDLE	ControllerHandle,
		IN EFI_DEVICE_PATH_PROTOCOL *	RemainingDevicePath
	)

USB NCM Driver Binding Support.

Parameters

[in]	This	Protocol instance pointer.
[in]	ControllerHandle	Handle of device to test.
[in]	RemainingDevicePath	Optional parameter use to pick a specific child device to start.

Return values

EFI_SUCCESS	This driver supports this device.
EFI_ALREADY_STARTED	This driver is already running on this device.
other	This driver does not support this device.

Definition at line 67 of file UsbCdcNcm.c.

Variable Documentation

◆ gUsbNcmComponentName2

EFI_COMPONENT_NAME2_PROTOCOL gUsbNcmComponentName2

extern

Definition at line 44 of file ComponentName.c.

Data Structures

Macros

Functions

Variables

Detailed Description

Macro Definition Documentation

◆ USB_ETHERNET_BULK_TIMEOUT

◆ USB_ETHERNET_DEV_FROM_THIS

◆ USB_ETHERNET_FRAME_SIZE

◆ USB_ETHERNET_SIGNATURE

◆ USB_ETHERNET_TRANSFER_TIMEOUT

◆ USB_NCM_DRIVER_VERSION

◆ USB_NCM_MAX_NTB_SIZE

◆ USB_NCM_NDP_LENGTH

◆ USB_NCM_NDP_SIGN_16

◆ USB_NCM_NDP_SIGN_16_CRC

◆ USB_NCM_NTH_LENGTH

◆ USB_NCM_NTH_SIGN_16

Function Documentation

◆ GetEndpoint()

◆ GetFunctionalDescriptor()

◆ GetUsbEthFunDescriptor()

◆ GetUsbEthMacAddress()

◆ GetUsbEthPowerFilter()

◆ GetUsbEthStatistic()

◆ GetUsbHeaderFunDescriptor()

◆ GetUsbUnionFunDescriptor()

◆ InterruptCallback()

◆ LoadAllDescriptor()

◆ NextDescriptor()

◆ SetUsbEthMcastFilter()

◆ SetUsbEthPacketFilter()

◆ SetUsbEthPowerFilter()

◆ UsbEthNcmBulkSize()

◆ UsbEthNcmInterrupt()

◆ UsbEthNcmReceive()

◆ UsbEthNcmTransmit()

◆ UsbNcmDriverStart()

◆ UsbNcmDriverStop()

◆ UsbNcmDriverSupported()

Variable Documentation

◆ gUsbNcmComponentName2