340 lines
		
	
	
		
			10 KiB
		
	
	
	
		
			C
		
	
	
		
			Executable File
		
	
	
	
	
			
		
		
	
	
			340 lines
		
	
	
		
			10 KiB
		
	
	
	
		
			C
		
	
	
		
			Executable File
		
	
	
	
	
| /*
 | |
|  * hermes.h
 | |
|  *
 | |
|  * Constants, structures and prototypes needed for the low level access of 
 | |
|  * Prism cards. The hermes.h file was used as the basis of this file
 | |
|  *
 | |
|  * Adjusted to Minix by Stevens Le Blond <slblond@few.vu.nl> 
 | |
|  *  	            and Michael Valkering <mjvalker@cs.vu.nl>
 | |
|  */
 | |
| 
 | |
| /* Original copyright notices from hermes.h of the Linux kernel 
 | |
|  *
 | |
|  * Copyright (C) 2000, David Gibson, Linuxcare Australia 
 | |
|  * <hermes@gibson.dropbear.id.au>
 | |
|  * Portions taken from hfa384x.h, Copyright (C) 1999 AbsoluteValue Systems, Inc. 
 | |
|  * All Rights Reserved.
 | |
|  * This file distributed under the GPL, version 2.
 | |
|  */
 | |
| #ifndef _HERMES_H
 | |
| #define _HERMES_H
 | |
| 
 | |
| #include "../drivers.h"
 | |
| #include <net/gen/ether.h>
 | |
| #include <net/gen/eth_io.h>
 | |
| #include <net/hton.h>
 | |
| #include <stdarg.h>
 | |
| 
 | |
| /*****************************************************************************
 | |
|  *              HERMES CONSTANTS                                             *
 | |
|  *****************************************************************************/
 | |
| #define		HERMES_ALLOC_LEN_MIN		(4)
 | |
| #define		HERMES_ALLOC_LEN_MAX		(2400)
 | |
| #define		HERMES_LTV_LEN_MAX		(34)
 | |
| #define		HERMES_BAP_DATALEN_MAX		(4096)
 | |
| #define		HERMES_BAP_OFFSET_MAX		(4096)
 | |
| #define		HERMES_PORTID_MAX		(7)
 | |
| #define		HERMES_NUMPORTS_MAX		(HERMES_PORTID_MAX+1)
 | |
| #define		HERMES_PDR_LEN_MAX		(260)	
 | |
| #define		HERMES_PDA_RECS_MAX		(200)	
 | |
| #define		HERMES_PDA_LEN_MAX		(1024)	
 | |
| #define		HERMES_SCANRESULT_MAX		(35)
 | |
| #define		HERMES_CHINFORESULT_MAX		(8)
 | |
| #define		HERMES_MAX_MULTICAST		(16)
 | |
| #define		HERMES_MAGIC			(0x69ff)
 | |
| 
 | |
| /* 
 | |
|  * Hermes register offsets
 | |
|  */
 | |
| #define		HERMES_CMD			(0x00)
 | |
| #define		HERMES_PARAM0			(0x02)
 | |
| #define		HERMES_PARAM1			(0x04)
 | |
| #define		HERMES_PARAM2			(0x06)
 | |
| #define		HERMES_STATUS			(0x08)
 | |
| #define		HERMES_RESP0			(0x0A)
 | |
| #define		HERMES_RESP1			(0x0C)
 | |
| #define		HERMES_RESP2			(0x0E)
 | |
| #define		HERMES_INFOFID			(0x10)
 | |
| #define		HERMES_RXFID			(0x20)
 | |
| #define		HERMES_ALLOCFID			(0x22)
 | |
| #define		HERMES_TXCOMPLFID		(0x24)
 | |
| #define		HERMES_SELECT0			(0x18)
 | |
| #define		HERMES_OFFSET0			(0x1C)
 | |
| #define		HERMES_DATA0			(0x36)
 | |
| #define		HERMES_SELECT1			(0x1A)
 | |
| #define		HERMES_OFFSET1			(0x1E)
 | |
| #define		HERMES_DATA1			(0x38)
 | |
