src/Radio/radio.hxx

   1 // radio.hxx -- FGRadio: class to manage radio propagation
   2 //
   3 // Written by Adrian Musceac, started August 2011.
   4 //
   5 // This program is free software; you can redistribute it and/or
   6 // modify it under the terms of the GNU General Public License as
   7 // published by the Free Software Foundation; either version 2 of the
   8 // License, or (at your option) any later version.
   9 //
  10 // This program is distributed in the hope that it will be useful, but
  11 // WITHOUT ANY WARRANTY; without even the implied warranty of
  12 // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  13 // General Public License for more details.
  14 //
  15 // You should have received a copy of the GNU General Public License
  16 // along with this program; if not, write to the Free Software
  17 // Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301, USA.
  18
  19
  20 #ifndef __cplusplus
  21 # error This library requires C++
  22 #endif
  23
  24 #include <simgear/compiler.h>
  25 #include <simgear/structure/subsystem_mgr.hxx>
  26 #include <deque>
  27 #include <Main/fg_props.hxx>
  28
  29 #include <simgear/math/sg_geodesy.hxx>
  30 #include <simgear/debug/logstream.hxx>
  31
  32
  33 using std::string;
  34
  35
  36 class FGRadioTransmission
  37 {
  38 private:
  39         bool isOperable() const
  40                 { return _operable; }
  41         bool _operable; ///< is the unit serviceable, on, powered, etc
  42
  43         double _receiver_sensitivity;
  44         double _transmitter_power;
  45         double _tx_antenna_height;
  46         double _rx_antenna_height;
  47         double _antenna_gain;
  48         std::map<string, double[2]> _mat_database;
  49
  50         int _propagation_model; /// 0 none, 1 round Earth, 2 ITM
  51         double ITM_calculate_attenuation(SGGeod tx_pos, double freq, int ground_to_air);
  52         double LOS_calculate_attenuation(SGGeod tx_pos, double freq, int ground_to_air);
  53         void clutterLoss(double freq, double distance_m, double itm_elev[], std::deque<string> materials,
  54                         double transmitter_height, double receiver_height, int p_mode,
  55                         double horizons[], double &clutter_loss);
  56         void get_material_properties(string mat_name, double &height, double &density);
  57
  58 public:
  59
  60     FGRadioTransmission();
  61     ~FGRadioTransmission();
  62
  63
  64     void setFrequency(double freq, int radio);
  65     double getFrequency(int radio);
  66     void setTxPower(double txpower) { _transmitter_power = txpower; };
  67     void setRxSensitivity(double sensitivity) { _receiver_sensitivity = sensitivity; };
  68     void setTxAntennaHeight(double tx_antenna_height) { _tx_antenna_height = tx_antenna_height; };
  69     void setRxAntennaHeight(double rx_antenna_height) { _rx_antenna_height = rx_antenna_height; };
  70     void setPropagationModel(int model) { _propagation_model = model; };
  71     // transmission_type: 0 for air to ground 1 for ground to air, 2 for air to air, 3 for pilot to ground, 4 for pilot to air
  72     void receiveATC(SGGeod tx_pos, double freq, string text, int transmission_type);
  73     void receiveChat(SGGeod tx_pos, double freq, string text, int transmission_type);
  74     // returns signal quality
  75     // transmission_type: 0 for VOR, 1 for ILS
  76     double receiveNav(SGGeod tx_pos, double freq, int transmission_type);
  77
  78 };
  79
  80