배너 이미지 STArt@IoT에서 제공하는 플랫폼을 사용하는데 도움을 드립니다. STArt@IoT
디바이스플랫폼 가이드
Home 가이드 디바이스플랫폼 가이드

디바이스 메인 화면

디바이스 모니터링

  • 전체 디바이스, 디바이스 모델, 디바이스 그룹 수치 현황을 확인할 수 있습니다.
  • 로그인 사용자의 등록 디바이스 상태에 따라 활성, 비활성, 디바이스와 통신이 되지 않는 데이터 미수신이 색상으로 구분하여 표시가 됩니다.
  • 디바이스 목록을 선택하면 디바이스 상세 정보로 이동합니다.

디바이스 현황 소개

디바이스 모델

가. 디바이스 모델 목록

디바이스 모델을 검색하고 현황을 확인할 수 있는 서비스 입니다.
  • 제조사, 모델타입, 모델 아이디 번호, 등록자를 선택하여 검색할 수 있으며, 승인/미승인 여부를 선택하여 조회가 가능 합니다.
  • 조회된 리스트에서 모델 타입을 클릭하면 해당 모델의 상세 화면으로 이동합니다.
  • 기업회원으로 로그인하면 우측 하단 등록 버튼을 클릭하여 디바이스 모델을 등록할 수 있습니다.

나. 디바이스 모델 상세

선택한 디바이스 모델의 상세 정보를 조회할 수 있습니다.
  • 펌웨어 다운로드가 가능하며 펌웨어 이력도 확인할 수 있습니다.

디바이스 관리

가. 목록 조회

디바이스를 검색하고 현황을 확인할 수 있는 서비스 입니다.
  • 디바이스 아이디 또는 디바이스 명을 선택하여 검색할 수 있습니다.
  • 조회된 리스트에서 디바이스를 클릭하면 해당 디바이스의 상세 화면으로 이동합니다.
  • 디바이스 목록의 색상을 통해 디바이스 상태를 쉽게 확인할 수 있습니다.
  • 우측 하단 등록 버튼을 클릭하여 디바이스를 등록할 수 있습니다.

나. 일반 정보

선택한 디바이스의 상세 정보를 조회할 수 있습니다.
  • 지도에서 디바이스의 위치를 확인 할 수 있습니다.
  • 디바이스에 연결된 센서들의 정보와 센서 데이터의 공개여부를 확인할 수 있습니다.
  • 위치등록을 통해 디바이스의 위치정보를 지도상에서 선택하여 등록할 수 있습니다.

다. 센서 데이터

선택한 디바이스의 센서 데이터 정보를 조회할 수 있습니다.
  • 그래프 옵션에서 연결된 센서를 추가하면 하나의 그래프에서 복수의 센서 데이터 정보를 확인할 수 있습니다.
  • JSON 데이터 타입의 센서는 해당 센서내의 JSON 키를 선택하여 정보를 확인 합니다.
  • 센서 데이터 발생내역을 통해 조회 기간에 따른 수집 데이터를 목록으로 확인할 수 있습니다.

라. 등록/수정/삭제 기능

  • 디바이스 아이디, 디바이스명, 제어정보, POA, 카테고리는 필수 입력 항목 입니다.
  • 제조사아이디 조회를 클릭하여 디바이스 모델번호를 검색하고 선택할 수 있습니다.
  • 디바이스 아이디 마지막 고유값은 사용자가 임의의 값을 입력하여 정할 수 있습니다.

오픈 API 관리 안내

Open API와 매시업 API를 테스트하고 테스트한 이력을 관리할 수 있습니다.

오픈 API

오픈 API를 호출하고 테스트할 수 있습니다.
  • 사용자 인증키(U-Key)는 API호출 시 사용되는 인증 토큰 입니다.
  • 좌측의 오픈 API명에서 항목을 선택하면 메인 화면에 해당 API의 상세 항목이 노출 됩니다.
  • 작업 디바이스 아이디에 작업할 아이디를 입력하면 오픈 API시 사용되는 디바이스 아이디가 자동으로 입력됩니다.
  • 원하는 오픈 API명을 선택한 뒤에 해당하는 항목 입력 후 실행 버튼을 클릭합니다.
  • 요청 정보에 따라 API호출 테스트가 진행 완료 후 응답 영역에 실행 결과가 표시 되며 이력에 등록 됩니다.
  • 초기화 버튼을 클릭하면 상세 항목 입력 전 최초 요청 정보로 초기화 됩니다.

