Int'l Light Convergence EXPO

번호

약어

설명

1

GW

Gateway

2

B-SLP

Backbone Smart Lighting Profile

3

CID

Controller ID

4

CoAP

Contrained Application Protocol

5

DID

Device ID

6

GID

Group ID

7

LD

Lighting Device

8

LPV

L-SLP Profile Version

9

L-SLP

Local Smart Lighting Profile

10

PC

Produce Code

11

PID

Physical ID

12

SCID

Scene ID

13

SD

Sensor Device

14

SN

Serial Number

15

TID

Tester ID

16

TS

Tester

17

UD

User Device

18

URL

Uniform Resource Locator

19

20

구분

attribute_set

API명

URI PATH

method

디바이스

dinfo

디바이스 전체 탐색

{broad_url}/dinfo?did=65535

GET

디바이스 설치 탐색

{broad_url}/dinfo?lid=0

GET

디바이스 전체정보 조회

{base_url}/

GET

디바이스 기본정보 조회

{base_url}/dinfo

GET

디바이스 기본정보 설정

{base_url}/dinfo

PATCH

identify

디바이스 식별

{base_url}/identify

PUT/

PATCH

디바이스 모듈 식별

{base_url}/identify?mid={mid}

PUT/

PATCH

디바이스 그룹 식별

{broad_url}/identify?gid={gid}

{multi_url}/identify

PUT/

PATCH

cap

디바이스 수용능력 조회

{base_url}/cap

GET

module

디바이스 전체 모듈정보 조회

{base_url}/modules

GET

디바이스 전체 모듈의 기본정보 목록 조회

{base_url}/modules/minfo

GET

modules

디바이스 개별 모듈 전체정보 조회

{base_url}/modules/{mid}

GET

디바이스 개별 모듈 기본정보 조회

{base_url}/modules/{mid}/minfo

GET

restart

디바이스 재시작

{base_url}/restart

POST

reset

디바이스 공장초기화

{base_url}/reset

POST

조명

light

조명 상태정보 조회

- 전체 조명 모듈 조회

{broad_url}/light

GET

- 개별 조명 모듈 조회

{broad_url}/modules/{mid}light

GET

조명 상태정보 변경 (조명 제어)

- 전체 조명 모듈 동일 변경

{base_url}/light

PATCH

- 전체 조명 모듈 개별 변경

{base_url}/light

PATCH

- 개별 조명 모듈 변경

{base_url}/modules/{mid}/light

PATCH

lightconfig

조명 설정정보 조회

- 전체 조명 모듈 조회

{base_url}/lightconfig

GET

- 개별 조명 모듈 조회

{base_url}/modules/{mid}/lightconfig

GET

조명 설정정보 변경

- 전체 조명 모듈 동일 변경

{base_url}/lightconfig

PATCH

- 전체 조명 모듈 개별 변경

{base_url}/lightconfig

PATCH

- 개별 조명 모듈 변경

{base_url}/modules/{mid}/lightconfig

PATCH

onconfig

조명 점등 상태정보 조회

- 전체 조명 모듈 조회

{base_url}/onconfig

GET

- 개별 조명 모듈 조회

{base_url}/modules/{mid}/onconfig

GET

조명 점등 상태정보 설정

- 전체 조명 모듈 동일 변경

{base_url}/onconfig

PATCH

- 전체 조명 모듈 개별 변경

{base_url}/onconfig

PATCH

- 개별 조명 모듈 변경

{base_url}/modules/{mid}/onconfig

PATCH

현재 조명상태의 점등 상태정보 저장

- 전체 조명 모듈 저장

{base_url}/onconfig

PUT

- 개별 조명 모듈 저장

{base_url}/modules/{mid}/onconfig

PUT

센서

sensor

센서 공통 설정정보 조회

- 전체 센서 모듈 조회

{base_url}/sensor

GET

- 특정 센서종류 조회

{base_url}/sensor?mtype={mtype}

GET

센서 개별 설정정보 조회

{base_url}/modules/{mid}/sensor

GET

센서 공통 설정정보 변경

- 전체 센서 모듈 변경

{base_url}/sensor

PATCH

- 특정 센서종류 변경

{base_url}/sensor

PATCH

센서 개별 설정정보 변경

{base_url}/modules/{mid}/sensor

PATCH

센서 출력정보 조회

- 전체 센서 모듈 조회

{base_url}/sensor?attr=value

GET

- 특정 센서종류 조회

{base_url}/sensor?mtype={mtype}&attr=value

GET

- 개별 센서 모듈 조회

{base_url}/modules/{mid}/sensor?attr=value

GET

그룹

group

그룹 등록

{base_url}/groups

POST

그룹 목록 조회

- 그룹 전체 목록 조회

{base_url}/groups

GET

- 그룹 논리주소 목록 조회

{base_url}/groups?attr=gid

GET

그룹 수용능력 조회

{base_url}/groups?attrs=gcap

GET

그룹 구성정보 조회

{base_url}/groups/{gid}

GET

그룹 구성정보 변경

{base_url}/groups/{gid}

PATCH

그룹 조명 상태정보 변경

(그룹 조명 제어)

{broad_url}/groups/{gid}/light

PATCH

그룹 조명 설정정보 변경

{broad_url}/groups/{gid}/lightconfig

PATCH

그룹 센서 설정정보 변경

{broad_url}/groups/{gid}/sensor

PATCH

그룹 삭제

- 개별 그룹 삭제

{base_url}/groups/{gid}

{broad_url}/groups/{gid}

DELETE

- 전체 그룹 삭제

{base_url}/groups/65535

{broad_url}/groups/65535

DELETE

장면

scene

장면 등록

{base_url}/scenes

POST

현재상태 장면 등록

{base_url}/scenes

POST

장면 목록 조회

- 장면 전체 목록 조회

{base_url}/scenes

GET

- 장면 논리주소 목록 조회

{base_url}/scenes?attr=scid

GET

장면 수용능력 조회

{base_url}/scenes?attrs=scap

GET

장면 설정정보 조회

{base_url}/scenes/{scid}

GET

장면 설정정보 변경

{base_url}/scenes/{scid}

PATCH

장면 호출

{broad_url}/scenes/{scid}/goto

POST

장면 삭제

- 개별 장면 삭제

{base_url}/scenes/{scid}

{broad_url}/scenes/{scid}

DELETE

- 전체 장면 삭제

{base_url}/scenes/65535

{broad_url}/scenes/65535

DELETE

고장

fault

고장 정보 조회

{base_url}/fault

GET

Header

Ver

Type

Code

Options

01

CON

0.01 (GET)

URI-Path: {broad_url}/dinfo?did=65535

Accept: text/plain

비고

- 게이트웨이 또는 사용자입력장치 type1(UD1)에서 사용

- 수신한 모든 디바이스는 응답

Header

Ver

Type

Code

Options

01

ACK

2.05 (Content)

Content-Format: text/plain

Payload

항목

타입(길이)

C

내용

did

Uint16

M

디바이스 논리주소

dpid

Hex(18)

M

디바이스 물리주소

pc

Hex(62)

M

디바이스 제품 코드

sn

String(10)

O

디바이스 일련번호

lid

Hex(28)

