OCPP 2.0.1 GetLocalListVersion 메시지

 

GetLocalListVersion 개요

GetLocalListVersion은 중앙 시스템(CSMS)이 충전소에 저장된 로컬 인증 리스트의 현재 버전을 확인할 때 사용하는 메시지입니다. 이 메시지를 통해 중앙 시스템은 충전소의 로컬 리스트가 최신 상태인지 확인하고, 필요시 업데이트 여부를 결정할 수 있어 인증 시스템의 동기화에 필수적입니다.

메시지 구조

Request (CSMS → 충전소)

{}

Response (충전소 → CSMS)

{
  "versionNumber": 15
}

주요 필드 설명

Request 필드들

  • 요청 메시지는 빈 객체입니다 (파라미터 없음)

Response 필드들

필드명 필수여부 타입 설명
versionNumber 필수 Integer 현재 로컬 인증 리스트의 버전 번호

versionNumber 필드 값

값 설명
0 로컬 인증 리스트가 비어있거나 초기화되지 않음
1 이상 현재 로컬 리스트의 버전 번호 (숫자가 클수록 최신 버전)
-1 로컬 리스트 기능이 지원되지 않음

실제 사용 예제

예제 1: 정상적인 로컬 리스트 버전 조회

// Request
{}

// Response
{
  "versionNumber": 25
}

예제 2: 빈 로컬 리스트 상태

// Request
{}

// Response
{
  "versionNumber": 0
}

예제 3: 로컬 리스트 미지원 충전소

// Request
{}

// Response
{
  "versionNumber": -1
}

예제 4: 최초 설치 후 초기 상태

// Request
{}

// Response
{
  "versionNumber": 0
}

처리 흐름

  1. 동기화 확인 필요: CSMS가 충전소의 로컬 리스트 동기화 상태 확인 필요
  2. 버전 조회 요청: 빈 객체로 GetLocalListVersion 메시지 전송
  3. 충전소 응답: 현재 저장된 로컬 인증 리스트의 버전 번호 반환
  4. 버전 비교: CSMS가 자신이 관리하는 최신 버전과 비교
  5. 후속 처리:
    • 버전이 일치: 동기화 완료 상태
    • 버전이 다름: SendLocalList를 통해 업데이트 필요
    • 버전이 0: 초기 리스트 전송 필요
    • 버전이 -1: 로컬 리스트 기능 미지원

중요 포인트

  • 이 메시지는 CSMS에서 충전소로 보내는 상태 조회 메시지입니다
  • 요청 메시지는 파라미터가 없는 빈 객체입니다
  • 버전 번호는 SendLocalList 메시지를 통해 업데이트될 때마다 증가합니다
  • versionNumber: 0은 리스트가 비어있음을 의미하며 초기 설정이 필요합니다
  • versionNumber: -1은 해당 충전소가 로컬 리스트 기능을 지원하지 않음을 의미합니다
  • 정기적인 버전 확인을 통해 인증 리스트의 동기화 상태를 모니터링할 수 있습니다
  • 네트워크 장애 후 복구 시 동기화 확인 용도로 활용됩니다
  • 로컬 리스트 관리 정책에 따라 주기적으로 호출될 수 있습니다
  • 충전소 재부팅 후 리스트 상태 확인에도 사용됩니다

관련 메시지와의 연관성

  • SendLocalList: 버전이 다를 경우 새로운 리스트 전송에 사용
  • ClearCache: 로컬 캐시 초기화 후 버전 확인에 활용
  • Authorize: 로컬 리스트 버전이 최신이어야 정확한 오프라인 인증 가능

이 메시지를 통해 중앙 시스템은 충전소의 로컬 인증 리스트가 최신 상태인지 확인하고, 필요시 적절한 업데이트 조치를 취할 수 있어 안정적인 인증 서비스 제공과 오프라인 상황에서의 충전 서비스 연속성을 보장할 수 있습니다.