This page is part of archived documentation for openHAB 3.4. Go to the current stable version

# Bosch Indego Binding

This is the Binding for Bosch Indego Connect lawn mowers. Thank´s to zazaz-de who found out how the API works. His Java Library (opens new window) made this Binding possible.

# Thing Configuration

Currently the binding supports indego mowers as a thing type with these configuration parameters:

Parameter Description Default
username Username for the Bosch Indego account
password Password for the Bosch Indego account
refresh The number of seconds between refreshing device state when idle 180
stateActiveRefresh The number of seconds between refreshing device state when active 30
cuttingTimeRefresh The number of minutes between refreshing last/next cutting time 60

# Channels

Channel Item Type Description Writeable
state Number You can send commands to this channel to control the mower and read the simplified state from it (1=mow, 2=return to dock, 3=pause) Yes
errorcode Number Error code of the mower (0=no error)
statecode Number Detailed state of the mower
textualstate String State as a text.
ready Number Shows if the mower is ready to mow (1=ready, 0=not ready)
mowed Dimmer Cut grass in percent
lastCutting DateTime Last cutting time
nextCutting DateTime Next scheduled cutting time
batteryVoltage Number:ElectricPotential Battery voltage reported by the device1
batteryLevel Number Battery level as a percentage (0-100%)1
lowBattery Switch Low battery warning with possible values on (low battery) and off (battery ok)1
batteryTemperature Number:Temperature Battery temperature reported by the device1
gardenSize Number:Area Garden size mapped by the device
gardenMap Image Garden map created by the device2

1) This will be updated every six hours when the device is idle. It will wake up the device, which can include turning on its display. When the device is active or charging, this will be updated every two minutes.

2) This will be updated as often as specified by the stateActiveRefresh thing parameter.

# State Codes

Code Description
0 Reading status
257 Charging
258 Docked
259 Docked - Software update
260 Docked
261 Docked
262 Docked - Loading map
263 Docked - Saving map
266 Leaving dock
513 Mowing
514 Relocalising
515 Loading map
516 Learning lawn
517 Paused
518 Border cut
519 Idle in lawn
523 SpotMow
768 Returning to dock
769 Returning to dock
770 Returning to dock
771 Returning to dock - Battery low
772 Returning to dock - Calendar timeslot ended
773 Returning to dock - Battery temp range
774 Returning to dock
775 Returning to dock - Lawn complete
776 Returning to dock - Relocalising
1025 Diagnostic mode
1026 End of life
1281 Software update
1537 Energy save mode
64513 Docked

# Full Example

# indego.things File

boschindego:indego:lawnmower [username="[email protected]", password="idontneedtocutthelawnagain", refresh=120]

# indego.items File

Number Indego_State { channel="boschindego:indego:lawnmower:state" }
Number Indego_ErrorCode { channel="boschindego:indego:lawnmower:errorcode" }
Number Indego_StateCode { channel="boschindego:indego:lawnmower:statecode" }
String Indego_TextualState { channel="boschindego:indego:lawnmower:textualstate" }
Number Indego_Ready { channel="boschindego:indego:lawnmower:ready" }
Dimmer Indego_Mowed { channel="boschindego:indego:lawnmower:mowed" }
DateTime Indego_LastCutting { channel="boschindego:indego:lawnmower:lastCutting" }
DateTime Indego_NextCutting { channel="boschindego:indego:lawnmower:nextCutting" }
Number:ElectricPotential Indego_BatteryVoltage { channel="boschindego:indego:lawnmower:batteryVoltage" }
Number Indego_BatteryLevel { channel="boschindego:indego:lawnmower:batteryLevel" }
Switch Indego_LowBattery { channel="boschindego:indego:lawnmower:lowBattery" }
Number:Temperature Indego_BatteryTemperature { channel="boschindego:indego:lawnmower:batteryTemperature" }
Number:Area Indego_GardenSize { channel="boschindego:indego:lawnmower:gardenSize" }
Image Indego_GardenMap { channel="boschindego:indego:lawnmower:gardenMap" }

# indego.sitemap File

Switch item=Indego_State mappings=[1="Mow", 2="Return",3="Pause"]