Troubleshooting

Common Issues

Slow WiFi

If uploading or accessing mariner is too slow, the following might help:

  • If you are powering your Raspberry Pi from a 5V pin on the printer’s mainboard, try using an external power supply or a buck converter from the printer’s 12V line. WiFi reception has been reported to be weaker when powering the RPi directly from the printer’s mainboard.

  • Use an external antenna.

  • Try moving the RPi to outside of the printer case.

  • Try moving your RPi closer to your router, consider using ethernet or a different model such as the RPi 4B, which has onboard ethernet.

Disk init fail

If your printer is returning an error such as //Disk init fail!\r\n, it means your Raspberry Pi is not properly configured to use Linux’s USB Gadget mode and your printer is failing to see the virtual disk shared by the RPi. Please refer to the USB Gadget Setup section of the documentation and check your setup carefully.

Often, this can be one of these issues:

  • Check for bad USB cables. Your Micro USB cable should be able to transfer data. There are a lot of USB cables out there that don’t have the D+/D- data lines connected and only have the 5V and GND pins connected. Check that your USB cable works with other devices!

  • Your /etc/rc.local isn’t setup correctly with the modprobe g_mass_storage line (see Issue #412 for an example).

  • Make sure dtoverlay=dwc2 is under the [all] section of your /boot/config.txt.

  • Make sure your Raspberry Pi supports USB OTG.

Unexpected Printer Response

If you are seeing the “Unexpected Printer Response” while printing from the web interface (but printing is working fine), then you are running into Issue #180, which is being worked on.

This has no performance effect and won’t cause issues with your prints. It should cause nothing but cosmetic issues on the user interface and can safely be ignored. Just refresh the page if you run into it.

No such file or directory: /dev/serial0

If you are seeing this on the logs for the mariner3d service on journalctl, this means your serial port is not setup properly. Please refer to the Setting up the serial port section of the installation guide.

Error: File is not existed or empty

If your printer is returning responses such as Error: File is not existed or empty, make sure to upgrade to the latest version of mariner. This is an old issue which was fixed on v0.2.0. See Issue #311.

Printer stops during print

If your printer is stopping during the print process, make sure to upgrade to the latest version of mariner. This is an old issue which was fixed on v0.2.0. See Issue #311.

Other Issues

If your issue isn’t listed above, check the mariner3d logs for clues:

$ sudo journalctl -ub mariner3d.service

Also check the message buffer of the Linux kernel for errors:

$ sudo dmesg

Carefully read the Installation Guide once again and, if none of that helps, file an issue on GitHub!