Overview
이 문서는 Open Charge Alliance에서 제안한 Open Charge Point Protocol을 기반으로 에스케이일렉링크 주식회사에서 충전기 운영 시스템을 운용할 목적으로 표준을 활용한 추가 데이터나 비표준 데이터를 추가적으로 정의하는 문서입니다.
접속 정보
접속 정보는 서버 담당자 또는 영업 담당자에게 문의 부탁드리겠습니다.
지원 프로토콜
- 지원 프로토콜: ocpp1.6, ocpp2.1
이 문서에서는 메시지명, 필드명, JSON 예시가 프로토콜 버전에 따라 달라지는 경우 OCPP v1.6과 OCPP v2.1을 명시적으로 구분합니다.
버전 표기가 없는 개념 설명은 두 버전에 공통으로 적용되는 연동 원칙입니다. 단, 실제 구현 시에는 각 섹션의 버전별 메시지명과 필드명을 우선 적용해야 합니다.
접속 보안
SK일렉링크 CSMS와 통신하는 모든 충전기는 OCPP Security Profile 2 이상의 보안 등급을 지원해야 합니다.
OCPP v1.6과 OCPP v2.1의 Security Profile 2/3 요구사항, 초기 자격 증명 관리, 클라이언트 인증서 운영 기준은 접속 보안 프로필을 참고해 주세요.
연동 시 주의사항
1. 시간 형식
시간형식의 데이터를 주고 받을 때에는 반드시 UTC(협정 세계시)를 기준으로 송수신해야합니다. 서버는 ISO 8601을 준수하며 다음과 같은 시간 형식을 수용할 수 있습니다:
2024-06-27T11:41:32Z2024-06-27T11:41:32.311Z2024-06-27T11:41:32.311141Z2024-06-27T20:41:32.311141+00:00
2. 다채널 충전기 처리
접속 엔드포인트는 반드시 충전소ID와 EVSE ID의 조합(하이픈으로 구분)으로 이루어집니다. 채널이 여러개인 EVSE는 접속 프로토콜에 맞는 채널 식별자를 사용해야 합니다.
OCPP v2.1 표준 모델에서는 하나의 Charging Station identity가 하나의 OCPP WebSocket connection을 대표하고, EVSE는 메시지 본문의 evse.id 또는 evseId로 식별됩니다.
다만 SK일렉링크 CSMS는 별도로 협의되지 않은 개소에 대해서는 EVSE별 1 Socket 정책을 기본으로 적용합니다. 따라서 별도 안내가 없는 경우 접속 엔드포인트의 EVSE ID와 메시지 본문의 EVSE 식별자가 동일한 EVSE를 가리키도록 구현해야 합니다.
- OCPP v1.6: 메시지 본문에서는
connectorId로 채널을 구분합니다. - OCPP v2.1: 메시지 본문에서는
evse.id또는 EVSE 모델의 식별자를 사용합니다. - 한 채널에서 사용자 인증 처리 중에 다른 채널에서 인증을 처리해서는 안됩니다.
문서 구조
이 문서는 다음과 같은 구조로 되어 있습니다:
- Custom Messages: 사용자 정의 메시지 정의
- Custom Datatypes: 사용자 정의 데이터 타입 및 열거형
- Custom Variables: 사용자 정의 변수 정의
- Use Cases: 실제 사용 사례 및 시나리오
- Security Profiles: OCPP Security Profile 2/3 및 인증서 운영 기준
재접속 시 백오프 및 지터 적용
충전기와 CSMS 간의 네트워크 연결이 끊어진 경우, 재접속 시에는 단순 반복이 아닌 지수 백오프(Exponential Backoff) 및 가중치/지터(Jitter)를 적용해야 합니다.
- 지수 백오프: 재접속 시도 간격을 점진적으로 늘려가며, 예를 들어 30초, 60초, 120초, 300초 등으로 증가시킵니다.
- 지터: 각 재접속 시도 간격에 무작위(random) 값을 더해, 여러 충전기가 동시에 재접속을 시도하는 것을 방지합니다.
이 방식은 서버에 과도한 부하를 방지하고, 네트워크 혼잡을 줄이기 위해 반드시 적용해야 합니다.
적용 예시:
- 첫 번째 재접속: 3초 후
- 두 번째 재접속: 30~35초 후
- 세 번째 재접속: 65~75초 후
- 이후 최대 재접속 간격까지 점진적으로 증가
충전기가 설치된 환경이 특수 환경이 아니라면, 최대 재접속 간격을 10분으로 제한하는 것을 권장드립니다.