WiFi Evaluation and Optimization

Overview of Evaluation

Introduction

This evaluation assesses the quality and performance of WiFi connections for clients connected to a CPE (Customer Premises Equipment) using TR-181 data. The assessment provides a comprehensive analysis based on six key factors that determine network performance and connectivity quality.

Evaluation Factors

The WiFi evaluation system analyzes the following six factors:

1. Signal Strength

Measures the strength of the WiFi signal received by client devices. A stronger signal generally indicates better connectivity and more reliable network performance.

2. Noise

Evaluates the level of background noise in the WiFi environment. Lower noise levels contribute to clearer signal transmission and improved overall performance.

3. Interference

Assesses the impact of other WiFi networks or devices operating on the same or adjacent channels. Lower interference levels lead to better performance and more stable connections.

4. SNR (Signal-to-Noise Ratio)

Represents the ratio between the desired signal level and background noise level. A higher SNR typically results in better WiFi performance and more reliable data transmission.

5. Standard

Considers the WiFi standard being used (e.g., 802.11n, 802.11ac, 802.11ax) and how it aligns with the capabilities of both the CPE and client devices. More advanced standards generally offer better performance and enhanced features.

6. Speed

Evaluates the actual data transfer rates achieved by client devices compared to the theoretical maximum rates for the given WiFi standard and configuration.

Frequency Band Analysis

These factors are analyzed for both 2.4GHz and 5GHz frequency bands, providing a comprehensive assessment of the WiFi network's performance and quality across different spectrum ranges.

Multi-AP Support Requirements

For optimal evaluation accuracy, devices should support Multi-AP with the "Data Elements" parameter as defined in the TR-181 standard.

For more information, refer to the TR-181 Device.WiFi.DataElements specification.

Signal Strength Factor Analysis in WiFi Evaluation

Overview

Signal Strength Factor is a critical metric for evaluating your WiFi network's performance. It is based on the Received Signal Strength Indicator (RSSI) of data frames, which measures the power level of the WiFi signal your device receives during actual data transmission.

Unlike measurements based solely on beacon frames, Signal Strength Factor provides a more accurate representation of real-world connection quality during active use.

Measurement Methodology

Technical Foundation

The Signal Strength Factor is derived from the DataFrameRSSI parameter, which is part of the ESS Link Parameter Set as defined in IEEE industry standards:

DataFrameRSSI is the received signal strength in dBm of received Data frames from the network. This may be time-averaged over recent history by a vendor-specific smoothing function.

Valid Range: -100 to 40 dBm

Implementation Details

In practical implementation, CONTROL obtains this data using the TR-181 parameter:

Device.WiFi.AccessPoint.AssociatedDevice.SignalStrength

This parameter is defined as:

An indicator of radio signal strength of the uplink from the associated device to the access point, measured in dBm, as an average of the last 100 packets received from the device. If the instance of this AssociatedDevice is the same as Device.WiFi.DataElements.Network.Device.{i}.Radio.{i}.BSS.{i}.STA.{i}., then this parameter is the same as Device.WiFi.DataElements.Network.Device.{i}.Radio.{i}.BSS.{i}.STA.{i}.SignalStrength.

Signal Strength Rating Scale

CONTROL translates raw dBm measurements into a user-friendly scale ranging from 4 to 10:

Why Signal Strength Factor Matters

Real-World Performance

DataFrameRSSI reflects the signal strength of actual data transmission rather than just beacon frames, providing a more accurate picture of your connection quality during active use.

User Experience Impact

A higher Signal Strength Factor typically results in:

Device Efficiency

Better signal strength helps conserve device battery life, as less power is required to maintain a strong, stable connection.

Improving Your Signal Strength Factor

To optimize your Signal Strength Factor, consider the following recommendations:

Standards Compliance

CONTROL's evaluation system is designed to align with industry standards while providing easy-to-understand insights into your WiFi performance.

References

Noise Factor in WiFi Evaluation

What is Noise Factor?

Noise Factor is a crucial component in evaluating your WiFi network's performance. It's based on the Average Noise Power Indicator (ANPI), which measures the level of unwanted electromagnetic energy or interference in your WiFi environment.

By understanding your Noise Factor, you can identify potential issues affecting your network quality and take steps to optimize your wireless performance.

Technical Foundation

The Noise Factor in CONTROL is derived from industry-standard measurements and specifications:

1. ANPI (Average Noise Power Indicator)

As defined in IEEE 802.11 standards, ANPI is "a medium access control (MAC) indication of the average noise plus interference power measured when the channel is idle." This measurement is taken under specific conditions to ensure accuracy and provides a reliable baseline for noise assessment.

2. Noise Histogram