M

디바이스 위치주소

lpv

String

O

L-SLP 프로파일 버전

delay

Uint16

O

디바이스 재시작 또는 공장초기화 지연 시간

ip

String

O

IP 주소

uport

Uint16

O

L-SLP UDP 포트번호

ct

String(2)

O

디바이스 지원 Content Format

name

String

O

디바이스 이름

dfault

Uint8

O

디바이스 상태 정보

fslist

Object Array

CM

디바이스 세부 기기장애 정보

- 조건: 디바이스 상태 정보(dfault)를 제공하고 그 값이 기기장애(2), 통신불능&기기장애(3)인 경우

mid

Uint8

M

모듈 논리주소

- 모듈 논리주소가 없는 경우: 0

fcode

HexStr(8)

M

세부장애 비트 표시 정보

Payload

Example 1

did=0;

dpid=3F2F1A00000011002A;

pc=3F2F1A00000001;

sn=1712000001;

lid=0;

lpv=1.0.0;

ct=pt

연결 설정 미완료 상태인 디바이스의 응답

Payload

Example 2

did=32;

dpid=3F2F1A000000110B2A;

pc=3F2F1A00000001;

sn=1712000021;

lid=010000040A0000002F000000ED;

lpv=1.0.0;

ct=pt

연결 설정 완료 상태인 디바이스의 응답

비고

- 항목에는 3.1.1절의 ‘디바이스 정보’ 속성을 모두 포함해야 하고, 순서는 상관없음

Header

Ver

Type

Code

Options

01

CON

0.01 (GET)

URI-Path: {base_url}/dinfo?lid=0000000000000000000000000000

Accept: text/plain

비고

- 게이트웨이 또는 사용자입력장치 type1(UD1)에서 사용

- LID가 0인 모든 디바이스는 응답

Header

Ver

Type

Code

Options

01

ACK

2.05 (Content)

Content-Format: text/plain

Payload

항목

타입(길이)

C

내용

did

Uint16

M

디바이스 논리주소

dpid

Hex(18)

M

디바이스 고유 물리주소

pc

Hex(62)

M

제품코드

sn

String(10)

M

일련번호

lid

Hex(28)

M

디바이스 위치주소

lpv

String

CM

L-SLP API 버전

조건: L-SLP 지원 디바이스인 경우

ct

String(2)

O

Content-format

(pt:text/plain, os: octet stream)

Payload

Example 1

did=0;

dpid=3F2F1A00000011002A;

pc=3F2F1A00000001;

sn=1712000001;

lid=0000000000000000000000000000;

lpv=1.0.0;

ct=pt

모든 연결 설정이 미완료 상태인 디바이스의 응답

Payload

Example 2

did=32;

dpid=3F2F1A000000110B2A;

pc=3F2F1A00000001;

sn=1712000021;

lid=0000000000000000000000000000;

lpv=1.0.0;

ct=pt

LID만 설정 미완료 상태인 디바이스의 응답

비고

- 항목에는 3.1.1절의 ‘디바이스 정보’ 속성을 모두 포함해야 하고, 순서는 상관없음

Header

Ver

Type

Code

Options

01

CON

0.03 (PUT)

0.06 (PATCH)

URI-Path: {base_url}/identify

Content-Format: text/plain

Payload

항목

타입(길이)

C

내용

blink

Uint8

O

점멸 횟수 (범위: 1~256)

Payload

Example

blink=2

디바이스 전체 LED 2회 점멸

비고

Header

Ver

Type

Code

Options

01

ACK

2.04 (Changed)

Content-Format: text/plain

Payload

항목

타입(길이)

C

내용

did

Uint16

M

디바이스 논리주소

blink

Uint8

O

점멸 횟수 (범위: 1~256)

Payload

Example

did=32;

blink=2

비고

- PUT 메소드를 사용하는 경우 빠진 항목은 NULL 또는 기본설정값 처리함

Header

Ver

Type

Code

Options

01

CON

0.03 (PUT)

0.06 (PATCH)

URI-Path: {base_url}/identify?mid={mid}

Content-Format: text/plain

Header

Parameter

항목

타입(길이)

내용

mid

Uint8

모듈 논리주소

Payload

항목

타입(길이)

C

내용

blink

Uint8

O

점멸 횟수 (범위: 1~256)

Payload

Example

blink=2

해당 모듈만 2회 점멸

비고

Header

Ver

Type

Code

Options

01

ACK

2.04 (Changed)

Content-Format: text/plain

Payload

항목

타입(길이)

C

내용

did

Uint16

M

디바이스 논리주소

blink

Uint8

O

점멸 횟수 (범위: 1~256)

Payload

Example

did=32;

blink=2

비고

- PUT 메소드를 사용하는 경우 빠진 항목은 NULL 또는 기본설정값 처리함

Header

Ver

Type

Code

Options

01

CON

NON

0.03 (PUT)

0.06 (PATCH)

URI-Path: {broad_url}/identify?gid={gid}

Content-Format: text/plain

Header

Parameter

항목

타입(길이)

내용

gid

Uint16

그룹 논리주소

Payload

항목

타입(길이)

C

내용

blink

Uint8

O

점멸 횟수 (범위: 1~256)

Payload

Example

blink=2

그룹 소속 디바이스만 LED 모듈 전체2회 점멸

비고

Header

Ver

Type

Code

Options

01

ACK

2.04 (Changed)

Content-Format: text/plain

Payload

항목

타입(길이)

C

내용

did

Uint16

M

디바이스 논리주소

blink

Uint8

O

점멸 횟수 (범위: 1~256)

Payload

Example

did=32;

blink=2

비고

- 그룹주소의 멤버만큼 응답이 발생함

- PUT 메소드를 사용하는 경우 빠진 항목은 NULL 또는 기본설정값 처리함

Header

Ver

Type

Code

Options

01

CON

0.01 (GET)

URI-Path: {base_url}/

Accept: text/plain

비고

Header

Ver

Type

Code

Options

01

ACK

2.05 (Content)

Content-Format: text/plain

Payload

항목

타입(길이)

C

내용

did

Uint16

M

디바이스 논리주소

dinfo

Object

M

디바이스 기본 정보

dpid

Hex(18)

M

디바이스 고유 물리주소

pc

Hex(62)

M

제품코드

sn

String(10)

M

일련번호

lid

Hex(28)

M

디바이스 위치주소

lpv

String

CM

L-SLP API 버전

조건: L-SLP 지원 디바이스인 경우

ct

String(2)

O

Content-format

(pt:text/plain, os: octet stream)

cap

Object

M

디바이스의 수용능력

mcap

Object

M

디바이스의 모듈 수용능력

in_maxm

Uint8

O

디바이스 내부에 연결 가능한 모듈 개수

  in_usedm

Uint8

O

디바이스 내부에 연결되어 사용중인 모듈 개수

  ex_maxm

Uint8

O

디바이스 외부에 연결 가능한 모듈 개수

  ex_usedm

Uint8

O

디바이스 외부에 연결되어 사용중인 모듈 개수

gcap

Object

M

디바이스의 그룹 수용능력

  numg

Uint8

O

지원 가능한 그룹 개수

  usedg

Uint8

O

