import type { JSONSchemaType } from 'ajv';
import { Client, type FTPResponse } from 'basic-ftp';
+import {
+ type Interval,
+ addSeconds,
+ differenceInSeconds,
+ isDate,
+ secondsToMilliseconds,
+} from 'date-fns';
+import { maxTime } from 'date-fns/constants';
import { create } from 'tar';
-import { OCPP16Constants } from './OCPP16Constants';
-import { OCPP16ServiceUtils } from './OCPP16ServiceUtils';
+import { OCPP16Constants } from './OCPP16Constants.js';
+import { OCPP16ServiceUtils } from './OCPP16ServiceUtils.js';
import {
type ChargingStation,
+ canProceedChargingProfile,
checkChargingStation,
getConfigurationKey,
+ getConnectorChargingProfiles,
+ prepareChargingProfileKind,
+ removeExpiredReservations,
setConfigurationKeyValue,
-} from '../../../charging-station';
-import { OCPPError } from '../../../exception';
+} from '../../../charging-station/index.js';
+import { OCPPError } from '../../../exception/index.js';
import {
- type ChangeAvailabilityRequest,
- type ChangeAvailabilityResponse,
type ChangeConfigurationRequest,
type ChangeConfigurationResponse,
- type ClearChargingProfileRequest,
- type ClearChargingProfileResponse,
- type ConnectorStatus,
ErrorType,
type GenericResponse,
GenericStatus,
type GetDiagnosticsRequest,
type GetDiagnosticsResponse,
type IncomingRequestHandler,
- type JsonObject,
type JsonType,
OCPP16AuthorizationStatus,
OCPP16AvailabilityType,
type OCPP16BootNotificationRequest,
type OCPP16BootNotificationResponse,
type OCPP16CancelReservationRequest,
+ type OCPP16ChangeAvailabilityRequest,
+ type OCPP16ChangeAvailabilityResponse,
OCPP16ChargePointErrorCode,
OCPP16ChargePointStatus,
type OCPP16ChargingProfile,
OCPP16ChargingProfilePurposeType,
type OCPP16ChargingSchedule,
type OCPP16ClearCacheRequest,
+ type OCPP16ClearChargingProfileRequest,
+ type OCPP16ClearChargingProfileResponse,
type OCPP16DataTransferRequest,
type OCPP16DataTransferResponse,
OCPP16DataTransferVendorId,
OCPPVersion,
type RemoteStartTransactionRequest,
type RemoteStopTransactionRequest,
- ReservationFilterKey,
ReservationTerminationReason,
type ResetRequest,
type SetChargingProfileRequest,
type SetChargingProfileResponse,
- type StartTransactionRequest,
type UnlockConnectorRequest,
type UnlockConnectorResponse,
-} from '../../../types';
+} from '../../../types/index.js';
import {
Constants,
convertToDate,
isUndefined,
logger,
sleep,
-} from '../../../utils';
-import { OCPPIncomingRequestService } from '../OCPPIncomingRequestService';
+} from '../../../utils/index.js';
+import { OCPPIncomingRequestService } from '../OCPPIncomingRequestService.js';
const moduleName = 'OCPP16IncomingRequestService';
export class OCPP16IncomingRequestService extends OCPPIncomingRequestService {
- protected jsonSchemas: Map<OCPP16IncomingRequestCommand, JSONSchemaType<JsonObject>>;
+ protected jsonSchemas: Map<OCPP16IncomingRequestCommand, JSONSchemaType<JsonType>>;
private incomingRequestHandlers: Map<OCPP16IncomingRequestCommand, IncomingRequestHandler>;
public constructor() {
this.handleRequestCancelReservation.bind(this) as unknown as IncomingRequestHandler,
],
]);
- this.jsonSchemas = new Map<OCPP16IncomingRequestCommand, JSONSchemaType<JsonObject>>([
+ this.jsonSchemas = new Map<OCPP16IncomingRequestCommand, JSONSchemaType<JsonType>>([
[
OCPP16IncomingRequestCommand.RESET,
OCPP16ServiceUtils.parseJsonSchemaFile<ResetRequest>(
],
[
OCPP16IncomingRequestCommand.CLEAR_CHARGING_PROFILE,
- OCPP16ServiceUtils.parseJsonSchemaFile<ClearChargingProfileRequest>(
+ OCPP16ServiceUtils.parseJsonSchemaFile<OCPP16ClearChargingProfileRequest>(
'assets/json-schemas/ocpp/1.6/ClearChargingProfile.json',
moduleName,
'constructor',
],
[
OCPP16IncomingRequestCommand.CHANGE_AVAILABILITY,
- OCPP16ServiceUtils.parseJsonSchemaFile<ChangeAvailabilityRequest>(
+ OCPP16ServiceUtils.parseJsonSchemaFile<OCPP16ChangeAvailabilityRequest>(
'assets/json-schemas/ocpp/1.6/ChangeAvailability.json',
moduleName,
'constructor',
): Promise<void> {
let response: ResType;
if (
- chargingStation.getOcppStrictCompliance() === true &&
+ chargingStation.stationInfo?.ocppStrictCompliance === true &&
chargingStation.inPendingState() === true &&
(commandName === OCPP16IncomingRequestCommand.REMOTE_START_TRANSACTION ||
commandName === OCPP16IncomingRequestCommand.REMOTE_STOP_TRANSACTION)
ErrorType.SECURITY_ERROR,
`${commandName} cannot be issued to handle request PDU ${JSON.stringify(
commandPayload,
- null,
+ undefined,
2,
)} while the charging station is in pending state on the central server`,
commandName,
}
if (
chargingStation.isRegistered() === true ||
- (chargingStation.getOcppStrictCompliance() === false &&
+ (chargingStation.stationInfo?.ocppStrictCompliance === false &&
chargingStation.inUnknownState() === true)
) {
if (
} catch (error) {
// Log
logger.error(
- `${chargingStation.logPrefix()} ${moduleName}.incomingRequestHandler:
- Handle incoming request error:`,
+ `${chargingStation.logPrefix()} ${moduleName}.incomingRequestHandler: Handle incoming request error:`,
error,
);
throw error;
ErrorType.NOT_IMPLEMENTED,
`${commandName} is not implemented to handle request PDU ${JSON.stringify(
commandPayload,
- null,
+ undefined,
2,
)}`,
commandName,
ErrorType.SECURITY_ERROR,
`${commandName} cannot be issued to handle request PDU ${JSON.stringify(
commandPayload,
- null,
+ undefined,
2,
)} while the charging station is not registered on the central server.`,
commandName,
);
}
logger.warn(
- `${chargingStation.logPrefix()} ${moduleName}.validatePayload: No JSON schema found
- for command '${commandName}' PDU validation`,
+ `${chargingStation.logPrefix()} ${moduleName}.validatePayload: No JSON schema found for command '${commandName}' PDU validation`,
);
return false;
}
chargingStation: ChargingStation,
commandPayload: ResetRequest,
): GenericResponse {
- this.runInAsyncScope(
- chargingStation.reset.bind(chargingStation) as (
- this: ChargingStation,
- ...args: unknown[]
- ) => Promise<void>,
- chargingStation,
- `${commandPayload.type}Reset` as OCPP16StopTransactionReason,
- ).catch(Constants.EMPTY_FUNCTION);
+ const { type } = commandPayload;
+ chargingStation
+ .reset(`${type}Reset` as OCPP16StopTransactionReason)
+ .catch(Constants.EMPTY_FUNCTION);
logger.info(
- `${chargingStation.logPrefix()} ${
- commandPayload.type
- } reset command received, simulating it. The station will be
- back online in ${formatDurationMilliSeconds(chargingStation.stationInfo.resetTime!)}`,
+ `${chargingStation.logPrefix()} ${type} reset command received, simulating it. The station will be back online in ${formatDurationMilliSeconds(
+ chargingStation.stationInfo.resetTime!,
+ )}`,
);
return OCPP16Constants.OCPP_RESPONSE_ACCEPTED;
}
chargingStation: ChargingStation,
commandPayload: UnlockConnectorRequest,
): Promise<UnlockConnectorResponse> {
- const connectorId = commandPayload.connectorId;
+ const { connectorId } = commandPayload;
if (chargingStation.hasConnector(connectorId) === false) {
logger.error(
- `${chargingStation.logPrefix()} Trying to unlock a non existing
- connector id ${connectorId.toString()}`,
+ `${chargingStation.logPrefix()} Trying to unlock a non existing connector id ${connectorId}`,
);
return OCPP16Constants.OCPP_RESPONSE_UNLOCK_NOT_SUPPORTED;
}
if (connectorId === 0) {
- logger.error(
- `${chargingStation.logPrefix()} Trying to unlock connector id ${connectorId.toString()}`,
- );
+ logger.error(`${chargingStation.logPrefix()} Trying to unlock connector id ${connectorId}`);
return OCPP16Constants.OCPP_RESPONSE_UNLOCK_NOT_SUPPORTED;
}
if (chargingStation.getConnectorStatus(connectorId)?.transactionStarted === true) {
chargingStation: ChargingStation,
commandPayload: GetConfigurationRequest,
): GetConfigurationResponse {
+ const { key } = commandPayload;
const configurationKey: OCPPConfigurationKey[] = [];
const unknownKey: string[] = [];
- if (isUndefined(commandPayload.key) === true) {
+ if (isUndefined(key) === true) {
for (const configuration of chargingStation.ocppConfiguration!.configurationKey!) {
if (isUndefined(configuration.visible) === true) {
configuration.visible = true;
value: configuration.value,
});
}
- } else if (isNotEmptyArray(commandPayload.key) === true) {
- for (const key of commandPayload.key!) {
- const keyFound = getConfigurationKey(chargingStation, key, true);
- if (keyFound) {
+ } else if (isNotEmptyArray(key) === true) {
+ for (const k of key!) {
+ const keyFound = getConfigurationKey(chargingStation, k, true);
+ if (keyFound !== undefined) {
if (isUndefined(keyFound.visible) === true) {
keyFound.visible = true;
}
value: keyFound.value,
});
} else {
- unknownKey.push(key);
+ unknownKey.push(k);
}
}
}
chargingStation: ChargingStation,
commandPayload: ChangeConfigurationRequest,
): ChangeConfigurationResponse {
- const keyToChange = getConfigurationKey(chargingStation, commandPayload.key, true);
+ const { key, value } = commandPayload;
+ const keyToChange = getConfigurationKey(chargingStation, key, true);
if (keyToChange?.readonly === true) {
return OCPP16Constants.OCPP_CONFIGURATION_RESPONSE_REJECTED;
} else if (keyToChange?.readonly === false) {
let valueChanged = false;
- if (keyToChange.value !== commandPayload.value) {
- setConfigurationKeyValue(chargingStation, commandPayload.key, commandPayload.value, true);
+ if (keyToChange.value !== value) {
+ setConfigurationKeyValue(chargingStation, key, value, true);
valueChanged = true;
}
let triggerHeartbeatRestart = false;
setConfigurationKeyValue(
chargingStation,
OCPP16StandardParametersKey.HeartbeatInterval,
- commandPayload.value,
+ value,
);
triggerHeartbeatRestart = true;
}
setConfigurationKeyValue(
chargingStation,
OCPP16StandardParametersKey.HeartBeatInterval,
- commandPayload.value,
+ value,
);
triggerHeartbeatRestart = true;
}
) {
return OCPP16Constants.OCPP_SET_CHARGING_PROFILE_RESPONSE_NOT_SUPPORTED;
}
- if (chargingStation.hasConnector(commandPayload.connectorId) === false) {
+ const { connectorId, csChargingProfiles } = commandPayload;
+ if (chargingStation.hasConnector(connectorId) === false) {
logger.error(
- `${chargingStation.logPrefix()} Trying to set charging profile(s) to a
- non existing connector id ${commandPayload.connectorId}`,
+ `${chargingStation.logPrefix()} Trying to set charging profile(s) to a non existing connector id ${connectorId}`,
);
return OCPP16Constants.OCPP_SET_CHARGING_PROFILE_RESPONSE_REJECTED;
}
if (
- commandPayload.csChargingProfiles.chargingProfilePurpose ===
+ csChargingProfiles.chargingProfilePurpose ===
OCPP16ChargingProfilePurposeType.CHARGE_POINT_MAX_PROFILE &&
- commandPayload.connectorId !== 0
+ connectorId !== 0
) {
return OCPP16Constants.OCPP_SET_CHARGING_PROFILE_RESPONSE_REJECTED;
}
if (
- commandPayload.csChargingProfiles.chargingProfilePurpose ===
- OCPP16ChargingProfilePurposeType.TX_PROFILE &&
- (commandPayload.connectorId === 0 ||
- chargingStation.getConnectorStatus(commandPayload.connectorId)?.transactionStarted ===
- false)
+ csChargingProfiles.chargingProfilePurpose === OCPP16ChargingProfilePurposeType.TX_PROFILE &&
+ connectorId === 0
) {
logger.error(
- `${chargingStation.logPrefix()} Trying to set transaction charging profile(s)
- on connector ${commandPayload.connectorId} without a started transaction`,
+ `${chargingStation.logPrefix()} Trying to set transaction charging profile(s) on connector ${connectorId}`,
);
return OCPP16Constants.OCPP_SET_CHARGING_PROFILE_RESPONSE_REJECTED;
}
- OCPP16ServiceUtils.setChargingProfile(
- chargingStation,
- commandPayload.connectorId,
- commandPayload.csChargingProfiles,
- );
+ const connectorStatus = chargingStation.getConnectorStatus(connectorId);
+ if (
+ csChargingProfiles.chargingProfilePurpose === OCPP16ChargingProfilePurposeType.TX_PROFILE &&
+ connectorId > 0 &&
+ connectorStatus?.transactionStarted === false
+ ) {
+ logger.error(
+ `${chargingStation.logPrefix()} Trying to set transaction charging profile(s) on connector ${connectorId} without a started transaction`,
+ );
+ return OCPP16Constants.OCPP_SET_CHARGING_PROFILE_RESPONSE_REJECTED;
+ }
+ if (
+ csChargingProfiles.chargingProfilePurpose === OCPP16ChargingProfilePurposeType.TX_PROFILE &&
+ connectorId > 0 &&
+ connectorStatus?.transactionStarted === true &&
+ csChargingProfiles.transactionId !== connectorStatus?.transactionId
+ ) {
+ logger.error(
+ `${chargingStation.logPrefix()} Trying to set transaction charging profile(s) on connector ${connectorId} with a different transaction id ${
+ csChargingProfiles.transactionId
+ } than the started transaction id ${connectorStatus?.transactionId}`,
+ );
+ return OCPP16Constants.OCPP_SET_CHARGING_PROFILE_RESPONSE_REJECTED;
+ }
+ OCPP16ServiceUtils.setChargingProfile(chargingStation, connectorId, csChargingProfiles);
logger.debug(
- `${chargingStation.logPrefix()} Charging profile(s) set on connector id ${
- commandPayload.connectorId
- }: %j`,
- commandPayload.csChargingProfiles,
+ `${chargingStation.logPrefix()} Charging profile(s) set on connector id ${connectorId}: %j`,
+ csChargingProfiles,
);
return OCPP16Constants.OCPP_SET_CHARGING_PROFILE_RESPONSE_ACCEPTED;
}
) {
return OCPP16Constants.OCPP_RESPONSE_REJECTED;
}
- if (chargingStation.hasConnector(commandPayload.connectorId) === false) {
+ const { connectorId, duration, chargingRateUnit } = commandPayload;
+ if (chargingStation.hasConnector(connectorId) === false) {
logger.error(
- `${chargingStation.logPrefix()} Trying to get composite schedule to a
- non existing connector id ${commandPayload.connectorId}`,
+ `${chargingStation.logPrefix()} Trying to get composite schedule to a non existing connector id ${connectorId}`,
);
return OCPP16Constants.OCPP_RESPONSE_REJECTED;
}
+ if (connectorId === 0) {
+ logger.error(
+ `${chargingStation.logPrefix()} Get composite schedule on connector id ${connectorId} is not yet supported`,
+ );
+ return OCPP16Constants.OCPP_RESPONSE_REJECTED;
+ }
+ if (chargingRateUnit) {
+ logger.warn(
+ `${chargingStation.logPrefix()} Get composite schedule with a specified rate unit is not yet supported, no conversion will be done`,
+ );
+ }
+ const connectorStatus = chargingStation.getConnectorStatus(connectorId)!;
if (
- isEmptyArray(chargingStation.getConnectorStatus(commandPayload.connectorId)?.chargingProfiles)
+ isEmptyArray(
+ connectorStatus?.chargingProfiles &&
+ isEmptyArray(chargingStation.getConnectorStatus(0)?.chargingProfiles),
+ )
) {
return OCPP16Constants.OCPP_RESPONSE_REJECTED;
}
- const startDate = new Date();
- const endDate = new Date(startDate.getTime() + commandPayload.duration * 1000);
+ const currentDate = new Date();
+ const compositeScheduleInterval: Interval = {
+ start: currentDate,
+ end: addSeconds(currentDate, duration),
+ };
+ // Get charging profiles sorted by connector id then stack level
+ const chargingProfiles: OCPP16ChargingProfile[] = getConnectorChargingProfiles(
+ chargingStation,
+ connectorId,
+ );
+ let previousCompositeSchedule: OCPP16ChargingSchedule | undefined;
let compositeSchedule: OCPP16ChargingSchedule | undefined;
- for (const chargingProfile of chargingStation.getConnectorStatus(commandPayload.connectorId)!
- .chargingProfiles!) {
- // FIXME: build the composite schedule including the local power limit, the stack level, the charging rate unit, etc.
+ for (const chargingProfile of chargingProfiles) {
+ if (
+ isNullOrUndefined(chargingProfile.chargingSchedule?.startSchedule) &&
+ connectorStatus?.transactionStarted
+ ) {
+ logger.debug(
+ `${chargingStation.logPrefix()} ${moduleName}.handleRequestGetCompositeSchedule: Charging profile id ${
+ chargingProfile.chargingProfileId
+ } has no startSchedule defined. Trying to set it to the connector current transaction start date`,
+ );
+ // OCPP specifies that if startSchedule is not defined, it should be relative to start of the connector transaction
+ chargingProfile.chargingSchedule.startSchedule = connectorStatus?.transactionStart;
+ }
if (
- chargingProfile.chargingSchedule.startSchedule! >= startDate &&
- chargingProfile.chargingSchedule.startSchedule! <= endDate
+ !isNullOrUndefined(chargingProfile.chargingSchedule?.startSchedule) &&
+ !isDate(chargingProfile.chargingSchedule?.startSchedule)
) {
- compositeSchedule = chargingProfile.chargingSchedule;
- break;
+ logger.warn(
+ `${chargingStation.logPrefix()} ${moduleName}.handleRequestGetCompositeSchedule: Charging profile id ${
+ chargingProfile.chargingProfileId
+ } startSchedule property is not a Date instance. Trying to convert it to a Date instance`,
+ );
+ chargingProfile.chargingSchedule.startSchedule = convertToDate(
+ chargingProfile.chargingSchedule?.startSchedule,
+ )!;
}
+ if (
+ !isNullOrUndefined(chargingProfile.chargingSchedule?.startSchedule) &&
+ isNullOrUndefined(chargingProfile.chargingSchedule?.duration)
+ ) {
+ logger.debug(
+ `${chargingStation.logPrefix()} ${moduleName}.handleRequestGetCompositeSchedule: Charging profile id ${
+ chargingProfile.chargingProfileId
+ } has no duration defined and will be set to the maximum time allowed`,
+ );
+ // OCPP specifies that if duration is not defined, it should be infinite
+ chargingProfile.chargingSchedule.duration = differenceInSeconds(
+ maxTime,
+ chargingProfile.chargingSchedule.startSchedule!,
+ );
+ }
+ if (
+ !prepareChargingProfileKind(
+ connectorStatus,
+ chargingProfile,
+ compositeScheduleInterval.start as Date,
+ chargingStation.logPrefix(),
+ )
+ ) {
+ continue;
+ }
+ if (
+ !canProceedChargingProfile(
+ chargingProfile,
+ compositeScheduleInterval.start as Date,
+ chargingStation.logPrefix(),
+ )
+ ) {
+ continue;
+ }
+ compositeSchedule = OCPP16ServiceUtils.composeChargingSchedules(
+ previousCompositeSchedule,
+ chargingProfile.chargingSchedule,
+ compositeScheduleInterval,
+ );
+ previousCompositeSchedule = compositeSchedule;
}
- return {
- status: GenericStatus.Accepted,
- scheduleStart: compositeSchedule?.startSchedule,
- connectorId: commandPayload.connectorId,
- chargingSchedule: compositeSchedule,
- };
+ if (compositeSchedule) {
+ return {
+ status: GenericStatus.Accepted,
+ scheduleStart: compositeSchedule.startSchedule!,
+ connectorId,
+ chargingSchedule: compositeSchedule,
+ };
+ }
+ return OCPP16Constants.OCPP_RESPONSE_REJECTED;
}
private handleRequestClearChargingProfile(
chargingStation: ChargingStation,
- commandPayload: ClearChargingProfileRequest,
- ): ClearChargingProfileResponse {
+ commandPayload: OCPP16ClearChargingProfileRequest,
+ ): OCPP16ClearChargingProfileResponse {
if (
OCPP16ServiceUtils.checkFeatureProfile(
chargingStation,
) {
return OCPP16Constants.OCPP_CLEAR_CHARGING_PROFILE_RESPONSE_UNKNOWN;
}
- if (chargingStation.hasConnector(commandPayload.connectorId!) === false) {
+ const { connectorId } = commandPayload;
+ if (chargingStation.hasConnector(connectorId!) === false) {
logger.error(
- `${chargingStation.logPrefix()} Trying to clear a charging profile(s) to
- a non existing connector id ${commandPayload.connectorId}`,
+ `${chargingStation.logPrefix()} Trying to clear a charging profile(s) to a non existing connector id ${connectorId}`,
);
return OCPP16Constants.OCPP_CLEAR_CHARGING_PROFILE_RESPONSE_UNKNOWN;
}
- if (
- !isNullOrUndefined(commandPayload.connectorId) &&
- isNotEmptyArray(
- chargingStation.getConnectorStatus(commandPayload.connectorId!)?.chargingProfiles,
- )
- ) {
- chargingStation.getConnectorStatus(commandPayload.connectorId!)!.chargingProfiles = [];
+ const connectorStatus = chargingStation.getConnectorStatus(connectorId!);
+ if (!isNullOrUndefined(connectorId) && isNotEmptyArray(connectorStatus?.chargingProfiles)) {
+ connectorStatus!.chargingProfiles = [];
logger.debug(
- `${chargingStation.logPrefix()} Charging profile(s) cleared on connector id ${
- commandPayload.connectorId
- }`,
+ `${chargingStation.logPrefix()} Charging profile(s) cleared on connector id ${connectorId}`,
);
return OCPP16Constants.OCPP_CLEAR_CHARGING_PROFILE_RESPONSE_ACCEPTED;
}
- if (isNullOrUndefined(commandPayload.connectorId)) {
+ if (isNullOrUndefined(connectorId)) {
let clearedCP = false;
if (chargingStation.hasEvses) {
for (const evseStatus of chargingStation.evses.values()) {
- for (const connectorStatus of evseStatus.connectors.values()) {
+ for (const status of evseStatus.connectors.values()) {
clearedCP = OCPP16ServiceUtils.clearChargingProfiles(
chargingStation,
commandPayload,
- connectorStatus.chargingProfiles,
+ status.chargingProfiles,
);
}
}
} else {
- for (const connectorId of chargingStation.connectors.keys()) {
+ for (const id of chargingStation.connectors.keys()) {
clearedCP = OCPP16ServiceUtils.clearChargingProfiles(
chargingStation,
commandPayload,
- chargingStation.getConnectorStatus(connectorId)?.chargingProfiles,
+ chargingStation.getConnectorStatus(id)?.chargingProfiles,
);
}
}
private async handleRequestChangeAvailability(
chargingStation: ChargingStation,
- commandPayload: ChangeAvailabilityRequest,
- ): Promise<ChangeAvailabilityResponse> {
- const connectorId: number = commandPayload.connectorId;
+ commandPayload: OCPP16ChangeAvailabilityRequest,
+ ): Promise<OCPP16ChangeAvailabilityResponse> {
+ const { connectorId, type } = commandPayload;
if (chargingStation.hasConnector(connectorId) === false) {
logger.error(
- `${chargingStation.logPrefix()} Trying to change the availability of a
- non existing connector id ${connectorId.toString()}`,
+ `${chargingStation.logPrefix()} Trying to change the availability of a non existing connector id ${connectorId}`,
);
return OCPP16Constants.OCPP_AVAILABILITY_RESPONSE_REJECTED;
}
const chargePointStatus: OCPP16ChargePointStatus =
- commandPayload.type === OCPP16AvailabilityType.Operative
+ type === OCPP16AvailabilityType.Operative
? OCPP16ChargePointStatus.Available
: OCPP16ChargePointStatus.Unavailable;
if (connectorId === 0) {
- let response: ChangeAvailabilityResponse =
- OCPP16Constants.OCPP_AVAILABILITY_RESPONSE_ACCEPTED;
- const changeAvailability = async (id: number, connectorStatus: ConnectorStatus) => {
- if (connectorStatus?.transactionStarted === true) {
- response = OCPP16Constants.OCPP_AVAILABILITY_RESPONSE_SCHEDULED;
- }
- connectorStatus.availability = commandPayload.type;
- if (response === OCPP16Constants.OCPP_AVAILABILITY_RESPONSE_ACCEPTED) {
- await OCPP16ServiceUtils.sendAndSetConnectorStatus(
+ let response: OCPP16ChangeAvailabilityResponse;
+ if (chargingStation.hasEvses) {
+ for (const evseStatus of chargingStation.evses.values()) {
+ response = await OCPP16ServiceUtils.changeAvailability(
chargingStation,
- id,
+ [...evseStatus.connectors.keys()],
chargePointStatus,
+ type,
);
}
- };
- if (chargingStation.hasEvses) {
- for (const evseStatus of chargingStation.evses.values()) {
- for (const [id, connectorStatus] of evseStatus.connectors) {
- await changeAvailability(id, connectorStatus);
- }
- }
} else {
- for (const id of chargingStation.connectors.keys()) {
- await changeAvailability(id, chargingStation.getConnectorStatus(id)!);
- }
+ response = await OCPP16ServiceUtils.changeAvailability(
+ chargingStation,
+ [...chargingStation.connectors.keys()],
+ chargePointStatus,
+ type,
+ );
}
- return response;
+ return response!;
} else if (
connectorId > 0 &&
(chargingStation.isChargingStationAvailable() === true ||
(chargingStation.isChargingStationAvailable() === false &&
- commandPayload.type === OCPP16AvailabilityType.Inoperative))
+ type === OCPP16AvailabilityType.Inoperative))
) {
if (chargingStation.getConnectorStatus(connectorId)?.transactionStarted === true) {
- chargingStation.getConnectorStatus(connectorId)!.availability = commandPayload.type;
+ chargingStation.getConnectorStatus(connectorId)!.availability = type;
return OCPP16Constants.OCPP_AVAILABILITY_RESPONSE_SCHEDULED;
}
- chargingStation.getConnectorStatus(connectorId)!.availability = commandPayload.type;
+ chargingStation.getConnectorStatus(connectorId)!.availability = type;
await OCPP16ServiceUtils.sendAndSetConnectorStatus(
chargingStation,
connectorId,
commandPayload: RemoteStartTransactionRequest,
): Promise<GenericResponse> {
const { connectorId: transactionConnectorId, idTag, chargingProfile } = commandPayload;
- const reserved =
- chargingStation.getConnectorStatus(transactionConnectorId)!.status ===
- OCPP16ChargePointStatus.Reserved;
- const reservedOnConnectorZero =
- chargingStation.getConnectorStatus(0)!.status === OCPP16ChargePointStatus.Reserved;
- if (
- (reserved &&
- !chargingStation.validateIncomingRequestWithReservation(transactionConnectorId, idTag)) ||
- (reservedOnConnectorZero && !chargingStation.validateIncomingRequestWithReservation(0, idTag))
- ) {
- return OCPP16Constants.OCPP_RESPONSE_REJECTED;
- }
if (chargingStation.hasConnector(transactionConnectorId) === false) {
return this.notifyRemoteStartTransactionRejected(
chargingStation,
const remoteStartTransactionLogMsg = `
${chargingStation.logPrefix()} Transaction remotely STARTED on ${
chargingStation.stationInfo.chargingStationId
- }#${transactionConnectorId.toString()} for idTag '${idTag}'`;
+ }#${transactionConnectorId} for idTag '${idTag}'`;
await OCPP16ServiceUtils.sendAndSetConnectorStatus(
chargingStation,
transactionConnectorId,
OCPP16ChargePointStatus.Preparing,
);
const connectorStatus = chargingStation.getConnectorStatus(transactionConnectorId)!;
- // Check if authorized
+ // Authorization check required
if (
- chargingStation.getAuthorizeRemoteTxRequests() &&
+ chargingStation.getAuthorizeRemoteTxRequests() === true &&
(await OCPP16ServiceUtils.isIdTagAuthorized(chargingStation, transactionConnectorId, idTag))
) {
// Authorization successful, start transaction
if (
- this.setRemoteStartTransactionChargingProfile(
- chargingStation,
- transactionConnectorId,
- chargingProfile!,
- ) === true
+ (chargingProfile &&
+ this.setRemoteStartTransactionChargingProfile(
+ chargingStation,
+ transactionConnectorId,
+ chargingProfile,
+ // eslint-disable-next-line @typescript-eslint/prefer-nullish-coalescing
+ ) === true) ||
+ !chargingProfile
) {
connectorStatus.transactionRemoteStarted = true;
- const startTransactionPayload: Partial<StartTransactionRequest> = {
- connectorId: transactionConnectorId,
- idTag,
- };
- if (reserved || reservedOnConnectorZero) {
- const reservation = chargingStation.getReservationBy(
- ReservationFilterKey.CONNECTOR_ID,
- reservedOnConnectorZero ? 0 : transactionConnectorId,
- )!;
- startTransactionPayload.reservationId = reservation.id;
- await chargingStation.removeReservation(
- reservation,
- ReservationTerminationReason.TRANSACTION_STARTED,
- );
- }
if (
(
await chargingStation.ocppRequestService.requestHandler<
OCPP16StartTransactionRequest,
OCPP16StartTransactionResponse
- >(chargingStation, OCPP16RequestCommand.START_TRANSACTION, startTransactionPayload)
+ >(chargingStation, OCPP16RequestCommand.START_TRANSACTION, {
+ connectorId: transactionConnectorId,
+ idTag,
+ })
).idTagInfo.status === OCPP16AuthorizationStatus.ACCEPTED
) {
logger.debug(remoteStartTransactionLogMsg);
}
// No authorization check required, start transaction
if (
- this.setRemoteStartTransactionChargingProfile(
- chargingStation,
- transactionConnectorId,
- chargingProfile!,
- ) === true
+ (chargingProfile &&
+ this.setRemoteStartTransactionChargingProfile(
+ chargingStation,
+ transactionConnectorId,
+ chargingProfile,
+ // eslint-disable-next-line @typescript-eslint/prefer-nullish-coalescing
+ ) === true) ||
+ !chargingProfile
) {
connectorStatus.transactionRemoteStarted = true;
if (
connectorId: number,
idTag: string,
): Promise<GenericResponse> {
- if (
- chargingStation.getConnectorStatus(connectorId)?.status !== OCPP16ChargePointStatus.Available
- ) {
+ const connectorStatus = chargingStation.getConnectorStatus(connectorId);
+ if (connectorStatus?.status !== OCPP16ChargePointStatus.Available) {
await OCPP16ServiceUtils.sendAndSetConnectorStatus(
chargingStation,
connectorId,
);
}
logger.warn(
- `${chargingStation.logPrefix()} Remote starting transaction REJECTED on connector id
- ${connectorId.toString()}, idTag '${idTag}', availability '${chargingStation.getConnectorStatus(
- connectorId,
- )?.availability}', status '${chargingStation.getConnectorStatus(connectorId)?.status}'`,
+ `${chargingStation.logPrefix()} Remote starting transaction REJECTED on connector id ${connectorId}, idTag '${idTag}', availability '${connectorStatus?.availability}', status '${connectorStatus?.status}'`,
);
return OCPP16Constants.OCPP_RESPONSE_REJECTED;
}
connectorId: number,
chargingProfile: OCPP16ChargingProfile,
): boolean {
- if (
- chargingProfile &&
- chargingProfile.chargingProfilePurpose === OCPP16ChargingProfilePurposeType.TX_PROFILE
- ) {
+ if (chargingProfile?.chargingProfilePurpose === OCPP16ChargingProfilePurposeType.TX_PROFILE) {
OCPP16ServiceUtils.setChargingProfile(chargingStation, connectorId, chargingProfile);
logger.debug(
- `${chargingStation.logPrefix()} Charging profile(s) set at remote start transaction
- on connector id ${connectorId}: %j`,
+ `${chargingStation.logPrefix()} Charging profile(s) set at remote start transaction on connector id ${connectorId}: %j`,
chargingProfile,
);
return true;
- } else if (
- chargingProfile &&
- chargingProfile.chargingProfilePurpose !== OCPP16ChargingProfilePurposeType.TX_PROFILE
- ) {
- logger.warn(
- `${chargingStation.logPrefix()} Not allowed to set ${
- chargingProfile.chargingProfilePurpose
- } charging profile(s) at remote start transaction`,
- );
- return false;
}
- return true;
+ logger.warn(
+ `${chargingStation.logPrefix()} Not allowed to set ${
+ chargingProfile.chargingProfilePurpose
+ } charging profile(s) at remote start transaction`,
+ );
+ return false;
}
private async handleRequestRemoteStopTransaction(
chargingStation: ChargingStation,
commandPayload: RemoteStopTransactionRequest,
): Promise<GenericResponse> {
- const transactionId = commandPayload.transactionId;
- const remoteStopTransaction = async (connectorId: number): Promise<GenericResponse> => {
- await OCPP16ServiceUtils.sendAndSetConnectorStatus(
- chargingStation,
- connectorId,
- OCPP16ChargePointStatus.Finishing,
- );
- const stopResponse = await chargingStation.stopTransactionOnConnector(
- connectorId,
- OCPP16StopTransactionReason.REMOTE,
- );
- if (stopResponse.idTagInfo?.status === OCPP16AuthorizationStatus.ACCEPTED) {
- return OCPP16Constants.OCPP_RESPONSE_ACCEPTED;
- }
- return OCPP16Constants.OCPP_RESPONSE_REJECTED;
- };
+ const { transactionId } = commandPayload;
if (chargingStation.hasEvses) {
for (const [evseId, evseStatus] of chargingStation.evses) {
if (evseId > 0) {
for (const [connectorId, connectorStatus] of evseStatus.connectors) {
if (connectorStatus.transactionId === transactionId) {
- return remoteStopTransaction(connectorId);
+ return OCPP16ServiceUtils.remoteStopTransaction(chargingStation, connectorId);
}
}
}
connectorId > 0 &&
chargingStation.getConnectorStatus(connectorId)?.transactionId === transactionId
) {
- return remoteStopTransaction(connectorId);
+ return OCPP16ServiceUtils.remoteStopTransaction(chargingStation, connectorId);
}
}
}
logger.warn(
- `${chargingStation.logPrefix()} Trying to remote stop a non existing transaction with id:
- ${transactionId.toString()}`,
+ `${chargingStation.logPrefix()} Trying to remote stop a non existing transaction with id ${transactionId}`,
);
return OCPP16Constants.OCPP_RESPONSE_REJECTED;
}
) === false
) {
logger.warn(
- `${chargingStation.logPrefix()} ${moduleName}.handleRequestUpdateFirmware:
- Cannot simulate firmware update: feature profile not supported`,
+ `${chargingStation.logPrefix()} ${moduleName}.handleRequestUpdateFirmware: Cannot simulate firmware update: feature profile not supported`,
);
return OCPP16Constants.OCPP_RESPONSE_EMPTY;
}
+ let { retrieveDate } = commandPayload;
if (
!isNullOrUndefined(chargingStation.stationInfo.firmwareStatus) &&
chargingStation.stationInfo.firmwareStatus !== OCPP16FirmwareStatus.Installed
) {
logger.warn(
- `${chargingStation.logPrefix()} ${moduleName}.handleRequestUpdateFirmware:
- Cannot simulate firmware update: firmware update is already in progress`,
+ `${chargingStation.logPrefix()} ${moduleName}.handleRequestUpdateFirmware: Cannot simulate firmware update: firmware update is already in progress`,
);
return OCPP16Constants.OCPP_RESPONSE_EMPTY;
}
- const retrieveDate = convertToDate(commandPayload.retrieveDate)!;
+ retrieveDate = convertToDate(retrieveDate)!;
const now = Date.now();
if (retrieveDate?.getTime() <= now) {
- this.runInAsyncScope(
- this.updateFirmwareSimulation.bind(this) as (
- this: OCPP16IncomingRequestService,
- ...args: unknown[]
- ) => Promise<void>,
- this,
- chargingStation,
- ).catch(Constants.EMPTY_FUNCTION);
+ this.updateFirmwareSimulation(chargingStation).catch(Constants.EMPTY_FUNCTION);
} else {
setTimeout(
() => {
- this.runInAsyncScope(
- this.updateFirmwareSimulation.bind(this) as (
- this: OCPP16IncomingRequestService,
- ...args: unknown[]
- ) => Promise<void>,
- this,
- chargingStation,
- ).catch(Constants.EMPTY_FUNCTION);
+ this.updateFirmwareSimulation(chargingStation).catch(Constants.EMPTY_FUNCTION);
},
retrieveDate?.getTime() - now,
);
chargingStation.stationInfo?.firmwareUpgrade?.failureStatus ===
OCPP16FirmwareStatus.DownloadFailed
) {
- await sleep(getRandomInteger(maxDelay, minDelay) * 1000);
+ await sleep(secondsToMilliseconds(getRandomInteger(maxDelay, minDelay)));
await chargingStation.ocppRequestService.requestHandler<
OCPP16FirmwareStatusNotificationRequest,
OCPP16FirmwareStatusNotificationResponse
chargingStation.stationInfo?.firmwareUpgrade?.failureStatus;
return;
}
- await sleep(getRandomInteger(maxDelay, minDelay) * 1000);
+ await sleep(secondsToMilliseconds(getRandomInteger(maxDelay, minDelay)));
await chargingStation.ocppRequestService.requestHandler<
OCPP16FirmwareStatusNotificationRequest,
OCPP16FirmwareStatusNotificationResponse
do {
const runningTransactions = chargingStation.getNumberOfRunningTransactions();
if (runningTransactions > 0) {
- const waitTime = 15 * 1000;
+ const waitTime = secondsToMilliseconds(15);
logger.debug(
- `${chargingStation.logPrefix()} ${moduleName}.updateFirmwareSimulation:
- ${runningTransactions} transaction(s) in progress, waiting ${
- waitTime / 1000
- } seconds before continuing firmware update simulation`,
+ `${chargingStation.logPrefix()} ${moduleName}.updateFirmwareSimulation: ${runningTransactions} transaction(s) in progress, waiting ${formatDurationMilliSeconds(
+ waitTime,
+ )} before continuing firmware update simulation`,
);
await sleep(waitTime);
transactionsStarted = true;
transactionsStarted = false;
}
} while (transactionsStarted);
- !wasTransactionsStarted && (await sleep(getRandomInteger(maxDelay, minDelay) * 1000));
+ !wasTransactionsStarted &&
+ (await sleep(secondsToMilliseconds(getRandomInteger(maxDelay, minDelay))));
if (checkChargingStation(chargingStation, chargingStation.logPrefix()) === false) {
return;
}
chargingStation.stationInfo?.firmwareUpgrade?.failureStatus ===
OCPP16FirmwareStatus.InstallationFailed
) {
- await sleep(getRandomInteger(maxDelay, minDelay) * 1000);
+ await sleep(secondsToMilliseconds(getRandomInteger(maxDelay, minDelay)));
await chargingStation.ocppRequestService.requestHandler<
OCPP16FirmwareStatusNotificationRequest,
OCPP16FirmwareStatusNotificationResponse
return;
}
if (chargingStation.stationInfo?.firmwareUpgrade?.reset === true) {
- await sleep(getRandomInteger(maxDelay, minDelay) * 1000);
+ await sleep(secondsToMilliseconds(getRandomInteger(maxDelay, minDelay)));
await chargingStation.reset(OCPP16StopTransactionReason.REBOOT);
}
}
) === false
) {
logger.warn(
- `${chargingStation.logPrefix()} ${moduleName}.handleRequestGetDiagnostics:
- Cannot get diagnostics: feature profile not supported`,
+ `${chargingStation.logPrefix()} ${moduleName}.handleRequestGetDiagnostics: Cannot get diagnostics: feature profile not supported`,
);
return OCPP16Constants.OCPP_RESPONSE_EMPTY;
}
- const uri = new URL(commandPayload.location);
+ const { location } = commandPayload;
+ const uri = new URL(location);
if (uri.protocol.startsWith('ftp:')) {
let ftpClient: Client | undefined;
try {
if (accessResponse.code === 220) {
ftpClient.trackProgress((info) => {
logger.info(
- `${chargingStation.logPrefix()} ${
+ `${chargingStation.logPrefix()} ${moduleName}.handleRequestGetDiagnostics: ${
info.bytes / 1024
} bytes transferred from diagnostics archive ${info.name}`,
);
})
.catch((error) => {
logger.error(
- `${chargingStation.logPrefix()} ${moduleName}.handleRequestGetDiagnostics:
- Error while sending '${OCPP16RequestCommand.DIAGNOSTICS_STATUS_NOTIFICATION}'`,
+ `${chargingStation.logPrefix()} ${moduleName}.handleRequestGetDiagnostics: Error while sending '${
+ OCPP16RequestCommand.DIAGNOSTICS_STATUS_NOTIFICATION
+ }'`,
error,
);
});
}
throw new OCPPError(
ErrorType.GENERIC_ERROR,
- `Diagnostics transfer failed with error code ${accessResponse.code.toString()}${
- uploadResponse?.code && `|${uploadResponse?.code.toString()}`
+ `Diagnostics transfer failed with error code ${accessResponse.code}${
+ uploadResponse?.code && `|${uploadResponse?.code}`
}`,
OCPP16IncomingRequestCommand.GET_DIAGNOSTICS,
);
}
throw new OCPPError(
ErrorType.GENERIC_ERROR,
- `Diagnostics transfer failed with error code ${accessResponse.code.toString()}${
- uploadResponse?.code && `|${uploadResponse?.code.toString()}`
+ `Diagnostics transfer failed with error code ${accessResponse.code}${
+ uploadResponse?.code && `|${uploadResponse?.code}`
}`,
OCPP16IncomingRequestCommand.GET_DIAGNOSTICS,
);
chargingStation: ChargingStation,
commandPayload: OCPP16TriggerMessageRequest,
): OCPP16TriggerMessageResponse {
+ const { requestedMessage, connectorId } = commandPayload;
if (
!OCPP16ServiceUtils.checkFeatureProfile(
chargingStation,
OCPP16SupportedFeatureProfiles.RemoteTrigger,
OCPP16IncomingRequestCommand.TRIGGER_MESSAGE,
) ||
- !OCPP16ServiceUtils.isMessageTriggerSupported(
- chargingStation,
- commandPayload.requestedMessage,
- )
+ !OCPP16ServiceUtils.isMessageTriggerSupported(chargingStation, requestedMessage)
) {
return OCPP16Constants.OCPP_TRIGGER_MESSAGE_RESPONSE_NOT_IMPLEMENTED;
}
!OCPP16ServiceUtils.isConnectorIdValid(
chargingStation,
OCPP16IncomingRequestCommand.TRIGGER_MESSAGE,
- commandPayload.connectorId!,
+ connectorId!,
)
) {
return OCPP16Constants.OCPP_TRIGGER_MESSAGE_RESPONSE_REJECTED;
}
try {
- switch (commandPayload.requestedMessage) {
+ switch (requestedMessage) {
case OCPP16MessageTrigger.BootNotification:
setTimeout(() => {
chargingStation.ocppRequestService
.requestHandler<OCPP16HeartbeatRequest, OCPP16HeartbeatResponse>(
chargingStation,
OCPP16RequestCommand.HEARTBEAT,
- null,
+ undefined,
{
triggerMessage: true,
},
return OCPP16Constants.OCPP_TRIGGER_MESSAGE_RESPONSE_ACCEPTED;
case OCPP16MessageTrigger.StatusNotification:
setTimeout(() => {
- if (!isNullOrUndefined(commandPayload?.connectorId)) {
+ if (!isNullOrUndefined(connectorId)) {
chargingStation.ocppRequestService
.requestHandler<OCPP16StatusNotificationRequest, OCPP16StatusNotificationResponse>(
chargingStation,
OCPP16RequestCommand.STATUS_NOTIFICATION,
{
- connectorId: commandPayload.connectorId,
+ connectorId,
errorCode: OCPP16ChargePointErrorCode.NO_ERROR,
- status: chargingStation.getConnectorStatus(commandPayload.connectorId!)?.status,
+ status: chargingStation.getConnectorStatus(connectorId!)?.status,
},
{
triggerMessage: true,
// eslint-disable-next-line no-lonely-if
if (chargingStation.hasEvses) {
for (const evseStatus of chargingStation.evses.values()) {
- for (const [connectorId, connectorStatus] of evseStatus.connectors) {
+ for (const [id, connectorStatus] of evseStatus.connectors) {
chargingStation.ocppRequestService
.requestHandler<
OCPP16StatusNotificationRequest,
chargingStation,
OCPP16RequestCommand.STATUS_NOTIFICATION,
{
- connectorId,
+ connectorId: id,
errorCode: OCPP16ChargePointErrorCode.NO_ERROR,
status: connectorStatus.status,
},
}
}
} else {
- for (const connectorId of chargingStation.connectors.keys()) {
+ for (const id of chargingStation.connectors.keys()) {
chargingStation.ocppRequestService
.requestHandler<
OCPP16StatusNotificationRequest,
chargingStation,
OCPP16RequestCommand.STATUS_NOTIFICATION,
{
- connectorId,
+ connectorId: id,
errorCode: OCPP16ChargePointErrorCode.NO_ERROR,
- status: chargingStation.getConnectorStatus(connectorId)?.status,
+ status: chargingStation.getConnectorStatus(id)?.status,
},
{
triggerMessage: true,
chargingStation: ChargingStation,
commandPayload: OCPP16DataTransferRequest,
): OCPP16DataTransferResponse {
+ const { vendorId } = commandPayload;
try {
- if (Object.values(OCPP16DataTransferVendorId).includes(commandPayload.vendorId)) {
+ if (Object.values(OCPP16DataTransferVendorId).includes(vendorId)) {
return OCPP16Constants.OCPP_DATA_TRANSFER_RESPONSE_ACCEPTED;
}
return OCPP16Constants.OCPP_DATA_TRANSFER_RESPONSE_UNKNOWN_VENDOR_ID;
const { reservationId, idTag, connectorId } = commandPayload;
let response: OCPP16ReserveNowResponse;
try {
- if (!chargingStation.isConnectorAvailable(connectorId) && connectorId > 0) {
+ if (connectorId > 0 && !chargingStation.isConnectorAvailable(connectorId)) {
return OCPP16Constants.OCPP_RESERVATION_RESPONSE_REJECTED;
}
- if (connectorId === 0 && !chargingStation.getReservationOnConnectorId0Enabled()) {
+ if (connectorId === 0 && !chargingStation.getReserveConnectorZeroSupported()) {
return OCPP16Constants.OCPP_RESERVATION_RESPONSE_REJECTED;
}
if (!(await OCPP16ServiceUtils.isIdTagAuthorized(chargingStation, connectorId, idTag))) {
return OCPP16Constants.OCPP_RESERVATION_RESPONSE_REJECTED;
}
+ await removeExpiredReservations(chargingStation);
switch (chargingStation.getConnectorStatus(connectorId)!.status) {
case OCPP16ChargePointStatus.Faulted:
response = OCPP16Constants.OCPP_RESERVATION_RESPONSE_FAULTED;
}
try {
const { reservationId } = commandPayload;
- const [exists, reservation] = chargingStation.doesReservationExists({ id: reservationId });
- if (!exists) {
- logger.error(
- `${chargingStation.logPrefix()} Reservation with ID ${reservationId}
- does not exist on charging station`,
+ const reservation = chargingStation.getReservationBy('reservationId', reservationId);
+ if (isUndefined(reservation)) {
+ logger.debug(
+ `${chargingStation.logPrefix()} Reservation with id ${reservationId} does not exist on charging station`,
);
return OCPP16Constants.OCPP_CANCEL_RESERVATION_RESPONSE_REJECTED;
}
repositories / e-mobility-charging-stations-simulator.git / blobdiff