MYPAGE LOGIN
개요 데이터 모델 백본 네트워크 I/F 로컬 조명 네트워크 I/F 기술지원 / Q&A

데이터 모델

1. 개요
2. 공통
3. 스마트 조명 디바이스
4. 그룹
5. 장면
6. 사용자 입력장치
7. 설치시험기
8. 게이트웨이
9. 속성값 정의
10. 부록
1. 개요
1.1 개요

본 문서는 스마트 조명 조명/센서의 L-SLP(Local – Smart Lighting Profile) API(Application Programming Interface)에 대한 규격서이다. 이 규격서는 CoAP의 Plain text 형태로 작성된다.

1.2 관련 문서

1. 스마트 조명 시스템 – 제1부 일반 요구사항, KSC7751-1
2. 스마트 조명 시스템 – 제2부 시스템 구조, KSC7751-2
3. 스마트 조명 시스템 – 제3부 주소체계, KSC7751-3
4. 스마트 조명 조명/센서 L-SLP CoAP API 규격서 (Plain-text)
5. 스마트 조명 게이트웨이 B-SLP REST API 규격서
6. 스마트 조명 게이트웨이 B-SLP MQTT API 규격서
7. 스마트 조명 게이트웨이 L-SLP CoAP API 규격서
8. The Contrained Application Protocol (CoAP), 2014.06, IETF RFC 7252
9. Observing Resources in the Constrained Application Protocol (CoAP), 2015.09, IETF RFC 7641
10. PATCH and FETCH Methods for the Constrained Application Protocol (CoAP), 2017.04, IETF RFC 8132

1.3 약어

번호

약어

설명

1

GW

Gateway

2

BPV

B-SLP Profile Version

3

B-SLP

Backbone - Smart Lighting Profile

4

CID

Controller IDentification

5

CPID

Controller Physical IDentification

6

CoAP

Contrained Application Protocol

7

DID

Device IDentification

8

DPID

Device Physical IDentification

9

GID

Group IDentification

10

GWID

Gateway IDentification

11

GWPID

Gateway Physical IDentification

12

LD

Lighting Device

13

LID

Location IDentification

14

LPV

L-SLP Profile Version

15

L-SLP

Local - Smart Lighting Profile

16

MS

Management Server

17

PC

Produce Code

18

PID

Physical IDentification

19

SCID

Scene IDentification

20

SD

Sensor Device

21

SN

Serial Number

22

TID

Tester IDentification

23

TPID

Test Device Physical IDentification

24

TS

Test Device

25

UD

User input Device

26

URL

Uniform Resource Locator

 

 

2. 공통
2.1 속성 테이블 요소

2.1.1 속성
스마트 조명 시스템 내에서의 속성에 대한 고유 이름을 지정한다. 스마트 조명 시스템의 모든 장치는 지정된 문자열 이름을 사용하여야 한다.


2.1.2 타입
각 속성 타입은 Uint8(Unsigend Integer – 8 bits), Uint16(Unsigend Integer – 16 bits), Uint32 (Unsigend Integer – 32 bits), Float(Floating point), Hex(Hexadecimal), String(문자열), Object(객체)를 지원한다. 또한 속성 타입별 배열(Array)를 지원한다.


2.1.3 길이
해당 속성이 제공하는 값이 표시할 수 있는 문자열 기준의 길이를 지정한다. Float는 소수점을 제외한 전체 길이와 소수점 아래의 길이를 지정하며, '.'으로 구분하여 표기한다.


2.1.4 단위
해당 속성이 제공하는 값의 단위를 지정한다.


2.1.5 범위
해당 속성이 제공할 수 있는 값의 범위를 지정한다.


2.1.6 기본값
개별 속성은 별도의 설정 동작이 없는 경우 가져야하는 초기값을 나타낸다. 


2.1.7 접근 권한
속성에 대한 읽기 및 쓰기 권한을 지정한다. 속성에 대한 접근 권한에는 읽기 전용(RO, read only), 쓰기 전용(WO, write only), 읽기 및 쓰기(RW, read & write)로 구분되어진다. 읽기 전용 속성은 값을 변경할 수 없으며, 쓰기 전용 속성은 조회할 수 없다.


2.1.8 대상
해당 속성을 지원해야하는 스마트 조명 시스템의 구성요소를 지정한다. 스마트 조명 시스템의 구성요소에는 디바이스, 게이트웨이, 사용자 입력장치, 설치시험기 등이 있다. 본 규격에서의 대상 범위는 디바이스와 게이트웨이에 한하며 디바이스, 게이트웨이 또는 모든 장치중 하나로 지정할 수 있다.


2.1.9 필수 여부
속성의 필수 지원 여부를 지정한다. 필수적으로 구현되어야 하는 속성은 M(Mandatory)으로 표시되고, 선택 구현할 수 있는 속성은 O(Optional)로 표시한다. 조건이 만족하는 경우 필수적으로 구현되어야 하는 속성은 CM(Conditionaly Mandatory)로 표시한다.


2.1.10 설명
해당 속성에 대한 기본적인 설명을 제공한다.

 

2.2 공통 속성

1.1.1 제품코드(pc)
스마트 조명 시스템의 구성요소들인 관제장치, 사용자 입력장치, 시험장치, 게이트웨이, 스마트등기구, 스마트 센서, 제어기에 대한 고유 정보를 제공하는 코드로 제조사 정보, 기기 종류, 기기 형상, 기기 기능, 통신 기능 등을 포함하고 있다. 상세한 규격은 KSC7751-3, “스마트 조명 시스템-제3부 주소체계” 표준을 따른다.

 

1.1.2 일련번호(sn)
스마트 조명 시스템의 제조사가 부여한 일련번호이다.

 

1.1.3 물리주소(pid)
스마트 조명 시스템의 구성요소들은 각각 고유의 물리주소를 제공한다. 물리주소는 제조사 코드와 제조사 할당 주소로 구성되어 있다. 상세한 규격은 KSC7751-3, “스마트 조명 시스템-제3부 주소체계” 표준을 따른다.

 

1.1.4 위치주소(lid)
게이트웨이, 사용자 입력장치, 디바이스 등의 위치를 나타내는 주소이다.

 

KSC7751-3, “스마트 조명 시스템-제3부 주소체계” 표준을 따른다. 위치주소는 전체 14 바이트로 위치주소의 사용유무를 나타내는 사용유무 비트(0-사용, 1-사용하지 않음), 실내외를 구분하는 실내외 비트(0-실내, 1-실외), 지상과 지하를 구분하는 지하 비트(0-지상, 1-지하)를 공통으로 가진다. X, Y, Z좌표는 3D 모델링 파일 원점 기준 mm 단위인 양의 정수 값이다.

 

실내형 위치주소 구조

 

실외형 위치주소 구조

 

실외형 위치주소 구조에서는 좌표계 인덱스를 이용하여 다양한 경위도 표시 규격을 지원할 수 있다. 위도와 경도는 위치주소 구분을 위하여 좌표계의 소수점 7자리까지 표시할 수 있으며, 4Byte 실수의 표현 범위로 인해 정수화하여 사용한다. 정수화는 천만(10,000,000)을 곱하거나 나누어 진행한다. Z좌표는 실내형 위치주소와 동일하다.

 

KS 표준에 정의된 좌표계 인덱스 값에 따른 좌표계는 다음과 같다. 국내에서는 2000년 이후 GRS80 타원체의 UTM-K 직각 좌표계 사용을 권고하고 있으므로ESPG:5179 또는 ESPG:5181 좌표계 사용을 권장한다.

 

좌표계 인덱스

EPSG 코드

좌표계

비고

0

-

NULL

-

1

4166

WGS84

World Geodetic System 1984 (GPS 경위도 좌표계)

2

2097

Bessel 1841

Bessel 1841 타원체의 한국 중부원점 TM 직각 좌표계

3

5179

GRS80

GRS80 타원체의 UTM-K 직각 좌표계. 네이버지도에서 사용

4

3857

Google Mercator

TM방식의 좌표계. 구글맵에서 사용

5

5178

Bessel 1841

Bessel 1841 타원체의 UTM-K 직각 좌표계

6

5181

GRS80

GRS80 타원체의 한국 중부원점이며 Y 축으로 500,000미터만큼 이동시킨 좌표계. 카카오맵에서 사용

7~

-

-

