Usage: wlctl [-a|i ] [-h] [-d|u|x] [arguments]
-h this message
-a, -i adapter name or number
-d signed integer
-u unsigned integer
-x hexdecimal
ver get version information
cmds generate a short list of available commands
up reinitialize and mark adapter up (operational)
down reset and mark adapter down (disabled)
out mark adapter down but do not reset hardware(disabled)
On dualband cards, cards must be bandlocked before use.
clk set board clock state. return error for set_clk attempt if the driver is not down
0: clock off
1: clock on
restart Restart driver. Driver must already be down.
reboot Reboot platform
ucflags Get/Set ucode flags
radio Set the radio on or off.
“on” or “off”
dump print driver software state and chip registers to stdout
srdump print contents of SPROM to stdout
nvdump print nvram variables to stdout
nvset set an nvram variable
name=value (no spaces around ‘=’)
nvget get the value of an nvram variable
revinfo get hardware revision information
msglevel
set driver console debugging message bitvector
type ‘wl msglevel ?’ for values
PM set driver power management mode:
0: CAM (constantly awake)
1: PS (power-save)
2: FAST PS mode
wake set driver power-save mode sleep state:
0: core-managed
1: awake
promisc set promiscuous mode ethernet address reception
0 – disable
1 – enable
monitor set monitor mode
0 – disable
1 – enable active monitor mode (interface still operates)
frag Deprecated. Use fragthresh.
rts Deprecated. Use rtsthresh.
cwmin Set the cwmin. (integer [1, 255])
cwmax Set the cwmax. (integer [256, 2047])
srl Set the short retry limit. (integer [1, 255])
lrl Set the long retry limit. (integer [1, 255])
rate force a fixed rate:
valid values for 802.11a are (6, 9, 12, 18, 24, 36, 48, 54)
valid values for 802.11b are (1, 2, 5.5, 11)
valid values for 802.11g are (1, 2, 5.5, 6, 9, 11, 12, 18, 24, 36, 48, 54)
-1 (default) means automatically determine the best rate
mrate force a fixed multicast rate:
valid values for 802.11a are (6, 9, 12, 18, 24, 36, 48, 54)
valid values for 802.11b are (1, 2, 5.5, 11)
valid values for 802.11g are (1, 2, 5.5, 6, 9, 11, 12, 18, 24, 36, 48, 54)
-1 (default) means automatically determine the best rate
a_rate force a fixed rate for the A PHY:
valid values for 802.11a are (6, 9, 12, 18, 24, 36, 48, 54)
-1 (default) means automatically determine the best rate
a_mrate force a fixed multicast rate for the A PHY:
valid values for 802.11a are (6, 9, 12, 18, 24, 36, 48, 54)
-1 (default) means automatically determine the best rate
bg_rate force a fixed rate for the B/G PHY:
valid values for 802.11b are (1, 2, 5.5, 11)
valid values for 802.11g are (1, 2, 5.5, 6, 9, 11, 12, 18, 24, 36, 48, 54)
-1 (default) means automatically determine the best rate
bg_mrate
force a fixed multicast rate for the B/G PHY:
valid values for 802.11b are (1, 2, 5.5, 11)
valid values for 802.11g are (1, 2, 5.5, 6, 9, 11, 12, 18, 24, 36, 48, 54)
-1 (default) means automatically determine the best rate
infra Set Infrastructure mode: 0 (IBSS) or 1 (Infra BSS)
ap Set AP mode: 0 (STA) or 1 (AP)
bssid Get the BSSID value, error if STA and not associated
channel Set the channel:
valid channels for 802.11b/g (2.4GHz band) are 1 through 14
valid channels for 802.11a (5 GHz band) are:
36, 40, 44, 48, 52, 56, 60, 64,
100, 104, 108, 112, 116,120, 124, 128, 132, 136, 140,
149, 153, 157, 161,
184, 188, 192, 196, 200, 204, 208, 212, 216
tssi Get the tssi value from radio
txpwr Set tx power in milliwatts. Range [1, 84].
txpwr1 Set tx power in in various units. Choose one of (default: dbm):
-d dbm units
-q quarter dbm units
-m milliwatt units
Can be combined with:
-o turn on override to disable regulatory and other limitations
Use wl txpwr -1 to restore defaults
txpathpwr
Turn the tx path power on or off on 2050 radios
txpwrlimit
Return current tx power limit
powerindex
Set the transmit power for A band(0-63).
-1 – default value
atten Set the transmit attenuation for B band. Args: bb radio txctl1.
auto to revert to automatic control
phyreg Get/Set a phy register:
offset [ value ] [ band ]
radioreg
Get/Set a radio register:
offset [ value ] [ band ]
shmem Get/Set a shared memory location:
offset [ value ] [ band ]
macreg Get/Set any mac registers(include IHR and SB):
macreg offset size[2,4] [value] [ band ]
ucantdiv
Enable/disable ucode antenna diversity (1/0 or on/off)
antdiv Set antenna diversity for rx
0 – force use of antenna 0
1 – force use of antenna 1
3 – automatic selection of antenna diversity
txant Set the transmit antenna
0 – force use of antenna 0
1 – force use of antenna 1
3 – use the RX antenna selection that was in force during
the most recently received good PLCP header
plcphdr Set the plcp header.
“long” or “auto” or “debug”
phytype Get phy type
scbdump print driver scb state to stdout
rateparam
set driver rate selection tunables
arg 1: tunable id
arg 2: tunable value
wepstatus
Set or Get WEP status
wepstatus [on|off]
primary_key
Set or get index of primary key
addwep Set an encryption key. The key must be 5, 13 or 16 bytes long, or
10, 26, 32, or 64 hex digits long. The encryption algorithm is
automatically selected based on the key size. keytype is accepted
only when key length is 16 bytes/32 hex digits and specifies
whether AES-OCB or AES-CCM encryption is used. Default is ccm.
addwep [ocb | ccm] [notx] [xx:xx:xx:xx:xx:xx]
rmwep Remove the encryption key at the specified key index.
keys Prints a list of the current WEP keys
tsc Print Tx Sequence Couter for key at specified key index.
wsec_test
Generate wsec errors
wsec_test
type ‘wl wsec_test ?’ for test_types
tkip_countermeasures
Enable or disable TKIP countermeasures (TKIP-enabled AP only)
0 – disable
1 – enable
wsec_restrict
Drop unencrypted packets if WSEC is enabled
0 – disable
1 – enable
eap restrict traffic to 802.1X packets until 802.1X authorization succeeds
0 – disable
1 – enable
authorize
restrict traffic to 802.1X packets until 802.1X authorization succeeds
deauthorize
do not restrict traffic to 802.1X packets until 802.1X authorization succeeds
deauthenticate
deauthenticate a STA from the AP with optional reason code (AP ONLY)
wsec wireless security bit vector
1 – WEP enabled
2 – TKIP enabled
4 – AES enabled
8 – WSEC in software
auth set/get 802.11 authentication type. 0 = OpenSystem, 1= SharedKey
wpa_auth
Bitvector of WPA authorization modes:
1 WPA-NONE
2 WPA-802.1X/WPA-Professional
4 WPA-PSK/WPA-Personal
64 WPA2-802.1X/WPA2-Professional
128 WPA2-PSK/WPA2-Personal
0 disable WPA
wpa_cap set/get 802.11i RSN capabilities
set_pmk Set passphrase for PMK in driver-resident supplicant.
scan Initiate a scan.
Default an active scan across all channels for any SSID.
Optional arg: SSID, the SSID to scan.
Options:
-s S, –ssid=S SSID to scan
-t ST, –scan_type=ST [active|passive] scan type
–bss_type=BT [bss/infra|ibss/adhoc] bss type to scan
-b MAC, –bssid=MAC particular BSSID MAC address to scan, xx:xx:xx:xx:xx:xx
-n N, –nprobes=N number of probes per scanned channel
-a N, –active=N dwell time per channel for active scanning
-p N, –passive=N dwell time per channel for passive scanning
-h N, –home=N dwell time for the home channel between channel scans
-c L, –channels=L comma or space separated list of channels to scan
passive Puts scan engine into passive mode
regulatory
Get/Set regulatory domain mode (802.11d). Driver must be down.
spect Get/Set 802.11h Spectrum Management mode.
0 – Off
1 – Loose interpretation of spec – may join non-11h APs
2 – Strict interpretation of spec – may not join non-11h APs 3
Disable 11H and enable 11D
scanresults
Return results from last scan.
assoc Print information about current network association.
(also known as “status”)
status Print information about current network association.
(also known as “assoc”)
disassoc
Disassociate from the current BSS/IBSS.
chanlist
Deprecated. Use channels.
channels
Return valid channels for the current settings.
channels_in_country
Return valid channels for the country specified.
Arg 1 is the country abbreviation
Arg 2 is the band(a or b)
curpower
Return current tx power settings.
-q (quiet): estimated power only.
scansuppress
Suppress all scans for testing.
0 – allow scans
1 – suppress scans
evm Start an EVM test on the given channel, or stop EVM test.
Arg 1 is channel number 1-14, or “off” or 0 to stop the test.
Arg 2 is optional rate (1, 2, 5.5 or 11)
rateset Returns or sets the supported and basic rateset, (b) indicates basic
With no args, returns the rateset. Args are
rateset “default” | “all” |
default – driver defaults
all – all rates are basic rates
arbitrary rateset – list of rates
List of rates are in Mbps and each rate is optionally followed
by “(b)” or “b” for a Basic rate. Example: 1(b) 2b 5.5 11
At least one rate must be Basic for a legal rateset.
roam_trigger
Set the roam trigger RSSI threshold: roam_trigger [integer [, a/b]]
roam_delta
Set the roam candidate qualification delta. roam_delta [integer [, a/b]]
roam_scan_period
Set the roam candidate qualification delta. (integer)
suprates
Returns or sets the 11g override for the supported rateset
With no args, returns the rateset. Args are a list of rates,
or 0 or -1 to specify an empty rateset to clear the override.
List of rates are in Mbps, example: 1 2 5.5 11
scan_channel_time
Get/Set scan channel time
scan_unassoc_time
Get/Set unassociated scan channel dwell time
scan_home_time
Get/Set scan home channel dwell time
scan_passive_time
Get/Set passive scan channel dwell time
scan_nprobes
Get/Set scan parameter for number of probes to use per channel scanned
prb_resp_timeout
Get/Set probe response timeout
channel_qa
Get last channel quality measurment
channel_qa_start
Start a channel quality measurment
country Select Country code for use with 802.11d
Use either long name or abbreviation from ISO 3166.
Use ‘wl country list [band(a or b)]’ for the list of supported countries
locale OBSOLETE: use “wl country”
Select the country:
Worldwide
Thailand
Israel
Jordan
China
Japan
USA/Canada/ANZ
Europe
USAlow
JapanHigh
All
join Join a specified network SSID.
Join syntax is:
join [key xxxxx] [imode bss|ibss] [amode open|shared|wpa|wpapsk|wpa2|wpa2psk|wpanone]
ssid Set or get a configuration’s SSID.
wl ssid [-C num]|[–cfg=num] []
If the configuration index ‘num’ is not given, configuraion #0 is assumed and
setting will initiate an assoication attempt if in infrastructure mode,
or join/creation of an IBSS if in IBSS mode,
or creation of a BSS if in AP mode.
mac Set or get the list of source MAC address matches.
wl mac xx:xx:xx:xx:xx:xx [xx:xx:xx:xx:xx:xx …]
To Clear the list: wl mac none
macmode Set the mode of the MAC list.
0 – Disable MAC address matching.
1 – Deny association to stations on the MAC list.
2 – Allow association to stations on the MAC list.
wds Set or get the list of WDS member MAC addresses.
Set using a space separated list of MAC addresses.
wl wds xx:xx:xx:xx:xx:xx [xx:xx:xx:xx:xx:xx …]
lazywds Set or get “lazy” WDS mode (dynamically grant WDS membership to anyone).
noise Get noise (moving average) right after tx in dBm
fqacurcy
Manufacturing test: set frequency accuracy mode.
freqacuracy syntax is: fqacurcy
Arg is channel number 1-14, or 0 to stop the test.
crsuprs Manufacturing test: set carrier suppression mode.
carriersuprs syntax is: crsuprs
Arg is channel number 1-14, or 0 to stop the test.
longtrain
Manufacturing test: set longtraining mode.
longtrain syntax is: longtrain
Arg is A band channel number or 0 to stop the test.
band Returns or sets the current band
auto – auto switch between available bands (default)
a – force use of 802.11a band
b – force use of 802.11b band
bands Return the list of available 802.11 bands
phylist Return the list of available phytypes
shortslot
Get current 11g Short Slot Timing mode. (0=long, 1=short)
shortslot_override
Get/Set 11g Short Slot Timing mode override. (-1=auto, 0=long, 1=short)
shortslot_restrict
Get/Set AP Restriction on associations for 11g Short Slot Timing capable STAs.
0 – Do not restrict association based on ShortSlot capability
1 – Restrict association to STAs with ShortSlot capability
ignore_bcns
AP only (G mode):
Check for beacons without NONERP element (0=Examine beacons, 1=Ignore beacons)
pktcnt Get the summary of good and bad packets.
upgrade Upgrade the firmware on an embedded device
gmode Set the 54g Mode (LegacyB|Auto||GOnly|BDeferred|Performance|LRS)
gmode_protection
Get G protection mode. (0=disabled, 1=enabled)
gmode_protection_control
Get/Set 11g protection mode control alg.
0=always off
1=monitor local association
2=monitor overlapping BSS
gmode_protection_cts
Get/Set 11g protection type to CTS (0=disable, 1=enable)
gmode_protection_override
Get/Set 11g protection mode override. (-1=auto, 0=disable, 1=enable)
legacy_erp
Get/Set 11g legacy ERP inclusion (0=disable, 1=enable)
scb_timeout
AP only: inactivity timeout value for authenticated stas
assoclist
AP only: Get the list of associated MAC addresses.
rssi Get the current RSSI val, for an AP you must specify the mac addr of the STA
isup Get driver operational state (0=down, 1=up)
fasttimer
Deprecated. Use fast_timer.
slowtimer
Deprecated. Use slow_timer.
glacialtimer
Deprecated. Use glacial_timer.
radar Enable/Disable radar
radarargs
Get/Set Radar parameters in
order as npulses, ncontig, min_pw , max_pw, thresh0, thresh1
dfs_status
Get dfs status
interference
Get/Set interference mitigation mode. Choices are:
0 = none
1 = non wlan
2 = wlan manual
3 = wlan automatic
frameburst
Disable/Enable frameburst mode
pwr_percent
Get/Set power output percentage
wet Get/Set wireless ethernet bridging mode
bi Get/Set the beacon period (bi=beacon interval)
dtim Get/Set DTIM
wds_remote_mac
Get WDS link remote endpoint’s MAC address
wds_wpa_role_old
Get WDS link local endpoint’s WPA role (old)
wds_wpa_role
Get/Set WDS link local endpoint’s WPA role
authe_sta_list
Get authenticated sta mac address list
autho_sta_list
Get authorized sta mac address list
measure_req
Send an 802.11h measurement request.
Usage: wl measure_req
Measurement types are: TPC, Basic, CCA, RPI
Target MAC addr format is xx:xx:xx:xx:xx:xx
quiet Send an 802.11h quiet command.
Usage: wl quiet , ,
csa Send an 802.11h channel switch anouncement
Usage wl csa
constraint
Send an 802.11h Power Constraint IE
Usage: wl constraint 1-255 db
rm_req Request a radio measurement of type basic, cca, or rpi
specify a series of measurement types each followed by options.
example: wl rm_req cca -c 1 -d 50 cca -c 6 cca -c 11
Options:
-t n numeric token id for measurement set or measurement
-c n channel
-d n duration in TUs (1024 us)
-p parallel flag, measurement starts at the same time as previous
Each measurement specified uses the same channel and duration as the
previous unless a new channel or duration is specified.
rm_rep Get current radio measurement report
join_pref
Set/Get join target preferences.
assoc_pref
Set/Get association preference.
Usage: wl assoc_pref [auto|a|b|g]
wme Set WME (Wireless Multimedia Extensions) mode (0=off, 1=on, -1=auto)
wme_ac wl wme_ac sta/ap [be, bk, vi, vo] [ecwmax, ecwmin, txop, aifsn, acm] value
wme_apsd
Set APSD (Automatic Power Save Delivery) mode on AP (0=off, 1=on)
wme_apsd_sta
Set APSD parameters on STA. Driver must be down.
Usage: wl wme_apsd_sta
: number of frames per USP: 0 (all), 2, 4, or 6
: value 0 to disable, 1 to enable U-APSD per AC
wme_dp Set AC queue discard policy.
Usage: wl wme_dp
: value 0 for newest-first, 1 for oldest-first
wme_counters
print WMM stats
reinit Reinitialize device
sta_info
wl sta_info
cap driver capabilities
malloc_dump
debug malloc info
chan_info
channel info
add_ie Add a vendor proprietary IE to 802.11 management packets
Usage: wl add_ie length OUI hexdata
: Bit 0 – Beacons
Bit 1 – Probe Rsp
Bit 2 – Assoc/Reassoc Rsp
Bit 3 – Auth Rsp
Example: wl add_ie 3 10 00:90:4C 0101050c121a03
to add this IE to beacons and probe responses
del_ie Delete a vendor proprietary IE from 802.11 management packets
Usage: wl del_ie length OUI hexdata
: Bit 0 – Beacons
Bit 1 – Probe Rsp
Bit 2 – Assoc/Reassoc Rsp
Bit 3 – Auth Rsp
Example: wl del_ie 3 10 00:90:4C 0101050c121a03
list_ie Dump the list of vendor proprietary IEs
rand Get a 2-byte Random Number from the MAC’s PRNG
Usage: wl rand
nvotpw Write nvram to on-chip otp
Usage: wl nvotpw file
bcmerrorstr
errorstring
freqtrack
Set Frequency Tracking Mode (0=Auto, 1=On, 2=OFF)
eventing
set/get 128-bit hex filter bitmask for MAC event reporting up to application layer
event_msgs
set/get 128-bit hex filter bitmask for MAC event reporting via packet indications
counters
Return driver counter values
assoc_info
Returns the assoc req and resp information [STA only]
autochannel
auto channel selection:
1 to issue a channel scanning;
2 to set channel based on the channel scanning result;
without argument to only show the channel selected;
ssid must set to null before this process, RF must be up
closed hides the network from active scans, 0 or 1.
0 is open, 1 is hide
pmkid_info
Returns the pmkid table
abminrate
get/set afterburner minimum rate threshold
bss set/get BSS enabled status: up/down
closednet
set/get BSS closed network attribute
diag diag testindex(1-interrupt, 2-loopback, 3-memory, 4-led);
precede by ‘wl down’ and follow by ‘wl up’
reset_d11cnts
reset 802.11 MIB counters
8021x Set or get 802.1x in use.
0 – disable
1 – enable
idle_timeout
Set or get the session idle timeout in seconds.
auth_blockout_time
Set or get the barring time (seconds) for log in retry is accepted.
auth_blockout_list
Get the list of authentication block out MAC addresses.
corerev Get current core revision
close hides the network from active scans, 0 or 1.
0 is open, 1 is hide
beacon Set the beacon interval:
valid beacon interval are 1-65535
essid Set the SSID ID value
pwr_percent1
Get/Set power output percentage