accAccelerationEvent (Functionblock)

accAccelerationEvent returns the information of an acceleration event.

Note that the information is only valid after an "Acceleration" event is raised; the event will be removed when this function block is called.

An "Acceleration" event is raised when the acceleration matches the parameters set when monitoring was enabled.

Input:

None.

Output:

XAbove   : BOOL

Was x-axis above threshold for the duration.

XBelow   : BOOL

Was x-axis below threshold for the duration.

YAbove   : BOOL

Was y-axis above threshold for the duration.

YBelow   : BOOL

Was y-axis below threshold for the duration.

ZAbove   : BOOL

Was z-axis above threshold for the duration.

ZBelow   : BOOL

was z-axis below threshold for the duration.

X : DINT

Last x-axis reading before event (mg).

Y : DINT

Last y-axis reading before event (mg).

Z : DINT

Last z-axis reading before event (mg).

Ready : BOOL

Indicates whether event was removed and data updated.

Declaration:

FUNCTION_BLOCK accAccelerationEvent;
VAR_OUTPUT
  X           : DINT;
  Y           : DINT;
  Z           : DINT;
  XAbove      : BOOL;
  XBelow      : BOOL;
  YAbove      : BOOL;
  YBelow      : BOOL;
  ZAbove      : BOOL;
  ZBelow      : BOOL;
  Ready       : BOOL;
END_VAR;

Example:

INCLUDE rtcu.inc
 
VAR
  acc : accAccelerationEvent;
END_VAR;
 
FUNCTION ReadAccEvent;
  acc();
  IF acc.ready THEN
    DebugMsg(message := "*** acceleration event received ***");
    DebugFmt(message := "-x=\4", v4 := acc.x);
    DebugFmt(message := "-y=\4", v4 := acc.y);
    DebugFmt(message := "-z=\4", v4 := acc.z);
  END_IF;
END_FUNCTION;
 
THREAD_BLOCK accMonitor;
VAR
  event : INT := 0;
END_VAR;
 
WHILE event <> -1 DO
  event := accWaitEvent(timeout := -1);
  CASE event OF
     ...
    7: ReadAccEvent();
     ...
  END_CASE;
END_WHILE;
END_THREAD_BLOCK;