2 * Copyright (c) 2010-2021 Contributors to the openHAB project
4 * See the NOTICE file(s) distributed with this work for additional
7 * This program and the accompanying materials are made available under the
8 * terms of the Eclipse Public License 2.0 which is available at
9 * http://www.eclipse.org/legal/epl-2.0
11 * SPDX-License-Identifier: EPL-2.0
13 package org.openhab.binding.nikohomecontrol.internal.protocol.nhc2;
15 import static org.openhab.binding.nikohomecontrol.internal.protocol.NikoHomeControlConstants.*;
17 import java.lang.reflect.Type;
18 import java.net.InetAddress;
19 import java.security.cert.CertificateException;
20 import java.util.ArrayList;
21 import java.util.List;
22 import java.util.NoSuchElementException;
23 import java.util.Objects;
24 import java.util.Optional;
25 import java.util.concurrent.CompletableFuture;
26 import java.util.concurrent.CopyOnWriteArrayList;
27 import java.util.concurrent.ExecutionException;
28 import java.util.concurrent.ScheduledExecutorService;
29 import java.util.concurrent.TimeUnit;
30 import java.util.concurrent.TimeoutException;
31 import java.util.stream.Collectors;
32 import java.util.stream.IntStream;
34 import org.eclipse.jdt.annotation.NonNullByDefault;
35 import org.eclipse.jdt.annotation.Nullable;
36 import org.openhab.binding.nikohomecontrol.internal.protocol.NhcAction;
37 import org.openhab.binding.nikohomecontrol.internal.protocol.NhcControllerEvent;
38 import org.openhab.binding.nikohomecontrol.internal.protocol.NhcEnergyMeter;
39 import org.openhab.binding.nikohomecontrol.internal.protocol.NhcThermostat;
40 import org.openhab.binding.nikohomecontrol.internal.protocol.NikoHomeControlCommunication;
41 import org.openhab.binding.nikohomecontrol.internal.protocol.NikoHomeControlConstants.ActionType;
42 import org.openhab.binding.nikohomecontrol.internal.protocol.nhc2.NhcDevice2.NhcProperty;
43 import org.openhab.binding.nikohomecontrol.internal.protocol.nhc2.NhcMessage2.NhcMessageParam;
44 import org.openhab.core.io.transport.mqtt.MqttConnectionObserver;
45 import org.openhab.core.io.transport.mqtt.MqttConnectionState;
46 import org.openhab.core.io.transport.mqtt.MqttException;
47 import org.openhab.core.io.transport.mqtt.MqttMessageSubscriber;
48 import org.slf4j.Logger;
49 import org.slf4j.LoggerFactory;
51 import com.google.gson.FieldNamingPolicy;
52 import com.google.gson.Gson;
53 import com.google.gson.GsonBuilder;
54 import com.google.gson.JsonSyntaxException;
55 import com.google.gson.reflect.TypeToken;
58 * The {@link NikoHomeControlCommunication2} class is able to do the following tasks with Niko Home Control II
61 * <li>Start and stop MQTT connection with Niko Home Control II Connected Controller.
62 * <li>Read all setup and status information from the Niko Home Control Controller.
63 * <li>Execute Niko Home Control commands.
64 * <li>Listen for events from Niko Home Control.
67 * @author Mark Herwege - Initial Contribution
70 public class NikoHomeControlCommunication2 extends NikoHomeControlCommunication
71 implements MqttMessageSubscriber, MqttConnectionObserver {
73 private final Logger logger = LoggerFactory.getLogger(NikoHomeControlCommunication2.class);
75 private final NhcMqttConnection2 mqttConnection;
77 private final List<NhcService2> services = new CopyOnWriteArrayList<>();
79 private volatile String profile = "";
81 private volatile @Nullable NhcSystemInfo2 nhcSystemInfo;
82 private volatile @Nullable NhcTimeInfo2 nhcTimeInfo;
84 private volatile @Nullable CompletableFuture<Boolean> communicationStarted;
86 private ScheduledExecutorService scheduler;
88 private final Gson gson = new GsonBuilder().setFieldNamingPolicy(FieldNamingPolicy.UPPER_CAMEL_CASE).create();
91 * Constructor for Niko Home Control communication object, manages communication with
92 * Niko Home Control II Connected Controller.
94 * @throws CertificateException when the SSL context for MQTT communication cannot be created
95 * @throws UnknownHostException when the IP address is not provided
98 public NikoHomeControlCommunication2(NhcControllerEvent handler, String clientId,
99 ScheduledExecutorService scheduler) throws CertificateException {
101 mqttConnection = new NhcMqttConnection2(clientId, this, this);
102 this.scheduler = scheduler;
106 public synchronized void startCommunication() {
107 communicationStarted = new CompletableFuture<>();
109 InetAddress addr = handler.getAddr();
111 logger.warn("IP address cannot be empty");
115 String addrString = addr.getHostAddress();
116 int port = handler.getPort();
117 logger.debug("initializing for mqtt connection to CoCo on {}:{}", addrString, port);
119 profile = handler.getProfile();
121 String token = handler.getToken();
122 if (token.isEmpty()) {
123 logger.warn("JWT token cannot be empty");
129 mqttConnection.startConnection(addrString, port, profile, token);
131 } catch (MqttException e) {
132 logger.debug("error in mqtt communication");
138 public synchronized void stopCommunication() {
139 CompletableFuture<Boolean> started = communicationStarted;
140 if (started != null) {
141 started.complete(false);
143 communicationStarted = null;
144 mqttConnection.stopConnection();
148 public boolean communicationActive() {
149 CompletableFuture<Boolean> started = communicationStarted;
150 if (started == null) {
154 // Wait until we received all devices info to confirm we are active.
155 return started.get(5000, TimeUnit.MILLISECONDS);
156 } catch (InterruptedException | ExecutionException | TimeoutException e) {
157 logger.debug("exception waiting for connection start");
163 * After setting up the communication with the Niko Home Control Connected Controller, send all initialization
167 private void initialize() throws MqttException {
168 NhcMessage2 message = new NhcMessage2();
170 message.method = "systeminfo.publish";
171 mqttConnection.connectionPublish(profile + "/system/cmd", gson.toJson(message));
173 message.method = "services.list";
174 mqttConnection.connectionPublish(profile + "/authentication/cmd", gson.toJson(message));
176 message.method = "devices.list";
177 mqttConnection.connectionPublish(profile + "/control/devices/cmd", gson.toJson(message));
179 message.method = "notifications.list";
180 mqttConnection.connectionPublish(profile + "/notification/cmd", gson.toJson(message));
183 private void connectionLost(String message) {
184 logger.debug("connection lost");
186 handler.controllerOffline(message);
189 private void systemEvt(String response) {
190 Type messageType = new TypeToken<NhcMessage2>() {
192 List<NhcTimeInfo2> timeInfo = null;
193 List<NhcSystemInfo2> systemInfo = null;
195 NhcMessage2 message = gson.fromJson(response, messageType);
196 List<NhcMessageParam> messageParams = (message != null) ? message.params : null;
197 if (messageParams != null) {
198 timeInfo = messageParams.stream().filter(p -> (p.timeInfo != null)).findFirst().get().timeInfo;
199 systemInfo = messageParams.stream().filter(p -> (p.systemInfo != null)).findFirst().get().systemInfo;
201 } catch (JsonSyntaxException e) {
202 logger.debug("unexpected json {}", response);
203 } catch (NoSuchElementException ignore) {
204 // Ignore if timeInfo not present in response, this should not happen in a timeInfo response
206 if (timeInfo != null) {
207 nhcTimeInfo = timeInfo.get(0);
209 if (systemInfo != null) {
210 nhcSystemInfo = systemInfo.get(0);
211 handler.updatePropertiesEvent();
215 private void systeminfoPublishRsp(String response) {
216 Type messageType = new TypeToken<NhcMessage2>() {
218 List<NhcSystemInfo2> systemInfo = null;
220 NhcMessage2 message = gson.fromJson(response, messageType);
221 List<NhcMessageParam> messageParams = (message != null) ? message.params : null;
222 if (messageParams != null) {
223 systemInfo = messageParams.stream().filter(p -> (p.systemInfo != null)).findFirst().get().systemInfo;
225 } catch (JsonSyntaxException e) {
226 logger.debug("unexpected json {}", response);
227 } catch (NoSuchElementException ignore) {
228 // Ignore if systemInfo not present in response, this should not happen in a systemInfo response
230 if (systemInfo != null) {
231 nhcSystemInfo = systemInfo.get(0);
235 private void servicesListRsp(String response) {
236 Type messageType = new TypeToken<NhcMessage2>() {
238 List<NhcService2> serviceList = null;
240 NhcMessage2 message = gson.fromJson(response, messageType);
241 List<NhcMessageParam> messageParams = (message != null) ? message.params : null;
242 if (messageParams != null) {
243 serviceList = messageParams.stream().filter(p -> (p.services != null)).findFirst().get().services;
245 } catch (JsonSyntaxException e) {
246 logger.debug("unexpected json {}", response);
247 } catch (NoSuchElementException ignore) {
248 // Ignore if services not present in response, this should not happen in a services response
251 if (serviceList != null) {
252 services.addAll(serviceList);
256 private void devicesListRsp(String response) {
257 Type messageType = new TypeToken<NhcMessage2>() {
259 List<NhcDevice2> deviceList = null;
261 NhcMessage2 message = gson.fromJson(response, messageType);
262 List<NhcMessageParam> messageParams = (message != null) ? message.params : null;
263 if (messageParams != null) {
264 deviceList = messageParams.stream().filter(p -> (p.devices != null)).findFirst().get().devices;
266 } catch (JsonSyntaxException e) {
267 logger.debug("unexpected json {}", response);
268 } catch (NoSuchElementException ignore) {
269 // Ignore if devices not present in response, this should not happen in a devices response
271 if (deviceList == null) {
275 for (NhcDevice2 device : deviceList) {
280 // Once a devices list response is received, we know the communication is fully started.
281 logger.debug("Communication start complete.");
282 handler.controllerOnline();
283 CompletableFuture<Boolean> future = communicationStarted;
284 if (future != null) {
285 future.complete(true);
289 private void devicesEvt(String response) {
290 Type messageType = new TypeToken<NhcMessage2>() {
292 List<NhcDevice2> deviceList = null;
293 String method = null;
295 NhcMessage2 message = gson.fromJson(response, messageType);
296 method = (message != null) ? message.method : null;
297 List<NhcMessageParam> messageParams = (message != null) ? message.params : null;
298 if (messageParams != null) {
299 deviceList = messageParams.stream().filter(p -> (p.devices != null)).findFirst().get().devices;
301 } catch (JsonSyntaxException e) {
302 logger.debug("unexpected json {}", response);
303 } catch (NoSuchElementException ignore) {
304 // Ignore if devices not present in response, this should not happen in a devices event
306 if (deviceList == null) {
310 if ("devices.removed".equals(method)) {
311 deviceList.forEach(this::removeDevice);
313 } else if ("devices.added".equals(method)) {
314 deviceList.forEach(this::addDevice);
317 deviceList.forEach(this::updateState);
320 private void notificationEvt(String response) {
321 Type messageType = new TypeToken<NhcMessage2>() {
323 List<NhcNotification2> notificationList = null;
325 NhcMessage2 message = gson.fromJson(response, messageType);
326 List<NhcMessageParam> messageParams = (message != null) ? message.params : null;
327 if (messageParams != null) {
328 notificationList = messageParams.stream().filter(p -> (p.notifications != null)).findFirst()
329 .get().notifications;
331 } catch (JsonSyntaxException e) {
332 logger.debug("unexpected json {}", response);
333 } catch (NoSuchElementException ignore) {
334 // Ignore if notifications not present in response, this should not happen in a notifications event
336 logger.debug("notifications {}", notificationList);
337 if (notificationList == null) {
341 for (NhcNotification2 notification : notificationList) {
342 if ("new".equals(notification.status)) {
343 String alarmText = notification.text;
344 switch (notification.type) {
346 handler.alarmEvent(alarmText);
349 handler.noticeEvent(alarmText);
352 logger.debug("unexpected message type {}", notification.type);
358 private void addDevice(NhcDevice2 device) {
359 String location = null;
360 if (device.parameters != null) {
361 location = device.parameters.stream().map(p -> p.locationName).filter(Objects::nonNull).findFirst()
365 if ("action".equals(device.type)) {
366 if (!actions.containsKey(device.uuid)) {
367 logger.debug("adding action device {}, {}", device.uuid, device.name);
369 ActionType actionType;
370 switch (device.model) {
377 case "overallcomfort":
379 actionType = ActionType.TRIGGER;
383 case "switched-generic":
385 actionType = ActionType.RELAY;
388 actionType = ActionType.DIMMER;
390 case "rolldownshutter":
392 case "venetianblind":
394 actionType = ActionType.ROLLERSHUTTER;
397 actionType = ActionType.GENERIC;
398 logger.debug("device type {} not recognised, default to GENERIC action", device.type);
401 NhcAction2 nhcAction = new NhcAction2(device.uuid, device.name, device.model, device.technology,
402 actionType, location, this);
403 actions.put(device.uuid, nhcAction);
405 } else if ("thermostat".equals(device.type)) {
406 if (!thermostats.containsKey(device.uuid)) {
407 logger.debug("adding thermostat device {}, {}", device.uuid, device.name);
409 NhcThermostat2 nhcThermostat = new NhcThermostat2(device.uuid, device.name, device.model,
410 device.technology, location, this);
411 thermostats.put(device.uuid, nhcThermostat);
413 } else if ("centralmeter".equals(device.type)) {
414 if (!energyMeters.containsKey(device.uuid)) {
415 logger.debug("adding centralmeter device {}, {}", device.uuid, device.name);
416 NhcEnergyMeter2 nhcEnergyMeter = new NhcEnergyMeter2(device.uuid, device.name, device.model,
417 device.technology, this, scheduler);
418 energyMeters.put(device.uuid, nhcEnergyMeter);
421 logger.debug("device type {} not supported for {}, {}", device.type, device.uuid, device.name);
425 private void removeDevice(NhcDevice2 device) {
426 NhcAction action = actions.get(device.uuid);
427 NhcThermostat thermostat = thermostats.get(device.uuid);
428 NhcEnergyMeter energyMeter = energyMeters.get(device.uuid);
429 if (action != null) {
430 action.actionRemoved();
431 actions.remove(device.uuid);
432 } else if (thermostat != null) {
433 thermostat.thermostatRemoved();
434 thermostats.remove(device.uuid);
435 } else if (energyMeter != null) {
436 energyMeter.energyMeterRemoved();
437 energyMeters.remove(device.uuid);
441 private void updateState(NhcDevice2 device) {
442 List<NhcProperty> deviceProperties = device.properties;
443 if (deviceProperties == null) {
444 logger.debug("Cannot Update state for {} as no properties defined in device message", device.uuid);
448 NhcAction action = actions.get(device.uuid);
449 NhcThermostat thermostat = thermostats.get(device.uuid);
450 NhcEnergyMeter energyMeter = energyMeters.get(device.uuid);
452 if (action != null) {
453 updateActionState((NhcAction2) action, deviceProperties);
454 } else if (thermostat != null) {
455 updateThermostatState((NhcThermostat2) thermostat, deviceProperties);
456 } else if (energyMeter != null) {
457 updateEnergyMeterState((NhcEnergyMeter2) energyMeter, deviceProperties);
461 private void updateActionState(NhcAction2 action, List<NhcProperty> deviceProperties) {
462 if (action.getType() == ActionType.ROLLERSHUTTER) {
463 updateRollershutterState(action, deviceProperties);
465 updateLightState(action, deviceProperties);
469 private void updateLightState(NhcAction2 action, List<NhcProperty> deviceProperties) {
470 Optional<NhcProperty> statusProperty = deviceProperties.stream().filter(p -> (p.status != null)).findFirst();
471 Optional<NhcProperty> dimmerProperty = deviceProperties.stream().filter(p -> (p.brightness != null))
473 Optional<NhcProperty> basicStateProperty = deviceProperties.stream().filter(p -> (p.basicState != null))
476 String booleanState = null;
477 if (statusProperty.isPresent()) {
478 booleanState = statusProperty.get().status;
479 } else if (basicStateProperty.isPresent()) {
480 booleanState = basicStateProperty.get().basicState;
483 if (booleanState != null) {
484 if (NHCON.equals(booleanState)) {
485 action.setBooleanState(true);
486 logger.debug("setting action {} internally to ON", action.getId());
487 } else if (NHCOFF.equals(booleanState)) {
488 action.setBooleanState(false);
489 logger.debug("setting action {} internally to OFF", action.getId());
493 if (dimmerProperty.isPresent()) {
494 String brightness = dimmerProperty.get().brightness;
495 if (brightness != null) {
496 action.setState(Integer.parseInt(brightness));
497 logger.debug("setting action {} internally to {}", action.getId(), dimmerProperty.get().brightness);
502 private void updateRollershutterState(NhcAction2 action, List<NhcProperty> deviceProperties) {
503 deviceProperties.stream().map(p -> p.position).filter(Objects::nonNull).findFirst().ifPresent(position -> {
505 action.setState(Integer.parseInt(position));
506 logger.debug("setting action {} internally to {}", action.getId(), position);
507 } catch (NumberFormatException e) {
508 logger.trace("received empty rollershutter {} position info", action.getId());
513 private void updateThermostatState(NhcThermostat2 thermostat, List<NhcProperty> deviceProperties) {
514 Optional<Boolean> overruleActiveProperty = deviceProperties.stream().map(p -> p.overruleActive)
515 .filter(Objects::nonNull).map(t -> Boolean.parseBoolean(t)).findFirst();
516 Optional<Integer> overruleSetpointProperty = deviceProperties.stream().map(p -> p.overruleSetpoint)
517 .map(s -> (!((s == null) || s.isEmpty())) ? Math.round(Float.parseFloat(s) * 10) : null)
518 .filter(Objects::nonNull).findFirst();
519 Optional<Integer> overruleTimeProperty = deviceProperties.stream().map(p -> p.overruleTime)
520 .map(s -> (!((s == null) || s.isEmpty())) ? Math.round(Float.parseFloat(s)) : null)
521 .filter(Objects::nonNull).findFirst();
522 Optional<Integer> setpointTemperatureProperty = deviceProperties.stream().map(p -> p.setpointTemperature)
523 .map(s -> (!((s == null) || s.isEmpty())) ? Math.round(Float.parseFloat(s) * 10) : null)
524 .filter(Objects::nonNull).findFirst();
525 Optional<Boolean> ecoSaveProperty = deviceProperties.stream().map(p -> p.ecoSave)
526 .map(s -> s != null ? Boolean.parseBoolean(s) : null).filter(Objects::nonNull).findFirst();
527 Optional<Integer> ambientTemperatureProperty = deviceProperties.stream().map(p -> p.ambientTemperature)
528 .map(s -> (!((s == null) || s.isEmpty())) ? Math.round(Float.parseFloat(s) * 10) : null)
529 .filter(Objects::nonNull).findFirst();
530 Optional<@Nullable String> demandProperty = deviceProperties.stream().map(p -> p.demand)
531 .filter(Objects::nonNull).findFirst();
532 Optional<@Nullable String> operationModeProperty = deviceProperties.stream().map(p -> p.operationMode)
533 .filter(Objects::nonNull).findFirst();
535 String modeString = deviceProperties.stream().map(p -> p.program).filter(Objects::nonNull).findFirst()
537 int mode = IntStream.range(0, THERMOSTATMODES.length).filter(i -> THERMOSTATMODES[i].equals(modeString))
538 .findFirst().orElse(thermostat.getMode());
540 int measured = ambientTemperatureProperty.orElse(thermostat.getMeasured());
541 int setpoint = setpointTemperatureProperty.orElse(thermostat.getSetpoint());
543 int overrule = thermostat.getOverrule();
544 int overruletime = thermostat.getRemainingOverruletime();
545 if (overruleActiveProperty.orElse(false)) {
546 overrule = overruleSetpointProperty.orElse(0);
547 overruletime = overruleTimeProperty.orElse(0);
550 int ecosave = thermostat.getEcosave();
551 if (ecoSaveProperty.orElse(false)) {
555 int demand = thermostat.getDemand();
556 String demandString = demandProperty.orElse(operationModeProperty.orElse(""));
557 demandString = demandString == null ? "" : demandString;
558 switch (demandString) {
571 "Niko Home Control: setting thermostat {} with measured {}, setpoint {}, mode {}, overrule {}, overruletime {}, ecosave {}, demand {}",
572 thermostat.getId(), measured, setpoint, mode, overrule, overruletime, ecosave, demand);
573 thermostat.updateState(measured, setpoint, mode, overrule, overruletime, ecosave, demand);
576 private void updateEnergyMeterState(NhcEnergyMeter2 energyMeter, List<NhcProperty> deviceProperties) {
577 deviceProperties.stream().map(p -> p.electricalPower).filter(Objects::nonNull).findFirst()
578 .ifPresent(electricalPower -> {
580 // Sometimes API sends a fractional part, although API should only send whole units in W,
581 // therefore drop fractional part
582 energyMeter.setPower((int) Double.parseDouble(electricalPower));
583 logger.trace("setting energy meter {} power to {}", energyMeter.getId(), electricalPower);
584 } catch (NumberFormatException e) {
585 energyMeter.setPower(null);
586 logger.trace("received empty energy meter {} power reading", energyMeter.getId());
592 public void executeAction(String actionId, String value) {
593 NhcMessage2 message = new NhcMessage2();
595 message.method = "devices.control";
596 ArrayList<NhcMessageParam> params = new ArrayList<>();
597 NhcMessageParam param = new NhcMessageParam();
599 message.params = params;
600 ArrayList<NhcDevice2> devices = new ArrayList<>();
601 NhcDevice2 device = new NhcDevice2();
603 param.devices = devices;
604 device.uuid = actionId;
605 ArrayList<NhcProperty> deviceProperties = new ArrayList<>();
606 NhcProperty property = new NhcProperty();
607 deviceProperties.add(property);
608 device.properties = deviceProperties;
610 NhcAction2 action = (NhcAction2) actions.get(actionId);
611 if (action == null) {
615 switch (action.getType()) {
618 property.basicState = NHCTRIGGERED;
621 property.status = value;
624 if (NHCON.equals(value)) {
625 action.setBooleanState(true); // this will trigger sending the stored brightness value event out
626 property.status = value;
627 } else if (NHCOFF.equals(value)) {
628 property.status = value;
630 // If the light is off, turn the light on before sending the brightness value, needs to happen
631 // in 2 separate messages.
632 if (!action.booleanState()) {
633 executeAction(actionId, NHCON);
635 property.brightness = value;
639 if (NHCSTOP.equals(value)) {
640 property.action = value;
641 } else if (NHCUP.equals(value)) {
642 property.position = "100";
643 } else if (NHCDOWN.equals(value)) {
644 property.position = "0";
646 int position = Integer.parseInt(value);
647 property.position = String.valueOf(position);
652 String topic = profile + "/control/devices/cmd";
653 String gsonMessage = gson.toJson(message);
654 sendDeviceMessage(topic, gsonMessage);
658 public void executeThermostat(String thermostatId, String mode) {
659 NhcMessage2 message = new NhcMessage2();
661 message.method = "devices.control";
662 ArrayList<NhcMessageParam> params = new ArrayList<>();
663 NhcMessageParam param = new NhcMessageParam();
665 message.params = params;
666 ArrayList<NhcDevice2> devices = new ArrayList<>();
667 NhcDevice2 device = new NhcDevice2();
669 param.devices = devices;
670 device.uuid = thermostatId;
671 ArrayList<NhcProperty> deviceProperties = new ArrayList<>();
673 NhcProperty overruleActiveProp = new NhcProperty();
674 deviceProperties.add(overruleActiveProp);
675 overruleActiveProp.overruleActive = "False";
677 NhcProperty program = new NhcProperty();
678 deviceProperties.add(program);
679 program.program = mode;
681 device.properties = deviceProperties;
683 String topic = profile + "/control/devices/cmd";
684 String gsonMessage = gson.toJson(message);
685 sendDeviceMessage(topic, gsonMessage);
689 public void executeThermostat(String thermostatId, int overruleTemp, int overruleTime) {
690 NhcMessage2 message = new NhcMessage2();
692 message.method = "devices.control";
693 ArrayList<NhcMessageParam> params = new ArrayList<>();
694 NhcMessageParam param = new NhcMessageParam();
696 message.params = params;
697 ArrayList<NhcDevice2> devices = new ArrayList<>();
698 NhcDevice2 device = new NhcDevice2();
700 param.devices = devices;
701 device.uuid = thermostatId;
702 ArrayList<NhcProperty> deviceProperties = new ArrayList<>();
704 if (overruleTime > 0) {
705 NhcProperty overruleActiveProp = new NhcProperty();
706 overruleActiveProp.overruleActive = "True";
707 deviceProperties.add(overruleActiveProp);
709 NhcProperty overruleSetpointProp = new NhcProperty();
710 overruleSetpointProp.overruleSetpoint = String.valueOf(overruleTemp / 10.0);
711 deviceProperties.add(overruleSetpointProp);
713 NhcProperty overruleTimeProp = new NhcProperty();
714 overruleTimeProp.overruleTime = String.valueOf(overruleTime);
715 deviceProperties.add(overruleTimeProp);
717 NhcProperty overruleActiveProp = new NhcProperty();
718 overruleActiveProp.overruleActive = "False";
719 deviceProperties.add(overruleActiveProp);
721 device.properties = deviceProperties;
723 String topic = profile + "/control/devices/cmd";
724 String gsonMessage = gson.toJson(message);
725 sendDeviceMessage(topic, gsonMessage);
729 public void startEnergyMeter(String energyMeterId) {
730 NhcMessage2 message = new NhcMessage2();
732 message.method = "devices.control";
733 ArrayList<NhcMessageParam> params = new ArrayList<>();
734 NhcMessageParam param = new NhcMessageParam();
736 message.params = params;
737 ArrayList<NhcDevice2> devices = new ArrayList<>();
738 NhcDevice2 device = new NhcDevice2();
740 param.devices = devices;
741 device.uuid = energyMeterId;
742 ArrayList<NhcProperty> deviceProperties = new ArrayList<>();
744 NhcProperty reportInstantUsageProp = new NhcProperty();
745 deviceProperties.add(reportInstantUsageProp);
746 reportInstantUsageProp.reportInstantUsage = "True";
747 device.properties = deviceProperties;
749 String topic = profile + "/control/devices/cmd";
750 String gsonMessage = gson.toJson(message);
752 NhcEnergyMeter2 energyMeter = (NhcEnergyMeter2) energyMeters.get(energyMeterId);
753 if (energyMeter != null) {
754 energyMeter.startEnergyMeter(topic, gsonMessage);
759 public void stopEnergyMeter(String energyMeterId) {
760 NhcEnergyMeter2 energyMeter = (NhcEnergyMeter2) energyMeters.get(energyMeterId);
761 if (energyMeter != null) {
762 energyMeter.stopEnergyMeter();
767 * Method called from the {@link NhcEnergyMeter2} object to send message to Niko Home Control.
772 public void executeEnergyMeter(String topic, String gsonMessage) {
773 sendDeviceMessage(topic, gsonMessage);
776 private void sendDeviceMessage(String topic, String gsonMessage) {
778 mqttConnection.connectionPublish(topic, gsonMessage);
780 } catch (MqttException e) {
781 String message = e.getLocalizedMessage();
783 logger.debug("sending command failed, trying to restart communication");
784 restartCommunication();
785 // retry sending after restart
787 if (communicationActive()) {
788 mqttConnection.connectionPublish(topic, gsonMessage);
790 logger.debug("failed to restart communication");
792 } catch (MqttException e1) {
793 message = e1.getLocalizedMessage();
795 logger.debug("error resending device command");
797 if (!communicationActive()) {
798 message = (message != null) ? message : "@text/offline.communication-error";
799 connectionLost(message);
805 public void processMessage(String topic, byte[] payload) {
806 String message = new String(payload);
807 if ((profile + "/system/evt").equals(topic)) {
809 } else if ((profile + "/system/rsp").equals(topic)) {
810 logger.debug("received topic {}, payload {}", topic, message);
811 systeminfoPublishRsp(message);
812 } else if ((profile + "/notification/evt").equals(topic)) {
813 logger.debug("received topic {}, payload {}", topic, message);
814 notificationEvt(message);
815 } else if ((profile + "/control/devices/evt").equals(topic)) {
816 logger.trace("received topic {}, payload {}", topic, message);
818 } else if ((profile + "/control/devices/rsp").equals(topic)) {
819 logger.debug("received topic {}, payload {}", topic, message);
820 devicesListRsp(message);
821 } else if ((profile + "/authentication/rsp").equals(topic)) {
822 logger.debug("received topic {}, payload {}", topic, message);
823 servicesListRsp(message);
824 } else if ((profile + "/control/devices.error").equals(topic)) {
825 logger.warn("received error {}", message);
827 logger.trace("not acted on received message topic {}, payload {}", topic, message);
832 * @return system info retrieved from Connected Controller
834 public NhcSystemInfo2 getSystemInfo() {
835 NhcSystemInfo2 systemInfo = nhcSystemInfo;
836 if (systemInfo == null) {
837 systemInfo = new NhcSystemInfo2();
843 * @return time info retrieved from Connected Controller
845 public NhcTimeInfo2 getTimeInfo() {
846 NhcTimeInfo2 timeInfo = nhcTimeInfo;
847 if (timeInfo == null) {
848 timeInfo = new NhcTimeInfo2();
854 * @return comma separated list of services retrieved from Connected Controller
856 public String getServices() {
857 return services.stream().map(NhcService2::name).collect(Collectors.joining(", "));
861 public void connectionStateChanged(MqttConnectionState state, @Nullable Throwable error) {
863 logger.debug("Connection state: {}", state, error);
864 String message = error.getLocalizedMessage();
865 message = (message != null) ? message : "@text/offline.communication-error";
866 if (!MqttConnectionState.CONNECTING.equals(state)) {
867 // This is a connection loss, try to restart
868 restartCommunication();
870 if (!communicationActive()) {
871 connectionLost(message);
874 logger.trace("Connection state: {}", state);