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

   1 /**
   2  * Copyright (c) 2010-2021 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.luxtronikheatpump.internal;
  14
  15 import java.io.IOException;
  16 import java.util.ArrayList;
  17 import java.util.HashSet;
  18 import java.util.List;
  19 import java.util.Set;
  20 import java.util.concurrent.ScheduledFuture;
  21 import java.util.concurrent.TimeUnit;
  22
  23 import javax.measure.Unit;
  24
  25 import org.eclipse.jdt.annotation.NonNullByDefault;
  26 import org.openhab.binding.luxtronikheatpump.internal.enums.HeatpumpChannel;
  27 import org.openhab.binding.luxtronikheatpump.internal.enums.HeatpumpCoolingOperationMode;
  28 import org.openhab.binding.luxtronikheatpump.internal.enums.HeatpumpOperationMode;
  29 import org.openhab.binding.luxtronikheatpump.internal.exceptions.InvalidChannelException;
  30 import org.openhab.binding.luxtronikheatpump.internal.exceptions.InvalidOperationModeException;
  31 import org.openhab.core.config.core.Configuration;
  32 import org.openhab.core.library.types.DecimalType;
  33 import org.openhab.core.library.types.OnOffType;
  34 import org.openhab.core.library.types.QuantityType;
  35 import org.openhab.core.thing.Channel;
  36 import org.openhab.core.thing.ChannelUID;
  37 import org.openhab.core.thing.Thing;
  38 import org.openhab.core.thing.ThingStatus;
  39 import org.openhab.core.thing.ThingStatusDetail;
  40 import org.openhab.core.thing.binding.BaseThingHandler;
  41 import org.openhab.core.thing.binding.ThingHandlerCallback;
  42 import org.openhab.core.thing.binding.builder.ThingBuilder;
  43 import org.openhab.core.thing.type.ChannelTypeUID;
  44 import org.openhab.core.types.Command;
  45 import org.openhab.core.types.RefreshType;
  46 import org.openhab.core.types.State;
  47 import org.slf4j.Logger;
  48 import org.slf4j.LoggerFactory;
  49
  50 /**
  51  * The {@link LuxtronikHeatpumpHandler} is responsible for handling commands, which are
  52  * sent to one of the channels.
  53  *
  54  * @author Stefan Giehl - Initial contribution
  55  */
  56 @NonNullByDefault
  57 public class LuxtronikHeatpumpHandler extends BaseThingHandler {
  58
  59     private final Logger logger = LoggerFactory.getLogger(LuxtronikHeatpumpHandler.class);
  60     private final Set<ScheduledFuture<?>> scheduledFutures = new HashSet<>();
  61     private static final int RETRY_INTERVAL_SEC = 60;
  62     private boolean tiggerChannelUpdate = false;
  63     private final LuxtronikTranslationProvider translationProvider;
  64     private LuxtronikHeatpumpConfiguration config;
  65
  66     public LuxtronikHeatpumpHandler(Thing thing, LuxtronikTranslationProvider translationProvider) {
  67         super(thing);
  68         this.translationProvider = translationProvider;
  69         config = new LuxtronikHeatpumpConfiguration();
  70     }
  71
  72     @Override
  73     public void updateState(String channelID, State state) {
  74         super.updateState(channelID, state);
  75     }
  76
  77     @Override
  78     public void updateProperty(String name, String value) {
  79         super.updateProperty(name, value);
  80     }
  81
  82     public void setStatusConnectionError() {
  83         updateStatus(ThingStatus.OFFLINE, ThingStatusDetail.COMMUNICATION_ERROR,
  84                 "couldn't establish network connection [host '" + config.ipAddress + "']");
  85     }
  86
  87     public void setStatusOnline() {
  88         updateStatus(ThingStatus.ONLINE);
  89     }
  90
  91     @Override
  92     public void handleCommand(ChannelUID channelUID, Command command) {
  93         String channelId = channelUID.getIdWithoutGroup();
  94         logger.debug("Handle command '{}' for channel {}", command, channelId);
  95         if (command == RefreshType.REFRESH) {
  96             // ignore resresh command as channels will be updated automatically
  97             return;
  98         }
  99
 100         HeatpumpChannel channel;
 101
 102         try {
 103             channel = HeatpumpChannel.fromString(channelId);
 104         } catch (InvalidChannelException e) {
 105             logger.debug("Channel '{}' could not be found for thing {}", channelId, thing.getUID());
 106             return;
 107         }
 108
 109         if (!channel.isWritable()) {
 110             logger.debug("Channel {} is a read-only channel and cannot handle command '{}'", channelId, command);
 111             return;
 112         }
 113
 114         if (command instanceof QuantityType) {
 115             QuantityType<?> value = (QuantityType<?>) command;
 116
 117             Unit<?> unit = channel.getUnit();
 118             if (unit != null) {
 119                 value = value.toUnit(unit);
 120             }
 121
 122             command = new DecimalType(value.floatValue());
 123         }
 124
 125         if (command instanceof OnOffType) {
 126             command = ((OnOffType) command) == OnOffType.ON ? new DecimalType(1) : DecimalType.ZERO;
 127         }
 128
 129         if (!(command instanceof DecimalType)) {
 130             logger.warn("Heatpump operation for item {} must be from type: {}. Received {}", channel.getCommand(),
 131                     DecimalType.class.getSimpleName(), command.getClass());
 132             return;
 133         }
 134
 135         Integer param = channel.getChannelId();
 136         Integer value = null;
 137
 138         switch (channel) {
 139             case CHANNEL_EINST_BWTDI_AKT_MO:
 140             case CHANNEL_EINST_BWTDI_AKT_DI:
 141             case CHANNEL_EINST_BWTDI_AKT_MI:
 142             case CHANNEL_EINST_BWTDI_AKT_DO:
 143             case CHANNEL_EINST_BWTDI_AKT_FR:
 144             case CHANNEL_EINST_BWTDI_AKT_SA:
 145             case CHANNEL_EINST_BWTDI_AKT_SO:
 146             case CHANNEL_EINST_BWTDI_AKT_AL:
 147                 value = ((DecimalType) command).intValue();
 148                 break;
 149             case CHANNEL_BA_HZ_AKT:
 150             case CHANNEL_BA_BW_AKT:
 151                 value = ((DecimalType) command).intValue();
 152                 try {
 153                     // validate the value is valid
 154                     HeatpumpOperationMode.fromValue(value);
 155                 } catch (InvalidOperationModeException e) {
 156                     logger.warn("Heatpump {} mode recevieved invalid value {}: {}", channel.getCommand(), value,
 157                             e.getMessage());
 158                     return;
 159                 }
 160                 break;
 161             case CHANNEL_EINST_WK_AKT:
 162             case CHANNEL_EINST_BWS_AKT:
 163             case CHANNEL_EINST_KUCFTL_AKT:
 164             case CHANNEL_SOLLWERT_KUCFTL_AKT:
 165             case CHANNEL_SOLL_BWS_AKT:
 166                 float temperature = ((DecimalType) command).floatValue();
 167                 value = (int) (temperature * 10);
 168                 break;
 169             case CHANNEL_EINST_BWSTYP_AKT:
 170                 value = ((DecimalType) command).intValue();
 171                 try {
 172                     // validate the value is valid
 173                     HeatpumpCoolingOperationMode.fromValue(value);
 174                 } catch (InvalidOperationModeException e) {
 175                     logger.warn("Heatpump {} mode recevieved invalid value {}: {}", channel.getCommand(), value,
 176                             e.getMessage());
 177                     return;
 178                 }
 179                 break;
 180             case CHANNEL_EINST_KUHL_ZEIT_EIN_AKT:
 181             case CHANNEL_EINST_KUHL_ZEIT_AUS_AKT:
 182                 float hours = ((DecimalType) command).floatValue();
 183                 value = (int) (hours * 10);
 184                 break;
 185
 186             default:
 187                 logger.debug("Received unknown channel {}", channelId);
 188                 break;
 189         }
 190
 191         if (param != null && value != null) {
 192             if (sendParamToHeatpump(param, value)) {
 193                 logger.debug("Heat pump mode {} set to {}.", channel.getCommand(), value);
 194             } else {
 195                 logger.warn("Failed setting heat pump mode {} to {}", channel.getCommand(), value);
 196             }
 197         } else {
 198             logger.warn("No valid value given for Heatpump operation {}", channel.getCommand());
 199         }
 200     }
 201
 202     @Override
 203     public void initialize() {
 204         config = getConfigAs(LuxtronikHeatpumpConfiguration.class);
 205
 206         if (!config.isValid()) {
 207             updateStatus(ThingStatus.OFFLINE, ThingStatusDetail.CONFIGURATION_ERROR,
 208                     "At least one mandatory configuration field is empty");
 209             return;
 210         }
 211
 212         updateStatus(ThingStatus.UNKNOWN);
 213
 214         synchronized (scheduledFutures) {
 215             ScheduledFuture<?> future = scheduler.scheduleWithFixedDelay(this::internalInitialize, 0,
 216                     RETRY_INTERVAL_SEC, TimeUnit.SECONDS);
 217             scheduledFutures.add(future);
 218         }
 219     }
 220
 221     private void internalInitialize() {
 222         // connect to heatpump and check if values can be fetched
 223         HeatpumpConnector connector = new HeatpumpConnector(config.ipAddress, config.port);
 224
 225         try {
 226             connector.read();
 227         } catch (IOException e) {
 228             setStatusConnectionError();
 229             return;
 230         }
 231
 232         // stop trying to establish a connection for initializing the thing once it was established
 233         stopJobs();
 234
 235         // When thing is initialized the first time or and update was triggered, set the available channels
 236         if (thing.getProperties().isEmpty() || tiggerChannelUpdate) {
 237             updateChannels(connector);
 238         }
 239
 240         setStatusOnline();
 241         restartJobs();
 242     }
 243
 244     @Override
 245     protected void updateConfiguration(Configuration configuration) {
 246         tiggerChannelUpdate = true;
 247         super.updateConfiguration(configuration);
 248     }
 249
 250     @Override
 251     public void dispose() {
 252         stopJobs();
 253     }
 254
 255     private void updateChannels(HeatpumpConnector connector) {
 256         Integer[] visibilityValues = connector.getVisibilities();
 257         Integer[] heatpumpValues = connector.getValues();
 258         Integer[] heatpumpParams = connector.getParams();
 259
 260         logger.debug("Updating available channels for thing {}", thing.getUID());
 261
 262         final ThingHandlerCallback callback = getCallback();
 263         if (callback == null) {
 264             logger.debug("ThingHandlerCallback is null. Skipping migration of last_update channel.");
 265             return;
 266         }
 267
 268         ThingBuilder thingBuilder = editThing();
 269         List<Channel> channelList = new ArrayList<>();
 270
 271         // clear channel list
 272         thingBuilder.withoutChannels(thing.getChannels());
 273
 274         // create list with available channels
 275         for (HeatpumpChannel channel : HeatpumpChannel.values()) {
 276             Integer channelId = channel.getChannelId();
 277             int length = channel.isWritable() ? heatpumpParams.length : heatpumpValues.length;
 278             ChannelUID channelUID = new ChannelUID(thing.getUID(), channel.getCommand());
 279             ChannelTypeUID channelTypeUID = new ChannelTypeUID(LuxtronikHeatpumpBindingConstants.BINDING_ID,
 280                     channel.getCommand());
 281             if ((channelId != null && length <= channelId)
 282                     || (config.showAllChannels == Boolean.FALSE && !channel.isVisible(visibilityValues))) {
 283                 logger.debug("Hiding channel {}", channel.getCommand());
 284             } else {
 285                 channelList.add(callback.createChannelBuilder(channelUID, channelTypeUID).build());
 286             }
 287         }
 288
 289         thingBuilder.withChannels(channelList);
 290
 291         updateThing(thingBuilder.build());
 292     }
 293
 294     private void restartJobs() {
 295         stopJobs();
 296
 297         synchronized (scheduledFutures) {
 298             if (getThing().getStatus() == ThingStatus.ONLINE) {
 299                 // Repeat channel update job every configured seconds
 300                 Runnable channelUpdaterJob = new ChannelUpdaterJob(this, translationProvider);
 301                 ScheduledFuture<?> future = scheduler.scheduleWithFixedDelay(channelUpdaterJob, 0, config.refresh,
 302                         TimeUnit.SECONDS);
 303                 scheduledFutures.add(future);
 304             }
 305         }
 306     }
 307
 308     private void stopJobs() {
 309         synchronized (scheduledFutures) {
 310             for (ScheduledFuture<?> future : scheduledFutures) {
 311                 if (!future.isDone()) {
 312                     future.cancel(true);
 313                 }
 314             }
 315             scheduledFutures.clear();
 316         }
 317     }
 318
 319     /**
 320      * Set a parameter on the Luxtronik heatpump.
 321      *
 322      * @param param
 323      * @param value
 324      */
 325     private boolean sendParamToHeatpump(int param, int value) {
 326         HeatpumpConnector connector = new HeatpumpConnector(config.ipAddress, config.port);
 327
 328         try {
 329             return connector.setParam(param, value);
 330         } catch (IOException e) {
 331             setStatusConnectionError();
 332         }
 333
 334         return false;
 335     }
 336 }