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

   1 /**
   2  * Copyright (c) 2010-2023 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.qbus.internal.protocol;
  14
  15 import java.io.IOException;
  16
  17 import org.eclipse.jdt.annotation.NonNullByDefault;
  18 import org.eclipse.jdt.annotation.Nullable;
  19 import org.openhab.binding.qbus.internal.handler.QbusBistabielHandler;
  20
  21 /**
  22  * The {@link QbusBistabiel} class represents the Qbus BISTABIEL output.
  23  *
  24  * @author Koen Schockaert - Initial Contribution
  25  */
  26
  27 @NonNullByDefault
  28 public final class QbusBistabiel {
  29
  30     private @Nullable QbusCommunication qComm;
  31
  32     private Integer id;
  33
  34     private @Nullable Integer state;
  35
  36     private @Nullable QbusBistabielHandler thingHandler;
  37
  38     QbusBistabiel(Integer id) {
  39         this.id = id;
  40     }
  41
  42     /**
  43      * This method should be called if the ThingHandler for the thing corresponding to this bistabiel is initialized.
  44      * It keeps a record of the thing handler in this object so the thing can be updated when
  45      * the bistable output receives an update from the Qbus client.
  46      *
  47      * @param handler
  48      */
  49     public void setThingHandler(QbusBistabielHandler handler) {
  50         this.thingHandler = handler;
  51     }
  52
  53     /**
  54      * This method sets a pointer to the qComm BISTABIEL of class {@link QbusCommuncation}.
  55      * This is then used to be able to call back the sendCommand method in this class to send a command to the
  56      * Qbus client.
  57      *
  58      * @param qComm
  59      */
  60     public void setQComm(QbusCommunication qComm) {
  61         this.qComm = qComm;
  62     }
  63
  64     /**
  65      * Update the value of the Bistabiel.
  66      *
  67      * @param state
  68      */
  69     void updateState(@Nullable Integer state) {
  70         this.state = state;
  71         QbusBistabielHandler handler = this.thingHandler;
  72         if (handler != null) {
  73             handler.handleStateUpdate(this);
  74         }
  75     }
  76
  77     /**
  78      * Get the value of the Bistabiel.
  79      *
  80      * @return
  81      */
  82     public @Nullable Integer getState() {
  83         return this.state;
  84     }
  85
  86     /**
  87      * Sends Bistabiel state to Qbus.
  88      *
  89      * @param value
  90      * @param sn
  91      * @throws InterruptedException
  92      * @throws IOException
  93      */
  94     public void execute(int value, String sn) throws InterruptedException, IOException {
  95         QbusMessageCmd qCmd = new QbusMessageCmd(sn, "executeBistabiel").withId(this.id).withState(value);
  96         QbusCommunication comm = this.qComm;
  97         if (comm != null) {
  98             comm.sendMessage(qCmd);
  99         }
 100     }
 101 }