Landroid cloud API library
Project description
pyWorxCloud
This is a PyPI module for communicating with Worx Cloud mowers, primarily developed for use with Home Assistant, but I try to keep it as wide usable as possible.
The module are compatible with cloud enabled devices from these vendors:
- Worx Landroid
- LandXcape
- Kress
This is using and undocumented API, so do not expect everything to work.
The module will be enhanced with more functionality as the API gets mapped out - any help will be much appreciated.
Available calls
Call | Description | Parameters |
---|---|---|
initialize | Initialize the API connection and authenticate the user credentials | |
connect | Connect to a device | dev_id: int, verify_ssl: bool |
set_callback | If set, the module will call this function when data is received from the API | callback |
enumerate | Returns the number of devices associated with the account | |
send | Send custom data to the API | data: str (JSON string!) |
update | Retrieve current status from API | |
start | Start mowing routine | |
pause | Pause mowing | |
home | Stop (and go home) | |
zonetraining | Start zonetraining | |
lock | Toggle device lock | |
restart | Reboot baseboard OS | |
raindelay | Set new rain delay | rain_delay: str or int |
toggle_schedule | Toggle schedule on or off | |
toggle_partymode | Toggle party mode if supported by device | |
ots | Start OTS | boundary: bool, runtime: str or int |
setzone | Set next zone to mow | zone: str or int |
Connection example
from pyworxcloud import WorxCloud
cloud = WorxCloud("your@email", "Password")
# Initialize connection
auth = cloud.initialize()
if not auth:
# If invalid credentials are used, or something happend during
# authorize, then exit
exit(0)
# Connect to device with index 0 (devices are enumerated 0, 1, 2 ...) and do
# not verify SSL (False)
cloud.connect(0, False)
# Read latest states received from the device
cloud.update()
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
pyworxcloud-2.0.3.tar.gz
(22.9 kB
view hashes)
Built Distribution
Close
Hashes for pyworxcloud-2.0.3-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 3d5d477f54bc681116fda23d900ca159b0b62cdc7c7545b4dd5acb509426fd4a |
|
MD5 | 8ea84cbcc48b56642abb1a6aaf3f95af |
|
BLAKE2b-256 | 0cf3ae538311f24df44022cc10e8aac1b723633e3a1c961aa31c79ff6d751b22 |