컬러 조명 rgb-light.1
켜기·끄기, 밝기, 색상을 가진 컬러 조명.
쓰임
RGB LED, WS2812 스트립처럼 색을 바꾸는 조명 하나에 씁니다. LED별로 따로 제어하려면 iris 타입을 봅니다.
장치 쪽 설정
장치는 접속하면 @$ui에 t=로 이 타입을 알리고, 상태가 바뀔 때마다 @$state를 보냅니다. 앱은 명령을 <cid>@로 보냅니다.
@$name 내 컬러 조명:거실
@$ui t=rgb-light.1
@$state on=1;level=0;color=#ff8800
상태 키 @$state
| 키 | 값 | 뜻 |
|---|---|---|
on | 0 / 1 | 1이면 켜짐, 0이면 꺼짐 |
level | 0–100% | 밝기 0~100 (%) |
color | #rrggbb | 색상 #rrggbb (소문자 16진수) |
명령 <cid>@
| 명령 | 뜻 |
|---|---|
on | 켜기 |
off | 끄기 |
level={v} | 밝기를 {v}%로 설정 |
color={v} | 색상을 #rrggbb로 설정 |
{v}는 슬라이더·색상 값입니다. 모르는 명령을 받아도 장치는 현재 상태를 보내야 앱이 기다리지 않습니다.
구현 메모
- color는 # 다음 6자리 16진수입니다. 상태도 같은 형식으로 보내야 색상 선택기가 현재 색을 보여 줍니다.
기본 그림
$ui에 v=1과 $view가 없으면 앱은 이 그림을 씁니다. 값은 그림이 읽을 $state 키 이름입니다.
{"kind":"bulb","on":"on","level":"level","color":"color"}
예제
이 타입을 쓰는 Arduino 예제가 아직 없습니다.
타입 파일
iosignal/devices/types/rgb-light.1.json(rev 2) · CDN
JSON 보기
{
"schema": 1,
"type": "rgb-light.1",
"rev": 2,
"title": "컬러 조명",
"icon": "palette",
"traits": [
"onoff",
"level",
"color"
],
"view": {
"kind": "bulb",
"on": "on",
"level": "level",
"color": "color"
},
"controls": [
{
"widget": "switch",
"label": "전원",
"key": "on",
"cmdOn": "on",
"cmdOff": "off"
},
{
"widget": "slider",
"label": "밝기",
"key": "level",
"min": 0,
"max": 100,
"step": 1,
"unit": "%",
"cmd": "level={v}"
},
{
"widget": "color",
"label": "색상",
"key": "color",
"cmd": "color={v}"
}
]
}