Commit | Line | Data |
---|---|---|
9ccca265 | 1 | import { MeterValueContext, MeterValueLocation, MeterValueUnit, OCPP16MeterValue, OCPP16MeterValueMeasurand, OCPP16MeterValuePhase, OCPP16SampledValue } from '../../../types/ocpp/1.6/MeterValues'; |
6ed92bc1 JB |
2 | |
3 | import ChargingStation from '../../ChargingStation'; | |
9ccca265 | 4 | import { SampledValueTemplate } from '../../../types/Connectors'; |
6ed92bc1 JB |
5 | import Utils from '../../../utils/Utils'; |
6 | import logger from '../../../utils/Logger'; | |
7 | ||
8 | export class OCPP16ServiceUtils { | |
9 | public static checkMeasurandPowerDivider(chargingStation: ChargingStation, measurandType: OCPP16MeterValueMeasurand): void { | |
10 | if (Utils.isUndefined(chargingStation.stationInfo.powerDivider)) { | |
11 | const errMsg = `${chargingStation.logPrefix()} MeterValues measurand ${measurandType ?? OCPP16MeterValueMeasurand.ENERGY_ACTIVE_IMPORT_REGISTER}: powerDivider is undefined`; | |
12 | logger.error(errMsg); | |
13 | throw Error(errMsg); | |
fd0c36fa | 14 | } else if (chargingStation.stationInfo?.powerDivider <= 0) { |
6ed92bc1 JB |
15 | const errMsg = `${chargingStation.logPrefix()} MeterValues measurand ${measurandType ?? OCPP16MeterValueMeasurand.ENERGY_ACTIVE_IMPORT_REGISTER}: powerDivider have zero or below value ${chargingStation.stationInfo.powerDivider}`; |
16 | logger.error(errMsg); | |
17 | throw Error(errMsg); | |
18 | } | |
19 | } | |
20 | ||
9ccca265 JB |
21 | public static buildSampledValue(sampledValueTemplate: SampledValueTemplate, value: number, context?: MeterValueContext, phase?: OCPP16MeterValuePhase): OCPP16SampledValue { |
22 | const sampledValueValue = value ?? (sampledValueTemplate.value ?? null); | |
6ed92bc1 | 23 | const sampledValueContext = context ?? (sampledValueTemplate.context ?? null); |
6e1221a3 | 24 | const sampledValueLocation = sampledValueTemplate.location ?? OCPP16ServiceUtils.getMeasurandDefaultLocation(sampledValueTemplate.measurand ?? null); |
6ed92bc1 JB |
25 | const sampledValuePhase = phase ?? (sampledValueTemplate.phase ?? null); |
26 | return { | |
27 | ...!Utils.isNullOrUndefined(sampledValueTemplate.unit) && { unit: sampledValueTemplate.unit }, | |
28 | ...!Utils.isNullOrUndefined(sampledValueContext) && { context: sampledValueContext }, | |
29 | ...!Utils.isNullOrUndefined(sampledValueTemplate.measurand) && { measurand: sampledValueTemplate.measurand }, | |
30 | ...!Utils.isNullOrUndefined(sampledValueLocation) && { location: sampledValueLocation }, | |
9ccca265 | 31 | ...!Utils.isNullOrUndefined(sampledValueValue) && { value: sampledValueValue.toString() }, |
6ed92bc1 JB |
32 | ...!Utils.isNullOrUndefined(sampledValuePhase) && { phase: sampledValuePhase }, |
33 | }; | |
34 | } | |
35 | ||
4a1857a2 | 36 | public static getMeasurandDefaultUnit(measurandType: OCPP16MeterValueMeasurand): MeterValueUnit | undefined { |
6ed92bc1 JB |
37 | switch (measurandType) { |
38 | case OCPP16MeterValueMeasurand.CURRENT_EXPORT: | |
39 | case OCPP16MeterValueMeasurand.CURRENT_IMPORT: | |
40 | case OCPP16MeterValueMeasurand.CURRENT_OFFERED: | |
41 | return MeterValueUnit.AMP; | |
42 | case OCPP16MeterValueMeasurand.ENERGY_ACTIVE_EXPORT_REGISTER: | |
43 | case OCPP16MeterValueMeasurand.ENERGY_ACTIVE_IMPORT_REGISTER: | |
44 | return MeterValueUnit.WATT_HOUR; | |
45 | case OCPP16MeterValueMeasurand.POWER_ACTIVE_EXPORT: | |
46 | case OCPP16MeterValueMeasurand.POWER_ACTIVE_IMPORT: | |
47 | case OCPP16MeterValueMeasurand.POWER_OFFERED: | |
48 | return MeterValueUnit.WATT; | |
49 | case OCPP16MeterValueMeasurand.STATE_OF_CHARGE: | |
50 | return MeterValueUnit.PERCENT; | |
51 | case OCPP16MeterValueMeasurand.VOLTAGE: | |
52 | return MeterValueUnit.VOLT; | |
53 | } | |
54 | } | |
55 | ||
4a1857a2 | 56 | public static getMeasurandDefaultLocation(measurandType: OCPP16MeterValueMeasurand): MeterValueLocation | undefined { |
6ed92bc1 JB |
57 | switch (measurandType) { |
58 | case OCPP16MeterValueMeasurand.STATE_OF_CHARGE: | |
59 | return MeterValueLocation.EV; | |
60 | } | |
61 | } | |
fd0c36fa JB |
62 | |
63 | public static buildTransactionBeginMeterValue(chargingStation: ChargingStation, connectorId: number, meterBegin: number): OCPP16MeterValue { | |
64 | const meterValue: OCPP16MeterValue = { | |
65 | timestamp: new Date().toISOString(), | |
66 | sampledValue: [], | |
67 | }; | |
9ccca265 JB |
68 | // Energy.Active.Import.Register measurand (default) |
69 | const sampledValueTemplate = chargingStation.getSampledValueTemplate(connectorId); | |
70 | const unitDivider = sampledValueTemplate?.unit === MeterValueUnit.KILO_WATT_HOUR ? 1000 : 1; | |
71 | meterValue.sampledValue.push(OCPP16ServiceUtils.buildSampledValue(sampledValueTemplate, Utils.roundTo(meterBegin / unitDivider, 4), MeterValueContext.TRANSACTION_BEGIN)); | |
fd0c36fa JB |
72 | return meterValue; |
73 | } | |
74 | ||
75 | public static buildTransactionEndMeterValue(chargingStation: ChargingStation, connectorId: number, meterEnd: number): OCPP16MeterValue { | |
76 | const meterValue: OCPP16MeterValue = { | |
77 | timestamp: new Date().toISOString(), | |
78 | sampledValue: [], | |
79 | }; | |
9ccca265 JB |
80 | // Energy.Active.Import.Register measurand (default) |
81 | const sampledValueTemplate = chargingStation.getSampledValueTemplate(connectorId); | |
82 | const unitDivider = sampledValueTemplate?.unit === MeterValueUnit.KILO_WATT_HOUR ? 1000 : 1; | |
83 | meterValue.sampledValue.push(OCPP16ServiceUtils.buildSampledValue(sampledValueTemplate, Utils.roundTo(meterEnd / unitDivider, 4), MeterValueContext.TRANSACTION_END)); | |
fd0c36fa JB |
84 | return meterValue; |
85 | } | |
86 | ||
87 | public static buildTransactionDataMeterValues(transactionBeginMeterValue: OCPP16MeterValue, transactionEndMeterValue: OCPP16MeterValue): OCPP16MeterValue[] { | |
88 | const meterValues: OCPP16MeterValue[] = []; | |
89 | meterValues.push(transactionBeginMeterValue); | |
90 | meterValues.push(transactionEndMeterValue); | |
91 | return meterValues; | |
92 | } | |
6ed92bc1 | 93 | } |