WL127x ini File Description and Parameters User's Guide

The *.ini file, configures driver behavior and is loaded upon driver initialization, in order to customize its behavior to best meet customer needs.
Parameters in the *.ini file may be changed by editing the *.ini file entries using a text editor.
Parameter changes take effect during the following driver load.

Introduction

The *.ini file configures driver behavior and is loaded upon driver initialization, in order to customize its behavior to best meet customer needs.

Parameters in the *.ini file may be changed by editing the *.ini file entries using a text editor. Parameter changes take effect during the following driver load.

The *.ini file is located under the /WiLink/platforms/ps/linux directory.

Synopsis

Each *.ini line item adheres to the following convention: Param = Value

Ini File Parameters

Unless otherwise noted, parameters are referenced to the Front End Module’s (FEM’s) single-ended RFANT port (without the band pass filter at the FEM output).

Short Description

Table 1: Ini File Parameters

Parameter	Description
SmeConnectMode	Connection scan initiator
WME_Enable	QoS support
dot11NetworkType	802.11 mode
SmeScanGChannelList	Channel list to be scanned when working in G band
SmeScanAChannelList	Channel list to be scanned when working in A band
BeaconListenInterval	Number of N-beacons to wake up
DtimListenInterval	Number of N-DTIMs to wake up
dot11PowerMode	Default Power mode profile of the station
PowerMgmtHangOverPeriod	Station awake time after sending a frame to the AP
AutoPowerModeDozeMode	Default Doze mode
AutoPowerModeActiveTh	Number of frames per second for moving from Doze mode to Active mode
AutoPowerModeDozeTh	Number of frames per seconds for moving from Active mode to Doze mode
defaultPowerLevel	Default power level when station not connected
PowerSavePowerLevel	Default power level when station connected
TxPower	Default transmission power
dot11FragmentationThreshold	Minimum frame size for fragmentation
dot11RTSThreshold	Frame size to send Request To Send frame
WPAMixedMode	WPA and the WPA2 support
RSNPreAuthentication	Preauthentication support
AllowedChannelsTable24	Allowed channels in 2.4 GHz radio band
AllowedChannelsTable5	Allowed channels in in 5.0 GHz radio band
SpectrumManagement	802.11h standard support
RxBroadcastInPs	Reception of broadcast frames while in PS support
RatePolicyUserShortRetryLimit	Number of transmission retries for short frames
RatePolicyUserLongRetryLimit	Number of transmission retries for long frames
BeaconReceiveTime	Time to wait for the beacon
desiredPsMode	Global power-save delivery protocol support
QOS_wmePsModeBE	Power-save delivery protocol for Best Effort access
QOS_wmePsModeBK	Power-save delivery protocol for Background access
QOS_wmePsModeVI	Power-save delivery protocol for Video access
QOS_wmePsModeVO	Power-save delivery protocol for Voice access
Clsfr_Type	Packet classification type
NumOfDstIPPortClassifiers	Number of classifiers
IPPortClassifier00_IPAddress	IP address and IP port for mapping to user priority
IPPortClassifier00_Port	IP port for mapping to user priority
IPPortClassifier00_DTag	IP port classifier for mapping to user priority
NumOfCodePoints	Number of classifiers
DSCPClassifier00_CodePoint	Code point for mapping to user priority
DSCPClassifier00_DTag	Classifier for mapping to user priority
STRdot11MaxReceiveLifetime	Time to maintain a frame fragment before dropping it

Detailed Description

SmeConnectMode

If set to AUTO, the driver initiates a SCAN automatically, based on the configuration, and selects an appropriate BSSID. If set to MANUAL, the driver does not initiate a SCAN operation and does not select a BSSID. Instead, the application initiates the scan.

Values: 0: AUTO

1: Manual

Default: 1

WME_Enable

This parameter defines whether or not quality of service is supported.

Values: 0: Disabled

1: Enabled

Default: 1

dot11NetworkType

This parameter defines the 802.11 mode.

Values: 1: B mode

2: A mode

3: G mode

4: A/G Dual mode

Default: 3

SmeScanGChannelList

