Merge tag 'hda-switcheroo' of git://git.kernel.org/pub/scm/linux/kernel/git/tiwai...
[deliverable/linux.git] / drivers / staging / wlags49_h2 / hcfcfg.h
CommitLineData
68c0bdff
HG
1
2// vim:tw=110:ts=4:
3#ifndef HCFCFG_H
4#define HCFCFG_H 1
5
6/*************************************************************************************************************
7*
8* FILE : hcfcfg.tpl // hcfcfg.h
9*
10* DATE : $Date: 2004/08/05 11:47:10 $ $Revision: 1.6 $
11* Original: 2004/04/08 15:18:16 Revision: 1.40 Tag: t20040408_01
12* Original: 2004/04/01 15:32:55 Revision: 1.38 Tag: t7_20040401_01
13* Original: 2004/03/10 15:39:28 Revision: 1.34 Tag: t20040310_01
14* Original: 2004/03/03 14:10:12 Revision: 1.32 Tag: t20040304_01
15* Original: 2004/03/02 09:27:12 Revision: 1.30 Tag: t20040302_03
16* Original: 2004/02/24 13:00:28 Revision: 1.25 Tag: t20040224_01
17* Original: 2004/02/18 17:13:57 Revision: 1.23 Tag: t20040219_01
18*
19* AUTHOR : Nico Valster
20*
21* DESC : HCF Customization Macros
22* hcfcfg.tpl list all #defines which must be specified to:
23* adjust the HCF functions defined in HCF.C to the characteristics of a specific environment
24* o maximum sizes for messages
25* o Endianess
26* Compiler specific macros
27* o port I/O macros
28* o type definitions
29*
30* By copying HCFCFG.TPL to HCFCFG.H and -if needed- modifying the #defines the WCI functionality can be
31* tailored
32*
33* Supported environments:
34* WVLAN_41 Miniport NDIS 3.1
35* WVLAN_42 Packet Microsoft Visual C 1.5
36* WVLAN_43 16 bits DOS ODI Microsoft Visual C 1.5
37* WVLAN_44 32 bits ODI (__NETWARE_386__) WATCOM
38* WVLAN_45 MAC_OS MPW?, Symantec?
39* WVLAN_46 Windows CE (_WIN32_WCE) Microsoft ?
40* WVLAN_47 LINUX (__LINUX__) GCC, discarded, based on GPL'ed HCF-light
41* WVLAN_48 Miniport NDIS 5
42* WVLAN_49 LINUX (__LINUX__) GCC, originally based on pre-compiled HCF_library
43* migrated to use the HCF sources when Lucent Technologies
44* brought the HCF module under GPL
45* WVLAN_51 Miniport USB NDIS 5
46* WVLAN_52 Miniport NDIS 4
47* WVLAN_53 VxWorks END Station driver
48* WVLAN_54 VxWorks END Access Point driver
49* WVLAN_81 WavePoint BORLAND C
50* WCITST Inhouse test tool Microsoft Visual C 1.5
51* WSU WaveLAN Station Update Microsoft Visual C ??
52* SCO UNIX not yet actually used ? ?
53* __ppc OEM supplied ?
54* _AM29K OEM supplied ?
55* ? OEM supplied Microtec Research 80X86 Compiler
56*
57**************************************************************************************************************
58*
59*
60* SOFTWARE LICENSE
61*
62* This software is provided subject to the following terms and conditions,
63* which you should read carefully before using the software. Using this
64* software indicates your acceptance of these terms and conditions. If you do
65* not agree with these terms and conditions, do not use the software.
66*
d36b6910
AV
67* COPYRIGHT © 1994 - 1995 by AT&T. All Rights Reserved
68* COPYRIGHT © 1996 - 2000 by Lucent Technologies. All Rights Reserved
69* COPYRIGHT © 2001 - 2004 by Agere Systems Inc. All Rights Reserved
68c0bdff
HG
70* All rights reserved.
71*
72* Redistribution and use in source or binary forms, with or without
73* modifications, are permitted provided that the following conditions are met:
74*
75* . Redistributions of source code must retain the above copyright notice, this
76* list of conditions and the following Disclaimer as comments in the code as
77* well as in the documentation and/or other materials provided with the
78* distribution.
79*
80* . Redistributions in binary form must reproduce the above copyright notice,
81* this list of conditions and the following Disclaimer in the documentation
82* and/or other materials provided with the distribution.
83*
84* . Neither the name of Agere Systems Inc. nor the names of the contributors
85* may be used to endorse or promote products derived from this software
86* without specific prior written permission.
87*
88* Disclaimer
89*
90* THIS SOFTWARE IS PROVIDED "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES,
91* INCLUDING, BUT NOT LIMITED TO, INFRINGEMENT AND THE IMPLIED WARRANTIES OF
92* MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. ANY
93* USE, MODIFICATION OR DISTRIBUTION OF THIS SOFTWARE IS SOLELY AT THE USERS OWN
94* RISK. IN NO EVENT SHALL AGERE SYSTEMS INC. OR CONTRIBUTORS BE LIABLE FOR ANY
95* DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
96* (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
97* LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
98* ON ANY THEORY OF LIABILITY, INCLUDING, BUT NOT LIMITED TO, CONTRACT, STRICT
99* LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
100* OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH
101* DAMAGE.
102*
103*
104*************************************************************************************************************/
105
106/* Alignment
107* Some platforms can access words on odd boundaries (with possibly an performance impact), at other
108* platforms such an access may result in a memory access violation.
109* It is assumed that everywhere where the HCF casts a char pointer into a word pointer, the alignment
110* criteria are met. This put some restrictions on the MSF, which are assumed to be "automatically" fulfilled
111* at the applicable platforms
112* To assert this assumption, the macro HCF_ALIGN can be defined. The default value is 1, meaning byte
113* alignment (or no alignment), a value of 2 means word alignment, a value of 4 means double word alignment
114*/
115
116/***************************** IN_PORT_STRING_8_16 S a m p l e s *****************************************
117
118 // C implementation which let the processor handle the word-at-byte-boundary problem
119#define IN_PORT_STRING_8_16( port, addr, n) while ( n-- ) \
120 { *(hcf_16 FAR*)addr = IN_PORT_WORD( port ); ((hcf_8 FAR*)addr)+=2; }
121
122 // C implementation which handles the word-at-byte-boundary problem
123#define IN_PORT_STRING_8_16( port, addr, n) while ( n-- ) \
124 { hcf_16 i = IN_PORT_WORD(port); *((hcf_8 FAR*)addr)++ = (hcf_8)i; *((hcf_8 FAR*)addr)++ = (hcf_8)(i>>8);}
125
126 // Assembler implementation
127#define IN_PORT_STRING_8_16( port, addr, len) __asm \
128{ \
129 __asm push di \
130 __asm push es \
131 __asm mov cx,len \
132 __asm les di,addr \
133 __asm mov dx,port \
134 __asm rep insw \
135 __asm pop es \
136 __asm pop di \
137}
138
139
140***************************** OUT_PORT_STRING_8_16 S a m p l e s ******************************************
141
142 // C implementation which let the processor handle the word-at-byte-boundary problem
143#define OUT_PORT_STRING_8_16( port, addr, n) while ( n-- ) \
144 { OUT_PORT_WORD( port, *(hcf_16 FAR*)addr ) ; ((hcf_8 FAR*)addr)+=2; }
145
146 // C implementation which handles the word-at-byte-boundary problem
147#define OUT_PORT_STRING_8_16( port, addr, n) while ( n-- ) \
148 { OUT_PORT_WORD( port, *((hcf_8 FAR*)addr) | *(((hcf_8 FAR*)addr)+1)<<8 ); (hcf_8 FAR*)addr+=2; }
149
150 // Assembler implementation
151#define OUT_PORT_STRING_8_16( port, addr, len) __asm \
152{ \
153 __asm push si \
154 __asm push ds \
155 __asm mov cx,len \
156 __asm lds si,addr \
157 __asm mov dx,port \
158 __asm rep outsw \
159 __asm pop ds \
160 __asm pop si \
161}
162
163*************************************************************************************************************/
164
165
166/************************************************************************************************/
167/****************** C O M P I L E R S P E C I F I C M A C R O S ***************************/
168/************************************************************************************************/
169/*************************************************************************************************
170*
171* !!!!!!!!!!!!!!!!!!!!!!!!! Note to the HCF-implementor !!!!!!!!!!!!!!!!!!!!!!!!!
172* !!!! Do not call these macros with parameters which introduce side effects !!!!
173* !!!!!!!!!!!!!!!!!!!!!!!!! Note to the HCF-implementor !!!!!!!!!!!!!!!!!!!!!!!!!
174*
175*
176* By selecting the appropriate Macro definitions by means of modifying the "#ifdef 0/1" lines, the HCF can be
177* adjusted for the I/O characteristics of a specific compiler
178*
179* If needed the macros can be modified or replaced with definitions appropriate for your personal platform.
180* If you need to make such changes it is appreciated if you inform Agere Systems
181* That way the changes can become part of the next release of the WCI
182*
183* For convenience of the MSF-programmer, all macros are allowed to modify their parameters (although some
184* might argue that this would constitute bad coding practice). This has its implications on the HCF, e.g. as a
185* consequence these macros should not be called with parameters which have side effects, e.g auto-increment.
186*
187* in the Microsoft implementation of inline assembly it is O.K. to corrupt all flags except the direction flag
188* and to corrupt all registers except the segment registers and EDI, ESI, ESP and EBP (or their 16 bits
189* equivalents). Other environments may have other constraints
190*
191* in the Intel environment it is O.K to have a word (as a 16 bits quantity) at a byte boundary, hence
192* IN_/OUT_PORT_STRING_8_16 can move words between PC-memory and NIC-memory with as only constraint that the
193* words are on a word boundary in NIC-memory. This does not hold true for all conceivable environments, e.g.
194* an Motorola 68xxx does not allow this. Probably/hopefully the boundary conditions imposed by these type of
195* platforms prevent this case from materializing. If this is not the case, OUT_PORT_STRING_8_16 must be coded
196* by combining two Host memory hcf_8 values at a time to a single hcf_16 value to be passed to the NIC and
197* IN_PORT_STRING_8_16 the single hcf_16 retrieved from the NIC must be split in two hcf_8 values to be stored
198* in Host memory (see the sample code above)
199*
200* The prototypes and functional description of the macros are:
201*
202* hcf_16 IN_PORT_WORD( hcf_16 port )
203* Reads a word (16 bits) from the specified port
204*
205* void OUT_PORT_WORD( hcf_16 port, hcf_16 value)
206* Writes a word (16 bits) to the specified port
207*
208* hcf_16 IN_PORT_DWORD( hcf_16 port )
209* Reads a dword (32 bits) from the specified port
210*
211* void OUT_PORT_DWORD( hcf_16 port, hcf_32 value)
212* Writes a dword (32 bits) to the specified port
213*
214* void IN_PORT_STRING_8_16( port, addr, len)
215* Reads len number of words (16 bits) from NIC memory via the specified port to the (FAR)
216* byte-pointer addr in PC-RAM
217* Note that len specifies the number of words, NOT the number of bytes
218* !!!NOTE, although len specifies the number of words, addr MUST be a char pointer NOTE!!!
219* See also the common notes for IN_PORT_STRING_8_16 and OUT_PORT_STRING_8_16
220*
221* void OUT_PORT_STRING_8_16( port, addr, len)
222* Writes len number of words (16 bits) from the (FAR) byte-pointer addr in PC-RAM via the specified
223* port to NIC memory
224* Note that len specifies the number of words, NOT the number of bytes.
225* !!!NOTE, although len specifies the number of words, addr MUST be a char pointer NOTE!!!
226*
227* The peculiar combination of word-length and char pointers for IN_PORT_STRING_8_16 as well as
228* OUT_PORT_STRING_8_16 is justified by the assumption that it offers a more optimal algorithm
229*
230* void IN_PORT_STRING_32( port, addr, len)
231* Reads len number of double-words (32 bits) from NIC memory via the specified port to the (FAR)
232* double-word address addr in PC-RAM
233*
234* void OUT_PORT_STRING_32( port, addr, len)
235* Writes len number of double-words (32 bits) from the (FAR) double-word address addr in PC-RAM via
236* the specified port to NIC memory
237*
238* !!!!!!!!!!!!!!!!!!!!!!!!! Note to the HCF-implementor !!!!!!!!!!!!!!!!!!!!!!!!!
239* !!!! Do not call these macros with parameters which introduce side effects !!!!
240* !!!!!!!!!!!!!!!!!!!!!!!!! Note to the HCF-implementor !!!!!!!!!!!!!!!!!!!!!!!!!
241*
242*************************************************************************************************/
243
244/**************************** define INT Types ******************************/
245typedef unsigned char hcf_8;
246typedef unsigned short hcf_16;
247typedef unsigned long hcf_32;
248
249/**************************** define I/O Types ******************************/
250#define HCF_IO_MEM 0x0001 // memory mapped I/O ( 0: Port I/O )
251#define HCF_IO_32BITS 0x0002 // 32Bits support ( 0: only 16 Bits I/O)
252
253/****************************** #define HCF_TYPE ********************************/
254#define HCF_TYPE_NONE 0x0000 // No type
255#define HCF_TYPE_WPA 0x0001 // WPA support
256#define HCF_TYPE_USB 0x0002 // reserved (USB Dongle driver support)
257//#define HCF_TYPE_HII 0x0004 // Hermes-II, to discriminate H-I and H-II CFG_HCF_OPT_STRCT
258#define HCF_TYPE_WARP 0x0008 // WARP F/W
259#define HCF_TYPE_PRELOADED 0x0040 // pre-loaded F/W
260#define HCF_TYPE_HII5 0x0080 // Hermes-2.5 H/W
261#define HCF_TYPE_CCX 0x0100 // CKIP
262#define HCF_TYPE_BEAGLE_HII5 0x0200 // Beagle Hermes-2.5 H/W
263#define HCF_TYPE_TX_DELAY 0x4000 // Delayed transmission ( non-DMA only)
264
265/****************************** #define HCF_ASSERT ******************************/
266#define HCF_ASSERT_NONE 0x0000 // No assert support
267#define HCF_ASSERT_PRINTF 0x0001 // Hermes generated debug info
268#define HCF_ASSERT_SW_SUP 0x0002 // logging via Hermes support register
269#define HCF_ASSERT_MB 0x0004 // logging via Mailbox
270#define HCF_ASSERT_RT_MSF_RTN 0x4000 // dynamically binding of msf_assert routine
271#define HCF_ASSERT_LNK_MSF_RTN 0x8000 // statically binding of msf_assert routine
272
273/****************************** #define HCF_ENCAP *******************************/
274#define HCF_ENC_NONE 0x0000 // No encapsulation support
275#define HCF_ENC 0x0001 // HCF handles En-/Decapsulation
276#define HCF_ENC_SUP 0x0002 // HCF supports MSF to handle En-/Decapsulation
277
278/****************************** #define HCF_EXT *********************************/
279#define HCF_EXT_NONE 0x0000 // No expanded features
280#define HCF_EXT_INFO_LOG 0x0001 // logging of Hermes Info frames
281//#define HCF_EXT_INT_TX_OK 0x0002 // RESERVED!!! monitoring successful Tx message
282#define HCF_EXT_INT_TX_EX 0x0004 // monitoring unsuccessful Tx message
283//#define HCF_EXT_MON_MODE 0x0008 // LEGACY
284#define HCF_EXT_TALLIES_FW 0x0010 // support for up to 32 Hermes Engineering tallies
285#define HCF_EXT_TALLIES_HCF 0x0020 // support for up to 8 HCF Engineering tallies
286#define HCF_EXT_NIC_ACCESS 0x0040 // direct access via Aux-ports and to Hermes registers and commands
287#define HCF_EXT_MB 0x0080 // MailBox code expanded
288#define HCF_EXT_IFB_STRCT 0x0100 // MSF custom pointer in IFB
289#define HCF_EXT_DESC_STRCT 0x0200 // MSF custom pointer in Descriptor
290#define HCF_EXT_TX_CONT 0x4000 // Continuous transmit test
291#define HCF_EXT_INT_TICK 0x8000 // enables TimerTick interrupt generation
292
293/****************************** #define HCF_SLEEP *******************************/
294#define HCF_DDS 0x0001 // Disconnected Deep Sleep
295#define HCF_CDS 0x0002 // Connected Deep Sleep
296
297/****************************** #define HCF_TALLIES ******************************/
298#define HCF_TALLIES_NONE 0x0000 // No tally support
299#define HCF_TALLIES_NIC 0x0001 // Hermes Tallies accumulated in IFB
300#define HCF_TALLIES_HCF 0x0002 // HCF Tallies accumulated in IFB
301#define HCF_TALLIES_RESET 0x8000 // Tallies in IFB are reset when reported via hcf_get_info
302
68c0bdff
HG
303/************************************************************************************************/
304/****************************************** L I N U X *****************************************/
305/************************************************************************************************/
306
307#ifdef WVLAN_49
308#include <asm/io.h>
309//#include <linux/module.h>
310#include <wl_version.h>
311
312/* The following macro ensures that no symbols are exported, minimizing the chance of a symbol
313 collision in the kernel */
314//EXPORT_NO_SYMBOLS; //;?this place seems not appropriately to me
315
316//#define HCF_SLEEP (HCF_CDS | HCF_DDS )
317#define HCF_SLEEP (HCF_CDS)
318
add54e5c
DK
319/* Note: Non-WARP firmware all support WPA. However the original Agere
320 * linux driver does not enable WPA. Enabling WPA here causes whatever
321 * preliminary WPA logic to be included, some of which may be specific
322 * to HERMESI.
323 *
324 * Various comment are clear that WARP and WPA are not compatible
325 * (which may just mean WARP does WPA in a different fashion).
326 */
327
328/* #define HCF_TYPE (HCF_TYPE_HII5|HCF_TYPE_STA|HCF_TYPE_AP) */
68c0bdff
HG
329#ifdef HERMES25
330#ifdef WARP
331#define HCF_TYPE ( HCF_TYPE_WARP | HCF_TYPE_HII5 )
332#else
add54e5c
DK
333#define HCF_TYPE (HCF_TYPE_HII5 | HCF_TYPE_WPA)
334#endif /* WARP */
68c0bdff 335#else
add54e5c
DK
336#define HCF_TYPE HCF_TYPE_WPA
337#endif /* HERMES25 */
68c0bdff
HG
338
339#ifdef ENABLE_DMA
340#define HCF_DMA 1
341#endif // ENABLE_DMA
342
343/* We now need a switch to include support for the Mailbox and other necessary extensions */
344#define HCF_EXT ( HCF_EXT_MB | HCF_EXT_INFO_LOG | HCF_EXT_INT_TICK )//get deepsleep exercise going
345
346/* ;? The Linux MSF still uses these definitions; define it here until it's removed */
347#ifndef HCF_TYPE_HII
348#define HCF_TYPE_HII 0x0004
349#endif
350
351#ifndef HCF_TYPE_AP
352#define HCF_TYPE_AP 0x0010
353#endif
354
355#ifndef HCF_TYPE_STA
356#define HCF_TYPE_STA 0x0020
357#endif // HCF_TYPE_STA
358
359/* Guarantees word alignment */
360#define HCF_ALIGN 2
361
362/* Endian macros CNV_INT_TO_LITTLE() and CNV_LITTLE_TO_INT() were renamed to
363 CNV_SHORT_TO_LITTLE() and CNV_LITTLE_TO_SHORT() */
364#ifndef CNV_INT_TO_LITTLE
365#define CNV_INT_TO_LITTLE CNV_SHORT_TO_LITTLE
366#endif
367
368#ifndef CNV_LITTLE_TO_INT
369#define CNV_LITTLE_TO_INT CNV_LITTLE_TO_SHORT
370#endif
371
372#define HCF_ERR_BUSY 0x06
373
374/* UIL defines were removed from the HCF */
375#define UIL_SUCCESS HCF_SUCCESS
376#define UIL_ERR_TIME_OUT HCF_ERR_TIME_OUT
377#define UIL_ERR_NO_NIC HCF_ERR_NO_NIC
378#define UIL_ERR_LEN HCF_ERR_LEN
379#define UIL_ERR_MIN HCF_ERR_MAX /*end of HCF errors which are passed through to UIL
380 *** ** *** ****** ***** *** ****** ******* ** *** */
381#define UIL_ERR_IN_USE 0x44
382#define UIL_ERR_WRONG_IFB 0x46
383#define UIL_ERR_MAX 0x7F /*upper boundary of UIL errors without HCF-pendant
384 ***** ******** ** *** ****** ******* *** ******* */
385#define UIL_ERR_BUSY HCF_ERR_BUSY
386#define UIL_ERR_DIAG_1 HCF_ERR_DIAG_1
387#define UIL_FAILURE 0xFF /* 20010705 nv this relick should be eridicated */
388#define UIL_ERR_PIF_CONFLICT 0x40 //obsolete
389#define UIL_ERR_INCOMP_DRV 0x41 //obsolete
390#define UIL_ERR_DOS_CALL 0x43 //obsolete
391#define UIL_ERR_NO_DRV 0x42 //obsolete
392#define UIL_ERR_NSTL 0x45 //obsolete
393
394
395
396#if 0 //;? #ifdef get this going LATER HERMES25
397#define HCF_IO HCF_IO_32BITS
398#define HCF_DMA 1
399#define HCF_DESC_STRCT_EXT 4
400
401/* Switch for BusMaster DMA support. Note that the above define includes the DMA-specific HCF
402 code in the build. This define sets the MSF to use DMA; if ENABLE_DMA is not defined, then
403 port I/O will be used in the build */
404#ifndef BUS_PCMCIA
405#define ENABLE_DMA
406#endif // USE_PCMCIA
407
408#endif // HERMES25
409
410
411/* Overrule standard WaveLAN Packet Size when in DMA mode */
412#ifdef ENABLE_DMA
413#define HCF_MAX_PACKET_SIZE 2304
414#else
415#define HCF_MAX_PACKET_SIZE 1514
416#endif // ENABLE_DMA
417
418/* The following sets the component ID, as well as the versioning. See also wl_version.h */
419#define MSF_COMPONENT_ID COMP_ID_LINUX
420
421#define MSF_COMPONENT_VAR DRV_VARIANT
422#define MSF_COMPONENT_MAJOR_VER DRV_MAJOR_VERSION
423#define MSF_COMPONENT_MINOR_VER DRV_MINOR_VERSION
424
425/* Define the following to turn on assertions in the HCF */
426//#define HCF_ASSERT 0x8000
427#define HCF_ASSERT HCF_ASSERT_LNK_MSF_RTN // statically binding of msf_assert routine
428
429#ifdef USE_BIG_ENDIAN
430#define HCF_BIG_ENDIAN 1
431#else
432#define HCF_BIG_ENDIAN 0
433#endif /* USE_BIG_ENDIAN */
434
435/* Define the following if your system uses memory-mapped IO */
436//#define HCF_MEM_IO
437
438/* The following defines the standard macros required by the HCF to move data to/from the card */
439#define IN_PORT_BYTE(port) ((hcf_8)inb( (hcf_io)(port) ))
440#define IN_PORT_WORD(port) ((hcf_16)inw( (hcf_io)(port) ))
441#define OUT_PORT_BYTE(port, value) (outb( (hcf_8) (value), (hcf_io)(port) ))
442#define OUT_PORT_WORD(port, value) (outw((hcf_16) (value), (hcf_io)(port) ))
443
444#define IN_PORT_STRING_16(port, dst, n) insw((hcf_io)(port), dst, n)
445#define OUT_PORT_STRING_16(port, src, n) outsw((hcf_io)(port), src, n)
446//#define IN_PORT_STRINGL(port, dst, n) insl((port), (dst), (n))
447//#define OUT_PORT_STRINGL(port, src, n) outsl((port), (src), (n))
448#define IN_PORT_STRING_32(port, dst, n) insl((port), (dst), (n))
449#define OUT_PORT_STRING_32(port, src, n) outsl((port), (src), (n))
450#define IN_PORT_HCF32(port) inl( (hcf_io)(port) )
451#define OUT_PORT_HCF32(port, value) outl((hcf_32)(value), (hcf_io)(port) )
452
453#define IN_PORT_DWORD(port) IN_PORT_HCF32(port)
454#define OUT_PORT_DWORD(port, value) OUT_PORT_HCF32(port, value)
455
456#define IN_PORT_STRING_8_16(port, addr, len) IN_PORT_STRING_16(port, addr, len)
457#define OUT_PORT_STRING_8_16(port, addr, len) OUT_PORT_STRING_16(port, addr, len)
458
68c0bdff
HG
459#ifndef CFG_SCAN_CHANNELS_2GHZ
460#define CFG_SCAN_CHANNELS_2GHZ 0xFCC2
461#endif /* CFG_SCAN_CHANNELS_2GHZ */
462
463#define HCF_MAX_MSG 1600 //get going ;?
464#endif // WVLAN_49
465
68c0bdff
HG
466/************************************************************************************************************/
467/*********************************** **************************************/
468/************************************************************************************************************/
469#if ! defined HCF_ALIGN
470#define HCF_ALIGN 1 //default to no alignment
471#endif // HCF_ALIGN
472
473#if ! defined HCF_ASSERT
474#define HCF_ASSERT 0
475#endif // HCF_ASSERT
476
477#if ! defined HCF_BIG_ENDIAN
478#define HCF_BIG_ENDIAN 0
479#endif // HCF_BIG_ENDIAN
480
68c0bdff
HG
481#if ! defined HCF_DMA
482#define HCF_DMA 0
483#endif // HCF_DMA
484
485#if ! defined HCF_ENCAP
486#define HCF_ENCAP HCF_ENC
487#endif // HCF_ENCAP
488
68c0bdff
HG
489#if ! defined HCF_EXT
490#define HCF_EXT 0
491#endif // HCF_EXT
492
493#if ! defined HCF_INT_ON
494#define HCF_INT_ON 1
495#endif // HCF_INT_ON
496
497#if ! defined HCF_IO
498#define HCF_IO 0 //default 16 bits support only, port I/O
499#endif // HCF_IO
500
501#if ! defined HCF_LEGACY
502#define HCF_LEGACY 0
503#endif // HCF_LEGACY
504
505#if ! defined HCF_MAX_LTV
506#define HCF_MAX_LTV 1200 // sufficient for all known purposes
507#endif // HCF_MAX_LTV
508
509#if ! defined HCF_PROT_TIME
510#define HCF_PROT_TIME 100 // number of 10K microsec protection timer against H/W malfunction
511#endif // HCF_PROT_TIME
512
513#if ! defined HCF_SLEEP
514#define HCF_SLEEP 0
515#endif // HCF_SLEEP
516
517#if ! defined HCF_TALLIES
518#define HCF_TALLIES ( HCF_TALLIES_NIC | HCF_TALLIES_HCF )
519#endif // HCF_TALLIES
520
521#if ! defined HCF_TYPE
522#define HCF_TYPE 0
523#endif // HCF_TYPE
524
525#if HCF_BIG_ENDIAN
526#undef HCF_BIG_ENDIAN
527#define HCF_BIG_ENDIAN 1 //just for convenience of generating cfg_hcf_opt
528#endif // HCF_BIG_ENDIAN
529
68c0bdff
HG
530#if HCF_DMA
531#undef HCF_DMA
532#define HCF_DMA 1 //just for convenience of generating cfg_hcf_opt
533#endif // HCF_DMA
534
535#if HCF_INT_ON
536#undef HCF_INT_ON
537#define HCF_INT_ON 1 //just for convenience of generating cfg_hcf_opt
538#endif // HCF_INT_ON
539
540
541#if ! defined IN_PORT_STRING_8_16
542#define IN_PORT_STRING_8_16(port, addr, len) IN_PORT_STRING_16(port, addr, len)
543#define OUT_PORT_STRING_8_16(port, addr, len) OUT_PORT_STRING_16(port, addr, len)
544#endif // IN_PORT_STRING_8_16
545
546/************************************************************************************************/
547/********** *************/
548/************************************************************************************************/
549
550#if ! defined FAR
551#define FAR // default to flat 32-bits code
552#endif // FAR
553
554typedef hcf_8 FAR *wci_bufp; // segmented 16-bits or flat 32-bits pointer to 8 bits unit
555typedef hcf_16 FAR *wci_recordp; // segmented 16-bits or flat 32-bits pointer to 16 bits unit
556
557/* I/O Address size
558* Platforms which use port mapped I/O will (in general) have a 64k I/O space, conveniently expressed in a
559* 16-bits quantity
560* Platforms which use memory mapped I/O will (in general) have an I/O space much larger than 64k, and need a
561* 32-bits quantity to express the I/O base
562*/
563
564#if HCF_IO & HCF_IO_MEM
565typedef hcf_32 hcf_io;
566#else
567typedef hcf_16 hcf_io;
568#endif //HCF_IO
569
570#if HCF_PROT_TIME > 128
571#define HCF_PROT_TIME_SHFT 3
572#define HCF_PROT_TIME_DIV 8
573#elif HCF_PROT_TIME > 64
574#define HCF_PROT_TIME_SHFT 2
575#define HCF_PROT_TIME_DIV 4
576#elif HCF_PROT_TIME > 32
577#define HCF_PROT_TIME_SHFT 1
578#define HCF_PROT_TIME_DIV 2
579#else //HCF_PROT_TIME >= 19
580#define HCF_PROT_TIME_SHFT 0
581#define HCF_PROT_TIME_DIV 1
582#endif
583
584#define HCF_PROT_TIME_CNT (HCF_PROT_TIME / HCF_PROT_TIME_DIV)
585
586
587/************************************************************************************************************/
588/******************************************* . . . . . . . . . *********************************************/
589/************************************************************************************************************/
590
591/* MSF_COMPONENT_ID is used to define the CFG_IDENTITY_STRCT in HCF.C
592* CFG_IDENTITY_STRCT is defined in HCF.C purely based on convenience arguments.
593* The HCF can not have the knowledge to determine the ComponentId field of the Identity record (aka as
594* Version Record), therefore the MSF part of the Drivers must supply this value via the System Constant
595* MSF_COMPONENT_ID.
596* There is a set of values predefined in MDD.H (format COMP_ID_.....)
597*
598* Note that taking MSF_COMPONENT_ID as a default value for DUI_COMPAT_VAR is purely an implementation
599* convenience, the numerical values of these two quantities have none functional relationship whatsoever.
600*/
601
602#if defined MSF_COMPONENT_ID
603
604#if ! defined DUI_COMPAT_VAR
605#define DUI_COMPAT_VAR MSF_COMPONENT_ID
606#endif // DUI_COMPAT_VAR
607
608#if ! defined DUI_COMPAT_BOT //;?this way utilities can lower as well raise the bottom
609#define DUI_COMPAT_BOT 8
610#endif // DUI_COMPAT_BOT
611
612#if ! defined DUI_COMPAT_TOP //;?this way utilities can lower as well raise the top
613#define DUI_COMPAT_TOP 8
614#endif // DUI_COMPAT_TOP
615
616#endif // MSF_COMPONENT_ID
617
618#if (HCF_TYPE) & HCF_TYPE_HII5
619
620#if ! defined HCF_HSI_VAR_5
621#define HCF_HSI_VAR_5
622#endif // HCF_HSI_VAR_5
623
624#if ! defined HCF_APF_VAR_4
625#define HCF_APF_VAR_4
626#endif // HCF_APF_VAR_4
627
628#if (HCF_TYPE) & HCF_TYPE_WARP
629#if ! defined HCF_STA_VAR_4
630#define HCF_STA_VAR_4
631#endif // HCF_STA_VAR_4
632#else
633#if ! defined HCF_STA_VAR_2
634#define HCF_STA_VAR_2
635#endif // HCF_STA_VAR_2
636#endif
637
638#if defined HCF_HSI_VAR_4
639err: HSI variants 4 correspond with HII;
640#endif // HCF_HSI_VAR_4
641
642#else
643
644#if ! defined HCF_HSI_VAR_4
645#define HCF_HSI_VAR_4 //Hermes-II all types (for the time being!)
646#endif // HCF_HSI_VAR_4
647
648#if ! defined HCF_APF_VAR_2
649#define HCF_APF_VAR_2
650#endif // HCF_APF_VAR_2
651
652#if ! defined HCF_STA_VAR_2
653#define HCF_STA_VAR_2
654#endif // HCF_STA_VAR_2
655
656#endif // HCF_TYPE_HII5
657
658#if ! defined HCF_PRI_VAR_3
659#define HCF_PRI_VAR_3
660#endif // HCF_PRI_VAR_3
661
662#if defined HCF_HSI_VAR_1 || defined HCF_HSI_VAR_2 || defined HCF_HSI_VAR_3
663err: HSI variants 1, 2 and 3 correspond with H-I only;
664#endif // HCF_HSI_VAR_1, HCF_HSI_VAR_2, HCF_HSI_VAR_3
665
666#if defined HCF_PRI_VAR_1 || defined HCF_PRI_VAR_2
667err: primary variants 1 and 2 correspond with H-I only;
668#endif // HCF_PRI_VAR_1 / HCF_PRI_VAR_2
669
670
671/************************************************************************************************************/
672/******************************************* . . . . . . . . . *********************************************/
673/************************************************************************************************************/
674
675
676/* The BASED customization macro is used to resolves the SS!=DS conflict for the Interrupt Service logic in
677 * DOS Drivers. Due to the cumbersomeness of mixing C and assembler local BASED variables still end up in the
678 * wrong segment. The workaround is that the HCF uses only global BASED variables or IFB-based variables.
679 * The "BASED" construction (supposedly) only amounts to something in the small memory model.
680 *
681 * Note that the whole BASED rigmarole is needlessly complicated because both the Microsoft Compiler and
682 * Linker are unnecessary restrictive in what far pointer manipulation they allow
683 */
684
685#if ! defined BASED
686#define BASED
687#endif // BASED
688
689#if ! defined EXTERN_C
690#ifdef __cplusplus
691#define EXTERN_C extern "C"
692#else
693#define EXTERN_C
694#endif // __cplusplus
695#endif // EXTERN_C
696
697#if ! defined NULL
698#define NULL ((void *) 0)
699#endif // NULL
700
701#if ! defined TEXT
702#define TEXT(x) x
703#endif // TEXT
704
68c0bdff
HG
705/************************************************************************************************************/
706/*********************** C O N F L I C T D E T E C T I O N & R E S O L U T I O N ************************/
707/************************************************************************************************************/
68c0bdff
HG
708#if HCF_ALIGN != 1 && HCF_ALIGN != 2 && HCF_ALIGN != 4 && HCF_ALIGN != 8
709err: invalid value for HCF_ALIGN;
710#endif // HCF_ALIGN
711
712#if (HCF_ASSERT) & ~( HCF_ASSERT_PRINTF | HCF_ASSERT_SW_SUP | HCF_ASSERT_MB | HCF_ASSERT_RT_MSF_RTN | \
713 HCF_ASSERT_LNK_MSF_RTN )
714err: invalid value for HCF_ASSERT;
715#endif // HCF_ASSERT
716
717#if (HCF_ASSERT) & HCF_ASSERT_MB && ! ( (HCF_EXT) & HCF_EXT_MB ) //detect potential conflict
718err: these macros are not used consistently;
719#endif // HCF_ASSERT_MB / HCF_EXT_MB
720
721#if HCF_BIG_ENDIAN != 0 && HCF_BIG_ENDIAN != 1
722err: invalid value for HCF_BIG_ENDIAN;
723#endif // HCF_BIG_ENDIAN
724
68c0bdff
HG
725#if HCF_DMA != 0 && HCF_DMA != 1
726err: invalid value for HCF_DMA;
727#endif // HCF_DMA
728
729#if (HCF_ENCAP) & ~( HCF_ENC | HCF_ENC_SUP )
730err: invalid value for HCF_ENCAP;
731#endif // HCF_ENCAP
732
733#if (HCF_EXT) & ~( HCF_EXT_INFO_LOG | HCF_EXT_INT_TX_EX | HCF_EXT_TALLIES_FW | HCF_EXT_TALLIES_HCF | \
734 HCF_EXT_NIC_ACCESS | HCF_EXT_MB | HCF_EXT_INT_TICK | \
735 HCF_EXT_IFB_STRCT | HCF_EXT_DESC_STRCT | HCF_EXT_TX_CONT )
736err: invalid value for HCF_EXT;
737#endif // HCF_EXT
738
739#if HCF_INT_ON != 0 && HCF_INT_ON != 1
740err: invalid value for HCF_INT_ON;
741#endif // HCF_INT_ON
742
743#if (HCF_IO) & ~( HCF_IO_MEM | HCF_IO_32BITS )
744err: invalid value for HCF_IO;
745#endif // HCF_IO
746
747#if HCF_LEGACY != 0 && HCF_LEGACY != 1
748err: invalid value for HCF_LEGACY;
749#endif // HCF_LEGACY
750
751#if HCF_MAX_LTV < 16 || HCF_MAX_LTV > 2304
752err: invalid value for HCF_MAX_LTV;
753#endif // HCF_MAX_LTV
754
755#if HCF_PROT_TIME != 0 && ( HCF_PROT_TIME < 19 || 256 < HCF_PROT_TIME )
756err: below minimum .08 second required by Hermes or possibly above hcf_32 capacity;
757#endif // HCF_PROT_TIME
758
759#if (HCF_SLEEP) & ~( HCF_CDS | HCF_DDS )
760err: invalid value for HCF_SLEEP;
761#endif // HCF_SLEEP
762
763#if (HCF_SLEEP) && ! (HCF_INT_ON)
764err: these macros are not used consistently;
765#endif // HCF_SLEEP / HCF_INT_ON
766
767#if (HCF_SLEEP) && ! ( (HCF_EXT) & HCF_EXT_INT_TICK )
768//;? err: these macros are not used consistently;
769#endif // HCF_SLEEP / HCF_EXT_INT_TICK
770
771#if (HCF_TALLIES) & ~( HCF_TALLIES_HCF | HCF_TALLIES_NIC | HCF_TALLIES_RESET ) || \
772 (HCF_TALLIES) == HCF_TALLIES_RESET
773err: invalid value for HCF_TALLIES;
774#endif // HCF_TALLIES
775
776#if (HCF_TYPE) & ~(HCF_TYPE_WPA | HCF_TYPE_USB | HCF_TYPE_PRELOADED | HCF_TYPE_HII5 | HCF_TYPE_WARP | \
777 HCF_TYPE_CCX /* | HCF_TYPE_TX_DELAY */ )
778err: invalid value for HCF_TYPE;
779#endif //HCF_TYPE
780
781#if (HCF_TYPE) & HCF_TYPE_WARP && (HCF_TYPE) & HCF_TYPE_WPA
782err: at most 1 of these macros should be defined;
783#endif //HCF_TYPE_WARP / HCF_TYPE_WPA
784
785#endif //HCFCFG_H
786
This page took 0.298837 seconds and 5 git commands to generate.