Shapeoko 3 connected to Debian Linux - Install & Setup notes

Assembly questions and answers for the Shapeoko 3 CNC Mill
Post Reply
jvin248
Posts: 6
Joined: Sun Mar 29, 2015 12:02 am

Shapeoko 3 connected to Debian Linux - Install & Setup notes

Post by jvin248 » Sun Aug 23, 2015 7:10 pm

I'm connecting to my SO3 from a Linux pc. Notes I went through for the steps _after_ the basic machine assembly, since they may help others out.

My pc is running Debian Linux (latest version 8 "Jessie")

[Installed, via Synaptic "arduino" and "arduino-core" (you can use "apt-get install" commands for those programs too). Edit: You won't need this unless flashing the Arduino with GRBL, SO3 comes pre-installed .. left over in the old SO2 instructions I was following]

Hook up the USB cable between the machine (powered on) and the pc and issue some terminal prompt commands to check connections:

See if the system recognizes what is attached.
$ dmsg
usb 4-2: Product: Shapeoko 3
usb 4-2: Manufacturer: Carbide 3D, LLC
usb 4-2: SerialNumber: XxXxXxXxXxX
cdc_acm 4-2:1.0: ttyACM1: USB ACM device

There is a little red flashing led that tells when commands are going back and forth from the pc to the machine's controller.

Did it create the serial port link?
$ ls /dev/ttyA*
/dev/ttyACM0

See privileges on the serial port link
$ ls -l /dev/ttyACM0
crw-rw---- 1 root dialout 166, 0 Aug 23 13:01 /dev/ttyACM0

Ensure USER has access to serial USB ports, using root terminal access
root$ usermod -a -G dialout USER
root$ usermod -a -G tty USER

Check that the user has these groups now (tty and dialout)
$ groups
USER tty dialout cdrom floppy audio dip video plugdev netdev scanner bluetooth lpadmin

Reboot the machine. Some of the instructions say log out and log back in. I found it took a full reboot.

Get some software to send machine code to the CNC motors.
https://github.com/winder/Universal-G-Code-Sender
scroll down to most recent "Stable" release, download, and unzip the files into a folder. I created /USER/CNC and put the files in there.

Using Terminal go in to that directory and run the g-code sender program
$ cd CNC
$ java -jar -Xmx256m UniversalGcodeSender.jar

Select
port /dev/ttyACM0
115200 baud
Open
Machine Control
millimeters

Then use the mouse to click on the X, Y, Z buttons. If everything worked the motors should respond with indexing the unit! Mine didn't the first time around since I hadn't yet found the port permissions solution noted above, so if you're following along you can go into the root account terminal and launch the UniversalGcodeSender program and it may work from there. If so you'll have to mess around with the permissions options.

Time to test the SO3 Hello World program
Download and save in a convenient location. I put mine in the CNC folder I created previously
http://docs.carbide3d.com/article/37...-3-hello-world

Launch UniversalGcodeSender, go to "File Mode" and load the file up.
The link at carbide3d above walks through the steps of setting zero point and so on.

You should have your hello world picture suitable for framing.
Last edited by jvin248 on Mon Sep 07, 2015 2:42 am, edited 1 time in total.

Ric
Posts: 33
Joined: Wed Apr 29, 2015 2:17 am

Re: Shapeoko 3 connected to Debian Linux - Install & Setup n

Post by Ric » Mon Aug 24, 2015 1:17 pm

I'm curious as to why you did:
Installed, via Synaptic "arduino" and "arduino-core"
Last week I resurrected an old Debian machine to use with my Shapeoko2, and I did pretty much everything you did except the above step. Everything seems to work fine, and would I gain anything by adding the arduino and arduino-core packages?

twforeman
Posts: 1347
Joined: Tue Jan 29, 2013 4:51 pm
Location: Minneapolis, MN
Contact:

Re: Shapeoko 3 connected to Debian Linux - Install & Setup n

Post by twforeman » Mon Aug 24, 2015 2:11 pm

Thanks for documenting this.

I drive my Shapeokos with UGS on Linux Mint.

You don't need the Arduino packages unless you want to compile and install a newer version of Grbl.

The only extra stuff I did was add my user to the dialout group so that I can use the USB serial port.

It shouldn't take a reboot to get the privs updated. Just logging out and back in. But who knows, sometimes computers get fussy.

There is also a 'start.sh' script that comes with UGS that you can run instead of the whole java command. I made a shortcut on my desktop to it.
Ender 3 3D Printer
ShapeOko v3 serial #0004 - upgrade thread
All of my ShapeOko related blog posts

jvin248
Posts: 6
Joined: Sun Mar 29, 2015 12:02 am

Re: Shapeoko 3 connected to Debian Linux - Install & Setup n

Post by jvin248 » Mon Sep 07, 2015 2:40 am

You may not need the arduino and arduino-core ... that step was in the instructions I was following (I think SO2 where you needed to instal GRBL on the machine controller, SO3 is pre-installed).

I'll eventually write a launcher 'start.sh' script but for now the command line route gets me there.

twforeman
Posts: 1347
Joined: Tue Jan 29, 2013 4:51 pm
Location: Minneapolis, MN
Contact:

Re: Shapeoko 3 connected to Debian Linux - Install & Setup n

Post by twforeman » Mon Sep 07, 2015 4:31 pm

If you downloaded the pre-built UGS it should have come with a start.sh script.

It's pretty simple: https://github.com/winder/Universal-G-C ... s/start.sh
Ender 3 3D Printer
ShapeOko v3 serial #0004 - upgrade thread
All of my ShapeOko related blog posts

Post Reply