git.basschouten.com Git - openhab-addons.git/blob

   1 /**
   2  * Copyright (c) 2010-2022 Contributors to the openHAB project
   3  *
   4  * See the NOTICE file(s) distributed with this work for additional
   5  * information.
   6  *
   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
  10  *
  11  * SPDX-License-Identifier: EPL-2.0
  12  */
  13 package org.openhab.binding.plugwiseha.internal.handler;
  14
  15 import static org.openhab.binding.plugwiseha.internal.PlugwiseHABindingConstants.*;
  16 import static org.openhab.core.thing.ThingStatus.*;
  17 import static org.openhab.core.thing.ThingStatusDetail.BRIDGE_OFFLINE;
  18 import static org.openhab.core.thing.ThingStatusDetail.COMMUNICATION_ERROR;
  19 import static org.openhab.core.thing.ThingStatusDetail.CONFIGURATION_ERROR;
  20
  21 import java.util.Map;
  22 import java.util.Optional;
  23
  24 import javax.measure.Unit;
  25 import javax.measure.quantity.Temperature;
  26
  27 import org.eclipse.jdt.annotation.NonNullByDefault;
  28 import org.eclipse.jdt.annotation.Nullable;
  29 import org.openhab.binding.plugwiseha.internal.PlugwiseHABindingConstants;
  30 import org.openhab.binding.plugwiseha.internal.api.exception.PlugwiseHAException;
  31 import org.openhab.binding.plugwiseha.internal.api.model.PlugwiseHAController;
  32 import org.openhab.binding.plugwiseha.internal.api.model.dto.Location;
  33 import org.openhab.binding.plugwiseha.internal.config.PlugwiseHAThingConfig;
  34 import org.openhab.core.library.types.OnOffType;
  35 import org.openhab.core.library.types.QuantityType;
  36 import org.openhab.core.library.types.StringType;
  37 import org.openhab.core.library.unit.ImperialUnits;
  38 import org.openhab.core.library.unit.SIUnits;
  39 import org.openhab.core.thing.ChannelUID;
  40 import org.openhab.core.thing.Thing;
  41 import org.openhab.core.thing.ThingTypeUID;
  42 import org.openhab.core.types.Command;
  43 import org.openhab.core.types.State;
  44 import org.openhab.core.types.UnDefType;
  45 import org.slf4j.Logger;
  46 import org.slf4j.LoggerFactory;
  47
  48 /**
  49  * The {@link PlugwiseHAZoneHandler} class is responsible for handling commands
  50  * and status updates for the Plugwise Home Automation zones/locations.
  51  * Extends @{link PlugwiseHABaseHandler}
  52  *
  53  * @author Bas van Wetten - Initial contribution
  54  * @author Leo Siepel - finish initial contribution
  55  *
  56  */
  57
  58 @NonNullByDefault
  59 public class PlugwiseHAZoneHandler extends PlugwiseHABaseHandler<Location, PlugwiseHAThingConfig> {
  60
  61     private @Nullable Location location;
  62     private final Logger logger = LoggerFactory.getLogger(PlugwiseHAZoneHandler.class);
  63
  64     // Constructor
  65
  66     public PlugwiseHAZoneHandler(Thing thing) {
  67         super(thing);
  68     }
  69
  70     public static boolean supportsThingType(ThingTypeUID thingTypeUID) {
  71         return PlugwiseHABindingConstants.THING_TYPE_ZONE.equals(thingTypeUID);
  72     }
  73
  74     // Overrides
  75
  76     @Override
  77     protected synchronized void initialize(PlugwiseHAThingConfig config, PlugwiseHABridgeHandler bridgeHandler) {
  78         if (thing.getStatus() == INITIALIZING) {
  79             logger.debug("Initializing Plugwise Home Automation zone handler with config = {}", config);
  80             if (!config.isValid()) {
  81                 updateStatus(OFFLINE, CONFIGURATION_ERROR,
  82                         "Invalid configuration for Plugwise Home Automation zone handler.");
  83                 return;
  84             }
  85
  86             try {
  87                 PlugwiseHAController controller = bridgeHandler.getController();
  88                 if (controller != null) {
  89                     this.location = getEntity(controller);
  90                     if (this.location != null) {
  91                         setLocationProperties();
  92                         updateStatus(ONLINE);
  93                     } else {
  94                         updateStatus(OFFLINE);
  95                     }
  96                 } else {
  97                     updateStatus(OFFLINE, BRIDGE_OFFLINE);
  98                 }
  99             } catch (PlugwiseHAException e) {
 100                 updateStatus(OFFLINE, COMMUNICATION_ERROR, e.getMessage());
 101             }
 102         }
 103     }
 104
 105     @Override
 106     protected @Nullable Location getEntity(PlugwiseHAController controller) throws PlugwiseHAException {
 107         PlugwiseHAThingConfig config = getPlugwiseThingConfig();
 108         Location location = controller.getLocation(config.getId());
 109
 110         return location;
 111     }
 112
 113     @Override
 114     protected void handleCommand(Location entity, ChannelUID channelUID, Command command) throws PlugwiseHAException {
 115         String channelID = channelUID.getIdWithoutGroup();
 116         PlugwiseHABridgeHandler bridge = this.getPlugwiseHABridge();
 117         if (bridge != null) {
 118             PlugwiseHAController controller = bridge.getController();
 119             if (controller != null) {
 120                 switch (channelID) {
 121                     case ZONE_SETPOINT_CHANNEL:
 122                         if (command instanceof QuantityType) {
 123                             Unit<Temperature> unit = entity.getSetpointTemperatureUnit().orElse(UNIT_CELSIUS)
 124                                     .equals(UNIT_CELSIUS) ? SIUnits.CELSIUS : ImperialUnits.FAHRENHEIT;
 125                             QuantityType<?> state = ((QuantityType<?>) command).toUnit(unit);
 126                             if (state != null) {
 127                                 try {
 128                                     controller.setLocationThermostat(entity, state.doubleValue());
 129                                 } catch (PlugwiseHAException e) {
 130                                     logger.warn("Unable to update setpoint for zone '{}': {} -> {}", entity.getName(),
 131                                             entity.getSetpointTemperature().orElse(null), state.doubleValue());
 132                                 }
 133                             }
 134                         }
 135                         break;
 136                     case ZONE_PREHEAT_CHANNEL:
 137                         if (command instanceof OnOffType) {
 138                             try {
 139                                 controller.setPreHeating(entity, command == OnOffType.ON);
 140                             } catch (PlugwiseHAException e) {
 141                                 logger.warn("Unable to switch zone pre heating {} for zone '{}'", (State) command,
 142                                         entity.getName());
 143                             }
 144                         }
 145                         break;
 146                     default:
 147                         logger.warn("Ignoring unsupported command = {} for channel = {}", command, channelUID);
 148                 }
 149             }
 150         }
 151     }
 152
 153     private State getDefaultState(String channelID) {
 154         State state = UnDefType.NULL;
 155         switch (channelID) {
 156             case ZONE_PREHEAT_CHANNEL:
 157             case ZONE_PRESETSCENE_CHANNEL:
 158             case ZONE_SETPOINT_CHANNEL:
 159             case ZONE_TEMPERATURE_CHANNEL:
 160                 state = UnDefType.NULL;
 161                 break;
 162         }
 163         return state;
 164     }
 165
 166     @Override
 167     protected void refreshChannel(Location entity, ChannelUID channelUID) {
 168         String channelID = channelUID.getIdWithoutGroup();
 169         State state = getDefaultState(channelID);
 170
 171         switch (channelID) {
 172             case ZONE_PREHEAT_CHANNEL:
 173                 Optional<Boolean> preHeatState = entity.getPreHeatState();
 174                 if (preHeatState.isPresent()) {
 175                     state = OnOffType.from(preHeatState.get());
 176                 }
 177                 break;
 178             case ZONE_PRESETSCENE_CHANNEL:
 179                 state = new StringType(entity.getPreset());
 180                 break;
 181             case ZONE_SETPOINT_CHANNEL:
 182                 if (entity.getSetpointTemperature().isPresent()) {
 183                     Unit<Temperature> unit = entity.getSetpointTemperatureUnit().orElse(UNIT_CELSIUS)
 184                             .equals(UNIT_CELSIUS) ? SIUnits.CELSIUS : ImperialUnits.FAHRENHEIT;
 185                     state = new QuantityType<Temperature>(entity.getSetpointTemperature().get(), unit);
 186                 }
 187                 break;
 188             case ZONE_TEMPERATURE_CHANNEL:
 189                 if (entity.getTemperature().isPresent()) {
 190                     Unit<Temperature> unit = entity.getTemperatureUnit().orElse(UNIT_CELSIUS).equals(UNIT_CELSIUS)
 191                             ? SIUnits.CELSIUS
 192                             : ImperialUnits.FAHRENHEIT;
 193                     state = new QuantityType<Temperature>(entity.getTemperature().get(), unit);
 194                 }
 195                 break;
 196             default:
 197                 break;
 198         }
 199
 200         if (state != UnDefType.NULL) {
 201             updateState(channelID, state);
 202         }
 203     }
 204
 205     protected void setLocationProperties() {
 206         if (this.location != null) {
 207             Map<String, String> properties = editProperties();
 208
 209             Location localLocation = this.location;
 210             if (localLocation != null) {
 211                 properties.put(PlugwiseHABindingConstants.LOCATION_PROPERTY_DESCRIPTION,
 212                         localLocation.getDescription());
 213                 properties.put(PlugwiseHABindingConstants.LOCATION_PROPERTY_TYPE, localLocation.getType());
 214                 properties.put(PlugwiseHABindingConstants.LOCATION_PROPERTY_FUNCTIONALITIES,
 215                         String.join(", ", localLocation.getActuatorFunctionalities().keySet()));
 216             }
 217
 218             updateProperties(properties);
 219         }
 220     }
 221 }