hllhll / HomeAssistant-EKON-iAircon

EKON iAircon / Tadiran climate component written in Python3 for Home Assistant. On the bases of Gree Climate component for easier interfacing with HASS
GNU General Public License v3.0
14 stars 7 forks source link

There's a new integration out there 100% local with no flashing of the device required! Feel free to try HomeAssistant-ekon-local

General warnings

Using this component may effect your hass installation stability, may report falsly the state of your HVAC, commands may seem to be working but they might not (such situation where u think you turned off the ac, but it didn't)

IT MIGHT ALSO MESS APP THE REGULAR APP USAGE. In this case, you should remove the component and restart the iAircon box either by disconnecting it from the supply of the of the AC Controller and reconnect (i.e. the phone cord that doesn't go to the screen). Or by triping the switch in the electrical panel.

The integration was only tested against "Tadiran connect" from Ekon And yet to be tested for "Airconet+" app, But it should work. For switching the app, follow the guidnce below.

What types of HVACs? / ACs?

Short: Tadiran mini-central ACs, other iAircon/EKON/Airconet Based ACs Long: There's a compony out there Called EKON, They have a product named iAircon which is a esp8266 hardware device, or the marketing name "Airconet+" (available on play store, formerly "Airconet") that connects to the HVAC system

Unfortunately, No API or documentation exist for this cloud service. This is where this repo comes in

Israeli HVACs manefacturer "TADIRAN" Uses this ekon solution for their "Tadiran connect" product, designated for some of their "mini central hvacs"

HomeAssistant-HomeAssistant-EKON-iAircon

EKON iAircon / Tadiran climate component written in Python3 for Home Assistant. Built on the bases of Gree Climate component for easier interfacing with HASS

Custom Component Installation

  1. Copy the custom_components folder to your own hassio /config folder.

  2. UPDATE: If you one to use Airconet, you would have to disable encryption and your password would not be secure. see below Choose the server you want to work with (Airconet/Tadiran). If you are using Airconet app you are currently using the EKON Main server If you are using Tadiran connect app you are currently using (what I call) Tadiran server

  3. If you want to work on a server OTHER then the one you are currently using, setup an account with the app, reset the wifi-controller-thing and pair it with the app and the new account. For example, you might currently be using Tadiran connect app, but this component was only tested on the main server. Install "Airconet", login/create an account, on the tadiran connect electronics thing, press and hold the reset button. The button is reachabe via a hole in the plastic under the sticker. You can also open the plastic box carefully. Hold the buttun untill the led blinks in 2 colors (blue/purpule) the box is in pairing mode, now using the Airconet app, add it to your account. 3.1. Verify that HomeAssistant server has permissions to read custom_components folder. Recommended is 0744 (read everyone, write owner)

  4. In your configuration.yaml add the following:

    climate: 
    - platform: ekon
     # This currently unused:
     name: Main account
     # Specify the name and password for your account
     username: my@account.com
     password: myPassword
     # This specifies the server that the component would work with, I have only tried it with EKON server (Airconet+ APP)
     # Optional, 
     # Use this if you are using "Airconet+" app - EKON main server
     # base_url and ws_url defults to Airconet server
     base_url: https://www.activate-ac.com/ 
     ws_url: wss://www.activate-ac.com/v2
    
     # If you are using Tadiran Connect, use these instead
     # base_url: https://www.airconet.xyz/
     # ws_url: wss://www.airconet.xyz/ws
    
     # WARNING, Enabling this next option would MAKE YOUR CEDENTIALS PRUNE TO MAN-IN-THE-MIDDLE Attack
     # Homeassistant ssl libraries in certain configurations has some issues with authenticating the www.activate-ac.com server SSL Certificate
     # One really bad option is to disable ssl checks altogether, you can use this switch to do that:
     # ssl_ignore: True
  5. OPTIONAL: Add info logging to this component (to see if/how it works)

    logger:
     default: error
     logs:
       custom_components.ekon: debug
  6. OPTIONAL: Add entity names for the HVACs under the user. In the climate block under the ekon platform add the following, entitiy names are assigned by their id, that is the XXX under the default HVAC name EkonXXX

     username: ...
     password: ...
     ...
     name_mapping:
     - id: XXX
       name: MyHvac

Tips

Troubleshooting (old, maybe usefull)