필립스 휴(Philips Hue)


필립스 Hue 제품군은 Wifi, Bluetooth, Zigbee 3가지 통신방식의 제품들이 존재합니다.

그 중에서 현재 가장 많이 쓰는 통신방식은 Zigbee 제품임으로 Zigbee2mqtt 설치방법를 통해 필립스 Hue 제품군들을 설치하시길 권장합니다.

zigbee2mqtt의 필립스 Hue 장치들의 지원 목록을 참조하십시오.

이외에도 Zigbee2mqtt는 2020년 2월 17일 현재 112개 회사의 584개 장치들을 공식 지원합니다.


이하 필립스 Hue 번역

Philips Hue support는 조명과 센서 플랫폼을 구동할 수 있는 허브로 Home Assistant에 통합되어 있습니다. Philips Hue 플랫폼을 설정하는 기본 방법은 discovery를 활성화하는 것입니다.

현재 홈어시스턴트에는 다음과 같은 장치 유형이 지원됩니다. :

  • 조명
  • 모션 센서 (온도와 조도 센서 포함)

이 통합구성요소를 설정하려면 사이드바에서 설정을 클릭한 다음 통합구성요소를 클릭하십시오. 발견된 섹션에 “Philips Hue”가 표시되어야합니다. (그렇지 않은 경우 오른쪽 하단의 + 아이콘을 클릭하고 필립스 휴를 찾으십시오.) 설정을 클릭하면 시작 대화 상자가 나타납니다. Hue 브릿지의 버튼을 눌러 홈어시스턴트로 허브를 등록하라는 메시지가 표시됩니다. 제출을 클릭하면 브릿지가 있는 구역을 선택할 수 있습니다.

Home Assistant에서 Hue 브릿지를 설정하면 Home Assistant configuration directory의 파일에 토큰을 기록합니다. 이 토큰은 Hue 브릿지와의 통신을 인증합니다. 브릿지의 IP 주소가 변경되면 홈어시스턴트에 다시 등록해야합니다. 이를 방지하기 위해 라우터에서 Hue 브릿지의 DHCP 예약을 설정하여 항상 동일한 IP 주소를 갖도록 할 수 있습니다

등록이 완료되면 Hue 조명이 light 엔티티로, Hue 모션 센서가 binary_sensor 엔티티로, Hue 온도와 조도 센서(모션 센서에 내장된)가 sensor 엔티티로 표시됩니다. 그렇지 않으면 홈어시스턴트를 다시 한번 더 시작해야 할 수도 있습니다.

discovery에 의존하지 않고 통합구성요소를 활성화하려면 configuration.yaml 파일에 다음 줄을 추가하십시오.

# Example configuration.yaml entry
hue:
  bridges:
    - host: DEVICE_IP_ADDRESS

Configuration Variables

host

(string)(Required)

브릿지의 IP 주소 (예: 192.168.1.10). Hue 브릿지를 발견하기 위해 discovery 통합구성요소를 사용하지 않는 경우 필요.

allow_unreachable

(boolean)(Optional)

이를 통해 끊어진(unreachable) 조명의 상태를 정확히 보고할 수 있습니다.

Default value:

false

allow_hue_groups

(boolean)(Optional)

Hue 브릿지에 정의된 그룹을 Home Assistant에서 가져오지 못하게하려면 이 기능을 비활성화.

Default value:

true

예시

# Example configuration.yaml entry specifying optional parameters
hue:
  bridges:
    - host: DEVICE_IP_ADDRESS
      allow_unreachable: true
      allow_hue_groups: true

다중 Hue 브릿지

다중 Hue 브릿지는 discovery에 명확하게 작동하므로 특별히 설정하지 않아도 됩니다.

# Example configuration.yaml entry
hue:
  bridges:
    - host: BRIDGE1_IP_ADDRESS
    - host: BRIDGE2_IP_ADDRESS

홈 어시스턴트에서 Hue 그룹 사용

Hue API를 사용하면 조명을 그룹화할 수 있습니다. 홈어시스턴트는 기본적으로 엔티티 그룹화를 지원하지만 때때로 Hue 그룹을 사용하여 조명을 그룹화하는 것이 유용할 수 있습니다. 이렇게하면 홈어시스턴트는 그룹의 모든 조명에 대해 한 번의 호출 대신 해당 그룹의 모든 조명 상태를 변경하기 위해 한 번의 API 호출만 보내면됩니다. 이로 인해 모든 조명이 동시에 상태가 변경됩니다.

