instrument_mgr.cxx

Go to the documentation of this file.

// instrument_mgr.cxx - manage aircraft instruments.
// Written by David Megginson, started 2002.
//
// This file is in the Public Domain and comes with no warranty.
 
#include <config.h>
 
#include <iostream>
#include <string>
#include <sstream>
 
#include <simgear/structure/exception.hxx>
#include <simgear/misc/sg_path.hxx>
#include <simgear/sg_inlines.h>
#include <simgear/props/props_io.hxx>
#include <simgear/debug/ErrorReportingCallback.hxx>
 
#include <Main/fg_props.hxx>
#include <Main/globals.hxx>
#include <Main/util.hxx>
 
#include "instrument_mgr.hxx"
#include "adf.hxx"
#include "airspeed_indicator.hxx"
#include "altimeter.hxx"
#include "attitude_indicator.hxx"
#include "attitude_indicator_electric.hxx"
#include "clock.hxx"
#include "dme.hxx"
#include "gps.hxx"
#include "gsdi.hxx"
#include "heading_indicator.hxx"
#include "heading_indicator_fg.hxx"
#include "heading_indicator_dg.hxx"
#include "kr_87.hxx"
#include "mag_compass.hxx"
#include "marker_beacon.hxx"
#include "newnavradio.hxx"
#include "commradio.hxx"
#include "slip_skid_ball.hxx"
#include "transponder.hxx"
#include "turn_indicator.hxx"
#include "vertical_speed_indicator.hxx"
#include "inst_vertical_speed_indicator.hxx"
#include "tacan.hxx"
#include "mk_viii.hxx"
#include "mrg.hxx"
#include "rad_alt.hxx"
#include "tcas.hxx"
 
FGInstrumentMgr::FGInstrumentMgr () :
  _explicitGps(false)
{    
}
 
FGInstrumentMgr::~FGInstrumentMgr ()
{
}
 
SGSubsystem::InitStatus FGInstrumentMgr::incrementalInit()
{
  init();
  return INIT_DONE;
}
 
void FGInstrumentMgr::init()
{
    simgear::ErrorReportContext ec("primary-aircraft", "yes");
 
    SGPropertyNode_ptr config_props = new SGPropertyNode;
    SGPropertyNode* path_n = fgGetNode("/sim/instrumentation/path");
    if (!path_n) {
        SG_LOG(SG_COCKPIT, SG_DEV_WARN, "No instrumentation model specified for this model!");
        return;
    }
 
  SGPath config = globals->resolve_aircraft_path(path_n->getStringValue());
  if (!config.exists()) {
      simgear::reportFailure(simgear::LoadFailure::NotFound, simgear::ErrorCode::AircraftSystems,
                             "FGInstrumentMgr: Missing instrumentation file", config);
      return;
  }
 
  SG_LOG( SG_COCKPIT, SG_INFO, "Reading instruments from " << config );
 
  try {
    readProperties( config, config_props );
    if (!build(config_props, config)) {
      throw sg_exception(
                    "Detected an internal inconsistency in the instrumentation\n"
                    "system specification file.  See earlier errors for details.");
    }
  } catch (const sg_exception& e) {
      simgear::reportFailure(simgear::LoadFailure::BadData, simgear::ErrorCode::AircraftSystems,
                             "Failed to load instrumentation system:" + e.getFormattedMessage(),
                             e.getLocation());
  }
 
 
  if (!_explicitGps) {
    SG_LOG(SG_INSTR, SG_INFO, "creating default GPS instrument");
    SGPropertyNode_ptr nd(new SGPropertyNode);
    nd->setStringValue("name", "gps");
    nd->setIntValue("number", 0);
    _instruments.push_back("gps[0]");
    set_subsystem("gps[0]", new GPS(nd, true /* default GPS mode */));
  }
 
  SGSubsystemGroup::init();
}
 
