Package: py-smart-gardena2
py-smart-gardena2This is a fork ofhttps://github.com/grm/py-smart-gardena/which was done because it was inactive.DescriptionThis library aims to provide python way to communicate with gardena smart systems and
all gardena smart equipments. Configuration of the equipement and inclusion has still
to be done using the Gardena application or website.RequirementsPython 3.6+Supported devicesFor now, only few devices are supported. I may add new ones in the future :GatewaySmart MowerSmart water controlSmart sensorPower plugsSmart Irrigation controlAccount creation in order to have access to Gardena APIGardena requires the creation of an account and an application in order to use their API.
You can find how to create such an account and application here :Account and application creationInstallation$pipinstallpy-smart-gardena2UsageData modelThe entrypoint of the library is the the SmartSytem class (in gardena.smart_system
package).
From there, you can get all locations from your account, and for each of these
locations, get the declared devices.All communications are not done directly with the gateway. This library uses a websocket in order
to communicate with gardena systems in order to avoid throttling. There is only one connection to authenticate,
and two connections to revoke tokens, everything else is done through websockets.AuthenticationYou first need to get a client id (also called application key in the
API documentation) for your personal installation of gardena.  To do
so, create an account here :https://developer.1689.cloud/apisThen you need to create an application, add APIs (Authentication API
and GARDENA smart system API), and copy the application key as
explained here:https://developer.1689.cloud/docs/getting-startedThe library manages the token for you then.
An exception is raised if authentication fails.fromgardena.smart_systemimportSmartSystemimportpprintsmart_system=SmartSystem(email="email@gmail.com",password="my_password",client_id="client_id")smart_system.authenticate()smart_system.update_locations()forlocationinsmart_system.locations.values():smart_system.update_devices(location)pprint.pprint(location)fordeviceinlocation.devices.values():pprint.pprint(device)smart_system.start_ws(smart_system.locations['LOCATION_ID'])Once authentication is successful, you need to gather locations and devices for the first time and then, you can create start the websocket in order to get updates automatically.LocationsLocations are automatically retrieved the first time from the API, and then the websocket is used to get updates.Here is the list of the current available fields and methods :forlocationinsmart_system.locations.values():print("location : "+location.name+"("+location.id+")")DevicesDevices are automatically retrieved the first time from the API, and then the websocket is used to get updates. They are stored in each locations. Depending on the function type, you can have diffrents fields.Mowersfordeviceinsmart_system.locations["LOCATION_ID"].find_device_by_type("MOWER"):print(f"name :{device.name}")print(f"id :{device.id}")print(f"type :{device.type}")print(f"model_type :{device.model_type}")print(f"battery_level :{device.battery_level}")print(f"battery_state :{device.battery_state}")print(f"rf_link_level :{device.rf_link_level}")print(f"rf_link_state :{device.rf_link_state}")print(f"serial :{device.serial}")print(f"activity :{device.activity}")print(f"operating_hours :{device.operating_hours}")print(f"state :{device.state}")print(f"last_error_code :{device.last_error_code}")Power Socketfordeviceinsmart_system.locations["LOCATION_ID"].find_device_by_type("POWER_SOCKET"):print(f"name :{device.name}")print(f"id :{device.id}")print(f"type :{device.type}")print(f"model_type :{device.model_type}")print(f"battery_level :{device.battery_level}")print(f"battery_state :{device.battery_state}")print(f"rf_link_level :{device.rf_link_level}")print(f"rf_link_state :{device.rf_link_state}")print(f"serial :{device.serial}")print(f"activity :{device.activity}")print(f"state :{device.state}")Sensorfordeviceinsmart_system.locations["LOCATION_ID"].find_device_by_type("SENSOR"):print(f"name :{device.name}")print(f"id :{device.id}")print(f"type :{device.type}")print(f"model_type :{device.model_type}")print(f"battery_level :{device.battery_level}")print(f"battery_state :{device.battery_state}")print(f"rf_link_level :{device.rf_link_level}")print(f"rf_link_state :{device.rf_link_state}")print(f"serial :{device.serial}")print(f"ambient_temperature :{device.ambient_temperature}")print(f"light_intensity :{device.light_intensity}")print(f"soil_humidity :{device.soil_humidity}")print(f"soil_temperature :{device.soil_temperature}")Smart irrigation controlfordeviceinsmart_system.locations["LOCATION_ID"].find_device_by_type("SMART_IRRIGATION_CONTROL"):print(f"name :{device.name}")print(f"id :{device.id}")print(f"type :{device.type}")print(f"model_type :{device.model_type}")print(f"battery_level :{device.battery_level}")print(f"battery_state :{device.battery_state}")print(f"rf_link_level :{device.rf_link_level}")print(f"rf_link_state :{device.rf_link_state}")print(f"serial :{device.serial}")print(f"valve_set_id :{device.valve_set_id}")print(f"valve_set_state :{device.valve_set_state}")print(f"valve_set_last_error_code :{device.valve_set_last_error_code}")forvalveindevice.valves.values():print(f"name :{valve['name']}")print(f"{valve['name']}- id :{valve['id']}")print(f"{valve['name']}- activity :{valve['activity']}")print(f"{valve['name']}- state :{valve['state']}")print(f"{valve['name']}- last_error_code :{valve['last_error_code']}")Smart water controlfordeviceinsmart_system.locations["LOCATION_ID"].find_device_by_type("WATER_CONTROL"):print(f"name :{device.name}")print(f"id :{device.id}")print(f"type :{device.type}")print(f"model_type :{device.model_type}")print(f"battery_level :{device.battery_level}")print(f"battery_state :{device.battery_state}")print(f"rf_link_level :{device.rf_link_level}")print(f"rf_link_state :{device.rf_link_state}")print(f"serial :{device.serial}")print(f"valve_set_id :{device.valve_set_id}")print(f"valve_name :{device.valve_name}")print(f"valve_id :{device.valve_id}")print(f"valve_activity :{device.valve_activity}")print(f"valve_state :{device.valve_state}")Using websocketOnce the websocket has been started, everything is managed and the devices are
automatically updated once their state change.
In order for your to be alerted of such a change, you need to add a callback to the
device.
This callback will be called each time the device state changed :defmy_callback(device):print(f"The device{device.name}has been updated !")device.add_callback(my_callback)Development environmentTo install the dev environment, you just have to do, in the source code directory :$pipinstall-e.[dev]