Reserved

 
3. 스마트 조명 디바이스
3.1 디바이스 공통 속성

스마트 조명 디바이스는 디바이스 논리주소(did)와 기본정보(dinfo), 수용능력(cap), 모듈 목록(modules), 그룹 논리주소 목록(gid_list), 장면 논리주소 목록(scid_list)를 포함하는 디바이스 공통정보와 그룹(group), 장면(scene) 속성을 가질 수 있다. 또한, 조명 디바이스는 조명상태(light), 조명설정(lightconfig) 정보를 추가로 제공하고, 센서는 센서(sensor)를 제공할 수 있다. 디바이스 속성은 접근 권한으로 RO(read only), WO(write only), RW(read & write)를 가지며, 접근 권한에 따라 CoAP 클라이언트는 속성값을 액세스할 수 있다. 디바이스 속성에는 또한 휘발성 메모리에 저장되어야 하는지, 그렇지 않은지의 여부를 나타내어야 하고, 필수적으로 구현되어야 하는 속성은 M(Mandatory)으로 표시되고, 선택 구현할 수 있는 속성은 O(Optional)로 표시한다.

 

속성

타입

길이

단위

범위

디폴트

액세스

대상1)

필수

설명

did

Uint16

1~5

 

1~65535

0

RW

A

M

디바이스 논리주소

dinfo

Object

-

 

-

-

-

A

M

디바이스 기본정보 객체

cap

Object

-

 

-

-

-

A

M

디바이스 수용능력 객체

modules

Object Array

-

 

-

-

-

A

M

디바이스의 모듈 목록 객체

gid_list

Uint16 Array

-

-

-

-

-

A

M

디바이스가 등록된 그룹 논리주소 목록

scid_list

Uint16 Array

-

-

-

-

-

A

M

디바이스가 등록된 장면 논리주소 목록

 

 

3.1 디바이스 공통 속성


디바이스 공통 속성은 조명 또는 센서 디바이스가 공통으로 가져야하는 속성을 포함한다.

 

3.1.1 디바이스 기본정보 속성

mqtt_df_enable 속성은 게이트웨이 기본정보의 mqtt_df_enable 속성이 enable일 경우에 디바이스의 오류 정보의 포함 여부를 결정한다.

 

속성

타입

길이

단위

범위

디폴트

액세스

대상

필수

설명

did1)

Uint16

1~5

-

0~65535

0

RW

A

M

디바이스 논리주소

dinfo

Object

-

-

-

-

-

A

M

디바이스 기본정보 객체

dpid

Hex

18

-

-

-

RO

A

M

디바이스 물리주소

pc

Hex

62

-

-

-

RO

A

M

디바이스 제품코드

sn

String

10

-

-

-

RO

A

M

디바이스 시리얼 번호

lid

Hex

28

-

-

0

RW

A

M

디바이스의 위치주소

lpv

String

-

-

-

1.0.0

RO

A

M

L-SLP 버전

ip

String

7~15

-

-

-

RW

A

M

디바이스 접속 IP 주소

uport

Uint16

4~5

-

1000~

65535

5683

RW

A

CM

디바이스 L-SLP 접속 UDP 포트번호

ct2)

String

2

-

pt, os

pt

RW

A

O

디바이스에서 지원하는 Content Format

name

String

-

-

-

-

RW

A

O

디바이스 이름

dfault

Uint8

1

-

0~4

0

RO

A

M

디바이스 상태 정보

fslist

Object Array

-

-

-

-

RO

A

M

디바이스 모듈별 장애 정보 배열객체

mid

Uint8

1~3

-

1~255

0

RO

A

M

모듈 논리주소

fcode3)

Hex

8

-

00000000

~FFFFFFFF

00000000

RO

A

M

모듈장애 비트 표시

mqtt_df_enable

String

1

-

enable,

disable

enable

RW

G

M

게이트웨이 MQTT Fault Alarm 활성화 여부

delay

Uint16

1~5

s

1-65535

5

RW

A

O

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

blink4)

Uint8

1~3

1-255

5

WO

D

O

디바이스 식별을 위한 점멸 횟수

 

1) 디바이스 논리주소
- 0: 미할당
- 1~65534: 게이트웨이 할당 고유 논리주소
- 65535: 모든 디바이스
2) Content Format
- pt : plain text
- os: octet stream
3) 모듈장애 비트 표시
- “9.1 모듈 장애 비트” 참조
4) 디바이스 식별을 위한 점멸 횟수(blink) 정보는 쓰기 전용(Write Only)으로 요청시 한 번만 적용되고 저장되지 않음(GET으로 읽어갈 수 없음)

 

3.1.2 디바이스 수용능력 

디바이스의 모듈, 그룹, 장면 정보를 수용할 수 있는 능력 정보를 포함한다.

 

속성

타입

길이

단위

범위

디폴트

액세스

대상

필수

설명

cap

Object

-

-

-

-

-

A

M

게이트웨이 능력 정보 객체

mcap

Object

-

-

-

-

-

A

M

모듈 수용능력 정보

in_maxm

Uint8

1~3

0~255

255

RO

A

CM

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

- 조건: 내부 모듈 기능이 있는 경우

in_usedm

Uint8

1~3

0~255

255

RO

A

CM

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

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

ex_maxm

Uint8

1~3

0~255

255

RO

A

CM

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

- 조건: 외부 모듈 기능이 있는 경우

ex_usedm

Uint8

1~3

0~255

255

RO

A

CM

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

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

gcap

Object

-

-

-

-

-

A

M

그룹 수용능력 정보 객체

maxg

Uint8

1~3

0~255

255

RO

A

M

지원 가능한 그룹 개수

usedg

Uint8

1~3

0~255

255

RO

A

M

사용중인 그룹 개수

scap

Object

-

-

-

-

-

A

M

장면 수용능력 정보 객체

maxs

Uint8

1~3

0~255

255

RO

A

M

지원 가능한 장면 개수

useds

Uint8

1~3

0~255

255

RO

A

M

사용중인 장면 개수

 
 
3.1.3 모듈 속성 

모든 디바이스는 모듈을 지원하여야 하며 모듈 논리주소(mid) 1번은 통신모듈에 할당하여야 한다.
 
 

속성

타입

길이

단위

범위

디폴트

액세스

대상

필수

설명

modules

Object Array

-

-

-

-

-

A

M

디바이스 모듈 객체 목록

mid

Uint8

1~3

-

1~255

0

RO

A

M

모듈 논리주소

minfo

Object

-

-

-

-

-

A

M

디바이스 모듈 기본정보 객체

mclass1)

String

1

-

l, c, s

-

RO

A

M

모듈 분류

mtype2)

Uint8

1~3

-

0~255

-

RO

A

M

모듈 분류(mclass)에 따른 유형

form

String

2

-

in, ex

in

RO

A

M

모듈 장착 방식

- 각 모듈이 기구물 내부(in) 장착인지 외부(ex) 작창 인지 표시

mqtt_mf_enable

String

6~7

-

enable,

disable

enable

RW

G

M

모듈단위 MQTT Fault Alarm 활성화 여부

light

Object

-

-

-

-

-

A

CM

조명 상태정보

- 조건: 조명 모듈인 경우

  {light attrs}

-

-

-

-

-

-

A

O

3.2.1 조명 상태정보 속성

lightconfig

Object

-

-

-

-

-

A

CM

조명 설정정보
- 조건: 조명 모듈인 경우

  {lightconfig attrs}

-

-

-

-

-

-

A

O

3.2.3 조명 설정정보 속성

sensor

Object

-

-

-

-

-

A

CM

센서 기본정보

- 조건: 센서 모듈인 경우

  {sensor attrs}

-

-

-

-

-

-

A

O

3.3.1 센서 공통 설정정보 속성

 
1) mclass
- “9.1.1 mclass” 참조
2) mclass별 모듈 mtype
- “9.1.2 mtype” 참조
 
3.2 조명 속성

3.2.1 조명 상태정보 속성

조명 기능을 제공하는 디바이스는 조명상태 속성을 지원하여야 한다.
조명 광의 색상 정보를 표현하는 방식에는 KS A 5700의 HSB(Hue, Saturation, Brightness), KS C IEC 60050-845의 CIE 1931 xy 색좌표, RGB(Red, Green, Blue) 표색계를 지원한다. 색상 제어가 가능한 스마트 등기구는 지원 가능한 모든 색상 정보 표현 방식을 포함할 수 있다.

 

