8. 메시지 포맷

Smart[Fleet] 플랫폼에 연동되는 다양한 차량 센서들이 플랫폼에 전송하는 메세지에 대해서 정의합니다.

표에 M/O는 Mandatory/Optional의 약자로, Mandatory는 필수로 포함해야 하는 데이터를 Optional은 필요에 따라 기입이 여부를 개발사에서 판단하시면 됩니다.

이 매뉴얼은 단말이 MQTTS 프로토콜로 Smart[Fleet] 플랫폼과 연동하기 위한 메시지 포맷입니다. Entity 등록을 위한 HTTP Rest API 사용은 4. 구성요소(Entity) 등록 문서를, App 개발자를 위한 Smart[Fleet] API 는 6. API 규격 문서를 참고하십시오.

8.1. 메시지 기본 구조

Smart[Fleet] 플랫폼의 기본 메시지 구조는 Header 와 Payload 형태로 구조화 되어 있습니다. 각 메시지는 해당 메시지의 타입인 ty 로 구분하고 ty 에 따라 pld child의 내용이 상이합니다.

Example Code :

{
    // Header
    "ts" : 1505434907995,
    "ty" : 2,

    // Payload
    "pld" : {
        "tid" : 1,
        "fc" : 12,
        "lon" : 127.114513,
        "lat" : 37.380241,
        "rpm" : 323,
        "em" : 28,
        "el" : 25,
        "xyz" : "23123,49923,123",
        "vv" : "11.4"
    }
}

8.2. 센서 타입별 주기 메시지 포맷

8.2.1. GPS

GPS 단말에서 발생한 위치 데이터를 플랫폼에 전달하기 위해 필요한 메시지를 정의합니다.

8.2.1.1. Message Header

Key	Type	M/O	Description
ty	Int	M	전달하고자 하는 페이로드 타입 Trip_GPS Microtrip_GPS
ts	Int	O	정보 수집 시간
pld		M	아래 각 페이로드 메시지를 참고

Note

표에 M/O는 Mandatory/Optional의 약자로, Mandatory는 필수로 포함해야하는 데이터를 Optional은 필요에 따라 기입이 여부를 개발사에 판단합니다.

8.2.1.2. Payload Types

8.2.1.2.1. GPS Trip Message

Trip Message는 차량이 운행이 종료된 후에 전달하는 메시지입니다.

Key	Type	M/O	Description	Note
tid	Int	M	Trip 고유 번호
stt	Int	M	Trip의 시작 날짜 및 시간	UTC
edt	Int	M	Trip의 종료 날짜 및 시간	UTC
dis	Int	O	Trip의 주행거리	Meter
stlat	Int	O	운행 시작 좌표의 위도
stlon	Int	O	운행 시작 좌표의 경도
edlat	Int	O	운행 종료 좌표의 위도
edlon	Int	O	운행 종료 좌표의 경도
hsts	Int	O	Trip의 최고 속도
mesp	Int	O	Trip의 평균 속도
fwv	String	O	펌웨어 버전
dtvt	Int	O	주행시간

Example Code :

{
    "ty" : 1,
    "ts" : 1505434907995,
    "pld" : {
          "tid" : 10,
          "stt" : 1505433907995,
          "edt" : 1505434907995,
          "dis" : 101,
          "stlon" : 127.114513,
          "stlat" : 37.380241,
          "edlon" : 126.114513,
          "edlat" : 36.380241,
          "hsts" : 121,
          "mesp" : 63,
          "fwv" : "1.0.1",
          "dtvt" : 88
    }
}

8.2.1.3. GPS Microtrip

Microtrip 메세지는 차량이 운행을 시작한 후 설정된 주기에 따라 전송하는 차량 운행에 대한 위치 데이터입니다. 주기는 각 어플리케이션 마다 상이하므로, 아래의 값은 플랫폼에 전송하는 해당 시점에 데이터를 추출하여 기입합니다.

Key	Type	M/O	Description
tid	Int	M	Trip 고유 번호
lat	Int	M	위도 (WGS84)
lon	Int	M	경도 (WGS84)
alt	Int	M	고도 (WGS84)
clt	Int	M	단말기 기준 수집 시간
sp	Int	O	Ground Speed (based on NMEA Protocol / km/h)
dop	Int	O	Dilution of Precision 값 (based on NMEA protcol)
nos	Int	O	위성 갯수 정보 (based on NMEA protocol)
tdis	Int	O	Microtrip 동안 이동한 거리

