OMSimulatorLib
The OMSimulator project is a FMI-based co-simulation environment that supports ordinary (i.e., non-delayed) and TLM connections.
Connector.h
Go to the documentation of this file.
1 /*
2  * This file is part of OpenModelica.
3  *
4  * Copyright (c) 1998-CurrentYear, Open Source Modelica Consortium (OSMC),
5  * c/o Linköpings universitet, Department of Computer and Information Science,
6  * SE-58183 Linköping, Sweden.
7  *
8  * All rights reserved.
9  *
10  * THIS PROGRAM IS PROVIDED UNDER THE TERMS OF GPL VERSION 3 LICENSE OR
11  * THIS OSMC PUBLIC LICENSE (OSMC-PL) VERSION 1.2.
12  * ANY USE, REPRODUCTION OR DISTRIBUTION OF THIS PROGRAM CONSTITUTES
13  * RECIPIENT'S ACCEPTANCE OF THE OSMC PUBLIC LICENSE OR THE GPL VERSION 3,
14  * ACCORDING TO RECIPIENTS CHOICE.
15  *
16  * The OpenModelica software and the Open Source Modelica
17  * Consortium (OSMC) Public License (OSMC-PL) are obtained
18  * from OSMC, either from the above address,
19  * from the URLs: http://www.ida.liu.se/projects/OpenModelica or
20  * http://www.openmodelica.org, and in the OpenModelica distribution.
21  * GNU version 3 is obtained from: http://www.gnu.org/copyleft/gpl.html.
22  *
23  * This program is distributed WITHOUT ANY WARRANTY; without
24  * even the implied warranty of MERCHANTABILITY or FITNESS
25  * FOR A PARTICULAR PURPOSE, EXCEPT AS EXPRESSLY SET FORTH
26  * IN THE BY RECIPIENT SELECTED SUBSIDIARY LICENSE CONDITIONS OF OSMC-PL.
27  *
28  * See the full OSMC Public License conditions for more details.
29  *
30  */
31 
32 #ifndef _OMS_CONNECTOR_H_
33 #define _OMS_CONNECTOR_H_
34 
35 #include "ComRef.h"
36 #include "ssd/ConnectorGeometry.h"
37 #include "Types.h"
38 
39 #include <string>
40 #include <map>
41 
42 #include <pugixml.hpp>
43 
44 namespace oms
45 {
49  class Connector : protected oms_connector_t
50  {
51  public:
53  Connector(oms_causality_enu_t causality, oms_signal_type_enu_t type, const oms::ComRef& name, const oms::ComRef& owner, double height);
54  ~Connector();
55 
56  // methods to copy the object
57  Connector(const Connector& rhs);
58  Connector& operator=(const Connector& rhs);
59 
60  // you have to free the memory yourself
61  static Connector* NewConnector(const pugi::xml_node& node, const std::string& sspVersion, const oms::ComRef& owner);
62 
63  oms_status_enu_t exportToSSD(pugi::xml_node& root) const;
64  static std::string getTypeString(const pugi::xml_node& node, const std::string& sspVersion);
65  std::string getTypeString() const;
66  std::string getCausalityString() const;
67 
68  operator std::string() const {return std::string(name);}
69 
70  void setName(const oms::ComRef& name);
71  void setOwner(const oms::ComRef& owner);
72  void setGeometry(const oms::ssd::ConnectorGeometry* newGeometry);
73 
74  std::map<std::string, std::map<std::string, std::string>> connectorUnits;
75 
76  const oms_causality_enu_t getCausality() const {return causality;}
77  const oms_signal_type_enu_t getType() const {return type;}
78  const oms::ComRef getOwner() const {return oms::ComRef(owner);}
79  const oms::ComRef getName() const {return oms::ComRef(name);}
80  const oms::ComRef getFullName() const {return getOwner() + getName();}
81  const oms::ssd::ConnectorGeometry* getGeometry() const {return reinterpret_cast<oms::ssd::ConnectorGeometry*>(geometry);}
82  Connector addPrefix(const ComRef& prefix) const;
83 
84  bool isInput() const { return oms_causality_input == causality; }
85  bool isOutput() const { return oms_causality_output == causality; }
86  bool isParameter() const { return oms_causality_parameter == causality; }
88 
89  bool isTypeBoolean() const { return oms_signal_type_boolean == type; }
90  bool isTypeInteger() const { return oms_signal_type_integer == type || oms_signal_type_enum == type; }
91  bool isTypeReal() const { return oms_signal_type_real == type; }
92  bool isTypeString() const { return oms_signal_type_string == type; }
93 
94  private:
95  friend bool operator==(const Connector& v1, const Connector& v2);
96  friend bool operator!=(const Connector& v1, const Connector& v2);
97  };
98 
99  bool operator==(const Connector& v1, const Connector& v2);
100  bool operator!=(const Connector& v1, const Connector& v2);
101 }
102 
103 #endif
ssd_connector_geometry_t * geometry
Geometry information of the connector.
Definition: Types.h:363
std::string getCausalityString() const
Definition: Connector.cpp:337
const oms::ssd::ConnectorGeometry * getGeometry() const
Definition: Connector.h:81
const oms::ComRef getFullName() const
Definition: Connector.h:80
oms_causality_enu_t
Definition: Types.h:61
Connector & operator=(const Connector &rhs)
Definition: Connector.cpp:102
void setOwner(const oms::ComRef &owner)
Definition: Connector.cpp:271
char * owner
Owner of the connector.
Definition: Types.h:361
oms_status_enu_t
Definition: Types.h:43
std::string getTypeString() const
Definition: Connector.cpp:310
const oms_causality_enu_t getCausality() const
Definition: Connector.h:76
friend bool operator==(const Connector &v1, const Connector &v2)
bool isTypeString() const
Definition: Connector.h:92
bool isTypeBoolean() const
Definition: Connector.h:89
~Connector()
Definition: Connector.cpp:81
const oms::ComRef getName() const
Definition: Connector.h:79
char * name
Name of the connector.
Definition: Types.h:362
ComRef - component reference.
Definition: ComRef.h:46
bool isParameter() const
Definition: Connector.h:86
calculated parameter
Definition: Types.h:65
Connector.
Definition: Connector.h:49
bool isInput() const
Definition: Connector.h:84
Definition: Types.h:137
static Connector * NewConnector(const pugi::xml_node &node, const std::string &sspVersion, const oms::ComRef &owner)
Definition: Connector.cpp:124
oms_status_enu_t exportToSSD(pugi::xml_node &root) const
Definition: Connector.cpp:211
Definition: Types.h:138
Connector addPrefix(const ComRef &prefix) const
Definition: Connector.cpp:293
void setGeometry(const oms::ssd::ConnectorGeometry *newGeometry)
Definition: Connector.cpp:281
oms_signal_type_enu_t
Definition: Types.h:135
Definition: Types.h:140
Definition: AlgLoop.h:44
bool isTypeReal() const
Definition: Connector.h:91
friend bool operator!=(const Connector &v1, const Connector &v2)
Signal: input, output, and parameter.
Definition: Types.h:358
Definition: Types.h:139
const oms::ComRef getOwner() const
Definition: Connector.h:78
bool isCalculatedParameter() const
Definition: Connector.h:87
oms_causality_enu_t causality
input/output/parameter
Definition: Types.h:359
bool isTypeInteger() const
Definition: Connector.h:90
void setName(const oms::ComRef &name)
Definition: Connector.cpp:261
output
Definition: Types.h:63
std::map< std::string, std::map< std::string, std::string > > connectorUnits
single entry map which contains unit as key and BaseUnits as value for a connector ...
Definition: Connector.h:74
input
Definition: Types.h:62
Definition: Types.h:136
Definition: ConnectorGeometry.h:45
const oms_signal_type_enu_t getType() const
Definition: Connector.h:77
bool isOutput() const
Definition: Connector.h:85
oms_signal_type_enu_t type
Type of the connector.
Definition: Types.h:360
Connector(oms_causality_enu_t causality, oms_signal_type_enu_t type, const oms::ComRef &name, const oms::ComRef &owner)
Definition: Connector.cpp:40
parameter
Definition: Types.h:64