Indego
所属分类:物联网
开发工具:Python
文件大小:249KB
下载次数:0
上传日期:2023-06-01 20:26:37
上 传 者:
sh-1993
说明: 博世Indego割草机家庭助理定制组件
(Home Assistant Custom Component for Bosch Indego Lawn Mower)
文件列表:
.vscode (0, 2023-06-26)
.vscode\settings.json (72, 2023-06-26)
chrome-extension.zip (1994, 2023-06-26)
custom_components (0, 2023-06-26)
custom_components\indego (0, 2023-06-26)
custom_components\indego\__init__.py (25589, 2023-06-26)
custom_components\indego\api.py (1535, 2023-06-26)
custom_components\indego\application_credentials.py (970, 2023-06-26)
custom_components\indego\binary_sensor.py (3013, 2023-06-26)
custom_components\indego\config_flow.py (4631, 2023-06-26)
custom_components\indego\const.py (1647, 2023-06-26)
custom_components\indego\manifest.json (389, 2023-06-26)
custom_components\indego\mixins.py (1741, 2023-06-26)
custom_components\indego\sensor.py (3252, 2023-06-26)
custom_components\indego\services.yaml (765, 2023-06-26)
custom_components\indego\translations (0, 2023-06-26)
custom_components\indego\translations\en.json (615, 2023-06-26)
custom_components\indego\vacuum.py (5401, 2023-06-26)
doc (0, 2023-06-26)
doc\0-Sensors_3.png (38989, 2023-06-26)
doc\1-State_3.png (16707, 2023-06-26)
doc\10-MowingMode_2.png (15857, 2023-06-26)
doc\11-Online_3.png (10938, 2023-06-26)
doc\12-Update_4.png (11081, 2023-06-26)
doc\2-StateDetail_1.png (18204, 2023-06-26)
doc\3-LawnMowed_3.png (23046, 2023-06-26)
doc\4-MowTime_3.png (16346, 2023-06-26)
doc\5-Battery_3.png (23778, 2023-06-26)
doc\7-Alerts_3.png (14942, 2023-06-26)
doc\8-LastCompleted_3.png (16391, 2023-06-26)
doc\9-NextMow_3.png (18762, 2023-06-26)
doc\S1-Command1.png (11169, 2023-06-26)
hacs.json (418, 2023-06-26)
info.md (624, 2023-06-26)
[![GitHub release](https://img.shields.io/github/release/jm-73/Indego.svg)](https://GitHub.com/jm-73/Indego/releases/) [![hacs_badge](https://img.shields.io/badge/HACS-Default-orange.svg)](https://github.com/custom-components/hacs)
# Indego
Join the Discord channel to discuss around this integration and vote for your favourite change to happen!
https://discord.gg/aD33GsP
Home Assistant Custom Component for Bosch Indego Lawn Mower.
![Entities in Home Asistant](/doc/0-Sensors_3.png)
## Installation
### Alternative 1
Install via HACS Community Store: https://hacs.xyz/
### Alternative 2
Copy the folder `indego` in `custom_components` into your `custom_components` in your Home Assistant.
## Reboot
Reboot HA in order to get HA to find the newly added custom component.
## Configuration
### Authentication using Bosch SingleKey ID
Bosch moved to a new authentication method called Bosch SingleKey ID (using OAuth) at the beginning of 2023.
Therefore we needed to rewrite the authentication flow.
Currently **only** Google Chrome is the supported for authenticating with the Bosch SingleKey ID servers when adding the integration in HA.
Also a small extension needs to be installed (temporarily) in Google Chrome to handle the response from the Bosch authentication servers.
More (technical) information on the why can be found in this [issue](https://github.com/jm-73/Indego/issues).
Optionally you can remove or disable the extension after adding the Bosch Indego integration to HomeAssistant.
### Installing the Chrome extension
1. The **HomeAssistant Indego authentication helper** extension can be downloaded [here](/chrome-extension.zip).
2. Extract the ZIP archive.
3. Go to [extensions](chrome://extensions/) in Google Chrome.
4. Enable **Developer mode** (right top).
5. Choose **Load unpacked** and select the unpacked extension.
### Adding a mower
_Make sure you are accessing your HomeAssistant through Google Chrome and have the **HomeAssistant Indego authentication helper** extension enabled (as described above)._
Please add this integration through the HomeAssistant interface (Settings > Devices & Services > Add Integration). Search for **Bosch Indego Mower**.
Configuration through YAML (configuration) files is no longer supported.
You can add this integration multiple times in case you own multiple Indego mowers.
## Usage
### Entities
All sensors are autodiscovered and should appear as "unused entities" after adding the component.
| Description | Screenshot |
|-------------|------------|
|
|
|
***Mower state***
Shows state of the mower. | ![State](/doc/1-State_3.png)
***Mower state detail***
Shows detailed state of the mower. | ![State Detail](/doc/2-StateDetail_1.png)
***Lawn mowed***
Shows percentage of lawn mowed. | ![Lawn mowed](/doc/3-LawnMowed_3.png)
***Total mowing time***
Shows the total mowing time for the mower. | ![Mowtime total](/doc/4-MowTime_3.png)
***Battery***
Shows the status of the battery. | ![Battery sensor percent](/doc/5-Battery_3.png)
***Alerts***
Shows all alerts | ![Alerts sensor](/doc/7-Alerts_3.png)
***Last completed mow***
Shows when the lawn was completed last time. | ![Last mow](/doc/8-LastCompleted_3.png)
***Next mow time***
Show the next planned mow. | ![Next mow](/doc/9-NextMow_3.png)
***Mowing mode***
Shows the mowing mode set. | ![Mowing mode](/doc/10-MowingMode_2.png)
***Online***
Shows if the mower is online/offline/sleeping. Possble values:
*True, False* | ![Online status](/doc/11-Online_3.png)
***Update available***
Shows if there is an update available for the firmware. Possble values:
*On, Off* | ![Update available](/doc/12-Update_4.png)
## Service
### indego.command ####
Sends a command to the mower. Example code:
`command: mow`
Accepted values are:
|Command |Description |
|----------------|----------------------|
| `mow` | Start/continue mowing|
| `pause` | Pause mower |
| `returnToDock` | Return mower to dock |
![Services](/doc/S1-Command1.png)
### indego.smartmowing ####
Changes mowing mode. Example:
`enable: true`
Accepted values are:
|value |Description |
|-------------|----------------------|
| `true` | SmartMowing enabled |
| `false` | SmartMowing disabled |
## Examples
Creating automation in HA gui:
Example for automations.yaml:
``` yaml
# automations.yaml
- id: '15***475250261'
alias: Mower start
trigger:
- at: '10:30'
platform: time
condition: []
action:
- data:
command: mow
service: indego.command
```
## Debugging
To get debug logs from the component in your log file, specify theese options in your configuration file:
``` yaml
#configuration.yaml
logger:
default: critical
logs:
custom_components.indego: debug
```
To get debug logs from the python API library in your log file, add this line to your configuration file in additon to the lines above:
``` yaml
pyIndego: debug
```
## Supported models
As known today the following models are supported:
* Indego 1000
* Indego 1100
* Indego 1200
* Indego 10C
* Indego 13C
* Indego 350
* Indego 400
* Indego S+ 350 1gen
* Indego S+ 350 2gen
* Indego S+ 400 1gen
* Indego S+ 400 2gen
* Indego S+ 500
* Indego M+ 700 1gen
* Indego M+ 700 2gen
## Contribution
If you experience any readings from your mower that the sensor does not read out correct (could be Alerts or mower state), please dont hesitate to write an issue. I need your input in order to make this component as useful as possible. All suggestions are welcome!
## Known issues
Password cannot contain dashes (-).
If serial begins with an (0) the serial needs to be quoted in secrets.yaml. Se example above under Configuration.
## New issues
If you experience issues/bugs with this the best way to report them is to open an issue in **this** repo.
[Issue link](https://github.com/jm-73/Indego/issues)
## Credits
### Thanks to
[Eduard](https://github.com/eavanvalkenburg)
[Jumper78](https://github.com/Jumper78)
[dykandDK](https://github.com/dykandDK)
[ultrasub](https://github.com/UltraSub)
[Gnol86](https://github.com/Gnol86)
naethan bekkm onkelfarmor ltjessem nsimb jjandersson
[Shamshala](https://github.com/Shamshala)
nath
[bekkm](https://github.com/bekkm)
[urbatecte](https://github.com/urbatecte)
[Windmelodie](https://github.com/Windmelodie)
[Fuempel](https://github.com/Fuempel)
[MagaliDB](https://github.com/MagaliDB)
[mhosse](https://github.com/mhosse)
[Promises](https://github.com/Pr0mises)
[Sander1***8](https://github.com/sander1***8)
Fork from iMarkus/Indego https://github.com/iMarkus/Indego
Inspiration from http://grauonline.de/wordpress/?page_id=219
Inspiration from https://github.com/jofleck/iot-device-bosch-indego-controller
近期下载者:
相关文件:
收藏者: