TionAPI / HA-tion

Home assistant integration for Tion breezers
Apache License 2.0
72 stars 6 forks source link
home-automation internet-of-things iot python tion

version_badge

Custom integration for Tion S3, S4 and Lite breezers for Home Assistant

This custom integration will allow your Home assistant to control:

of your Tion S3/S4/Lite breezer via bluetooth. If you are prefer control breezer via Magic Air, please follow to https://github.com/airens/tion_home_assistant repository.

:warning: Please remember that breezer is not heating device and don't try use it for room heating :warning:

disclaimer: everything that you do, you do at your own peril and risk

How to use

Requirements

  1. BTLE supported host with Home Assistant
  2. Tion S3, S4 or Lite breezer

Installation & configuration

HACS installation

  1. goto HACS->Integrations->three dot at upper-right conner->Custom repositories;
  2. add TionAPI/HA-tion to ADD CUSTOM REPOSITORY field and select Integration in CATEGORY;
  3. click "add" button;
  4. find "Tion breezer" integration;
  5. click "Install". Home assistant restart may be required;

Configuration via User interface

  1. go to Integrations page;
  2. click "plus" button;
  3. type "Tion" in search field;
  4. click on "Tion breezer integration";
  5. fill fields;
  6. click "Next" and follow instructions;
  7. restart Home Assistant.

    Repeat this steps for every device that you are going to use with home assistant.

Usage

Turning on / Turning off

Automation example

automations.yaml:

- id: 'tion1'
  alias: 1 speed for tion by co2 < 500
  trigger:
  - platform: numeric_state
    entity_id: sensor.mhz19_co2
    below: '500'    
    for: 00:05:00    
  condition:
  - condition: not
    conditions:
    - condition: state
      entity_id: climate.tion_breezer
      state: 'off'
  action:
  - service: climate.set_fan_mode
    entity_id: climate.tion_breezer
    data:
      fan_mode: 1    

- id: 'tion4'
  alias: 4 speed for tion with co2 > 600
  trigger:
  - platform: numeric_state
    entity_id: sensor.mhz19_co2
    above: '600'    
    for: 00:05:00    
  condition:
  - condition: time     #don't turn on fan at speed 4 from 22:00 to 08:00 
    after: '08:00:00'
    before: '22:00:00'    
  - condition: not
    conditions:
    - condition: state
      entity_id: climate.tion_breezer
      state: 'off'
  action:
  - service: climate.set_fan_mode
    entity_id: climate.tion_breezer
    data:
      fan_mode: 4  

Error reporting

Feel free to open issues.
Please attach debug log to issue.
For turning on debug log level you may use following logger settings in configuration.yaml:

logger:
  default: warning
  logs:
    custom_components.ha_tion_btle: debug
    tion_btle.tion: debug
    tion_btle.s3: debug    
    tion_btle.lite: debug
    tion_btle.s4: debug
    custom_components.ha_tion_btle.config_flow: debug