사용중인 그룹 개수

scap

Object

M

디바이스의 Scene 수용능력

  nums

Uint8

O

지원 가능한 Scene 개수

  useds

Uint8

O

사용중인 Scene 개수

modules

Object Array

M

디바이스의 모듈정보 객체 목록

- 조명, 센서 모듈만 포함

- 통신 모듈(mid=1) 정보는 개별 조회

mid

Uint8

M

모듈 논리주소

minfo

Object

M

모듈 기본정보

mclass

String(1)

M

모듈 종류

mtype

Uint8

M

모듈 상세 종류

form

String(2)

O

모듈 장착 방식

light

Object

CM

조명 상태정보

- 조건: 모듈 기본정보(minfo)의 모듈 종류(mclass)가 조명(l)인 경우

onoff

String

M

조명 점소등 상태

level

Uint8

CM

밝기

- 조건: 조명이 점등(on) 상태인 경우

- 소등(off) 상태인 경우 생략하거나 “0”이어야 함

colortemp

Uint16

O

상관 색온도

hue

Uint16

O

HSV 모델 - 색상

sat

Uint8

O

HSV 모델 - 채도

bright

Uint8

O

HSV 모델 - 이름도

x

Float(3,2)

O

조명 색상(CIE 1931 XY 색좌표)의 x

y

Float(3,2)

O

조명 색상(CIE 1931 XY 색좌표)의 y

r

Uint8

O

RGB 모델 - Red

g

Uint8

O

RGB 모델 - Green

b

Uint8

O

RGB 모델 - Bule

lightconfig

Object

CM

조명 설정정보

- 조건: 모듈 기본정보(minfo)의 모듈 종류(mclass)가 조명(l)인 경우

onoff_tt

Uint16

O

점소등소요시간 (100ms)

dimup_tt

Uint16

O

최대밝기도달 소요시간 (100ms)

dimdn_tt

Uint16

O

최소밝기도달 소요시간 (100ms)

on_htime

Uint16

O

점등유지시간(s)

off_htime

Uint16

O

소등유지시간(s)

on_dtime

Uint16

O

점등대기시간(s)

off_dtime

Uint16

O

소등대기시간(s)

color_tt

Uint16

O

색상변경소요시간

offlevel

Uint8

O

소등(off) 소등되는 밝기

level_rate

Uint8

M

조명 출력 비율

rperiod

Uint16

O

조명 상태정보 보고 주기 (s)

last_light

String

M

점등시 마지막 조명 상태정보 복구

onconfig

Object

M

조명 점등 상태정보 객체

onlevel

Uint8

M

점등시 조명 밝기(밝기)

colortemp

Uint16

O

점등시 조명 상관 색온도

hue

Uint16

O

점등시 조명 색상(HSB)의 색상

sat

Uint8

O

점등시 조명 색상(HSB)의 채도

bright

Uint8

O

점등시 조명 색상(HSB)의 휘도

x

Float(3,2)

O

점등시 조명 색상(CIE 1931 XY 색좌표)의 x

y

Float(3,2)

O

점등시 조명 색상(CIE 1931 XY 색좌표)의 y

r

Uint8

O

점등시 조명 색상(R, G, B)의 적색(Red)

g

Uint8

O

점등시 조명 색상(R, G, B)의 녹색(Green)

b

Uint8

O

점등시 조명 색상(R, G, B)의 청색(Blue)

sensor

Object

CM

센서 기본정보

- 조건: 모듈 기본정보(minfo)의 모듈 종류(mclass)가 센서(s)인 경우

active

String

M

센서 동작 상태 정보

opmode

String

M

센서 이벤트 발생시 동작 모드

mperiod

Uint16

M

센서 측정 주기

rperiod

Uint16

M

센서 정보 보고 주기

vtype

String

M

센서 출력(value)의 데이터 형식

value

{vtype value}

M

현재 센서 출력 데이터

Payload

Example

did=32;

dinfo={

dpid=3F2F1A000000110B2A;

pc=3F2F1A00000001;

sn=1712000021;

lid=010000040A0000002F000000ED;

lpv=1.0.0;

ct=pt

};

cap={

mcap={in_maxm=2; in_usedm=2};

gcap={numg=10; usedg=3};

scap={nums=10; useds=0}

}

modules=[

{

mid=2;

minfo={ mclass=l; mtype=0; form=in }

light={

onoff=on;

level=50;

colortemp=4000

};

lightconfig={

onoff_tt=50;

dimup_tt=10;

dimdn_tt=10;

color_tt=10;

offlevel=20;

level_rate=80;

last_light=enable

onconfig={

onlevel=100;

colortemp=4000

}

}

},

{

mid=3;

minfo={ mclass=l; mtype=0; form=in }

light={

onoff=on;

level=50;

colortemp=4000

};

lightconfig={

onoff_tt=50;

dimup_tt=10;

dimdn_tt=10;

color_tt=10;

offlevel=20;

onconfig={

onlevel=100;

colortemp=4000

}

}

}

]

조명 모듈 2개로 구성된 조명 디바이스의 응답

비고

- 설정이 미완료된 항목은 디폴트 값으로 응답

- 지원하지 않는 항목은 포함하지 않음

Header

Ver

Type

Code

Options

01

ACK

4.13

(Request Entity Too Large)

Content-Format: text/plain

Payload

항목

타입(길이)

C

내용

did

Uint16

M

디바이스 논리주소

Payload

Example

did=32

비고

-

Header

Ver

Type

Code

Options

01

CON

0.01 (GET)

URI-Path: {base_url}/dinfo

Accept: text/plain

비고

Header

Ver

Type

Code

Options

01

ACK

2.05 (Content)

Content-Format: text/plain

Payload

항목

타입(길이)

C

내용

did

Uint16

M

디바이스 논리주소

dpid

Hex(18)

M

디바이스 고유 물리주소

pc

Hex(62)

M

제품코드

sn

String(10)

M

일련번호

lid

Hex(28)

M

디바이스 위치주소

lpv

String

CM

L-SLP API 버전

조건: L-SLP 지원 디바이스인 경우

ct

String(2)

O

Content-format

(pt:text/plain, os: octet stream)

Payload

Example

did=32;

dpid=3F2F1A000000110B2A;

pc=3F2F1A00000001;

sn=1712000021;

lid=010000040A0000002F000000ED;

lpv=1.0.0;

ct=pt

비고

- 설정이 미완료된 항목도 디폴트 값으로 응답

Header

Ver

Type

Code

Options

01

CON

0.06 (PATCH)

URI-Path: {base_url}/dinfo

Content-Format: text/plain

Payload

항목

타입(길이)

C

내용

did

Uint16

O

디바이스 논리주소

dpid

Hex(18)

M

디바이스 물리주소

lid

Hex(28)

O

디바이스 위치주소

ct

String(2)

O

Content-format

(pt:text/plain, os: octet stream)

delay

Uint16

O

디바이스 재시작 또는 공장초기화 지연 시간

Payload

Example 1

did=32;

dpid=3F2F1A000000110B2A;

ct=pt;

lid=010000040A0000002F000000ED

did, ct, lid 변경 요청

Payload

Example 2

dpid=3F2F1A000000110B2A;

ct=pt

