Skip to content

Commit

Permalink
Separate gcs_install to LP & OP sections
Browse files Browse the repository at this point in the history
  • Loading branch information
@UncleRus
UncleRus committed Dec 11, 2015
1 parent 5a4aece commit 06955c3
Show file tree
Hide file tree
Showing 3 changed files with 349 additions and 172 deletions.
193 changes: 21 additions & 172 deletions source/user_manual/gcs_install.rst
View file
Original file line number Diff line number Diff line change
@@ -1,182 +1,31 @@
Downloading and Installing the Ground Control Station
=====================================================
*************************************************
Downloading and Installing Ground Control Station
*************************************************

You can use the OpenPilot Ground Control Station (GCS) both to configure your
controller board and to control and monitor your aircraft during flight. More
commonly, you would use a conventional radio control transmitter to control
your vehicle, but the GCS is also capable of doing so.
.. toctree::
:maxdepth: 2

gcs_install_lp
gcs_install_op

All OpenPilot products use the same Ground Control Station. OpenPilot GCS is
currently available for the Windows, Mac, and Linux operating systems.
.. rubric:: Introduction

.. warning:: **OPENPILOT WAS DISCONTINUED!**

Use `LibrePilot <http://www.librepilot.org/>`_ instead.

Downloading the GCS installer
-----------------------------

The first step is to download the appropriate GCS installer. Using the release
table below, select the Download Link that corresponds to your computer's
operating system.

If updating from a previous release, you may wish note the current settings for
your vehicle first by creating a .UAV file or taking screenshots of vehicle
settings.

.. important:: The software on this page comes with no warranty. Use it at your
own risk and please be careful!

Visit the `OpenPilot forums <http://forums.openpilot.org/>`_ if you have
questions and/or suggestions. Extensive documentation about how the system
works and how to install and configure it is available in this wiki.

Latest version can be found here: `<http://www.openpilot.org/download/>`_.

RELEASE – OP-15.05.02 – Revolution Nano, Revo, OPLM and Platinum GPS
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

.. note:: Please note that **CC3D is NOT supported by this release**. To find
the latest release for the CC3D, please see Release – 15.02.02 below.

.. rubric:: Windows NSIS Installer

`OpenPilot-RELEASE-15.05.2-win32.exe <http://www.openpilot.org/wp-content/uploads/OP-Downloads/OpenPilot-RELEASE-15.05.2-win32.exe>`_

Uninstall previous version first.

.. rubric:: Mac OS X distribution image

`OpenPilot-RELEASE-15.05.2-osx.dmg <http://www.openpilot.org/wp-content/uploads/OP-Downloads/OpenPilot-RELEASE-15.05.2-osx.dmg>`_

Open as a standard distribution image.

.. rubric:: Linux 64 bit Debian package

`openpilot_15.05.2-1_amd64.deb <http://www.openpilot.org/wp-content/uploads/OP-Downloads/openpilot_15.05.2-1_amd64.deb>`_

Uninstall previous version first, then use your system package installer to
install.

.. note:: Please note that Linux .debs will only work with Linux versions Ubuntu
14.04 or later, due to lack of popularity we are no longer building 32 Bit
.debs but if needed you can build them easily using the source below and the
‘make package’ command.

.. rubric:: Source code

`SRC-OpenPilot-RELEASE-15.05.2.tar.gz <http://www.openpilot.org/wp-content/uploads/OP-Downloads/SRC-OpenPilot-RELEASE-15.05.2.tar.gz>`_


::

Note that the CC3D is not supported by this release.
This release fixes an important bug of Nano attitude drift with Basic
attitude estimation.
All Revolution hardware running 15.05.01 should upgrade to 15.05.02.
Note that this is a hotfix; to get the new defaults a full erase settings
is required.
Stabilization settings and banks can be imported back after upgrade
Furthermore, please review your vtolpathfollowersettings:HorizontalVelMax;
a value of around 4m/s would be more appropriate for preliminary trialing of
a new release and will be changed in future.
This version supports Revolution Nano, Revolution, OPLink Modems, and
Platinum GPS.


(Previous) RELEASE – OP-15.02.02 – Revo, CC3D, Atom, CC and v9 GPS
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

This version supports the CopterControl, CC3D, Atom, and Revo as well as the
OPLink Modems.

.. rubric:: Windows NSIS Installer

`OpenPilot-RELEASE-15.02.02-win32.exe <http://www.openpilot.org/wp-content/uploads/OP-Downloads/OpenPilot-RELEASE-15.02.02-win32.exe>`_