Example Code :

{
    "ts" : 1505434907995,
    "ty" : 2,
    "pld" : {
          "tid" : 1,
          "lon" : 127.114513,
          "lat" : 37.380241,
          "alt" : 280.2,
          "clt" : 1505434907995,
          "sp" : 10.2,
          "dop" : 15.2,
          "nos" : 5
    }
}

8.2.1.4. Aggregated Microtrip

Microtrip 데이터는 여러개의 데이터를 모아서 한번에 보낼 수 있습니다. 각 수집한 Microtrip 데이터는 JSON Array 데이터를 기반으로 다음과 같이 패킷을 합쳐 보낼 수 있습니다.

{
    "ty":2,
    "ts":1508215121898,
    "pld":
    [
        {
            "tid":301,
            "lon":127.062512,
            "lat":37.510296,
            "alt":102,
            "sp":90,
            "dop":13,
            "nos":5,
            "clt":1508215121888
        },
        {
            "tid":301,
            "lon":127.062512,
            "lat":37.510296,
            "alt":113,
            "sp":74,
            "dop":11,
            "nos":4,
            "clt":1508215121893
        },
        {
            "tid":301,
            "lon":127.062512,
            "lat":37.510296,
            "alt":115,
            "sp":71,
            "dop":14,
            "nos":5,
            "clt":1508215121898
        }
    ]
}

Note

페이로드가 Microtrip 여러개를 Aggregation 하여 전송할 때는 시간의 순서에 맞추어 전송하여야 합니다. 플랫폼에서 시간에 따라 Re-ordering을 수행하지 않습니다.

8.2.2. OBD

OBD 단말에서 발생한 데이터를 플랫폼에 전달하기 위해 필요한 메시지를 정의합니다.

8.2.2.1. Message Header

Key	Type	M/O	Description
ty	Int	M	전달하고자 하는 페이로드 타입 Trip_OBD Microtrip_OBD
ts	Int	O	정보 수집 시간
pld		M	아래 각 페이로드 메시지를 참고

8.2.2.2. Payload Type

8.2.2.2.1. OBD Trip

Trip Message는 차량이 운행이 종료된 후에 전달하는 메시지입니다.

Key	Type	M/O	Description	Note
tid	Int	M	Trip 고유 번호
stt	Int	M	Trip의 시작 날짜 및 시간	UTC
edt	Int	M	Trip의 종료 날짜 및 시간	UTC
dis	Int	M	Trip의 주행거리	Meter
tdis	Int	M	차량의 총 주행거리	Meter
fc	Int	M	연료소모량
stlat	Int	M	운행 시작 좌표의 위도
stlon	Int	M	운행 시작 좌표의 경도
edlat	Int	M	운행 종료 좌표의 위도
edlon	Int	M	운행 종료 좌표의 경도
ctp	Int	M	부동액(냉각수) 평균온도
coe	Int	M	Trip의 탄소 배출량
fct	Int	M	연료차단 상태의 운행시간
hsts	Int	M	Trip의 최고 속도
mesp	Int	M	Trip의 평균 속도
idt	Int	M	Trip의 공회전 시간
btv	Int	M	배터리 전압(시동OFF후 전압)
gnv	Int	M	발전기 전압(주행중 최고 전압)
wut	Int	M	Trip의 웜업시간(주행전 시동 시간)
usm	Int	O	BT가 연결된 휴대폰 번호
est	Int	O	80~100km 운행 시간
fwv	Int	O	펌웨어 버전
dtvt	Int	O	주행시간

Example Code :

{
    "ty" : 1,
    "ts" : 1505434907995,
    "pld" : {
        "tid" : 10,
        "stt" : 1505433907995,
        "edt" : 1505434907995,
        "dis" : 101,
        "tdis" : 16813,
        "fc" : 83,
        "stlon" : 127.114513,
        "stlat" : 37.380241,
        "edlon" : 126.114513,
        "edlat" : 36.380241,
        "ctp" : 48,
        "coe" : 392,
        "fct" : 123,
        "hsts" : 121,
        "mesp" : 63,
        "idt" : 3,
        "btv" : 14.5,
        "gnv" : 12.3,
        "wut" : 181,
        "dtvt" :2301
    }
}