ct 변경 요청

Payload

Example 3

dpid=3F2F1A000000110B20;

ct=pt

dpid 오류 요청

비고

Header

Ver

Type

Code

Options

01

ACK

2.04 (Changed)

Content-Format: text/plain

Payload

항목

타입(길이)

C

내용

did

Uint16

M

디바이스 논리주소

lid

Hex(28)

O

디바이스 위치주소

ct

String(2)

O

Content-format

(pt:text/plain, os: octet stream)

delay

Uint16

O

디바이스 재시작 또는 공장초기화 지연 시간

Payload

Example 1

did=32;

ct=pt;

lid=010000040A0000002F000000ED;

Payload

Example 2

did=32;

ct=pt

비고

- 요청받은 항목만 응답에 포함하여야 함

Header

Ver

Type

Code

Options

01

ACK

4.03 (Forbidden)

Content-Format: text/plain

비고

-

Header

Ver

Type

Code

Options

01

CON

0.01 (GET)

URI-Path: {base_url}/cap

Accept: text/plain

비고

- Payload없음

Header

Ver

Type

Code

Options

01

ACK

2.05 (Content)

Content-Format: text/plain

Payload

항목

타입(길이)

C

내용

did

Uint16

M

디바이스 논리주소

mcap

Object

M

디바이스의 모듈 수용능력

in_maxm

Uint8

O

디바이스 내부에 연결 가능한 모듈 개수

  in_usedm

Uint8

CM

디바이스 내부에 연결되어 사용중인 모듈 개수

- 조건: 내부 연결 모듈이 있는 경우

  ex_maxm

Uint8

O

디바이스 외부에 연결 가능한 모듈 개수

  ex_usedm

Uint8

CM

디바이스 외부에 연결되어 사용중인 모듈 개수

- 조건: 외부 연결 모듈이 있는 경우

gcap

Object

O

디바이스의 그룹 수용능력

  numg

Uint8

M

지원 가능한 그룹 개수

  usedg

Uint8

M

사용중인 그룹 개수

scap

Object

O

디바이스의 장면(Scene) 수용능력

  nums

Uint8

M

지원 가능한 장면(Scene) 개수

  useds

Uint8

M

사용중인 장면(Scene) 개수

Payload

Example

did=32;

mcap={in_maxm=2; in_usedm=2};

gcap={numg=10; usedg=3};

scap={nums=10; useds=0}

비고

Header

Ver

Type

Code

Options

01

CON

0.01 (GET)

URI-Path: {base_url}/modules

Accept: text/plain

Header

Ver

Type

Code

Options

01

ACK

2.05 (Content)

Content-Format: text/plain

Payload

항목

타입(길이)

C

내용

did

Uint16

M

디바이스 논리주소

modules

Object Array

M

디바이스 전체 모듈정보 목록

- 조명, 센서 모듈만 포함

- 통신 모듈(mid=1) 정보는 개별 조회

mid

Uint8

M

모듈 논리주소

minfo

Object

M

모듈 기본정보

mclass

String(1)

M

모듈 종류

mtype

Uint8

M

모듈 종류(mclass)에 따른 세부 종류

form

String(2)

O

모듈 장착 방식

light

Object

CM

조명 상태정보

- 조건: 조명 기능을 제공하는 경우

{light attributes}

조명 상태정보 하위 속성

lightconfig

Object

CM

조명 설정정보

- 조건: 조명 기능을 제공하는 경우

{lightconfig attributes}

조명 설정정보 속성들

sensor

Object

CM

센서 설정정보

- 조건: 센서 기능을 제공하는 경우

{sensor attributes}

센서 설정정보 속성들

Payload

Example

did=32;

modules=[

{

mid=2;

minfo={ mclass=l; mtype=0; form=in },

light={ onoff=on, level=100, … },

lightconfig={ onlevel=100, … }

},

{

mid=3;

minfo={ mclass=s; mtype=3; form=ex },

sensor={ status=enable, opmode=notify, mperiod=300, rperiod=600, …}

}

]

비고

- Payload에는 디바이스가 가지고 있는 모든 모듈에 대한 모듈 정보의 속성이 들어감

Header

Ver

Type

Code

Options

01

ACK

4.13

(Request Entity Too Large)

Content-Format: text/plain

Payload

항목

타입(길이)

C

내용

did

Uint16

M

디바이스 논리주소

Payload

Example

did=32

비고

Header

Ver

Type

Code

Options

01

CON

0.01 (GET)

URI-Path: {base_url}/modules/minfo

Accept: text/plain

비고

Header

Ver

Type

Code

Options

01

ACK

2.05 (Content)

Content-Format: text/plain

Payload

항목

타입(길이)

C

내용

did

Uint16

M

디바이스 논리주소

modules

Object Array

O

모듈 기본정보 목록

- 조명, 센서 모듈만 포함

- 통신 모듈(mid=1) 정보는 개별 조회

mid

Uint8

M

모듈 논리주소

minfo

Object

M

모듈정보 객체

mclass

String(1)

M

모듈 종류

mtype

Uint8

M

모듈 종류(mclass)에 따른 세부 종류

form

String(2)

O

모듈 장착 방식

Payload

Example

did=32;

modules=[

{ mid=2; minfo={mclass=l; mtype=0; form=in} },

{ mid=3; minfo={mclass=s; mtype=3; form=ex} }

]

비고

- Payload에는 디바이스가 가지고 있는 모든 모듈에 대한 모듈 정보의 속성이 들어감

Header

Ver

Type

Code

Options

01

CON

0.01 (GET)

URI-Path: {base_url}/modules/{mid}

Accept: text/plain

Header

Parameter

항목

타입(길이)

내용

mid

Uint8

모듈 논리주소

비고

Header

Ver

Type

Code

Options

01

ACK

2.05 (Content)

Content-Format: text/plain

Payload

항목

타입(길이)

C

내용

did

Uint16

M

디바이스 논리주소

mid

Uint8

M

모듈 논리주소

minfo

Object

M

모듈 기본정보

mclass

String(1)

M

모듈 종류

mtype

Uint8

M

모듈 종류(mclass)에 따른 세부 종류

form

String(2)

M

모듈 장착 방식

light

Object

CM

조명 상태정보

- 조건: 조명 기능을 제공하는 경우

{light attributes}

조명 상태정보 하위 속성

lightconfig

Object

CM

조명 설정정보

- 조건: 조명 기능을 제공하는 경우

{lightconfig attributes}

조명 설정정보 속성들

sensor

Object

CM

센서 설정정보

- 조건: 센서 기능을 제공하는 경우

{sensor attributes}

센서 설정정보 속성들

Payload

Example

did=32;

mid=2;

minfo={ mclass=l; mtype=0; form=in},

light={ onoff=on, level=100, … },

lightconfig={ onlevel=100, … }}

비고

-

Header

Ver

Type

Code

Options

01

CON

0.01 (GET)

URI-Path: {base_url}/modules/{mid}/minfo

Accept: text/plain

Header

Parameter

항목

타입(길이)

내용

mid

Uint8

모듈 논리주소

비고

Header

Ver

Type

Code

Options

01

ACK

2.05 (Content)

Content-Format: text/plain