The WiFi system continuously collects detailed noise data over time, creating a histogram that shows the distribution of noise levels across your network environment. This historical data enables more accurate noise pattern analysis.

3. TR-181 Standard

This standard defines the Noise parameter as "an indicator of radio noise on the uplink from the associated device to the access point, measured in dBm, as an average of the last 100 packets received from the device." This provides a practical, real-world measurement of noise affecting active connections.

How is Noise Factor Measured?

Based on these technical standards, CONTROL translates the raw noise measurements into a user-friendly scale from 4 to 10:

This scale is derived from the IPI (Idle Power Indicator) definitions for Noise Histogram reports in the IEEE 802.11 standard, ensuring consistency with industry best practices.

Why is Noise Factor Important?

Understanding your Noise Factor helps you assess several critical aspects of your WiFi performance:

Signal Clarity

Lower noise levels allow for clearer WiFi signals, improving overall connection quality. Clean signals mean more reliable data transmission and fewer dropped packets.

Performance Impact

High noise levels can significantly reduce your effective WiFi speed and reliability, even when your signal strength appears good. Noise directly affects the signal-to-noise ratio, which determines your maximum achievable throughput.

Range Effect

In low-noise environments, your WiFi signals can effectively reach farther distances. Less interference means devices at the edge of your coverage area maintain better connectivity.

Technical Insight: Noise Histogram and ANPI

The WiFi system constantly monitors noise levels in your environment, creating a histogram of these measurements over time. This histogram helps calculate the ANPI value, which CONTROL uses as the basis for your Noise Factor score.

By analyzing patterns in the noise histogram, CONTROL can identify:

How to Improve Your Noise Factor

If your Noise Factor score is lower than desired, consider these optimization strategies:

  1. Identify and eliminate interference sources — Common culprits include microwaves, cordless phones, Bluetooth devices, baby monitors, and wireless security cameras
  2. Change your WiFi channel — Select a channel with less interference from neighboring networks
  3. Use a WiFi analyzer — Deploy a WiFi analyzer app to identify less congested channels in your area
  4. Consider the 5 GHz band — The 5 GHz frequency band is often less crowded than 2.4 GHz, resulting in lower noise levels
  5. Update router firmware — Ensure your router's firmware is current, as newer versions may include improved noise-handling capabilities
  6. Optimize router placement — Position your router away from potential interference sources and metal objects

Noise Factor in Context

While a good Noise Factor is important, it works in conjunction with other metrics like Signal Factor. The relationship between signal strength and noise is captured in the Signal-to-Noise Ratio (SNR), which is a key determinant of overall WiFi performance.

A strong signal (high Signal Factor) combined with low noise (high Noise Factor) produces an excellent SNR, resulting in optimal network performance. Conversely, even a strong signal can be compromised by high noise levels.

Remember: Noise Factor is just one piece of the puzzle in understanding your overall WiFi performance. CONTROL combines it with other metrics to give you a comprehensive view of your network's health and capabilities.

Interference Factor in WiFi Evaluation

Overview

The Interference Factor is a crucial metric for evaluating your WiFi network's performance within the CONTROL portal. It quantifies the impact of other WiFi networks and devices operating on the same or adjacent channels as your network. Lower interference levels correlate directly with better overall WiFi performance.

Technical Foundation

The Interference Factor calculation is based on several core technical concepts from WiFi standards:

  1. Channel Overlap: WiFi channels can overlap, particularly in the 2.4 GHz band. This overlap is a primary source of interference between networks.

  2. Signal Strength of Neighboring Networks: The received signal strength from nearby WiFi networks directly impacts the level of interference experienced by your network.

  3. Operating Channel Bandwidth: Wider channel bandwidths (such as 40 MHz compared to 20 MHz) increase the likelihood of interference with neighboring networks due to greater spectrum occupancy.

Measurement Methodology

Data Collection

The CONTROL system analyzes your WiFi environment and calculates an interference score based on data obtained from the TR-181 parameter:

Device.WiFi.NeighboringWiFiDiagnostic.Result.

This parameter provides a "Neighboring SSID table" that models all WiFi SSIDs detectable by your device. At most one entry in this table can exist with a given value for BSSID.

Calculation Process

To calculate the Interference Factor, the system:

  1. Retrieves the neighboring WiFi networks table
  2. Compares this data with your CPE (Customer Premises Equipment) transmission channels (2.4 GHz and/or 5.0 GHz)
  3. Analyzes the "Current Operating Channel Bandwidth"
  4. Evaluates the overlap and signal strength relationships

The system considers multiple factors during calculation:

Scoring Scale

The resulting interference score is translated into a user-friendly scale from 2 to 10:

Interpreting Your Interference Factor

Understanding your Interference Factor score helps you assess your WiFi environment:

