2 * Copyright (c) 2010-2024 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.tado.internal;
15 import java.io.IOException;
17 import org.eclipse.jdt.annotation.NonNullByDefault;
18 import org.openhab.binding.tado.internal.TadoBindingConstants.FanLevel;
19 import org.openhab.binding.tado.internal.TadoBindingConstants.FanSpeed;
20 import org.openhab.binding.tado.internal.TadoBindingConstants.HorizontalSwing;
21 import org.openhab.binding.tado.internal.TadoBindingConstants.HvacMode;
22 import org.openhab.binding.tado.internal.TadoBindingConstants.OperationMode;
23 import org.openhab.binding.tado.internal.TadoBindingConstants.VerticalSwing;
24 import org.openhab.binding.tado.internal.api.ApiException;
25 import org.openhab.binding.tado.internal.api.model.GenericZoneSetting;
26 import org.openhab.binding.tado.internal.api.model.Overlay;
27 import org.openhab.binding.tado.internal.api.model.OverlayTerminationCondition;
28 import org.openhab.binding.tado.internal.api.model.OverlayTerminationConditionType;
29 import org.openhab.binding.tado.internal.builder.TerminationConditionBuilder;
30 import org.openhab.binding.tado.internal.builder.ZoneSettingsBuilder;
31 import org.openhab.binding.tado.internal.builder.ZoneStateProvider;
32 import org.openhab.binding.tado.internal.handler.TadoZoneHandler;
33 import org.openhab.core.thing.Thing;
34 import org.openhab.core.thing.binding.ThingHandler;
37 * Builder for incremental creation of zone overlays.
39 * @author Dennis Frommknecht - Initial contribution
42 public class TadoHvacChange {
44 private final TadoZoneHandler zoneHandler;
45 private final TerminationConditionBuilder terminationConditionBuilder;
46 private final ZoneSettingsBuilder settingsBuilder;
48 private boolean followSchedule = false;
50 public TadoHvacChange(Thing zoneThing) {
51 ThingHandler handler = zoneThing.getHandler();
52 if (!(handler instanceof TadoZoneHandler)) {
53 throw new IllegalArgumentException("TadoZoneThing expected, but instead got " + zoneThing);
55 zoneHandler = (TadoZoneHandler) handler;
56 terminationConditionBuilder = TerminationConditionBuilder.of(zoneHandler);
57 settingsBuilder = ZoneSettingsBuilder.of(zoneHandler);
60 public TadoHvacChange withOperationMode(OperationMode operationMode) {
61 switch (operationMode) {
63 return followSchedule();
65 return activeForever();
67 return activeForMinutes(0);
69 return activeUntilChange();
74 public TadoHvacChange followSchedule() {
75 followSchedule = true;
79 public TadoHvacChange activeForever() {
80 terminationConditionBuilder.withTerminationType(OverlayTerminationConditionType.MANUAL);
84 public TadoHvacChange activeUntilChange() {
85 terminationConditionBuilder.withTerminationType(OverlayTerminationConditionType.TADO_MODE);
89 public TadoHvacChange activeForMinutes(int minutes) {
90 terminationConditionBuilder.withTerminationType(OverlayTerminationConditionType.TIMER);
91 terminationConditionBuilder.withTimerDurationInSeconds(minutes * 60);
95 public TadoHvacChange withTemperature(float temperatureValue) {
96 settingsBuilder.withTemperature(temperatureValue, zoneHandler.getTemperatureUnit());
100 public TadoHvacChange withHvacMode(HvacMode mode) {
101 settingsBuilder.withMode(mode);
105 public TadoHvacChange withHvacMode(String mode) {
106 return withHvacMode(HvacMode.valueOf(mode.toUpperCase()));
109 public TadoHvacChange withSwing(boolean swingOn) {
110 settingsBuilder.withSwing(swingOn);
114 public TadoHvacChange withFanSpeed(FanSpeed fanSpeed) {
115 settingsBuilder.withFanSpeed(fanSpeed);
119 public TadoHvacChange withFanSpeed(String fanSpeed) {
120 withFanSpeed(FanSpeed.valueOf(fanSpeed.toUpperCase()));
124 public TadoHvacChange withFanLevel(FanLevel fanLevel) {
125 settingsBuilder.withFanLevel(fanLevel);
129 public TadoHvacChange withHorizontalSwing(HorizontalSwing horizontalSwing) {
130 settingsBuilder.withHorizontalSwing(horizontalSwing);
134 public TadoHvacChange withVerticalSwing(VerticalSwing verticalSwing) {
135 settingsBuilder.withVerticalSwing(verticalSwing);
139 public void apply() throws IOException, ApiException {
140 if (followSchedule) {
141 zoneHandler.removeOverlay();
143 Overlay overlay = buildOverlay();
144 zoneHandler.setOverlay(overlay);
148 private Overlay buildOverlay() throws IOException, ApiException {
149 ZoneStateProvider zoneStateProvider = new ZoneStateProvider(zoneHandler);
150 OverlayTerminationCondition terminationCondition = terminationConditionBuilder.build(zoneStateProvider);
151 GenericZoneSetting setting = settingsBuilder.build(zoneStateProvider, zoneHandler.getZoneCapabilities());
153 Overlay overlay = new Overlay();
154 overlay.setTermination(terminationCondition);
155 overlay.setSetting(setting);
160 public TadoHvacChange withLight(boolean lightOn) {
161 settingsBuilder.withLight(lightOn);