Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Adding additional signals to TractionBattery branch #601

Merged
merged 1 commit into from
Jun 13, 2023
Merged
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
50 changes: 44 additions & 6 deletions spec/Powertrain/TractionBattery.vspec
Original file line number Diff line number Diff line change
Expand Up @@ -24,6 +24,13 @@ ProductionDate:
type: attribute
description: Production date of battery in ISO8601 format, e.g. YYYY-MM-DD.

ErrorCodes:
datatype: string[]
type: sensor
description: Current error codes related to the battery, if any.
comment: Error code format is not defined, it may be DTCs according to OBD II (SAE-J2012DA_201812)
standard ([P|C|B|U]XXXXX ) or any other format.

IsPowerConnected:
datatype: boolean
type: sensor
Expand Down Expand Up @@ -60,6 +67,12 @@ Temperature.Max:
unit: celsius
description: Current maximum temperature of the battery cells, i.e. temperature of the hottest cell.

Temperature.CellTemperature:
datatype: float[]
type: sensor
description: Array of cell temperatures. Length or array shall correspond to number of cells in vehicle.
comment: Cells are identified by relative position in array.

CellVoltage:
type: branch
description: Voltage information for cells in the battery pack.
Expand All @@ -70,12 +83,30 @@ CellVoltage.Min:
unit: V
description: Current voltage of the battery cell with lowest voltage.

CellVoltage.IdMin:
datatype: uint16
type: sensor
description: Identifier of the battery cell with lowest voltage.
comment: Identifier is supposed to be relative index of the cell, starting with 0 the first cell.

CellVoltage.Max:
datatype: float
type: sensor
unit: V
description: Current voltage of the battery cell with highest voltage.

CellVoltage.IdMax:
datatype: uint16
type: sensor
description: Identifier of the battery cell with highest voltage.
comment: Identifier is supposed to be relative index of the cell, starting with 0 the first cell.

CellVoltage.CellVoltages:
datatype: float[]
type: sensor
description: Array of cell voltages. Length or array shall correspond to number of cells in vehicle.
comment: Cells are identified by relative position in array.

GrossCapacity:
datatype: uint16
type: attribute
Expand All @@ -88,7 +119,6 @@ NetCapacity:
unit: kWh
description: Total net capacity of the battery considering aging.


StateOfHealth:
datatype: float
type: sensor
Expand Down Expand Up @@ -296,13 +326,21 @@ Charging.ChargePlugType:
Charging.Mode:
datatype: string
type: actuator
allowed: ['MANUAL', 'TIMER', 'GRID', 'PROFILE']
description: Control of the charge process.
allowed: ['DEACTIVATED', 'AUTOMATIC', 'TRIGGERED', 'TIMER', 'PROFILE', 'EXTERNAL_ENTITY', 'MANUAL', 'GRID']
description: Describes how the charging process is controlled.
DEACTIVATED means that charging and discharging is deactivated, nothing will happen if charger is connected.
AUTOMATIC means charging will be initiated as soon as charger is connected.
TRIGGERED means charging will be initiated when triggered by user.
TIMER means charging is timer-based.
PROFILE means charging is controlled by profile downloaded to vehicle.
EXTERNAL_ENTITY means charging/discharging is controlled by the external entity connected to the vehicle.
This includes GRID-controlled charging (e.g. ISO 15118), but also other cases where vehicle is
connected to an arbitrary load that is powered by the vehicle.
MANUAL means manually initiated (plug-in event, companion app, etc).
TIMER means timer-based.
GRID means grid-controlled (e.g. ISO 15118).
PROFILE means controlled by profile download to vehicle.
comment: The mechanism to provide a profile to the vehicle is currently not covered by VSS.
deprecation: V4.1 - MANUAL and GRID are deprecated, please use AUTOMATIC/TRIGGERED or EXTERNAL_ENITY instead.
Copy link
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Added MANUAL+GRID plus this deprecation text. Note that we here use the deprecation keyword in a somewhat new meaning as the signal itself is not deprecated but rather certain parts of it. We could alternatively just mention deprecation in free text

comment: EXTERNAL_ENTITY is the only mode where discharge may occur.
The mechanism to provide a profile to the vehicle is currently not covered by VSS.

Charging.IsCharging:
datatype: boolean
Expand Down