feat: Allow the specification of multiple charging ports.

Signed-off-by: Daniel Alvarez-Coello <[email protected]>
COVESA · Aug 13, 2024 · d63292b · d63292b
1 parent 777997c
commit d63292b
Showing 1 changed file with 104 additions and 41 deletions.
diff --git a/spec/Powertrain/TractionBattery.vspec b/spec/Powertrain/TractionBattery.vspec
@@ -236,6 +236,64 @@ Charging:
   type: branch
   description: Properties related to battery charging.
 
+Charging.ChargingPort:
+  type: branch
+  instances:
+    - ["FrontLeft", "FrontMiddle", "FrontRight", "RearLeft", "RearMiddle", "RearRight", "AnyPosition"]
+  description: Properties related to a particular charging port available in the vehicle.
+  comment: If a vehicle has a single charging port, then use the instance AnyPosition.
+
+Charging.ChargingPort.SupportedInletTypes:
+  datatype: string[]
+  type: attribute
+  allowed: [
+    'IEC_TYPE_1_AC',
+    'IEC_TYPE_2_AC',
+    'IEC_TYPE_3_AC',
+    'IEC_TYPE_4_DC',
+    'IEC_TYPE_1_CCS_DC',
+    'IEC_TYPE_2_CCS_DC',
+    'TESLA_ROADSTER',
+    'TESLA_HPWC',
+    'TESLA_SUPERCHARGER',
+    'GBT_AC',
+    'GBT_DC',
+    'OTHER'
+    ]
+  description: A list of the supported (i.e., available) charging inlets in a particular charging port.
+               IEC types refer to IEC 62196,  GBT refers to  GB/T 20234.
+  comment:     A vehicle may have multiple charging ports.
+               IEC_TYPE_1_AC refers to Type 1 as defined in IEC 62196-2. Also known as Yazaki or J1772 connector.
+               IEC_TYPE_2_AC refers to Type 2 as defined in IEC 62196-2. Also known as Mennekes connector.
+               IEC_TYPE_3_AC refers to Type 3 as defined in IEC 62196-2. Also known as Scame connector.
+               IEC_TYPE_4_DC refers to AA configuration as defined in IEC 62196-3. Also known as Type 4 or CHAdeMO connector.
+               IEC_TYPE_1_CCS_DC refers to EE Configuration as defined in IEC 62196-3. Also known as CCS1 or Combo1 connector.
+               IEC_TYPE_2_CCS_DC refers to FF Configuration as defined in IEC 62196-3. Also known as CCS2 or Combo2 connector.
+               TESLA_ROADSTER, TESLA_HPWC (High Power Wall Connector) and TESLA_SUPERCHARGER refer to non-standardized charging
+               ports/methods used by Tesla.
+               GBT_AC refers to connector specified in GB/T 20234.2.
+               GBT_DC refers to connector specified in GB/T 20234.3. Also specified as BB Configuration in IEC 62196-3.
+               OTHER shall be used for charging ports not included in the list above.
+               For additional information see https://en.wikipedia.org/wiki/IEC_62196.
+
+Charging.ChargingPort.IsFlapOpen:
+  type: sensor
+  datatype: boolean
+  type: actuator
+  description: Status of the charging port flap(s).
+  comment: True = at least one flap of this port is open, False = All flaps of this port are clossed.
+
+Charging.ChargingPort.IsChargingCableConnected:
+  datatype: boolean
+  type: sensor
+  description: Indicates whether a charging cable is physically connected to a particular charging port or not.
+
+Charging.ChargingPort.IsChargingCableLocked:
+  datatype: boolean
+  type: actuator
+  description: Is charging cable locked to prevent removal.
+  comment: Locking of charging cable can be used to prevent unintentional removing during charging.
+
 Charging.ChargeLimit:
   datatype: uint8
   type: actuator
@@ -274,68 +332,72 @@ Charging.MaximumChargingCurrent.Phase3:
   description: Maximum AC charging current (rms) at inlet for Phase 3 that can be accepted by the system.
 
 Charging.ChargePortFlap:
-  deprecation: V4.1 - Replaced with Charging.IsChargePortFlapOpen
-  datatype: string
-  type: actuator
-  allowed: ['OPEN', 'CLOSED']
-  description: Status of the charge port cover(s), can potentially be controlled manually.
-               OPEN if at least one is open.
+   deprecation: V4.1 - Replaced with Charging.IsChargePortFlapOpen
+   datatype: string
+   type: actuator
+   allowed: ['OPEN', 'CLOSED']
+   description: Status of the charge port cover(s), can potentially be controlled manually.
+                OPEN if at least one is open.
 
 Charging.IsChargePortFlapOpen:
+  deprecation: V4.3 - Replaced with Charging.ChargingPort.<SomeInstance>.IsFlapOpen to allow multiple charging ports.
   datatype: boolean
   type: actuator
   description: Status of the charge port flap(s), can potentially be controlled manually.
                True if at least one is open.
 
 Charging.IsChargingCableConnected:
+  deprecation: V4.3 - Replaced with Charging.ChargingPort.<SomeInstance>.IsChargingCableConnected to allow multiple charging ports.
   datatype: boolean
   type: sensor
   description: Indicates if a charging cable is physically connected to the vehicle or not.
 
 Charging.IsChargingCableLocked:
+  deprecation: V4.3 - Replaced with Charging.ChargingPort.<SomeInstance>.IsChargingCableLocked to allow multiple charging ports.
   datatype: boolean
   type: actuator
   description: Is charging cable locked to prevent removal.
   comment: Locking of charging cable can be used to prevent unintentional removing during charging.
 
 Charging.ChargePlugType:
