Get rid of useless intermediate variable
[e-mobility-charging-stations-simulator.git] / src / charging-station / ocpp / 1.6 / OCPP16ResponseService.ts
CommitLineData
c8eeb62b
JB
1// Partial Copyright Jerome Benoit. 2021. All Rights Reserved.
2
e7aeea18
JB
3import {
4 AuthorizeRequest,
5 OCPP16AuthorizationStatus,
6 OCPP16AuthorizeResponse,
7 OCPP16StartTransactionResponse,
8 OCPP16StopTransactionResponse,
9 StartTransactionRequest,
10 StopTransactionRequest,
11} from '../../../types/ocpp/1.6/Transaction';
12import {
13 HeartbeatRequest,
14 OCPP16RequestCommand,
15 StatusNotificationRequest,
16} from '../../../types/ocpp/1.6/Requests';
f22266fd 17import { MeterValuesRequest, OCPP16MeterValuesResponse } from '../../../types/ocpp/1.6/MeterValues';
e7aeea18 18import {
e7aeea18 19 OCPP16BootNotificationResponse,
f22266fd 20 OCPP16HeartbeatResponse,
e7aeea18 21 OCPP16RegistrationStatus,
f22266fd 22 OCPP16StatusNotificationResponse,
e7aeea18 23} from '../../../types/ocpp/1.6/Responses';
c0560973 24
73b9adec 25import type ChargingStation from '../../ChargingStation';
a4bc2942 26import { ErrorType } from '../../../types/ocpp/ErrorType';
d1888640 27import { JsonType } from '../../../types/JsonType';
93b4a429 28import { OCPP16ChargePointErrorCode } from '../../../types/ocpp/1.6/ChargePointErrorCode';
c0560973 29import { OCPP16ChargePointStatus } from '../../../types/ocpp/1.6/ChargePointStatus';
fd0c36fa 30import { OCPP16ServiceUtils } from './OCPP16ServiceUtils';
c0560973 31import { OCPP16StandardParametersKey } from '../../../types/ocpp/1.6/Configuration';
e58068fd 32import OCPPError from '../../../exception/OCPPError';
c0560973 33import OCPPResponseService from '../OCPPResponseService';
74c6a954 34import { ResponseHandler } from '../../../types/ocpp/Responses';
c0560973 35import Utils from '../../../utils/Utils';
9f2e3130 36import logger from '../../../utils/Logger';
c0560973 37
909dcf2d
JB
38const moduleName = 'OCPP16ResponseService';
39
c0560973 40export default class OCPP16ResponseService extends OCPPResponseService {
58144adb
JB
41 private responseHandlers: Map<OCPP16RequestCommand, ResponseHandler>;
42
9f2e3130 43 public constructor(chargingStation: ChargingStation) {
909dcf2d 44 if (new.target?.name === moduleName) {
06127450 45 throw new TypeError(`Cannot construct ${new.target?.name} instances directly`);
9f2e3130 46 }
58144adb
JB
47 super(chargingStation);
48 this.responseHandlers = new Map<OCPP16RequestCommand, ResponseHandler>([
49 [OCPP16RequestCommand.BOOT_NOTIFICATION, this.handleResponseBootNotification.bind(this)],
50 [OCPP16RequestCommand.HEARTBEAT, this.handleResponseHeartbeat.bind(this)],
51 [OCPP16RequestCommand.AUTHORIZE, this.handleResponseAuthorize.bind(this)],
52 [OCPP16RequestCommand.START_TRANSACTION, this.handleResponseStartTransaction.bind(this)],
53 [OCPP16RequestCommand.STOP_TRANSACTION, this.handleResponseStopTransaction.bind(this)],
54 [OCPP16RequestCommand.STATUS_NOTIFICATION, this.handleResponseStatusNotification.bind(this)],
e7aeea18 55 [OCPP16RequestCommand.METER_VALUES, this.handleResponseMeterValues.bind(this)],
58144adb
JB
56 ]);
57 }
58
e7aeea18
JB
59 public async handleResponse(
60 commandName: OCPP16RequestCommand,
61 payload: JsonType | string,
62 requestPayload: JsonType
63 ): Promise<void> {
64 if (
65 this.chargingStation.isRegistered() ||
66 commandName === OCPP16RequestCommand.BOOT_NOTIFICATION
67 ) {
124f3553
JB
68 if (this.responseHandlers.has(commandName)) {
69 try {
70 await this.responseHandlers.get(commandName)(payload, requestPayload);
71 } catch (error) {
e7aeea18
JB
72 logger.error(
73 this.chargingStation.logPrefix() + ' Handle request response error: %j',
74 error
75 );
124f3553
JB
76 throw error;
77 }
78 } else {
79 // Throw exception
e7aeea18
JB
80 throw new OCPPError(
81 ErrorType.NOT_IMPLEMENTED,
82 `${commandName} is not implemented to handle request response payload ${JSON.stringify(
83 payload,
84 null,
85 2
86 )}`,
87 commandName
88 );
887fef76 89 }
c0560973 90 } else {
e7aeea18
JB
91 throw new OCPPError(
92 ErrorType.SECURITY_ERROR,
93 `${commandName} cannot be issued to handle request response payload ${JSON.stringify(
94 payload,
95 null,
96 2
97 )} while the charging station is not registered on the central server. `,
98 commandName
99 );
c0560973
JB
100 }
101 }
102
624df199 103 private handleResponseBootNotification(payload: OCPP16BootNotificationResponse): void {
c0560973 104 if (payload.status === OCPP16RegistrationStatus.ACCEPTED) {
e7aeea18
JB
105 this.chargingStation.addConfigurationKey(
106 OCPP16StandardParametersKey.HeartBeatInterval,
a95873d8
JB
107 payload.interval.toString(),
108 {},
109 { overwrite: true, save: true }
e7aeea18
JB
110 );
111 this.chargingStation.addConfigurationKey(
112 OCPP16StandardParametersKey.HeartbeatInterval,
113 payload.interval.toString(),
00db15b8 114 { visible: false },
a95873d8 115 { overwrite: true, save: true }
e7aeea18
JB
116 );
117 this.chargingStation.heartbeatSetInterval
118 ? this.chargingStation.restartHeartbeat()
119 : this.chargingStation.startHeartbeat();
672fed6e 120 }
74c6a954 121 if (Object.values(OCPP16RegistrationStatus).includes(payload.status)) {
e7aeea18
JB
122 const logMsg = `${this.chargingStation.logPrefix()} Charging station in '${
123 payload.status
124 }' state on the central server`;
125 payload.status === OCPP16RegistrationStatus.REJECTED
126 ? logger.warn(logMsg)
127 : logger.info(logMsg);
c0560973 128 } else {
e7aeea18
JB
129 logger.error(
130 this.chargingStation.logPrefix() +
131 ' Charging station boot notification response received: %j with undefined registration status',
132 payload
133 );
c0560973
JB
134 }
135 }
136
e7aeea18 137 private handleResponseHeartbeat(
f22266fd 138 payload: OCPP16HeartbeatResponse,
e7aeea18
JB
139 requestPayload: HeartbeatRequest
140 ): void {
141 logger.debug(
142 this.chargingStation.logPrefix() +
143 ' Heartbeat response received: %j to Heartbeat request: %j',
144 payload,
145 requestPayload
146 );
58144adb
JB
147 }
148
e7aeea18
JB
149 private handleResponseAuthorize(
150 payload: OCPP16AuthorizeResponse,
151 requestPayload: AuthorizeRequest
152 ): void {
58144adb 153 let authorizeConnectorId: number;
734d790d 154 for (const connectorId of this.chargingStation.connectors.keys()) {
e7aeea18
JB
155 if (
156 connectorId > 0 &&
157 this.chargingStation.getConnectorStatus(connectorId)?.authorizeIdTag ===
158 requestPayload.idTag
159 ) {
734d790d 160 authorizeConnectorId = connectorId;
58144adb
JB
161 break;
162 }
163 }
164 if (payload.idTagInfo.status === OCPP16AuthorizationStatus.ACCEPTED) {
a2653482 165 this.chargingStation.getConnectorStatus(authorizeConnectorId).idTagAuthorized = true;
e7aeea18
JB
166 logger.debug(
167 `${this.chargingStation.logPrefix()} IdTag ${
168 requestPayload.idTag
169 } authorized on connector ${authorizeConnectorId}`
170 );
58144adb 171 } else {
a2653482 172 this.chargingStation.getConnectorStatus(authorizeConnectorId).idTagAuthorized = false;
734d790d 173 delete this.chargingStation.getConnectorStatus(authorizeConnectorId).authorizeIdTag;
e7aeea18 174 logger.debug(
e8e865ea 175 `${this.chargingStation.logPrefix()} IdTag ${requestPayload.idTag} refused with status '${
e7aeea18 176 payload.idTagInfo.status
e8e865ea 177 }' on connector ${authorizeConnectorId}`
e7aeea18 178 );
58144adb
JB
179 }
180 }
181
e7aeea18
JB
182 private async handleResponseStartTransaction(
183 payload: OCPP16StartTransactionResponse,
184 requestPayload: StartTransactionRequest
185 ): Promise<void> {
c0560973
JB
186 const connectorId = requestPayload.connectorId;
187
188 let transactionConnectorId: number;
734d790d
JB
189 for (const id of this.chargingStation.connectors.keys()) {
190 if (id > 0 && id === connectorId) {
191 transactionConnectorId = id;
c0560973
JB
192 break;
193 }
194 }
195 if (!transactionConnectorId) {
e7aeea18
JB
196 logger.error(
197 this.chargingStation.logPrefix() +
198 ' Trying to start a transaction on a non existing connector Id ' +
199 connectorId.toString()
200 );
c0560973
JB
201 return;
202 }
e7aeea18
JB
203 if (
204 this.chargingStation.getConnectorStatus(connectorId).transactionRemoteStarted &&
205 this.chargingStation.getAuthorizeRemoteTxRequests() &&
206 this.chargingStation.getLocalAuthListEnabled() &&
207 this.chargingStation.hasAuthorizedTags() &&
208 !this.chargingStation.getConnectorStatus(connectorId).idTagLocalAuthorized
209 ) {
210 logger.error(
211 this.chargingStation.logPrefix() +
212 ' Trying to start a transaction with a not local authorized idTag ' +
213 this.chargingStation.getConnectorStatus(connectorId).localAuthorizeIdTag +
214 ' on connector Id ' +
215 connectorId.toString()
216 );
a2653482
JB
217 await this.resetConnectorOnStartTransactionError(connectorId);
218 return;
219 }
e7aeea18
JB
220 if (
221 this.chargingStation.getConnectorStatus(connectorId).transactionRemoteStarted &&
222 this.chargingStation.getAuthorizeRemoteTxRequests() &&
223 this.chargingStation.getMayAuthorizeAtRemoteStart() &&
224 !this.chargingStation.getConnectorStatus(connectorId).idTagLocalAuthorized &&
225 !this.chargingStation.getConnectorStatus(connectorId).idTagAuthorized
226 ) {
227 logger.error(
228 this.chargingStation.logPrefix() +
229 ' Trying to start a transaction with a not authorized idTag ' +
230 this.chargingStation.getConnectorStatus(connectorId).authorizeIdTag +
231 ' on connector Id ' +
232 connectorId.toString()
233 );
a2653482
JB
234 await this.resetConnectorOnStartTransactionError(connectorId);
235 return;
236 }
e7aeea18
JB
237 if (
238 this.chargingStation.getConnectorStatus(connectorId).idTagAuthorized &&
239 this.chargingStation.getConnectorStatus(connectorId).authorizeIdTag !== requestPayload.idTag
240 ) {
241 logger.error(
242 this.chargingStation.logPrefix() +
243 ' Trying to start a transaction with an idTag ' +
244 requestPayload.idTag +
245 ' different from the authorize request one ' +
246 this.chargingStation.getConnectorStatus(connectorId).authorizeIdTag +
247 ' on connector Id ' +
248 connectorId.toString()
249 );
a2653482
JB
250 await this.resetConnectorOnStartTransactionError(connectorId);
251 return;
252 }
e7aeea18
JB
253 if (
254 this.chargingStation.getConnectorStatus(connectorId).idTagLocalAuthorized &&
255 this.chargingStation.getConnectorStatus(connectorId).localAuthorizeIdTag !==
256 requestPayload.idTag
257 ) {
258 logger.error(
259 this.chargingStation.logPrefix() +
260 ' Trying to start a transaction with an idTag ' +
261 requestPayload.idTag +
262 ' different from the local authorized one ' +
263 this.chargingStation.getConnectorStatus(connectorId).localAuthorizeIdTag +
264 ' on connector Id ' +
265 connectorId.toString()
266 );
a2653482 267 await this.resetConnectorOnStartTransactionError(connectorId);
163547b1
JB
268 return;
269 }
734d790d 270 if (this.chargingStation.getConnectorStatus(connectorId)?.transactionStarted) {
e7aeea18
JB
271 logger.debug(
272 this.chargingStation.logPrefix() +
273 ' Trying to start a transaction on an already used connector ' +
274 connectorId.toString() +
275 ': %j',
276 this.chargingStation.getConnectorStatus(connectorId)
277 );
c0560973
JB
278 return;
279 }
e7aeea18
JB
280 if (
281 this.chargingStation.getConnectorStatus(connectorId)?.status !==
282 OCPP16ChargePointStatus.AVAILABLE &&
283 this.chargingStation.getConnectorStatus(connectorId)?.status !==
284 OCPP16ChargePointStatus.PREPARING
285 ) {
286 logger.error(
287 `${this.chargingStation.logPrefix()} Trying to start a transaction on connector ${connectorId.toString()} with status ${
288 this.chargingStation.getConnectorStatus(connectorId)?.status
289 }`
290 );
290d006c
JB
291 return;
292 }
f3a6f63b 293 if (!Number.isInteger(payload.transactionId)) {
e7aeea18
JB
294 logger.warn(
295 `${this.chargingStation.logPrefix()} Trying to start a transaction on connector ${connectorId.toString()} with a non integer transaction Id ${
296 payload.transactionId
297 }, converting to integer`
298 );
f3a6f63b
JB
299 payload.transactionId = Utils.convertToInt(payload.transactionId);
300 }
c0560973 301
f0c6ed89 302 if (payload.idTagInfo?.status === OCPP16AuthorizationStatus.ACCEPTED) {
734d790d
JB
303 this.chargingStation.getConnectorStatus(connectorId).transactionStarted = true;
304 this.chargingStation.getConnectorStatus(connectorId).transactionId = payload.transactionId;
305 this.chargingStation.getConnectorStatus(connectorId).transactionIdTag = requestPayload.idTag;
e7aeea18
JB
306 this.chargingStation.getConnectorStatus(
307 connectorId
308 ).transactionEnergyActiveImportRegisterValue = 0;
309 this.chargingStation.getConnectorStatus(connectorId).transactionBeginMeterValue =
310 OCPP16ServiceUtils.buildTransactionBeginMeterValue(
311 this.chargingStation,
312 connectorId,
313 requestPayload.meterStart
314 );
315 this.chargingStation.getBeginEndMeterValues() &&
f22266fd 316 (await this.chargingStation.ocppRequestService.sendMessageHandler<OCPP16MeterValuesResponse>(
443c0641
JB
317 OCPP16RequestCommand.METER_VALUES,
318 {
319 connectorId,
320 transactionId: payload.transactionId,
321 meterValue:
322 this.chargingStation.getConnectorStatus(connectorId).transactionBeginMeterValue,
323 }
e7aeea18 324 ));
f22266fd 325 await this.chargingStation.ocppRequestService.sendMessageHandler<OCPP16StatusNotificationResponse>(
93b4a429
JB
326 OCPP16RequestCommand.STATUS_NOTIFICATION,
327 {
328 connectorId,
329 status: OCPP16ChargePointStatus.CHARGING,
330 errorCode: OCPP16ChargePointErrorCode.NO_ERROR,
331 }
e7aeea18
JB
332 );
333 this.chargingStation.getConnectorStatus(connectorId).status =
334 OCPP16ChargePointStatus.CHARGING;
335 logger.info(
336 this.chargingStation.logPrefix() +
337 ' Transaction ' +
338 payload.transactionId.toString() +
339 ' STARTED on ' +
340 this.chargingStation.stationInfo.chargingStationId +
341 '#' +
342 connectorId.toString() +
343 ' for idTag ' +
344 requestPayload.idTag
345 );
c0560973
JB
346 if (this.chargingStation.stationInfo.powerSharedByConnectors) {
347 this.chargingStation.stationInfo.powerDivider++;
348 }
e7aeea18
JB
349 const configuredMeterValueSampleInterval = this.chargingStation.getConfigurationKey(
350 OCPP16StandardParametersKey.MeterValueSampleInterval
351 );
352 this.chargingStation.startMeterValues(
353 connectorId,
354 configuredMeterValueSampleInterval
355 ? Utils.convertToInt(configuredMeterValueSampleInterval.value) * 1000
356 : 60000
357 );
c0560973 358 } else {
e7aeea18
JB
359 logger.warn(
360 this.chargingStation.logPrefix() +
361 ' Starting transaction id ' +
362 payload.transactionId.toString() +
e8e865ea 363 " REJECTED with status '" +
e7aeea18 364 payload?.idTagInfo?.status +
e8e865ea 365 "', idTag " +
e7aeea18
JB
366 requestPayload.idTag
367 );
a2653482
JB
368 await this.resetConnectorOnStartTransactionError(connectorId);
369 }
370 }
371
372 private async resetConnectorOnStartTransactionError(connectorId: number): Promise<void> {
373 this.chargingStation.resetConnectorStatus(connectorId);
e7aeea18
JB
374 if (
375 this.chargingStation.getConnectorStatus(connectorId).status !==
376 OCPP16ChargePointStatus.AVAILABLE
377 ) {
f22266fd 378 await this.chargingStation.ocppRequestService.sendMessageHandler<OCPP16StatusNotificationResponse>(
93b4a429
JB
379 OCPP16RequestCommand.STATUS_NOTIFICATION,
380 {
381 connectorId,
382 status: OCPP16ChargePointStatus.AVAILABLE,
383 errorCode: OCPP16ChargePointErrorCode.NO_ERROR,
384 }
e7aeea18
JB
385 );
386 this.chargingStation.getConnectorStatus(connectorId).status =
387 OCPP16ChargePointStatus.AVAILABLE;
c0560973
JB
388 }
389 }
390
e7aeea18
JB
391 private async handleResponseStopTransaction(
392 payload: OCPP16StopTransactionResponse,
393 requestPayload: StopTransactionRequest
394 ): Promise<void> {
f479a792
JB
395 const transactionConnectorId = this.chargingStation.getConnectorIdByTransactionId(
396 requestPayload.transactionId
397 );
c0560973 398 if (!transactionConnectorId) {
e7aeea18
JB
399 logger.error(
400 this.chargingStation.logPrefix() +
401 ' Trying to stop a non existing transaction ' +
402 requestPayload.transactionId.toString()
403 );
c0560973
JB
404 return;
405 }
406 if (payload.idTagInfo?.status === OCPP16AuthorizationStatus.ACCEPTED) {
e7aeea18
JB
407 this.chargingStation.getBeginEndMeterValues() &&
408 !this.chargingStation.getOcppStrictCompliance() &&
409 this.chargingStation.getOutOfOrderEndMeterValues() &&
f22266fd 410 (await this.chargingStation.ocppRequestService.sendMessageHandler<OCPP16MeterValuesResponse>(
3a33b6a9
JB
411 OCPP16RequestCommand.METER_VALUES,
412 {
413 connectorId: transactionConnectorId,
414 transactionId: requestPayload.transactionId,
415 meterValue: OCPP16ServiceUtils.buildTransactionEndMeterValue(
416 this.chargingStation,
417 transactionConnectorId,
418 requestPayload.meterStop
419 ),
420 }
e7aeea18
JB
421 ));
422 if (
423 !this.chargingStation.isChargingStationAvailable() ||
424 !this.chargingStation.isConnectorAvailable(transactionConnectorId)
425 ) {
f22266fd 426 await this.chargingStation.ocppRequestService.sendMessageHandler<OCPP16StatusNotificationResponse>(
93b4a429
JB
427 OCPP16RequestCommand.STATUS_NOTIFICATION,
428 {
429 connectorId: transactionConnectorId,
430 status: OCPP16ChargePointStatus.UNAVAILABLE,
431 errorCode: OCPP16ChargePointErrorCode.NO_ERROR,
432 }
e7aeea18
JB
433 );
434 this.chargingStation.getConnectorStatus(transactionConnectorId).status =
435 OCPP16ChargePointStatus.UNAVAILABLE;
c0560973 436 } else {
f22266fd 437 await this.chargingStation.ocppRequestService.sendMessageHandler<OCPP16BootNotificationResponse>(
93b4a429
JB
438 OCPP16RequestCommand.STATUS_NOTIFICATION,
439 {
440 connectorId: transactionConnectorId,
441 status: OCPP16ChargePointStatus.AVAILABLE,
442 errorCode: OCPP16ChargePointErrorCode.NO_ERROR,
443 }
e7aeea18
JB
444 );
445 this.chargingStation.getConnectorStatus(transactionConnectorId).status =
446 OCPP16ChargePointStatus.AVAILABLE;
c0560973
JB
447 }
448 if (this.chargingStation.stationInfo.powerSharedByConnectors) {
449 this.chargingStation.stationInfo.powerDivider--;
450 }
e7aeea18
JB
451 logger.info(
452 this.chargingStation.logPrefix() +
453 ' Transaction ' +
454 requestPayload.transactionId.toString() +
455 ' STOPPED on ' +
456 this.chargingStation.stationInfo.chargingStationId +
457 '#' +
458 transactionConnectorId.toString()
459 );
a2653482 460 this.chargingStation.resetConnectorStatus(transactionConnectorId);
c0560973 461 } else {
e7aeea18
JB
462 logger.warn(
463 this.chargingStation.logPrefix() +
464 ' Stopping transaction id ' +
465 requestPayload.transactionId.toString() +
e8e865ea
JB
466 " REJECTED with status '" +
467 payload.idTagInfo?.status +
468 "'"
e7aeea18 469 );
c0560973
JB
470 }
471 }
472
e7aeea18
JB
473 private handleResponseStatusNotification(
474 payload: StatusNotificationRequest,
f22266fd 475 requestPayload: OCPP16StatusNotificationResponse
e7aeea18
JB
476 ): void {
477 logger.debug(
478 this.chargingStation.logPrefix() +
479 ' Status notification response received: %j to StatusNotification request: %j',
480 payload,
481 requestPayload
482 );
c0560973
JB
483 }
484
e7aeea18
JB
485 private handleResponseMeterValues(
486 payload: MeterValuesRequest,
f22266fd 487 requestPayload: OCPP16MeterValuesResponse
e7aeea18
JB
488 ): void {
489 logger.debug(
490 this.chargingStation.logPrefix() +
491 ' MeterValues response received: %j to MeterValues request: %j',
492 payload,
493 requestPayload
494 );
c0560973 495 }
c0560973 496}