Linux & Mac Connection Guide

These are the tutorials for connecting to your debug clip via a Linux or Mac machine, a majority of these are going to be the same with slight variations for distribution.

We will cover Debian, Redhat & Suse based systems. These cover a majority of distributions.

The Mac guide is based off feedback.

Auto Finder

We've created a couple of scripts that use python which can be downloaded using the following commands. The first script will download the python program and the python program itself will install the required libs and programs on first launch and after then automatically detect which serial port the Debug clip is on. This will only work for 1 debug clip at a time.

The program is also fully open source on BitBucket. If you have any issues please either contact us via our support system or create an issue on the git.

Just run the following in your terminal if you use CURL (Fedora, Suse & Mac) and the rest should happen automagically!

curl -OL && sudo python debuginstaller

Or if you use WGET (Normally on Ubuntu, Debian)

wget -L && sudo python debuginstaller

Manual Guide

If you don't wish to use the auto finder then the following instructions apply. I am basing it off of my Ubuntu Computer with only slight tweaks needed for Mac & Non Debian based linux distributions.

1) Open a terminal window and then navigate to /dev "cd /dev"

2) Next list all of the devices by typing in "ls /dev"

3) Now plug in the debug clip and re-run the previous command

4) A new device should appear. Make note of which device appears. (If your using Linux it should be in the format of ttyACMx or on a mac it should be a usb modem).

On most linux systems it will be the default of ttyACM0, if you have multiple devices then this may be different.

5) Install screen or another serial terminal of your choice. For the rest of the tutorial we will be using screen.

On Debian based systems install it by running "apt-get install screen" as root, if you use aptitude then you can do the same with "aptitude install screen"

On Redhat / Fedora based systems it should work by running "yum install screen" as root.

I believe on a Mac it is installed as standard.

On most systems you can become root by either using sudo before each command or running su at the beginning.

6) Finally open the connection to the Pi by typing in as root "screen /dev/<DEVICENAME> 115200" replacing <DEVICENAME> with the device. On my computer it would be "screen /dev/ttyACM0 115200"

Quitting Screen

To quit screen you will need to first press Ctrl & A and then the K key. Finally press Y to confirm quit.

You can also detach the screen which will leave it open in the background by pressing D instead of Y. You can then re-attach by using "screen -x"

Video Guides

Linux - Ubuntu

Coming soon.


Backer Keith Ellis has made a mix of a review and a quick guide in the following video.