Refine error messages.
[e-mobility-charging-stations-simulator.git] / src / charging-station / ChargingStation.js
CommitLineData
3f40bc9c
JB
1import {PerformanceObserver, performance} from 'perf_hooks';
2
3import AutomaticTransactionGenerator from './AutomaticTransactionGenerator.js';
4import Configuration from '../utils/Configuration.js';
5import Constants from '../utils/Constants.js';
6import ElectricUtils from '../utils/ElectricUtils.js';
7import OCPPError from './OcppError.js';
8import Statistics from '../utils/Statistics.js';
9import Utils from '../utils/Utils.js';
10import WebSocket from 'ws';
11import crypto from 'crypto';
12import fs from 'fs';
13import logger from '../utils/Logger.js';
14
15export default class ChargingStation {
2e6f5966
JB
16 constructor(index, stationTemplateFile) {
17 this._index = index;
18 this._stationTemplateFile = stationTemplateFile;
fa9bcef2 19 this._connectors = {};
2e6f5966
JB
20 this._initialize();
21
0a60c33c 22 this._isSocketRestart = false;
7dde0b73
JB
23 this._autoReconnectRetryCount = 0;
24 this._autoReconnectMaxRetries = Configuration.getAutoReconnectMaxRetries(); // -1 for unlimited
25 this._autoReconnectTimeout = Configuration.getAutoReconnectTimeout() * 1000; // ms, zero for disabling
2e6f5966
JB
26
27 this._requests = {};
28 this._messageQueue = [];
29
83045896 30 this._authorizedTags = this._loadAndGetAuthorizedTags();
2e6f5966
JB
31 }
32
5ad8570f
JB
33 _getStationName(stationTemplate) {
34 return stationTemplate.fixedName ? stationTemplate.baseName : stationTemplate.baseName + '-' + ('000000000' + this._index).substr(('000000000' + this._index).length - 4);
35 }
36
37 _buildStationInfo() {
38 let stationTemplateFromFile;
39 try {
40 // Load template file
41 const fileDescriptor = fs.openSync(this._stationTemplateFile, 'r');
42 stationTemplateFromFile = JSON.parse(fs.readFileSync(fileDescriptor, 'utf8'));
43 fs.closeSync(fileDescriptor);
44 } catch (error) {
cdd9fed5
JB
45 logger.error('Template file ' + this._stationTemplateFile + ' loading error: ' + error);
46 throw error;
5ad8570f
JB
47 }
48 const stationTemplate = stationTemplateFromFile || {};
0a60c33c 49 if (!Utils.isEmptyArray(stationTemplateFromFile.power)) {
5ad8570f
JB
50 stationTemplate.maxPower = stationTemplateFromFile.power[Math.floor(Math.random() * stationTemplateFromFile.power.length)];
51 } else {
52 stationTemplate.maxPower = stationTemplateFromFile.power;
53 }
54 stationTemplate.name = this._getStationName(stationTemplateFromFile);
0a60c33c 55 stationTemplate.resetTime = stationTemplateFromFile.resetTime ? stationTemplateFromFile.resetTime * 1000 : Constants.CHARGING_STATION_DEFAULT_RESET_TIME;
5ad8570f
JB
56 return stationTemplate;
57 }
58
2e6f5966
JB
59 _initialize() {
60 this._stationInfo = this._buildStationInfo();
61 this._bootNotificationMessage = {
62 chargePointModel: this._stationInfo.chargePointModel,
63 chargePointVendor: this._stationInfo.chargePointVendor,
38c8fd6c
JB
64 ...!Utils.isUndefined(this._stationInfo.chargePointSerialNumberPrefix) && {chargePointSerialNumber: this._stationInfo.chargePointSerialNumberPrefix},
65 ...!Utils.isUndefined(this._stationInfo.firmwareVersion) && {firmwareVersion: this._stationInfo.firmwareVersion},
2e6f5966
JB
66 };
67 this._configuration = this._getConfiguration();
2e6f5966 68 this._supervisionUrl = this._getSupervisionURL();
0a60c33c
JB
69 this._wsConnectionUrl = this._supervisionUrl + '/' + this._stationInfo.name;
70 // Build connectors if needed
6ecb15e4
JB
71 const maxConnectors = this._getMaxNumberOfConnectors();
72 if (maxConnectors <= 0) {
3f40bc9c 73 logger.warn(`${this._logPrefix()} Charging station template ${this._stationTemplateFile} with ${maxConnectors} connectors`);
7abfea5f
JB
74 }
75 const templateMaxConnectors = this._getTemplateMaxNumberOfConnectors();
76 if (templateMaxConnectors <= 0) {
3f40bc9c 77 logger.warn(`${this._logPrefix()} Charging station template ${this._stationTemplateFile} with no connector configurations`);
7abfea5f
JB
78 }
79 // Sanity check
80 if (maxConnectors > (this._stationInfo.Connectors[0] ? templateMaxConnectors - 1 : templateMaxConnectors) && !Utils.convertToBoolean(this._stationInfo.randomConnectors)) {
81 logger.warn(`${this._logPrefix()} Number of connectors exceeds the number of connector configurations in template ${this._stationTemplateFile}, forcing random connector configurations affectation`);
82 this._stationInfo.randomConnectors = true;
6ecb15e4 83 }
8bce55bf 84 const connectorsConfigHash = crypto.createHash('sha256').update(JSON.stringify(this._stationInfo.Connectors) + maxConnectors.toString()).digest('hex');
de1f5008 85 // FIXME: Handle shrinking the number of connectors
5a9f5716 86 if (!this._connectors || (this._connectors && this._connectorsConfigurationHash !== connectorsConfigHash)) {
de1f5008 87 this._connectorsConfigurationHash = connectorsConfigHash;
7abfea5f
JB
88 // Add connector Id 0
89 let lastConnector = 0;
8bce55bf 90 for (lastConnector in this._stationInfo.Connectors) {
7abfea5f 91 if (Utils.convertToInt(lastConnector) === 0 && Utils.convertToBoolean(this._stationInfo.useConnectorId0) && this._stationInfo.Connectors[lastConnector]) {
2328be1e 92 this._connectors[lastConnector] = Utils.cloneObject(this._stationInfo.Connectors[lastConnector]);
0a60c33c
JB
93 }
94 }
0a60c33c 95 // Generate all connectors
7abfea5f
JB
96 if ((this._stationInfo.Connectors[0] ? templateMaxConnectors - 1 : templateMaxConnectors) > 0) {
97 for (let index = 1; index <= maxConnectors; index++) {
98 const randConnectorID = Utils.convertToBoolean(this._stationInfo.randomConnectors) ? Utils.getRandomInt(lastConnector, 1) : index;
99 this._connectors[index] = Utils.cloneObject(this._stationInfo.Connectors[randConnectorID]);
100 }
0a60c33c
JB
101 }
102 }
d4a73fb7
JB
103 // Avoid duplication of connectors related information
104 delete this._stationInfo.Connectors;
0a60c33c
JB
105 // Initialize transaction attributes on connectors
106 for (const connector in this._connectors) {
8bce55bf 107 if (!this.getConnector(connector).transactionStarted) {
0a60c33c
JB
108 this._initTransactionOnConnector(connector);
109 }
110 }
7abfea5f
JB
111 // OCPP parameters
112 this._addConfigurationKey('NumberOfConnectors', this._getNumberOfConnectors(), true);
113 if (!this._getConfigurationKey('MeterValuesSampledData')) {
114 this._addConfigurationKey('MeterValuesSampledData', 'Energy.Active.Import.Register');
115 }
6ecb15e4 116 this._stationInfo.powerDivider = this._getPowerDivider();
8bce55bf
JB
117 if (this.getEnableStatistics()) {
118 this._statistics = Statistics.getInstance();
119 this._statistics.objName = this._stationInfo.name;
120 this._performanceObserver = new PerformanceObserver((list) => {
121 const entry = list.getEntries()[0];
122 this._statistics.logPerformance(entry, 'ChargingStation');
123 this._performanceObserver.disconnect();
124 });
125 }
7dde0b73
JB
126 }
127
ead548f2
JB
128 _logPrefix() {
129 return Utils.logPrefix(` ${this._stationInfo.name}:`);
7dde0b73
JB
130 }
131
2e6f5966
JB
132 _getConfiguration() {
133 return this._stationInfo.Configuration ? this._stationInfo.Configuration : {};
7dde0b73
JB
134 }
135
2e6f5966
JB
136 _getAuthorizationFile() {
137 return this._stationInfo.authorizationFile ? this._stationInfo.authorizationFile : '';
7dde0b73
JB
138 }
139
83045896 140 _loadAndGetAuthorizedTags() {
2e6f5966
JB
141 let authorizedTags = [];
142 const authorizationFile = this._getAuthorizationFile();
143 if (authorizationFile) {
144 try {
145 // Load authorization file
146 const fileDescriptor = fs.openSync(authorizationFile, 'r');
147 authorizedTags = JSON.parse(fs.readFileSync(fileDescriptor, 'utf8'));
148 fs.closeSync(fileDescriptor);
149 } catch (error) {
cdd9fed5
JB
150 logger.error(this._logPrefix() + ' Authorization file ' + authorizationFile + ' loading error: ' + error);
151 throw error;
2e6f5966
JB
152 }
153 } else {
ead548f2 154 logger.info(this._logPrefix() + ' No authorization file given in template file ' + this._stationTemplateFile);
2e6f5966
JB
155 }
156 return authorizedTags;
157 }
158
5ad8570f
JB
159 getRandomTagId() {
160 const index = Math.floor(Math.random() * this._authorizedTags.length);
161 return this._authorizedTags[index];
2e6f5966
JB
162 }
163
5ad8570f
JB
164 hasAuthorizedTags() {
165 return !Utils.isEmptyArray(this._authorizedTags);
166 }
167
8bce55bf 168 getEnableStatistics() {
2328be1e
JB
169 return !Utils.isUndefined(this._stationInfo.enableStatistics) ? Utils.convertToBoolean(this._stationInfo.enableStatistics) : true;
170 }
171
172 _getNumberOfPhases() {
173 return !Utils.isUndefined(this._stationInfo.numberOfPhases) ? Utils.convertToInt(this._stationInfo.numberOfPhases) : 3;
8bce55bf
JB
174 }
175
6ecb15e4
JB
176 _getNumberOfRunningTransactions() {
177 let trxCount = 0;
178 for (const connector in this._connectors) {
8bce55bf 179 if (this.getConnector(connector).transactionStarted) {
6ecb15e4
JB
180 trxCount++;
181 }
182 }
183 return trxCount;
184 }
185
186 _getPowerDivider() {
7abfea5f 187 let powerDivider = this._getNumberOfConnectors();
6ecb15e4
JB
188 if (this._stationInfo.powerSharedByConnectors) {
189 powerDivider = this._getNumberOfRunningTransactions();
190 }
191 return powerDivider;
192 }
193
8bce55bf
JB
194 getConnector(id) {
195 return this._connectors[Utils.convertToInt(id)];
6ecb15e4
JB
196 }
197
7abfea5f
JB
198 _getTemplateMaxNumberOfConnectors() {
199 return Object.keys(this._stationInfo.Connectors).length;
200 }
201
6ecb15e4 202 _getMaxNumberOfConnectors() {
5ad8570f 203 let maxConnectors = 0;
0a60c33c 204 if (!Utils.isEmptyArray(this._stationInfo.numberOfConnectors)) {
6ecb15e4 205 // Distribute evenly the number of connectors
5ad8570f 206 maxConnectors = this._stationInfo.numberOfConnectors[(this._index - 1) % this._stationInfo.numberOfConnectors.length];
7abfea5f 207 } else if (!Utils.isUndefined(this._stationInfo.numberOfConnectors)) {
5ad8570f 208 maxConnectors = this._stationInfo.numberOfConnectors;
488fd3a7 209 } else {
7abfea5f 210 maxConnectors = this._stationInfo.Connectors[0] ? this._getTemplateMaxNumberOfConnectors() - 1 : this._getTemplateMaxNumberOfConnectors();
5ad8570f
JB
211 }
212 return maxConnectors;
2e6f5966
JB
213 }
214
6ecb15e4 215 _getNumberOfConnectors() {
7abfea5f 216 return this._connectors[0] ? Object.keys(this._connectors).length - 1 : Object.keys(this._connectors).length;
6ecb15e4
JB
217 }
218
b2acff85
JB
219 _getVoltageOut() {
220 const errMsg = `${this._logPrefix()} Unknown ${this._getPowerOutType()} powerOutType in template file ${this._stationTemplateFile}, cannot define default voltage out`;
221 let defaultVoltageOut;
222 switch (this._getPowerOutType()) {
223 case 'AC':
224 defaultVoltageOut = 230;
225 break;
226 case 'DC':
227 defaultVoltageOut = 400;
228 break;
229 default:
230 logger.error(errMsg);
231 throw Error(errMsg);
232 }
233 return !Utils.isUndefined(this._stationInfo.voltageOut) ? Utils.convertToInt(this._stationInfo.voltageOut) : defaultVoltageOut;
234 }
235
236 _getPowerOutType() {
237 return !Utils.isUndefined(this._stationInfo.powerOutType) ? this._stationInfo.powerOutType : 'AC';
3f40bc9c
JB
238 }
239
2e6f5966 240 _getSupervisionURL() {
2328be1e 241 const supervisionUrls = Utils.cloneObject(this._stationInfo.supervisionURL ? this._stationInfo.supervisionURL : Configuration.getSupervisionURLs());
7dde0b73 242 let indexUrl = 0;
0a60c33c 243 if (!Utils.isEmptyArray(supervisionUrls)) {
2e6f5966
JB
244 if (Configuration.getDistributeStationToTenantEqually()) {
245 indexUrl = this._index % supervisionUrls.length;
7dde0b73
JB
246 } else {
247 // Get a random url
248 indexUrl = Math.floor(Math.random() * supervisionUrls.length);
249 }
250 return supervisionUrls[indexUrl];
251 }
252 return supervisionUrls;
253 }
254
7dde0b73 255 _getAuthorizeRemoteTxRequests() {
61c2e33d 256 const authorizeRemoteTxRequests = this._getConfigurationKey('AuthorizeRemoteTxRequests');
a6e68f34 257 return authorizeRemoteTxRequests ? Utils.convertToBoolean(authorizeRemoteTxRequests.value) : false;
7dde0b73
JB
258 }
259
def3d48e 260 _getLocalAuthListEnabled() {
61c2e33d 261 const localAuthListEnabled = this._getConfigurationKey('LocalAuthListEnabled');
def3d48e
JB
262 return localAuthListEnabled ? Utils.convertToBoolean(localAuthListEnabled.value) : false;
263 }
264
5ad8570f
JB
265 async _basicStartMessageSequence() {
266 // Start heartbeat
267 this._startHeartbeat(this);
0a60c33c 268 // Initialize connectors status
5ad8570f 269 for (const connector in this._connectors) {
8bce55bf
JB
270 if (!this.getConnector(connector).transactionStarted) {
271 if (this.getConnector(connector).bootStatus) {
272 this.sendStatusNotificationWithTimeout(connector, this.getConnector(connector).bootStatus);
5ad8570f
JB
273 } else {
274 this.sendStatusNotificationWithTimeout(connector, 'Available');
275 }
276 } else {
277 this.sendStatusNotificationWithTimeout(connector, 'Charging');
278 }
279 }
0a60c33c 280 // Start the ATG
5ad8570f
JB
281 if (Utils.convertToBoolean(this._stationInfo.AutomaticTransactionGenerator.enable)) {
282 if (!this._automaticTransactionGeneration) {
283 this._automaticTransactionGeneration = new AutomaticTransactionGenerator(this);
284 }
285 if (this._automaticTransactionGeneration.timeToStop) {
286 this._automaticTransactionGeneration.start();
287 }
288 }
8bce55bf
JB
289 if (this.getEnableStatistics()) {
290 this._statistics.start();
291 }
5ad8570f
JB
292 }
293
294 // eslint-disable-next-line class-methods-use-this
295 async _startHeartbeat(self) {
0a60c33c 296 if (self._heartbeatInterval && self._heartbeatInterval > 0 && !self._heartbeatSetInterval) {
5ad8570f 297 self._heartbeatSetInterval = setInterval(() => {
0a60c33c 298 this.sendHeartbeat();
5ad8570f 299 }, self._heartbeatInterval);
ead548f2 300 logger.info(self._logPrefix() + ' Heartbeat started every ' + self._heartbeatInterval + 'ms');
7dde0b73 301 } else {
cb07a745 302 logger.error(`${self._logPrefix()} Heartbeat interval set to ${self._heartbeatInterval}ms, not starting the heartbeat`);
0a60c33c
JB
303 }
304 }
305
306 async _stopHeartbeat() {
307 if (this._heartbeatSetInterval) {
308 clearInterval(this._heartbeatSetInterval);
309 this._heartbeatSetInterval = null;
7dde0b73 310 }
5ad8570f
JB
311 }
312
313 _startAuthorizationFileMonitoring() {
314 // eslint-disable-next-line no-unused-vars
315 fs.watchFile(this._getAuthorizationFile(), (current, previous) => {
316 try {
ead548f2 317 logger.debug(this._logPrefix() + ' Authorization file ' + this._getAuthorizationFile() + ' have changed, reload');
5ad8570f
JB
318 // Initialize _authorizedTags
319 this._authorizedTags = this._loadAndGetAuthorizedTags();
320 } catch (error) {
ead548f2 321 logger.error(this._logPrefix() + ' Authorization file monitoring error: ' + error);
5ad8570f
JB
322 }
323 });
324 }
325
326 _startStationTemplateFileMonitoring() {
327 // eslint-disable-next-line no-unused-vars
328 fs.watchFile(this._stationTemplateFile, (current, previous) => {
329 try {
ead548f2 330 logger.debug(this._logPrefix() + ' Template file ' + this._stationTemplateFile + ' have changed, reload');
5ad8570f
JB
331 // Initialize
332 this._initialize();
333 this._addConfigurationKey('HeartBeatInterval', Utils.convertToInt(this._heartbeatInterval ? this._heartbeatInterval / 1000 : 0));
334 this._addConfigurationKey('HeartbeatInterval', Utils.convertToInt(this._heartbeatInterval ? this._heartbeatInterval / 1000 : 0), false, false);
5ad8570f 335 } catch (error) {
ead548f2 336 logger.error(this._logPrefix() + ' Charging station template file monitoring error: ' + error);
5ad8570f
JB
337 }
338 });
339 }
340
bec64e8b 341 async _startMeterValues(connectorId, interval) {
8bce55bf 342 if (!this.getConnector(connectorId).transactionStarted) {
6ecb15e4 343 logger.error(`${this._logPrefix()} Trying to start MeterValues on connector Id ${connectorId} with no transaction started`);
5ad8570f 344 return;
8bce55bf 345 } else if (this.getConnector(connectorId).transactionStarted && !this.getConnector(connectorId).transactionId) {
6ecb15e4 346 logger.error(`${this._logPrefix()} Trying to start MeterValues on connector Id ${connectorId} with no transaction id`);
5ad8570f
JB
347 return;
348 }
0a60c33c 349 if (interval > 0) {
8bce55bf
JB
350 this.getConnector(connectorId).transactionSetInterval = setInterval(async () => {
351 if (this.getEnableStatistics()) {
352 const sendMeterValues = performance.timerify(this.sendMeterValues);
353 this._performanceObserver.observe({
354 entryTypes: ['function'],
355 });
356 await sendMeterValues(connectorId, interval, this);
357 } else {
358 await this.sendMeterValues(connectorId, interval, this);
359 }
0a60c33c
JB
360 }, interval);
361 } else {
ead548f2 362 logger.error(`${this._logPrefix()} Charging station MeterValueSampleInterval configuration set to ${interval}ms, not sending MeterValues`);
0a60c33c 363 }
7dde0b73
JB
364 }
365
366 async start() {
0a60c33c
JB
367 if (!this._wsConnectionUrl) {
368 this._wsConnectionUrl = this._supervisionUrl + '/' + this._stationInfo.name;
5ad8570f 369 }
0a60c33c 370 this._wsConnection = new WebSocket(this._wsConnectionUrl, 'ocpp' + Constants.OCPP_VERSION_16);
ead548f2 371 logger.info(this._logPrefix() + ' Will communicate through URL ' + this._supervisionUrl);
2e6f5966
JB
372 // Monitor authorization file
373 this._startAuthorizationFileMonitoring();
374 // Monitor station template file
375 this._startStationTemplateFileMonitoring();
7dde0b73
JB
376 // Handle Socket incoming messages
377 this._wsConnection.on('message', this.onMessage.bind(this));
378 // Handle Socket error
379 this._wsConnection.on('error', this.onError.bind(this));
380 // Handle Socket close
381 this._wsConnection.on('close', this.onClose.bind(this));
382 // Handle Socket opening connection
383 this._wsConnection.on('open', this.onOpen.bind(this));
384 // Handle Socket ping
385 this._wsConnection.on('ping', this.onPing.bind(this));
386 }
387
2d0e26f5 388 async stop(reason = '') {
5ad8570f 389 // Stop heartbeat
0a60c33c 390 await this._stopHeartbeat();
5ad8570f
JB
391 // Stop the ATG
392 if (Utils.convertToBoolean(this._stationInfo.AutomaticTransactionGenerator.enable) &&
393 this._automaticTransactionGeneration &&
394 !this._automaticTransactionGeneration.timeToStop) {
2d0e26f5 395 await this._automaticTransactionGeneration.stop(reason);
5ad8570f
JB
396 } else {
397 for (const connector in this._connectors) {
8bce55bf
JB
398 if (this.getConnector(connector).transactionStarted) {
399 await this.sendStopTransaction(this.getConnector(connector).transactionId, reason);
5ad8570f
JB
400 }
401 }
402 }
403 // eslint-disable-next-line guard-for-in
404 for (const connector in this._connectors) {
405 await this.sendStatusNotification(connector, 'Unavailable');
406 }
0a60c33c 407 if (this._wsConnection && this._wsConnection.readyState === WebSocket.OPEN) {
5ad8570f
JB
408 await this._wsConnection.close();
409 }
410 }
411
412 _reconnect(error) {
ead548f2 413 logger.error(this._logPrefix() + ' Socket: abnormally closed', error);
5ad8570f
JB
414 // Stop the ATG if needed
415 if (Utils.convertToBoolean(this._stationInfo.AutomaticTransactionGenerator.enable) &&
416 Utils.convertToBoolean(this._stationInfo.AutomaticTransactionGenerator.stopOnConnectionFailure) &&
417 this._automaticTransactionGeneration &&
418 !this._automaticTransactionGeneration.timeToStop) {
419 this._automaticTransactionGeneration.stop();
420 }
421 // Stop heartbeat
0a60c33c 422 this._stopHeartbeat();
5ad8570f
JB
423 if (this._autoReconnectTimeout !== 0 &&
424 (this._autoReconnectRetryCount < this._autoReconnectMaxRetries || this._autoReconnectMaxRetries === -1)) {
ead548f2 425 logger.error(`${this._logPrefix()} Socket: connection retry with timeout ${this._autoReconnectTimeout}ms`);
5ad8570f
JB
426 this._autoReconnectRetryCount++;
427 setTimeout(() => {
ead548f2 428 logger.error(this._logPrefix() + ' Socket: reconnecting try #' + this._autoReconnectRetryCount);
5ad8570f
JB
429 this.start();
430 }, this._autoReconnectTimeout);
431 } else if (this._autoReconnectTimeout !== 0 || this._autoReconnectMaxRetries !== -1) {
ead548f2 432 logger.error(`${this._logPrefix()} Socket: max retries reached (${this._autoReconnectRetryCount}) or retry disabled (${this._autoReconnectTimeout})`);
5ad8570f
JB
433 }
434 }
435
7dde0b73 436 onOpen() {
ead548f2 437 logger.info(`${this._logPrefix()} Is connected to server through ${this._wsConnectionUrl}`);
5ad8570f 438 if (!this._isSocketRestart) {
0bbcb3dc 439 // Send BootNotification
0a60c33c 440 this.sendBootNotification();
0bbcb3dc 441 }
7dde0b73 442 if (this._isSocketRestart) {
027b409a 443 this._basicStartMessageSequence();
546dec0f 444 if (!Utils.isEmptyArray(this._messageQueue)) {
7dde0b73 445 this._messageQueue.forEach((message) => {
0a60c33c 446 if (this._wsConnection && this._wsConnection.readyState === WebSocket.OPEN) {
7dde0b73
JB
447 this._wsConnection.send(message);
448 }
449 });
450 }
7dde0b73
JB
451 }
452 this._autoReconnectRetryCount = 0;
453 this._isSocketRestart = false;
454 }
455
456 onError(error) {
457 switch (error) {
458 case 'ECONNREFUSED':
459 this._isSocketRestart = true;
460 this._reconnect(error);
461 break;
462 default:
ead548f2 463 logger.error(this._logPrefix() + ' Socket error: ' + error);
7dde0b73
JB
464 break;
465 }
466 }
467
468 onClose(error) {
469 switch (error) {
470 case 1000: // Normal close
471 case 1005:
ead548f2 472 logger.info(this._logPrefix() + ' Socket normally closed ' + error);
7dde0b73
JB
473 this._autoReconnectRetryCount = 0;
474 break;
475 default: // Abnormal close
476 this._isSocketRestart = true;
477 this._reconnect(error);
478 break;
479 }
480 }
481
482 onPing() {
ead548f2 483 logger.debug(this._logPrefix() + ' Has received a WS ping (rfc6455) from the server');
7dde0b73
JB
484 }
485
486 async onMessage(message) {
2d8cee5a 487 let [messageType, messageId, commandName, commandPayload, errorDetails] = [0, '', Constants.ENTITY_CHARGING_STATION, '', ''];
7dde0b73 488 try {
2d8cee5a
JB
489 // Parse the message
490 [messageType, messageId, commandName, commandPayload, errorDetails] = JSON.parse(message);
491
7dde0b73
JB
492 // Check the Type of message
493 switch (messageType) {
494 // Incoming Message
f7869514 495 case Constants.OCPP_JSON_CALL_MESSAGE:
7dde0b73 496 // Process the call
7dde0b73
JB
497 await this.handleRequest(messageId, commandName, commandPayload);
498 break;
499 // Outcome Message
f7869514 500 case Constants.OCPP_JSON_CALL_RESULT_MESSAGE:
7dde0b73
JB
501 // Respond
502 // eslint-disable-next-line no-case-declarations
503 let responseCallback; let requestPayload;
504 if (Utils.isIterable(this._requests[messageId])) {
505 [responseCallback, , requestPayload] = this._requests[messageId];
506 } else {
5933cbc8 507 throw new Error(`Response request for message id ${messageId} is not iterable`);
7dde0b73
JB
508 }
509 if (!responseCallback) {
510 // Error
511 throw new Error(`Response for unknown message id ${messageId}`);
512 }
513 delete this._requests[messageId];
7dde0b73
JB
514 responseCallback(commandName, requestPayload);
515 break;
516 // Error Message
f7869514 517 case Constants.OCPP_JSON_CALL_ERROR_MESSAGE:
7dde0b73
JB
518 if (!this._requests[messageId]) {
519 // Error
520 throw new Error(`Error for unknown message id ${messageId}`);
521 }
522 // eslint-disable-next-line no-case-declarations
523 let rejectCallback;
524 if (Utils.isIterable(this._requests[messageId])) {
525 [, rejectCallback] = this._requests[messageId];
526 } else {
5933cbc8 527 throw new Error(`Error request for message id ${messageId} is not iterable`);
7dde0b73
JB
528 }
529 delete this._requests[messageId];
530 rejectCallback(new OCPPError(commandName, commandPayload, errorDetails));
531 break;
532 // Error
533 default:
534 throw new Error(`Wrong message type ${messageType}`);
535 }
536 } catch (error) {
537 // Log
ead548f2 538 logger.error('%s Incoming message %j processing error %s on request content %s', this._logPrefix(), message, error, this._requests[messageId]);
7dde0b73
JB
539 // Send error
540 // await this.sendError(messageId, error);
541 }
542 }
543
0a60c33c
JB
544 sendHeartbeat() {
545 try {
546 const payload = {
547 currentTime: new Date().toISOString(),
548 };
549 this.sendMessage(Utils.generateUUID(), payload, Constants.OCPP_JSON_CALL_MESSAGE, 'Heartbeat');
550 } catch (error) {
ead548f2 551 logger.error(this._logPrefix() + ' Send Heartbeat error: ' + error);
0a60c33c
JB
552 throw error;
553 }
554 }
555
556 sendBootNotification() {
557 try {
558 this.sendMessage(Utils.generateUUID(), this._bootNotificationMessage, Constants.OCPP_JSON_CALL_MESSAGE, 'BootNotification');
559 } catch (error) {
ead548f2 560 logger.error(this._logPrefix() + ' Send BootNotification error: ' + error);
0a60c33c
JB
561 throw error;
562 }
563 }
564
5ad8570f
JB
565 async sendStatusNotification(connectorId, status, errorCode = 'NoError') {
566 try {
567 const payload = {
568 connectorId,
569 errorCode,
570 status,
571 };
572 await this.sendMessage(Utils.generateUUID(), payload, Constants.OCPP_JSON_CALL_MESSAGE, 'StatusNotification');
573 } catch (error) {
ead548f2 574 logger.error(this._logPrefix() + ' Send StatusNotification error: ' + error);
5ad8570f 575 throw error;
027b409a
JB
576 }
577 }
578
5ad8570f
JB
579 sendStatusNotificationWithTimeout(connectorId, status, errorCode = 'NoError', timeout = Constants.STATUS_NOTIFICATION_TIMEOUT) {
580 setTimeout(() => this.sendStatusNotification(connectorId, status, errorCode), timeout);
581 }
582
bec64e8b 583 async sendStartTransaction(connectorId, idTag) {
5ad8570f
JB
584 try {
585 const payload = {
bec64e8b 586 connectorId,
5ad8570f
JB
587 idTag,
588 meterStart: 0,
589 timestamp: new Date().toISOString(),
590 };
591 return await this.sendMessage(Utils.generateUUID(), payload, Constants.OCPP_JSON_CALL_MESSAGE, 'StartTransaction');
592 } catch (error) {
ead548f2 593 logger.error(this._logPrefix() + ' Send StartTransaction error: ' + error);
5ad8570f 594 throw error;
7dde0b73
JB
595 }
596 }
597
e5a5f1d2 598 sendStartTransactionWithTimeout(connectorId, idTag, timeout = Constants.START_TRANSACTION_TIMEOUT) {
bec64e8b 599 setTimeout(() => this.sendStartTransaction(connectorId, idTag), timeout);
7dde0b73
JB
600 }
601
5ad8570f 602 async sendStopTransaction(transactionId, reason = '') {
027b409a 603 try {
38c8fd6c
JB
604 const payload = {
605 transactionId,
606 meterStop: 0,
607 timestamp: new Date().toISOString(),
608 ...reason && {reason},
609 };
5ad8570f 610 await this.sendMessage(Utils.generateUUID(), payload, Constants.OCPP_JSON_CALL_MESSAGE, 'StopTransaction');
027b409a 611 } catch (error) {
ead548f2 612 logger.error(this._logPrefix() + ' Send StopTransaction error: ' + error);
5ad8570f 613 throw error;
027b409a
JB
614 }
615 }
616
5ad8570f 617 // eslint-disable-next-line class-methods-use-this
bec64e8b 618 async sendMeterValues(connectorId, interval, self, debug = false) {
5ad8570f 619 try {
7abfea5f 620 const sampledValues = {
5ad8570f 621 timestamp: new Date().toISOString(),
7abfea5f 622 sampledValue: [],
5ad8570f 623 };
7abfea5f
JB
624 const meterValuesTemplate = self.getConnector(connectorId).MeterValues;
625 for (let index = 0; index < meterValuesTemplate.length; index++) {
8bce55bf 626 const connector = self.getConnector(connectorId);
0a60c33c 627 // SoC measurand
7abfea5f
JB
628 if (meterValuesTemplate[index].measurand && meterValuesTemplate[index].measurand === 'SoC' && self._getConfigurationKey('MeterValuesSampledData').value.includes('SoC')) {
629 sampledValues.sampledValue.push({
630 ...!Utils.isUndefined(meterValuesTemplate[index].unit) ? {unit: meterValuesTemplate[index].unit} : {unit: 'Percent'},
631 ...!Utils.isUndefined(meterValuesTemplate[index].context) && {context: meterValuesTemplate[index].context},
632 measurand: meterValuesTemplate[index].measurand,
633 ...!Utils.isUndefined(meterValuesTemplate[index].location) ? {location: meterValuesTemplate[index].location} : {location: 'EV'},
634 ...!Utils.isUndefined(meterValuesTemplate[index].value) ? {value: meterValuesTemplate[index].value} : {value: Utils.getRandomInt(100)},
635 });
636 const sampledValuesIndex = sampledValues.sampledValue.length - 1;
637 if (sampledValues.sampledValue[sampledValuesIndex].value > 100 || debug) {
3f40bc9c 638 logger.error(`${self._logPrefix()} MeterValues measurand ${sampledValues.sampledValue[sampledValuesIndex].measurand ? sampledValues.sampledValue[sampledValuesIndex].measurand : 'Energy.Active.Import.Register'}: connectorId ${connectorId}, transaction ${connector.transactionId}, value: ${sampledValues.sampledValue[sampledValuesIndex].value}/100`);
5ad8570f 639 }
0a60c33c 640 // Voltage measurand
7abfea5f
JB
641 } else if (meterValuesTemplate[index].measurand && meterValuesTemplate[index].measurand === 'Voltage' && self._getConfigurationKey('MeterValuesSampledData').value.includes('Voltage')) {
642 sampledValues.sampledValue.push({
643 ...!Utils.isUndefined(meterValuesTemplate[index].unit) ? {unit: meterValuesTemplate[index].unit} : {unit: 'V'},
644 ...!Utils.isUndefined(meterValuesTemplate[index].context) && {context: meterValuesTemplate[index].context},
645 measurand: meterValuesTemplate[index].measurand,
646 ...!Utils.isUndefined(meterValuesTemplate[index].location) && {location: meterValuesTemplate[index].location},
b2acff85 647 ...!Utils.isUndefined(meterValuesTemplate[index].value) ? {value: meterValuesTemplate[index].value} : {value: self._getVoltageOut()},
7abfea5f 648 });
b2acff85 649 for (let phase = 1; self._getPowerOutType() === 'AC' && self._getNumberOfPhases() === 3 && phase <= self._getNumberOfPhases(); phase++) {
7abfea5f
JB
650 const voltageValue = sampledValues.sampledValue[sampledValues.sampledValue.length - 1].value;
651 let phaseValue;
b2acff85 652 if (voltageValue >= 0 && voltageValue <= 250) {
7abfea5f 653 phaseValue = `L${phase}-N`;
b2acff85 654 } else if (voltageValue > 250) {
3f40bc9c 655 phaseValue = `L${phase}-L${(phase + 1) % self._getNumberOfPhases() !== 0 ? (phase + 1) % self._getNumberOfPhases() : self._getNumberOfPhases()}`;
7abfea5f
JB
656 }
657 sampledValues.sampledValue.push({
658 ...!Utils.isUndefined(meterValuesTemplate[index].unit) ? {unit: meterValuesTemplate[index].unit} : {unit: 'V'},
659 ...!Utils.isUndefined(meterValuesTemplate[index].context) && {context: meterValuesTemplate[index].context},
660 measurand: meterValuesTemplate[index].measurand,
661 ...!Utils.isUndefined(meterValuesTemplate[index].location) && {location: meterValuesTemplate[index].location},
b2acff85 662 ...!Utils.isUndefined(meterValuesTemplate[index].value) ? {value: meterValuesTemplate[index].value} : {value: self._getVoltageOut()},
3f40bc9c
JB
663 phase: phaseValue,
664 });
665 }
fee83021
JB
666 // Power.Active.Import measurand
667 } else if (meterValuesTemplate[index].measurand && meterValuesTemplate[index].measurand === 'Power.Active.Import' && self._getConfigurationKey('MeterValuesSampledData').value.includes('Power.Active.Import')) {
668 // FIXME: factor out powerDivider checks
669 if (Utils.isUndefined(self._stationInfo.powerDivider)) {
670 const errMsg = `${self._logPrefix()} MeterValues measurand ${meterValuesTemplate[index].measurand ? meterValuesTemplate[index].measurand : 'Energy.Active.Import.Register'}: powerDivider is undefined`;
671 logger.error(errMsg);
672 throw Error(errMsg);
673 } else if (self._stationInfo.powerDivider && self._stationInfo.powerDivider <= 0) {
674 const errMsg = `${self._logPrefix()} MeterValues measurand ${meterValuesTemplate[index].measurand ? meterValuesTemplate[index].measurand : 'Energy.Active.Import.Register'}: powerDivider have zero or below value ${self._stationInfo.powerDivider}`;
675 logger.error(errMsg);
676 throw Error(errMsg);
677 }
678 const errMsg = `${self._logPrefix()} MeterValues measurand ${meterValuesTemplate[index].measurand ? meterValuesTemplate[index].measurand : 'Energy.Active.Import.Register'}: Unknown ${self._getPowerOutType()} powerOutType in template file ${self._stationTemplateFile}, cannot calculate ${meterValuesTemplate[index].measurand ? meterValuesTemplate[index].measurand : 'Energy.Active.Import.Register'} measurand value`;
679 const powerMeasurandValues = {};
680 const maxPower = Math.round(self._stationInfo.maxPower / self._stationInfo.powerDivider);
681 const maxPowerPerPhase = Math.round((self._stationInfo.maxPower / self._stationInfo.powerDivider) / self._getNumberOfPhases());
682 switch (self._getPowerOutType()) {
683 case 'AC':
684 if (Utils.isUndefined(meterValuesTemplate[index].value)) {
685 powerMeasurandValues.L1 = Utils.getRandomFloatRounded(maxPowerPerPhase);
686 powerMeasurandValues.L2 = 0;
687 powerMeasurandValues.L3 = 0;
688 if (self._getNumberOfPhases() === 3) {
689 powerMeasurandValues.L2 = Utils.getRandomFloatRounded(maxPowerPerPhase);
690 powerMeasurandValues.L3 = Utils.getRandomFloatRounded(maxPowerPerPhase);
691 }
692 powerMeasurandValues.all = Utils.roundTo(powerMeasurandValues.L1 + powerMeasurandValues.L2 + powerMeasurandValues.L3, 2);
693 }
694 break;
695 case 'DC':
696 if (Utils.isUndefined(meterValuesTemplate[index].value)) {
697 powerMeasurandValues.all = Utils.getRandomFloatRounded(maxPower);
698 }
699 break;
700 default:
701 logger.error(errMsg);
702 throw Error(errMsg);
703 }
704 sampledValues.sampledValue.push({
705 ...!Utils.isUndefined(meterValuesTemplate[index].unit) ? {unit: meterValuesTemplate[index].unit} : {unit: 'W'},
706 ...!Utils.isUndefined(meterValuesTemplate[index].context) && {context: meterValuesTemplate[index].context},
707 measurand: meterValuesTemplate[index].measurand,
708 ...!Utils.isUndefined(meterValuesTemplate[index].location) && {location: meterValuesTemplate[index].location},
709 ...!Utils.isUndefined(meterValuesTemplate[index].value) ? {value: meterValuesTemplate[index].value} : {value: powerMeasurandValues.all},
710 });
711 const sampledValuesIndex = sampledValues.sampledValue.length - 1;
712 if (sampledValues.sampledValue[sampledValuesIndex].value > maxPower || debug) {
713 logger.error(`${self._logPrefix()} MeterValues measurand ${sampledValues.sampledValue[sampledValuesIndex].measurand ? sampledValues.sampledValue[sampledValuesIndex].measurand : 'Energy.Active.Import.Register'}: connectorId ${connectorId}, transaction ${connector.transactionId}, value: ${sampledValues.sampledValue[sampledValuesIndex].value}/${maxPower}`);
714 }
715 for (let phase = 1; self._getPowerOutType() === 'AC' && self._getNumberOfPhases() === 3 && phase <= self._getNumberOfPhases(); phase++) {
716 const phaseValue = `L${phase}-N`;
717 sampledValues.sampledValue.push({
718 ...!Utils.isUndefined(meterValuesTemplate[index].unit) ? {unit: meterValuesTemplate[index].unit} : {unit: 'W'},
719 ...!Utils.isUndefined(meterValuesTemplate[index].context) && {context: meterValuesTemplate[index].context},
720 ...!Utils.isUndefined(meterValuesTemplate[index].measurand) && {measurand: meterValuesTemplate[index].measurand},
721 ...!Utils.isUndefined(meterValuesTemplate[index].location) && {location: meterValuesTemplate[index].location},
722 ...!Utils.isUndefined(meterValuesTemplate[index].value) ? {value: meterValuesTemplate[index].value} : {value: powerMeasurandValues[`L${phase}`]},
723 phase: phaseValue,
724 });
725 }
3f40bc9c
JB
726 // Current.Import measurand
727 } else if (meterValuesTemplate[index].measurand && meterValuesTemplate[index].measurand === 'Current.Import' && self._getConfigurationKey('MeterValuesSampledData').value.includes('Current.Import')) {
728 // FIXME: factor out powerDivider checks
729 if (Utils.isUndefined(self._stationInfo.powerDivider)) {
730 const errMsg = `${self._logPrefix()} MeterValues measurand ${meterValuesTemplate[index].measurand ? meterValuesTemplate[index].measurand : 'Energy.Active.Import.Register'}: powerDivider is undefined`;
731 logger.error(errMsg);
732 throw Error(errMsg);
733 } else if (self._stationInfo.powerDivider && self._stationInfo.powerDivider <= 0) {
734 const errMsg = `${self._logPrefix()} MeterValues measurand ${meterValuesTemplate[index].measurand ? meterValuesTemplate[index].measurand : 'Energy.Active.Import.Register'}: powerDivider have zero or below value ${self._stationInfo.powerDivider}`;
735 logger.error(errMsg);
736 throw Error(errMsg);
737 }
b2acff85 738 const errMsg = `${self._logPrefix()} MeterValues measurand ${meterValuesTemplate[index].measurand ? meterValuesTemplate[index].measurand : 'Energy.Active.Import.Register'}: Unknown ${self._getPowerOutType()} powerOutType in template file ${self._stationTemplateFile}, cannot calculate ${meterValuesTemplate[index].measurand ? meterValuesTemplate[index].measurand : 'Energy.Active.Import.Register'} measurand value`;
3f40bc9c 739 const currentMeasurandValues = {};
b2acff85
JB
740 let maxAmperage;
741 switch (self._getPowerOutType()) {
742 case 'AC':
743 maxAmperage = ElectricUtils.ampPerPhaseFromPower(self._getNumberOfPhases(), self._stationInfo.maxPower / self._stationInfo.powerDivider, self._getVoltageOut());
744 if (Utils.isUndefined(meterValuesTemplate[index].value)) {
745 currentMeasurandValues.L1 = Utils.getRandomFloatRounded(maxAmperage);
746 currentMeasurandValues.L2 = 0;
747 currentMeasurandValues.L3 = 0;
748 if (self._getNumberOfPhases() === 3) {
749 currentMeasurandValues.L2 = Utils.getRandomFloatRounded(maxAmperage);
750 currentMeasurandValues.L3 = Utils.getRandomFloatRounded(maxAmperage);
751 }
752 currentMeasurandValues.all = Utils.roundTo((currentMeasurandValues.L1 + currentMeasurandValues.L2 + currentMeasurandValues.L3) / self._getNumberOfPhases(), 2);
753 }
754 break;
755 case 'DC':
756 maxAmperage = ElectricUtils.ampTotalFromPower(self._stationInfo.maxPower / self._stationInfo.powerDivider, self._getVoltageOut());
fee83021
JB
757 if (Utils.isUndefined(meterValuesTemplate[index].value)) {
758 currentMeasurandValues.all = Utils.getRandomFloatRounded(maxAmperage);
759 }
b2acff85
JB
760 break;
761 default:
762 logger.error(errMsg);
763 throw Error(errMsg);
3f40bc9c
JB
764 }
765 sampledValues.sampledValue.push({
766 ...!Utils.isUndefined(meterValuesTemplate[index].unit) ? {unit: meterValuesTemplate[index].unit} : {unit: 'A'},
767 ...!Utils.isUndefined(meterValuesTemplate[index].context) && {context: meterValuesTemplate[index].context},
768 measurand: meterValuesTemplate[index].measurand,
769 ...!Utils.isUndefined(meterValuesTemplate[index].location) && {location: meterValuesTemplate[index].location},
b2acff85 770 ...!Utils.isUndefined(meterValuesTemplate[index].value) ? {value: meterValuesTemplate[index].value} : {value: currentMeasurandValues.all},
3f40bc9c
JB
771 });
772 const sampledValuesIndex = sampledValues.sampledValue.length - 1;
b2acff85
JB
773 if (sampledValues.sampledValue[sampledValuesIndex].value > maxAmperage || debug) {
774 logger.error(`${self._logPrefix()} MeterValues measurand ${sampledValues.sampledValue[sampledValuesIndex].measurand ? sampledValues.sampledValue[sampledValuesIndex].measurand : 'Energy.Active.Import.Register'}: connectorId ${connectorId}, transaction ${connector.transactionId}, value: ${sampledValues.sampledValue[sampledValuesIndex].value}/${maxAmperage}`);
3f40bc9c 775 }
b2acff85 776 for (let phase = 1; self._getPowerOutType() === 'AC' && self._getNumberOfPhases() === 3 && phase <= self._getNumberOfPhases(); phase++) {
3f40bc9c
JB
777 const phaseValue = `L${phase}`;
778 sampledValues.sampledValue.push({
779 ...!Utils.isUndefined(meterValuesTemplate[index].unit) ? {unit: meterValuesTemplate[index].unit} : {unit: 'A'},
780 ...!Utils.isUndefined(meterValuesTemplate[index].context) && {context: meterValuesTemplate[index].context},
781 ...!Utils.isUndefined(meterValuesTemplate[index].measurand) && {measurand: meterValuesTemplate[index].measurand},
782 ...!Utils.isUndefined(meterValuesTemplate[index].location) && {location: meterValuesTemplate[index].location},
783 ...!Utils.isUndefined(meterValuesTemplate[index].value) ? {value: meterValuesTemplate[index].value} : {value: currentMeasurandValues[phaseValue]},
7abfea5f
JB
784 phase: phaseValue,
785 });
786 }
0a60c33c 787 // Energy.Active.Import.Register measurand (default)
7abfea5f 788 } else if (!meterValuesTemplate[index].measurand || meterValuesTemplate[index].measurand === 'Energy.Active.Import.Register') {
38c8fd6c 789 // FIXME: factor out powerDivider checks
6ecb15e4 790 if (Utils.isUndefined(self._stationInfo.powerDivider)) {
7abfea5f 791 const errMsg = `${self._logPrefix()} MeterValues measurand ${meterValuesTemplate[index].measurand ? meterValuesTemplate[index].measurand : 'Energy.Active.Import.Register'}: powerDivider is undefined`;
6ecb15e4
JB
792 logger.error(errMsg);
793 throw Error(errMsg);
794 } else if (self._stationInfo.powerDivider && self._stationInfo.powerDivider <= 0) {
7abfea5f 795 const errMsg = `${self._logPrefix()} MeterValues measurand ${meterValuesTemplate[index].measurand ? meterValuesTemplate[index].measurand : 'Energy.Active.Import.Register'}: powerDivider have zero or below value ${self._stationInfo.powerDivider}`;
6ecb15e4
JB
796 logger.error(errMsg);
797 throw Error(errMsg);
798 }
7abfea5f 799 if (Utils.isUndefined(meterValuesTemplate[index].value)) {
6ecb15e4 800 const measurandValue = Utils.getRandomInt(self._stationInfo.maxPower / (self._stationInfo.powerDivider * 3600000) * interval);
9b25a525 801 // Persist previous value in connector
3f40bc9c 802 if (connector && !Utils.isNullOrUndefined(connector.lastEnergyActiveImportRegisterValue) && connector.lastEnergyActiveImportRegisterValue >= 0) {
9b25a525
JB
803 connector.lastEnergyActiveImportRegisterValue += measurandValue;
804 } else {
805 connector.lastEnergyActiveImportRegisterValue = 0;
806 }
5ad8570f 807 }
7abfea5f
JB
808 sampledValues.sampledValue.push({
809 ...!Utils.isUndefined(meterValuesTemplate[index].unit) ? {unit: meterValuesTemplate[index].unit} : {unit: 'Wh'},
810 ...!Utils.isUndefined(meterValuesTemplate[index].context) && {context: meterValuesTemplate[index].context},
811 ...!Utils.isUndefined(meterValuesTemplate[index].measurand) && {measurand: meterValuesTemplate[index].measurand},
812 ...!Utils.isUndefined(meterValuesTemplate[index].location) && {location: meterValuesTemplate[index].location},
813 ...!Utils.isUndefined(meterValuesTemplate[index].value) ? {value: meterValuesTemplate[index].value} : {value: connector.lastEnergyActiveImportRegisterValue},
814 });
815 const sampledValuesIndex = sampledValues.sampledValue.length - 1;
38c8fd6c 816 const maxConsumption = Math.round(self._stationInfo.maxPower * 3600 / (self._stationInfo.powerDivider * interval));
7abfea5f
JB
817 if (sampledValues.sampledValue[sampledValuesIndex].value > maxConsumption || debug) {
818 logger.error(`${self._logPrefix()} MeterValues measurand ${sampledValues.sampledValue[sampledValuesIndex].measurand ? sampledValues.sampledValue[sampledValuesIndex].measurand : 'Energy.Active.Import.Register'}: connectorId ${connectorId}, transaction ${connector.transactionId}, value: ${sampledValues.sampledValue[sampledValuesIndex].value}/${maxConsumption}`);
5ad8570f 819 }
0a60c33c
JB
820 // Unsupported measurand
821 } else {
7abfea5f 822 logger.info(`${self._logPrefix()} Unsupported MeterValues measurand ${meterValuesTemplate[index].measurand ? meterValuesTemplate[index].measurand : 'Energy.Active.Import.Register'} on connectorId ${connectorId}`);
5ad8570f
JB
823 }
824 }
825
826 const payload = {
bec64e8b 827 connectorId,
8bce55bf 828 transactionId: self.getConnector(connectorId).transactionId,
7abfea5f 829 meterValue: sampledValues,
5ad8570f
JB
830 };
831 await self.sendMessage(Utils.generateUUID(), payload, Constants.OCPP_JSON_CALL_MESSAGE, 'MeterValues');
832 } catch (error) {
ead548f2 833 logger.error(self._logPrefix() + ' Send MeterValues error: ' + error);
0a60c33c 834 throw error;
5ad8570f
JB
835 }
836 }
837
838 sendError(messageId, err) {
839 // Check exception: only OCPP error are accepted
840 const error = err instanceof OCPPError ? err : new OCPPError(Constants.OCPP_ERROR_INTERNAL_ERROR, err.message);
841 // Send error
842 return this.sendMessage(messageId, error, Constants.OCPP_JSON_CALL_ERROR_MESSAGE);
027b409a
JB
843 }
844
f7869514 845 sendMessage(messageId, command, messageType = Constants.OCPP_JSON_CALL_RESULT_MESSAGE, commandName = '') {
7dde0b73
JB
846 // Send a message through wsConnection
847 const self = this;
848 // Create a promise
849 return new Promise((resolve, reject) => {
850 let messageToSend;
851 // Type of message
852 switch (messageType) {
853 // Request
f7869514 854 case Constants.OCPP_JSON_CALL_MESSAGE:
8bce55bf
JB
855 if (this.getEnableStatistics()) {
856 this._statistics.addMessage(commandName);
857 }
7dde0b73
JB
858 // Build request
859 this._requests[messageId] = [responseCallback, rejectCallback, command];
860 messageToSend = JSON.stringify([messageType, messageId, commandName, command]);
861 break;
862 // Response
f7869514 863 case Constants.OCPP_JSON_CALL_RESULT_MESSAGE:
8bce55bf
JB
864 if (this.getEnableStatistics()) {
865 this._statistics.addMessage(commandName);
866 }
7dde0b73
JB
867 // Build response
868 messageToSend = JSON.stringify([messageType, messageId, command]);
869 break;
870 // Error Message
f7869514 871 case Constants.OCPP_JSON_CALL_ERROR_MESSAGE:
8bce55bf
JB
872 if (this.getEnableStatistics()) {
873 this._statistics.addMessage(`Error ${command.code ? command.code : Constants.OCPP_ERROR_GENERIC_ERROR} on ${commandName}`);
874 }
7dde0b73 875 // Build Message
894a1780 876 messageToSend = JSON.stringify([messageType, messageId, command.code ? command.code : Constants.OCPP_ERROR_GENERIC_ERROR, command.message ? command.message : '', command.details ? command.details : {}]);
7dde0b73
JB
877 break;
878 }
2e6f5966 879 // Check if wsConnection is ready
0a60c33c 880 if (this._wsConnection && this._wsConnection.readyState === WebSocket.OPEN) {
7dde0b73
JB
881 // Yes: Send Message
882 this._wsConnection.send(messageToSend);
883 } else {
884 // Buffer message until connection is back
885 this._messageQueue.push(messageToSend);
886 }
887 // Request?
f7869514 888 if (messageType !== Constants.OCPP_JSON_CALL_MESSAGE) {
7dde0b73
JB
889 // Yes: send Ok
890 resolve();
0a60c33c 891 } else if (this._wsConnection && this._wsConnection.readyState === WebSocket.OPEN) {
7dde0b73
JB
892 // Send timeout in case connection is open otherwise wait for ever
893 // FIXME: Handle message on timeout
38c8fd6c 894 setTimeout(() => rejectCallback(new OCPPError(command.code ? command.code : Constants.OCPP_ERROR_GENERIC_ERROR, command.message ? command.message : '', command.details ? command.details : {})), Constants.OCPP_SOCKET_TIMEOUT);
7dde0b73
JB
895 }
896
897 // Function that will receive the request's response
898 function responseCallback(payload, requestPayload) {
3f40bc9c 899 self.handleResponse(commandName, payload, requestPayload, self);
7dde0b73
JB
900 // Send the response
901 resolve(payload);
902 }
903
904 // Function that will receive the request's rejection
38c8fd6c
JB
905 function rejectCallback(error) {
906 if (!(error instanceof OCPPError)) {
907 const errMsg = `${self._logPrefix()} Argument error is not an instance of OCPPError in rejectCallback call`;
908 logger.error(errMsg);
909 throw Error(errMsg);
910 }
911 logger.debug(`${self._logPrefix()} Error %j on commandName %s command %j`, error, commandName, command);
8bce55bf 912 if (self.getEnableStatistics()) {
38c8fd6c 913 self._statistics.addMessage(`Error on commandName ${commandName}`, true);
8bce55bf 914 }
7dde0b73
JB
915 // Build Exception
916 // eslint-disable-next-line no-empty-function
917 self._requests[messageId] = [() => { }, () => { }, '']; // Properly format the request
7dde0b73
JB
918 // Send error
919 reject(error);
920 }
921 });
922 }
923
3f40bc9c
JB
924 // eslint-disable-next-line class-methods-use-this
925 handleResponse(commandName, payload, requestPayload, self) {
926 if (self.getEnableStatistics()) {
927 self._statistics.addMessage(commandName, true);
928 }
929 const responseCallbackFn = 'handleResponse' + commandName;
930 if (typeof self[responseCallbackFn] === 'function') {
931 self[responseCallbackFn](payload, requestPayload, self);
932 } else {
933 logger.error(self._logPrefix() + ' Trying to call an undefined response callback function: ' + responseCallbackFn);
934 }
935 }
936
5ad8570f
JB
937 handleResponseBootNotification(payload) {
938 if (payload.status === 'Accepted') {
939 this._heartbeatInterval = payload.interval * 1000;
940 this._addConfigurationKey('HeartBeatInterval', Utils.convertToInt(payload.interval));
941 this._addConfigurationKey('HeartbeatInterval', Utils.convertToInt(payload.interval), false, false);
942 this._basicStartMessageSequence();
0a60c33c 943 } else if (payload.status === 'Pending') {
ead548f2 944 logger.info(this._logPrefix() + ' Charging station pending on the central server');
5ad8570f 945 } else {
ead548f2 946 logger.info(this._logPrefix() + ' Charging station rejected by the central server');
7dde0b73 947 }
7dde0b73
JB
948 }
949
bec64e8b 950 _initTransactionOnConnector(connectorId) {
8bce55bf
JB
951 this.getConnector(connectorId).transactionStarted = false;
952 this.getConnector(connectorId).transactionId = null;
953 this.getConnector(connectorId).idTag = null;
954 this.getConnector(connectorId).lastEnergyActiveImportRegisterValue = -1;
0a60c33c
JB
955 }
956
bec64e8b
JB
957 _resetTransactionOnConnector(connectorId) {
958 this._initTransactionOnConnector(connectorId);
8bce55bf
JB
959 if (this.getConnector(connectorId).transactionSetInterval) {
960 clearInterval(this.getConnector(connectorId).transactionSetInterval);
027b409a
JB
961 }
962 }
963
7dde0b73 964 handleResponseStartTransaction(payload, requestPayload) {
8bce55bf
JB
965 if (this.getConnector(requestPayload.connectorId).transactionStarted) {
966 logger.debug(this._logPrefix() + ' Try to start a transaction on an already used connector ' + requestPayload.connectorId + ': %s', this.getConnector(requestPayload.connectorId));
2d0e26f5 967 return;
d3a7883e 968 }
84393381 969
7de604f9
JB
970 let transactionConnectorId;
971 for (const connector in this._connectors) {
972 if (Utils.convertToInt(connector) === Utils.convertToInt(requestPayload.connectorId)) {
973 transactionConnectorId = connector;
974 break;
7dde0b73 975 }
7de604f9
JB
976 }
977 if (!transactionConnectorId) {
ead548f2 978 logger.error(this._logPrefix() + ' Try to start a transaction on a non existing connector Id ' + requestPayload.connectorId);
7de604f9
JB
979 return;
980 }
981 if (payload.idTagInfo && payload.idTagInfo.status === 'Accepted') {
8bce55bf
JB
982 this.getConnector(requestPayload.connectorId).transactionStarted = true;
983 this.getConnector(requestPayload.connectorId).transactionId = payload.transactionId;
984 this.getConnector(requestPayload.connectorId).idTag = requestPayload.idTag;
985 this.getConnector(requestPayload.connectorId).lastEnergyActiveImportRegisterValue = 0;
7de604f9 986 this.sendStatusNotification(requestPayload.connectorId, 'Charging');
ead548f2 987 logger.info(this._logPrefix() + ' Transaction ' + payload.transactionId + ' STARTED on ' + this._stationInfo.name + '#' + requestPayload.connectorId + ' for idTag ' + requestPayload.idTag);
6ecb15e4
JB
988 if (this._stationInfo.powerSharedByConnectors) {
989 this._stationInfo.powerDivider++;
990 }
7de604f9 991 const configuredMeterValueSampleInterval = this._getConfigurationKey('MeterValueSampleInterval');
5ad8570f 992 this._startMeterValues(requestPayload.connectorId,
7de604f9 993 configuredMeterValueSampleInterval ? configuredMeterValueSampleInterval.value * 1000 : 60000);
7dde0b73 994 } else {
ead548f2 995 logger.error(this._logPrefix() + ' Starting transaction id ' + payload.transactionId + ' REJECTED with status ' + payload.idTagInfo.status + ', idTag ' + requestPayload.idTag);
8bce55bf 996 this._resetTransactionOnConnector(requestPayload.connectorId);
7dde0b73
JB
997 this.sendStatusNotification(requestPayload.connectorId, 'Available');
998 }
999 }
1000
34dcb3b5 1001 handleResponseStopTransaction(payload, requestPayload) {
d3a7883e
JB
1002 let transactionConnectorId;
1003 for (const connector in this._connectors) {
8bce55bf 1004 if (this.getConnector(connector).transactionId === requestPayload.transactionId) {
d3a7883e
JB
1005 transactionConnectorId = connector;
1006 break;
1007 }
1008 }
1009 if (!transactionConnectorId) {
ead548f2 1010 logger.error(this._logPrefix() + ' Try to stop a non existing transaction ' + requestPayload.transactionId);
7de604f9 1011 return;
d3a7883e
JB
1012 }
1013 if (payload.idTagInfo && payload.idTagInfo.status === 'Accepted') {
1014 this.sendStatusNotification(transactionConnectorId, 'Available');
6ecb15e4
JB
1015 if (this._stationInfo.powerSharedByConnectors) {
1016 this._stationInfo.powerDivider--;
1017 }
ead548f2 1018 logger.info(this._logPrefix() + ' Transaction ' + requestPayload.transactionId + ' STOPPED on ' + this._stationInfo.name + '#' + transactionConnectorId);
d3a7883e 1019 this._resetTransactionOnConnector(transactionConnectorId);
34dcb3b5 1020 } else {
ead548f2 1021 logger.error(this._logPrefix() + ' Stopping transaction id ' + requestPayload.transactionId + ' REJECTED with status ' + payload.idTagInfo.status);
34dcb3b5
JB
1022 }
1023 }
1024
facd8ebd 1025 handleResponseStatusNotification(payload, requestPayload) {
ead548f2 1026 logger.debug(this._logPrefix() + ' Status notification response received: %j to StatusNotification request: %j', payload, requestPayload);
7dde0b73
JB
1027 }
1028
facd8ebd 1029 handleResponseMeterValues(payload, requestPayload) {
ead548f2 1030 logger.debug(this._logPrefix() + ' MeterValues response received: %j to MeterValues request: %j', payload, requestPayload);
027b409a
JB
1031 }
1032
facd8ebd 1033 handleResponseHeartbeat(payload, requestPayload) {
ead548f2 1034 logger.debug(this._logPrefix() + ' Heartbeat response received: %j to Heartbeat request: %j', payload, requestPayload);
7dde0b73
JB
1035 }
1036
1037 async handleRequest(messageId, commandName, commandPayload) {
8bce55bf
JB
1038 if (this.getEnableStatistics()) {
1039 this._statistics.addMessage(commandName, true);
1040 }
3f40bc9c 1041 let response;
7dde0b73
JB
1042 // Call
1043 if (typeof this['handle' + commandName] === 'function') {
1044 try {
3f40bc9c
JB
1045 // Call the method to build the response
1046 response = await this['handle' + commandName](commandPayload);
7dde0b73
JB
1047 } catch (error) {
1048 // Log
ead548f2 1049 logger.error(this._logPrefix() + ' Handle request error: ' + error);
facd8ebd 1050 // Send back response to inform backend
7dde0b73
JB
1051 await this.sendError(messageId, error);
1052 }
1053 } else {
84393381 1054 // Throw exception
f7869514 1055 await this.sendError(messageId, new OCPPError(Constants.OCPP_ERROR_NOT_IMPLEMENTED, 'Not implemented', {}));
7dde0b73
JB
1056 throw new Error(`${commandName} is not implemented ${JSON.stringify(commandPayload, null, ' ')}`);
1057 }
84393381 1058 // Send response
3f40bc9c 1059 await this.sendMessage(messageId, response, Constants.OCPP_JSON_CALL_RESULT_MESSAGE);
7dde0b73
JB
1060 }
1061
5ad8570f 1062 async handleReset(commandPayload) {
5ad8570f
JB
1063 // Simulate charging station restart
1064 setImmediate(async () => {
2d0e26f5 1065 await this.stop(commandPayload.type + 'Reset');
0a60c33c 1066 await Utils.sleep(this._stationInfo.resetTime);
5ad8570f
JB
1067 await this.start();
1068 });
ead548f2 1069 logger.info(`${this._logPrefix()} ${commandPayload.type} reset command received, simulating it. The station will be back online in ${this._stationInfo.resetTime}ms`);
5ad8570f
JB
1070 return Constants.OCPP_RESPONSE_ACCEPTED;
1071 }
1072
61c2e33d
JB
1073 _getConfigurationKey(key) {
1074 return this._configuration.configurationKey.find((configElement) => configElement.key === key);
1075 }
1076
3497da01 1077 _addConfigurationKey(key, value, readonly = false, visible = true, reboot = false) {
61c2e33d
JB
1078 const keyFound = this._getConfigurationKey(key);
1079 if (!keyFound) {
1080 this._configuration.configurationKey.push({
1081 key,
1082 readonly,
1083 value,
1084 visible,
3497da01 1085 reboot,
61c2e33d
JB
1086 });
1087 }
1088 }
1089
1090 _setConfigurationKeyValue(key, value) {
1091 const keyFound = this._getConfigurationKey(key);
1092 if (keyFound) {
d3a7883e
JB
1093 const keyIndex = this._configuration.configurationKey.indexOf(keyFound);
1094 this._configuration.configurationKey[keyIndex].value = value;
61c2e33d
JB
1095 }
1096 }
1097
34dcb3b5 1098 async handleGetConfiguration(commandPayload) {
facd8ebd
JB
1099 const configurationKey = [];
1100 const unknownKey = [];
61c2e33d
JB
1101 if (Utils.isEmptyArray(commandPayload.key)) {
1102 for (const configuration of this._configuration.configurationKey) {
1103 if (Utils.isUndefined(configuration.visible)) {
1104 configuration.visible = true;
1105 } else {
1106 configuration.visible = Utils.convertToBoolean(configuration.visible);
1107 }
1108 if (!configuration.visible) {
1109 continue;
1110 }
1111 configurationKey.push({
1112 key: configuration.key,
1113 readonly: configuration.readonly,
1114 value: configuration.value,
1115 });
facd8ebd 1116 }
61c2e33d 1117 } else {
d20c21a0
JB
1118 for (const configurationKey of commandPayload.key) {
1119 const keyFound = this._getConfigurationKey(configurationKey);
61c2e33d
JB
1120 if (keyFound) {
1121 if (Utils.isUndefined(keyFound.visible)) {
1122 keyFound.visible = true;
1123 } else {
d20c21a0 1124 keyFound.visible = Utils.convertToBoolean(configurationKey.visible);
61c2e33d
JB
1125 }
1126 if (!keyFound.visible) {
1127 continue;
1128 }
1129 configurationKey.push({
1130 key: keyFound.key,
1131 readonly: keyFound.readonly,
1132 value: keyFound.value,
1133 });
1134 } else {
d20c21a0 1135 unknownKey.push(configurationKey);
61c2e33d 1136 }
facd8ebd 1137 }
facd8ebd
JB
1138 }
1139 return {
1140 configurationKey,
1141 unknownKey,
1142 };
7dde0b73
JB
1143 }
1144
1145 async handleChangeConfiguration(commandPayload) {
61c2e33d 1146 const keyToChange = this._getConfigurationKey(commandPayload.key);
7d887a1b
JB
1147 if (!keyToChange) {
1148 return {status: Constants.OCPP_ERROR_NOT_SUPPORTED};
1149 } else if (keyToChange && Utils.convertToBoolean(keyToChange.readonly)) {
1150 return Constants.OCPP_RESPONSE_REJECTED;
1151 } else if (keyToChange && !Utils.convertToBoolean(keyToChange.readonly)) {
a6e68f34
JB
1152 const keyIndex = this._configuration.configurationKey.indexOf(keyToChange);
1153 this._configuration.configurationKey[keyIndex].value = commandPayload.value;
d3a7883e
JB
1154 let triggerHeartbeatRestart = false;
1155 if (keyToChange.key === 'HeartBeatInterval') {
1156 this._setConfigurationKeyValue('HeartbeatInterval', commandPayload.value);
1157 triggerHeartbeatRestart = true;
1158 }
1159 if (keyToChange.key === 'HeartbeatInterval') {
1160 this._setConfigurationKeyValue('HeartBeatInterval', commandPayload.value);
1161 triggerHeartbeatRestart = true;
1162 }
1163 if (triggerHeartbeatRestart) {
5c68da4d
JB
1164 this._heartbeatInterval = Utils.convertToInt(commandPayload.value) * 1000;
1165 // Stop heartbeat
0a60c33c 1166 this._stopHeartbeat();
5c68da4d
JB
1167 // Start heartbeat
1168 this._startHeartbeat(this);
1169 }
7d887a1b
JB
1170 if (Utils.convertToBoolean(keyToChange.reboot)) {
1171 return Constants.OCPP_RESPONSE_REBOOT_REQUIRED;
1172 }
dcab13bd 1173 return Constants.OCPP_RESPONSE_ACCEPTED;
7dde0b73 1174 }
7dde0b73
JB
1175 }
1176
1177 async handleRemoteStartTransaction(commandPayload) {
72766a82 1178 const transactionConnectorID = commandPayload.connectorId ? commandPayload.connectorId : '1';
2e6f5966 1179 if (this.hasAuthorizedTags() && this._getLocalAuthListEnabled() && this._getAuthorizeRemoteTxRequests()) {
dcab13bd 1180 // Check if authorized
2e6f5966 1181 if (this._authorizedTags.find((value) => value === commandPayload.idTag)) {
7dde0b73 1182 // Authorization successful start transaction
e5a5f1d2 1183 this.sendStartTransactionWithTimeout(transactionConnectorID, commandPayload.idTag);
ead548f2 1184 logger.debug(this._logPrefix() + ' Transaction remotely STARTED on ' + this._stationInfo.name + '#' + transactionConnectorID + ' for idTag ' + commandPayload.idTag);
dcab13bd 1185 return Constants.OCPP_RESPONSE_ACCEPTED;
7dde0b73 1186 }
ead548f2 1187 logger.error(this._logPrefix() + ' Remote starting transaction REJECTED with status ' + commandPayload.idTagInfo.status + ', idTag ' + commandPayload.idTag);
dcab13bd 1188 return Constants.OCPP_RESPONSE_REJECTED;
7dde0b73 1189 }
dcab13bd 1190 // No local authorization check required => start transaction
e5a5f1d2 1191 this.sendStartTransactionWithTimeout(transactionConnectorID, commandPayload.idTag);
ead548f2 1192 logger.debug(this._logPrefix() + ' Transaction remotely STARTED on ' + this._stationInfo.name + '#' + transactionConnectorID + ' for idTag ' + commandPayload.idTag);
027b409a
JB
1193 return Constants.OCPP_RESPONSE_ACCEPTED;
1194 }
1195
1196 async handleRemoteStopTransaction(commandPayload) {
1197 for (const connector in this._connectors) {
8bce55bf 1198 if (this.getConnector(connector).transactionId === commandPayload.transactionId) {
d3a7883e
JB
1199 this.sendStopTransaction(commandPayload.transactionId);
1200 return Constants.OCPP_RESPONSE_ACCEPTED;
027b409a
JB
1201 }
1202 }
ead548f2 1203 logger.info(this._logPrefix() + ' Try to stop remotely a non existing transaction ' + commandPayload.transactionId);
d3a7883e 1204 return Constants.OCPP_RESPONSE_REJECTED;
7dde0b73 1205 }
7dde0b73
JB
1206}
1207