diff --git a/assets/github_stats.png b/assets/github_stats.png new file mode 100644 index 0000000..e086fe6 Binary files /dev/null and b/assets/github_stats.png differ diff --git a/takedown_faq.md b/takedown_faq.md index db5b537..30ea5d1 100644 --- a/takedown_faq.md +++ b/takedown_faq.md @@ -22,14 +22,16 @@ I wrote another mail on and tried to get some clarification and reach some agree ### What was Haier's reaction? **2024-01-19** -[Haier US answered](https://www.reddit.com/r/homeassistant/comments/19a615l/haier_us_supports_home_assistant_and_open_iot/) that they have nothing to do with it and support open IOT platforms. -Haier Europe created [a blog post](https://corporate.haier-europe.com/press-release/hon-app-a-message-about-our-iot-and-ecosystem-vision/) and said they are _committed to enhancing the smart home scenarios in line with authorized usages and intellectual property rights of Haier Europe._ +Haier US [answered on X](https://www.reddit.com/r/homeassistant/comments/19a615l/haier_us_supports_home_assistant_and_open_iot/) that they have nothing to do with it and support open IOT platforms. +Haier Europe [created a blog post](https://corporate.haier-europe.com/press-release/hon-app-a-message-about-our-iot-and-ecosystem-vision/) and said they are _committed to enhancing the smart home scenarios in line with authorized usages and intellectual property rights of Haier Europe._ **2024-01-20** Gianpiero Morbello, Head of Brand & IOT Haier Europe, wrote this mail: -![haier response](assets/haier_response.png) +![haier response](assets/haier_response.png) + +As far as I know, none of the numerous requests from the community have been answered, but if they have, please let me know. ### Are you in contact with Home Assistant? -The Home Assistant team got in touch with me and will be part of a conversation with Haier. +The Home Assistant/Nabu Casa team got in touch with me and will be part of a conversation with Haier. ### Did you agree to Haier's tos? To create an account for Haier hOn you have to accept the terms of service. Without it, you can't connect your appliances to hOn and so you can't use Andre0512/hon. @@ -39,7 +41,7 @@ Haier sells home appliances with internet connection and offers the free hOn app The connection only works with the Haier servers, so your appliance sends data to the cloud and the hOn app communicates with it, there is no direct connection. ### How was the plugin created? -I used [HTTP Tookit](https://httptoolkit.com/) to monitor the HTTP requests between hOn and the Haier servers and then rebuilt the requests in Python (with aiohttp). This takes me a few days to figure out and rebuild the necessary requests and I can now also explain why the hOn app is so extremely slow. The login alone hammers ~20 requests to the servers and also the communication with the devices is made of super many requests (at least at the time of my analysis). +I used [HTTP Tookit](https://httptoolkit.com/) to monitor the HTTP requests between hOn and the Haier servers and then rebuilt the requests in Python (with aiohttp). I have tried to make the requests in the same way as the app does, except for the ones we don't need. The pretty complex login can be found in [auth.py](https://github.com/Andre0512/pyhOn/blob/main/pyhon/connection/auth.py) and the API requests that I have adopted as relevant for the integration are these [api.py](https://github.com/Andre0512/pyhOn/blob/main/pyhon/connection/api.py). Beyond that, there is no communication with the hOn servers in the code. @@ -58,7 +60,7 @@ This are all requests the plugin sends to Haiers servers - Loading of all appliance functions (In [hon-test-data](https://github.com/Andre0512/hon-test-data/tree/main/test_data) you can have an overview of which data this is for each appliance) **Status polling** -- 1 request every 5 seconds to fetch the current state for each appliance ([something like this](https://github.com/Andre0512/hon-test-data/blob/main/test_data/ac_312/appliance_data.json)) +- 1 request every 10 seconds to fetch the current state for each appliance ([something like this](https://github.com/Andre0512/hon-test-data/blob/main/test_data/ac_312/appliance_data.json)) **Triggering action** - If any action is triggerd, e.g. start some appliance or set a new a/c mode, some data have to be posted @@ -66,8 +68,13 @@ This are all requests the plugin sends to Haiers servers **Creating a new releases** - If I create a new release, program names and translations in all languages are fetched from the api and loaded to the [translation folder](https://github.com/Andre0512/hon/tree/main/custom_components/hon/translations) -### What could bother Haier? -Requesting every 5 seconds is a bit much (even if the app makes more requests more frequent, but only in use). With a poorly implemented application, this could perhaps provide some load. The default interval for most integrations is 10 seconds. I would totally understand if haier wanted a higher value here and would increase it, I have already asked them suggest a poll interval. +### What bothers Haier? +Polling every 10 seconds is a bit much. The default interval for most integrations is 30 seconds. Even if the hOn app makes more requests more frequent, but it does it only in use and not 24/7. +As Haier explained in their answer, this generates a lot of traffic on the not so cheap aws hosting. I understand if Haier wishes a higher value here and will hopefully find a good solution with them. +_I had initially claimed 5 seconds, but it is actually "only" 10 seconds, see [this constant](https://github.com/Andre0512/hon/blob/main/custom_components/hon/const.py#L10)._ + +### How often has your plugin been installed? +Since the latest versions are downloaded about 3000 times each on GitHub, I assume 2000-5000 active installations. ### Are there some secret keys stored in the repository? There is a constant for a [client ID](https://github.com/Andre0512/pyhOn/blob/main/pyhon/const.py) and an [api key](https://github.com/Andre0512/pyhOn/blob/main/pyhon/const.py). They seems to be static because they are the same for requests from every account I saw. diff --git a/takedown_timeline.md b/takedown_timeline.md index e789b2e..fac922b 100644 --- a/takedown_timeline.md +++ b/takedown_timeline.md @@ -4,9 +4,9 @@ hon | 98 Stars | 23 Forks pyhOn | 17 Stars | 5 Forks -- Haier wrote the takedown mail -- Replied that I take it down in the next days -- Updated the README of Andre0512/pyhOn and Andre0512/hon +- Haier wrote the [takedown mail](https://github.com/Andre0512/hon/blob/main/takedown_faq.md#what-did-haier-wrote) +- [Replied](https://github.com/Andre0512/hon/blob/main/takedown_faq.md#what-did-you-answer-haier) that I take it down in the next days +- [Updated](https://github.com/Andre0512/hon/commit/14f133f3f471bf0b46a7ba3cd2e524b45446d125) the README of Andre0512/pyhOn and Andre0512/hon - Created a [new release](https://github.com/Andre0512/hon/releases/tag/v0.11.0) with takedown info, so people know why it was removed - Posted the info to the [community board](https://community.home-assistant.io/t/integration-with-haier-hon-app/322490/159?u=andre0512) - Talked to some friends that convinced me to not give up @@ -21,7 +21,13 @@ pyhOn | 18 Stars | 13 Forks - People in [#147](https://github.com/Andre0512/hon/issues/147) started to write their opinion on all available channels - [u/Waluicel](https://www.reddit.com/user/Waluicel/) created [a post](https://www.reddit.com/r/homeassistant/comments/197xc0m/haier_is_shutting_down_the_hacs_integration_hon/) on [r/homeassistant](https://www.reddit.com/r/homeassistant) that got 400+ comments - People started to contact journalists and organizations to help -- I had a call with an IT lawyer who pointed out many of the risks I was exposing myself to despite having insurance +- Had a call with an IT lawyer who pointed out many of the risks I was exposing myself to despite having insurance + +### 2024-01-17 +hon | 111 Stars | 73 Forks +pyhOn | 20 Stars | 42 Forks + +- [hectorzin](https://github.com/hectorzin) creates a first [YouTube video](https://www.youtube.com/watch?v=u2rEVW0grsk) ### 2024-01-18 hon | 122 Stars | 103 Forks @@ -31,29 +37,41 @@ pyhOn | 23 Stars | 64 Forks - Forks and stars of the repos started to blow up - BleepingComputer published an [article about the topic](https://www.bleepingcomputer.com/news/security/haier-hits-home-assistant-plugin-dev-with-takedown-notice/) - Home Assistant team got in touch with me -- I wrote Haier another mail and tried to get some clarification and reach some agreement -- [l00ps](https://github.com/l00ps) pointed out [who's the opponent](https://github.com/Andre0512/hon/issues/147#issuecomment-1899191758) +- Wrote Haier [another mail](https://github.com/Andre0512/hon/blob/main/takedown_faq.md#what-did-you-answer-haier) and tried to get some clarification and reach some agreement +- [l00ps](https://github.com/l00ps) pointed out [who's the opponent](https://github.com/Andre0512/hon/issues/147#issuecomment-1899191758) (Haier CEO has a crazy history xD) ### 2024-01-19 hon | 321 Stars | 711 Forks pyhOn | 121 Stars | 552 Forks -- Tech sites in many countries start to report about it eg [Hackaday](https://hackaday.com/2024/01/19/haier-threatens-legal-action-against-home-assistant-plugin-developer/), [Tweakers](https://tweakers.net/nieuws/217750/haier-stuurt-takedownverzoek-aan-home-assistant-plug-inontwikkelaar.html), [ilSoftware](https://www.ilsoftware.it/focus/smart-home-offline-per-svincolarsi-dagli-ecosistemi-chiusi-dei-singoli-produttori/) and [Caschys Blog](https://stadt-bremerhaven.de/home-assistant-haier-geht-gegen-plugin-entwickler-vor/) +- Tech sites in many countries started to report about it eg [Hackaday](https://hackaday.com/2024/01/19/haier-threatens-legal-action-against-home-assistant-plugin-developer/), [Tweakers](https://tweakers.net/nieuws/217750/haier-stuurt-takedownverzoek-aan-home-assistant-plug-inontwikkelaar.html), [ilSoftware](https://www.ilsoftware.it/focus/smart-home-offline-per-svincolarsi-dagli-ecosistemi-chiusi-dei-singoli-produttori/) and [Caschys Blog](https://stadt-bremerhaven.de/home-assistant-haier-geht-gegen-plugin-entwickler-vor/) - The Wikipedia articles of [Haier](https://en.wikipedia.org/wiki/Haier#Controversy) and [List of Streisand effect examples](https://en.wikipedia.org/wiki/List_of_Streisand_effect_examples#By_businesses) gets updated - [LauLaman](https://github.com/LauLaman) started [a petition in the Netherlands](https://www.petitie24.nl/petitie/5069/smart-home-lokaal-continu%C3%AFteit-en-veiligheid) _to force manufactories to provide local APIs and forcing them to opensource firmware as soon as they stop supporting devices_ -- Linus Tech Tips [talks about it in his WAN Show](https://www.youtube.com/watch?v=FBQVPOSeRe8&t=6580s) +- Linus Tech Tips [talked about it in his WAN Show](https://www.youtube.com/watch?v=FBQVPOSeRe8&t=6580s) - Haier US [answered on X](https://www.reddit.com/r/homeassistant/comments/19a615l/haier_us_supports_home_assistant_and_open_iot/) that they have nothing to do with it and support open IOT platforms - Haier Europe [created a blog post](https://corporate.haier-europe.com/press-release/hon-app-a-message-about-our-iot-and-ecosystem-vision/) and said they are _committed to enhancing the smart home scenarios in line with authorized usages and intellectual property rights of Haier Europe._ -- Mark Atwood, Principal Engineer in the Open Source Program Office at Amazon offers free consultant ### 2024-01-20 hon | 562 Stars | 1555 Forks pyhOn | 228 Stars | 1199 Forks -- Got an answer from Head of Brand & IOT Haier Europe, he proposed _scheduling a call involving our IOT Technology department to address the issue comprehensively and respond to any questions both parties may have._ +- [Got an answer](https://github.com/Andre0512/hon/blob/main/takedown_faq.md#what-was-haiers-reaction) from Head of Brand & IOT Haier Europe, he proposed _scheduling a call involving our IOT Technology department to address the issue comprehensively and respond to any questions both parties may have._ + +### 2024-01-22 +hon | 779 Stars | 1948 Forks +pyhOn | 315 Stars | 1477 Forks +- [The Register](https://www.theregister.com/2024/01/22/haier_plugin_takedown/) reported about the story +- [Hackaday](https://hackaday.com/2024/01/22/haier-europe-eases-off-on-legal-threat-and-seeks-dialogue/) and [Tweakers](https://tweakers.net/nieuws/217840/haier-trekt-takedownverzoek-aan-plug-indeveloper-in-geeft-api-calls-de-schuld.html) posted a follow up article about Haier eases off on legal threat and seeking a dialogue + +### 2024-01-23 +hon | 874 Stars | 2123 Forks +pyhOn | 349 Stars | 1590 Forks +- [heise online](https://www.heise.de/news/Hausgeraete-Hersteller-wollte-Open-Source-Projekt-loeschen-lassen-Loesung-in-Sicht-9606349.html) published an article ## Stats ![Forks](assets/forks.png) -![Stars](assets/stars.png) \ No newline at end of file +![Stars](assets/stars.png) + +![Github Stats](assets/github_stats.png) \ No newline at end of file