Skip to Content

WIF Command — WiFi Connection Status

Query the device’s WiFi connection status.


What is it for?

📶 Main use cases:

  • 📊 Verify WiFi connection status
  • 📡 Know the currently connected network
  • 📈 Measure signal strength and quality
  • 🔧 Diagnose connectivity issues
  • 🔍 WiFi infrastructure monitoring

Commands

OperationSyntax
QueryQWIF
ResponseRWIF,pwr,apmode,stationindex,ssid,rssi,signallevel

Response Fields

FieldDescriptionValues
pwrWiFi status0 = Inactive, 1 = Active
apmodeOperation mode0 = Client (STA), 1 = Access Point (AP)
stationindexStation index0-9
ssidNetwork nameText
rssiSignal strengthValue in dBm (negative)
signallevelQuality level0-4

Signal Levels

LevelQualityTypical RSSIIcon
4Excellent> -50 dBm📶
3Good-50 to -60 dBm📶
2Average-60 to -70 dBm📶
1Weak-70 to -80 dBm📶
0No connection< -80 dBm

Example

WiFi status query

>QWIF< >RWIF,1,0,0,VERA AP 4,-74,1< // │ │ │ │ │ └─ Signal level: 1 (weak) // │ │ │ │ └─ RSSI: -74 dBm // │ │ │ └─ Connected network: "VERA AP 4" // │ │ └─ Station index: 0 // │ └─ Mode: 0 (client/Station) // └─ WiFi: 1 (active)

An RSSI of -74 dBm indicates weak signal. Consider moving the device closer to the router or using a WiFi repeater.


QWIFN — Scan the visible networks

Since firmware v1.09.26, >QWIFN< scans and lists the WiFi networks the device sees from its position, sorted by signal. It is the tool for diagnosing installations remotely: it answers at a glance whether the customer’s network exists, how much signal reaches the device, and whether the configured SSID is in sight.

>QWIFN< >RWIFN,*MiRed,-52,6;Vecino,-71,11;(hidden),-80,1<
  • Lists up to 5 networks, from strongest to weakest signal, in ssid,rssi,canal format separated by ;
  • The leading * marks the networks that match an SSID configured on the device — if none carries a *, “your network is not in sight” reads straight off
  • Hidden networks appear as (hidden); repeated SSIDs (mesh) are shown only once with their best signal
ResponseMeaning
RWIFN,OFFThe device’s WiFi is off
RWIFN,NONEScan succeeded, no network visible
RWIFN,ERRThe scan failed (retry)

The scan is active and blocks the channel that asked for between 1 and 4 seconds. Typical case it uncovers: a configured SSID that does not appear in the list even though the router is right there is usually a 5 GHz network — the device only sees 2.4 GHz.


Compatibility

💾Firmware:v1.00.00
💾Firmware v1.00.00
SP-IOT
SM-IOT
QWIFN scan since v1.09.26

See Also

Last updated