msVibrationSetWakeup (Function)

Configure the system to wake from suspend on detection of vibration. See pmSuspend.

Note:

The Motion Sensor interface must be opened with msOpen before calling this function. To wake on vibration without calling msOpen, see accVibrationSetWakeup.

pmSuspend return codes for this wake-up source:

Input:

Enable : BOOL

Controls if enabling or disabling wake-up on vibration.

Sensitivity : SINT (-1..100, default -1)

To use vibration as a wake-up source, the sensitivity must not be 0.

Returns: INT

Declaration

FUNCTION msVibrationSetWakeup : INT;
VAR_INPUT
  Enable      : BOOL;
  Sensitivity : SINT := -1;
END_VAR;

Example:

INCLUDE rtcu.inc
 
PROGRAM test;
// These are the local variables of the program block
VAR
  wk    : DINT;
END_VAR;
// The next code will only be executed once after the program starts
  ...
  // Open Motion Sensor interface
  msOpen();
  ...
  // Enable wake on vibration with high sensitivity
  msVibrationSetWakeup(sensitivity := 80, enable := ON);
  ...

  // Sleep 600 seconds or wake on vibration detection
  wk := pmSuspend(time:=600, mode := 0);
  ...
  // Close Motion Sensor interface
  msClose();
  ...
BEGIN
// Code from this point until END will be executed repeatedly
END;
END_PROGRAM;