속성

타입

길이

단위

범위

디폴트

액세스

대상

필수

설명

light

Object

-

 

-

-

-

A

CM

조명 상태정보 객체

onoff

String

2~3

 

on, off, tog1)

on

RW

A

M

조명기기의 현재 On/Off 상태 정보

level

Uint8

1~3

1

1~100

100

RW

A

M

조명 밝기(디밍 레벨)

- off 상태에서는 조회시 0이어야 함

colortemp

Uint16

4

 

2700~6500

5000

RW

A

CM

조명 상관 색온도

hue2)

Uint16

1~3

 

0~359

0

RW

A

CM

조명 색상(HSB)의 색상

sat

Uint8

1~3

 

0~100

0

RW

A

CM

조명 색상(HSB)의 채도

bright

Uint8

1~3

 

0~100

100

RW

A

CM

조명 색상(HSB)의 휘도

x

Float(3,2)

1~5

 

0~0.8

0.22

RW

A

CM

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

y

Float(3,2)

1~5

 

0~0.9

0.48

RW

A

CM

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

r

Uint8

1~3

 

0~255

255

RW

A

CM

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

g

Uint8

1~3

 

0~255

255

RW

A

CM

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

b

Uint8

1~3

 

0~255

255

RW

A

CM

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

tt3)

Uint16

1~5

100ms

0-65535

0

WO

A

M

동작소요시간

 
1) tog (toggle)
- on 상태를 off 상태로, off 상태를 on 상태로 변경
- 상태변경을 위한 동작소요시간은 메시지에 포함된 점등소요시간(tt) 또는 조명 설정정보의 점소등소요시간(onoff_tt)을 사용함
2) Hue 색상
- 0 = 360
- http://www.huecode.com
3) 동작소요시간(transition time)
- onoff, level, colortemp, color 관련 명령시 적용되는 천이 시간
- 해당 명령어는 쓰기 전용(Write Only)으로 요청시 한 번만 적용되고 저장되지 않음(GET으로 읽어갈 수 없음)
- onoff, level, colortemp, color 관련 명령이 함께 와야함, 단독으로 사용될 수 없음
 
 
3.2.2 조명 상태정보 목록 객체
조명 디바이스가 다수의 조명 모듈로 구성된 경우 조명상태 목록 속성을 지원하여야 한다.
 
 

속성

타입

길이

단위

범위

디폴트

액세스

대상

필수

설명

light_list

Object Array

-

-

-

-

-

A

CM

조명 상태정보 목록 객체

mid

Uint8

1~3

-

1~255

0

RO

A

M

모듈 논리주소

onoff

String

2~3

-

off, on, tog

on

RW

A

M

조명기기의 현재 On/Off 상태 정보

level

Uint8

1~3

-

1~100

100

RW

A

M

조명 밝기(디밍 레벨)

- off 상태에서는 조회시 0이어야 함

colortemp

Uint16

4

-

2700~6500

5000

RW

A

CM

조명 상관 색온도

hue

Uint16

1~3

-

0~359

0

RW

A

CM

조명 색상(HSB)의 색상

sat

Uint8

1~3

-

0~100

0

RW

A

CM

조명 색상(HSB)의 채도

bright

Uint8

1~3

-

0~100

100

RW

A

CM

조명 색상(HSB)의 휘도

x

Float(3,2)

1~5

-

0~0.8

0.22

RW

A

CM

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

y

Float(3,2)

1~5

-

0~0.9

0.48

RW

A

CM

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

r

Uint8

1~3

-

0~255

255

RW

A

CM

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

g

Uint8

1~3

-

0~255

255

RW

A

CM

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

b

Uint8

1~3

-

0~255

255

RW

A

CM

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

tt

Uint16

1~5

100ms

0-65535

0

WO

A

M

동작소요시간

 
3.2.3 조명 설정정보 속성
조명 기능을 제공하는 디바이스는 조명설정(lightconfig) 속성을 지원하여야 한다.
 
 

속성

타입

길이

단위

범위

디폴트

액세스

대상

필수

설명

onoff_tt

Uint16

1~5

100ms

0-65535

0

RW

A

O

점소등소요시간

- 점등 또는 소등 시 소요되는 시간

dimup_tt

Uint16

1~5

100ms

0-65535

0

RW

A

O

밝기 증가시 목표 밝기 도달 시간

- 요청받은 밝기(level)이 현재보다 큰 경우 목표 밝기에 도달하는 시간

dimdn_tt

Uint16

1~5

100ms

0-65535

0

RW

A

O

밝기 감소시 목표 밝기 도달 시간

- 요청받은 밝기(level)이 현재보다 작은 경우 목표 밝기에 도달하는 시간

on_htime

Uint16

1~5

1s

0-65535

65535

RW

A

O

점등유지시간(on hold time)

- Off에서 On으로 가서 On 유지되는 시간으로 종료 후 다시 Off

(On 명령을 받은 이후 On 유지시간)

- 65535인 경우에는 유지 지속

off_htime

Uint16

1~5

1s

0-65535

65535

RW

A

O

소등유지시간(off hold time)

- On에서 Off로 가서 Off 유지되는 시간으로 종류 후 다시 On
(Off 명령 이후 Off 유지시간)
- 65535인 경우에는 유지 지속

on_dtime

Uint16

1~5

1s

0-65535

0

RW

A

O

점등대기시간(on delay time)

- 점등 요청을 받고 점등 수행까지 대기 시간

off_dtime

Uint16

1~5

1s

0-65535

0

RW

A

O

소등대기시간(off delay time)

- 소등 요청을 받고 소등 수행까지 대기 시간

color_tt

Uint16

1~5

100ms

0-65535

0

RW

A

O

색상 및 상관 색온도 변환 소요시간

offlevel

Uint8

1~3

-

0-100

0

RW

A

O

소등(off) 명령 시 소등되는 밝기

level_rate

Uint8

1~3

%

1~100

100

RW

A

M

조명 출력 비율: level값에 대한 rate 설정

rperiod

Uint16

1~5

1s

0-65535

10

RW

A

O

조명 상태정보 보고 주기

- 0: 보고 중지

last_light

String

6~7

-

enable, disable

enable

RW

A

M

점등시 마지막 조명 상태정보 복구
- disable: 조명 점등 상태정보(onconfig)의 onlevel 속성의 값으로 점등

- enable: 마지막 조명 상태로 점등

onconfig

Object

-

-

-

-

-

A

M

3.2.3.1 조명 점등 상태정보 객체

 
3.2.3.1 조명 점등 상태정보(onconfig) 속성
조명 점등 상태정보는 조명 기능을 제공하는 디바이스에서 조명이 전원 공급에 의해 점등되거나 또는 마지막 조명 상태정보 복구(lightconfig/last_light) 속성이 비활성화인 상태에서 조명 점등 명령을 받은 조명이 점등시 제공해야하는 조명상태를 포함하는 속성이다.
 
 

속성

타입

길이

단위

범위

디폴트

액세스

대상

필수

설명

onlevel

Uint8

1~3

-

1~100

100

RW

A

M

점등시 조명 밝기(디밍 레벨)

- 전원 점등시 점등 밝기

- last_light=disable 일때 점등 명령에 의한 점등 밝기

colortemp

Uint16

4

-

2700~6500

5000

RW

A

CM

점등시 조명 상관 색온도

hue

Uint16

1~3

-

0~359

0

RW

A

CM

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

sat

Uint8

1~3

-

0~100

0

RW

A

CM

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

bright

Uint8

1~3

-

0~100

100

RW

A

CM

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

x

Float(3,2)

1~5

-

0~0.8

0.22

RW

A

CM

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

y

Float(3,2)

1~5

-

0~0.9

0.48

RW

A

CM

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

r

Uint8

1~3

-

0~255

255

RW

A

CM

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

g

Uint8

1~3

-

0~255

255

RW

A

CM

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

b

Uint8

1~3

-

0~255

255

RW

A

CM

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

 
3.2.4 조명 설정정보 목록 속성
조명 디바이스가 다수의 조명 모듈로 구성된 경우 조명설정 목록(lightconfig_list) 속성을 지원하여야 한다.
 
 

속성

타입

길이

단위

범위

디폴트

액세스

대상

필수

설명

mid

Uint8

1~3

-

1~255

0

RO

A

M

모듈 논리주소

onoff_tt

