2 * Copyright (c) 2010-2023 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.api2;
15 import static org.openhab.binding.shelly.internal.ShellyBindingConstants.*;
16 import static org.openhab.binding.shelly.internal.api1.Shelly1ApiJsonDTO.*;
17 import static org.openhab.binding.shelly.internal.api2.Shelly2ApiJsonDTO.*;
18 import static org.openhab.binding.shelly.internal.discovery.ShellyThingCreator.*;
19 import static org.openhab.binding.shelly.internal.util.ShellyUtils.*;
21 import java.util.ArrayList;
22 import java.util.HashMap;
25 import org.eclipse.jdt.annotation.Nullable;
26 import org.openhab.binding.shelly.internal.api.ShellyApiException;
27 import org.openhab.binding.shelly.internal.api.ShellyDeviceProfile;
28 import org.openhab.binding.shelly.internal.api1.Shelly1ApiJsonDTO.ShellyInputState;
29 import org.openhab.binding.shelly.internal.api1.Shelly1ApiJsonDTO.ShellySensorSleepMode;
30 import org.openhab.binding.shelly.internal.api1.Shelly1ApiJsonDTO.ShellySettingsDevice;
31 import org.openhab.binding.shelly.internal.api1.Shelly1ApiJsonDTO.ShellySettingsInput;
32 import org.openhab.binding.shelly.internal.api1.Shelly1ApiJsonDTO.ShellySettingsStatus;
33 import org.openhab.binding.shelly.internal.api1.Shelly1ApiJsonDTO.ShellyStatusSensor;
34 import org.openhab.binding.shelly.internal.api1.Shelly1ApiJsonDTO.ShellyStatusSensor.ShellySensorAccel;
35 import org.openhab.binding.shelly.internal.api1.Shelly1ApiJsonDTO.ShellyStatusSensor.ShellySensorBat;
36 import org.openhab.binding.shelly.internal.api1.Shelly1ApiJsonDTO.ShellyStatusSensor.ShellySensorLux;
37 import org.openhab.binding.shelly.internal.api1.Shelly1ApiJsonDTO.ShellyStatusSensor.ShellySensorState;
38 import org.openhab.binding.shelly.internal.api2.Shelly2ApiJsonDTO.Shelly2NotifyEvent;
39 import org.openhab.binding.shelly.internal.api2.Shelly2ApiJsonDTO.Shelly2RpcNotifyEvent;
40 import org.openhab.binding.shelly.internal.config.ShellyThingConfiguration;
41 import org.openhab.binding.shelly.internal.handler.ShellyBluSensorHandler;
42 import org.openhab.binding.shelly.internal.handler.ShellyComponents;
43 import org.openhab.binding.shelly.internal.handler.ShellyThingInterface;
44 import org.openhab.binding.shelly.internal.handler.ShellyThingTable;
45 import org.slf4j.Logger;
46 import org.slf4j.LoggerFactory;
49 * {@link ShellyBluApi} implementsBLU interface
51 * @author Markus Michels - Initial contribution
53 public class ShellyBluApi extends Shelly2ApiRpc {
54 private static final Logger logger = LoggerFactory.getLogger(ShellyBluApi.class);
55 private boolean connected = false; // true = BLU devices has connected
56 private ShellySettingsStatus deviceStatus = new ShellySettingsStatus();
57 private int lastPid = -1;
59 private static final Map<String, String> MAP_INPUT_EVENT_TYPE = new HashMap<>();
61 MAP_INPUT_EVENT_TYPE.put(SHELLY2_EVENT_1PUSH, SHELLY_BTNEVENT_1SHORTPUSH);
62 MAP_INPUT_EVENT_TYPE.put(SHELLY2_EVENT_2PUSH, SHELLY_BTNEVENT_2SHORTPUSH);
63 MAP_INPUT_EVENT_TYPE.put(SHELLY2_EVENT_3PUSH, SHELLY_BTNEVENT_3SHORTPUSH);
64 MAP_INPUT_EVENT_TYPE.put(SHELLY2_EVENT_LPUSH, SHELLY_BTNEVENT_LONGPUSH);
65 MAP_INPUT_EVENT_TYPE.put(SHELLY2_EVENT_LSPUSH, SHELLY_BTNEVENT_LONGSHORTPUSH);
66 MAP_INPUT_EVENT_TYPE.put(SHELLY2_EVENT_SLPUSH, SHELLY_BTNEVENT_SHORTLONGPUSH);
67 MAP_INPUT_EVENT_TYPE.put("1", SHELLY_BTNEVENT_1SHORTPUSH);
68 MAP_INPUT_EVENT_TYPE.put("2", SHELLY_BTNEVENT_2SHORTPUSH);
69 MAP_INPUT_EVENT_TYPE.put("3", SHELLY_BTNEVENT_3SHORTPUSH);
70 MAP_INPUT_EVENT_TYPE.put("4", SHELLY_BTNEVENT_LONGPUSH);
74 * Regular constructor - called by Thing handler
76 * @param thingName Symbolic thing name
77 * @param thing Thing Handler (ThingHandlerInterface)
79 public ShellyBluApi(String thingName, ShellyThingTable thingTable, ShellyThingInterface thing) {
80 super(thingName, thingTable, thing);
82 ShellyInputState input = new ShellyInputState();
83 deviceStatus.inputs = new ArrayList<>();
87 deviceStatus.inputs.add(input);
91 public void initialize() throws ShellyApiException {
100 public boolean isInitialized() {
105 public void setConfig(String thingName, ShellyThingConfiguration config) {
106 this.thingName = thingName;
107 this.config = config;
111 public ShellySettingsDevice getDeviceInfo() throws ShellyApiException {
112 ShellySettingsDevice info = new ShellySettingsDevice();
113 info.hostname = !config.serviceName.isEmpty() ? config.serviceName : "";
116 info.mac = config.deviceAddress;
123 public ShellyDeviceProfile getDeviceProfile(String thingType, @Nullable ShellySettingsDevice devInfo)
124 throws ShellyApiException {
125 ShellyDeviceProfile profile = thing != null ? getProfile() : new ShellyDeviceProfile();
127 if (devInfo != null) {
128 profile.device = devInfo;
130 profile.isBlu = true;
131 profile.settingsJson = "{}";
132 profile.thingName = thingName;
133 profile.name = getString(profile.settings.name);
134 if (profile.gateway.isEmpty()) {
135 profile.gateway = getThing().getProperty(PROPERTY_GW_DEVICE);
138 ShellySettingsDevice device = getDeviceInfo();
139 if (config.serviceName.isEmpty()) {
140 config.serviceName = getString(profile.device.hostname);
142 profile.fwDate = substringBefore(device.fw, "/");
143 profile.fwVersion = substringBefore(ShellyDeviceProfile.extractFwVersion(device.fw.replace("/", "/v")), "-");
144 profile.status.update.oldVersion = profile.fwVersion;
145 profile.status.hasUpdate = profile.status.update.hasUpdate = false;
147 if (profile.hasBattery) {
148 profile.settings.sleepMode = new ShellySensorSleepMode();
149 profile.settings.sleepMode.unit = "m";
150 profile.settings.sleepMode.period = 720;
153 if (profile.isButton) {
154 ShellySettingsInput settings = new ShellySettingsInput();
155 profile.numInputs = 1;
156 settings.btnType = SHELLY_BTNT_MOMENTARY;
158 if (profile.settings.inputs != null) {
159 profile.settings.inputs.set(0, settings);
161 profile.settings.inputs = new ArrayList<>();
162 profile.settings.inputs.add(settings);
164 profile.status = deviceStatus;
168 throw new ShellyApiException("BLU Device not yet connected");
171 profile.initialized = true;
176 public ShellySettingsStatus getStatus() throws ShellyApiException {
178 throw new ShellyApiException("Thing is not yet initialized -> status not available");
184 public ShellyStatusSensor getSensorStatus() throws ShellyApiException {
186 throw new ShellyApiException("Thing is not yet initialized -> sensor data not available");
193 public void onNotifyEvent(Shelly2RpcNotifyEvent message) {
194 logger.trace("{}: ShellyEvent received: {}", thingName, gson.toJson(message));
196 boolean updated = false;
197 ShellyBluSensorHandler t = (ShellyBluSensorHandler) thing;
199 logger.debug("{}: Thing is not initialized -> ignore event", thingName);
204 ShellyDeviceProfile profile = getProfile();
215 for (Shelly2NotifyEvent e : message.params.events) {
216 logger.debug("{}: BluEvent received: {}", thingName, gson.toJson(message));
217 String event = getString(e.event);
218 if (event.startsWith(SHELLY2_EVENT_BLUPREFIX)) {
219 logger.debug("{}: BLU event {} received from address {}, pid={}", thingName, event,
220 getString(e.data.addr), getInteger(e.data.pid));
221 if (e.data.pid != null) {
222 int pid = e.data.pid;
223 if (pid == lastPid) {
224 logger.debug("{}: Duplicate packet for PID={} received, ignore", thingName, pid);
229 getThing().getProfile().gateway = message.src;
233 case SHELLY2_EVENT_BLUSCAN:
234 if (e.data == null || e.data.addr == null) {
235 logger.debug("{}: Inconsistent BLU scan result ignored: {}", thingName,
236 gson.toJson(message));
239 logger.debug("{}: BLU Device discovered", thingName);
240 if (e.data.name != null) {
241 profile.settings.name = buildBluServiceName(e.data.name, e.data.addr);
244 case SHELLY2_EVENT_BLUDATA:
245 if (e.data == null || e.data.addr == null || e.data.pid == null) {
246 logger.debug("{}: Inconsistent BLU packet ignored: {}", thingName, gson.toJson(message));
250 if (e.data.battery != null) {
251 if (sensorData.bat == null) {
252 sensorData.bat = new ShellySensorBat();
254 sensorData.bat.value = (double) e.data.battery;
256 if (e.data.rssi != null) {
257 deviceStatus.wifiSta.rssi = e.data.rssi;
259 if (e.data.windowState != null) {
260 if (sensorData.sensor == null) {
261 sensorData.sensor = new ShellySensorState();
263 sensorData.sensor.isValid = true;
264 sensorData.sensor.state = e.data.windowState == 1 ? SHELLY_API_DWSTATE_OPEN
265 : SHELLY_API_DWSTATE_CLOSE;
267 if (e.data.illuminance != null) {
268 if (sensorData.lux == null) {
269 sensorData.lux = new ShellySensorLux();
271 sensorData.lux.isValid = true;
272 sensorData.lux.value = (double) e.data.illuminance;
274 if (e.data.rotation != null) {
275 if (sensorData.accel == null) {
276 sensorData.accel = new ShellySensorAccel();
278 sensorData.accel.tilt = e.data.rotation.intValue();
281 if (e.data.buttonEvent != null) {
282 ShellyInputState input = deviceStatus.inputs != null ? deviceStatus.inputs.get(0)
283 : new ShellyInputState();
284 input.event = mapValue(MAP_INPUT_EVENT_TYPE, e.data.buttonEvent + "");
286 deviceStatus.inputs.set(0, input);
287 // sensorData.inputs.set(0, input);
289 String group = getProfile().getInputGroup(0);
290 String suffix = profile.getInputSuffix(0);
291 t.updateChannel(group, CHANNEL_STATUS_EVENTTYPE + suffix, getStringType(input.event));
292 t.updateChannel(group, CHANNEL_STATUS_EVENTCOUNT + suffix, getDecimal(input.eventCount));
293 t.triggerButton(profile.getInputGroup(0), 0, input.event);
295 updated |= ShellyComponents.updateDeviceStatus(t, deviceStatus);
296 updated |= ShellyComponents.updateSensors(getThing(), deviceStatus);
299 super.onNotifyEvent(message);
302 } catch (ShellyApiException e) {
303 logger.debug("{}: Unable to process event", thingName, e);
310 public static String buildBluServiceName(String name, String mac) throws IllegalArgumentException {
311 String model = name.contains("-") ? substringBefore(name, "-") : name; // e.g. SBBT-02C or just SBDW
313 case SHELLYDT_BLUBUTTON:
314 return (THING_TYPE_SHELLYBLUBUTTON_STR + "-" + mac).toLowerCase();
316 return (THING_TYPE_SHELLYBLUDW_STR + "-" + mac).toLowerCase();
318 throw new IllegalArgumentException("Unsupported BLU device model " + model);