WLAGS49(4)

NAME
wlags49 - Agere Systems Wireless PC Card / PCI device drivers wlags49_h1_cs.o - Hermes-I Card Services (PCMCIA/CF) driver wlags49_h2_cs.o - Hermes-II Card Services (PCMCIA/CF) driver wlags49_h2.o - Hermes-II MiniPCI driver

SYNOPSIS
insmod wlags49_[h1,h2]_[cs].o [irq_mask=n] [irq_list=i,j,...] [pc_debug=n] [debug_flags=n] [network_name=s] [channel=n] [distance_between_aps=n] [transmit_rate=n] [medium_reservation=n] [microwave_robustness=s] [mac_address=n,n,n,n,n,n] [station_name=s] [enable_encryption=s] [key_1=s] [key_2=s] [key_3=s] [key_4=s] [transmit_key_id=n] [multicast_rate=n] [card_power_management=b] [port_type=n] [create_ibss=s] [receive_all_multicasts=s] [maximum_sleep_duration=n] [authentication=n] [atim_window=n] [holdover_duration=n] [promiscuous_mode=s] [download_firmware=n] [dtim_period=n] [closed_system=s] [deny_nonencrypted=s] [multicast_pm_buffering=s] [intra_bss_relay=s] [rts_threshold_1=n] [rts_threshold_2=n] [rts_threshold_3=n] [rts_threshold_4=n] [rts_threshold_5=n] [rts_threshold_6=n] [tx_rate_control_1=n] [tx_rate_control_2=n] [tx_rate_control_3=n] [tx_rate_control_4=n] [tx_rate_control_5=n] [tx_rate_control_6=n] [wds_address_1=n,n,n,n,n,n] [wds_address_2=n,n,n,n,n,n] [wds_address_3=n,n,n,n,n,n] [wds_address_4=n,n,n,n,n,n] [wds_address_5=n,n,n,n,n,n] [wds_address_6=n,n,n,n,n,n] Note that the above parameters have been marked for deprecation in lieu of the following: insmod wlags49_[h1,h2]_[cs].o [irq_mask=n] [irq_list=i,j,...] [pc_debug=n] [debug_flags=n] [DesiredSSID=s] [OwnSSID=s] [OwnChannel=n] [SystemScale=n] [TxRateControl=n] [RTSThreshold=n] [MicroWaveRobustness=s] [NetworkAddress=n,n,n,n,n,n] [OwnName=s] [EnableEncryption=s] [Key1=s] [Key2=s] [Key3=s] [Key4=s] [TxKey=n] [MulticastRate=n] [PMEnabled=b] [PortType=n] [CreateIBSS=s] [MulticastReceive=s] [MaxSleepDuration=n] [Authentication=n] [OwnATIMWindow=n] [PMHoldoverDuration=n] [PromiscuousMode=s] [DownloadFirmware=n] [OwnDTIMPeriod=n] [RejectANY=s] [ExcludeUnencrypted=s] [MulticastPMBuffering=s] [IntraBSSRelay=s] [RTSThreshold1=n] [RTSThreshold2=n] [RTSThreshold3=n] [RTSThreshold4=n] [RTSThreshold5=n] [RTSThreshold6=n] [TxRateControl1=n] [TxRateControl2=n] [TxRateControl3=n] [TxRateControl4=n] [TxRateControl5=n] [TxRateControl6=n] [WDSAddress1=n,n,n,n,n,n] [WDSAddress2=n,n,n,n,n,n] [WDSAddress3=n,n,n,n,n,n] [WDSAddress4=n,n,n,n,n,n] [WDSAddress5=n,n,n,n,n,n] [WDSAddress6=n,n,n,n,n,n]

