Protocols and Modes

An introduction to Handy protocols and modes.



As an online-enabled device, the Handy can receive commands over the Internet and react accordingly. It has four protocols to enable different functionalities:

  • Handy Simple Timing Protocol (HSTP)
  • Handy Alternate Motion Protocol (HAMP)
  • Handy Direct Streaming Protocol (HDSP)
  • Handy Synced Stream Protocol (HSSP)


The Handy uses modes to separate different functions. It has modes directly corresponding to three protocols:

  • HAMP mode — the mode to control the speed and stroke length of the oscillating Handy motion.
  • HDSP mode — an experimental mode that tells the Handy where to go and how fast to arrive there.
  • HSSP mode — the mode used for synchronizing the Handy with videos and scripts.

Certain operations are only available when the Handy is set to a corresponding mode. For instance, functions such as script looping are only possible when the Handy is synchronized with a script — that is, the Handy is in HSSP mode.

See the SDK Reference for details.

Default Mode

By default, the Handy will enter HSSP mode when it first connects to the Internet.

Mode Persistence

When set to a certain mode, the Handy will stay in that mode until it is manually disconnected from Wi-Fi or power cycled. For instance, if a Handy is in HAMP mode, and it loses connection to the Handy servers, it will remain in HAMP mode during the reconnection period.

Handy Simple Timing Protocol (HSTP)

The Handy Simple Timing Protocol (HSTP) contains functions used for synchronizing the Handy with the Handy server. The functions of HSTP are available in any mode.