From ShapeOko
Jump to: navigation, search


What safety gear do I need to operate a machine? --- At a minimum eye protection and heavy clothing to protect against a broken bit, hearing protection or a sound enclosure, dust collection and if necessary a filter mask or respirator depending on the nature of the material being cut. See the Operating Checklist.

Possibility of fire https://www.cnccookbook.com/survive-first-cnc-router-fire/

Use with a UPS: https://www.apc.com/us/en/faqs/FA158851/




What else do I need to operate a machine?

Further details are available at appropriate places in this and also see: https://docs.carbide3d.com/general-faq/machine-operating-checklist/

  • eye and hearing protection: https://docs.carbide3d.com/shapeoko-faq/safety-gear-and-necessary-precautions-when-using-the-machine/
  • Additional assembly tools: Flush cut pliers (or scissors --- fingernail clippers can also be used to cut a short zip tie with a nicely rounded edge), Needle nose pliers, Tape measure or ruler, Level, Pencil; possibly also Easy-peel masking tape, such as blue painter’s tape (nothing that leaves a residue behind), Adjustable wrench, Flashlight
  • a trim router (you can order with a machine, but Carbide 3D only has our Carbide Compact Router, but if you prefer you could get  a Dewalt DWP611 or Makita RT0701)
  • some endmills (one is included with the machine, but they're consumables: https://shop.carbide3d.com/collections/cutters/products/201-25-end-mill-cutter-qty-2 ) If one is starting with just a 1/4" collet:
    • three 2-flute 1/4" straight endmills (such as the #201 endmills from Carbide 3D --- one will be included with the machine, a pack of two will fill one out with: 1 for initial experimentation/roughing, 1 for finishing passes, and 1 spare
    • two 2-flute 1/4" ball end endmills (such as the #202 endmills from Carbide 3D) --- if one wishes to do 3D modeling or cut parts which have rounded profiles along the bottom (often a good idea in woodworking for increased strength)
    • two 90 degree V-bits such as the #301 from Carbide 3D --- if one wishes to do V-carving or cut joints which use this angle
  • If you wish to do small-scale or precision work you may want a 1/8" precision collet (we sell one for the Carbide Compact Router (also works for the Makita): https://shop.carbide3d.com/collections/accessories/products/precision-collets ):
    • five 2-flute 1/8" straight endmills (such as the #102 endmills from Carbide 3D [9]
    • two 2-flute 1/8" ball end endmills (such as the #101 .125" Ball Cutters from Carbide 3D)
    • two smaller straight endmills (say 2 mm or so) (such as the #112 0.0625" endmills from Carbide 3D)
  • Additions:
    • V-carving bits (say 30 and 60 degrees) --- these are excellent if doing text
  • you should already have ​a place to set the machine up (the Shapeoko is more suited for use in a shop environment) --- note that you'll want to have access to the front and back of the machine so that you can feed material in from end and out the other if working with oversized material (you can process an entire 4x8 sheet by cutting it into thirds and feeding it incrementally into an XL or XXL --- an SO3 would require 1/6ths)
  • ​dust collection suited to the material which you are cutting (at least a shop vacuum --- many of our customers rig up dust shoes and formal dust collection) --- you'll want to tie into existing dust collection if you have it --- Carbide 3D offers https://shop.carbide3d.com/products/sweepy-dustboot which will fit many smaller shop vac / dust extractor hoses
  • ​workholding (some way to hold the material in place --- we have a T-track and clamp kit: https://shop.carbide3d.com/collections/accessories/products/t-track-table but many folks work up their own --- we have a pair of tutorials: http://carbide3d.com/docs/tutorials/shapeoko-clamps/ and https://docs.carbide3d.com/tutorials/project-wasteboard/)
  • calipers
  • good quality square for assembly or positioning parts
  • tools to break stock down
  • tools to post-process stock (files, deburring tools, &c.)

​and of course, material and designs to cut. I recommend that folks start by drawing up a design (follow along in one of our tutorials: https://docs.carbide3d.com/tutorials/#shapeoko-tutorials and watch our videos: http://carbide3d.com/carbidecreate/video/ and read through: http://docs.carbide3d.com/assembly/carbidecreate/userguide/ ) and working up toolpaths all the way through 3D simulation --- if that effort seems workable to you, you should be in a good place to get a machine.


For holding down materials we offer a couple of products:

  • Threaded Tables --- we have these for the Shapeoko:

https://shop.carbide3d.com/collections/tools/products/shapeoko-threaded-table and the Nomad: https://shop.carbide3d.com/collections/tools/products/nomad-threaded-table

  • a low profile vise (for the Nomad, but again, it's easily mounted to the Shapeoko:


  • T track and clamp kit:


Consumable options:

We also offer some tutorial options for making your own: threaded inserts for a wasteboard:

A good approach on that is a three-layered system:

  • bottom: original MDF baseplate (sealed with spar urethane or lacquer) with some holes and threaded inserts installed from underneath for adding threaded inserts to secure
  • middle: a threaded insert board larger than the working area by the reach of a clamp which has holes in that border area which match up with the threaded insert holes in the bottom layer to secure it, a grid of holes in the working area field for threaded inserts installed for workholding, and additional holes with threaded inserts to secure
  • top: a spoilboard the size of the supported working area plus the diameter of the endmill used for surfacing along X, and endmill radius along Y, (with a matching radius at the back corner) which has holes in it to match the threaded insert board for workholding purposes (these may be drilled at need) and holes to secure it to the threaded insert middle layer


and a variety of clamps:


Is it possible to upgrade a ShapeOko 2 to a Shapeoko 3? ---No. The only parts in common are the V-wheels and a few connectors.[1][2] if there were such a kit, using it would result in one essentially having a second machine as a pile of parts.

Shapeoko v4



The Z Plus has a single mounting point for the router mounting collar. The Belt Drive X/Z has two mounting points one higher and one lower. Depending on where the user installs the mounting collar on the Front Z plate of the Belt Drive Z axis, there are two different operating heights. The Z Plus advertises 3 inches of travel and provides more than that. Your reach is different from that of the lower mounted point of the Belt Drive Z axis. There are 2 options for reaching work when using the Z Plus. A longer endmill or lifting the work up with say a spoilboard.

Announcement: https://community.carbide3d.com/t/shapeoko-z-plus/19301/19

Plan for DIY EZ tram plate: https://community.carbide3d.com/t/flattening-bit-doesnt-touch-waste-board/20285/45


What commodity code is used to describe this machine for customs? --- “other milling machines, numerically controlled.” USPS has instructed companies selling kits to put “build it yourself kit” as the code descriptor.

Can parts be removed from the kit for a savings in price or weight? --- No. At this time, in order to keep costs (and price) as low as possible, the kits are put together in large quantities. As such, it is not possible to customize the kits.

What is the weight and size of the box for a full kit? --- Full kits for the Shapeoko 3 weigh approximately 55 lbs (~25kg)[3], and the box size is 30 × 18 × 8 inches (762mm x 460mm x 204mm).

What bits are included in a full kit? --- Since the SO3 doesn’t include a spindle, it is not possible to bundle Endmills (that page also has a list of recommended endmills and suggested vendors). One can often find a local vendor for end mills (they're needed by machine shops which are more common than one might think). Carbide 3D has since begun bundling 1/4" endmills (though these may not be helpful in regions where the router comes with a 6mm collet).

Is the machine available in Europe (or anywhere other than the U.S.)? --- The Shapeoko 3 is now available from Sparkfun and its distributors: https://www.sparkfun.com/distributors as well as https://www.fablabfactory.com/collections/milling-machines/products/shapeoko-3 and https://www.robotshop.com/en/carbide3d-shapeoko-3-robust-cnc-router-kit-us.html

What defines a Shapeoko? --- http://www.shapeoko.com/forum/viewtopic.php?f=7&t=621

What are the differences between a Shapeoko and an eShapeoko? --- http://wiki.amberspyglass.co.uk/index.php?title=EShapeOko_FAQ


Can the ShapeOko cut Material <X>? --- http://www.shapeoko.com/wiki/index.php/Materials

Is CAD/CAM program <X> compatible? --- the ShapeOko is usually controlled by an Arduino running Grbl which accepts G-codes (up to 50 or 70 characters per line/command), so any program which can export to G-code or which can create a file (.dxf, .stl, .svg, &c.) which one of the CAM programs here: http://www.shapeoko.com/wiki/index.php/CAM will accept, will work.

What is the X and Y resolution on the Shapeoko? --- the resolution for the X- and Y-axis is 40 steps/mm (~1000 steps/inch). This was determined using inputs of 200 steps/rev, 8 micros/step, 20 teeth pulley, and 2mm belt pitch. http://www.shapeoko.com/wiki/index.php/Grbl_Configuration

What is a reasonable expectation for accuracy? --- If tuned properly you should be able to get to within ~0.003″ –- 0.005″ (~0.075mm -- 0.127mm) --- better is achievable with careful setup and an upgraded machine. Note that at such small dimensions many factors can affect this number --- temperature, humidity if using the MDF wasteboard (upgrade to an aluminum one), &c. One user was far more pessimistic: https://www.facebook.com/groups/232744457133521/permalink/284699991937967/?comment_id=284735568601076&reply_comment_id=284766828597950 Notes on area and scale: http://community.carbide3d.com/t/calibrating-belt-streth-maxmum-100-101-writes/7840/2

What are the dimensions of an assembled machine? --- The dimensions of an assembled, stock Shapeoko 3 are approximately 28.5″ × 24.25″ × 14.5″

How to make letters to cut out? --- A tutorial from the ShapeOko blog touches on this: http://www.shapeoko.com/archives/988 or see: https://wiki.shapeoko.com/index.php/Child_Name_or_Letter_Board

Can the machine cut 3D parts? --- Yes. http://www.shapeoko.com/wiki/index.php/Projects

How long can the machine run? --- http://www.shapeoko.com/forum/viewtopic.php?f=7&t=4674&p=34701


Upgrading the spindle? --- http://www.shapeoko.com/wiki/index.php/Spindle_Options

Upgrading to NEMA 23 motors? (for the ShapeOko 2) --- See http://www.shapeoko.com/wiki/index.php/BOM and http://www.shapeoko.com/wiki/index.php/ShapeOko_2#Upgrades

Are NEMA 23 motors necessary? (for the ShapeOko 2) --- No. They are helpful if one wants the machine to move faster, or if one needs to mount an exceptionally heavy spindle which requires the additional torque, but most users do not need the additional power (or weight and expense).

Limit / Homing switches? --- http://www.shapeoko.com/wiki/index.php/Home_switches and http://www.shapeoko.com/wiki/index.php/Limit_Switches

Increasing the work/cutting area (X- and Y-axes)? --- http://www.shapeoko.com/wiki/index.php/Scaling_Up

Can the Z-axis be extended? --- Yes. http://www.shapeoko.com/forum/viewtopic.php?f=7&t=2241


What else should I have on hand? --- Safety gear as noted above. A good quality square, a digital caliper (inexpensive plastic is a suitable improvement over just a ruler), paper and tape, a plan for Workholding, stock to cut (tools to break down stock will make this more affordable), plans for Projects, a vacuum, and possibly Dust Shoe, and tools for post-processing stock (a deburring tool is handy for metals and plastics), and if need be suitable hardware and supplies to finish them. See http://community.carbide3d.com/t/considering-shapeoko-3/3842/2 and http://www.shapeoko.com/forum/viewtopic.php?f=7&t=5626#p41942 and http://www.shapeoko.com/forum/viewtopic.php?f=7&t=2325#p17646

How do I reverse an axis? --- This can be done by either re-wiring the machine, or by flipping bits in the Grbl#Invert_Bits Grbl configuration---invert bits. For the Shapeoko 3, the Z-axis can be mechanically reversed by flipping the Z-axis plate over, and the Y-axis by swapping the connectors at the controller.

Placement of eccentric nuts? --- The circular portion of the eccentric nuts goes all the way into the matching hole: MakerSlide Eccentric placement

Do I have to tap the MakerSlide? (for the ShapeOko 2) --- Yes, if the extrusion isn't already tapped. http://www.shapeoko.com/wiki/index.php/Makerslide#Tapping The Shapeoko 3 kits have their extrusion already tapped.

Are larger versions of the diagrams available? (for the ShapeOko 2) --- Click on the images to open much more detailed versions.



Power supply


Homing switches

Make sure you've sent the machine configuration per the assembly instructions for your machine:https://docs.carbide3d.com/assembly/shapeoko/#assemble-machine and that the configuration matches your machine and its accessories. Note that it may help to temporarily disable or disconnect accessories when troubleshooting.

There is a basic page on troubleshooting the homing switches at: https://docs.carbide3d.com/software-faq/home-switch-troubleshooting/

There is also a Carbide 3D Answer video: https://www.youtube.com/watch?v=P7lOLMAcl_0&feature=youtu.be

For the new inductive homing switches: Troubleshooting: https://www.youtube.com/watch?v=Zf8NPmxrEDs and Adjusting: https://www.youtube.com/watch?v=EZDBza_B25Q

If the machine moves down rather than up at first and is not on the Z-axis switch, address this by sending the settings, righting the Z-axis spindle carriage plate on a belt-drive machine, or correcting the wiring.

​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 putting a bit of metal up against them or 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), also ensure that the aluminum post which activates the Z-axis switch is in place. 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.


Per the machine operating checklist: https://docs.carbide3d.com/general-faq/machine-operating-checklist/ , the basic points of adjustment for a machine are:

  • Pulley set screws: http://docs.carbide3d.com/shapeoko-faq/shapeoko-3-how-to-check-the-pulley-set-screws/ --- be sure to check all axes/pulleys including Z.
  • V wheels / eccentric nuts: http://docs.carbide3d.com/support/tensioning-eccentrics
  • Belt tension (see the relevant step in your instruction manual) Note that the X-axis motor is held in place on standoffs and if those bolts are loose this can cause belt tension issues.
  • Z-axis:
    • Belt drive: Belt tension --- the Z-axis should be guitar string tight (but careful not to bend the motor shaft) on deep cuts it may help to remove one spring from the Z-axis temporarily (which side doesn't matter), esp. if one hasn't added a spoilboard on top of the wasteboard --- it also helps to install the router as low as possible (installing the Makita adapter upside down will help). Some folks have found it helps to remove bolts which won't stay tensioned (M4 Z-axis tension bolt, various V wheels with eccentric nuts), apply a thin bead of threadlock along the length of the threads, then reinstalling. See the video at: https://www.youtube.com/watch?v=_lIIb_PdziA
    • HDZ --- make certain that it can move for its entire extent (the coupler provides a good point to turn it) when the power is off, check that dust caps are all in place and not interfering with movement
    • Z-Plus --- verify that it can move from top--bottom and that the stop is in place at the bottom, and the cylindrical standoff which triggers the homing switch is securely in place

It is also important to be sure that the collet is correctly tightened, the endmill fits correctly and doesn't slip, and the router is mounted securely in the mount, and that the mount doesn't shift. Note that endmill pullout can happen gradually, especially when profiling against tall walls.[4]

Also feeds and speeds may be a consideration: https://docs.carbide3d.com/support/#tooling-support and see https://www.youtube.com/watch?v=S9bceJxpqG0 for concepts on this and https://www.precisebits.com/tutorials/calibrating_feeds_n_speeds.htm for a testing technique and see the series #MaterialMonday: https://community.carbide3d.com/t/materialmonday-on-youtube/13092

Beyond that it's usually a matter of ​calibration and squaring the machine c.f., https://www.youtube.com/watch?v=V9E3VEYlfwA and https://www.youtube.com/watch?v=P4VverLXpCI and http://docs.carbide3d.com/shapeoko-faq/how-to-calibrate-the-machine-for-belt-stretch/

Drag chain catches on homing switch screw

Usually this can be adjusted by loosening the hardware in question, pulling it into the desired alignment, then tightening it, sometimes slightly bending the drag chain bracket up will help. One option is to only use one screw in the rearmost hole on the bracket and the frontmost on the drag chain. Some folks have found it helpful to put a couple of washers under the drag chain bracket to push it out into a better alignment (the drag chain should slightly hang off the rear of the extrusion), other solutions include sourcing a longer drag chain bracket from the hardware store, or placing a piece of angle on the extrusion to guide the drag chain.

A straight-forward solution is to only use one hole (rearmost on bracket, nearest on drag chain).

Doubled belt prevents carriage moving back

Shorten the belt so the rear doesn't run over a doubled up belt. The space at the front has more area for the doubled belt.

Troubleshooting Concepts

To eliminate the software, please check it in a 3rd party previewer such as CAMotics: https://camotics.org/

Verify that you are using up-to-date software versions including the firmware (Grbl 0.9 originally, currently 1.1).

The software works by:

  • Carbide Create creating geometry
  • assigning toolpaths
  • exporting toolpaths to .nc (G-Code) files
  • Carbide Motion connecting to the machine (and if need be sending the correct settings)
  • initializing (homing) it
  • moving the machine to the correct origin relative to the stock and setting zero there
  • sending the G-Code file

​ ​The machine is able to move based on: ​

  • impulses from the stepper driver --- usually if they don't work right there are horrible noises
  • sent through the wiring --- check the conections and wiring --- if you or a friend have a multimeter use it to check for continuity
  • received by the stepper motor --- these almost never go bad
  • which rotates the motor shaft --- check that this is true and not bent
  • which rotates the pulley --- check that it has two set screws at least one of which is on flats and that they are secure: https://docs.carbide3d.com/shapeoko-faq/shapeoko-3-how-to-check-the-pulley-set-screws/
  • which pushes/pulls on the belt --- make sure that the belt tracks true through both the pulley and the idlers and is in good condition, secure at appropriate points and well tensioned
  • which moves the machine along the V rails guided by V wheels --- make sure that the latter are properly adjusted https://docs.carbide3d.com/support/tensioning-eccentrics/ and the former clean and in good shape

For electronic accessories, check the connectors and the length of the wiring.


Where is the FAQ for using the machine? --- Operation Troubleshooting

What skills do I need to assemble and use the machine? --- The ability to read and follow directions, tighten a bolt (used to be one needed to be able to tap a thread); and the ability to use (or learn to use) vector drawing (such as Inkscape) or CAD software and a CAM program and some utilities.

Should one motor be hotter than the others? (the Z-Axis for the Shapeoko 2, X-axis for the Shapeoko 3) --- Yes. holding requires more energy than spinning a stepper motor and these are not bolted to a large metal part which functions as a heat sink.

error: Unsupported statement --- Problem is likely that you have comma defined as a decimal separator in your localization file which your CAM program is wrongly using in the G-code.[5]

Communication program connects but machine doesn’t move --- Incorrect baud rate. Grbl v0.8 and earlier use 9600, 0.9 uses 115200.[6]

USB disconnection --- http://carbide3d.com/blog/2016/disconnect-problems/ [7] and http://www.shapeoko.com/wiki/index.php/Electronics#Recommendations

Machine cuts/moves at wrong size --- http://www.shapeoko.com/wiki/index.php/Operation_Troubleshooting#Machine_cuts.2Fmoves_at_wrong_size.2Fscale

What spare parts should be kept on-hand? --- brushes for the trim router, belts, Delrin V wheels, a pulley (the SO3 would want two different sizes), set screws and various other fasteners (though these can be acquired at any decent hardware store), stepper drivers or a spare controller (this last is a fairly pricey investment and arguably not needed unless down-time has serious repercussions)

Other things needed/other considerations

It depends on how you want to work and what sort of work space you have and other constraints. Let's break it down:

  • it helps to be able to break down stock (you'll also want to store it) --- the larger a size you can purchase, the lower the ultimate cost will be, but not everyone has the wherewithal to receive 4x8 sheets and to break them down (pretty much needs a panel saw or track saw) --- but at a minimum a hand saw (and some clamps and a miter box) to cut stock to length will help a lot
  • if you get rough cut lumber (big savings) you may want to plane it smooth --- a planer, or for small stock a handplane and a workbench --- alternately, clamp the stock to the machine and surface it using the machine
  • again, for rough cut stock, a jointer will allow one to dress an edge and set it to 90 degrees --- as for planing though this can be done on the machine instead (assuming it is properly squared and trammed)
  • stock then needs to be secured to the machine for cutting --- you'll need clamps or some sort of workholding
  • while and after cutting you'll need dust collection --- at least a shop vac
  • after cutting you may need a pull saw, razor saw, or a sharp chisel or utility knife to cut tabs or cut stock free from an onionskin layer
  • once stock is removed you'll want to post-process it --- a file or sandpaper block, deburring tool, or a countersink and/or chamfering plane can nicely finish off a piece
  • there are entire books written on finishing --- research and select an appropriate finish, prep the surface, then apply the finish according to the directions


There is a basic page on troubleshooting connection issues at: https://docs.carbide3d.com/software-faq/can-t-connect-to-machine-or-jog/

Things to check:

  • power supply plugged in --- it lights up promptly and stays lit with a steady light?
  • power supply connected to machine and switched on --- machine boots up, controller lights up with power, lights flicker on/off, motors lock?
  • machine connected to computer using USB --- computer registers USB device? red/green/white lights on controller begin to blink signifying USB communication?

Disconnection Issues

Try changing the brushes of your Router following the manufacturer's instructions.

  1. arrange the AC cable for the spindle (trim router) so that it doesn't cross or be near any of the other cables
  2. if you're using a laptop, ensure that it is plugged in, preferably to a grounded outlet using a 3 prong plug if possible
  3. if you're using a USB extension cable or unpowered USB hub, please directly connect the machine using a shorter than 6 foot USB cable --- if your cable doesn't have a toroid (metal cylinder often molded into the end of the cable) and you have a cable which has that feature, try it, if not consider adding one or getting a cable which has that feature
  4. try a different USB port, esp. if you have the option to switch from USB3 to USB2 --- if using a laptop try a good-quality powered USB hub --- some laptops undervolt the USB ports to save power. Make sure that the cable isn't being jostled or disturbed.
  5. if your spindle (trim router) power cable doesn't have a toroid, try adding one (note that what seems to be a toroid on most trim routers is actually an anti-theft device on all the ones I've seen). Note that worn carbon brushes or a loose connector on a trim router may cause arcing which results in EMI.
  6. if possible, connect the spindle (trim router) and the machine through a different circuit
  7. if you have a surge protector, please connect the machine through it
  8. check the ambient humidity, if low, consider a humidifier
  9. if using dust collection, ensure that your dust hose does not allow static build-up, or is properly grounded
  10. Connect the machine with a galvanic isolator such as this one: https://www.adafruit.com/product/2107?gclid=Cj0KCQiA5aTUBRC2ARIsAPoPJk_QzQ3Qjm2-l-wyL9heIWt_62QGVKLz2u_ytQJiniXgGNuPTVyfUI8aAi7qEALw_wcB

Please ensure that there aren't any extraneous wires which create ground loops (the default configuration doesn’t have this problem but folks have introduced it when adding dust collection, or trying to ground things themselves).

Z-axis moves down rather than up

There are several things which will cause the Z-axis to move down rather than up or to run in reverse:

  • incorrect Grbl setting --- make sure that those have been sent --- https://docs.carbide3d.com/support/carbideupdater/#carbide-motion-v4 --- if installing an HDZ, make sure that box is checked, conversely, do not check that box if no HDZ is installed --- similarly if you have the Z-Plus make certain that you have configured for that option
  • Note that this only applies to the original belt-drive Z-axis: Z-axis spindle carriage plate installed upside down --- the static pulley should be on the left when viewed from the front --- remove and rotate and reinstall
  • stuck homing switch or other electronic sensor incorrectly wired --- if the system starts in an alarm mode it will cause the axes to move away from the switches, unfortunately, it can't identify which switch is which --- check that the matching lights for the homing switches momentarily light up when the controller boots up and then go off, and that they light when the matching switch is pressed/closed, troubleshooting as noted in the homing switch documentation: https://docs.carbide3d.com/software-faq/home-switch-troubleshooting/ ​ There is also a Carbide 3D Answer video: https://www.youtube.com/watch?v=P7lOLMAcl_0&feature=youtu.be
  • Z-axis motor or wiring extension miswired --- all wiring connectors should be consistent, and all wiring extensions straight through --- correct as necessary to make things match the other motors which are working correctly. Make sure that all wiring and all connectors are in good condition. See: http://www.pcbheaven.com/exppages/Reuse_and-or_extend_the_Molex_connectors/
  • bad stepper driver chip --- one failure mode for stepper drivers is that they run in only one direction --- contact support@carbide3d.com to replace the controller

Z-axis plunges too deeply

This may be caused by a number of different things:

  • a disconnect in how the origin is set in the file and how the zero is set relative to the stock, see: https://docs.carbide3d.com/assembly/carbidecreate/video-tutorials/#job-setup and https://docs.carbide3d.com/tutorials/tutorial-homing/
    • if using the Probe this may be caused by setting the Probe as for an X/Y/Z probe at a corner, but probing for Z only, see: https://docs.carbide3d.com/assembly/touch-probe/userguide/#probing-xyz (the Probe should be fully on the surface, rather than only the body on the stock and the 3mm lip off the stock)
    • if using the BitSetter, changing a tool without using the Change Tool button can result in too deep or too high cutting
  • setting the Z-axis safety/retract height in the CAM program (Job Setup | Machine | Retract Height in Carbide Create) to a value greater than is available above where the machine expects the top of the stock to be, resulting in the machine bottoming out against the top stock, thinking it is too high, then plunging down too far in an effort to travel down as far as that failed effort would allow. Setting the origin to the bottom of the stock/wasteboard surface, while setting the zero to the top of the stock may also cause this problem
  • a mechanical difficulty --- check pulley set screws, Z-axis belt tension (if using a belt drive)
  • Grbl misconfiguration --- check that you have the correct Z-axis enabled, in particular, having a Z-Plus, but configuring for an HDZ will cause overtravel in the Z-axis
  • an electronics issue --- check the wiring and connectors
  • the endmill gradually working loose --- check that an adequate length of shaft is in the collet and tighten using two wrenches per the instructions

Router Feeds and Speeds

The router speed setting should match the feeds and speeds for your selection of endmill and material. For #201 endmills in a Shapeoko and #102 endmills in a Nomad please see:


(there's a row matching dial settings to RPMs at the bottom)

There's an interactive version at: https://public.tableau.com/profile/willadams#!/vizhome/Carbide3DCNCFeedsandSpeeds/Sheet1?publish=yes

Note that the feeds and speeds calculations in Carbide Create were updated for trim routers in 433 and 440 and later use a curated set of feeds and speeds which are stored in CSV files.

See https://www.youtube.com/watch?v=S9bceJxpqG0 for concepts on this and see the series #MaterialMonday: https://community.carbide3d.com/t/materialmonday-on-youtube/13092 for specifics.

You should test feeds and speeds in a piece of scrap using the technique at: https://precisebits.com/tutorials/calibrating_feeds_n_speeds.htm

Another consideration is Climb vs. Conventional Milling and tooling engagement --- where possible avoid slotting and add geometry and cut as a pocket (https://community.carbide3d.com/t/adding-geometry-to-cut-as-a-pocket-with-a-finishing-pass/9993 ) and consider leaving a roughing clearance and taking a finishing pass.

Extensive discussion at: https://community.carbide3d.com/t/origin-consistency-of-chipload-recommandations/14152 and https://shapeokoenthusiasts.gitbook.io/shapeoko-cnc-a-to-z/feeds-and-speeds-basics with a spreadsheet for this at: https://community.carbide3d.com/t/speeds-feeds-power-and-force-sfpf-calculator/16237/29

Continuing a cut which is interrupted

Best practice is to break up jobs into manageable chunks: http://docs.carbide3d.com/tutorials/tool-change/

If you must do this:

  • note what line the machine is currently sending (or determine where it was by measuring the deepest area correctly cut)
  • pause, then stop the job and shut things down
  • open up the G-Code file in a text editor
  • identify the preamble and copy it --- see G-Code and https://docs.carbide3d.com/software-faq/grbl-g-code-definitions/ for the details of the codes
  • go to the line # noted above
  • scroll up from there until you find a move down from safety height
  • delete everything from the line above that line to the beginning of the file
  • paste in the preamble at the beginning
  • save under a new name


What parts will need to be lubricated or replaced? --- Machines with metal screws and nuts for motion such as the Nomad may need lubrication, belts will wear and require replacement, V-wheels will wear and require replacement. If using a spindle with brushes (such as a trim router) brushes will need to be replaced --- usually EMI will increase before the router quits working, so disconnects suddenly occurring may indicate a need to replace brushes.

Packaging for Transportation

Fasten the moving parts using foam (pipe insulation or pool noodles) with zip ties to secure everything in place. See how the Nomad is unboxed for one example.[8]


Carbide 3D doesn't do à la carte parts sales. ​ ​There's the maintenance kit of course. For folks using machines in production we recommend the following spares:

  • belts, pulleys, belt anchors, eccentric nuts, Delrin V wheels, misc. hardware --- our maintenance kit: https://shop.carbide3d.com/collections/accessories/products/shapeoko-maintenance-kit
  • brushes and bearings for the trim router --- if budget allows a second trim router as a hot spare
  • endmills (these are consumables of course)
  • electronics controller (and power supply as your situation indicates)
  • the power supply is a commodity item, and also used to power some televisions and so forth --- it's just a matter of the same connector --- with the same pinout and polarity as noted on the label ---- the size of the power supply should be at least 4.5A at 24V for an SO3 with NEMA23 motors --- the Nomad uses a more powerful supply (outputs 24V at 7.5A) and works as well, so anything with the right connector and polarity in-between that range (4.5 -- 7.5A) would be fine. Here's one available in the U.S. from Amazon https://www.amazon.com/dp/B00AI152FO --- note the labeled image should match the image on the bottom of your power supply

Any hardware store should have most of the metric hardware we use --- the spacers are the only specialty item not enumerated above and can be replaced by stacks of spacers/washers and a couple of longer bolts with nuts --- they should be available from aluminumspacers.com ​ ​


G-Code previews okay, but circles and arcs are stair-stepped? --- Lines are too long. Turn on truncating lines in your Communication / Control program or edit them by hand or use a javascript wrapped up in a zipped up html file. Note that there have been some instances of arcs (measured in inches) failing when trimming to 2 digits, 3 is suggested for Imperial files, 4 for metric as a reasonable compromise.[9][10] 5 may be necessary[11]

Expected command letter --- this can also be caused by the too long lines noted above.

Carbide 3D Software

What software does Carbide 3D bundle with their machines? --- Carbide Create and Carbide Motion Machine Control Software --- these are proprietary programs developed for use with the Shapeoko 3 and Nomad 883. Carbide Create can now be used with any machine, MeshCAM can be run in a Nomad specific mode which will output .egc files which Carbide Motion will decrypt when attached to a Nomad, while Carbide Motion will only run if attached to a machine (when so attached it will allow one to copy the plain text of a .egc file). It is possible to request an activation code to run Carbide Motion on a Stepoko from Sparkfun.[12]

Reverting to Grbl 0.9: http://community.carbide3d.com/t/grbl-1-1-and-carbide-motion-4/4403/21

Carbide Create

How to install fonts in Carbide Create? --- Carbide Create uses the fonts which the operating system makes available to it. Usually it is necessary to "install for all users".  ​ ​It also can't make certain proprietary fonts which are in system-specific formats available --- TrueType and OpenType should work though, so long as they are technically correct (fonts missing a space won't load).  ​ ​It is also possible to directly install fonts --- do Help | About | Open Data Directory, then place fonts in the Carbide Create\Fonts directory, then quit and relaunch Carbide Create.

Invalid G-Code: Error 33

Invalid arc format / calculation. --- Increase precision to 5 decimals.[13][14] May be caused by stacked paths. Another possible cause (esp. if using AutoDesk Fusion 360) is inaccurate conversion from Imperial to metric — convert project to metric, then do CAM in metric, then send a metric G-code file to Grbl. Seems to be an accuracy or calculation problem.[15]

Solved by Carbide Motion 414, a suitable post-processor, and setting min. arc size to 4mm:

Shapeoko 3


SO3 Function Test




Is more information available? --- Click on the grey Section heads in the sidebar (which have a right-pointing disclosure triangle) to access the sub-sections.

How can I upload a file? --- Disclose the Toolbox Section in the sidebar and use the Upload a File link.

Where can I record information about my machine? --- Each registered user gets a user page: User:<username> and one can store additional pages in one's User: hierarchy.