8.2.2.2.2. OBD Microtrip

Microtrip 메세지는 차량이 운행을 시작한 후 설정된 주기에 따라 전송하는 차량 운행 상세 데이터입니다. 주기는 각 어플리케이션 마다 상이하므로, 아래의 값은 플랫폼에 전송하는 해당 시점에 데이터를 추출하여 기입합니다.

Key	Type	M/O	Description
tid	Int	M	Trip 고유 번호
fc	Int	O	연료소모량
lat	Int	M	위도 (WGS84)
lon	Int	M	경도 (WGS84)
lc	Int	O	측정 한 위치 값의 정확도
clt	Int	M	단말기 기준 수집 시간
cdit	Int	O	Trip의 현재시점까지 주행거리
rpm	Int	O	rpm
sp	Int	O	차량 속도
em	Int	O	한 주기 동안 발생한 이벤트에 대해서 Hexa String으로 표기한다. Bit Description 0 급출발 1 급좌회전 2 급우회전 3 급유턴 4 급감속 5 급가속 6 급정지 7 Reserved 한 주기 동안 차량이 급유턴과 급가속을 동시에 진행한 경우에는 28 로 표현 Bit 7 6 5 4 3 2 1 0 Value 0 0 1 0 1 0 0 0
el	Int	O	엔진 부하
xyz	Int	O	가속도 X, Y 및 각속도 Y 값 (Delimeter는comma)
vv	Int	O	배터리 전압 (시동 OFF 후 전압)
tpos	Int	O	엑셀 포지션 값

Example Code :

{
    "ts" : 1505434907995,
    "ty" : 2,
    "pld" : {
        "tid" : 1,
        "fc" : 12,
        "lon" : 127.114513,
        "lat" : 37.380241,
        "rpm" : 323,
        "em" : 28,
        "el" : 25,
        "xyz" : "23123,49923,123",
        "vv" : "11.4"
    }
}

8.2.3. ADAS

ADAS 단말에서 발생한 데이터를 플랫폼에 전달하기 위해 필요한 메시지를 정의합니다.

8.2.3.1. Message Header

Key	Type	M/O	Description
ty	Int	M	전달하고자 하는 페이로드 타입 Trip_ADAS Microtrip_ADAS
ts	Int	O	정보 수집 시간
pld		M	아래 각 페이로드 메시지를 참고

8.2.3.2. Payload Type

8.2.3.2.1. ADAS Trip

ADAS Trip 메세지는 ADAS 단말이 주행을 완료한 경우에 사용하는 메시지 포맷입니다.

Key	Type	M/O	Description
tid	Int	M	Trip 고유 번호
lat	Int	M	운행 종료 시 위도 (WGS84)
lon	Int	M	운행 종료 시 경도 (WGS84)
dop	Int	O	Dilution of Precision 값 (based on NMEA protcol)
nos	Int	O	위성 갯수 정보 (based on NMEA protocol)

Example Code :

{
    "ts" : 1505434907995,
    "ty" : 5,
    "pld" : {
        "tid" : 11123,
        "lon" : 127.114513,
        "lat" : 37.380241,
    }
}

8.2.3.2.2. ADAS Microtrip

ADAS Microtrip 메세지는 ADAS 단말에서 인지한 ADAS 및 GPS 위치 정보를 주기적으로 올릴때 사용하는 메시지 포맷입니다. 일반적으로는 ADAS와 GPS가 함께 있는 경우에 활용하며, 메시지는 ADAS 부착 차량의 운행 시작부터 운행 종료까지 주기적으로 전송합니다.