Uninstall previous version first.

.. rubric:: Mac OS X distribution image

`OpenPilot-RELEASE-15.02.02-osx.dmg <http://www.openpilot.org/wp-content/uploads/OP-Downloads/OpenPilot-RELEASE-15.02.02-osx.dmg>`_

Open as a standard distribution image.

.. rubric:: Linux Debian packages

:32 bit: `openpilot_15.02.02-1_i386.deb <http://www.openpilot.org/wp-content/uploads/OP-Downloads/openpilot_15.02.02-1_i386.deb>`_
:64 bit: `openpilot_15.02.02-1_amd64.deb <http://www.openpilot.org/wp-content/uploads/OP-Downloads/openpilot_15.02.02-1_amd64.deb>`_

Uninstall previous version first, then use your system package installer to
install.

.. note:: Please note that Linux .debs will only work with Linux versions Ubuntu
14.04 or later.

::

This release fixes a bug that prevents revo onboard mag to work correctly.
Release Notes - OpenPilot - Version RELEASE-15.02.02
The full list of bugfixes in this release is accessible here:
https://progress.openpilot.org/issues/?filter=12262
** Bug
* [OP-1820] - fix onboard mag orientation
* [OP-1821] - Tricopter tail servo wrong speed on wizard
* [OP-1827] - Version ID wrong in Windows uninstaller
* [OP-1857] - PPM on Flexi does not work on CC/CC3D
** Task
* [OP-1831] - due to oneshot higher pid values ki now shows "red" warning in
stabilization page

Installation of the GCS
-----------------------

Open the GCS installer file that you downloaded and follow these steps:

1. Choose a language from the drop-down list on the first page, then click OK.
(You can cancel installation at any point by clicking Cancel.)
2. The OpenPilot Welcome screen appears. Click Next.
3. Review the conditions of the license agreement and then click I Agree to
accept the terms.
4. You can select which components to install in the Choose Components dialog
box. Click Next to accept the default selections.

.. note:: Note that the Mesa OpenGL driver may be required by older operating
systems and is a required component for the GCS interface. If major elements
of the GCS user interface fail to display, re-installation with selection of
the Mesa OpenGL driver may help.

5. You can specify where to install OpenPilot GCS in the Choose Install Location
dialog box. Click Browse to choose a location or Install to install the
software in the default location shown in the text box.
We've designed this section and the OpenPilot/LibrePilot Documentation as a whole to flow
like a story, guiding you through all the steps necessary for successful setup
and flight.

Previous installations of the OpenPilot GCS were installed in the Documents
and Settings directory on Windows machines. The latest default GCS location
is the standard Program Files location on Windows machines.
6. OpenPilot GCS installs on your computer. Click Next when installation is
complete.
7. If you have have chosen the default setup, Windows will now install the CDC
driver for the Virtual Comm Port of your OpenPilot board.
New users will use this section to learn the basics of the system and progress
to their first flight, while experienced users can refresh their memory when
setting up a new board, or gain insight into more detailed functions and
configurations covered in the advanced sections of the manual.

.. note:: Note that the CDC driver is not required to connect and configure
your OpenPilot board with the GCS. You need the CDC driver for Virtual
Comm Port support.
As a new user, try to take things one step at a time, take advantage of video
tutorials where available, and follow the manual in sequential order. We've
provided links to the previous page, next page, and Table of Contents whenever
possible to simplify navigation as you progress through the manual.

8. Click Finish to complete installation. (Clear the check box if you don't want
OpenPilot GCS to run immediately.)
9. If you choose to run OpenPilot GCS immediately, click OK to load the default
configuration file.
10. The OpenPilot GCS start page appears. Congratulations! You can explore
OpenPilot GCS or proceed to the next step, Installing or Updating Your
Firmware.
Let's get started!
146 changes: 146 additions & 0 deletions source/user_manual/gcs_install_lp.rst
View file
Original file line number Diff line number Diff line change
@@ -0,0 +1,146 @@
LibrePilot
==========

You can use the LibrePilot Ground Control Station (GCS) both to configure your
controller board and to control and monitor your aircraft during flight. More
commonly, you would use a conventional radio control transmitter to control
your vehicle, but the GCS is also capable of doing so.

LibrePilot GCS is currently available for the Windows, Mac, and Linux
operating systems.


Downloading the GCS installer
-----------------------------

The first step is to download the appropriate GCS installer. Using the release
table below, select the Download Link that corresponds to your computer's
operating system.

