Home | History | Annotate | Download | only in nge
      1 /*
      2  * CDDL HEADER START
      3  *
      4  * The contents of this file are subject to the terms of the
      5  * Common Development and Distribution License (the "License").
      6  * You may not use this file except in compliance with the License.
      7  *
      8  * You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE
      9  * or http://www.opensolaris.org/os/licensing.
     10  * See the License for the specific language governing permissions
     11  * and limitations under the License.
     12  *
     13  * When distributing Covered Code, include this CDDL HEADER in each
     14  * file and include the License file at usr/src/OPENSOLARIS.LICENSE.
     15  * If applicable, add the following below this CDDL HEADER, with the
     16  * fields enclosed by brackets "[]" replaced with your own identifying
     17  * information: Portions Copyright [yyyy] [name of copyright owner]
     18  *
     19  * CDDL HEADER END
     20  */
     21 
     22 /*
     23  * Copyright 2009 Sun Microsystems, Inc.  All rights reserved.
     24  * Use is subject to license terms.
     25  */
     26 
     27 #ifndef	_SYS_NGE_H
     28 #define	_SYS_NGE_H
     29 
     30 #ifdef __cplusplus
     31 extern "C" {
     32 #endif
     33 
     34 
     35 #include <sys/types.h>
     36 #include <sys/stream.h>
     37 #include <sys/strsun.h>
     38 #include <sys/strsubr.h>
     39 #include <sys/stat.h>
     40 #include <sys/pci.h>
     41 #include <sys/note.h>
     42 #include <sys/modctl.h>
     43 #include <sys/kstat.h>
     44 #include <sys/ethernet.h>
     45 #include <sys/pattr.h>
     46 #include <sys/errno.h>
     47 #include <sys/dlpi.h>
     48 #include <sys/devops.h>
     49 #include <sys/debug.h>
     50 #include <sys/conf.h>
     51 #include <sys/callb.h>
     52 
     53 #include <netinet/ip6.h>
     54 
     55 #include <inet/common.h>
     56 #include <inet/ip.h>
     57 #include <netinet/udp.h>
     58 #include <inet/mi.h>
     59 #include <inet/nd.h>
     60 
     61 #include <sys/ddi.h>
     62 #include <sys/sunddi.h>
     63 
     64 #include <sys/mac_provider.h>
     65 #include <sys/mac_ether.h>
     66 
     67 /*
     68  * Reconfiguring the network devices requires the net_config privilege
     69  * in Solaris 10+.
     70  */
     71 extern int secpolicy_net_config(const cred_t *, boolean_t);
     72 
     73 #include <sys/netlb.h>
     74 #include <sys/miiregs.h>
     75 
     76 #include "nge_chip.h"
     77 
     78 #define	PIO_ADDR(ngep, offset)	((void *)((caddr_t)(ngep)->io_regs+(offset)))
     79 /*
     80  * Copy an ethernet address
     81  */
     82 #define	ethaddr_copy(src, dst)	bcopy((src), (dst), ETHERADDRL)
     83 #define	ether_eq(a, b) (bcmp((caddr_t)(a), (caddr_t)(b), (ETHERADDRL)) == 0)
     84 
     85 #define	BIS(w, b)	(((w) & (b)) ? B_TRUE : B_FALSE)
     86 #define	BIC(w, b)	(((w) & (b)) ? B_FALSE : B_TRUE)
     87 #define	UPORDOWN(x)	((x) ? "up" : "down")
     88 
     89 #define	NGE_DRIVER_NAME		"nge"
     90 
     91 /*
     92  * 'Progress' bit flags ...
     93  */
     94 #define	PROGRESS_CFG		0x0001	/* config space mapped		*/
     95 #define	PROGRESS_REGS		0x0002	/* registers mapped		*/
     96 #define	PROGRESS_BUFS		0x0004	/* registers mapped		*/
     97 #define	PROGRESS_RESCHED	0x0008	/* resched softint registered	*/
     98 #define	PROGRESS_FACTOTUM	0x0010	/* factotum softint registered	*/
     99 #define	PROGRESS_SWINT		0x0020	/* s/w interrupt registered	*/
    100 #define	PROGRESS_INTR		0x0040	/* h/w interrupt registered	*/
    101 					/* and mutexen initialised	*/
    102 #define	PROGRESS_HWINT		0x0080
    103 #define	PROGRESS_PHY		0x0100	/* PHY initialised		*/
    104 #define	PROGRESS_NDD		0x0200	/* NDD parameters set up	*/
    105 #define	PROGRESS_KSTATS		0x0400	/* kstats created		*/
    106 #define	PROGRESS_READY		0x0800	/* ready for work		*/
    107 
    108 #define	NGE_HW_ERR		0x00
    109 #define	NGE_HW_LINK		0x01
    110 #define	NGE_HW_BM		0x02
    111 #define	NGE_HW_RCHAN		0x03
    112 #define	NGE_HW_TCHAN		0x04
    113 #define	NGE_HW_ROM		0x05
    114 #define	NGE_SW_PROBLEM_ID	0x06
    115 
    116 
    117 /*
    118  * NOTES:
    119  *
    120  * #defines:
    121  *
    122  *	NGE_PCI_CONFIG_RNUMBER and NGE_PCI_OPREGS_RNUMBER are the
    123  *	register-set numbers to use for the config space registers
    124  *	and the operating registers respectively.  On an OBP-based
    125  *	machine, regset 0 refers to CONFIG space, and regset 1 will
    126  *	be the operating registers in MEMORY space.  If an expansion
    127  *	ROM is fitted, it may appear as a further register set.
    128  *
    129  *	NGE_DMA_MODE defines the mode (STREAMING/CONSISTENT) used
    130  *	for the data buffers.  The descriptors are always set up
    131  *	in CONSISTENT mode.
    132  *
    133  *	NGE_HEADROOM defines how much space we'll leave in allocated
    134  *	mblks before the first valid data byte.  This should be chosen
    135  *	to be 2 modulo 4, so that once the ethernet header (14 bytes)
    136  *	has been stripped off, the packet data will be 4-byte aligned.
    137  *	The remaining space can be used by upstream modules to prepend
    138  *	any headers required.
    139  */
    140 
    141 
    142 #define	NGE_PCI_OPREGS_RNUMBER	1
    143 #define	NGE_DMA_MODE		DDI_DMA_STREAMING
    144 #define	NGE_HEADROOM		6
    145 #define	ETHER_HEAD_LEN		14
    146 #ifndef	VTAG_SIZE
    147 #define	VTAG_SIZE		4
    148 #endif
    149 
    150 #define	NGE_CYCLIC_PERIOD	(1000000000)
    151 
    152 #define	NGE_DEFAULT_MTU		1500
    153 #define	NGE_DEFAULT_SDU		1518
    154 #define	NGE_MTU_2500		2500
    155 #define	NGE_MTU_4500		4500
    156 #define	NGE_MAX_MTU		9000
    157 #define	NGE_MAX_SDU		9018
    158 
    159 #define	NGE_DESC_MIN		0x200
    160 
    161 #define	NGE_STD_BUFSZ		1792
    162 #define	NGE_JB2500_BUFSZ	(3*1024)
    163 #define	NGE_JB4500_BUFSZ	(5*1024)
    164 #define	NGE_JB9000_BUFSZ	(9*1024)
    165 
    166 #define	NGE_SEND_SLOTS_DESC_1024	1024
    167 #define	NGE_SEND_SLOTS_DESC_3072	3072
    168 #define	NGE_SEND_JB2500_SLOTS_DESC	3072
    169 #define	NGE_SEND_JB4500_SLOTS_DESC	2048
    170 #define	NGE_SEND_JB9000_SLOTS_DESC	1024
    171 #define	NGE_SEND_LOWMEM_SLOTS_DESC	1024
    172 #define	NGE_SEND_SLOTS_BUF		3072
    173 
    174 #define	NGE_RECV_SLOTS_DESC_1024	1024
    175 #define	NGE_RECV_SLOTS_DESC_3072	3072
    176 #define	NGE_RECV_JB2500_SLOTS_DESC	3072
    177 #define	NGE_RECV_JB4500_SLOTS_DESC	2048
    178 #define	NGE_RECV_JB9000_SLOTS_DESC	1024
    179 #define	NGE_RECV_LOWMEM_SLOTS_DESC	1024
    180 #define	NGE_RECV_SLOTS_BUF		6144
    181 
    182 #define	NGE_SPLIT_32		32
    183 #define	NGE_SPLIT_96		96
    184 #define	NGE_SPLIT_256		256
    185 
    186 #define	NGE_RX_COPY_SIZE	512
    187 #define	NGE_TX_COPY_SIZE	512
    188 #define	NGE_MAP_FRAGS		3
    189 #define	NGE_MAX_COOKIES		3
    190 #define	NGE_MAX_DMA_HDR		(4*1024)
    191 
    192 /* Used by interrupt moderation */
    193 #define	NGE_TFINT_DEFAULT	32
    194 #define	NGE_POLL_TUNE		80000
    195 #define	NGE_POLL_ENTER		10000
    196 #define	NGE_POLL_MAX		1280000
    197 #define	NGE_POLL_QUIET_TIME	100
    198 #define	NGE_POLL_BUSY_TIME	2
    199 
    200 /*
    201  * NGE-specific ioctls ...
    202  */
    203 #define	NGE_IOC			((((('N' << 8) + 'G') << 8) + 'E') << 8)
    204 
    205 /*
    206  * PHY register read/write ioctls, used by cable test software
    207  */
    208 #define	NGE_MII_READ		(NGE_IOC|1)
    209 #define	NGE_MII_WRITE		(NGE_IOC|2)
    210 
    211 /*
    212  * SEEPROM read/write ioctls, for use by SEEPROM upgrade utility
    213  *
    214  * Note: SEEPROMs can only be accessed as 32-bit words, so <see_addr>
    215  * must be a multiple of 4.  Not all systems have a SEEPROM fitted!
    216  */
    217 #define	NGE_SEE_READ		(NGE_IOC|3)
    218 #define	NGE_SEE_WRITE		(NGE_IOC|4)
    219 
    220 
    221 /*
    222  * These diagnostic IOCTLS are enabled only in DEBUG drivers
    223  */
    224 #define	NGE_DIAG		(NGE_IOC|5)	/* currently a no-op	*/
    225 #define	NGE_PEEK		(NGE_IOC|6)
    226 #define	NGE_POKE		(NGE_IOC|7)
    227 #define	NGE_PHY_RESET		(NGE_IOC|8)
    228 #define	NGE_SOFT_RESET		(NGE_IOC|9)
    229 #define	NGE_HARD_RESET		(NGE_IOC|10)
    230 
    231 
    232 enum NGE_HW_OP {
    233 	NGE_CLEAR = 0,
    234 	NGE_SET
    235 };
    236 
    237 /*
    238  * Required state according to GLD
    239  */
    240 enum nge_mac_state {
    241 	NGE_MAC_UNKNOWN,
    242 	NGE_MAC_RESET,
    243 	NGE_MAC_STOPPED,
    244 	NGE_MAC_STARTED,
    245 	NGE_MAC_UNATTACH
    246 };
    247 enum loop_type {
    248 	NGE_LOOP_NONE = 0,
    249 	NGE_LOOP_EXTERNAL_100,
    250 	NGE_LOOP_EXTERNAL_10,
    251 	NGE_LOOP_INTERNAL_PHY,
    252 };
    253 
    254 /*
    255  * (Internal) return values from send_msg subroutines
    256  */
    257 enum send_status {
    258 	SEND_COPY_FAIL = -1,		/* => GLD_NORESOURCES	*/
    259 	SEND_MAP_FAIL,			/* => GLD_NORESOURCES	*/
    260 	SEND_COPY_SUCESS,		/* OK, msg queued	*/
    261 	SEND_MAP_SUCCESS		/* OK, free msg		*/
    262 };
    263 
    264 /*
    265  * (Internal) return values from ioctl subroutines
    266  */
    267 enum ioc_reply {
    268 	IOC_INVAL = -1,			/* bad, NAK with EINVAL	*/
    269 	IOC_DONE,			/* OK, reply sent	*/
    270 	IOC_ACK,			/* OK, just send ACK	*/
    271 	IOC_REPLY,			/* OK, just send reply	*/
    272 	IOC_RESTART_ACK,		/* OK, restart & ACK	*/
    273 	IOC_RESTART_REPLY		/* OK, restart & reply	*/
    274 };
    275 
    276 enum nge_pp_type {
    277 	NGE_PP_SPACE_CFG = 0,
    278 	NGE_PP_SPACE_REG,
    279 	NGE_PP_SPACE_NIC,
    280 	NGE_PP_SPACE_MII,
    281 	NGE_PP_SPACE_NGE,
    282 	NGE_PP_SPACE_TXDESC,
    283 	NGE_PP_SPACE_TXBUFF,
    284 	NGE_PP_SPACE_RXDESC,
    285 	NGE_PP_SPACE_RXBUFF,
    286 	NGE_PP_SPACE_STATISTICS,
    287 	NGE_PP_SPACE_SEEPROM,
    288 	NGE_PP_SPACE_FLASH
    289 };
    290 
    291 /*
    292  * Flag to kstat type
    293  */
    294 enum nge_kstat_type {
    295 	NGE_KSTAT_RAW = 0,
    296 	NGE_KSTAT_STATS,
    297 	NGE_KSTAT_CHIPID,
    298 	NGE_KSTAT_DEBUG,
    299 	NGE_KSTAT_COUNT
    300 };
    301 
    302 
    303 /*
    304  * Actual state of the nvidia's chip
    305  */
    306 enum nge_chip_state {
    307 	NGE_CHIP_FAULT = -2,		/* fault, need reset	*/
    308 	NGE_CHIP_ERROR,			/* error, want reset	*/
    309 	NGE_CHIP_INITIAL,		/* Initial state only	*/
    310 	NGE_CHIP_RESET,			/* reset, need init	*/
    311 	NGE_CHIP_STOPPED,		/* Tx/Rx stopped	*/
    312 	NGE_CHIP_RUNNING		/* with interrupts	*/
    313 };
    314 
    315 enum nge_eeprom_size {
    316 	EEPROM_1K = 0,
    317 	EEPROM_2K,
    318 	EEPROM_4K,
    319 	EEPROM_8K,
    320 	EEPROM_16K,
    321 	EEPROM_32K,
    322 	EEPROM_64K
    323 };
    324 
    325 enum nge_eeprom_access_wid {
    326 	ACCESS_8BIT = 0,
    327 	ACCESS_16BIT
    328 };
    329 
    330 /*
    331  * MDIO operation
    332  */
    333 enum nge_mdio_operation {
    334 	NGE_MDIO_READ = 0,
    335 	NGE_MDIO_WRITE
    336 };
    337 
    338 /*
    339  * Speed selection
    340  */
    341 enum nge_speed {
    342 	UNKOWN_SPEED = 0,
    343 	NGE_10M,
    344 	NGE_100M,
    345 	NGE_1000M
    346 };
    347 
    348 /*
    349  * Duplex selection
    350  */
    351 enum nge_duplex {
    352 	UNKOWN_DUPLEX = 0,
    353 	NGE_HD,
    354 	NGE_FD
    355 };
    356 
    357 typedef struct {
    358 	ether_addr_t		addr;		/* in canonical form	*/
    359 	uint8_t			spare;
    360 	uint8_t			set;		/* nonzero => valid	*/
    361 } nge_mac_addr_t;
    362 
    363 struct nge;
    364 
    365 
    366 #define	CHIP_FLAG_COPPER	0x40
    367 
    368 /*
    369  * Collection of physical-layer functions to:
    370  *	(re)initialise the physical layer
    371  *	update it to match software settings
    372  *	check for link status change
    373  */
    374 typedef struct {
    375 	boolean_t	(*phys_restart)(struct nge *);
    376 	void		(*phys_update)(struct nge *);
    377 	boolean_t	(*phys_check)(struct nge *);
    378 } phys_ops_t;
    379 
    380 struct nge_see_rw {
    381 	uint32_t	see_addr;	/* Byte offset within SEEPROM	*/
    382 	uint32_t	see_data;	/* Data read/data to write	*/
    383 };
    384 
    385 typedef struct {
    386 	uint64_t	pp_acc_size;	/* in bytes: 1,2,4,8	*/
    387 	uint64_t	pp_acc_space;	/* See #defines below	*/
    388 	uint64_t	pp_acc_offset;
    389 	uint64_t	pp_acc_data;	/* output for peek	*/
    390 					/* input for poke	*/
    391 } nge_peekpoke_t;
    392 
    393 typedef uintptr_t 	nge_regno_t;	/* register # (offset)	*/
    394 
    395 typedef struct _mul_list {
    396 	struct _mul_list *next;
    397 	uint32_t ref_cnt;
    398 	ether_addr_t mul_addr;
    399 }mul_item, *pmul_item;
    400 
    401 /*
    402  * Describes one chunk of allocated DMA-able memory
    403  *
    404  * In some cases, this is a single chunk as allocated from the system;
    405  * but we also use this structure to represent slices carved off such
    406  * a chunk.  Even when we don't really need all the information, we
    407  * use this structure as a convenient way of correlating the various
    408  * ways of looking at a piece of memory (kernel VA, IO space DVMA,
    409  * handle+offset, etc).
    410  */
    411 typedef struct dma_area
    412 {
    413 
    414 	caddr_t			private;	/* pointer to nge */
    415 	frtn_t			rx_recycle;	/* recycle function */
    416 	mblk_t			*mp;
    417 	ddi_acc_handle_t	acc_hdl;	/* handle for memory	*/
    418 	void			*mem_va;	/* CPU VA of memory	*/
    419 	uint32_t		nslots;		/* number of slots	*/
    420 	uint32_t		size;		/* size per slot	*/
    421 	size_t			alength;	/* allocated size	*/
    422 						/* >= product of above	*/
    423 	ddi_dma_handle_t	dma_hdl;	/* DMA handle		*/
    424 	offset_t		offset;		/* relative to handle	*/
    425 	ddi_dma_cookie_t	cookie;		/* associated cookie	*/
    426 	uint32_t		ncookies;
    427 	uint32_t		signature;	/* buffer signature	*/
    428 						/* for deciding to free */
    429 						/* or to reuse buffers	*/
    430 	boolean_t		rx_delivered;	/* hold by upper layer	*/
    431 	struct dma_area		*next;
    432 } dma_area_t;
    433 
    434 #define	HOST_OWN	0x00000000
    435 #define	CONTROLER_OWN	0x00000001
    436 #define	NGE_END_PACKET	0x00000002
    437 
    438 
    439 typedef struct nge_dmah_node
    440 {
    441 	struct nge_dmah_node	*next;
    442 	ddi_dma_handle_t	hndl;
    443 } nge_dmah_node_t;
    444 
    445 typedef struct nge_dmah_list
    446 {
    447 	nge_dmah_node_t	*head;
    448 	nge_dmah_node_t	*tail;
    449 } nge_dmah_list_t;
    450 
    451 /*
    452  * Software version of the Recv Descriptor
    453  * There's one of these for each recv buffer (up to 512 per ring)
    454  */
    455 typedef struct sw_rx_sbd {
    456 
    457 	dma_area_t		desc;		/* (const) related h/w	*/
    458 						/* descriptor area	*/
    459 	dma_area_t		*bufp;		/* (const) related	*/
    460 						/* buffer area		*/
    461 	uint8_t			flags;
    462 } sw_rx_sbd_t;
    463 
    464 /*
    465  * Software version of the send Buffer Descriptor
    466  * There's one of these for each send buffer (up to 512 per ring)
    467  */
    468 typedef struct sw_tx_sbd {
    469 
    470 	dma_area_t		desc;		/* (const) related h/w	*/
    471 						/* descriptor area	*/
    472 	dma_area_t		pbuf;		/* (const) related	*/
    473 						/* buffer area		*/
    474 	void			(*tx_recycle)(struct sw_tx_sbd *);
    475 	uint32_t		flags;
    476 	mblk_t			*mp;		/* related mblk, if any	*/
    477 	nge_dmah_list_t		mp_hndl;
    478 	uint32_t		frags;
    479 	uint32_t		ncookies;	/* dma cookie number */
    480 
    481 } sw_tx_sbd_t;
    482 
    483 /*
    484  * Software Receive Buffer (Producer) Ring Control Block
    485  * There's one of these for each receiver producer ring (up to 3),
    486  * but each holds buffers of a different size.
    487  */
    488 typedef struct buff_ring {
    489 
    490 	uint64_t		nslots;		/* descriptor area	*/
    491 	struct nge		*ngep;		/* (const) containing	*/
    492 						/* driver soft state	*/
    493 						/* initialise same	*/
    494 	uint64_t		rx_hold;
    495 	sw_rx_sbd_t		*sw_rbds; 	/* software descriptors	*/
    496 	sw_rx_sbd_t		*free_rbds;	/* free ring */
    497 	dma_area_t		*free_list;	/* available buffer queue */
    498 	dma_area_t		*recycle_list;	/* recycling buffer queue */
    499 	kmutex_t		recycle_lock[1];
    500 	uint32_t		buf_sign;	/* buffer ring signature */
    501 						/* for deciding to free  */
    502 						/* or to reuse buffers   */
    503 	boolean_t		rx_bcopy;
    504 } buff_ring_t;
    505 
    506 /*
    507  * Software Receive (Return) Ring Control Block
    508  * There's one of these for each receiver return ring (up to 16).
    509  */
    510 typedef struct recv_ring {
    511 	/*
    512 	 * The elements flagged (const) in the comments below are
    513 	 * set up once during initialiation and thereafter unchanged.
    514 	 */
    515 	dma_area_t		desc;		/* (const) related h/w	*/
    516 						/* descriptor area	*/
    517 	struct nge		*ngep;		/* (const) containing	*/
    518 						/* driver soft state	*/
    519 	uint16_t		prod_index;	/* (const) ptr to h/w	*/
    520 						/* "producer index"	*/
    521 	mac_resource_handle_t	handle;
    522 } recv_ring_t;
    523 
    524 
    525 
    526 /*
    527  * Software Send Ring Control Block
    528  * There's one of these for each of (up to) 1 send rings
    529  */
    530 typedef struct send_ring {
    531 	/*
    532 	 * The elements flagged (const) in the comments below are
    533 	 * set up once during initialiation and thereafter unchanged.
    534 	 */
    535 	dma_area_t		desc;		/* (const) related h/w	*/
    536 						/* descriptor area	*/
    537 	dma_area_t		buf[NGE_SEND_SLOTS_BUF];
    538 						/* buffer area(s)	*/
    539 	struct nge		*ngep;		/* (const) containing	*/
    540 						/* driver soft state	*/
    541 
    542 	uint32_t		tx_hwmark;
    543 	uint32_t		tx_lwmark;
    544 
    545 	/*
    546 	 * The tx_lock must be held when updating
    547 	 * the s/w producer index
    548 	 * (tx_next)
    549 	 */
    550 	kmutex_t		tx_lock[1];	/* serialize h/w update	*/
    551 	uint32_t		tx_next;	/* next slot to use	*/
    552 	uint32_t		tx_flow;
    553 
    554 	/*
    555 	 * These counters/indexes are manipulated in the transmit
    556 	 * path using atomics rather than mutexes for speed
    557 	 */
    558 	uint32_t		tx_free;	/* # of slots available	*/
    559 
    560 	/*
    561 	 * index (tc_next).
    562 	 */
    563 	kmutex_t		tc_lock[1];
    564 	uint32_t		tc_next;	/* next slot to recycle	*/
    565 						/* ("consumer index")	*/
    566 
    567 	sw_tx_sbd_t		*sw_sbds; 	/* software descriptors	*/
    568 
    569 	kmutex_t		dmah_lock;
    570 	nge_dmah_list_t		dmah_free;
    571 	nge_dmah_node_t		dmahndl[NGE_MAX_DMA_HDR];
    572 
    573 } send_ring_t;
    574 
    575 
    576 typedef struct {
    577 	uint32_t		businfo;	/* from private reg	*/
    578 	uint16_t		command;	/* saved during attach	*/
    579 
    580 	uint16_t		vendor;		/* vendor-id		*/
    581 	uint16_t		device;		/* device-id		*/
    582 	uint16_t		subven;		/* subsystem-vendor-id	*/
    583 	uint16_t		subdev;		/* subsystem-id		*/
    584 	uint8_t			class_code;
    585 	uint8_t			revision;	/* revision-id		*/
    586 	uint8_t			clsize;		/* cache-line-size	*/
    587 	uint8_t			latency;	/* latency-timer	*/
    588 	uint8_t			flags;
    589 
    590 	uint16_t		phy_type;	/* Fiber module type 	*/
    591 	uint64_t		hw_mac_addr;	/* from chip register	*/
    592 	nge_mac_addr_t		vendor_addr;	/* transform of same	*/
    593 } chip_info_t;
    594 
    595 
    596 typedef struct {
    597 	offset_t	index;
    598 	char		*name;
    599 } nge_ksindex_t;
    600 
    601 typedef struct {
    602 	uint64_t tso_err_mss;
    603 	uint64_t tso_dis;
    604 	uint64_t tso_err_nosum;
    605 	uint64_t tso_err_hov;
    606 	uint64_t tso_err_huf;
    607 	uint64_t tso_err_l2;
    608 	uint64_t tso_err_ip;
    609 	uint64_t tso_err_l4;
    610 	uint64_t tso_err_tcp;
    611 	uint64_t hsum_err_ip;
    612 	uint64_t hsum_err_l4;
    613 }fe_statistics_t;
    614 
    615 /*
    616  * statistics parameters to tune the driver
    617  */
    618 typedef struct {
    619 	uint64_t		intr_count;
    620 	uint64_t		intr_lval;
    621 	uint64_t		recv_realloc;
    622 	uint64_t		poll_time;
    623 	uint64_t		recy_free;
    624 	uint64_t		recv_count;
    625 	uint64_t		xmit_count;
    626 	uint64_t		obytes;
    627 	uint64_t		rbytes;
    628 	uint64_t		mp_alloc_err;
    629 	uint64_t		dma_alloc_err;
    630 	uint64_t		kmem_alloc_err;
    631 	uint64_t		load_context;
    632 	uint64_t		ip_hwsum_err;
    633 	uint64_t		tcp_hwsum_err;
    634 	uint64_t		rx_nobuffer;
    635 	uint64_t		rx_err;
    636 	uint64_t		tx_stop_err;
    637 	uint64_t		tx_stall;
    638 	uint64_t		tx_rsrv_fail;
    639 	uint64_t		tx_resched;
    640 	fe_statistics_t	fe_err;
    641 }nge_sw_statistics_t;
    642 
    643 typedef struct {
    644 	nge_hw_statistics_t	hw_statistics;
    645 	nge_sw_statistics_t	sw_statistics;
    646 }nge_statistics_t;
    647 
    648 struct nge_desc_attr	{
    649 
    650 	size_t	rxd_size;
    651 	size_t	txd_size;
    652 
    653 	ddi_dma_attr_t	*dma_attr;
    654 	ddi_dma_attr_t	*tx_dma_attr;
    655 
    656 	void (*rxd_fill)(void *, const ddi_dma_cookie_t *, size_t);
    657 	uint32_t (*rxd_check)(const void *, size_t *);
    658 
    659 	void (*txd_fill)(void *, const ddi_dma_cookie_t *, size_t,
    660 			uint32_t, boolean_t, boolean_t);
    661 
    662 	uint32_t (*txd_check)(const void *);
    663 };
    664 
    665 typedef struct nge_desc_attr nge_desc_attr_t;
    666 
    667 /*
    668  * Structure used to hold the device-specific config parameters.
    669  * The setting of such parameters may not consistent with the
    670  * hardware feature of the device. It's used for software purpose.
    671  */
    672 typedef struct nge_dev_spec_param {
    673 	boolean_t	msi;		/* specifies msi support */
    674 	boolean_t	msi_x;		/* specifies msi_x support */
    675 	boolean_t	vlan;		/* specifies vlan support */
    676 	boolean_t	advanced_pm;	/* advanced power management support */
    677 	boolean_t	mac_addr_order; /* mac address order */
    678 	boolean_t	tx_pause_frame;	/* specifies tx pause frame support */
    679 	boolean_t	rx_pause_frame;	/* specifies rx pause frame support */
    680 	boolean_t	jumbo;		/* jumbo frame support */
    681 	boolean_t	tx_rx_64byte;	/* set the max tx/rx prd fetch size */
    682 	boolean_t	rx_hw_checksum;	/* specifies tx hw checksum feature */
    683 	uint32_t	tx_hw_checksum;	/* specifies rx hw checksum feature */
    684 	uint32_t	desc_type;	/* specifies descriptor type */
    685 	uint32_t	rx_desc_num;	/* specifies rx descriptor number */
    686 	uint32_t	tx_desc_num;	/* specifies tx descriptor number */
    687 	uint32_t	nge_split;	/* specifies the split number */
    688 } nge_dev_spec_param_t;
    689 
    690 typedef struct nge {
    691 	/*
    692 	 * These fields are set by attach() and unchanged thereafter ...
    693 	 */
    694 	dev_info_t		*devinfo;	/* device instance	*/
    695 	mac_handle_t		mh;		/* mac module handle    */
    696 	chip_info_t		chipinfo;
    697 	ddi_acc_handle_t	cfg_handle;	/* DDI I/O handle	*/
    698 	ddi_acc_handle_t	io_handle;	/* DDI I/O handle	*/
    699 	void			*io_regs;	/* mapped registers	*/
    700 
    701 	ddi_periodic_t		periodic_id;	/* periodical callback	*/
    702 	uint32_t		factotum_flag;
    703 	ddi_softint_handle_t	factotum_hdl;	/* factotum callback	*/
    704 	ddi_softint_handle_t	resched_hdl;	/* reschedule callback	*/
    705 	uint_t			soft_pri;
    706 
    707 	ddi_intr_handle_t 	*htable;	/* for array of interrupts */
    708 	int			intr_type;	/* type of interrupt */
    709 	int			intr_actual_cnt; /* alloc intrs count */
    710 	int			intr_req_cnt;	/* request intrs count */
    711 	uint_t			intr_pri;	/* interrupt priority	*/
    712 	int			intr_cap;	/* interrupt capabilities */
    713 
    714 	uint32_t		progress;	/* attach tracking	*/
    715 	uint32_t		debug;		/* flag to debug function */
    716 
    717 	char			ifname[8];	/* "nge0" ... "nge999" */
    718 
    719 
    720 	enum nge_mac_state	nge_mac_state;	/* definitions above	*/
    721 	enum nge_chip_state	nge_chip_state; /* definitions above	*/
    722 	boolean_t		promisc;
    723 	boolean_t		record_promisc;
    724 	boolean_t		suspended;
    725 
    726 	int			resched_needed;
    727 	uint32_t		default_mtu;
    728 	uint32_t		max_sdu;
    729 	uint32_t		buf_size;
    730 	uint32_t		rx_desc;
    731 	uint32_t		tx_desc;
    732 	uint32_t		rx_buf;
    733 	uint32_t		nge_split;
    734 	uint32_t		watchdog;
    735 	uint32_t		lowmem_mode;
    736 
    737 
    738 	/*
    739 	 * Runtime read-write data starts here ...
    740 	 * 1 Receive Rings
    741 	 * 1 Send Rings
    742 	 *
    743 	 * Note: they're not necessarily all used.
    744 	 */
    745 	struct buff_ring	buff[1];
    746 	struct recv_ring	recv[1];
    747 	struct send_ring	send[1];
    748 
    749 
    750 	kmutex_t		genlock[1];
    751 	krwlock_t		rwlock[1];
    752 	kmutex_t		softlock[1];
    753 	uint32_t		intr_masks;
    754 	boolean_t		poll;
    755 	boolean_t		ch_intr_mode;
    756 	boolean_t		intr_moderation;
    757 	uint32_t		recv_count;
    758 	uint32_t		quiet_time;
    759 	uint32_t		busy_time;
    760 	uint64_t		tpkts_last;
    761 	uint32_t		tfint_threshold;
    762 	uint32_t		sw_intr_intv;
    763 	nge_mac_addr_t		cur_uni_addr;
    764 	uint32_t		rx_datahwm;
    765 	uint32_t		rx_prdlwm;
    766 	uint32_t		rx_prdhwm;
    767 	uint32_t		rx_def;
    768 	uint32_t		desc_mode;
    769 
    770 	mul_item		*pcur_mulist;
    771 	nge_mac_addr_t		cur_mul_addr;
    772 	nge_mac_addr_t		cur_mul_mask;
    773 
    774 	nge_desc_attr_t		desc_attr;
    775 
    776 	/*
    777 	 * Link state data (protected by genlock)
    778 	 */
    779 	int32_t			link_state;	/* See GLD #defines	*/
    780 	uint32_t		stall_cknum;	/* Stall check number */
    781 
    782 	uint32_t		phy_xmii_addr;
    783 	uint32_t		phy_id;
    784 	uint32_t		phy_mode;
    785 	const phys_ops_t	*physops;
    786 	uint16_t		phy_gen_status;
    787 
    788 	uint32_t		param_loop_mode;
    789 
    790 	kstat_t			*nge_kstats[NGE_KSTAT_COUNT];
    791 	nge_statistics_t	statistics;
    792 
    793 	nge_dev_spec_param_t	dev_spec_param;
    794 
    795 	uint32_t		param_en_pause:1,
    796 				param_en_asym_pause:1,
    797 				param_en_1000hdx:1,
    798 				param_en_1000fdx:1,
    799 				param_en_100fdx:1,
    800 				param_en_100hdx:1,
    801 				param_en_10fdx:1,
    802 				param_en_10hdx:1,
    803 				param_adv_autoneg:1,
    804 				param_adv_pause:1,
    805 				param_adv_asym_pause:1,
    806 				param_adv_1000fdx:1,
    807 				param_adv_1000hdx:1,
    808 				param_adv_100fdx:1,
    809 				param_adv_100hdx:1,
    810 				param_adv_10fdx:1,
    811 				param_adv_10hdx:1,
    812 				param_lp_autoneg:1,
    813 				param_lp_pause:1,
    814 				param_lp_asym_pause:1,
    815 				param_lp_1000fdx:1,
    816 				param_lp_1000hdx:1,
    817 				param_lp_100fdx:1,
    818 				param_lp_100hdx:1,
    819 				param_lp_10fdx:1,
    820 				param_lp_10hdx:1,
    821 				param_link_up:1,
    822 				param_link_autoneg:1,
    823 				param_link_rx_pause:1,
    824 				param_link_tx_pause:1,
    825 				param_pad_to_32:2;
    826 	uint64_t		param_link_speed;
    827 	link_duplex_t		param_link_duplex;
    828 	int			param_txbcopy_threshold;
    829 	int			param_rxbcopy_threshold;
    830 	int			param_recv_max_packet;
    831 	int			param_poll_quiet_time;
    832 	int			param_poll_busy_time;
    833 	int			param_rx_intr_hwater;
    834 	int			param_rx_intr_lwater;
    835 } nge_t;
    836 
    837 extern const nge_ksindex_t nge_statistics[];
    838 
    839 /*
    840  * Sync a DMA area described by a dma_area_t
    841  */
    842 #define	DMA_SYNC(area, flag)	((void) ddi_dma_sync((area).dma_hdl,	\
    843 				    (area).offset, (area).alength, (flag)))
    844 
    845 /*
    846  * Find the (kernel virtual) address of block of memory
    847  * described by a dma_area_t
    848  */
    849 #define	DMA_VPTR(area)		((area).mem_va)
    850 
    851 /*
    852  * Zero a block of memory described by a dma_area_t
    853  */
    854 #define	DMA_ZERO(area)		bzero(DMA_VPTR(area), (area).alength)
    855 
    856 /*
    857  * Next/Prev value of a cyclic index
    858  */
    859 #define	NEXT(index, limit)	((index) + 1 < (limit) ? (index) + 1 : 0)
    860 #define	PREV(index, limit)	(0 == (index) ? (limit - 1) : (index) - 1)
    861 
    862 #define	NEXT_INDEX(ndx, num, lim)\
    863 	(((ndx) + (num) < (lim)) ? ((ndx) + (num)) : ((ndx) + (num) - (lim)))
    864 
    865 
    866 /*
    867  * Property lookups
    868  */
    869 #define	NGE_PROP_EXISTS(d, n)	ddi_prop_exists(DDI_DEV_T_ANY, (d),	\
    870 					DDI_PROP_DONTPASS, (n))
    871 #define	NGE_PROP_GET_INT(d, n)	ddi_prop_get_int(DDI_DEV_T_ANY, (d),	\
    872 					DDI_PROP_DONTPASS, (n), -1)
    873 
    874 
    875 /*
    876  * Debugging ...
    877  */
    878 #ifdef	DEBUG
    879 #define	NGE_DEBUGGING		1
    880 #else
    881 #define	NGE_DEBUGGING		0
    882 #endif	/* DEBUG */
    883 
    884 /*
    885  * Bit flags in the 'debug' word ...
    886  */
    887 #define	NGE_DBG_STOP		0x00000001	/* early debug_enter()	*/
    888 #define	NGE_DBG_TRACE		0x00000002	/* general flow tracing	*/
    889 
    890 #define	NGE_DBG_MII		0x00000010	/* low-level MII access	*/
    891 #define	NGE_DBG_CHIP		0x00000020	/* low(ish)-level code	*/
    892 
    893 #define	NGE_DBG_RECV		0x00000100	/* receive-side code	*/
    894 #define	NGE_DBG_SEND		0x00000200	/* packet-send code	*/
    895 
    896 #define	NGE_DBG_INIT		0x00100000	/* initialisation	*/
    897 #define	NGE_DBG_NEMO		0x00200000	/* MAC layer entry points */
    898 #define	NGE_DBG_STATS		0x00400000	/* statistics		*/
    899 
    900 #define	NGE_DBG_BADIOC		0x01000000	/* unknown ioctls	*/
    901 
    902 #define	NGE_DBG_NDD		0x10000000	/* NDD operations	*/
    903 
    904 
    905 
    906 /*
    907  * 'Do-if-debugging' macro.  The parameter <command> should be one or more
    908  * C statements (but without the *final* semicolon), which will either be
    909  * compiled inline or completely ignored, depending on the NGE_DEBUGGING
    910  * compile-time flag.
    911  *
    912  * You should get a compile-time error (at least on a DEBUG build) if
    913  * your statement isn't actually a statement, rather than unexpected
    914  * run-time behaviour caused by unintended matching of if-then-elses etc.
    915  *
    916  * Note that the NGE_DDB() macro itself can only be used as a statement,
    917  * not an expression, and should always be followed by a semicolon.
    918  */
    919 #if NGE_DEBUGGING
    920 #define	NGE_DDB(command)	do {					\
    921 					{ command; }			\
    922 					_NOTE(CONSTANTCONDITION)	\
    923 				} while (0)
    924 #else 	/* NGE_DEBUGGING */
    925 #define	NGE_DDB(command)
    926 /*
    927  * Old way of debugging.  This is a poor way, as it leeaves empty
    928  * statements that cause lint to croak.
    929  * #define	NGE_DDB(command)	do {				\
    930  * 					{ _NOTE(EMPTY); }		\
    931  * 					_NOTE(CONSTANTCONDITION)	\
    932  * 				} while (0)
    933  */
    934 #endif	/* NGE_DEBUGGING */
    935 
    936 /*
    937  * 'Internal' macros used to construct the TRACE/DEBUG macros below.
    938  * These provide the primitive conditional-call capability required.
    939  * Note: the parameter <args> is a parenthesised list of the actual
    940  * printf-style arguments to be passed to the debug function ...
    941  */
    942 #define	NGE_XDB(b, w, f, args)	NGE_DDB(if ((b) & (w)) f args)
    943 #define	NGE_GDB(b, args)	NGE_XDB(b, nge_debug, (*nge_gdb()), args)
    944 #define	NGE_LDB(b, args)	NGE_XDB(b, ngep->debug, \
    945 				    (*nge_db(ngep)), args)
    946 #define	NGE_CDB(f, args)	NGE_XDB(NGE_DBG, ngep->debug, f, args)
    947 
    948 /*
    949  * Conditional-print macros.
    950  *
    951  * Define NGE_DBG to be the relevant member of the set of NGE_DBG_* values
    952  * above before using the NGE_GDEBUG() or NGE_DEBUG() macros.  The 'G'
    953  * versions look at the Global debug flag word (nge_debug); the non-G
    954  * versions look in the per-instance data (ngep->debug) and so require a
    955  * variable called 'ngep' to be in scope (and initialised!) before use.
    956  *
    957  * You could redefine NGE_TRC too if you really need two different
    958  * flavours of debugging output in the same area of code, but I don't
    959  * really recommend it.
    960  *
    961  * Note: the parameter <args> is a parenthesised list of the actual
    962  * arguments to be passed to the debug function, usually a printf-style
    963  * format string and corresponding values to be formatted.
    964  */
    965 
    966 #define	NGE_TRC	NGE_DBG_TRACE
    967 
    968 #define	NGE_GTRACE(args)	NGE_GDB(NGE_TRC, args)
    969 #define	NGE_GDEBUG(args)	NGE_GDB(NGE_DBG, args)
    970 #define	NGE_TRACE(args)		NGE_LDB(NGE_TRC, args)
    971 #define	NGE_DEBUG(args)		NGE_LDB(NGE_DBG, args)
    972 
    973 /*
    974  * Debug-only action macros
    975  */
    976 
    977 
    978 #define	NGE_REPORT(args)	NGE_DDB(nge_log args)
    979 
    980 boolean_t nge_atomic_decrease(uint64_t *count_p, uint64_t n);
    981 void nge_atomic_increase(uint64_t *count_p, uint64_t n);
    982 
    983 int nge_alloc_dma_mem(nge_t *ngep, size_t memsize,
    984     ddi_device_acc_attr_t *attr_p, uint_t dma_flags, dma_area_t *dma_p);
    985 void nge_free_dma_mem(dma_area_t *dma_p);
    986 int nge_restart(nge_t *ngep);
    987 void nge_wake_factotum(nge_t *ngep);
    988 
    989 uint8_t nge_reg_get8(nge_t *ngep, nge_regno_t regno);
    990 void nge_reg_put8(nge_t *ngep, nge_regno_t regno, uint8_t data);
    991 uint16_t nge_reg_get16(nge_t *ngep, nge_regno_t regno);
    992 void nge_reg_put16(nge_t *ngep, nge_regno_t regno, uint16_t data);
    993 uint32_t nge_reg_get32(nge_t *ngep, nge_regno_t regno);
    994 void nge_reg_put32(nge_t *ngep, nge_regno_t regno, uint32_t data);
    995 uint_t nge_chip_factotum(caddr_t args1, caddr_t args2);
    996 void nge_chip_cfg_init(nge_t *ngep, chip_info_t *infop, boolean_t reset);
    997 void nge_init_dev_spec_param(nge_t *ngep);
    998 int nge_chip_stop(nge_t *ngep, boolean_t fault);
    999 void nge_restore_mac_addr(nge_t *ngep);
   1000 int nge_chip_reset(nge_t *ngep);
   1001 int nge_chip_start(nge_t *ngep);
   1002 void nge_chip_sync(nge_t *ngep);
   1003 
   1004 uint_t nge_chip_intr(caddr_t arg1, caddr_t arg2);
   1005 enum ioc_reply nge_chip_ioctl(nge_t *ngep, mblk_t *mp, struct iocblk *iocp);
   1006 
   1007 void nge_phys_init(nge_t *ngep);
   1008 boolean_t nge_phy_reset(nge_t *ngep);
   1009 uint16_t nge_mii_get16(nge_t *ngep, nge_regno_t regno);
   1010 void nge_mii_put16(nge_t *ngep, nge_regno_t regno, uint16_t data);
   1011 
   1012 void nge_recv_recycle(caddr_t arg);
   1013 void nge_receive(nge_t *ngep);
   1014 
   1015 uint_t nge_reschedule(caddr_t args1, caddr_t args2);
   1016 mblk_t *nge_m_tx(void *arg, mblk_t *mp);
   1017 
   1018 void nge_tx_recycle(nge_t *ngep, boolean_t is_intr);
   1019 void nge_tx_recycle_all(nge_t *ngep);
   1020 
   1021 int nge_nd_init(nge_t *ngep);
   1022 void nge_nd_cleanup(nge_t *ngep);
   1023 
   1024 
   1025 void nge_init_kstats(nge_t *ngep, int instance);
   1026 void nge_fini_kstats(nge_t *ngep);
   1027 int nge_m_stat(void *arg, uint_t stat, uint64_t *val);
   1028 
   1029 uint32_t nge_atomic_shl32(uint32_t *sp, uint_t count);
   1030 
   1031 void nge_log(nge_t *ngep, const char *fmt, ...);
   1032 void nge_problem(nge_t *ngep, const char *fmt, ...);
   1033 void nge_error(nge_t *ngep, const char *fmt, ...);
   1034 void
   1035 nge_report(nge_t *ngep, uint8_t error_id);
   1036 
   1037 void (*nge_db(nge_t *ngep))(const char *fmt, ...);
   1038 void (*nge_gdb(void))(const char *fmt, ...);
   1039 extern	uint32_t nge_debug;
   1040 
   1041 /*
   1042  * DESC MODE 2
   1043  */
   1044 
   1045 extern void nge_sum_rxd_fill(void *, const ddi_dma_cookie_t *, size_t);
   1046 extern uint32_t nge_sum_rxd_check(const void *, size_t *);
   1047 
   1048 extern void nge_sum_txd_fill(void *, const ddi_dma_cookie_t *,
   1049 				size_t, uint32_t, boolean_t, boolean_t);
   1050 extern uint32_t nge_sum_txd_check(const void *);
   1051 
   1052 /*
   1053  * DESC MODE 3
   1054  */
   1055 
   1056 extern void nge_hot_rxd_fill(void *, const ddi_dma_cookie_t *, size_t);
   1057 extern uint32_t nge_hot_rxd_check(const void *, size_t *);
   1058 
   1059 extern void nge_hot_txd_fill(void *, const ddi_dma_cookie_t *,
   1060 				size_t, uint32_t, boolean_t, boolean_t);
   1061 extern uint32_t nge_hot_txd_check(const void *);
   1062 
   1063 #ifdef __cplusplus
   1064 }
   1065 #endif
   1066 
   1067 #endif	/* _SYS_NGE_H */
   1068