|
8 | 8 |
|
9 | 9 | A comprehensive WiFi analysis and troubleshooting tool that diagnoses connectivity issues, optimizes performance, and provides distribution-specific fixes for modern Linux systems. Features DFS radar interference detection, WiFi 7/6E support, and modern VPN integration.
|
10 | 10 |
|
| 11 | +## β οΈ Framework Support Disclaimer |
| 12 | + |
| 13 | +**Before implementing any power management changes recommended by this tool, please verify with Framework Support first.** |
| 14 | + |
| 15 | +While the Enhanced WiFi Analyzer provides valuable diagnostic information and generates safe configuration scripts, power management settings should only be modified when addressing specific connectivity issues. The tool may recommend disabling PCIe ASPM (Active State Power Management) or NetworkManager power saving features, but these changes should only be applied if: |
| 16 | + |
| 17 | +1. **You are experiencing actual WiFi connectivity problems** (disconnections, micro-dropouts, poor roaming) |
| 18 | +2. **The analysis clearly identifies power management as the root cause** |
| 19 | +3. **Framework Support has reviewed your specific situation and confirmed the recommendation** |
| 20 | + |
| 21 | +### Why This Matters |
| 22 | + |
| 23 | +Power management features exist for good reasons - they extend battery life and reduce heat generation. Disabling them unnecessarily can impact your system's efficiency without providing any benefits. The diagnostic tools help identify *potential* power management conflicts, but not every detection requires action. |
| 24 | + |
| 25 | +### Recommended Workflow |
| 26 | + |
| 27 | +1. **Run the analysis** to identify potential issues: Run the script per the instructions. |
| 28 | +2. **Document your specific symptoms** (connection drops, poor performance, etc.) |
| 29 | +3. **Contact Framework Support** with both your symptoms and the tool's findings |
| 30 | +4. **Apply recommended changes only** after confirmation from Support |
| 31 | +5. **Test thoroughly** and revert changes if they don't resolve your specific issues |
| 32 | + |
| 33 | +### Contact Framework Support |
| 34 | + |
| 35 | +[Contact](https://framework.kustomer.help/contact/support-request-ryon9uAuq) - Ask to send your findings to the Linux Support Team |
| 36 | + |
| 37 | +Remember: These diagnostic tools are designed to help identify issues, not automatically fix them. Always verify recommendations with Framework Support before making system changes. |
| 38 | + |
11 | 39 | ## π Table of Contents
|
12 | 40 |
|
13 | 41 | - [π Key Features](#-key-features)
|
@@ -300,26 +328,6 @@ Tool provides ASPM fixes and power management optimization
|
300 | 328 | 2. **Framework + Mesh users** - Follow up with Framework's Mesh Analyzer for specialized optimization
|
301 | 329 | 3. **Best results** - Use both tools for complete coverage of modern WiFi challenges
|
302 | 330 |
|
303 |
| -## π Related Tools |
304 |
| - |
305 |
| -### **Specialized WiFi Analysis** |
306 |
| -- **[Framework WiFi Mesh Network Analyzer](https://github.com/FrameworkComputer/linux-docs/tree/main/MeshAnalyzer#wifi-mesh-network-analyzer)** - Framework's dedicated tool for mesh network performance analysis and optimization |
307 |
| - |
308 |
| -### **When to Use Which Tool** |
309 |
| -| Scenario | Enhanced WiFi Analyzer | Framework Mesh Analyzer | |
310 |
| -|----------|----------------------|------------------------| |
311 |
| -| **General WiFi issues** | β
Primary tool | βͺ Not needed | |
312 |
| -| **DFS disconnections** | β
Specialized detection | βͺ Limited coverage | |
313 |
| -| **VPN conflicts** | β
Modern VPN support | βͺ Not covered | |
314 |
| -| **Framework + Mesh** | β
General analysis | β
Mesh optimization | |
315 |
| -| **Thermal/power issues** | β
Comprehensive | βͺ Not covered | |
316 |
| -| **Mesh performance tuning** | βͺ Basic detection | β
Specialized analysis | |
317 |
| - |
318 |
| -### **Complementary Workflow** |
319 |
| -1. **Start here** - Run Enhanced WiFi Analyzer for comprehensive system health |
320 |
| -2. **Framework + Mesh users** - Follow up with Framework's Mesh Analyzer for specialized optimization |
321 |
| -3. **Best results** - Use both tools for complete coverage of modern WiFi challenges |
322 |
| - |
323 | 331 | ## π€ Contributing
|
324 | 332 |
|
325 | 333 | Contributions welcome! Areas of particular interest:
|
|
0 commit comments