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.2.tar.gz
(22.9 kB
view hashes)
Built Distribution
Close
Hashes for pyworxcloud-2.0.2-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | ae73f90d8d9bbaf186ff5590ef1962dac8e46787d6303516736fcf304c1c0baf |
|
MD5 | 4bf07341159a20da180a6a03aabc304d |
|
BLAKE2b-256 | 2e84cacbd58253caaa38fe2f96475f7ac315bb1ae5b1a6bef4d33ebc8ce58110 |