-  deprecation: V4.1 renamed to Charging.ChargePortType
-  datatype: string[]
-  type: attribute
-  allowed: [
-    'IEC_TYPE_1_AC',
-    'IEC_TYPE_2_AC',
-    'IEC_TYPE_3_AC',
-    'IEC_TYPE_4_DC',
-    'IEC_TYPE_1_CCS_DC',
-    'IEC_TYPE_2_CCS_DC',
-    'TESLA_ROADSTER',
-    'TESLA_HPWC',
-    'TESLA_SUPERCHARGER',
-    'GBT_AC',
-    'GBT_DC',
-    'OTHER'
-    ]
-  description: Type of charge plugs (charging inlet) available on the vehicle.
-               A charge plug type may occur multiple times in the list if there are multiple instances of that charge
-               plug type.
-               IEC types refer to IEC 62196,  GBT refers to  GB/T 20234.
-  comment:     A vehicle may have multiple charging inlets.
-               The signal Charging.ChargePlugPosition can be used to indicate position of the charge plug.
-               IEC_TYPE_1_AC refers to Type 1 as defined in IEC 62196-2. Also known as Yazaki or J1772 connector.
-               IEC_TYPE_2_AC refers to Type 2 as defined in IEC 62196-2. Also known as Mennekes connector.
-               IEC_TYPE_3_AC refers to Type 3 as defined in IEC 62196-2. Also known as Scame connector.
-               IEC_TYPE_4_DC refers to AA configuration as defined in IEC 62196-3. Also known as Type 4 or CHAdeMO connector.
-               IEC_TYPE_1_CCS_DC refers to EE Configuration as defined in IEC 62196-3. Also known as CCS1 or Combo1 connector.
-               IEC_TYPE_2_CCS_DC refers to FF Configuration as defined in IEC 62196-3. Also known as CCS2 or Combo2 connector.
-               TESLA_ROADSTER, TESLA_HPWC (High Power Wall Connector) and TESLA_SUPERCHARGER refer to non-standardized charging
-               inlets/methods used by Tesla.
-               GBT_AC refers to connector specified in GB/T 20234.2.
-               GBT_DC refers to connector specified in GB/T 20234.3. Also specified as BB Configuration in IEC 62196-3.
-               OTHER shall be used if the vehicle has a charging connector, but not one of the connectors listed above.
-               For additional information see https://en.wikipedia.org/wiki/IEC_62196.
+   deprecation: V4.1 renamed to Charging.ChargePortType
+   datatype: string[]
+   type: attribute
+   allowed: [
+     'IEC_TYPE_1_AC',
+     'IEC_TYPE_2_AC',
+     'IEC_TYPE_3_AC',
+     'IEC_TYPE_4_DC',
+     'IEC_TYPE_1_CCS_DC',
+     'IEC_TYPE_2_CCS_DC',
+     'TESLA_ROADSTER',
+     'TESLA_HPWC',
+     'TESLA_SUPERCHARGER',
+     'GBT_AC',
+     'GBT_DC',
+     'OTHER'
+     ]
+   description: Type of charge plugs (charging inlet) available on the vehicle.
+                A charge plug type may occur multiple times in the list if there are multiple instances of that charge
+                plug type.
+                IEC types refer to IEC 62196,  GBT refers to  GB/T 20234.
+   comment:     A vehicle may have multiple charging inlets.
+                The signal Charging.ChargePlugPosition can be used to indicate position of the charge plug.
+                IEC_TYPE_1_AC refers to Type 1 as defined in IEC 62196-2. Also known as Yazaki or J1772 connector.
+                IEC_TYPE_2_AC refers to Type 2 as defined in IEC 62196-2. Also known as Mennekes connector.
+                IEC_TYPE_3_AC refers to Type 3 as defined in IEC 62196-2. Also known as Scame connector.
+                IEC_TYPE_4_DC refers to AA configuration as defined in IEC 62196-3. Also known as Type 4 or CHAdeMO connector.
+                IEC_TYPE_1_CCS_DC refers to EE Configuration as defined in IEC 62196-3. Also known as CCS1 or Combo1 connector.
+                IEC_TYPE_2_CCS_DC refers to FF Configuration as defined in IEC 62196-3. Also known as CCS2 or Combo2 connector.
+                TESLA_ROADSTER, TESLA_HPWC (High Power Wall Connector) and TESLA_SUPERCHARGER refer to non-standardized charging
+                inlets/methods used by Tesla.
+                GBT_AC refers to connector specified in GB/T 20234.2.
+                GBT_DC refers to connector specified in GB/T 20234.3. Also specified as BB Configuration in IEC 62196-3.
+                OTHER shall be used if the vehicle has a charging connector, but not one of the connectors listed above.
+                For additional information see https://en.wikipedia.org/wiki/IEC_62196.
 
 Charging.ChargePortType:
+  deprecation: V4.3 - Replaced with Charging.ChargingPort.<SomeInstance>.SupportedInletTypes to allow multiple charging ports.
   datatype: string[]
   type: attribute
   allowed: [
@@ -372,6 +434,7 @@ Charging.ChargePortType:
                For additional information see https://en.wikipedia.org/wiki/IEC_62196.
 
 Charging.ChargePortPosition:
+  deprecation: V4.3 - Multiple charging ports are supported by instantiation of the branch Charging.ChargingPort. The label used in the instantiation refers to the position. For example, Charging.ChargingPort.<FRONT_LEFT>.
   datatype: string[]
   type: attribute
   allowed: ['FRONT_LEFT', 'FRONT_MIDDLE', 'FRONT_RIGHT',