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

   1 /**
   2  * Copyright (c) 2010-2024 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.shelly.internal.api1;
  14
  15 import java.util.ArrayList;
  16 import java.util.List;
  17
  18 import org.eclipse.jdt.annotation.Nullable;
  19 import org.openhab.binding.shelly.internal.api1.Shelly1ApiJsonDTO.ShellyStatusSensor.ShellyMotionSettings;
  20 import org.openhab.core.thing.CommonTriggerEvents;
  21
  22 import com.google.gson.annotations.SerializedName;
  23
  24 /**
  25  * The {@link Shelly1ApiJsonDTO} is used for the JSon/GSon mapping
  26  *
  27  * @author Markus Michels - Initial contribution
  28  */
  29 public class Shelly1ApiJsonDTO {
  30     public static final String SHELLY_NULL_URL = "null";
  31     public static final String SHELLY_URL_DEVINFO = "/shelly";
  32     public static final String SHELLY_URL_STATUS = "/status";
  33     public static final String SHELLY_URL_SETTINGS = "/settings";
  34     public static final String SHELLY_URL_SETTINGS_AP = "/settings/ap";
  35     public static final String SHELLY_URL_SETTINGS_STA = "/settings/sta";
  36     public static final String SHELLY_URL_SETTINGS_LOGIN = "/settings/sta";
  37     public static final String SHELLY_URL_SETTINGS_CLOUD = "/settings/cloud";
  38     public static final String SHELLY_URL_LIST_IR = "/ir/list";
  39     public static final String SHELLY_URL_SEND_IR = "/ir/emit";
  40     public static final String SHELLY_URL_RESTART = "/reboot";
  41
  42     public static final String SHELLY_URL_SETTINGS_RELAY = "/settings/relay";
  43     public static final String SHELLY_URL_STATUS_RELEAY = "/status/relay";
  44     public static final String SHELLY_URL_CONTROL_RELEAY = "/relay";
  45
  46     public static final String SHELLY_URL_SETTINGS_EMETER = "/settings/emeter";
  47     public static final String SHELLY_URL_STATUS_EMETER = "/emeter";
  48     public static final String SHELLY_URL_DATA_EMETER = "/emeter/{0}/em_data.csv";
  49
  50     public static final String SHELLY_URL_CONTROL_ROLLER = "/roller";
  51     public static final String SHELLY_URL_SETTINGS_ROLLER = "/settings/roller";
  52
  53     public static final String SHELLY_URL_SETTINGS_LIGHT = "/settings/light";
  54     public static final String SHELLY_URL_STATUS_LIGHT = "/light";
  55     public static final String SHELLY_URL_CONTROL_LIGHT = "/light";
  56
  57     public static final String SHELLY_URL_SETTINGS_DIMMER = "/settings/light";
  58
  59     // Wakeup reasons
  60     public static final String SHELLY_WAKEUPT_SENSOR = "SENSOR"; // new sensordata
  61     public static final String SHELLY_WAKEUPT_PERIODIC = "PERIODIC"; // periodic wakeup
  62     public static final String SHELLY_WAKEUPT_BUTTON = "BUTTON"; // button pressed
  63     public static final String SHELLY_WAKEUPT_POWERON = "POWERON"; // device powered up
  64     public static final String SHELLY_WAKEUPT_EXT_POWER = "EXT_POWER"; // charger connected
  65     public static final String SHELLY_WAKEUPT_UNKNOWN = "UNKNOWN"; // other event
  66
  67     //
  68     // Action URLs according to the device type
  69     //
  70     public static final String SHELLY_EVENTURL_SUFFIX = "_url";
  71
  72     // Relay
  73     public static final String SHELLY_EVENT_BTN_ON = "btn_on";
  74     public static final String SHELLY_EVENT_BTN_OFF = "btn_off";
  75     public static final String SHELLY_EVENT_OUT_ON = "out_on";
  76     public static final String SHELLY_EVENT_OUT_OFF = "out_off";
  77     public static final String SHELLY_EVENT_SHORTPUSH = "shortpush";
  78     public static final String SHELLY_EVENT_LONGPUSH = "longpush";
  79     // Button
  80     public static final String SHELLY_EVENT_DOUBLE_SHORTPUSH = "double_shortpush";
  81     public static final String SHELLY_EVENT_TRIPLE_SHORTPUSH = "triple_shortpush";
  82     public static final String SHELLY_EVENT_SHORT_LONGTPUSH = "shortpush_longpush";
  83     public static final String SHELLY_EVENT_LONG_SHORTPUSH = "longpush_shortpush";
  84
  85     // Dimmer
  86     public static final String SHELLY_EVENT_BTN1_ON = "btn1_on";
  87     public static final String SHELLY_EVENT_BTN1_OFF = "btn1_off";
  88     public static final String SHELLY_EVENT_BTN2_ON = "btn2_on";
  89     public static final String SHELLY_EVENT_BTN2_OFF = "btn2_off";
  90     public static final String SHELLY_EVENT_SHORTPUSH1 = "btn1_shortpush";
  91     public static final String SHELLY_EVENT_LONGPUSH1 = "btn1_longpush";
  92     public static final String SHELLY_EVENT_SHORTPUSH2 = "btn2_shortpush";
  93     public static final String SHELLY_EVENT_LONGPUSH2 = "btn2_longpush";
  94
  95     // Roller
  96     public static final String SHELLY_EVENT_ROLLER_OPEN = "roller_open";
  97     public static final String SHELLY_EVENT_ROLLER_CLOSE = "roller_close";
  98     public static final String SHELLY_EVENT_ROLLER_STOP = "roller_stop";
  99     public static final String SHELLY_EVENT_ROLLER_CALIB = "roller_calibrating";
 100
 101     // Roller states
 102     public static final String SHELLY_RSTATE_OPEN = "open";
 103     public static final String SHELLY_RSTATE_STOP = "stop";
 104     public static final String SHELLY_RSTATE_CLOSE = "close";
 105
 106     // Sensors
 107     public static final String SHELLY_EVENT_SENSORREPORT = "report";
 108     public static final String SHELLY_EVENT_DARK = "dark";
 109     public static final String SHELLY_EVENT_TWILIGHT = "twilight";
 110     public static final String SHELLY_EVENT_BRIGHT = "bright";
 111     public static final String SHELLY_EVENT_FLOOD_DETECTED = "flood_detected";
 112     public static final String SHELLY_EVENT_FLOOD_GONE = "flood_gone";
 113     public static final String SHELLY_EVENT_VIBRATION = "vibration"; // DW 1.6.5+
 114     public static final String SHELLY_EVENT_OPEN = "open"; // DW 1.6.5+
 115     public static final String SHELLY_EVENT_CLOSE = "close"; // DW 1.6.5+
 116     public static final String SHELLY_EVENT_TEMP_OVER = "temp_over"; // FW 1.7
 117     public static final String SHELLY_EVENT_TEMP_UNDER = "temp_under"; // FW 1.7
 118
 119     // Gas
 120     public static final String SHELLY_EVENT_ALARM_MILD = "alarm_mild"; // DW 1.7+
 121     public static final String SHELLY_EVENT_ALARM_HEAVY = "alarm_heavy"; // DW 1.7+
 122     public static final String SHELLY_EVENT_ALARM_OFF = "alarm_off"; // DW 1.7+
 123
 124     //
 125     // API values
 126     //
 127     public static final double SHELLY_API_INVTEMP = 999.0;
 128
 129     public static final String SHELLY_BTNT_MOMENTARY = "momentary";
 130     public static final String SHELLY_BTNT_MOM_ON_RELEASE = "momentary_on_release";
 131     public static final String SHELLY_BTNT_ONE_BUTTON = "one_button";
 132     public static final String SHELLY_BTNT_TWO_BUTTON = "dual_button";
 133     public static final String SHELLY_BTNT_TOGGLE = "toggle";
 134     public static final String SHELLY_BTNT_EDGE = "edge";
 135     public static final String SHELLY_BTNT_DETACHED = "detached";
 136
 137     public static final String SHELLY_STATE_LAST = "last";
 138     public static final String SHELLY_STATE_STOP = "stop";
 139
 140     public static final String SHELLY_INP_MODE_OPENCLOSE = "openclose";
 141     public static final String SHELLY_INP_MODE_ONEBUTTON = "onebutton";
 142
 143     public static final String SHELLY_OBSTMODE_DISABLED = "disabled";
 144     public static final String SHELLY_SAFETYM_WHILEOPENING = "while_opening";
 145
 146     public static final String SHELLY_ALWD_TRIGGER_NONE = "none";
 147     public static final String SHELLY_ALWD_ROLLER_TURN_OPEN = "open";
 148     public static final String SHELLY_ALWD_ROLLER_TURN_CLOSE = "close";
 149     public static final String SHELLY_ALWD_ROLLER_TURN_STOP = "stop";
 150
 151     // API Error Codes
 152     public static final String SHELLY_APIERR_UNAUTHORIZED = "Unauthorized";
 153     public static final String SHELLY_APIERR_TIMEOUT = "Timeout";
 154     public static final String SHELLY_APIERR_NOT_CALIBRATED = "Not calibrated!";
 155
 156     // API device types / properties
 157     public static final String SHELLY_CLASS_RELAY = "relay"; // Relay: relay mode
 158     public static final String SHELLY_CLASS_ROLLER = "roller"; // Relay: roller mode
 159     public static final String SHELLY_CLASS_LIGHT = "light"; // Bulb: color mode
 160     public static final String SHELLY_CLASS_EMETER = "emeter"; // EM/EM3: emeter
 161
 162     public static final String SHELLY_API_ON = "on";
 163     public static final String SHELLY_API_OFF = "off";
 164     public static final String SHELLY_API_TRUE = "true";
 165     public static final String SHELLY_API_FALSE = "false";
 166
 167     public static final String SHELLY_API_MODE = "mode";
 168     public static final String SHELLY_MODE_RELAY = "relay"; // Relay: relay mode
 169     public static final String SHELLY_MODE_ROLLER = "roller"; // Relay: roller mode
 170     public static final String SHELLY_MODE_COLOR = "color"; // Bulb/RGBW2: color mode
 171     public static final String SHELLY_MODE_WHITE = "white"; // Bulb/RGBW2: white mode
 172
 173     public static final String SHELLY_LED_STATUS_DISABLE = "led_status_disable";
 174     public static final String SHELLY_LED_POWER_DISABLE = "led_power_disable";
 175
 176     public static final String SHELLY_API_STOPR_NORMAL = "normal";
 177     public static final String SHELLY_API_STOPR_SAFETYSW = "safety_switch";
 178     public static final String SHELLY_API_STOPR_OBSTACLE = "obstacle";
 179     public static final String SHELLY_API_STOPR_OVERPOWER = "overpower";
 180
 181     public static final String SHELLY_TIMER_AUTOON = "auto_on";
 182     public static final String SHELLY_TIMER_AUTOOFF = "auto_off";
 183     public static final String SHELLY_TIMER_ACTIVE = "has_timer";
 184
 185     public static final String SHELLY_LIGHT_TURN = "turn";
 186     public static final String SHELLY_LIGHT_DEFSTATE = "def_state";
 187     public static final String SHELLY_LIGHTTIMER = "timer";
 188
 189     public static final String SHELLY_COLOR_RED = "red";
 190     public static final String SHELLY_COLOR_BLUE = "blue";
 191     public static final String SHELLY_COLOR_GREEN = "green";
 192     public static final String SHELLY_COLOR_YELLOW = "yellow";
 193     public static final String SHELLY_COLOR_WHITE = "white";
 194     public static final String SHELLY_COLOR_GAIN = "gain";
 195     public static final String SHELLY_COLOR_BRIGHTNESS = "brightness";
 196     public static final String SHELLY_COLOR_TEMP = "temp";
 197     public static final String SHELLY_COLOR_EFFECT = "effect";
 198
 199     public static final int SHELLY_MIN_ROLLER_POS = 0;
 200     public static final int SHELLY_MAX_ROLLER_POS = 100;
 201     public static final int SHELLY_MIN_BRIGHTNESS = 0;
 202     public static final int SHELLY_MAX_BRIGHTNESS = 100;
 203     public static final int SHELLY_MIN_GAIN = 0;
 204     public static final int SHELLY_MAX_GAIN = 100;
 205     public static final int SHELLY_MIN_COLOR = 0;
 206     public static final int SHELLY_MAX_COLOR = 255;
 207     public static final int SHELLY_DIM_STEPSIZE = 10;
 208
 209     // color temperature: 3000 = warm, 4750 = white, 6565 = cold; gain: 0..100
 210     public static final int MIN_COLOR_TEMP_BULB = 3000;
 211     public static final int MAX_COLOR_TEMP_BULB = 6500;
 212     public static final int MIN_COLOR_TEMP_DUO = 2700;
 213     public static final int MAX_COLOR_TEMP_DUO = 6500;
 214     public static final int COLOR_TEMP_RANGE_BULB = MAX_COLOR_TEMP_DUO - MIN_COLOR_TEMP_DUO;
 215     public static final int COLOR_TEMP_RANGE_DUO = MAX_COLOR_TEMP_DUO - MIN_COLOR_TEMP_DUO;
 216     public static final double MIN_BRIGHTNESS = 0.0;
 217     public static final double MAX_BRIGHTNESS = 100.0;
 218     public static final double SATURATION_FACTOR = 2.55;
 219     public static final double GAIN_FACTOR = SHELLY_MAX_GAIN / 100;
 220     public static final double BRIGHTNESS_FACTOR = SHELLY_MAX_BRIGHTNESS / 100;
 221
 222     // Door/Window
 223     public static final String SHELLY_API_ILLUM_DARK = "dark";
 224     public static final String SHELLY_API_ILLUM_TWILIGHT = "twilight";
 225     public static final String SHELLY_API_ILLUM_BRIGHT = "bright";
 226     public static final String SHELLY_API_DWSTATE_OPEN = "open";
 227     public static final String SHELLY_API_DWSTATE_CLOSE = "close";
 228
 229     // Shelly Sense
 230     public static final String SHELLY_IR_CODET_STORED = "stored";
 231     public static final String SHELLY_IR_CODET_PRONTO = "pronto";
 232     public static final String SHELLY_IR_CODET_PRONTO_HEX = "pronto_hex";
 233
 234     // Bulb/Duo/RGBW2
 235     public static final int SHELLY_MIN_EFFECT = 0;
 236     public static final int SHELLY_MAX_EFFECT = 6;
 237
 238     // Button
 239     public static final String SHELLY_BTNEVENT_1SHORTPUSH = "S";
 240     public static final String SHELLY_BTNEVENT_2SHORTPUSH = "SS";
 241     public static final String SHELLY_BTNEVENT_3SHORTPUSH = "SSS";
 242     public static final String SHELLY_BTNEVENT_LONGPUSH = "L";
 243     public static final String SHELLY_BTNEVENT_SHORTLONGPUSH = "SL";
 244     public static final String SHELLY_BTNEVENT_LONGSHORTPUSH = "LS";
 245
 246     public static final String SHELLY_TEMP_CELSIUS = "C";
 247     public static final String SHELLY_TEMP_FAHRENHEIT = "F";
 248
 249     // Motion
 250     public static final int SHELLY_MOTION_SLEEPTIME_OFFSET = 3; // we need to substract and offset
 251
 252     // TRV
 253     public static final int SHELLY_TRV_MIN_TEMP = 5; // < 5: means: lowest (valve fully closed)
 254     public static final int SHELLY_TRV_MAX_TEMP = 30; // > 30: means: highest (valve fully open)
 255
 256     public static final String SHELLY_TRV_MODE_MANUAL = "manual";
 257     public static final String SHELLY_TRV_MODE_AUTO = "automatic";
 258
 259     // CoIoT Multicast setting
 260     public static final String SHELLY_COIOT_MCAST = "mcast";
 261
 262     public static class ShellySettingsDevice {
 263         public String type;
 264         public String mode; // Gen 1
 265         public String id; // Gen2: service name
 266         public String name; // Gen2: configured device name
 267         public String profile; // Gen 2
 268         public String mac;
 269         public String hostname;
 270         public String fw;
 271         public Boolean auth;
 272         public Integer gen;
 273         public String coiot;
 274         public Integer longid;
 275
 276         @SerializedName("num_outputs")
 277         public Integer numOutputs;
 278         @SerializedName("num_meters")
 279         public Integer numMeters;
 280         @SerializedName("num_emeters")
 281         public Integer numEMeters;
 282         @SerializedName("num_rollers")
 283         public Integer numRollers;
 284     }
 285
 286     public static class ShellySettingsWiFiAp {
 287         public Boolean enabled;
 288         public String ssid;
 289         public String key;
 290         public Boolean rangeExtender; // Gen2 only
 291     }
 292
 293     public static class ShellySettingsWiFiNetwork {
 294         public Boolean enabled;
 295         public String ssid;
 296         public Integer rssi;
 297
 298         @SerializedName("ipv4_method")
 299         public String ipv4Method;
 300         public String ip;
 301         public String gw;
 302         public String mask;
 303         public String dns;
 304     }
 305
 306     public static class ShellySettingsMqtt {
 307         public Boolean enable;
 308         public String server;
 309         public String user;
 310         @SerializedName("reconnect_timeout_max")
 311         public Double reconnectTimeoutMax;
 312         @SerializedName("reconnect_timeout_min")
 313         public Double reconnectTimeoutMin;
 314         @SerializedName("clean_session")
 315         public Boolean cleanSession;
 316         @SerializedName("keep_alive")
 317         public Integer keepAlive;
 318         @SerializedName("will_topic")
 319         public String willTopic;
 320         @SerializedName("will_message")
 321         public String willMessage;
 322         @SerializedName("max_qos")
 323         public Integer maxQOS;
 324         public Boolean retain;
 325         @SerializedName("update_period")
 326         public Integer updatePeriod;
 327     }
 328
 329     public static class ShellySettingsCoiot { // FW 1.6+
 330         @SerializedName("update_period")
 331         public Integer updatePeriod;
 332         public Boolean enabled; // Motion 1.0.7: Coap can be disabled
 333         public String peer; // if set the device uses singlecast CoAP, mcast=set back to Multicast
 334     }
 335
 336     public static class ShellyStatusMqtt {
 337         public Boolean connected;
 338     }
 339
 340     public static class ShellySettingsSntp {
 341         public String server;
 342         public Boolean enabled;
 343     }
 344
 345     public static class ShellySettingsLogin {
 346         public Boolean enabled;
 347         public Boolean unprotected;
 348         public String username;
 349         public String password;
 350     }
 351
 352     public static class ShellySettingsBuildInfo {
 353         @SerializedName("build_id")
 354         public String buildId;
 355         @SerializedName("build_timestamp")
 356         public String buildTimestamp;
 357         @SerializedName("build_version")
 358         public String buildVersion;
 359     }
 360
 361     public static class ShellyStatusCloud {
 362         public Boolean enabled;
 363         public Boolean connected;
 364     }
 365
 366     public static class ShellySettingsHwInfo {
 367         @SerializedName("hw_revision")
 368         public String hwRevision;
 369         @SerializedName("batch_id")
 370         public Integer batchId;
 371     }
 372
 373     public static class ShellySettingsScheduleRules {
 374     }
 375
 376     public static class ShellySettingsRelay {
 377         public String name;
 378         @SerializedName("default_state")
 379         public String defaultState; // Accepted values: off, on, last, switch
 380         @SerializedName("btn_type")
 381         public String btnType; // Accepted values: momentary, toggle, edge, detached - // see SHELLY_BTNT_xxx
 382         @SerializedName("btn1_type") // Shelly 1L
 383         public String btnType1;
 384         @SerializedName("btn2_type") // Shelly 1L
 385         public String btnType2;
 386         @SerializedName("has_timer")
 387         public Boolean hasTimer; // Whether a timer is currently armed for this channel
 388         @SerializedName("auto_on")
 389         public Double autoOn; // Automatic flip back timer, seconds. Will engage after turning Shelly1 OFF.
 390         @SerializedName("auto_off")
 391         public Double autoOff; // Automatic flip back timer, seconds. Will engage after turning Shelly1 ON.
 392         @SerializedName("btn_on_url")
 393         public String btnOnUrl; // input is activated
 394         @SerializedName("btnOffUrl")
 395         public String btnOffUrl; // input is deactivated
 396         @SerializedName("out_on_url")
 397         public String outOnUrl; // output is activated
 398         @SerializedName("out_off_url")
 399         public String outOffUrl; // output is deactivated
 400         @SerializedName("roller_open_url")
 401         public String rollerOpenUrl; // to access when roller reaches open position
 402         @SerializedName("roller_close_url")
 403         public String rollerCloseUrl; // to access when roller reaches close position
 404         @SerializedName("roller_stop_url")
 405         public String rollerStopUrl; // to access when roller stopped
 406         @SerializedName("longpush_url")
 407         public String pushLongUrl; // to access when roller stopped
 408         @SerializedName("shortpush_url")
 409         public String pushShortUrl; // to access when roller stopped
 410
 411         // Status information
 412         public Integer id;
 413         public Boolean ison;
 414         public Boolean overpower;
 415         @SerializedName("is_valid")
 416         public Boolean isValid;
 417     }
 418
 419     public static class ShellySettingsDimmer {
 420         public String name; // unique name of the device
 421         public Boolean ison; // true: output is ON
 422         @SerializedName("default_state")
 423         public String defaultState; // Accepted values: off, on, last, switch
 424         @SerializedName("auto_on")
 425         public Double autoOn; // Automatic flip back timer, seconds. Will engage after turning Shelly1 OFF.
 426         @SerializedName("auto_off")
 427         public Double autoOff; // Automatic flip back timer, seconds. Will engage after turning Shelly1 ON.
 428         @SerializedName("btn1_on_url")
 429         public String btn1OnUrl; // URL to access when SW input is activated
 430         @SerializedName("btn1_off_url")
 431         public String btn1OffUrl; // URL to access when SW input is deactivated
 432         @SerializedName("btn2_on_url")
 433         public String btn2OnUrl; // URL to access when SW input is activated
 434         @SerializedName("btn2_off_url")
 435         public String btn2OoffUrl; // URL to access when SW input is deactivated
 436         @SerializedName("out_on_url")
 437         public String outOnUrl; // URL to access when output is activated
 438         @SerializedName("out_off_url")
 439         public String outOffUrl; // URL to access when output is deactivated
 440         @SerializedName("longpush_url")
 441         public String pushLongUrl; // long push button event
 442         @SerializedName("shortpush_url")
 443         public String pushShortUrl; // short push button event
 444         @SerializedName("btn_type")
 445         public String btnType; // Accepted values: momentary, toggle, edge, detached - // see SHELLY_BTNT_xxx
 446         @SerializedName("btn1_type")
 447         public String btnType1; // Accepted values: momentary, toggle, edge, detached - // see SHELLY_BTNT_xxx
 448         @SerializedName("btn2_type")
 449         public String btnType2; // Accepted values: momentary, toggle, edge, detached - // see SHELLY_BTNT_xxx
 450         @SerializedName("swap_inputs")
 451         public Integer swapInputs; // 0=no
 452     }
 453
 454     public static class ShellySettingsRoller {
 455         public Double maxtime;
 456         @SerializedName("maxtime_open")
 457         public Double maxtimeOpen;
 458         @SerializedName("maxtime_close")
 459         public Double maxtimeClose;
 460         @SerializedName("default_state")
 461         public String defaultState; // see SHELLY_STATE_xxx
 462         public Boolean swap;
 463         @SerializedName("swap_inputs")
 464         public Boolean swapInputs;
 465         @SerializedName("input_mode")
 466         public String inputMode; // see SHELLY_INP_MODE_OPENCLOSE
 467         @SerializedName("button_type")
 468         public String buttonType; // // see SHELLY_BTNT_xxx
 469         @SerializedName("btn_Reverse")
 470         public Integer btnReverse;
 471         public String state;
 472         public Double power;
 473         @SerializedName("is_valid")
 474         public Boolean isValid;
 475         @SerializedName("safety_switch")
 476         public Boolean safetySwitch;
 477         @SerializedName("obstacle_mode")
 478         public String obstaclMode; // SHELLY_OBSTMODE_
 479         @SerializedName("obstacle_action")
 480         public String obstacleAction; // see SHELLY_STATE_xxx
 481         @SerializedName("obstacle_power")
 482         public Integer obstaclePower;
 483         @SerializedName("obstacle_delay")
 484         public Integer obstacleDelay;
 485         @SerializedName("safety_mode")
 486         public String safetyMode; // see SHELLY_SAFETYM_xxx
 487         @SerializedName("safety_action")
 488         public String safetyAction; // see SHELLY_STATE_xxx
 489         @SerializedName("safety_allowed_on_trigger")
 490         public String safetyAllowedOnTrigger; // see SHELLY_ALWD_TRIGGER_xxx
 491         @SerializedName("off_power")
 492         public Integer offPower;
 493         public Boolean positioning;
 494     }
 495
 496     public static class ShellySettingsRgbwLight {
 497         public String name;
 498         public Boolean ison; // true: output is ON
 499         public Integer brightness;
 500         public Integer temp;
 501         public Integer transition;
 502         @SerializedName("default_state")
 503         public String defaultState;
 504         @SerializedName("auto_on")
 505         public Double autoOn; // Automatic flip back timer, seconds. Will engage after turning Shelly1 OFF.
 506         @SerializedName("auto_off")
 507         public Double autoOff; // Automatic flip back timer, seconds. Will engage after turning Shelly1 ON.
 508         public Boolean schedule;
 509         @SerializedName("btn_type")
 510         public String btnType; // Accepted values: momentary, toggle, edge, detached - // see SHELLY_BTNT_xxx
 511         @SerializedName("btn_reverse")
 512         public Integer btnReverse; // Accepted values: momentary, toggle, edge, detached - // see SHELLY_BTNT_xxx
 513         @SerializedName("out_on_url")
 514         public String outOnUrl; // output is activated
 515         @SerializedName("out_off_url")
 516         public String outOffUrl; // output is deactivated
 517     }
 518
 519     public static class ShellyFavPos { // FW 1.9.2+ in roller mode
 520         public String name;
 521         public Integer pos;
 522     }
 523
 524     public static class ShellyInputState {
 525         public Integer input;
 526
 527         // Shelly Button
 528         public String event;
 529         @SerializedName("event_cnt")
 530         public Integer eventCount;
 531     }
 532
 533     public static class ShellySettingsMeter {
 534         @SerializedName("is_valid")
 535         public Boolean isValid;
 536         public Double power;
 537         public Double[] counters = { 0.0, 0.0, 0.0 };
 538         public Double total;
 539         public Long timestamp;
 540     }
 541
 542     public static class ShellySettingsEMeter { // ShellyEM meter
 543         @SerializedName("is_valid")
 544         public Boolean isValid; // Whether the associated meter is functioning properly
 545         public Double power; // Instantaneous power, Watts
 546         public Double reactive; // Instantaneous reactive power, Watts
 547         public Double voltage; // RMS voltage, Volts
 548         public Double total; // Total consumed energy, Wh
 549         @SerializedName("total_returned")
 550         public Double totalReturned; // Total returned energy, Wh
 551
 552         public Double pf; // 3EM
 553         public Double current; // 3EM
 554     }
 555
 556     public static class ShellySettingsUpdate {
 557         public String status;
 558         @SerializedName("has_update")
 559         public Boolean hasUpdate;
 560         @SerializedName("new_version")
 561         public String newVersion;
 562         @SerializedName("old_version")
 563         public String oldVersion;
 564         @SerializedName("beta_version")
 565         public String betaVersion;
 566     }
 567
 568     public static class ShellySettingsGlobal {
 569         // https://shelly-api-docs.shelly.cloud/#shelly1pm-settings
 570         @SerializedName("wifi_ap")
 571         public ShellySettingsWiFiAp wifiAp = new ShellySettingsWiFiAp();
 572         @SerializedName("wifi_sta")
 573         public ShellySettingsWiFiNetwork wifiSta = new ShellySettingsWiFiNetwork();
 574         @SerializedName("wifi_sta1")
 575         public ShellySettingsWiFiNetwork wifiSta1 = new ShellySettingsWiFiNetwork();
 576         @SerializedName("wifirecovery_reboot_enabled")
 577         public Boolean wifiRecoveryReboot; // FW 1.10+
 578         @SerializedName("ap_roaming")
 579         public ShellyApRoaming apRoaming; // FW 1.10+
 580
 581         public ShellySettingsMqtt mqtt = new ShellySettingsMqtt();
 582         public ShellySettingsSntp sntp = new ShellySettingsSntp();
 583         public ShellySettingsCoiot coiot = new ShellySettingsCoiot();
 584         public ShellySettingsLogin login = new ShellySettingsLogin();
 585         @SerializedName("pin_code")
 586         public String pinCode;
 587         @SerializedName("coiot_execute_enable")
 588         public Boolean coiotExecuteEnable;
 589         public String name;
 590         public Boolean discoverable; // FW 1.6+
 591         public String fw;
 592         @SerializedName("build_info")
 593         public ShellySettingsBuildInfo buildInfo = new ShellySettingsBuildInfo();
 594         public ShellyStatusCloud cloud = new ShellyStatusCloud();
 595         @SerializedName("sleep_mode")
 596         public ShellySensorSleepMode sleepMode; // FW 1.6
 597         @SerializedName("external_power")
 598         public Integer externalPower; // H&T FW 1.6, seems to be the same like charger for the Sense
 599         @SerializedName("debug_enable") // FW 1.10+
 600         public Boolean debugEnable;
 601
 602         public String timezone;
 603         public Double lat;
 604         public Double lng;
 605         public Boolean tzautodetect;
 606         public String time;
 607
 608         public ShellySettingsHwInfo hwinfo;
 609         public String mode;
 610         @SerializedName("max_power")
 611         public Double maxPower;
 612         public Boolean calibrated;
 613
 614         public Double voltage; // AC voltage for Shelly 2.5
 615         @SerializedName("supply_voltage")
 616         public Long supplyVoltage; // Shelly 1PM/1L: 0=110V, 1=220V
 617
 618         public @Nullable ArrayList<ShellySettingsRelay> relays;
 619         public @Nullable ArrayList<ShellySettingsInput> inputs; // ix3
 620         public @Nullable ArrayList<ShellySettingsDimmer> dimmers;
 621         public @Nullable ArrayList<ShellySettingsRoller> rollers;
 622         public @Nullable ArrayList<ShellySettingsRgbwLight> lights;
 623         public @Nullable ArrayList<ShellySettingsEMeter> emeters;
 624         public @Nullable ArrayList<ShellyThermnostat> thermostats; // TRV
 625
 626         @SerializedName("ext_switch_enable")
 627         public Boolean externalSwitchEnable;
 628         @SerializedName("ext_switch")
 629         public ShellyStatusSensor.ShellyExtSwitchSettings extSwitch;
 630         @SerializedName("ext_temperature")
 631         public ShellyStatusSensor.ShellyExtTemperature extTemperature; // Shelly 1/1PM: sensor values
 632         @SerializedName("ext_humidity")
 633         public ShellyStatusSensor.ShellyExtHumidity extHumidity; // Shelly 1/1PM: sensor values
 634         public ShellyStatusSensor.ShellyExtVoltage extVoltage; // Shelly ´Plus 1/1PM: sensor values
 635         public ShellyStatusSensor.ShellyExtAnalogInput extAnalogInput; // Shelly ´Plus 1/1PM: sensor values
 636         public ShellyStatusSensor.ShellyExtDigitalInput extDigitalInput; // Shelly ´Plus 1/1PM: state of digital input
 637
 638         @SerializedName("temperature_units")
 639         public String temperatureUnits = "C"; // Either'C'or'F'
 640
 641         @SerializedName("led_status_disable")
 642         public Boolean ledStatusDisable; // PlugS only Disable LED indication for network
 643                                          // status
 644         @SerializedName("led_power_disable")
 645         public Boolean ledPowerDisable; // PlugS only Disable LED indication for network
 646                                         // status
 647         @SerializedName("light_sensor")
 648         public String lightSensor; // Sense: sensor type
 649         @SerializedName("rain_sensor")
 650         public Boolean rainSensor; // Flood: true=in rain mode
 651
 652         // FW 1.5.7: Door Window
 653         @SerializedName("dark_treshold")
 654         public Integer darkTreshold; // Illumination definition for "dark" in lux
 655         @SerializedName("twilight_treshold")
 656         public Integer twiLightTreshold; // Illumination definition for "twilight" in lux
 657         @SerializedName("dark_url")
 658         public String darkUrl; // URL to report to when luminance <= dark_threshold
 659         @SerializedName("twilight_url")
 660         public String twiLightUrl; // URL reports when luminance > dark_threshold AND luminance <=
 661         @SerializedName("close_url")
 662         public String closeUrl; // URL reports when DW contact is closed FW 1.6.5+
 663         @SerializedName("vibration_url")
 664         public String vibrationUrl; // URL reports when DW detects vibration FW 1.6.5+
 665
 666         // Gas FW 1.7
 667         @SerializedName("set_volume")
 668         public Integer volume; // Speaker volume for alarm
 669         @SerializedName("alarm_off_url")
 670         public String alarmOffUrl; // URL reports when alarm went off
 671         @SerializedName("alarm_mild_url")
 672         public String alarmMidUrl; // URL reports middle alarm
 673         @SerializedName("alarm_heavy_url")
 674         public String alarmHeavyfUrl; // URL reports heavy alarm
 675
 676         // Roller with FW 1.9.2+
 677         @SerializedName("favorites_enabled")
 678         public Boolean favoritesEnabled = false;
 679         public ArrayList<ShellyFavPos> favorites;
 680
 681         // Motion
 682         public ShellyMotionSettings motion;
 683         @SerializedName("tamper_sensitivity")
 684         public Integer tamperSensitivity;
 685         @SerializedName("dark_threshold")
 686         public Integer darkThreshold;
 687         @SerializedName("twilight_threshold")
 688         public Integer twilightThreshold;
 689
 690         @SerializedName("sleep_time") // Shelly Motion
 691         public Integer sleepTime;
 692
 693         // Gen2
 694         public Boolean ethernet;
 695         public Boolean bluetooth;
 696     }
 697
 698     public static class ShellySettingsAttributes {
 699         @SerializedName("device_type")
 700         public String deviceType; // Device model identifier
 701         @SerializedName("device_mac")
 702         public String deviceMac; // MAC address of the device in hexadecimal
 703         @SerializedName("wifi_ap")
 704         public String wifiAp; // WiFi access poInteger configuration, see /settings/ap for details
 705         @SerializedName("wifi_sta")
 706         public String wifiSta; // WiFi client configuration. See /settings/sta for details
 707         public String login; // credentials used for HTTP Basic authentication for the REST interface. If
 708                              // enabled is true clients must include an Authorization: Basic ... HTTP header with valid
 709                              // credentials when performing TP requests.
 710         public String name; // unique name of the device.
 711         public String fw; // current FW version
 712     }
 713
 714     public static class ShellyActionsStats {
 715         public Integer skipped;
 716     }
 717
 718     public static class ShellySettingsStatus {
 719         public String name; // FW 1.8: Symbolic Device name is configurable
 720
 721         @SerializedName("wifi_sta")
 722         public ShellySettingsWiFiNetwork wifiSta = new ShellySettingsWiFiNetwork(); // WiFi client configuration. See
 723                                                                                     // /settings/sta for details
 724         public ShellyStatusCloud cloud = new ShellyStatusCloud();
 725         public ShellyStatusMqtt mqtt = new ShellyStatusMqtt();
 726
 727         public String time;
 728         public Integer serial = -1;
 729         @SerializedName("has_update")
 730         public Boolean hasUpdate;
 731         public String mac;
 732         public Boolean discoverable; // FW 1.6+
 733         @SerializedName("cfg_changed_cnt")
 734         public Integer cfgChangedCount; // FW 1.8
 735         @SerializedName("actions_stats")
 736         public ShellyActionsStats astats;
 737
 738         public ArrayList<ShellySettingsRelay> relays;
 739         public Double voltage; // Shelly 2.5
 740         public Integer input; // RGBW2 has no JSON array
 741         public ArrayList<ShellyInputState> inputs;
 742         public ArrayList<ShellyShortLightStatus> dimmers;
 743         public ArrayList<ShellyRollerStatus> rollers;
 744         public ArrayList<ShellySettingsLight> lights;
 745         public ArrayList<ShellySettingsMeter> meters;
 746
 747         public ArrayList<ShellySettingsEMeter> emeters;
 748         public Double totalCurrent;
 749         public Double totalPower;
 750         public Double totalReturned;
 751
 752         @SerializedName("ext_temperature")
 753         public ShellyStatusSensor.ShellyExtTemperature extTemperature; // Shelly 1/1PM: sensor values
 754         @SerializedName("ext_humidity")
 755         public ShellyStatusSensor.ShellyExtHumidity extHumidity; // Shelly 1/1PM: sensor values
 756         public ShellyStatusSensor.ShellyExtVoltage extVoltage; // Shelly ´Plus 1/1PM: sensor values
 757         public ShellyStatusSensor.ShellyExtAnalogInput extAnalogInput; // Shelly ´Plus 1/1PM: sensor values
 758         public ShellyStatusSensor.ShellyExtDigitalInput extDigitalInput; // Shelly ´Plus 1/1PM: sensor values
 759         @SerializedName("ext_switch")
 760         public ShellyStatusSensor.ShellyExtSwitchStatus extSwitch;
 761
 762         // Internal device temp
 763         public ShellySensorTmp tmp; // Shelly 1PM
 764         public Double temperature; // Shelly 2.5
 765         public Boolean overtemperature;
 766
 767         // Shelly Dimmer only
 768         public Boolean loaderror;
 769         public Boolean overload;
 770
 771         // Shelly TRV
 772         public Boolean calibrated;
 773         public ArrayList<ShellyThermnostat> thermostats;
 774
 775         public ShellySettingsUpdate update = new ShellySettingsUpdate();
 776         @SerializedName("ram_total")
 777         public Long ramTotal;
 778         @SerializedName("ram_free")
 779         public Long ramFree;
 780         @SerializedName("fs_size")
 781         public Long fsSize;
 782         @SerializedName("fs_free")
 783         public Long fsFree;
 784         public Long uptime;
 785
 786         @SerializedName("sleep_time") // Shelly Motion
 787         public Integer sleepTime;
 788
 789         public String json;
 790     }
 791
 792     public static class ShellySettingsInput {
 793         @SerializedName("btn_type")
 794         public String btnType;
 795     }
 796
 797     public static class ShellyControlRelay {
 798         // https://shelly-api-docs.shelly.cloud/#shelly1-1pm-settings-relay-0
 799         @SerializedName("is_valid")
 800         public Boolean isValid;
 801         @SerializedName("has_timer")
 802         public Boolean hasTimer; // Whether a timer is currently armed for this channel
 803         @SerializedName("timer_remaining")
 804         public Integer timerRemaining; // FW 1.6+
 805         public Boolean overpower; // Shelly1PM only if maximum allowed power was exceeded
 806
 807         public String turn; // Accepted values are on and off. This will turn ON/OFF the respective output
 808                             // channel when request is sent .
 809         public Integer timer; // A one-shot flip-back timer in seconds.
 810     }
 811
 812     public static class ShellyShortStatusRelay {
 813         public String name; // FW 1.8+: Channel could now have a logical name
 814         @SerializedName("is_valid")
 815         public Boolean isValid;
 816         public Boolean ison; // Whether output channel is on or off
 817         @SerializedName("has_timer")
 818         public Boolean hasTimer; // Whether a timer is currently armed for this channel
 819         @SerializedName("timer_remaining")
 820         public Integer timerRemaining;
 821         public Boolean overpower; // Shelly1PM only if maximum allowed power was exceeded
 822         public Double temperature; // Internal device temperature
 823         public Boolean overtemperature; // Device over heated
 824     }
 825
 826     public static class ShellyShortLightStatus {
 827         public Boolean ison; // Whether output channel is on or off
 828         public String mode; // color or white - valid only for Bulb and RGBW2 even Dimmer returns it also
 829         public Integer brightness; // brightness: 0.100%
 830         @SerializedName("has_timer")
 831         public Boolean hasTimer;
 832         @SerializedName("timer_duration")
 833         public Integer timerDuration;
 834     }
 835
 836     public static class ShellyStatusRelay {
 837         public String name; // FW 1.8: Symbolic channel name is configurable
 838
 839         @SerializedName("wifi_sta")
 840         public ShellySettingsWiFiNetwork wifiSta; // WiFi status
 841         public ShellySettingsCoiot coiot; // Firmware 1.6+
 842         public Integer serial;
 843         public String mac; // MAC
 844         public ArrayList<ShellyShortStatusRelay> relays; // relay status
 845         public ArrayList<ShellySettingsMeter> meters; // current meter value
 846         public ArrayList<ShellyInputState> inputs; // Firmware 1.5.6+
 847
 848         @SerializedName("ext_temperature")
 849         public ShellyStatusSensor.ShellyExtTemperature extTemperature; // Shelly 1/1PM: sensor values
 850         @SerializedName("ext_humidity")
 851         public ShellyStatusSensor.ShellyExtHumidity extHumidity; // Shelly 1/1PM: sensor values
 852
 853         public Double temperature; // device temp acc. on the selected temp unit
 854         public ShellySensorTmp tmp;
 855     }
 856
 857     public static class ShellyStatusDimmer {
 858         @SerializedName("wifi_sta")
 859         public ShellySettingsWiFiNetwork wifiSta; // WiFi status
 860         public ArrayList<ShellyShortLightStatus> lights; // relay status
 861         public ArrayList<ShellySettingsMeter> meters; // current meter value
 862
 863         public ShellySensorTmp tmp;
 864         public Boolean overtemperature;
 865
 866         public Boolean loaderror;
 867         public Boolean overload;
 868     }
 869
 870     public static class ShellyRollerStatus {
 871         public String name; // FW 1.8: Symbolic name is configurable
 872
 873         @SerializedName("roller_pos")
 874         public Integer rollerPos; // number Desired position in percent
 875         public Integer duration; // If specified, the motor will move for this period in seconds. If missing, the
 876                                  // value of maxtime in /settings/roller/N will be used.
 877         public String state; // One of stop, open, close
 878         public Double power; // Current power consumption in Watts
 879         @SerializedName("is_valid")
 880         public Boolean isValid; // If the power meter functions properly
 881         @SerializedName("safety_switch")
 882         public Boolean safetySwitch; // Whether the safety input is currently triggered
 883         public Boolean overtemperature;
 884         @SerializedName("stop_reason")
 885         public String stopReason; // Last cause for stopping: normal, safety_switch, obstacle
 886         @SerializedName("last_direction")
 887         public String lastDirection; // Last direction of motion, open or close
 888         public Boolean calibrating;
 889         public Boolean positioning; // true when calibration was performed
 890         @SerializedName("current_pos")
 891         public Integer currentPos; // current position 0..100, 100=open
 892     }
 893
 894     public static class ShellyOtaCheckResult {
 895         public String status;
 896     }
 897
 898     public static class ShellyApRoaming {
 899         public Boolean enabled;
 900         public Integer threshold;
 901     }
 902
 903     public static class ShellySensorSleepMode {
 904         public Integer period;
 905         public String unit;
 906     }
 907
 908     // Shelly TRV
 909     public class ShellyThermnostat {
 910         public class ShellyThermTargetTemp {
 911             public Boolean enabled;
 912             public Double value;
 913             public String unit;
 914         }
 915
 916         public class ShellyThermTemp {
 917             public Double value;
 918             public String units;
 919             @SerializedName("is_valid")
 920             public Boolean isValid;
 921         }
 922
 923         public Double pos;
 924         @SerializedName("target_t")
 925         public ShellyThermTargetTemp targetTemp;
 926         public Boolean schedule;
 927         @SerializedName("schedule_profile")
 928         public Integer profile;
 929         @SerializedName("schedule_profile_names")
 930         public String[] profileNames;
 931         public ShellyThermTemp tmp;
 932         @SerializedName("boost_minutes")
 933         public Integer boostMinutes;
 934         @SerializedName("window_open")
 935         public Boolean windowOpen;
 936     }
 937
 938     public static class ShellySensorTmp {
 939         public Double value; // Temperature in configured unites
 940         public String units; // 'C' or 'F'
 941         public Double tC; // temperature in deg C
 942         public Double tF; // temperature in deg F
 943         @SerializedName("is_valid")
 944         public Boolean isValid; // whether the internal sensor is operating properly
 945     }
 946
 947     public static class ShellyStatusSensor {
 948         // https://shelly-api-docs.shelly.cloud/#h-amp-t-settings
 949
 950         public static class ShellySensorHum {
 951             public Double value; // relative humidity in %
 952         }
 953
 954         public static class ShellySensorBat {
 955             public Double value; // estimated remaining battery capacity in %
 956             public Double voltage; // battery voltage
 957         };
 958
 959         // Door/Window sensor
 960         public static class ShellySensorState {
 961             @SerializedName("is_valid")
 962             public Boolean isValid; // whether the internal sensor is operating properly
 963             public String state; // Shelly Door/Window
 964
 965             // Shelly Motion
 966             public Boolean motion;
 967             public Boolean vibration;
 968             @SerializedName("timestamp")
 969             public Long motionTimestamp;
 970             @SerializedName("active")
 971             public Boolean motionActive;
 972         }
 973
 974         public static class ShellySensorLux {
 975             @SerializedName("is_valid")
 976             public Boolean isValid; // whether the internal sensor is operating properly
 977             public Double value;
 978
 979             public String illumination;
 980         }
 981
 982         public static class ShellySensorAccel {
 983             public Integer tilt; // Tilt in °
 984             public Integer vibration; // Whether vibration is detected
 985         }
 986
 987         public static class ShellyMotionSettings {
 988             public Integer sensitivity;
 989             @SerializedName("blind_time_minutes")
 990             public Integer blindTimeMinutes;
 991             @SerializedName("pulse_count")
 992             public Integer pulseCount;
 993             @SerializedName("operating_mode")
 994             public Integer operatingMode;
 995             public Boolean enabled;
 996         }
 997
 998         public static class ShellyExtTemperature {
 999             public static class ShellyShortTemp {
1000                 public String hwID; // e.g. "2882379497020381",
1001                 public Double tC; // temperature in deg C
1002                 public Double tF; // temperature in deg F
1003             }
1004
1005             // Shelly 1/1PM have up to 3 sensors
1006             // for whatever reasons it's not an array, but 3 independent elements
1007             @SerializedName("0")
1008             public ShellyShortTemp sensor1;
1009             @SerializedName("1")
1010             public ShellyShortTemp sensor2;
1011             @SerializedName("2")
1012             public ShellyShortTemp sensor3;
1013             @SerializedName("3")
1014             public ShellyShortTemp sensor4;
1015             @SerializedName("4")
1016             public ShellyShortTemp sensor5;
1017         }
1018
1019         public static class ShellyExtHumidity {
1020             public static class ShellyShortHum {
1021                 public Double hum; // Humidity reading of sensor 0, percent
1022             }
1023
1024             public ShellyExtHumidity() {
1025             }
1026
1027             public ShellyExtHumidity(double hum) {
1028                 sensor1 = new ShellyShortHum();
1029                 sensor1.hum = hum;
1030             }
1031
1032             @SerializedName("0")
1033             public ShellyShortHum sensor1;
1034         }
1035
1036         public static class ShellyExtVoltage {
1037             public static class ShellyShortVoltage {
1038                 public Double voltage;
1039             }
1040
1041             public ShellyExtVoltage() {
1042             }
1043
1044             public ShellyExtVoltage(double voltage) {
1045                 sensor1 = new ShellyShortVoltage();
1046                 sensor1.voltage = voltage;
1047             }
1048
1049             @SerializedName("0")
1050             public ShellyShortVoltage sensor1;
1051         }
1052
1053         public static class ShellyExtDigitalInput {
1054             public static class ShellyShortDigitalInput {
1055                 public Boolean state;
1056             }
1057
1058             public ShellyExtDigitalInput() {
1059             }
1060
1061             public ShellyExtDigitalInput(boolean state) {
1062                 sensor1 = new ShellyShortDigitalInput();
1063                 sensor1.state = state;
1064             }
1065
1066             @SerializedName("0")
1067             public ShellyShortDigitalInput sensor1;
1068         }
1069
1070         public static class ShellyExtAnalogInput {
1071             public static class ShellyShortAnalogInput {
1072                 public Double percent;
1073             }
1074
1075             public ShellyExtAnalogInput() {
1076             }
1077
1078             public ShellyExtAnalogInput(double percent) {
1079                 sensor1 = new ShellyShortAnalogInput();
1080                 sensor1.percent = percent;
1081             }
1082
1083             @SerializedName("0")
1084             public ShellyShortAnalogInput sensor1;
1085         }
1086
1087         public static class ShellyADC {
1088             public Double voltage;
1089         }
1090
1091         public static class ShellyExtSwitchSettings {
1092             public static class ShellyExtSwitchSettingsInput {
1093                 @SerializedName("relay_num")
1094                 public Integer relayNum;
1095             }
1096
1097             @SerializedName("0")
1098             public ShellyExtSwitchSettingsInput input0;
1099         }
1100
1101         public static class ShellyExtSwitchStatus {
1102             public static class ShellyExtSwitchStatusInput {
1103                 public Integer input;
1104             }
1105
1106             @SerializedName("0")
1107             public ShellyExtSwitchStatusInput input0;
1108         }
1109
1110         public ShellySensorTmp tmp;
1111         public ShellySensorHum hum;
1112         public ShellySensorLux lux;
1113         public ShellySensorAccel accel;
1114         public ShellySensorBat bat;
1115         @SerializedName("sensor")
1116         public ShellySensorState sensor;
1117         public Boolean smoke; // SHelly Smoke
1118         public Boolean flood; // Shelly Flood: true = flood condition detected
1119         public Boolean mute; // mute enabled/disabled
1120         @SerializedName("rain_sensor")
1121         public Boolean rainSensor; // Shelly Flood: true=in rain mode
1122
1123         public Boolean motion; // Shelly Sense: true=motion detected
1124         public Boolean charger; // Shelly Sense, TRV: true=charger connected
1125
1126         @SerializedName("act_reasons")
1127         public List<Object> actReasons; // HT/Smoke/Flood: list of reasons which woke up the device
1128
1129         @SerializedName("sensor_error")
1130         public String sensorError; // 1.5.7: Only displayed in case of error
1131
1132         // FW 1.7: Shelly Gas
1133         @SerializedName("gas_sensor")
1134         public ShellyStatusGasSensor gasSensor;
1135         @SerializedName("concentration")
1136         public ShellyStatusGasConcentration concentration;
1137         public ArrayList<ShellyStatusValve> valves;
1138
1139         // FW 1.7 Button
1140         @SerializedName("connect_retries")
1141         public Integer connectRetries;
1142         public ArrayList<ShellyInputState> inputs; // Firmware 1.5.6+
1143
1144         // Shelly UNI FW 1.9+
1145         public ArrayList<ShellyADC> adcs;
1146
1147         // Shelly TRV
1148         public Boolean calibrated;
1149         public ArrayList<ShellyThermnostat> thermostats;
1150     }
1151
1152     public static class ShellySettingsSmoke {
1153         @SerializedName("temperature_units")
1154         public String temperatureUnits; // Either 'C' or 'F'
1155         @SerializedName("temperature_threshold")
1156         public Integer temperatureThreshold; // Temperature delta (in configured degree units) which triggers an update
1157         @SerializedName("sleep_mode_period")
1158         public Integer sleepModePeriod; // Periodic update period in hours, between 1 and 24
1159     }
1160
1161     // Shelly Gas
1162     // "gas_sensor":{"sensor_state":"normal","self_test_state":"not_completed","alarm_state":"none"},
1163     // "concentration":{"ppm":0,"is_valid":true},
1164     public static class ShellyStatusGasSensor {
1165         @SerializedName("sensor_state")
1166         public String sensorState;
1167         @SerializedName("self_test_state")
1168         public String selfTestState;
1169         @SerializedName("alarm_state")
1170         public String alarmState;
1171     }
1172
1173     public static class ShellyStatusGasConcentration {
1174         public Integer ppm;
1175         @SerializedName("is_valid")
1176         public Boolean isValid;
1177     }
1178
1179     public static class ShellyStatusValve {
1180         public String state; // closed/opened/not_connected/failure/closing/opening/checking
1181     }
1182
1183     public static class ShellySettingsLight {
1184         public Integer red; // red brightness, 0..255, applies in mode="color"
1185         public Integer green; // green brightness, 0..255, applies in mode="color"
1186         public Integer blue; // blue brightness, 0..255, applies in mode="color"
1187         public Integer white; // white brightness, 0..255, applies in mode="color"
1188         public Integer gain; // gain for all channels, 0..100, applies in mode="color"
1189         public Integer temp; // color temperature in K, 3000..6500, applies in mode="white"
1190         public Integer brightness; // brightness, 0..100, applies in mode="white"
1191         public Integer effect; // Currently applied effect, description: 0: Off, 1: Meteor Shower, 2: Gradual
1192                                // Change, 3: Breath,
1193                                // 4: Flash, 5: On/Off Gradual, 6: Red/Green Change
1194         @SerializedName("default_state")
1195         public String defaultState; // one of on, off or last
1196         @SerializedName("auto_on")
1197         public Double autoOn; // see above
1198         @SerializedName("auto_off")
1199         public Double autoOff; // see above
1200
1201         public Integer dcpower; // RGW2:Set to true for 24 V power supply, false for 12 V
1202
1203         // Shelly Dimmer
1204         public String mode;
1205         public Boolean ison;
1206     }
1207
1208     public static class ShellySettingsNightMode { // FW1.5.7+
1209         public Integer enabled;
1210         @SerializedName("start_time")
1211         public String startTime;
1212         @SerializedName("end_time")
1213         public String endTime;
1214         public Integer brightness;
1215     }
1216
1217     public static class ShellyStatusLightChannel {
1218         public Boolean ison;
1219         public Double power;
1220         public Boolean overpower;
1221         @SerializedName("has_timer")
1222         public Boolean hasTimer;
1223         @SerializedName("timer_started")
1224         public Integer timerStarted;
1225         @SerializedName("timer_duration")
1226         public Integer timerDuration;
1227         @SerializedName("timer_remaining")
1228         public Integer timerRemaining;
1229
1230         public Integer red; // red brightness, 0..255, applies in mode="color"
1231         public Integer green; // green brightness, 0..255, applies in mode="color"
1232         public Integer blue; // blue brightness, 0..255, applies in mode="color"
1233         public Integer white; // white brightness, 0..255, applies in mode="color"
1234         public Integer gain; // gain for all channels, 0..100, applies in mode="color"
1235         public Integer temp; // color temperature in K, 3000..6500, applies in mode="white"
1236         public Integer brightness; // brightness, 0..100, applies in mode="white"
1237         public Integer effect; // Currently applied effect, description: 0: Off, 1: Meteor Shower, 2: Gradual
1238                                // Change, 3: Breath,
1239     }
1240
1241     public static class ShellyStatusLight {
1242         public Boolean ison; // Whether output channel is on or off
1243         public Integer input;
1244
1245         public ArrayList<ShellyStatusLightChannel> lights;
1246         public ArrayList<ShellySettingsMeter> meters;
1247     }
1248
1249     public static class ShellySenseKeyCode {
1250         String id; // ID of the stored IR code into Shelly Sense.
1251         String name; // Short description or name of the stored IR code.
1252     }
1253
1254     public static class ShellySendKeyList {
1255         @SerializedName("key_codes")
1256         public ArrayList<ShellySenseKeyCode> keyCodes;
1257     }
1258
1259     /**
1260      * Shelly Dimmer returns light[]. However, the structure doesn't match the lights[] of a Bulb/RGBW2.
1261      * The tag lights[] will be replaced with dimmers[] so this could be mapped to a different Gson structure.
1262      * The function requires that it's only called when the device is a dimmer - on get settings and get status
1263      *
1264      * @param json Input Json as received by the API
1265      * @return Modified Json
1266      */
1267     public static String fixDimmerJson(String json) {
1268         return !json.contains("\"lights\":[") ? json
1269                 : json.replaceFirst(java.util.regex.Pattern.quote("\"lights\":["), "\"dimmers\":[");
1270     }
1271
1272     /**
1273      * Convert Shelly Button events into OH button states
1274      *
1275      * @param eventType S/SS/SSS or L
1276      * @return OH button states
1277      */
1278     public static String mapButtonEvent(String eventType) {
1279         // decode different codings
1280         // 0..2: CoAP
1281         // S/SS/SSS/L: CoAP for Button and xi3
1282         // shortpush/double_shortpush/triple_shortpush/longpush: REST
1283         switch (eventType) {
1284             case "0":
1285                 return CommonTriggerEvents.RELEASED;
1286             case "1":
1287             case SHELLY_BTNEVENT_1SHORTPUSH:
1288             case SHELLY_EVENT_SHORTPUSH:
1289                 return CommonTriggerEvents.SHORT_PRESSED;
1290             case SHELLY_BTNEVENT_2SHORTPUSH:
1291             case SHELLY_EVENT_DOUBLE_SHORTPUSH:
1292                 return CommonTriggerEvents.DOUBLE_PRESSED;
1293             case SHELLY_BTNEVENT_3SHORTPUSH:
1294             case SHELLY_EVENT_TRIPLE_SHORTPUSH:
1295                 return "TRIPLE_PRESSED";
1296             case "2":
1297             case SHELLY_BTNEVENT_LONGPUSH:
1298             case SHELLY_EVENT_LONGPUSH:
1299                 return CommonTriggerEvents.LONG_PRESSED;
1300             case SHELLY_BTNEVENT_SHORTLONGPUSH:
1301             case SHELLY_EVENT_SHORT_LONGTPUSH:
1302                 return "SHORT_LONG_PRESSED";
1303             case SHELLY_BTNEVENT_LONGSHORTPUSH:
1304             case SHELLY_EVENT_LONG_SHORTPUSH:
1305                 return "LONG_SHORT_PRESSED";
1306             default:
1307                 return "";
1308         }
1309     }
1310 }