# 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](https://docs.zequenze.com/books/control/page/signal-strength-factor-analysis-in-wifi-evaluation)

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](https://docs.zequenze.com/books/control/page/noise-factor-in-wifi-evaluation)

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

### 3. [Interference](https://docs.zequenze.com/books/control/page/interference-factor-in-wifi-evaluation)

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)](https://docs.zequenze.com/books/control/page/snr-factor-in-wifi-evaluation)

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](https://docs.zequenze.com/books/control/page/standard-factor-in-wifi-evaluation)

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](https://docs.zequenze.com/books/control/page/speedfactor-in-wifi-evaluation)

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](https://cwmp-data-models.broadband-forum.org/tr-181-2-18-0-cwmp.html#D.Device:2.Device.WiFi.DataElements.).

# 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:

- **10 (Excellent)** — Your device is receiving a very strong signal strength, typically when very close to the router or in ideal conditions.

- **9 (Very Good)** — The signal is strong and should provide excellent performance for most applications.

- **8 (Good)** — A solid signal strength that is suitable for most online activities.

- **7 (Fair)** — The signal is moderate. You may experience some slowdowns with demanding applications.

- **6 (Poor)** — The signal is weak. You might encounter issues with stability and speed.

- **4 (Very Poor)** — The signal is very weak. Connectivity problems are likely, and performance will be significantly impacted.

## 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:

- Smoother online activities with fewer interruptions
- More consistent performance across applications
- Reduced latency and buffering

### 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:

- **Reduce physical distance** — Move closer to your WiFi router
- **Clear line of sight** — Remove obstacles between your device and the router
- **Minimize interference** — Reduce interference from other electronic devices
- **Extend coverage** — Consider using a WiFi extender or mesh system for larger spaces
- **Optimize placement** — Ensure your router is centrally located in your home or office

## Standards Compliance

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

---

## References

- [IEEE Std 802.11™‐2020](https://ieeexplore.ieee.org/document/9363693)
- [Device:2 Root Data Model definition [CWMP]](https://cwmp-data-models.broadband-forum.org/tr-181-2-18-0-cwmp.html)
- [TR-181 Issue 2 Amendment 15](https://cwmp-data-models.broadband-forum.org/tr-181-2-18-0-cwmp.html#D.Device:2.Device.WiFi.AccessPoint.AssociatedDevice.SignalStrength)

# 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:

- **10 (Excellent)**: Very low noise, typically below -92 dBm
- **8 (Good)**: Low noise, between -92 dBm and -86 dBm
- **6 (Fair)**: Moderate noise, between -86 dBm and -75 dBm
- **4 (Poor)**: High noise, above -75 dBm

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:

- Consistent interference sources
- Time-based noise patterns
- Environmental factors affecting your network
- Opportunities for optimization

## 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:

- **Number of Overlapping Networks**: More networks on the same or adjacent channels increase interference
- **Signal Strength of Interfering Networks**: Stronger signals from other networks cause more significant interference
- **Channel Width**: Wider channels (e.g., 40 MHz in 2.4 GHz) are more susceptible to overlap with other networks
- **Frequency Band**: The 2.4 GHz band is typically more congested and prone to interference than the 5 GHz band

### Scoring Scale

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

- **10 (Excellent)**: Minimal interference, ideal conditions
- **8 (Good)**: Low interference, suitable for most applications
- **6 (Fair)**: Moderate interference, may affect some high-bandwidth applications
- **4 (Poor)**: Significant interference, likely to impact performance
- **2 (Very Poor)**: Severe interference, major impact on WiFi performance

## Interpreting Your Interference Factor

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

- **10-9**: Ideal environment with minimal interference from other networks
- **8-7**: Good environment, most applications should work well
- **6-5**: Noticeable interference present, may affect some applications
- **4-3**: Significant interference, likely to impact overall WiFi performance
- **2**: Severe interference, major issues with WiFi performance expected

## Impact on Network Performance

### Why Interference Factor Matters

- **Network Performance**: High interference can significantly reduce your WiFi speed and reliability
- **Consistency**: In high-interference environments, your WiFi performance may be inconsistent and unpredictable
- **Range**: Interference can effectively reduce the usable range of your WiFi network

### 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:

- Change your WiFi channel to one with less interference
- If possible, use the 5 GHz band, which typically experiences less interference
- Reduce your channel width (e.g., from 40 MHz to 20 MHz) in crowded environments
- Position your router away from neighbors' WiFi equipment
- In dense areas, consider using a WiFi system that can automatically select the optimal channel

---

## References

1. [TR-181 Issue 2 Amendment 15](https://wiki.broadband-forum.org/display/RESOURCES/Broadband+Forum+Published+Resources#tf-filters=%7B%22selectfilters%22%3A%5B%5D%2C%22userfilters%22%3A%5B%22Number%22%5D%2C%22numberfilters%22%3A%5B%5D%2C%22datefilters%22%3A%5B%5D%2C%22globalfilter%22%3Atrue%2C%22columnhider%22%3Afalse%2C%22iconfilters%22%3A%5B%5D%2C%22defaults%22%3A%5B%22TR-181%22%2C%22%22%5D%2C%22width%22%3A%5B%22150%22%2C%22150%22%5D%2C%22inverse%22%3A%5Bfalse%2Cfalse%5D%2C%22order%22%3A%5B0%2C1%5D%2C%22ddSeparator%22%3A%5B%5D%2C%22ddOperator%22%3A%5B%5D%2C%22sorts%22%3A%5B%22Date%20%E2%87%A9%22%5D%7D)
2. [IEEE 802.11 standards](https://standards.ieee.org/ieee/802.11/7028/)

# 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:

- **BeaconSNR**: Signal-to-noise ratio of received Beacon frames
- **DataFrameSNR**: Signal-to-noise ratio of received Data frames

### 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

- **10-9 (Excellent)**: Optimal connection quality, ideal for high-bandwidth applications such as 4K streaming, video conferencing, and online gaming
- **8-7 (Good)**: Reliable connection suitable for most online activities including HD streaming and general browsing
- **6-5 (Adequate)**: Sufficient for basic tasks like web browsing and email, but may experience issues with bandwidth-intensive applications
- **4-3 (Poor)**: Degraded connection with frequent interruptions, disconnections, and slow data rates
- **2-1 (Critical)**: Severely compromised or unusable connection

## 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:

- **SNR > 25 dB**: Supports 256-QAM modulation (highest data rates)
- **SNR ≈ 20 dB**: Typically uses 64-QAM modulation
- **Lower SNR values**: Fall back to simpler schemes such as 16-QAM or QPSK for reliability

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:

- **Optimize Router Placement**: Position your WiFi router centrally and elevated to improve signal strength throughout your space
- **Minimize Distance**: Move closer to your WiFi router when maximum performance is needed
- **Reduce Interference**: Identify and eliminate sources of noise such as microwaves, cordless phones, and neighboring WiFi networks
- **Channel Optimization**: Use a WiFi analyzer tool to identify the least congested channel in your area
- **Expand Coverage**: Deploy WiFi extenders or mesh networking systems to improve coverage in weak signal areas
- **Hardware Upgrades**: Consider routers with advanced features such as improved antennas, beamforming, or MIMO (Multiple Input Multiple Output) capabilities

## SNR Factor in Context

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

- **Signal Factor**: Measures raw signal strength
- **Noise Factor**: Quantifies environmental noise levels
- **SNR Factor**: Combines both metrics to evaluate overall connection quality

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](https://wiki.broadband-forum.org/display/RESOURCES/Broadband+Forum+Published+Resources#tf-filters=%7B%22selectfilters%22%3A%5B%5D%2C%22userfilters%22%3A%5B%22Number%22%5D%2C%22numberfilters%22%3A%5B%5D%2C%22datefilters%22%3A%5B%5D%2C%22globalfilter%22%3Atrue%2C%22columnhider%22%3Afalse%2C%22iconfilters%22%3A%5B%5D%2C%22defaults%22%3A%5B%22TR-181%22%2C%22%22%5D%2C%22width%22%3A%5B%22150%22%2C%22150%22%5D%2C%22inverse%22%3A%5Bfalse%2Cfalse%5D%2C%22order%22%3A%5B0%2C1%5D%2C%22ddSeparator%22%3A%5B%5D%2C%22ddOperator%22%3A%5B%5D%2C%22sorts%22%3A%5B%22Date%20%E2%87%A9%22%5D%7D)
2. [IEEE 802.11 Standards](https://standards.ieee.org/ieee/802.11/7028/)

# 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:

- **802.11b, g** – Older 2.4 GHz standards
- **802.11n** – Improved speed and range, operates on both 2.4 GHz and 5 GHz bands
- **802.11ac** – High-speed standard for 5 GHz band
- **802.11ax (Wi-Fi 6)** – Latest standard supporting both 2.4 GHz and 5 GHz bands

## 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

- **10** – Device using 802.11n (highest standard for 2.4 GHz)
- **8** – Device using 802.11g when 802.11n is available on the router
- **6** – Device using 802.11g, which is the best standard available on the router
- **4** – Device using older standards or unable to utilize the best available standard

### 5 GHz Band Scoring

- **10** – Device using the latest available standard (e.g., 802.11ac or 802.11ax)
- **8** – Device using 802.11n when a newer standard is available on the router
- **6** – Device using 802.11n, which is the best standard available on the router
- **4** – Device using older standards or unable to utilize the best available standard

## Interpreting Your Standard Factor Score

- **Score 10** – Your devices are using the best WiFi standard available, ensuring optimal performance
- **Score 8** – Good performance with room for improvement through device upgrades
- **Score 6** – Acceptable performance; consider upgrading devices or router for better results
- **Score 4** – Devices are not leveraging your router's full capabilities, potentially limiting WiFi performance

## 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:

- **802.11g** – Up to 54 Mbps
- **802.11n** – Up to 600 Mbps
- **802.11ac** – Up to 3.5 Gbps
- **802.11ax (Wi-Fi 6)** – Up to 9.6 Gbps

**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:

- **Upgrade devices** to models that support the latest WiFi standards
- **Update router firmware** to ensure you have the latest features and security patches
- **Replace older routers** with models supporting newer WiFi standards (802.11ac or 802.11ax)
- **Optimize band usage** by using legacy devices on the 2.4 GHz band while reserving 5 GHz for newer devices

## 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:

- **`Device.WiFi.Radio.MaxBitRate`**: The maximum PHY bit rate supported by this interface (expressed in *Mbps*)

### Step 2: Measure Actual Data Rates

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

- **`Device.WiFi.AccessPoint.{i}.AssociatedDevice.{i}.LastDataDownlinkRate`**: The data transmit rate in *kbps* that was most recently used for transmission from the access point to the associated device
- **`Device.WiFi.AccessPoint.{i}.AssociatedDevice.{i}.LastDataUplinkRate`**: The data transmit rate in *kbps* that was most recently used for transmission from the associated device to the access point

### 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:

- **10 (Excellent)**: 80% or more
- **8 (Very Good)**: 60-79%
- **6 (Good)**: 40-59%
- **4 (Fair)**: Less than 40%

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:

- MaxBitRate is 1300 Mbps (typical for 802.11ac with 80 MHz channel)
- LastDataDownlinkRate is 780 Mbps
- LastDataUplinkRate is 650 Mbps

**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?

- **10-9**: You're getting the most out of your WiFi setup. Ideal for all applications, including high-bandwidth activities.
- **8-7**: Very good performance. Suitable for most high-bandwidth applications.
- **6-5**: Good performance for general use, but might struggle with very demanding applications.
- **4**: Your speed is significantly below potential. You may experience issues with high-bandwidth applications.

## 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:

- **802.11n (20 MHz channel)**: Up to 72 Mbps
- **802.11n (40 MHz channel)**: Up to 150 Mbps
- **802.11ac (80 MHz channel)**: Up to 1300 Mbps
- **802.11ax (160 MHz channel)**: Up to 2400 Mbps

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

### References

- [1] [IEEE Std 802.11n-2009](https://ieeexplore.ieee.org/document/5307322)
- [2] [IEEE Std 802.11ac-2013](https://ieeexplore.ieee.org/document/6687187)
- [3] [IEEE Std 802.11ax-2021](https://ieeexplore.ieee.org/document/9442429)

## How Can You Improve Your Speed Factor?

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

- Ensure you're using the latest WiFi standards supported by your router
- Use wider channel bandwidths when possible (e.g., 40 MHz instead of 20 MHz)
- Reduce interference from other devices and networks
- Position your router for optimal coverage
- Consider upgrading your router or internet plan if you consistently get low scores

## 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:

- **`calculate_channel_score`** — Evaluates each channel based on interference from neighboring networks
  - **2.4GHz band:** Considers overlapping channels within a 4-channel range
  - **5GHz band:** Focuses on co-channel interference and adjacent channel interference

- **`find_best_channel`** — Iterates through available channels to identify the option with the least interference

### Bandwidth Optimization

**Function:** `evaluate_bandwidth`

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

- **High interference** (factor ≥ 8): Suggests wider bandwidth for increased throughput
- **Moderate interference** (6 ≤ factor < 8): Maintains current bandwidth settings
- **Low interference** (factor < 6): Recommends narrower bandwidth to reduce overlap

### Device-Specific Analysis

**Function:** `calculate_weighted_score`

This function performs comprehensive analysis of each connected device:

- Calculates a normalized score (1-10) based on multiple factors including:
  - Interference levels
  - Signal strength
  - Signal-to-Noise Ratio (SNR)
  - Connection speed
  - Noise levels
  - WiFi standard compatibility
- Generates device-specific recommendations based on the analysis results

## 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:

- **2.4GHz devices with excellent signal:** Suggests switching to 5GHz for better performance
- **5GHz devices with poor signal:** Recommends switching to 2.4GHz for better coverage

**Examples:**
- "Consider switching to 5GHz band for better performance, if supported by your device"
- "If device is far from router, consider switching to 2.4GHz band for better coverage"

### 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:

- **Weak signals:** Increase transmit power to improve coverage
- **Very strong signals:** Decrease transmit power to reduce interference

**Examples:**
- "Increase transmit power to improve signal strength. Current: 40, Max supported: 100"
- "Consider decreasing transmit power to reduce interference. Current: 100, Min supported: 20"

## Optimization Mechanisms

The system employs six core optimization strategies:

### 1. Intelligent Channel Selection

- Minimizes co-channel and adjacent channel interference
- Selects channels with the least impact from neighboring networks

### 2. Dynamic Bandwidth Adjustment

- Balances throughput potential against interference mitigation
- Recommends wider bandwidths in low-interference environments for higher speeds
- Suggests narrower bandwidths in high-interference scenarios for stability

### 3. Adaptive Band Steering

- Guides devices to the most appropriate frequency band based on their capabilities and current signal conditions

### 4. Transmit Power Optimization

- Adjusts transmit power to balance signal strength against potential interference with neighboring networks

### 5. Network Load Balancing

- Advises on distributing devices between 2.4GHz and 5GHz bands based on their physical location and usage patterns

### 6. Alternative Connection Methods

- Suggests WiFi extenders or Ethernet connections when wireless optimization alone proves insufficient

## 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](https://docs.zequenze.com/uploads/images/gallery/2026-04/ZOD7PBTZte3DNfGQ-tmp1hpiohwv.png)

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](https://docs.zequenze.com/uploads/images/gallery/2026-04/Nk1uDBCoqHy5RLu4-tmp53cifa81.png)

#### 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](https://docs.zequenze.com/uploads/images/gallery/2026-04/vIRbKUrNiZbOvvCt-tmpp6nukgbg.png)

### 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](https://docs.zequenze.com/uploads/images/gallery/2026-04/1OH5jwfjli1R134K-tmpxdie5n6s.png)

### Step 4: Create a Test Profile

A **Test Profile** links the Service to a device Type, so the engine knows which Service configuration to use when running a diagnostic.

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](https://docs.zequenze.com/uploads/images/gallery/2026-04/jw1A2ovaPvcg1tbM-tmpwpurkgoq.png)

### 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](https://docs.zequenze.com/uploads/images/gallery/2026-04/gWAuFAY9pqCNRtcg-tmpnz06y52t.png)

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](https://docs.zequenze.com/uploads/images/gallery/2026-04/CSJtTjZPQFsz0N3D-tmp5opxyzmw.png)

## 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](https://docs.zequenze.com/uploads/images/gallery/2026-04/7lTklvT5hndVTWGv-tmpp2ut7x2u.png)

### Recommendations and Tips

- **Recommendations** (yellow accent): Channel changes, bandwidth suggestions, or "No issues" when optimal
- **Tips** (blue accent): Missing parameters, discovery suggestions, or vendor contact recommendations
- **No clients**: When no WiFi clients are connected, Overall shows N/A with an info message

![Quality factor bars for both bands and the Recommendations panel](https://docs.zequenze.com/uploads/images/gallery/2026-04/BsM85AENVuvKcxaB-tmpunifwtxr.png)

### 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:**
- `Device.WiFi.Radio.{i}.Channel` — the CPE's current operating channel
- `Device.WiFi.Radio.{i}.CurrentOperatingChannelBandwidth` — channel width (affects adjacency range)
- **Neighboring networks** — the full list of detected WiFi neighbors from the NeighboringWiFiDiagnostic scan

#### 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 |

- **Proximity** is a value between 0 and 1 based on how close the neighbor's channel is within the adjacency range
- **Adjacency range** depends on the CPE's channel bandwidth: 20 MHz covers ~4 channels, 40 MHz covers ~8, 80 MHz covers ~16, 160 MHz covers ~32 (for 5 GHz / 6 GHz)
- A **bandwidth multiplier** is applied to the accumulated raw score based on the CPE's own bandwidth (40 MHz ×1.5, 80 MHz ×2, 160 MHz ×3)

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:**
- `LastDataDownlinkRate` and `LastDataUplinkRate` from each client (in kbps)
- `OperatingStandards` and `CurrentOperatingChannelBandwidth` from the radio

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

- **Without a Service/TestProfile**, the system auto-discovers radios from DeviceSettings (works for standard TR-181 CPEs with sequential indexes 1, 2)
- **For TR-098 or vendor-specific CPEs**, explicit Service configuration is required
- **Score weights** are per-Service — you can create multiple Services with different weight profiles for different environments
- The `{i}` placeholder is the **only** substitution the engine performs. All other numbers in paths are literal

### 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)* |