Impact on Network Performance

Why Interference Factor Matters

Relationship to Other Metrics

The Interference Factor works alongside other metrics like Signal Factor and Noise Factor. While a strong signal can sometimes overcome interference, reducing interference is often the key to improving overall WiFi performance, especially in densely populated areas.

Remember that Interference Factor is just one component of a comprehensive WiFi evaluation that helps you understand and optimize your network's capabilities.

Optimization Strategies

If your Interference Factor score is lower than desired, consider these improvement strategies:

References

  1. TR-181 Issue 2 Amendment 15
  2. IEEE 802.11 standards

SNR Factor in WiFi Evaluation

Overview

The SNR Factor, based on the Signal-to-Noise Ratio (SNR), is a critical metric for evaluating WiFi network performance within CONTROL. It measures the relationship between your WiFi signal strength and the background noise level in your environment. A higher SNR value indicates better WiFi performance and connection quality.

Technical Foundation

Core Principles

SNR Factor is built on fundamental wireless communication principles:

  1. Signal Strength: The power of the WiFi signal received by your device
  2. Noise Floor: The ambient background noise level in the environment
  3. SNR Calculation: SNR = Signal Strength - Noise Floor (measured in dB)

Standards Compliance

The SNR Factor aligns with the IEEE 802.11 standard, incorporating key parameters:

Implementation Details

CONTROL obtains SNR data using the TR-181 parameter:

Device.WiFi.AccessPoint.AssociatedDevice.SNR

This parameter is defined as:

"An indicator of signal to noise ratio, in dB, on the uplink from the associated device to the access point, measured in dB, as an average of the last 100 packets received from the device."

SNR Factor Scale

CONTROL translates raw SNR measurements into a user-friendly scale ranging from 1 to 10:

Rating Quality Level SNR Range (dB)
10 Excellent 35 or higher
9 Very Good 30 to 34
8 Good 25 to 29
7 Fair 20 to 24
6 Marginal 15 to 19
5 Poor 10 to 14
4 Very Poor 5 to 9
3 Unreliable 0 to 4
2 Highly Unreliable -5 to -1
1 No Connection Below -5

Interpreting Your SNR Factor

Performance Expectations

Why SNR Factor Matters

Understanding SNR Factor is essential for several reasons:

  1. Connection Quality: Higher SNR values provide clearer signal reception, resulting in superior WiFi performance with fewer errors
  2. Dynamic Data Rates: WiFi devices automatically adjust their transmission rates based on SNR—higher SNR enables faster data throughput
  3. Network Stability: Strong SNR leads to more stable connections with reduced packet loss and fewer dropouts
  4. Effective Range: Improved SNR can extend the practical usable range of your WiFi network

Technical Insight: SNR and Modulation Schemes

SNR directly influences the Modulation and Coding Scheme (MCS) that your WiFi connection can utilize. Higher SNR values enable more sophisticated modulation schemes, which deliver higher data rates:

This adaptive behavior ensures your connection remains stable while maximizing throughput based on current conditions.

Improving Your SNR Factor

Optimization Strategies

Consider these approaches to enhance your SNR Factor:

SNR Factor in Context

SNR Factor works in conjunction with other CONTROL metrics to provide a comprehensive assessment of your WiFi network:

While strong signal strength is important, maintaining a low noise floor is equally critical for achieving high SNR and optimal WiFi performance. CONTROL analyzes all these factors together to give you a complete picture of your network health.

References

  1. TR-181 Issue 2 Amendment 15
  2. IEEE 802.11 Standards

Standard Factor in WiFi Evaluation

Overview

Standard Factor is a key metric for evaluating your WiFi network's performance. It measures how effectively your connected devices utilize the WiFi standards (protocols) supported by your router. A higher Standard Factor score indicates that your devices are taking full advantage of the latest available WiFi technologies, ensuring optimal network performance.

Technical Foundation

Standard Factor is based on WiFi standards defined by the IEEE 802.11 working group. The most common standards include:

Measurement Methodology

CONTROL evaluates the WiFi standard used by each connected device and compares it to the best standard supported by your router. This assessment is translated into a user-friendly scale ranging from 4 to 10.

2.4 GHz Band Scoring

5 GHz Band Scoring

Interpreting Your Standard Factor Score

Why Standard Factor Matters

Understanding your Standard Factor score is important for several reasons:

  1. Speed – Newer WiFi standards offer significantly faster data transfer rates
  2. Efficiency – Modern standards use more efficient encoding and modulation, delivering better performance even in congested WiFi environments
  3. Range – Recent standards provide improved signal range and wall penetration capabilities
  4. Future-Proofing – Higher scores indicate your network setup is better prepared for evolving WiFi technologies

