From 76268a76d0ab18fff821dd88a2e3e1c67ca68534 Mon Sep 17 00:00:00 2001 From: Rosi Date: Tue, 17 Oct 2023 20:33:16 +0200 Subject: [PATCH] [boschindego] Add note that batteryVoltage is not populated correctly (#15764) Add a note on how to interpret the `batteryChannel` channel - or rather not to use it at all. --- bundles/org.openhab.binding.boschindego/README.md | 15 +++++++++------ 1 file changed, 9 insertions(+), 6 deletions(-) diff --git a/bundles/org.openhab.binding.boschindego/README.md b/bundles/org.openhab.binding.boschindego/README.md index 78a1cde287f..2cfd0505a83 100644 --- a/bundles/org.openhab.binding.boschindego/README.md +++ b/bundles/org.openhab.binding.boschindego/README.md @@ -30,7 +30,7 @@ To authorize, please follow these steps: ### `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 | @@ -39,7 +39,7 @@ To authorize, please follow these steps: ## 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 | | @@ -48,21 +48,24 @@ To authorize, please follow these steps: | 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 | | +| 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 device2 | | +| 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) This will be updated as often as specified by the `stateActiveRefresh` thing parameter. +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 |