Smart[Fleet] Device Simulator

본 시뮬레이터는 SKT의 Smart[Fleet] 플랫폼 프로토콜을 따르는 GPS, OBD 단말의 동작을 나타내는 시뮬레이터입니다.

본 시뮬레이터는 Smart[Fleet] 플랫폼의 기술문서를 기반으로 구성되어 있습니다. 상세한 프로토콜은 상기 기술문서를 참고하세요.

Smart[Fleet] Device Simulator Flow

본 시뮬레이터는 아래의 Flow를 기반으로 작성되어 있으며, 아래의 Flow는 단말 프로시저 규격와 단말 전송 메시지 규격을 참고 바랍니다.

하기 제공되는 각 단말 시뮬레이터의 코드에는 상기 Flow의 순서가 주석으로 표기되어 있으니, 각 순서를 코드와 매핑하여 이해하시면 됩니다.

//////////////////////////////////////////////////
// Flow #1 : Request Connection 
//////////////////////////////////////////////////

var messageSender = mqtt.connect('mqtts://' + config.Host, {
    username:config.userName,
    clientId:clientIdSession,
    clean:true,
    keepalive:60,
    rejectUnauthorized: true
});

Device Simulator 구성

본 시뮬레이터는 node.js 기반으로 구현되어 있으며, 기술 규격에 따라 MQTT프로토콜에 준수하여 개발이 되어 있습니다.

본 시뮬레이터에서 제공하는 단말 타입은 GPS, OBD이며 아래의 파일에 시뮬레이션 과정이 코딩되어 있습니다.

• device.js

Device Simulator 실행 방법

본 시뮬레이터를 동작을 위해서는 기본적으로 node.js가 설치되어 있어야 합니다. node.js의 설치 방법은 node.js 홈페이지를 참고하시길 부탁 드립니다.

git clone https://github.com/skt-smartfleet/device-simulator.git

npm install

node device

Device Simulator 설정 방법

본 시뮬레이터 동작을 위한 설정은 본 Repository의 config.js 파일에 기술되어 있으며, 해당 설정을 수정하므로, 각자에 상황에 맞추어 시뮬레이션을 수행할 수 있습니다.

아래 코드의 내용 중에서 수정이 필요한 사항은 다음과 같습니다.

Key	Description
userName	MQTT Conection에 명시하는 username 항목으로 해당 항목에는 Smart[Fleet]에 정상적으로 등록된 단말임을 증명하는 AccessToken값을 기입해야합니다. 시뮬레이션을 위한 20자리의 Token 값을 발급 받기위해서는 Repository Issue(Link)에 이슈 등록 부탁 드립니다.
updateInterval	단말이 메시지를 업로드 하는 주기를 명시합니다. (msec)
microtripcnt	단말이 주기 정보를 보내는 총 갯수를 명시합니다.
deviceType	시뮬레이션을 돌리고자 하는 디바이스 타입을 명시합니다. GPS 또는 OBD

module.exports = {

    Host : 'smartfleet.sktelecom.com',
    Port : '9900',
    HttpPort : '9000',

    // 20-digits Device Access Token given by manufacturer
    userName : '{Please input your access token}',
    updateInterval : 2000,
    microTripCnt : 10,
    deviceType : 'GPS',
}

Device Simulator 정상 동작 예시

정상적으로 설정된 Device Simulator의 동작 예시입니다.

[GPS Device]

