This page is part of archived documentation for openHAB 4.1. 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.
# Discovery
When the bridge is authorized, the binding can automatically discover Indego mowers connected to the SingleKey ID account.
# Thing Configuration
# account Bridge Configuration
There are no parameters for the bridge. However, the bridge is used for managing the SingleKey ID (opens new window) digital identity.
# Authorization
To authorize, please follow these steps:
- In your browser, go to the Bosch Indego login page (opens new window).
- Select "Bosch ID", enter your e-mail address and password and click "Log-in".
- In your browser, open Developer Tools.
- With developer tools showing on the right, go to Bosch Indego login page (opens new window) again.
- "Please wait..." should now be displayed.
- Find the
authrespand copy the code:com.bosch.indegoconnect://login/?code=<copy this> - Use the openHAB console to authorize with this code:
openhab:boschindego authorize <paste code>
# indego Thing Configuration
| Parameter | Description | Default | Required |
|---|---|---|---|
| serialNumber | The serial number of the connected Indego mower | yes | |
| refresh | The number of seconds between refreshing device state when idle | 180 | no |
| stateActiveRefresh | The number of seconds between refreshing device state when active | 30 | no |
| cuttingTimeRefresh | The number of minutes between refreshing last/next cutting time | 60 | no |
# 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,2 | |
| 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 device3 |
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) Currently for some models the channel batteryVoltage is populated with the same value as batteryLevel.
For these models batteryLevel should be used instead of batteryVoltage.
3) 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 |
| 524 | Mowing randomly |
| 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
Bridge boschindego:account:singlekey {
Things:
Thing indego lawnmower [serialNumber="1234567890", refresh=120]
}
# indego.items File
Number Indego_State { channel="boschindego:indego:singlekey:lawnmower:state" }
Number Indego_ErrorCode { channel="boschindego:indego:singlekey:lawnmower:errorcode" }
Number Indego_StateCode { channel="boschindego:indego:singlekey:lawnmower:statecode" }
String Indego_TextualState { channel="boschindego:indego:singlekey:lawnmower:textualstate" }
Number Indego_Ready { channel="boschindego:indego:singlekey:lawnmower:ready" }
Dimmer Indego_Mowed { channel="boschindego:indego:singlekey:lawnmower:mowed" }
DateTime Indego_LastCutting { channel="boschindego:indego:singlekey:lawnmower:lastCutting" }
DateTime Indego_NextCutting { channel="boschindego:indego:singlekey:lawnmower:nextCutting" }
Number:ElectricPotential Indego_BatteryVoltage { channel="boschindego:indego:singlekey:lawnmower:batteryVoltage" }
Number Indego_BatteryLevel { channel="boschindego:indego:singlekey:lawnmower:batteryLevel" }
Switch Indego_LowBattery { channel="boschindego:indego:singlekey:lawnmower:lowBattery" }
Number:Temperature Indego_BatteryTemperature { channel="boschindego:indego:singlekey:lawnmower:batteryTemperature" }
Number:Area Indego_GardenSize { channel="boschindego:indego:singlekey:lawnmower:gardenSize" }
Image Indego_GardenMap { channel="boschindego:indego:singlekey:lawnmower:gardenMap" }
# indego.sitemap File
Switch item=Indego_State mappings=[1="Mow", 2="Return",3="Pause"]
Caught a mistake or want to contribute to the documentation? Edit this page on GitHub (opens new window)