🔍 USB Inspector (v1.2.0)

A lightweight, zero-dependency Windows CLI tool and C# library designed to diagnose USB power delivery bottlenecks, hub topology hierarchies, and hardware connectivity health.

Read this in Traditional Chinese (繁體中文版) | Changelog

---

✨ Features

• TDD-Verified Unidirectional Architecture: Built with test-driven development (TDD) principles to ensure zero UI/diagnostic inconsistencies.
• Dynamic Port Icon Alignment: Real-time visual status icons (🟢, 🟡, 🔴, ⚪) matching device health ratings.
• Zero Hardcoding: 100% dynamic USB-IF topology detection using Windows SetupAPI & PnP registry lookups.
• Bluetooth D3 Suspend False Alarm Protection: Accurately differentiates power-saving D3 suspend states from genuine hardware failures.
• Dynamic Intermediate Hub Pruning: Automatically filters out internal pass-through hubs containing no terminal devices.
• Mobile Device Power Inspection: Automatically identifies USB 2.0 500mA speed bottlenecks for iPhones/iPads/Android devices.
• Dual-Target Compatibility: Compiles seamlessly under legacy .NET Framework 4.8 (csc.exe) and modern .NET 8.0+.

---

🚀 Quick Start

Running the Diagnostic Tool

UsbInspector.exe

Running the TDD Unit Test Suite

UsbInspector.Tests.exe

---

🛠️ Building from Source

Using legacy Windows csc.exe (.NET Framework 4.8):

C:\Windows\Microsoft.NET\Framework64\v4.0.30319\csc.exe /out:UsbInspector.exe src\UsbInspector\Program.cs src\UsbInspector\Models\*.cs src\UsbInspector\Services\*.cs

Building the TDD Test Runner:

C:\Windows\Microsoft.NET\Framework64\v4.0.30319\csc.exe /out:UsbInspector.Tests.exe src\UsbInspector.Tests\TestRunner.cs src\UsbInspector\Models\*.cs src\UsbInspector\Services\*.cs

---

📄 License

Distributed under the MIT License. See LICENSE for more information.