본문으로 건너뛰기

Custom Variables

본 문서는 SK일렉링크 CSMS에서 커스텀 확장으로 지원하는 컴포넌트(Component) 및 변수(Variable) 규격을 정의합니다.

OCPP 버전별 조회 방식
  • OCPP v1.6: DataTransfer:com.skelectlink:GetVariables 또는 DataTransfer:com.skelectlink:SetVariables로 컴포넌트-변수 payload를 래핑하여 송수신합니다.
  • OCPP v2.1: 표준 GetVariables 또는 SetVariables 메시지 본문에 동일한 컴포넌트-변수 payload를 직접 담아 전송합니다.
인벤토리 및 상태 보고 컴포넌트 안내

커넥터 타입, 컴포넌트별 펌웨어 버전, 하드웨어 인벤토리처럼 충전기가 자신의 구성을 CSMS에 보고하는 항목은 GetVariables가 아니라 GetReport / NotifyReport로 교환합니다. 해당 컴포넌트-변수 정의는 Report Components 문서를 참고하시기 바랍니다.

접근 권한 정의​

  • EVSE 권한:
    • ReadOnly: EVSE가 GetVariables를 통해 조회만 가능한 변수
    • WriteOnly: EVSE가 SetVariables를 통해 설정만 가능한 변수
    • ReadWrite: EVSE가 GetVariables 및 SetVariables로 조회와 설정 모두 가능한 변수
  • CSMS 권한:
    • ReadOnly: CSMS가 GetVariables를 통해 조회만 수행하는 변수
    • WriteOnly: CSMS가 SetVariables를 통해 설정값을 주입하는 변수
    • ReadWrite: CSMS가 GetVariables 및 SetVariables로 조회와 설정 모두 수행하는 변수

1. CustomGeneralInfo​

사용자 인터페이스(UI/화면) 표시 및 충전소 기본 안내에 사용되는 정보를 제공하는 컴포넌트입니다.

Variables​

Field NameTypeEVSE 권한CSMS 권한Description
CustomStationDisplayNameStringReadOnlyReadWrite충전소 표시 이름
CustomDeepLinkURIStringReadOnlyReadWriteQR/원격 결제 연동 딥링크 URI
MaximumChargingSoCStringReadOnlyReadWrite충전기 최대 충전 제한 SoC (%)

Sample (OCPP v1.6)​

Request

요청 예시
[
  2,
  "b914adcc-d113-46de-ad4b-edb168b96045",
  "DataTransfer",
  {
    "vendorId": "com.skelectlink",
    "messageId": "GetVariables",
    "data": {
      "getVariableData": [
        {
          "component": {
            "name": "CustomGeneralInfo"
          },
          "variable": {
            "name": "CustomStationDisplayName"
          },
          "attributeType": "Actual"
        }
      ]
    }
  }
]

Response

응답 예시
[
  3,
  "b914adcc-d113-46de-ad4b-edb168b96045",
  {
    "status": "Accepted",
    "data": {
      "getVariableResult": [
        {
          "attributeType": "Actual",
          "attributeValue": "SK일렉링크 서초 로얄 파크점",
          "component": {
            "name": "CustomGeneralInfo"
          },
          "variable": {
            "name": "CustomStationDisplayName"
          }
        }
      ]
    }
  }
]

Sample (OCPP v2.1)​

Request

요청 예시
[
  2,
  "b914adcc-d113-46de-ad4b-edb168b96045",
  "GetVariables",
  {
    "getVariableData": [
      {
        "component": {
          "name": "CustomGeneralInfo"
        },
        "variable": {
          "name": "CustomStationDisplayName"
        },
        "attributeType": "Actual"
      }
    ]
  }
]

Response

응답 예시
[
  3,
  "b914adcc-d113-46de-ad4b-edb168b96045",
  {
    "getVariableResult": [
      {
        "attributeType": "Actual",
        "attributeValue": "SK일렉링크 서초 로얄 파크점",
        "component": {
          "name": "CustomGeneralInfo"
        },
        "variable": {
          "name": "CustomStationDisplayName"
        },
        "attributeStatus": "Accepted"
      }
    ]
  }
]

2. CustomKoreaSmartCharge​

환경부 스마트 충전(K-VAS) 및 배터리 정보 수집과 관련된 설정 컴포넌트입니다.

Variables​

Field NameTypeEVSE 권한CSMS 권한Description
VasAgreeTermStringReadOnlyReadWrite개인정보 수집 및 이용 동의 약관 내용
BatteryInfoMaxCartridgeNumberReadOnlyReadWriteBatteryInfo 최대 적재량 (1~100 사이 정수)

3. CustomDemandResponse​

수요반응(DR, Demand Response) 프로그램 관련 설정 컴포넌트입니다.

Variables​

Field NameTypeEVSE 권한CSMS 권한Description
DRTargetEnabledStringReadOnlyReadWrite수요반응 대상 충전기 여부 (true / false)
DRParticipationModeStringReadOnlyReadWrite수요반응 참여 모드 (manual / auto)

변수 상세 설명​

DRTargetEnabled

  • true: 해당 충전기는 수요반응(DR) 참여 대상 충전기입니다.
  • false: 해당 충전기는 수요반응(DR) 참여 대상이 아닙니다.

DRParticipationMode

  • manual: 충전 시작 시 사용자가 화면에서 수요반응 참여 여부를 직접 선택합니다.
  • auto: 별도의 사용자 동의 절차 없이 자동으로 수요반응에 참여합니다.