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

From Teltonika Networks Wiki
(Created page with "==Introduction== This article provides a guide on how to configure '''SMS''' and '''Email''' alerts using '''I/O Juggler''' on '''Teltonika Networks''' Routers and Gateways wh...")
 
No edit summary
 
(10 intermediate revisions by 4 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.08'''] 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'''.


----
----
* First you want to make sure that you have '''ADVANCED mode''' enabled. This will allow you to choose from a larger variety of settings.
If you're having trouble finding this page or some of the parameters described here on your device's WebUI, you should turn on '''"Advanced WebUI" mode.''' You can do that by clicking the "Advanced" button, located at the top of the WebUI.
[[File:Networking rutx manual webui basic advanced mode v1.gif|border|class=tlt-border]]
[[File:Networking_rutos_manual_webui_basic_advanced_mode_75.gif|border|center|class=tlt-border|1102x93px]]
----
----


Line 13: Line 14:
* One of Teltonika Networks '''Routers''' or '''Gateways''' ('''RUT955''' is being used in the example)
* One of Teltonika Networks '''Routers''' or '''Gateways''' ('''RUT955''' is being used in the example)
* '''BAT120'''
* '''BAT120'''
* '''2 SIM card''', that allows sending SMS messages(One used by RUT955 and one by the client at the receiving end)
* '''2 SIM card''', that allows sending SMS messages(One used by RUT956 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)
* '''2 Email accounts''' (Two accounts are being used in this example: one Google Mail and one Teltonika)


Line 19: Line 20:


* Connect Power Supply to '''BAT120''' '''IN PWR'''
* Connect Power Supply to '''BAT120''' '''IN PWR'''
* Connect '''BAT120''' '''OUT PWR''' to '''RUT955''' Power Socket
* Connect '''BAT120''' '''OUT PWR''' to '''RUT956''' Power Socket
 
==Use Case Topology==
[[File:708877_1.png|border|class=tlt-border]]
 
'''Scenario:'''<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.''' '''RUT956''' 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 25: 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:Bat120_trigger_sms_email_7.8_add_email.png|1100px|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:Bat120_trigger_sms_email_7.8_add_email_config.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>
----
'''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>
'''1.''' Open your '''Routers (RUT956)''' WebUI <br>
'''2.1''' Adding SMS Action:[[File:Add SMS Action.png|center|Add SMS Action]] <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:<br>[[File:Bat120_trigger_sms_email_7.8_add_action.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:Bat120_trigger_sms_email_7.8_add_action_config.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:Bat120_trigger_sms_email_7.8_add_action_email.png|1100px|border|class=tlt-border]]<br>
'''2.4''' Configuring Email Action: <br>
'''2.4''' Configuring Email Action: <br>
Type: '''Email''' <br>
[[File:Bat120_trigger_sms_email_7.8_add_action_email_config.png|1100px|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:Bat120_trigger_sms_email_7.8_overall_actions.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:Bat120_trigger_sms_email_7.8_add_io.png|1100px|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:Bat120_trigger_sms_email_7.8_add_io_config.png|1100px|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 08:23, 6 August 2024

The information in this page is updated in accordance with 00.07.08 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.


If you're having trouble finding this page or some of the parameters described here on your device's WebUI, you should turn on "Advanced WebUI" mode. You can do that by clicking the "Advanced" button, located at the top of the WebUI.


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 RUT956 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 RUT956 Power Socket

Use Case Topology

Scenario:
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. RUT956 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

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 (RUT956) 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:

2.4 Configuring Email Action:

  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)

2. Another configuration window will open, you would need to select:

  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:

Email Alert:

See Also