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

   1 import { MeterValueContext, MeterValueLocation, MeterValuePhase, MeterValueUnit, OCPP16MeterValueMeasurand, OCPP16SampledValue } from '../../../types/ocpp/1.6/MeterValues';
   2
   3 import ChargingStation from '../../ChargingStation';
   4 import Utils from '../../../utils/Utils';
   5 import logger from '../../../utils/Logger';
   6
   7 export class OCPP16ServiceUtils {
   8   public static checkMeasurandPowerDivider(chargingStation: ChargingStation, measurandType: OCPP16MeterValueMeasurand): void {
   9     if (Utils.isUndefined(chargingStation.stationInfo.powerDivider)) {
  10       const errMsg = `${chargingStation.logPrefix()} MeterValues measurand ${measurandType ?? OCPP16MeterValueMeasurand.ENERGY_ACTIVE_IMPORT_REGISTER}: powerDivider is undefined`;
  11       logger.error(errMsg);
  12       throw Error(errMsg);
  13     } else if (chargingStation.stationInfo.powerDivider && chargingStation.stationInfo.powerDivider <= 0) {
  14       const errMsg = `${chargingStation.logPrefix()} MeterValues measurand ${measurandType ?? OCPP16MeterValueMeasurand.ENERGY_ACTIVE_IMPORT_REGISTER}: powerDivider have zero or below value ${chargingStation.stationInfo.powerDivider}`;
  15       logger.error(errMsg);
  16       throw Error(errMsg);
  17     }
  18   }
  19
  20   public static buildSampledValue(sampledValueTemplate: OCPP16SampledValue, value: number, context?: MeterValueContext, phase?: MeterValuePhase): OCPP16SampledValue {
  21     const sampledValueContext = context ?? (sampledValueTemplate.context ?? null);
  22     const sampledValueLocation = sampledValueTemplate.location
  23       ? sampledValueTemplate.location
  24       : (OCPP16ServiceUtils.getMeasurandDefaultLocation(sampledValueTemplate.measurand ?? null));
  25     const sampledValuePhase = phase ?? (sampledValueTemplate.phase ?? null);
  26     return {
  27       ...!Utils.isNullOrUndefined(sampledValueTemplate.unit) && { unit: sampledValueTemplate.unit },
  28       ...!Utils.isNullOrUndefined(sampledValueContext) && { context: sampledValueContext },
  29       ...!Utils.isNullOrUndefined(sampledValueTemplate.measurand) && { measurand: sampledValueTemplate.measurand },
  30       ...!Utils.isNullOrUndefined(sampledValueLocation) && { location: sampledValueLocation },
  31       ...!Utils.isNullOrUndefined(sampledValueTemplate.value) ? { value: sampledValueTemplate.value } : { value: value.toString() },
  32       ...!Utils.isNullOrUndefined(sampledValuePhase) && { phase: sampledValuePhase },
  33     };
  34   }
  35
  36   public static getMeasurandDefaultUnit(measurandType: OCPP16MeterValueMeasurand): MeterValueUnit {
  37     switch (measurandType) {
  38       case OCPP16MeterValueMeasurand.CURRENT_EXPORT:
  39       case OCPP16MeterValueMeasurand.CURRENT_IMPORT:
  40       case OCPP16MeterValueMeasurand.CURRENT_OFFERED:
  41         return MeterValueUnit.AMP;
  42       case OCPP16MeterValueMeasurand.ENERGY_ACTIVE_EXPORT_REGISTER:
  43       case OCPP16MeterValueMeasurand.ENERGY_ACTIVE_IMPORT_REGISTER:
  44         return MeterValueUnit.WATT_HOUR;
  45       case OCPP16MeterValueMeasurand.POWER_ACTIVE_EXPORT:
  46       case OCPP16MeterValueMeasurand.POWER_ACTIVE_IMPORT:
  47       case OCPP16MeterValueMeasurand.POWER_OFFERED:
  48         return MeterValueUnit.WATT;
  49       case OCPP16MeterValueMeasurand.STATE_OF_CHARGE:
  50         return MeterValueUnit.PERCENT;
  51       case OCPP16MeterValueMeasurand.VOLTAGE:
  52         return MeterValueUnit.VOLT;
  53     }
  54   }
  55
  56   public static getMeasurandDefaultLocation(measurandType: OCPP16MeterValueMeasurand): MeterValueLocation {
  57     switch (measurandType) {
  58       case OCPP16MeterValueMeasurand.STATE_OF_CHARGE:
  59         return MeterValueLocation.EV;
  60     }
  61   }
  62 }