SmartMeter
The SmartMeter configuration enables the setup and monitoring of intelligent power meters for measuring and analyzing energy consumption. Comprehensive settings for alarms, connection and individual measuring phases can be configured here.
General
The basic settings of each device include the activation state (On/Off) as well as a name under which all alarms and warnings reported by this device are displayed. This should be chosen as uniquely descriptive as possible to be able to distinguish between devices.
Device name
The display name of the SmartMeter for identification in the system.
Alarm Group
By selecting the parent alarm group, the device is integrated into the system hierarchy.
Alarms are signaled in the parent alarm group.
Description
Optional description text for further characterization of the SmartMeter.
Address
The network address of the SmartMeter device.
Supply line
Select the supply line to which the device is connected. The options include:
- Feed line A
- Feed line B
- Both feed lines
PUE
For determining the Power Usage Effectiveness (PUE) and sum calculation across the assigned alarm group. Available options:
- Sub-meter/IT Device
- Main meter
Sign
Determines how the sign is represented:
- Sign bit
- Two's complement
Word order
Selects the order in which data words are interpreted from the SmartMeter:
- Little Endian
- Big Endian
Read function
Function code used to read the value:
- 0x03 (Holding Register)
- 0x04 (Input Register)
When using Kentix SmartMeters, the pre-filled values should not be changed as this may negatively affect the functionality of the device.
Connection
Connection monitoring enables alarming when the device is not reachable.
| Alarm Assignment | Selection of the alarm assignment |
| Output as Warning | Connection loss does not trigger an alarm and is only reported as a warning. |
Alarm assignment
Configuration of system alarming for connection failures:
- System message: Standard alarming via the system
- Output as warning: Output connection loss as warning
If the device is unreachable for a certain time, a connection loss alarm is triggered. The time until connection loss can be configured in the respective alarm group.
Measuring phases
Individual settings can be made for each measuring phase. The general settings include a name, address and alarm options.
Name
Display name of this phase (e.g. "L1").
Address
Address of this phase in the Modbus network.
Alarm settings
Warnings and alarms are always triggered when the value measured by the device exceeds (for Max.) or falls below (for Min.) one of the configured thresholds.
Possible alarm assignments are
| Name | API value | Description |
|---|---|---|
| Off | off | For this input, alarming is disabled and the state/measurement value is not updated. |
| Armed-Active | armed-active | When the parent alarm group has been armed, alarms can be triggered. The state/measurement value of the input is updated. |
| Always-Active | always-active | Alarms can be triggered regardless of the alarm group's switch status. The state/measurement value of the input is updated. |
| Fire | fire | Alarms can always be triggered. These are reported as fire alarms. |
| Sabotage | sabotage | Alarms can always be triggered. These are reported as sabotage/intrusion alarms. |
| System Message | system | Alarms can always be triggered. These are reported as system messages. |
Voltage
| Alarm Type | Selection of the alarm assignment |
| Min. | Lower alarm threshold in V |
| Max. | Upper alarm threshold in V |
| Warning at | Activatable option for warnings |
Current
| Alarm Type | Selection of the alarm assignment |
| Min. | Lower alarm threshold in A |
| Max. | Upper alarm threshold in A |
| Warning at | Activatable option for warnings |
Active Power
| Alarm Type | Selection of the alarm assignment |
| Max. | Upper alarm threshold in W |
| Warning at | Activatable option for warnings |
Apparent Power
| Alarm Type | Selection of the alarm assignment |
| Max. | Upper alarm threshold in VA |
| Warning at | Activatable option for warnings |
Reactive Power
| Alarm Type | Selection of the alarm assignment |
| Max. | Upper alarm threshold in var |
| Warning at | Activatable option for warnings |
Frequency
| Alarm Type | Selection of the alarm assignment |
| Max. Tolerance | Maximum frequency deviation |
| Reference Value | Target frequency, reference value for max. tolerance |
| Warning at | Activatable option for warnings |
Power Factor
| Alarm Type | Selection of the alarm assignment |
Consumption
| Alarm Type | Selection of the alarm assignment |
Alarm Input
| Alarm Type | Selection of the alarm assignment |
| Alarm Value | When the measured value equals the alarm value, an alarm is triggered |
Connection settings
For the individual measured values, the connection can be configured individually by selecting the Modbus register as well as a factor and the data type. The corresponding configuration specifications can be found in the device manual.
The Modbus registers can be specified in both hexadecimal (0x) and decimal notation.
The conversion factors must be specified as decimal numbers, not as percentage values.
Supported data types are:
- INT8
- INT16
- INT32
- INT64
- UINT8
- UINT16
- UINT32
- UINT64
- FLOAT (Little Endian)
- FLOAT (Big Endian)
The register settings are structured as follows:
| Register | Modbus register from which the measured value can be read |
| Factor | Conversion factor for this measured value |
| Data type | Modbus data type of this measured value |
Webhooks
Webhooks in KentixONE provide the ability to send an HTTP request to an external server when an event occurs. System-wide Webhooks can be created for this purpose. Such a webhook can be assigned to any number of events.
Webhooks also provide the possibility to implement functions via the KentixONE SmartAPI that are not available through the standard configuration.
For example, when a fire alarm occurs, the switching outputs of an AccessManager could be activated to unlock the connected motor locks.
Events
| Name | Beschreibung |
|---|---|
| Alle Alarme | Bei jedem aufgetretenen Alarm wird der Webhook verschickt. |
| Scharf-Aktive Alarme | Wenn ein scharf-aktiver Alarm auftritt, wird der Webhook verschickt. |
| Dauer-Aktive Alarme | Wenn ein scharf-aktiver Alarm auftritt, wird der Webhook verschickt. |
| Brandalarme | Wenn ein Brandalarm auftritt, wird der Webhook verschickt. |
| Sabotagealarme | Wenn ein Sabotagelarm auftritt, wird der Webhook verschickt. |
| Systemmeldungen | Wenn eine Systemmeldung ausgelöst wird, wird der Webhook verschickt |
| Vor Scharfschaltung | Der Webhook wird verschickt, wenn eine Alarmgruppe scharfgeschaltet werden soll.(1) |
| Nach Scharfschaltung | Der Webhook wird verschickt, nachdem eine Alarmgruppe scharfgeschaltet wurde. |
| Vor Unscharfschaltung | Der Webhook wird verschickt, wenn eine Alarmgruppe unscharfgeschaltet wurde.(1) |
| Nach Unscharfschaltung | Der Webhook wird verschickt, nachdem eine Alarmgruppe unscharfgeschaltet wurde. |
| Änderung des Schaltstatus (Scharf- oder Unscharfschaltung) | Wenn die Alarmgruppe geschaltet wird, wird der Webhook verschickt. |
| Zyklisch (5 Min, 10 Min, 15 Min, 30 Min) | Der Webhook wird zyklisch verschickt. |
(1) Der Webhook wird verschickt, wenn ein Schaltbefehl entweder von einem Benutzer oder der automatischen Scharfschaltung ausgelöst wurde. Bsp: (Un-)Scharfschaltbefehl durch Benutzer → Webhook wird verschickt → (Un-)Scharfschaltung wird ausgeführt
Determine which webhooks should be called when an event occurs. New webhook-event combinations can be created using the "Create link" button.