ThingPlug_SDK_Android Technical Notes ThingPlug_SDK_Android 환경 구축 및 테스트 가이드 Ver. 1.0 IoT 오픈 하우스 ©2017 IoT 오픈 하우스 All Rights Reserved. ☞ for more information, visit our website at https://lora.sktiot.com

Contents Device & Service App Overview Device App 동작 및 테스트 LoRa 모듈과 Service App 동작 및 테스트

LoRa/Android Device 모니터링 App > Device & Service App Overview IoT Sensor Device App. 스마트폰의 각 종 센서로 LoRa Device 구성 LoRa/Android Device 모니터링 App Service App. 동작 환경 : Android OS 4.3(Jelly Bean, API Level 18) 이상

> ThingPlug SDK Android 소스 https://github.com/SKT-ThingPlug/thingplug-sdk-android

Contents Device & Service App Overview Device App 동작 및 테스트 LoRa 모듈과 Service App 동작 및 테스트

스마트폰에 내장된 각 종 센서에서 측정한 값을 제공된 Device App.을 통해 ThingPlug에 전송합니다. > Device App Overview IoT Sensor Device App. 스마트폰에 내장된 각 종 센서에서 측정한 값을 제공된 Device App.을 통해 ThingPlug에 전송합니다.

Device App.을 통해서 보내지는 스마트폰 센서와 액츄에이터 종류는 다음과 같습니다. > Device App Overview Device App.을 통해서 보내지는 스마트폰 센서와 액츄에이터 종류는 다음과 같습니다. 센서 (Sensor) Battery : temperature(℃), charge level(％) Temperature(℃) Humidity(％) Noise(㏈) GPS : latitude(˚), longitude(˚), altitude(˚) Air pressure(h㎩) Brightness(㏓) Proximity(㎝) Accelerometer : X(㎨), Y(㎨), Z(㎨) Orientation : azimuth(˚), pitch(˚), roll(˚) Gravity : X(㎨), Y(㎨), Z(㎨) Gyroscope : X(˚), Y(˚), Z(˚) Magnetic field : X(µT), Y(µT), Z(µT) Step detector(detection) Step count(steps) 액츄에이터 (Actuator) 1. Buzzer : ringtone, notification, alarm 2. LED : off, red, green, blue, magenta, cyan, yellow, white 3. Camera : back, front IoT Sensor Device App.

Device App. 실행 화면에서 ThingPlug ID와 PW로 로그인 과정을 수행합니다. 앱 화면 내에서 사이트에 접속하여 가입을 진행할 수 있습니다.

Device App. 실행 화면에서 다음을 누르면 ThingPlug 포털 정보 Login : 로그인 API URL Register : 디바이스 등록 API URL ThingPlug server 정보 URL : ThingPlug server URL AppEUI : CSE 생성 접두어 Use TLS : TLS 사용 여부 TLV/TDV : 센서 데이터 포맷 LOAD DEFAULT : 기본 설정값 불러오기 Device App. 실행 화면에서 다음을 누르면 Server 정보 확인 및 수정이 가능하다 < Device App. 최초 실행 화면 > < Server 정보 확인 및 수정 화면 >

> App. 권한 승인 단계 최초 로그인 시 네 단계의 권한 승인절차를 거치게 됩니다. 위치 정보 접근 권한 습득 사진 및 동영상 접근 권한 습득 사진 및 동영상 촬영 권한 습득 음성 녹음 권한 습득 Android OS 6.0(Marshmallow, API Level 23) 이상의 단말에서는 GPS 및 카메라 사용, Noise 센 서 표시에 필요한 권한 허용 팝업이 표시됩니다. Android OS 6.0 미만의 단말에서는 App설치 시 권한을 확인하게 됩니다.

> App. 개인 위치정보 이용 App.에서 권한을 설정하는 단계를 지나면 다음과 같이, 위치정보 이용 동의를 화면을 볼 수 있습니다. 위치정보 이용을 동의 하면, 해당 디바이스의 위치정보를 ThingPlug에 전송 하게 됩니다.

> 디바이스(스마트폰)의 센서 정보 전송 화면

> 디바이스(스마트폰)의 센서 정보 전송 화면 특정 센서 정보를 선택하면 해당 센서의 상세화면으로 이동하여 지속적인 관찰이 가능하다.