If updating from a previous release, you may wish note the current settings for
your vehicle first by creating a .UAV file or taking screenshots of vehicle
settings.

.. important:: The software on this page comes with no warranty. Use it at your
own risk and please be careful!

Visit the `LibrePilot forums <http://forums.librepilot.org/>`_ if you have
questions and/or suggestions. Extensive documentation about how the system
works and how to install and configure it is available in the
`LibrePilot wiki <https://librepilot.atlassian.net/wiki/display/LPDOC/Welcome>`_
and here.

Latest version can be found here: `<https://librepilot.atlassian.net/wiki/display/LPDOC/Downloads>`_.

RELEASE – 15.09 – First LibrePilot Release - Supermoon Eclipse
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

This is the first LibrePilot release.

This version supports the CopterControl, CC3D, Atom, Revolution, Revolution
Nano, Platinum GPS (V9) and OPLink Modems. The main focus of this release is
to bring back support for CC3D and a general re-branding of the GCS.

Some key addition in this release:
* Easytune : A TxPID feature for 'offline' tuning,
* Improved motor scaling,
* Different Acro+ factors for roll and pitch
* Fixed wing: Roll differential and setup wizard improvements,
* Import/Export and manage templates,
* OSX fix for crashes running 'El Capitan',
* ...

The full list of bug fixes and enhancements in this release is available here:
`15.09 release JIRA list. <https://librepilot.atlassian.net/browse/LP-162?jql=filter%3D10300>`_

.. note: Known Issues:
Due to a change in release naming there is an issue with GCS not showing it
as a genuine release. It is just a cosmetic issue and does not affects flight
performance or reliability.
.. rubric:: Windows

`LibrePilot-15.09-win32.exe <http://bit.ly/1jUC3YT>`_

Uninstall previous version first.

.. rubric:: OSX

`LibrePilot-15.09-osx.dmg <http://bit.ly/1LH0KiZ>`_

.. rubric:: PPA for Ubuntu 15.04+

::

$ sudo add-apt-repository ppa:librepilot/release
$ sudo apt-get update
$ sudo apt-get install librepilot

.. rubric:: Arch Linux

Available on the `AUR <https://aur.archlinux.org/packages/librepilot>`_ or
via repository by adding

::

[librepilot]
SigLevel = Optional TrustAll
Server = http://download.librepilot.org/repo/archlinux/librepilot/$arch

to /etc/pacman.conf.

.. rubric:: Fedora

Repository available `here <https://copr.fedoraproject.org/coprs/parched/LibrePilot>`_.

.. rubric:: Source code

* Archives are available at `<http://download.librepilot.org/source/>`_
* The git mirror at `<https://github.com/librepilot/LibrePilot.git>`_

.. rubric:: Bootloaders

:doc:`/appendices/bootloader`

Installation of the GCS
-----------------------

Open the GCS installer file that you downloaded and follow these steps:

1. Choose a language from the drop-down list on the first page, then click OK.
(You can cancel installation at any point by clicking Cancel.)
2. The LibrePilot Welcome screen appears. Click Next.
3. Review the conditions of the license agreement and then click I Agree to
accept the terms.
4. You can select which components to install in the Choose Components dialog
box. Click Next to accept the default selections.

.. note:: Note that the Mesa OpenGL driver may be required by older operating
systems and is a required component for the GCS interface. If major elements
of the GCS user interface fail to display, re-installation with selection of
the Mesa OpenGL driver may help.

5. You can specify where to install LibrePilot GCS in the Choose Install Location
dialog box. Click Browse to choose a location or Install to install the
software in the default location shown in the text box.

Previous installations of the LibrePilot GCS were installed in the Documents
and Settings directory on Windows machines. The latest default GCS location
is the standard Program Files location on Windows machines.
6. LibrePilot GCS installs on your computer. Click Next when installation is
complete.
7. If you have have chosen the default setup, Windows will now install the CDC
driver for the Virtual Comm Port of your LibrePilot board.

.. note:: Note that the CDC driver is not required to connect and configure
your LibrePilot board with the GCS. You need the CDC driver for Virtual
Comm Port support.

8. Click Finish to complete installation. (Clear the check box if you don't want
LibrePilot GCS to run immediately.)
9. If you choose to run LibrePilot GCS immediately, click OK to load the default
configuration file.
10. The LibrePilot GCS start page appears. Congratulations! You can explore
LibrePilot GCS or proceed to the next step, Installing or Updating Your
Firmware.

0 comments on commit 06955c3

Please sign in to comment.