X-Git-Url: https://git.piment-noir.org/?a=blobdiff_plain;f=src%2Fcharging-station%2FAutomaticTransactionGenerator.ts;h=3a1c6786f9b3c9fcf5cc93f522dd541b23c1e69e;hb=44eb6026079c8dc2c77b10a96a42d0c0b2da7c8f;hp=942410eba9c6115a5a8a6284c75b42eb4c9d5723;hpb=6ed92bc13120d78f84f2182ddbafd3cbcaa37359;p=e-mobility-charging-stations-simulator.git diff --git a/src/charging-station/AutomaticTransactionGenerator.ts b/src/charging-station/AutomaticTransactionGenerator.ts index 942410eb..3a1c6786 100644 --- a/src/charging-station/AutomaticTransactionGenerator.ts +++ b/src/charging-station/AutomaticTransactionGenerator.ts @@ -1,162 +1,465 @@ -import { AuthorizationStatus, AuthorizeResponse, StartTransactionResponse, StopTransactionReason, StopTransactionResponse } from '../types/ocpp/Transaction'; -import { PerformanceObserver, performance } from 'perf_hooks'; +// Partial Copyright Jerome Benoit. 2021-2023. All Rights Reserved. -import ChargingStation from './ChargingStation'; +import { AsyncResource } from 'async_hooks'; + +import type ChargingStation from './ChargingStation'; +import { ChargingStationUtils } from './ChargingStationUtils'; +import BaseError from '../exception/BaseError'; +import PerformanceStatistics from '../performance/PerformanceStatistics'; +import { + type AutomaticTransactionGeneratorConfiguration, + IdTagDistribution, + type Status, +} from '../types/AutomaticTransactionGenerator'; +import { RequestCommand } from '../types/ocpp/Requests'; +import { + AuthorizationStatus, + type AuthorizeRequest, + type AuthorizeResponse, + type StartTransactionRequest, + type StartTransactionResponse, + StopTransactionReason, + type StopTransactionResponse, +} from '../types/ocpp/Transaction'; import Constants from '../utils/Constants'; -import Utils from '../utils/Utils'; import logger from '../utils/Logger'; +import Utils from '../utils/Utils'; + +const moduleName = 'AutomaticTransactionGenerator'; -export default class AutomaticTransactionGenerator { - public timeToStop: boolean; - private chargingStation: ChargingStation; - private performanceObserver!: PerformanceObserver; +export default class AutomaticTransactionGenerator extends AsyncResource { + private static readonly instances: Map = new Map< + string, + AutomaticTransactionGenerator + >(); - constructor(chargingStation: ChargingStation) { + public readonly connectorsStatus: Map; + public readonly configuration: AutomaticTransactionGeneratorConfiguration; + public started: boolean; + private readonly chargingStation: ChargingStation; + private idTagIndex: number; + + private constructor( + automaticTransactionGeneratorConfiguration: AutomaticTransactionGeneratorConfiguration, + chargingStation: ChargingStation + ) { + super(moduleName); + this.started = false; + this.configuration = automaticTransactionGeneratorConfiguration; this.chargingStation = chargingStation; - this.timeToStop = true; - if (this.chargingStation.getEnableStatistics()) { - this.performanceObserver = new PerformanceObserver((list) => { - const entry = list.getEntries()[0]; - this.chargingStation.performanceStatistics.logPerformance(entry, Constants.ENTITY_AUTOMATIC_TRANSACTION_GENERATOR); - this.performanceObserver.disconnect(); + this.idTagIndex = 0; + this.connectorsStatus = new Map(); + this.initializeConnectorsStatus(); + } + + public static getInstance( + automaticTransactionGeneratorConfiguration: AutomaticTransactionGeneratorConfiguration, + chargingStation: ChargingStation + ): AutomaticTransactionGenerator { + if (AutomaticTransactionGenerator.instances.has(chargingStation.stationInfo.hashId) === false) { + AutomaticTransactionGenerator.instances.set( + chargingStation.stationInfo.hashId, + new AutomaticTransactionGenerator( + automaticTransactionGeneratorConfiguration, + chargingStation + ) + ); + } + return AutomaticTransactionGenerator.instances.get(chargingStation.stationInfo.hashId); + } + + public start(): void { + if (this.checkChargingStation() === false) { + return; + } + if (this.started === true) { + logger.warn(`${this.logPrefix()} is already started`); + return; + } + this.startConnectors(); + this.started = true; + } + + public stop(): void { + if (this.started === false) { + logger.warn(`${this.logPrefix()} is already stopped`); + return; + } + this.stopConnectors(); + this.started = false; + } + + public startConnector(connectorId: number): void { + if (this.checkChargingStation(connectorId) === false) { + return; + } + if (this.connectorsStatus.has(connectorId) === false) { + logger.error(`${this.logPrefix(connectorId)} starting on non existing connector`); + throw new BaseError(`Connector ${connectorId} does not exist`); + } + if (this.connectorsStatus.get(connectorId)?.start === false) { + this.runInAsyncScope( + this.internalStartConnector.bind(this) as ( + this: AutomaticTransactionGenerator, + ...args: any[] + ) => Promise, + this, + connectorId + ).catch(() => { + /* This is intentional */ }); + } else if (this.connectorsStatus.get(connectorId)?.start === true) { + logger.warn(`${this.logPrefix(connectorId)} is already started on connector`); } } - public async start(): Promise { - this.timeToStop = false; - if (this.chargingStation.stationInfo.AutomaticTransactionGenerator.stopAfterHours && - this.chargingStation.stationInfo.AutomaticTransactionGenerator.stopAfterHours > 0) { - // eslint-disable-next-line @typescript-eslint/no-misused-promises - setTimeout(async (): Promise => { - await this.stop(); - }, this.chargingStation.stationInfo.AutomaticTransactionGenerator.stopAfterHours * 3600 * 1000); + public stopConnector(connectorId: number): void { + if (this.connectorsStatus.has(connectorId) === false) { + logger.error(`${this.logPrefix(connectorId)} stopping on non existing connector`); + throw new BaseError(`Connector ${connectorId} does not exist`); + } + if (this.connectorsStatus.get(connectorId)?.start === true) { + this.connectorsStatus.get(connectorId).start = false; + } else if (this.connectorsStatus.get(connectorId)?.start === false) { + logger.warn(`${this.logPrefix(connectorId)} is already stopped on connector`); } - for (const connector in this.chargingStation.connectors) { - if (Utils.convertToInt(connector) > 0) { - await this.startConnector(Utils.convertToInt(connector)); + } + + private startConnectors(): void { + if ( + this.connectorsStatus?.size > 0 && + this.connectorsStatus.size !== this.chargingStation.getNumberOfConnectors() + ) { + this.connectorsStatus.clear(); + this.initializeConnectorsStatus(); + } + for (const connectorId of this.chargingStation.connectors.keys()) { + if (connectorId > 0) { + this.startConnector(connectorId); } } - logger.info(this.logPrefix() + ' ATG started and will stop in ' + Utils.secondsToHHMMSS(this.chargingStation.stationInfo.AutomaticTransactionGenerator.stopAfterHours * 3600)); } - public async stop(reason: StopTransactionReason = StopTransactionReason.NONE): Promise { - logger.info(this.logPrefix() + ' ATG OVER => STOPPING ALL TRANSACTIONS'); - for (const connector in this.chargingStation.connectors) { - const transactionId = this.chargingStation.getConnector(Utils.convertToInt(connector)).transactionId; - if (this.chargingStation.getConnector(Utils.convertToInt(connector)).transactionStarted) { - logger.info(this.logPrefix(Utils.convertToInt(connector)) + ' ATG OVER. Stop transaction ' + transactionId.toString()); - await this.chargingStation.ocppRequestService.sendStopTransaction(transactionId, this.chargingStation.getEnergyActiveImportRegisterByTransactionId(transactionId), - this.chargingStation.getTransactionIdTag(transactionId), reason); + private stopConnectors(): void { + for (const connectorId of this.chargingStation.connectors.keys()) { + if (connectorId > 0) { + this.stopConnector(connectorId); } } - this.timeToStop = true; } - private async startConnector(connectorId: number): Promise { - do { - if (this.timeToStop) { - logger.error(this.logPrefix(connectorId) + ' Entered in transaction loop while a request to stop it was made'); + private async internalStartConnector(connectorId: number): Promise { + this.setStartConnectorStatus(connectorId); + logger.info( + `${this.logPrefix( + connectorId + )} started on connector and will run for ${Utils.formatDurationMilliSeconds( + this.connectorsStatus.get(connectorId).stopDate.getTime() - + this.connectorsStatus.get(connectorId).startDate.getTime() + )}` + ); + while (this.connectorsStatus.get(connectorId).start === true) { + if (new Date() > this.connectorsStatus.get(connectorId).stopDate) { + this.stopConnector(connectorId); break; } - if (!this.chargingStation.isRegistered()) { - logger.error(this.logPrefix(connectorId) + ' Entered in transaction loop while the charging station is not registered'); + if (this.chargingStation.isInAcceptedState() === false) { + logger.error( + `${this.logPrefix( + connectorId + )} entered in transaction loop while the charging station is not in accepted state` + ); + this.stopConnector(connectorId); break; } - if (!this.chargingStation.isChargingStationAvailable()) { - logger.info(this.logPrefix(connectorId) + ' Entered in transaction loop while the charging station is unavailable'); - await this.stop(); + if (this.chargingStation.isChargingStationAvailable() === false) { + logger.info( + `${this.logPrefix( + connectorId + )} entered in transaction loop while the charging station is unavailable` + ); + this.stopConnector(connectorId); break; } - if (!this.chargingStation.isConnectorAvailable(connectorId)) { - logger.info(`${this.logPrefix(connectorId)} Entered in transaction loop while the connector ${connectorId} is unavailable, stop it`); + if (this.chargingStation.isConnectorAvailable(connectorId) === false) { + logger.info( + `${this.logPrefix( + connectorId + )} entered in transaction loop while the connector ${connectorId} is unavailable` + ); + this.stopConnector(connectorId); break; } if (!this.chargingStation?.ocppRequestService) { - logger.info(`${this.logPrefix(connectorId)} Transaction loop waiting for charging station service to be initialized`); + logger.info( + `${this.logPrefix( + connectorId + )} transaction loop waiting for charging station service to be initialized` + ); do { await Utils.sleep(Constants.CHARGING_STATION_ATG_INITIALIZATION_TIME); } while (!this.chargingStation?.ocppRequestService); } - const wait = Utils.getRandomInt(this.chargingStation.stationInfo.AutomaticTransactionGenerator.maxDelayBetweenTwoTransactions, - this.chargingStation.stationInfo.AutomaticTransactionGenerator.minDelayBetweenTwoTransactions) * 1000; - logger.info(this.logPrefix(connectorId) + ' wait for ' + Utils.milliSecondsToHHMMSS(wait)); + const wait = + Utils.getRandomInteger( + this.configuration.maxDelayBetweenTwoTransactions, + this.configuration.minDelayBetweenTwoTransactions + ) * 1000; + logger.info( + `${this.logPrefix(connectorId)} waiting for ${Utils.formatDurationMilliSeconds(wait)}` + ); await Utils.sleep(wait); - const start = Math.random(); - let skip = 0; - if (start < this.chargingStation.stationInfo.AutomaticTransactionGenerator.probabilityOfStart) { - skip = 0; + const start = Utils.secureRandom(); + if (start < this.configuration.probabilityOfStart) { + this.connectorsStatus.get(connectorId).skippedConsecutiveTransactions = 0; // Start transaction - let startResponse: StartTransactionResponse | AuthorizeResponse; - if (this.chargingStation.getEnableStatistics()) { - const startTransaction = performance.timerify(this.startTransaction); - this.performanceObserver.observe({ entryTypes: ['function'] }); - startResponse = await startTransaction(connectorId, this); - } else { - startResponse = await this.startTransaction(connectorId, this); - } - if (startResponse?.idTagInfo?.status !== AuthorizationStatus.ACCEPTED) { - logger.warn(this.logPrefix(connectorId) + ' transaction rejected'); - await Utils.sleep(Constants.CHARGING_STATION_ATG_WAIT_TIME); - } else { + const startResponse = await this.startTransaction(connectorId); + if (startResponse?.idTagInfo?.status === AuthorizationStatus.ACCEPTED) { // Wait until end of transaction - const waitTrxEnd = Utils.getRandomInt(this.chargingStation.stationInfo.AutomaticTransactionGenerator.maxDuration, - this.chargingStation.stationInfo.AutomaticTransactionGenerator.minDuration) * 1000; - logger.info(this.logPrefix(connectorId) + ' transaction ' + this.chargingStation.getConnector(connectorId).transactionId.toString() + ' will stop in ' + Utils.milliSecondsToHHMMSS(waitTrxEnd)); + const waitTrxEnd = + Utils.getRandomInteger(this.configuration.maxDuration, this.configuration.minDuration) * + 1000; + logger.info( + `${this.logPrefix(connectorId)} transaction ${this.chargingStation + .getConnectorStatus(connectorId) + .transactionId.toString()} started and will stop in ${Utils.formatDurationMilliSeconds( + waitTrxEnd + )}` + ); await Utils.sleep(waitTrxEnd); // Stop transaction - if (this.chargingStation.getConnector(connectorId)?.transactionStarted) { - logger.info(this.logPrefix(connectorId) + ' stop transaction ' + this.chargingStation.getConnector(connectorId).transactionId.toString()); - if (this.chargingStation.getEnableStatistics()) { - const stopTransaction = performance.timerify(this.stopTransaction); - this.performanceObserver.observe({ entryTypes: ['function'] }); - await stopTransaction(connectorId, this); - } else { - await this.stopTransaction(connectorId, this); - } - } + logger.info( + `${this.logPrefix(connectorId)} stop transaction ${this.chargingStation + .getConnectorStatus(connectorId) + .transactionId.toString()}` + ); + await this.stopTransaction(connectorId); } } else { - skip++; - logger.info(this.logPrefix(connectorId) + ' transaction skipped ' + skip.toString()); + this.connectorsStatus.get(connectorId).skippedConsecutiveTransactions++; + this.connectorsStatus.get(connectorId).skippedTransactions++; + logger.info( + `${this.logPrefix(connectorId)} skipped consecutively ${this.connectorsStatus + .get(connectorId) + .skippedConsecutiveTransactions.toString()}/${this.connectorsStatus + .get(connectorId) + .skippedTransactions.toString()} transaction(s)` + ); } - } while (!this.timeToStop); - logger.info(this.logPrefix(connectorId) + ' ATG STOPPED on the connector'); + this.connectorsStatus.get(connectorId).lastRunDate = new Date(); + } + this.connectorsStatus.get(connectorId).stoppedDate = new Date(); + logger.info( + `${this.logPrefix( + connectorId + )} stopped on connector and lasted for ${Utils.formatDurationMilliSeconds( + this.connectorsStatus.get(connectorId).stoppedDate.getTime() - + this.connectorsStatus.get(connectorId).startDate.getTime() + )}` + ); + logger.debug( + `${this.logPrefix(connectorId)} connector status: %j`, + this.connectorsStatus.get(connectorId) + ); } - // eslint-disable-next-line consistent-this - private async startTransaction(connectorId: number, self: AutomaticTransactionGenerator): Promise { - if (self.chargingStation.hasAuthorizedTags()) { - const tagId = self.chargingStation.getRandomTagId(); - if (self.chargingStation.getAutomaticTransactionGeneratorRequireAuthorize()) { - // Authorize tagId - const authorizeResponse = await self.chargingStation.ocppRequestService.sendAuthorize(tagId); + private setStartConnectorStatus(connectorId: number): void { + this.connectorsStatus.get(connectorId).skippedConsecutiveTransactions = 0; + const previousRunDuration = + this?.connectorsStatus.get(connectorId)?.startDate && + this?.connectorsStatus.get(connectorId)?.lastRunDate + ? this.connectorsStatus.get(connectorId).lastRunDate.getTime() - + this.connectorsStatus.get(connectorId).startDate.getTime() + : 0; + this.connectorsStatus.get(connectorId).startDate = new Date(); + this.connectorsStatus.get(connectorId).stopDate = new Date( + this.connectorsStatus.get(connectorId).startDate.getTime() + + (this.configuration.stopAfterHours ?? + Constants.CHARGING_STATION_ATG_DEFAULT_STOP_AFTER_HOURS) * + 3600 * + 1000 - + previousRunDuration + ); + this.connectorsStatus.get(connectorId).start = true; + } + + private initializeConnectorsStatus(): void { + for (const connectorId of this.chargingStation.connectors.keys()) { + if (connectorId > 0) { + this.connectorsStatus.set(connectorId, { + start: false, + authorizeRequests: 0, + acceptedAuthorizeRequests: 0, + rejectedAuthorizeRequests: 0, + startTransactionRequests: 0, + acceptedStartTransactionRequests: 0, + rejectedStartTransactionRequests: 0, + stopTransactionRequests: 0, + acceptedStopTransactionRequests: 0, + rejectedStopTransactionRequests: 0, + skippedConsecutiveTransactions: 0, + skippedTransactions: 0, + }); + } + } + } + + private async startTransaction( + connectorId: number + ): Promise { + const measureId = 'StartTransaction with ATG'; + const beginId = PerformanceStatistics.beginMeasure(measureId); + let startResponse: StartTransactionResponse; + if (this.chargingStation.hasAuthorizedTags()) { + const idTag = this.getIdTag(connectorId); + const startTransactionLogMsg = `${this.logPrefix( + connectorId + )} start transaction with an idTag '${idTag}'`; + if (this.getRequireAuthorize()) { + this.chargingStation.getConnectorStatus(connectorId).authorizeIdTag = idTag; + // Authorize idTag + const authorizeResponse: AuthorizeResponse = + await this.chargingStation.ocppRequestService.requestHandler< + AuthorizeRequest, + AuthorizeResponse + >(this.chargingStation, RequestCommand.AUTHORIZE, { + idTag, + }); + this.connectorsStatus.get(connectorId).authorizeRequests++; if (authorizeResponse?.idTagInfo?.status === AuthorizationStatus.ACCEPTED) { - logger.info(self.logPrefix(connectorId) + ' start transaction for tagID ' + tagId); + this.connectorsStatus.get(connectorId).acceptedAuthorizeRequests++; + logger.info(startTransactionLogMsg); // Start transaction - return await self.chargingStation.ocppRequestService.sendStartTransaction(connectorId, tagId); + startResponse = await this.chargingStation.ocppRequestService.requestHandler< + StartTransactionRequest, + StartTransactionResponse + >(this.chargingStation, RequestCommand.START_TRANSACTION, { + connectorId, + idTag, + }); + this.handleStartTransactionResponse(connectorId, startResponse); + PerformanceStatistics.endMeasure(measureId, beginId); + return startResponse; } - return authorizeResponse; + this.connectorsStatus.get(connectorId).rejectedAuthorizeRequests++; + PerformanceStatistics.endMeasure(measureId, beginId); + return startResponse; } - logger.info(self.logPrefix(connectorId) + ' start transaction for tagID ' + tagId); + logger.info(startTransactionLogMsg); // Start transaction - return await self.chargingStation.ocppRequestService.sendStartTransaction(connectorId, tagId); + startResponse = await this.chargingStation.ocppRequestService.requestHandler< + StartTransactionRequest, + StartTransactionResponse + >(this.chargingStation, RequestCommand.START_TRANSACTION, { + connectorId, + idTag, + }); + this.handleStartTransactionResponse(connectorId, startResponse); + PerformanceStatistics.endMeasure(measureId, beginId); + return startResponse; } - logger.info(self.logPrefix(connectorId) + ' start transaction without a tagID'); - return await self.chargingStation.ocppRequestService.sendStartTransaction(connectorId); + logger.info(`${this.logPrefix(connectorId)} start transaction without an idTag`); + startResponse = await this.chargingStation.ocppRequestService.requestHandler< + StartTransactionRequest, + StartTransactionResponse + >(this.chargingStation, RequestCommand.START_TRANSACTION, { connectorId }); + this.handleStartTransactionResponse(connectorId, startResponse); + PerformanceStatistics.endMeasure(measureId, beginId); + return startResponse; + } + + private async stopTransaction( + connectorId: number, + reason: StopTransactionReason = StopTransactionReason.LOCAL + ): Promise { + const measureId = 'StopTransaction with ATG'; + const beginId = PerformanceStatistics.beginMeasure(measureId); + let stopResponse: StopTransactionResponse; + if (this.chargingStation.getConnectorStatus(connectorId)?.transactionStarted === true) { + stopResponse = await this.chargingStation.stopTransactionOnConnector(connectorId, reason); + this.connectorsStatus.get(connectorId).stopTransactionRequests++; + if (stopResponse?.idTagInfo?.status === AuthorizationStatus.ACCEPTED) { + this.connectorsStatus.get(connectorId).acceptedStopTransactionRequests++; + } else { + this.connectorsStatus.get(connectorId).rejectedStopTransactionRequests++; + } + } else { + const transactionId = this.chargingStation.getConnectorStatus(connectorId).transactionId; + logger.warn( + `${this.logPrefix(connectorId)} stopping a not started transaction${ + transactionId ? ` ${transactionId.toString()}` : '' + }` + ); + } + PerformanceStatistics.endMeasure(measureId, beginId); + return stopResponse; + } + + private getRequireAuthorize(): boolean { + return this.configuration?.requireAuthorize ?? true; } - // eslint-disable-next-line consistent-this - private async stopTransaction(connectorId: number, self: AutomaticTransactionGenerator): Promise { - const transactionId = self.chargingStation.getConnector(connectorId).transactionId; - return await self.chargingStation.ocppRequestService.sendStopTransaction(transactionId, self.chargingStation.getEnergyActiveImportRegisterByTransactionId(transactionId), - self.chargingStation.getTransactionIdTag(transactionId)); + private getRandomIdTag(authorizationFile: string): string { + const tags = this.chargingStation.authorizedTagsCache.getAuthorizedTags(authorizationFile); + this.idTagIndex = Math.floor(Utils.secureRandom() * tags.length); + return tags[this.idTagIndex]; + } + + private getRoundRobinIdTag(authorizationFile: string): string { + const tags = this.chargingStation.authorizedTagsCache.getAuthorizedTags(authorizationFile); + const idTag = tags[this.idTagIndex]; + this.idTagIndex = this.idTagIndex === tags.length - 1 ? 0 : this.idTagIndex + 1; + return idTag; + } + + private getConnectorAffinityIdTag(authorizationFile: string, connectorId: number): string { + const tags = this.chargingStation.authorizedTagsCache.getAuthorizedTags(authorizationFile); + this.idTagIndex = (this.chargingStation.index - 1 + (connectorId - 1)) % tags.length; + return tags[this.idTagIndex]; + } + + private getIdTag(connectorId: number): string { + const authorizationFile = ChargingStationUtils.getAuthorizationFile( + this.chargingStation.stationInfo + ); + switch (this.configuration?.idTagDistribution) { + case IdTagDistribution.RANDOM: + return this.getRandomIdTag(authorizationFile); + case IdTagDistribution.ROUND_ROBIN: + return this.getRoundRobinIdTag(authorizationFile); + case IdTagDistribution.CONNECTOR_AFFINITY: + return this.getConnectorAffinityIdTag(authorizationFile, connectorId); + default: + return this.getRoundRobinIdTag(authorizationFile); + } } private logPrefix(connectorId?: number): string { - if (connectorId) { - return Utils.logPrefix(' ' + this.chargingStation.stationInfo.chargingStationId + ' | ATG on connector #' + connectorId.toString() + ':'); + return Utils.logPrefix( + ` ${this.chargingStation.stationInfo.chargingStationId} | ATG${ + connectorId !== undefined ? ` on connector #${connectorId.toString()}` : '' + }:` + ); + } + + private handleStartTransactionResponse( + connectorId: number, + startResponse: StartTransactionResponse + ): void { + this.connectorsStatus.get(connectorId).startTransactionRequests++; + if (startResponse?.idTagInfo?.status === AuthorizationStatus.ACCEPTED) { + this.connectorsStatus.get(connectorId).acceptedStartTransactionRequests++; + } else { + logger.warn(`${this.logPrefix(connectorId)} start transaction rejected`); + this.connectorsStatus.get(connectorId).rejectedStartTransactionRequests++; + } + } + + private checkChargingStation(connectorId?: number): boolean { + if (this.chargingStation.started === false && this.chargingStation.starting === false) { + logger.warn(`${this.logPrefix(connectorId)} charging station is stopped, cannot proceed`); + return false; } - return Utils.logPrefix(' ' + this.chargingStation.stationInfo.chargingStationId + ' | ATG:'); + return true; } }