Limit Switch (Error Code 17)

On my Shapeoko 3 XXL, the homing process fails.
It says it is due to a Limit Switch Error.
Any ideas what this is or how I can fix it?

If you go to the settings screen you get a dialog at the bottom showing you which switches are “on” at that time, try pressing each of the limit switches in turn with a finger and see if they show up on screen, or if any of them are stuck on.


Make sure you’ve sent the machine configuration:

There is a basic page on troubleshooting the homing switches at: ​ There is also a Carbide 3D Answer video:

​Please check that the switches are plugged in correctly, and work properly — when the machine powers up the homing indicator lights should flicker on/off, then once the controller is booted up you can test the switches by pressing them — the matching light should light while the switch is pressed (closed), and should go off when the switch is released (open). ​ Check that the wiring is connected properly and that all the wiring extensions and connectors are consistent. color-ordering should be consistent and all wiring extensions should be straight through.

​Please make sure that the machine can mechanically/electrically close the appropriate homing switch on an axis before reaching the limit of travel along that axis — if it can’t, it should be possible to adjust a problematic switch’s placement by loosening the hardware in question, pulling it into a better alignment and then tightening it. Note that it may be necessary to lower the Z-axis switch on a Z-Plus upon arrival (it may have been installed at the highest point to prevent damage when shipping). The machine being out of square can also affect this, squaring up the machine, or more expediently, securing a small block or plate for the homing switches to contact may be necessary.

If you continue to have difficulties let us know that you’ve seen the above and what you tried and let us know step-by-step what happens when you try to home the machine and the specifics of testing each homing switch at and we’ll do our best to work through this with you.