Key	Type	M/O	Description
tid	Int	M	Trip 고유 번호
lat	Int	M	위도 (WGS84)
lon	Int	M	경도 (WGS84)
dop	Int	O	Dilution of Precision 값 (based on NMEA protcol)
nos	Int	O	위성 갯수 정보 (based on NMEA protocol)
dir	Int	M	방향지시등 정보 Bit Description 30 방향지시등 점등 없음 31 좌측 방향지시등 점등 32 우측 방향지시등 점등 33 비상등 점등
sp	Int	M	차량 속도 (km/h)
ldw	Int	M	Lane Departure Warning Bit Description 30 LDW 없음 31 좌측 LDW 이슈 발생 32 우측 LDW 이슈 발생
rld	Int	O	차량과 오른쪽 차선과의 거리 (Right Lane Distance) 단위 : cm
lld	Int	O	차량과 왼쪽 차선과의 거리 (Left Lane Distance) 단위 : cm
fcw	Int	M	Forward Collision Warning Bit Description 30 FCW 없음 31 1차 경보 : CIPV (Closest In Path Vehicle) detected 32 2차 경보 : 안전거리 미확보 경보
hdw	Int	O	전방 차량과의 거리 (단위 : m)
brk	Int	O	브레이크 Bit Description 0 No Brake hit 1 Brake hit
chcmr	Int	M	카메라 고장진단 Bit Description 0 카메라 정상 1 카메라 고장
chdir	Int	M	방향지시등 고장진단 Bit Description 0 방향지시등 정상 1 왼쪽 방향지시등 고장 2 오른쪽 방향지시등 고장 3 양쪽 방향지시등 고장
chbrk	Int	M	브레이크 고장진단 Bit Description 0 브레이크 정상 1 브레이크 고장

Example Code :

{
    "ts" : 1505434907995,
    "ty" : 6,
    "pld" : {
        "tid" : 11123,
        "lon" : 127.114513,
        "lat" : 37.380241,
        "sp" : 113,
        "dir" : 31,
        "ldw" : 32,
        "rld" : 20,
        "lld" : 50,
        "fcw" : 30,
        "hdw" : 50,
        "brk" : 0,
        "chcmr" : 0,
        "chdir" : 0,
        "chbrk" : 0
    }
}

8.2.4. BlackBox

BlackBox 단말에서 발생한 데이터를 플랫폼에 전달하기 위해 필요한 메시지를 정의합니다.

8.2.4.1. Message Header

Key	Type	M/O	Description
ty	Int	M	전달하고자 하는 페이로드 타입 Trip_BlackBox Microtrip_BlackBox
ts	Int	O	정보 수집 시간
pld		M	아래 각 페이로드 메시지를 참고

8.2.4.2. Payload Type

8.2.4.2.1. BlackBox Trip

BlackBox Trip 메세지는 BlackBox 단말이 주행 또는 주차 상태를 완료한 경우에 사용하는 메시지 포맷입니다. 단 BlackBox의 Trip은 주행과 주차로 설정합니다.

Key	Type	M/O	Description
tid	Int	M	Trip 고유 번호
lat	Int	M	운행 종료 시 위도 (WGS84)
lon	Int	M	운행 종료 시 경도 (WGS84)
try	Int	M	Trip 타입 Driving Parking
vlt	Int	M	자동차 배터리 전압 (운행 종료 시)

Example Code :

{
    "ts" : 1505434907995,
    "ty" : 7,
    "pld" : {
        "tid" : 11123,
        "lon" : 127.114513,
        "lat" : 37.380241,
        "try" : 1,
        "vlt" : 12.1
    }
}

8.2.4.2.2. BlackBox Microtrip

BlackBox Microtrip 메세지는 Blackbox 단말에서 인지한 정보를 주기적으로 플랫폼에서 사용하는 메시지 포맷입니다. 일반적으로는 ADAS와 GPS가 함께 있는 경우에 활용하며, 메시지는 ADAS 부착 차량의 운행 시작부터 운행 종료까지 주기적으로 전송합니다.

Key	Type	M/O	Description
tid	Int	M	Trip 고유 번호
try	Int	M	Trip 타입 Driving Parking
lat	Int	O	위도 (WGS84) Mandatory when Driving
lon	Int	O	경도 (WGS84) Mandatory when Driving
sp	Int	O	Ground Speed (based on NMEA Protocol, km/h) Mandatory when Driving
vlt	Int	O	자동차 배터리 전압 Mandatory when Parking
tem	Int	O	자동차 내부 온도 Mandatory when Parking
tim	Int	O	주차 시간 (or 주차 남은 시간) Mandatory when Parking

Example Code :