> 디바이스(스마트폰)의 센서 정보 전송 화면 센서 감지 간격(Sensor read interval, msec) : 센서에서 값을 읽어오는 간격 센서 정보 전송 간격(Transfer interval, msec) : 센서 정보를 ThingPlug 서버로 전송하는 간격 센서 목록 갱신 간격(List update interval) : 센서 목록 화면을 갱신하는 간격 센서 상태 그래프 갱신 간격(Graph update interval) : 센서 상세 화면의 그래프를 갱신하는 간격     - LOGOUT : ThingPlug 포털에서 로그아웃합니다. 단, 기기해지는 자동으로 되지 않으므로 ThingPlug 포털에서 수동으로 기기해지(삭제)를 해주어야, 향후 해당 단말을 재등록할 수 있습니다.

Contents Device & Service App Overview Device App 동작 및 테스트 LoRa 모듈과 Service App 동작 및 테스트

> Service App Overview Device App.에서 ThingPlug에 전송된 센서 정보를 모니터링하고, 제어 가능한 센서(LED, BUZZER, CAMERA)에 대해서는 필요에 의해서 제어가 가능합니다.

Service App. 실행 화면에서 다음을 누르면 Device App.에서 설정한 정보와 동일. ThingPlug 포털 정보 Login : 로그인 API URL Register : 디바이스 등록 API URL ThingPlug server 정보 URL : ThingPlug server URL AppEUI : CSE 생성 접두어 Use TLS : TLS 사용 여부 TLV/TDV : 센서 데이터 포맷 LOAD DEFAULT : 기본 설정값 불러오기 Service App. 실행 화면에서 다음을 누르면 Server 정보 확인 및 수정이 가능하다 < Service App. 최초 실행 화면 > < Server 정보 확인 및 수정 화면 >

> Service App.에서 디바이스 선택 로그인에 성공하게 되면, 해당 ThingPlug ID에 등록된 디바이스 목록을 볼 수 있다. 만약에 Device App.에서 로그인을 하고, 최초로 데이터를 전송하면, ThingPlug에 디바이스를 등록하지 않아도 Device에 정의된 이름으로 자동 생성된다.

> Service App.에서 디바이스 선택 로그인에 성공하게 되면, 해당 ThingPlug ID에 등록된 디바이스 목록을 볼 수 있다. 만약에 Device App.에서 로그인을 하고, 최초로 데이터를 전송하면, ThingPlug에 디바이스를 등록하지 않아도 Device에 정의된 이름으로 자동 생성된다.

새롭게 추가된 디바이스는 ThingPlug 포탈에서도 정상적으로 등록이 되었음을 확인할 수 있습니다.

> Device & Service App. Demo https://www.youtube.com/watch?v=btRFXE-LG4o

Contents Device & Service App Overview Device App 동작 및 테스트 LoRa 모듈과 Service App 동작 및 테스트

> LoRa 모듈과 Service App 테스트구성도 WIZnet LoRa 키트 (솔루엠 LoRa 모듈) Service App (Android) LoRa G/W N/W Server (1) LoRa 모듈에서 AT Command를 이용하여 가상의 센서 데이터를 보내고, (2) 안드로이드 폰의 Service App에서 이를 확인합니다.

> ThingPlug에서 사용되는 TLV란? 앞서 언급한 대로 ThingPlug에서 데이터 전송은 TLV(Type Length Value) 포맷을 사용하였습니다. 아래는 ThingPlug에서 사용되는 Type 종류의 일부입니다. "Battery", {0x04, 0x05}, "Temperature", {0x11}, "Humidity", {0x12}, "Noise", {0x13}, "GPS", {0x20, 0x21, 0x22}, "Air Pressure", {0x24}, "Light", {0x25}, "Buzzer", {0x27}, "Led", {0x28}, 사용 예) 110101 : Type(11:Temperature), Length(01), Value(01) 120101 : Type(12:Humedity), Length(01), Value(01) 130101 : Type(13:Noise), Length(01), Value(01) 040101050101 : Type(04:Battery-Temperature), Length(01), Value(01) Type(05:Battery-Charge), Length(01), Value(01)

> LoRa 모듈 AT Command 로그와 Service App 화면 AT+SEND 01110101  Temperature(01) value : 01 Send Data Send Data Port:1, Byte :3 Event mode txDone OnRadioTxDone RSSI -49, SNR 37 RX DONE AT+SEND 01120101  Humidity(02) value : 01 RSSI -50, SNR 36 AT+SEND 01130101  Noise(03) value : 01 AT+SEND 01040101050101 Battery(04, 05) value : 01, 01 Send Data Port:1, Byte :6 RSSI -50, SNR 39

감사합니다