WiFi Standards and Performance Specifications

Different WiFi standards offer varying theoretical maximum speeds:

Note: Real-world speeds are typically lower than theoretical maximums due to factors such as distance, interference, number of connected devices, and environmental conditions.

Technical Specifications

These speed capabilities are based on the following technical specifications:

  1. IEEE 802.11g-2003 – Uses OFDM modulation in the 2.4 GHz band with a maximum physical layer bit rate of 54 Mbit/s [1]
  2. IEEE 802.11n-2009 – Introduces MIMO technology allowing multiple spatial streams. With 4 streams and 40 MHz channels, achieves up to 600 Mbit/s [2]
  3. IEEE 802.11ac-2013 – Operates in the 5 GHz band, uses wider 160 MHz channels, higher-order 256-QAM modulation, and up to 8 MIMO spatial streams for speeds up to 3.5 Gbit/s [3]
  4. IEEE 802.11ax-2021 (Wi-Fi 6) – Introduces OFDMA and 1024-QAM modulation. With 160 MHz channels and 8 spatial streams, theoretically achieves up to 9.6 Gbit/s [4]

These standards also introduce significant improvements in efficiency and capacity beyond raw speed. For example, 802.11ax is specifically designed to perform better in dense environments with many connected devices.

References

[1] IEEE Std 802.11g-2003
[2] IEEE Std 802.11n-2009
[3] IEEE Std 802.11ac-2013
[4] IEEE Std 802.11ax-2021

Improving Your Standard Factor Score

To optimize your Standard Factor score, consider the following recommendations:

Standard Factor in Context

While Standard Factor is an important metric, it should be evaluated alongside other performance indicators within CONTROL, such as Signal Factor and Interference Factor. A high Standard Factor ensures you're leveraging the best available WiFi technology, but signal strength and interference levels also play crucial roles in determining overall network performance.

Standard Factor is one component of a comprehensive WiFi performance assessment. It helps ensure you're taking full advantage of the best technology available for your WiFi connection.

SpeedFactor in WiFi Evaluation

What is Speed Factor?

Speed Factor is a crucial component in evaluating your WiFi network's performance within CONTROL. It measures how well your actual connection speed matches the theoretical maximum speed of your WiFi standard and configuration. A higher Speed Factor indicates that you're getting closer to the full potential of your WiFi setup.

Note on Terminology: In this document, we use the terms "speed", "data rate", and "throughput" interchangeably. These all refer to the rate at which data is transmitted over your WiFi connection, which directly impacts the user's experience. While technically "speed" can be misleading as it's often used colloquially, here it's used synonymously with the more accurate terms "data rate" and "throughput".

Technical Foundation

Speed Factor is based on several technical aspects:

  1. WiFi Standards: Each standard (802.11n, 802.11ac, etc.) has different theoretical maximum speeds.
  2. Channel Bandwidth: Wider channels (e.g., 40 MHz vs 20 MHz) allow for higher speeds.
  3. Actual Data Rates: The real-world upload and download speeds your devices are achieving.

How is Speed Factor Measured?

CONTROL compares the actual data rates (both uplink and downlink) with the theoretical maximum for your WiFi standard and channel bandwidth using the following process:

Step 1: Identify Maximum Theoretical Data Rate

The system uses the TR-181 parameter:

Step 2: Measure Actual Data Rates

The system measures actual uplink and downlink data rates using the TR-181 parameters:

Step 3: Calculate Speed Factor Percentage

Speed Factor Percentage = (Actual Data Rate / MaxBitRate) × 100

Where Actual Data Rate is the average of LastDataDownlinkRate and LastDataUplinkRate.

Step 4: Assign Speed Factor Score

Based on the calculated percentage, CONTROL assigns a Speed Factor score:

This comparison between the actual data rates (throughput) and the maximum supported bit rate gives a clear indication of how well your WiFi connection is performing relative to its theoretical capabilities, which translates directly to the speed and quality of the user's experience.

Calculation Example

Consider the following scenario:

Calculation:

  1. Average Actual Speed = (780 + 650) / 2 = 715 Mbps
  2. Speed Factor Percentage = (715 / 1300) × 100 ≈ 55%
  3. Result: Speed Factor score of 6 (Good)

This comparison between the actual speeds and the maximum supported bit rate gives a clear indication of how well your WiFi connection is performing relative to its theoretical capabilities.

What Does Your Speed Factor Mean?

Why is Speed Factor Important?

  1. Performance Indicator: It shows how well your actual speeds match up to what's theoretically possible.
  2. Troubleshooting Tool: A low Speed Factor can indicate issues that need addressing.
  3. Value Assessment: It helps you understand if you're getting the full value from your WiFi setup and internet plan.

