configXMLImpl.h

#ifndef SCTAPI_CONFIGURATIONXMLIMPL
#define SCTAPI_CONFIGURATIONXMLIMPL

#include <utility>
#include <vector>
#include <libxml/tree.h>
#include <libxml/xpath.h>

#include <is/infodictionary.h>
#include <boost/thread.hpp>

#include "log.h"
#include "configuration.h"

#include "timings.h"

class ConfigurationXMLImpl : public SctConfiguration::Configuration {
  ConfigurationXMLImpl(const ConfigurationXMLImpl &);
  ConfigurationXMLImpl &operator=(const ConfigurationXMLImpl &);

  static ConfigurationXMLImpl *m_config;

  xmlDocPtr document;
  xmlXPathContextPtr xpathContext;

  Log log;

  std::string lastFilename;

  ISInfoDictionary *is_dict;
  bool useIS;
  bool useMRS;

  Timings timings;

public:
  ConfigurationXMLImpl();

  virtual ~ConfigurationXMLImpl();

  /************* Get physical configuration ****************/

  std::list<unsigned int> listPartitions();

  std::list<unsigned int> listCratesInPartition(unsigned int partition);

  bool isDummyCrate(unsigned int partition, unsigned int crate);

  std::list<unsigned int> listRodsInCrate(unsigned int partition, unsigned int crate);

  std::list<unsigned int> listMURSInRod(unsigned int partition, unsigned int crate, unsigned int rod);

  std::list<std::string> listModulesInMUR(unsigned int partition, unsigned int MUR);

  std::list<std::string> listRModulesInMUR(unsigned int partition, unsigned int MUR);

  std::list<std::string> listAllModules();

  std::list<std::string> listUnusedModules();

  /************** Get configurations *****************/

  ABCDModule getModuleConfig(const std::string module);

  short getModuleGroup(const std::string module);

  void setModuleGroup(const std::string module, short group);

  unsigned int getModuleErrorMask(unsigned int partition, unsigned int crate, unsigned int rod,
                                  unsigned int channel, unsigned int link);

  void setModuleErrorMask(unsigned int partition, unsigned int crate, unsigned int rod,
                          unsigned int channel, unsigned int link, unsigned int mask);

  void setDefaultModuleErrorMask(unsigned int mask);

  SctConfiguration::RodConfig getRodConfig(unsigned int partition, unsigned int crate, unsigned int rod);

  SctConfiguration::SlaveConfig getDefaultSlaveConfig(char type);

  SctConfiguration::BOCChannelConfig getBOCConfig(unsigned int partition, unsigned int crate, unsigned int rod, 
                                unsigned int channel);

  SctConfiguration::BOCGlobalConfig getBOCGlobalConfig(unsigned int partition, unsigned int crate, unsigned int rod);

  unsigned char *getFibreMappings(unsigned int partition, unsigned int crate, unsigned int rod);

  SctConfiguration::TimConfig getTimConfig(unsigned int partition, unsigned int crate);

  void setFibreMapping(unsigned int partition, unsigned int crate, unsigned int rod, 
                       unsigned int channel, unsigned int tx, unsigned int rx0, unsigned int rx1);

  std::string printModuleConfig(const ABCDModule &conf);

  SctConfiguration::MURType getMURType(unsigned int MUR);

  unsigned int getFreeMurId();

  /************** Change indexing schemes ****************/

  void translateToROD(unsigned int MUR, unsigned int module,
              unsigned int &partition, unsigned int &crate, 
              unsigned int &rod, unsigned int &channel);
 
  void translateToRROD(unsigned int MUR, unsigned int module,
               unsigned int &partition, unsigned int &crate, 
               unsigned int &rod, unsigned int &channel);
 
  void translateToSN(unsigned int MUR, unsigned int module,
                     std::string &sn);

  void translateToRMUR(unsigned int MUR, unsigned int module,
                       unsigned int &RMUR, unsigned int &rmodule);

  void translateToBarrel(unsigned int MUR, unsigned int module,
                         unsigned int &barrel, unsigned int &row, int &number);