This parameter provides the list of channels to be scanned when working in G band.

Values: List of channels in G band, from 1 to 14

Default: 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14

SmeScanAChannelList

This parameter provides the list of channels to be scanned when working in A band.

Values: List of channels in A band, from 36 to 64

Default: 36, 40, 44, 48, 52, 56, 60, 64

BeaconListenInterval

This parameter defines the number of N-beacons to wake up. It is used when working in Short Doze mode.

Values: 1 - 50

Default: 1

DtimListenInterval

This parameter defines the number of N-DTIMs to wake up. It is used when working in Long Doze mode.

Values: 1 - 50

Default: 1

dot11PowerMode

This parameter defines the default Power mode profile of the station.

Values: 0: Auto. The Power mode toggles between Active mode and the defined Doze mode.

1: Always active.

2: Short doze.

3: Long doze.

Default: 0

PowerMgmtHangOverPeriod

This parameter defines the time, in milliseconds, during which the station will remain awake after sending a frame to the AP, indicating that the station is going into Power Save.

Values: 5 - 255

Default: 10

AutoPowerModeDozeMode

This parameter defines the default Doze mode (short or long) that Auto mode uses when toggling between doze and active.

Values: 2: Short doze

3: Long doze

Default: 2

AutoPowerModeActiveTh

This parameter specifies the number of frames per seconds for moving from Doze mode to Active mode, if Power mode is set to Auto.

Values: 2 - 30,000

Default: 15

AutoPowerModeDozeTh

This parameter specifies the number of frames per seconds for moving from Active mode to Doze mode, if Power mode is set to Auto.

Values: 1 - 30,000

Default: 8

defaultPowerLevel

This parameter specifies the default power level to be used when the station is not connected.

Values: 0: ELP

1: Power down

2: Awake

Default: 0

PowerSavePowerLevel

This parameter specifies the default power level to be used when the station is connected.

Values: 0: ELP

1: Power down

2: Awake

Default: 0

TxPower

This parameter specifies the default transmission power, in dBm * 10.

Values: 0 - 250

Default: 205

dot11FragmentationThreshold

This parameter specifies the minimum frame size, in bytes, used for fragmentation.

Values: 256 - 4,096 (must be a multiple of 256)

Default: 4,096

dot11RTSThreshold

This parameter specifies the threshold of the frame size, in bytes, to send Request To Send frame.

Values: 0 - 4,096

Default: 4,096

WPAMixedMode

This parameter defines whether both the WPA and the WPA2 are supported.

Values: 0: Only the WPA is supported.

1: Both the WPA and WPA2 are supported.

Default: 1

RSNPreAuthentication

This parameter defines if Preauthentication is supported.

Values: 0: Not supported

1: Supported

Default: 1

AllowedChannelsTable24

When working in 2.4 GHz radio band, this parameter defines the following for each channel:

• Bit 7: Whether it is allowed to be scanned
• Bit 6: Whether it is allowed to be scanned in Active mode
• Bits 0-4: The maximum Tx power allowed when scanning

Each byte correlates to one channel in sequential order.

Values: 00-FF for each channel

Default: FFFFFFFFFFFFFFFFFFFFFFFFFFFF

AllowedChannelsTable5

When working in 5.0 GHz radio band, this parameter defines the following for each channel:

• Bit 7: Whether it is allowed to be scanned
• Bit 6: Whether it is allowed to be scanned in Active mode
• Bits 0-4: The maximum Tx power allowed when scanning

Each byte correlates to one channel in sequential order.

Values: 00-FF for each channel

Default: FF000000FF000000FF000000FF000000FF000000FF000000 FF000000FF00000000000000000000000000000000000000 00000000000000000000000000000000FF000000FF000000 FF000000FF000000FF000000FF000000FF000000FF000000 FF000000FF000000FF0000000000000000FF000000FF0000 00FF000000FF000000FF000000000000000000000000000000

SpectrumManagement

This parameter defines if the 802.11h standard is supported.

Values: 0: Not supported

1: Supported

Default: 0

RxBroadcastInPs

This parameter defines whether or not the reception of broadcast frames while in PS is enabled.

