mirrors/hOn
1
0
Fork 0
mirror of https://github.com/Andre0512/hon.git synced 2024-12-22 10:45:30 +00:00
Code Issues Packages Projects Releases Wiki Activity

Update reamde with latest development

Browse source
This commit is contained in:
Andre Basche 2024-02-02 18:51:47 +01:00
parent 9870de2a42
commit a9e2cd0c05
3 changed files with 25 additions and 24 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

3
README.md
View file

@ -20,11 +20,12 @@ Home Assistant integration for [Haier's mobile app hOn](https://hon-smarthome.co
[![Supported Entities](https://img.shields.io/badge/Entities-317-crimson)](https://github.com/Andre0512/hon#supported-appliances) [![Supported Entities](https://img.shields.io/badge/Entities-317-crimson)](https://github.com/Andre0512/hon#supported-appliances)
## Takedown Story ## Takedown Story
Haier sent a takedown notice and threatened legal action. The community started a big riot and called for a Haier boycott, the repository was forked over 2000+ times to make the code undeletable. Haier was made to rethink and plans to support the integration. Read all about it here: Haier sent a takedown notice and threatened legal action. The community started a big riot and called for a Haier boycott, the repository was forked over 2000+ times to make the code undeletable. Haier starts a dialog to find a joint solution. Read all about it here:
- [Timeline of events](https://github.com/Andre0512/hon/blob/main/takedown_timeline.md) - [Timeline of events](https://github.com/Andre0512/hon/blob/main/takedown_timeline.md)
- [Takedown FAQs](https://github.com/Andre0512/hon/blob/main/takedown_faq.md) - [Takedown FAQs](https://github.com/Andre0512/hon/blob/main/takedown_faq.md)
- [Main discussion](https://github.com/Andre0512/hon/issues/147) - [Main discussion](https://github.com/Andre0512/hon/issues/147)
- [Summary video](https://www.youtube.com/watch?v=ayG7o74kdbc) - [Summary video](https://www.youtube.com/watch?v=ayG7o74kdbc)
- [Haier's Statement](https://github.com/Andre0512/hon/issues/147#issuecomment-1923622715)
## Supported Appliances ## Supported Appliances
_Click to expand..._ _Click to expand..._

18
takedown_faq.md
View file

@ -1,6 +1,6 @@
## Takedown FAQs ## Takedown FAQs
_Last update: 2024-01-24_ _Last update: 2024-02-02_
### What did Haier wrote? ### What did Haier wrote?
Haier Europe wrote me on 2024-01-15 [this email](assets/takedown.eml): Haier Europe wrote me on 2024-01-15 [this email](assets/takedown.eml):
@ -14,9 +14,9 @@ I think the points are very questionable, but I'm a software developer and not a
**2024-01-15** **2024-01-15**
In the first moment of getting the mail I was absolutely shocked, I didn't think that someone cares about me and my little plugin and I know Haier is a billion dollar company, so I answered In the first moment of getting the mail I was absolutely shocked, I didn't think that someone cares about me and my little plugin and I know Haier is a billion dollar company, so I answered
![answer 1](assets/answer_1.png) ![answer 1](assets/answer_1.png)
after that i announced to take it down and then you guys happened. after that I announced to take it down and then the community does its thing.
**2024-01-19** **2024-01-19**
I'm getting so much support, and you started a huge wave, I mean we are now an example for the [Streisand effect on wikipedia](https://en.wikipedia.org/wiki/List_of_Streisand_effect_examples#By_businesses) xD I'm getting so much support, and the community started a huge wave and created the Streisand effect.
I wrote another mail on and tried to get some clarification and reach some agreement: I wrote another mail on and tried to get some clarification and reach some agreement:
![answer 2](assets/answer_2.png) ![answer 2](assets/answer_2.png)
@ -27,11 +27,10 @@ Haier Europe [created a blog post](https://corporate.haier-europe.com/press-rele
**2024-01-20** **2024-01-20**
Gianpiero Morbello, Head of Brand & IOT Haier Europe, wrote this mail: Gianpiero Morbello, Head of Brand & IOT Haier Europe, wrote this mail:
![haier response](assets/haier_response.png) ![haier response](assets/haier_response.png)
**Update: See [Timeline of events](https://github.com/Andre0512/hon/blob/main/takedown_timeline.md) for further development**
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? ### Are you in contact with Home Assistant?
The Home Assistant/Nabu Casa 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 Paulus Schoutsen is part of the conversation with Haier.
### Did you agree to Haier's tos? ### 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. 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.
@ -60,7 +59,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) - 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** **Status polling**
- 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)) - 1 request every 10 seconds (**Update: 60 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** **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 - If any action is triggerd, e.g. start some appliance or set a new a/c mode, some data have to be posted
@ -71,10 +70,11 @@ This are all requests the plugin sends to Haiers servers
### What bothers Haier? ### 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. 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. 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)._ **Update 1: 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).**
**Update 2: After discussion with Haier, we have switched to 60-second polling and are trying to work out a better solution.**
### How often has your plugin been installed? ### How often has your plugin been installed?
Since the latest versions are downloaded [about 3000 times](https://tooomm.github.io/github-release-stats/?username=Andre0512&repository=hon) each on GitHub, I assume 2000-5000 active installations. Since the latest versions are downloaded [about 3000 times](https://tooomm.github.io/github-release-stats/?username=Andre0512&repository=hon) each on GitHub, I assume 2000-4000 active installations.
### Are there some secret keys stored in the repository? ### 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. 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.

28
takedown_timeline.md
View file

@ -12,13 +12,14 @@ pyhOn | 17 Stars | 5 Forks
- Talked to some friends that convinced me to not give up - Talked to some friends that convinced me to not give up
- Asked on the home assistant discord to how to handle this, got the info on discord that my integration does not violate the law - Asked on the home assistant discord to how to handle this, got the info on discord that my integration does not violate the law
- [Extreme79](https://github.com/Extreme79) created an [the issue #147](https://github.com/Andre0512/hon/issues/147) to disscuss how to help - [Extreme79](https://github.com/Extreme79) created an [the issue #147](https://github.com/Andre0512/hon/issues/147) to disscuss how to help
- People started to fork, copying the code to other hosting platforms and save it offline
- Talked to my law insurance and after a talk with a general lawyer I have been given permission to consult a lawyer of my choice - Talked to my law insurance and after a talk with a general lawyer I have been given permission to consult a lawyer of my choice
### 2024-01-16 ### 2024-01-16
hon | 100 Stars | 32 Forks hon | 100 Stars | 32 Forks
pyhOn | 18 Stars | 13 Forks pyhOn | 18 Stars | 13 Forks
- People in [#147](https://github.com/Andre0512/hon/issues/147) started to write their opinion on all available channels - People in [#147](https://github.com/Andre0512/hon/issues/147) started to write their opinion to Haier on all available channels (X, mails, support form, reviews, ...)
- [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 - [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 - People started to contact journalists and organizations to help
- 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
@ -39,12 +40,13 @@ pyhOn | 23 Stars | 64 Forks
- Home Assistant team got in touch with me - Home Assistant team got in touch with me
- 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 - 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) - [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)
- Forms like [Reddit](https://www.reddit.com/r/homeassistant/comments/199uzbu/haier_attacks_home_assistant_destroys_open_source/), [Hacker News](https://news.ycombinator.com/item?id=39044932), [HA Community](https://community.home-assistant.io/t/haier-hits-home-assistant-plugin-dev-with-takedown-notice-lets-fork/675784), [linux.org.ru](https://www.linux.org.ru/news/opensource/17493319), [Hubitat](https://community.hubitat.com/t/haier-europe-sends-take-down-notice-to-ha-developer/132166), [femboys](https://femboys.bar/post/292973) started to discuss the topic
### 2024-01-19 ### 2024-01-19
hon | 321 Stars | 711 Forks hon | 321 Stars | 711 Forks
pyhOn | 121 Stars | 552 Forks pyhOn | 121 Stars | 552 Forks
- 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/) - 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/), [ipFail](https://ipfail.org/broken-internet/haier-troll-vs-home-assistant/), [Scurt Pe Doi](https://scurtpedoi.ro/diverse/2024/haier-vs-home-assistant-controlul-open-source.html3), [iGeneration](https://www.igen.fr/domotique/2024/01/domotique-haier-veut-son-tour-bloquer-une-integration-dans-home-assistant-141587), [Smarthome Assistent](https://www.smarthomeassistent.de/home-assistant-haier-verbietet-den-einsatz-von-plugins/) 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 - 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_ - [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 [talked 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)
@ -57,22 +59,20 @@ pyhOn | 228 Stars | 1199 Forks
- [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._ - [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 ### 2024-01-22 - 2024-01-27
hon | 779 Stars | 1948 Forks hon | 779 Stars | 1948 Forks
pyhOn | 315 Stars | 1477 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/), [Caschys Blog](https://stadt-bremerhaven.de/haier-und-home-assistant-es-koennte-weitergehen/) 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 - [Hackaday](https://hackaday.com/2024/01/22/haier-europe-eases-off-on-legal-threat-and-seeks-dialogue/), [Caschys Blog](https://stadt-bremerhaven.de/haier-und-home-assistant-es-koennte-weitergehen/) 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
- [The Register](https://www.theregister.com/2024/01/22/haier_plugin_takedown/) and [heise online](https://www.heise.de/news/Hausgeraete-Hersteller-wollte-Open-Source-Projekt-loeschen-lassen-Loesung-in-Sicht-9606349.html) reported about the story
- [Everything Smart Home](https://www.youtube.com/watch?v=ayG7o74kdbc) and [Un loco y su tecnología](https://www.youtube.com/watch?v=P-kjoy1CS38) uploaded good summaries on YouTube
- [Hackaday](https://hackaday.com/2024/01/26/hackaday-podcast-episode-254-ai-hijack-guy-and-water-rockets-fly/#more-660935) discussed the topic in their podcast
### 2024-01-23 ### 2024-01-28 - 2024-02-04
hon | 874 Stars | 2123 Forks hon | 1038 Stars | 2436 Forks
pyhOn | 349 Stars | 1590 Forks pyhOn | 409 Stars | 1790 Forks
- [heise online](https://www.heise.de/news/Hausgeraete-Hersteller-wollte-Open-Source-Projekt-loeschen-lassen-Loesung-in-Sicht-9606349.html) published an article - Call with Haier and Paulus Schoutsen (Founder of Home Assistant) [to discuss things with the result to work together](https://github.com/Andre0512/hon/issues/147#issuecomment-1915355303)
- Released [v0.12.0](https://github.com/Andre0512/hon/releases/tag/v0.12.0) with 60 seconds polling
### 2024-01-24 - [Haier replies](https://github.com/Andre0512/hon/issues/147#issuecomment-1923622715) to the complaint email of [AtomicFS](https://github.com/AtomicFS) and others
hon | 894 Stars | 2194 Forks
pyhOn | 358 Stars | 1650 Forks
- [Everything Smart Home](https://www.youtube.com/watch?v=ayG7o74kdbc) uploaded a good summary on YouTube
## Stats ## Stats