X-Git-Url: https://git.piment-noir.org/?a=blobdiff_plain;f=src%2Fcharging-station%2Focpp%2F1.6%2FOCPP16ResponseService.ts;h=3b91fba1f028f2a16b38f6abc99f77f55e37938b;hb=298be10c5c800e43b0b9dcd6c50f6d49e2cb786b;hp=79064f1c48d9deec97e583da6679fd4b2a600d86;hpb=e7aeea18e189dd087c8f951cf77a253e2818ae90;p=e-mobility-charging-stations-simulator.git diff --git a/src/charging-station/ocpp/1.6/OCPP16ResponseService.ts b/src/charging-station/ocpp/1.6/OCPP16ResponseService.ts index 79064f1c..3b91fba1 100644 --- a/src/charging-station/ocpp/1.6/OCPP16ResponseService.ts +++ b/src/charging-station/ocpp/1.6/OCPP16ResponseService.ts @@ -1,476 +1,889 @@ -// Partial Copyright Jerome Benoit. 2021. All Rights Reserved. +// Partial Copyright Jerome Benoit. 2021-2024. All Rights Reserved. +import type { ValidateFunction } from 'ajv' +import { secondsToMilliseconds } from 'date-fns' + +import { OCPP16ServiceUtils } from './OCPP16ServiceUtils.js' import { - AuthorizeRequest, - OCPP16AuthorizationStatus, - OCPP16AuthorizeResponse, - OCPP16StartTransactionResponse, - OCPP16StopTransactionResponse, - StartTransactionRequest, - StopTransactionRequest, -} from '../../../types/ocpp/1.6/Transaction'; + type ChargingStation, + addConfigurationKey, + getConfigurationKey, + hasReservationExpired, + resetConnectorStatus +} from '../../../charging-station/index.js' +import { OCPPError } from '../../../exception/index.js' import { - HeartbeatRequest, + type ChangeConfigurationResponse, + ErrorType, + type GenericResponse, + type GetConfigurationResponse, + type GetDiagnosticsResponse, + type JsonType, + OCPP16AuthorizationStatus, + type OCPP16AuthorizeRequest, + type OCPP16AuthorizeResponse, + type OCPP16BootNotificationResponse, + type OCPP16ChangeAvailabilityResponse, + OCPP16ChargePointStatus, + type OCPP16ClearChargingProfileResponse, + type OCPP16DataTransferResponse, + type OCPP16DiagnosticsStatusNotificationResponse, + type OCPP16FirmwareStatusNotificationResponse, + type OCPP16GetCompositeScheduleResponse, + type OCPP16HeartbeatResponse, + OCPP16IncomingRequestCommand, + type OCPP16MeterValuesRequest, + type OCPP16MeterValuesResponse, OCPP16RequestCommand, - StatusNotificationRequest, -} from '../../../types/ocpp/1.6/Requests'; -import { - HeartbeatResponse, - OCPP16BootNotificationResponse, - OCPP16RegistrationStatus, - StatusNotificationResponse, -} from '../../../types/ocpp/1.6/Responses'; -import { MeterValuesRequest, MeterValuesResponse } from '../../../types/ocpp/1.6/MeterValues'; + type OCPP16ReserveNowResponse, + OCPP16StandardParametersKey, + type OCPP16StartTransactionRequest, + type OCPP16StartTransactionResponse, + type OCPP16StatusNotificationResponse, + type OCPP16StopTransactionRequest, + type OCPP16StopTransactionResponse, + type OCPP16TriggerMessageResponse, + type OCPP16UpdateFirmwareResponse, + OCPPVersion, + RegistrationStatusEnumType, + ReservationTerminationReason, + type ResponseHandler, + type SetChargingProfileResponse, + type UnlockConnectorResponse +} from '../../../types/index.js' +import { Constants, convertToInt, logger } from '../../../utils/index.js' +import { OCPPResponseService } from '../OCPPResponseService.js' -import type ChargingStation from '../../ChargingStation'; -import { ErrorType } from '../../../types/ocpp/ErrorType'; -import { JsonType } from '../../../types/JsonType'; -import { OCPP16ChargePointStatus } from '../../../types/ocpp/1.6/ChargePointStatus'; -import { OCPP16ServiceUtils } from './OCPP16ServiceUtils'; -import { OCPP16StandardParametersKey } from '../../../types/ocpp/1.6/Configuration'; -import OCPPError from '../../../exception/OCPPError'; -import OCPPResponseService from '../OCPPResponseService'; -import { ResponseHandler } from '../../../types/ocpp/Responses'; -import Utils from '../../../utils/Utils'; -import logger from '../../../utils/Logger'; +const moduleName = 'OCPP16ResponseService' -const moduleName = 'OCPP16ResponseService'; +export class OCPP16ResponseService extends OCPPResponseService { + public jsonSchemasIncomingRequestResponseValidateFunction: Map< + OCPP16IncomingRequestCommand, + ValidateFunction + > -export default class OCPP16ResponseService extends OCPPResponseService { - private responseHandlers: Map; + protected jsonSchemasValidateFunction: Map> + private readonly responseHandlers: Map - public constructor(chargingStation: ChargingStation) { - if (new.target?.name === moduleName) { - throw new TypeError(`Cannot construct ${new.target?.name} instances directly`); - } - super(chargingStation); + public constructor () { + // if (new.target.name === moduleName) { + // throw new TypeError(`Cannot construct ${new.target.name} instances directly`) + // } + super(OCPPVersion.VERSION_16) this.responseHandlers = new Map([ - [OCPP16RequestCommand.BOOT_NOTIFICATION, this.handleResponseBootNotification.bind(this)], - [OCPP16RequestCommand.HEARTBEAT, this.handleResponseHeartbeat.bind(this)], - [OCPP16RequestCommand.AUTHORIZE, this.handleResponseAuthorize.bind(this)], - [OCPP16RequestCommand.START_TRANSACTION, this.handleResponseStartTransaction.bind(this)], - [OCPP16RequestCommand.STOP_TRANSACTION, this.handleResponseStopTransaction.bind(this)], - [OCPP16RequestCommand.STATUS_NOTIFICATION, this.handleResponseStatusNotification.bind(this)], - [OCPP16RequestCommand.METER_VALUES, this.handleResponseMeterValues.bind(this)], - ]); + [ + OCPP16RequestCommand.BOOT_NOTIFICATION, + this.handleResponseBootNotification.bind(this) as ResponseHandler + ], + [OCPP16RequestCommand.HEARTBEAT, this.emptyResponseHandler], + [OCPP16RequestCommand.AUTHORIZE, this.handleResponseAuthorize.bind(this) as ResponseHandler], + [ + OCPP16RequestCommand.START_TRANSACTION, + this.handleResponseStartTransaction.bind(this) as ResponseHandler + ], + [ + OCPP16RequestCommand.STOP_TRANSACTION, + this.handleResponseStopTransaction.bind(this) as ResponseHandler + ], + [ + OCPP16RequestCommand.STATUS_NOTIFICATION, + this.emptyResponseHandler.bind(this) as ResponseHandler + ], + [OCPP16RequestCommand.METER_VALUES, this.emptyResponseHandler], + [ + OCPP16RequestCommand.DIAGNOSTICS_STATUS_NOTIFICATION, + this.emptyResponseHandler.bind(this) as ResponseHandler + ], + [OCPP16RequestCommand.DATA_TRANSFER, this.emptyResponseHandler], + [OCPP16RequestCommand.FIRMWARE_STATUS_NOTIFICATION, this.emptyResponseHandler] + ]) + this.jsonSchemasValidateFunction = new Map>([ + [ + OCPP16RequestCommand.BOOT_NOTIFICATION, + this.ajv + .compile( + OCPP16ServiceUtils.parseJsonSchemaFile( + 'assets/json-schemas/ocpp/1.6/BootNotificationResponse.json', + moduleName, + 'constructor' + ) + ) + .bind(this) + ], + [ + OCPP16RequestCommand.HEARTBEAT, + this.ajv + .compile( + OCPP16ServiceUtils.parseJsonSchemaFile( + 'assets/json-schemas/ocpp/1.6/HeartbeatResponse.json', + moduleName, + 'constructor' + ) + ) + .bind(this) + ], + [ + OCPP16RequestCommand.AUTHORIZE, + this.ajv + .compile( + OCPP16ServiceUtils.parseJsonSchemaFile( + 'assets/json-schemas/ocpp/1.6/AuthorizeResponse.json', + moduleName, + 'constructor' + ) + ) + .bind(this) + ], + [ + OCPP16RequestCommand.START_TRANSACTION, + this.ajv + .compile( + OCPP16ServiceUtils.parseJsonSchemaFile( + 'assets/json-schemas/ocpp/1.6/StartTransactionResponse.json', + moduleName, + 'constructor' + ) + ) + .bind(this) + ], + [ + OCPP16RequestCommand.STOP_TRANSACTION, + this.ajv + .compile( + OCPP16ServiceUtils.parseJsonSchemaFile( + 'assets/json-schemas/ocpp/1.6/StopTransactionResponse.json', + moduleName, + 'constructor' + ) + ) + .bind(this) + ], + [ + OCPP16RequestCommand.STATUS_NOTIFICATION, + this.ajv + .compile( + OCPP16ServiceUtils.parseJsonSchemaFile( + 'assets/json-schemas/ocpp/1.6/StatusNotificationResponse.json', + moduleName, + 'constructor' + ) + ) + .bind(this) + ], + [ + OCPP16RequestCommand.METER_VALUES, + this.ajv + .compile( + OCPP16ServiceUtils.parseJsonSchemaFile( + 'assets/json-schemas/ocpp/1.6/MeterValuesResponse.json', + moduleName, + 'constructor' + ) + ) + .bind(this) + ], + [ + OCPP16RequestCommand.DIAGNOSTICS_STATUS_NOTIFICATION, + this.ajv + .compile( + OCPP16ServiceUtils.parseJsonSchemaFile( + 'assets/json-schemas/ocpp/1.6/DiagnosticsStatusNotificationResponse.json', + moduleName, + 'constructor' + ) + ) + .bind(this) + ], + [ + OCPP16RequestCommand.DATA_TRANSFER, + this.ajv + .compile( + OCPP16ServiceUtils.parseJsonSchemaFile( + 'assets/json-schemas/ocpp/1.6/DataTransferResponse.json', + moduleName, + 'constructor' + ) + ) + .bind(this) + ], + [ + OCPP16RequestCommand.FIRMWARE_STATUS_NOTIFICATION, + this.ajv + .compile( + OCPP16ServiceUtils.parseJsonSchemaFile( + 'assets/json-schemas/ocpp/1.6/FirmwareStatusNotificationResponse.json', + moduleName, + 'constructor' + ) + ) + .bind(this) + ] + ]) + this.jsonSchemasIncomingRequestResponseValidateFunction = new Map< + OCPP16IncomingRequestCommand, + ValidateFunction + >([ + [ + OCPP16IncomingRequestCommand.RESET, + this.ajvIncomingRequest + .compile( + OCPP16ServiceUtils.parseJsonSchemaFile( + 'assets/json-schemas/ocpp/1.6/ResetResponse.json', + moduleName, + 'constructor' + ) + ) + .bind(this) + ], + [ + OCPP16IncomingRequestCommand.CLEAR_CACHE, + this.ajvIncomingRequest + .compile( + OCPP16ServiceUtils.parseJsonSchemaFile( + 'assets/json-schemas/ocpp/1.6/ClearCacheResponse.json', + moduleName, + 'constructor' + ) + ) + .bind(this) + ], + [ + OCPP16IncomingRequestCommand.CHANGE_AVAILABILITY, + this.ajvIncomingRequest + .compile( + OCPP16ServiceUtils.parseJsonSchemaFile( + 'assets/json-schemas/ocpp/1.6/ChangeAvailabilityResponse.json', + moduleName, + 'constructor' + ) + ) + .bind(this) + ], + [ + OCPP16IncomingRequestCommand.UNLOCK_CONNECTOR, + this.ajvIncomingRequest + .compile( + OCPP16ServiceUtils.parseJsonSchemaFile( + 'assets/json-schemas/ocpp/1.6/UnlockConnectorResponse.json', + moduleName, + 'constructor' + ) + ) + .bind(this) + ], + [ + OCPP16IncomingRequestCommand.GET_CONFIGURATION, + this.ajvIncomingRequest + .compile( + OCPP16ServiceUtils.parseJsonSchemaFile( + 'assets/json-schemas/ocpp/1.6/GetConfigurationResponse.json', + moduleName, + 'constructor' + ) + ) + .bind(this) + ], + [ + OCPP16IncomingRequestCommand.CHANGE_CONFIGURATION, + this.ajvIncomingRequest + .compile( + OCPP16ServiceUtils.parseJsonSchemaFile( + 'assets/json-schemas/ocpp/1.6/ChangeConfigurationResponse.json', + moduleName, + 'constructor' + ) + ) + .bind(this) + ], + [ + OCPP16IncomingRequestCommand.GET_COMPOSITE_SCHEDULE, + this.ajvIncomingRequest + .compile( + OCPP16ServiceUtils.parseJsonSchemaFile( + 'assets/json-schemas/ocpp/1.6/GetCompositeScheduleResponse.json', + moduleName, + 'constructor' + ) + ) + .bind(this) + ], + [ + OCPP16IncomingRequestCommand.SET_CHARGING_PROFILE, + this.ajvIncomingRequest + .compile( + OCPP16ServiceUtils.parseJsonSchemaFile( + 'assets/json-schemas/ocpp/1.6/SetChargingProfileResponse.json', + moduleName, + 'constructor' + ) + ) + .bind(this) + ], + [ + OCPP16IncomingRequestCommand.CLEAR_CHARGING_PROFILE, + this.ajvIncomingRequest + .compile( + OCPP16ServiceUtils.parseJsonSchemaFile( + 'assets/json-schemas/ocpp/1.6/ClearChargingProfileResponse.json', + moduleName, + 'constructor' + ) + ) + .bind(this) + ], + [ + OCPP16IncomingRequestCommand.REMOTE_START_TRANSACTION, + this.ajvIncomingRequest + .compile( + OCPP16ServiceUtils.parseJsonSchemaFile( + 'assets/json-schemas/ocpp/1.6/RemoteStartTransactionResponse.json', + moduleName, + 'constructor' + ) + ) + .bind(this) + ], + [ + OCPP16IncomingRequestCommand.REMOTE_STOP_TRANSACTION, + this.ajvIncomingRequest + .compile( + OCPP16ServiceUtils.parseJsonSchemaFile( + 'assets/json-schemas/ocpp/1.6/RemoteStopTransactionResponse.json', + moduleName, + 'constructor' + ) + ) + .bind(this) + ], + [ + OCPP16IncomingRequestCommand.GET_DIAGNOSTICS, + this.ajvIncomingRequest + .compile( + OCPP16ServiceUtils.parseJsonSchemaFile( + 'assets/json-schemas/ocpp/1.6/GetDiagnosticsResponse.json', + moduleName, + 'constructor' + ) + ) + .bind(this) + ], + [ + OCPP16IncomingRequestCommand.TRIGGER_MESSAGE, + this.ajvIncomingRequest + .compile( + OCPP16ServiceUtils.parseJsonSchemaFile( + 'assets/json-schemas/ocpp/1.6/TriggerMessageResponse.json', + moduleName, + 'constructor' + ) + ) + .bind(this) + ], + [ + OCPP16IncomingRequestCommand.DATA_TRANSFER, + this.ajvIncomingRequest + .compile( + OCPP16ServiceUtils.parseJsonSchemaFile( + 'assets/json-schemas/ocpp/1.6/DataTransferResponse.json', + moduleName, + 'constructor' + ) + ) + .bind(this) + ], + [ + OCPP16IncomingRequestCommand.UPDATE_FIRMWARE, + this.ajvIncomingRequest + .compile( + OCPP16ServiceUtils.parseJsonSchemaFile( + 'assets/json-schemas/ocpp/1.6/UpdateFirmwareResponse.json', + moduleName, + 'constructor' + ) + ) + .bind(this) + ], + [ + OCPP16IncomingRequestCommand.RESERVE_NOW, + this.ajvIncomingRequest + .compile( + OCPP16ServiceUtils.parseJsonSchemaFile( + 'assets/json-schemas/ocpp/1.6/ReserveNowResponse.json', + moduleName, + 'constructor' + ) + ) + .bind(this) + ], + [ + OCPP16IncomingRequestCommand.CANCEL_RESERVATION, + this.ajvIncomingRequest + .compile( + OCPP16ServiceUtils.parseJsonSchemaFile( + 'assets/json-schemas/ocpp/1.6/CancelReservationResponse.json', + moduleName, + 'constructor' + ) + ) + .bind(this) + ] + ]) + this.validatePayload = this.validatePayload.bind(this) } - public async handleResponse( + public async responseHandler( + chargingStation: ChargingStation, commandName: OCPP16RequestCommand, - payload: JsonType | string, - requestPayload: JsonType + payload: ResType, + requestPayload: ReqType ): Promise { - if ( - this.chargingStation.isRegistered() || - commandName === OCPP16RequestCommand.BOOT_NOTIFICATION - ) { - if (this.responseHandlers.has(commandName)) { + if (chargingStation.isRegistered() || commandName === OCPP16RequestCommand.BOOT_NOTIFICATION) { + if ( + this.responseHandlers.has(commandName) && + OCPP16ServiceUtils.isRequestCommandSupported(chargingStation, commandName) + ) { try { - await this.responseHandlers.get(commandName)(payload, requestPayload); + this.validatePayload(chargingStation, commandName, payload) + // eslint-disable-next-line @typescript-eslint/no-non-null-assertion + await this.responseHandlers.get(commandName)!(chargingStation, payload, requestPayload) } catch (error) { logger.error( - this.chargingStation.logPrefix() + ' Handle request response error: %j', + `${chargingStation.logPrefix()} ${moduleName}.responseHandler: Handle response error:`, error - ); - throw error; + ) + throw error } } else { // Throw exception throw new OCPPError( ErrorType.NOT_IMPLEMENTED, - `${commandName} is not implemented to handle request response payload ${JSON.stringify( + `${commandName} is not implemented to handle response PDU ${JSON.stringify( payload, - null, + undefined, 2 )}`, - commandName - ); + commandName, + payload + ) } } else { throw new OCPPError( ErrorType.SECURITY_ERROR, - `${commandName} cannot be issued to handle request response payload ${JSON.stringify( + `${commandName} cannot be issued to handle response PDU ${JSON.stringify( payload, - null, + undefined, 2 - )} while the charging station is not registered on the central server. `, - commandName - ); + )} while the charging station is not registered on the central server.`, + commandName, + payload + ) } } - private handleResponseBootNotification(payload: OCPP16BootNotificationResponse): void { - if (payload.status === OCPP16RegistrationStatus.ACCEPTED) { - this.chargingStation.addConfigurationKey( - OCPP16StandardParametersKey.HeartBeatInterval, - payload.interval.toString() - ); - this.chargingStation.addConfigurationKey( + private validatePayload ( + chargingStation: ChargingStation, + commandName: OCPP16RequestCommand, + payload: JsonType + ): boolean { + if (this.jsonSchemasValidateFunction.has(commandName)) { + return this.validateResponsePayload(chargingStation, commandName, payload) + } + logger.warn( + `${chargingStation.logPrefix()} ${moduleName}.validatePayload: No JSON schema validation function found for command '${commandName}' PDU validation` + ) + return false + } + + private handleResponseBootNotification ( + chargingStation: ChargingStation, + payload: OCPP16BootNotificationResponse + ): void { + if (payload.status === RegistrationStatusEnumType.ACCEPTED) { + addConfigurationKey( + chargingStation, OCPP16StandardParametersKey.HeartbeatInterval, payload.interval.toString(), - { visible: false } - ); - this.chargingStation.heartbeatSetInterval - ? this.chargingStation.restartHeartbeat() - : this.chargingStation.startHeartbeat(); + {}, + { overwrite: true, save: true } + ) + addConfigurationKey( + chargingStation, + OCPP16StandardParametersKey.HeartBeatInterval, + payload.interval.toString(), + { visible: false }, + { overwrite: true, save: true } + ) + OCPP16ServiceUtils.startHeartbeatInterval(chargingStation, payload.interval) } - if (Object.values(OCPP16RegistrationStatus).includes(payload.status)) { - const logMsg = `${this.chargingStation.logPrefix()} Charging station in '${ + if (Object.values(RegistrationStatusEnumType).includes(payload.status)) { + const logMsg = `${chargingStation.logPrefix()} Charging station in '${ payload.status - }' state on the central server`; - payload.status === OCPP16RegistrationStatus.REJECTED + }' state on the central server` + payload.status === RegistrationStatusEnumType.REJECTED ? logger.warn(logMsg) - : logger.info(logMsg); + : logger.info(logMsg) } else { logger.error( - this.chargingStation.logPrefix() + - ' Charging station boot notification response received: %j with undefined registration status', + `${chargingStation.logPrefix()} Charging station boot notification response received: %j with undefined registration status`, payload - ); + ) } } - private handleResponseHeartbeat( - payload: HeartbeatResponse, - requestPayload: HeartbeatRequest - ): void { - logger.debug( - this.chargingStation.logPrefix() + - ' Heartbeat response received: %j to Heartbeat request: %j', - payload, - requestPayload - ); - } - - private handleResponseAuthorize( + private handleResponseAuthorize ( + chargingStation: ChargingStation, payload: OCPP16AuthorizeResponse, - requestPayload: AuthorizeRequest + requestPayload: OCPP16AuthorizeRequest ): void { - let authorizeConnectorId: number; - for (const connectorId of this.chargingStation.connectors.keys()) { - if ( - connectorId > 0 && - this.chargingStation.getConnectorStatus(connectorId)?.authorizeIdTag === - requestPayload.idTag - ) { - authorizeConnectorId = connectorId; - break; + let authorizeConnectorId: number | undefined + if (chargingStation.hasEvses) { + for (const [evseId, evseStatus] of chargingStation.evses) { + if (evseId > 0) { + for (const [connectorId, connectorStatus] of evseStatus.connectors) { + if (connectorStatus.authorizeIdTag === requestPayload.idTag) { + authorizeConnectorId = connectorId + break + } + } + } + } + } else { + for (const connectorId of chargingStation.connectors.keys()) { + if ( + connectorId > 0 && + chargingStation.getConnectorStatus(connectorId)?.authorizeIdTag === requestPayload.idTag + ) { + authorizeConnectorId = connectorId + break + } } } - if (payload.idTagInfo.status === OCPP16AuthorizationStatus.ACCEPTED) { - this.chargingStation.getConnectorStatus(authorizeConnectorId).idTagAuthorized = true; - logger.debug( - `${this.chargingStation.logPrefix()} IdTag ${ - requestPayload.idTag - } authorized on connector ${authorizeConnectorId}` - ); + if (authorizeConnectorId != null) { + // eslint-disable-next-line @typescript-eslint/no-non-null-assertion + const authorizeConnectorStatus = chargingStation.getConnectorStatus(authorizeConnectorId)! + if (payload.idTagInfo.status === OCPP16AuthorizationStatus.ACCEPTED) { + authorizeConnectorStatus.idTagAuthorized = true + logger.debug( + `${chargingStation.logPrefix()} idTag '${ + requestPayload.idTag + }' accepted on connector id ${authorizeConnectorId}` + ) + } else { + authorizeConnectorStatus.idTagAuthorized = false + delete authorizeConnectorStatus.authorizeIdTag + logger.debug( + `${chargingStation.logPrefix()} idTag '${requestPayload.idTag}' rejected with status '${ + payload.idTagInfo.status + }` + ) + } } else { - this.chargingStation.getConnectorStatus(authorizeConnectorId).idTagAuthorized = false; - delete this.chargingStation.getConnectorStatus(authorizeConnectorId).authorizeIdTag; - logger.debug( - `${this.chargingStation.logPrefix()} IdTag ${requestPayload.idTag} refused with status ${ - payload.idTagInfo.status - } on connector ${authorizeConnectorId}` - ); + logger.error( + `${chargingStation.logPrefix()} idTag '${ + requestPayload.idTag + }' has no authorize request pending` + ) } } - private async handleResponseStartTransaction( + private async handleResponseStartTransaction ( + chargingStation: ChargingStation, payload: OCPP16StartTransactionResponse, - requestPayload: StartTransactionRequest + requestPayload: OCPP16StartTransactionRequest ): Promise { - const connectorId = requestPayload.connectorId; - - let transactionConnectorId: number; - for (const id of this.chargingStation.connectors.keys()) { - if (id > 0 && id === connectorId) { - transactionConnectorId = id; - break; - } - } - if (!transactionConnectorId) { + const { connectorId } = requestPayload + if (connectorId === 0 || !chargingStation.hasConnector(connectorId)) { logger.error( - this.chargingStation.logPrefix() + - ' Trying to start a transaction on a non existing connector Id ' + - connectorId.toString() - ); - return; + `${chargingStation.logPrefix()} Trying to start a transaction on a non existing connector id ${connectorId}` + ) + return } + const connectorStatus = chargingStation.getConnectorStatus(connectorId) if ( - this.chargingStation.getConnectorStatus(connectorId).transactionRemoteStarted && - this.chargingStation.getAuthorizeRemoteTxRequests() && - this.chargingStation.getLocalAuthListEnabled() && - this.chargingStation.hasAuthorizedTags() && - !this.chargingStation.getConnectorStatus(connectorId).idTagLocalAuthorized + connectorStatus?.transactionRemoteStarted === true && + chargingStation.getAuthorizeRemoteTxRequests() && + chargingStation.getLocalAuthListEnabled() && + chargingStation.hasIdTags() && + connectorStatus.idTagLocalAuthorized === false ) { logger.error( - this.chargingStation.logPrefix() + - ' Trying to start a transaction with a not local authorized idTag ' + - this.chargingStation.getConnectorStatus(connectorId).localAuthorizeIdTag + - ' on connector Id ' + - connectorId.toString() - ); - await this.resetConnectorOnStartTransactionError(connectorId); - return; + `${chargingStation.logPrefix()} Trying to start a transaction with a not local authorized idTag ${ + connectorStatus.localAuthorizeIdTag + } on connector id ${connectorId}` + ) + await this.resetConnectorOnStartTransactionError(chargingStation, connectorId) + return } if ( - this.chargingStation.getConnectorStatus(connectorId).transactionRemoteStarted && - this.chargingStation.getAuthorizeRemoteTxRequests() && - this.chargingStation.getMayAuthorizeAtRemoteStart() && - !this.chargingStation.getConnectorStatus(connectorId).idTagLocalAuthorized && - !this.chargingStation.getConnectorStatus(connectorId).idTagAuthorized + connectorStatus?.transactionRemoteStarted === true && + chargingStation.getAuthorizeRemoteTxRequests() && + chargingStation.stationInfo?.remoteAuthorization === true && + connectorStatus.idTagLocalAuthorized === false && + connectorStatus.idTagAuthorized === false ) { logger.error( - this.chargingStation.logPrefix() + - ' Trying to start a transaction with a not authorized idTag ' + - this.chargingStation.getConnectorStatus(connectorId).authorizeIdTag + - ' on connector Id ' + - connectorId.toString() - ); - await this.resetConnectorOnStartTransactionError(connectorId); - return; + `${chargingStation.logPrefix()} Trying to start a transaction with a not authorized idTag ${ + connectorStatus.authorizeIdTag + } on connector id ${connectorId}` + ) + await this.resetConnectorOnStartTransactionError(chargingStation, connectorId) + return } if ( - this.chargingStation.getConnectorStatus(connectorId).idTagAuthorized && - this.chargingStation.getConnectorStatus(connectorId).authorizeIdTag !== requestPayload.idTag + connectorStatus?.idTagAuthorized === true && + connectorStatus.authorizeIdTag !== requestPayload.idTag ) { logger.error( - this.chargingStation.logPrefix() + - ' Trying to start a transaction with an idTag ' + - requestPayload.idTag + - ' different from the authorize request one ' + - this.chargingStation.getConnectorStatus(connectorId).authorizeIdTag + - ' on connector Id ' + - connectorId.toString() - ); - await this.resetConnectorOnStartTransactionError(connectorId); - return; + `${chargingStation.logPrefix()} Trying to start a transaction with an idTag ${ + requestPayload.idTag + } different from the authorize request one ${ + connectorStatus.authorizeIdTag + } on connector id ${connectorId}` + ) + await this.resetConnectorOnStartTransactionError(chargingStation, connectorId) + return } if ( - this.chargingStation.getConnectorStatus(connectorId).idTagLocalAuthorized && - this.chargingStation.getConnectorStatus(connectorId).localAuthorizeIdTag !== - requestPayload.idTag + connectorStatus?.idTagLocalAuthorized === true && + connectorStatus.localAuthorizeIdTag !== requestPayload.idTag ) { logger.error( - this.chargingStation.logPrefix() + - ' Trying to start a transaction with an idTag ' + - requestPayload.idTag + - ' different from the local authorized one ' + - this.chargingStation.getConnectorStatus(connectorId).localAuthorizeIdTag + - ' on connector Id ' + - connectorId.toString() - ); - await this.resetConnectorOnStartTransactionError(connectorId); - return; + `${chargingStation.logPrefix()} Trying to start a transaction with an idTag ${ + requestPayload.idTag + } different from the local authorized one ${ + connectorStatus.localAuthorizeIdTag + } on connector id ${connectorId}` + ) + await this.resetConnectorOnStartTransactionError(chargingStation, connectorId) + return + } + if (connectorStatus?.transactionStarted === true) { + logger.error( + `${chargingStation.logPrefix()} Trying to start a transaction on an already used connector id ${connectorId} by idTag ${ + connectorStatus.transactionIdTag + }` + ) + return } - if (this.chargingStation.getConnectorStatus(connectorId)?.transactionStarted) { - logger.debug( - this.chargingStation.logPrefix() + - ' Trying to start a transaction on an already used connector ' + - connectorId.toString() + - ': %j', - this.chargingStation.getConnectorStatus(connectorId) - ); - return; + if (chargingStation.hasEvses) { + for (const [evseId, evseStatus] of chargingStation.evses) { + if (evseStatus.connectors.size > 1) { + for (const [id, status] of evseStatus.connectors) { + if (id !== connectorId && status.transactionStarted === true) { + logger.error( + `${chargingStation.logPrefix()} Trying to start a transaction on an already used evse id ${evseId} by connector id ${id} with idTag ${ + status.transactionIdTag + }` + ) + await this.resetConnectorOnStartTransactionError(chargingStation, connectorId) + return + } + } + } + } } if ( - this.chargingStation.getConnectorStatus(connectorId)?.status !== - OCPP16ChargePointStatus.AVAILABLE && - this.chargingStation.getConnectorStatus(connectorId)?.status !== - OCPP16ChargePointStatus.PREPARING + connectorStatus?.status !== OCPP16ChargePointStatus.Available && + connectorStatus?.status !== OCPP16ChargePointStatus.Preparing ) { logger.error( - `${this.chargingStation.logPrefix()} Trying to start a transaction on connector ${connectorId.toString()} with status ${ - this.chargingStation.getConnectorStatus(connectorId)?.status - }` - ); - return; + `${chargingStation.logPrefix()} Trying to start a transaction on connector id ${connectorId} with status ${connectorStatus?.status}` + ) + return } - if (!Number.isInteger(payload.transactionId)) { + if (!Number.isSafeInteger(payload.transactionId)) { logger.warn( - `${this.chargingStation.logPrefix()} Trying to start a transaction on connector ${connectorId.toString()} with a non integer transaction Id ${ + `${chargingStation.logPrefix()} Trying to start a transaction on connector id ${connectorId} with a non integer transaction id ${ payload.transactionId }, converting to integer` - ); - payload.transactionId = Utils.convertToInt(payload.transactionId); + ) + payload.transactionId = convertToInt(payload.transactionId) } - if (payload.idTagInfo?.status === OCPP16AuthorizationStatus.ACCEPTED) { - this.chargingStation.getConnectorStatus(connectorId).transactionStarted = true; - this.chargingStation.getConnectorStatus(connectorId).transactionId = payload.transactionId; - this.chargingStation.getConnectorStatus(connectorId).transactionIdTag = requestPayload.idTag; - this.chargingStation.getConnectorStatus( - connectorId - ).transactionEnergyActiveImportRegisterValue = 0; - this.chargingStation.getConnectorStatus(connectorId).transactionBeginMeterValue = + if (payload.idTagInfo.status === OCPP16AuthorizationStatus.ACCEPTED) { + connectorStatus.transactionStarted = true + connectorStatus.transactionStart = requestPayload.timestamp + connectorStatus.transactionId = payload.transactionId + connectorStatus.transactionIdTag = requestPayload.idTag + connectorStatus.transactionEnergyActiveImportRegisterValue = 0 + connectorStatus.transactionBeginMeterValue = OCPP16ServiceUtils.buildTransactionBeginMeterValue( - this.chargingStation, + chargingStation, connectorId, requestPayload.meterStart - ); - this.chargingStation.getBeginEndMeterValues() && - (await this.chargingStation.ocppRequestService.sendTransactionBeginMeterValues( + ) + if (requestPayload.reservationId != null) { + const reservation = chargingStation.getReservationBy( + 'reservationId', + requestPayload.reservationId + ) + if (reservation != null) { + if (reservation.idTag !== requestPayload.idTag) { + logger.warn( + `${chargingStation.logPrefix()} Reserved transaction ${ + payload.transactionId + } started with a different idTag ${requestPayload.idTag} than the reservation one ${ + reservation.idTag + }` + ) + } + if (hasReservationExpired(reservation)) { + logger.warn( + `${chargingStation.logPrefix()} Reserved transaction ${ + payload.transactionId + } started with expired reservation ${ + requestPayload.reservationId + } (expiry date: ${reservation.expiryDate.toISOString()}))` + ) + } + await chargingStation.removeReservation( + reservation, + ReservationTerminationReason.TRANSACTION_STARTED + ) + } else { + logger.warn( + `${chargingStation.logPrefix()} Reserved transaction ${ + payload.transactionId + } started with unknown reservation ${requestPayload.reservationId}` + ) + } + } + chargingStation.stationInfo?.beginEndMeterValues === true && + (await chargingStation.ocppRequestService.requestHandler< + OCPP16MeterValuesRequest, + OCPP16MeterValuesResponse + >(chargingStation, OCPP16RequestCommand.METER_VALUES, { connectorId, - payload.transactionId, - this.chargingStation.getConnectorStatus(connectorId).transactionBeginMeterValue - )); - await this.chargingStation.ocppRequestService.sendStatusNotification( + transactionId: payload.transactionId, + meterValue: [connectorStatus.transactionBeginMeterValue] + } satisfies OCPP16MeterValuesRequest)) + await OCPP16ServiceUtils.sendAndSetConnectorStatus( + chargingStation, connectorId, - OCPP16ChargePointStatus.CHARGING - ); - this.chargingStation.getConnectorStatus(connectorId).status = - OCPP16ChargePointStatus.CHARGING; + OCPP16ChargePointStatus.Charging + ) logger.info( - this.chargingStation.logPrefix() + - ' Transaction ' + - payload.transactionId.toString() + - ' STARTED on ' + - this.chargingStation.stationInfo.chargingStationId + - '#' + - connectorId.toString() + - ' for idTag ' + + `${chargingStation.logPrefix()} Transaction with id ${ + payload.transactionId + } STARTED on ${chargingStation.stationInfo?.chargingStationId}#${connectorId} for idTag '${ requestPayload.idTag - ); - if (this.chargingStation.stationInfo.powerSharedByConnectors) { - this.chargingStation.stationInfo.powerDivider++; + }'` + ) + if (chargingStation.stationInfo?.powerSharedByConnectors === true) { + // eslint-disable-next-line @typescript-eslint/no-non-null-assertion + ++chargingStation.powerDivider! } - const configuredMeterValueSampleInterval = this.chargingStation.getConfigurationKey( + const configuredMeterValueSampleInterval = getConfigurationKey( + chargingStation, OCPP16StandardParametersKey.MeterValueSampleInterval - ); - this.chargingStation.startMeterValues( + ) + chargingStation.startMeterValues( connectorId, - configuredMeterValueSampleInterval - ? Utils.convertToInt(configuredMeterValueSampleInterval.value) * 1000 - : 60000 - ); + configuredMeterValueSampleInterval != null + ? secondsToMilliseconds(convertToInt(configuredMeterValueSampleInterval.value)) + : Constants.DEFAULT_METER_VALUES_INTERVAL + ) } else { logger.warn( - this.chargingStation.logPrefix() + - ' Starting transaction id ' + - payload.transactionId.toString() + - ' REJECTED with status ' + - payload?.idTagInfo?.status + - ', idTag ' + + `${chargingStation.logPrefix()} Starting transaction with id ${ + payload.transactionId + } REJECTED on ${ + chargingStation.stationInfo?.chargingStationId + }#${connectorId} with status '${payload.idTagInfo.status}', idTag '${ requestPayload.idTag - ); - await this.resetConnectorOnStartTransactionError(connectorId); + }'${ + OCPP16ServiceUtils.hasReservation(chargingStation, connectorId, requestPayload.idTag) + ? `, reservationId '${requestPayload.reservationId}'` + : '' + }` + ) + await this.resetConnectorOnStartTransactionError(chargingStation, connectorId) } } - private async resetConnectorOnStartTransactionError(connectorId: number): Promise { - this.chargingStation.resetConnectorStatus(connectorId); - if ( - this.chargingStation.getConnectorStatus(connectorId).status !== - OCPP16ChargePointStatus.AVAILABLE - ) { - await this.chargingStation.ocppRequestService.sendStatusNotification( + private async resetConnectorOnStartTransactionError ( + chargingStation: ChargingStation, + connectorId: number + ): Promise { + const connectorStatus = chargingStation.getConnectorStatus(connectorId) + resetConnectorStatus(connectorStatus) + chargingStation.stopMeterValues(connectorId) + if (connectorStatus?.status !== OCPP16ChargePointStatus.Available) { + await OCPP16ServiceUtils.sendAndSetConnectorStatus( + chargingStation, connectorId, - OCPP16ChargePointStatus.AVAILABLE - ); - this.chargingStation.getConnectorStatus(connectorId).status = - OCPP16ChargePointStatus.AVAILABLE; + OCPP16ChargePointStatus.Available + ) } } - private async handleResponseStopTransaction( + private async handleResponseStopTransaction ( + chargingStation: ChargingStation, payload: OCPP16StopTransactionResponse, - requestPayload: StopTransactionRequest + requestPayload: OCPP16StopTransactionRequest ): Promise { - let transactionConnectorId: number; - for (const connectorId of this.chargingStation.connectors.keys()) { - if ( - connectorId > 0 && - this.chargingStation.getConnectorStatus(connectorId)?.transactionId === - requestPayload.transactionId - ) { - transactionConnectorId = connectorId; - break; - } - } - if (!transactionConnectorId) { + const transactionConnectorId = chargingStation.getConnectorIdByTransactionId( + requestPayload.transactionId + ) + if (transactionConnectorId == null) { logger.error( - this.chargingStation.logPrefix() + - ' Trying to stop a non existing transaction ' + - requestPayload.transactionId.toString() - ); - return; + `${chargingStation.logPrefix()} Trying to stop a non existing transaction with id ${ + requestPayload.transactionId + }` + ) + return } - if (payload.idTagInfo?.status === OCPP16AuthorizationStatus.ACCEPTED) { - this.chargingStation.getBeginEndMeterValues() && - !this.chargingStation.getOcppStrictCompliance() && - this.chargingStation.getOutOfOrderEndMeterValues() && - (await this.chargingStation.ocppRequestService.sendTransactionEndMeterValues( - transactionConnectorId, - requestPayload.transactionId, + chargingStation.stationInfo?.beginEndMeterValues === true && + chargingStation.stationInfo.ocppStrictCompliance === false && + chargingStation.stationInfo.outOfOrderEndMeterValues === true && + (await chargingStation.ocppRequestService.requestHandler< + OCPP16MeterValuesRequest, + OCPP16MeterValuesResponse + >(chargingStation, OCPP16RequestCommand.METER_VALUES, { + connectorId: transactionConnectorId, + transactionId: requestPayload.transactionId, + meterValue: [ OCPP16ServiceUtils.buildTransactionEndMeterValue( - this.chargingStation, + chargingStation, transactionConnectorId, requestPayload.meterStop ) - )); - if ( - !this.chargingStation.isChargingStationAvailable() || - !this.chargingStation.isConnectorAvailable(transactionConnectorId) - ) { - await this.chargingStation.ocppRequestService.sendStatusNotification( - transactionConnectorId, - OCPP16ChargePointStatus.UNAVAILABLE - ); - this.chargingStation.getConnectorStatus(transactionConnectorId).status = - OCPP16ChargePointStatus.UNAVAILABLE; - } else { - await this.chargingStation.ocppRequestService.sendStatusNotification( - transactionConnectorId, - OCPP16ChargePointStatus.AVAILABLE - ); - this.chargingStation.getConnectorStatus(transactionConnectorId).status = - OCPP16ChargePointStatus.AVAILABLE; - } - if (this.chargingStation.stationInfo.powerSharedByConnectors) { - this.chargingStation.stationInfo.powerDivider--; - } - logger.info( - this.chargingStation.logPrefix() + - ' Transaction ' + - requestPayload.transactionId.toString() + - ' STOPPED on ' + - this.chargingStation.stationInfo.chargingStationId + - '#' + - transactionConnectorId.toString() - ); - this.chargingStation.resetConnectorStatus(transactionConnectorId); + ] + })) + if ( + !chargingStation.isChargingStationAvailable() || + !chargingStation.isConnectorAvailable(transactionConnectorId) + ) { + await OCPP16ServiceUtils.sendAndSetConnectorStatus( + chargingStation, + transactionConnectorId, + OCPP16ChargePointStatus.Unavailable + ) } else { - logger.warn( - this.chargingStation.logPrefix() + - ' Stopping transaction id ' + - requestPayload.transactionId.toString() + - ' REJECTED with status ' + - payload.idTagInfo?.status - ); + await OCPP16ServiceUtils.sendAndSetConnectorStatus( + chargingStation, + transactionConnectorId, + OCPP16ChargePointStatus.Available + ) + } + if (chargingStation.stationInfo?.powerSharedByConnectors === true) { + // eslint-disable-next-line @typescript-eslint/no-non-null-assertion + chargingStation.powerDivider!-- + } + resetConnectorStatus(chargingStation.getConnectorStatus(transactionConnectorId)) + chargingStation.stopMeterValues(transactionConnectorId) + const logMsg = `${chargingStation.logPrefix()} Transaction with id ${ + requestPayload.transactionId + } STOPPED on ${ + chargingStation.stationInfo?.chargingStationId + }#${transactionConnectorId} with status '${payload.idTagInfo?.status}'` + if ( + payload.idTagInfo == null || + payload.idTagInfo.status === OCPP16AuthorizationStatus.ACCEPTED + ) { + logger.info(logMsg) + } else { + logger.warn(logMsg) } - } - - private handleResponseStatusNotification( - payload: StatusNotificationRequest, - requestPayload: StatusNotificationResponse - ): void { - logger.debug( - this.chargingStation.logPrefix() + - ' Status notification response received: %j to StatusNotification request: %j', - payload, - requestPayload - ); - } - - private handleResponseMeterValues( - payload: MeterValuesRequest, - requestPayload: MeterValuesResponse - ): void { - logger.debug( - this.chargingStation.logPrefix() + - ' MeterValues response received: %j to MeterValues request: %j', - payload, - requestPayload - ); } }