Uint16

1~5

100ms

0-65535

0

RW

A

O

점소등소요시간

- 점등 또는 소등시 소요되는시간

dimup_tt

Uint16

1~5

100ms

0-65535

0

RW

A

O

디밍 업시 목표 밝기 도달 시간
- 디밍 업인 경우 목표 밝기에 도달하는 시간

dimdn_tt

Uint16

1~5

100ms

0-65535

0

RW

A

O

디밍 다운시 목표 밝기 도달 시간
디밍 다운인 경우 목표 밝기에 도달하는 시간

on_htime

Uint16

1~5

1s

0-65535

65535

RW

A

O

점등유지시간

- Off에서 On으로 가서 On 유지되는 시간으로 종료 후 다시 Off

(On 명령 받은 이후 On 유지시간)

65535인 경우에는 유지 지속

off_htime

Uint16

1~5

1s

0-65535

65535

RW

A

O

소등유지시간

- On에서 Off로 가서 Off 유지되는 시간으로 종류 후 다시 On
(Off 명령 이후 Off 유지시간)
- 65535인 경우에는 유지 지속

off_dtime

Uint16

1~5

100ms

0-65535

0

RW

A

O

소등대기시간(s)

- Off할 때 Off 수행까지 대기 시간

on_dtime

Uint16

1~5

100ms

0-65535

0

RW

A

O

점등대기시간

- On할 때 On 수행까지 대기 시간

color_tt

Uint16

1~5

100ms

0-65535

0

RW

A

O

color, colortemp 변환 시간

offlevel

Uint8

1~3

 

0-100

0

RW

A

O

Off 명령어시 소등되는 레벨

level_rate

Uint8

1~3

 

1~100

100

RW

A

M

조명 출력 비율: level값에 대한 rate 설정

rperiod

Uint16

1~5

 

0-65535

10

RW

A

O

조명 상태정보 보고 주기

- 0: 보고 중지

last_light

String

6~7

 

enable, disable

enable

RW

A

M

점등시 마지막 조명 상태정보 복구
- disable: onlevel로 점등

- enable: 마지막 조명 상태로 점등

onconfig

Object

-

-

-

-

-

A

M

조명 점등 상태정보 객체

 
 
3.3 센서 속성

3.3.1 센서 공통 설정정보

센서는 문의 개폐 상태, 인지 상태 등 상태(status) 정보를 제공하는 Status형 센서와 온도, 습도, 조도 등 값(value)을 제공하는 value형 센서로 구분한다. 본 절에서는 Status형 센서와 Value형 센서의 속성 정보의 기본 구조를 정의하고 센서 종류별로 센서형에 맞게 개별 정의하여 사용한다.

 

속성

타입

길이

단위

범위

디폴트

액세스

대상

필수

설명

active

String

6~7

-

enable, disable

enable

RW

A

M

센서기기의 현재 상태 정보

opmode1)

String

3~10

-

act, notify,
act_notify

notify

RW

A

M

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

mperiod

Uint16

1~5

100ms

1-65535

10

RW

A

M

센서 측정 주기

rperiod

Uint16

1~5

1s

0-65535

10

RW

A

M

센서 출력 보고 주기

- 0: 보고 중지

vtype

String

5~6

-

string, uint8, uint16, float, uint8a, uint16a, floata

-

RO

A

M

센서 출력의 데이터 형식

value2)

{vtype}

-

-

{value range}

c

RO

A

M

센서 출력

control_list

Object Array

-

-

-

-

RW

A

CM

3.3.1.1 이벤트 발생 시 제어 정보

 
1) 동작 모드
- actuator 실행 모드: 센서의 이벤트 발생시 센서 상태별 제어 정보에 따라 조명을 직접 제어하는 모드
- notify 모드: 센서의 이벤트 발생 정보를 보고하는 모드
- actuator 실행 및 notify 모드: 센서의 이벤트 발생시 센서 상태별 제어 정보에 따라 조명을 직접 제어 및 센서 이벤트 발생 정보를 보고하는 모드
2) 센서 출력
- 센서 출력의 데이터형식(vtype)에서 선언된 데이터 타입 가진다.
- 데이터 타입에 따라 범위가 결정된다.
 
 
3.3.1.1 제어정보(control) 속성

제어정보(control) 속성은 센서가 actuator 실행 모드 또는 actuator 실행 및 notify 모드일때 조명 직접 제어를 위한 제어 대상 및 조명 상태정보를 포함하는 객체 정보이다. 
제어정보 속성에는 제어 키와 장면 논리주소, 대상 목록 정보가 포함된다. 제어 키는 Status형센서의 경우 센서의 상태값, Value형의 경우 최대, 최소, 중간값을 표시하는 키값이 올 수 있다. 대상 목록 정보에는 디바이스, 모듈, 그룹 단위로 개별 조명 상태를 설정할 수 있다. 제어정보에는 장면 논리주소와 제어 대상 목록중 하나를 포함하여야 한다. 제어 대상 목록보다는 장면 논리주소를 사용하는 것을 권장한다.
 
 

속성

타입

길이

단위

범위

디폴트

액세스

대상

필수

설명

key

String

-

-

-

-

RW

A

M

이벤트 키

scid

Uint16

1~5

-

1~65535

0

RW

A

CM

장면 논리주소

- 조건: tlist가 포함되지 않은 경우

tlist

Object Array

-

-

-

-

-

A

CM

제어 대상 및 상태정보 객체

- 조건: scid가 포함되지 않은 경우

light

Object

-

-

-

-

-

A

M

조명 상태정보 객체

{light attribute}

-

-

-

-

-

-

A

M

3.2.1 조명 상태정보 속성

did

Uint16

1~5

-

1~65535

0

RW

A

CM

디바이스 논리주소

- 조건: mid를 포함하는 경우

mid

Uint8

1~3

-

1~255

0

RO

A

CM

모듈 논리주소

gid

Uint16

1~5

-

1~65535

0

RW

A

CM

그룹 논리주소

 
3.3.2 Status형 센서

본 절에서는 Status형 센서들에 대하여 개별적인 속성을 정의한다.

3.3.2.1 Status형 센서 설정정보

Status형 센서에는 센서 공통 설정정보와 제어 키 목록, 특수 속성을 추가적으로 가질 수 있다.
특수속성에는 시간 속성은 Status형 센서의 제어 키(key) 종류별로 가질 수 있다.
 

속성

타입

길이

단위

범위

디폴트

액세스

대상

필수

설명

active

String

6~7

-

enable, disable

enable

RW

A

M

센서기기의 현재 상태 정보

opmode

String

3~10

-

act, notify,
act_notify

notify

RW

A

M

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

mperiod

Uint16

1~5

100ms

1-65535

10

RW

A

M

센서 측정 주기

rperiod

Uint16

1~5

1s

0-65535

10

RW

A

M

센서 상태정보 보고 주기

- 0: 보고 중지

vtype

String

5~6

-

string

-

RO

A

M

센서출력의 데이터 형식

value

String

 

-

{status}

c

RO

A

M

센서 상태 출력

control_list

Object Array

-

-

-

-

RW

A

CM

3.3.1.1 이벤트 발생 시 제어 정보

{특수 속성}4)

-

-

-

-

-

-

A

O

센서 타입에 따른 고유 속성

 
3.3.2.2 인지센서 (presence) 특수 속성

인지센서는 인지 후 제어 상태 유지시간, 인지종료 예고 시간을 추가로 포함한다.
 

속성

타입

길이

단위

범위

디폴트

액세스

대상

필수

설명

klist

String Array

3

-

[p, t, n]

-

RO

A

M

인지센서 제어 키 목록

pperiod

Uint16

1~5

100ms

1-65535

10

RW

A

O

인지(p) 후 센서 측정 주기

ptime

Uint16

-

100ms

0-65535

-

RW

A

O

인지(p) 후 제어 상태 유지시간

- 65535: 계속 유지

ttime

Uint16

-

100ms

0-65535

-

RW

A

O

ptime 종료 전 종료 예고 시간

- ptime보다 작은값이어야 함

- 65535: 계속 유지

 
 
 
3.3.2.3 도어센서 (door) 속성

도어센서는 센서 공통 속성만을 지원한다.
 

속성

타입

길이

단위

범위

디폴트

액세스

대상

필수

설명

klist

String Array

2

-

[o, c]

-

RO

A

M

