https://github.com/kyle-seongwoo-jun/homebridge-navien-smart

Homebridge plugin to control Navien devices via Navien Smart
https://github.com/kyle-seongwoo-jun/homebridge-navien-smart

homebridge homebridge-plugin homekit iot navien

Last synced: 29 days ago
JSON representation

Homebridge plugin to control Navien devices via Navien Smart

• Host: GitHub
• URL: https://github.com/kyle-seongwoo-jun/homebridge-navien-smart
• Owner: kyle-seongwoo-jun
• License: apache-2.0
• Created: 2024-01-05T05:13:32.000Z (10 months ago)
• Default Branch: latest
• Last Pushed: 2024-08-03T21:01:51.000Z (3 months ago)
• Last Synced: 2024-09-27T08:20:51.216Z (about 1 month ago)
• Topics: homebridge, homebridge-plugin, homekit, iot, navien
• Language: TypeScript
• Homepage: https://www.npmjs.com/package/homebridge-navien-smart
• Size: 958 KB
• Stars: 4
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README-ko.md
  • Changelog: CHANGELOG.md
  • License: LICENSE

Awesome Lists containing this project

README

        








# Homebridge Navien Smart



[🇺🇸 English Version](README.md) | **[🇰🇷 한국어 버전](README-ko.md)**

## 둘러보기

![demo](https://raw.githubusercontent.com/kyle-seongwoo-jun/homebridge-navien-smart/latest/docs/demo.jpg)

나비엔 스마트를 통해 나비엔 기기를 제어하는 플러그인.

"나비엔 스마트" 시스템과 상호 작용하는 플러그인으로, 나비엔 기기를 제어할 수 있습니다. 이 플러그인에서 사용된 API는 공식적이지 않으며, "나비엔 스마트" 모바일 앱에서 리버싱을 통해 얻었습니다.

### ⚠️ 경고

이 플러그인은 `나비엔 EME520 (퀸 사이즈)` 모델에서만 테스트되었습니다. 다른 모델에서는 작동하지 않을 수 있습니다. 다른 모델을 사용하는 경우 지원 요청 이슈를 열어주세요.

자세한 정보는 [구현 상태](#구현-상태)를 참조하세요.

## 설치

```shell

npm i -g homebridge-navien-smart

```

# 설정

```json

{

    "authMode": "account",

    "username": "",

    "password": "",

    "accessoryType": "HeaterCooler",

    "platform": "NavienSmart"

}

```

```json

{

    "authMode": "token",

    "username": "",

    "refreshToken": "",

    "accountSeq": 12345678,

    "accessoryType": "HeaterCooler",

    "platform": "NavienSmart"

}

```

| *키* | *설명* |

| --- | --- |

| `authMode` | 필수. `token`과 `account` 중 하나를 선택할 수 있습니다. |

| `username` | 필수. 나비엔 스마트 계정 |

| `password` | `authMode`가 `account`인 경우 필수. 나비엔 스마트 비밀번호 |

| `refreshToken` | `authMode`가 `token`인 경우 필수. `navien` CLI로 얻을 수 있습니다. |

| `accountSeq` | `authMode`가 `token`인 경우 필수. `navien` CLI로 얻을 수 있습니다. |

| `accessoryType` | 필수. `HeaterCooler`와 `Thermostat` 중 하나를 선택할 수 있습니다. |

| `platform` | 항상 `NavienSmart` |

비밀번호를 설정 파일에 넣고 싶지 않은 경우 `authMode`를 `token`으로 설정하고 대신 `refreshToken`과 `accountSeq`를 사용할 수 있습니다.

`refreshToken`과 `accountSeq`는 `navien` CLI를 통해 얻을 수 있습니다. 자세한 내용은 [CLI 사용방법](#cli-사용방법)을 참조하세요.

## 구현 상태

| *장치*       | *구현* | *상태* | *제어* |

|----------------| --- | --- | --- |

| 보일러         | 🚫 | 🚫 | 🚫 |

| EME 모델     | ✔️ | ✔️ | ✔️ |

| EQM 모델     | 🚫 | 🚫 | 🚫 |

다른 장치 지원을 원하시면 이슈 요청을 열어주세요.

## CLI 사용방법

```shell

$ navien

Usage: navien  

```

```shell

$ npm install -g homebridge-navien-smart

$ navien  

Logging in with username: , password: 

refreshToken: XXXXXXXXXXX.XXXXXXXXX.XXXXXXXXX

accountSeq: 12345678

```

`refreshToken`과 `accountSeq`를 복사하여 설정 파일에 붙여넣으면 됩니다.

## 데모 영상

### 시리 (음성 제어)

[![siri demo](https://img.youtube.com/vi/FpLxOSHVeKw/0.jpg)](https://youtu.be/FpLxOSHVeKw)

### 위젯 (홈 앱 / 컨트롤 센터)

[![widget demo](https://img.youtube.com/vi/lCtJF57DZQk/0.jpg)](https://youtu.be/lCtJF57DZQk)