Values: 0: Disabled

1: Enabled

Default: 1

RatePolicyUserShortRetryLimit

This parameter specifies the number of transmission retries for short frames (less than or equal to dot11RTSThreshold).

Values: 1 - 255

Default: 10

RatePolicyUserLongRetryLimit

This parameter specifies the number of transmission retries for long frames (greater than dot11RTSThreshold).

Values: 1 - 255

Default: 10

BeaconReceiveTime

This parameter defines how much time, in milliseconds (msecs), to wait for the beacon, before going back into power save.

Values: 10 - 1,000 msecs

Default: 50 msecs

desiredPsMode

This parameter defines the global power-save delivery protocol.

Values: 0 – Standard PS: The station sends a PsPoll frame in order to retrieve the data buffered at the AP. As a result, the AP sends only one frame to the station.

1 – UPSD: The station sends a data frame in order to retrieve the data buffered at the AP. As a result, the AP sends data frames according to the service period indicated by the station.

Default: 1

QOS_wmePsModeBE

This parameter defines the power-save delivery protocol for the Best Effort access category.

Values: 0 - 1 (For exact values, refer to the desiredPsMode field.)

Default: 0

QOS_wmePsModeBK

This parameter defines the power-save delivery protocol for the Background access category.

Values: 0 - 1 (For exact values, refer to the desiredPsMode field.)

Default: 0

QOS_wmePsModeVI

This parameter defines the power-save delivery protocol for the Video access category.

Values: 0 - 1 (For exact values, refer to the desiredPsMode field.)

Default: 0

QOS_wmePsModeVO

This parameter defines the power-save delivery protocol for the Voice access category.

Values: 0 - 1 (For exact values, refer to the desiredPsMode field.)

Default: 1

Clsfr_Type

This parameter defines the packet classification type. The classified packet is mapped to one of the QoS user priorities and is transmitted over the WLAN using the corresponding access category.

Values: 0: Classification according to 802.1d tag

1: Classification according to Diffserv control service point

2: Classification according to IP port

3: Classification according to IP port and IP address

Default: 3

NumOfDstIPPortClassifiers

This parameter defines the number of classifiers when the classification type is based on the IP port and IP address.

Values: 0 - 16

Default: 0

IPPortClassifier00_IPAddress

Frames destined to this IP address and to the IP port defined in IPPortClassifier00_Port are mapped to the user priority defined in IPPortClassifier00_DTag and are transmitted over the WLAN using the corresponding access category.

Values: 0 0 0 0 – 0xFF 0xFF 0xFF 0xFF

Default: 0a 03 01 C9 (IP address 10.3.1.201)

IPPortClassifier00_Port

Refer to IPPortClassifier00_IPAddress for more information.

Values: 1 - 65,535

Default: 5,004

IPPortClassifier00_DTag

Refer to IPPortClassifier00_IPAddress for more information.

Values: 0 - 7

Default: 0 There are 16 IP address and IP port classifiers:

• IPPortClassifier00_IPAddress – IPPortClassifier15_IPAddress
• IPPortClassifier00_Port – IPPortClassifier15_Port
• IPPortClassifier00_DTag – IPPortClassifier15_DTag

NumOfCodePoints

This parameter defines the number of classifiers when the classification type is based on the Diffserv control service point.

Values: 0 - 16

Default: 0

DSCPClassifier00_CodePoint

Frames with this code point are mapped to the user priority defined in DSCPClassifier00_DTag and are transmitted over the WLAN using the corresponding access category.

Values: 0 - 63

Default: 0

DSCPClassifier00_DTag

Refer to DSCPClassifier00_CodePoint for more information.

Values: 0 - 7

Default: 0 There are 16 DSCP classifiers:

• DSCPClassifier00_CodePoint – DSCPClassifier00_CodePoint
• DSCPClassifier15_DTag – DSCPClassifier15_DTag

STRdot11MaxReceiveLifetime

This parameter specifies the maximum time to keep a fragment of a frame that was not reassembled yet, before deciding to drop it.

Values: 0 - 0xFFFFFFFF

Default: 512 msecs

HOME