The timers of the icom Data Suite are powerful tools for realising many applications.

Situation

The integrity of a room requires that access to this room is open for a limited time only.

Solution

A door switch is installed to signal an open access door. A supervisor will be notified via SMS if the door is open for more than three minutes without interruption. Moreover, the time the door is open is to be accumulated and the supervisor will get a notification if the door has been open for more than 15 minutes a day. This counter will be reset daily at midnight. The functionality of the monitoring function will be verified to the supervisor by an alive message every three hours.

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. The door switch is connected to input 2.1 of the Smart Device. Switch logic for this example is that the switch closes if the door is opened.

  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 the supervisor

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

  5. Click on Save settings.

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

    • Description: 3 minutes exceeded SMS

    • Modem: lte2

    • Recipient: select the supervisor as contact

    • Text: door is open for more than three minutes w/o interruption

  7. Click on Save settings.

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

    • Description: 15 minutes exceeded SMS

    • Modem: lte2

    • Recipient: select the supervisor as contact

    • Text: door is open for more than 15 minutes today

  9. Click on Save settings.

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

    • Description: alive SMS

    • Modem: lte2

    • Recipient: select the supervisor as contact

    • Text: the monitoring function is working properly

  11. Click on Save settings.

  12. In the Datapoints → Timer menu, add a new timer () and edit it ():

    • Description: 3 minute countdown

    • Type: Countdown, triggered after 3 minutes

  13. Click on Save settings.

  14. In the Datapoints → Timer menu, add a new timer () and edit it ():

    • Description: stopwatch for temporary open time

    • Type: Stopwatch

  15. Click on Save settings.

  16. In the Datapoints → Timer menu, add a new timer () and edit it ():

    • Description: stopwatch for total open time

    • Type: Stopwatch

  17. Click on Save settings.

  18. In the Datapoints → Timer menu, add a new timer () and edit it ():

    • Description: daily reset timer

    • Type: Fix set time, triggered every day at 00:00 (midnight)

  19. Click on Save settings.

  20. In the Datapoints → Timer menu, add a new timer () and edit it ():

    • Description: 3 hours interval

    • Type: Interval, triggered every 3 hours

  21. Click on Save settings.

  22. In the Events menu, add a new event () and edit it (): [3]

    • Description: start temporary open door timer

    • Event: Digital data point has changed

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

    • Action: Start or stop timer

    • Timer: start stopwatch for temporary open time

  23. Click on Save settings.

  24. In the Events menu, add a new event () and edit it (): [5]

    • Description: stop and reset temporary open door timer

    • Event: Digital data point has changed

    • Data point: input1 and Changed to HIGH (boolean 1)

    • Action: Start or stop timer

    • Timer: stop and reset stopwatch for temporary open time

  25. Click on Save settings.

  26. In the Events menu, add a new event () and edit it (): [6]

    • Description: send 3 minutes exceeded SMS

    • Event: Stopwatch timer exceeds value

    • Stopwatch timer: stopwatch for temporary open time exceeds 3 minutes

    • Action: Send message

    • Send message: 3 minutes exceeded SMS

  27. Click on Save settings.

  28. In the Events menu, add a new event () and edit it (): [7]

    • Description: start total open door timer

    • Event: Digital data point has changed

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

    • Action: Start or stop timer

    • Timer: start stopwatch for total open time

  29. Click on Save settings.

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

    • Description: pause total open door timer

    • Event: Digital data point has changed

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

    • Action: Start or stop timer

    • Timer: pause stopwatch for total open time

  31. Click on Save settings.

  32. In the Events menu, add a new event () and edit it (): [9]

    • Description: send 15 minutes exceeded SMS

    • Event: Stopwatch timer exceeds value

    • Stopwatch timer: stopwatch for total open time exceeds 15 minutes

    • Action: Send message

    • Send message: 15 minutes exceeded SMS

  33. Click on Save settings.

  34. In the Events menu, add a new event () and edit it (): [10]

    • Description: reset total open door timer

    • Event: Timer expired

    • Timer: daily reset time

    • Action: Start or stop timer

    • Timer: stop and reset stopwatch for total open time

  35. Click on Save settings.

  36. In the Events menu, add a new event () and edit it (): [11]

    • Description: send alive SMS

    • Event: Timer expired

    • Timer: 3 hours interval

    • Action: Send message

    • Send message: alive SMS

  37. Click on Save settings.

  38. Activate the profile ().

  39. Open the door (or close Input 1) to check whether the SMS are 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

datapoints.timer.timer.add
datapoints.timer.timer[1].name=timer1
datapoints.timer.timer[1].active=1
datapoints.timer.timer[1].description=3 minute countdown
datapoints.timer.timer[1].type=countdown
datapoints.timer.timer[1].countdown_mm=3

datapoints.timer.timer.add
datapoints.timer.timer[2].name=timer2
datapoints.timer.timer[2].active=1
datapoints.timer.timer[2].description=stopwatch for temporary open time
datapoints.timer.timer[2].type=stopwatch

datapoints.timer.timer.add
datapoints.timer.timer[3].name=timer3
datapoints.timer.timer[3].active=1
datapoints.timer.timer[3].description=stopwatch for total open time
datapoints.timer.timer[3].type=stopwatch

