Add docs for MyPermobil (#28021)

* add docs for MyPermobil

* Update mypermobil.markdown

* update documentation

* change sensor chapters to list

* Add notice about voice assistant linking

Users may need to activate voice assistant linking in the MyPermobil app for the config flow to work. Added a notice about this in the documentation.

* fix ha_release

* tiny tweaks

* Update source/_integrations/mypermobil.markdown

Co-authored-by: c0ffeeca7 <38767475+c0ffeeca7@users.noreply.github.com>

* Update source/_integrations/mypermobil.markdown

Co-authored-by: c0ffeeca7 <38767475+c0ffeeca7@users.noreply.github.com>

---------

Co-authored-by: Robert Resch <robert@resch.dev>
Co-authored-by: c0ffeeca7 <38767475+c0ffeeca7@users.noreply.github.com>
This commit is contained in:
Isak Nyberg 2023-11-26 16:42:40 +01:00 committed by GitHub
parent 2297b6d81b
commit 8e38d54c70
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
2 changed files with 47 additions and 0 deletions

View File

@ -471,6 +471,7 @@ source/_integrations/msteams.markdown @peroyvind
source/_integrations/mullvad.markdown @meichthys
source/_integrations/mutesync.markdown @currentoor
source/_integrations/my.markdown @home-assistant/core
source/_integrations/mypermobil @IsakNyberg
source/_integrations/mysensors.markdown @MartinHjelmare @functionpointer
source/_integrations/mystrom.markdown @fabaff
source/_integrations/nam.markdown @bieniu

View File

@ -0,0 +1,46 @@
---
title: MyPermobil
description: Instructions on how to integrate Permobil wheelchair into Home Assistant.
ha_category:
- Sensor
ha_iot_class: Cloud Polling
ha_release: 2023.12
ha_domain: permobil
ha_codeowners:
- '@IsakNyberg'
ha_config_flow: true
ha_platforms:
- Sensor
ha_integration_type: hub
---
The **MyPermobil** integration allows you to view various sensors with information about your Permobil wheelchair. For example: battery status, distance traveled, and number of seating adjustments. The values of the sensors may be delayed by several minutes and should not be relied on for any crucial applications. For the integration to work, you must ensure that _voice assistant linking_ is activated in the MyPermobil app. To do this, open the app and navigate to **Settings** > **My Account** > **Connection Settings**.
{% include integrations/config_flow.md %}
## Sensors
A total of 11 sensors are available:
- **Battery charge**
The current battery state of the wheelchair as a percentage.
- **Battery health**
The maximum amount of charge the battery can hold. Measured as a percentage of the battery's original capacity.
- **Charge time left**
A number indicating how many hours the battery needs until it is fully charged. The battery needs to be charging for this sensor to work.
- **Distance left**
The distance the wheelchair can travel on its current charge. This figure is an estimate and should not be relied upon.
- **Indoor drive time**
The estimated number of hours of indoor drive time that is left on the current battery charge.
- **Battery max watt hours**
The number of watt hours of energy stored in the battery when it is at maximum capacity.
- **Watt hours left**
The number of watt hours of energy stored in the battery on its current charge.
- **Full charge distance**
The distance the wheelchair can travel on a full charge. This figure is an estimate and should not be relied upon.
- **Distance traveled**
The distance the wheelchair has traveled today.
- **Number of adjustments**
The number of adjustments sessions today. Multiple different adjustment within a short time period are counted as a single sessions.
- **Highest number of adjustments**
The highest number of adjustments ever recorded in a single day.