AZIC Education
TroubleshootingError Codes

Antminer Error Codes — Complete Reference Guide

Comprehensive reference for all Antminer error codes, LED status indicators, and fault messages. Includes severity, common causes, quick fixes, and links to detailed troubleshooting guides for every error.

Overview

Antminer ASIC miners report errors through the web UI status page, kernel logs, and LED status indicators. Understanding these error codes is critical for fast diagnosis — each code points to a specific subsystem and narrows down the possible causes.

This guide covers every known Antminer error code organized by category, along with severity ratings, probable causes, and recommended actions. It applies to all Antminer models including S9, S17, S19 series, S21 series, T-series, and L-series.

How to Access Error Logs

  1. Navigate to your miner's IP address in a web browser
  2. Log in (default credentials: root / root or admin / admin)
  3. Go to "System""Kernel Log" or "Miner Status"
  4. Error messages appear in the status table and in the log output

The web UI shows the most recent errors and the current status of each hashboard, fan, and temperature sensor.

# Connect via SSH
ssh root@<miner-ip>
# Password: root (or admin, depending on firmware)

# View full kernel log
dmesg

# Filter for errors only
dmesg | grep -iE "error|fail|fault|warn"

# View real-time log output
dmesg -w

The kernel log contains hardware-level messages including chain detection, voltage errors, and temperature faults.

# Connect via SSH
ssh root@<miner-ip>

# View the main miner application log
cat /tmp/log/bmminer.log

# View real-time miner log
tail -f /tmp/log/bmminer.log

# Check chip frequency and status
cat /tmp/freq.txt

# View detailed chip status
bitmain-soc --chips 2>/dev/null

The miner log contains application-level messages including pool connections, chip enumeration, and hashrate data.

LED Status Indicator Guide

Before checking logs, the LED on the front panel provides an immediate visual indicator:

LED StateMeaningAction
Solid GreenNormal operationNo action needed
Blinking GreenBooting / initializingWait 3–5 minutes for boot to complete
Solid RedCritical error — miner stoppedCheck web UI and kernel log for specific error
Blinking RedFault detected — miner attempting recoveryCheck logs; may resolve on its own
Alternating Red/GreenFirmware update in progressDo NOT power off — wait for completion
Red, then OffBoot failure or PSU issueCheck PSU, try reflashing firmware
No LEDNo power reaching control boardCheck PSU output, power cable, fuse
Rapid Red Blink (5Hz+)IP conflict or network errorCheck network configuration

Never power off a miner showing alternating Red/Green (firmware update). Interrupting a firmware flash can brick the control board, requiring SD card recovery.


Chain / Hashboard Errors

These errors relate to hashboard detection, communication, and ASIC chip enumeration.

Chain find 0 ASIC

MessageChain [X]: find 0 ASIC
SeverityCritical
MeaningThe control board cannot detect any ASIC chips on hashboard X
Common CausesLoose data connector, broken CLK/CI signal trace, failed first chip in chain, EEPROM failure, PIC failure
Quick FixReseat the hashboard connector. Swap the board to a different slot to determine if the board or the slot is faulty.
Detailed GuideHashboard Not Detected

Chain not detected / Chain find 0 PCB

MessageChain [X]: find 0 pcb or Chain [X] not found
SeverityCritical
MeaningThe entire hashboard is not recognized by the control board
Common CausesNo hashboard installed in that slot, completely loose connector, EEPROM unreadable, PIC not responding, cable fault
Quick FixVerify the board is physically installed. Reseat connector. Try a different cable.
Detailed GuideHashboard Not Detected

Missing ASIC chips (partial)

MessageChain [X]: find [Y] ASIC (where Y is less than expected)
SeverityWarning to High
MeaningSome but not all chips on the board are detected
Common CausesFailed chip breaking the daisy chain, broken signal trace mid-chain, cold solder joint, voltage domain failure
Quick FixCheck ASIC status page — chips show as "o" (OK) or "x" (missing). Identify the position of the first missing chip.
Detailed GuideMissing Chips Troubleshooting

Chip bin error

MessageChip bin error or chip_bin mismatch
SeverityWarning
MeaningThe chip hardware revision does not match what the firmware expects
Common CausesWrong firmware version for the hardware revision, replacement chip with different bin/revision, EEPROM data mismatch
Quick FixVerify you are running the correct firmware for your specific model and hardware revision. Reflash the correct firmware version.

Chain incomplete

MessageChain [X]: incomplete or chain init fail
SeverityHigh
MeaningThe chip chain initialization did not complete — some chips responded but the full chain could not be established
Common CausesA chip in the middle of the chain is unresponsive, signal integrity issue (noisy CLK line), voltage domain not powering up
Quick FixPower cycle the miner. If persistent, check for voltage domain failures and signal trace integrity.

