JSPM

homebridge-xiaomi-airpurifier-km81

1.0.4
  • ESM via JSPM
  • ES Module Entrypoint
  • Export Map
  • Keywords
  • License
  • Repository URL
  • TypeScript Types
  • README
  • Created
  • Published
  • Downloads 12
  • Score
    100M100P100Q53475F
  • License ISC

Homebridge plugin for Xiaomi Air Purifier (2S/Pro) with optimistic UI updates and optional Temperature/Humidity/AirQuality sensors.

Package Exports

  • homebridge-xiaomi-airpurifier-km81
  • homebridge-xiaomi-airpurifier-km81/index.js

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (homebridge-xiaomi-airpurifier-km81) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

homebridge-xiaomi-airpurifier

최신 Homebridge 및 Node.js 환경에 최적화된 Xiaomi Mi Air Purifier 2S 및 Pro를 위한 현대적인 단일 파일 Homebridge 플러그인입니다.

이 플러그인은 YinHangCode/homebridge-mi-airpurifier의 원본 작업을 기반으로 완전히 재작성되었습니다.

지원 기기

  • Xiaomi Mi Air Purifier 2S (zhimi.airpurifier.ma2)
  • Xiaomi Mi Air Purifier Pro (zhimi.airpurifier.v6)

설치 방법

  1. 공식 설명서에 따라 Homebridge를 설치하세요.
  2. 다음 명령어를 사용하여 이 플러그인을 설치하세요:
    npm install -g homebridge-xiaomi-airpurifier-km81

설정 방법

config.json 파일에 아래 플랫폼 설정을 추가하세요:

"platforms": [
    {
        "platform": "XiaomiAirPurifierPlatform",
        "deviceCfgs": [
            {
                "type": "MiAirPurifier2S",
                "ip": "192.168.1.XX",
                "token": "YOUR_32_CHARACTER_TOKEN",
                "name": "거실 공기청정기",
                "showTemperature": true,
                "temperatureName": "거실 온도",
                "showHumidity": true,
                "humidityName": "거실 습도",
                "showAirQuality": true,
                "airQualityName": "거실 공기질",
                "showModeSwitches": true
            }
        ]
    }
]

설정 항목 설명

  • platform: 반드시 "XiaomiAirPurifierPlatform" 이어야 합니다.
  • deviceCfgs: 사용 중인 공기청정기 기기 목록을 배열 형태로 입력합니다.
    • name: HomeKit에 표시될 공기청정기의 기본 이름입니다. (필수)
    • ip: 공기청정기의 고정 IP 주소입니다. (필수)
    • token: 32자리 Mi Home 기기 토큰입니다. (필수)
    • type: 기기 모델명입니다. "MiAirPurifier2S" 또는 "MiAirPurifierPro" 중 하나를 선택합니다. (필수)
    • showTemperature (선택 사항, 기본값: true): 온도 센서를 표시할지 여부를 결정합니다.
    • temperatureName (선택 사항): 온도 센서의 이름을 별도로 지정합니다. 지정하지 않으면 '공기청정기 이름 + Temperature'로 표시됩니다.
    • showHumidity (선택 사항, 기본값: true): 습도 센서를 표시할지 여부를 결정합니다.
    • humidityName (선택 사항): 습도 센서의 이름을 별도로 지정합니다.
    • showAirQuality (선택 사항, 기본값: true): 공기질 센서를 표시할지 여부를 결정합니다.
    • airQualityName (선택 사항): 공기질 센서의 이름을 별도로 지정합니다.
    • showLED (선택 사항, 기본값: false): 기기 LED 화면을 제어하는 스위치를 표시합니다.
    • showBuzzer (선택 사항, 기본값: false): 기기 부저(알림음)를 제어하는 스위치를 표시합니다.
    • showModeSwitches (선택 사항, 기본값: false): 자동/수면/선호 모드를 제어하는 3개의 개별 스위치를 표시합니다. 이 스위치들은 기기의 실제 작동 모드를 실시간으로 반영하여 해당 스위치가 켜진 상태를 유지하며, 하나를 켜면 나머지는 자동으로 꺼집니다.

토큰(Token) 추출 방법

Mi Home 앱 백업에서 토큰을 추출하려면 python-miio 도구나 커뮤니티에서 제공하는 다른 방법을 사용할 수 있습니다.