VIBRATE - Play a ringtone or ringtone file as vibration. A ringtone is a RTTTL format monophonic series of notes.

When to use it

Use VIBRATE to play a custom (or system) ringtone pattern, with vibration only.

Vibration patterns are controlled as if they were ringtones - when a note would play, the vibration motor is triggered. This can be used to introduce complex patterns of vibration, or used as a simple on/off pulse.

Syntax 

  VIBRATE [rtttl - or - filename]

rtttl or filename

Play the supplied RTTTL ringtone, or play a RTTTL file.

To play a custom ringtone, use the entire RTTTL ringtone as an argument.

To play a ringtone file, pass the name of the file. Ringtones are automatically played from /root/ringtones/.

Results

VIBRATE will exit with an error if another ringtone or vibration is currently playing.

Examples 

  # Play the default `alert.rtttl` ringtone as vibration
VIBRATE "alert"
  
  # Play a custom ringtone as vibration
VIBRATION "custom:d=16,o=4,b=200:8e4,8g4,8a#4,8d5,8b6"