Skip to content

Commit

Permalink
Update README.MD
Browse files Browse the repository at this point in the history
  • Loading branch information
svmironov committed Feb 12, 2024
1 parent 6e97f4d commit fd80ddc
Show file tree
Hide file tree
Showing 2 changed files with 34 additions and 14 deletions.
39 changes: 25 additions & 14 deletions README.MD
Original file line number Diff line number Diff line change
@@ -1,28 +1,27 @@
# AirCloud Home Assistant Integration

![Logo](https://github.com/svmironov/aircloud_ha/blob/main/custom_components/aircloud/img/icon.png?raw=true)

This integration allows control Hitachi climate devices whit connected airCloud Home service.
For change temperature with step 0.5 recommend uses a alternative thermostat UI

## Features

* Temperature change
* Modes: HEATING, COOLING, FAN, DRY
* Swing modes: VERTICAL, HORIZONTAL, BOTH

Integration does not currently support authorization by a phone and FrostWash mode. You're a model may not support some modes, but you will see it in the UI.

AirCloud API have low performance. Execution of commands and updating the UI occurs with latency from 1 to 5 seconds

## Installation

First install HACS if you don't have it yet. Add https://github.com/svmironov/aircloud_ha to HACS as user repository.

## Configuration

You can add integration in the UI or manual in configuration.yml

air_cloud:
email: "login" #supported only email authorization
email: "login" # supported only email authorization
password: "pass"
temp_adjust: -1 #optional parameter for adjustment current temp
temp_adjust: -1 # optional parameter for adjustment current temp

climate:
- platform: air_cloud
Expand All @@ -31,10 +30,22 @@ All devices be loaded from AirCloud. For every device be created HA entity with

## Sample lovelace object

type: custom:simple-thermostat
entity: climate.kitchen_ac
header:
name: Kitchen AC
layout:
mode:
headings: false
- type: thermostat
entity: climate.kitchen_ac

## Usages

Integration does not currently support authorization by a phone and FrostWash mode. You're a model may not support some modes, but you will see it in the UI.
AirCloud API have low performance. Execution of commands and updating the UI occurs with latency from 1 to 5 seconds

The integration provides a service for a single command:

service: air_cloud.exec_command
data:
id: 15187 # AirCloud ID from developer panel
power: "OFF" # ON/OFF
target_temp: 24
mode: COOLING # HEATING, COOLING, FAN, DRY or AUTO
fan_speed: LV1 # Speed LV1-LV5 or AUTO
fan_swing: "OFF" # VERTICAL, HORIZONTAL, BOTH or OFF
humidity: 0 # It is magic number, select experimentally for your model from 0, 50, 2147483647
9 changes: 9 additions & 0 deletions test/service_data.yml
Original file line number Diff line number Diff line change
@@ -0,0 +1,9 @@
service: air_cloud.exec_command
data:
id: 15187
power: "OFF"
target_temp: 20.0
mode: "COOLING"
fan_speed: "LV1"
fan_swing: "OFF"
humidity: 0

0 comments on commit fd80ddc

Please sign in to comment.