Davicom DM96xx USB Ethernet driver. More...

#include <ipxe/usb.h>
#include <ipxe/usbnet.h>
#include <ipxe/if_ether.h>

Data Structures
struct	dm96xx_interrupt
	DM96xx interrupt data. More...

struct	dm96xx_rx_header
	DM96xx receive header. More...

struct	dm96xx_tx_header
	DM96xx transmit header. More...

struct	dm96xx_device
	A DM96xx network device. More...

Macros
#define	DM96XX_READ_REGISTER
	Read register(s) More...

#define	DM96XX_WRITE_REGISTER
	Write register(s) More...

#define	DM96XX_WRITE1_REGISTER
	Write single register. More...

#define	DM96XX_NCR 0x00
	Network control register. More...

#define	DM96XX_NCR_RST 0x01
	Software reset. More...

#define	DM96XX_NSR 0x01
	Network status register. More...

#define	DM96XX_NSR_LINKST 0x40
	Link status. More...

#define	DM96XX_RCR 0x05
	Receive control register. More...

#define	DM96XX_RCR_ALL 0x08
	Pass all multicast. More...

#define	DM96XX_RCR_RUNT 0x04
	Pass runt packet. More...

#define	DM96XX_RCR_PRMSC 0x02
	Promiscuous mode. More...

#define	DM96XX_RCR_RXEN 0x01
	RX enable. More...

#define	DM96XX_RSR 0x06
	Receive status register. More...

#define	DM96XX_RSR_MF 0x40
	Multicast frame. More...

#define	DM96XX_PAR 0x10
	PHY address registers. More...

#define	DM96XX_CHIPR 0x2c
	Chip revision register. More...

#define	DM96XX_CHIPR_9601 0x00
	DM9601. More...

#define	DM96XX_CHIPR_9620 0x01
	DM9620. More...

#define	DM96XX_MODE_CTL 0x91
	RX header control/status register (DM9620+ only) More...

#define	DM96XX_MODE_CTL_MODE 0x80
	4-byte header mode More...

#define	DM96XX_RESET_DELAY_US 10
	Reset delay (in microseconds) More...

#define	DM96XX_INTR_MAX_FILL 2
	Interrupt maximum fill level. More...

#define	DM96XX_IN_MAX_FILL 8
	Bulk IN maximum fill level. More...

#define	DM96XX_IN_MTU
	Bulk IN buffer size. More...

Functions
	FILE_LICENCE (GPL2_OR_LATER_OR_UBDL)

static int	dm96xx_read_registers (struct dm96xx_device dm96xx, unsigned int offset, void data, size_t len)
	Read registers. More...

static int	dm96xx_read_register (struct dm96xx_device *dm96xx, unsigned int offset)
	Read register. More...

static int	dm96xx_write_registers (struct dm96xx_device dm96xx, unsigned int offset, void data, size_t len)
	Write registers. More...

static int	dm96xx_write_register (struct dm96xx_device *dm96xx, unsigned int offset, uint8_t value)
	Write register. More...

Detailed Description

Davicom DM96xx USB Ethernet driver.

Definition in file dm96xx.h.

Macro Definition Documentation

◆ DM96XX_READ_REGISTER

#define DM96XX_READ_REGISTER

Value:

( USB_DIR_IN | USB_TYPE_VENDOR | USB_RECIP_DEVICE | \

USB_REQUEST_TYPE ( 0x00 ) )

USB_TYPE_VENDOR

#define USB_TYPE_VENDOR

Vendor-specific request type.

Definition: usb.h:92

USB_DIR_IN

#define USB_DIR_IN

Data transfer is from device to host.

Definition: usb.h:83

USB_RECIP_DEVICE

#define USB_RECIP_DEVICE

Request recipient is the device.

Definition: usb.h:98

Read register(s)

Definition at line 17 of file dm96xx.h.

◆ DM96XX_WRITE_REGISTER

#define DM96XX_WRITE_REGISTER

Value:

( USB_DIR_OUT | USB_TYPE_VENDOR | USB_RECIP_DEVICE | \

USB_REQUEST_TYPE ( 0x01 ) )

USB_DIR_OUT

#define USB_DIR_OUT

Data transfer is from host to device.

Definition: usb.h:80

USB_TYPE_VENDOR

#define USB_TYPE_VENDOR

Vendor-specific request type.

Definition: usb.h:92

USB_RECIP_DEVICE

#define USB_RECIP_DEVICE

