2 * Copyright (c) 2010-2022 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.action;
15 import java.util.Optional;
17 import java.util.stream.Collectors;
19 import org.eclipse.jdt.annotation.NonNullByDefault;
20 import org.eclipse.jdt.annotation.Nullable;
21 import org.openhab.binding.netatmo.internal.api.data.NetatmoConstants.SetpointMode;
22 import org.openhab.binding.netatmo.internal.handler.CommonInterface;
23 import org.openhab.binding.netatmo.internal.handler.capability.EnergyCapability;
24 import org.openhab.core.automation.annotation.ActionInput;
25 import org.openhab.core.automation.annotation.RuleAction;
26 import org.openhab.core.thing.binding.ThingActions;
27 import org.openhab.core.thing.binding.ThingActionsScope;
28 import org.openhab.core.thing.binding.ThingHandler;
29 import org.slf4j.Logger;
30 import org.slf4j.LoggerFactory;
33 * The {@link RoomActions} defines thing actions for RoomHandler.
35 * @author Markus Dillmann - Initial contribution
37 @ThingActionsScope(name = "netatmo")
39 public class RoomActions implements ThingActions {
40 private final Logger logger = LoggerFactory.getLogger(RoomActions.class);
41 private static final Set<SetpointMode> ALLOWED_MODES = Set.of(SetpointMode.MAX, SetpointMode.MANUAL,
44 private @Nullable CommonInterface handler;
45 private Optional<EnergyCapability> energy = Optional.empty();
47 public RoomActions() {
48 logger.debug("Netatmo RoomActions service created");
52 public void setThingHandler(@Nullable ThingHandler handler) {
53 if (handler instanceof CommonInterface) {
54 CommonInterface commonHandler = (CommonInterface) handler;
55 this.handler = commonHandler;
56 energy = commonHandler.getHomeCapability(EnergyCapability.class);
61 public @Nullable ThingHandler getThingHandler() {
62 return (ThingHandler) handler;
65 @RuleAction(label = "@text/actionSetThermRoomTempSetpointLabel", description = "@text/actionSetThermRoomTempSetpointDesc")
66 public void setThermRoomTempSetpoint(
67 @ActionInput(name = "temp", label = "@text/actionInputSetpointLabel", description = "@text/actionInputSetpointDesc") @Nullable Double temp,
68 @ActionInput(name = "endtime", label = "@text/actionInputEndtimeLabel", description = "@text/actionInputEndtimeDesc") @Nullable Long endTime) {
69 CommonInterface roomHandler = handler;
70 if (roomHandler == null) {
71 logger.info("Handler not set for room thing actions.");
73 } else if (temp == null) {
74 logger.info("Temperature is required, action ignored");
76 } else if (endTime == null) {
77 logger.info("Temperature provided but no endtime given, action ignored");
80 energy.ifPresent(cap -> cap.setRoomThermTemp(roomHandler.getId(), temp, endTime, SetpointMode.MANUAL));
83 @RuleAction(label = "@text/actionSetThermRoomModeSetpointLabel", description = "@text/actionSetThermRoomModeSetpointDesc")
84 public void setThermRoomModeSetpoint(
85 @ActionInput(name = "mode", label = "@text/actionInputModeLabel", description = "@text/actionInputModeDesc") @Nullable String mode,
86 @ActionInput(name = "endtime", label = "@text/actionInputEndtimeLabel", description = "@text/actionInputEndtimeDesc") @Nullable Long endTime) {
87 CommonInterface roomHandler = handler;
88 if (roomHandler == null) {
89 logger.info("Handler not set for room thing actions.");
91 } else if (mode == null) {
92 logger.info("Mode is required, action ignored");
96 SetpointMode targetMode = SetpointMode.UNKNOWN;
98 targetMode = SetpointMode.valueOf(mode);
99 if (!ALLOWED_MODES.contains(targetMode)) {
100 logger.info("Mode can only be {} for a room",
101 ALLOWED_MODES.stream().map(s -> s.name()).collect(Collectors.joining(", ")));
104 } catch (IllegalArgumentException e) {
105 logger.info("Invalid mode passed : {} - {}", mode, e.getMessage());
109 Long targetEndTime = endTime;
110 if (SetpointMode.HOME.equals(targetMode)) {
112 } else if (targetEndTime == null) {
113 logger.info("No endtime given, action ignored");
117 long setpointEnd = targetEndTime;
118 SetpointMode setpointMode = targetMode;
119 energy.ifPresent(cap -> cap.setRoomThermTemp(roomHandler.getId(), 0, setpointEnd, setpointMode));
122 public static void setThermRoomTempSetpoint(ThingActions actions, @Nullable Double temp, @Nullable Long endTime) {
123 ((RoomActions) actions).setThermRoomTempSetpoint(temp, endTime);
126 public static void setThermRoomModeSetpoint(ThingActions actions, @Nullable String mode, @Nullable Long endTime) {
127 ((RoomActions) actions).setThermRoomModeSetpoint(mode, endTime);