Whatsminer Common Diagnostics Guide
Universal diagnostic guide for all Whatsminer models — WhatsMiner Tool, SSH commands, error codes, LED status, and firmware management.
Overview
This guide covers diagnostic tools and techniques applicable to all Whatsminer models (M20S, M30S, M30S++, M50, M50S, M56S, M60, M60S, and newer). Unlike Bitmain's Antminer platform which uses cgminer, Whatsminer uses its own btminer software and WhatsMiner Tool for management and diagnostics.
Diagnostic Tool #1: WhatsMiner Tool
The WhatsMiner Tool is the primary management application for Whatsminer miners:
Installation:
- Download from MicroBT's official support page
- Available for Windows (primary platform)
- Install and launch — no special dependencies required
Key features:
- Network scanning — finds all Whatsminers on your network
- Real-time status monitoring (hashrate, temperature, fan speed)
- Firmware upgrade management
- Batch configuration (pool settings, network settings)
- Fault code display and basic diagnostics
- SD card firmware preparation tool
Basic usage:
- Open WhatsMiner Tool
- Click "Scan" to find miners on your network (or enter IP directly)
- Select a miner to view detailed status
- Navigate tabs: Status, Configuration, Firmware, Diagnostics
Diagnostic Tool #2: SSH Access
For deeper diagnostics, SSH into the miner:
# Connect via SSH
ssh root@<miner-ip>
# Default password varies by firmware version (commonly blank or a default string)
# View real-time mining log
tail -f /tmp/btminer.log
# Check chip status
cat /tmp/chip_status
# View hashboard detection
cat /tmp/board_status
# Check temperatures
cat /tmp/temperature
# View fan speeds
cat /tmp/fan_speed
# Network configuration
ifconfig eth0
# System information
cat /etc/version
uname -aAdvanced btminer commands:
# Restart mining software without rebooting
killall btminer
/usr/bin/btminer &
# Check mining pool connection
cat /tmp/pool_status
# View error log
cat /var/log/messages | grep -i "error\|fault\|fail"
# Check power consumption
cat /tmp/power_statusDiagnostic Tool #3: Web Dashboard
Access the web dashboard at http://<miner-ip>:
Dashboard sections:
- Summary — overall hashrate, uptime, pool status
- Hash Board — per-board chip count, temperature, hashrate
- Pool — pool connection status, accepted/rejected shares
- Fan — fan speed percentages, RPM readings
- Network — IP configuration, DNS settings
- System — firmware version, uptime, error log
- Configuration — pool settings, fan mode, network settings
LED Status Codes
Whatsminer LED patterns differ from Antminer:
| LED Pattern | Meaning | Action |
|---|---|---|
| Green steady | Normal mining operation | None needed |
| Green blinking | Initializing / starting up | Wait 3–5 minutes |
| Red steady | Hardware fault detected | Check fault code in WhatsMiner Tool |
| Red blinking | Firmware upgrade in progress | Do NOT power off |
| Red + Green alternating | Recovery mode | Firmware recovery in progress |
| All off | No power | Check PSU, AC input |
| Network LED off | No network link | Check cable, switch |
Error Code Reference
Whatsminer uses numeric fault codes. Here are the most common:
| Fault Code | Description | Severity | Common Fix |
|---|---|---|---|
| 110 | Temperature sensor error | Medium | Check NTC thermistors, wiring |
| 111 | Over-temperature protection triggered | High | Improve cooling, check fans, check thermal paste |
| 130 | Hashboard communication error | High | Reseat connector, check data lines |
| 131 | Hashboard not detected | High | Reseat connector, check hashboard |
| 200 | Voltage abnormality | High | Check domain voltages, PSU output |
| 201 | Under-voltage detected | Medium | Check PSU, AC input voltage |
| 231 | Chip voltage error | High | Voltage domain failure — repair needed |
| 301 | Fan speed error | Medium | Check fan, replace if needed |
| 302 | Fan not detected | Medium | Check fan connector, replace fan |
| 400 | Power supply fault | High | Check PSU, AC input, cables |
| 500 | Firmware error | Medium | Update or reflash firmware |
| 600 | Network error | Low | Check cable, DHCP, DNS |
Fault codes are displayed in the WhatsMiner Tool, web dashboard, and btminer logs. Multiple fault codes can occur simultaneously — always address the highest-severity code first.
Common Issues Across All Models
Issue 1: Hashboard Not Detected (Fault 130/131)
Diagnosis steps:
- Check physical connector — reseat both ends
- Try the hashboard in a different slot
- Check 12V power at the hashboard connector
- Check data signal continuity
- Try a different hashboard in the suspect slot (isolates board vs control board issue)
Issue 2: Temperature Errors (Fault 110/111)
Diagnosis steps:
- Check actual ambient temperature
- Verify fan operation (all fans spinning at expected speed)
- Check for dust blockage in heatsinks and fans
- SSH in and read raw temperature data
- If readings are abnormal (-1, 999, or wildly inconsistent), the sensor has failed
Issue 3: Voltage Errors (Fault 200/201/231)
Diagnosis steps:
- Check PSU output voltage (should be 12V ±5%)
- Check AC input voltage
- If PSU output is correct, the issue is on the hashboard — perform domain voltage testing
- Disconnect hashboards one at a time to identify which board has the fault
Issue 4: Low Hashrate
Not always a fault code — may just show reduced performance:
- Check chip temperatures — overheating causes throttling
- Check per-board hashrate in web dashboard — is one board underperforming?
- Check pool connection — high reject rate indicates network or configuration issue
- Check firmware version — older firmware may have performance bugs
Firmware Management
Checking Firmware Version
# Via SSH
cat /etc/version
# Via WhatsMiner Tool: Status tab shows firmware version
# Via Web Dashboard: System page shows firmware versionUpdating Firmware
- Download the firmware file from MicroBT support
- Open WhatsMiner Tool → select miner(s)
- Click "Upgrade Firmware"
- Browse to the firmware file
- Click "Start" — wait for completion (5–15 minutes)
- Miner reboots automatically
- Download firmware for your exact model
- Format microSD as FAT32
- Copy firmware files to SD card root
- Power off miner, insert SD card
- Power on — miner enters recovery mode
- Wait 5–10 minutes for flash
- Remove SD card after successful boot
- Log in to web dashboard
- Navigate to System → Firmware Upgrade
- Upload the firmware file
- Click Upgrade — wait for completion
- Miner reboots automatically
Always use firmware for your exact model (M30S ≠ M30S+ ≠ M30S++). Incorrect firmware can brick the control board. Verify model before flashing.
Factory Reset
To reset all settings to factory defaults:
- Use the SD card firmware flash method (resets everything)
- Or via SSH:
factory_reset(if available in your firmware version) - Or via web dashboard: System → Factory Reset
Network Diagnostics
# Check IP configuration
ifconfig eth0
# Test internet connectivity
ping -c 4 8.8.8.8
# Test DNS resolution
ping -c 4 stratum.slushpool.com
# Check pool connection
cat /tmp/pool_status
# View network errors
dmesg | grep -i "eth\|network\|link"Common network fixes:
- No IP: Check cable, try different port, verify DHCP server
- IP but no pool: Check DNS, pool address, firewall rules
- High latency: Check for network congestion, try a geographically closer pool
When to Seek Professional Repair
| Situation | DIY | Professional |
|---|---|---|
| Fan replacement | ✅ | Not needed |
| Connector cleaning | ✅ | Not needed |
| Firmware recovery | ✅ | Not needed |
| Single chip replacement | ✅ (if skilled) | Recommended for beginners |
| Multiple domain failure | Maybe | ✅ Recommended |
| Control board failure | ❌ | ✅ |
| Immersion board corrosion | Maybe | ✅ Recommended |
Troubleshooting FAQ
Where do I download WhatsMiner Tool?
From MicroBT's official website support section. The tool is free and does not require registration.
Can I use Bitmain diagnostic tools on Whatsminer?
No. Bitmain tools (IPReporter, BMMiner, etc.) are not compatible with Whatsminer hardware. Use WhatsMiner Tool and btminer-based commands.
How do I find the default password for my Whatsminer?
Default credentials vary by firmware version. Check MicroBT's documentation for your specific firmware version. Common defaults include blank password or a model-specific string.
Can I install custom firmware on Whatsminer?
Whatsminer has fewer custom firmware options than Antminer. MicroBT's stock firmware is the primary option. Some third-party firmware may be available for specific models — check with the firmware vendor for compatibility.
What is the difference between fault codes and error messages?
Fault codes (numeric: 110, 130, 200, etc.) are hardware-detected conditions reported by the mining software. Error messages in the system log provide more detailed text descriptions. Use fault codes for quick identification and error messages for detailed debugging.