BO signal error

MessageBO signal error or BO timeout
SeverityHigh
MeaningThe chip output signal (Busy Out) is not responding as expected during chip addressing
Common CausesFailed chip, damaged BO trace, timing issue from noisy signal path
Quick FixIdentify the chip position from the log. Inspect the BO trace for damage. May require chip replacement.

Temperature Errors

Temp too high

MessageTemp too high or over max temp
SeverityCritical (causes shutdown)
MeaningChip temperature has exceeded the maximum safe threshold (typically 85–95°C)
Common CausesInsufficient cooling (dust, failed fan, high ambient temp), degraded thermal paste, blocked airflow, overclocking
Quick FixPower off immediately. Clean heatsinks, check all fans, verify airflow path is clear.
Detailed GuideHigh Temperature Troubleshooting

Temp sensor read error

Messagetemp sensor read fail or invalid temp reading
SeverityHigh
MeaningThe temperature sensor on the hashboard returned an invalid reading or did not respond
Common CausesFailed temperature sensor IC (LM75, TMP451, or NCT218), broken I2C trace to sensor, sensor desoldered
Quick FixIf all other temperatures are normal and the miner is otherwise functioning, the sensor itself may have failed. Replace the sensor IC.

Hashboard overheat

MessageHashboard overheat or PCB temp too high
SeverityCritical
MeaningThe PCB-level temperature sensor (separate from chip temperature) is reporting excessive heat
Common CausesA component on the board is drawing excessive current (shorted chip, failed regulator), or the board-level sensor is near a hot spot with inadequate cooling
Quick FixCheck for hot spots with thermal camera or by touch (carefully). Look for damaged voltage regulators or shorted chips.

Temp too low

MessageTemp too low or temp below threshold
SeverityWarning
MeaningThe reported temperature is below the minimum expected (sometimes negative or 0°C readings)
Common CausesFaulty temperature sensor, broken sensor wiring, environment genuinely too cold for operation (below 0°C)
Quick FixIf the environment is not extremely cold, the sensor has likely failed. Check sensor connections and replace if needed.

Fan Errors

Fan speed error

MessageFan speed error or fan [X] speed too low
SeverityHigh
MeaningA fan is not reaching the expected RPM
Common CausesFan motor failing, fan cable loose or damaged, fan blocked by debris, bearing worn out
Quick FixCheck that all fans are spinning. Reseat fan connectors. Replace the failed fan.
Detailed GuideFan Error Troubleshooting

Fan not detected

MessageFan [X] not detected or fan lost
SeverityCritical (most firmware will shut down)
MeaningThe fan tachometer signal is not being received — the miner thinks the fan is not present
Common CausesFan disconnected, fan cable damaged, fan motor completely failed, control board fan header fault
Quick FixVerify fan is plugged in. Try swapping fans between headers to isolate fan vs. header issue.

Fan speed too high

MessageFan speed abnormal or fan [X] RPM above max
SeverityWarning
MeaningThe fan is reporting an RPM higher than physically possible — usually a signal issue, not an actual speed problem
Common CausesElectrical noise on the tachometer line, loose connector creating intermittent contact, wrong fan model with different pulse count
Quick FixReseat the fan connector. If using a replacement fan, verify it has the correct number of tachometer pulses per revolution for the miner model.

Power Errors

Power supply fault

MessagePower supply fault or PSU error
SeverityCritical
MeaningThe PSU has reported a fault condition or the miner detected a power anomaly
Common CausesPSU overcurrent/overtemperature protection tripped, PSU capacitor degradation, input voltage too low/high, hashboard short causing PSU overload
Quick FixCheck PSU output voltage. Try with fewer hashboards to reduce load. Test with a different PSU.
Detailed GuidePower Issues Troubleshooting

Voltage error

MessageVoltage error or Vol Err chain [X]
SeverityHigh
MeaningA voltage domain on the hashboard is reading outside acceptable range
Common CausesFailed buck converter, shorted ASIC chip, damaged power trace, PSU voltage droop, corroded connector
Quick FixCheck PSU output voltage. Inspect the hashboard for visible damage. Measure voltage domains.
Detailed GuideAbnormal Chip Voltage

Undervoltage warning

Messageundervolt or voltage too low
SeverityWarning
MeaningOne or more voltage domains are below the expected voltage, but not critically failed
Common CausesPSU aging, high ambient temperature reducing PSU efficiency, corroded power connector, early-stage regulator degradation
Quick FixCheck PSU output under load. Clean power connectors. If PSU is aged (2+ years), consider replacement.

Overvoltage error

