Telemetry¶
This project includes optional, privacy-respecting telemetry to help understand usage and improve the driver.
Overview¶
Telemetry is disabled by default and only enabled if you explicitly opt-in during installation.
What is Collected¶
When telemetry is enabled, the following anonymous data is sent:
| Data | Example | Purpose |
|---|---|---|
| Event type | install, uninstall |
Track adoption |
| Kernel version | 6.18.5 |
Kernel compatibility |
| Package version | 1.5.0 |
Version distribution |
| Chip type | mt7925, mt7921 |
Hardware support |
| Bus type | pci, usb |
Interface usage |
| Clang kernel | yes, no |
Build compatibility |
| Session ID | abc123 |
Correlate install/uninstall |
What is NOT Collected¶
- IP addresses (not logged by analytics service)
- MAC addresses
- Personal information
- WiFi network names/passwords
- System hostname
- User accounts
How it Works¶
Telemetry uses GoatCounter, a privacy-focused analytics service:
- No cookies
- No personal data collection
- Open source
- GDPR compliant
Events are sent as simple HTTP requests:
Enabling Telemetry¶
During Installation¶
# Enable telemetry
sudo MT7925_TELEMETRY=1 ./install.sh
# Disable telemetry (default)
sudo MT7925_TELEMETRY=0 ./install.sh
Check Current Status¶
Disable After Installation¶
Network Handling¶
Since the telemetry runs during WiFi driver installation, network may not be available immediately. The installer handles this by:
- Attempt immediate send - If network is available
- Queue for later - If network is unavailable, event is saved
- Retry on boot - Queued events are sent on next boot
Queue location: /var/lib/mt7925-telemetry-queue
Source Code¶
The telemetry implementation is fully transparent:
- Install script:
dkms/install.sh - Uninstall script:
dkms/uninstall.sh - Config file:
/etc/mt7925-telemetry.conf
Removing Telemetry Data¶
To completely remove telemetry:
# Disable telemetry
echo "MT7925_TELEMETRY=0" | sudo tee /etc/mt7925-telemetry.conf
# Remove queue file
sudo rm -f /var/lib/mt7925-telemetry-queue
# Remove config file (optional)
sudo rm -f /etc/mt7925-telemetry.conf
Why Telemetry?¶
Anonymous usage data helps:
- Prioritize kernel versions - Know which kernels need support
- Track adoption - Understand how many users benefit from fixes
- Identify issues - Correlate hardware types with problems
- Justify upstream work - Show maintainers that fixes are needed
Questions?¶
If you have concerns about telemetry, please open a GitHub Discussion.