GetConfiguration 메시지는 OCPP에서 충전기의 구성 정보를 요청하거나 특정 키(key)에 대한 값을 조회하기 위해 사용하는 메시지입니다. 이 메시지를 통해 중앙 시스템(Central System)은 충전기의 설정 정보를 얻을 수 있으며, 관리와 문제 해결에 유용합니다.
◈ GetConfiguration 메시지 구조
▶ GetConfiguration 요청 (Central System → Charge Point)
GetConfiguration 요청 메시지는 중앙 시스템에서 충전기로 전송되며, 조회하고자 하는 특정 키 값을 명시하거나, 모든 키를 조회할 수 있습니다.
| 필드 이름 | 필드 타입 | 설명 |
| key | CiString50Type | 조회하고자 하는 설정 키 배열 (옵션) |
이 필드가 비어 있으면, 충전기의 모든 구성 키와 값을 요청합니다.
▶ GetConfiguration 응답 (Charge Point → Central System)
충전기는 요청에 대한 응답으로 현재 구성 정보를 반환합니다. 응답은 아래의 두 가지 주요 데이터 그룹으로 나뉩니다.
| 필드 이름 | 필드 타입 | 설명 |
| configurationKey | KeyValue | 현재 설정된 키와 값 리스트(옵션) |
| unknownKey | CiString50Type | 요청한 키 중 충전기에서 인식하지 못한 키 리스트(옵션) |
● KeyValue
| 필드 이름 | 필드 타입 | 설명 |
| key | CiString50Type | 조회하고자 하는 설정 키(필수) |
| readonly | Boolean | 해당 키가 읽기 전용인지 여부를 나타냅니다. true라면 이 키의 값은 수정할 수 없습니다.(필수) |
| value | CiString500Type | 설정된 값(옵션) |
◈ GetConfiguration 메시지 예제
▶ 요청 메시지 (모든 키 조회 요청)
{}
▶요청 메시지 (특정 키 조회 요청)
{
"key": ["AllowOfflineTxForUnknownId", "HeartbeatInterval"]
}
▶ 응답 메시지 (성공적인 응답)
{
"configurationKey": [
{
"key": "AllowOfflineTxForUnknownId",
"readonly": false,
"value": "true"
},
{
"key": "HeartbeatInterval",
"readonly": false,
"value": "300"
}
],
"unknownKey": []
}
▶ 응답 메시지 (요청한 키 중 일부를 찾지 못한 경우)
{
"configurationKey": [
{
"key": "HeartbeatInterval",
"readonly": false,
"value": "300"
}
],
"unknownKey": ["InvalidKeyName"]
}
◈ 주요 기능
- 중앙 관리의 효율성
중앙 시스템에서 충전기의 설정 정보를 쉽게 조회할 수 있어 관리 작업을 간소화합니다. - 문제 해결 지원
충전기의 현재 상태를 확인하고, 설정이 문제의 원인인지 파악할 수 있습니다. - 유연한 설정 변경 가능성 탐색
읽기 전용 여부를 확인하여 중앙 시스템이 변경 가능한 설정을 식별합니다.
GetConfiguration 메시지는 충전기의 설정 정보를 효과적으로 관리하고 문제를 해결하는 데 중요한 역할을 합니다.