Reference Speeds for WiFi Standards

The following table provides typical maximum theoretical speeds for common WiFi standards and configurations:

Note: These are simplified figures. Actual maximums can vary based on specific configurations and number of spatial streams.

References

How Can You Improve Your Speed Factor?

To optimize your Speed Factor score, consider the following recommendations:

Speed Factor in Context

While Speed Factor is important, it works in conjunction with other metrics like Signal Factor and Interference Factor within CONTROL. A high Speed Factor indicates that you're efficiently using your WiFi technology, but factors like signal strength and interference also play crucial roles in overall performance.

Remember, Speed Factor helps you understand if you're getting the speeds you should be getting based on your WiFi setup. It's a key indicator of your WiFi efficiency and performance.

Understanding Your WiFi Device Score

Overview

Your device's WiFi Experience Score provides a comprehensive assessment of your wireless connection quality. The score is calculated using six key performance factors, each weighted according to its impact on your overall WiFi experience.

The final score ranges from 1 to 10, with higher values indicating superior WiFi performance.

Scoring Factors and Weights

Each factor contributes differently to your overall score based on its importance in determining connection quality:

Factor Weight Description
Interference 0.30 The most critical factor affecting WiFi performance. Interference directly impacts both the quality and stability of your wireless connection.
Signal Strength 0.20 Essential for maintaining a stable, high-speed connection. Signal strength determines the effective range and reliability of your WiFi coverage.
SNR (Signal-to-Noise Ratio) 0.15 Measures signal clarity relative to background noise. A higher SNR is crucial for maintaining consistent connection quality.
Speed 0.15 Particularly important for user satisfaction when using high-bandwidth applications such as video streaming, gaming, or large file transfers.
Noise 0.10 Background noise degrades signal quality. Note that noise impact is partially accounted for in the SNR calculation.
Standard 0.10 The WiFi standard (e.g., 802.11ac, 802.11ax) determines the theoretical maximum capabilities and influences potential performance levels.

How the Score is Calculated

The weighting system prioritizes factors that have direct, measurable effects on connection stability and quality over theoretical maximum capabilities.

Your device's final WiFi Experience Score is calculated by:

  1. Evaluating each of the six factors listed above
  2. Applying the corresponding weight to each factor's measurement
  3. Combining all weighted factors into a single composite score
  4. Normalizing the result to a scale of 1-10

This methodology ensures that real-world performance indicators have greater influence on your score than theoretical specifications alone. The final score for each device results in a value between 1 and 10, where higher scores indicate better WiFi experience.

WiFi Optimization System

Overview

The WiFi Optimization System analyzes and optimizes wireless network performance by evaluating channel usage, bandwidth efficiency, device connectivity, and transmit power levels. The system delivers comprehensive recommendations for optimal network settings, device placement, and configuration adjustments to enhance overall network performance.

Key Components

Channel Evaluation

Functions: calculate_channel_score and find_best_channel

These functions assess WiFi channels across both 2.4GHz and 5GHz frequency bands:

Bandwidth Optimization

Function: evaluate_bandwidth

This function recommends optimal channel bandwidth based on current interference levels:

Device-Specific Analysis

Function: calculate_weighted_score

This function performs comprehensive analysis of each connected device:

Recommendation Types

The system provides six categories of optimization recommendations:

1. Channel Change

Suggests migrating to a less congested channel for improved performance.

Example: "Change channel to 1 for better performance"

2. Bandwidth Adjustment

Recommends optimal bandwidth settings based on current interference levels.

Example: "Change bandwidth to 40MHz for optimal performance"

3. Band Switching

Advises switching between 2.4GHz and 5GHz bands based on device capabilities and signal conditions:

Examples:

4. Signal Improvement

Suggests deploying WiFi extenders for devices experiencing consistently weak signals.

Example: "Consider using a WiFi extender to improve signal strength"

5. Wired Connection

Recommends Ethernet connections for devices with poor wireless performance.

Example: "Consider using Ethernet connection for better stability and performance"

6. Transmit Power Adjustment

Optimizes router transmit power based on device signal conditions:

Examples:

Optimization Mechanisms

The system employs six core optimization strategies:

1. Intelligent Channel Selection

2. Dynamic Bandwidth Adjustment

3. Adaptive Band Steering

4. Transmit Power Optimization

5. Network Load Balancing

6. Alternative Connection Methods

Implementation Details

Scoring System

The system uses a scoring mechanism where higher scores indicate better conditions (less interference, stronger signal, better performance).

Real-Time Analysis

Recommendations are based on real-time analysis of the network environment and connected devices, ensuring current and relevant suggestions.

Non-Intrusive Operation

