Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/qqaatw/jcihitachiha

A home assistant integration for controlling Jci-Hitachi devices, using LibJciHitachi backend. 台灣日立雲端模組
https://github.com/qqaatw/jcihitachiha

hitachi home-assistant home-automation homeassistant homekit

Last synced: 1 day ago
JSON representation

A home assistant integration for controlling Jci-Hitachi devices, using LibJciHitachi backend. 台灣日立雲端模組

Awesome Lists containing this project

README 

        
# Jci-Hitachi Home Assistant Integration



[![System Status](https://github.com/qqaatw/LibJciHitachi/actions/workflows/Status.yml/badge.svg)](https://github.com/qqaatw/LibJciHitachi/actions/workflows/Status.yml)



*If you find the project useful and want to support it, you can buy me a chocolate cake via [Jkopay(街口)](.github/jkopay.jpg) or [ko-fi](https://ko-fi.com/qqaatw). Your name will be listed on [Chocolate Cake Buyers](ChocolateCakeBuyers.md).*



## Feature

A home assistant integration for controlling Jci Hitachi devices, using [LibJciHitachi](https://github.com/qqaatw/LibJciHitachi) backend.



## Installation



### Configuring via UI



1. Create `config/custom_components` folder if not existing.

2. Copy `jcihitachi_tw` into `custom_components` folder.

3. Click `Configuration` button on the left side of Home Assistant panel, and then click `Integrations` tab.

4. Click `ADD INTEGRATION` button at the bottom right corner and follow the UI.



### Configuring via `configuration.yaml`



1. Create `config/custom_components` folder if not existing.

2. Copy `jcihitachi_tw` into `custom_components` folder.

3. Configure your email address, password, and device names, in `config/configuration.yaml`. If device names are not provided, they will be fetched from the API automatically. (not recommended.)

4. Restart Home Assistant.



*An example of `configuration.yaml` can be found [here](configuration.yaml).*



## Supported devices



*支援以下使用日立雲端模組(雲端智慧控)的機種與功能*



- Hitachi Air Conditioner 日立冷氣

  - Power 電源

  - Mode 運轉模式

  - Air speed 風速

  - Vertical wind swingable 導風板垂直擺動

  - Vertical wind direction 導風板垂直方向

  - Horizontal wind direction 導風板水平方向

  - Target temperature 目標溫度

  - Indoor temperature 室內溫度

  - Mold prevention 機體防霉

  - Energy saving 節電

  - Fast operation 快速運轉

  - Power consumption 用電統計 (supports HA core v2021.9.0+)

  - Monthly power consumption 月用電統計

  - ~~Sleep timer 睡眠計時器~~ (Only supported by LibJciHitachi)

  - ~~Freeze clean 凍結洗淨~~ (Only supported by LibJciHitachi)

- Hitachi Dehumidifier 日立除濕機

  - Power 電源

  - Mode 運轉模式

  - Air speed 風速

  - Wind swingable 導風板擺動

  - Target humidity 目標濕度

  - Indoor humidity 室內溼度

  - Water full warning 滿水警示

  - Error warning 錯誤警示

  - Clean filter notify 濾網清潔通知

  - Mold prevention 機體防霉

  - PM2.5 value PM2.5數值

  - Odor level 異味等級

  - Air cleaning filter setting 空氣清淨濾網設定

  - Power consumption 用電統計 (supports HA core v2021.9.0+)

  - Monthly power consumption 月用電統計

  - Display brightness 顯示器亮度

  - Ion 負離子

  - Keypad Lock 按鍵鎖

  - ~~Sound control 聲音控制~~ (Only supported by LibJciHitachi)

  - ~~Side vent 側吹~~ (Only supported by LibJciHitachi)

- Hitachi Heat Exchanger 日立全熱交換機

  - Power 電源

  - Breath mode 換氣模式

  - Air speed 風速

  - Indoor temperature 室內溫度

  - ~~Mode 運轉模式~~ (Only supported by LibJciHitachi)

  - ~~Error code 錯誤代碼~~ (Only supported by LibJciHitachi)

  - ~~Air cleaning filter notification 空氣清淨濾網清潔通知~~ (Only supported by LibJciHitachi)

  - ~~Front filter notification 前置濾網清潔通知~~ (Only supported by LibJciHitachi)

  - ~~PM25 filter notification PM25濾網清潔通知~~ (Only supported by LibJciHitachi)



## Tested devices



*Below models have been tested on my side or reported by someone whose device works normally. Unlisted models DO NOT MEAN they are not supported.*



### Air conditioner



- Window

  - RA-36NV1

  - RA-28NV1

- Single-split and multi-split

  - RAD-90NJF / RAC-90NK1

  - RAS-81NJF

  - RAS-81NK

  - RAC-63NK

  - RAS-50NJF / RAC-50NK

  - RAS-40NK

  - RAS-40NT / RAC-40NP

  - RAS-36NJF / RAC-36NK

  - RAS-36NK  / RAC-36NK1

  - RAS-32NJF

  - RAS-28NJF / RAC-28NK

  - RAS-28NB / RAC-28NB

  - RAS-22NJF

- Business

  - RPI-90FK

  - RPI-36FR

  - RPI-28FT

  - RPI-22FC



### Dehumidifier



- RD-360HH

- RD-240HH

- RD-200HH

- RDI-640HH

- RDI-360DX



### Heat exchanger



- KPI-H



## Frequently asked questions



1. Is the integration usable (does the Hitachi cloud work) ? 

   - If the system status badge on the top is green, the Hitachi cloud worked normally at the last nightly check. Please do not open an issue asking the usability of the integration.

2. I cannot install the integration, the log indicates `Requirements for jcihitachi_tw not found: ['LibJciHitachi==x.x.x']`, where x is an arbitrary version number.

    - Ensure the OS in which your Home Assistant is installed is of the following types: `Windows`, `macOS`, `manylinux`, and `musllinux`, on x86 or ARM platforms. Only 64bit OSes on ARM are supported. Other platforms such as PowerPC and MIPS are not supported.

    - If you still want to run the integration on unsupported platforms, you will need to build(compile) it on your own.

3. When auto mode or fan mode is set, the target temperature stays at the target set in cool/dry/heat mode.

    - If this entity didn't get a valid target temperature before, the target temperature will indicate the minimum temperature.

    - Technically, because the target temperature is not intended to be adjusted by users and changes automatically under auto mode or fan mode, the value is set 2-complement `-1` in 16 bit data type (a.k.a. `65535`) by the Hitachi cloud. We have modified the displayed value to avoid the Home Assistant history plot scales to `65535`.

    - If it is still showing a huge number, please refer to PR #36, you may add extra edge conditions by yourself.



## Known issues



1. Clean filter notification of the dehumidifier doesn't work now.



## License



Apache License 2.0