2 * Copyright (c) 2010-2022 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.shelly.internal;
15 import static org.openhab.binding.shelly.internal.discovery.ShellyThingCreator.*;
17 import java.util.Collections;
19 import java.util.stream.Collectors;
20 import java.util.stream.Stream;
22 import org.eclipse.jdt.annotation.NonNullByDefault;
23 import org.openhab.core.thing.ThingTypeUID;
26 * The {@link ShellyBindingConstants} class defines common constants, which are
27 * used across the whole binding.
29 * @author Markus Michels - Initial contribution
32 public class ShellyBindingConstants {
34 public static final String VENDOR = "Shelly";
35 public static final String BINDING_ID = "shelly";
36 public static final String SYSTEM_ID = "system";
38 public static final Set<ThingTypeUID> SUPPORTED_THING_TYPES_UIDS = Collections
39 .unmodifiableSet(Stream.of(THING_TYPE_SHELLY1, THING_TYPE_SHELLY1L, THING_TYPE_SHELLY1PM,
40 THING_TYPE_SHELLYEM, THING_TYPE_SHELLY3EM, THING_TYPE_SHELLY2_RELAY, THING_TYPE_SHELLY2_ROLLER,
41 THING_TYPE_SHELLY25_RELAY, THING_TYPE_SHELLY25_ROLLER, THING_TYPE_SHELLY4PRO, THING_TYPE_SHELLYPLUG,
42 THING_TYPE_SHELLYPLUGS, THING_TYPE_SHELLYPLUGU1, THING_TYPE_SHELLYUNI, THING_TYPE_SHELLYDIMMER,
43 THING_TYPE_SHELLYDIMMER2, THING_TYPE_SHELLYIX3, THING_TYPE_SHELLYBULB, THING_TYPE_SHELLYDUO,
44 THING_TYPE_SHELLYVINTAGE, THING_TYPE_SHELLYDUORGBW, THING_TYPE_SHELLYRGBW2_COLOR,
45 THING_TYPE_SHELLYRGBW2_WHITE, THING_TYPE_SHELLYHT, THING_TYPE_SHELLYTRV, THING_TYPE_SHELLYSENSE,
46 THING_TYPE_SHELLYEYE, THING_TYPE_SHELLYSMOKE, THING_TYPE_SHELLYGAS, THING_TYPE_SHELLYFLOOD,
47 THING_TYPE_SHELLYDOORWIN, THING_TYPE_SHELLYDOORWIN2, THING_TYPE_SHELLYBUTTON1,
48 THING_TYPE_SHELLYBUTTON2, THING_TYPE_SHELLMOTION, THING_TYPE_SHELLMOTION,
49 THING_TYPE_SHELLYPROTECTED, THING_TYPE_SHELLYUNKNOWN).collect(Collectors.toSet()));
51 // Thing Configuration Properties
52 public static final String CONFIG_DEVICEIP = "deviceIp";
53 public static final String CONFIG_HTTP_USERID = "userId";
54 public static final String CONFIG_HTTP_PASSWORD = "password";
55 public static final String CONFIG_UPDATE_INTERVAL = "updateInterval";
57 public static final String PROPERTY_SERVICE_NAME = "serviceName";
58 public static final String PROPERTY_DEV_NAME = "deviceName";
59 public static final String PROPERTY_DEV_TYPE = "deviceType";
60 public static final String PROPERTY_DEV_MODE = "deviceMode";
61 public static final String PROPERTY_DEV_GEN = "deviceGeneration";
62 public static final String PROPERTY_HWREV = "deviceHwRev";
63 public static final String PROPERTY_HWBATCH = "deviceHwBatch";
64 public static final String PROPERTY_UPDATE_PERIOD = "devUpdatePeriod";
65 public static final String PROPERTY_NUM_RELAYS = "numberRelays";
66 public static final String PROPERTY_NUM_ROLLERS = "numberRollers";
67 public static final String PROPERTY_NUM_METER = "numberMeters";
68 public static final String PROPERTY_LAST_ACTIVE = "lastActive";
69 public static final String PROPERTY_WIFI_NETW = "wifiNetwork";
70 public static final String PROPERTY_UPDATE_STATUS = "updateStatus";
71 public static final String PROPERTY_UPDATE_AVAILABLE = "updateAvailable";
72 public static final String PROPERTY_UPDATE_CURR_VERS = "updateCurrentVersion";
73 public static final String PROPERTY_UPDATE_NEW_VERS = "updateNewVersion";
74 public static final String PROPERTY_COAP_DESCR = "coapDeviceDescr";
75 public static final String PROPERTY_COAP_VERSION = "coapVersion";
76 public static final String PROPERTY_COIOTAUTO = "coiotAutoEnable";
79 public static final String CHANNEL_GROUP_RELAY_CONTROL = "relay";
80 public static final String CHANNEL_OUTPUT_NAME = "outputName";
81 public static final String CHANNEL_OUTPUT = "output";
82 public static final String CHANNEL_INPUT = "input";
83 public static final String CHANNEL_INPUT1 = "input1";
84 public static final String CHANNEL_INPUT2 = "input2";
85 public static final String CHANNEL_BRIGHTNESS = "brightness";
87 public static final String CHANNEL_TIMER_AUTOON = "autoOn";
88 public static final String CHANNEL_TIMER_AUTOOFF = "autoOff";
89 public static final String CHANNEL_TIMER_ACTIVE = "timerActive";
92 public static final String CHANNEL_GROUP_ROL_CONTROL = "roller";
93 public static final String CHANNEL_ROL_CONTROL_CONTROL = "control";
94 public static final String CHANNEL_ROL_CONTROL_POS = "rollerpos";
95 public static final String CHANNEL_ROL_CONTROL_FAV = "rollerFav";
96 public static final String CHANNEL_ROL_CONTROL_TIMER = "timer";
97 public static final String CHANNEL_ROL_CONTROL_STATE = "state";
98 public static final String CHANNEL_ROL_CONTROL_STOPR = "stopReason";
99 public static final String CHANNEL_ROL_CONTROL_SAFETY = "safety";
102 public static final String CHANNEL_GROUP_DIMMER_CONTROL = CHANNEL_GROUP_RELAY_CONTROL;
105 public static final String CHANNEL_GROUP_METER = "meter";
106 public static final String CHANNEL_METER_CURRENTWATTS = "currentWatts";
107 public static final String CHANNEL_METER_LASTMIN = "lastPower";
108 public static final String CHANNEL_METER_LASTMIN1 = CHANNEL_METER_LASTMIN + "1";
109 public static final String CHANNEL_METER_TOTALKWH = "totalKWH";
110 public static final String CHANNEL_EMETER_TOTALRET = "returnedKWH";
111 public static final String CHANNEL_EMETER_REACTWATTS = "reactiveWatts";
112 public static final String CHANNEL_EMETER_VOLTAGE = "voltage";
113 public static final String CHANNEL_EMETER_CURRENT = "current";
114 public static final String CHANNEL_EMETER_PFACTOR = "powerFactor";
116 public static final String CHANNEL_GROUP_SENSOR = "sensors";
117 public static final String CHANNEL_SENSOR_TEMP = "temperature";
118 public static final String CHANNEL_SENSOR_HUM = "humidity";
119 public static final String CHANNEL_SENSOR_LUX = "lux";
120 public static final String CHANNEL_SENSOR_PPM = "ppm";
121 public static final String CHANNEL_SENSOR_VOLTAGE = "voltage";
122 public static final String CHANNEL_SENSOR_ILLUM = "illumination";
123 public static final String CHANNEL_SENSOR_VIBRATION = "vibration";
124 public static final String CHANNEL_SENSOR_TILT = "tilt";
125 public static final String CHANNEL_SENSOR_FLOOD = "flood";
126 public static final String CHANNEL_SENSOR_SMOKE = "smoke";
127 public static final String CHANNEL_SENSOR_STATE = "state";
128 public static final String CHANNEL_SENSOR_VALVE = "valve";
129 public static final String CHANNEL_SENSOR_SSTATE = "status"; // Shelly Gas
130 public static final String CHANNEL_SENSOR_MOTION_ACT = "motionActive";
131 public static final String CHANNEL_SENSOR_MOTION = "motion";
132 public static final String CHANNEL_SENSOR_MOTION_TS = "motionTimestamp";
133 public static final String CHANNEL_SENSOR_SLEEPTIME = "sensorSleepTime";
134 public static final String CHANNEL_SENSOR_ALARM_STATE = "alarmState";
135 public static final String CHANNEL_SENSOR_ERROR = "lastError";
138 public static final String CHANNEL_CONTROL_SETTEMP = "targetTemp";
139 public static final String CHANNEL_CONTROL_POSITION = "position";
140 public static final String CHANNEL_CONTROL_MODE = "mode";
141 public static final String CHANNEL_CONTROL_BCONTROL = "boost";
142 public static final String CHANNEL_CONTROL_BTIMER = "boostTimer";
143 public static final String CHANNEL_CONTROL_SCHEDULE = "schedule";
144 public static final String CHANNEL_CONTROL_PROFILE = "selectedProfile";
146 // External sensors for Shelly1/1PM
147 public static final String CHANNEL_ESENDOR_TEMP1 = CHANNEL_SENSOR_TEMP + "1";
148 public static final String CHANNEL_ESENDOR_TEMP2 = CHANNEL_SENSOR_TEMP + "2";
149 public static final String CHANNEL_ESENDOR_TEMP3 = CHANNEL_SENSOR_TEMP + "3";
150 public static final String CHANNEL_ESENDOR_HUMIDITY = CHANNEL_SENSOR_HUM;
152 public static final String CHANNEL_GROUP_CONTROL = "control";
153 public static final String CHANNEL_SENSE_KEY = "key";
155 public static final String CHANNEL_GROUP_BATTERY = "battery";
156 public static final String CHANNEL_SENSOR_BAT_LEVEL = "batteryLevel";
157 public static final String CHANNEL_SENSOR_BAT_LOW = "lowBattery";
159 public static final String CHANNEL_GROUP_LIGHT_CONTROL = "control";
160 public static final String CHANNEL_LIGHT_COLOR_MODE = "mode";
161 public static final String CHANNEL_LIGHT_POWER = "power";
162 public static final String CHANNEL_LIGHT_DEFSTATE = "defaultState";
163 public static final String CHANNEL_GROUP_LIGHT_CHANNEL = "channel";
165 // Bulb/RGBW2 in color mode
166 public static final String CHANNEL_GROUP_COLOR_CONTROL = "color";
167 public static final String CHANNEL_COLOR_PICKER = "hsb";
168 public static final String CHANNEL_COLOR_FULL = "full";
169 public static final String CHANNEL_COLOR_RED = "red";
170 public static final String CHANNEL_COLOR_GREEN = "green";
171 public static final String CHANNEL_COLOR_BLUE = "blue";
172 public static final String CHANNEL_COLOR_WHITE = "white";
173 public static final String CHANNEL_COLOR_GAIN = "gain";
174 public static final String CHANNEL_COLOR_EFFECT = "effect";
176 // Bulb/RGBW2/Dup in White Mode
177 public static final String CHANNEL_GROUP_WHITE_CONTROL = "white";
178 public static final String CHANNEL_COLOR_TEMP = "temperature";
181 public static final String CHANNEL_GROUP_DEV_STATUS = "device";
182 public static final String CHANNEL_DEVST_NAME = "deviceName";
183 public static final String CHANNEL_DEVST_UPTIME = "uptime";
184 public static final String CHANNEL_DEVST_HEARTBEAT = "heartBeat";
185 public static final String CHANNEL_DEVST_RSSI = "wifiSignal";
186 public static final String CHANNEL_DEVST_ITEMP = "internalTemp";
187 public static final String CHANNEL_DEVST_WAKEUP = "wakeupReason";
188 public static final String CHANNEL_DEVST_ALARM = "alarm";
189 public static final String CHANNEL_DEVST_ACCUWATTS = "accumulatedWatts";
190 public static final String CHANNEL_DEVST_ACCUTOTAL = "accumulatedWTotal";
191 public static final String CHANNEL_DEVST_ACCURETURNED = "accumulatedReturned";
192 public static final String CHANNEL_DEVST_CHARGER = "charger";
193 public static final String CHANNEL_DEVST_UPDATE = "updateAvailable";
194 public static final String CHANNEL_DEVST_SELFTTEST = "selfTest";
195 public static final String CHANNEL_DEVST_VOLTAGE = "supplyVoltage";
196 public static final String CHANNEL_DEVST_CALIBRATED = "calibrated";
198 public static final String CHANNEL_LED_STATUS_DISABLE = "statusLed";
199 public static final String CHANNEL_LED_POWER_DISABLE = "powerLed";
201 public static final String CHANNEL_GROUP_STATUS = "status";
202 public static final String CHANNEL_STATUS_EVENTTYPE = "lastEvent";
203 public static final String CHANNEL_STATUS_EVENTTYPE1 = CHANNEL_STATUS_EVENTTYPE + "1";
204 public static final String CHANNEL_STATUS_EVENTTYPE2 = CHANNEL_STATUS_EVENTTYPE + "2";
205 public static final String CHANNEL_STATUS_EVENTCOUNT = "eventCount";
206 public static final String CHANNEL_STATUS_EVENTCOUNT1 = CHANNEL_STATUS_EVENTCOUNT + "1";
207 public static final String CHANNEL_STATUS_EVENTCOUNT2 = CHANNEL_STATUS_EVENTCOUNT + "2";
210 public static final String CHANNEL_LAST_UPDATE = "lastUpdate";
211 public static final String CHANNEL_EVENT_TRIGGER = "event";
212 public static final String CHANNEL_BUTTON_TRIGGER = "button";
213 public static final String CHANNEL_BUTTON_TRIGGER1 = CHANNEL_BUTTON_TRIGGER + "1";
214 public static final String CHANNEL_BUTTON_TRIGGER2 = CHANNEL_BUTTON_TRIGGER + "2";
216 public static final String SERVICE_TYPE = "_http._tcp.local.";
217 public static final String SHELLY_API_MIN_FWVERSION = "v1.8.2";
218 public static final String SHELLY_API_MIN_FWCOIOT = "v1.6";// v1.6.0+
219 public static final String SHELLY_API_FWCOIOT2 = "v1.8";// CoAP 2 with FW 1.8+
220 public static final String SHELLY_API_FW_110 = "v1.10"; // FW 1.10 or newer detected, activates some add feature
222 // Alarm types/messages
223 public static final String ALARM_TYPE_NONE = "NONE";
224 public static final String ALARM_TYPE_RESTARTED = "RESTARTED";
225 public static final String ALARM_TYPE_OVERTEMP = "OVERTEMP";
226 public static final String ALARM_TYPE_OVERPOWER = "OVERPOWER";
227 public static final String ALARM_TYPE_OVERLOAD = "OVERLOAD";
228 public static final String ALARM_TYPE_LOADERR = "LOAD_ERROR";
229 public static final String ALARM_TYPE_SENSOR_ERROR = "SENSOR_ERROR";
230 public static final String ALARM_TYPE_LOW_BATTERY = "LOW_BATTERY";
231 public static final String ALARM_TYPE_VALVE_ERROR = "VALVE_ERROR";
232 public static final String EVENT_TYPE_VIBRATION = "VIBRATION";
235 public static final String EVENT_TYPE_RELAY = "relay";
236 public static final String EVENT_TYPE_ROLLER = "roller";
237 public static final String EVENT_TYPE_LIGHT = "light";
238 public static final String EVENT_TYPE_SENSORDATA = "report";
240 // URI for the EventServlet
241 public static final String SHELLY_CALLBACK_URI = "/shelly/event";
243 public static final int DIM_STEPSIZE = 5;
245 // Formatting: Number of scaling digits
246 public static final int DIGITS_NONE = 0;
247 public static final int DIGITS_WATT = 2;
248 public static final int DIGITS_KWH = 3;
249 public static final int DIGITS_VOLT = 1;
250 public static final int DIGITS_TEMP = 1;
251 public static final int DIGITS_LUX = 0;
252 public static final int DIGITS_PERCENT = 1;
254 public static final int SHELLY_API_TIMEOUT_MS = 15000;
255 public static final int UPDATE_STATUS_INTERVAL_SECONDS = 3; // check for updates every x sec
256 public static final int UPDATE_SKIP_COUNT = 20; // update every x triggers or when a key was pressed
257 public static final int UPDATE_MIN_DELAY = 15;// update every x triggers or when a key was pressed
258 public static final int UPDATE_SETTINGS_INTERVAL_SECONDS = 60; // check for updates every x sec
259 public static final int HEALTH_CHECK_INTERVAL_SEC = 300; // Health check interval, 5min
260 public static final int VIBRATION_FILTER_SEC = 5; // Absore duplicate vibration events for xx sec