도어센서 제어 키 목록

otime

Uint16

-

100ms

0-65535

-

RW

A

O

문 열림 후 제어 상태 유지시간

- 65535: 계속 유지

ctime

Uint16

-

100ms

0-65535

-

RW

A

O

문 닫힘 후 제어 상태 유지시간

- 65535: 계속 유지

 
3.3.3 Value형 센서

본 절에서는 Value형 센서들에 대하여 개별적인 속성을 정의한다.

3.3.3.1 Value형 센서 속성

Value형 센서는 센서 공통 속성과 채널, 최대(high), 기본(base), 최소(low) 상태 속성, 특수 속성을 추가적으로 가질 수 있다.
 

속성

타입

길이

단위

범위

디폴트

액세스

대상

필수

설명

active

String

6~7

-

enable, disable

enable

RW

A

M

센서기기의 현재 상태 정보

Opmode

String

3~10

-

act, notify,
act_notify

notify

RW

A

M

센서 이벤트 발생시 actuator 실행 모드

Mperiod

Uint16

1~5

100ms

1-65535

10

RW

A

M

센서 측정 주기

rperiod

Uint16

1~5

1s

0-65535

10

RW

A

M

센서 상태정보 보고 주기

- 0: 보고 중지

channel

Unit8

1~3

-

1~255

1

RO

A

O

센서출력 채널 수

vtype1)

String

5~6

-

uint8, uint8a, uint16, uint16a, float, floata

uint16

RO

A

M

센서출력의 데이터 형식

value

{vtype value}2)

 

3)

2)

4)

RO

A

M

센서출력

control_list

Object Array

-

-

-

-

RW

A

O

이벤트 발생 시 제어 정보

key5)

String

-

-

h, b, l

-

RW

A

M

이벤트 키

scid

Uint16

1~5

-

1~65535

0

RW

A

O

장면 논리주소

tlist

Object Array

-

-

-

-

-

A

O

제어 대상 및 상태정보 객체

light

Object

-

-

-

-

-

A

M

조명 상태정보 객체

{light}

-

-

-

-

-

-

A

M

조명 상태정보 속성

did

Uint16

1~5

-

1-65535

-

RW

A

CM

디바이스 논리주소

mid

Uint8

1~5

-

1-255

-

RW

A

CM

모듈 논리주소

gid

Uint16

1~5

-

1-65535

-

RW

A

CM

그룹 논리주소

high6)

-

-

-

-

-

RW

A

O

최대 상태 값

base7)

-

-

-

-

-

RW

A

O

기본 상태 값

low8)

-

-

-

-

-

RW

A

O

최소 상태 값

{특수 속성}9)

-

-

-

-

-

-

A

O

센서 타입에 따른 고유 속성

 
1) 센서출력의 데이터 형식
- uint8a : unit8 array
- uint16a : unit16 array
- floata : float array
2) 센서 출력 데이터의 타입
- 센서출력의 데이터 형식(vtype)의 값과 값의 범위에 따라 정의된다.
3) 센서 출력 데이터의 단위
- 센서의 종류에 따라 정의하여 사용한다.
4) 센서 출력 데이터의 디폴트
- 센서의 종류에 따라 정의하여 사용한다.
5) 이벤트 키
- Value형 센서의 이벤트 발생 키는 h(high), b(base), l(low)를 사용한다.
6) 최대 상태 값 (high)
- ‘h’ 이벤트 발생 조건이다. 
- 센서출력이 해당 값 이상인 경우 ‘h’ 이벤트를 발생한다.
- 데이터 형식은 센서출력의 데이터 형식(vtype)에서 지정된 형식을 따른다. 
7) 기본 상태 값 (base) 
- ‘b’ 이벤트 발생 조건이다. 
- ‘h’ 이벤트가 발생한 상태에서 센서출력이 base 값 이하로 하락하는 경우 ‘b’ 이벤트를 발생한다.
- ‘l’ 이벤트가 발생한 상태에서 센서출력이 base 값 이상으로 상승하는 경우 ‘b’ 이벤트를 발생한다.
- 데이터 형식은 센서출력의 데이터 형식(vtype)에서 지정된 형식을 따른다.
8) 최소 상태 값 (low) 
- ‘l’ 이벤트 발생 조건이다. 
- 센서출력이 해당 값 이상인 경우 ‘l’ 이벤트를 발생한다.
- 데이터 형식은 센서출력의 데이터 형식(vtype)에서 지정된 형식을 따른다.
9) 특수 속성
- 센서에 따라 추가적으로 필요한 속성을 정의하여 사용할 수 있다.
 
3.3.3.2 조도센서 (illuminance) 특수 속성
 

속성

타입

길이

단위

범위

 

디폴트

액세스

대상

필수

설명

adjust_rate

Float(7,2)

3~8

%

0.00~65535.99

 

100.00

RW

A

O

조도센서 위치에 따른 조도기준값에 대한 비례값

aperiod

Uint16

1~5

100ms

1~65535

 

600

RW

A

O

조도센서 측정 후 평균 조도 판단 시간

- mperiod의 배수로 설정해야 함

 
3.3.3.3 온도센서 (temperature) 속성
 

속성

타입

길이

단위

범위

디폴트

액세스

대상

필수

설명

-

-

-

-

-

-

-

A

-

-

 
3.3.3.4 습도센서 (humidity) 속성
 

속성

타입

길이

단위

범위

디폴트

액세스

대상

필수

설명

-

-

-

-

-

-

-

A

-

-

 
 
3.4 고장 속성

3.4.1 디바이스 고장 속성 

 

속성

타입

길이

단위

범위

디폴트

액세스

대상

필수

설명

dfault

Uint8

1~3

-

1~4

0

RO

A

M

디바이스 상태 정보(9.3.1)

fslist

Object Array

-

-

-

-

RO

A

M

Fault 발생 모듈 리스트

mid

Uint8

1~3

-

1~255

0

RO

A

M

모듈 논리주소

fcode

Hex

8

-

00000000~

FFFFFFFF

00000000

RO

A

M

모듈 장애 코드(9.3.2)

 
4. 그룹
4.1 그룹 속성

속성

타입

길이

단위

범위

디폴트

액세스

대상

필수

설명

gid

Uint16

1~5

-

1-65535

-

RW

A

M

그룹 논리주소

gname

String

variable

-

-

-

RW

A

O

그룹 이름

gmlist

Object

-

-

-

-

RW

A

M

그룹 멤버 목록

gmtype1)

String

1

-

device, module

 

 

A

M

그룹 멤버 종류

did

Uint16

1~5

-

1-65535

-

RW

A

M

디바이스 논리주소

mid_list

Uint8 Array

1~5

-

1-255

-

RW

A

CM

디바이스 모듈 논리주소 목록

- 조건:     그룹 멤버 종류(gmtype)이 모듈(m)인 경우

lid

Hex

28

-

-

0

RW

A

M

디바이스 위치주소

 
 
1) 그룹 멤버의 종류를 나타낸다
- device: 디바이스 멤버로 did와 lid 정보를 필수로 포함하여야 한다.
- module: 디바이스의 모듈 멤버로 did, mid, lid 정보를 모두 포함하여야 한다.
4.2 그룹 목록 속성

속성

타입

길이

단위

범위

디폴트

액세스

대상

필수

설명

groups

Object

-

-

-

-

-

A

-

그룹 객체

gid

Uint16

1~5

-

1-65535

-

RW

A

M

그룹 논리주소

gname

String

variable

-

-

-

RW

A

O

그룹 이름

gmlist

Object Array

-

-

-

-

RW

A

M

그룹 멤버 목록

gmtype1)

String

-

-

device, module

 

 

A

M

그룹 멤버 종류

did

Uint16

1~5

-

1-65535

-

RW

A

M

디바이스 논리주소

mid_list

Uint8 Array

1~5

-

1-255

-

RW

A

CM

디바이스 모듈 논리주소 목록

- 조건:     그룹 멤버 종류(gmtype)이 모듈(m)인 경우

lid

Hex

28

-

-

0

RW

A

M

디바이스 위치주소

 

1) 그룹 멤버의 종류를 나타낸다.
- device: 디바이스 멤버로 did와 lid 정보를 필수로 포함하여야 한다.
- module: 디바이스의 모듈 멤버로 did, mid, lid 정보를 모두 포함하여야 한다.

 

5. 장면
5.1 장면 속성

