Situation
A connected device is supposed to trigger the sending of a text message (SMS) by activating an input on the router. This is intended to send an alert to a cell phone.
.png)
Solution
An event is defined that triggers an action as soon as the configured input is activated. The action then sends a preconfigured message that notifies the recipient of the event.
It is assumed that you have access to the router's user interface and that the router has Internet access. To ensure this, we recommend setting up the router as described in the Quick Installation Guide.
It is also assumed that the router's input is correctly connected to the output of the signalling device.Please note the different digital inputs on our routers!
The various routers and plug-in cards (MRcards) from INSYS icom have different types of digital inputs that vary in their logic and wiring:
LOW-active digital inputs
HIGH-active digital inputs
configurable digital inputs/outputs (LOW-active)
Depending on the input, different wiring and a different configuration of the Digital Input parameter of the event are required. The differences are detailed in the Differences in the Inputs section below.
You can find the exact specifications for the inputs in the installation manual for the respective router.
The following configuration example applies to a MIRO router with a configurable input/output that is LOW-active.
Open the user interface of the router: https://insys.icom
The following configuration is only necessary if you are using a configurable input/output on your router:
Click on the Ports → I/O page on in the line of the IO you want to use and configure it as Input..png)
Click on SUBMIT.
Click on the Events → Contacts page on and add the recipient of the text message as contact:
Name: enter a unique and descriptive name for the contact
Phone number: enter the cell phone number where you want to receive the message.png)
Click on SUBMIT.
Click on the Events → Messages page on and add the alarm SMS as message:
Description: enter a unique description for the alarm text message
Type: SMS
Recipient: select the previously added contact
Message: enter the text of the SMS messageOptionally, include current values in the message text!
You can include CLI commands in messages, which are then executed when the message is sent, and the command's return value is inserted into the message text. For example, the following message text inserts the time the message was triggered as a timestamp:
The alarm has been triggered at$cli(status.sysdetail.system.date)!Modem: select the cellular modem used in the router
.png)
Click on SUBMIT.
Click on the Events → Events page on and add a new event that sends the message to the recipient upon activating the input:
Description: enter a unique description for the event
Event: Digital input has changed
Digital input: select the digital input being used and the Changed to LOW option (this triggers the event when the input is closed; if the Check for event upon start-up checkbox is selected, the event is triggered even if the input is already closed when the router starts up)Is the input used HIGH-active or LOW-active?
Refer to the Differences in the Inputs section for the correct configuration of this parameter!
How are pulse sequences detected?
It is also possible to trigger the event with a sequence of short pulses at the input. Each pulse in the sequence must last at least 100 ms. A pulse sequence (1–99 pulses) is considered complete when the level remains unchanged for more than 2 seconds.
Action: Send message
Message: select the previously added message.png)
Click on SUBMIT.
Activate the profile with a click on ACTIVATE PROFILE .
Damit haben Sie Ihren Router so konfiguriert, dass er mit dem Schließen des Eingangs eine SMS an ein Mobiltelefon versendet.
Differences in the Inputs
LOW-active digital inputs
The following routers and plug-in cards feature LOW-active digital inputs (the I/Os (inputs/outputs) must be configured as inputs)::
MIRO
MOROS.neo (digital inputs IO1, IO2, DIO1 and DIO2)
MRX.neo (basic card)
MRcard MSI.5G (digital inputs/outputs IO1 and IO2)
MRcard MSI.4G (digital inputs/outputs IO1 and IO2)
MRcard PL (digitale input IN1)
MRcard PD (digital input IN1)
MRcard Fiber (digital input IN1)
MRcard PL450 (digital input IN1)
MRcard PL450D (digital input IN1)
MRcard PM (digital input IN1)
MRcard PLS (digital input IN1)
For LOW-active digital inputs, the input is activated by connecting it to GND, as shown in the following figure:
.png)
For LOW-active digital inputs, Changed to LOW must be selected when configuring the event:
.png)
HIGH-active digital inputs
The following routers and plug-in cards feature HIGH-active digital inputs:
MOROS.neo-E.4G (digitale input DI)
MOROS.neo-EW.4G (digitale input DI)
ECR
SCR
MRcard MSI.5G (digitale input DI)
MRcard MSI.4G (digitale input DI)
MRcard PL (digitale input IN2)
MRcard PD (digitale input IN2)
MRcard SI (digitale inputs IN1 and IN2)
MRcard IO (digitale inputs D!1 through DI4)
MRcard Fiber (digitale input IN2)
MRcard PL450 (digitale input IN2)
MRcard PL450D (digitale input IN2)
MRcard PM (digitale input IN2)
MRcard PLS (digitale input IN2)
For HIGH-active digital inputs, the input is activated by connecting it to the supply voltage, as shown in the following figure:
.png)
For HIGH-active digital inputs, Changed to HIGH must be selected when configuring the event:
.png)
Result Testing
Activate the input on the router and verify that you are receiving the text message correctly.
Troubleshooting
Check on the Status → Log view page the Events log for possible hints.
Try to send an SMS to the recipient on the System → Debugging page using the action Send SMS.
Make sure that the input is activated (closed) for at least one (1) second so that it is recognized as an event.