/hass-WEM-Portal

Custom component for retrieving sensor information from Weishaupt WEM Portal

Primary LanguagePythonMIT LicenseMIT

hacs_badge buy me a coffee License

hass-WEM-Portal

Custom component for retrieving sensor information from Weishaupt WEM Portal.
Component uses webscraping, as well as Weishaupt mobile API, to get all the sensor data from the Weishaupt WEM Portal ( Expert view) and makes it available in Home Assistant.

Installation

HACS (preferred method)

  • In HACS Store search for erikkastelec/hass-WEM-Portal and install it
  • Activate the component by configuring it via UI as described in Configuration section below.

Manual install

Create a directory called wemportal in the <config directory>/custom_components/ directory on your Home Assistant instance. Install this component by copying all files in /custom_components/wemportal/ folder from this repo into the new <config directory>/custom_components/wemportal/ directory you just created.

This is how your custom_components directory should look like:

custom_components
├── wemportal
│   ├── __init__.py
│   ├── ...
│   ├── ...
│   ├── ...
│   └── wemportalapi.py  

Configuration

Integration must be configured in Home Assistant frontend: Go to Settings > Devices&Services , click on Add integration button and search for Weishaupt WEM Portal.

After Adding the integration, you can click CONFIGURE button to edit the default settings. Make sure to read what each setting does below.

Configuration variables:

  • username: Email address used for logging into WEM Portal
  • password: Password used for logging into WEM Portal
  • scan_interval (Optional): Defines update frequency of web scraping. Optional and in seconds (defaults to 30 min). Setting update frequency below 15 min is not recommended.
  • api_scan_interval (Optional): Defines update frequency for API data fetching. Optional and in seconds (defaults to 5 min, should not be lower than 3 min).
  • language ( Optional): Defines preferred language. Use en for English translation or de for German. (defaults to en ( English))
  • mode (Optional): Defines the mode of data fetching. Defaults to api, which gets the data available through the mobile API. Option web gets only the data on the website, while option both queries website and api and provides all the available data from both sources.

Troubleshooting

Please set your logging for the custom_component to debug:

Go to Settings > Devices&Services , find WEM Portal and click on three dots at the bottom of the card. Click on Enable debug logging.