{
    "ts" : 1505434907995,
    "ty" : 6,
    "pld" : {
        "tid" : 11123,
        "try" : 1
        "lon" : 127.114513,
        "lat" : 37.380241,
        "sp" : 113,
    }
}

8.3. 이벤트 데이터 포맷

단말에서 비주기적으로 발생한 이벤트를 플랫폼에 전송하기 위한 메시지 포맷입니다. 이벤트 기반 데이터 전송을 위한 프로시저는 5.4.2 Event Data 를 참고하십시오.

8.3.1. Message Header

Key	Type	M/O	Description
ty	Int	M	전달하고자 하는 이벤트 타입 Diagnostic Information Collision warning (Driving) Collision warning (Parking) Battery Warning Unplugged Warning Turn-off Warning ADAS Event BlackBox Booting BlackBox Mode Change BlackBox Setting Report Message BlackBox Capture Image Message
ts	Int	O	정보 수집 시간
pld		M	아래 각 페이로드 메시지를 참고

8.3.2. Payload Type

8.3.2.1. Diagnostic Information

OBD에서 인지한 차량 진단 코드(DTC)를 전송하는 메시지를 정의합니다.

Key	Type	M/O	Description
tid	Int	O	Trip 고유 번호(Not required)
dtcc	String	M	차량고장코드 (Delimeter Comma)
dtck	Int	M	0=confirm 1=pending 2=permanent
dtcs	Int	M	DTC Code의 개수

Note

OBD가 플랫폼에 DTC 코드를 전송하는 방식은 2가지입니다.

• 차량 주행이 시작한 후에 감지된 Diagnostic Information을 전송하는 방법
• 플랫폼을 통해서 OBD에 DTC 코드 보고를 요청하는 RPC 방법

Example Code :

{
    "ts" : 1505434907995,
    "ty" : 20,
    "pld" : {
        "tid": 1,
        "dtcc": "AAA",
        "dtck": 0,
        "dtcs": 2
    }
}

8.3.2.2. Collision warning (Driving)

운행 중 OBD가 감지한 차량 접촉 사고에 대한 위치 정보를 전달하는 메세지를 정의합니다.

Key	Type	M/O	Description
tid	Int	O	Trip 고유 번호
dclat	Int	M	위도 (WGS84)
dclon	Int	M	경도 (WGS84)

Example Code :

{
    "ts" : 1505434907995,
    "ty" : 21,
    "pld" : {
        "tid": 1,
        "dclat" : 37.380241,
        "dclon" : 127.114513
    }
}

8.3.2.3. Collision warning (Parking)

주차 중 OBD가 감지한 차량 접촉 사고에 대한 위치 정보를 전달하는 메세지를 정의합니다.

Key	Type	M/O	Description
tid	Int	O	Trip 고유 번호
plat	Int	M	위도 (WGS84)
plon	Int	M	경도 (WGS84)

Example Code :

{
  "ts" : 1505434907995,
  "ty" : 22,
  "pld" : {
      "plat" : 37.380241,
      "plon" : 127.114513
  }
}

8.3.2.4. Battery Warning

차량 배터리 소모에 대한 위험 알림 메시지를 정의합니다.

Key	Type	M/O	Description
tid	Int	O	Trip 고유 번호
wbv	Int	M	배터리 전압

Example Code :

{
  "ts" : 1505434907995,
  "ty" : 23,
  "pld" : {
      "wbv" : 13
  }
}

8.3.2.5. Unplugged Warning

OBD가 차량으로부터 탈착되는 이벤트에 대한 알림 메시지를 정의합니다.

Key	Type	M/O	Description
tid	Int	O	Trip 고유 번호
unpt	Int	M	탈착 시간
pt	Int	M	부착 시간

Example Code :

{
  "ts" : 1505434907995,
  "ty" : 24,
  "pld" : {
      "unpt": 1505433907995,
      "pt": 1505434907995
  }
}

8.3.2.6. Turn-off Warning

OBD가 종료된 경우, 종료 이전에 종료에 대한 이유를 플랫폼에 전달하기 위한 알림 매시지를 정의합니다.

Key	Type	M/O	Description
tid	Int	O	Trip 고유 번호
rs	String	M	단말 종료 원인

Example Code :

{
  "ts" : 1505434907995,
  "ty" : 25,
  "pld" : {
      "rs": "unexpected reason"
  }
}