Connecting to Smart[Fleet] Platform
[Flow #1] Connected Smart[Fleet] Platform
ClientID : trfedc0fa06
Device Type : GPS
[Flow #2] Successfully Subscribe the RPC topic to Smart[Fleet] Platform

[Flow #3] Successfully sending a MicroTrip message to Smart[Fleet] Platform
Message : {"ty":2,"ts":1507970678509,"ap":0,"pld":{"tid":1,"lon":127.062512,"lat":37.510296,"alt":106,"sp":75,"dop":14,"nos":6,"clt":1507970678509}}

[Flow #3] Successfully sending a MicroTrip message to Smart[Fleet] Platform
Message : {"ty":2,"ts":1507970680512,"ap":0,"pld":{"tid":1,"lon":127.061969,"lat":37.511334,"alt":118,"sp":59,"dop":20,"nos":6,"clt":1507970680512}}

[Flow #3] Successfully sending a MicroTrip message to Smart[Fleet] Platform
Message : {"ty":2,"ts":1507970682517,"ap":0,"pld":{"tid":1,"lon":127.061426,"lat":37.512353,"alt":108,"sp":81,"dop":11,"nos":6,"clt":1507970682517}}

[Flow #3] Successfully sending a MicroTrip message to Smart[Fleet] Platform
Message : {"ty":2,"ts":1507970684523,"ap":0,"pld":{"tid":1,"lon":127.060685,"lat":37.513743,"alt":102,"sp":83,"dop":14,"nos":3,"clt":1507970684523}}

[Flow #5] Receive the RPC Message
Topic :v1/sensors/me/rpc/request/edcff010-b0bb-11e7-8c12-ed6c4a5c999b
{"method":"d","params":{"pin":"23","value":1}}

[Flow #6] Successfully sending a RPC Response message to Smart[Fleet] Platform
Message : {"results":2000}

[Flow #3] Successfully sending a MicroTrip message to Smart[Fleet] Platform
Message : {"ty":2,"ts":1507970686527,"ap":0,"pld":{"tid":1,"lon":127.060067,"lat":37.51477,"alt":119,"sp":72,"dop":14,"nos":6,"clt":1507970686527}}

[Flow #8] Successfully sending a RPC Result to Smart[Fleet] Platform
Message : {"results":2000,"additionalInfo":{"rusage":{"recv":100,"stime":200}}}

[Flow #3] Successfully sending a MicroTrip message to Smart[Fleet] Platform
Message : {"ty":2,"ts":1507970688530,"ap":0,"pld":{"tid":1,"lon":127.0592,"lat":37.516314,"alt":114,"sp":64,"dop":12,"nos":5,"clt":1507970688530}}

[Flow #3] Successfully sending a MicroTrip message to Smart[Fleet] Platform
Message : {"ty":2,"ts":1507970690536,"ap":0,"pld":{"tid":1,"lon":127.058356,"lat":37.517931,"alt":116,"sp":88,"dop":12,"nos":4,"clt":1507970690536}}

[Flow #3] Successfully sending a MicroTrip message to Smart[Fleet] Platform
Message : {"ty":2,"ts":1507970692539,"ap":0,"pld":{"tid":1,"lon":127.057246,"lat":37.519846,"alt":104,"sp":66,"dop":21,"nos":5,"clt":1507970692539}}

[Flow #3] Successfully sending a MicroTrip message to Smart[Fleet] Platform
Message : {"ty":2,"ts":1507970694545,"ap":0,"pld":{"tid":1,"lon":127.056837,"lat":37.520759,"alt":112,"sp":75,"dop":13,"nos":3,"clt":1507970694545}}

[Flow #3] Successfully sending a MicroTrip message to Smart[Fleet] Platform
Message : {"ty":2,"ts":1507970696548,"ap":0,"pld":{"tid":1,"lon":127.063228,"lat":37.509141,"alt":110,"sp":85,"dop":18,"nos":4,"clt":1507970696548}}

[Flow #3] Successfully sending a Trip message to Smart[Fleet] Platform
Message : {"ty":1,"ts":1507970696549,"pld":{"tid":1,"stt":1507970678509,"edt":1507970696548,"dis":1022,"stlat":37.509141,"stlon":127.063228,"edlat":37.520759,"edlon":127.056837,"hsts":90,"mesp":56,"fwv":"1.0.1","dtvt":102}}