오픈 API 이력

테스트한 오픈 API 이력을 조회할 수 있습니다
  • 목록에서 테스트 항목을 선택하면 테스트 이력 상세 화면으로 이동 합니다.
선택한 오픈 API 테스트 이력에 대한 상세 정보를 조회할 수 있습니다.
  • 테스트 결과는 하단 응답 영역에 표시 됩니다.

매시업 API

매시업 API(Mashup API) 에서는 하나 또는 다수의 Open API를 한번의 호출로 응답 받을 수 있는 API를 생성할 수 있습니다.
  • 매시업 API명 또는 매시업 URL을 선택하여 검색할 수 있습니다.
  • 조회된 리스트에서 매시업 API명을 클릭하면 해당 매시업 API의 상세 화면으로 이동합니다.
  • 우측 하단 등록 버튼을 클릭하여 신규 매시업 API를 등록할 수 있습니다
  • 좌측의 API 목록에서 API를 선택하면 영역이 확장(아코디언UI) 되면서 해당 API 정보가 표시 됩니다.
  • API 정보가 확장되어 표시된 영역의 우측 하단에 있는 추가 버튼을 클릭하면 우측 매시업 API 리스트에 해당 API가 추가 됩니다.
  • 별표 표시된 항목에 정보를 입력 후 저장 버튼을 클릭하면 매시업 API로 등록 됩니다.

매시업 API 이력

테스트한 매시업 API 이력을 조회할 수 있습니다.
  • 목록에서 테스트 항목을 선택하면 테스트 이력 상세 화면으로 이동 합니다.
선택한 매시업 API 테스트 이력에 대한 상세 정보를 조회할 수 있습니다.

시스템 관리 안내

플랫폼의 상태 정보나 하드웨어 정보를 확인할 수 있습니다.

플랫폼 정보

  • 디바이스플랫폼의 쓰레드 수와 오픈 API 호출 수 그리고 메모리 사용량을 실시간 차트를 통해 확인할 수 있습니다.
  • 디바이스 플랫폼의 데이터 저장 용량을 확인할 수 있습니다.
  • 통신 프로토콜(HTTP, CoAP, MQTT)와 데이터베이스(MongoDB)의 서비스 구동여부를 확인 할 수 있습니다.
  • 디바이스 플랫폼의 시스템 로그를 확인할 수 있습니다.

하드웨어 정보

  • 3초 단위로 시스템 부하, CPU 사용량, 메모리 사용량, Traffic 정보, Packet 정보, Disk I/O 현황이 갱신 됩니다.

서비스 API 사용 안내

API를 이용하여 디바이스 정보나 센서 정보를 확인할 수 있습니다.

API 샘플 어플리케이션

API 공통 Header

  • Authorization : Bearer 사용자인증키

디바이스 목록 조회

  • 해당 계정에 등록된 디바이스 목록을 조회 합니다.
  • URL : https://apim.startiot.or.kr:8244/api/devices
  • Params : did (디바이스 아이디)
  • Params : dnm (디바이스 명)

디바이스 정보 조회

  • 지정한 디바이스 정보를 조회 합니다.
  • URL : https://apim.startiot.or.kr:8244/api/device/{디바이스 아이디}

센서 목록 조회

  • 지정한 디바이스의 센서 목록을 조회 합니다.
  • URL : https://apim.startiot.or.kr:8244/api/sensors/{디바이스 아이디}

센서 최근 데이터 조회

  • 지정한 센서의 가장 최근 데이터를 조회 합니다.
  • URL : https://apim.startiot.or.kr:8244/api/lastdata/{디바이스 아이디}/{센서명}

센서 데이터 조회

  • 지정한 센서의 조회조건에 따라 데이터 목록을 조회 합니다.
  • URL : https://apim.startiot.or.kr:8244/api/data/{디바이스 아이디}/{센서명}
  • Params : sdt (조회 시작일 YYYY-MM-DD)
  • Params : edt (조회 종료일 YYYY-MM-DD)
  • Params : limit (최대 조회 건수)

