src/charging-station/ocpp/1.6/OCPP16ResponseService.ts

   1 // Partial Copyright Jerome Benoit. 2021. All Rights Reserved.
   2
   3 import { AuthorizeRequest, OCPP16AuthorizationStatus, OCPP16AuthorizeResponse, OCPP16StartTransactionResponse, OCPP16StopTransactionResponse, StartTransactionRequest, StopTransactionRequest } from '../../../types/ocpp/1.6/Transaction';
   4 import { HeartbeatRequest, OCPP16RequestCommand, StatusNotificationRequest } from '../../../types/ocpp/1.6/Requests';
   5 import { HeartbeatResponse, OCPP16BootNotificationResponse, OCPP16RegistrationStatus, StatusNotificationResponse } from '../../../types/ocpp/1.6/Responses';
   6 import { MeterValuesRequest, MeterValuesResponse } from '../../../types/ocpp/1.6/MeterValues';
   7
   8 import ChargingStation from '../../ChargingStation';
   9 import { OCPP16ChargePointStatus } from '../../../types/ocpp/1.6/ChargePointStatus';
  10 import { OCPP16ServiceUtils } from './OCPP16ServiceUtils';
  11 import { OCPP16StandardParametersKey } from '../../../types/ocpp/1.6/Configuration';
  12 import OCPPResponseService from '../OCPPResponseService';
  13 import { ResponseHandler } from '../../../types/ocpp/Responses';
  14 import Utils from '../../../utils/Utils';
  15 import logger from '../../../utils/Logger';
  16
  17 export default class OCPP16ResponseService extends OCPPResponseService {
  18   private responseHandlers: Map<OCPP16RequestCommand, ResponseHandler>;
  19
  20   constructor(chargingStation: ChargingStation) {
  21     super(chargingStation);
  22     this.responseHandlers = new Map<OCPP16RequestCommand, ResponseHandler>([
  23       [OCPP16RequestCommand.BOOT_NOTIFICATION, this.handleResponseBootNotification.bind(this)],
  24       [OCPP16RequestCommand.HEARTBEAT, this.handleResponseHeartbeat.bind(this)],
  25       [OCPP16RequestCommand.AUTHORIZE, this.handleResponseAuthorize.bind(this)],
  26       [OCPP16RequestCommand.START_TRANSACTION, this.handleResponseStartTransaction.bind(this)],
  27       [OCPP16RequestCommand.STOP_TRANSACTION, this.handleResponseStopTransaction.bind(this)],
  28       [OCPP16RequestCommand.STATUS_NOTIFICATION, this.handleResponseStatusNotification.bind(this)],
  29       [OCPP16RequestCommand.METER_VALUES, this.handleResponseMeterValues.bind(this)]
  30     ]);
  31   }
  32
  33   public async handleResponse(commandName: OCPP16RequestCommand, payload: Record<string, unknown> | string, requestPayload: Record<string, unknown>): Promise<void> {
  34     if (this.responseHandlers.has(commandName)) {
  35       try {
  36         await this.responseHandlers.get(commandName)(payload, requestPayload);
  37       } catch (error) {
  38         logger.error(this.chargingStation.logPrefix() + ' Handle request response error: %j', error);
  39       }
  40     } else {
  41       logger.error(`${this.chargingStation.logPrefix()} %s is not implemented to handle request response payload %j`, commandName, payload);
  42     }
  43   }
  44
  45   private handleResponseBootNotification(payload: OCPP16BootNotificationResponse): void {
  46     if (payload.status === OCPP16RegistrationStatus.ACCEPTED) {
  47       this.chargingStation.addConfigurationKey(OCPP16StandardParametersKey.HeartBeatInterval, payload.interval.toString());
  48       this.chargingStation.addConfigurationKey(OCPP16StandardParametersKey.HeartbeatInterval, payload.interval.toString(), false, false);
  49       this.chargingStation.heartbeatSetInterval ? this.chargingStation.restartHeartbeat() : this.chargingStation.startHeartbeat();
  50     } else if (payload.status === OCPP16RegistrationStatus.PENDING) {
  51       logger.info(this.chargingStation.logPrefix() + ' Charging station in pending state on the central server');
  52     } else {
  53       logger.warn(this.chargingStation.logPrefix() + ' Charging station rejected by the central server');
  54     }
  55   }
  56
  57   private handleResponseHeartbeat(payload: HeartbeatResponse, requestPayload: HeartbeatRequest): void {
  58     logger.debug(this.chargingStation.logPrefix() + ' Heartbeat response received: %j to Heartbeat request: %j', payload, requestPayload);
  59   }
  60
  61   private handleResponseAuthorize(payload: OCPP16AuthorizeResponse, requestPayload: AuthorizeRequest): void {
  62     let authorizeConnectorId: number;
  63     for (const connectorId of this.chargingStation.connectors.keys()) {
  64       if (connectorId > 0 && this.chargingStation.getConnectorStatus(connectorId)?.authorizeIdTag === requestPayload.idTag) {
  65         authorizeConnectorId = connectorId;
  66         break;
  67       }
  68     }
  69     if (payload.idTagInfo.status === OCPP16AuthorizationStatus.ACCEPTED) {
  70       this.chargingStation.getConnectorStatus(authorizeConnectorId).authorized = true;
  71       logger.debug(`${this.chargingStation.logPrefix()} IdTag ${requestPayload.idTag} authorized on connector ${authorizeConnectorId}`);
  72     } else {
  73       this.chargingStation.getConnectorStatus(authorizeConnectorId).authorized = false;
  74       delete this.chargingStation.getConnectorStatus(authorizeConnectorId).authorizeIdTag;
  75       logger.debug(`${this.chargingStation.logPrefix()} IdTag ${requestPayload.idTag} refused with status ${payload.idTagInfo.status} on connector ${authorizeConnectorId}`);
  76     }
  77   }
  78
  79   private async handleResponseStartTransaction(payload: OCPP16StartTransactionResponse, requestPayload: StartTransactionRequest): Promise<void> {
  80     const connectorId = requestPayload.connectorId;
  81
  82     let transactionConnectorId: number;
  83     for (const id of this.chargingStation.connectors.keys()) {
  84       if (id > 0 && id === connectorId) {
  85         transactionConnectorId = id;
  86         break;
  87       }
  88     }
  89     if (!transactionConnectorId) {
  90       logger.error(this.chargingStation.logPrefix() + ' Trying to start a transaction on a non existing connector Id ' + connectorId.toString());
  91       return;
  92     }
  93     if (this.chargingStation.getConnectorStatus(connectorId).authorized && this.chargingStation.getConnectorStatus(connectorId).authorizeIdTag !== requestPayload.idTag) {
  94       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());
  95       return;
  96     }
  97     if (this.chargingStation.getConnectorStatus(connectorId)?.transactionStarted) {
  98       logger.debug(this.chargingStation.logPrefix() + ' Trying to start a transaction on an already used connector ' + connectorId.toString() + ': %j', this.chargingStation.getConnectorStatus(connectorId));
  99       return;
 100     }
 101     if (this.chargingStation.getConnectorStatus(connectorId)?.status !== OCPP16ChargePointStatus.AVAILABLE
 102       && this.chargingStation.getConnectorStatus(connectorId)?.status !== OCPP16ChargePointStatus.PREPARING) {
 103       logger.error(`${this.chargingStation.logPrefix()} Trying to start a transaction on connector ${connectorId.toString()} with status ${this.chargingStation.getConnectorStatus(connectorId)?.status}`);
 104       return;
 105     }
 106     if (!Number.isInteger(payload.transactionId)) {
 107       logger.warn(`${this.chargingStation.logPrefix()} Trying to start a transaction on connector ${connectorId.toString()} with a non integer transaction Id ${payload.transactionId}, converting to integer`);
 108       payload.transactionId = Utils.convertToInt(payload.transactionId);
 109     }
 110
 111     if (payload.idTagInfo?.status === OCPP16AuthorizationStatus.ACCEPTED) {
 112       this.chargingStation.getConnectorStatus(connectorId).transactionStarted = true;
 113       this.chargingStation.getConnectorStatus(connectorId).transactionId = payload.transactionId;
 114       this.chargingStation.getConnectorStatus(connectorId).transactionIdTag = requestPayload.idTag;
 115       this.chargingStation.getConnectorStatus(connectorId).transactionEnergyActiveImportRegisterValue = 0;
 116       this.chargingStation.getConnectorStatus(connectorId).transactionBeginMeterValue = OCPP16ServiceUtils.buildTransactionBeginMeterValue(this.chargingStation, connectorId,
 117         requestPayload.meterStart);
 118       this.chargingStation.getBeginEndMeterValues() && await this.chargingStation.ocppRequestService.sendTransactionBeginMeterValues(connectorId, payload.transactionId,
 119         this.chargingStation.getConnectorStatus(connectorId).transactionBeginMeterValue);
 120       await this.chargingStation.ocppRequestService.sendStatusNotification(connectorId, OCPP16ChargePointStatus.CHARGING);
 121       this.chargingStation.getConnectorStatus(connectorId).status = OCPP16ChargePointStatus.CHARGING;
 122       logger.info(this.chargingStation.logPrefix() + ' Transaction ' + payload.transactionId.toString() + ' STARTED on ' + this.chargingStation.stationInfo.chargingStationId + '#' + connectorId.toString() + ' for idTag ' + requestPayload.idTag);
 123       if (this.chargingStation.stationInfo.powerSharedByConnectors) {
 124         this.chargingStation.stationInfo.powerDivider++;
 125       }
 126       const configuredMeterValueSampleInterval = this.chargingStation.getConfigurationKey(OCPP16StandardParametersKey.MeterValueSampleInterval);
 127       this.chargingStation.startMeterValues(connectorId, configuredMeterValueSampleInterval ? Utils.convertToInt(configuredMeterValueSampleInterval.value) * 1000 : 60000);
 128     } else {
 129       logger.warn(this.chargingStation.logPrefix() + ' Starting transaction id ' + payload.transactionId.toString() + ' REJECTED with status ' + payload?.idTagInfo?.status + ', idTag ' + requestPayload.idTag);
 130       this.chargingStation.resetTransactionOnConnector(connectorId);
 131       if (this.chargingStation.getConnectorStatus(connectorId).status !== OCPP16ChargePointStatus.AVAILABLE) {
 132         await this.chargingStation.ocppRequestService.sendStatusNotification(connectorId, OCPP16ChargePointStatus.AVAILABLE);
 133         this.chargingStation.getConnectorStatus(connectorId).status = OCPP16ChargePointStatus.AVAILABLE;
 134       }
 135     }
 136   }
 137
 138   private async handleResponseStopTransaction(payload: OCPP16StopTransactionResponse, requestPayload: StopTransactionRequest): Promise<void> {
 139     let transactionConnectorId: number;
 140     for (const connectorId of this.chargingStation.connectors.keys()) {
 141       if (connectorId > 0 && this.chargingStation.getConnectorStatus(connectorId)?.transactionId === requestPayload.transactionId) {
 142         transactionConnectorId = connectorId;
 143         break;
 144       }
 145     }
 146     if (!transactionConnectorId) {
 147       logger.error(this.chargingStation.logPrefix() + ' Trying to stop a non existing transaction ' + requestPayload.transactionId.toString());
 148       return;
 149     }
 150     if (payload.idTagInfo?.status === OCPP16AuthorizationStatus.ACCEPTED) {
 151       (this.chargingStation.getBeginEndMeterValues() && this.chargingStation.getOutOfOrderEndMeterValues())
 152         && await this.chargingStation.ocppRequestService.sendTransactionEndMeterValues(transactionConnectorId, requestPayload.transactionId,
 153           OCPP16ServiceUtils.buildTransactionEndMeterValue(this.chargingStation, transactionConnectorId, requestPayload.meterStop));
 154       if (!this.chargingStation.isChargingStationAvailable() || !this.chargingStation.isConnectorAvailable(transactionConnectorId)) {
 155         await this.chargingStation.ocppRequestService.sendStatusNotification(transactionConnectorId, OCPP16ChargePointStatus.UNAVAILABLE);
 156         this.chargingStation.getConnectorStatus(transactionConnectorId).status = OCPP16ChargePointStatus.UNAVAILABLE;
 157       } else {
 158         await this.chargingStation.ocppRequestService.sendStatusNotification(transactionConnectorId, OCPP16ChargePointStatus.AVAILABLE);
 159         this.chargingStation.getConnectorStatus(transactionConnectorId).status = OCPP16ChargePointStatus.AVAILABLE;
 160       }
 161       if (this.chargingStation.stationInfo.powerSharedByConnectors) {
 162         this.chargingStation.stationInfo.powerDivider--;
 163       }
 164       logger.info(this.chargingStation.logPrefix() + ' Transaction ' + requestPayload.transactionId.toString() + ' STOPPED on ' + this.chargingStation.stationInfo.chargingStationId + '#' + transactionConnectorId.toString());
 165       this.chargingStation.resetTransactionOnConnector(transactionConnectorId);
 166     } else {
 167       logger.warn(this.chargingStation.logPrefix() + ' Stopping transaction id ' + requestPayload.transactionId.toString() + ' REJECTED with status ' + payload.idTagInfo?.status);
 168     }
 169   }
 170
 171   private handleResponseStatusNotification(payload: StatusNotificationRequest, requestPayload: StatusNotificationResponse): void {
 172     logger.debug(this.chargingStation.logPrefix() + ' Status notification response received: %j to StatusNotification request: %j', payload, requestPayload);
 173   }
 174
 175   private handleResponseMeterValues(payload: MeterValuesRequest, requestPayload: MeterValuesResponse): void {
 176     logger.debug(this.chargingStation.logPrefix() + ' MeterValues response received: %j to MeterValues request: %j', payload, requestPayload);
 177   }
 178 }