The optimization process provides suggestions without automatically changing router or device settings, leaving control in the hands of the network administrator.

User Interface

A tooltip system displays the number of recommendations for each device, with detailed recommendations shown on hover for easy review.

Summary

The WiFi Optimization System provides a comprehensive approach to enhancing wireless network performance. By analyzing channel interference, signal strength, bandwidth usage, and device capabilities, it delivers tailored recommendations to improve overall network efficiency and user experience. The system's adaptability to different network environments and device-specific issues makes it an essential tool for maintaining optimal WiFi performance in CONTROL.

WiFi Analytics Configuration Guide

Introduction

WiFi Analytics is a built-in diagnostic feature of the CONTROL ACS platform that evaluates the quality of a CPE's WiFi network. After triggering a neighboring-WiFi scan from the device's Diagnostics tab, the engine collects radio, client, and neighbor data from the CPE and produces a structured score report.

The evaluation covers six quality factors: Signal, Noise, SNR, Interference, Standard, and Speed. Each factor is scored on a scale of 1–10 and then combined into a single Overall Score using configurable weights. This lets you tune the scoring model to reflect the conditions of your own network — for example, increasing the Interference weight for dense urban deployments.

The engine supports both TR-181 and TR-098 CPEs. For standard TR-181 devices with sequential radio indexes, the engine can auto-discover the radio configuration without any additional setup. For TR-098 or vendor-specific devices with non-standard parameter paths, an explicit Service configuration is required to supply the correct path templates and JSON key names.

Prerequisites

Before configuring WiFi Analytics, ensure the following conditions are met:

Requirement Details
Managed CPE The device must be connected to CONTROL and actively reporting via TR-069/CWMP.
WiFi parameters in device Type The Type profile must include parameters for periodic collection: Channel, OperatingFrequencyBand, AssociatedDevice tables, Noise, TX power, and supported standards.
ServiceType 23 present The "CWMP WIFI Neighbor test" ServiceType must exist in CONTROL Settings. This is included in the default platform fixtures and should already be present.

Note: If ServiceType 23 is missing, contact your platform administrator to load the WiFi Analytics fixtures.

Configuration Steps

Step 1: Create a Service for WiFi Analytics

A Service instance of ServiceType 23 holds all the configuration that tells the engine how to map radio and client parameters for a specific device model.

  1. Navigate to Settings > Services > Add
  2. Set the Service Type field to CWMP WIFI Neighbor test (ServiceType 23)
  3. Give it a descriptive name, for example: WiFi Diagnostic Score - Model XYZ
  4. Check Active and Public
  5. Save the Service

Service configuration showing ServiceType and general settings

After saving, the Service will display four parameter groups:

Parameter Group Purpose
2.4 GHz Band Configuration Radio and client configuration for the 2.4 GHz band
5 GHz Band Configuration Radio and client configuration for the 5 GHz band
6 GHz Band Configuration Radio and client configuration for the 6 GHz band
Score Weights Relative importance of each quality factor (must sum to 100%)

Configure only the bands that are relevant to the device model. Bands that are left disabled are excluded from scoring.

Step 2: Configure Band Parameters

Each band group (2.4 GHz, 5 GHz, 6 GHz) contains the same set of fields. Repeat this configuration for every band the device supports.

Band Enable and Index Fields

Field Description
Enabled Enable or disable analysis for this band. Disabled bands are ignored entirely.
Radio index The value substituted for the {i} placeholder at runtime. For TR-181, this is the Device.WiFi.Radio.{i} object index (e.g., 1 for 2.4 GHz, 2 for 5 GHz). For TR-098, this is the WLANConfiguration index.
SSID indexes Comma-separated list of SSID object indexes to read SSID-level data from.
AP indexes Comma-separated list of AccessPoint object indexes. These are iterated when collecting connected-client data.

Important: The {i} placeholder is the only token substituted by the engine. All other numbers in path templates (e.g., LANDevice.1) are treated as literal strings and are never modified.

Variable Override Fields

These fields allow you to supply explicit TR-181 or TR-098 parameter paths. Leave them blank for standard TR-181 devices — the engine uses the correct Device.WiFi.* defaults automatically.

For TR-098 or vendor-specific devices, enter the full path template using {i} where the radio index should appear.

Field TR-181 default (auto) TR-098 example
Channel Device.WiFi.Radio.{i}.Channel InternetGatewayDevice.LANDevice.1.WLANConfiguration.{i}.Channel
Possible channels Device.WiFi.Radio.{i}.PossibleChannels InternetGatewayDevice.LANDevice.1.WLANConfiguration.{i}.PossibleChannels
Radio noise Device.WiFi.Radio.{i}.Stats.Noise InternetGatewayDevice.LANDevice.1.WLANConfiguration.{i}.Stats.Noise
Bandwidth Device.WiFi.Radio.{i}.CurrentOperatingChannelBandwidth Supply vendor-specific path
Standards Device.WiFi.Radio.{i}.OperatingStandards InternetGatewayDevice.LANDevice.1.WLANConfiguration.{i}.Standard
TX power Device.WiFi.Radio.{i}.TransmitPower Supply vendor-specific path

