Hardware Troubleshooting

How to reflash

Having issues? Try a fresh start by reflashing your hardware.

Follow the how to flash RoninOS section of the install guide.

My system is having issues

Usually hardware problems are the culprit if your system is acting abnormal.

If you notice:

• General commands are failing.
• RoninUI is not accessbile.
• Dojo is not running or fails.
• You are having difficulty progressing.

Then it’s time to troubleshoot your hardware.

How to find hardware issues

1. Try rebooting the device.

2. Try running the debug script using RoninUI.

3. If that fails, try to SSH into RoninCLI.

4. If that fails, connect keyboard to USB and screen to HDMI and login to RoninCLI that way.

5. Try running the debug script using RoninCLI.

6. Try entering the dmesg command in the terminal and use the arrow keys to scroll and find any possible I/O errors or read/write errors.

7. Another good thing to check is the SSD status. Make sure it’s staying mounted by using the df -h command.

How to debug hardware issues

SSD I/O Error

It’s possible this error indicates hardware failure. Try the following steps.

• SSD: /dev/nvme0n1p1
• Error example: I/O error, dev nvme0n1, sector 763672728 op 0x0:(WRITE) flags 0x0 phys_seg 1 prio class 0

1. Try reseating the SSD as it may not be plugged in correctly.

2. The SSD adapter may be going bad if you are using one, or actually be defective if brand new. Try swapping out any adapters.

3. If you are using an SSD enclosure, this is probably the cause of your issue. We do not support using SSD enclosures because they are so problematic.

MicroSD I/O Error

It’s possible this error indicates hardware failure. Try the following steps.

• Micro SD: /dev/mmcblk1p1
• Error example: I/O error, dev mmcblk0, sector 7628568

1. Try reflashing the microSD card if you cannot get the system to function properly while doing basic tasks.

2. Your microSD card has probably failed. Replace it with high quality microSD card that we recommend in the hardware section.

Bitcoin I/O Error

It’s possible this error indicates hardware failure. Try the following steps.

bitcoind | Flushing block file to disk failed. This is likely the result of an I/O error.

1. Run the Debug Script in RoninUI or RoninCLI.

2. Run the dmesg command in the terminal and use the arrow keys to scroll and find any possible I/O errors or read/write errors.

My RoninDojo is not getting power

Try the following steps if your RoninDojo device is not booting or does not seem to be getting power.

Any Hardware

1. Unplug power cable from RoninDojo device and from power source for 10 minutes.

2. Plug in power cable. Some devices will boot automatically, and other devices you must press a button.

3. Look for green and yellow lights on the ethernet port to confirm the device is powered on.

Tanto Gen2

1. Unplug the power supply and wait until any power indicator light turns off.

2. Using a paperclip, press through the front-left hole until you feel the power button click. Hold the power button down for 10 seconds to expend all power.

3. Plug the power supply back in and your device should start up.

4. Look for the red light on the front of the device to indicate it has started.

5. If you only see a blue light on the front of the device, press the power button until it turns red.

Tanto Gen1

1. Unplug the power supply and wait until any power indicator light turns off.

2. Using a paperclip, press through the front-left hole until you feel the power button click. Hold the power button down for 10 seconds to expend all power.

3. Plug the power supply back in and your device should start up.

4. Look for green and yellow lights on the ethernet port to confirm the device is powered on.

5. If you don’t see green and yellow lights on the ethernet port, press the power button until they light up.

6. Wait for red lights on the front of the device to confirm the system has started.

How to wipe SSD

Sometimes you need to delete or format a hard drive for some operations. The most common use case for completely and irrevocably wiping a device is when the device is going to be given away or sold, as this is really important for data protection.

The following dd command overwrites the whole disk with zeros, and is considerably faster than generating gigabytes of random data.

dd if=/dev/zero of=/dev/sda1 bs=512 count=1

If you prefer to fully wipe the SSD, you can write over the entire drive with random data using the following command. This command will take a very long time.

dd if=/dev/urandom of=/dev/sda1 bs=4096

How to change SSD

1. Remove the bottom cover.

2. Remove all Allen screws on the board.

3. Ensure all Allen screws have been removed, then carefully lift up the board.

4. Remove the Phillips screw that secures the SSD to the adapter.

5. Re-assemble with new SSD.

6. Continue with the Install Guide.