patch-2.4.3 linux/drivers/net/pcmcia/hermes.h

Next file: linux/drivers/net/pcmcia/i82593.h
Previous file: linux/drivers/net/pcmcia/hermes.c
Back to the patch index
Back to the overall index

diff -u --recursive --new-file v2.4.2/linux/drivers/net/pcmcia/hermes.h linux/drivers/net/pcmcia/hermes.h
@@ -0,0 +1,398 @@
+/* hermes.h
+ *
+ * Driver core for the "Hermes" wireless MAC controller, as used in
+ * the Lucent Orinoco and Cabletron RoamAbout cards. It should also
+ * work on the hfa3841 and hfa3842 MAC controller chips used in the
+ * Prism I & II chipsets.
+ *
+ * This is not a complete driver, just low-level access routines for
+ * the MAC controller itself.
+ *
+ * Based on the prism2 driver from Absolute Value Systems' linux-wlan
+ * project, the Linux wvlan_cs driver, Lucent's HCF-Light
+ * (wvlan_hcf.c) library, and the NetBSD wireless driver.
+ *
+ * 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
+
+/* Notes on locking:
+ *
+ * As a module of low level hardware access routines, there is no
+ * locking. Users of this module should ensure that they serialize
+ * access to the hermes_t structure, and to the hardware
+*/
+
+#include <linux/delay.h>
+#include <linux/if_ether.h>
+
+/*
+ * Limits and constants
+ */
+#define		HERMES_ALLOC_LEN_MIN		((uint16_t)4)
+#define		HERMES_ALLOC_LEN_MAX		((uint16_t)2400)
+#define		HERMES_LTV_LEN_MAX		(34)
+#define		HERMES_BAP_DATALEN_MAX		((uint16_t)4096)
+#define		HERMES_BAP_OFFSET_MAX		((uint16_t)4096)
+#define		HERMES_PORTID_MAX		((uint16_t)7)
+#define		HERMES_NUMPORTS_MAX		((uint16_t)(HERMES_PORTID_MAX+1))
+#define		HERMES_PDR_LEN_MAX		((uint16_t)260)	/* in bytes, from EK */
+#define		HERMES_PDA_RECS_MAX		((uint16_t)200)	/* a guess */
+#define		HERMES_PDA_LEN_MAX		((uint16_t)1024)	/* in bytes, from EK */
+#define		HERMES_SCANRESULT_MAX		((uint16_t)35)
+#define		HERMES_CHINFORESULT_MAX		((uint16_t)8)
+#define		HERMES_FRAME_LEN_MAX		(2304)
+#define		HERMES_MAX_MULTICAST		(16)
+#define		HERMES_MAGIC			(0x7d1f)
+
+/*
+ * 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			((uint16_t)0x8000)
+#define		HERMES_CMD_AINFO		((uint16_t)0x7f00)
+#define		HERMES_CMD_MACPORT		((uint16_t)0x0700)
+#define		HERMES_CMD_RECL			((uint16_t)0x0100)
+#define		HERMES_CMD_WRITE		((uint16_t)0x0100)
+#define		HERMES_CMD_PROGMODE		((uint16_t)0x0300)
+#define		HERMES_CMD_CMDCODE		((uint16_t)0x003f)
+
+/*
+ * STATUS register bitmasks
+ */
+#define		HERMES_STATUS_RESULT		((uint16_t)0x7f00)
+#define		HERMES_STATUS_CMDCODE		((uint16_t)0x003f)
+
+/*
+ * OFFSET refister bitmasks
+ */
+#define		HERMES_OFFSET_BUSY		((uint16_t)0x8000)
+#define		HERMES_OFFSET_ERR		((uint16_t)0x4000)
+#define		HERMES_OFFSET_DATAOFF		((uint16_t)0x0ffe)
+
+/*
+ * Event register bitmasks (INTEN, EVSTAT, EVACK)
+ */
+#define		HERMES_EV_TICK			((uint16_t)0x8000)
+#define		HERMES_EV_WTERR			((uint16_t)0x4000)
+#define		HERMES_EV_INFDROP		((uint16_t)0x2000)
+#define		HERMES_EV_INFO			((uint16_t)0x0080)
+#define		HERMES_EV_DTIM			((uint16_t)0x0020)
+#define		HERMES_EV_CMD			((uint16_t)0x0010)
+#define		HERMES_EV_ALLOC			((uint16_t)0x0008)
+#define		HERMES_EV_TXEXC			((uint16_t)0x0004)
+#define		HERMES_EV_TX			((uint16_t)0x0002)
+#define		HERMES_EV_RX			((uint16_t)0x0001)
+
+/*
+ * Command codes
+ */
+/*--- Controller Commands --------------------------*/
+#define		HERMES_CMD_INIT			((uint16_t)0x00)
+#define		HERMES_CMD_ENABLE		((uint16_t)0x01)
+#define		HERMES_CMD_DISABLE		((uint16_t)0x02)
+#define		HERMES_CMD_DIAG			((uint16_t)0x03)
+
+/*--- Buffer Mgmt Commands --------------------------*/
+#define		HERMES_CMD_ALLOC		((uint16_t)0x0A)
+#define		HERMES_CMD_TX			((uint16_t)0x0B)
+#define		HERMES_CMD_CLRPRST		((uint16_t)0x12)
+
+/*--- Regulate Commands --------------------------*/
+#define		HERMES_CMD_NOTIFY		((uint16_t)0x10)
+#define		HERMES_CMD_INQ			((uint16_t)0x11)
+
+/*--- Configure Commands --------------------------*/
+#define		HERMES_CMD_ACCESS		((uint16_t)0x21)
+#define		HERMES_CMD_DOWNLD		((uint16_t)0x22)
+
+/*--- Debugging Commands -----------------------------*/
+#define 	HERMES_CMD_MONITOR		((uint16_t)(0x38))
+#define		HERMES_MONITOR_ENABLE		((uint16_t)(0x0b))
+#define		HERMES_MONITOR_DISABLE		((uint16_t)(0x0f))
+
+/*
+ * Configuration RIDs
+ */
+
+#define		HERMES_RID_CNF_PORTTYPE		((uint16_t)0xfc00)
+#define		HERMES_RID_CNF_MACADDR		((uint16_t)0xfc01)
+#define		HERMES_RID_CNF_DESIRED_SSID	((uint16_t)0xfc02)
+#define		HERMES_RID_CNF_CHANNEL		((uint16_t)0xfc03)
+#define		HERMES_RID_CNF_OWN_SSID		((uint16_t)0xfc04)
+#define		HERMES_RID_CNF_SYSTEM_SCALE	((uint16_t)0xfc06)
+#define		HERMES_RID_CNF_MAX_DATA_LEN	((uint16_t)0xfc07)
+#define		HERMES_RID_CNF_PM_ENABLE	((uint16_t)0xfc09)
+#define		HERMES_RID_CNF_PM_MCAST_RX	((uint16_t)0xfc0b)
+#define		HERMES_RID_CNF_PM_PERIOD	((uint16_t)0xfc0c)
+#define		HERMES_RID_CNF_PM_HOLDOVER	((uint16_t)0xfc0d)
+#define		HERMES_RID_CNF_NICKNAME		((uint16_t)0xfc0e)
+#define		HERMES_RID_CNF_WEP_ON		((uint16_t)0xfc20)
+#define		HERMES_RID_CNF_MWO_ROBUST	((uint16_t)0xfc25)
+#define		HERMES_RID_CNF_PRISM2_WEP_ON	((uint16_t)0xfc28)
+#define		HERMES_RID_CNF_MULTICAST_LIST	((uint16_t)0xfc80)
+#define		HERMES_RID_CNF_CREATEIBSS	((uint16_t)0xfc81)
+#define		HERMES_RID_CNF_FRAG_THRESH	((uint16_t)0xfc82)
+#define		HERMES_RID_CNF_RTS_THRESH	((uint16_t)0xfc83)
+#define		HERMES_RID_CNF_TX_RATE_CTRL	((uint16_t)0xfc84)
+#define		HERMES_RID_CNF_PROMISCUOUS	((uint16_t)0xfc85)
+#define		HERMES_RID_CNF_KEYS		((uint16_t)0xfcb0)
+#define		HERMES_RID_CNF_TX_KEY		((uint16_t)0xfcb1)
+#define		HERMES_RID_CNF_TICKTIME		((uint16_t)0xfce0)
+
+#define		HERMES_RID_CNF_PRISM2_TX_KEY	((uint16_t)0xfc23)
+#define		HERMES_RID_CNF_PRISM2_KEY0	((uint16_t)0xfc24)
+#define		HERMES_RID_CNF_PRISM2_KEY1	((uint16_t)0xfc25)
+#define		HERMES_RID_CNF_PRISM2_KEY2	((uint16_t)0xfc26)
+#define		HERMES_RID_CNF_PRISM2_KEY3	((uint16_t)0xfc27)
+#define		HERMES_RID_CNF_SYMBOL_AUTH_TYPE		((uint16_t)0xfc2A)
+/* This one is read only */
+#define		HERMES_RID_CNF_SYMBOL_KEY_LENGTH	((uint16_t)0xfc2B)
+#define		HERMES_RID_CNF_SYMBOL_BASIC_RATES	((uint16_t)0xfc8A)
+
+/*
+ * Information RIDs
+ */
+#define		HERMES_RID_CHANNEL_LIST		((uint16_t)0xfd10)
+#define		HERMES_RID_STAIDENTITY		((uint16_t)0xfd20)
+#define		HERMES_RID_CURRENT_SSID		((uint16_t)0xfd41)
+#define		HERMES_RID_CURRENT_BSSID	((uint16_t)0xfd42)
+#define		HERMES_RID_COMMSQUALITY		((uint16_t)0xfd43)
+#define 	HERMES_RID_CURRENT_TX_RATE	((uint16_t)0xfd44)
+#define		HERMES_RID_WEP_AVAIL		((uint16_t)0xfd4f)
+#define		HERMES_RID_CURRENT_CHANNEL	((uint16_t)0xfdc1)
+#define		HERMES_RID_DATARATES		((uint16_t)0xfdc6)
+
+/*
+ * Frame structures and constants
+ */
+
+typedef struct hermes_frame_desc {
+	/* Hermes - i.e. little-endian byte-order */
+	uint16_t status; /* 0x0 */
+	uint16_t res1, res2; /* 0x2, 0x4 */
+	uint16_t q_info; /* 0x6 */
+	uint16_t res3, res4; /* 0x8, 0xA */
+	uint16_t tx_ctl; /* 0xC */
+} __attribute__ ((packed)) hermes_frame_desc_t;
+
+#define		HERMES_RXSTAT_ERR		((uint16_t)0x0003)
+#define		HERMES_RXSTAT_MACPORT		((uint16_t)0x0700)
+#define		HERMES_RXSTAT_MSGTYPE		((uint16_t)0xE000)
+
+#define		HERMES_RXSTAT_BADCRC		((uint16_t)0x0001)
+#define		HERMES_RXSTAT_UNDECRYPTABLE	((uint16_t)0x0002)
+
+/* RFC-1042 encoded frame */
+#define		HERMES_RXSTAT_1042		((uint16_t)0x2000)
+/* Bridge-tunnel encoded frame */
+#define		HERMES_RXSTAT_TUNNEL		((uint16_t)0x4000)
+/* Wavelan-II Management Protocol frame */
+#define		HERMES_RXSTAT_WMP		((uint16_t)0x6000)
+
+#ifdef __KERNEL__
+
+/* Basic control structure */
+typedef struct hermes {
+	uint iobase;
+
+	uint16_t inten; /* Which interrupts should be enabled? */
+} hermes_t;
+
+typedef struct hermes_response {
+	uint16_t status, resp0, resp1, resp2;
+} hermes_response_t;
+
+/* Firmware information structure */
+typedef struct hermes_identity {
+	uint16_t id, vendor, major, minor;
+} __attribute__ ((packed)) hermes_identity_t;
+
+/* "ID" structure - used for ESSID and station nickname */
+typedef struct hermes_id {
+	uint16_t len;
+	uint16_t val[16];
+} __attribute__ ((packed)) hermes_id_t;
+
+typedef struct hermes_commsqual {
+	uint16_t qual, signal, noise;
+} __attribute__ ((packed)) hermes_commsqual_t;
+
+typedef struct hermes_multicast {
+	uint8_t addr[HERMES_MAX_MULTICAST][ETH_ALEN];
+} __attribute__ ((packed)) hermes_multicast_t;
+
+/* Register access convenience macros */
+#define hermes_read_reg(hw, off) (inw((hw)->iobase + (off)))
+#define hermes_write_reg(hw, off, val) (outw_p((val), (hw)->iobase + (off)))
+
+#define hermes_read_regn(hw, name) (hermes_read_reg((hw), HERMES_##name))
+#define hermes_write_regn(hw, name, val) (hermes_write_reg((hw), HERMES_##name, (val)))
+
+/* Note that for the next two, the count is in 16-bit words, not bytes */
+#define hermes_read_data(hw, off, buf, count) (insw((hw)->iobase + (off), (buf), (count)))
+#define hermes_write_data(hw, off, buf, count) (outsw((hw)->iobase + (off), (buf), (count)))
+
+/* Function prototypes */
+void hermes_struct_init(hermes_t *hw, ushort io);
+int hermes_reset(hermes_t *hw);
+int hermes_docmd_wait(hermes_t *hw, uint16_t cmd, uint16_t parm0, hermes_response_t *resp);
+int hermes_allocate(hermes_t *hw, uint16_t size, uint16_t *fid);
+
+
+int hermes_bap_pread(hermes_t *hw, int bap, void *buf, uint16_t len,
+		       uint16_t id, uint16_t offset);
+int hermes_bap_pwrite(hermes_t *hw, int bap, const void *buf, uint16_t len,
+			uint16_t id, uint16_t offset);
+int hermes_read_ltv(hermes_t *hw, int bap, uint16_t rid, int buflen,
+		    uint16_t *length, void *buf);
+int hermes_write_ltv(hermes_t *hw, int bap, uint16_t rid,
+		      uint16_t length, const void *value);
+
+/* Inline functions */
+
+static inline int hermes_present(hermes_t *hw)
+{
+	return hermes_read_regn(hw, SWSUPPORT0) == HERMES_MAGIC;
+}
+
+static inline void hermes_enable_interrupt(hermes_t *hw, uint16_t events)
+{
+	hw->inten |= events;
+	hermes_write_regn(hw, INTEN, hw->inten);
+}
+
+static inline void hermes_set_irqmask(hermes_t *hw, uint16_t events)
+{
+	hw->inten = events;
+	hermes_write_regn(hw, INTEN, events);
+}
+
+static inline int hermes_enable_port(hermes_t *hw, int port)
+{
+	hermes_response_t resp;
+
+	return hermes_docmd_wait(hw, HERMES_CMD_ENABLE | (port << 8),
+				 0, &resp);
+}
+
+static inline int hermes_disable_port(hermes_t *hw, int port)
+{
+	hermes_response_t resp;
+
+	return hermes_docmd_wait(hw, HERMES_CMD_ENABLE | (port << 8), 
+				 0, &resp);
+}
+
+#define HERMES_BYTES_TO_RECLEN(n) ( ((n) % 2) ? (((n)+1)/2)+1 : ((n)/2)+1 )
+#define HERMES_RECLEN_TO_BYTES(n) ( ((n)-1) * 2 )
+
+#define HERMES_READ_RECORD(hw, bap, rid, buf) \
+	(hermes_read_ltv((hw),(bap),(rid), sizeof(*buf), NULL, (buf)))
+#define HERMES_WRITE_RECORD(hw, bap, rid, buf) \
+	(hermes_write_ltv((hw),(bap),(rid),HERMES_BYTES_TO_RECLEN(sizeof(*buf)),(buf)))
+#define HERMES_WRITE_RECORD_LEN(hw, bap, rid, buf, len) \
+	(hermes_write_ltv((hw),(bap),(rid),HERMES_BYTES_TO_RECLEN(len),(buf)))
+
+static inline int hermes_read_wordrec(hermes_t *hw, int bap, uint16_t rid, uint16_t *word)
+{
+	uint16_t rec;
+	int err;
+
+	err = HERMES_READ_RECORD(hw, bap, rid, &rec);
+	*word = le16_to_cpu(rec);
+	return err;
+}
+
+static inline int hermes_write_wordrec(hermes_t *hw, int bap, uint16_t rid, uint16_t word)
+{
+	uint16_t rec = cpu_to_le16(word);
+	return HERMES_WRITE_RECORD(hw, bap, rid, &rec);
+}
+
+static inline int hermes_read_staidentity(hermes_t *hw, int bap, hermes_identity_t *buf)
+{
+	int err;
+
+	err = HERMES_READ_RECORD(hw, bap, HERMES_RID_STAIDENTITY, buf);
+	if (err)
+		return err;
+
+	le16_to_cpus(&buf->id);
+	le16_to_cpus(&buf->vendor);
+	le16_to_cpus(&buf->major);
+	le16_to_cpus(&buf->minor);
+	
+	return 0;
+}
+
+static inline int hermes_read_commsqual(hermes_t *hw, int bap, hermes_commsqual_t *buf)
+{
+	int err;
+
+	err = HERMES_READ_RECORD(hw, bap, HERMES_RID_COMMSQUALITY, buf);
+	if (err)
+		return err;
+
+	le16_to_cpus(&buf->qual);
+	le16_to_cpus(&buf->signal);
+	le16_to_cpus(&buf->noise);
+	
+	return 0;
+}
+
+#else /* ! __KERNEL__ */
+
+/* These are provided for the benefit of userspace drivers and testing programs
+   which use ioperm() or iopl() */
+
+#define hermes_read_reg(base, off) (inw((base) + (off)))
+#define hermes_write_reg(base, off, val) (outw((val), (base) + (off)))
+
+#define hermes_read_regn(base, name) (hermes_read_reg((base), HERMES_##name))
+#define hermes_write_regn(base, name, val) (hermes_write_reg((base), HERMES_##name, (val)))
+
+/* Note that for the next two, the count is in 16-bit words, not bytes */
+#define hermes_read_data(base, off, buf, count) (insw((base) + (off), (buf), (count)))
+#define hermes_write_data(base, off, buf, count) (outsw((base) + (off), (buf), (count)))
+
+#endif /* ! __KERNEL__ */
+
+#endif  /* _HERMES_H */

FUNET's LINUX-ADM group, linux-adm@nic.funet.fi
TCL-scripts by Sam Shen (who was at: slshen@lbl.gov)