2.4 GHz Band Configuration — variable override fields with Radio index, SSID/AP indexes, and channel/noise/bandwidth paths

Client Field Override Fields

These fields specify the JSON key names used to read per-client metrics from the AssociatedDevice table entries. These are short key names, not full parameter paths.

Leave them blank for standard TR-181 devices. For TR-098 or vendor devices, enter the vendor-specific key name.

Field TR-181 default Vendor example
Noise field Noise X_ALCATEL_Noise
SNR field (auto-calculated) X_ALU-COM_SNR
Signal field SignalStrength X_VENDOR_RSSI
Downlink rate LastDataDownlinkRate —
Uplink rate LastDataUplinkRate —
Standard field OperatingStandard —

Clients Table Path and Active Filter

Field Description
Clients table path Template path for the AssociatedDevice table. Leave blank for TR-181 default. TR-098 example: InternetGatewayDevice.LANDevice.1.WLANConfiguration.{i}.AssociatedDevice.
Active field JSON key for active-client filtering. Default: Active. Leave blank to skip filtering.
Hosts table path LAN Hosts table for MAC-based cross-reference when AssociatedDevice.Active is unreliable.

Client field overrides, Clients table path, Active field, and Hosts table path

Step 3: Configure Score Weights

The Score Weights parameter group controls how much each quality factor contributes to the Overall Score. The six weights must add up to 100%.

Quality Factor Default Weight What it measures
Signal 24% Client signal strength (RSSI in dBm)
Noise 19% Background noise level on the radio channel
SNR 4% Signal-to-noise ratio per client
Standard 14% WiFi standard in use (802.11n, ac, ax, etc.)
Speed 9% Per-client uplink and downlink rates
Interference 30% Neighboring network congestion on the channel

Adjust these values to match your deployment environment. For example, increase Interference weight to 40–50% for dense urban areas, or increase Signal weight if coverage is the primary concern.

Score Weights section showing the six configurable weight fields

Step 4: Create a Test Profile

  1. Navigate to Userx > Profiles > Add
  2. Give it a descriptive name (e.g., WiFi Analytics — Model XYZ)
  3. Check Is active
  4. In the Locations, tests and limits settings section, add the Service created in Step 1 to the Test services field
  5. Save the Test Profile

Test Profile form showing the Test services field with the WiFi Service assigned

Step 5: Assign the Test Profile to a Device Type

  1. Navigate to Inventory > Profiles and select the device Type for the target CPE model
  2. Locate the Automatic tests profile field
  3. Select the Test Profile created in Step 4
  4. Save the Type

Device Type form with Automatic tests profile field populated

From this point on, any device of this Type will use the configured Service when a WiFi diagnostic is run.

Running the WiFi Diagnostic

  1. Navigate to the target device's Diagnostics tab
  2. From the Operation dropdown, select WiFi neighbor diagnostics
  3. The Parameter name field defaults to .WiFi.NeighboringWiFiDiagnostic. The engine automatically prefixes this with Device. for TR-181 or InternetGatewayDevice. for TR-098
  4. Click Proceed
  5. Wait for the CPE to scan neighboring networks (typically 10–30 seconds)

Diagnostic form with WiFi neighbor diagnostics selected and Proceed button

Understanding the Results

Once the diagnostic completes, a WiFi Analytics mini-dashboard appears below the form.

Header Summary

Element Description
Bands Number of active bands analyzed
Clients Total WiFi clients across all bands
Overall Weighted average score as a colored badge (Green ≥8, Yellow ≥5, Red <5, Gray = N/A)

Band Cards

Each band displays its current channel, bandwidth, connected client count, a score progress bar, and a quality label (Excellent / Fair / Poor).

WiFi Analytics dashboard showing header summary, band scores, and client counts

Recommendations and Tips

Quality factor bars for both bands and the Recommendations panel

How the Overall Score is Calculated

The Overall Score is a weighted average of all available factor scores across all bands:

  1. Each client's 6 factors are scored individually
  2. Factors with N/A are excluded; remaining weights are renormalized to sum to 100%
  3. The weighted average produces a per-client score (1–10)
  4. All client scores within a band are averaged to produce the band score
  5. All band scores are averaged to produce the Overall Score

The default weight distribution emphasizes Interference (30%) and Signal (24%) as the highest-impact factors for typical residential WiFi environments.

