WiFiStatus plugin

Plugin=WiFiStatus can be used to display various attributes of visible wireless networks in your area.

Options

General measure options
All general measure options are valid.
WiFiInfoType

This defines what is measured. This option is required. Valid values are:

  • SSID: The broadcast name for your current connection. When trying to connect, you may see a 'connecting...' or 'authorizing...' next to the name, but only if your update speed is around 2 seconds.
  • Quality: Percentage value of the maximum dBm signal strength for your current connection.
  • Encryption: The cipher algorithm being used for your current connection. Possible values are: NONE, WEP40, TKIP, AES, WEP104, WPA_GROUP, and WEP. An unknown algorithm will return ???.
  • AUTH: The authentication algorithm being used for your current connection. Possible values are: Open, Shared, WPA-NONE, WPA-Enterprise, WPA-Personal, WPA2-Enterprise, and WPA2-Personal. An unknown algorithm will return ???.
  • PHY: The supported bands for your connection (not your adapter). Possible values are 802.11a, 802.11ac, 802.11b, 802.11g, 802.11n, DSSS, FHSSS, and IR-Band. An unknown band will return ???.
  • List: Returns a list of all visible networks. The list is automatically separated by line-breaks \n, so each network appears on a separate line. It will also display the PHY, Encryption, and AUTH algorithms next the the network SSID.
WiFiIntfID Default: 0
Only use this if you have more than 1 wireless interface adapter (which may include any bluetooth or infrared receivers). If you do not get any response from the measure with this value at 0, then try other values starting from 1, then 2 and so on.
WiFiListStyle Default: 0

This allows you to control what information appears along with the names of all visible networks when WiFiInfoType=List. Valid values are:

  • 0: SSID.
  • 1: SSID @band.
  • 2: SSID (Encryption:Authentication).
  • 3: SSID @band (Encryption:Authentication).
WiFiListLimit Default: 5

Allows you to control the number of networks that are will be displayed when used with WiFiInfoType=List.

Note: The list is sorted in descending order based on the signal quality of each network (i.e. strongest first, weakest last).

Example

[MeasureSSID]
Measure=Plugin
Plugin=WiFiStatus
WiFiInfoType=SSID
WiFiIntfID=0
[MeasureNetworks]
Measure=Plugin
Plugin=WiFiStatus
WiFiInfoType=LIST
WiFiIntfID=0
WiFiListStyle=3