Request recipient is the device.

Definition: usb.h:98

Write register(s)

Definition at line 22 of file dm96xx.h.

◆ DM96XX_WRITE1_REGISTER

#define DM96XX_WRITE1_REGISTER

Value:

( USB_DIR_OUT | USB_TYPE_VENDOR | USB_RECIP_DEVICE | \

USB_REQUEST_TYPE ( 0x03 ) )

USB_DIR_OUT

#define USB_DIR_OUT

Data transfer is from host to device.

Definition: usb.h:80

USB_TYPE_VENDOR

#define USB_TYPE_VENDOR

Vendor-specific request type.

Definition: usb.h:92

USB_RECIP_DEVICE

#define USB_RECIP_DEVICE

Request recipient is the device.

Definition: usb.h:98

Write single register.

Definition at line 27 of file dm96xx.h.

◆ DM96XX_NCR

#define DM96XX_NCR 0x00

Network control register.

Definition at line 32 of file dm96xx.h.

◆ DM96XX_NCR_RST

#define DM96XX_NCR_RST 0x01

Software reset.

Definition at line 33 of file dm96xx.h.

◆ DM96XX_NSR

#define DM96XX_NSR 0x01

Network status register.

Definition at line 36 of file dm96xx.h.

◆ DM96XX_NSR_LINKST

#define DM96XX_NSR_LINKST 0x40

Link status.

Definition at line 37 of file dm96xx.h.

◆ DM96XX_RCR

#define DM96XX_RCR 0x05

Receive control register.

Definition at line 40 of file dm96xx.h.

◆ DM96XX_RCR_ALL

#define DM96XX_RCR_ALL 0x08

Pass all multicast.

Definition at line 41 of file dm96xx.h.

◆ DM96XX_RCR_RUNT

#define DM96XX_RCR_RUNT 0x04

Pass runt packet.

Definition at line 42 of file dm96xx.h.

◆ DM96XX_RCR_PRMSC

#define DM96XX_RCR_PRMSC 0x02

Promiscuous mode.

Definition at line 43 of file dm96xx.h.

◆ DM96XX_RCR_RXEN

#define DM96XX_RCR_RXEN 0x01

RX enable.

Definition at line 44 of file dm96xx.h.

◆ DM96XX_RSR

#define DM96XX_RSR 0x06

Receive status register.

Definition at line 47 of file dm96xx.h.

◆ DM96XX_RSR_MF

#define DM96XX_RSR_MF 0x40

Multicast frame.

Definition at line 48 of file dm96xx.h.

◆ DM96XX_PAR

#define DM96XX_PAR 0x10

PHY address registers.

Definition at line 51 of file dm96xx.h.

◆ DM96XX_CHIPR

#define DM96XX_CHIPR 0x2c

Chip revision register.

Definition at line 54 of file dm96xx.h.

◆ DM96XX_CHIPR_9601

#define DM96XX_CHIPR_9601 0x00

DM9601.

Definition at line 55 of file dm96xx.h.

◆ DM96XX_CHIPR_9620

#define DM96XX_CHIPR_9620 0x01

DM9620.

Definition at line 56 of file dm96xx.h.

◆ DM96XX_MODE_CTL

#define DM96XX_MODE_CTL 0x91

RX header control/status register (DM9620+ only)

Definition at line 59 of file dm96xx.h.

◆ DM96XX_MODE_CTL_MODE

#define DM96XX_MODE_CTL_MODE 0x80

4-byte header mode

Definition at line 60 of file dm96xx.h.

◆ DM96XX_RESET_DELAY_US

#define DM96XX_RESET_DELAY_US 10

Reset delay (in microseconds)

Definition at line 175 of file dm96xx.h.

◆ DM96XX_INTR_MAX_FILL

#define DM96XX_INTR_MAX_FILL 2

Interrupt maximum fill level.

This is a policy decision.

Definition at line 181 of file dm96xx.h.

◆ DM96XX_IN_MAX_FILL

#define DM96XX_IN_MAX_FILL 8

Bulk IN maximum fill level.

This is a policy decision.

Definition at line 187 of file dm96xx.h.

◆ DM96XX_IN_MTU

#define DM96XX_IN_MTU

Value:

( 4 /* DM96xx header */ + ETH_FRAME_LEN + \

4 /* possible VLAN header */ + 4 /* CRC */ )

ETH_FRAME_LEN

#define ETH_FRAME_LEN

