Skip to main content

Module datatypes

Module datatypes 

Source
Expand description

OCPP 2.1 composite datatypes.

Structs§

ACChargingParameters
EV AC charging parameters for ISO 15118-2
APN
Collection of configuration data needed to make a data-connection over a cellular network. NOTE: When asking a GSM modem to dial in, it is possible to specify which mobile operator should be used. This can be done with the mobile country code (MCC) in combination with a mobile network code (MNC). Example: If your preferred network is Vodafone Netherlands, the MCC=204 and the MNC=04 which means the key PreferredNetwork = 20404 Some modems allows to specify a preferred network, which means, if this network is not available, a different network is used. If you specify UseOnlyPreferredNetwork and this network is not available, the modem will not dial in.
AbsolutePriceSchedule
The AbsolutePriceScheduleType is modeled after the same type that is defined in ISO 15118-20, such that if it is supplied by an EMSP as a signed EXI message, the conversion from EXI to JSON (in OCPP) and back to EXI (for ISO 15118-20) does not change the digest and therefore does not invalidate the signature. image::images/AbsolutePriceSchedule-Simple.png[]
AdditionalInfo
Contains a case insensitive identifier to use for the authorization and the type of authorization to support multiple forms of identifiers.
AdditionalSelectedServices
Part of ISO 15118-20 price schedule.
Address
(2.1) A generic address format.
AuthorizationData
Contains the identifier to use for authorization.
BatteryData
CertificateHashData
CertificateHashDataChain
CertificateStatus
Revocation status of certificate
CertificateStatusRequestInfo
Data necessary to request the revocation status of a certificate.
ChargingLimit
ChargingNeeds
ChargingPeriod
A ChargingPeriodType consists of a start time, and a list of possible values that influence this period, for example: amount of energy charged this period, maximum current during this period etc.
ChargingProfile
A ChargingProfile consists of 1 to 3 ChargingSchedules with a list of ChargingSchedulePeriods, describing the amount of power or current that can be delivered per time interval. image::images/ChargingProfile-Simple.png[]
ChargingProfileCriterion
A ChargingProfileCriterionType is a filter for charging profiles to be selected by a GetChargingProfilesRequest.
ChargingSchedule
Charging schedule structure defines a list of charging periods, as used in: NotifyEVChargingScheduleRequest and ChargingProfileType. When used in a NotifyEVChargingScheduleRequest only duration and chargingSchedulePeriod are relevant and chargingRateUnit must be ‘W’. + An ISO 15118-20 session may provide either an absolutePriceSchedule or a priceLevelSchedule. An ISO 15118-2 session can only provide a_salesTariff_ element. The field digestValue is used when price schedule or sales tariff are signed. image::images/ChargingSchedule-Simple.png[]
ChargingSchedulePeriod
Charging schedule period structure defines a time period in a charging schedule. It is used in: CompositeScheduleType and in ChargingScheduleType. When used in a NotifyEVChargingScheduleRequest only startPeriod, limit, limit_L2, limit_L3 are relevant.
ChargingScheduleUpdate
Updates to a ChargingSchedulePeriodType for dynamic charging profiles.
ChargingStation
The physical system where an Electrical Vehicle (EV) can be charged.
ClearChargingProfile
A ClearChargingProfileType is a filter for charging profiles to be cleared by ClearChargingProfileRequest.
ClearMonitoringResult
ClearTariffsResult
Component
A physical or logical component
ComponentVariable
Class to report components, variables and variable attributes and characteristics.
CompositeSchedule
ConstantStreamData
ConsumptionCost
Cost
CostDetails
CostDetailsType contains the cost as calculated by Charging Station based on provided TariffType. NOTE: Reservation is not shown as a chargingPeriod, because it took place outside of the transaction.
CostDimension
Volume consumed of cost dimension.
CustomData
This class does not get ‘AdditionalProperties = false’ in the schema generation, so it can be extended with arbitrary JSON properties to allow adding custom data.
DCChargingParameters
EV DC charging parameters for ISO 15118-2
DERChargingParameters
(2.1) DERChargingParametersType is used in ChargingNeedsType during an ISO 15118-20 session for AC_BPT_DER to report the inverter settings related to DER control that were agreed between EVSE and EV. Fields starting with “ev” contain values from the EV. Other fields contain a value that is supported by both EV and EVSE. DERChargingParametersType type is only relevant in case of an ISO 15118-20 AC_BPT_DER/AC_DER charging session. NOTE: All these fields have values greater or equal to zero (i.e. are non-negative)
DERCurve
DERCurveGet
DERCurvePoints
EVAbsolutePriceSchedule
(2.1) Price schedule of EV energy offer.
EVAbsolutePriceScheduleEntry
(2.1) An entry in price schedule over time for which EV is willing to discharge.
EVEnergyOffer
(2.1) A schedule of the energy amount over time that EV is willing to discharge. A negative value indicates the willingness to discharge under specific conditions, a positive value indicates that the EV currently is not able to offer energy to discharge.
EVPowerSchedule
(2.1) Schedule of EV energy offer.
EVPowerScheduleEntry
(2.1) An entry in schedule of the energy amount over time that EV is willing to discharge. A negative value indicates the willingness to discharge under specific conditions, a positive value indicates that the EV currently is not able to offer energy to discharge.
EVPriceRule
(2.1) An entry in price schedule over time for which EV is willing to discharge.
EVSE
Electric Vehicle Supply Equipment
EnterService
EnterServiceGet
EventData
Class to report an event notification for a component-variable.
Firmware
Represents a copy of the firmware that can be loaded/updated on the Charging Station.
FixedPF
FixedPFGet
FixedVar
FixedVarGet
FreqDroop
FreqDroopGet
GetVariableData
Class to hold parameters for GetVariables request.
GetVariableResult
Class to hold results of GetVariables request.
Gradient
GradientGet
Hysteresis
IdToken
Contains a case insensitive identifier to use for the authorization and the type of authorization to support multiple forms of identifiers.
IdTokenInfo
Contains status information about an identifier. It is advised to not stop charging for a token that expires during charging, as ExpiryDate is only used for caching purposes. If ExpiryDate is not given, the status has no end date.
LimitAtSoC
LimitMaxDischarge
LimitMaxDischargeGet
LogParameters
Generic class for the configuration of logging entries.
MessageContent
Contains message details, for a message to be displayed on a Charging Station.
MessageInfo
Contains message details, for a message to be displayed on a Charging Station.
MeterValue
Collection of one or more sampled values in MeterValuesRequest and TransactionEvent. All sampled values in a MeterValue are sampled at the same point in time.
Modem
Defines parameters required for initiating and maintaining wireless communication with other devices.
MonitoringData
Class to hold parameters of SetVariableMonitoring request.
NetworkConnectionProfile
The NetworkConnectionProfile defines the functional and technical parameters of a communication link.
OCSPRequestData
Information about a certificate for an OCSP check.
OverstayRule
Part of ISO 15118-20 price schedule.
OverstayRuleList
Part of ISO 15118-20 price schedule.
PeriodicEventStreamParams
Price
Price with and without tax. At least one of exclTax, inclTax must be present.
PriceLevelSchedule
The PriceLevelScheduleType is modeled after the same type that is defined in ISO 15118-20, such that if it is supplied by an EMSP as a signed EXI message, the conversion from EXI to JSON (in OCPP) and back to EXI (for ISO 15118-20) does not change the digest and therefore does not invalidate the signature.
PriceLevelScheduleEntry
Part of ISO 15118-20 price schedule.
PriceRule
Part of ISO 15118-20 price schedule.
PriceRuleStack
Part of ISO 15118-20 price schedule.
RationalNumber
Part of ISO 15118-20 price schedule.
ReactivePowerParams
RelativeTimeInterval
ReportData
Class to report components, variables and variable attributes and characteristics.
SalesTariff
A SalesTariff provided by a Mobility Operator (EMSP) . NOTE: This dataType is based on dataTypes from <<ref-ISOIEC15118-2,ISO 15118-2>>.
SalesTariffEntry
SampledValue
Single sampled value in MeterValues. Each value can be accompanied by optional fields. To save on mobile data usage, default values of all of the optional fields are such that. The value without any additional fields will be interpreted, as a register reading of active import energy in Wh (Watt-hour) units.
SetMonitoringData
Class to hold parameters of SetVariableMonitoring request.
SetMonitoringResult
Class to hold result of SetVariableMonitoring request.
SetVariableData
SetVariableResult
SignedMeterValue
Represent a signed version of the meter value.
StatusInfo
Element providing more information about the status.
StreamDataElement
Tariff
A tariff is described by fields with prices for: energy, charging time, idle time, fixed fee, reservation time, reservation fixed fee. + Each of these fields may have (optional) conditions that specify when a price is applicable. + The description contains a human-readable explanation of the tariff to be shown to the user. + The other fields are parameters that define the tariff. These are used by the charging station to calculate the price.
TariffAssignment
Shows assignment of tariffs to EVSE or IdToken.
TariffConditions
These conditions describe if and when a TariffEnergyType or TariffTimeType applies during a transaction. When more than one restriction is set, they are to be treated as a logical AND. All need to be valid before this price is active. For reverse energy flow (discharging) negative values of energy, power and current are used. NOTE: minXXX (where XXX = Kwh/A/Kw) must be read as “closest to zero”, and maxXXX as “furthest from zero”. For example, a charging power range from 10 kW to 50 kWh is given by minPower = 10000 and maxPower = 50000, and a discharging power range from -10 kW to -50 kW is given by minPower = -10 and maxPower = -50. NOTE: startTimeOfDay and endTimeOfDay are in local time, because it is the time in the tariff as it is shown to the EV driver at the Charging Station. A Charging Station will convert this to the internal time zone that it uses (which is recommended to be UTC, see section Generic chapter 3.1) when performing cost calculation.
TariffConditionsFixed
These conditions describe if a FixedPrice applies at start of the transaction. When more than one restriction is set, they are to be treated as a logical AND. All need to be valid before this price is active. NOTE: startTimeOfDay and endTimeOfDay are in local time, because it is the time in the tariff as it is shown to the EV driver at the Charging Station. A Charging Station will convert this to the internal time zone that it uses (which is recommended to be UTC, see section Generic chapter 3.1) when performing cost calculation.
TariffEnergy
Price elements and tax for energy
TariffEnergyPrice
Tariff with optional conditions for an energy price.
TariffFixed
TariffFixedPrice
Tariff with optional conditions for a fixed price.
TariffTime
Price elements and tax for time
TariffTimePrice
Tariff with optional conditions for a time duration price.
TaxRate
Tax percentage
TaxRule
Part of ISO 15118-20 price schedule.
TotalCost
This contains the cost calculated during a transaction. It is used both for running cost and final cost of the transaction.
TotalPrice
Total cost with and without tax. Contains the total of energy, charging time, idle time, fixed and reservation costs including and/or excluding tax.
TotalUsage
This contains the calculated usage of energy, charging time and idle time during a transaction.
Transaction
TransactionLimit
Cost, energy, time or SoC limit for a transaction.
UnitOfMeasure
Represents a UnitOfMeasure with a multiplier
V2XChargingParameters
Charging parameters for ISO 15118-20, also supporting V2X charging/discharging.+ All values are greater or equal to zero, with the exception of EVMinEnergyRequest, EVMaxEnergyRequest, EVTargetEnergyRequest, EVMinV2XEnergyRequest and EVMaxV2XEnergyRequest.
V2XFreqWattPoint
(2.1) A point of a frequency-watt curve.
V2XSignalWattPoint
(2.1) A point of a signal-watt curve.
VPN
VPN Configuration settings
Variable
Reference key to a component-variable.
VariableAttribute
Attribute data of a variable.
VariableCharacteristics
Fixed read-only parameters of a variable.
VariableMonitoring
A monitoring setting for a variable.
VoltageParams