6 * Reorganisation and extension of the driver.
7 * Original copyright follows. See wavelan.p.h for details.
9 * This file contains the declarations for the WaveLAN hardware. Note that
10 * the WaveLAN ISA includes a i82586 controller (see definitions in
13 * The main difference between the ISA hardware and the PCMCIA one is
14 * the Ethernet controller (i82586 instead of i82593).
15 * The i82586 allows multiple transmit buffers. The PSA needs to be accessed
16 * through the host interface.
22 /************************** MAGIC NUMBERS ***************************/
24 /* Detection of the WaveLAN card is done by reading the MAC
25 * address from the card and checking it. If you have a non-AT&T
26 * product (OEM, like DEC RoamAbout, Digital Ocean, or Epson),
27 * you might need to modify this part to accommodate your hardware.
29 static const char MAC_ADDRESSES
[][3] =
31 { 0x08, 0x00, 0x0E }, /* AT&T WaveLAN (standard) & DEC RoamAbout */
32 { 0x08, 0x00, 0x6A }, /* AT&T WaveLAN (alternate) */
33 { 0x00, 0x00, 0xE1 }, /* Hitachi Wavelan */
34 { 0x00, 0x60, 0x1D } /* Lucent Wavelan (another one) */
35 /* Add your card here and send me the patch! */
38 #define WAVELAN_ADDR_SIZE 6 /* Size of a MAC address */
40 #define WAVELAN_MTU 1500 /* Maximum size of WaveLAN packet */
42 #define MAXDATAZ (WAVELAN_ADDR_SIZE + WAVELAN_ADDR_SIZE + 2 + WAVELAN_MTU)
45 * Constants used to convert channels to frequencies
48 /* Frequency available in the 2.0 modem, in units of 250 kHz
49 * (as read in the offset register of the dac area).
50 * Used to map channel numbers used by `wfreqsel' to frequencies
52 static const short channel_bands
[] = { 0x30, 0x58, 0x64, 0x7A, 0x80, 0xA8,
53 0xD0, 0xF0, 0xF8, 0x150 };
55 /* Frequencies of the 1.0 modem (fixed frequencies).
56 * Use to map the PSA `subband' to a frequency
57 * Note : all frequencies apart from the first one need to be multiplied by 10
59 static const int fixed_bands
[] = { 915e6
, 2.425e8
, 2.46e8
, 2.484e8
, 2.4305e8
};
63 /*************************** PC INTERFACE ****************************/
66 * Host Adaptor structure.
67 * (base is board port address).
69 typedef union hacs_u hacs_u
;
72 unsigned short hu_command
; /* Command register */
73 #define HACR_RESET 0x0001 /* Reset board */
74 #define HACR_CA 0x0002 /* Set Channel Attention for 82586 */
75 #define HACR_16BITS 0x0004 /* 16-bit operation (0 => 8bits) */
76 #define HACR_OUT0 0x0008 /* General purpose output pin 0 */
77 /* not used - must be 1 */
78 #define HACR_OUT1 0x0010 /* General purpose output pin 1 */
79 /* not used - must be 1 */
80 #define HACR_82586_INT_ENABLE 0x0020 /* Enable 82586 interrupts */
81 #define HACR_MMC_INT_ENABLE 0x0040 /* Enable MMC interrupts */
82 #define HACR_INTR_CLR_ENABLE 0x0080 /* Enable interrupt status read/clear */
83 unsigned short hu_status
; /* Status Register */
84 #define HASR_82586_INTR 0x0001 /* Interrupt request from 82586 */
85 #define HASR_MMC_INTR 0x0002 /* Interrupt request from MMC */
86 #define HASR_MMC_BUSY 0x0004 /* MMC busy indication */
87 #define HASR_PSA_BUSY 0x0008 /* LAN parameter storage area busy */
88 } __attribute__ ((packed
));
90 typedef struct ha_t ha_t
;
93 hacs_u ha_cs
; /* Command and status registers */
94 #define ha_command ha_cs.hu_command
95 #define ha_status ha_cs.hu_status
96 unsigned short ha_mmcr
; /* Modem Management Ctrl Register */
97 unsigned short ha_pior0
; /* Program I/O Address Register Port 0 */
98 unsigned short ha_piop0
; /* Program I/O Port 0 */
99 unsigned short ha_pior1
; /* Program I/O Address Register Port 1 */
100 unsigned short ha_piop1
; /* Program I/O Port 1 */
101 unsigned short ha_pior2
; /* Program I/O Address Register Port 2 */
102 unsigned short ha_piop2
; /* Program I/O Port 2 */
107 #define hoff(p,f) (unsigned short)((void *)(&((ha_t *)((void *)0 + (p)))->f) - (void *)0)
108 #define HACR(p) hoff(p, ha_command)
109 #define HASR(p) hoff(p, ha_status)
110 #define MMCR(p) hoff(p, ha_mmcr)
111 #define PIOR0(p) hoff(p, ha_pior0)
112 #define PIOP0(p) hoff(p, ha_piop0)
113 #define PIOR1(p) hoff(p, ha_pior1)
114 #define PIOP1(p) hoff(p, ha_piop1)
115 #define PIOR2(p) hoff(p, ha_pior2)
116 #define PIOP2(p) hoff(p, ha_piop2)
119 * Program I/O Mode Register values.
121 #define STATIC_PIO 0 /* Mode 1: static mode */
123 #define AUTOINCR_PIO 1 /* Mode 2: auto increment mode */
125 #define AUTODECR_PIO 2 /* Mode 3: auto decrement mode */
127 #define PARAM_ACCESS_PIO 3 /* Mode 4: LAN parameter access mode */
128 /* Parameter access. */
129 #define PIO_MASK 3 /* register mask */
130 #define PIOM(cmd,piono) ((u_short)cmd << 10 << (piono * 2))
132 #define HACR_DEFAULT (HACR_OUT0 | HACR_OUT1 | HACR_16BITS | PIOM(STATIC_PIO, 0) | PIOM(AUTOINCR_PIO, 1) | PIOM(PARAM_ACCESS_PIO, 2))
133 #define HACR_INTRON (HACR_82586_INT_ENABLE | HACR_MMC_INT_ENABLE | HACR_INTR_CLR_ENABLE)
135 /************************** MEMORY LAYOUT **************************/
138 * Onboard 64 k RAM layout.
139 * (Offsets from 0x0000.)
141 #define OFFSET_RU 0x0000 /* 75% memory */
142 #define OFFSET_CU 0xC000 /* 25% memory */
143 #define OFFSET_SCB (OFFSET_ISCP - sizeof(scb_t))
144 #define OFFSET_ISCP (OFFSET_SCP - sizeof(iscp_t))
145 #define OFFSET_SCP I82586_SCP_ADDR
147 #define RXBLOCKZ (sizeof(fd_t) + sizeof(rbd_t) + MAXDATAZ)
148 #define TXBLOCKZ (sizeof(ac_tx_t) + sizeof(ac_nop_t) + sizeof(tbd_t) + MAXDATAZ)
150 #define NRXBLOCKS ((OFFSET_CU - OFFSET_RU) / RXBLOCKZ)
151 #define NTXBLOCKS ((OFFSET_SCB - OFFSET_CU) / TXBLOCKZ)
153 /********************** PARAMETER STORAGE AREA **********************/
156 * Parameter Storage Area (PSA).
158 typedef struct psa_t psa_t
;
161 unsigned char psa_io_base_addr_1
; /* [0x00] Base address 1 ??? */
162 unsigned char psa_io_base_addr_2
; /* [0x01] Base address 2 */
163 unsigned char psa_io_base_addr_3
; /* [0x02] Base address 3 */
164 unsigned char psa_io_base_addr_4
; /* [0x03] Base address 4 */
165 unsigned char psa_rem_boot_addr_1
; /* [0x04] Remote Boot Address 1 */
166 unsigned char psa_rem_boot_addr_2
; /* [0x05] Remote Boot Address 2 */
167 unsigned char psa_rem_boot_addr_3
; /* [0x06] Remote Boot Address 3 */
168 unsigned char psa_holi_params
; /* [0x07] HOst Lan Interface (HOLI) Parameters */
169 unsigned char psa_int_req_no
; /* [0x08] Interrupt Request Line */
170 unsigned char psa_unused0
[7]; /* [0x09-0x0F] unused */
172 unsigned char psa_univ_mac_addr
[WAVELAN_ADDR_SIZE
]; /* [0x10-0x15] Universal (factory) MAC Address */
173 unsigned char psa_local_mac_addr
[WAVELAN_ADDR_SIZE
]; /* [0x16-1B] Local MAC Address */
174 unsigned char psa_univ_local_sel
; /* [0x1C] Universal Local Selection */
175 #define PSA_UNIVERSAL 0 /* Universal (factory) */
176 #define PSA_LOCAL 1 /* Local */
177 unsigned char psa_comp_number
; /* [0x1D] Compatibility Number: */
178 #define PSA_COMP_PC_AT_915 0 /* PC-AT 915 MHz */
179 #define PSA_COMP_PC_MC_915 1 /* PC-MC 915 MHz */
180 #define PSA_COMP_PC_AT_2400 2 /* PC-AT 2.4 GHz */
181 #define PSA_COMP_PC_MC_2400 3 /* PC-MC 2.4 GHz */
182 #define PSA_COMP_PCMCIA_915 4 /* PCMCIA 915 MHz or 2.0 */
183 unsigned char psa_thr_pre_set
; /* [0x1E] Modem Threshold Preset */
184 unsigned char psa_feature_select
; /* [0x1F] Call code required (1=on) */
185 #define PSA_FEATURE_CALL_CODE 0x01 /* Call code required (Japan) */
186 unsigned char psa_subband
; /* [0x20] Subband */
187 #define PSA_SUBBAND_915 0 /* 915 MHz or 2.0 */
188 #define PSA_SUBBAND_2425 1 /* 2425 MHz */
189 #define PSA_SUBBAND_2460 2 /* 2460 MHz */
190 #define PSA_SUBBAND_2484 3 /* 2484 MHz */
191 #define PSA_SUBBAND_2430_5 4 /* 2430.5 MHz */
192 unsigned char psa_quality_thr
; /* [0x21] Modem Quality Threshold */
193 unsigned char psa_mod_delay
; /* [0x22] Modem Delay (?) (reserved) */
194 unsigned char psa_nwid
[2]; /* [0x23-0x24] Network ID */
195 unsigned char psa_nwid_select
; /* [0x25] Network ID Select On/Off */
196 unsigned char psa_encryption_select
; /* [0x26] Encryption On/Off */
197 unsigned char psa_encryption_key
[8]; /* [0x27-0x2E] Encryption Key */
198 unsigned char psa_databus_width
; /* [0x2F] AT bus width select 8/16 */
199 unsigned char psa_call_code
[8]; /* [0x30-0x37] (Japan) Call Code */
200 unsigned char psa_nwid_prefix
[2]; /* [0x38-0x39] Roaming domain */
201 unsigned char psa_reserved
[2]; /* [0x3A-0x3B] Reserved - fixed 00 */
202 unsigned char psa_conf_status
; /* [0x3C] Conf Status, bit 0=1:config*/
203 unsigned char psa_crc
[2]; /* [0x3D] CRC-16 over PSA */
204 unsigned char psa_crc_status
; /* [0x3F] CRC Valid Flag */
209 /* Calculate offset of a field in the above structure.
210 * Warning: only even addresses are used. */
211 #define psaoff(p,f) ((unsigned short) ((void *)(&((psa_t *) ((void *) NULL + (p)))->f) - (void *) NULL))
213 /******************** MODEM MANAGEMENT INTERFACE ********************/
216 * Modem Management Controller (MMC) write structure.
218 typedef struct mmw_t mmw_t
;
221 unsigned char mmw_encr_key
[8]; /* encryption key */
222 unsigned char mmw_encr_enable
; /* Enable or disable encryption. */
223 #define MMW_ENCR_ENABLE_MODE 0x02 /* mode of security option */
224 #define MMW_ENCR_ENABLE_EN 0x01 /* Enable security option. */
225 unsigned char mmw_unused0
[1]; /* unused */
226 unsigned char mmw_des_io_invert
; /* encryption option */
227 #define MMW_DES_IO_INVERT_RES 0x0F /* reserved */
228 #define MMW_DES_IO_INVERT_CTRL 0xF0 /* control (?) (set to 0) */
229 unsigned char mmw_unused1
[5]; /* unused */
230 unsigned char mmw_loopt_sel
; /* looptest selection */
231 #define MMW_LOOPT_SEL_DIS_NWID 0x40 /* Disable NWID filtering. */
232 #define MMW_LOOPT_SEL_INT 0x20 /* Activate Attention Request. */
233 #define MMW_LOOPT_SEL_LS 0x10 /* looptest, no collision avoidance */
234 #define MMW_LOOPT_SEL_LT3A 0x08 /* looptest 3a */
235 #define MMW_LOOPT_SEL_LT3B 0x04 /* looptest 3b */
236 #define MMW_LOOPT_SEL_LT3C 0x02 /* looptest 3c */
237 #define MMW_LOOPT_SEL_LT3D 0x01 /* looptest 3d */
238 unsigned char mmw_jabber_enable
; /* jabber timer enable */
239 /* Abort transmissions > 200 ms */
240 unsigned char mmw_freeze
; /* freeze or unfreeze signal level */
241 /* 0 : signal level & qual updated for every new message, 1 : frozen */
242 unsigned char mmw_anten_sel
; /* antenna selection */
243 #define MMW_ANTEN_SEL_SEL 0x01 /* direct antenna selection */
244 #define MMW_ANTEN_SEL_ALG_EN 0x02 /* antenna selection algo. enable */
245 unsigned char mmw_ifs
; /* inter frame spacing */
246 /* min time between transmission in bit periods (.5 us) - bit 0 ignored */
247 unsigned char mmw_mod_delay
; /* modem delay (synchro) */
248 unsigned char mmw_jam_time
; /* jamming time (after collision) */
249 unsigned char mmw_unused2
[1]; /* unused */
250 unsigned char mmw_thr_pre_set
; /* level threshold preset */
251 /* Discard all packet with signal < this value (4) */
252 unsigned char mmw_decay_prm
; /* decay parameters */
253 unsigned char mmw_decay_updat_prm
; /* decay update parameters */
254 unsigned char mmw_quality_thr
; /* quality (z-quotient) threshold */
255 /* Discard all packet with quality < this value (3) */
256 unsigned char mmw_netw_id_l
; /* NWID low order byte */
257 unsigned char mmw_netw_id_h
; /* NWID high order byte */
258 /* Network ID or Domain : create virtual net on the air */
260 /* 2.0 Hardware extension - frequency selection support */
261 unsigned char mmw_mode_select
; /* for analog tests (set to 0) */
262 unsigned char mmw_unused3
[1]; /* unused */
263 unsigned char mmw_fee_ctrl
; /* frequency EEPROM control */
264 #define MMW_FEE_CTRL_PRE 0x10 /* Enable protected instructions. */
265 #define MMW_FEE_CTRL_DWLD 0x08 /* Download EEPROM to mmc. */
266 #define MMW_FEE_CTRL_CMD 0x07 /* EEPROM commands: */
267 #define MMW_FEE_CTRL_READ 0x06 /* Read */
268 #define MMW_FEE_CTRL_WREN 0x04 /* Write enable */
269 #define MMW_FEE_CTRL_WRITE 0x05 /* Write data to address. */
270 #define MMW_FEE_CTRL_WRALL 0x04 /* Write data to all addresses. */
271 #define MMW_FEE_CTRL_WDS 0x04 /* Write disable */
272 #define MMW_FEE_CTRL_PRREAD 0x16 /* Read addr from protect register */
273 #define MMW_FEE_CTRL_PREN 0x14 /* Protect register enable */
274 #define MMW_FEE_CTRL_PRCLEAR 0x17 /* Unprotect all registers. */
275 #define MMW_FEE_CTRL_PRWRITE 0x15 /* Write address in protect register */
276 #define MMW_FEE_CTRL_PRDS 0x14 /* Protect register disable */
277 /* Never issue the PRDS command: it's irreversible! */
279 unsigned char mmw_fee_addr
; /* EEPROM address */
280 #define MMW_FEE_ADDR_CHANNEL 0xF0 /* Select the channel. */
281 #define MMW_FEE_ADDR_OFFSET 0x0F /* Offset in channel data */
282 #define MMW_FEE_ADDR_EN 0xC0 /* FEE_CTRL enable operations */
283 #define MMW_FEE_ADDR_DS 0x00 /* FEE_CTRL disable operations */
284 #define MMW_FEE_ADDR_ALL 0x40 /* FEE_CTRL all operations */
285 #define MMW_FEE_ADDR_CLEAR 0xFF /* FEE_CTRL clear operations */
287 unsigned char mmw_fee_data_l
; /* Write data to EEPROM. */
288 unsigned char mmw_fee_data_h
; /* high octet */
289 unsigned char mmw_ext_ant
; /* Setting for external antenna */
290 #define MMW_EXT_ANT_EXTANT 0x01 /* Select external antenna */
291 #define MMW_EXT_ANT_POL 0x02 /* Polarity of the antenna */
292 #define MMW_EXT_ANT_INTERNAL 0x00 /* Internal antenna */
293 #define MMW_EXT_ANT_EXTERNAL 0x03 /* External antenna */
294 #define MMW_EXT_ANT_IQ_TEST 0x1C /* IQ test pattern (set to 0) */
295 } __attribute__ ((packed
));
299 #define mmwoff(p,f) (unsigned short)((void *)(&((mmw_t *)((void *)0 + (p)))->f) - (void *)0)
302 * Modem Management Controller (MMC) read structure.
304 typedef struct mmr_t mmr_t
;
307 unsigned char mmr_unused0
[8]; /* unused */
308 unsigned char mmr_des_status
; /* encryption status */
309 unsigned char mmr_des_avail
; /* encryption available (0x55 read) */
310 #define MMR_DES_AVAIL_DES 0x55 /* DES available */
311 #define MMR_DES_AVAIL_AES 0x33 /* AES (AT&T) available */
312 unsigned char mmr_des_io_invert
; /* des I/O invert register */
313 unsigned char mmr_unused1
[5]; /* unused */
314 unsigned char mmr_dce_status
; /* DCE status */
315 #define MMR_DCE_STATUS_RX_BUSY 0x01 /* receiver busy */
316 #define MMR_DCE_STATUS_LOOPT_IND 0x02 /* loop test indicated */
317 #define MMR_DCE_STATUS_TX_BUSY 0x04 /* transmitter on */
318 #define MMR_DCE_STATUS_JBR_EXPIRED 0x08 /* jabber timer expired */
319 #define MMR_DCE_STATUS 0x0F /* mask to get the bits */
320 unsigned char mmr_dsp_id
; /* DSP ID (AA = Daedalus rev A) */
321 unsigned char mmr_unused2
[2]; /* unused */
322 unsigned char mmr_correct_nwid_l
; /* # of correct NWIDs rxd (low) */
323 unsigned char mmr_correct_nwid_h
; /* # of correct NWIDs rxd (high) */
324 /* Warning: read high-order octet first! */
325 unsigned char mmr_wrong_nwid_l
; /* # of wrong NWIDs rxd (low) */
326 unsigned char mmr_wrong_nwid_h
; /* # of wrong NWIDs rxd (high) */
327 unsigned char mmr_thr_pre_set
; /* level threshold preset */
328 #define MMR_THR_PRE_SET 0x3F /* level threshold preset */
329 #define MMR_THR_PRE_SET_CUR 0x80 /* Current signal above it */
330 unsigned char mmr_signal_lvl
; /* signal level */
331 #define MMR_SIGNAL_LVL 0x3F /* signal level */
332 #define MMR_SIGNAL_LVL_VALID 0x80 /* Updated since last read */
333 unsigned char mmr_silence_lvl
; /* silence level (noise) */
334 #define MMR_SILENCE_LVL 0x3F /* silence level */
335 #define MMR_SILENCE_LVL_VALID 0x80 /* Updated since last read */
336 unsigned char mmr_sgnl_qual
; /* signal quality */
337 #define MMR_SGNL_QUAL 0x0F /* signal quality */
338 #define MMR_SGNL_QUAL_ANT 0x80 /* current antenna used */
339 unsigned char mmr_netw_id_l
; /* NWID low order byte (?) */
340 unsigned char mmr_unused3
[3]; /* unused */
342 /* 2.0 Hardware extension - frequency selection support */
343 unsigned char mmr_fee_status
; /* Status of frequency EEPROM */
344 #define MMR_FEE_STATUS_ID 0xF0 /* Modem revision ID */
345 #define MMR_FEE_STATUS_DWLD 0x08 /* Download in progress */
346 #define MMR_FEE_STATUS_BUSY 0x04 /* EEPROM busy */
347 unsigned char mmr_unused4
[1]; /* unused */
348 unsigned char mmr_fee_data_l
; /* Read data from EEPROM (low) */
349 unsigned char mmr_fee_data_h
; /* Read data from EEPROM (high) */
350 } __attribute__ ((packed
));
354 #define mmroff(p,f) (unsigned short)((void *)(&((mmr_t *)((void *)0 + (p)))->f) - (void *)0)
356 /* Make the two above structures one */
359 struct mmw_t w
; /* Write to the mmc */
360 struct mmr_t r
; /* Read from the mmc */
363 #endif /* _WAVELAN_H */
366 * This software may only be used and distributed
367 * according to the terms of the GNU General Public License.
369 * For more details, see wavelan.c.
This page took 0.039231 seconds and 5 git commands to generate.