Device API 데이터 모델 및 메시지 정의

표준화된 JSON 기반 통신 프로토콜

메시지 구조

  • JSON 기반 Key-Value: 가독성 높고 유연한 데이터 교환 형식
  • deviceId: 제어할 하드웨어 장치의 고유 식별자
  • interface: `setOper`, `ntfCurr` 등 추상화된 기능
  • params / result: 입출력 파라미터 및 수행 결과

호출 방식 및 특징

  • Request/Response 및 Event-driven 통신 지원
  • 서비스 품질(QoS), 타임아웃(Timeout) 등 제약 조건 포함 가능

JSON 메시지 예시

► Request: 창문 모터 구동 요청

{
  "deviceId": "WindowMotor_FL",
  "interface": "setOper",
  "params": {
    "dir": 1, // 1: Upward
    "dutyRat": 10000 // 100.00%
  }
}

◄ Response: 요청 결과 응답

{
  "deviceId": "WindowMotor_FL",
  "interface": "setOper",
  "result": {
    "status": 0 // 0: OK
  }
}