- 01 Oct 2024
- Print
- PDF
Using Timers for Alarming Applications
- Updated on 01 Oct 2024
- Print
- PDF
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.
Open the web interface of the icom Data Suite using a browser:
192.168.1.10 or ids.local (default)
User name: insys (default)
Password: icom (default)
In the Data points → Digital I/Os menu under Inputs, add a new input ():
Description: Input 2.1
Input: 2.1
Click on Save settings.
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
Please note!
It is recommended to enter the phone number in international notation in the form +491701234567.
Click on Save settings.
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
Click on Save settings.
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
Click on Save settings.
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
Click on Save settings.
In the Datapoints → Timer menu, add a new timer () and edit it ():
Description: 3 minute countdown
Type: Countdown, triggered after 3 minutes
Click on Save settings.
In the Datapoints → Timer menu, add a new timer () and edit it ():
Description: stopwatch for temporary open time
Type: Stopwatch
Click on Save settings.
In the Datapoints → Timer menu, add a new timer () and edit it ():
Description: stopwatch for total open time
Type: Stopwatch
Click on Save settings.
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)
Click on Save settings.
In the Datapoints → Timer menu, add a new timer () and edit it ():
Description: 3 hours interval
Type: Interval, triggered every 3 hours
Click on Save settings.
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)
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
Click on Save settings.
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
Click on Save settings.
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
Click on Save settings.
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
Click on Save settings.
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
Click on Save settings.
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
Click on Save settings.
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
Click on Save settings.
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
Click on Save settings.
Activate the profile ().
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
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