Payload

항목

타입(길이)

C

내용

did

Uint16

M

디바이스 논리주소

mclass

String(1)

M

모듈 종류

mtype

Uint8

M

모듈 종류(mclass)에 따른 세부 종류

form

String(2)

M

모듈 장착 방식

Payload

Example

did=32;

mclass=l;

mtype=0;

form=in

비고

-

Header

Ver

Type

Code

Options

01

CON

0.02 (POST)

URI-Path: {base_url}/restart

Content-Format: text/plain

Payload

항목

타입(길이)

C

내용

delay

Uint16

O

디바이스 재시작 지연 시간

Payload

Example

delay=10

비고

Header

Ver

Type

Code

Options

01

ACK

2.04 (Changed)

Content-Format: text/plain

Payload

항목

타입(길이)

C

내용

did

Uint16

M

디바이스 논리주소

Payload

Example

did=32

비고

Header

Ver

Type

Code

Options

01

CON

0.02 (POST)

URI-Path: {base_url}/reset

Content-Format: text/plain

Payload

항목

타입(길이)

C

내용

dpid

Hex(18)

M

디바이스 고유 물리주소

delay

Uint16

O

디바이스 재시작 지연 시간

Payload

Example

dpid=3F2F1A000000110B2A;

delay=10

비고

Header

Ver

Type

Code

Options

01

ACK

2.04 (Changed)

Content-Format: text/plain

Payload

항목

타입(길이)

C

내용

did

Uint16

M

디바이스 논리주소

Payload

Example

did=32

비고

Header

Ver

Type

Code

Options

01

CON

0.01 (GET)

URI-Path: {base_url}/light

Accept: text/plain

비고

Header

Ver

Type

Code

Options

01

ACK

2.05 (Content)

Content-Format: text/plain

Payload

항목

타입(길이)

C

내용

did

Uint16

M

디바이스 논리주소

light_list

Object Array

M

조명 상태정보 목록

mid

Uint8

M

모듈 논리주소

onoff

String(2~3)

M

조명 on/off 상태

level

Uint8

CM

조명 밝기(밝기)

- 조건: on 상태인 경우

colortemp

Uint16(4)

CM

조명 상관 색온도

- 조건: 속성을 제공하는 경우

r

Uint8

CM

조명 색상(R, G, B)의 적색(Red)

- 조건: 속성을 제공하는 경우

g

Uint8

CM

조명 색상(R, G, B)의 녹색(Green)

- 조건: 속성을 제공하는 경우

b

Uint8

CM

조명 색상(R, G, B)의 청색(Blue)

- 조건: 속성을 제공하는 경우

x

Float(3,2)

CM

조명 색상(CIE 1931 XY 색좌표)의 x

- 조건: 속성을 제공하는 경우

y

Float(3,2)

CM

조명 색상(CIE 1931 XY 색좌표)의 y

- 조건: 속성을 제공하는 경우

hue

Uint8

CM

조명 색상(HSB)의 색상

- 조건: 속성을 제공하는 경우

sat

Uint8

CM

조명 색상(HSB)의 채도

- 조건: 속성을 제공하는 경우

bright

Uint8

CM

조명 색상(HSB)의 휘도

- 조건: 속성을 제공하는 경우

Payload

Example 1

did=32;

light_list=[

{mid=2;onoff=on;level=50;colortemp=4000},

{mid=3;onoff=on;level=50;colortemp=4000}

]

Payload

Example 2

did=32;

light_list=[

{mid=2;onoff=off},

{mid=3;onoff=on;level=50;colortemp=4000}

]

조명이 소등(off) 상태인 경우 조명 밝기(level)는 생략 가능하며, 제공시에는 ‘0’이어야 함

비고

-

Header

Ver

Type

Code

Options

01

CON

0.01 (GET)

URI-Path: {base_url}/modules/{mid}/light

Accept: text/plain

Header

Parameter

항목

타입(길이)

내용

mid

Uint8

모듈 논리주소

비고

Header

Ver

Type

Code

Options

01

ACK

2.05 (Content)

Content-Format: text/plain

Payload

항목

타입(길이)

C

내용

did

Uint16

M

디바이스 논리주소

mid

Uint8

M

모듈 논리주소

onoff

String(2~3)

M

조명 on/off 상태

level

Uint8

M

조명 밝기(밝기)

colortemp

Uint16(4)

CM

조명 상관 색온도

r

Uint8

CM

조명 색상(R, G, B)의 적색(Red)

g

Uint8

CM

조명 색상(R, G, B)의 녹색(Green)

b

Uint8

CM

조명 색상(R, G, B)의 청색(Blue)

x

Float(3,2)

CM

조명 색상(CIE 1931 XY 색좌표)의 x

y

Float(3,2)

CM

조명 색상(CIE 1931 XY 색좌표)의 y

hue

Uint8

CM

조명 색상(HSB)의 색상

sat

Uint8

CM

조명 색상(HSB)의 채도

bright

Uint8

CM

조명 색상(HSB)의 휘도

Payload

Example

did=32;

onoff=on;

level=50;

colortemp=4000

비고

Header

Ver

Type

Code

Options

01

CON

0.06 (PATCH)

URI-Path: {base_url}/light

Content-Format: text/plain

Payload

항목

타입(길이)

C

내용

onoff

String(2~3)

O

조명 on/off 상태

level

Uint8

O

조명 밝기(밝기)

colortemp

Uint16(4)

O

조명 상관 색온도

r

Uint8

O

조명 색상(R, G, B)의 적색(Red)

g

Uint8

O

조명 색상(R, G, B)의 녹색(Green)

b

Uint8

O

조명 색상(R, G, B)의 청색(Blue)

x

Float(3,2)

O

조명 색상(CIE 1931 XY 색좌표)의 x

y

Float(3,2)

O

조명 색상(CIE 1931 XY 색좌표)의 y

hue

Uint8

O

조명 색상(HSB)의 색상

sat

Uint8

O

조명 색상(HSB)의 채도

bright

Uint8

O

조명 색상(HSB)의 휘도

tt

Uint16

O

동작소요시간(100ms)

- 동작소요시간(tt)은 명령어 수행 후 유지(저장)되지 않음. 1회성임.

Payload

Example 1

onoff=on;

colortemp=4000;

tt=10

- tt=10 동안 조명 점등 및 상관 색온도 변경

Payload

Example 2

level=100

- level=100으로 상태변경 요청

Payload

Example 3

onoff=on

- 조명 점등 요청

비고

- Payload에는 하나 이상의 항목이 있어야 함

Header

Ver

Type

Code

Options

01

ACK

2.04 (Changed)

Content-Format: text/plain

Payload

항목

타입(길이)

C

내용

did

Uint16

M

디바이스 논리주소

onoff

String(2~3)

CM

조명 on/off 상태

level

Uint8

CM

조명 밝기(밝기)

colortemp

Uint16(4)

CM

조명 상관 색온도

r

Uint8

CM

조명 색상(R, G, B)의 적색(Red)

g

Uint8

CM

조명 색상(R, G, B)의 녹색(Green)

b

Uint8

CM

조명 색상(R, G, B)의 청색(Blue)

x

Float(3,2)

CM

