// Partial Copyright Jerome Benoit. 2021. All Rights Reserved.
+import PerformanceStatistics from '../performance/PerformanceStatistics';
+import {
+ AutomaticTransactionGeneratorConfiguration,
+ Status,
+} from '../types/AutomaticTransactionGenerator';
+import { MeterValuesRequest, RequestCommand } from '../types/ocpp/Requests';
+import { MeterValuesResponse } from '../types/ocpp/Responses';
import {
AuthorizationStatus,
+ AuthorizeRequest,
AuthorizeResponse,
+ StartTransactionRequest,
StartTransactionResponse,
StopTransactionReason,
+ StopTransactionRequest,
StopTransactionResponse,
} from '../types/ocpp/Transaction';
-
-import type ChargingStation from './ChargingStation';
import Constants from '../utils/Constants';
-import PerformanceStatistics from '../performance/PerformanceStatistics';
-import { RequestCommand } from '../types/ocpp/Requests';
-import { Status } from '../types/AutomaticTransactionGenerator';
-import Utils from '../utils/Utils';
import logger from '../utils/Logger';
+import Utils from '../utils/Utils';
+import type ChargingStation from './ChargingStation';
+import { OCPP16ServiceUtils } from './ocpp/1.6/OCPP16ServiceUtils';
export default class AutomaticTransactionGenerator {
private static readonly instances: Map<string, AutomaticTransactionGenerator> = new Map<
AutomaticTransactionGenerator
>();
+ public readonly configuration: AutomaticTransactionGeneratorConfiguration;
public started: boolean;
private readonly chargingStation: ChargingStation;
private readonly connectorsStatus: Map<number, Status>;
- private constructor(chargingStation: ChargingStation) {
+ private constructor(
+ automaticTransactionGeneratorConfiguration: AutomaticTransactionGeneratorConfiguration,
+ chargingStation: ChargingStation
+ ) {
+ this.configuration = automaticTransactionGeneratorConfiguration;
this.chargingStation = chargingStation;
this.connectorsStatus = new Map<number, Status>();
this.stopConnectors();
this.started = false;
}
- public static getInstance(chargingStation: ChargingStation): AutomaticTransactionGenerator {
- if (!AutomaticTransactionGenerator.instances.has(chargingStation.id)) {
+ public static getInstance(
+ automaticTransactionGeneratorConfiguration: AutomaticTransactionGeneratorConfiguration,
+ chargingStation: ChargingStation
+ ): AutomaticTransactionGenerator {
+ if (!AutomaticTransactionGenerator.instances.has(chargingStation.hashId)) {
AutomaticTransactionGenerator.instances.set(
- chargingStation.id,
- new AutomaticTransactionGenerator(chargingStation)
+ chargingStation.hashId,
+ new AutomaticTransactionGenerator(
+ automaticTransactionGeneratorConfiguration,
+ chargingStation
+ )
);
}
- return AutomaticTransactionGenerator.instances.get(chargingStation.id);
+ return AutomaticTransactionGenerator.instances.get(chargingStation.hashId);
}
public start(): void {
}
private async internalStartConnector(connectorId: number): Promise<void> {
- this.initStartConnectorStatus(connectorId);
+ this.initializeConnectorStatus(connectorId);
logger.info(
this.logPrefix(connectorId) +
' started on connector and will run for ' +
}
const wait =
Utils.getRandomInteger(
- this.chargingStation.stationInfo.AutomaticTransactionGenerator
- .maxDelayBetweenTwoTransactions,
- this.chargingStation.stationInfo.AutomaticTransactionGenerator
- .minDelayBetweenTwoTransactions
+ this.configuration.maxDelayBetweenTwoTransactions,
+ this.configuration.minDelayBetweenTwoTransactions
) * 1000;
logger.info(
this.logPrefix(connectorId) + ' waiting for ' + Utils.formatDurationMilliSeconds(wait)
);
await Utils.sleep(wait);
const start = Utils.secureRandom();
- if (
- start < this.chargingStation.stationInfo.AutomaticTransactionGenerator.probabilityOfStart
- ) {
+ if (start < this.configuration.probabilityOfStart) {
this.connectorsStatus.get(connectorId).skippedConsecutiveTransactions = 0;
// Start transaction
const startResponse = await this.startTransaction(connectorId);
} else {
// Wait until end of transaction
const waitTrxEnd =
- Utils.getRandomInteger(
- this.chargingStation.stationInfo.AutomaticTransactionGenerator.maxDuration,
- this.chargingStation.stationInfo.AutomaticTransactionGenerator.minDuration
- ) * 1000;
+ Utils.getRandomInteger(this.configuration.maxDuration, this.configuration.minDuration) *
+ 1000;
logger.info(
this.logPrefix(connectorId) +
' transaction ' +
});
}
- private initStartConnectorStatus(connectorId: number): void {
+ private initializeConnectorStatus(connectorId: number): void {
this.connectorsStatus.get(connectorId).authorizeRequests =
this?.connectorsStatus.get(connectorId)?.authorizeRequests ?? 0;
this.connectorsStatus.get(connectorId).acceptedAuthorizeRequests =
this.connectorsStatus.get(connectorId).startDate = new Date();
this.connectorsStatus.get(connectorId).stopDate = new Date(
this.connectorsStatus.get(connectorId).startDate.getTime() +
- (this.chargingStation.stationInfo?.AutomaticTransactionGenerator?.stopAfterHours ??
+ (this.configuration.stopAfterHours ??
Constants.CHARGING_STATION_ATG_DEFAULT_STOP_AFTER_HOURS) *
3600 *
1000 -
let startResponse: StartTransactionResponse;
if (this.chargingStation.hasAuthorizedTags()) {
const idTag = this.chargingStation.getRandomIdTag();
- if (this.chargingStation.getAutomaticTransactionGeneratorRequireAuthorize()) {
+ if (this.getRequireAuthorize()) {
this.chargingStation.getConnectorStatus(connectorId).authorizeIdTag = idTag;
// Authorize idTag
const authorizeResponse: AuthorizeResponse =
- (await this.chargingStation.ocppRequestService.sendMessageHandler(
- RequestCommand.AUTHORIZE,
- {
- idTag,
- }
- )) as AuthorizeResponse;
+ await this.chargingStation.ocppRequestService.requestHandler<
+ AuthorizeRequest,
+ AuthorizeResponse
+ >(this.chargingStation, RequestCommand.AUTHORIZE, {
+ idTag,
+ });
this.connectorsStatus.get(connectorId).authorizeRequests++;
if (authorizeResponse?.idTagInfo?.status === AuthorizationStatus.ACCEPTED) {
this.connectorsStatus.get(connectorId).acceptedAuthorizeRequests++;
logger.info(this.logPrefix(connectorId) + ' start transaction for idTag ' + idTag);
// Start transaction
- startResponse = (await this.chargingStation.ocppRequestService.sendMessageHandler(
- RequestCommand.START_TRANSACTION,
- {
- connectorId,
- idTag,
- }
- )) as StartTransactionResponse;
+ startResponse = await this.chargingStation.ocppRequestService.requestHandler<
+ StartTransactionRequest,
+ StartTransactionResponse
+ >(this.chargingStation, RequestCommand.START_TRANSACTION, {
+ connectorId,
+ idTag,
+ });
PerformanceStatistics.endMeasure(measureId, beginId);
return startResponse;
}
}
logger.info(this.logPrefix(connectorId) + ' start transaction for idTag ' + idTag);
// Start transaction
- startResponse = (await this.chargingStation.ocppRequestService.sendMessageHandler(
- RequestCommand.START_TRANSACTION,
- {
- connectorId,
- idTag,
- }
- )) as StartTransactionResponse;
+ startResponse = await this.chargingStation.ocppRequestService.requestHandler<
+ StartTransactionRequest,
+ StartTransactionResponse
+ >(this.chargingStation, RequestCommand.START_TRANSACTION, {
+ connectorId,
+ idTag,
+ });
PerformanceStatistics.endMeasure(measureId, beginId);
return startResponse;
}
logger.info(this.logPrefix(connectorId) + ' start transaction without an idTag');
- startResponse = (await this.chargingStation.ocppRequestService.sendMessageHandler(
- RequestCommand.START_TRANSACTION,
- { connectorId }
- )) as StartTransactionResponse;
+ startResponse = await this.chargingStation.ocppRequestService.requestHandler<
+ StartTransactionRequest,
+ StartTransactionResponse
+ >(this.chargingStation, RequestCommand.START_TRANSACTION, { connectorId });
PerformanceStatistics.endMeasure(measureId, beginId);
return startResponse;
}
let stopResponse: StopTransactionResponse;
if (this.chargingStation.getConnectorStatus(connectorId)?.transactionStarted) {
transactionId = this.chargingStation.getConnectorStatus(connectorId).transactionId;
- stopResponse = await this.chargingStation.ocppRequestService.sendStopTransaction(
+ if (
+ this.chargingStation.getBeginEndMeterValues() &&
+ this.chargingStation.getOcppStrictCompliance() &&
+ !this.chargingStation.getOutOfOrderEndMeterValues()
+ ) {
+ // FIXME: Implement OCPP version agnostic helpers
+ const transactionEndMeterValue = OCPP16ServiceUtils.buildTransactionEndMeterValue(
+ this.chargingStation,
+ connectorId,
+ this.chargingStation.getEnergyActiveImportRegisterByTransactionId(transactionId)
+ );
+ await this.chargingStation.ocppRequestService.requestHandler<
+ MeterValuesRequest,
+ MeterValuesResponse
+ >(this.chargingStation, RequestCommand.METER_VALUES, {
+ connectorId,
+ transactionId,
+ meterValue: [transactionEndMeterValue],
+ });
+ }
+ stopResponse = await this.chargingStation.ocppRequestService.requestHandler<
+ StopTransactionRequest,
+ StopTransactionResponse
+ >(this.chargingStation, RequestCommand.STOP_TRANSACTION, {
transactionId,
- this.chargingStation.getEnergyActiveImportRegisterByTransactionId(transactionId),
- this.chargingStation.getTransactionIdTag(transactionId),
- reason
- );
+ meterStop: this.chargingStation.getEnergyActiveImportRegisterByTransactionId(transactionId),
+ idTag: this.chargingStation.getTransactionIdTag(transactionId),
+ reason,
+ });
this.connectorsStatus.get(connectorId).stopTransactionRequests++;
} else {
logger.warn(
return stopResponse;
}
+ private getRequireAuthorize(): boolean {
+ return this.configuration?.requireAuthorize ?? true;
+ }
+
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:');
+ return Utils.logPrefix(
+ ` ${this.chargingStation.stationInfo.chargingStationId} | ATG${
+ connectorId && ` on connector #${connectorId.toString()}`
+ }:`
+ );
}
}