Messageovervolt or voltage too high
SeverityCritical
MeaningA voltage domain is reading above the safe maximum — chips may be damaged
Common CausesVoltage regulator feedback resistor open, regulator running uncontrolled
Quick FixShut down immediately. Overvoltage can permanently destroy ASIC chips within seconds. The voltage regulator circuit must be repaired before the board is powered again.

Network Errors

Network error / Pool connection failed

Messagepool connect fail or network error
SeverityWarning (miner continues attempting reconnection)
MeaningThe miner cannot reach the configured mining pool
Common CausesIncorrect pool URL, DNS failure, network cable disconnected, router/switch issue, pool server down
Quick FixVerify pool URL and port. Check Ethernet cable. Ping the miner from another device. Try backup pool.
Detailed GuideNetwork Problems Troubleshooting

IP conflict

MessageIP conflict detected or rapid LED blinking
SeverityWarning
MeaningAnother device on the network has the same IP address
Common CausesStatic IP assignment conflict, DHCP server assigning duplicate IPs, or a second miner was cloned with the same configuration
Quick FixUse DHCP instead of static IP, or assign a unique static IP. Reset network settings via the physical reset button.

DNS resolution failure

MessageDNS resolve failed or hostname not found
SeverityWarning
MeaningThe miner cannot resolve the pool hostname to an IP address
Common CausesDNS server unreachable, incorrect DNS settings, ISP DNS issues
Quick FixConfigure a reliable DNS server (e.g., 8.8.8.8 or 1.1.1.1). Or use the pool's IP address directly instead of hostname.

Firmware Errors

Firmware checksum error

Messagefirmware checksum error or image verify fail
SeverityCritical
MeaningThe firmware image in NAND flash has become corrupt
Common CausesPower loss during firmware update, NAND flash wear, bad firmware download
Quick FixReflash firmware using the SD card recovery method. Download the firmware file again (the original download may have been corrupt).

NAND flash error

MessageNAND read error or UBI error
SeverityCritical
MeaningThe NAND flash storage on the control board is failing
Common CausesNAND flash has reached end of life (finite write cycles), physical damage, manufacturing defect
Quick FixReflash firmware to remap bad blocks. If errors persist, the NAND chip may need replacement (control board repair).

Configuration error / Config corrupt

Messageconfig read error or config corrupt, using defaults
SeverityWarning
MeaningThe miner's configuration file is corrupt and defaults are being used
Common CausesPower loss during config write, NAND degradation, firmware bug
Quick FixReconfigure the miner through the web UI (pool URLs, worker name, etc.). The miner will create a new config file.

PIC / EEPROM Errors

PIC communication error

MessagePIC error or PIC read fail chain [X]
SeverityCritical
MeaningThe control board cannot communicate with the PIC microcontroller on the hashboard
Common CausesPIC chip failure, I2C bus fault (broken trace, failed pull-up resistor), EEPROM failure preventing PIC initialization
Quick FixTry reseating the hashboard connector. If persistent, the PIC chip may need replacement — this requires a pre-programmed replacement and soldering equipment.
Detailed GuidePIC Microcontrollers

EEPROM error

MessageEEPROM error or EEPROM read fail
SeverityCritical
MeaningThe EEPROM on the hashboard cannot be read
Common CausesEEPROM chip failure, I2C bus short or open, data corruption, connector issue affecting I2C lines
Quick FixReseat connector (I2C lines pass through the connector). If persistent, the EEPROM chip needs replacement and reprogramming.
Detailed GuideEEPROM Chips

EEPROM data mismatch

MessageEEPROM data mismatch or board info invalid
SeverityHigh
MeaningThe EEPROM data does not match what the firmware expects for this model
Common CausesEEPROM was programmed with data from a different model, partial data corruption, board was previously used in a different miner model
Quick FixReprogram the EEPROM with the correct data for the specific board model and revision.

Miscellaneous Errors

Watchdog reset

Messagewatchdog reset or wdt timeout
SeverityHigh
MeaningThe firmware hung and the hardware watchdog timer forced a reboot
Common CausesFirmware bug, memory leak, corrupted firmware, control board hardware issue
Quick FixCheck if the issue is consistent. Try a different firmware version. If persistent across firmware versions, suspect control board hardware.
Detailed GuideFrequent Restarts

Memory allocation failure

Messageout of memory or malloc fail
SeverityCritical
MeaningThe control board has run out of RAM
Common CausesMemory leak in firmware, too many concurrent operations, firmware bug
Quick FixReboot the miner. If recurrent, try a different firmware version. Factory reset to clear any accumulated state.

CRC error

MessageCRC error or data integrity check failed
SeverityWarning
MeaningData corruption detected during chip-to-control-board communication
Common CausesSignal integrity issue (noisy environment, damaged trace), electromagnetic interference, degraded chip I/O
Quick FixIf occasional, may be acceptable (firmware retries). If frequent, check signal traces and shield from EMI sources.