조명 색상(CIE 1931 XY 색좌표)의 x

y

Float(3,2)

CM

조명 색상(CIE 1931 XY 색좌표)의 y

hue

Uint8

CM

조명 색상(HSB)의 색상

sat

Uint8

CM

조명 색상(HSB)의 채도

bright

Uint8

CM

조명 색상(HSB)의 휘도

tt

Uint16

CM

동작소요시간(100ms)

- 동작소요시간(tt)은 명령어 수행 후 유지(저장)되지 않음. 1회성임.

Payload

Example 1

did=32;

level=100;

onoff=on;

colortemp=4000;

tt=10

- 모든 상태정보 포함

Payload

Example 2

did=32;

level=100

- level=100으로 상태변경 되어야 함

- 소등(off) 상태인 경우 조명 on/off 상태 속성값이 점등(on) 상태로 함께 변경되어야 함

Payload

Example 3

did=32;

onoff=on;

level=80;

colortemp=4000

- 조명 설정정보의 점등시 마지막 조명 상태정보 복구 속성(last_light)의 값에 따라 점등 되어야 함

- 모든 상태정보 포함

비고

- 응답의 CM 조건: 요청에 포함된 속성은 응답에도 포함되어야 함

- 모듈 디바이스도 Request에서 요청한 항목에 대해서만 응답

- 조명 점등 요청(onoff=on)이 포함된 경우에는 제공 가능한 모든 상태정보를 포함하여 응답하여야 함

Header

Ver

Type

Code

Options

01

CON

0.06 (PATCH)

URI-Path: {base_url}/light

Content-Format: text/plain

Payload

항목

타입(길이)

C

내용

light_list

Object Array

M

조명 상태정보 목록

mid

Uint8

M

모듈 논리주소

onoff

String(2~3)

O

조명 on/off 상태

level

Uint8

O

조명 밝기(밝기)

colortemp

Uint16(4)

O

조명 상관 색온도

r

Uint8

O

조명 색상(R, G, B)의 적색(Red)

g

Uint8

O

조명 색상(R, G, B)의 녹색(Green)

b

Uint8

O

조명 색상(R, G, B)의 청색(Blue)

x

Float(3,2)

O

조명 색상(CIE 1931 XY 색좌표)의 x

y

Float(3,2)

O

조명 색상(CIE 1931 XY 색좌표)의 y

hue

Uint8

O

조명 색상(HSB)의 색상

sat

Uint8

O

조명 색상(HSB)의 채도

bright

Uint8

O

조명 색상(HSB)의 휘도

tt

Uint16

O

동작소요시간(100ms)

- 동작소요시간(tt)은 명령어 수행 후 유지(저장)되지 않음. 1회성임.

Payload

Example

light_list=[

{mid=2; onoff=on; colortemp=4000; tt=10},

{mid=3; onoff=off}

]

3등 모듈 조명에서 2개 모듈만 점등

비고

Header

Ver

Type

Code

Options

01

ACK

2.04 (Changed)

Content-Format: text/plain

Payload

항목

타입(길이)

C

내용

did

Uint16

M

디바이스 논리주소

light_list

Object Array

M

조명 상태정보 목록

mid

Uint8

M

모듈 논리주소

onoff

String(2~3)

CM

조명 on/off 상태

level

Uint8

CM

조명 밝기(밝기)

colortemp

Uint16(4)

CM

조명 상관 색온도

r

Uint8

CM

조명 색상(R, G, B)의 적색(Red)

g

Uint8

CM

조명 색상(R, G, B)의 녹색(Green)

b

Uint8

CM

조명 색상(R, G, B)의 청색(Blue)

x

Float(3,2)

CM

조명 색상(CIE 1931 XY 색좌표)의 x

y

Float(3,2)

CM

조명 색상(CIE 1931 XY 색좌표)의 y

hue

Uint8

CM

조명 색상(HSB)의 색상

sat

Uint8

CM

조명 색상(HSB)의 채도

bright

Uint8

CM

조명 색상(HSB)의 휘도

tt

Uint16

CM

동작소요시간(100ms)

- 동작소요시간(tt)은 명령어 수행 후 유지(저장)되지 않음. 1회성임.

Payload

Example

did=32;

light_list=[

{mid=2; onoff=on;level=100;colortemp=4000;tt=10},

{mid=3; onoff=off}

]

비고

- 응답의 CM 조건: 요청에 포함된 속성은 응답에도 포함되어야 함

- 조명 점등 요청(onoff=on)이 포함된 경우에는 제공 가능한 모든 상태정보를 포함하여 응답하여야 함

Header

Ver

Type

Code

Options

01

CON

0.06 (PATCH)

URI-Path: {base_url}/modules/{mid}/light

Content-Format: text/plain

Header

Parameter

항목

타입(길이)

내용

mid

Uint8

모듈 논리주소

Payload

항목

타입(길이)

C

내용

onoff

String(2~3)

O

조명 on/off 상태

level

Uint8

O

조명 밝기(밝기)

colortemp

Uint16(4)

O

조명 상관 색온도

r

Uint8

O

조명 색상(R, G, B)의 적색(Red)

g

Uint8

O

조명 색상(R, G, B)의 녹색(Green)

b

Uint8

O

조명 색상(R, G, B)의 청색(Blue)

x

Float(3,2)

O

조명 색상(CIE 1931 XY 색좌표)의 x

y

Float(3,2)

O

조명 색상(CIE 1931 XY 색좌표)의 y

hue

Uint8

O

조명 색상(HSB)의 색상

sat

Uint8

O

조명 색상(HSB)의 채도

bright

Uint8

O

조명 색상(HSB)의 휘도

tt

Uint16

O

동작소요시간(100ms)

- 동작소요시간(tt)은 명령어 수행 후 유지(저장)되지 않음. 1회성임.

Payload

Example 1

onoff=on;

colortemp=4000;

tt=10

- tt=10 동안 조명 점등 및 상관 색온도 변경

Payload

Example 2

level=100

- level=100으로 상태변경 요청

Payload

Example 3

onoff=on

- 모듈 점등 요청

비고

- Payload에는 하나 이상의 항목이 있어야 함

Header

Ver

Type

Code

Options

01

ACK

2.04 (Changed)

Content-Format: text/plain

Payload

항목

타입(길이)

C

내용

did

Uint16

M

디바이스 논리주소

mid

Uint8

M

모듈 논리주소

onoff

String(2~3)

CM

조명 on/off 상태

level

Uint8

CM

조명 밝기(밝기)

colortemp

Uint16(4)

CM

조명 상관 색온도

r

Uint8

CM

조명 색상(R, G, B)의 적색(Red)

g

Uint8

CM

조명 색상(R, G, B)의 녹색(Green)

b

Uint8

CM

조명 색상(R, G, B)의 청색(Blue)

x

Float(3,2)

CM

조명 색상(CIE 1931 XY 색좌표)의 x

y

Float(3,2)

CM

조명 색상(CIE 1931 XY 색좌표)의 y

hue

Uint8

CM

조명 색상(HSB)의 색상

sat

Uint8

CM

조명 색상(HSB)의 채도

bright

Uint8

CM

조명 색상(HSB)의 휘도

tt

Uint16

