Common issues & fixes

Last Update: 9 December 2019

My machine isn’t moving in the right direction

  • Are all of the motor wires plugged in correctly and all the way?
  • Check the color pattern of each wire coming from the motor and connected to the LongBoard. Is the pattern all the same with each motor? If not, change the order of the wires to match.
The wiring color pattern should be blue, yellow, green, red.

My machine is not turning on

  • Is your power supply connected properly and providing power? There is a green LED that should be turned on when your power supply is plugged in. Check if your AC cable is pushed in all the way into the socket of the power supply.
  • Make sure that the polarity of the wiring is correct. Switch the wires around if need be.
The wire on the left should be white, and the wire on the right should be black.

My machine is not moving the right amount when I jog a certain amount

  • The microstepping on your drivers may not be set correctly. Check the drivers under your machine and make sure that they are set to 1/8″ microstepping.
  • Try restarting your g-code sender.

My motors are stalling

  • Make sure that you have not overtightened the Delrin anti-backlash nuts on your machine. Loosen the two M5-25mm screws that hold the nut in place and see if that helps.
  • Make sure that all of the motor wires are seated properly.

My cuts are not coming out accurately

  • You may have a loose component. Make sure that all of your fasteners are tight and your eccentric nuts and Delrin anti-backlash nuts are tensioned correctly.
  • Try reducing your speeds and feeds, or use a different cutting tool.

My lead screws wobble excessively

  • Loosen the two M5-25mm screws that hold the Delrin anti-backlash nuts slightly for the axis which the lead screw is on and run the machine back and forth. This will align the lead screw and the nut. Retighten the screws once the wobbling as gone away.
  • Check that the lead screw is not bent. You can check by rolling it along a surface that is very flat and seeing if it rolls evenly.

The machine moves really really slowly or not at all when I jog it

  • Check your feedrate. 1000mm/min is a good place to start.
  • Check your step size. 10mm is a good place to start.

My machine randomly stops and starts

  • Check if your power supply and all of the connectors are secure and properly attached.
  • Check for sources that may be causing electromagnetic interference (EMI). This could be vacuums, motors, and other electronics nearby that could be sending EMI to the control board.
  • Check if your drivers are excessively hot. The drivers should not exceed 80C.

My machine won’t move and says it’s in an ‘ALARM’ state

  • Something’s happened during the machines operation which was unexpected so it’s decided to lock itself just in case.
  • To bring it out of the alarm state, press the “Soft Reset” button followed by the “Unlock” button and that will put the machine back into its ‘IDLE’ state.
  • If it continues to go into an ALARM state under similar conditions in the future, check that no wires or hardware have come loose and that there’s nothing externally affecting the movement of your machine.


I cannot connect to UGSPlatform or any other g-code sending software

  • Try restarting your program or computer.
  • Try installing the latest version of Java.
  • You might not have drivers installed. You can install Arduino drivers by installing the IDE for your computer.
  • If you are using UGSPlatform, make sure to refresh and check the dropdown box for all of the ports that have devices connected to them. Try each one until you can connect.
  • Check your computer’s drivers. Update or reinstall them if necessary.
  • Try a different USB port and USB cable.
  • If USG is still not able to open due to a Java access error, then there is another program on your computer blocking UGS from opening properly. UGS is usually able to automatically detect where Java is located on your computer, but since this detection is being blocked the way to fix this is to explicitly inform UGS where Java is. First you’ll need to locate Java. You can usually find it by going to the Windows file explorer under ‘This PC Windows (C:) Programs Files Java jre### or ‘This PC Windows (C:) Programs Files (x86) Java jre###. Once inside the ‘jre’ folder, left-click the navigation path at the top of the file explorer then right-click the selected text and left click the ‘Copy’ option to copy the path.
    Once the path is copied, navigate to where you downloaded UGS; this will normally be located inside your ‘Downloads’ folder. Once there, go to: ‘ugs-platform-app-2.0-SNAPSHOT ugsplatform etc’. In this folder should be a file called ‘ugsplatform.conf’. Opening this with a text editor like Notepad, you’ll want to find the line which says: “#jdkhome=”/path/to/jdk“, delete the ‘#’, then replace the text within the quotes with the Java path by right-clicking and selecting ‘Paste‘. The completed edit should look like this: To confirm the changes, click ‘File‘ in the top bar and ‘Save‘. With all this done, once you go back to the UGS .exe launcher you should now be able to get UGS to start up without any errors.