0. 문서 개요

• 표준 OCPP 1.6 메시지는 OCPP 1.6 규격(OCPP-J 1.6)을 그대로 따르므로 본 문서에서는 지원 여부만 목록화합니다.
• 비표준 확장(DataTransfer 및 명령 확장)은 CSMS 고유 규격이므로 요청/응답 payload 스키마와 처리 로직을 상세히 기술합니다.

대상 독자: 충전기 펌웨어/연동 개발자  |  전제 지식: OCPP 1.6 규격, WebSocket, JSON, TLS

1. 연결 개요

충전기는 OCPP 1.6 JSON(OCPP-J) 프로토콜로 CSMS에 WebSocket 연결합니다. 연결 시 반드시 아래 규격을 따라야 합니다.

1.1 연결 수립 순서

1. 충전기가 wss://<host>/<identity>로 WebSocket 핸드셰이크(subprotocol ocpp1.6).
2. 연결 직후 충전기가 BootNotification 전송.
3. CSMS가 등록된 충전기면 Accepted + interval 반환. 미등록이면 Rejected.
4. 충전기는 interval 주기로 Heartbeat 전송, 커넥터 상태는 StatusNotification으로 통지.

1.2 메시지 프레임 (OCPP-J)

모든 메시지는 JSON 배열입니다.

CALL       [2, "<uniqueId>", "<Action>", {<payload>}]
CALLRESULT [3, "<uniqueId>", {<payload>}]
CALLERROR  [4, "<uniqueId>", "<errorCode>", "<description>", {<details>}]

• uniqueId: 요청/응답을 짝짓는 메시지 ID. 응답은 요청과 동일한 uniqueId 사용.
• 미지원 Action 수신 시 CSMS는 CALLERROR의 errorCode = "NotImplemented"를 반환합니다.

예시 — Heartbeat

→ [2, "msg-001", "Heartbeat", {}]
← [3, "msg-001", {"currentTime": "2026-07-06T09:00:00Z"}]

2. 표준 OCPP 1.6 메시지 지원 목록

아래 표준 메시지의 payload 필드·enum·제약 조건은 OCPP 1.6 규격서를 그대로 따릅니다. 충전기는 규격서 기준으로 구현하면 되며 별도 커스터마이징은 없습니다(비표준 확장은 3~4장 참조).

2.1 Charge Point → CSMS (충전기가 전송)

2.2 CSMS → Charge Point (CSMS가 전송)

2.3 보안 확장 (OCPP 1.6 Security Whitepaper, 선택 지원)

mTLS/인증서 기반 사업자 구성에서만 사용합니다.

2.4 ChangeConfiguration 커스텀 키 (비표준 확장)

CSMS는 표준 설정 키 외에 아래 커스텀 키를 ChangeConfiguration.req로 전송할 수 있습니다. 충전기는 각 키를 아래 규칙대로 처리해야 합니다.

3. 프로토콜 프로파일 (중요)

4. DataTransfer 확장 규격

4.0 공통 규칙

요청 (CP → CSMS) — 표준 OCPP DataTransfer.req 구조:

{
  "vendorId": "<문자열>",
  "messageId": "<문자열>",
  "data": { ... }        // 확장별 JSON. 문자열이 아닌 JSON 객체로 전송
}

응답 (CSMS → CP) — 표준 OCPP DataTransfer.conf 구조:

{
  "status": "Accepted | Rejected | UnknownMessageId | UnknownVendorId",
  "data": { ... }        // 확장별 결과 JSON
}

4.1 Bionever 프로파일 (vendorId = com.bionever)

프로파일 코드 OCPP_16_BIONEVER. vendorId는 com.bionever (대소문자 무관, 불일치 시 UnknownVendorId). 아래 messageId 외에는 UnknownMessageId로 응답합니다.

4.1.1 SetPaymentInfo — 비회원 결제 통보 (CP → CSMS)

요청

{
  "vendorId": "com.bionever",
  "messageId": "SetPaymentInfo",
  "data": {
    "paymentStatus": "PAYMENT",
    "pgType": "VAN",
    "tid": "<거래 고유 ID>",
    "amount": "10000",
    "phoneNo": "01012345678",
    "connectorId": 1,
    "mid": "<상점 ID>",
    "authCode": "<카드사 승인번호>",
    "parentTid": "<원거래 tid, 취소 시>",
    "paidAt": "2026-07-08T10:00:00+09:00",
    "responseCode": "0000",
    "responseMsg": "정상",
    "ext1": null,
    "ext2": null
  }
}

응답 — PAYMENT: status = "Accepted", data에 발급된 idTag:

{ "idTag": "G1234567890" }

취소/FINALIZE: status = "Accepted" (data 없음).

4.1.2 SetChargePreference — 사용자 충전 설정: 목표 SoC + 한도 (CP ↔ CSMS)

사용자가 충전기 화면에서 설정한 목표 SoC(필수)와 충전량/금액 한도(선택)를 전달합니다. 한도에 도달하면 CSMS가 원격 정지를 요청합니다. KVAS 사용 설정과 무관하게 모든 Bionever 충전기에서 처리됩니다.

요청

{
  "vendorId": "com.bionever",
  "messageId": "SetChargePreference",
  "data": {
    "connectorId": 1,
    "targetSoC": 80,
    "limitWh": 30500,
    "limitAmount": 10000,
    "idTag": "CARD-0001"
  }
}

응답 (status = "Accepted", data는 빈 객체). Rejected 조건: connectorId < 1, SoC 범위 밖, limitWh/limitAmount가 양수가 아님, idTag 100자 초과.

CSMS → CP 방향: 원격 충전 시작 시 CSMS가 이 메시지로 목표 SoC(기본 100)를 내려보냅니다. 충전기는 {"status":"Accepted"}로 응답해야 합니다.