CM

동작소요시간(100ms)

- 동작소요시간(tt)은 명령어 수행 후 유지(저장)되지 않음. 1회성임.

Payload

Example 1

did=32;

mid=2;

onoff=on;

level=100;

colortemp=4000;

tt=10

- 모든 상태정보 포함

Payload

Example 2

did=32;

mid=2;

level=100

- level=100으로 상태변경 되어야 함

- 소등(off) 상태인 경우 조명 on/off 상태 속성값이 점등(on) 상태로 함께 변경되어야 함

Payload

Example 3

did=32;

mid=2;

onoff=on;

level=80;

colortemp=4000

- 조명 설정정보의 점등시 마지막 조명 상태정보 복구 속성(last_light)의 값에 따라 점등 되어야 함

- 모든 상태정보 포함

비고

- 응답의 CM 조건: 요청에 포함된 속성은 응답에도 포함되어야 함

- 조명 점등 요청(onoff=on)이 포함된 경우에는 제공 가능한 모든 상태정보를 포함하여 응답하여야 함

Header

Ver

Type

Code

Options

01

CON

0.01 (GET)

URI-Path: {base_url}/lightconfig

Accept: text/plain

비고

Header

Ver

Type

Code

Options

01

ACK

2.05 (Content)

Content-Format: text/plain

Payload

항목

타입(길이)

C

내용

did

Uint16

M

디바이스 논리주소

lightconfig_list

Object Array

M

조명 설정정보 목록

mid

Uint8

M

모듈 논리주소

onoff_tt

Uint16

O

점소등소요시간 (100ms)

dimup_tt

Uint16

O

밝기 증가시 목표 밝기도달 소요시간 (100ms)

dimdn_tt

Uint16

O

밝기 감소시 목표 밝기도달 소요시간 (100ms)

on_htime

Uint16

O

점등유지시간(s)

off_htime

Uint16

O

소등유지시간(s)

on_dtime

Uint16

O

점등대기시간(s)

off_dtime

Uint16

O

소등대기시간(s)

color_tt

Uint16

O

색상 및 상관 색온도 변환 소요시간 (100ms)

offlevel

Uint8

O

Off 명령어시 소등되는 밝기

level_rate

Uint8

M

조명 출력 비율

rperiod

Uint16

O

조명 상태정보 보고 주기 (s)

last_light

String(6~7)

M

점등시 마지막 조명상태 복구

onconfig

Object

M

조명 점등 상태정보 객체

onlevel

Uint8

O

조명 점등시 밝기

colortemp

Uint16(4)

O

조명 상관 색온도

r

Uint8

O

조명 색상(R, G, B)의 적색(Red)

g

Uint8

O

조명 색상(R, G, B)의 녹색(Green)

b

Uint8

O

조명 색상(R, G, B)의 청색(Blue)

x

Float(3,2)

O

조명 색상(CIE 1931 XY 색좌표)의 x

y

Float(3,2)

O

조명 색상(CIE 1931 XY 색좌표)의 y

hue

Uint8

O

조명 색상(HSB)의 색상

sat

Uint8

O

조명 색상(HSB)의 채도

bright

Uint8

O

조명 색상(HSB)의 휘도

Payload

Example 1

did=32;

lightconfig_list=[

{

mid=2;

onoff_tt=0;

dimup_tt=10;

dimdn_tt=10;

color_tt=10;

level_rate=80;

last_light=enable;

onconfig={

onlevel=80;

colortemp=6000

}

},

{

mid=3;

onoff_tt=0;

dimup_tt=10;

dimdn_tt=10;

color_tt=10;

level_rate=80;

last_light=enable;

onconfig={

onlevel=80;

colortemp=6000

}

}

]

조명 모듈이 2개인 조명 디바이스의 응답

Payload

Example 2

did=32;

lightconfig_list=[

{

mid=2;

onoff_tt=0;

dimup_tt=10;

dimdn_tt=10;

color_tt=10;

level_rate=80;

last_light=enable;

onconfig={

onlevel=80;

colortemp=6000

}

}

]

조명 모듈이 1개인 조명 디바이스의 응답

비고

Header

Ver

Type

Code

Options

01

CON

0.01 (GET)

URI-Path: {base_url}/modules/{mid}/lightconfig

Accept: text/plain

Header

Parameter

항목

타입(길이)

내용

mid

Uint8

모듈 논리주소

비고

Header

Ver

Type

Code

Options

01

ACK

2.05 (Content)

Content-Format: text/plain

Payload

항목

타입(길이)

C

내용

did

Uint16

M

디바이스 논리주소

mid

Uint8

M

모듈 논리주소

onoff_tt

Uint16

O

점소등소요시간 (100ms)

dimup_tt

Uint16

O

밝기 증가시 목표 밝기도달 소요시간 (100ms)

dimdn_tt

Uint16

O

밝기 감소시 목표 밝기도달 소요시간 (100ms)

on_htime

Uint16

O

점등유지시간(s)

off_htime

Uint16

O

소등유지시간(s)

on_dtime

Uint16

O

점등대기시간(s)

off_dtime

Uint16

O

소등대기시간(s)

color_tt

Uint16

O

색상 및 상관 색온도 변환 소요시간 (100ms)

offlevel

Uint8

O

Off 명령어시 소등되는 밝기

level_rate

Uint8

M

조명 출력 비율

rperiod

Uint16

O

조명 상태정보 보고 주기 (s)

last_light

String(6~7)

M

점등시 마지막 조명상태 복구 여부

onconfig

Object

M

조명 점등 상태정보 객체

onlevel

Uint8

O

조명 점등시 밝기

colortemp

Uint16(4)

O

조명 상관 색온도

r

Uint8

O

조명 색상(R, G, B)의 적색(Red)

g

Uint8

O

조명 색상(R, G, B)의 녹색(Green)

b

Uint8

O

조명 색상(R, G, B)의 청색(Blue)

x

Float(3,2)

O

조명 색상(CIE 1931 XY 색좌표)의 x

y

Float(3,2)

O

조명 색상(CIE 1931 XY 색좌표)의 y

hue

Uint8

O

조명 색상(HSB)의 색상

sat

Uint8

O

조명 색상(HSB)의 채도

bright

Uint8

O

조명 색상(HSB)의 휘도

Payload

Example

did=32;

mid=2;

onoff_tt=0;

dimup_tt=10;

dimdn_tt=10;

color_tt=10;

offlevel=0;

level_rate=80;

last_light=enable;

onconfig={onlevel=80; colortemp=6000}

비고

Header

Ver

Type

Code

Options

01

CON

0.03 (PUT)

0.06 (PATCH)

URI-Path: {base_url}/lightconfig

Content-Format: text/plain

Payload

항목

타입(길이)

C

내용

onoff_tt

Uint16

O

점소등소요시간 (100ms)

dimup_tt

Uint16

O

밝기 증가시 목표 밝기도달 소요시간 (100ms)

dimdn_tt

Uint16

O

밝기 감소시 목표 밝기도달 소요시간 (100ms)

on_htime

Uint16

O

점등유지시간(s)

off_htime

Uint16

O

소등유지시간(s)

on_dtime

Uint16

O

점등대기시간(s)

