Skip to main content

Python API for communicating with Eufy RoboVac 11c devices

Project description

PyRobovac

Python library for controlling the Eufy RoboVac 11c.

Usage

from robovac.robovac import Robovac

my_robovac = Robovac('ROBOVAC_IP', 'ROBOVAC_LOCAL_CODE')

# Cleaning modes
my_robovac.start_auto_clean()
my_robovac.start_edge_clean()
my_robovac.start_single_room_clean()
my_robovac.start_spot_clean()

# Set cleaning speed
my_robovac.use_normal_speed()
my_robovac.use_max_speed()

# Stop cleaning
my_robovac.stop()

# Return to charging base
my_robovac.go_home()

# Activate "find me" mode, plays a tone until deactivated
my_robovac.start_find_me()
my_robovac.stop_find_me()

# Move in a given direction
my_robovac.go_forward()
my_robovac.go_backward()
my_robovac.go_left()
my_robovac.go_right()

# Get RoboVac status
my_robovac.get_status()

Local code

The API authenticates with the Robovac using a unique local code. This is a 16 character string that's unique to the RoboVac. Currently, the easiest way to find this code is to connect to your Android phone via ADB, and run Logcat while running the Eufy Home app.

You can then search through the log output for "localcode" to find the local code for your device.

Notes & Acknowledgements

This library can only be used when on the same LAN as the RoboVac. The library has only been tested with the Eufy RoboVac 11c. It may or may not work with other models.

Thanks to @mjg59 for his work on decrypting packets received from Eufy devices. See it here: google/python-lakeside

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

robovac-0.0.3.tar.gz (7.5 kB view details)

Uploaded Source

Built Distribution

robovac-0.0.3-py3-none-any.whl (11.2 kB view details)

Uploaded Python 3

File details

Details for the file robovac-0.0.3.tar.gz.

File metadata

  • Download URL: robovac-0.0.3.tar.gz
  • Upload date:
  • Size: 7.5 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/1.13.0 pkginfo/1.5.0.1 requests/2.21.0 setuptools/41.0.1 requests-toolbelt/0.9.1 tqdm/4.32.1 CPython/3.7.2

File hashes

Hashes for robovac-0.0.3.tar.gz
Algorithm Hash digest
SHA256 1eca39b9139a45df2613421c744fbf0be64a343ad8438d92f05d33fec8cda3e2
MD5 2dda8487e71e59f8483679c2c5ba5f5a
BLAKE2b-256 3a397a8d3277e6929445b714beebb5977f12eda560fb073955de0fb4c2b50f68

See more details on using hashes here.

File details

Details for the file robovac-0.0.3-py3-none-any.whl.

File metadata

  • Download URL: robovac-0.0.3-py3-none-any.whl
  • Upload date:
  • Size: 11.2 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/1.13.0 pkginfo/1.5.0.1 requests/2.21.0 setuptools/41.0.1 requests-toolbelt/0.9.1 tqdm/4.32.1 CPython/3.7.2

File hashes

Hashes for robovac-0.0.3-py3-none-any.whl
Algorithm Hash digest
SHA256 9490c47fa610d584aab1b6e4ac8e26235a1116666bd91822c46172e033151317
MD5 51231a9658598fb68be4f385eb279f40
BLAKE2b-256 fbdd68f3baebeebb67c8edfebc7bfab7e081b306210630e9696892b4ab39c68a

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page