Page 1 of 10
Shapeoko Assembly Guide
Introduction
SparkFun’s Deluxe Shapeoko kit is a Carbide3D Shapoko 3 in fancy
SparkFun red with our open source 3 axis mill driver, the Stepoko.
The full kit. In this picture, the Shapeoko parts have been assembled as per
the Shapeoko guide, and the SparkFun kit parts are shown beside it.
Guide Content
This guide directs you to the Shapeoko assembly instructions, then goes
through the final steps to add the electronics to the mill.
Required Materials
• Shapeoko assembly instructions - Download and read before
unboxing. It works well to print two pages per sheet in order to have
a copy on hand, and to save trees.
• Shapeoko Deluxe Kit Contents PDF - This list reflects exactly what
comes in the deluxe kit and can be used to verify the shipment
before starting assembly.
• A meter or so of spare wire.
• A soldering iron and some solder.
• A multimeter.
• A 2.5mm hex wrench for belt clips.
• Pliers or small adjustable wrench.
Suggested Reading
Stepoko guide - This guide talks about how the Stepoko control electronics
works. Important information is also linked below.
Assembly
Page 2 of 10
1. Follow the Shapeoko assembly instructions until you get to the part
where controller is added. There are a few differences, for instance
the motors in this kit have equal length wires, but nothing too
significant. Use the parts list from downloaded from the “Required
Materials” section above rather than the list from the assembly guide.
Set Aside Some Time It may take about four hours to
complete the initial assembly. Once you’ve got it, continue on.
2. Install the Shapeoko into the enclosure. There are 10 4-40 screws for
this purpose, but you’ll only need 8. Use a number 1 phillips
screwdriver.
To get the Stepoko into the enclosure, put the ‘port end’ in first.
Installing the 4-40 screws
3. Get ready to install the controller. Test fit it first, but don’t install just
yet, set it down such that the pad can be added, and then it can be
rotated into position. Make sure the aluminum heatsink and extruded
mill rail are clean and free of debris.
Test fitting the enclosure – the motor wires will go through the top
Page 3 of 10
Here the enclosure is ready to rotate up onto the mill into the correct
orientation. This picture is shown with the wires installed. Don’t worry
if yours are not installed yet, that will be covered later.
4. Peel one side’s protective sheet away and discard. Both sides will be
removed, but just peel one for now.
Peeling the protective sheet. Once removed, the rigidity of the
material changes completely
5. Holding by the corners, lower the pad onto the exposed heat sink,
and gently press into place. Generally, it just needs to be centered
and overlapping the edge of the heat sink. It’s been sized so that the
following two points can insure it’s in the correct position:
◦ The long edge is flush with the enclosure’s edge, towards the
motor wires.
◦ The short edge is flush with the keyholed mounting hole.
Lowering the pad
Page 4 of 10
Checking for proper alignment. Here, my thumb checks flushness on
one edge while I point out the proper alignment near the mounting
hole.
6. Peel the second protective layer away.
Removing the protective sheeting
7. Install the Stepoko controller. The pad will add thickness and cause
the enclosure to sit off the mill, so don’t tighten the mounting bolts
down too hard. Use threadlocker to keep the screw from backing out
due to vibrations. Alternately, a flat washer that’s slightly thinner than
the pad can be used here.
Applying threadlocker – Here, a bit too much is used. It only needs to
be filling in the treads. Excess may run.
The finished installation. Notice that the enclosure is nice and even
and not deformed along the mill.
8. Install the enclosure to the rail with the terminal connections at the
top. Use the extra M6x12mm bolts provided with the Shapeoko.
9. Connect the X and Z axes to the Stepoko. For more information,
check the Stepoko guide’s Hardware: Connecting the Motors section.
◦ Tin the wire ends with some solder.
◦ Identify which pairs of wire are connected inside the motors
with your meter.
◦ Match the coils to the winding symbols on the Stepoko. Either
polarity or A-B position will work, but may make the motors
spin the other way. This can be changed in software.
Page 5 of 10
The X and Z axis are connected.
10. Connect the Y axis. But wait! It has two motors that are wired in
parallel.
If two stepper motors are connected in parallel, they may not spin in
the same direction because the internal polarities may not be the
same. The solution to this problem is to transpose the colors of one
pair of coil wires. This polarity/spin direction problem is compounded
by the fact that the motors are mirrored on the mill and actually need
to spin different directions.
Watch the video below go get a basic idea, then work through these
steps.
◦ Connect short leads to the Y axis terminals.
◦ Identify the coils.
◦ Group one coil from each motor together by color, except with
reversed polarities.
◦ Twist the ends to test.
◦ Try and move the mill in the Y axis. If it moves smoothly,
solder the wires and apply heatshrink/electrical tape, or use
wire nuts.
◦ If the axis moved roughly, unlike the X and Z axes, filp one of
the pairs of coils so that it has the same colors combined, but
leave the other reversed. This is because the motor’s coils are
not always wired the same internally.
Shapeoko Belt Fix
Take a quick look at this video to see, and hear, how the Y axis
when wired incorrectly, and correctly.
11. Set the motor drive currents. Make sure the trimpots are in the center
for 1A service until you are more experienced. Or, read up on how
the current setting works in the Stepoko Guide’s Hardware: Setting
the current section.
Page 6 of 10
The trimpots are centered for 1 A drive in this photograph.
12. Mount the switch to a free hole on the gantry end plate and solder on
leads.
Here the switch has been mounted and the switch wires are being
measured. They go into the two terminals labled E-Stop.
Soldering on the leads.
All of the wires are added for this mill setup.
13. Screw in the lid to the enclosure using a number 1 or 2 phillips.
14. Collect your wires and bind with twist ties or zip ties.
Page 7 of 10
The Y axis wires have been twist tied together here. The X and Z
axes are gently pulled out to see how long they are.
With the X axis moved ofer to one end, I can see that my bound
wires have enough slack so that they won’t be pulled on when the
carriage moves.
15. Connect the power supply, power cord, and USB cord between your
computer and the Stepoko
16. Open up the Universal Gcode Sender, open the Stepoko’s serial
port, and select the machine control tab. Set the switch to ‘ON’ and
try to move the machine by computer control. If the axis move in the
wrong directions to your liking (but of course, up should be positive
Z), switch the direction bit field accordingly. Use the Stepoko guide’s
Software: Machine Control section for more information about grbl, or
check out grbl’s Github wiki for more information on changing
settings.
17. Measure know movements and calibrate each axis. See the Stepoko
guide’s Firmware: Configuring grbl and Calibrating section for more
info.
Finishing Touches
The cable carriers have been included in your kit to help with wire
management, but it’s up to you to decide what cables to carry and where
you you would like them to be. They can go either way on an axis and don’t
need to be full length to get the job done.
This section shows the installation of a cable carrier between the mill head
and the cross-rail. The process is the same for any axis.
1. Start by finding the location and length of the cable carrier. Hold the
fixed end of the carrier in where you think it should go, and move the
mill head through the full range to make sure the cable carrier has
unrestrained motion along the axis of movement. Alternately, mimic
the motion of the mill to approximately check the motion. The cable
carrier should be shortened if there’s not enough play in the wires or
if the loop hangs too far off the mill.
Page 8 of 10
Mimic the motion of the axis to get a good idea where to mount the
fixed end and how long the carrier needs to be.
2. Pull the wires through the carrier. A hooked wire or tape on a straight
wire helps. When running multiple groups of similar colors through,
mark each set differently with sharpie or tape.
Use a helper wire to thread the cable carriers. Here, four of the eight
wires have a tape wrap to indicate that they belong to the same
motor
The wires are probably not long enough to pull through with a bend,
so carefully work the ends free.
3. After you’ve located where the fixed end will be, cut a small piece of
double-sided tape, and firmly squish the carrier down. For these
Shapeoko mills, make sure nothing crosses the center line in the
extrusion.
Here, the tape is being dispensed directly onto the location and cut
right in place. Notice that it does not cross the center line.
Page 9 of 10
4. Check that the wires will reach the terminals, that the axis has a full
range of motion, and that the roller bolt misses the cable carrier.
Then connect the motor wires for the final time.
A view of the installed cable carrier. Also shown, the strip of cable
carrier on the enclosure is a convenient place to stuff fixed wires –
just pull them in with your wire hook. This is made from extra bits of
the other carriers from when they were shortened.
The roller clears the cable carrier with no problems! If this is not the
case, simply peel up the cable carrier, and try again.
Resources and Going Further
Here’s some links and projects you may find useful.
• Stepoko Hookup Guide – Read in-depth about the Stepoko.
• The Stepoko GitHub Repository – Schematics and Gcode examples.
• The grbl GitHub Repository – Link to grbl source and wiki, for
settings information.
• See this Shapeoko Coaster Project for an example of drawing and
milling a complete project.
• Our Cable Carrier Product Video shows some alternate carrier
installations.
Or, head back to the The Stepoko and Shapeoko Landing page to see what
accessories and tools are available.
Now that you have built your Shapeoko Mill, check out these other
SparkFun tutorials to learn how to use the SparkFun Stepoko Control
board.
Page 10 of 10
Stepoko: Powered by grbl Hookup Guide
N OVEM BE R 20, 2015
Hardware guide for the Stepoko
Once you’re familiar with the Stepoko, create your first project by following
along with the Shapeoko SparkFun Coaster.
Shapeoko Coaster Project
N OVEM BE R 20, 2015
A step-by-step guide to cutting and engraving a coaster with the Shapeoko.
https://learn.sparkfun.com/tutorials/shapeoko-assembly-guide?_ga=1.30113791.193945695...
5/2/2016