Quality Factors — Detailed Breakdown

Below each band card, six horizontal bars show the individual factor scores. Each factor is scored 1–10 based on specific inputs from the CPE. When a factor cannot be calculated, it shows N/A and its weight is redistributed proportionally across the remaining factors.

Signal Factor

Measures the received signal strength (RSSI) of each connected WiFi client.

Input: SignalStrength from the AssociatedDevice table (or the vendor-specific JSON key configured in the Service).

Signal strength (dBm) Score
≥ −50 10 (Excellent)
≥ −60 9
≥ −70 8
≥ −80 7
≥ −90 6
< −90 4 (Poor)

The final Signal score for the band is the average across all connected clients.

Noise Factor

Measures the background noise floor on the radio channel.

Input: Per-client Noise field from AssociatedDevice, or fallback to Device.WiFi.Radio.{i}.Stats.Noise (radio-level noise).

Noise level (dBm) Score
< −90 10 (Very quiet)
< −80 8
< −70 6
≥ −70 4 (Noisy)

Lower noise is better — a value below −90 dBm indicates a very clean radio environment.

SNR Factor (Signal-to-Noise Ratio)

Measures the gap between signal and noise for each client. Higher SNR means clearer communication.

Input: Either a vendor-specific SNR field (e.g., X_ALU-COM_SNR) or auto-calculated as SignalStrength − Noise when no dedicated SNR field is available.

SNR (dB) Score
≥ 35 10
≥ 30 9
≥ 25 8
≥ 20 7
≥ 15 6
≥ 10 5
≥ 5 4
≥ 0 3
≥ −5 2
< −5 1

Interference Factor

Evaluates how much congestion the CPE experiences from neighboring WiFi networks on the same or adjacent channels.

Inputs:

How neighbors are scored:

Each detected neighbor contributes to a raw interference accumulator based on two criteria: whether it is on the same channel or an adjacent channel, and its signal strength:

Neighbor position Strong signal (≥ −60 dBm) Medium (≥ −80 dBm) Weak (< −80 dBm)
Same channel +5.0 +3.0 +1.0
Adjacent channel +2.5 × proximity +1.5 × proximity +0.5 × proximity
Non-overlapping 0 0 0

The raw accumulator is then mapped to a score:

Raw interference Score
0 (no neighbors on channel) 10
≤ 10 8
≤ 20 6
≤ 30 4
> 30 1 (Severe congestion)

N/A condition: If the CPE's Channel parameter is missing from DeviceSettings, the engine cannot determine which neighbors overlap — the Interference factor shows N/A.

Standard Factor

Evaluates the WiFi standard (protocol generation) used by the CPE's radio.

Input: Device.WiFi.Radio.{i}.OperatingStandards — the active standard(s) for this radio.

The score depends on the band:

2.4 GHz band:

Standard Score
WiFi 7 (be) / WiFi 6 (ax) 10
WiFi 4 (n) 8
WiFi 3 (g) 6
WiFi 1 (b) 4

5 GHz band:

Standard Score
WiFi 7 (be) / WiFi 6 (ax) 10
WiFi 5 (ac) 8
WiFi 4 (n) 6
WiFi 2 (a) 4

Newer standards support higher throughput, better modulation, and features like OFDMA and MU-MIMO, which directly improve network quality.

Speed Factor

Measures actual throughput as a percentage of the theoretical maximum for the current standard and bandwidth combination.

Inputs:

The engine calculates: average_speed = (downlink + uplink) / 2, then compares it against a reference throughput table:

Standard 20 MHz 40 MHz 80 MHz 160 MHz
n 300 Mbps 600 Mbps — —
ac 437 Mbps 875 Mbps 1750 Mbps 3500 Mbps
ax 574 Mbps 1148 Mbps 2402 Mbps 4804 Mbps
be 690 Mbps 1380 Mbps 2880 Mbps 5760 Mbps
Actual / Max ratio Score
≥ 80% 10
≥ 60% 8
≥ 40% 6
< 40% 4

N/A condition: If downlink or uplink rate data is missing for all clients, Speed shows N/A.

Additional Notes

TR-098 Quick Reference

Field Example value
Radio index 1
AP indexes 1
Clients table path InternetGatewayDevice.LANDevice.1.WLANConfiguration.{i}.AssociatedDevice.
Channel override InternetGatewayDevice.LANDevice.1.WLANConfiguration.{i}.Channel
Noise override InternetGatewayDevice.LANDevice.1.WLANConfiguration.{i}.Stats.Noise
Hosts table path InternetGatewayDevice.LANDevice.1.Hosts.Host.
SNR client field X_ALU-COM_SNR (vendor-specific)