  void translateToEndcap(unsigned int MUR, unsigned int module,
                         int &disk, unsigned int &ring, unsigned int &number);

  void translateToPowerSupply(unsigned int MUR, unsigned int module,
                              unsigned int &partition, 
                              unsigned int &crate, unsigned int &channel);

  void translateFromROD(unsigned int partition, unsigned int crate, 
                        unsigned int rod, unsigned int channel,
                        unsigned int &MUR, unsigned int &module);

  void translateFromRROD(unsigned int partition, unsigned int crate,
                         unsigned int rod, unsigned int channel,
                         unsigned int &MUR, unsigned int &module);
  void translateFromSN(const std::string sn,
                       unsigned int &MUR, unsigned int &module);

  void translateFromRMUR(unsigned int RMUR, unsigned int rmodule,
                         unsigned int &MUR, unsigned int &module);

  void translateFromBarrel(unsigned int barrel, unsigned int row, int number,
                           unsigned int &MUR, unsigned int &module);

  void translateFromEndcap(int disk, unsigned int ring, unsigned int number,
                           unsigned int &MUR, unsigned int &module);

  void translateFromPowerSupply(unsigned int partition, 
                                unsigned int crate, unsigned int channel, 
                                unsigned int &MUR, unsigned int &module);


  /************** Change configuration ******************/

  void configureModuleFromStructure(const std::string module, const ABCDModule conf);

  void configureModuleFromFile(const std::string filename);

  void configureROD(unsigned int partition, unsigned int crate, unsigned int rod, SctConfiguration::RodConfig conf);

  void configureTIM(unsigned int partition, unsigned int crate, SctConfiguration::TimConfig conf);

  void configureBOC(unsigned int partition, unsigned int crate, unsigned int rod, const SctConfiguration::BOCGlobalConfig &conf);

  void clearAll();

  void namePartition(unsigned int partition, const std::string name);

 public:
/*   void setBOCConfig(int partition, int crate, int rod, int channel, const BOCChannelConfig &conf); */
  
  void configureBOCChannel(unsigned int MUR, unsigned int position, const SctConfiguration::BOCChannelConfig &conf);

  void mapModuleMUR(unsigned int MUR, unsigned int order, unsigned int RMUR, unsigned int rorder, std::string number);

  void unmapModuleMUR(unsigned int MUR, unsigned int order);

  void mapRODMUR(unsigned int partition, unsigned int crate, unsigned int rod, unsigned int order, unsigned int number);

  void unmapRODMUR(unsigned int number);

  void mapBarrelMUR(unsigned int MUR, unsigned int barrel, unsigned int row, int position);

  void unmapBarrelMUR(unsigned int MUR);

  void getMapMURROD(unsigned int MUR, unsigned int &partition, unsigned int &crate, unsigned int &rod, unsigned int &order);

  void getMapRODMUR(unsigned int partition, unsigned int crate, unsigned int rod, unsigned int order, unsigned int &MUR);

  /*
    Get mapping of MUR to physical structure
  */
  void getMapMURPhysical(unsigned int MUR, SctConfiguration::MURType &type, int &plane, int &section, int &position);

  void mapEndcapMUR(unsigned int MUR, int disk, unsigned int quadrant, unsigned int position);
 
  void unmapEndcapMUR(unsigned int MUR);

  void swapMURNames(unsigned int MUR1, unsigned int MUR2);

  void mapPowerChannel(unsigned int MUR, unsigned int number, unsigned int partition, unsigned int crate, unsigned int channel);

  void unmapPowerChannel(unsigned int MUR, unsigned int number);

  void modifyDefaultPowerParam(std::string state, std::string name, std::string type, float value);

  void modifyHVCardParam(unsigned int crate, unsigned int card,
                         std::string name, std::string type, float value);

  void modifyLVCardParam(unsigned int crate, unsigned int card,
                         std::string name, std::string type, float value);

  void modifyPowerParam(unsigned int MUR, unsigned int number,
                         std::string state, std::string name, std::string type, float value);

  void modifyPowerParamCC(unsigned int crate, unsigned int channel,
          std::string state, std::string name, std::string type, float value);

