밝기 조절 전등 dimmer.1
켜기·끄기와 0~100% 밝기를 가진 전등.
쓰임
PWM LED, 디머 모듈처럼 밝기를 바꿀 수 있는 조명에 씁니다.
장치 쪽 설정
장치는 접속하면 @$ui에 t=로 이 타입을 알리고, 상태가 바뀔 때마다 @$state를 보냅니다. 앱은 명령을 <cid>@로 보냅니다.
@$name 내 밝기 조절 전등:거실
@$ui t=dimmer.1
@$state on=1;level=0
상태 키 @$state
| 키 | 값 | 뜻 |
|---|---|---|
on | 0 / 1 | 1이면 켜짐, 0이면 꺼짐 |
level | 0–100% | 밝기 0~100 (%) |
명령 <cid>@
| 명령 | 뜻 |
|---|---|
on | 켜기 |
off | 끄기 |
level={v} | 밝기를 {v}%로 설정 |
level=25 | 밝기를 25%로 설정 |
level=50 | 밝기를 50%로 설정 |
level=100 | 밝기를 100%로 설정 |
{v}는 슬라이더·색상 값입니다. 모르는 명령을 받아도 장치는 현재 상태를 보내야 앱이 기다리지 않습니다.
구현 메모
- 꺼진 상태에서 level을 받으면 켤지 말지는 장치가 정합니다. 켠다면 on=1도 함께 보냅니다.
- 슬라이더를 드래그하는 동안 명령이 150ms 간격으로 여러 번 옵니다. 마지막 값이 최종값입니다.
기본 그림
$ui에 v=1과 $view가 없으면 앱은 이 그림을 씁니다. 값은 그림이 읽을 $state 키 이름입니다.
{"kind":"bulb","on":"on","level":"level"}
예제
이 타입을 쓰는 Arduino 예제가 아직 없습니다.
타입 파일
iosignal/devices/types/dimmer.1.json(rev 2) · CDN
JSON 보기
{
"schema": 1,
"type": "dimmer.1",
"rev": 2,
"title": "밝기 조절 전등",
"icon": "light_mode",
"traits": [
"onoff",
"level"
],
"view": {
"kind": "bulb",
"on": "on",
"level": "level"
},
"controls": [
{
"widget": "switch",
"label": "전원",
"key": "on",
"cmdOn": "on",
"cmdOff": "off"
},
{
"widget": "slider",
"label": "밝기",
"key": "level",
"min": 0,
"max": 100,
"step": 5,
"unit": "%",
"cmd": "level={v}"
},
{
"widget": "buttons",
"label": "빠른 설정",
"key": "level",
"cmd": "level={v}",
"options": [
{
"label": "25%",
"value": "25"
},
{
"label": "50%",
"value": "50"
},
{
"label": "100%",
"value": "100"
}
]
}
]
}