이 Hue 그룹은 Luminaire, Lightsource, LightGroup 또는 Room이 될 수 있습니다. Hue 브릿지가 감지된 조명을 기반으로 자동으로 관리하기 때문에 LuminaireLightsource를 수동으로 만들 수 없습니다. RoomLightGroup은 API 혹은 모바일 앱을 통해 수동으로 생성할 수 있습니다. 조명은 하나의 Room에만 존재할 수 있지만 둘 이상의 LightGroup에 존재할 수도 있습니다. LightGroup은 특정 조명을 서로 연결하려는 경우 유용할 수 있습니다.

2세대 Hue 앱은 Room만 만들 수 있습니다. LightGroup을 만들려면 1세대 앱 또는 API를 사용해야합니다.

예시 :

조명 1,2,3를 포함하는 Ceiling lights라는 LightGroup을 만들려면 다음 명령을 실행하십시오. :

$ curl -XPOST -d '{"name": "Ceiling lights", "lights": ["1", "2", "3"]}' http://<bridge>/api/<username>/groups

<username>은 브릿지에서 홈어시스턴트를 등록하는데 사용하는 문자열입니다. configuration.storage 경로의 core.config_entries 파일에서 찾을 수 있습니다. <bridge>는 Hue 브릿지의 IP 주소 또는 호스트 이름입니다.

다음 명령을 실행하여 조명의 ID를 찾을 수 있습니다 :

$ curl http://<bridge>/api/<username>/lights

홈어시스턴트는 새 LightGroup을 자동으로 감지하여 인터페이스에 추가합니다.

Hue 조명 그룹을 지원하려면 브릿지에 펌웨어 1.13 이상이 있어야합니다 (2016년 6월 3일 출시).

자세한 내용은 Philips Hue API documentation에서 확인할 수 있습니다.

홈어시스턴트에서 Hue 씬(Scenes) 사용

Hue 플랫폼에는 조명 그룹의 색상을 한번에 설정하기위한 고유한 Scene 개념이 있습니다. Hue Scene은 매우 저렴하고 모든 종류의 앱에서 만들 수 있으며 (동시에 2개이상의 조명을 변경하는 유일한 방법이므로) 거의 삭제되지 않습니다. 전형적인 Hue 허브에는 수백개의 Scene이 저장되어 있을겁니다.

사용자 인터페이스 과부하를 피하기 위해 Scene을 직접 노출시키지 않습니다. 대신 Hue가 있습니다. hue_activate_scene 서비스는 automation 또는 script 구성요소에서 사용할 수 있습니다. 이렇게 하면 Home Assistant에서 표준 Scene을 사용할 때와 같이 한 번에 하나씩이 아니라 모든 조명이 한 번에 transition 됩니다.

예시 :

script:
  porch_on:
    sequence:
      - service: hue.hue_activate_scene
        data:
          group_name: "Porch"
          scene_name: "Porch Orange"
Service data attribute Optional Description
group_name no 조명의 group/room 이름입니다. 공식 Hue 앱에서 찾으십시오.
scene_name no scene의 이름. 공식 Hue 앱에서 찾으십시오.

Note: group_name은 홈어시스턴트 그룹 이름에 대한 참조가 아닙니다. Hue 앱에서 group/room의 이름만 될 수 있습니다.

그룹과 씬 이름 찾기

이 이름들을 어떻게 찾습니까?

가장 쉬운 방법은 group/room과 scene 이름으로 구성된 2 세대 Hue 앱의 scene만 사용하는 것입니다. 앱에 표시되는 room 이름과 scene 이름 값을 사용하십시오. Home Assistant 인스턴스의 dev-service 콘솔을 사용하여 이러한 작업이 작동하는지 테스트할 수 있습니다.

또는 이 gist를 사용하여 모든 room과 scene 이름을 가져올 수 있습니다. 이는 어떤 group과 scene이 함께 작동하는지 알려주지는 않지만 dev-service 콘솔에서 테스트할 수 있는 값을 얻는 것으로 충분합니다.

경고 (Caveats)

Hue API는 scene을 직접 활성화하지 않습니다. 오히려 Hue group(일반적으로 room, 특히 2 세대 앱을 사용하는 경우)과 연결되어야 합니다. 그러나 Hue scene은 실제로 group을 참조하지 않습니다. 휴리스틱 매칭(heuristic matching)이 사용됩니다.

Hue에서 group 이름이나 scene 이름이 고유하지는 않습니다. 홈어시스턴트에서 Hue scene을 호출하여 예기치 않은 동작이 관찰되는 경우 Hue 앱에서 Hue scene의 이름을 보다 구체적으로 지정하십시오.

Hue 허브에는 scene에 대한 공간이 제한되어 있으며 새 scene이 만들어지면 해당 공간을 오버플로하는 scene을 삭제합니다. API 문서에 따르면 이것이 “최근에 사용된” scene을 기반으로합니다.