Definition: if_ether.h:11

Bulk IN buffer size.

Definition at line 190 of file dm96xx.h.

Function Documentation

◆ FILE_LICENCE()

FILE_LICENCE ( GPL2_OR_LATER_OR_UBDL )

◆ dm96xx_read_registers()

static int dm96xx_read_registers	(	struct dm96xx_device *	dm96xx,
		unsigned int	offset,
		void *	data,
		size_t	len
	)

inlinestatic

Read registers.

Parameters

dm96xx	DM96xx device
offset	Register offset
data	Data buffer
len	Length of data

Return values

rc	Return status code

Definition at line 116 of file dm96xx.h.

                                                  {
 
         return usb_control ( dm96xx->usb, DM96XX_READ_REGISTER, 0, offset,
                              data, len );
 }

References data, DM96XX_READ_REGISTER, len, offset, dm96xx_device::usb, and usb_control().

Referenced by dm96xx_read_mac(), and dm96xx_read_register().

◆ dm96xx_read_register()

static int dm96xx_read_register	(	struct dm96xx_device *	dm96xx,
		unsigned int	offset
	)

inlinestatic

Read register.

Parameters

dm96xx	DM96xx device
offset	Register offset

Return values

value Register value, or negative error

Definition at line 131 of file dm96xx.h.

                                                                            {
         uint8_t value;
         int rc;
 
         if ( ( rc = dm96xx_read_registers ( dm96xx, offset, &value,
                                             sizeof ( value ) ) ) != 0 )
                 return rc;
         return value;
 }

References dm96xx_read_registers(), offset, rc, and value.

Referenced by dm96xx_check_link(), dm96xx_reset(), and dm96xx_rx_mode().

◆ dm96xx_write_registers()

static int dm96xx_write_registers	(	struct dm96xx_device *	dm96xx,
		unsigned int	offset,
		void *	data,
		size_t	len
	)

inlinestatic

Write registers.

Parameters

dm96xx	DM96xx device
offset	Register offset
data	Data buffer
len	Length of data

Return values

rc	Return status code

Definition at line 151 of file dm96xx.h.

                                                   {
 
         return usb_control ( dm96xx->usb, DM96XX_WRITE_REGISTER, 0, offset,
                              data, len );
 }

References data, DM96XX_WRITE_REGISTER, len, offset, dm96xx_device::usb, and usb_control().

Referenced by dm96xx_write_mac().

◆ dm96xx_write_register()

static int dm96xx_write_register	(	struct dm96xx_device *	dm96xx,
		unsigned int	offset,
		uint8_t	value
	)

inlinestatic

Write register.

Parameters

dm96xx	DM96xx device
offset	Register offset
value	Register value

Return values

rc	Return status code

Definition at line 167 of file dm96xx.h.

                                         {
 
         return usb_control ( dm96xx->usb, DM96XX_WRITE1_REGISTER, value,
                              offset, NULL, 0 );
 }

References DM96XX_WRITE1_REGISTER, NULL, offset, dm96xx_device::usb, usb_control(), and value.

Referenced by dm96xx_open(), dm96xx_reset(), and dm96xx_rx_mode().

Data Structures

Macros

Functions

Detailed Description

Macro Definition Documentation

◆ DM96XX_READ_REGISTER

◆ DM96XX_WRITE_REGISTER

◆ DM96XX_WRITE1_REGISTER

◆ DM96XX_NCR

◆ DM96XX_NCR_RST

◆ DM96XX_NSR

◆ DM96XX_NSR_LINKST

◆ DM96XX_RCR

◆ DM96XX_RCR_ALL

◆ DM96XX_RCR_RUNT

◆ DM96XX_RCR_PRMSC

◆ DM96XX_RCR_RXEN

◆ DM96XX_RSR

◆ DM96XX_RSR_MF

◆ DM96XX_PAR

◆ DM96XX_CHIPR

◆ DM96XX_CHIPR_9601

◆ DM96XX_CHIPR_9620

◆ DM96XX_MODE_CTL

◆ DM96XX_MODE_CTL_MODE

◆ DM96XX_RESET_DELAY_US

◆ DM96XX_INTR_MAX_FILL

◆ DM96XX_IN_MAX_FILL

◆ DM96XX_IN_MTU

Function Documentation

◆ FILE_LICENCE()

◆ dm96xx_read_registers()

◆ dm96xx_read_register()

◆ dm96xx_write_registers()

◆ dm96xx_write_register()