2 * Copyright (c) 2010-2023 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.netatmo.internal.handler.capability;
15 import static org.openhab.binding.netatmo.internal.NetatmoBindingConstants.*;
17 import java.time.ZonedDateTime;
19 import org.eclipse.jdt.annotation.NonNullByDefault;
20 import org.openhab.binding.netatmo.internal.api.EnergyApi;
21 import org.openhab.binding.netatmo.internal.api.NetatmoException;
22 import org.openhab.binding.netatmo.internal.api.data.NetatmoConstants.FeatureArea;
23 import org.openhab.binding.netatmo.internal.api.data.NetatmoConstants.SetpointMode;
24 import org.openhab.binding.netatmo.internal.api.dto.HomeData;
25 import org.openhab.binding.netatmo.internal.api.dto.HomeDataModule;
26 import org.openhab.binding.netatmo.internal.api.dto.HomeDataRoom;
27 import org.openhab.binding.netatmo.internal.api.dto.HomeStatusModule;
28 import org.openhab.binding.netatmo.internal.api.dto.NAHomeStatus;
29 import org.openhab.binding.netatmo.internal.api.dto.NAHomeStatus.HomeStatus;
30 import org.openhab.binding.netatmo.internal.api.dto.Room;
31 import org.openhab.binding.netatmo.internal.config.HomeConfiguration;
32 import org.openhab.binding.netatmo.internal.deserialization.NAObjectMap;
33 import org.openhab.binding.netatmo.internal.handler.CommonInterface;
34 import org.openhab.binding.netatmo.internal.providers.NetatmoDescriptionProvider;
35 import org.openhab.core.thing.ChannelUID;
36 import org.openhab.core.types.Command;
37 import org.openhab.core.types.StateOption;
38 import org.slf4j.Logger;
39 import org.slf4j.LoggerFactory;
42 * The {@link EnergyCapability} is the base class for handler able to handle energy features
44 * @author Gaƫl L'hopital - Initial contribution
48 public class EnergyCapability extends RestCapability<EnergyApi> {
49 private final Logger logger = LoggerFactory.getLogger(EnergyCapability.class);
51 private int setPointDefaultDuration = -1;
52 private final NetatmoDescriptionProvider descriptionProvider;
53 private String energyId = "";
55 EnergyCapability(CommonInterface handler, NetatmoDescriptionProvider descriptionProvider) {
56 super(handler, EnergyApi.class);
57 this.descriptionProvider = descriptionProvider;
61 public void initialize() {
63 energyId = handler.getConfiguration().as(HomeConfiguration.class).getIdForArea(FeatureArea.ENERGY);
67 protected void updateHomeData(HomeData homeData) {
68 if (homeData instanceof HomeData.Energy energyData) {
69 NAObjectMap<HomeDataRoom> rooms = energyData.getRooms();
70 NAObjectMap<HomeDataModule> modules = energyData.getModules();
71 handler.getActiveChildren(FeatureArea.ENERGY).forEach(childHandler -> {
72 String childId = childHandler.getId();
74 .ifPresentOrElse(roomData -> childHandler.setNewData(roomData.ignoringForThingUpdate()), () -> {
75 modules.getOpt(childId).ifPresent(
76 childData -> childHandler.setNewData(childData.ignoringForThingUpdate()));
77 modules.values().stream().filter(module -> childId.equals(module.getBridge()))
78 .forEach(bridgedModule -> childHandler.setNewData(bridgedModule));
81 descriptionProvider.setStateOptions(new ChannelUID(thing.getUID(), GROUP_ENERGY, CHANNEL_PLANNING),
82 energyData.getThermSchedules().stream().map(p -> new StateOption(p.getId(), p.getName())).toList());
83 setPointDefaultDuration = energyData.getThermSetpointDefaultDuration();
88 protected void updateHomeStatus(HomeStatus homeStatus) {
89 if (homeStatus instanceof NAHomeStatus.Energy energyStatus) {
90 NAObjectMap<Room> rooms = energyStatus.getRooms();
91 NAObjectMap<HomeStatusModule> modules = energyStatus.getModules();
92 handler.getActiveChildren(FeatureArea.ENERGY).forEach(childHandler -> {
93 String childId = childHandler.getId();
94 rooms.getOpt(childId).ifPresentOrElse(roomData -> childHandler.setNewData(roomData), () -> {
95 modules.getOpt(childId).ifPresent(moduleData -> {
96 childHandler.setNewData(moduleData);
97 modules.values().stream().filter(module -> childId.equals(module.getBridge()))
98 .forEach(bridgedModule -> childHandler.setNewData(bridgedModule));
105 public void setThermPoint(String roomId, SetpointMode mode, long endtime, double temp) {
106 getApi().ifPresent(api -> {
108 api.setThermpoint(energyId, roomId, mode, endtime, temp);
109 handler.expireData();
110 } catch (NetatmoException e) {
111 logger.warn("Error setting room thermostat mode '{}' : {}", mode, e.getMessage());
116 public void setRoomThermTemp(String roomId, SetpointMode mode, long endtime, double temp) {
117 setThermPoint(roomId, mode, endtime, temp);
120 public void setRoomThermMode(String roomId, SetpointMode targetMode) {
121 setThermPoint(roomId, targetMode, targetMode == SetpointMode.MAX ? setpointEndTimeFromNow() : 0, 0);
124 public void setRoomThermTemp(String roomId, double temp) {
125 setThermPoint(roomId, SetpointMode.MANUAL, setpointEndTimeFromNow(), temp);
129 public void handleCommand(String channelName, Command command) {
130 getApi().ifPresent(api -> {
132 switch (channelName) {
133 case CHANNEL_PLANNING:
134 api.switchSchedule(energyId, command.toString());
136 case CHANNEL_SETPOINT_MODE:
137 SetpointMode targetMode = SetpointMode.valueOf(command.toString());
138 if (targetMode == SetpointMode.MANUAL) {
139 logger.info("Switch to 'Manual' is done by setting a setpoint temp, command ignored");
142 api.setThermMode(energyId, targetMode.apiDescriptor);
145 handler.expireData();
146 } catch (NetatmoException e) {
147 logger.warn("Error handling command '{}' : {}", command, e.getMessage());
148 } catch (IllegalArgumentException e) {
149 logger.warn("Command '{}' sent to channel '{}' is not a valid setpoint mode.", command, channelName);
154 private long setpointEndTimeFromNow() {
155 return ZonedDateTime.now().plusMinutes(setPointDefaultDuration).toEpochSecond();