8.3.2.7. ADAS Event

ADAS에서 인지한 이벤트 정보를 전송하는 메시지 포맷입니다.

Key	Type	M/O	Description
tid	Int	O	Trip 고유 번호
lat	Int	O	위도 (WGS84)
lon	Int	O	경도 (WGS84)
dop	Int	O	Dilution of Precision 값 (based on NMEA protcol)
nos	Int	O	위성 갯수 정보 (based on NMEA protocol)
dir	Int	M	방향 지시등 정보 Bit Description 30 방향 지시등 점등 없음 31 좌측 지시등 점등 32 우측 지시등 점등 33 비상등 점등
sp	Int	M	차량 속도 (km/h)
ldw	Int	M	Lane Departure Warning Bit Description 30 LDW 없음 31 좌측 LDW 이슈 발생 32 우측 LDW 이슈 발생
fcw	Int	M	Forward Collision Warning Bit Description 30 FCW 없음 31 1차 경보 (위험 경보) 32 2차 경보 (안전거리 미확보 경보)

Example Code :

{
    "ts" : 1505434907995,
    "ty" : 26,
    "pld" : {
          "tid" : 11123,
          "lon" : 127.114513,
          "lat" : 37.380241,
          "sp" : 113,
          "dir" : 31,
          "ldw" : 32,
          "fcw" : 30
    }
}

8.4. RPC 메시지 포맷

OBD 단말을 제어하기 위한 RPC Message Type을 명세합니다. 기술되지 않는 제어는 단말과 어플리케이션 상호 간에만 규약 되어 있다면, Vendor Specific Message를 사용합니다.

8.4.1. Vendor Specific Message

각 단말 업체에서 별도로 관리하는 제어 요청 메시지이며, 다른 제어 메시지도 본 포맷을 확장하여 명시됩니다.

8.4.1.1. Request

Key	Type	M/O	Description
method	String	M	원격 제어하고자 하는 기능에 대해서 명세
params	String	M	기능에 대한 파라미터를 명세

8.4.1.2. Response

Key	Type	M/O	Description
result	String	M	resultCode 에 정의된 제어 결과 추가

8.4.1.3. Result

Key	Type	M/O	Description
result	String	M	resultCode 에 정의된 제어 결과 추가
addInfo	String	O	결과 값에 따른 추가 정보 명세

8.4.2. Device Activation

차량용 센서를 차량에 부착한 후 활성화하기 위해 필요한 RPC 메시지를 명세합니다.

8.4.2.1. Request

Key	Type	M/O	Description
method	String	M	activationReq 로 명세
params	String	M	Key Type M/O Description Vid String M 차량 식별 번호 upp Int M Microtrip 업로드 주가 (초) Elt Int M 배기량 정보 Fut Int M 가솔린 디젤 LPG Mty String M Automatic Manual cyl Int O 실린더 정보

Example Code :

{
    "method" : "activationReq",
    "params" : {
        "vid" : "25나0660",
        "upp" : 1,
        "elt" : 1999,
        "fut" : 1,
        "mty" : "Automatic"
    }
}

8.4.2.2. Response

Key	Type	M/O	Description
result	String	M	resultCode 에 정의된 제어 결과 추가

Example Code :

{
    "result" : 2000
}

8.4.2.3. Result

Key	Type	M/O	Description
result	String	M	resultCode 에 정의된 제어 결과 추가
addInfo	String	M	Key Type M/O Decsription addInfo String M 차량 식별 번호

Example Code :

{
    "result" : 2000,
    "addInfo" : {
        "vid" : "25나0660"
    }
}

8.4.3. Firmware Update

차량용 OBD의 펌웨어 업데이트를 위한 RPC 메시지를 명세합니다.

8.4.3.1. Request

Key	Type	M/O	Description
method	String	M	fwupdate 로 명세
params	String	M	Key Type M/O Description Pkv String M F/W 패키지 버전 url String M F/W 패키지가 저장된 사이트 주소

Example Code :

{
    "method" : "fwupdate",
    "params" : {
        "pkv" : "1.0.1",
        "url" : "ftp://smartfleet.sktelecom.com:10011"
    }
}

8.4.3.2. Response

Key	Type	M/O	Description
result	String	M	resultCode 에 정의된 제어 결과 추가

