Skip to content

Commit a18949a

Browse files
authored
Update README.md
Framework Support Disclaimer
1 parent e6166a2 commit a18949a

File tree

1 file changed

+28
-20
lines changed

1 file changed

+28
-20
lines changed

β€ŽEnhanced-WiFi-Analyzer/README.md

Lines changed: 28 additions & 20 deletions
Original file line numberDiff line numberDiff line change
@@ -8,6 +8,34 @@
88

99
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.
1010

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+
1139
## πŸ“š Table of Contents
1240

1341
- [πŸš€ Key Features](#-key-features)
@@ -300,26 +328,6 @@ Tool provides ASPM fixes and power management optimization
300328
2. **Framework + Mesh users** - Follow up with Framework's Mesh Analyzer for specialized optimization
301329
3. **Best results** - Use both tools for complete coverage of modern WiFi challenges
302330

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-
323331
## 🀝 Contributing
324332

325333
Contributions welcome! Areas of particular interest:

0 commit comments

Comments
Β (0)