Contents

  1. Overview
  2. Usage
  3. Nodes
    1. groundstation
      1. Subscribed Topics
      2. Parameters
    2. telemetry_demo
      1. Subscribed Topics
      2. Parameters
  4. Bug Reports & Feature Requests

Overview

ground_station is a GUI based on GTK+ allowing to display/update data provided by some ROS topics. Given that the CityFlyer platform is a quadrotor (i.e. Pelican built by Ascending Technologies GmbH - http://www.asctec.de) we have developed several GTK+ widgets capable of display telemetry data. These widgets are made to look like to real flight instruments in order to allow easy feedbacks for the user/pilot.

For more details about these widgets and how to use them, check out the doxygen documentation available in the Code API section.

Usage

The ground station GUI can be started by running: 

   1 roslaunch ground_station ground_station.launch

The telemetry demo can be started by running: 

   1 roslaunch ground_station telemetry.launch

Nodes

groundstation

The is the first version of the CityFlyer ground station. In this version, the GUI is devided into 3 tabs. The first one showing the telemtry widgets needed. The second tab is quite the same as gpsd_viewer. And the third tab provide an easy way to record bags.ground_station_telemetry.pngground_station_gps.pngground_station_rec.png

Subscribed Topics

/asctec/GPS_DATA (asctec_msgs/GPSData)
  • Basic GPS Data
/asctec/IMU_CALCDATA (asctec_msgs/IMUCalcData)
  • Fused IMU Data, in asctec format
/asctec/LL_STATUS (asctec_msgs/LLStatus)
  • Low Level Status including battery voltage
/mav/imu (sensor_msgs/IMU)
  • IMU data
/mav/pressure_height_filtered (mav_msgs/Height)
  • The height reported by the pressure sensor
/fix (gps_common/GPSFix)

Parameters

window_grayscale_color (bool, default: false)
  • Puts all widgets in grayscale color mode (e.g. outdoor use).
window_radial_color (bool, default: true)
  • Enable/Disable radial color layer on widgets; increases drawing performance.
altimeter_unit_is_feet (bool, default: true)
  • Sets the altimeter in meter or feet.
altimeter_step_value (int, default: 100)
  • Define the step of the altimeter (e.g. 1,10 or 100 feet/meter).
variometer_step_value (int, default: 100)
  • Define the step of the variometer (e.g. 1,10 or 100 feet/meter).
bg_widget_name (string)
  • Indicates the name of the bar gauge widget.
bg_bar_number (int, default: 1)
  • Number of bag gauge you want in the widget.
bg_name_bar_gauge1 (string)
  • Indicates the name of bar 1.
bg_unit_bar_gauge1 (string)
  • Indicates the unit of bar 1.
bg_start_value_bar_1 (int, default: 0)
  • Indicates the start value of bar 1.
bg_end_value_bar_1 (int, default: 100)
  • Indicates the end value of bar 1.
bg_name_bar_gauge2 (string)
  • Indicates the name of bar 2.
bg_unit_bar_gauge2 (string)
  • Indicates the unit of bar 2.
bg_start_value_bar_2 (int, default: 0)
  • Indicates the start value of bar 2.
bg_end_value_bar_2 (int, default: 100)
  • Indicates the end value of bar 2.
bg_name_bar_gauge3 (string)
  • Indicates the name of bar 3.
bg_unit_bar_gauge3 (string)
  • Indicates the unit of bar 3.
bg_start_value_bar_3 (int, default: 0)
  • Indicates the start value of bar 3.
bg_end_value_bar_3 (int, default: 100)
  • Indicates the end value of bar 3.
bg_name_bar_gauge4 (string)
  • Indicates the name of bar 4.
bg_unit_bar_gauge4 (string)
  • Indicates the unit of bar 4.
bg_start_value_bar_4 (int, default: 0)
  • Indicates the start value of bar 4.
bg_end_value_bar_4 (int, default: 100)
  • Indicates the end value of bar 4.

telemetry_demo

This node show all the telemetry widgets in a simple GTK window and suscribe to an altitude message. It was only made for widgets demonstration. The widgets available are: altimeter, variometer, compass, gauge, bar gauges, artificial horizon and turn coordinator. telemetry_widgets.png

Subscribed Topics

/fake_alti (geometry_msgs/Pose)
  • Suscribes to this topic for a testing purpose, altitude only (pose.z).

Parameters

window_grayscale_color (bool, default: false)
  • Puts all widgets in grayscale color mode (e.g. outdoor use).
window_radial_color (bool, default: true)
  • Enable/Disable radial color layer on widgets; increases drawing performance.
altimeter_unit_is_feet (bool, default: true)
  • Sets the altimeter in meter or feet.
altimeter_step_value (int, default: 100)
  • Define the step of the altimeter (e.g. 1,10 or 100 feet/meter).
variometer_step_value (int, default: 100)
  • Define the step of the variometer (e.g. 1,10 or 100 feet/meter).
gauge1_name (string)
  • Provide the name of gauge 1 (support pango text attribute).
gauge1_unit (string)
  • Provide the unit of gauge 1 (support pango text attribute).
gauge1_start_value (int, default: 0)
  • Indicates the start value of the gauge 1.
gauge1_end_value (string, default: 100)
  • Indicates the end value of the gauge 1.
gauge1_initial_step (int, default: 10)
  • Fisrt step, divides the gauge 1 range into steps.
gauge1_sub_step (string, default: 1)
  • Sub step, divides the gauge 1 range into steps.
gauge1_drawing_step (int, default: 10)
  • Indicates the step where numbers will be drawn for gauge 1.
gauge1_color_strip_order (string, default: "YOR")
  • Allows to change the color strip order in gauge 1. By default it's YOR (Yellow Orange Red) - possible: GYR,RYG,ROY.
gauge1_green_strip_start (int)
  • Indicates the start of the green strip for gauge 1.
gauge1_yellow_strip_start (int)
  • Indicates the start of the yellow strip for gauge 1.
gauge1_red_strip_start (int)
  • Indicates the start of the red strip for gauge 1.
gauge1_green_strip_start (int)
  • Indicates the start of the green strip for gauge 1.
gauge2_name (string)
  • Provide the name of gauge 2 (support pango text attribute).
gauge2_unit (string)
  • Provide the unit of gauge 2 (support pango text attribute).
gauge2_start_value (int, default: 0)
  • Indicates the start value of the gauge 2.
gauge2_end_value (string, default: 100)
  • Indicates the end value of the gauge 2.
gauge2_initial_step (int, default: 10)
  • Fisrt step, divides the gauge 2 range into steps.
gauge2_sub_step (string, default: 1)
  • Sub step, divides the gauge 2 range into steps.
gauge2_drawing_step (int, default: 10)
  • Indicates the step where numbers will be drawn for gauge 2.
gauge2_color_strip_order (string, default: "YOR")
  • Allows to change the color strip order in gauge 2. By default it's YOR (Yellow Orange Red) - possible: GYR,RYG,ROY.
gauge2_green_strip_start (int)
  • Indicates the start of the green strip for gauge 2.
gauge2_yellow_strip_start (int)
  • Indicates the start of the yellow strip for gauge 2.
gauge2_red_strip_start (int)
  • Indicates the start of the red strip for gauge 2.
gauge2_green_strip_start (int)
  • Indicates the start of the green strip for gauge 2.
bg_widget_name (string)
  • Indicates the name of the bar gauge widget.
bg_bar_number (int, default: 1)
  • Number of bag gauge you want in the widget.
bg_name_bar_gauge1 (string)
  • Indicates the name of bar 1.
bg_unit_bar_gauge1 (string)
  • Indicates the unit of bar 1.
bg_start_value_bar_1 (int, default: 0)
  • Indicates the start value of bar 1.
bg_end_value_bar_1 (int, default: 100)
  • Indicates the end value of bar 1.
bg_name_bar_gauge2 (string)
  • Indicates the name of bar 2.
bg_unit_bar_gauge2 (string)
  • Indicates the unit of bar 2.
bg_start_value_bar_2 (int, default: 0)
  • Indicates the start value of bar 2.
bg_end_value_bar_2 (int, default: 100)
  • Indicates the end value of bar 2.
bg_name_bar_gauge3 (string)
  • Indicates the name of bar 3.
bg_unit_bar_gauge3 (string)
  • Indicates the unit of bar 3.
bg_start_value_bar_3 (int, default: 0)
  • Indicates the start value of bar 3.
bg_end_value_bar_3 (int, default: 100)
  • Indicates the end value of bar 3.
bg_name_bar_gauge4 (string)
  • Indicates the name of bar 4.
bg_unit_bar_gauge4 (string)
  • Indicates the unit of bar 4.
bg_start_value_bar_4 (int, default: 0)
  • Indicates the start value of bar 4.
bg_end_value_bar_4 (int, default: 100)
  • Indicates the end value of bar 4.

Bug Reports & Feature Requests

We appreciate the time and effort spent submitting bug reports.

Please use our Trac to report bugs or request features.

Wiki: ground_station (last edited 2011-06-17 15:39:41 by IvanDryanovski)

Except where otherwise noted, the ROS wiki is licensed under the
Creative Commons Attribution 3.0