datapoints.timer.timer.add
datapoints.timer.timer[4].name=timer4
datapoints.timer.timer[4].active=1
datapoints.timer.timer[4].description=daily reset time
datapoints.timer.timer[4].type=time
datapoints.timer.timer[4].time_hh=00
datapoints.timer.timer[4].time_mm=00
datapoints.timer.timer[4].time_monday=1
datapoints.timer.timer[4].time_tuesday=1
datapoints.timer.timer[4].time_wednesday=1
datapoints.timer.timer[4].time_thursday=1
datapoints.timer.timer[4].time_friday=1
datapoints.timer.timer[4].time_saturday=1
datapoints.timer.timer[4].time_sunday=1

datapoints.timer.timer.add
datapoints.timer.timer[5].name=timer5
datapoints.timer.timer[5].active=1
datapoints.timer.timer[5].description=3 hours interval
datapoints.timer.timer[5].type=interval
datapoints.timer.timer[5].interval_hh=3

messages.contacts.contact.add
messages.contacts.contact[1].active=1
messages.contacts.contact[1].name=contact1
messages.contacts.contact[1].real_name=Supervisor
messages.contacts.contact[1].email_address=
messages.contacts.contact[1].phone_number=+4917xxxxxxxx

messages.sms.sms.add
messages.sms.sms[1].active=1
messages.sms.sms[1].name=sms1
messages.sms.sms[1].description=3 minutes exceeded SMS
messages.sms.sms[1].recipient=contact1
messages.sms.sms[1].modem=lte2
messages.sms.sms[1].text=-----BEGIN text-----door is open for more than three minutes w/o interruption-----END text-----

messages.sms.sms.add
messages.sms.sms[2].active=1
messages.sms.sms[2].name=sms2
messages.sms.sms[2].description=15 minutes exceeded SMS
messages.sms.sms[2].recipient=contact1
messages.sms.sms[2].modem=lte2
messages.sms.sms[2].text=-----BEGIN text-----door is open for more than 15 minutes today-----END text-----

messages.sms.sms.add
messages.sms.sms[3].active=1
messages.sms.sms[3].name=sms3
messages.sms.sms[3].description=alive SMS
messages.sms.sms[3].recipient=contact1
messages.sms.sms[3].modem=lte2
messages.sms.sms[3].text=-----BEGIN text-----the monitoring function is working properly-----END text-----

events.event.add
events.event[1].active=1
events.event[1].description=start temporary open door timer
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_timer
events.event[1].event_action_timer_name=timer2
events.event[1].event_action_timer_change=start

events.event.add
events.event[2].active=1
events.event[2].description=stop and reset temporary open door timer
events.event[2].event_type=ev_digital
events.event[2].event_digital_datapoint=input1
events.event[2].event_digital_change=to_one
events.event[2].event_digital_initial_check=0
events.event[2].action_type=act_timer
events.event[2].event_action_timer_name=timer2
events.event[2].event_action_timer_change=stop

events.event.add
events.event[3].active=1
events.event[3].description=send 3 minutes exceeded SMS
events.event[3].event_type=ev_stopwatch
events.event[3].event_stopwatch_name=timer2
events.event[3].event_stopwatch_mm=3
events.event[3].action_type=act_message
events.event[3].action_message=sms1

events.event.add
events.event[4].active=1
events.event[4].description=start total open door timer
events.event[4].event_type=ev_digital
events.event[4].event_digital_datapoint=input1
events.event[4].event_digital_change=to_zero
events.event[4].event_digital_initial_check=0
events.event[4].action_type=act_timer
events.event[4].event_action_timer_name=timer3
events.event[4].event_action_timer_change=start

events.event.add
events.event[5].active=1
events.event[5].description=pause total open door timer
events.event[5].event_type=ev_digital
events.event[5].event_digital_datapoint=input1
events.event[5].event_digital_change=to_one
events.event[5].event_digital_initial_check=0
events.event[5].action_type=act_timer
events.event[5].event_action_timer_name=timer3
events.event[5].event_action_timer_change=pause

events.event.add
events.event[6].active=1
events.event[6].description=send 15 minutes exceeded SMS
events.event[6].event_type=ev_stopwatch
events.event[6].event_stopwatch_name=timer3
events.event[6].event_stopwatch_mm=15
events.event[6].event_stopwatch_ss=
events.event[6].action_type=act_message
events.event[6].action_message=sms2

events.event.add
events.event[7].active=1
events.event[7].description=reset total open door timer
events.event[7].event_type=ev_timer
events.event[7].event_timer_name=timer4
events.event[7].action_type=act_timer
events.event[7].event_action_timer_name=timer3
events.event[7].event_action_timer_change=stop

events.event.add
events.event[8].active=1
events.event[8].description=send alive SMS
events.event[8].event_type=ev_timer
events.event[8].event_timer_name=timer5
events.event[8].action_type=act_message
events.event[8].action_message=sms3

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. This event starts the timer that counts the temporary open time of the door as soon as it is opened.
4. 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.
5. This event stops and rests the timer that counts the temporary open time of the door as soon as it is closed again.
6. This event sends the notification SMS to the supervisor if the timer that counts the temporary open time of the door exceeds 3 minutes.
7. This event starts the timer that counts the total open time of the door as soon as it is opened.
8. This event pauses the timer that counts the total open time of the door as soon as it is closed again.
9. This event sends the notification SMS to the supervisor if the timer that counts the total open time of the door exceeds 15 minutes.
10. This event resets the timer that counts the total open time of the door every midnight.
11. This event sends the alive SMS to the supervisor every 3 hours to verify the functionality of the monitoring function.