Difference between revisions of "Template:SMS and Email alerts Triggered by BAT120"

From Teltonika Networks Wiki
 
(7 intermediate revisions by 3 users not shown)
Line 1: Line 1:
 +
<p style="color:red">The information in this page is updated in accordance with [https://wiki.teltonika-networks.com/view/FW_%26_SDK_Downloads'''00.07.03.3'''] firmware version .</p>
 
==Introduction==
 
==Introduction==
 
This article provides a guide on how to configure '''SMS''' and '''Email''' alerts using '''I/O Juggler''' on '''Teltonika Networks''' Routers and Gateways when the main power supply is being cut and the device switches onto the Backup Power from - '''BAT120'''.
 
This article provides a guide on how to configure '''SMS''' and '''Email''' alerts using '''I/O Juggler''' on '''Teltonika Networks''' Routers and Gateways when the main power supply is being cut and the device switches onto the Backup Power from - '''BAT120'''.
Line 21: Line 22:
 
* Connect '''BAT120''' '''OUT PWR''' to '''RUT955''' Power Socket
 
* Connect '''BAT120''' '''OUT PWR''' to '''RUT955''' Power Socket
  
==Scheme==
+
==Use Case Topology==
 +
[[File:Power Supply BAT120 Use Case v1.png|border|class=tlt-border]]
 +
 
 +
'''Where:'''<br>
 +
'''1.'''Power is being cut from the '''main Power Supply''' for '''BAT120'''<br>
 +
'''2.'''Once '''BAT120''' recognizes that '''IN PWR''' is no longer receiving any Input from '''Main Power supply''', it sends a '''12 VDC''' alarm via its '''OUT PWR'''<br>
 +
'''3.''' '''RUT955''' receives an '''Alarm Signal''' from '''BAT120''' via its '''INPUT PIN 3''', which changes the pin state from '''Low''' to '''High'''<br>
 +
'''4.''' An E-mail and SMS alerts are being sent to the end user<br>
  
 
==Configuration==
 
==Configuration==
Line 27: Line 35:
 
=== Adding e-mail user ===
 
=== Adding e-mail user ===
  
'''1.''' Navigate to '''System -> Administration -> Recipients -> E-mail Users''' type in the Name and add a New Instance
+
'''1.''' Navigate to '''System -> Administration -> Recipients -> E-mail Users (1)''' type in the '''Name (2)''' and '''add (3)''' a New Instance
[[File:Adding New Recipient 1 - Copy.png|center]]
+
[[File:Adding New Recipient RutOS73.png|1056 × 416px|border|class=tlt-border]]
 +
 
 
'''2.''' An advanced configuration window will open, in there, type in the details for your E-mail account. In this example, Gmail account is being used, therefore the following configuration is required:
 
'''2.''' An advanced configuration window will open, in there, type in the details for your E-mail account. In this example, Gmail account is being used, therefore the following configuration is required:
  
Secure Connection: '''on''' <br>
+
[[File:Adding New Recipient RutOS73 2.png|1013 × 440px|border|class=tlt-border]]
SMTP Server: '''smtp.gmail.com''' <br>
+
 
SMTP Server Port: '''587''' <br>
+
# Secure Connection: '''on''' <br>
Credentials: '''on''' <br>
+
# SMTP Server: '''smtp.gmail.com''' <br>
Username: '''e-mail username''' <br>
+
# SMTP Server Port: '''587''' <br>
Password: '''e-mail account password''' <br>
+
# Credentials: '''on''' <br>
Senders email: '''Usually it is the Username''' <br>
+
# Username: '''e-mail username''' <br>
[[File:Adding New Recipient 2 2 2.png|center|Adding New Recipient]]
+
# Password: '''e-mail account password''' <br>
 +
# Senders email: '''Usually it is the Username''' <br>
 +
# '''Save & Apply''' configuration <br>
 +
 
 
'''Note:''' It also might be required to allow '''"less secure apps"''' to access your email account, which is being used to send the letter. This can be changed via your email settings.
 
'''Note:''' It also might be required to allow '''"less secure apps"''' to access your email account, which is being used to send the letter. This can be changed via your email settings.
  
 
=== I/O Juggler actions Configuration ===
 
=== I/O Juggler actions Configuration ===
 +
----
 
'''1.''' Open your '''Routers (RUT955)''' WebUI <br>
 
'''1.''' Open your '''Routers (RUT955)''' WebUI <br>
'''2.''' Navigate to: '''Services -> Input/Output -> I/O Juggler -> Actions -> Add two New Instances''': one with type SMS and another one with type Email. A configuration window will open, you need to select accordingly. <br>
+
'''2.''' Navigate to: '''Services -> Input/Output -> I/O Juggler -> Actions (1) -> Add two New Instances (2)''': one with type SMS and another one with type Email '''(3)'''. A configuration window will open, you need to select accordingly. <br>
'''2.1''' Adding SMS Action:[[File:Add SMS Action.png|center|Add SMS Action]] <br>
+
'''2.1''' Adding SMS Action:[[File:Add SMS Action RutOS73.png|1058 × 424px|border|class=tlt-border]] <br>
 
'''2.2''' Configuring SMS Action: <br>
 
'''2.2''' Configuring SMS Action: <br>
Type: '''SMS''' <br>
+
 
Text Message: '''Your Preferred SMS text''' <br>
+
[[File:SMS Instance RutOS73.png|1010 × 618px|border|class=tlt-border]]
Recipient's phone number: '''Phone number of the recipient''' with the country code, for example, +370... <br>
+
 
Click '''Save & Apply'''. <br><br>
+
# Type: '''SMS''' <br>
 +
# Text Message: '''Your Preferred SMS text''' <br>
 +
# Recipients: '''Number of recipients''' <br>
 +
# Recipient's phone number: '''Phone number of the recipient''' with the country code, for example, +370... <br>
 +
# Click '''Save & Apply'''. <br>
 
'''Note:''' You could send the SMS alerts to '''more than one phone number''' as well, this is called '''Phone Groups'''. To create one, the process is very similar to creating an Email Recipient described above, you would need to navigate to ''' System -> Administration -> Recipients -> Phone Groups'''. Once created, your created Phone groups will be available for selection within our I/O Juggler. <br>
 
'''Note:''' You could send the SMS alerts to '''more than one phone number''' as well, this is called '''Phone Groups'''. To create one, the process is very similar to creating an Email Recipient described above, you would need to navigate to ''' System -> Administration -> Recipients -> Phone Groups'''. Once created, your created Phone groups will be available for selection within our I/O Juggler. <br>
[[File:SMS Instance.png|center|SMS Instance]]
+
 
 
'''2.3''' Adding Email Action: <br>
 
'''2.3''' Adding Email Action: <br>
[[File:Add Email Action.png|center|Add Email Action]]
+
[[File:Add Email Action RutOS73.png|1060 × 429px|border|class=tlt-border]]<br>
 
'''2.4''' Configuring Email Action: <br>
 
'''2.4''' Configuring Email Action: <br>
Type: '''Email''' <br>
+
[[File:Email Instance RutOS73.png|998 × 650px|border|class=tlt-border]]
Subject: '''Your preferred subject''' <br>
+
# Type: '''Email''' <br>
Text message: '''Your preferred text message''' <br>
+
# Subject: '''Your preferred subject''' <br>
Email account: '''Recipient (Created earlier)''' <br>
+
# Text message: '''Your preferred text message''' <br>
Recipient’s email address: '''Recipient’s e-mail address''' <br> <br>
+
# Email account: '''Recipient (Created earlier)''' <br>
[[File:Email Instance.png|center|Email Instance]]
+
# Recipient’s email address: '''Recipient’s e-mail address''' <br>
 +
# '''Save & Apply''' configuration <br>
 +
 
 
'''2.5''' Once finished, your configuration should look like this:
 
'''2.5''' Once finished, your configuration should look like this:
[[File:Actions Configured.png|center|Actions Configured]]
+
[[File:Actions Configured RutOS73.png|1051 × 465px|border|class=tlt-border]]
 
=== I/O Juggler General Configuration===
 
=== I/O Juggler General Configuration===
'''1.''' Navigate to: '''Services -> Input/Output -> General -> Add new Instance -> Select Role Input (3)''' and click on '''Add''' <br>
+
----
[[File:Adding Input.png|center|Adding Input]]
+
'''1.''' Navigate to: '''Services -> Input/Output -> General (1) -> Add new Instance (2) -> Select Role Input (3)''' and click on '''Add (4)''' <br>
 +
[[File:Adding Input RutOS73.png|1065 x 530 px|border|class=tlt-border]] <br>
 
'''2.''' Another configuration window will open, you would need to select: <br>
 
'''2.''' Another configuration window will open, you would need to select: <br>
Enabled: '''on''' <br>
+
[[File:Input Output Input 3 Configuration RutOS73.png|1014 × 311 px|border|class=tlt-border]] <br>
Trigger: '''Rising''' <br>
+
# Enabled: '''on''' <br>
Add actions: '''BAT_SMS''' and '''BAT_Email''' that you have configured previously. <br>
+
# Trigger: '''Rising''' <br>
Click '''Save & Apply'''. <br>
+
# Add actions: '''BAT_SMS''' and '''BAT_Email''' that you have configured previously. <br>
[[File:Input Output Input 3 Configuration.png|center|Input Output Input 3 Configuration]] <br>
+
# Click '''Save & Apply'''. <br>
'''3.''' Navigate to '''Services -> Input/Output -> General -> General drop-down menu and enable I/O Juggler''' and click on '''Save & Apply''' <br>
 
[[File:Enabling Juggler.png|center|Enabling Juggler]]
 
 
==Verification==
 
==Verification==
 
Once Configured according to this example, in the case of RUT955 (or any other Teltonika Networks Router/Gateway) losing connection to its main Power Source '''BAT120''' will take over and will forward an up to '''12V Alarm Signal''' to '''INPUT PIN 3'''.<br>
 
Once Configured according to this example, in the case of RUT955 (or any other Teltonika Networks Router/Gateway) losing connection to its main Power Source '''BAT120''' will take over and will forward an up to '''12V Alarm Signal''' to '''INPUT PIN 3'''.<br>
 
This Alarm Signal will work as a trigger for I/O Juggler and you should receive alarms similar to the ones bellow. <br>
 
This Alarm Signal will work as a trigger for I/O Juggler and you should receive alarms similar to the ones bellow. <br>
 
'''SMS Alert:'''<br>
 
'''SMS Alert:'''<br>
[[File:SMS Alert New.png|center|SMS Alert]]<br>
+
[[File:SMS Alert New.png|border|class=tlt-border]]<br>
 
'''Email Alert:'''<br>
 
'''Email Alert:'''<br>
[[File:Email Alert.png|center|Email Alert]] <br>
+
[[File:Email Alert.png|1102px|border|class=tlt-border]] <br>
 
==See Also==
 
==See Also==
 
* https://wiki.teltonika-networks.com/view/RUT955_Powering_Options
 
* https://wiki.teltonika-networks.com/view/RUT955_Powering_Options
 
* https://wiki.teltonika-networks.com/view/RUT955_Input/Output#I.2FO_Juggler
 
* https://wiki.teltonika-networks.com/view/RUT955_Input/Output#I.2FO_Juggler

Latest revision as of 11:38, 27 March 2023

The information in this page is updated in accordance with 00.07.03.3 firmware version .

Introduction

This article provides a guide on how to configure SMS and Email alerts using I/O Juggler on Teltonika Networks Routers and Gateways when the main power supply is being cut and the device switches onto the Backup Power from - BAT120.


  • First you want to make sure that you have ADVANCED mode enabled. This will allow you to choose from a larger variety of settings.

Networking rutx manual webui basic advanced mode.gif


Prerequisites

For this particular configuration you will need:

  • One of Teltonika Networks Routers or Gateways (RUT955 is being used in the example)
  • BAT120
  • 2 SIM card, that allows sending SMS messages(One used by RUT955 and one by the client at the receiving end)
  • 2 Email accounts (Two accounts are being used in this example: one Google Mail and one Teltonika)

Preparation

  • Connect Power Supply to BAT120 IN PWR
  • Connect BAT120 OUT PWR to RUT955 Power Socket

Use Case Topology

Power Supply BAT120 Use Case v1.png

Where:
1.Power is being cut from the main Power Supply for BAT120
2.Once BAT120 recognizes that IN PWR is no longer receiving any Input from Main Power supply, it sends a 12 VDC alarm via its OUT PWR
3. RUT955 receives an Alarm Signal from BAT120 via its INPUT PIN 3, which changes the pin state from Low to High
4. An E-mail and SMS alerts are being sent to the end user

Configuration

Adding e-mail user

1. Navigate to System -> Administration -> Recipients -> E-mail Users (1) type in the Name (2) and add (3) a New Instance 1056 × 416px

2. An advanced configuration window will open, in there, type in the details for your E-mail account. In this example, Gmail account is being used, therefore the following configuration is required:

1013 × 440px

  1. Secure Connection: on
  2. SMTP Server: smtp.gmail.com
  3. SMTP Server Port: 587
  4. Credentials: on
  5. Username: e-mail username
  6. Password: e-mail account password
  7. Senders email: Usually it is the Username
  8. Save & Apply configuration

Note: It also might be required to allow "less secure apps" to access your email account, which is being used to send the letter. This can be changed via your email settings.

I/O Juggler actions Configuration


1. Open your Routers (RUT955) WebUI
2. Navigate to: Services -> Input/Output -> I/O Juggler -> Actions (1) -> Add two New Instances (2): one with type SMS and another one with type Email (3). A configuration window will open, you need to select accordingly.
2.1 Adding SMS Action:1058 × 424px
2.2 Configuring SMS Action:

1010 × 618px

  1. Type: SMS
  2. Text Message: Your Preferred SMS text
  3. Recipients: Number of recipients
  4. Recipient's phone number: Phone number of the recipient with the country code, for example, +370...
  5. Click Save & Apply.

Note: You could send the SMS alerts to more than one phone number as well, this is called Phone Groups. To create one, the process is very similar to creating an Email Recipient described above, you would need to navigate to System -> Administration -> Recipients -> Phone Groups. Once created, your created Phone groups will be available for selection within our I/O Juggler.

2.3 Adding Email Action:
1060 × 429px
2.4 Configuring Email Action:
998 × 650px

  1. Type: Email
  2. Subject: Your preferred subject
  3. Text message: Your preferred text message
  4. Email account: Recipient (Created earlier)
  5. Recipient’s email address: Recipient’s e-mail address
  6. Save & Apply configuration

2.5 Once finished, your configuration should look like this: 1051 × 465px

I/O Juggler General Configuration


1. Navigate to: Services -> Input/Output -> General (1) -> Add new Instance (2) -> Select Role Input (3) and click on Add (4)
1065 x 530 px
2. Another configuration window will open, you would need to select:
1014 × 311 px

  1. Enabled: on
  2. Trigger: Rising
  3. Add actions: BAT_SMS and BAT_Email that you have configured previously.
  4. Click Save & Apply.

Verification

Once Configured according to this example, in the case of RUT955 (or any other Teltonika Networks Router/Gateway) losing connection to its main Power Source BAT120 will take over and will forward an up to 12V Alarm Signal to INPUT PIN 3.
This Alarm Signal will work as a trigger for I/O Juggler and you should receive alarms similar to the ones bellow.
SMS Alert:
SMS Alert New.png
Email Alert:
Email Alert.png

See Also