RulbusInterface.h

/*
 * RulbusInterface.h - abstract class RulbusInterface.
 *
 * This file is part of the Rulbus Device Class Library (RDCL).
 *
 * Copyright (C) 2003-2004, Leiden University.
 *
 * This library 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.
 *
 * The library 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.
 *
 * You should have received a copy of the GNU General Public License
 * along with mngdriver; if not, write to the Free Software
 * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
 *
 * $Id: RulbusInterface.h 2 2004-10-12 11:54:15Z moene $
 */

#ifndef __RULBUSINTERFACE_H
#define __RULBUSINTERFACE_H

#ifndef __COMMON_H
#include "Common.h"
#endif

#include "Singleton.h"
#include "RulbusInterfaceFactory.h"

namespace WindowsUtils
{
   DECLARE_CLASS( Semaphore );
}

namespace Rulbus
{
   DECLARE_CLASS( TheRulbusInterface );

   class TheRulbusInterface : public Singleton<TheRulbusInterface>
   {
      friend class Singleton<TheRulbusInterface>;

   public:                                                      // P U B L I C

     static TheRulbusInterfaceRef instance();


      int          getByte( int rack, int offset           ) const;
      int          putByte( int rack, int offset, int byte ) const;


      virtual bool invariant() const;


      virtual bool printOn  ( std::ostream& stream ) const = 0; 


   protected:                                                   // P R O T E C T E D

      TheRulbusInterface();
     ~TheRulbusInterface();


      virtual int  getReg (int offset          ) const = 0;     
      virtual int  putReg (int offset, int byte) const = 0;     


   private:                                                     // P R I V A T E
      WindowsUtils::SemaphorePtr s;                             

   public:
      static const int ANY_RACK = 0xF;                          
   };

   inline TheRulbusInterfaceRef TheRulbusInterface::instance()
   {
      if ( 0 == theInstance )
      {
         theInstance = RulbusInterfaceFactory::createInterface();
      }

      return *theInstance;
   }

   inline bool TheRulbusInterface::invariant() const
   {
      return true;
   }

}       // namespace Rulbus

#endif  // __RULBUSINTERFACE_H

/*
 * end of file
 */

---