340 lines
		
	
	
		
			10 KiB
		
	
	
	
		
			C
		
	
	
	
	
	
			
		
		
	
	
			340 lines
		
	
	
		
			10 KiB
		
	
	
	
		
			C
		
	
	
	
	
	
/*
 | 
						|
 * 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 */
 |