off_dtime

Uint16

O

소등대기시간(s)

color_tt

Uint16

O

색상 및 상관 색온도 변환 소요시간 (100ms)

offlevel

Uint8

O

Off 명령어시 소등되는 밝기

level_rate

Uint8

O

조명 출력 비율

rperiod

Uint16

O

조명 상태정보 보고 주기 (s)

last_light

String(6~7)

O

점등시 마지막 조명상태 복구

onconfig

Object

O

조명 점등 상태정보 객체

onlevel

Uint8

O

조명 점등시 밝기

colortemp

Uint16(4)

O

조명 상관 색온도

r

Uint8

O

조명 색상(R, G, B)의 적색(Red)

g

Uint8

O

조명 색상(R, G, B)의 녹색(Green)

b

Uint8

O

조명 색상(R, G, B)의 청색(Blue)

x

Float(3,2)

O

조명 색상(CIE 1931 XY 색좌표)의 x

y

Float(3,2)

O

조명 색상(CIE 1931 XY 색좌표)의 y

hue

Uint8

O

조명 색상(HSB)의 색상

sat

Uint8

O

조명 색상(HSB)의 채도

bright

Uint8

O

조명 색상(HSB)의 휘도

Payload

Example 1

onoff_tt=50;

dimup_tt=10;

dimdn_tt=10;

color_tt=10;

offlevel=20

Payload

Example 2

onoff_tt=0;

level_rate=80;

rperiod=300;

last_light=enable;

onconfig={onlevel=80; colortemp=6000}

비고

- 디바이스는 조명의 속성 정보를 설정한 후 유지하고 있어야 함

Header

Ver

Type

Code

Options

01

ACK

2.04 (Changed)

Content-Format: text/plain

Payload

항목

타입(길이)

C

내용

did

Uint16

M

디바이스 논리주소

onoff_tt

Uint16

CM

점소등소요시간 (100ms)

dimup_tt

Uint16

CM

밝기 증가시 목표 밝기도달 소요시간 (100ms)

dimdn_tt

Uint16

CM

밝기 감소시 목표 밝기도달 소요시간 (100ms)

on_htime

Uint16

CM

점등유지시간(s)

off_htime

Uint16

CM

소등유지시간(s)

on_dtime

Uint16

CM

점등대기시간(s)

off_dtime

Uint16

CM

소등대기시간(s)

color_tt

Uint16

CM

색상 및 상관 색온도 변환 소요시간 (100ms)

offlevel

Uint8

CM

Off 명령어시 소등되는 밝기

level_rate

Uint8

CM

조명 출력 비율

rperiod

Uint16

CM

조명 상태정보 보고 주기 (s)

last_light

String(6~7)

CM

점등시 마지막 조명상태 복구

onconfig

Object

CM

조명 점등 상태정보 객체

onlevel

Uint8

CM

조명 점등시 밝기

colortemp

Uint16(4)

CM

조명 상관 색온도

r

Uint8

CM

조명 색상(R, G, B)의 적색(Red)

g

Uint8

CM

조명 색상(R, G, B)의 녹색(Green)

b

Uint8

CM

조명 색상(R, G, B)의 청색(Blue)

x

Float(3,2)

CM

조명 색상(CIE 1931 XY 색좌표)의 x

y

Float(3,2)

CM

조명 색상(CIE 1931 XY 색좌표)의 y

hue

Uint8

CM

조명 색상(HSB)의 색상

sat

Uint8

CM

조명 색상(HSB)의 채도

bright

Uint8

CM

조명 색상(HSB)의 휘도

Payload

Example 1

did=32;

onoff_tt=50;

dimup_tt=10;

dimdn_tt=10;

color_tt=10;

offlevel=20;

Payload

Example 2

did=32;

onoff_tt=0;

level_rate=80;

rperiod=300;

last_light=enable;

onconfig={onlevel=80; colortemp=6000}

비고

- 응답의 CM 조건: 요청에 포함된 속성은 응답에도 포함되어야 함

- 디바이스는 조명의 설정정보를 설정한 후 유지하고 있어야 함

Header

Ver

Type

Code

Options

01

CON

0.03 (PUT)

0.06 (PATCH)

URI-Path: {base_url}/lightconfig

Content-Format: text/plain

Payload

항목

타입(길이)

C

내용

lightconfig_list

Object Array

M

조명 설정정보 목록

mid

Uint8

M

모듈 논리주소

onoff_tt

Uint16

O

점소등소요시간 (100ms)

dimup_tt

Uint16

O

밝기 증가시 목표 밝기도달 소요시간 (100ms)

dimdn_tt

Uint16

O

밝기 감소시 목표 밝기도달 소요시간 (100ms)

on_htime

Uint16

O

점등유지시간(s)

off_htime

Uint16

O

소등유지시간(s)

on_dtime

Uint16

O

점등대기시간(s)

off_dtime

Uint16

O

소등대기시간(s)

color_tt

Uint16

O

색상 및 상관 색온도 변환 소요시간 (100ms)

offlevel

Uint8

O

Off 명령어시 소등되는 밝기

level_rate

Uint8

O

조명 출력 비율

rperiod

Uint16

O

조명 상태정보 보고 주기 (s)

last_light

String(6~7)

O

점등시 마지막 조명상태 복구

onconfig

Object

O

조명 점등 상태정보 객체

onlevel

Uint8

O

조명 점등시 밝기

colortemp

Uint16(4)

O

조명 상관 색온도

r

Uint8

O

조명 색상(R, G, B)의 적색(Red)

g

Uint8

O

조명 색상(R, G, B)의 녹색(Green)

b

Uint8

O

조명 색상(R, G, B)의 청색(Blue)

x

Float(3,2)

O

조명 색상(CIE 1931 XY 색좌표)의 x

y

Float(3,2)

O

조명 색상(CIE 1931 XY 색좌표)의 y

hue

Uint8

O

조명 색상(HSB)의 색상

sat

Uint8

O

조명 색상(HSB)의 채도

bright

Uint8

O

조명 색상(HSB)의 휘도

Payload

Example 1

lightconfig_list=[

{

mid=2;

level_rate=90;

last_light=enable;

onconfig={

onlevel=90

}

},

{

mid=3;

level_rate=80;

last_light=enable;

onconfig={

onlevel=80

}

}

]

조명 모듈이 2개인 조명 디바이스의 설정

Payload

Example 2

did=32;

lightconfig_list=[

{

mid=2;

onoff_tt=0;

dimup_tt=10;

dimdn_tt=10;

color_tt=10;

level_rate=80;

last_light=enable;

onconfig={

onlevel=80;

colortemp=6000

}

}

]

조명 모듈이 1개인 조명 디바이스의 설정

비고

- 디바이스는 조명의 설정정보를 설정한 후 유지하고 있어야 함

Header

Ver

Type

Code

Options

01

ACK

2.04 (Changed)

Content-Format: text/plain

Payload

항목

타입(길이)

C

내용

did

Uint16

M

디바이스 논리주소

lightconfig_list

Object Array

M

조명 설정정보 목록

mid

Uint8

M

모듈 논리주소

onoff_tt

Uint16

CM

점소등소요시간 (100ms)

dimup_tt

Uint16