--- title: "Using Timers for Alarming Applications - icom Data Suite" slug: "using-timers-for-alarming-applications-en" updated: 2024-10-01T13:16:56Z published: 2024-10-01T13:16:56Z canonical: "docs.insys-icom.com/using-timers-for-alarming-applications-en" --- > ## Documentation Index > Fetch the complete documentation index at: https://docs.insys-icom.com/llms.txt > Use this file to discover all available pages before exploring further. # Using Timers for Alarming Applications - icom Data Suite 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 router must be functional for SMS dispatch. The door switch is connected to input 2.1 of the router. 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: - [192.168.1.10](https://192.168.1.10) or [ids.local](https://ids.local) (default) - *User name*: insys (default) - *Password*: icom (default) 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 > [!NOTE] > Please note! > > It is recommended to enter the phone number in international notation in the form *+491701234567*. 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, which starts the timer that counts the temporary open time of the door as soon as it is opened, () and edit it (): - *Description*: start temporary open door timer - *Event*: *Digital data point has changed* - *Data point*: *input1* and *Changed to LOW (boolean 0)* > [!NOTE] > Please note! > > The inputs of the router may have a different logic. This applies only to input 1 of a plug-in card with power supply. - *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, which stops and rests the timer that counts the temporary open time of the door as soon as it is closed again, () and edit it (): - *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, which sends the notification SMS to the supervisor if the timer that counts the temporary open time of the door exceeds 3 minutes, () and edit it (): - *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, which starts the timer that counts the total open time of the door as soon as it is opened, () and edit it (): - *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, which pauses the timer that counts the total open time of the door as soon as it is closed again, () and edit it (): - *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, which sends the notification SMS to the supervisor if the timer that counts the total open time of the door exceeds 15 minutes, () and edit it (): - *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, which resets the timer that counts the total open time of the door every midnight, () and edit it (): - *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, which sends the alive SMS to the supervisor every 3 hours to verify the functionality of the monitoring function, () and edit it (): - *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 router 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 ```plaintext 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)](https://docs.insys-icom.de/assets/configs/cg_ids_using_timers.txt)