PaparazziUAV - User contributions [en]

PPRZonDroid

2014-04-18T07:37:52Z

Savassen:

<pre style="color:red; font-weight:bold;">
PLEASE KEEP IN MIND THAT THIS IS A BETA RELEASE FOR BOTH SERVER AND ANDROID APPLICATION AND MAY NOT WORK ON ALL ANDROID VERSIONS!!
</pre>

__TOC__

{|
|-valign="top"
|
[[Image:PPRZonDroid phone.png|thumb|300px|left|App on Nexus4]]
[[Image:PPRZonDroid tablet.png|768px|thumb|right|App on Nexus10]]
|}

= Introduction =
PPRZonDroid is an application that you can use to control Paparazzi aircraft with your android device. Some basic controls can be performed to a ''configured aircraft'' with this application. Server and android application are connected thru wifi, so they should be in the same network :)
Several clients can be connected at the same time with full or restricted access. This app should (theoretically) work with Android 3.2 and up.

[[Image:PPRZonDroidOverview.png|600px|thumb|right|Communications]]

= Installation =
To use it with your device you need to install '''server application (App Server)''' to pc and '''[http://download.paparazziuav.org/android/PPRZonDroid_v0.5.apk android application(.apk)]''' to your cell phone or tablet.

Server application can be found in;
<pre>
path_to_paparazzi_folder/sw/ground_segment/tmtc/app_server
</pre>

Launch server application, and PPRZonDroid app with the correct configuration. App should connect to server and you are ready to go.

= Configuration =

== Server Configuration ==

To launch server application by using paparazzi center, all you need is to add the below code to "programs" section of 'path_to_paparazzi_folder/conf/control_panel.xml' file.

<pre>
<program name="App Server" command="sw/ground_segment/tmtc/app_server"/>
</pre>
This will add 'App Server' to 'Tools>App Server' menu of Paparazzi Center.
Clicking this will launch server application with default settings.

App server uses TCP port (default:5010) to receive commands from clients and send aircraft information (like aircraft names, block names, etc) to connected clients. UDP broadcast is used to send ivy messages to clients. App server usage ;
<pre>
app_server [options]
</pre>
'''Options'''
* -t <TCP port> for receiving devices commands (default: 5010)
* -u <UDP port> for sending AC data (default: 5005)
* -b <Ivy bus> default is 127.255.255.255:2010
* -p <password> password for connection with control capabilities (default is 1234)
* -v verbose
* -h --help show this help

Type;
<pre>
./app_server -h
</pre>
to see help & options to configure App Server.
App server can handle several clients at the same time. Clients who has the correct password will control the aircrafts. If the client password is wrong then command send will be ignored.

== PPRZonDroid Configuration ==