| #define		HERMES_EVSTAT			(0x30)
 | |
| #define		HERMES_INTEN			(0x32)
 | |
| #define		HERMES_EVACK			(0x34)
 | |
| #define		HERMES_CONTROL			(0x14)
 | |
| #define		HERMES_SWSUPPORT0		(0x28)
 | |
| #define		HERMES_SWSUPPORT1		(0x2A)
 | |
| #define		HERMES_SWSUPPORT2		(0x2C)
 | |
| #define		HERMES_AUXPAGE			(0x3A)
 | |
| #define		HERMES_AUXOFFSET		(0x3C)
 | |
| #define		HERMES_AUXDATA			(0x3E)
 | |
| 
 | |
| /* 
 | |
|  * CMD register bitmasks
 | |
|  */
 | |
| #define		HERMES_CMD_BUSY			(0x8000)
 | |
| #define		HERMES_CMD_AINFO		(0x7f00)
 | |
| #define		HERMES_CMD_MACPORT		(0x0700)
 | |
| #define		HERMES_CMD_RECL			(0x0100)
 | |
| #define		HERMES_CMD_WRITE		(0x0100)
 | |
| #define		HERMES_CMD_PROGMODE		(0x0300)
 | |
| #define		HERMES_CMD_CMDCODE		(0x003f)
 | |
| 
 | |
| /* 
 | |
|  * STATUS register bitmasks
 | |
|  */
 | |
| #define		HERMES_STATUS_RESULT		(0x7f00)
 | |
| #define		HERMES_STATUS_CMDCODE		(0x003f)
 | |
| 
 | |
| /* 
 | |
|  * OFFSET register bitmasks
 | |
|  */
 | |
| #define		HERMES_OFFSET_BUSY		(0x8000)
 | |
| #define		HERMES_OFFSET_ERR		(0x4000)
 | |
| #define		HERMES_OFFSET_DATAOFF		(0x0ffe)
 | |
| 
 | |
| /* 
 | |
|  * Event register bitmasks (INTEN, EVSTAT, EVACK)
 | |
|  */
 | |
| #define		HERMES_EV_TICK			(0x8000)
 | |
| #define		HERMES_EV_WTERR			(0x4000)
 | |
| #define		HERMES_EV_INFDROP		(0x2000)
 | |
| #define		HERMES_EV_INFO			(0x0080)
 | |
| #define		HERMES_EV_DTIM			(0x0020)
 | |
| #define		HERMES_EV_CMD			(0x0010)
 | |
| #define		HERMES_EV_ALLOC			(0x0008)
 | |
| #define		HERMES_EV_TXEXC			(0x0004)
 | |
| #define		HERMES_EV_TX			(0x0002)
 | |
| #define		HERMES_EV_RX			(0x0001)
 | |
| 
 | |
| /*
 | |
|  * COR reset options 
 | |
|  */
 | |
| #define		HERMES_PCI_COR			(0x26)
 | |
| #define		HERMES_PCI_COR_MASK		(0x0080)
 | |
| /* It appears that the card needs quite some time to recover: */
 | |
| #define		HERMES_PCI_COR_ONT		(250) /* ms */
 | |
| #define		HERMES_PCI_COR_OFFT		(500) /* ms */
 | |
| #define		HERMES_PCI_COR_BUSYT		(500) /* ms */
 | |
| /* 
 | |
|  * Command codes
 | |
|  */
 | |
| /*--- Controller Commands --------------------------*/
 | |
| #define		HERMES_CMD_INIT			(0x0000)
 | |
| #define		HERMES_CMD_ENABLE		(0x0001)
 | |
| #define		HERMES_CMD_DISABLE		(0x0002)
 | |
| #define		HERMES_CMD_DIAG			(0x0003)
 | |
| 
 | |
| /*--- Buffer Mgmt Commands --------------------------*/
 | |
| #define		HERMES_CMD_ALLOC		(0x000A)
 | |
| #define		HERMES_CMD_TX			(0x000B)
 | |
| #define		HERMES_CMD_CLRPRST		(0x0012)
 | |
