PLCnext API Documentation  22.9.0.33
AlarmAccess.hpp
1 //
3 // Copyright PHOENIX CONTACT Electronics GmbH
4 //
6 #pragma once
7 #include "Arp/System/Core/Arp.h"
8 #include "Arp/System/Nm/NotificationManager.hpp"
9 #include "Arp/System/Nm/StringPayload.hpp"
10 #include "Arp/System/NmPayload/Alarms/Internal/AckConfPayload.hpp"
11 #include "Arp/System/NmPayload/Alarms/Internal/AlarmPayload.hpp"
12 #include <functional>
13 
14 namespace Arp { namespace System { namespace NmPayload { namespace Alarms
15 {
16 
17 constexpr int NotificationQueueOverflowError = 100;
18 constexpr int NotInitializedError = -1;
19 constexpr int InvalidArgumentError = -2;
20 constexpr int InvalidStateError = -2;
21 constexpr int InvalidAlarmIdError = -2;
22 constexpr int InvalidAlarmTypeError = -3;
23 
24 using namespace Arp::System::NmPayload::Alarms::Internal;
25 
46 {
47 public: // typedefs
48 
49 public: // construction/destruction
50  AlarmAccess();
51  AlarmAccess(const AlarmAccess& arg) = delete;
52  AlarmAccess& operator=(const AlarmAccess& arg) = delete;
53  ~AlarmAccess(void);
54 
55 public:
61  int32 Init(String alarmClientId);
63  void Dispose();
73  int32 AddAlarm(AlarmState& alarmState);
83  int32 Acknowledge(const String& alarmId);
90  int32 AcknowledgeWithComment(const String& alarmId, const String& comment = "", const String& language = "", const String& user = "");
94  int32 Confirm(const String& alarmId);
101  int32 ConfirmWithComment(const String& alarmId, const String& comment = "", const String& language = "", const String& user = "");
108  int32 AddComment(const String& alarmId, const String& comment, const String& language = "", const String& user = "");
115  int32 SubscribeAddAlarm(std::function<void(const AlarmState& alarmState)> handler);
122  int32 SubscribeNewAlarmState(std::function<void(const AlarmState& alarmState)> handler);
131  int32 SubscribeAcknowledge(std::function<void(const String& alarmId, const String& comment, const String& language, const String& user)> handler);
140  int32 SubscribeConfirm(std::function<void(const String& alarmId, const String& comment, const String& language, const String& user)> handler);
149  int32 SubscribeAddComment(std::function<void(const String& alarmId, const String& comment, const String& language, const String& user)> handler);
150 
151 private: // methods
152  void AddAlarmNotificationReceived(const Notification& notification);
153  void NewStateNotificationReceived(const Notification& notification);
154  void AcknowledgeNotificationReceived(const Notification& notification);
155  void ConfirmNotificationReceived(const Notification& notification);
156  void AddCommentNotificationReceived(const Notification& notification);
157 private: // fields
158  String alarmClientName;
159  bool initialized;
160  mutable Mutex alarmsMutex;
168  NotificationSubscriber addAlarmSubscriber;
169  NotificationSubscriber newStateSubscriber;
170  //NotificationSubscriber acknowledgeSubscriber1;
171  NotificationSubscriber acknowledgeSubscriber2;
172  //NotificationSubscriber confirmSubscriber1;
173  NotificationSubscriber confirmSubscriber2;
174  NotificationSubscriber addCommentSubscriber;
175  std::function<void(const AlarmState& alarmState)> addAlarmHandler;
176  std::function<void(const AlarmState& alarmState)> newAlarmStateHandler;
177  std::function<void(const String& alarmId, const String& comment, const String& language, const String& user)> acknowledgeHandler;
178  std::function<void(const String& alarmId, const String& comment, const String& language, const String& user)> confirmHandler;
179  std::function<void(const String& alarmId, const String& comment, const String& language, const String& user)> addCommentHandler;
180 };
181 
183 // inline methods of class AlarmAccess
184 
185 }}}}
Mutual exclusion object to prevent data from concurrent modifications.
Definition: Mutex.hpp:26
Access class for the alarm server component.
Definition: AlarmAccess.hpp:46
int32 Confirm(const String &alarmId)
int32 SubscribeAddComment(std::function< void(const String &alarmId, const String &comment, const String &language, const String &user)> handler)
An alarm source that supports acknowledgeble or confirmable alarms should subscribe to add comment re...
int32 SubscribeNewAlarmState(std::function< void(const AlarmState &alarmState)> handler)
A client can subscribe to NewAlarmState calls to track the state of alarms.
int32 Init(String alarmClientId)
Initialize the class.
int32 SubscribeAddAlarm(std::function< void(const AlarmState &alarmState)> handler)
A client can subscribe to AddAlarm calls (used e.g. by the OPC-UA Server to show the alarms in the ad...
int32 NewAlarmState(AlarmState &alarmState)
Inform the AlarmServer about a new alarm state (comming alarms, going alarms / changes to sub states)...
int32 Acknowledge(const String &alarmId)
A client can ask for acknowledgement of an alarm instance (if supported by an alarm).
int32 SubscribeConfirm(std::function< void(const String &alarmId, const String &comment, const String &language, const String &user)> handler)
An alarm source that supports confirmable alarms should subscribe to confirm request by a client.
int32 ConfirmWithComment(const String &alarmId, const String &comment="", const String &language="", const String &user="")
int32 AcknowledgeWithComment(const String &alarmId, const String &comment="", const String &language="", const String &user="")
A client can ask for acknowledgement of an alarm instance (if supported by an alarm).
int32 AddComment(const String &alarmId, const String &comment, const String &language="", const String &user="")
int32 SubscribeAcknowledge(std::function< void(const String &alarmId, const String &comment, const String &language, const String &user)> handler)
An alarm source that supports acknowledgeble alarms should subscribe to acknowledge request by a clie...
int32 AddAlarm(AlarmState &alarmState)
Announce a new alarm to the server (used for browsing in OPC UA).
void Dispose()
Diposes all resources of this instance.
State with sub states of an alarm.
Definition: AlarmState.hpp:12
Proxy object for a non-blocking NotificationRegistration
Definition: NonBlockingNotificationRegistration.hpp:34
Proxy class for an subscriber of notifications
Definition: NotificationSubscriber.hpp:30
Contains meta data and paylod of a Notification
Definition: Notification.hpp:22
std::int32_t int32
The Arp integer type of 4 byte size.
Definition: PrimitiveTypes.hpp:37
@ System
System components used by the System, Device, Plc or Io domains.
Root namespace for the PLCnext API