Shapeoko e-book [V4 released]

Hi Rob,

Bummer, EMI/static-related disconnects are no fun. I’m afraid there is no single magic trick to solve them, because there are many possible reasons for them to happen. So your best bet is to create a dedicated thread here on the forum, and describe your setup and how/when these disconnects happen, in excruciating details: I’m sure the good people here will then jump in to guide you through the investigation. Unless you have an ancient Shapeoko, forget about the controller and capacitors, there is 99% probability that this is not the issue, it’s been a few years now since boards were plagued with EMI weaknesses, it’s all fixed by now. Yet, other factors can still lead to this.

In the meantime, here’s the list of workarounds I have collected in the book for now:

  • try different wall sockets if possible

  • grounding the router body/mount (e.g. wrapping a copper wire around the router mount and connecting it to a known-good grounding point, on the machine itself or nearby)

  • earthing the machine frame

  • grounding the dust collection hose, and/or use an anti-static hose.

  • if the air is very dry, spray a little water on the stock, or use a humidifier in the room.

  • using a high-quality shielded USB cable, and/or a USB isolator or powered USB hub, or just using a different USB port on the PC running the G-code sender.

  • checking if router brushes are not worn out, and replace them.

  • using a voltage regulator/surge protector between mains and the machine

You can try those, in more or less this order, do ask if anything is too obscure.
Good luck, we’ll have your back


While this should be for another thread, I was plagued with EMI disconnects after I installed the DustBoot but I have reduced them to almost nothing using most of the things Julien mentioned but also, I also connected the Shopvac on a different electrical circuit, I ran a copper wire the length of the vacuum tube then I connected that wire to the Z limit switch plate above the router using a wire with alligator clips.



i’d also try with the vac removed just to confirm it is at fault. sometimes something basic gets altered and we assume it’s the new addition when it could be an unrelated loose cable,etc


There is no silver bullet fix for the disconnects and it can definitely be frustrating. Anecdotally, I started having disconnects out of the blue a while back. After trying a bunch of other forum suggestions, I tried wrapping some wire around the router mount and connected it to a nearby electrical conduit by wrapping it around it. Have not changed the setup and haven’t had a disconnect since.

1 Like

My shopvac gives me disconnects and my festool ct midi doesn’t… Go figure

1 Like

Allright, it may not be as polished as I would like, but it’s been almost three months and more evenings than I care to admit, so here you go, version 1 of the e-book:

I would appreciate any and all comments (be it about grammar/English, inaccurate statements, ideas for improvements, …)

And if you are in the mood for a thorough proofreading, or would like to contribute a section, we can work something out (the gitbook inline comment feature would have been perfect, but the “reader+comment” permission just does not work)

Looking forward to hearing what you think, good or bad !


@Julien I just skimmed through your creation, going back for a deep dive in a minute. Nicely done, a real benefit to the Shapeoko community!

I sure wish this had been available 3 years ago! New users will love this.

1 Like

Excellent work! Well done.

I have found a missing word/typo so far … do you want the details here or by some other route?

1 Like

Wow Julien, this looks good. Is it possible to download the whole thing so I don’t have to read it on the computer? Yeah I’m old school but I like to have that stuff in my shop and it is easier and safer to use paper.

1 Like

Hi Andy,

@WillAdams started sending me private messages with various corrections (thanks !), and I think this is a practical solution for me to collect comments for now, without making this thread super long. But whatever you prefer !

I’m still looking for an efficient way to generate a PDF, but gitbook does not yet support it.
BUT, I have synced the gitbook repository to a github repository:
You can go there and click “Clone or Download” button, to get a zip file of the full contents. Unfortunately this is all in Markdown format, so pretty unreadable in that format. There must be a way to generate the corresponding HTML directory structure, and zip that, I’ll look into it tomorrow.

EDIT: the legacy gitbook tools should work, just need some time to test. Until then I have changed it back to a private repo, it’s useless content anyway in this form.


I will be reading this a bit more and deeper in the next few days, but from what I have seen so far it looks like you did a great job and this will be a big help to new users and a great reference for even the seasoned user.


holy crap, this is great so far. sharing with another forum of nerds curious about taking the plunge soon!


Well done, @Julien! You are a patient man.

1 Like


After a few very frustrating attempts at using various half-baked solutions to generate PDF from gitbook v2, I have a semi-working solution that generated one PDF per chapter. I zipped them and uploaded them here:


It does not look as nice as the online version, the page breaks are a little weird sometimes, but all the content is there for offline reading. I’ll keep searching for a better PDF generator solution.


Probably the best option would be a Markdown to LaTeX converter — if you can make a sample which shows all the Markdown you’re using I’d be glad to work up a LaTeX package which formats it nicely.


  • page size? (I’d suggest A4 wide x 11 inches tall — that way it works on either side of the pond)
  • fonts — something free/opensource

Let me know.


That would be awesome!
You can find all the Markdown source files and assets (images) in the github repo, I made it visible again.

1 Like

Okay, downloaded, and I found:

so we’ll have to see what I can work up.


Thank you Excellent .

1 Like

Whilst we’re talking about converting to PDF, i’d be interested in an ebook version for my Kindle :slight_smile:

Nice bed time reading! Not meant in a derogatory way!!!

1 Like