| 
 | |
| /*--- Regulate Commands --------------------------*/
 | |
| #define		HERMES_CMD_NOTIFY		(0x0010)
 | |
| #define		HERMES_CMD_INQUIRE		(0x0011)
 | |
| 
 | |
| /*--- Configure Commands --------------------------*/
 | |
| #define		HERMES_CMD_ACCESS		(0x0021)
 | |
| #define		HERMES_CMD_DOWNLD		(0x0022)
 | |
| 
 | |
| /*--- Debugging Commands -----------------------------*/
 | |
| #define 	HERMES_CMD_MONITOR		(0x0038)
 | |
| #define		HERMES_MONITOR_ENABLE		(0x000b)
 | |
| #define		HERMES_MONITOR_DISABLE		(0x000f)
 | |
| 
 | |
| /* 
 | |
|  * Frame structures and constants
 | |
|  */
 | |
| 
 | |
| #define 	HERMES_DESCRIPTOR_OFFSET	(0)
 | |
| #define 	HERMES_802_11_OFFSET		(14)
 | |
| #define 	HERMES_802_3_OFFSET		(14+32)
 | |
| #define 	HERMES_802_2_OFFSET		(14+32+14)
 | |
| 
 | |
| struct hermes_rx_descriptor
 | |
| {
 | |
| 	u16_t status;
 | |
| 	u16_t time_lefthalf;
 | |
| 	u16_t time_righthalf;
 | |
| 	u8_t silence;
 | |
| 	u8_t signal;
 | |
| 	u8_t rate;
 | |
| 	u8_t rxflow;
 | |
| 	u16_t reserved1;
 | |
| 	u16_t reserved2;
 | |
| };
 | |
| 
 | |
| #define HERMES_RXSTAT_ERR		(0x0003)
 | |
| #define	HERMES_RXSTAT_BADCRC		(0x0001)
 | |
| #define	HERMES_RXSTAT_UNDECRYPTABLE	(0x0002)
 | |
| #define	HERMES_RXSTAT_MACPORT		(0x0700)
 | |
| #define HERMES_RXSTAT_PCF		(0x1000)	
 | |
| #define	HERMES_RXSTAT_MSGTYPE		(0xE000)
 | |
| #define	HERMES_RXSTAT_1042		(0x2000)	/* RFC-1042 frame */
 | |
| #define	HERMES_RXSTAT_TUNNEL		(0x4000)	/* bridge-tunnel
 | |
| 							 * encoded frame */
 | |
| #define	HERMES_RXSTAT_WMP		(0x6000)	/* Wavelan-II
 | |
| 							 * Management
 | |
| 							 * Protocol frame */
 | |
| 
 | |
| struct hermes_tx_descriptor
 | |
| {
 | |
| 	u16_t status;
 | |
| 	u16_t reserved1;
 | |
| 	u16_t reserved2;
 | |
| 	u16_t sw_support_lefthalf;
 | |
| 	u16_t sw_support_righthalf;
 | |
| 	u8_t retry_count;
 | |
| 	u8_t tx_rate;
 | |
| 	u16_t tx_control;
 | |
| };
 | |
| 
 | |
| #define HERMES_TXSTAT_RETRYERR		(0x0001)
 | |
| #define HERMES_TXSTAT_AGEDERR		(0x0002)
 | |
| #define HERMES_TXSTAT_DISCON		(0x0004)
 | |
| #define HERMES_TXSTAT_FORMERR		(0x0008)
 | |
| 
 | |
| #define HERMES_TXCTRL_TX_OK		(0x0002)	
 | |
| #define HERMES_TXCTRL_TX_EX		(0x0004)	
 | |
| #define HERMES_TXCTRL_802_11		(0x0008)	
 | |
| #define HERMES_TXCTRL_ALT_RTRY		(0x0020)
 | |
| 
 | |
| /* Inquiry constants and data types */
 | |
| 
 | |
| #define HERMES_INQ_TALLIES		(0xF100)
 | |
| #define HERMES_INQ_SCAN			(0xF101)
 | |