속성

타입

길이

단위

범위

디폴트

액세스

대상

필수

설명

scid

Uint16

1~5

 

1-65535

-

RW

A

M

장면 논리주소

sname

String

variable

 

-

-

RW

A

O

장면 이름

sopt1)

Uint16

1~5

s

1~65535

65535

RW

A

O

장면 유지시간

- 65535: 무한 유지

sslist

Object Array

-

 

-

-

RW

A

M

장면 멤버 목록

slid

Uint16

1~3

-

1~65535

1

RW

A

M

장면 설정정보 논리주소

light

Object

-

-

-

-

-

A

M

조명 상태정보 객체

{light}

-

-

-

-

-

-

A

M

조명 상태정보 속성

tglist

Object Array

-

-

-

-

RW

A

M

장면 수행 대상 멤버 목록

tgtype2)

String

-

-

device, module, group

-

-

A

M

멤버 종류

did

Uint16

1~5

 

1-65535

-

RW

A

CM

디바이스 논리주소

mid_list

Uint8 Array

1~5

-

1-255

-

RW

A

CM

디바이스 모듈 논리주소 목록

- 조건:     씬 멤버 종류(tgtype)이 모듈(m)인 경우

gid

Uint16

1~5

 

1-65535

-

RW

A

CM

그룹 논리주소

- 조건:     씬 멤버 종류(tgtype)이 그룹(g)인 경우

 
1) 장면 유지시간이 종료되면 기존 상태로 복귀하여야 한다.
2) 장면 멤버의 종류를 나타낸다
- device: 디바이스 멤버로 did 정보만 필수로 포함하여야 한다.
- module: 디바이스의 모듈 멤버로 did, mid 정보를 모두 포함하여야 한다.
- group: 그룹 멤버로 gid 정보만 포함하여야 한다.
 
 
5.2 장면 목록 속성

속성

타입

길이

단위

범위

디폴트

액세스

대상

필수

설명

scenes

Object

-

-

-

-

-

A

-

장면 객체

scid

Uint16

1~5

 

1-65535

-

RW

A

M

장면 논리주소

sname

String

variable

 

-

-

RW

A

O

장면 이름

sopt1)

Uint16

1~5

s

1~65535

65535

RW

A

O

장면 유지시간

- 65535: 무한 유지

sslist

Object Array

-

 

-

-

RW

A

M

장면 멤버 목록

slid

Uint16

1~3

-

1~65535

1

RW

A

M

장면 설정정보 논리주소

light

Object

-

-

-

-

-

A

M

조명 상태정보 객체

{light}

-

-

-

-

-

-

A

M

조명 상태정보 속성

tglist

Object Array

-

-

-

-

RW

A

M

장면 수행 대상 멤버 목록

tgtype2)

String

-

-

device, module, group

-

-

A

M

멤버 종류

did

Uint16

1~5

 

1-65535

-

RW

A

CM

디바이스 논리주소

mid_list

Uint8 Array

1~5

-

1-255

-

RW

A

CM

디바이스 모듈 논리주소 목록

- 조건:     씬 멤버 종류(tgtype)이 모듈(m)인 경우

gid

Uint16

1~5

 

1-65535

-

RW

A

CM

그룹 논리주소

- 조건:     씬 멤버 종류(tgtype)이 그룹(g)인 경우

 
1) 장면 유지시간이 종료되면 기존 상태로 복귀하여야 한다.
2) 장면 멤버의 종류를 나타낸다
- device: 디바이스 멤버로 did 정보만 필수로 포함하여야 한다.
- module: 디바이스의 모듈 멤버로 did, mid 정보를 모두 포함하여야 한다.
- group: 그룹 멤버로 gid 정보만 포함하여야 한다
 
 
6. 사용자 입력장치
6.1 사용자 입력장치 기본정보 속성

사용자 입력장치는 조명 또는 센서 디바이스를 제어 및 설정할 수 있는 장치이다. 사용자 입력장치는 사용자 입력장치 논리주소(cid), 기본정보(cinfo)를 가지고 있어야 한다. 

 

속성

타입

길이

단위

범위

디폴트

액세스

필수

설명

cid

Uint16

1~5

-

1~65535

0

RW

M

사용자 입력장치 논리주소

cinfo

Object

- 

-

-

-

-

M

사용자 입력장치 기본정보 객체

 
6.1 사용자 입력장치 기본정보 속성

사용자 입력장치의 기본정보는 다음과 같다.
 

속성

타입

길이

단위

범위

디폴트

액세스

필수

설명

cinfo

Object

-

-

-

-

-

M

사용자 입력장치 기본속성 객체

cid

Uint16

 

-

0~65535

0

RW

M

사용자 입력장치 논리주소

- 0: 할당받지 못함

cpid

Hex

18

-

-

-

RO

M

사용자 입력장치 물리주소

pc

Hex

62

-

-

-

RO

M

사용자 입력장치 제품 코드

sn

String

10

-

-

-

RO

M

사용자 입력장치 시리얼번호

lid

Hex

28

-

-

-

RW

M

사용자 입력장치 위치주소

bpv

String

 

-

-

-

RO

CM

Backbone SLP 버전

lpv

String

 

-

-

-

RO

CM

Local SLP 버전

name

String

 

-

-

-

RW

O

사용자 입력장치 이름

 
 
7. 설치시험기
7.1 설치시험기 기본정보 속성

설치시험기(TS)는 조명 또는 센서 디바이스를 제어 및 설정할 수 있는 장치이다. 설치시험기는 설치시험기 논리주소(tid), 기본정보(cinfo)를 가지고 있어야 한다. 

 

속성

타입

길이

단위

범위

디폴트

액세스

필수

설명

tid

Uint16

1~5

 

1~65535

0

RW

M

설치시험기 논리주소

tinfo

Object

 

 

-

-

-

M

설치시험기 기본정보 객체

 
7.1 설치시험기 기본정보 속성
 

설치시험기의 기본정보는 다음과 같다.

 

 

속성

타입

길이

단위

범위

디폴트

액세스

필수

설명

tinfo

Object

-

-

-

-

-

M

설치시험기 기본속성 객체

tid

Uint16

 

-

1~65535

0

RW

M

설치시험기 논리주소

- 0: 할당받지 못함

tpid

Hex

18

-

-

-

RO

M

설치시험기 물리주소

pc

Hex

62

-

-

-

RO

M

설치시험기 제품 코드

sn

String

10

-

-

-

RO

M

설치시험기 시리얼번호

lid

Hex

28

-

-

-

RW

M

설치시험기 위치주소

bpv

String

-

-

-

-

RO

CM

Backbone SLP 버전

lpv

String

-

-

-

-

RO

CM

Local SLP 버전

name

String

 

-

-

-

RW

O

설치시험기 이름

 
8. 게이트웨이
8.1 게이트웨이 기본 정보

 게이트웨이는 조명 또는 센서 디바이스를 제어 및 설정할 수 있고 사용자 입력장치를 관리하고 관제장치에 조명 시스템 정보를 제공할 수 있는 장치이다.

 게이트웨이는 게이트웨이 논리주소(gwid), 기본정보(gwinfo), 버전(version), 수용능력(cap), 동기화(sync), 부속장치(units) 속성을 가지고 있어야 한다. 

속성

길이

타입

범위

디폴트

액세스

필수

설명

gwid

1~5

Uint16

1~65535

0

RW

M

게이트웨이 논리주소

gwinfo

-

Object

-

-

-

M

게이트웨이 기본정보 객체

version

-

Object

-

-

-

M

게이트웨이 버전 객체

cap

-

Object

-

-

-

M

게이트웨이 수용능력 객체

sync

-

Object

-

-

-

M

게이트웨이 동기화 버전 객체

units

-

Object Array

-

-

-

CM

게이트웨이 부속장치 객체

- 조건: 부속장치가 있는 경우

 
8.1 게이트웨이 기본 정보
 
 게이트웨이의 기본 속성 정보를 포함한다.
 게이트웨이의 B-SLP 접속 포트번호는 B-SLP GW Discovery API를 통하여 수집할 수 있어야 한다. GW Discovery API를 제공하지 않는 게이트웨이는 디폴트 접속 번호(443)을 사용하여야 한다.
 게이트웨이의 디폴트 L-SLP 접속 포트번호를 사용하지 않는 게이트웨이는 L-SLP를 이용한 게이트웨이의 L-SLP 접속 포트번호 수집을 위하여 L-SLP GW Discovery API는 L-SLP 디폴트 접속 번호(5684)를 사용하여야 한다.
 mqtt_df_enable 속성은 게이트웨이에 소속된 디바이스의 오류 정보의 발행 여부를 결정한다. 게이트웨이가 디바이스 오류 정보를 발행할 때 개별 디바이스의 오류 정보 포함 여부는 개별 디바이스의 기본정보에 있는 mqtt_df_enable 속성을 설정하여야 한다. 
 
 

