OpenZWave Library  1.5.0
Value.h
Go to the documentation of this file.
1 //-----------------------------------------------------------------------------
2 //
3 // Value.h
4 //
5 // Base class for all OpenZWave Value Classes
6 //
7 // Copyright (c) 2010 Mal Lansell <openzwave@lansell.org>
8 //
9 // SOFTWARE NOTICE AND LICENSE
10 //
11 // This file is part of OpenZWave.
12 //
13 // OpenZWave is free software: you can redistribute it and/or modify
14 // it under the terms of the GNU Lesser General Public License as published
15 // by the Free Software Foundation, either version 3 of the License,
16 // or (at your option) any later version.
17 //
18 // OpenZWave is distributed in the hope that it will be useful,
19 // but WITHOUT ANY WARRANTY; without even the implied warranty of
20 // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
21 // GNU Lesser General Public License for more details.
22 //
23 // You should have received a copy of the GNU Lesser General Public License
24 // along with OpenZWave. If not, see <http://www.gnu.org/licenses/>.
25 //
26 //-----------------------------------------------------------------------------
27 
28 #ifndef _Value_H
29 #define _Value_H
30 
31 #include <string>
32 #ifdef __FreeBSD__
33 #include <time.h>
34 #endif
35 #include "Defs.h"
36 #include "platform/Ref.h"
37 #include "value_classes/ValueID.h"
38 
39 class TiXmlElement;
40 
41 namespace OpenZWave
42 {
43  class Node;
44 
48  class Value: public Ref
49  {
50  friend class Driver;
51  friend class ValueStore;
52 
53  public:
54  Value( uint32 const _homeId, uint8 const _nodeId, ValueID::ValueGenre const _genre, uint8 const _commandClassId, uint8 const _instance, uint16 const _index, ValueID::ValueType const _type, string const& _label, string const& _units, bool const _readOnly, bool const _writeOnly, bool const _isset, uint8 const _pollIntensity );
55  Value();
56 
57  virtual void ReadXML( uint32 const _homeId, uint8 const _nodeId, uint8 const _commandClassId, TiXmlElement const* _valueElement );
58  virtual void WriteXML( TiXmlElement* _valueElement );
59 
60  ValueID const& GetID()const{ return m_id; }
61  bool IsReadOnly()const{ return m_readOnly; }
62  bool IsWriteOnly()const{ return m_writeOnly; }
63  bool IsSet()const{ return m_isSet; }
64  bool IsPolled()const{ return m_pollIntensity != 0; }
65 
66  string const& GetLabel()const{ return m_label; }
67  void SetLabel( string const& _label ){ m_label = _label; }
68 
69  string const& GetUnits()const{ return m_units; }
70  void SetUnits( string const& _units ){ m_units = _units; }
71 
72  string const& GetHelp()const{ return m_help; }
73  void SetHelp( string const& _help ){ m_help = _help; }
74 
75  uint8 const& GetPollIntensity()const{ return m_pollIntensity; }
76  void SetPollIntensity( uint8 const& _intensity ){ m_pollIntensity = _intensity; }
77 
78  int32 GetMin()const{ return m_min; }
79  int32 GetMax()const{ return m_max; }
80 
81  void SetChangeVerified( bool _verify ){ m_verifyChanges = _verify; }
83 
84  virtual string const GetAsString() const { return ""; }
85  virtual bool SetFromString( string const& ) { return false; }
86 
87  bool Set(); // For the user to change a value in a device
88 
89  // Helpers
90  static ValueID::ValueGenre GetGenreEnumFromName( char const* _name );
91  static char const* GetGenreNameFromEnum( ValueID::ValueGenre _genre );
92  static ValueID::ValueType GetTypeEnumFromName( char const* _name );
93  static char const* GetTypeNameFromEnum( ValueID::ValueType _type );
94 
95  protected:
96  virtual ~Value();
97 
98 // void SetIsSet() { m_isSet = true; } // TODO: consider removing this...it's never called since m_isSet is set in ValueChanged and ValueRefreshed
99  bool IsCheckingChange()const{ return m_checkChange; }
100  void SetCheckingChange( bool _check ) { m_checkChange = _check; }
101  void OnValueRefreshed(); // A value in a device has been refreshed
102  void OnValueChanged(); // The refreshed value actually changed
103  int VerifyRefreshedValue( void* _originalValue, void* _checkValue, void* _newValue, ValueID::ValueType _type, int _length = 0 );
104 
107 
108  time_t m_refreshTime; // time_t identifying when this value was last refreshed
109  bool m_verifyChanges; // if true, apparent changes are verified; otherwise, they're not
111 
112 
113  private:
114  string m_label;
115  string m_units;
116  string m_help;
117  bool m_readOnly;
118  bool m_writeOnly;
119  bool m_isSet;
120  uint8 m_affectsLength;
121  uint8* m_affects;
122  bool m_affectsAll;
123  bool m_checkChange;
124  uint8 m_pollIntensity;
125  };
126 
127 } // namespace OpenZWave
128 
129 #endif
130 
131 
132 
bool GetChangeVerified()
Definition: Value.h:82
Definition: Bitfield.h:34
Container that holds all of the values associated with a given node.
Definition: ValueStore.h:44
string const & GetLabel() const
Definition: Value.h:66
void SetCheckingChange(bool _check)
Definition: Value.h:100
virtual void WriteXML(TiXmlElement *_valueElement)
Definition: Value.cpp:288
unsigned short uint16
Definition: Defs.h:93
string const & GetUnits() const
Definition: Value.h:69
ValueType
Definition: ValueID.h:94
void SetUnits(string const &_units)
Definition: Value.h:70
void SetChangeVerified(bool _verify)
Definition: Value.h:81
static char const * GetTypeNameFromEnum(ValueID::ValueType _type)
Definition: Value.cpp:548
virtual void ReadXML(uint32 const _homeId, uint8 const _nodeId, uint8 const _commandClassId, TiXmlElement const *_valueElement)
Definition: Value.cpp:148
void SetPollIntensity(uint8 const &_intensity)
Definition: Value.h:76
bool IsWriteOnly() const
Definition: Value.h:62
bool IsCheckingChange() const
Definition: Value.h:99
int32 GetMax() const
Definition: Value.h:79
void SetHelp(string const &_help)
Definition: Value.h:73
static ValueID::ValueType GetTypeEnumFromName(char const *_name)
Definition: Value.cpp:523
int32 m_max
Definition: Value.h:106
void OnValueRefreshed()
Definition: Value.cpp:415
bool m_verifyChanges
Definition: Value.h:109
virtual ~Value()
Definition: Value.cpp:134
string const & GetHelp() const
Definition: Value.h:72
ValueID const & GetID() const
Definition: Value.h:60
ValueID m_id
Definition: Value.h:110
The Driver class handles communication between OpenZWave and a device attached via a serial port (typ...
Definition: Driver.h:63
signed int int32
Definition: Defs.h:95
unsigned int uint32
Definition: Defs.h:96
static ValueID::ValueGenre GetGenreEnumFromName(char const *_name)
Definition: Value.cpp:486
bool IsReadOnly() const
Definition: Value.h:61
bool IsSet() const
Definition: Value.h:63
Provides a unique ID for a value reported by a Z-Wave device.The ValueID is used to uniquely identify...
Definition: ValueID.h:62
int32 m_min
Definition: Value.h:105
time_t m_refreshTime
Definition: Value.h:108
int32 GetMin() const
Definition: Value.h:78
Definition: Ref.h:46
bool IsPolled() const
Definition: Value.h:64
Base class for values associated with a node.
Definition: Value.h:48
Value()
Definition: Value.cpp:112
int VerifyRefreshedValue(void *_originalValue, void *_checkValue, void *_newValue, ValueID::ValueType _type, int _length=0)
Definition: Value.cpp:565
void SetLabel(string const &_label)
Definition: Value.h:67
virtual bool SetFromString(string const &)
Definition: Value.h:85
bool Set()
Definition: Value.cpp:353
uint8 const & GetPollIntensity() const
Definition: Value.h:75
ValueGenre
Definition: ValueID.h:80
static char const * GetGenreNameFromEnum(ValueID::ValueGenre _genre)
Definition: Value.cpp:511
virtual string const GetAsString() const
Definition: Value.h:84
void OnValueChanged()
Definition: Value.cpp:445
unsigned char uint8
Definition: Defs.h:90