bool FGInstrumentMgr::build (SGPropertyNode* config_props, const SGPath& path)
{
    for ( int i = 0; i < config_props->nChildren(); ++i ) {
        SGPropertyNode *node = config_props->getChild(i);
        std::string name = node->getNameString();
 
        std::ostringstream subsystemname;
        subsystemname << "instrument-" << i << '-'
                << node->getStringValue("name", name.c_str());
        int index = node->getIntValue("number", 0);
        if (index > 0)
            subsystemname << '['<< index << ']';
        std::string id = subsystemname.str();
      
        if ( name == "adf" ) {
            set_subsystem( id, new ADF( node ), 0.15 );
 
        } else if ( name == "airspeed-indicator" ) {
            set_subsystem( id, new AirspeedIndicator( node ) );
 
        } else if ( name == "altimeter" ) {
            set_subsystem( id, new Altimeter( node, "altimeter" ) );
 
        } else if ( name == "attitude-indicator" ) {
            set_subsystem( id, new AttitudeIndicator( node ) );
 
        } else if ( name == "attitude-indicator-electric" ) {
            set_subsystem( id, new AttitudeIndicatorElectric( node ) );
 
        } else if ( name == "clock" ) {
            set_subsystem( id, new Clock( node ), 0.25 );
 
        } else if ( name == "dme" ) {
            set_subsystem( id, new DME( node ), 1.0 );
 
        } else if ( name == "encoder" ) {
            set_subsystem( id, new Altimeter( node, "encoder" ), 0.15 );
 
        } else if ( name == "gps" ) {
            // post 2.12.0, add a new name (distinct from 'gps'), so
            // it is possible to create non-default GPS instruments.
            // then authors of realistic GPS and FMSs can transition to using
            // that name as they choose.
            set_subsystem( id, new GPS( node, true /* default GPS mode */ ) );
            _explicitGps = true;
        } else if ( name == "gsdi" ) {
            set_subsystem( id, new GSDI( node ) );
 
        } else if ( name == "heading-indicator" ) {
            set_subsystem( id, new HeadingIndicator( node ) );
 
        } else if ( name == "heading-indicator-fg" ) {
            set_subsystem( id, new HeadingIndicatorFG( node ) );
 
        } else if ( name == "heading-indicator-dg" ) {
            set_subsystem( id, new HeadingIndicatorDG( node ) );
 
        } else if ( name == "KR-87" ) {
            set_subsystem( id, new FGKR_87( node ) );
 
        } else if ( name == "magnetic-compass" ) {
            set_subsystem( id, new MagCompass( node ) );
 
        } else if ( name == "marker-beacon" ) {
            set_subsystem(id, new FGMarkerBeacon(node));
 
        } else if ( name == "comm-radio" ) {
            set_subsystem( id, Instrumentation::CommRadio::createInstance( node ) );
 
        } else if ( name == "nav-radio" ) {
            set_subsystem( id, Instrumentation::NavRadio::createInstance( node ) );
 
        } else if ( name == "slip-skid-ball" ) {
            set_subsystem( id, new SlipSkidBall( node ), 0.03 );
 
        } else if (( name == "transponder" ) || ( name == "KT-70" )) {
            if  (name == "KT-70") {
                SG_LOG(SG_INSTR, SG_DEV_ALERT, "KT-70 legacy instrument compatibility. "
                                               "Please update aircraft to use transponder directly");
                // force configuration into compatibility mode
                node->setBoolValue("kt70-compatibility", true);
            }
            set_subsystem( id, new Transponder( node ), 0.2 );
 
        } else if ( name == "turn-indicator" ) {
            set_subsystem( id, new TurnIndicator( node ) );
 
        } else if ( name == "vertical-speed-indicator" ) {
            set_subsystem( id, new VerticalSpeedIndicator( node ) );
 
        } else if ( name == "inst-vertical-speed-indicator" ) {
            set_subsystem( id, new InstVerticalSpeedIndicator( node ) );
 
        } else if ( name == "tacan" ) {
            set_subsystem( id, new TACAN( node ), 0.2 );
 
        } else if ( name == "mk-viii" ) {
            set_subsystem( id, new MK_VIII( node ), 0.2);
 
        } else if ( name == "master-reference-gyro" ) {
            set_subsystem( id, new MasterReferenceGyro( node ) );
 
        } else if (( name == "groundradar" ) ||
                   ( name == "radar" ) ||
                   ( name == "air-ground-radar" ) ||
                   ( name == "navigation-display" ))
        {
        // these instruments are handled by the CockpitDisplayManager
        // catch them here so we can still warn about bogus names in
        // the instruments file
          continue;
        } else if ( name == "radar-altimeter" ) {
            set_subsystem( id, new RadarAltimeter( node ) );
 
        } else if ( name == "tcas" ) {
            set_subsystem( id, new TCAS( node ), 0.2);
            
        } else {
            simgear::reportFailure(simgear::LoadFailure::Misconfigured, simgear::ErrorCode::AircraftSystems,
                                   "Unknown top level section in instrumentation:" + name,
                                   path);
            continue;
        }
      
      // only push to our array if we actually built an insturment
        _instruments.push_back(id);
    } // of instruments iteration
    return true;
}
 
 
// Register the subsystem.
SGSubsystemMgr::Registrant<FGInstrumentMgr> registrantFGInstrumentMgr(
    SGSubsystemMgr::FDM);
 
// end of instrument_manager.cxx