속성

타입

길이

단위

범위

디폴트

액세스1)

필수2)

설명

gwinfo

Object

-

-

-

-

-

M

게이트웨이 기본속성 객체

gwid

Uint16

1~5

-

0~65535

0

RW

M

게이트웨이 논리주소

- 0: 할당받지 못함

gwpid

Hex

18

-

-

-

RO

M

게이트웨이 물리주소

pc

Hex

62

-

-

-

RO

M

게이트웨이 제품 코드

sn

String

10

-

-

-

RO

M

게이트웨이 시리얼번호

lid

Hex

28

-

-

-

RW

M

게이트웨이 위치주소

ip

String

7~15

-

-

-

RW

M

게이트웨이 B-SLP 접속 IP 주소

tport

Uint16

3~5

-

100~

65535

443

RW

M

게이트웨이 B-SLP 접속 포트번호

- HTTPS 사용

- 인증서 관련 사항은 규격에 포함하지 않음

uport

Uint16

4~5

-

1000~

65535

5683

RW

M

게이트웨이 L-SLP 접속 포트번호

- DTLS Securied CoAP port

ms_addr

String

7~15

-

-

-

RW

M

관제서버 IP 주소 또는 도메인

ms_port

UInt16

3~5

-

-

443

RW

M

관제서버 포트 번호

bk_addr

String

7~15

-

-

-

RW

M

브로커 IP 주소 또는 도메인

- TCP TLS 사용

bk_port

UInt16

3~5

-

-

8883

RW

M

브로커 포트 번호

- TLS port

mqtt_report

Uint32

-

s

0-86,400

300

RW

M

게이트웨이 MQTT Report 주기

- 0: Report 배포하지 않음

mqtt_df_enable

String

-

-

enable,

disable

enable

RW

M

게이트웨이 MQTT Fault Alarm 활성화 여부

- 하위 디바이스 전체

mqtt_ua_enable

String

-

-

enable,

disable

enable

RW

CM

MQTT Units Alarm 활성화 여부

mqtt_ua_list

Uint8 Arrary

-

-

-

-

RW

CM

MQTT Units Alarm 활성화 목록

- 미지정시 기본적으로 전체 부속장치 Alarm 활성화

 

1) 액세스
- RO: Read only
- WO: Write Only
- RW: Read and Write

8.2 게이트웨이 버전 정보

 게이트웨이의 하드웨어, 운영처계, 펌웨어, B-SLP 및 L-SLP의 버전 정보를 포함한다.

 

속성

타입

길이

단위

범위

디폴트

액세스

필수

설명

 

version

Object

-

-

-

-

-

M

게이트웨이 버전 정보 객체

hwv

String

 

-

-

-

RO

O

Hardware 버전

osv

String

 

-

-

-

RO

O

OS 버전

fwv

String

 

-

-

-

RO

O

Firmware 버전

bpv

String

 

-

-

-

RO

CM

B-SLP 프로파일 버전

lpv

String

 

-

-

-

RO

CM

L-SLP 프로파일 버전

 
8.3 게이트웨이 수용능력 정보

 게이트웨이의 디바이스, 그룹 및 장면 정보를 수용할 수 있는 능력 정보를 포함한다.

 

속성

타입

길이

단위

범위

디폴트

액세스

필수

설명

cap

Object

-

-

-

-

-

M

게이트웨이 능력 정보 객체

dcap

Object

-

-

-

-

-

M

디바이스 수용능력 정보 객체

maxd

Uint16

 

0~65535

65535

RO

M

연결 가능한 디바이스 개수

connd

Uint16

 

0~65535

0

RO

M

연결중인 디바이스 개수

gcap

Object

-

-

-

-

-

M

그룹 수용능력 정보 객체

maxg

Uint16

 

0~65535

65535

RO

M

지원 가능한 그룹 개수

usedg

Uint16

 

0~65535

0

RO

M

사용중인 그룹 개수

scap

Object

-

-

-

-

-

M

장면 수용능력 정보 객체

maxs

Uint16

 

0~65535

65535

RO

M

지원 가능한 장면 개수

useds

Uint16

 

0~65535

0

RO

M

사용중인 장면 개수

 
8.4 게이트웨이 동기화 버전 정보

8.4 게이트웨이 동기화 버전 정보

 게이트웨이의 자원인 게이트웨이 부속장치(units), 디바이스(device), 그룹(group), 장면(scene)에 대한 동기화 버전 정보를 포함한다. 

 스마트 게이트웨이의 동기화 버전 정보는 KS X ISO 8601의 세계협정시(UTC) 형식을 사용한다. 동기화 버전의 UTC 형식에는 역날짜(달력날짜) 완전 표기 확장형식(YYYY-MM-DD)과 시각 완전 표기 확장형식(hh:mm:ss)을 포함하며 시각 표기의 시작점을 나타내기 위해 문자 [T]를 시간 지시 기호로 사용하고, UTC의 지시 기호인 [Z]를 마지막에 붙여 표기한다. 동기화 버전의 전체 길이는 문자열로 20자이다.

- 2022-10-27T17:13:40Z

 

속성

타입

길이

단위

범위

디폴트

액세스

필수

설명

sync

Object

-

-

-

-

-

 

게이트웨이 동기화 버전 정보 객체

units_sync

String

20

-

-

-

RO

CM

게이트웨이 부속장치 동기화 버전 정보

- 조건: 부속장치가 있는 경우

devices_sync

String

20

-

-

-

RO

M

디바이스 동기화 버전 정보

groups_sync

String

20

-

-

-

RO

M

그룹 동기화 버전 정보

scenes_sync

String

20

-

-

-

RO

M

장면 동기화 버전 정보

 
8.5 게이트웨이 부속장치 속성

8.5.1 게이트웨이 부속장치 정보 속성


 게이트웨이 부속장치 속성은 게이트웨이의 부속장치의 종류, 상태 등에 대한 정보를 포함한다.  

 

속성

타입

길이

단위

범위

디폴트

액세스

필수

설명

unid

Uint16

-

-

1~65535

-

RO

M

부속장치 논리주소

utype1)

Uint8

1

-

0~2

-

RO

M

부속장치 종류

active2)

String

6~7

-

enable, disable

enable

RW

M

부속장치 동작 상태

event_value3)

Uint8

1

-

0, 1

-

RO

M

부속장치 상태 정보

mqtt_ue_enable

String

-

-

enable,

disable

enable

RW

M

MQTT Units Event 활성화 여부

relay_onoff

String

2~3

-

on, off

-

RW

CM

릴레이 상태 정보

- utype이 2(릴레이)인 경우 해당

did_list

Uint16 Array

-

-

1~65535

-

RO

CM

릴레이에 연결된 디바이스 논리주소 목록

- utype이 2(릴레이)인 경우 해당

gid_list

Uint16 Array

-

-

1~65535

-

RO

CM

릴레이에 연결된 그룹 논리주소 목록

- utype이 2(릴레이)인 경우 해당

 
 

1) 부속장치 종류

 

부속장치 종류

0

분전함 문

1

분전함 전원

2

릴레이

3~

Reserved

 

2) 부속장치 동작 상태

 

부속장치 동작 상태

disable

정지

enable

동작

 

3) 부속장치 상태 정보

 

부속장치

상태

0

1

분전함 문

닫힘

열림

분전함 전원

정상

비정상

릴레이 전원

공급

차단

 

8.5.2 게이트웨이 부속장치 정보 목록 속성

 

속성

타입

길이

단위

범위

디폴트

액세스

필수

설명

units

Object Array

-

-

-

-

-

-

부속장치 목록 정보 배열 객체

unid

Uint16

-

-

1~65535

-

RO

M

부속장치 논리주소

utype

Uint8

1

-

0~2

-

RO

M

부속장치 종류

active

String

6~7

-

enable, disable

enable

RW

M

