clockWeekAlarm (Functionblock)

clockWeekAlarm is a convenient way of setting an alarm at a specific time on a specific weekday.

Input:

enable : BOOL

The timer will be initialized and started on the leading edge of the enable input.

dayofweek : SINT (1 .. 7)

The day of the week the alarm should trigger. 1 is Monday, 7 is Sunday.

hour: SINT (0 .. 23)

The hour for the alarm.

minute : SINT (0 .. 59)

The minute for the alarm.

second : SINT (0 .. 59)

The second for the alarm

Output:

q : BOOL

When the alarm time is reached, q will be TRUE.

Declaration:

FUNCTION_BLOCK clockWeekAlarm;
VAR_INPUT
  enable   : BOOL R_EDGE;    
  DayOfWeek : SINT;   // 01..31    
  Hour     : SINT;   // 00..23    
  Minute   : SINT;   // 00..59    
  Second   : SINT;  // 00..59    
END_VAR;
VAR_OUTPUT
  q         : BOOL;    
END_VAR;

Example:

INCLUDE rtcu.inc
 
VAR
  Alarm_1 : clockWeekAlarm;
  Alarm_2 : clockWeekAlarm;
  Alarm_3 : clockWeekAlarm;
  Alarm_4 : clockWeekAlarm;
END_VAR;
 
PROGRAM test;
 
Alarm_1(enable:=TRUE, DayOfWeek:=1, Hour:=18);
Alarm_2(enable:=TRUE, DayOfWeek:=2, Hour:=18);
Alarm_3(enable:=TRUE, DayOfWeek:=4, Hour:=18);
Alarm_4(enable:=TRUE, DayOfWeek:=6, Hour:=18);
 
BEGIN
  Alarm_1();
  Alarm_2();
  Alarm_3();
  Alarm_4();
 
  IF Alarm_1.q THEN
    DebugMsg(message:="Alarm 1");
  END_IF;
  IF Alarm_2.q THEN
    DebugMsg(message:="Alarm 2");
  END_IF;
  IF Alarm_3.q THEN
    DebugMsg(message:="Alarm 3");
  END_IF;
  IF Alarm_4.q THEN
    DebugMsg(message:="Alarm 4");
  END_IF;
END;
 
END_PROGRAM;