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.velux.internal.bridge.slip;
  14
  15 import org.eclipse.jdt.annotation.NonNullByDefault;
  16 import org.eclipse.jdt.annotation.Nullable;
  17 import org.openhab.binding.velux.internal.bridge.VeluxBridgeInstance;
  18 import org.openhab.binding.velux.internal.bridge.common.BridgeAPI;
  19 import org.openhab.binding.velux.internal.bridge.common.GetDeviceStatus;
  20 import org.openhab.binding.velux.internal.bridge.common.GetFirmware;
  21 import org.openhab.binding.velux.internal.bridge.common.GetHouseStatus;
  22 import org.openhab.binding.velux.internal.bridge.common.GetLANConfig;
  23 import org.openhab.binding.velux.internal.bridge.common.GetProduct;
  24 import org.openhab.binding.velux.internal.bridge.common.GetProductLimitation;
  25 import org.openhab.binding.velux.internal.bridge.common.GetProducts;
  26 import org.openhab.binding.velux.internal.bridge.common.GetScenes;
  27 import org.openhab.binding.velux.internal.bridge.common.GetWLANConfig;
  28 import org.openhab.binding.velux.internal.bridge.common.Login;
  29 import org.openhab.binding.velux.internal.bridge.common.Logout;
  30 import org.openhab.binding.velux.internal.bridge.common.RunProductCommand;
  31 import org.openhab.binding.velux.internal.bridge.common.RunProductDiscovery;
  32 import org.openhab.binding.velux.internal.bridge.common.RunProductIdentification;
  33 import org.openhab.binding.velux.internal.bridge.common.RunProductSearch;
  34 import org.openhab.binding.velux.internal.bridge.common.RunReboot;
  35 import org.openhab.binding.velux.internal.bridge.common.RunScene;
  36 import org.openhab.binding.velux.internal.bridge.common.SetHouseStatusMonitor;
  37 import org.openhab.binding.velux.internal.bridge.common.SetProductLimitation;
  38 import org.openhab.binding.velux.internal.bridge.common.SetSceneVelocity;
  39 import org.slf4j.Logger;
  40 import org.slf4j.LoggerFactory;
  41
  42 /**
  43  * SLIP-based 3rd Level I/O interface towards the <B>Velux</B> bridge.
  44  * <P>
  45  * It provides the one-and-only protocol specific 1st-level communication class.
  46  * Additionally it provides all methods for different gateway interactions.
  47  * <P>
  48  * The following class access methods exist:
  49  * <UL>
  50  * <LI>{@link SlipBridgeAPI#getDeviceStatus} for retrieving the bridge state (i.e. IDLE, BUSY, a.s.o),</LI>
  51  * <LI>{@link SlipBridgeAPI#getFirmware} for retrieving the firmware version of the bridge,</LI>
  52  * <LI>{@link SlipBridgeAPI#getHouseStatus} for retrieving the information about device state changes recognized by the
  53  * bridge,</LI>
  54  * <LI>{@link SlipBridgeAPI#getLANConfig} for retrieving the complete LAN information of the bridge,</LI>
  55  * <LI>{@link SlipBridgeAPI#getProduct} for retrieving the any information about a device behind the bridge,</LI>
  56  * <LI>{@link SlipBridgeAPI#getProductLimitation} for retrieving the limitation information about a device behind the
  57  * bridge,</LI>
  58  * <LI>{@link SlipBridgeAPI#getProducts} for retrieving the any information for all devices behind the bridge,</LI>
  59  * <LI>{@link SlipBridgeAPI#getScenes} for retrieving the any information for all scenes defined on the bridge,</LI>
  60  * <LI>{@link SlipBridgeAPI#getWLANConfig} for retrieving the complete WLAN information of the bridge,</LI>
  61  * <LI>{@link SlipBridgeAPI#login} for establishing a trusted connectivity by authentication,</LI>
  62  * <LI>{@link SlipBridgeAPI#logout} for tearing down the trusted connectivity by deauthentication,</LI>
  63  * <LI>{@link SlipBridgeAPI#runProductCommand} for manipulation of a device behind the bridge (i.e. instructing to
  64  * modify a position),</LI>
  65  * <LI>{@link SlipBridgeAPI#runProductDiscovery} for activation of learning mode of the bridge to discovery new
  66  * products,</LI>
  67  * <LI>{@link SlipBridgeAPI#runProductIdentification} for human-oriented identification a device behind the bridge (i.e.
  68  * by winking or switching on-and-off),</LI>
  69  * <LI>{@link SlipBridgeAPI#runProductSearch} for searching for lost products on the bridge,</LI>
  70  * <LI>{@link SlipBridgeAPI#runScene} for manipulation of a set of devices behind the bridge which are tied together as
  71  * scene,</LI>
  72  * <LI>{@link SlipBridgeAPI#setHouseStatusMonitor} for activation or deactivation of the house monitoring mode to be
  73  * informed about device state changes recognized by the bridge,</LI>
  74  * <LI>{@link SlipBridgeAPI#setSceneVelocity} for changes the velocity of a scene defined on the bridge (i.e. silent or
  75  * fast mode).</LI>
  76  * </UL>
  77  * <P>
  78  * As most derived class of the several inheritance levels it defines an
  79  * interfacing method which returns the SLIP-protocol-specific communication for gateway interaction.
  80  *
  81  * @author Guenther Schreiner - Initial contribution.
  82  */
  83 @NonNullByDefault
  84 class SlipBridgeAPI implements BridgeAPI {
  85     private final Logger logger = LoggerFactory.getLogger(SlipBridgeAPI.class);
  86
  87     private final GetDeviceStatus slipGetDeviceStatus = new SCgetDeviceStatus();
  88     private final GetFirmware slipGetFirmware = new SCgetFirmware();
  89     private final GetHouseStatus slipGetHouseStatus = new SCgetHouseStatus();
  90     private final GetLANConfig slipGetLanConfig = new SCgetLANConfig();
  91     private final GetProduct slipGetProduct = new SCgetProduct();
  92     private final GetProductLimitation slipGetProductLimitation = new SCgetLimitation();
  93     private final GetProducts slipGetProducts = new SCgetProducts();
  94     private final GetScenes slipGetScenes = new SCgetScenes();
  95     private final GetWLANConfig slipGetWLanConfig = new SCgetWLANConfig();
  96     private final Login slipLogin = new SClogin();
  97     private final Logout slipLogout = new SClogout();
  98     private final RunProductCommand slipRunProductCommand = new SCrunProductCommand();
  99     private final RunProductDiscovery slipRunProductDiscovery = new SCrunProductDiscovery();
 100     private final RunProductIdentification slipRunProductIdentification = new SCrunProductIdentification();
 101     private final RunProductSearch slipRunProductSearch = new SCrunProductSearch();
 102     private final RunScene slipRunScene = new SCrunScene();
 103     private final SetHouseStatusMonitor slipSetHouseMonitor = new SCsetHouseStatusMonitor();
 104     private final SetProductLimitation slipSetProductLimitation = new SCsetLimitation();
 105     private final SetSceneVelocity slipSetSceneVelocity = new SCsetSceneVelocity();
 106     private final RunReboot slipRunReboot = new SCrunReboot();
 107
 108     /**
 109      * Constructor.
 110      * <P>
 111      * Inherits the initialization of the binding-wide instance for dealing for common information and
 112      * initializes the handler {@link SlipVeluxBridge#bridgeAPI}
 113      * to pass the interface methods.
 114      *
 115      * @param bridgeInstance refers to the binding-wide instance for dealing for common informations.
 116      */
 117     SlipBridgeAPI(VeluxBridgeInstance bridgeInstance) {
 118         logger.trace("SlipBridgeAPI(constructor) called.");
 119     }
 120
 121     @Override
 122     public GetDeviceStatus getDeviceStatus() {
 123         return slipGetDeviceStatus;
 124     }
 125
 126     @Override
 127     public GetFirmware getFirmware() {
 128         return slipGetFirmware;
 129     }
 130
 131     @Override
 132     public @Nullable GetHouseStatus getHouseStatus() {
 133         return slipGetHouseStatus;
 134     }
 135
 136     @Override
 137     public GetLANConfig getLANConfig() {
 138         return slipGetLanConfig;
 139     }
 140
 141     @Override
 142     public @Nullable GetProduct getProduct() {
 143         return slipGetProduct;
 144     }
 145
 146     @Override
 147     public @Nullable GetProductLimitation getProductLimitation() {
 148         return slipGetProductLimitation;
 149     }
 150
 151     @Override
 152     public @Nullable SetProductLimitation setProductLimitation() {
 153         return slipSetProductLimitation;
 154     }
 155
 156     @Override
 157     public GetProducts getProducts() {
 158         return slipGetProducts;
 159     }
 160
 161     @Override
 162     public GetScenes getScenes() {
 163         return slipGetScenes;
 164     }
 165
 166     @Override
 167     public GetWLANConfig getWLANConfig() {
 168         return slipGetWLanConfig;
 169     }
 170
 171     @Override
 172     public Login login() {
 173         return slipLogin;
 174     }
 175
 176     @Override
 177     public Logout logout() {
 178         return slipLogout;
 179     }
 180
 181     @Override
 182     public @Nullable RunProductCommand runProductCommand() {
 183         return slipRunProductCommand;
 184     }
 185
 186     @Override
 187     public RunProductDiscovery runProductDiscovery() {
 188         return slipRunProductDiscovery;
 189     }
 190
 191     @Override
 192     public RunProductIdentification runProductIdentification() {
 193         return slipRunProductIdentification;
 194     }
 195
 196     @Override
 197     public RunProductSearch runProductSearch() {
 198         return slipRunProductSearch;
 199     }
 200
 201     @Override
 202     public RunScene runScene() {
 203         return slipRunScene;
 204     }
 205
 206     @Override
 207     public @Nullable SetHouseStatusMonitor setHouseStatusMonitor() {
 208         return slipSetHouseMonitor;
 209     }
 210
 211     @Override
 212     public SetSceneVelocity setSceneVelocity() {
 213         return slipSetSceneVelocity;
 214     }
 215
 216     @Override
 217     public @Nullable RunReboot runReboot() {
 218         return slipRunReboot;
 219     }
 220 }