  float getDefaultPowerParam(std::string state, std::string name, std::string type);

  float getHVCardParam(unsigned int crate, unsigned int card, std::string name, std::string type);

  float getLVCardParam(unsigned int crate, unsigned int card, std::string name, std::string type);

  float getPowerParam(unsigned int MUR, unsigned int number, std::string state, std::string name, std::string type);

  float getPowerParamCC(unsigned int crate, unsigned int channel, std::string state, std::string name, std::string type);

  std::list<std::string> listDefaultPowerParams();

  float getCratePowerParam(unsigned int crate, std::string name);

  std::list<std::string> listDCSChannelParams();

  std::list<std::string> listDCSCardParams();

  std::list<std::string> listDCSCrateParams();

  void useISForChanges(bool valid = true);

  void useMRSForMessages(bool valid = true);

  void loadConfiguration(const std::string &filename);

  std::string getConfigurationFileName();

  /************** Save configuration *********************/

  void saveConfiguration(const std::string filename = "");

  void saveModuleConfiguration(const std::string modsn, const std::string filename);

  std::string getModuleConfigurationString(const std::string modsn, const ABCDModule config);

  void writePowerSupplyConfiguration(std::string filename);

 protected:
  void createPartition(unsigned int partition);

  void createCrate(unsigned int partition, unsigned int crate);

  void createROD(unsigned int partition, unsigned int crate, unsigned int rod);

  xmlNodePtr getModuleConfigurationNode(std::string sn, std::string reason);

  void notifyModuleConfChange();

  void notifyModuleMappingChange();

  void notifySystemStructureChange();

 private:
  ISInfoDictionary *getIsDict();

  void updateRodConfig(unsigned int partition, unsigned int crate, unsigned int rod, SctConfiguration::RodConfig conf);

  xmlNodePtr getQueryNode(const std::string query, const std::string task);

  std::list<xmlNodePtr> getQueryNodeList(const std::string query, const std::string task);

  float getAttrAsFloat(xmlNodePtr node, const char *attr);

  int getAttrAsInt(xmlNodePtr node, const char *attr, int base = 0);

  std::string getAttrAsString(xmlNodePtr node, const char *attr);

  xmlNodePtr getChildNode(xmlNodePtr node, const char *name);

  xmlNodePtr getOrNewChildNode(xmlNodePtr node, const char *name);

  void setOrCreateChildNodeWithContent(xmlNodePtr node, const char *name, const char *content);

  xmlNodePtr getChildNodeWithContent(xmlNodePtr node, const char *name, const char *content);

  xmlNodePtr getOrNewChildWithIntAttr(xmlNodePtr, const char *name, const char *attr, int integer);

  xmlNodePtr getOrNewChildWithStringAttr(xmlNodePtr parent, const char *name, const char *attr, std::string value);

  xmlNodePtr getNodeWithIntAttr(xmlNodePtr node, const char *name, const char *attr, int integer);

  xmlNodePtr getNodeWithStringAttr(xmlNodePtr node, const char *name, const char *attr, std::string value);

  void setFloatAttr(xmlNodePtr node, const char *attr, float floater);

  void setIntAttr(xmlNodePtr node, const char *attr, int integer);

  void clearAttr(xmlNodePtr node, const char *attr);

  const ABCDModule parseModuleConfig(xmlNodePtr node);

  const SctConfiguration::RodConfig parseRodConfig(xmlNodePtr node);

  const SctConfiguration::TimConfig parseTimConfig(xmlNodePtr node);

  xmlNodePtr replaceModuleConfig(xmlNodePtr node, const ABCDModule conf, const std::string name);

 protected:
  void checkInitialised();
  boost::mutex initialise_mutex;

  std::map<std::string, xmlNodePtr> serialToMurNode;
  bool serialToMurNodeBuilt;

  void buildSerialToMurNode();

  std::map<std::string, xmlNodePtr> serialToConfigNode;
  bool serialToConfigNodeBuilt;

  void buildSerialToConfigNode();
};

#endif

---