Strong type protocols payloads
[e-mobility-charging-stations-simulator.git] / src / charging-station / ocpp / 1.6 / OCPP16RequestService.ts
... / ...
CommitLineData
1// Partial Copyright Jerome Benoit. 2021. All Rights Reserved.
2
3import { ACElectricUtils, DCElectricUtils } from '../../../utils/ElectricUtils';
4import { AuthorizeRequest, OCPP16AuthorizeResponse, OCPP16StartTransactionResponse, OCPP16StopTransactionReason, OCPP16StopTransactionResponse, StartTransactionRequest, StopTransactionRequest } from '../../../types/ocpp/1.6/Transaction';
5import { CurrentType, Voltage } from '../../../types/ChargingStationTemplate';
6import { DiagnosticsStatusNotificationRequest, HeartbeatRequest, OCPP16BootNotificationRequest, OCPP16IncomingRequestCommand, OCPP16RequestCommand, StatusNotificationRequest } from '../../../types/ocpp/1.6/Requests';
7import { MeterValueUnit, MeterValuesRequest, OCPP16MeterValue, OCPP16MeterValueMeasurand, OCPP16MeterValuePhase } from '../../../types/ocpp/1.6/MeterValues';
8
9import Constants from '../../../utils/Constants';
10import { ErrorType } from '../../../types/ocpp/ErrorType';
11import { JsonType } from '../../../types/JsonType';
12import MeasurandPerPhaseSampledValueTemplates from '../../../types/MeasurandPerPhaseSampledValueTemplates';
13import MeasurandValues from '../../../types/MeasurandValues';
14import { MessageType } from '../../../types/ocpp/MessageType';
15import { OCPP16BootNotificationResponse } from '../../../types/ocpp/1.6/Responses';
16import { OCPP16ChargePointErrorCode } from '../../../types/ocpp/1.6/ChargePointErrorCode';
17import { OCPP16ChargePointStatus } from '../../../types/ocpp/1.6/ChargePointStatus';
18import { OCPP16DiagnosticsStatus } from '../../../types/ocpp/1.6/DiagnosticsStatus';
19import { OCPP16ServiceUtils } from './OCPP16ServiceUtils';
20import OCPPError from '../../../exception/OCPPError';
21import OCPPRequestService from '../OCPPRequestService';
22import { SendParams } from '../../../types/ocpp/Requests';
23import Utils from '../../../utils/Utils';
24import logger from '../../../utils/Logger';
25
26export default class OCPP16RequestService extends OCPPRequestService {
27 public async sendHeartbeat(params?: SendParams): Promise<void> {
28 try {
29 const payload: HeartbeatRequest = {};
30 await this.sendMessage(Utils.generateUUID(), payload, MessageType.CALL_MESSAGE, OCPP16RequestCommand.HEARTBEAT, params);
31 } catch (error) {
32 this.handleRequestError(OCPP16RequestCommand.HEARTBEAT, error as Error);
33 }
34 }
35
36 public async sendBootNotification(chargePointModel: string, chargePointVendor: string, chargeBoxSerialNumber?: string, firmwareVersion?: string,
37 chargePointSerialNumber?: string, iccid?: string, imsi?: string, meterSerialNumber?: string, meterType?: string,
38 params?: SendParams): Promise<OCPP16BootNotificationResponse> {
39 try {
40 const payload: OCPP16BootNotificationRequest = {
41 chargePointModel,
42 chargePointVendor,
43 ...!Utils.isUndefined(chargeBoxSerialNumber) && { chargeBoxSerialNumber },
44 ...!Utils.isUndefined(chargePointSerialNumber) && { chargePointSerialNumber },
45 ...!Utils.isUndefined(firmwareVersion) && { firmwareVersion },
46 ...!Utils.isUndefined(iccid) && { iccid },
47 ...!Utils.isUndefined(imsi) && { imsi },
48 ...!Utils.isUndefined(meterSerialNumber) && { meterSerialNumber },
49 ...!Utils.isUndefined(meterType) && { meterType }
50 };
51 return await this.sendMessage(Utils.generateUUID(), payload, MessageType.CALL_MESSAGE,
52 OCPP16RequestCommand.BOOT_NOTIFICATION, { ...params, skipBufferingOnError: true }) as OCPP16BootNotificationResponse;
53 } catch (error) {
54 this.handleRequestError(OCPP16RequestCommand.BOOT_NOTIFICATION, error as Error);
55 }
56 }
57
58 public async sendStatusNotification(connectorId: number, status: OCPP16ChargePointStatus,
59 errorCode: OCPP16ChargePointErrorCode = OCPP16ChargePointErrorCode.NO_ERROR): Promise<void> {
60 try {
61 const payload: StatusNotificationRequest = {
62 connectorId,
63 errorCode,
64 status,
65 };
66 await this.sendMessage(Utils.generateUUID(), payload, MessageType.CALL_MESSAGE, OCPP16RequestCommand.STATUS_NOTIFICATION);
67 } catch (error) {
68 this.handleRequestError(OCPP16RequestCommand.STATUS_NOTIFICATION, error as Error);
69 }
70 }
71
72 public async sendAuthorize(connectorId: number, idTag?: string): Promise<OCPP16AuthorizeResponse> {
73 try {
74 const payload: AuthorizeRequest = {
75 ...!Utils.isUndefined(idTag) ? { idTag } : { idTag: Constants.TRANSACTION_DEFAULT_IDTAG },
76 };
77 this.chargingStation.getConnectorStatus(connectorId).authorizeIdTag = idTag;
78 return await this.sendMessage(Utils.generateUUID(), payload, MessageType.CALL_MESSAGE, OCPP16RequestCommand.AUTHORIZE) as OCPP16AuthorizeResponse;
79 } catch (error) {
80 this.handleRequestError(OCPP16RequestCommand.AUTHORIZE, error as Error);
81 }
82 }
83
84 public async sendStartTransaction(connectorId: number, idTag?: string): Promise<OCPP16StartTransactionResponse> {
85 try {
86 const payload: StartTransactionRequest = {
87 connectorId,
88 ...!Utils.isUndefined(idTag) ? { idTag } : { idTag: Constants.TRANSACTION_DEFAULT_IDTAG },
89 meterStart: this.chargingStation.getEnergyActiveImportRegisterByConnectorId(connectorId),
90 timestamp: new Date().toISOString(),
91 };
92 return await this.sendMessage(Utils.generateUUID(), payload, MessageType.CALL_MESSAGE, OCPP16RequestCommand.START_TRANSACTION) as OCPP16StartTransactionResponse;
93 } catch (error) {
94 this.handleRequestError(OCPP16RequestCommand.START_TRANSACTION, error as Error);
95 }
96 }
97
98 public async sendStopTransaction(transactionId: number, meterStop: number, idTag?: string,
99 reason: OCPP16StopTransactionReason = OCPP16StopTransactionReason.NONE): Promise<OCPP16StopTransactionResponse> {
100 try {
101 let connectorId: number;
102 for (const id of this.chargingStation.connectors.keys()) {
103 if (id > 0 && this.chargingStation.getConnectorStatus(id)?.transactionId === transactionId) {
104 connectorId = id;
105 break;
106 }
107 }
108 const transactionEndMeterValue = OCPP16ServiceUtils.buildTransactionEndMeterValue(this.chargingStation, connectorId, meterStop);
109 // FIXME: should be a callback, each OCPP commands implementation must do only one job
110 (this.chargingStation.getBeginEndMeterValues() && !this.chargingStation.getOutOfOrderEndMeterValues())
111 && await this.sendTransactionEndMeterValues(connectorId, transactionId, transactionEndMeterValue);
112 const payload: StopTransactionRequest = {
113 transactionId,
114 ...!Utils.isUndefined(idTag) && { idTag },
115 meterStop,
116 timestamp: new Date().toISOString(),
117 ...reason && { reason },
118 ...this.chargingStation.getTransactionDataMeterValues() && { transactionData: OCPP16ServiceUtils.buildTransactionDataMeterValues(this.chargingStation.getConnectorStatus(connectorId).transactionBeginMeterValue, transactionEndMeterValue) },
119 };
120 return await this.sendMessage(Utils.generateUUID(), payload, MessageType.CALL_MESSAGE, OCPP16RequestCommand.STOP_TRANSACTION) as OCPP16StartTransactionResponse;
121 } catch (error) {
122 this.handleRequestError(OCPP16RequestCommand.STOP_TRANSACTION, error as Error);
123 }
124 }
125
126 public async sendMeterValues(connectorId: number, transactionId: number, interval: number, debug = false): Promise<void> {
127 try {
128 const meterValue: OCPP16MeterValue = {
129 timestamp: new Date().toISOString(),
130 sampledValue: [],
131 };
132 const connector = this.chargingStation.getConnectorStatus(connectorId);
133 // SoC measurand
134 const socSampledValueTemplate = this.chargingStation.getSampledValueTemplate(connectorId, OCPP16MeterValueMeasurand.STATE_OF_CHARGE);
135 if (socSampledValueTemplate) {
136 const socSampledValueTemplateValue = socSampledValueTemplate.value
137 ? Utils.getRandomFloatFluctuatedRounded(parseInt(socSampledValueTemplate.value), socSampledValueTemplate.fluctuationPercent ?? Constants.DEFAULT_FLUCTUATION_PERCENT)
138 : Utils.getRandomInteger(100);
139 meterValue.sampledValue.push(OCPP16ServiceUtils.buildSampledValue(socSampledValueTemplate, socSampledValueTemplateValue));
140 const sampledValuesIndex = meterValue.sampledValue.length - 1;
141 if (Utils.convertToInt(meterValue.sampledValue[sampledValuesIndex].value) > 100 || debug) {
142 logger.error(`${this.chargingStation.logPrefix()} MeterValues measurand ${meterValue.sampledValue[sampledValuesIndex].measurand ?? OCPP16MeterValueMeasurand.ENERGY_ACTIVE_IMPORT_REGISTER}: connectorId ${connectorId}, transaction ${connector.transactionId}, value: ${meterValue.sampledValue[sampledValuesIndex].value}/100`);
143 }
144 }
145 // Voltage measurand
146 const voltageSampledValueTemplate = this.chargingStation.getSampledValueTemplate(connectorId, OCPP16MeterValueMeasurand.VOLTAGE);
147 if (voltageSampledValueTemplate) {
148 const voltageSampledValueTemplateValue = voltageSampledValueTemplate.value ? parseInt(voltageSampledValueTemplate.value) : this.chargingStation.getVoltageOut();
149 const fluctuationPercent = voltageSampledValueTemplate.fluctuationPercent ?? Constants.DEFAULT_FLUCTUATION_PERCENT;
150 const voltageMeasurandValue = Utils.getRandomFloatFluctuatedRounded(voltageSampledValueTemplateValue, fluctuationPercent);
151 if (this.chargingStation.getNumberOfPhases() !== 3 || (this.chargingStation.getNumberOfPhases() === 3 && this.chargingStation.getMainVoltageMeterValues())) {
152 meterValue.sampledValue.push(OCPP16ServiceUtils.buildSampledValue(voltageSampledValueTemplate, voltageMeasurandValue));
153 }
154 for (let phase = 1; this.chargingStation.getNumberOfPhases() === 3 && phase <= this.chargingStation.getNumberOfPhases(); phase++) {
155 const phaseLineToNeutralValue = `L${phase}-N`;
156 const voltagePhaseLineToNeutralSampledValueTemplate = this.chargingStation.getSampledValueTemplate(connectorId, OCPP16MeterValueMeasurand.VOLTAGE,
157 phaseLineToNeutralValue as OCPP16MeterValuePhase);
158 let voltagePhaseLineToNeutralMeasurandValue: number;
159 if (voltagePhaseLineToNeutralSampledValueTemplate) {
160 const voltagePhaseLineToNeutralSampledValueTemplateValue = voltagePhaseLineToNeutralSampledValueTemplate.value ? parseInt(voltagePhaseLineToNeutralSampledValueTemplate.value) : this.chargingStation.getVoltageOut();
161 const fluctuationPhaseToNeutralPercent = voltagePhaseLineToNeutralSampledValueTemplate.fluctuationPercent ?? Constants.DEFAULT_FLUCTUATION_PERCENT;
162 voltagePhaseLineToNeutralMeasurandValue = Utils.getRandomFloatFluctuatedRounded(voltagePhaseLineToNeutralSampledValueTemplateValue, fluctuationPhaseToNeutralPercent);
163 }
164 meterValue.sampledValue.push(OCPP16ServiceUtils.buildSampledValue(voltagePhaseLineToNeutralSampledValueTemplate ?? voltageSampledValueTemplate,
165 voltagePhaseLineToNeutralMeasurandValue ?? voltageMeasurandValue, null, phaseLineToNeutralValue as OCPP16MeterValuePhase));
166 if (this.chargingStation.getPhaseLineToLineVoltageMeterValues()) {
167 const phaseLineToLineValue = `L${phase}-L${(phase + 1) % this.chargingStation.getNumberOfPhases() !== 0 ? (phase + 1) % this.chargingStation.getNumberOfPhases() : this.chargingStation.getNumberOfPhases()}`;
168 const voltagePhaseLineToLineSampledValueTemplate = this.chargingStation.getSampledValueTemplate(connectorId, OCPP16MeterValueMeasurand.VOLTAGE, phaseLineToLineValue as OCPP16MeterValuePhase);
169 let voltagePhaseLineToLineMeasurandValue: number;
170 if (voltagePhaseLineToLineSampledValueTemplate) {
171 const voltagePhaseLineToLineSampledValueTemplateValue = voltagePhaseLineToLineSampledValueTemplate.value ? parseInt(voltagePhaseLineToLineSampledValueTemplate.value) : Voltage.VOLTAGE_400;
172 const fluctuationPhaseLineToLinePercent = voltagePhaseLineToLineSampledValueTemplate.fluctuationPercent ?? Constants.DEFAULT_FLUCTUATION_PERCENT;
173 voltagePhaseLineToLineMeasurandValue = Utils.getRandomFloatFluctuatedRounded(voltagePhaseLineToLineSampledValueTemplateValue, fluctuationPhaseLineToLinePercent);
174 }
175 const defaultVoltagePhaseLineToLineMeasurandValue = Utils.getRandomFloatFluctuatedRounded(Voltage.VOLTAGE_400, fluctuationPercent);
176 meterValue.sampledValue.push(OCPP16ServiceUtils.buildSampledValue(voltagePhaseLineToLineSampledValueTemplate ?? voltageSampledValueTemplate,
177 voltagePhaseLineToLineMeasurandValue ?? defaultVoltagePhaseLineToLineMeasurandValue, null, phaseLineToLineValue as OCPP16MeterValuePhase));
178 }
179 }
180 }
181 // Power.Active.Import measurand
182 const powerSampledValueTemplate = this.chargingStation.getSampledValueTemplate(connectorId, OCPP16MeterValueMeasurand.POWER_ACTIVE_IMPORT);
183 let powerPerPhaseSampledValueTemplates: MeasurandPerPhaseSampledValueTemplates = {};
184 if (this.chargingStation.getNumberOfPhases() === 3) {
185 powerPerPhaseSampledValueTemplates = {
186 L1: this.chargingStation.getSampledValueTemplate(connectorId, OCPP16MeterValueMeasurand.POWER_ACTIVE_IMPORT, OCPP16MeterValuePhase.L1_N),
187 L2: this.chargingStation.getSampledValueTemplate(connectorId, OCPP16MeterValueMeasurand.POWER_ACTIVE_IMPORT, OCPP16MeterValuePhase.L2_N),
188 L3: this.chargingStation.getSampledValueTemplate(connectorId, OCPP16MeterValueMeasurand.POWER_ACTIVE_IMPORT, OCPP16MeterValuePhase.L3_N),
189 };
190 }
191 if (powerSampledValueTemplate) {
192 OCPP16ServiceUtils.checkMeasurandPowerDivider(this.chargingStation, powerSampledValueTemplate.measurand);
193 const errMsg = `${this.chargingStation.logPrefix()} MeterValues measurand ${powerSampledValueTemplate.measurand ?? OCPP16MeterValueMeasurand.ENERGY_ACTIVE_IMPORT_REGISTER}: Unknown ${this.chargingStation.getCurrentOutType()} currentOutType in template file ${this.chargingStation.stationTemplateFile}, cannot calculate ${powerSampledValueTemplate.measurand ?? OCPP16MeterValueMeasurand.ENERGY_ACTIVE_IMPORT_REGISTER} measurand value`;
194 const powerMeasurandValues = {} as MeasurandValues;
195 const unitDivider = powerSampledValueTemplate?.unit === MeterValueUnit.KILO_WATT ? 1000 : 1;
196 const maxPower = Math.round(this.chargingStation.stationInfo.maxPower / this.chargingStation.stationInfo.powerDivider);
197 const maxPowerPerPhase = Math.round((this.chargingStation.stationInfo.maxPower / this.chargingStation.stationInfo.powerDivider) / this.chargingStation.getNumberOfPhases());
198 switch (this.chargingStation.getCurrentOutType()) {
199 case CurrentType.AC:
200 if (this.chargingStation.getNumberOfPhases() === 3) {
201 const defaultFluctuatedPowerPerPhase = powerSampledValueTemplate.value
202 && Utils.getRandomFloatFluctuatedRounded(parseInt(powerSampledValueTemplate.value) / this.chargingStation.getNumberOfPhases(), powerSampledValueTemplate.fluctuationPercent ?? Constants.DEFAULT_FLUCTUATION_PERCENT);
203 const phase1FluctuatedValue = powerPerPhaseSampledValueTemplates?.L1?.value
204 && Utils.getRandomFloatFluctuatedRounded(parseInt(powerPerPhaseSampledValueTemplates.L1.value), powerPerPhaseSampledValueTemplates.L1.fluctuationPercent ?? Constants.DEFAULT_FLUCTUATION_PERCENT);
205 const phase2FluctuatedValue = powerPerPhaseSampledValueTemplates?.L2?.value
206 && Utils.getRandomFloatFluctuatedRounded(parseInt(powerPerPhaseSampledValueTemplates.L2.value), powerPerPhaseSampledValueTemplates.L2.fluctuationPercent ?? Constants.DEFAULT_FLUCTUATION_PERCENT);
207 const phase3FluctuatedValue = powerPerPhaseSampledValueTemplates?.L3?.value
208 && Utils.getRandomFloatFluctuatedRounded(parseInt(powerPerPhaseSampledValueTemplates.L3.value), powerPerPhaseSampledValueTemplates.L3.fluctuationPercent ?? Constants.DEFAULT_FLUCTUATION_PERCENT);
209 powerMeasurandValues.L1 = (phase1FluctuatedValue ?? defaultFluctuatedPowerPerPhase) ?? Utils.getRandomFloatRounded(maxPowerPerPhase / unitDivider);
210 powerMeasurandValues.L2 = (phase2FluctuatedValue ?? defaultFluctuatedPowerPerPhase) ?? Utils.getRandomFloatRounded(maxPowerPerPhase / unitDivider);
211 powerMeasurandValues.L3 = (phase3FluctuatedValue ?? defaultFluctuatedPowerPerPhase) ?? Utils.getRandomFloatRounded(maxPowerPerPhase / unitDivider);
212 } else {
213 powerMeasurandValues.L1 = powerSampledValueTemplate.value
214 ? Utils.getRandomFloatFluctuatedRounded(parseInt(powerSampledValueTemplate.value), powerSampledValueTemplate.fluctuationPercent ?? Constants.DEFAULT_FLUCTUATION_PERCENT)
215 : Utils.getRandomFloatRounded(maxPower / unitDivider);
216 powerMeasurandValues.L2 = 0;
217 powerMeasurandValues.L3 = 0;
218 }
219 powerMeasurandValues.allPhases = Utils.roundTo(powerMeasurandValues.L1 + powerMeasurandValues.L2 + powerMeasurandValues.L3, 2);
220 break;
221 case CurrentType.DC:
222 powerMeasurandValues.allPhases = powerSampledValueTemplate.value
223 ? Utils.getRandomFloatFluctuatedRounded(parseInt(powerSampledValueTemplate.value), powerSampledValueTemplate.fluctuationPercent ?? Constants.DEFAULT_FLUCTUATION_PERCENT)
224 : Utils.getRandomFloatRounded(maxPower / unitDivider);
225 break;
226 default:
227 logger.error(errMsg);
228 throw new OCPPError(ErrorType.INTERNAL_ERROR, errMsg, OCPP16RequestCommand.METER_VALUES);
229 }
230 meterValue.sampledValue.push(OCPP16ServiceUtils.buildSampledValue(powerSampledValueTemplate, powerMeasurandValues.allPhases));
231 const sampledValuesIndex = meterValue.sampledValue.length - 1;
232 const maxPowerRounded = Utils.roundTo(maxPower / unitDivider, 2);
233 if (Utils.convertToFloat(meterValue.sampledValue[sampledValuesIndex].value) > maxPowerRounded || debug) {
234 logger.error(`${this.chargingStation.logPrefix()} MeterValues measurand ${meterValue.sampledValue[sampledValuesIndex].measurand ?? OCPP16MeterValueMeasurand.ENERGY_ACTIVE_IMPORT_REGISTER}: connectorId ${connectorId}, transaction ${connector.transactionId}, value: ${meterValue.sampledValue[sampledValuesIndex].value}/${maxPowerRounded}`);
235 }
236 for (let phase = 1; this.chargingStation.getNumberOfPhases() === 3 && phase <= this.chargingStation.getNumberOfPhases(); phase++) {
237 const phaseValue = `L${phase}-N`;
238 meterValue.sampledValue.push(OCPP16ServiceUtils.buildSampledValue(powerPerPhaseSampledValueTemplates[`L${phase}`] ?? powerSampledValueTemplate, powerMeasurandValues[`L${phase}`], null,
239 phaseValue as OCPP16MeterValuePhase));
240 const sampledValuesPerPhaseIndex = meterValue.sampledValue.length - 1;
241 const maxPowerPerPhaseRounded = Utils.roundTo(maxPowerPerPhase / unitDivider, 2);
242 if (Utils.convertToFloat(meterValue.sampledValue[sampledValuesPerPhaseIndex].value) > maxPowerPerPhaseRounded || debug) {
243 logger.error(`${this.chargingStation.logPrefix()} MeterValues measurand ${meterValue.sampledValue[sampledValuesPerPhaseIndex].measurand ?? OCPP16MeterValueMeasurand.ENERGY_ACTIVE_IMPORT_REGISTER}: phase ${meterValue.sampledValue[sampledValuesPerPhaseIndex].phase}, connectorId ${connectorId}, transaction ${connector.transactionId}, value: ${meterValue.sampledValue[sampledValuesPerPhaseIndex].value}/${maxPowerPerPhaseRounded}`);
244 }
245 }
246 }
247 // Current.Import measurand
248 const currentSampledValueTemplate = this.chargingStation.getSampledValueTemplate(connectorId, OCPP16MeterValueMeasurand.CURRENT_IMPORT);
249 let currentPerPhaseSampledValueTemplates: MeasurandPerPhaseSampledValueTemplates = {};
250 if (this.chargingStation.getNumberOfPhases() === 3) {
251 currentPerPhaseSampledValueTemplates = {
252 L1: this.chargingStation.getSampledValueTemplate(connectorId, OCPP16MeterValueMeasurand.CURRENT_IMPORT, OCPP16MeterValuePhase.L1),
253 L2: this.chargingStation.getSampledValueTemplate(connectorId, OCPP16MeterValueMeasurand.CURRENT_IMPORT, OCPP16MeterValuePhase.L2),
254 L3: this.chargingStation.getSampledValueTemplate(connectorId, OCPP16MeterValueMeasurand.CURRENT_IMPORT, OCPP16MeterValuePhase.L3),
255 };
256 }
257 if (currentSampledValueTemplate) {
258 OCPP16ServiceUtils.checkMeasurandPowerDivider(this.chargingStation, currentSampledValueTemplate.measurand);
259 const errMsg = `${this.chargingStation.logPrefix()} MeterValues measurand ${currentSampledValueTemplate.measurand ?? OCPP16MeterValueMeasurand.ENERGY_ACTIVE_IMPORT_REGISTER}: Unknown ${this.chargingStation.getCurrentOutType()} currentOutType in template file ${this.chargingStation.stationTemplateFile}, cannot calculate ${currentSampledValueTemplate.measurand ?? OCPP16MeterValueMeasurand.ENERGY_ACTIVE_IMPORT_REGISTER} measurand value`;
260 const currentMeasurandValues: MeasurandValues = {} as MeasurandValues;
261 let maxAmperage: number;
262 switch (this.chargingStation.getCurrentOutType()) {
263 case CurrentType.AC:
264 maxAmperage = ACElectricUtils.amperagePerPhaseFromPower(this.chargingStation.getNumberOfPhases(), this.chargingStation.stationInfo.maxPower / this.chargingStation.stationInfo.powerDivider, this.chargingStation.getVoltageOut());
265 if (this.chargingStation.getNumberOfPhases() === 3) {
266 const defaultFluctuatedAmperagePerPhase = currentSampledValueTemplate.value
267 && Utils.getRandomFloatFluctuatedRounded(parseInt(currentSampledValueTemplate.value), currentSampledValueTemplate.fluctuationPercent ?? Constants.DEFAULT_FLUCTUATION_PERCENT);
268 const phase1FluctuatedValue = currentPerPhaseSampledValueTemplates?.L1?.value
269 && Utils.getRandomFloatFluctuatedRounded(parseInt(currentPerPhaseSampledValueTemplates.L1.value), currentPerPhaseSampledValueTemplates.L1.fluctuationPercent ?? Constants.DEFAULT_FLUCTUATION_PERCENT);
270 const phase2FluctuatedValue = currentPerPhaseSampledValueTemplates?.L2?.value
271 && Utils.getRandomFloatFluctuatedRounded(parseInt(currentPerPhaseSampledValueTemplates.L2.value), currentPerPhaseSampledValueTemplates.L2.fluctuationPercent ?? Constants.DEFAULT_FLUCTUATION_PERCENT);
272 const phase3FluctuatedValue = currentPerPhaseSampledValueTemplates?.L3?.value
273 && Utils.getRandomFloatFluctuatedRounded(parseInt(currentPerPhaseSampledValueTemplates.L3.value), currentPerPhaseSampledValueTemplates.L3.fluctuationPercent ?? Constants.DEFAULT_FLUCTUATION_PERCENT);
274 currentMeasurandValues.L1 = (phase1FluctuatedValue ?? defaultFluctuatedAmperagePerPhase) ?? Utils.getRandomFloatRounded(maxAmperage);
275 currentMeasurandValues.L2 = (phase2FluctuatedValue ?? defaultFluctuatedAmperagePerPhase) ?? Utils.getRandomFloatRounded(maxAmperage);
276 currentMeasurandValues.L3 = (phase3FluctuatedValue ?? defaultFluctuatedAmperagePerPhase) ?? Utils.getRandomFloatRounded(maxAmperage);
277 } else {
278 currentMeasurandValues.L1 = currentSampledValueTemplate.value
279 ? Utils.getRandomFloatFluctuatedRounded(parseInt(currentSampledValueTemplate.value), currentSampledValueTemplate.fluctuationPercent ?? Constants.DEFAULT_FLUCTUATION_PERCENT)
280 : Utils.getRandomFloatRounded(maxAmperage);
281 currentMeasurandValues.L2 = 0;
282 currentMeasurandValues.L3 = 0;
283 }
284 currentMeasurandValues.allPhases = Utils.roundTo((currentMeasurandValues.L1 + currentMeasurandValues.L2 + currentMeasurandValues.L3) / this.chargingStation.getNumberOfPhases(), 2);
285 break;
286 case CurrentType.DC:
287 maxAmperage = DCElectricUtils.amperage(this.chargingStation.stationInfo.maxPower / this.chargingStation.stationInfo.powerDivider, this.chargingStation.getVoltageOut());
288 currentMeasurandValues.allPhases = currentSampledValueTemplate.value
289 ? Utils.getRandomFloatFluctuatedRounded(parseInt(currentSampledValueTemplate.value), currentSampledValueTemplate.fluctuationPercent ?? Constants.DEFAULT_FLUCTUATION_PERCENT)
290 : Utils.getRandomFloatRounded(maxAmperage);
291 break;
292 default:
293 logger.error(errMsg);
294 throw new OCPPError(ErrorType.INTERNAL_ERROR, errMsg, OCPP16RequestCommand.METER_VALUES);
295 }
296 meterValue.sampledValue.push(OCPP16ServiceUtils.buildSampledValue(currentSampledValueTemplate, currentMeasurandValues.allPhases));
297 const sampledValuesIndex = meterValue.sampledValue.length - 1;
298 if (Utils.convertToFloat(meterValue.sampledValue[sampledValuesIndex].value) > maxAmperage || debug) {
299 logger.error(`${this.chargingStation.logPrefix()} MeterValues measurand ${meterValue.sampledValue[sampledValuesIndex].measurand ?? OCPP16MeterValueMeasurand.ENERGY_ACTIVE_IMPORT_REGISTER}: connectorId ${connectorId}, transaction ${connector.transactionId}, value: ${meterValue.sampledValue[sampledValuesIndex].value}/${maxAmperage}`);
300 }
301 for (let phase = 1; this.chargingStation.getNumberOfPhases() === 3 && phase <= this.chargingStation.getNumberOfPhases(); phase++) {
302 const phaseValue = `L${phase}`;
303 meterValue.sampledValue.push(OCPP16ServiceUtils.buildSampledValue(currentPerPhaseSampledValueTemplates[phaseValue] ?? currentSampledValueTemplate,
304 currentMeasurandValues[phaseValue], null, phaseValue as OCPP16MeterValuePhase));
305 const sampledValuesPerPhaseIndex = meterValue.sampledValue.length - 1;
306 if (Utils.convertToFloat(meterValue.sampledValue[sampledValuesPerPhaseIndex].value) > maxAmperage || debug) {
307 logger.error(`${this.chargingStation.logPrefix()} MeterValues measurand ${meterValue.sampledValue[sampledValuesPerPhaseIndex].measurand ?? OCPP16MeterValueMeasurand.ENERGY_ACTIVE_IMPORT_REGISTER}: phase ${meterValue.sampledValue[sampledValuesPerPhaseIndex].phase}, connectorId ${connectorId}, transaction ${connector.transactionId}, value: ${meterValue.sampledValue[sampledValuesPerPhaseIndex].value}/${maxAmperage}`);
308 }
309 }
310 }
311 // Energy.Active.Import.Register measurand (default)
312 const energySampledValueTemplate = this.chargingStation.getSampledValueTemplate(connectorId);
313 if (energySampledValueTemplate) {
314 OCPP16ServiceUtils.checkMeasurandPowerDivider(this.chargingStation, energySampledValueTemplate.measurand);
315 const unitDivider = energySampledValueTemplate?.unit === MeterValueUnit.KILO_WATT_HOUR ? 1000 : 1;
316 const maxEnergyRounded = Utils.roundTo(((this.chargingStation.stationInfo.maxPower / this.chargingStation.stationInfo.powerDivider) * interval) / (3600 * 1000), 2);
317 const energyValueRounded = energySampledValueTemplate.value
318 // Cumulate the fluctuated value around the static one
319 ? Utils.getRandomFloatFluctuatedRounded(parseInt(energySampledValueTemplate.value), energySampledValueTemplate.fluctuationPercent ?? Constants.DEFAULT_FLUCTUATION_PERCENT)
320 : Utils.getRandomFloatRounded(maxEnergyRounded);
321 // Persist previous value on connector
322 if (connector && !Utils.isNullOrUndefined(connector.energyActiveImportRegisterValue) && connector.energyActiveImportRegisterValue >= 0 &&
323 !Utils.isNullOrUndefined(connector.transactionEnergyActiveImportRegisterValue) && connector.transactionEnergyActiveImportRegisterValue >= 0) {
324 connector.energyActiveImportRegisterValue += energyValueRounded;
325 connector.transactionEnergyActiveImportRegisterValue += energyValueRounded;
326 } else {
327 connector.energyActiveImportRegisterValue = 0;
328 connector.transactionEnergyActiveImportRegisterValue = 0;
329 }
330 meterValue.sampledValue.push(OCPP16ServiceUtils.buildSampledValue(energySampledValueTemplate,
331 Utils.roundTo(this.chargingStation.getEnergyActiveImportRegisterByTransactionId(transactionId) / unitDivider, 2)));
332 const sampledValuesIndex = meterValue.sampledValue.length - 1;
333 if (energyValueRounded > maxEnergyRounded || debug) {
334 logger.error(`${this.chargingStation.logPrefix()} MeterValues measurand ${meterValue.sampledValue[sampledValuesIndex].measurand ?? OCPP16MeterValueMeasurand.ENERGY_ACTIVE_IMPORT_REGISTER}: connectorId ${connectorId}, transaction ${connector.transactionId}, value: ${energyValueRounded}/${maxEnergyRounded}, duration: ${Utils.roundTo(interval / (3600 * 1000), 4)}h`);
335 }
336 }
337 const payload: MeterValuesRequest = {
338 connectorId,
339 transactionId,
340 meterValue: [meterValue],
341 };
342 await this.sendMessage(Utils.generateUUID(), payload, MessageType.CALL_MESSAGE, OCPP16RequestCommand.METER_VALUES);
343 } catch (error) {
344 this.handleRequestError(OCPP16RequestCommand.METER_VALUES, error as Error);
345 }
346 }
347
348 public async sendTransactionBeginMeterValues(connectorId: number, transactionId: number, beginMeterValue: OCPP16MeterValue): Promise<void> {
349 try {
350 const payload: MeterValuesRequest = {
351 connectorId,
352 transactionId,
353 meterValue: [beginMeterValue],
354 };
355 await this.sendMessage(Utils.generateUUID(), payload, MessageType.CALL_MESSAGE, OCPP16RequestCommand.METER_VALUES);
356 } catch (error) {
357 this.handleRequestError(OCPP16RequestCommand.METER_VALUES, error as Error);
358 }
359 }
360
361 public async sendTransactionEndMeterValues(connectorId: number, transactionId: number, endMeterValue: OCPP16MeterValue): Promise<void> {
362 try {
363 const payload: MeterValuesRequest = {
364 connectorId,
365 transactionId,
366 meterValue: [endMeterValue],
367 };
368 await this.sendMessage(Utils.generateUUID(), payload, MessageType.CALL_MESSAGE, OCPP16RequestCommand.METER_VALUES);
369 } catch (error) {
370 this.handleRequestError(OCPP16RequestCommand.METER_VALUES, error as Error);
371 }
372 }
373
374 public async sendDiagnosticsStatusNotification(diagnosticsStatus: OCPP16DiagnosticsStatus): Promise<void> {
375 try {
376 const payload: DiagnosticsStatusNotificationRequest = {
377 status: diagnosticsStatus
378 };
379 await this.sendMessage(Utils.generateUUID(), payload, MessageType.CALL_MESSAGE, OCPP16RequestCommand.DIAGNOSTICS_STATUS_NOTIFICATION);
380 } catch (error) {
381 this.handleRequestError(OCPP16RequestCommand.METER_VALUES, error as Error);
382 }
383 }
384
385 public async sendResult(messageId: string, resultMessageData: JsonType, commandName: OCPP16RequestCommand | OCPP16IncomingRequestCommand): Promise<JsonType> {
386 try {
387 // Send error
388 return await this.sendMessage(messageId, resultMessageData, MessageType.CALL_RESULT_MESSAGE, commandName) as JsonType;
389 } catch (error) {
390 this.handleRequestError(commandName as OCPP16RequestCommand, error as Error);
391 }
392 }
393
394 public async sendError(messageId: string, ocppError: OCPPError, commandName: OCPP16RequestCommand | OCPP16IncomingRequestCommand): Promise<JsonType> {
395 try {
396 // Send error
397 return await this.sendMessage(messageId, ocppError, MessageType.CALL_ERROR_MESSAGE, commandName) as JsonType;
398 } catch (error) {
399 this.handleRequestError(commandName as OCPP16RequestCommand, error as Error);
400 }
401 }
402}