Smartthings 뉴앱에서 타일 구성하기

최근 아파트 월패드 시스템과 Smartthings를 연동을 위해 DTH를 뉴앱에 호환되도록 작성을 했다.
그런데 각종 타일들이 원하는대로 구성이 안되는 것을 확인, 힘들게 방법을 찾아 기록해둔다.

우선 Smartthings 클래식 앱과는 다르게 뉴앱은 vid(Device id로 추정)를 지정하면 타일이 자동으로 구성된다.
그럼 vid를 어디서 확인할 수 있느냐?

아직까지 Smartthings 뉴앱의 타일 구성 등 DTH 작성에 대한 공식적인 문서는 없다.
하지만 커뮤니티를 열심히 찾다보니 아래와 같은 글을 발견!
https://community.smartthings.com/t/device-handler-update-to-support-new-stsc-app/163877

해당글에 따르면 우선 난방조절기를 위해 여러개의 vid가 존재함을 확인

vid: "generic-radiator-thermostat"
main tile temp
temp
set heating
set mode
battery

vid: "generic-radiator-thermostat-1"
main tile power
refersh
temp
set cooling
set heating
operating state
set mode
set fan
set heating
set cooling
set mode
operating state
battery
set temp line?

vid: "generic-radiator-thermostat-2"
main tile temp
Temp
set temp heating
battery

vid: "generic-radiator-thermostat-3"
main tile power
refersh
temp
set cooling
set heating
operating state
set mode
set fan
set heating
set cooling
set mode
operating state
battery
set temp line?

vid: "generic-thermostat"
main tile power
refersh
temp
set cooling
set heating
operating state
set mode
set fan
set heating
set cooling
set mode
operating state
battery
set temp line?

vid: "generic-thermostat-1"
main tile temp
temp
set temp heating and cooling
operating state
set mode
set fan mode
battery

vid: "generic-thermostat-2"
main tile switch
switch
refresh
temp
set cooling
set heating
operating state
set mode
set fan mode
set heating
set cooling
set mode
operating state
battery
set temp line?

vid:"SmartThings-smartthings-Z-Wave_Thermostat"
main tile temp
temp
set heating and cooling
operating state
set mode
set fan mode

우리집은 현재온도, 설정온도 이렇게 2가지만 표시할 수 있는 타일이 필요하므로 vid를 ‘generic-radiator-thermostat-2’로 정하고 metadata는 아래와 같이 구성했다.

metadata {
    definition (name: "Heating", namespace: "ByJJoon", author: "ByJJoon", vid: "generic-radiator-thermostat-2") {
        capability "Thermostat"
        capability "Thermostat Heating Setpoint"
        capability "Thermostat Cooling Setpoint"
        capability "Temperature Measurement"
    }
}

내가 선택한 vid에는 ‘battery’가 기본적으로 나오게 되어 있으나 capability에 Battery를 추가해주지 않아 표시가 되지 않는다.

이렇게 작성하면 클래식앱에서 필요한 tiles{…} 같은 코드 없이 자동으로 타일이 구성, 아이콘도 이쁜 아이콘으로 적용된다.

이외에도 여러 vid 및 Capabilities를 참고할 수 있는 페이지도 있어 링크를 걸어둔다.
https://vid-selector.glitch.me/
https://smartthings.developer.samsung.com/docs/api-ref/capabilities.html#Capabilities

공식문서가 나오기 전까지 Smartthings 뉴앱 기반에서 DTH 작성에 도움이 되길 바라며…..

댓글 남기기

이메일은 공개되지 않습니다. 필수 입력창은 * 로 표시되어 있습니다