Example Code :

{
    "result" : 2000
}

8.4.4. OBD Reset

차량용 OBD의 재시작을 위한 RPC 메시지

8.4.4.1. Request

Key	Type	M/O	Description
method	String	M	reset 로 명세
params	String	M	N/A

Example Code :

{
    "method" : "reset",
    "params" : ""
}

8.4.4.2. Response

Key	Type	M/O	Description
result	String	M	resultCode 에 정의된 제어 결과 추가

Example Code :

{
    "result" : 2000
}

8.4.4.3. Result

Key	Type	M/O	Description
result	String	M	resultCode 에 정의된 제어 결과 추가
addInfo	String	O	결과 값에 따른 추가 정보 명세

Example Code :

{
    "result" : 2000
}

8.4.5. Device Serial Number Check

차량용 OBD의 시리얼 번호 확인용 RPC 메시지

8.4.5.1. Request

Key	Type	M/O	Description
method	String	M	serial 로 명세
params	String	M	N/A

Example Code :

{
    "method" : "serial",
    "params" : ""
}

8.4.5.2. Response

Key	Type	M/O	Description
result	String	M	resultCode 에 정의된 제어 결과 추가

Example Code :

{
    "result" : 2000
}

8.4.5.3. Result

Key	Type	M/O	Description
result	String	M	resultCode 에 정의된 제어 결과 추가
addInfo	String	M	Key Type M/O Decsription sn String M 단말 시리얼 번호

Example Code :

{
    "result" : 2000,
    "addInfo" : {
        "sn" : "70d71b00-71c9-11e7-b3e0-e5673983c7b9"
    }
}

8.4.6. Clear Device Data

차량용 OBD 데이터 삭제

8.4.6.1. Request

Key	Type	M/O	Description
method	String	M	cleardata 로 명세
params	String	M	N/A

Example Code :

{
    "method" : "cleardata",
    "params" : ""
}

8.4.6.2. Response

Key	Type	M/O	Description
result	String	M	resultCode 에 정의된 제어 결과 추가

Example Code :

{
    "result" : 2000
}

8.4.6.3. Result

Key	Type	M/O	Description
result	String	M	resultCode 에 정의된 제어 결과 추가
addInfo	String	O	N/A

Example Code :

{
    "result" : 2000
}

8.4.7. Firmware Update (Chunk-based)

Chunk 기반으로 차량용 OBD의 펌웨어 업데이트를 위한 RPC 메시지를 명세합니다.

8.4.7.1. Request

Key	Type	M/O	Description
method	String	M	fwupchunk 로 명세
params	String	M	Key Type M/O Description Tsz Int M F/W 전체 용량 Csz Int M Chunk 사이즈 Idx Int M Chunk 데이터 인덱스 pyd String M F/W Chunk 데이터

Example Code :

{
    "method" : "fwupchunk",
    "params" : {
        "tsz" : 4932321,
        "csz" : 10000,
        "idx" : 13,
        "pyl" : "83a27473cf0000015e82e9b55ba2747902a3706c64"
    }
}

8.4.7.2. Response

Key	Type	M/O	Description
result	String	M	resultCode 에 정의된 제어 결과 추가

Example Code :

{
    "result" : 2000
}

8.4.7.3. Result

Key	Type	M/O	Description
result	String	M	resultCode 에 정의된 제어 결과 추가
addInfo	String	O	N/A

Example Code :

{
    "result" : 2000
}

8.4.8. Common Response Code for RPC Result

8.4.8.1. Code Class

Status Class	Code	Description
Success	2XXX	RPC 결과가 정상적으로 동작하는 경우
Sensor Error	4XXX	RPC 결과를 수신한 단말이 비정상적으로 동작한 경우
Platform Error	5XXX	RPC 요청에 대해서 플랫폼이 비정상적으로 동작한 경우

8.4.8.2. Successful Response Class

Code	Description
2000	RPC 정상적 수행
2001	RPC 메시지 정상적으로 수신

8.4.8.3. Sensor Error Response Class

Code	Description
4000	디바이스가 수행할 수 없는 RPC 메시지 수신
4001	잘못된 RPC 파라미터 수신
4002	접근 불가
4003	동일한 RPC 중복 수신