1,108
edits
Changes
Template:SMS and Email alerts Triggered by BAT120 (view source)
Revision as of 11:38, 27 March 2023
, 11:38, 27 March 2023no edit summary
<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'''.
* 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==
=== 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:
[[File:Adding New Recipient RutOS73 2.png|1013 × 440px|border|class=tlt-border]]
# Secure Connection: '''on''' <br>
# SMTP Server: '''smtp.gmail.com''' <br>
# SMTP Server Port: '''587''' <br>
# Credentials: '''on''' <br>
# Username: '''e-mail username''' <br>
# 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>
[[File:SMS Instance RutOS73.png|1010 × 618px|border|class=tlt-border]]
# 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>
'''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>
[[File:Email Instance RutOS73.png|998 × 650px|border|class=tlt-border]]
# Type: '''Email''' <br>
# Subject: '''Your preferred subject''' <br>
# Text message: '''Your preferred text message''' <br>
# Email account: '''Recipient (Created earlier)''' <br>
# 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>
[[File:Input Output Input 3 Configuration RutOS73.png|1014 × 311 px|border|class=tlt-border]] <br>
# Enabled: '''on''' <br>
# Trigger: '''Rising''' <br>
# Add actions: '''BAT_SMS''' and '''BAT_Email''' that you have configured previously. <br>
# Click '''Save & Apply'''. <br>
==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