API postman 즐겨찾기 다운로드

디바이스 아이디체계

IoT 개발플랫폼은 자체 디바이스아이디 체계를 가지고 있습니다.

다음 구성으로 이루어집니다.
  • 식별번호.모델번호.고유번호
  • 총 50자리이내
식별번호
  • 5자리, 숫자
  • 제조사마다 순차적으로 부여됩니다.
모델번호
  • 4자리, 숫자
  • 제조사별 모델에 따라 순차적으로 부여됩니다.
고유번호
  • 39자리 이내 영문 및 숫자 조합
  • 사용자가 해당 디바이스를 관리하기 위해 직접 부여할 수 있습니다.

Resource Tree

IWF의 기능 지원 범위

  • Legacy SW를 위한 AE를 생성가능합니다.
  • OpenAPI를 통해 디바이스 플랫폼과 정보 교환이 가능합니다.

IWF API 목록

register 디바이스를 플랫폼에 등록
unregister 디바이스를 플랫폼에서 삭제
setState 장치의 상태 정보를 업로드 및 갱신 하는데 사용
putContent 디바이스에서 생성된 데이터 업로드
putControl 디바이스를 제어하기 위한 명령어 등록
putBattery 디바이스에 대한 배터리 정보 등록
putDeviceInfo 디바이스에 대한 정보 등록
putReboot 디바이스에 대한 재부팅 등록
putLocation 디바이스에 대한 위치정보 등록
putMemory 디바이스에 대한 메모리 정보 등록
putFirmware 디바이스에 대한 펌웨어 정보 등록
putSoftware 디바이스에 대한 소프트웨어 정보 등록
close 프록시의 AE 인스턴스를 종료

시나리오

  • IWF 라이브러리를 이용하여 디바이스 등록하기
  • 온습도 값 수집하기(Subscription)
  • 전구 제어하기 (On/Off)

준비사항

부품확인

  • RASPBERRY PI 3, 스타터 키트/입출력 키트, 전구, 전원 릴레이모듈, DHT11 온습도 센서, 점퍼케이블, 노트북, (키보드, 마우스, 모니터) 등

센서 연결

  • 부품 : DHT11 온습도센서, 점퍼케이블
  • 부품 : 전구, 전원릴레이모듈, 점퍼케이블

STArt@IoT (www.startiot.or.kr) 회원가입

환경 구성

샘플소스 다운로드

  • 샘플소스는 아래를 클릭하시면 다운받을 수 있습니다.
샘플 소스 다운받기
imf-mqtt-ex-temphum.zip

상세내용

샘플소스 IDE에 import

디바이스 아이디 설정

  • IWF 을 이용한 디바이스 등록

Runnable JAR File 생성

Winscp를 이용하여 라즈베리 파이에 접속 (ID : pi / PW : raspberry)

생성한 Runnable JAR 파일 및 프로젝트내 conf폴더를 /home/pi폴더에 업로드

설정파일(iwf.properties) 편집

putty를 이용하여 라즈베리 파이 연결 (ID : pi / PW : raspberry)

iwf 실행 – 디바이스 등록

  • java –jar –DhomePath=/home/pi/conf 파일명.jar 명령어 입력

디바이스 등록 확인

디바이스 관리
  • 디바이스 플랫폼 > 디바이스 현황 > 디바이스 관리
오픈 API이용
  • L-IF7. AE 리소스 조회 클릭

구독 신청

Webserver 설정

Webserver 설정

구독 확인

  • Chrome 등 웹브라우저에서 http://127.0.0.1:8080 접속

제어 확인

항 목 다운로드
IWF 활용가이드 iwf_guide.pdf
IWF 라이브러리 (HTTP) iwf-http.zip
IWF 라이브러리 (MQTT) iwf-mqtt.zip
IWF 라이브러리 (CoAP) iwf-coap.zip
IWF 예제소스 (MQTT) iwf-mqtt-example.zip
oneM2MSpecifications - TS-0013 TS-0013-Interoperability_Testing-V0_3_0(cl).pdf
postman 즐겨찾기 IoT-charlot-Platform.postman_collection