diff --git a/README.md b/README.md index fcd4e5b..6e310f8 100644 --- a/README.md +++ b/README.md @@ -10,6 +10,7 @@ Home Assistant integration for Haier hOn: support for Haier/Candy/Hoover home ap - Washing Machine - Oven + ## Installation **Method 1:** [![Open your Home Assistant instance and open a repository inside the Home Assistant Community Store.](https://my.home-assistant.io/badges/hacs_repository.svg)](https://my.home-assistant.io/redirect/hacs_repository/?owner=Andre0512&repository=hon&category=integration) @@ -26,14 +27,34 @@ _Restart Home Assistant_ **Method 2**: Settings > Devices & Services > Add Integration > **Haier hOn** _If the integration is not in the list, you need to clear the browser cache._ + + ## Contribute Any kind of contribution is welcome! -#### Add appliances or additional attributes +### Read out device data +If you want to make a request for adding new appliances or additional attributes and don't want to use the command line, here is how you can read out your device data. +For every device exists a hidden button which can be used to log all info of your appliance. +1. Enable the "Log Device Info" button + _This button can be found in the diagnostic section of your device or in the entity overview if "show disabled entities" is enabled._ +2. Press the button +3. Go to Settings > System > Logs, click _load full logs_ and scroll down + _The formatting is messy if you not load full logs_ +4. Here you can find all data which can be read out via the api + ```yaml + data: + appliance: + applianceId: 12-34-56-78-90-ab#2022-10-25T19:47:11Z + applianceModelId: 1569 + ... + ``` +5. Copy this data and create a [new issue](https://github.com/Andre0512/hon/issues/new) with your request + +### Add appliances or additional attributes 1. Install [pyhOn](https://github.com/Andre0512/pyhOn) ```commandline $ pip install pyhOn ``` -2. Use the commandline tool to read out all appliance data from your account +2. Use the command line tool to read out all appliance data from your account ```commandline $ pyhOn User for hOn account: user.name@example.com diff --git a/custom_components/hon/button.py b/custom_components/hon/button.py index 949747f..15b32fc 100644 --- a/custom_components/hon/button.py +++ b/custom_components/hon/button.py @@ -1,11 +1,18 @@ +import logging +import urllib +from urllib.parse import quote + from homeassistant.components.button import ButtonEntityDescription, ButtonEntity from homeassistant.config_entries import ConfigEntry from pyhon import Hon from pyhon.appliance import HonAppliance +from homeassistant.const import EntityCategory from .const import DOMAIN from .hon import HonCoordinator, HonEntity +_LOGGER = logging.getLogger(__name__) + BUTTONS: dict[str, tuple[ButtonEntityDescription, ...]] = { "OV": ( ButtonEntityDescription( @@ -41,6 +48,7 @@ async def async_setup_entry(hass, entry: ConfigEntry, async_add_entities) -> Non appliances.extend( [HonButtonEntity(hass, coordinator, entry, device, description)] ) + appliances.extend([HonFeatureRequestButton(hass, coordinator, entry, device)]) async_add_entities(appliances) @@ -58,3 +66,18 @@ class HonButtonEntity(HonEntity, ButtonEntity): async def async_press(self) -> None: await self._device.commands[self.entity_description.key].send() + + +class HonFeatureRequestButton(HonEntity, ButtonEntity): + def __init__(self, hass, coordinator, entry, device: HonAppliance) -> None: + super().__init__(hass, entry, coordinator, device) + + self._device = device + self._attr_unique_id = f"{super().unique_id}_log_device_info" + self._attr_icon = "mdi:information" + self._attr_name = "Log Device Info" + self._attr_entity_category = EntityCategory.DIAGNOSTIC + self._attr_entity_registry_enabled_default = False + + async def async_press(self) -> None: + _LOGGER.error("Device Info:\n" + self._device.diagnose) diff --git a/info.md b/info.md index 1e75d39..bcd2a5a 100644 --- a/info.md +++ b/info.md @@ -26,10 +26,7 @@ _If the integration is not in the list, you need to clear the browser cache._ ## Contribute -Want to help us to support more appliances? -Or add more sensors? -Or help with translating? -Or beautify some icons or captions? +Want to help us to support more appliances? Or add more sensors? Or help with translating? Or beautify some icons or captions? Check out the [project on GitHub](https://github.com/Andre0512/hon), every contribution is welcome!