+34 641 10 27 16

Getting control board boot logs on Antminer

Firmware documentation

Board boot logs: when the web interface no longer answers

The ASIC does not come up, the web interface does not answer, the LEDs stay dark. In that situation the boot log is the only honest source of what is going on with the board.

The bench is the same one used for AML unlocking: the board, a 12 V power supply, a USB-UART adapter, PuTTY at 115200, GND to GND, RXD to LINUX_TX, TXD to LINUX_RX. The difference is that you leave the jumper alone. You just apply power and watch what the board says about itself at startup.

How to save the log to a file

Watching the terminal with your eyes is pointless: the lines scroll away in seconds. Set up logging before you apply power.

  1. In PuTTY open the Session section, then Logging.
  2. Pick the "All session output" mode.
  3. Set the file path, for example C:\logs\board-01.txt.
  4. Go back to Session, set the port and the speed to 115200, open the connection.
  5. Apply power to the board and wait until the stream of lines stops.
  6. Close the PuTTY window. The file is ready to send.
Image goes hereScreenshot of the PuTTY settings window, Session and Logging sections, All session output selected and a file path filled in
The Logging section in PuTTY. All session output mode writes down everything that came from the board

What to look for in the log

What you seeWhat it means
The log stops at the first uboot linesTrouble with board power or with the bootloader itself
The bootloader starts, the kernel does not come upThe NAND image is damaged, roll back from SD
The system boots but keeps rebooting in a loopUsually a mismatch between the build and the board revision
Sensor read errors at the end of the logLook at the hash board ribbon cables and the power
Nothing at all in the terminalWrong speed, RX and TX swapped, or the board has no power

You do not have to read the whole log yourself. Capture it, attach it to your ticket, and the rest is support work. What else to attach is listed in the section on contacting support.

When boot logs are not needed If the web interface opens, there is no point capturing a log over UART. Everything you need is in the interface itself: logs and the diagnostic report are collected in two clicks and hold more useful detail than the boot stream.

Quick answers

Do I need an expensive adapter?
No. Any USB-UART with working drivers will do, a plain CP2102 costs a few euros.
Can I capture a boot log without opening the ASIC?
No, the UART pins sit on the control board. If the ASIC is reachable over the network, use the firmware logs instead.
The log is several megabytes, is that normal?
Yes, in a reboot loop the file grows fast. Send it as is, no need to cut out the middle.
Written by , ASIC repair and tuning engineer at asic.es.