4.1.3 SetPrivacyConsent — 개인정보 정책 동의 (CP ↔ CSMS)

개인정보 정책 N건의 동의 여부를 목록으로 전달합니다. 같은 세션에서 같은 policyCode를 다시 보내면 최신 값으로 갱신됩니다. KVAS 사용 설정과 무관하게 처리됩니다.

요청

{
  "vendorId": "com.bionever",
  "messageId": "SetPrivacyConsent",
  "data": {
    "connectorId": 1,
    "timestamp": "2026-07-19T10:30:00.000Z",
    "idTag": "CARD-0001",
    "policies": [
      { "policyCode": "PRIVACY_COLLECT", "consented": true },
      { "policyCode": "THIRD_PARTY_KECO", "consented": true }
    ]
  }
}

응답 (status = "Accepted"). Rejected 조건: timestamp 누락/형식 오류, policies 누락/빈 배열, policyCode 누락·50자 초과·중복, consented 누락.

4.1.4 ReportDeviceVersions — 장치 버전 보고 (CP → CSMS)

충전기가 자기 장치의 버전 정보를 CSMS에 보고합니다. CSMS는 해당 충전기에 버전을 저장하며, 부팅 후 또는 버전 변경(펌웨어 업데이트 등) 시 전송하는 것을 권장합니다. KVAS 사용 설정과 무관하게 처리됩니다.

요청

{
  "vendorId": "com.bionever",
  "messageId": "ReportDeviceVersions",
  "data": {
    "managedVersion": "MGR-1.2.3",
    "seccVersion": "SECC-0.9.1"
  }
}

* 두 필드 모두 선택이나 최소 한 개는 값이 있어야 합니다. 존재하는 필드만 갱신되며, 누락한 필드의 기존 저장값은 유지됩니다.

응답 (status = "Accepted", data는 빈 객체). Rejected 조건(data.message에 사유): 두 필드 모두 없거나 공백, 값이 50자 초과.

4.2 K-VAS 스마트 제어 충전기 (환경부 배터리 상태정보 수집)

5. 충전기 QR 생성 가이드

5.1 QR URL 형식

https://qr.oasis-arca.com/{CPO}/{cpid}/{connector}

각 토큰은 ^[A-Za-z0-9_-]{1,64}$ 문자셋만 허용됩니다(그 외 문자는 무시되고 웹 기본 화면으로 이동). 예시:

https://qr.oasis-arca.com/am/CH001/1   → 게스트 웹  ?charger=CH001&connector=1
https://qr.oasis-arca.com/am/CH001     → 게스트 웹  ?charger=CH001  (connector 생략)

5.2 QR 코드 생성

• QR에 인코딩할 내용은 위 URL 문자열 그대로입니다. 별도 인코딩·파라미터 불필요.
• 커넥터마다 개별 QR을 발급합니다(듀얼 커넥터 충전기는 QR 2개).
• 오류정정 레벨 M 이상 권장(URL이 짧아 충분). 스티커에는 충전기ID·커넥터 번호를 함께 표기 권장.

생성 예시

# qrencode CLI 예 (커넥터 1번)
qrencode -o CH001-1.png -l M "https://qr.oasis-arca.com/am/CH001/1"

# 커넥터 2번
qrencode -o CH001-2.png -l M "https://qr.oasis-arca.com/am/CH001/2"

5.3 스캔 시 연결 동작 (web / iOS / Android)

QR URL 자체가 Universal Link(iOS) / App Link(Android)입니다. 실행 환경에 따라 아래와 같이 분기합니다.

서버 도달 시 CPO별 분기

[사용자가 QR 스캔]
      │
      ▼
 앱 설치? ──── 예 ──▶ OS가 앱 직접 실행 (Universal/App Link, 서버 미도달)
      │
      아니오 (또는 PC/웹)
      ▼
 qr.oasis-arca.com 서버 도달
      │
      ├─ 앱 없는 CPO(am) ─▶ 302 → https://app-am.oasis-arca.com/?charger={cpid}&connector={connector}
      │
      └─ 앱 있는 CPO ─────▶ 스토어 / 인터스티셜 (앱 설치 유도)

6. 부록

6.1 프로파일별 확장 요약

6.2 구현 체크리스트 (제조사)

• ☐WebSocket subprotocol ocpp1.6로 접속하고 경로에 chargePointIdentity를 포함한다.
• ☐표준 메시지(2장)는 OCPP 1.6 규격서 기준으로 구현한다.
• ☐CSMS가 할당한 프로파일과 vendorId를 확인한다(3장).
• ☐DataTransfer는 data를 JSON 객체로 전송하고, 응답의 OCPP status뿐 아니라 data 내부 결과 필드까지 파싱한다(4.0).
• ☐프로파일 고유 확장(4.1 Bionever)을 구현한다. 목표 SoC·한도는 SetChargePreference, 동의는 SetPrivacyConsent(정책 목록)를 사용한다 — 구 SetChargeLimit은 제거됨.
• ☐(K-VAS) 세션키 요청·설치, 배터리 3초 적재·트리거 전송, counter 연속성, 암호화(base64)를 구현한다(4.2).
• ☐(Bionever) RemoteStartTransaction의 additionalInfo를 파싱해 단가/선결제 한도를 적용한다(규격은 별도 전달).
• ☐ChangeConfiguration 커스텀 키 CsmsUrl(Hard Reset 시 전환·실패 시 복구)·SecurityProfile(Hard Reset 후 적용)·StationName을 처리한다(2.4).

6.3 문의

연동 프로파일 지정, vendorId 할당, 단가/로밍 정책 등은 CSMS 운영팀에 문의하십시오.

문의: axd@bionever.com