def read_event_history(self, starttime=None, endtime=None, numvalues=0, evtypes=ua.ObjectIds.BaseEventType):
"""
Read event history of a source node
result code from server is checked and an exception is raised in case of error
If numvalues is > 0 and number of events in period is > numvalues
then result will be truncated
"""
details = ua.ReadEventDetails()
if starttime:
details.StartTime = starttime
else:
details.StartTime = ua.get_win_epoch()
if endtime:
details.EndTime = endtime
else:
details.EndTime = ua.get_win_epoch()
details.NumValuesPerNode = numvalues
if not isinstance(evtypes, (list, tuple)):
evtypes = [evtypes]
evtypes = [Node(self.server, evtype) for evtype in evtypes]
evfilter = events.get_filter_from_event_type(evtypes)
details.Filter = evfilter
result = self.history_read_events(details)
event_res = []
for res in result.HistoryData.Events:
event_res.append(events.Event.from_event_fields(evfilter.SelectClauses, res.EventFields))
return event_res
def read_event_history(self, starttime=None, endtime=None, numvalues=0, evtypes=ua.ObjectIds.BaseEventType):
"""
Read event history of a source node
result code from server is checked and an exception is raised in case of error
If numvalues is > 0 and number of events in period is > numvalues
then result will be truncated
"""
details = ua.ReadEventDetails()
if starttime:
details.StartTime = starttime
else:
details.StartTime = ua.get_win_epoch()
if endtime:
details.EndTime = endtime
else:
details.EndTime = ua.get_win_epoch()
details.NumValuesPerNode = numvalues
if not isinstance(evtypes, (list, tuple)):
evtypes = [evtypes]
evtypes = [Node(self.server, evtype) for evtype in evtypes]
evfilter = events.get_filter_from_event_type(evtypes)
details.Filter = evfilter
result = self.history_read_events(details)
event_res = []
for res in result.HistoryData.Events:
event_res.append(events.Event.from_event_fields(evfilter.SelectClauses, res.EventFields))
return event_res
def read_raw_history(self,
uaNode,
starttime=None,
endtime=None,
numvalues=0,
cont=None):
details = ua.ReadRawModifiedDetails()
details.IsReadModified = False
details.StartTime = starttime or ua.get_win_epoch()
details.EndTime = endtime or ua.get_win_epoch()
details.NumValuesPerNode = numvalues
details.ReturnBounds = True
result = OpcUaClient._history_read(uaNode, details, cont)
assert (result.StatusCode.is_good())
return result.HistoryData.DataValues, result.ContinuationPoint
def get_references(self,
refs=ua.ObjectIds.References,
direction=ua.BrowseDirection.Both,
nodeclassmask=ua.NodeClass.Unspecified,
includesubtypes=True):
"""
returns references of the node based on specific filter defined with:
refs = ObjectId of the Reference
direction = Browse direction for references
nodeclassmask = filter nodes based on specific class
includesubtypes = If true subtypes of the reference (ref) are also included
"""
desc = ua.BrowseDescription()
desc.BrowseDirection = direction
desc.ReferenceTypeId = _to_nodeid(refs)
desc.IncludeSubtypes = includesubtypes
desc.NodeClassMask = nodeclassmask
desc.ResultMask = ua.BrowseResultMask.All
desc.NodeId = self.nodeid
params = ua.BrowseParameters()
params.View.Timestamp = ua.get_win_epoch()
params.NodesToBrowse.append(desc)
params.RequestedMaxReferencesPerNode = 0
results = self.server.browse(params)
references = self._browse_next(results)
return references
def get_references(self, refs=ua.ObjectIds.References, direction=ua.BrowseDirection.Both, nodeclassmask=ua.NodeClass.Unspecified, includesubtypes=True):
"""
returns references of the node based on specific filter defined with:
refs = ObjectId of the Reference
direction = Browse direction for references
nodeclassmask = filter nodes based on specific class
includesubtypes = If true subtypes of the reference (ref) are also included
"""
desc = ua.BrowseDescription()
desc.BrowseDirection = direction
desc.ReferenceTypeId = _to_nodeid(refs)
desc.IncludeSubtypes = includesubtypes
desc.NodeClassMask = nodeclassmask
desc.ResultMask = ua.BrowseResultMask.All
desc.NodeId = self.nodeid
params = ua.BrowseParameters()
params.View.Timestamp = ua.get_win_epoch()
params.NodesToBrowse.append(desc)
params.RequestedMaxReferencesPerNode = 0
results = self.server.browse(params)
references = self._browse_next(results)
return references
def read_raw_history(self, starttime=None, endtime=None, numvalues=0):
"""
Read raw history of a node
result code from server is checked and an exception is raised in case of error
If numvalues is > 0 and number of events in period is > numvalues
then result will be truncated
"""
details = ua.ReadRawModifiedDetails()
details.IsReadModified = False
if starttime:
details.StartTime = starttime
else:
details.StartTime = ua.get_win_epoch()
if endtime:
details.EndTime = endtime
else:
details.EndTime = ua.get_win_epoch()
details.NumValuesPerNode = numvalues
details.ReturnBounds = True
result = self.history_read(details)
return result.HistoryData.DataValues
def read_raw_history(self, starttime=None, endtime=None, numvalues=0):
"""
Read raw history of a node
result code from server is checked and an exception is raised in case of error
If numvalues is > 0 and number of events in period is > numvalues
then result will be truncated
"""
details = ua.ReadRawModifiedDetails()
details.IsReadModified = False
if starttime:
details.StartTime = starttime
else:
details.StartTime = ua.get_win_epoch()
if endtime:
details.EndTime = endtime
else:
details.EndTime = ua.get_win_epoch()
details.NumValuesPerNode = numvalues
details.ReturnBounds = True
result = self.history_read(details)
return result.HistoryData.DataValues
def read_event_history(self, source_id, start, end, nb_values, evfilter):
cont = None
if source_id not in self._events:
print("Error attempt to read event history for a node which does not historize events")
return [], cont
else:
if start is None:
start = ua.get_win_epoch()
if end is None:
end = ua.get_win_epoch()
if start == ua.get_win_epoch():
results = [ev for ev in reversed(self._events[source_id]) if start <= ev.Time]
elif end == ua.get_win_epoch():
results = [ev for ev in self._events[source_id] if start <= ev.Time]
elif start > end:
results = [ev for ev in reversed(self._events[source_id]) if end <= ev.Time <= start]
else:
results = [ev for ev in self._events[source_id] if start <= ev.Time <= end]
if nb_values and len(results) > nb_values:
cont = results[nb_values + 1].Time
results = results[:nb_values]
return results, cont
def read_node_history(self, node_id, start, end, nb_values):
cont = None
if node_id not in self._datachanges:
print("Error attempt to read history for a node which is not historized")
return [], cont
else:
if start is None:
start = ua.get_win_epoch()
if end is None:
end = ua.get_win_epoch()
if start == ua.get_win_epoch():
results = [dv for dv in reversed(self._datachanges[node_id]) if start <= dv.ServerTimestamp]
elif end == ua.get_win_epoch():
results = [dv for dv in self._datachanges[node_id] if start <= dv.ServerTimestamp]
elif start > end:
results = [dv for dv in reversed(self._datachanges[node_id]) if end <= dv.ServerTimestamp <= start]
else:
results = [dv for dv in self._datachanges[node_id] if start <= dv.ServerTimestamp <= end]
if nb_values and len(results) > nb_values:
cont = results[nb_values + 1].ServerTimestamp
results = results[:nb_values]
return results, cont
def read_event_history(self, source_id, start, end, nb_values, evfilter):
cont = None
if source_id not in self._events:
print("Error attempt to read event history for a node which does not historize events")
return [], cont
else:
if start is None:
start = ua.get_win_epoch()
if end is None:
end = ua.get_win_epoch()
if start == ua.get_win_epoch():
results = [ev for ev in reversed(self._events[source_id]) if start <= ev.Time]
elif end == ua.get_win_epoch():
results = [ev for ev in self._events[source_id] if start <= ev.Time]
elif start > end:
results = [ev for ev in reversed(self._events[source_id]) if end <= ev.Time <= start]
else:
results = [ev for ev in self._events[source_id] if start <= ev.Time <= end]
if nb_values and len(results) > nb_values:
cont = results[nb_values + 1].Time
results = results[:nb_values]
return results, cont
def read_node_history(self, node_id, start, end, nb_values):
cont = None
if node_id not in self._datachanges:
self.logger.warning("Error attempt to read history for a node which is not historized")
return [], cont
else:
if start is None:
start = ua.get_win_epoch()
if end is None:
end = ua.get_win_epoch()
if start == ua.get_win_epoch():
results = [dv for dv in reversed(self._datachanges[node_id]) if start <= dv.SourceTimestamp]
elif end == ua.get_win_epoch():
results = [dv for dv in self._datachanges[node_id] if start <= dv.SourceTimestamp]
elif start > end:
results = [dv for dv in reversed(self._datachanges[node_id]) if end <= dv.SourceTimestamp <= start]
else:
results = [dv for dv in self._datachanges[node_id] if start <= dv.SourceTimestamp <= end]
if nb_values and len(results) > nb_values:
cont = results[nb_values + 1].SourceTimestamp
results = results[:nb_values]
return results, cont
def _get_bounds(start, end, nb_values):
order = "ASC"
if start is None or start == ua.get_win_epoch():
order = "DESC"
start = ua.get_win_epoch()
if end is None or end == ua.get_win_epoch():
end = datetime.utcnow() + timedelta(days=1)
if start < end:
start_time = start.isoformat(' ')
end_time = end.isoformat(' ')
else:
order = "DESC"
start_time = end.isoformat(' ')
end_time = start.isoformat(' ')
if nb_values:
limit = nb_values + 1 # add 1 to the number of values for retrieving a continuation point
else:
limit = -1 # in SQLite a LIMIT of -1 returns all results
return start_time, end_time, order, limit
def _get_bounds(start, end, nb_values):
order = "ASC"
if start is None or start == ua.get_win_epoch():
order = "DESC"
start = ua.get_win_epoch()
if end is None or end == ua.get_win_epoch():
end = datetime.utcnow() + timedelta(days=1)
if start < end:
start_time = start.isoformat(' ')
end_time = end.isoformat(' ')
else:
order = "DESC"
start_time = end.isoformat(' ')
end_time = start.isoformat(' ')
if nb_values:
limit = nb_values + 1 # add 1 to the number of values for retrieving a continuation point
else:
limit = -1 # in SQLite a LIMIT of -1 returns all results
return start_time, end_time, order, limit