Lovense Protocol

Protocol Rules

  • Commands and replies are strings, using semicolons to mark their end.
  • All commands start with a command identifier word, then possibly either specifiers or levels, delimited by colons. e.g. “Vibrate:5;” would set vibration to 5.
  • Replies are in the context of the command (i.e. sending “Battery;” will just return a number, like “85;”), but can still be colon delimited lists.
  • Commands that do not return a context specific value will return “OK;” on success, “ERR;” on error.

Command List

The following is the known command table for all toys. Anything send or received over the serial port is in quotes to denote communication, but should not be sent using quotes if you are implementing your own version of this protocol. Commands with ”:x” mean that the x should be replaced with a number, the range of which is mentioned in the description.

Get Device Information

Returns toy model type (see models for model letters), Firmware version, and bluetooth MAC address, as a colon delimited list

Availability: All toys

Command Format

DeviceType;

Return Example

C:11:0082059AD3BD;

Denotes Nora toy, running v1.1 firmware, BT Addr of 00:82:05:9A:D3:BD

Get Battery Level

Returns the battery level of the toy as an integer percentage from 0-100.

Availability: All toys

Command Format

Battery;

Return Example

85;

Denotes 85% battery remaining.

Turn Off Power

Turns off power to the toy.

Availability: All toys

Command Format

PowerOff;

Return Example

OK;

Device Status

Retreive the status of the toy.

Availability: All toys

Command Format

Status:1;

Return Example

2;

Status Codes:

  • 2: Normal

Set Vibration Speed

Changes the vibration speed for the toy. Takes integer values from 0-20.

Availability: All toys

Command Format

Vibrate:10;

Sets vibration speed to 10 (50%).

Return Example

OK;

Start Accelerometer Data Stream

Starts a stream of accelerometer data. Will send constantly until stop command is sent. Incoming accelerometer data starts with the letter G, followed by 3 16-bit little-endian numbers.

Availability: Max, Nora

Command Format

StartMove:1;

Return Example

GEF008312ED00;

Denotes [0x00EF, 0x1283, 0x00ED] accelerometer readings.

Stop Accelerometer Data Stream

Stops stream of accelerometer data.

Availability: Max, Nora

Command Format

StopMove:1;

Return Example

OK;

Change Rotation Direction

Changes the direction of rotation for the toy.

Availability: Nora

Command Format

RotateChange;

Return Example

OK;

Set rotation speed

Changes the rotation speed of the Nora toy. Takes integer values from 0-20.

Availability: Nora

Command Format

Rotate:10;

Sets rotation speed to 10 (50%).

Return Example

OK;

Set Absolute Air Level

Changes the inflation level of the Max toy. Takes integer values from 0-5.

Availability: Max

Command Format

Air:Level:3;

Sets air level to 3 (60%).

Return Example

OK;

Set Relative Inflation Level

Inflates relative to current level, i.e. if currently inflation level is 3, and “Air:In:1;” is sent, will inflate to 4.

Availability: Max

Command Format

Air:In:1;

Sets air level to 1 level more inflated than it was.

Return Example

OK;

Set Relative Deflation Level

Deflates relative to current level, i.e. if currently inflation level is 3, and “Air:Out:1;” is sent, will deflate to 2.

Availability: Max

Command Format

Air:Out:1;

Sets air level to 1 level deflated than it was.

Return Example

OK;