Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
46 changes: 46 additions & 0 deletions specification/schema/ConnectorType/README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,46 @@
# ConnectorType

> **Canonical IRI:** [`https://schema.beckn.io/ConnectorType`](https://schema.beckn.io/ConnectorType)
> **Tags:** `ev-charging, connector, enumeration, ocpi, beckn`
> **Namespace:** `https://schema.beckn.io/`
> Part of the [DEG Schema](../../README.md)

---

**EV connector type enumeration** — the single source of truth for physical connector interface identifiers used by DEG EV charging schemas. Referenced by `EvChargingService` and `EvChargingSession` via their `connectorType` property.

## Versions

| Version | attributes.yaml | context.jsonld | vocab.jsonld |
|---------|----------------|----------------|--------------|
| **v2.0** | [attributes.yaml](./v2.0/attributes.yaml) | [context.jsonld](./v2.0/context.jsonld) | [vocab.jsonld](./v2.0/vocab.jsonld) |

## Values (latest: v2.0)

| Value | IRI | Notes |
|-------|-----|-------|
| `CCS2` | `deg:ConnectorTypeCCS2` | IEC 62196 Combo 2. |
| `Type2` | `deg:ConnectorTypeType2` | IEC 62196 Type 2 (Mennekes), AC. |
| `Type1` | `deg:ConnectorTypeType1` | IEC 62196 Type 1 (SAE J1772). |
| `CHAdeMO` | `deg:ConnectorTypeCHAdeMO` | CHAdeMO DC fast charging. |
| `GB_T` | `deg:ConnectorTypeGBT` | GB/T family (AC/DC not distinguished). |
| `GBT_AC` | `deg:ConnectorTypeGBT_AC` | GB/T AC. |
| `GBT_DC` | `deg:ConnectorTypeGBT_DC` | GB/T DC. |
| `AC-001` | `deg:ConnectorTypeAC001` | Bharat AC-001. |
| `DC-001` | `deg:ConnectorTypeDC001` | Bharat DC-001. |
| `15A` | `deg:ConnectorType15A` | 15A current rating (see notes). |
| `IEC_AC` | `deg:ConnectorTypeIECAC` | Generic IEC AC. |
| `IEC_60309` | `deg:ConnectorTypeIEC60309` | IEC 60309 industrial. |
| `Anderson` | `deg:ConnectorTypeAnderson` | Anderson-style DC. |
| `Type6` | `deg:ConnectorTypeType6` | IEC 62196-6 / IS 17017-2-6 (LEV). |

## Linked Data

| Resource | URL |
|----------|-----|
| Canonical IRI | `https://schema.beckn.io/ConnectorType` |
| JSON Schema (latest) | `https://schema.beckn.io/ConnectorType/v2.0` |
| context.jsonld (latest) | `https://schema.beckn.io/ConnectorType/v2.0/context.jsonld` |
| vocab.jsonld (latest) | `https://schema.beckn.io/ConnectorType/v2.0/vocab.jsonld` |
| Root context.jsonld | `https://schema.beckn.io/context.jsonld` |
| Root vocab.jsonld | `https://schema.beckn.io/vocab.jsonld` |
31 changes: 31 additions & 0 deletions specification/schema/ConnectorType/v2.0/attributes.yaml
Original file line number Diff line number Diff line change
@@ -0,0 +1,31 @@
$id: "https://schema.beckn.io/ConnectorType/v2.0"
$schema: "https://json-schema.org/draft/2020-12/schema"
title: ConnectorType
description: >
Enumeration of electric vehicle connector interface types used across
DEG EV charging schemas. This is the single source of truth for
connector type definitions.
x-tags:
- ev-charging
- connector
- enumeration
type: string
x-jsonld:
"@context": ./context.jsonld
"@type": ConnectorType
enum:
- CCS2
- Type2
- CHAdeMO
- GB_T
- GBT_AC
- GBT_DC
- AC-001
- DC-001
- 15A
- IEC_AC
- IEC_60309
- Anderson
- Type6
- Type1
example: "CCS2"
30 changes: 30 additions & 0 deletions specification/schema/ConnectorType/v2.0/context.jsonld
Original file line number Diff line number Diff line change
@@ -0,0 +1,30 @@
{
"@context": {
"@version": 1.1,
"deg": "https://schema.beckn.io/deg/ConnectorType/v2.0/#",
"ConnectorType": "deg:ConnectorType",
"connectorType": {
"@id": "deg:connectorType",
"@type": "@id",
"@context": {
"CCS2": "deg:ConnectorTypeCCS2",
"Type2": "deg:ConnectorTypeType2",
"Type1": "deg:ConnectorTypeType1",
"CHAdeMO": "deg:ConnectorTypeCHAdeMO",
"GB_T": "deg:ConnectorTypeGBT",
"GB/T": "deg:ConnectorTypeGBT",
"GB-T": "deg:ConnectorTypeGBT",
"GBT_AC": "deg:ConnectorTypeGBT_AC",
"GBT_DC": "deg:ConnectorTypeGBT_DC",
"AC-001": "deg:ConnectorTypeAC001",
"DC-001": "deg:ConnectorTypeDC001",
"15A": "deg:ConnectorType15A",
"IEC_AC": "deg:ConnectorTypeIECAC",
"IEC_60309": "deg:ConnectorTypeIEC60309",
"Anderson": "deg:ConnectorTypeAnderson",
"Type6": "deg:ConnectorTypeType6"
}
}
},
"@graph": []
}
141 changes: 141 additions & 0 deletions specification/schema/ConnectorType/v2.0/vocab.jsonld
Original file line number Diff line number Diff line change
@@ -0,0 +1,141 @@
{
"@context": {
"@version": 1.1,
"deg": "https://schema.beckn.io/deg/ConnectorType/v2.0/#",
"schema": "https://schema.org/",
"rdf": "http://www.w3.org/1999/02/22-rdf-syntax-ns#",
"rdfs": "http://www.w3.org/2000/01/rdf-schema#",
"xsd": "http://www.w3.org/2001/XMLSchema#"
},
"@graph": [
{
"@id": "deg:ConnectorType",
"@type": "schema:Enumeration",
"schema:name": "Connector Type",
"rdfs:comment": "Enumeration of electric vehicle connector interface types.",
"schema:hasEnumerationMember": [
{ "@id": "deg:ConnectorTypeCCS2" },
{ "@id": "deg:ConnectorTypeType2" },
{ "@id": "deg:ConnectorTypeCHAdeMO" },
{ "@id": "deg:ConnectorTypeGBT" },
{ "@id": "deg:ConnectorTypeGBT_AC" },
{ "@id": "deg:ConnectorTypeGBT_DC" },
{ "@id": "deg:ConnectorTypeAC001" },
{ "@id": "deg:ConnectorTypeDC001" },
{ "@id": "deg:ConnectorType15A" },
{ "@id": "deg:ConnectorTypeIECAC" },
{ "@id": "deg:ConnectorTypeIEC60309" },
{ "@id": "deg:ConnectorTypeAnderson" },
{ "@id": "deg:ConnectorTypeType6" },
{ "@id": "deg:ConnectorTypeType1" }
]
},
{
"@id": "deg:ConnectorTypeCCS2",
"@type": "deg:ConnectorType",
"schema:name": "CCS2",
"schema:identifier": "CCS2",
"rdfs:comment": "IEC 62196 Combo 2 (CCS2). Type 2 inlet with additional DC pins for DC fast charging.",
"rdfs:seeAlso": "https://github.com/ocpi/ocpi/blob/master/mod_locations.asciidoc"
},
{
"@id": "deg:ConnectorTypeType2",
"@type": "deg:ConnectorType",
"schema:name": "Type2",
"schema:identifier": "Type2",
"rdfs:comment": "IEC 62196 Type 2 (AC) connector, commonly called Type 2 or Mennekes, used for AC charging.",
"rdfs:seeAlso": "https://github.com/ocpi/ocpi/blob/master/mod_locations.asciidoc"
},
{
"@id": "deg:ConnectorTypeCHAdeMO",
"@type": "deg:ConnectorType",
"schema:name": "CHAdeMO",
"schema:identifier": "CHAdeMO",
"rdfs:comment": "CHAdeMO DC fast charging connector system.",
"rdfs:seeAlso": "https://github.com/ocpi/ocpi/blob/master/mod_locations.asciidoc"
},
{
"@id": "deg:ConnectorTypeGBT",
"@type": "deg:ConnectorType",
"schema:name": "GB/T",
"schema:identifier": "GB_T",
"schema:alternateName": "GB-T",
"rdfs:comment": "GB/T connector family. OCPI distinguishes AC vs DC (GBT_AC vs GBT_DC). Consider splitting if the distinction matters for interoperability.",
"rdfs:seeAlso": "https://github.com/ocpi/ocpi/blob/master/mod_locations.asciidoc"
},
{
"@id": "deg:ConnectorTypeGBT_AC",
"@type": "deg:ConnectorType",
"schema:name": "GBT AC",
"schema:identifier": "GBT_AC",
"rdfs:comment": "GB/T AC connector type.",
"rdfs:seeAlso": "https://github.com/ocpi/ocpi/blob/master/mod_locations.asciidoc"
},
{
"@id": "deg:ConnectorTypeGBT_DC",
"@type": "deg:ConnectorType",
"schema:name": "GBT DC",
"schema:identifier": "GBT_DC",
"rdfs:comment": "GB/T DC connector type.",
"rdfs:seeAlso": "https://github.com/ocpi/ocpi/blob/master/mod_locations.asciidoc"
},
{
"@id": "deg:ConnectorTypeType1",
"@type": "deg:ConnectorType",
"schema:name": "Type1",
"schema:identifier": "Type1",
"rdfs:comment": "IEC 62196 Type 1 (SAE J1772) AC connector, common in North America and Japan.",
"rdfs:seeAlso": "https://github.com/ocpi/ocpi/blob/master/mod_locations.asciidoc"
},
{
"@id": "deg:ConnectorTypeAC001",
"@type": "deg:ConnectorType",
"schema:name": "AC-001",
"schema:identifier": "AC-001",
"rdfs:comment": "Bharat AC-001 charging specification and program."
},
{
"@id": "deg:ConnectorTypeDC001",
"@type": "deg:ConnectorType",
"schema:name": "DC-001",
"schema:identifier": "DC-001",
"rdfs:comment": "Bharat DC-001 charging specification and program."
},
{
"@id": "deg:ConnectorType15A",
"@type": "deg:ConnectorType",
"schema:name": "15A",
"schema:identifier": "15A",
"rdfs:comment": "15A is a current rating, not a connector family. Consider modeling this as rated or max current, not as ConnectorType."
},
{
"@id": "deg:ConnectorTypeIECAC",
"@type": "deg:ConnectorType",
"schema:name": "IEC AC",
"schema:identifier": "IEC_AC",
"rdfs:comment": "Ambiguous shorthand. Prefer a specific IEC connector family (Type 1, Type 2, IEC 60309), or deprecate."
},
{
"@id": "deg:ConnectorTypeIEC60309",
"@type": "deg:ConnectorType",
"schema:name": "IEC 60309",
"schema:identifier": "IEC_60309",
"rdfs:comment": "IEC 60309 industrial connector family. Multiple variants exist by phase and current rating. Consider narrowing or splitting into variants if needed.",
"rdfs:seeAlso": "https://github.com/ocpi/ocpi/blob/master/mod_locations.asciidoc"
},
{
"@id": "deg:ConnectorTypeAnderson",
"@type": "deg:ConnectorType",
"schema:name": "Anderson",
"schema:identifier": "Anderson",
"rdfs:comment": "Anderson-style DC connector family label. Not directly represented in OCPI ConnectorType list."
},
{
"@id": "deg:ConnectorTypeType6",
"@type": "deg:ConnectorType",
"schema:name": "Type6",
"schema:identifier": "Type6",
"rdfs:comment": "IEC 62196-6 or IS 17017-2-6 (Type 6) connector, typically referenced in LEV charging contexts."
}
]
}
4 changes: 3 additions & 1 deletion specification/schema/EvChargingService/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -21,7 +21,8 @@
| Property | Type | Required | Description |
|----------|------|:--------:|-------------|
| `evseId` | `string` | — | EVSE identifier (e.g., OCPI/Hubject style). |
| `connectorType` | `string` (enum) | ✓ | Physical connector type: `CCS2`, `Type2`, `CHAdeMO`, `GB_T`. |
| `qrIdentifier` | `string` | — | Short URL or token encoded in the physical QR code affixed to the connector, for BAP-side QR-scan discovery. |
| `connectorType` | `string` (enum) | ✓ | Physical connector type. Full list: see [ConnectorType](../ConnectorType/README.md). |
| `maxPowerKW` | `number` | ✓ | Maximum output power of the connector (kW). |
| `minPowerKW` | `number` | — | Minimum controllable power if throttling is supported (kW). |
| `reservationSupported` | `boolean` | — | Whether advance reservations are supported. |
Expand All @@ -31,6 +32,7 @@
| `roamingNetworks` | `array<string>` | — | Interoperability/roaming networks this EVSE participates in. |
| `ocppVersion` | `string` | — | OCPP protocol version supported. |
| `powerType` | `string` (enum) | — | AC or DC power type. |
| `vehicleType` | `string` or `array<string>` (enum) | — | Vehicle type(s) that can use this charging service: `2-WHEELER`, `3-WHEELER`, `4-WHEELER`. |

## Linked Data

Expand Down
36 changes: 30 additions & 6 deletions specification/schema/EvChargingService/v2.0/attributes.yaml
Original file line number Diff line number Diff line change
Expand Up @@ -17,7 +17,7 @@ x-tags:
- connector
- energy
type: object
additionalProperties: false
additionalProperties: true
required:
- connectorType
- maxPowerKW
Expand All @@ -33,9 +33,20 @@ properties:
x-jsonld:
"@id": evseId

qrIdentifier:
type: string
description: >
The short URL or plain-text token encoded in the physical QR code
affixed to this connector. BPPs populate this during catalog publish
so that BAPs can discover a specific connector by scanning its QR
without requiring CPO-specific SDK logic to resolve the scanned value.
example: "https://charge.ecopower.in/cs01-ccs2"
x-jsonld:
"@id": qrIdentifier

connectorType:
type: string
enum: [CCS2, Type2, CHAdeMO, GB_T]
enum: [CCS2, Type2, CHAdeMO, GB_T, GBT_AC, GBT_DC, AC-001, DC-001, 15A, IEC_AC, IEC_60309, Anderson, Type6, Type1]
description: Physical connector type supported by this EVSE.
example: CCS2
x-jsonld:
Expand Down Expand Up @@ -161,9 +172,22 @@ properties:
"@id": chargingSpeed

vehicleType:
type: string
enum: ["2-WHEELER", "3-WHEELER", "4-WHEELER"]
description: Type of vehicle that can use this charging service.
example: "4-WHEELER"
oneOf:
- type: string
enum: ["2-WHEELER", "3-WHEELER", "4-WHEELER"]
description: Single vehicle type supported by this charging service.
example: "4-WHEELER"
- type: array
items:
type: string
enum: ["2-WHEELER", "3-WHEELER", "4-WHEELER"]
minItems: 1
uniqueItems: true
description: Multiple vehicle types supported by this charging service.
example: ["2-WHEELER", "4-WHEELER"]
description: >
Vehicle type(s) that can use this charging service.
Use a single string for backwards compatibility or an array
when the connector supports multiple vehicle types.
x-jsonld:
"@id": vehicleType
Loading