DESCRIPTION
wlags49 is the low-level Card Services / PCI driver for the Wireless PC Card, Wireless Integrated Card, Wireless Embedded Card and other wireless adapters based on the Agere Systems Hermes-I and Hermes-II wireless MAC. When this driver is attached to a card, it allocates the next available ethernet device (eth0..eth#). This device name will be passed on to cardmgr(8), or the PCI subsystem, for the card configuration, and reported in the kernel log file with the I/O base address and MAC address used by the card.

FEATURES
 - Hot plug/unplug
 - Access Point and peer-to-peer communication
 - Card power management
 - Standard, Turbo, Silver and Gold cards
    (with firmware 4.x or higher)
 - Support for Hermes-I & Hermes-II based PCMCIA and Mini
    PCI cards
 - Wired Equivalent Privacy (WEP)
 - WPA-PSK support (EXPERIMENTAL)
 - Driver utility interface (UIL)
 - Wireless Extensions
 - Software AP mode

PARAMETERS

irq_mask=n
    Specifies a mask of valid interrupts that may be allocated by this driver. If irq_list is also specified, the values in irq_list are used instead. NOTE: This parameter is for PCMCIA only.
        Default: 0xdeb8 (IRQ 3,4,5,7,9,10,11,12,14,15)

irq_list=i,j,...
    Specifies the set of interrupts (up to 4) that may be allocated by this driver. This overrides the values set in the irq_mask parameter. NOTE: This parameter is for PCMCIA only.

pc_debug=n
    Selects the PCMCIA debugging level. This parameter is only available if the module is compiled with debugging enabled. A non-zero value enables debugging.

debug_flags=n
    Selects the driver debugging level. This parameter is only available if the module is compiled with debugging enabled. Refer to the file debug.h in the source directory for information on the flag values.

network_name=s
    Same as OwnSSID.

DesiredSSID=s
    Same as OwnSSID.

OwnSSID=s
    Sets the card network name to the specified string value. This parameter accepts a maximum of 32 characters. Whitespace in the network name will need to be escaped with a backslash (ie. network_name=My\ Network).
        Default: ANY

channel=n
    Same as OwnChannel.

OwnChannel=n
    Sets the channel the Ad-Hoc or IBSS mode will use. The default channel for Ad-Hoc mode is determined by the Wireless PC Card. The default channel for IBSS is set to 10 by the driver. This value has no effect when the adapter is used with an Access Point (BSS network) since the Access Point automatically determines the channel. Valid values are 0 to 14. However the channels allowed in your region are subject to local regulations and are limited at manufacturing time of the Wireless PC Card. When the provided value is not allowed, the value remains unchanged.
        0 - Use default channel
        Default: 0

distance_between_aps=n
    Same as SystemScale.

SystemScale=n
    Sets the distance between Access Points in the network. This value influences the Modem Thresholds (EnergyDetectThreshold, CarrierDetectThreshold and DeferThreshold) and the Roaming Thresholds (CellSearchThreshold and OutOfRangeThreshold).
        1 - Large
        2 - Medium
        3 - Small
        Default: 1

transmit_rate=n
    Same as TxRateControl

TxRateControl=n
    Sets the data rate to be used by the transmitter.
        1 - Fixed Low
        2 - Fixed Standard
        3 - Auto Rate Select (High)
        4 - Fixed Medium
        5 - Fixed High
        6 - Auto Rate Select (Standard)
        7 - Auto Rate Select (Medium)
        Default: 3

medium_reservation=n
    Same as RTSThreshold.

RTSThreshold=n
    Sets the number of octets in a message or fragment above which a RTS/CTS handshake is performed. Valid values are 0 to 2347.
        500 - Hidden Stations
        2347 - No RTS/CTS
        Default: 2347

microwave_robustness=s
    Same as MicrowaveRobustness.

MicroWaveRobustness=s
    Enable or disable Microwave Oven Robustness.
        N - Disable
        Y - Enable
        Default: N

mac_address=n,n,n,n,n,n
    Same as NetworkAddress

NetworkAddress=n,n,n,n,n,n
    Sets the adapter hardware ethernet address (MAC address) to the value specified. Note that this is to be used to specify a Local MAC address. Do not specify this parameter if the card's universal address is to be used. Valid values are six hexadecimal digit-pairs (prefixed with 0x).
        Default: <factory assigned address>

station_name=s
    Same as OwnName.

OwnName=s
    Sets the station name to the specified string value. This parameter is used for diagnostic purposes, as a user-friendly identification of this system. This parameter accepts a maximum of 32 characters.
        Default: Linux

enable_encryption=n
    Same as EnableEncryption.

EnableEncryption=n
    Set the method of Data encryption.
        0 - Disable
        1 - Enable WEP Encryption
        2 - Enable WPA with TKIP encryption
        Default: 0

key_1=s
    Same as Key1.

Key1=s
    Specifies one of 4 possible keys for the Data encryption. One of these keys, identified by Transmit_Key_ID, is used for the enciphering of Data that is transmitted by this station. All keys specified can be used for the deciphering of Data that is received. The key value can be an ASCII character string or a hexadecimal value. The length of the key value can be 5 characters or 10 hexadecimal digits for the standard encryption (Silver or Gold card), or 13 characters or 26 hexadecimal digits for the encryption with extended keys (Gold card only). The keys defined in the station must match the keys defined in the access points; both on value and number (1 through 4). In 2.0 series Linux kernel modules, values that begin with a number are considered integers. In this case a hexadecimal value string or a character string starting with a number, will need to be surrounded by escaped double quotes (ie. key_1=\"0x1122334455\" key_2=\"12xyz\").
        5 or 13, printable character string, or
        10 or 26 hex digits if preceded by "0x".
        If this parameter is omitted, the default of the MAC is used ( = 0-length).

key_2=s
    Same as Key1.

Key2=s
    Same as Key1.

key_3=s
    Same as Key1

Key3=s
    Same as Key1.

key_4=s
    Same as Key1

Key4=s
    Same as Key1.

transmit_key_id=n
    Same as TxKey.

TxKey=n
    Designates which of the keys is to be used for the enciphering of data that is transmitted by this station.
        Integer in the range 1..4.
        Default: 1

multicast_rate=n
    Same as MulticastRate.

MulticastRate=n
    Sets the data rate for multicast message transmission.
        1 - Fixed 1Mb/s
        2 - Fixed 2Mb/s
        3 - Fixed 5.5Mb/s
        4 - Fixed 11Mb/s
        Default: 2

card_power_management=b
    Same as PMEnabled.

PMEnabled=b
    Sets the card's Power Management state.
        0 - Disable
        1 - Enable Enhanced Mode
        2 - Enabled Standard Mode
        Default: 0 (Disabled)

port_type=n
    Same as PortType.

PortType=n
    Selects the type of network operation.
        1 - Normal Operation (BSS or IBSS)
        3 - Ad-Hoc Demo Mode
        Default: 1

create_ibss=s
    Same as CreateIBSS.

CreateIBSS=s
    Enable or disable IBSS Creation. For correct operation, specification of a network_name is required. This mode requires firmware 6.04 or higher.
        N - Disable
        Y - Enable
        Default: N

receive_all_multicasts=s
    Same as MulticastReceive.

MulticastReceive=s
    Enable or disable receiving of all multicast packets when Card Power Management is enabled. When enabled, the station will wake up frequently to receive the multicast frames. This causes less optimal power savings.
        N - Disable
        Y - Enable
        Default: Y

maximum_sleep_duration=n
    Same as MaxSleepDuration.

MaxSleepDuration=n
    Set the maximum Power Management sleep duration in milliseconds. Valid values are 0 to 65535 milliseconds.
        Default: 100

authentication=n
    Same as Authentication.

Authentication=n
    Algorithm used for Authentication.
        1 - Open System
        2 - Shared Key
        Default: 1

atim_window=n
    Same as OwnATIMWindow.

OwnATIMWindow=n
    ATIM window time used for creating an IBSS.
        Range: 0..100
        Default: 0

holdover_duration=n
    Same as PMHoldoverDuration.

PMHoldoverDuration=n
    Time that the station remains in an awake state after a MAC frame transfer if Enhanced Power Save is active.
        Range: 1..1000
        Default: 100

promiscuous_mode=s
    Same as PromiscuousMode.

PromiscuousMode=s
    Switch for promiscuous mode reception.
        Default: N

download_firmware=n
    Same as DownloadFirmware.

DownloadFirmware=n
    This release of the driver introduces the ability to perform downloads of the STA/AP firmware. In fact, this is required for Hermes-II based cards. This parameter tells the driver which version of the firmware to download to the card.
        0 - No download performed (Hermes-I only)
        1 - Download STA firmware
        2 - Download AP firmware
        Default: 1, when STA mode functionality is
                    included in the build
                 2, when code is built exclusively for
                    AP mode

dtim_period=n
    Same as OwnDTIMPeriod.

OwnDTIMPeriod=n
    The number of beacon intervals between successive Delivery Traffic Identification Maps (DTIMs).
        Range: 1..65535
        Default: 1

closed_system=s
    Same as RejectANY.

RejectANY=s
    Controls how stations associate to the device.
        Y - Stations must provide the correct SSID to
             associate to the AP.
        N - Stations are not required to provide the
             correct SSID to associate to the AP.
             Known as an 'open' network.
        Default - N

deny_nonencrypted=s
    Same as ExcludeUnencrypted.

ExcludeUnencrypted=s
    Controls how the stations must communicate with the AP.
        Y - Stations must enable encryption and provide
             the proper encryption key to communicate
             with the AP.
        N - Stations do not need to enable encryption
             to communicate with the AP.
        Default: N

multicast_pm_buffering=s
    Same as MulticastPMBuffering.

MulticastPMBuffering=s
    Controls buffering of multicast MAC frames for transmission after DTIM. If no, multicast MAC frames are directly placed in the output queue.
        Default: Y

intra_bss_relay=s
    Same as IntraBSSRelay.

IntraBSSRelay=s
    Controls the automatic relay of received messages that are destined for other stations in the BSS.
        Y - Messages are relayed to the appropriate
             station(s).
        N - Messages are passed up to the host.
        Default: Y

rts_threshold_1=n
    Same as RTSThreshold1.

RTSThreshold1=n
    Controls the RTS/CTS handshake threshold for transmissions via port 1. Valid values are 0 to 2347.
        500 - Hidden Stations
        2347 - No RTS/CTS
        Default: 2347

rts_threshold_2=n
    Same as RTSThreshold1, only for port 2.

RTSThreshold2=n
    Same as RTSThreshold1, only for port 2.

rts_threshold_3=n
    Same as RTSThreshold1, only for port 3.

RTSThreshold3=n
    Same as RTSThreshold1, only for port 3.

rts_threshold_4=n
    Same as RTSThreshold1, only for port 4.

RTSThreshold4=n
    Same as RTSThreshold1, only for port 4.

rts_threshold_5=n
    Same as RTSThreshold1, only for port 5.

RTSThreshold5=n
    Same as RTSThreshold1, only for port 5.

rts_threshold_6=n
    Same as RTSThreshold1, only for port 6.

RTSThreshold6=n
    Same as RTSThreshold1, only for port 6.

tx_rate_control_1=n
    Same as TxRateControl1.

TxRateControl1=n
    Sets the data rate to be used by the transmitter for port 1.
        1 - Fixed Low
        2 - Fixed Standard
        3 - Auto Rate Select (High)
        4 - Fixed Medium
        5 - Fixed High
        6 - Auto Rate Select (Standard)
        7 - Auto Rate Select (Medium)
        Default: 3

tx_rate_control_2=n
    Same as TxRateControl1, only for port 2.

TxRateControl2=n
    Same as TxRateControl1, only for port 2.

tx_rate_control_3=n
    Same as TxRateControl1, only for port 3.

TxRateControl3=n
    Same as TxRateControl1, only for port 3.

tx_rate_control_4=n
    Same as TxRateControl1, only for port 4.

TxRateControl4=n
    Same as TxRateControl1, only for port 4.

tx_rate_control_5=n
    Same as TxRateControl1, only for port 5.

TxRateControl5=n
    Same as TxRateControl1, only for port 5.

tx_rate_control_6=n
    Same as TxRateControl1, only for port 6.

TxRateControl6=n
    Same as TxRateControl1, only for port 6.

wds_address_1=n,n,n,n,n,n
    Same as WDSAddress1.

WDSAddress1=n,n,n,n,n,n
    MAC address that identifies the corresponding node of WDS port 1. Note that for WDS to work properly, a bridge interface must be setup between the device and the wds network devices created by the driver. For more information on bridge interfaces, please refer to the man page for 'brctl'.
        Default: 00:00:00:00:00:00

wds_address_2=n,n,n,n,n,n
    Same as WDSAddress1, only for port 2.

WDSAddress2=n,n,n,n,n,n
    Same as WDSAddress1, only for port 2.

wds_address_3=n,n,n,n,n,n
    Same as WDSAddress1, only for port 3.

WDSAddress3=n,n,n,n,n,n
    Same as WDSAddress1, only for port 3.

wds_address_4=n,n,n,n,n,n
    Same as WDSAddress1, only for port 4.

WDSAddress4=n,n,n,n,n,n
    Same as WDSAddress1, only for port 4.

wds_address_5=n,n,n,n,n,n
    Same as WDSAddress1, only for port 5.

WDSAddress5=n,n,n,n,n,n
    Same as WDSAddress1, only for port 5.

wds_address_6=n,n,n,n,n,n
    Same as WDSAddress1, only for port 6

WDSAddress6=n,n,n,n,n,n
    Same as WDSAddress1, only for port 6.

SECURITY
On a multi-user system only the system administrator needs access to the WEP encryption keys. In this case, consider removing the read permission for normal users of the PCMCIA config.opts file, the system log file, and any Agere proprietary iwconfig-eth<n> scripts.

CONTACT
If you encounter problems when installing or using this product, or would like information about our other "Wireless" products, please contact your local Authorized "Wireless" Reseller or Agere Systems sales office.

Addresses and telephone numbers of the Agere Systems sales offices are listed on our Agere Systems web site.

WWW http://www.agere.com

SEE ALSO
cardmgr(8), pcmcia(5), ifconfig(8), insmod(8), brctl(8).