| #define HERMES_INQ_LINKSTATUS		(0xF200)
 | |
| 
 | |
| 
 | |
| /* The tallies are retrieved, but these fields are not processed until now */
 | |
| struct hermes_tallies_frame
 | |
| {
 | |
| 	u16_t TxUnicastFrames;
 | |
| 	u16_t TxMulticastFrames;
 | |
| 	u16_t TxFragments;
 | |
| 	u16_t TxUnicastOctets;
 | |
| 	u16_t TxMulticastOctets;
 | |
| 	u16_t TxDeferredTransmissions;
 | |
| 	u16_t TxSingleRetryFrames;
 | |
| 	u16_t TxMultipleRetryFrames;
 | |
| 	u16_t TxRetryLimitExceeded;
 | |
| 	u16_t TxDiscards;
 | |
| 	u16_t RxUnicastFrames;
 | |
| 	u16_t RxMulticastFrames;
 | |
| 	u16_t RxFragments;
 | |
| 	u16_t RxUnicastOctets;
 | |
| 	u16_t RxMulticastOctets;
 | |
| 	u16_t RxFCSErrors;
 | |
| 	u16_t RxDiscards_NoBuffer;
 | |
| 	u16_t TxDiscardsWrongSA;
 | |
| 	u16_t RxWEPUndecryptable;
 | |
| 	u16_t RxMsgInMsgFragments;
 | |
| 	u16_t RxMsgInBadMsgFragments;
 | |
| 	u16_t RxDiscards_WEPICVError;
 | |
| 	u16_t RxDiscards_WEPExcluded;
 | |
| };
 | |
| 
 | |
| #define HERMES_LINKSTATUS_NOT_CONNECTED   (0x0000)
 | |
| #define HERMES_LINKSTATUS_CONNECTED       (0x0001)
 | |
| #define HERMES_LINKSTATUS_DISCONNECTED    (0x0002)
 | |
| #define HERMES_LINKSTATUS_AP_CHANGE       (0x0003)
 | |
| #define HERMES_LINKSTATUS_AP_OUT_OF_RANGE (0x0004)
 | |
| #define HERMES_LINKSTATUS_AP_IN_RANGE     (0x0005)
 | |
| #define HERMES_LINKSTATUS_ASSOC_FAILED    (0x0006)
 | |
| 
 | |
| struct hermes_linkstatus
 | |
| {
 | |
| 	u16_t linkstatus;	/* Link status */
 | |
| };
 | |
| 
 | |
| /* Timeouts. These are maximum timeouts. Most often, card wil react 
 | |
|  * much faster */
 | |
| #define HERMES_BAP_BUSY_TIMEOUT 	(10000)	/* In iterations of ~1us */
 | |
| #define HERMES_CMD_BUSY_TIMEOUT 	(100)	/* In iterations of ~1us */
 | |
| #define HERMES_CMD_INIT_TIMEOUT 	(50000)	/* in iterations of ~10us */
 | |
| #define HERMES_CMD_COMPL_TIMEOUT	(20000)	/* in iterations of ~10us */
 | |
| #define HERMES_ALLOC_COMPL_TIMEOUT 	(1000)	/* in iterations of ~10us */
 | |
| 
 | |
| /* WEP settings */
 | |
| #define HERMES_AUTH_OPEN		(1)
 | |
| #define HERMES_AUTH_SHARED_KEY		(2)
 | |
| #define HERMES_WEP_PRIVACY_INVOKED	(0x0001)
 | |
| #define HERMES_WEP_EXCL_UNENCRYPTED	(0x0002)
 | |
| #define HERMES_WEP_HOST_ENCRYPT		(0x0010)
 | |
| #define HERMES_WEP_HOST_DECRYPT		(0x0080)
 | |
| 
 | |
| 
 | |
| /* Basic control structure */
 | |
| typedef struct hermes
 | |
