Situation

The input of an INSYS Smart Device is to be monitored by the icom Data Suite and an SMS is to be dispatched as soon as the input is closed.
This functionality is often used in alarming applications.

Solution

An event will be defined that triggers an action as soon as the configured input changes its state. The action will then dispatch a pre-configured message notifying the recipient about the state change of the input.

It is prerequisite that you have access to the web interface of the icom Data Suite. The Smart Device must be functional for SMS dispatch. A switch or similar device is connected to input 2.1 of the Smart Device.

  1. Open the web interface of the icom Data Suite using a browser:

  2. In the Data points → Digital I/Os menu under Inputs, add a new input ():

    • Description: Input 2.1

    • Input: 2.1

  3. Click on Save settings.

  4. In the Messages → Contacts menu, add a new contact () and edit it ():

    • Real name: enter the name of your SMS recipient

    • Phone number: enter the mobile phone number of your SMS recipient [2]

  5. Click on Save settings.

  6. In the Messages → SMS menu, add a new message () and edit it ():

    • Description: Notification SMS

    • Modem: lte2

    • Recipient: select above added contact

    • Text: enter the desired SMS content

  7. Click on Save settings.

  8. In the Events menu, add a new event () and edit it ():

    • Description: Notification SMS on input 2.1 close

    • Event: Digital data point has changed

    • Data point: input1 and Changed to LOW (boolean 0) [3]

    • Action: Send message

    • Send message: select above added SMS message

  9. Click on Save settings.

  10. Activate the profile ().

  11. Close Input 1 to check whether the SMS is sent as intended.

Troubleshooting

  • Refer to the installation manual of the Smart Device and check the connection and logic of the input used.

  • In order to be able to send an SMS by the icom Data Suite, the modem in the router must know the SMS center number of the provider. This is usually read out from the SIM card. If no number is stored on the SIM card, this must be entered in the Interfaces → Slot 2: LTE menu in the web interface of the router.

  • In order to be able to receive an SMS by the icom Data Suite, incoming SMS must be forwarded to the container. The checkbox Forward SMS to containers must be checked in the Administration → Container menu in the web interface of the router.

Resources

The following ASCII configuration can be taken over using copy & paste. It must be observed that the individual parameters need to be adapted to the own application. Correct numbering must be observed for numbered parameters. Moreover, it must be observed that no existing parameters with the same number will be overwritten. A proper functionality can only be ensured if the opened profile has been created from default settings before.

ASCII configuration
datapoints.digital_ios.inputs.input.add
datapoints.digital_ios.inputs.input[1].name=input1
datapoints.digital_ios.inputs.input[1].active=1
datapoints.digital_ios.inputs.input[1].description=Input 2.1
datapoints.digital_ios.inputs.input[1].input=2.1

messages.contacts.contact.add
messages.contacts.contact[1].active=1
messages.contacts.contact[1].name=contact1
messages.contacts.contact[1].real_name=Real Name
messages.contacts.contact[1].email_address=
messages.contacts.contact[1].phone_number=+4917xxxxxxxxx

messages.sms.sms.add
messages.sms.sms[1].active=1
messages.sms.sms[1].name=sms1
messages.sms.sms[1].description=Notification SMS
messages.sms.sms[1].recipient=contact1
messages.sms.sms[1].modem=lte2
messages.sms.sms[1].text=-----BEGIN text-----Input 2.1 has been closed-----END text-----

events.event.add
events.event[1].active=1
events.event[1].description=Notification SMS on input 2.1 close
events.event[1].event_type=ev_digital
events.event[1].event_digital_datapoint=input1
events.event[1].event_digital_change=to_zero
events.event[1].event_digital_initial_check=0
events.event[1].action_type=act_message
events.event[1].action_message=sms1

ASCII configuration download (right-click and save as)

Back to the Configuration Guides for the icom Data Suite

Back to overview

1. This IP address and host name only apply in case of a standard default installation.
2. It is recommended to enter the phone number in international notation in the form +491701234567.
3. Please note that the inputs of the router may have a different logic. This applies only to input 1 of a plug-in card with power supply.