VIBRATE Play a ringtone or ringtone file as a vibration pattern. A ringtone is [a RTTTL format](/wifi-pineapple-pager/device/ringtones/) monophonic series of notes.

When to use it

Use VIBRATE to play a custom (or pre-installed system) ringtone as a vibration pattern. Vibration patterns are controlled as if they were ringtones - when a note would play, the vibration motor is triggered. This can be used to generate complex patterns or basic notifications without sound.

Syntax

VIBRATE [rtttl or filename]

rtttl or filename required

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

To play a custom ringtone, use the entire RTTTL ringtone here.

To play a ringtone file, pass the name of the file. VIBRATE looks for the ringtone files in /root/ringtones/.

Results

VIBRATE will eit with an error if another vibration pattern or ringtone 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"