Clock error

MessageCLK error or PLL lock fail
SeverityHigh
MeaningA chip's internal PLL (Phase-Locked Loop) cannot lock to the target frequency
Common CausesChip degradation, excessive overclocking, voltage too low for target frequency, damaged clock trace
Quick FixReduce operating frequency. If the error is on one specific chip, it may need replacement.

Hash test failure

Messagehash test fail or chip [X] test fail
SeverityHigh
MeaningA chip failed the built-in self-test during initialization
Common CausesDegraded chip, voltage issue affecting that chip's domain, thermal damage
Quick FixCheck the voltage domain for the failing chip. If voltage is correct, the chip is likely degraded and may need replacement.

Frequency setting error

Messagefreq set fail or frequency out of range
SeverityWarning
MeaningThe firmware could not set the requested operating frequency on one or more chips
Common CausesRequested frequency exceeds chip capability, voltage too low to support frequency, chip PLL issue
Quick FixUse the default frequency for your model. If custom overclocking, reduce the target frequency.

I2C bus error

MessageI2C error or I2C bus timeout
SeverityHigh
MeaningThe I2C communication bus has a fault
Common CausesShorted I2C line (SDA or SCL), missing pull-up resistor, damaged connector pin carrying I2C signals, component on the bus holding the line low
Quick FixReseat connectors. Check I2C pull-up resistors (typically 4.7K to 3.3V). Measure SDA and SCL lines — they should idle high (3.3V).

Error Code Quick Reference Table

ErrorSeverityCategoryMost Likely CauseFirst Action
Chain find 0 ASICCriticalChainConnector / first chipReseat connector
Chain not detectedCriticalChainConnector / EEPROMReseat, swap slots
Missing ASICs (partial)HighChainFailed chip in chainCheck ASIC status map
Chip bin errorWarningChainWrong firmwareReflash firmware
BO signal errorHighChainFailed chipCheck chip at error position
Temp too highCriticalTempCooling insufficientClean, check fans
Temp sensor read errorHighTempFailed sensor ICReplace sensor
Hashboard overheatCriticalTempComponent fault or coolingThermal camera inspection
Fan speed errorHighFanFan motor failingReplace fan
Fan not detectedCriticalFanFan disconnectedReseat fan connector
Power supply faultCriticalPowerPSU overload/failureTest PSU output
Voltage errorHighPowerBuck converter / shortMeasure domain voltages
Network errorWarningNetworkCable / configCheck cable and pool URL
Firmware checksum errorCriticalFirmwareCorrupt flashSD card reflash
NAND flash errorCriticalFirmwareFlash wear-outReflash, may need board
PIC errorCriticalPICPIC chip failureReseat, then replace PIC
EEPROM errorCriticalEEPROMEEPROM chip failureReseat, then replace EEPROM
Watchdog resetHighSystemFirmware hangTry different firmware
CRC errorWarningSignalTrace damage / EMICheck signal traces
CLK / PLL errorHighChipChip degradationReduce frequency
Hash test failHighChipDegraded chipCheck voltage, replace chip
I2C bus errorHighBusWiring / pull-upsCheck I2C lines

When to Seek Professional Help

  • EEPROM reprogramming: If you do not have the correct EEPROM data for your board model, a professional with a library of known-good dumps can help
  • PIC replacement: Requires a pre-programmed PIC chip specific to your board model — professionals typically stock these
  • NAND flash replacement: Requires BGA rework equipment and a programmed NAND chip
  • Multiple simultaneous errors: If you see errors across multiple categories simultaneously, a professional can more efficiently diagnose the root cause
  • Persistent errors after replacing obvious components: May indicate a subtle PCB-level issue requiring schematic analysis

Frequently Asked Questions

How do I factory reset my Antminer?

Hold the reset button (small hole on the front panel) for 10 seconds while the miner is powered on. The LED will flash and the miner will reboot with default settings. You will need to reconfigure pool URLs and network settings.

Can I ignore warning-level errors?

Some warnings are informational and do not affect mining (e.g., occasional CRC errors). However, warnings often escalate to critical errors over time. If a warning persists across multiple reboots, investigate it before it becomes a critical failure.

My miner shows an error I cannot find in this guide. What should I do?

Check the full kernel log for additional context around the error. Search the error message text online — Bitmain support forums, BitcoinTalk, and Reddit r/BitcoinMining often have discussions about uncommon errors. If the error contains a number, it may be a model-specific code not covered here.

Do error codes differ between firmware versions?

Yes. Third-party firmware (Braiins OS, VNish, LuxOS) uses different error messages than stock Bitmain firmware. The underlying hardware faults are the same, but the log messages may be worded differently. This guide covers stock Bitmain firmware messages; consult the third-party firmware documentation for their specific messages.