DSMEngine.h

Go to the documentation of this file.

// -*- mode: C++; indent-tabs-mode: nil; c-basic-offset: 4; tab-width: 4; -*-
// vim: set shiftwidth=4 softtabstop=4 expandtab:
/*
 ********************************************************************
 ** NIDAS: NCAR In-situ Data Acquistion Software
 **
 ** 2005, Copyright University Corporation for Atmospheric Research
 **
 ** This program is free software; you can redistribute it and/or modify
 ** it under the terms of the GNU General Public License as published by
 ** the Free Software Foundation; either version 2 of the License, or
 ** (at your option) any later version.
 **
 ** This program is distributed in the hope that it will be useful,
 ** but WITHOUT ANY WARRANTY; without even the implied warranty of
 ** MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 ** GNU General Public License for more details.
 **
 ** The LICENSE.txt file accompanying this software contains
 ** a copy of the GNU General Public License. If it is not found,
 ** write to the Free Software Foundation, Inc.,
 ** 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
 **
 ********************************************************************
*/
 
#ifndef NIDAS_CORE_DSMENGINE_H
#define NIDAS_CORE_DSMENGINE_H
 
#include "ConnectionRequester.h"
#include "XMLException.h"
#include "NidasApp.h"
#include <nidas/util/Inet4SocketAddress.h>
#include <nidas/util/InvalidParameterException.h>
 
#include <set>
 
#include <signal.h>
 
namespace nidas { namespace core {
 
class Project;
class DSMConfig;
class DSMSensor;
class SensorHandler;
class SamplePipeline;
class DSMEngineIntf;
class XMLConfigInput;
class DSMEngineStat;
 
class DSMEngine : public SampleConnectionRequester {
public:
 
    DSMEngine();
 
    ~DSMEngine();
 
    static int main(int argc, char** argv) throw();
 
    static DSMEngine* getInstance() { return _instance; }
 
    void initLogger();
 
    int initProcess();
 
    int run() throw();
 
    int parseRunstring(int argc, char** argv);
 
    void usage();
 
    void start();
 
    void stop();
 
    void restart();
 
    void quit();
 
    void shutdown();
 
    void reboot();
 
    const DSMConfig* getDSMConfig() const { return _dsmConfig; }
 
    const SensorHandler* getSensorHandler() const { return _selector; }
 
    void registerSensorWithXmlRpc(const std::string& devname,DSMSensor*);
 
    enum command { DSM_STOP, DSM_RUN, DSM_QUIT, DSM_RESTART, DSM_REBOOT, DSM_SHUTDOWN };
 
    bool quitCommand(enum command command)
    {
        return command == DSM_QUIT || command == DSM_REBOOT || command == DSM_SHUTDOWN;
    }
 
    enum command getCommand() const { return _command; }
 
private:
 
    static DSMEngine* _instance;
 
    void setupSignals();
 
    void waitForSignal(int secs);
 
    void initialize(xercesc::DOMDocument* projectDoc);
 
    void startXmlRpcThread();
 
    void killXmlRpcThread();
 
    void openSensors();
 
    void connectOutputs();
 
    void connectProcessors();
 
    void disconnectProcessors() throw();
 
    void closeOutputs() throw();
 
    void interrupt();
 
    void deleteDataThreads() throw();
 
    void joinDataThreads() throw();
 
    void connect(SampleOutput*) throw();
 
    void disconnect(SampleOutput*) throw();
 
    void connect(SampleInput*) throw() { assert(false); }
 
    void disconnect(SampleInput*) throw() { assert(false); }
 
    bool _externalControl;
    bool _disableAutoconfig;
    enum run_states { DSM_RUNNING, DSM_ERROR, DSM_STOPPED } _runState;
 
    enum command _command;
 
    bool _syslogit;
 
    std::string _configFile;
 
    nidas::util::Inet4SocketAddress _configSockAddr;
 
    Project*         _project;
 
    DSMConfig*       _dsmConfig;
 
    SensorHandler*  _selector;
 
    SamplePipeline* _pipeline;
 
    DSMEngineStat*    _statusThread;
 
    DSMEngineIntf*   _xmlrpcThread;
 
    std::set<SampleOutput*> _outputSet;
 
    nidas::util::Mutex _outputMutex;
 
    int _logLevel;
 
    sigset_t _signalMask;
 
    pthread_t _myThreadId;
 
    NidasApp _app;
 
    NidasAppArg ExternalControl;
    NidasAppArg DisableAutoConfig;
 
    DSMEngine(const DSMEngine&);
 
    DSMEngine& operator=(const DSMEngine&);
 
};
 
}}  // namespace nidas namespace core
 
#endif