Linux

MaslowCNC Wiki: Electronics | Firmware | Mechanics | Software | Community Garden

Linux

How to install Ground Control from the source

Note, this method does not work well for Raspberry Pi. See the Raspberry Pi instructions here.

Step 1: Install Kivy

Install Kivy using by folowing the instructions found at https://kivy.org/docs/installation/installation-linux.html

NOTE: at this time Ground Control does not support Python3, so use Python2 instead

Step 2: Install PySerial

Install the PySerial package by running the command pip install pyserial

On Debian/Ubuntu distros you may be able to install pySerial using sudo apt-get install python-serial

Step 3: Download the Source Code

Download a copy of the Ground Control source code from https://github.com/MaslowCNC/GroundControl using the "clone or download" button on the right side.

Step 4: Launch Ground Control

Launch Ground Control by using the command python main.py from within the folder

Optional: Make a desktop shortcut to launch GC (tested on Lubuntu)

1. Create a new file on the desktop (or wherever you want the shortcut)

2. Copy/Paste the following into the file:

   [Desktop Entry]
   Name=GC Shortcut
   Exec=python /home/username/Documents/GroundControl-master/main.py
   Type=Application
   Terminal=true
   Path=me/username/Documents/GroundControl-master/
   StartupNotify=false
   X-KeepTerminal=false

3. Change "Name=" to whatever name you want for the shortcut

4. Make sure the paths for "Exec=" and "Path=" are correct (including changing "username" to your username)

5. Save file. You should now be able to open/double-click it to launch GC!