부속장치 동작 상태

event_value

Uint8

1

-

0, 1

-

RO

M

부속장치 상태 정보

relay_onoff

String

2~3

-

on, off

-

RW

CM

릴레이 상태 정보

mqtt_ue_enable

String

-

-

enable,

disable

enable

RW

CM

MQTT Units Event 활성화 여부4)

did_list

Uint16 Array

-

-

1~65535

-

RO

CM

디바이스 논리주소 목록

- type이 2(릴레이)인 경우 해당

gid_list

Uint16 Array

-

-

1~65535

-

RO

CM

릴레이에 연결된 그룹 논리주소 목록

- utype이 2(릴레이)인 경우 해당

 

8.6 디바이스 정보

8.6 디바이스 정보

 게이트웨이는 게이트웨이에 연결된 모든 디바이스에 대하여 개별 디바이스의 정보를 목록으로 제공한다. 개별 디바이스의 정보는 조명/센서 디바이스 속성과 동일하다. 

 

속성

타입

길이

단위

범위

디폴트

액세스

대상1)

필수

설명

devices

Object Array

-

-

-

-

-

G

M

디바이스 정보 목록

did

Uint16

1~5

 

1~65535

0

RW

A

M

디바이스 논리주소

dinfo

Object

-

 

-

-

-

A

M

디바이스 기본정보 객체

cap

Object

-

 

-

-

-

A

M

디바이스 수용능력 객체

modules 

Object Array

-

 

-

-

-

A

M

디바이스의 모듈 목록 객체

gid_list

Uint16 Array

-

-

1~65535

-

-

A

M

디바이스가 등록된 그룹 논리주소 목록

scid_list

Uint16 Array

-

-

1~65535

-

-

A

M

디바이스가 등록된 장면 논리주소 목록

did_list

Uint16 Array

-

-

-

-

-

G

M

게이트웨이에 등록된 디바이스 논리주소 목록

 
 
8.7 고장 정보

8.7.1 디바이스 고장 목록 
 게이트웨이에 소속된 디바이스들의 고장 정보 목록이다.

 

속성

타입

길이

단위

범위

디폴트

액세스

대상

필수

설명

device_fault_list

Object Array

-

-

-

-

RO

G

M

게이트웨이에 연결된 모든 디바이스의 고장 정보 목록

did

Uint16

1~5

-

0~65535

0

RW

A

M

디바이스 논리주소

dfault

Uint8

1~3

-

1~4

0

RO

A

M

디바이스 상태 정보(9.3.1)

fslist

Object Array

-

-

-

-

RO

A

M

Fault 발생 모듈 리스트

mid

Uint8

1~3

-

1~255

0

RO

A

M

모듈 논리주소

fcode

Hexr

8

-

00000000~

FFFFFFFF

00000000

RO

A

M

모듈 장애 코드(9.3.2)

 

 

9. 속성값 정의
9.1 모듈 속성

9.1.1 모듈 분류

 모듈의 분류(classification)를 다음과 같이 정의한다.

- l: 조명 모듈
- c: 통신 모듈
- s: 센서 모듈


9.1.2 모듈 유형
 모듈의 분류에 따른 모듈의 세부 유형(type)을 다음과 같이 정의한다.
 mtype은 1번부터 할당하고 정의되지 않은 유형의 모듈은 0번을 사용한다.

 

mtype

조명 모듈(l)

통신 모듈(c)

센서 모듈(s)

0

미정의

미정의

미정의

1

일반조명

Ethernet

온도

2

살균조명

DALI

습도

3

-

DMX512

조도

4

-

RS485

전류

5

-

ACN

인지

6

-

E/F2

칼라

7

-

Cbus

상관

색온도

8

-

WiFi

영상

9

-

Zigbee

연기

10

-

BLE

가스

11

-

Z-Wave

열감지

12

-

ANT

먼지

13

-

RS-232

도어

14

-

RF

-

15

-

PLC

-

16

-

Thread

-

 

 

9.2 센서 속성

9.2.1 opmode


 센서의 이벤트 발생시 동작 모드는 다음과 같이 정의한다.


- act: 이벤트가 발생하면 해당 상태(status)에 따른 제어(control)를 동작
- notify: 이벤트가 발생하면 해당 상태(status)를 보고
- act_notify: 이벤트가 발생하면 해당 상태(status)를 보고하고 상태에 따른 제어(control)를 동작

 

9.3 고장 속성

9.3.1 디바이스 상태 정보


 디바이스 상태 정보는 디바이스의 보고, 게이트웨이의 판단, 설치시험기를 사용한 현장 확인 후 장애 등록 등의 방법으로 설정한다.

 디바이스 상태 정보는 다음과 같이 정의한다.

 

dfault

고장

비고

0

정상

디바이스 정상 상태

1

통신불능

디바이스가 요청에 응답이 없는 상태

2

기기장애

LED불량, SMPS장애, 과열 등 장애 상태

3

통신불능 & 기기장애

기기장애 확인 후 디바이스가 요청에 응답이 없는 상태

4

전원 꺼짐

전원 꺼짐 상태

5~31

Reserved

 

 

 

10. 부록
10.1 조명 설정정보 시간

10. 부록


 정의된 속성들에 대한 상세한 정보들을 제공한다. 

 

10.1 조명 설정정보: 시간


 조명 설정정보에는 각종 조명 제어에 따른 처리 설정들이 포함되어 있다. 본 절에서는 각종 조명 제어 요청에 따른 처리 설중중에서 변환시간, 유지시간 및 지연시간에 대하여 설명한다.
 변환시간(transition time)은 상태가 변경되는데 소요되는 시간이며, 유지시간(hold time)은 요청 상태를 유지하는 시간, 지연시간(delay time)은 요청 상태로의 변경을 늦추는 시간이다.

 

 

 

10.1.2 밝기 변환시간


 밝기 변환시간은 밝기(level) 명령을 받은 경우에 요청받은 밝기가 기존 밝기보다 큰 경우에는 밝기 증가 시 목표 밝기에 도달하는데 소요되는 시간 또는 소등(off) 기존 밝기보다 작은 경우에는 밝기 감소 시 목표 밝기에 도달하는데 소요되는 시간이다.

 

 

10.1.3 유지시간


 점소등 유지시간은 점등(on) 명령을 받고 점등 시 조명 밝기(onlevel)로 변경된 후 해당 밝기를 유지하는 시간 또는 소등(off) 명령을 받고 소등 시 조명 밝기(offlevel)로 변경된 후 해당 밝기를 유지하는 시간이다.

 

10.1.4 지연시간


 점소등 지연시간은 점등(on) 명령을 받고 점등 시 조명 밝기(onlevel)로 변경되기 전까지 기존 밝기를 해당 시간만큼 유지하여 밝기 변경을 지연하는 시간 또는 소등(off) 명령을 받고 소등 시 조명 밝기(offlevel)로 변경되기 전까지 기존 밝기를 해당 시간만큼 유지하여 밝기 변경을 지연하는 시간이다.

 

 

 

 

 

 

10.2 마지막 조명 상태 기억

조명 설정 정보(lightconfig) 속성에는 점등시 마지막 조명 상태정보로 복구하는 설정인 last_light 속성이 있다. 본 절에서는 last_light 속성의 설정에 따른 동작 방식을 설명한다.

 

10.2.1 점소등 명령에 따른 동작
 

last_light가 enable로 설정된 조명이 소등(off) 명령을 받으면 마지막 조명 상태 정보(level, colortemp, hue/saturation/brightness, r/g/b)를 저장해 두었다가 점등(on) 명령을 받으면 마지막 조명 상태로 점등하여야 한다. 


 last_light가 disable로 설정된 조명이 소등(off) 명령을 받아 소등된 후 다시 점등(on) 명령을 받으면 조명 점등 상태정보(onconfig)에 저장된 조명 상태로 점등하여야 한다.
 단, 소등 상태에서 조명 상태 정보(level, colortemp, hue/saturation/brightness, r/g/b)를 포함하는 점등 메시지를 받은 경우 메시지에 포함된 조명 상태로 점등하여야 한다.

10.2.2 전원 On/Off에 따른 동작


 조명의 전원이 차단되거나 재시작 또는 공장초기화 명령을 받아 재점등시에는 last_light의 설정값에 상관없이 조명 점등 상태정보(onconfig)에 저장된 조명 상태로 점등하여야 한다.