ConfigParser.h

/*
 * ConfigParser.h - parser for Rulbus configuration file.
 *
 * 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: ConfigParser.h 2 2004-10-12 11:54:15Z moene $
 */

#ifndef __CONFIGPARSER_H
#define __CONFIGPARSER_H

#include <vector>                       // for CardList

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

#include "ConfigScanner.h"              // header

namespace Rulbus
{
   DECLARE_CLASS( ConfigParser  );      
   DECLARE_CLASS( ConfigScanner );      
   DECLARE_CLASS( ConfigBuilder );      
   DECLARE_CLASS( ConfigContext );      
   DECLARE_CLASS( RulbusDevice  );      

   class ConfigParser
   {
   public:
      ConfigParser( ConfigScanner& scanner, ConfigBuilder& builder, ConfigContext& context );

      void parse();

   protected:
      void parseProgram();

      void parseFileAssignment();

      void parseRackDeclarationSequence();
      void parseRackDeclaration();
      void parseRackInitializer();

      void parseRackAddressAssignment();
      void parseCardDeclarationSequence();
      void parseCardDeclaration();
      void parseCardInitializer( ConfigToken::TokenCode card );
//      void parseRB8506 ();    // generic
      void parseRB8509 ( bool scanProperties = true );
      void parseRB8510 ( bool scanProperties = true );
      void parseRB8514 ( bool scanProperties = true );
//      void parseRB8515 ();    // generic
      void parseRB8905 ( bool scanProperties = true );
//      void parseRB9005 ( bool scanProperties = true );

      void parseGenericCard( ConfigToken::TokenCode card, bool scanProperties = true );

      Int  parseAddress        ( ConfigToken::TokenCode token = ConfigToken::tcCARD );
      bool parseHasExtTrigger  ( );
      Int  parseNumChannels    ( );
      bool parseBipolar        ( );
      Real parseVoltPerBit     ( );
      Real parseIntrDelay      ( );

      bool parseBooleanProperty( ConfigToken::TokenCode token );
      Int  parseIntegerProperty( ConfigToken::TokenCode token );
      Real parseRealProperty   ( ConfigToken::TokenCode token );
      Real parseOptUnit        ( ConfigToken::TokenCode token );

      void parseOptDelimiter   ( );
      void parseOptAssignOp    ( );

      void checkRackAllowed      ( );
      void checkDuplicateRackName( );
      void checkDuplicateCardName( );
      void checkRackDeclaration  ( );
      void checkCardDeclarations ( );
      void checkDuplicateRackAddr( bool withline = false );
      void checkOverlapCardAddr  ( bool withline = false );

      void addCard( RulbusDevicePtr card );
      void clearRackCardList    ( );
      void updateRackCardList   ( );

      void getToken( );
      bool test    ( ConfigToken::TokenCode token, bool require = true );
      void expect  ( ConfigToken::TokenCode token, bool require = true );

      class ParseError : public std::logic_error
      {
      public:
         ParseError( StringCref msg ) : std::logic_error( to_cstr( msg ) )
         {
            ; //do nothing
         }
      };

   private:
      typedef std::vector<RulbusDevicePtr> CardList;    
      typedef std::vector<String>          NameList;    
      typedef std::vector<bool>            AddrList;    
      typedef std::vector<int>             LineList;    

      ConfigToken::TokenCode t;                 

      ConfigScanner *theScanner;                
      ConfigBuilder& theBuilder;                
      ConfigContext& theContext;                
      ConfigToken   *theToken;                  

      String         theRackName;               
      Int            theRackAddress;            
      Int            theRackLine;               

      String         theCardName;               
      Int            theCardAddress;            

      CardList       theCardList;               
      NameList       theCardNameList;           
      LineList       theCardLineList;           

      CardList       theRackCardList;           
      AddrList       theRackAddrSet;            
      NameList       theRackNameSet;            
      LineList       theRackLineSet;            

   private:
      static const int DEF_CARDS = 32;          
      static const int LIM_RACKS = 16;          
      
      static CharCptr already_assigned;         
   };

} // namespace Rulbus

#endif  // __CONFIGPARSER_H

/*
 * end of file
 */

---