Push3 gateway triggers are in beta, which means bugs and issues should be expected.  Please contact EKM Metering with details of any issues you see.

TABLE OF CONTENTS

  • Setting Up a Trigger Condition
  • Setting Up a Trigger Action
  • Setting Up a Recurrence Rule
  • Glossary of Terms


EKM Push3 gateway triggers are one of the most powerful tools that EKM has to offer.  You can automate how and when the EKM Push system will react to metered values.  You can have the Push gateway send you an email or control a relay to turn on/off a switch or close a valve based on the metered data for example.   Push3 gateways have the ability trigger specific actions based on conditions that you set up. Triggers live on the Push3 gateways so they will continue to function even without an internet connection. Triggers can control the relays on the v.4 Omnimeters, in order to turn something on or off, or they can email you notifications of the trigger.  Please note: v.3 Omnimeters do not have controllable relays, so the relay triggers will not work, but the email triggers will.


Setting up a trigger consists of 2–3 parts:

  1. Defining what conditions will cause the trigger to happen
  2. Defining what action will happen when the conditions are met
  3. There is also an option to set up a recurrence rule for scheduled relay control

Setting Up a Trigger Condition

  1. Select the Push3 gateway that you would like to set up the trigger on in the left column of the EKM Push account portal.
  2. Click the + Add trigger button
  3. Name your trigger
  4. Select the Omnimeter address (serial number) that you would like the trigger set up for. Only Omnimeters, that are assigned to the Push3 you have selected, will be available in the dropdown list.
  5. Select the condition type.

    Threshold:
    Trigger if the metered value is less than, greater than, or equal to the threshold value. Use this to trigger if the kWh or pulse count reaches a specified level, or if the net watts is too low (turn on a load for self consumption of solar), or for frequency/vo response, or if the voltage on any phase drops out, or to get an alert if your Push3 gateway is not able to read its meters (using Good Reads Ratio = 0) for example.

    Threshold range:
    Trigger if the metered value is either within the Threshold bounds, or out of the Threshold bounds.  Use this to look for voltage issues, for example.
    Rate:
    Trigger if the rate of change is higher or lower than your preference. Use this option to trigger based on leaks, or equipment failures, for example. Please note: rate measurement is constrained by a relatively slow meter read rate, so please do not depend on high accuracy with this trigger.Rate range:
    Trigger if the rate of change if higher than or lower than your preferred bounds.  Use this to trigger based on voltage anomalies, for example.Pulse inputs:
    Trigger if a switch connected to the Omnimeter pulse input is open or closed for a specified period of time. Use this to trigger if a float switch senses low water, or a temperature switch indicates overheating, or a door is left open, for example.See the glossary of terms below to understand what each condition means.



Setting Up a Trigger Action

  1. From the dropdown list at the top of the Trigger action settings select Command if you want the trigger to actuate a relay on the v.4/v.5 Omnimeter.

    Select Email notification if you would like to receive an email when the trigger fires.



Setting Up a Recurrence Rule

  1. If you would like to control the Omnimeter relays on a schedule, select Recurrence rule from the dropdown list at the top of the Trigger condition settings.



Glossary of Terms

TRIGGER CONDITION
TermDefinition
Data sourceChoose Omnimeter data to trigger on
AddressThe Omnimeter unique address that the Push will monitor for triggering
Condition Type
The kind of trigger you want to set up
ThresholdTrigger based on if the data is higher or lower than the threshold value
Data fieldThe Omnimeter metered value to trigger on (volts or watts for example)
Condition testGreater than, Less than, or Equals
greater thanTrigger if the metered value is more than the threshold value
greater than or equalsTrigger if the metered value is more than or the same as the threshold value
less thanTrigger if the metered value is less than the threshold value
less than or equalsTrigger if the metered value is less than or the same as the threshold value
Threshold valueThe specified value which the push will monitor for.
Minimum duration of conditionThe triggered condition must be true for this many seconds for the trigger to fire.  Use a higher value if you don't want the trigger to fire based on momentary deviations.
Minimum time between triggersThe time in seconds between triggers.  Use a higher value if you don't want the trigger to fire back to back in rapid succession.
Continuous triggerIf you do not choose this, then after a trigger fires, the condition must go to false before the trigger can fire again.
Threshold value lowIn a Range Trigger, this is the value under which the trigger will fire
Threshold value highIn a Range Trigger, this is the value above which the trigger will fire
RateThe rate of change in the metered value.  If the pulse count is increasing too quickly or increasing too slowly, for example
AmountThe number of increments in the metered value per interval
Per intervalThe time period within which the rate must be less than or greater than the specified amount.
Filter typeAdvanced Rate Trigger Filtering:  Used for filtering out spurious noise
Moving averageAdvanced Rate Trigger Filtering:  Please research this independently
Moving medianAdvanced Rate Trigger Filtering: Please research this independently
Weighted moving averageAdvanced Rate Trigger Filtering: Please research this independently
Exponential moving averageAdvanced Rate Trigger Filtering: Please research this independently
Rate rangeTrigger on conditions that are within or outside of the specified rate of change
Pulse inputsOmnimeter inputs that count pulses as well as report the real-time input state
Pulse input 1, 2, and 3The Omnimeter has 3 separate pulse inputs
ignorePulse Input: If you do not want the input to be considered in the trigger
closedPulse Input: If you want the trigger to fire when the pulse input is closed for the specified period of time
openPulse Input: If you want the trigger to fire when the pulse input is open for the specified period of time
and/orChoose "and" if you want multiple inputs to be true at the same time in order for the trigger to fire.  Choose "or" if you only want one of the inputs to be true in order for the trigger to fire


Recurrence ruleUse this to schedule relay control
Time of dayFor Daily or less frequent: The time of day do you want the relay to be controlled
FrequencyHow often you want the relay to be controlled
Starts onYou can specify the date when the trigger should start.
EndsWhen the trigger should stop, you can choose never, a date, or after x triggered events



TRIGGER ACTION
TermDefinition
CommandYou can choose if you want to control a relay or send an email based on the triggered event
Email notificationSend an email based on the triggered event
WebhookNot enabled
Command targetWhich meter the relay should be controlled on (this does not have to be the same meter as the data source meter)
AddressThe Omnimeter number of the command target meter for relay control
Relay numberThe Omnimeter has 2 controllable outputs, specify which one
Relay statusDo you want the relay to Open (Off) or Close (On) when there is a triggered event?
DurationHow many seconds do you want the relay to remain Open (Off) or Closed (On) as the result of a triggered event.  Use 0 seconds if you want the relay to remain Open or Closed forever.