OVMS3/OVMS.V3/main/ovms_metrics.h

1003 lines
29 KiB
C
Raw Normal View History

/*
; Project: Open Vehicle Monitor System
; Date: 14th March 2017
;
; Changes:
; 1.0 Initial release
;
; (C) 2011 Michael Stegen / Stegen Electronics
; (C) 2011-2017 Mark Webb-Johnson
; (C) 2011 Sonny Chen @ EPRO/DX
;
; Permission is hereby granted, free of charge, to any person obtaining a copy
; of this software and associated documentation files (the "Software"), to deal
; in the Software without restriction, including without limitation the rights
; to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
; copies of the Software, and to permit persons to whom the Software is
; furnished to do so, subject to the following conditions:
;
; The above copyright notice and this permission notice shall be included in
; all copies or substantial portions of the Software.
;
; THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
; IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
; FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
; AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
; LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
; OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
; THE SOFTWARE.
*/
#ifndef __METRICS_H__
#define __METRICS_H__
#include <functional>
#include <map>
#include <list>
#include <string>
#include <bitset>
#include <stdint.h>
#include <sstream>
#include <set>
#include <vector>
#include <atomic>
#include "ovms_utils.h"
#include "ovms_mutex.h"
#include "dbc_number.h"
#ifdef CONFIG_OVMS_SC_JAVASCRIPT_DUKTAPE
#include "ovms_script.h"
#endif
#include "ovms_log.h"
#define TAG ((const char*)"metric")
#define METRICS_MAX_MODIFIERS 32
using namespace std;
typedef enum : uint8_t
{
Other = 0,
Native = Other,
Kilometers = 10,
Miles = 11,
Meters = 12,
Feet = 13,
Celcius = 20,
Fahrenheit = 21,
kPa = 30,
Pa = 31,
PSI = 32,
Volts = 40,
Amps = 41,
AmpHours = 42,
kW = 43,
kWh = 44,
Watts = 45,
WattHours = 46,
Seconds = 50,
Minutes = 51,
Hours = 52,
TimeUTC = 53,
TimeLocal = 54,
Degrees = 60,
Kph = 61,
Mph = 62,
// Acceleration:
KphPS = 71, // Kph per second
MphPS = 72, // Mph per second
MetersPSS = 73, // Meters per second^2
dbm = 80, // Signal Quality (in dBm)
sq = 81, // Signal Quality (in SQ units)
Percentage = 90,
// Energy consumption:
WattHoursPK = 100, // Wh/km
WattHoursPM = 101, // Wh/mi
// Torque:
Nm = 110,
} metric_unit_t;
typedef enum : uint8_t
{
NeverDefined = 0,
FirstDefined,
Defined
} metric_defined_t;
extern const char* OvmsMetricUnitLabel(metric_unit_t units);
extern int UnitConvert(metric_unit_t from, metric_unit_t to, int value);
extern float UnitConvert(metric_unit_t from, metric_unit_t to, float value);
typedef uint32_t persistent_value_t;
struct persistent_values
{
std::size_t namehash;
persistent_value_t value;
};
struct persistent_metrics
{
u_long magic;
int version;
unsigned int serial;
size_t size;
int used;
persistent_values values[100];
};
extern persistent_values *pmetrics_find(const char *name);
extern persistent_values *pmetrics_register(const char *name);
class OvmsMetric
{
public:
OvmsMetric(const char* name, uint16_t autostale = 0, metric_unit_t units = Other, bool persist = false);
virtual ~OvmsMetric();
public:
virtual std::string AsString(const char* defvalue = "", metric_unit_t units = Other, int precision = -1);
std::string AsUnitString(const char* defvalue = "", metric_unit_t units = Other, int precision = -1);
virtual std::string AsJSON(const char* defvalue = "", metric_unit_t units = Other, int precision = -1);
virtual float AsFloat(const float defvalue = 0, metric_unit_t units = Other);
#ifdef CONFIG_OVMS_SC_JAVASCRIPT_DUKTAPE
virtual void DukPush(DukContext &dc);
#endif
virtual bool SetValue(std::string value);
virtual bool SetValue(dbcNumber& value);
virtual void operator=(std::string value);
virtual uint32_t LastModified();
virtual uint32_t Age();
virtual bool CheckPersist();
virtual bool IsDefined();
virtual bool IsFirstDefined();
virtual bool IsPersistent();
virtual bool IsStale();
virtual bool IsString() { return false; };
virtual bool IsFresh();
virtual void RefreshPersist();
virtual void SetStale(bool stale);
virtual void SetAutoStale(uint16_t seconds);
virtual metric_unit_t GetUnits();
virtual bool IsModified(size_t modifier);
virtual bool IsModifiedAndClear(size_t modifier);
virtual void ClearModified(size_t modifier);
virtual void SetModified(bool changed=true);
virtual void Clear();
public:
OvmsMetric* m_next;
const char* m_name;
std::atomic_ulong m_modified;
uint32_t m_lastmodified;
uint16_t m_autostale;
metric_unit_t m_units;
metric_defined_t m_defined;
bool m_stale;
bool m_persist;
};
class OvmsMetricBool : public OvmsMetric
{
public:
OvmsMetricBool(const char* name, uint16_t autostale=0, metric_unit_t units = Other, bool persist = false);
virtual ~OvmsMetricBool();
public:
std::string AsString(const char* defvalue = "", metric_unit_t units = Other, int precision = -1);
virtual std::string AsJSON(const char* defvalue = "", metric_unit_t units = Other, int precision = -1);
float AsFloat(const float defvalue = 0, metric_unit_t units = Other);
int AsBool(const bool defvalue = false);
#ifdef CONFIG_OVMS_SC_JAVASCRIPT_DUKTAPE
void DukPush(DukContext &dc);
#endif
bool SetValue(bool value);
void operator=(bool value) { SetValue(value); }
bool SetValue(std::string value);
bool SetValue(dbcNumber& value);
void operator=(std::string value) { SetValue(value); }
void Clear();
bool CheckPersist();
void RefreshPersist();
protected:
bool m_value;
bool* m_valuep;
};
class OvmsMetricInt : public OvmsMetric
{
public:
OvmsMetricInt(const char* name, uint16_t autostale=0, metric_unit_t units = Other, bool persist = false);
virtual ~OvmsMetricInt();
public:
std::string AsString(const char* defvalue = "", metric_unit_t units = Other, int precision = -1);
virtual std::string AsJSON(const char* defvalue = "", metric_unit_t units = Other, int precision = -1);
float AsFloat(const float defvalue = 0, metric_unit_t units = Other);
int AsInt(const int defvalue = 0, metric_unit_t units = Other);
#ifdef CONFIG_OVMS_SC_JAVASCRIPT_DUKTAPE
void DukPush(DukContext &dc);
#endif
bool SetValue(int value, metric_unit_t units = Other);
void operator=(int value) { SetValue(value); }
bool SetValue(std::string value);
bool SetValue(dbcNumber& value);
void operator=(std::string value) { SetValue(value); }
void Clear();
bool CheckPersist();
void RefreshPersist();
protected:
int m_value;
int* m_valuep;
};
class OvmsMetricFloat : public OvmsMetric
{
public:
OvmsMetricFloat(const char* name, uint16_t autostale=0, metric_unit_t units = Other, bool persist = false);
virtual ~OvmsMetricFloat();
public:
std::string AsString(const char* defvalue = "", metric_unit_t units = Other, int precision = -1);
virtual std::string AsJSON(const char* defvalue = "", metric_unit_t units = Other, int precision = -1);
float AsFloat(const float defvalue = 0, metric_unit_t units = Other);
int AsInt(const int defvalue = 0, metric_unit_t units = Other);
#ifdef CONFIG_OVMS_SC_JAVASCRIPT_DUKTAPE
void DukPush(DukContext &dc);
#endif
bool SetValue(float value, metric_unit_t units = Other);
void operator=(float value) { SetValue(value); }
bool SetValue(std::string value);
bool SetValue(dbcNumber& value);
void operator=(std::string value) { SetValue(value); }
void Clear();
virtual bool CheckPersist();
virtual void RefreshPersist();
protected:
float m_value;
float* m_valuep;
};
class OvmsMetricString : public OvmsMetric
{
public:
OvmsMetricString(const char* name, uint16_t autostale=0, metric_unit_t units = Other, bool persist = false);
virtual ~OvmsMetricString();
public:
std::string AsString(const char* defvalue = "", metric_unit_t units = Other, int precision = -1);
#ifdef CONFIG_OVMS_SC_JAVASCRIPT_DUKTAPE
void DukPush(DukContext &dc);
#endif
bool SetValue(std::string value);
void operator=(std::string value) { SetValue(value); }
void Clear();
virtual bool IsString() { return true; };
protected:
OvmsMutex m_mutex;
std::string m_value;
};
/**
* OvmsMetricBitset<bits>: metric wrapper for std::bitset<bits>
* - string representation as comma separated bit positions (beginning at startpos) of set bits
*/
template <size_t N, int startpos=1>
class OvmsMetricBitset : public OvmsMetric
{
public:
OvmsMetricBitset(const char* name, uint16_t autostale=0, metric_unit_t units = Other)
: OvmsMetric(name, autostale, units, false)
{
}
virtual ~OvmsMetricBitset()
{
}
public:
std::string AsString(const char* defvalue = "", metric_unit_t units = Other, int precision = -1)
{
if (!IsDefined())
return std::string(defvalue);
std::ostringstream ss;
OvmsMutexLock lock(&m_mutex);
for (int i = 0; i < N; i++)
{
if (m_value[i])
{
if (ss.tellp() > 0)
ss << ',';
ss << startpos + i;
}
}
return ss.str();
}
virtual std::string AsJSON(const char* defvalue = "", metric_unit_t units = Other, int precision = -1)
{
std::string json = "[";
json += AsString(defvalue, units, precision);
json += "]";
return json;
}
bool SetValue(std::string value)
{
std::bitset<N> n_value;
std::istringstream vs(value);
std::string token;
int elem;
while(std::getline(vs, token, ','))
{
std::istringstream ts(token);
ts >> elem;
elem -= startpos;
if (elem >= 0 && elem < N)
n_value[elem] = 1;
}
return SetValue(n_value);
}
void operator=(std::string value) { SetValue(value); }
std::bitset<N> AsBitset(const std::bitset<N> defvalue = std::bitset<N>(0), metric_unit_t units = Other)
{
if (!IsDefined())
return defvalue;
OvmsMutexLock lock(&m_mutex);
return m_value;
}
#ifdef CONFIG_OVMS_SC_JAVASCRIPT_DUKTAPE
void DukPush(DukContext &dc)
{
std::bitset<N> value;
{
OvmsMutexLock lock(&m_mutex);
value = m_value;
}
dc.PushArray();
int cnt = 0;
for (int i = 0; i < N; i++)
{
if (value[i])
{
dc.Push(i);
dc.PutProp(-2, cnt++);
}
}
}
#endif
bool SetValue(std::bitset<N> value, metric_unit_t units = Other)
{
if (m_mutex.Lock())
{
bool modified = false;
if (m_value != value)
{
m_value = value;
modified = true;
}
m_mutex.Unlock();
SetModified(modified);
return modified;
}
return false;
}
void operator=(std::bitset<N> value) { SetValue(value); }
protected:
OvmsMutex m_mutex;
std::bitset<N> m_value;
};
/**
* OvmsMetricSet<type>: metric wrapper for std::set<type>
* - string representation as comma separated values
* - be aware this is a memory eater, only use if necessary
*/
template <typename ElemType>
class OvmsMetricSet : public OvmsMetric
{
public:
OvmsMetricSet(const char* name, uint16_t autostale=0, metric_unit_t units = Other)
: OvmsMetric(name, autostale, units, false)
{
}
virtual ~OvmsMetricSet()
{
}
public:
std::string AsString(const char* defvalue = "", metric_unit_t units = Other, int precision = -1)
{
if (!IsDefined())
return std::string(defvalue);
std::ostringstream ss;
OvmsMutexLock lock(&m_mutex);
for (auto i = m_value.begin(); i != m_value.end(); i++)
{
if (ss.tellp() > 0)
ss << ',';
ss << *i;
}
return ss.str();
}
virtual std::string AsJSON(const char* defvalue = "", metric_unit_t units = Other, int precision = -1)
{
std::string json = "[";
json += AsString(defvalue, units, precision);
json += "]";
return json;
}
bool SetValue(std::string value)
{
std::set<ElemType> n_value;
std::istringstream vs(value);
std::string token;
ElemType elem;
while(std::getline(vs, token, ','))
{
std::istringstream ts(token);
ts >> elem;
n_value.insert(elem);
}
return SetValue(n_value);
}
void operator=(std::string value) { SetValue(value); }
std::set<ElemType> AsSet(const std::set<ElemType> defvalue = std::set<ElemType>(), metric_unit_t units = Other)
{
if (!IsDefined())
return defvalue;
OvmsMutexLock lock(&m_mutex);
return m_value;
}
#ifdef CONFIG_OVMS_SC_JAVASCRIPT_DUKTAPE
void DukPush(DukContext &dc)
{
std::set<ElemType> value;
{
OvmsMutexLock lock(&m_mutex);
value = m_value;
}
dc.PushArray();
int cnt = 0;
for (auto i = value.begin(); i != value.end(); i++)
{
dc.Push(*i);
dc.PutProp(-2, cnt++);
}
}
#endif
bool SetValue(std::set<ElemType> value, metric_unit_t units = Other)
{
if (m_mutex.Lock())
{
bool modified = false;
if (m_value != value)
{
m_value = value;
modified = true;
}
m_mutex.Unlock();
SetModified(modified);
return modified;
}
return false;
}
void operator=(std::set<ElemType> value) { SetValue(value); }
protected:
OvmsMutex m_mutex;
std::set<ElemType> m_value;
};
/**
* OvmsMetricVector<type>: metric wrapper for std::vector<type>
* - string representation as comma separated values
* - TODO: escaping / string encoding for non-numeric types
* - TODO: unit conversions
*
* Usage example:
* OvmsMetricVector<float>* vf = new OvmsMetricVector<float>("test.volts", SM_STALE_MIN, Volts);
* vf->SetElemValue(3, 1.23);
* vf->SetElemValue(17, 2.34);
* float myvals[3] = { 5.5, 6.6, 7.7 };
* vf->SetElemValues(10, 3, myvals);
*
* Note: use ExtRamAllocator<type> for large vectors (= use SPIRAM)
*
* Persistence can only be used on ElemTypes fitting into a pmetrics storage container.
* A persistent vector will need 1+size pmetrics slots. It will allocate new slots as
* needed when growing, but the slots will remain used when shrinking the vector. If any
* new element cannot allocate a pmetrics slot, the whole vector loses its persistence.
*
* Unit conversion currently casts to and from float for the conversion, it's assumed to
* only be necessary for floating point values here. If you need int conversion, rework
* UnitConvert() into a template.
*/
template
<
typename ElemType,
class Allocator = std::allocator<ElemType>
>
class OvmsMetricVector : public OvmsMetric
{
public:
OvmsMetricVector(const char* name, uint16_t autostale=0, metric_unit_t units = Other, bool persist = false)
: OvmsMetric(name, autostale, units, persist)
{
m_valuep_size = NULL;
if (!persist)
return;
// Ensure ElemType fits into persistent value:
if (sizeof(ElemType) > sizeof(persistent_value_t))
return;
// Vector persistence is currently implemented by a size entry with the metric name
// + one additional entry per element using the metric name extended by the element index.
// This may be optimized when the persistence system supports arrays.
struct persistent_values *vp = pmetrics_register(m_name);
if (!vp)
return;
m_valuep_size = reinterpret_cast<std::size_t*>(&vp->value);
std::size_t psize = *m_valuep_size;
if (SetPersistSize(psize))
{
SetModified(true);
ESP_LOGI(TAG, "persist %s = %s", m_name, AsUnitString().c_str());
}
}
virtual ~OvmsMetricVector()
{
}
private:
bool SetPersistSize(std::size_t new_size)
{
// Used by the constructor for initial read and by later SetValue() calls
// on vector size changes:
// m_persist false => register & read persistent values
// m_persist true => only register new elements
//
// Persistent element pointers will be retained on shrinking, and reused
// when the size grows again. Overall vector persistence is cancelled if any
// new element fails to register.
if (!m_valuep_size)
return false;
std::size_t old_size = m_valuep_elem.size();
if (new_size <= old_size)
{
*m_valuep_size = new_size;
m_persist = true;
return false;
}
m_valuep_elem.resize(new_size);
if (!m_persist)
m_value.resize(new_size);
struct persistent_values *vp;
char elem_name[100];
for (std::size_t i = old_size; i < new_size; i++)
{
snprintf(elem_name, sizeof(elem_name), "%s_%u", m_name, i);
vp = pmetrics_register(elem_name);
if (!vp)
{
// if any element fails to register, the whole vector persistence fails:
ESP_LOGE(TAG, "%s persistence lost: can't register slot for elem index %u", m_name, i);
*m_valuep_size = 0;
m_valuep_size = NULL;
m_valuep_elem.resize(0);
if (!m_persist)
m_value.resize(0);
m_persist = false;
return false;
}
else
{
m_valuep_elem[i] = reinterpret_cast<ElemType*>(&vp->value);
if (!m_persist)
m_value[i] = *m_valuep_elem[i];
}
}
*m_valuep_size = new_size;
m_persist = true;
return true;
}
public:
bool CheckPersist()
{
if (!m_persist || !m_valuep_size || !IsDefined())
return true;
if (*m_valuep_size != m_value.size())
{
ESP_LOGE(TAG, "CheckPersist: bad value for %s", m_name);
return false;
}
persistent_values *vp = pmetrics_find(m_name);
if (vp == NULL)
{
ESP_LOGE(TAG, "CheckPersist: can't find %s", m_name);
return false;
}
if (m_valuep_size != reinterpret_cast<std::size_t*>(&vp->value))
{
ESP_LOGE(TAG, "CheckPersist: bad address for %s", m_name);
return false;
}
for (int i = 0; i < m_value.size(); i++)
{
if (*m_valuep_elem[i] != m_value[i])
{
ESP_LOGE(TAG, "CheckPersist: bad value for %s[%d]", m_name, i);
return false;
}
}
return true;
}
void RefreshPersist()
{
if (m_persist && m_valuep_size && IsDefined())
{
*m_valuep_size = m_value.size();
for (int i = 0; i < m_value.size(); i++)
*m_valuep_elem[i] = m_value[i];
}
}
public:
virtual std::string AsString(const char* defvalue = "", metric_unit_t units = Other, int precision = -1)
{
if (!IsDefined())
return std::string(defvalue);
std::ostringstream ss;
if (precision >= 0)
{
ss.precision(precision);
ss << fixed;
}
OvmsMutexLock lock(&m_mutex);
for (auto i = m_value.begin(); i != m_value.end(); i++)
{
if (ss.tellp() > 0)
ss << ',';
if (units != Other && units != m_units)
ss << (ElemType) UnitConvert(m_units, units, (float)*i);
else
ss << *i;
}
return ss.str();
}
virtual std::string ElemAsString(size_t n, const char* defvalue = "", metric_unit_t units = Other, int precision = -1, bool addunitlabel = false)
{
OvmsMutexLock lock(&m_mutex);
if (!IsDefined() || m_value.size() <= n)
return std::string(defvalue);
std::ostringstream ss;
if (precision >= 0)
{
ss.precision(precision);
ss << fixed;
}
if (units != Other && units != m_units)
ss << (ElemType) UnitConvert(m_units, units, (float)m_value[n]);
else
ss << m_value[n];
if (addunitlabel)
ss << OvmsMetricUnitLabel(units == Native ? GetUnits() : units);
return ss.str();
}
std::string ElemAsUnitString(size_t n, const char* defvalue = "", metric_unit_t units = Other, int precision = -1)
{
return ElemAsString(n, defvalue, units, precision, true);
}
virtual std::string AsJSON(const char* defvalue = "", metric_unit_t units = Other, int precision = -1)
{
std::string json = "[";
json += AsString(defvalue, units, precision);
json += "]";
return json;
}
#ifdef CONFIG_OVMS_SC_JAVASCRIPT_DUKTAPE
void DukPush(DukContext &dc)
{
std::vector<ElemType, Allocator> value;
{
OvmsMutexLock lock(&m_mutex);
value = m_value;
}
dc.PushArray();
int cnt = 0;
for (auto i = value.begin(); i != value.end(); i++)
{
dc.Push(*i);
dc.PutProp(-2, cnt++);
}
}
#endif
virtual bool SetValue(std::string value)
{
std::vector<ElemType, Allocator> n_value;
std::istringstream vs(value);
std::string token;
ElemType elem;
while(std::getline(vs, token, ','))
{
std::istringstream ts(token);
ts >> elem;
n_value.push_back(elem);
}
return SetValue(n_value);
}
void operator=(std::string value) { SetValue(value); }
bool SetValue(const std::vector<ElemType, Allocator>& value, metric_unit_t units = Other)
{
bool modified = false, resized = false;
if (m_mutex.Lock())
{
if (m_value.size() != value.size())
{
m_value.resize(value.size());
if (m_persist)
SetPersistSize(value.size());
resized = true;
}
for (size_t i = 0; i < value.size(); i++)
{
ElemType ivalue;
if (units != Other && units != m_units)
ivalue = (ElemType) UnitConvert(units, m_units, (float)value[i]);
else
ivalue = value[i];
if (resized || m_value[i] != ivalue)
{
m_value[i] = ivalue;
modified = true;
if (m_persist)
*m_valuep_elem[i] = ivalue;
}
}
m_mutex.Unlock();
SetModified(modified);
}
return modified;
}
void operator=(std::vector<ElemType, Allocator> value) { SetValue(value); }
void ClearValue()
{
if (IsDefined())
{
if (m_mutex.Lock())
{
if (m_persist)
SetPersistSize(0);
m_value.clear();
m_mutex.Unlock();
SetModified(true);
}
}
}
std::vector<ElemType, Allocator> AsVector(const std::vector<ElemType, Allocator> defvalue = std::vector<ElemType, Allocator>(), metric_unit_t units = Other)
{
if (!IsDefined())
return defvalue;
OvmsMutexLock lock(&m_mutex);
return m_value;
}
ElemType GetElemValue(size_t n)
{
ElemType val{};
OvmsMutexLock lock(&m_mutex);
if (m_value.size() > n)
val = m_value[n];
return val;
}
void SetElemValue(size_t n, const ElemType nvalue, metric_unit_t units = Other)
{
ElemType value;
if (units != Other && units != m_units)
value = (ElemType) UnitConvert(units, m_units, (float)nvalue);
else
value = nvalue;
bool modified = false, resized = false;
if (m_mutex.Lock())
{
if (m_value.size() < n+1)
{
m_value.resize(n+1);
if (m_persist)
SetPersistSize(n+1);
resized = true;
}
if (resized || m_value[n] != value)
{
m_value[n] = value;
modified = true;
if (m_persist)
*m_valuep_elem[n] = value;
}
m_mutex.Unlock();
}
SetModified(modified);
}
void SetElemValues(size_t start, size_t cnt, const ElemType* values, metric_unit_t units = Other)
{
bool modified = false, resized = false;
if (m_mutex.Lock())
{
if (m_value.size() < start+cnt)
{
m_value.resize(start+cnt);
if (m_persist)
SetPersistSize(start+cnt);
resized = true;
}
for (size_t i = 0; i < cnt; i++)
{
ElemType ivalue;
if (units != Other && units != m_units)
ivalue = (ElemType) UnitConvert(units, m_units, (float)values[i]);
else
ivalue = values[i];
if (resized || m_value[start+i] != ivalue)
{
m_value[start+i] = ivalue;
modified = true;
if (m_persist)
*m_valuep_elem[start+i] = ivalue;
}
}
m_mutex.Unlock();
}
SetModified(modified);
}
uint32_t GetSize()
{
return m_value.size();
}
protected:
OvmsMutex m_mutex;
std::vector<ElemType, Allocator> m_value;
std::size_t* m_valuep_size;
std::vector<ElemType*, Allocator> m_valuep_elem;
};
typedef std::function<void(OvmsMetric*)> MetricCallback;
class MetricCallbackEntry
{
public:
MetricCallbackEntry(const char* caller, MetricCallback callback);
virtual ~MetricCallbackEntry();
public:
const char *m_caller;
MetricCallback m_callback;
};
typedef std::list<MetricCallbackEntry*> MetricCallbackList;
typedef std::map<const char*, MetricCallbackList*, CmpStrOp> MetricCallbackMap;
class OvmsMetrics
{
public:
OvmsMetrics();
virtual ~OvmsMetrics();
public:
void RegisterMetric(OvmsMetric* metric);
void DeregisterMetric(OvmsMetric* metric);
public:
bool Set(const char* metric, const char* value);
bool SetInt(const char* metric, int value);
bool SetBool(const char* metric, bool value);
bool SetFloat(const char* metric, float value);
OvmsMetric* Find(const char* metric);
OvmsMetricInt *InitInt(const char* metric, uint16_t autostale=0, int value=0, metric_unit_t units = Other, bool persist = false);
OvmsMetricBool *InitBool(const char* metric, uint16_t autostale=0, bool value=0, metric_unit_t units = Other, bool persist = false);
OvmsMetricFloat *InitFloat(const char* metric, uint16_t autostale=0, float value=0, metric_unit_t units = Other, bool persist = false);
OvmsMetricString *InitString(const char* metric, uint16_t autostale=0, const char* value=NULL, metric_unit_t units = Other);
template <size_t N>
OvmsMetricBitset<N> *InitBitset(const char* metric, uint16_t autostale=0, const char* value=NULL, metric_unit_t units = Other)
{
OvmsMetricBitset<N> *m = (OvmsMetricBitset<N> *)Find(metric);
if (m==NULL) m = new OvmsMetricBitset<N>(metric, autostale, units);
if (value && !m->IsDefined())
m->SetValue(value);
return m;
}
template <typename ElemType>
OvmsMetricSet<ElemType> *InitSet(const char* metric, uint16_t autostale=0, const char* value=NULL, metric_unit_t units = Other)
{
OvmsMetricSet<ElemType> *m = (OvmsMetricSet<ElemType> *)Find(metric);
if (m==NULL) m = new OvmsMetricSet<ElemType>(metric, autostale, units);
if (value && !m->IsDefined())
m->SetValue(value);
return m;
}
template <typename ElemType>
OvmsMetricVector<ElemType> *InitVector(const char* metric, uint16_t autostale=0, const char* value=NULL, metric_unit_t units = Other, bool persist = false)
{
OvmsMetricVector<ElemType> *m = (OvmsMetricVector<ElemType> *)Find(metric);
if (m==NULL) m = new OvmsMetricVector<ElemType>(metric, autostale, units, persist);
if (value && !m->IsDefined())
m->SetValue(value);
return m;
}
public:
void RegisterListener(const char* caller, const char* name, MetricCallback callback);
void DeregisterListener(const char* caller);
void NotifyModified(OvmsMetric* metric);
protected:
MetricCallbackMap m_listeners;
public:
size_t RegisterModifier();
public:
void EventSystemShutDown(std::string event, void* data);
protected:
size_t m_nextmodifier;
public:
OvmsMetric* m_first;
bool m_trace;
};
extern OvmsMetrics MyMetrics;
#undef TAG
#endif //#ifndef __METRICS_H__