| {
 | |
| 	u32_t iobase;
 | |
| 	int io_space;		/* 1 if we IO-mapped IO, 0 for memory-mapped
 | |
| 				 * IO */
 | |
| #define HERMES_IO	1
 | |
| #define HERMES_MEM	0
 | |
| 	int reg_spacing;
 | |
| #define HERMES_16BIT_REGSPACING	0
 | |
| #define HERMES_32BIT_REGSPACING	1
 | |
| 	u16_t inten;		/* Which interrupts should be enabled? */
 | |
| 	char *locmem;
 | |
| } hermes_t;
 | |
| 
 | |
| typedef struct hermes_response
 | |
| {
 | |
| 	u16_t status, resp0, resp1, resp2;
 | |
| } hermes_response_t;
 | |
| 
 | |
| struct hermes_idstring
 | |
| {
 | |
| 	u16_t len;
 | |
| 	u16_t val[16];
 | |
| };
 | |
| 
 | |
| #define HERMES_BYTES_TO_RECLEN(n) ( (((n)+1)/2) + 1 )
 | |
| #define HERMES_RECLEN_TO_BYTES(n) ( ((n)-1) * 2 )
 | |
| 
 | |
| /* Function prototypes */
 | |
| _PROTOTYPE (u16_t hermes_read_reg, (hermes_t * hw, u16_t off));
 | |
| _PROTOTYPE (void  hermes_write_reg, (hermes_t * hw, u16_t off, u16_t val));
 | |
| _PROTOTYPE (void  hermes_struct_init, (hermes_t * hw, u32_t address,
 | |
| 					int io_space, int reg_spacing));
 | |
| _PROTOTYPE (int  hermes_init, (hermes_t * hw));
 | |
| _PROTOTYPE (int  hermes_docmd_wait, (hermes_t * hw, u16_t cmd,
 | |
| 					u16_t parm0, hermes_response_t * resp));
 | |
| _PROTOTYPE (int  hermes_allocate, (hermes_t * hw, u16_t size, u16_t * fid));
 | |
| _PROTOTYPE (int  hermes_bap_pread, (hermes_t * hw, int bap, void *buf,
 | |
| 					unsigned len, u16_t id, u16_t offset));
 | |
| _PROTOTYPE (int  hermes_bap_pwrite, (hermes_t * hw, int bap,
 | |
| 				    	const void *buf, unsigned len, u16_t id,
 | |
| 				    u16_t offset));
 | |
| _PROTOTYPE (void hermes_read_words, (hermes_t * hw, int off, void *buf,
 | |
| 				    	unsigned count));
 | |
| _PROTOTYPE (void hermes_write_words, (hermes_t * hw, int off,
 | |
| 					const void *buf, unsigned count));
 | |
| _PROTOTYPE (int  hermes_read_ltv, (hermes_t * hw, int bap, u16_t rid,
 | |
| 					unsigned buflen, u16_t * length,
 | |
| 					void *buf));
 | |
| _PROTOTYPE (int  hermes_write_ltv, (hermes_t * hw, int bap, u16_t rid,
 | |
| 					u16_t length, const void *value));
 | |
| _PROTOTYPE (int  hermes_present, (hermes_t * hw));
 | |
| _PROTOTYPE (int  myfunc_read, (vir_bytes src));
 | |
| _PROTOTYPE (void myfunc_write, (vir_bytes dst, int val));
 | |
| _PROTOTYPE (void hermes_print_ioarea, (hermes_t * hw, int first_reg,
 | |
| 					int last_reg));
 | |
| _PROTOTYPE (int  hermes_set_irqmask, (hermes_t * hw, u16_t events));
 | |
| _PROTOTYPE (u16_t hermes_get_irqmask, (hermes_t * hw));
 | |
| _PROTOTYPE (int  hermes_read_wordrec, (hermes_t * hw, int bap, u16_t rid,
 | |
| 					u16_t * word));
 | |
| _PROTOTYPE (int  hermes_write_wordrec, (hermes_t * hw, int bap, u16_t rid,
 | |
| 				   	u16_t word));
 | |
| _PROTOTYPE (int  hermes_cor_reset, (hermes_t *hw));
 | |
| _PROTOTYPE (void milli_delay, (unsigned int msecs));
 | |
| #endif /* _HERMES_H */
 | 