[[Image:PPRZonDroidsettings.png|frame|left|App Settings]]
Click 'Settings' (top right) to view the settings page of PPRZonDroid application.
*'''Use My Location''': Click to use device gps to point your location on map. (Warning: Using this option will reduce battery)
*<strike>'''Connect Server on Start-Up'''</strike> -> (removed in v 0.5)
*'''Block Change Timeout(sec)''' -> Countdown time before jumping to clicked block (in seconds). Setting this value to 0 will make application to wait for user confirmation before changing current block.
*'''Server Ip Adress''':Ip adress of pc where app server is running
*'''Server TCP Port''': TCP port which application will use to connect server. (Should be same as app server setting)
*'''UDP Listen Port''': Device listen UDP port. (Should be same as app server setting)
*'''Password to control Aircrafts''': Password to be able to control aircrafts.
*'''Airspeed warning at''': Application will alert user if airspeed is below this setting. (will not warn below 5m/s). ''This option will work only if an airspeed sensor is defined in airframe file.''
PPRZonDroid application can handle multiple aircraft data. However only selected aircraft data will be shown on user interface. (see [[PPRZonDroid#PPRZonDroid_Usage | PPRZonDroid Usage]])
<div style="clear: both;">
</div>
= PPRZonDroid Usage =
PPRZonDroid application has different layouts for small screen devices (like cell phone) and big screen devices (like tablet).
{|
|-valign="top"
|
[[Image:PPRZonDroid phone.png|thumb|300px|left|App on Nexus4]]
[[Image:PPRZonDroid tablet.png|768px|thumb|right|App on Nexus10]]
|}
[[Image:PPRZonDroid_num.png|frame|right|Screenshots]]
PPRZonDroid is an easy to use application. Both layouts has the same functionalities.
There are three sections in the app. When the app is launched, main screen is viewed with two hidden menus. In tablet layout 'AC MENU' is static also. In main screen (see 'Screenshots' image);
*'''[1]''' = Shows menu to open 'Settings' window.
*'''[2]''' = Selected aircraft name
*'''[3]''' = Some flight parameters
To change the waypoint location; click and hold waypoint, drag it to the new place and drop it. This will fire the 'Waypoint changed' dialog. '''[14]''' After setting the desired altitude click 'Confirm Changes' button to save the changes. To change only altitude of a waypoint, click to the tooltip of that waypoint.

'''Sliding from left''' edge of the screen will show 'App menu'.
*'''[4]''' = Connect button will force app to reconnect to the server app.
*'''[5]''' = Clears the aircraft track on map.
*'''[6]''' = Trace the selected aircraft.
*'''[7]''' = Show/hide unselected aircraft markers.
*'''[8]''' = Change selected aircraft. You can also click aircraft marker tip to change selected aircraft. Aircraft list has AC icon, name and battery.

Selected aircraft's name will appear at the top [2]. Also selected aircraft marker will be marked with yellow corners in the map.

'''Sliding from right''' edge of the screen will show 'AC menu'. ''(This menu is static in big screen layout)''
*'''[9]''' = PFD with some aircraft information. (like heading, battery, altitude)
*'''[10]''' = Block names of selected aircraft.
*'''[11]''' = Launch
*'''[12]''' = Kill throttle
*'''[13]''' = Resurrect

[[Image:PPRZonDroid_blcounter.png|frame|right|Jump to block countdown ]]

Clicking a block name in 'Blocks' list will send this request to app_server. However this request will be shown in UI after app gets this feedback from app_server.
A Jump to block countdown is added to version '''v0.5'''. App will send the request to app_server after countdown finishes. Timeout value can be configured in 'Settings'. Click check button to send the request immediately, or cancel button to stop&cancel the request.

Please see the demo video for brief app usage.

== Demo Video ==

{{#ev:youtubehd|sPR1K1DH7MI}}

= Troubleshooting =

The application may not work on all Android versions at the moment.

* Working configurations
** 4.2.2
** 4.3 (HTC One)
** 4.4.2 (Nexus 5, Nexus 10)

* Not working configurations
** 4.0.1 (Galaxy Tab)

File:PPRZonDroid blcounter.png

2014-04-17T13:30:45Z

Savassen:

File:PPRZonDroid num.png

2014-04-17T13:21:08Z

Savassen: Savassen uploaded a new version of "File:PPRZonDroid num.png"

File:PPRZonDroidsettings.png

2014-04-17T12:54:20Z

Savassen: Savassen uploaded a new version of "File:PPRZonDroidsettings.png"

File:PPRZonDroidsettings.png

2014-04-17T12:52:28Z

Savassen: Savassen uploaded a new version of "File:PPRZonDroidsettings.png"

PPRZonDroid

2014-04-02T22:36:59Z

Savassen:

<pre style="color:red; font-weight:bold;">
PLEASE KEEP IN MIND THAT THIS IS A BETA RELEASE FOR BOTH SERVER AND ANDROID APPLICATION AND MAY NOT WORK ON ALL ANDROID VERSIONS!!
</pre>

__TOC__

{|
|-valign="top"
|
[[Image:PPRZonDroid phone.png|thumb|300px|left|App on Nexus4]]
[[Image:PPRZonDroid tablet.png|768px|thumb|right|App on Nexus10]]
|}

= Introduction =
PPRZonDroid is an application that you can use to control Paparazzi aircraft with your android device. Some basic controls can be performed to a ''configured aircraft'' with this application. Server and android application are connected thru wifi, so they should be in the same network :)
Several clients can be connected at the same time with full or restricted access.

[[Image:PPRZonDroidOverview.png|600px|thumb|right|Communications]]

= Installation =
To use it with your device you need to install '''server application (App Server)''' to pc and '''[http://download.paparazziuav.org/android/PPRZonDroid_v0.4.apk android application(.apk)]''' to your cell phone or tablet.

Server application can be found in;
<pre>
path_to_paparazzi_folder/sw/ground_segment/tmtc/app_server
</pre>

Launch server application, and PPRZonDroid app with the correct configuration. App should connect to server and you are ready to go.

= Configuration =

== Server Configuration ==

To launch server application by using paparazzi center, all you need is to add the below code to "programs" section of 'path_to_paparazzi_folder/conf/control_panel.xml' file.

<pre>
<program name="App Server" command="sw/ground_segment/tmtc/app_server"/>
</pre>
This will add 'App Server' to 'Tools>App Server' menu of Paparazzi Center.
Clicking this will launch server application with default settings.

App server uses TCP port (default:5010) to receive commands from clients and send aircraft information (like aircraft names, block names, etc) to connected clients. UDP broadcast is used to send ivy messages to clients. App server usage ;
<pre>
app_server [options]
</pre>
'''Options'''
* -t <TCP port> for receiving devices commands (default: 5010)
* -u <UDP port> for sending AC data (default: 5005)
* -b <Ivy bus> default is 127.255.255.255:2010
* -p <password> password for connection with control capabilities (default is 1234)
* -v verbose
* -h --help show this help

Type;
<pre>
./app_server -h
</pre>
to see help & options to configure App Server.
App server can handle several clients at the same time. Clients who has the correct password will control the aircrafts. If the client password is wrong then command send will be ignored.

== PPRZonDroid Configuration ==

[[Image:PPRZonDroidsettings.png|frame|left|App Settings]]
Click 'Settings' (top right) to view the settings page of PPRZonDroid application.
*'''Use My Location''': Click to use device gps to point your location on map. (Warning: Using this option will reduce battery)
*'''Connect Server on Start-Up''' -> Will be removed
*'''Server Ip Adress''': Ip adress of pc where app server is running
*'''Server TCP Port''': TCP port which application will use to connect server. (Should be same as app server setting)
*'''UDP Listen Port''': Device listen UDP port. (Should be same as app server setting)
*'''Password to control Aircrafts''': Password to be able to control aircrafts.
*'''Airspeed warning at''': Application will alert user if airspeed is below this setting. (will not warn below 5m/s). ''This option will work only if an airspeed sensor is defined in airframe file.''
PPRZonDroid application can handle multiple aircraft data. However only selected aircraft data will be shown on user interface. (see [[PPRZonDroid#PPRZonDroid_Usage | PPRZonDroid Usage]])
<div style="clear: both;">
</div>
= PPRZonDroid Usage =
PPRZonDroid application has different layouts for small screen devices (like cell phone) and big screen devices (like tablet).
{|
|-valign="top"
|
[[Image:PPRZonDroid phone.png|thumb|300px|left|App on Nexus4]]
[[Image:PPRZonDroid tablet.png|768px|thumb|right|App on Nexus10]]
|}
[[Image:PPRZonDroid_num.png|frame|right|Screenshots]]
PPRZonDroid is an easy to use application. Both layouts has the same functionalities.
There are three sections in the app. When the app is launched, main screen is viewed with two hidden menus. In tablet layout 'AC MENU' is static also. In main screen (see 'Screenshots' image);
*'''[1]''' = Shows menu to open 'Settings' window.
*'''[2]''' = Selected aircraft name
*'''[3]''' = Some flight parameters
To change the waypoint location; click and hold waypoint, drag it to the new place and drop it. This will fire the 'Waypoint changed' dialog. '''[14]''' After setting the desired altitude click 'Confirm Changes' button to save the changes.

'''Sliding from left''' edge of the screen will show 'App menu'.
*'''[4]''' = Connect button will force app to reconnect to the server app.
*'''[5]''' = Clears the aircraft track on map.
*'''[6]''' = Trace the selected aircraft.
*'''[7]''' = Show/hide unselected aircraft markers.
*'''[8]''' = Change selected aircraft. You can also click aircraft marker tip to change selected aircraft. Aircraft list has AC icon, name and battery.

Selected aircraft's name will appear at the top [2]. Also selected aircraft marker will be marked with yellow corners in the map.

'''Sliding from right''' edge of the screen will show 'AC menu'. ''(This menu is static in big screen layout)''
*'''[9]''' = PFD with some aircraft information. (like heading, battery, altitude)
*'''[10]''' = Block names of selected aircraft. (! Right now changing blocks will not require any approval)
*'''[11]''' = Launch
*'''[12]''' = Kill throttle
*'''[13]''' = Resurrect

Please see the demo video for brief app usage.

== Demo Video ==

{{#ev:youtubehd|sPR1K1DH7MI}}

= Troubleshooting =

The application may not work on all Android versions at the moment.

* Working configurations
** 4.2.2
** 4.3 (HTC One)
** 4.4.2 (Nexus 5, Nexus 10)

* Not working configurations
** 4.0.1 (Galaxy Tab)

PPRZonDroid

2014-04-02T20:03:37Z

Savassen:

<pre style="color:red; font-weight:bold;">
PLEASE KEEP IN MIND THAT THIS IS A BETA RELEASE FOR BOTH SERVER AND ANDROID APPLICATION AND MAY NOT WORK ON ALL ANDROID VERSIONS!!
</pre>

__TOC__

{|
|-valign="top"
|
[[Image:PPRZonDroid phone.png|thumb|300px|left|App on Nexus4]]
[[Image:PPRZonDroid tablet.png|600px|thumb|right|App on Nexus10]]
|}

= Introduction =
PPRZonDroid is an application that you can use to control Paparazzi aircraft with your android device. Some basic controls can be performed to a ''configured aircraft'' with this application. Server and android application are connected thru wifi, so they should be in the same network :)
Several clients can be connected at the same time with full or restricted access.

[[Image:PPRZonDroidOverview.png|600px|thumb|right|Communications]]

= Installation =
To use it with your device you need to install '''server application (App Server)''' to pc and '''[http://download.paparazziuav.org/android/PPRZonDroid_v0.4.apk android application(.apk)]''' to your cell phone or tablet.

Server application can be found in;
<pre>
path_to_paparazzi_folder/sw/ground_segment/tmtc/app_server
</pre>

Launch server application, and PPRZonDroid app with the correct configuration. App should connect to server and you are ready to go.

= Configuration =

== Server Configuration ==

To launch server application to from paparazzi center, all you need is add the below code to "programs" section of 'path_to_paparazzi_folder/conf/control_panel.xml' file.

<pre>
<program name="App Server" command="sw/ground_segment/tmtc/app_server"/>
</pre>
This will add 'App Server' to 'Tools>App Server' menu of Paparazzi Center.
Clicking this will launch server application with default settings.

App server uses TCP port (default:5010) to receive commands from clients and send aircraft information (like aircraft names, block names, etc) to connected clients. UDP broadcast is used to send ivy messages to clients. App server usage ;
<pre>
app_server [options]
</pre>
'''Options'''
* -t <TCP port> for receiving devices commands (default: 5010)
* -u <UDP port> for sending AC data (default: 5005)
* -b <Ivy bus> default is 127.255.255.255:2010
* -p <password> password for connection with control capabilities (default is 1234)
* -v verbose
* -h --help show this help

Type;
<pre>
./app_server -h
</pre>
to see & configure App Server.
App server can handle several clients at the same time. Clients who has the correct password will control the aircrafts. If the client password is wrong then command send will be ignored.

== PPRZonDroid Configuration ==

[[Image:PPRZonDroidsettings.png|frame|left|App Settings]]
Click 'Settings' (top right) to view the settings page of PPRZonDroid application.
*'''Use My Location''': Click to use device gps to point your location on map. (Warning: Using this option will reduce battery)
*'''Connect Server on Start-Up''' -> Will be removed
*'''Server Ip Adress''': Ip adress of pc where app server is running
*'''Server TCP Port''': TCP port which application will use to connect server. (Should be same as app server setting)
*'''UDP Listen Port''': Device listen UDP port. (Should be same as app server setting)
*'''Password to control Aircrafts''': Password to be able to control aircrafts.
*'''Airspeed warning at''': Application will alert user if airspeed is below this setting. (will not warn below 5m/s). ''This option will work only if an airspeed sensor is defined in airframe file.''
PPRZonDroid application can handle multiple aircraft data. However only selected aircraft data will be shown on user interface. (see [[PPRZonDroid#PPRZonDroid_Usage | PPRZonDroid Usage]])
<div style="clear: both;">
</div>
= PPRZonDroid Usage =
PPRZonDroid application has different layouts for small screen devices (like cell phone) and big screen devices (like tablet).
{|
|-valign="top"
|
[[Image:PPRZonDroid phone.png|thumb|300px|left|App on Nexus4]]
[[Image:PPRZonDroid tablet.png|600px|thumb|right|App on Nexus10]]
|}
[[Image:PPRZonDroid_num.png|frame|right|Screenshots]]
PPRZonDroid is an easy to use application. Both layouts has the same functionalities.
There are three sections in the app. When the app is launched, main screen is viewed with two hidden menus. In tablet layout 'AC MENU' is static also. In main screen (see 'Screenshots' image);
*'''[1]''' = Shows menu to open 'Settings' window.
*'''[2]''' = Selected aircraft name
*'''[3]''' = Some flight parameters
To change the waypoint location; click and hold waypoint, drag it to the new place and drop it. This will fire the 'Waypoint changed' dialog. '''[14]''' After setting the desired altitude click 'Confirm Changes' button to save the changes.

'''Sliding from left''' edge of the screen will show 'App menu'.
*'''[4]''' = Connect button will force app to reconnect to the server app.
*'''[5]''' = Clears the aircraft track on map.
*'''[6]''' = Trace the selected aircraft.
*'''[7]''' =
*'''[8]''' = Change selected aircraft. You can also click aircraft marker tip to change selected aircraft. Aircraft list has AC icon, name and battery.

Selected aircraft's name will appear at the top [2]. Also selected aircraft marker will be marked with yellow corners in the map.

'''Sliding from right''' edge of the screen will show 'AC menu'. ''(This menu is static in big screen layout)''
*'''[9]''' = PFD with some aircraft information. (like heading, battery, altitude)
*'''[10]''' = Block names of selected aircraft. (! Right now changing blocks will not require any approval)
*'''[11]''' = Launch
*'''[12]''' = Kill throttle
*'''[13]''' = Resurrect

Please see the demo video for brief app usage.

== Demo Video ==

{{#ev:youtubehd|sPR1K1DH7MI}}

= Troubleshooting =

The application may not work on all Android versions at the moment.

* Working configurations
** 4.2.2
** 4.3 (HTC One)
** 4.4.2 (Nexus 5, Nexus 10)

* Not working configurations
** 4.0.1 (Galaxy Tab)

PPRZonDroid

2014-04-01T16:34:33Z

Savassen:

<pre style="color:red; font-weight:bold;">
PLEASE KEEP IN MIND THAT THIS IS A BETA RELEASE FOR BOTH SERVER AND ANDROID APPLICATION!!
</pre>

{|
|-valign="top"
|
[[Image:PPRZonDroid phone.png|thumb|300px|left|App on Nexus4]]
[[Image:PPRZonDroid tablet.png|600px|thumb|right|App on Nexus10]]
|}

= Introduction =
PPRZonDroid is an application that you can use to control Paparazzi aircraft with your android device. Some basic controls can be performed to a ''configured aircraft'' with this application. Server and android application are connected thru wifi, so they should be in the same network :)
Several clients can be connected at the same time with full or restricted access.

[[Image:PPRZonDroidOverview.png|600px|thumb|right|Communications]]

= Installation =
To use it with your device you need to install '''server application (App Server)''' to pc and '''[http://download.paparazziuav.org/android/PPRZonDroid_v0.4.apk android application(.apk)]''' to your cell phone or tablet.

Server application can be found in;
<pre>
path_to_paparazzi_folder/sw/ground_segment/tmtc/app_server
</pre>

Launch server application, and PPRZonDroid app with the correct configuration. App should connect to server and you are ready to go.

= Configuration =

== Server Configuration ==

To launch server application to from paparazzi center, all you need is add the below code to "programs" section of 'path_to_paparazzi_folder/conf/control_panel.xml' file.

<pre>
<program name="App Server" command="sw/ground_segment/tmtc/app_server"/>
</pre>
This will add 'App Server' to 'Tools>App Server' menu of Paparazzi Center.
Clicking this will launch server application with default settings.

App server uses TCP port (default:5010) to receive commands from clients and send aircraft information (like aircraft names, block names, etc) to connected clients. UDP broadcast is used to send ivy messages to clients. App server usage ;
<pre>
app_server [options]
</pre>
'''Options'''
* -t <TCP port> for receiving devices commands (default: 5010)
* -u <UDP port> for sending AC data (default: 5005)
* -b <Ivy bus> default is 127.255.255.255:2010
* -p <password> password for connection with control capabilities (default is 1234)
* -v verbose
* -h --help show this help

Type;
<pre>
./app_server -h
</pre>
to see & configure App Server.
App server can handle several clients at the same time. Clients who has the correct password will control the aircrafts. If the client password is wrong then command send will be ignored.

== PPRZonDroid Configuration ==

[[Image:PPRZonDroidsettings.png|frame|left|App Settings]]
Click 'Settings' (top right) to view the settings page of PPRZonDroid application.
*'''Use My Location''': Click to use device gps to point your location on map. (Warning: Using this optin will reduce battery)
*'''Connect Server on Start-Up''' -> Will be removed
*'''Server Ip Adress''': Ip adress of pc where app server is running
*'''Server TCP Port''': TCP port which application will use to connect server. (Should be same as app server setting)
*'''UDP Listen Port''': Device listen UDP port. (Should be same as app server setting)
*'''Password to control Aircrafts''': Password to be able to control aircrafts.
*'''Airspeed warning at''': Application will alert user if airspeed is below this setting. (will not warn below 5m/s). ''This option will work only if an airspeed sensor is defined in airframe file.''
PPRZonDroid application can handle multiple aircraft data. However only selected aircraft data will be shown on user interface. (see [[PPRZonDroid Usage]])
<div style="clear: both;">
</div>
= PPRZonDroid Usage =
PPRZonDroid application has different layouts for small screen devices (like cell phone) and big screen devices (like tablet).
{|
|-valign="top"
|
[[Image:PPRZonDroid phone.png|thumb|300px|left|App on Nexus4]]
[[Image:PPRZonDroid tablet.png|600px|thumb|right|App on Nexus10]]
|}
[[Image:PPRZonDroid_num.png|frame|right|Screenshots]]
PPRZonDroid is an easy to use application. Both layouts has the same functionalities.
There are three sections in the app. When the app is launched, main screen is viewed with two hidden menus. In tablet layout 'AC MENU' is static also. In main screen (see 'Screenshots' image);
*'''[1]''' = Shows menu to open 'Settings' window.
*'''[2]''' = Selected aircraft name
*'''[3]''' = Some flight parameters
To change the waypoint location; click and hold waypoint, drag it to the new place and drop it. This will fire the 'Waypoint changed' dialog. '''[14]''' After setting the desired altitude click 'Confirm Changes' button to save the changes.

File:PPRZonDroid num.png

2014-04-01T16:17:10Z

Savassen:

File:PPRZonDroidsettings.png

2014-04-01T14:13:42Z

Savassen:

File:PPRZonDroidOverview.png

2014-04-01T13:01:14Z

Savassen:

PPRZonDroid

2014-04-01T11:38:21Z

Savassen: /* Introduction */

<pre style="color:red; font-weight:bold;">
Please keep in mind that this is a beta release for both server and android app.
</pre>

{|
|-valign="top"
|
[[Image:PPRZonDroid phone.png|thumb|300px|left|App on Nexus4]]
[[Image:PPRZonDroid tablet.png|600px|thumb|right|App on Nexus10]]
|}

= Introduction =
PPRZonDroid is an application that you can use to control Paparazzi aircraft with your android device. Some basic controls can be performed to a ''configured aircraft'' with this application. Server and android application are connected thru wifi, so they should be in the same network :)

= Installation =
To use it with your device you need to install '''server application''' to pc and '''[http://download.paparazziuav.org/android/PPRZonDroid_v0.4.apk/ android application(.apk)]''' to your cell phone or tablet.

Server application code can be found in;
<pre>
path_to_paparazzi_folder/sw/ground_segment/tmtc/app_server.c
</pre>

= Manual =

PPRZonDroid

2014-04-01T11:33:58Z

Savassen: /* Installation */

<pre style="color:red; font-weight:bold;">
Please keep in mind that this is a beta release for both server and android app.
</pre>

{|
|-valign="top"
|
[[Image:PPRZonDroid phone.png|thumb|300px|left|App on Nexus4]]
[[Image:PPRZonDroid tablet.png|600px|thumb|right|App on Nexus10]]
|}

= Introduction =
PPRZonDroid is an application that you can use to control Paparazzi aircraft with your android device. Some basic controls can be performed to a ''configured aircraft'' with this application.

= Installation =
To use it with your device you need to install '''server application''' to pc and '''[http://download.paparazziuav.org/android/PPRZonDroid_v0.4.apk/ android application(.apk)]''' to your cell phone or tablet.

Server application code can be found in;
<pre>
path_to_paparazzi_folder/sw/ground_segment/tmtc/app_server.c
</pre>

= Manual =

PPRZonDroid

2014-04-01T11:29:11Z

Savassen:

<pre style="color:red; font-weight:bold;">
Please keep in mind that this is a beta release for both server and android app.
</pre>

{|
|-valign="top"
|
[[Image:PPRZonDroid phone.png|thumb|300px|left|App on Nexus4]]
[[Image:PPRZonDroid tablet.png|600px|thumb|right|App on Nexus10]]
|}

= Introduction =
PPRZonDroid is an application that you can use to control Paparazzi aircraft with your android device. Some basic controls can be performed to a ''configured aircraft'' with this application.

= Installation =
To use it with your device you need to install '''server application''' to pc and '''[http://download.paparazziuav.org/android/PPRZonDroid_v0.4.apk/ android application(.apk)]''' to your cell phone or tablet.

Server application can be found in;
<pre>
path_to_paparazzi_folder/sw/ground_segment/tmtc/app_server
</pre>

= Manual =

PPRZonDroid

2014-04-01T11:28:10Z

Savassen: /* Installation */

{|
|-valign="top"
|
[[Image:PPRZonDroid phone.png|thumb|300px|left|App on Nexus4]]
[[Image:PPRZonDroid tablet.png|600px|thumb|right|App on Nexus10]]
|}

= Introduction =
PPRZonDroid is an application that you can use to control Paparazzi aircraft with your android device. Some basic controls can be performed to a ''configured aircraft'' with this application.

= Installation =
To use it with your device you need to install '''server application''' to pc and '''[http://download.paparazziuav.org/android/PPRZonDroid_v0.4.apk/ android application(.apk)]''' to your cell phone or tablet.

Server application can be found in;
<pre>
path_to_paparazzi_folder/sw/ground_segment/tmtc/app_server
</pre>

= Manual =

PPRZonDroid

2014-04-01T10:04:29Z

Savassen:

{|
|-valign="top"
|
[[Image:PPRZonDroid phone.png|thumb|300px|left|App on Nexus4]]
[[Image:PPRZonDroid tablet.png|600px|thumb|right|App on Nexus10]]
|}

= Introduction =
PPRZonDroid is an application that you can use to control Paparazzi aircraft with your android device. Some basic controls can be performed to a ''configured aircraft'' with this application.

= Installation =
To use it with your device you need to install '''server application''' to pc and '''android application(.apk)''' to your cell phone or tablet.
Please keep in mind that this is a beta release for both server and android app.

= Manual =

PPRZonDroid

2014-04-01T09:57:43Z

Savassen:

PPRZonDroid is an application that you can use to control Paparazzi aircraft with your android device.

{|
|-valign="top"
|
[[Image:PPRZonDroid phone.png|thumb|300px|left|App on Nexus4]]
[[Image:PPRZonDroid tablet.png|600px|thumb|right|App on Nexus10]]
|}

To use it with your device you need to install '''server application''' to pc and '''android application(.apk)''' to your cell phone or tablet.

Please keep in mind that this is a beta release for both server and android app.

File:PPRZonDroid tablet.png

2014-04-01T09:54:29Z

Savassen: Savassen uploaded a new version of "File:PPRZonDroid tablet.png"

PPRZonDroid app on Nexus 10

File:PPRZonDroid phone.png

2014-04-01T09:51:54Z

Savassen: Savassen uploaded a new version of "File:PPRZonDroid phone.png"

PPRZonDroid app on cell phone

File:PPRZonDroid tablet.png

2014-04-01T08:58:34Z

Savassen: PPRZonDroid app on Nexus 10

PPRZonDroid app on Nexus 10

PPRZonDroid

2014-04-01T08:54:34Z

Savassen: Created page with "PPRZonDroid is an application that you can use to control Paparazzi aircraft with your android device. Image:PPRZonDroid phone.png|thumb|300px|center|App on small screens..."

PPRZonDroid is an application that you can use to control Paparazzi aircraft with your android device.

[[Image:PPRZonDroid phone.png|thumb|300px|center|App on small screens]]

To use it with your device you need to install '''server application''' to pc and '''android application(.apk)''' to your cell phone or tablet.

Please keep in mind that this is a beta release for both server and android app.

File:PPRZonDroid phone.png

2014-04-01T08:38:06Z

Savassen: PPRZonDroid app on cell phone

PPRZonDroid app on cell phone

GCS

2014-03-31T16:41:20Z

Savassen: /* Related Links */

<categorytree style="float:right; clear:right; margin-left:1ex; border: 1px solid gray; padding: 0.7ex;" mode=pages>GCS</categorytree>
__TOC__

Ground Control Station

{|
|-valign="top"
|__TOC__
|
[[Image:gcs.jpg|frame|left|The Paparazzi Ground Control Station is the heart of the system and the user's primary interaction interface.]] [[Image:GCSParrotardroneandpaparazzi.jpg|right|370px| THe GCS is very flexible in the way you can change the look and add functionality. One only need to change a configuration file. For example, the look when using the configuration GCS setting for Paparazzi Parrot AR Drone 2]]
|}

= Introduction =

The [[GCS_Configuration | versatile]] Paparazzi Ground Control Station is an operator control unit ground control software for unmanned aircraft. It allows to visualize and control an unmanned aircraft during development and operation, both indoors and outdoors. With a flexible software architecture it supports multiple UA types/autopilot projects. The purpose of the '''G'''round '''C'''ontrol '''S'''tation is real-time monitoring of an UA.

= Features =

The Paparazzi GroundControlStation is a feature-rich application with fully customizable views, each containing a collection of the most useful interface components for a particular purpose.

* Simultaneous flying '''multi UAS''' support
* Multi-system support (multiple procotols, multiple autopilots/projects) by writing a IVY Plugin
* 2D Map capable of displaying Google Satellite, OpenStreetMaps Images and Microsoft Satellite Maps
* Mission planning
* '''Realtime movable waypoints'''
* Realtime flightplan adjustments if needed
* System status overview
* '''Realtime''' Airframe '''in Air tuning''' and calibration
* Supports rotary and fixed-wing e.g. Airplanes, helicopters, coaxial and quadrotors
* Definable '''Hotkeys''' for quick simple in the field control
* '''Voice''' status output
* Full freely '''configurable GUI layout'''

= Configuration Options =
The [[GCS_Configuration|GCS is highly configurable]] and modules can be added, removed, or resized as needed. In addition to this the GCS has many '''command line options''' which can be used when launching the GCS
<br>
See the [[GCS_Configuration|'''GCS configuration''']] page for details.

= Simulation of Flightplan =
Your flight plans can, and should, always be tested prior to a real autonomous flight. Testing end adjusting is possible from within the same GCS. See the [[Simulation|simulation]] page for details.

= Options =

== Strips ==

Each A/C has an associated strip that displays information about the A/C and provides buttons for common commands. The strip has the following layout by default. Paparazzi GCS is very flexible and the strip can have more or less buttons according to your configuration.

[[Image:strip.png|Aircraft information strip]]

=== Displayed information ===

* Left: Flight information
* Center: Navigation information
* Right: Navigation control
* Bottom: Custom navigation and setting buttons

=== Actions ===

Every change in the waypoints (position or/and [[Altitude_definitions|altitude]]) must be confirmed with the dialog box that appears after the move. A modified waypoint remains animated on the map and the GCS continues to re-send the move request until confirmation is received from the aircraft.
When clicked, the '''Mark''' button places a mark on the map at the A/C position. A snapshot from the video plugin is associated to this mark and can be viewed by moving the mouse over the mark. A click on the mark opens a dialog box allowing to delete the mark.
A click on the colored bar at the top selects the corresponding A/C in the [[#notebook|Notebook]].

== Map ==

[[Image:GCSmap.png|thumb|400px|Sample map showing the various features]]

=== Display ===

The map display contains the following information:
* The A/C track: it can be erased ''via'' the ''Clear track'' option from the A/C menu.
* The A/C label (in clear blue near the A/C) contains the name of the A/C (Plaster), it's altitude (218 m) and it's ground speed (11.99 m/s). This option default is off. It can be activated with the ''A/C label'' option from the A/C menu.
* The carrot (the orange triangle). This is the point the A/C is following during autonomous navigation.
* The waypoints defined in the flight plan (blue diamonds).
* The intended trajectory is shown as a green line, in this example a circle around waypoint 2.
* The default background is black. [[Maps|Maps]] can be loaded to provide navigation reference.
* The camera footprint (the grey polygon) is representative of the swath of land currently seen by the onboard camera. This option default is off. It can be activated with the ''Cam footprint'' option from the A/C menu. see also [[Pan_Tilt_Camera]]
* The WGS84 coordinates of the mouse cursor are displayed at the top right hand corner (43.462019 1.270474).
* A UTM kilometric grid can be added to the background ''via'' the ''UTM grid'' option from the ''Nav'' menu.
* The [[Altitude_definitions|height Above Ground Level (AGL)]] displays the ground altitude of the mouse near the geographic position in the top right hand corner. The [http://srtm.usgs.gov/ SRTM] option must be enabled in the ''Nav'' menu and the height data must be downloaded as described [[Maps#Height_Data|here]]. If SRTM data is not enabled and downloaded, the height above mean sea level [[Altitude_definitions#MSL|MSL]] will be displayed instead.

=== Navigation ===

You can pan/zoom the map using the following:
* Pan with the blue arrows on the map or use the arrow keys on the keyboard
* zoom in/out with the mouse scroll wheel, the page up/page down buttons or the small up/down buttons at the top right hand corner where the zoom factor is displayed
* fit the map to the window, in order to see all the waypoints and A/C, with the '''f''' key or the ''Fit'' option from the ''Nav'' menu;
* center the map on an A/C with the ''Center A/C'' option from the corresponding A/C menu.

=== Map Photo Tiles ===
The default black background can be automatically filled with calibrated satellite photo tiles from Openstreetmaps, Google Maps or MS Maps. Note: If you download too much map data from Google into the GCS you may be blocked for downloading further map data for 24 hours. With OpenStreetmaps data and MS data there is no such limitation.
<br>
See the [[Maps]] page for more info.

=== Waypoint Editing ===

The properties of any waypoint in the currently loaded flight plan can be modified by two methods:
* Drag and drop the waypoints to a new location (a confirmation dialog will appear).
* A single left click on a waypoint opens a dialog box where you can edit the waypoint's coordinates and altitude.

Waypoint edits are sent to the aircraft immediately upon confirmation in the dialog box. The GCS will re-send the data and the waypoint will animate until the aircraft confirms receipt of the move request. New waypoints cannot be added during flight.
<br>
See the [[Flight_Plans|Flight plans]] and [[Flight_Plan_Editor|Flight Plan Editor]] pages for more information on waypoints.

== Notebook ==

The notebook frame contains one page for each running aircraft. Each aircraft page is itself divided into subpages displaying telemetry data and giving access to the autopilot tuning parameters.

Note that the colored tabs at the top of this section allow the user to select among multiple aircraft.

=== Flight Plan ===

<center>
[[Image:GCSfp.png|Flight plan tree]]
</center>

The full tree of the flight plan is given in this page. The current block and the current stage are highlighted. A double-click on a block allows the operator to immediately switch navigation to this block.
<br>
See the [[Flight_Plans|Flight plans]] and [[Flight_Plan_Editor|Flight Plan Editor]] pages for more information on flight plans.

=== Settings ===
<center>
[[Image:GCSsettings.png|Settings tab]]
</center>
The setting page allows the operator to change variable values during flight. The layout of the page is generated from the <tt>dl_settings</tt> section of the settings.xml file, one tab is associated to every section and sub-section.

On each line is displayed (from left to right), the name of the variable, its current value (periodically sent by the A/C), a slider or radio buttons for user input, and commit/undo buttons. Also note, clicking on the current value will send a request to obtain the current value from the aircraft.
<br>
See the [[Telemetry#Settings|Telemetry]] page for more information on settings.
<br>
The save button of this tab opens the following popup which proposes to the user to save the current values in the airframe file (according to the <tt>param</tt> attribute in the [[Telemetry#Settings|setttings]] configuration file). The values of the checked rows will be saved in the airframe file (or any other file) for further use. Units (e.g. deg or rad) are taken into account. '''It is recommended to backup the airframe file before overwriting it with this utility''' (even if time-stamped copy of the airframe file is actually automatically done).

Symetrically, the Upload button of this dialog button will send all the checked values of the airframe file to the live aircraft.
<center>
[[Image:Save settings.png|Settings tab]]
</center>

=== PFD ===

[[Image:GCSpfd.png|Primary Flight Display]]

The Primary Flight Display contains an artificial horizon and two scales displaying the current ground speed (left side) and the altitude (right side). Minimum and maximum speeds are shown under and above the speed scale. A click on the scale resets these values to the current speed value.

=== GPS, Infrared, Wind ===

The '''GPS''' page gives the list of satellites tracked by the receiver and their respective signal strengths in dB.
(35 is low, 45 is excellent) and if they are used to compute the fix (green: used, red:not used). This page may help to tune the position of the receiver on the aircraft relatively to other components (e.g. datalink and video transmitters).

The '''Infrared''' page is only used for aircraft not equipped with the vertical infrared sensor. This page reports the required pre-flight calibration value as well as the evolution of the in-flight calibration correction factor (from hybridization with the GPS information).

The '''Misc''' page displays the estimated wind velocity computed by the ground station during flight and relayed back to the aircraft. Wind velocity is estimated by vector addition of the GPS-measured ground speed in many different directions during level flight. This computation may soon be performed by the autopilot instead of the ground station.

== Video Plugin ==

The <tt>-mplayer</tt> option of GCS allows the user to display a video stream in this window. The video window can also be exchanged with the map by clicking anywhere inside the frame or from the menu.
Use the following line in your [[Control_panel.xml|control panel]] to enable the video window.
<tt>path_to_ground_segment/cockpit/gcs -mplayer rtsp://localhost:7070/video -layout appropriate_layout.xml</tt>
Note that a <tt>plugin</tt> widget must be specified in the used layout:
<source lang="xml"> <widget size="300" name="plugin"/> </source>
A useful example of how to configure the GCS to show video from a USB DVB-T tuner with composite input follows:

If you have an Avermedia DVB-T usb tuner like the Aver-Tv Hybrid Volar HX (Avermedia finally released Ubuntu Linux drivers)
then in order to use the usb tuner as video input to the GCS you have to complete the following steps:

First download and install the drivers and check that the Usb tuner works well by connecting a video signal to the composite input
and then opening a console window and typing:

'''mplayer tv:// -tv driver=v4l2:width=320:height=240:norm=NTSC:input=1:device=/dev/video1:noaudio'''

Remember to change the "device=/dev/video1" in the above line with whatever your new usb tuner is registered with (if needed).
Type "dmesg" in a console immediately after you connect the usb tuner and you should see a line stating the video device your usb tuner got registered with.
If it says video0 change "device=/dev/video1" with "device=/dev/video0"
Mine is registered as "video1" because "video0" is the built in laptop camera.
If everything is ok then a blue or similar LED on the usb tuner dongle should light up indicating that the tuner driver is loaded
and you should be able to watch the video on the pc screen (no audio yet).
Now close the console and remove the Usb tuner as it is time to configure the control_panel.xml file by editing the GCS command line.
Locate the line in the "control_panel.xml" file, usually located in "/Your Paparazzi directory/conf/" (mine is in "/paparazzi/conf/"),
that starts with "<program name="GCS" command="sw/ground_segment/cockpit/gcs......".
For example let's say that the complete line looks like this:

<source lang="xml"> <program name="GCS" command="sw/ground_segment/cockpit/gcs -layout horizontal.xml"> </source>

Now add the below line at the end (before the quotes) of the original line:

'''-mplayer 'tv:// -tv driver=v4l2:width=320:height=240:norm=NTSC:input=1:device=/dev/video1:alsa:adevice=hw.2,0:amode=1:audiorate=48000:forceaudio:volume=100:immediatemode=0''''

The original line should look now like this:

<program name="GCS" command="sw/ground_segment/cockpit/gcs -layout horizontal.xml -mplayer
'tv:// -tv driver=v4l2:width=320:height=240:norm=NTSC:input=1:device=/dev/video1:alsa:adevice=hw.2,0:amode=1:audiorate=48000:forceaudio:volume=100:immediatemode=0'">

The above line is one complete and uninterrupted line but it is just too long to show it in one line here.
Please remember to change the "NTSC" with "PAL" if you do not use the NTSC video system (if your airborne camera is PAL for example).
This will load the mplayer, select the composite video input of the tuner and enable the sound input.
Read the mplayer documentation so you can tweak the resolution etc. later to suit your particular setup.
The resolution above is set to 320x240 here but you can set it to 640x480 by replacing the numbers in the command line above.

Finally you have to add the plugin widget to your GCS layout configuration file.
If you noticed the GCS command line in the "control_panel.xml" file, it has a part that reads "-layout horizontal.xml"
so our layout configuration file is the "horizontal.xml" which is located always in "/Your Paparazzi directory/conf/gcs/"
(mine is in "/paparazzi/conf/gcs/").
Open the file and add or uncomment the below line (in "horizontal.xml" the plugin widget is there but commented out):

<source lang="xml"><widget NAME="plugin" SIZE="300"/> </source>

Now the file should look like this:

<source lang="xml">
<rows>
<widget size="500" name="map2d"/>
<columns>
<rows size="375">
<widget size="200" name="strips"/>
</rows>
<widget size="400" name="aircraft"/>
<widget name="alarms"/>
<widget NAME="plugin" SIZE="300"/>
</columns>
</rows>
</source>

That's it, Enjoy!

Tested in Ubuntu 10.04 LTS but probably the same method should work fine on different versions too.

See this [http://www.youtube.com/watch?v=7OCcMA4vluM screen capture] as an example of the resulting GCS (Y-UAV).

The <tt>-plugin</tt> option is another way to use the plugin widget: the X subwindow id is given to the provided command:
<tt>path_to_ground_segment/cockpit/gcs -plugin "mplayer video_stream -wid " -layout appropriate_layout.xml</tt>
<tt>path_to_ground_segment/cockpit/gcs -plugin "cvlc video_stream --drawable-xid=" -layout appropriate_layout.xml</tt>
The <tt>--vout-event=3</tt> option can be used for vlc to disable mouse and keyboard events handling

== Altitude graph widget ==
<center>
[[Image:altgraph.png|400px|The GCS with the altitude graph]]
</center>

An altitude graph can be displayed in the GCS by adding the widget ''altgraph'' in the layout configuration (See the [[GCS_Configuration|GCS configuration]] page). An example is provided in conf/gcs/alt.xml. To use this layout add -layout alt.xml to the /conf/control_panel.xml file. This type of layout is more suited to a multi UAV set up. The Papget ruler is a much less intrusive and better tool when you are only flying a single aircraft.

==Papgets==
Graphical objects can be added to 2D maps: text, rule, gauge, buttons, .... These objects are named ''papgets''. The following snapshot
shows an example with buttons (left side), gauges (lower left corner), text (upper right corner) and ruler (right side). This example
has been produced with a layout file provided in the distribution:

.../gcs -layout papgets.xml

<center>
[[Image:papgets.png|516px|A 2D map augmented with papgets]]
</center>

===Telemetry data report===
The easiest way to create a papget displaying telemetry data is to drag&drop a message field from the Messages window onto the 2D map of the GCS. The default rendering is then a string of text. Clicking on it allows the user to change its type (currently text, ruler or gauge) and some of its attributes (color, size, range for a gauge, format for a text ...). A papget can be moved by simply dragging it.

<center>
[[Image:papget_editor.png|Main characteristics of a papget can be dynamically edited]]
</center>

Papgets can be saved in the layout of the GCS (from the Nav menu). The description is saved in an XML file (in <tt>conf/gcs/</tt> folder) which can be manually edited:

<source lang="xml">
<papget type="message_field" display="gauge" x="47" y="414">
<property name="field" value="BAT:voltage"/>
<property name="scale" value="0.1"/>
<property name="min" value="0."/>
<property name="max" value="15."/>
<property name="size" value="50."/>
<property name="text" value="Bat(V)"/>
</papget>
</source>

The file is used later by giving it to the gcs process:

<pre>
.../gcs -layout my_fancy_papgets.xml
</pre>

===Buttons===
In the same way, user buttons from the strip can be dragged&dropped on the 2D map. However, they currently cannot be directly edited, and
attributes changes have to be done in the XML file. Two types of button are provided to jump to a block or to set a value:
<source lang="xml">
<papget type="goto_block" display="button" x="10" y="300">
<property name="block_name" value="Standby"/>
<property name="icon" value="home.png"/>
</papget>
<papget type="variable_setting" display="button" x="10" y="250">
<property name="variable" value="launch"/>
<property name="value" value="1."/>
<property name="icon" value="launch.png"/>
</papget>
</source>

===Video on Papget===
A video stream can be rendered in a <tt>video_plugin</tt> papget, using the ''mplayer'' player:
<source lang="xml">
<papget type="video_plugin" display="mplayer" x="300" y="250">
<property name="video_feed" value="my video source"/>
<property name="width" VALUE="320"/>
<property name="height" VALUE="240"/>
</papget>
</source>
or any video player which takes in option the X window id, here for example ''VLC'':
<source lang="xml">
<papget type="video_plugin" display="plugin" x="300" y="250">
<property name="command" value="cvlc video_source --drawable-xid="/>
<property NAME="width" VALUE="320"/>
<property NAME="height" VALUE="240"/>
</papget>
</source>

===Papget Development===
Graphical appearence of papgets is defined in <tt>sw/lib/ocaml/papget_renderer.ml</tt>. A renderer must implement the Papget_renderer.t class type interface (<tt>canvas_text</tt> is probably the simpler example) and listed in the <tt>renderers</tt> list to be available
in the edit popup box.

The XML configuration is parsed in <tt>sw/ground_segment/cockpit/papgets.ml</tt>: a new created papget identifier must listed here.

== Alarms ==

The alarm window displays a list of recent errors such as:
* Low battery warning
* Low altitude warning
* Autopilot mode changes (i.e. Manual, Auto2)
* Flight plan block changes

These alarms can be provided via the speaker using the [[speech]] function.

=Related Links=

* [[GettingTheGCSRunningonAGumstixBoard | Getting the GCS running on a Gumstix board]]
* [[RaspberryPi | Getting the GCS running on a Raspberry Pi board]]
* [[PPRZonDroid | PPRZonDroid: a Remote GCS Android application]]

[[Category:Software]] [[Category:GCS]] [[Category:User_Documentation]]