__init__.py 6.0 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205
  1. """Switchbot Device Consts Library."""
  2. from __future__ import annotations
  3. from ..enum import StrEnum
  4. from .air_purifier import AirPurifierMode, AirQualityLevel
  5. from .climate import ClimateAction, ClimateMode, SmartThermostatRadiatorMode
  6. from .evaporative_humidifier import (
  7. HumidifierAction,
  8. HumidifierMode,
  9. HumidifierWaterLevel,
  10. )
  11. from .fan import (
  12. CirculatorFanProMode,
  13. FanMode,
  14. HorizontalOscillationAngle,
  15. NightLightState,
  16. StandingFanMode,
  17. VerticalOscillationAngle,
  18. )
  19. from .light import (
  20. BulbColorMode,
  21. CeilingLightColorMode,
  22. ColorMode,
  23. StripLightColorMode,
  24. )
  25. # Preserve old LockStatus export for backwards compatibility
  26. from .lock import LockStatus, QuickKeyFunction
  27. from .meter_pro import (
  28. MeterProAlarmMode,
  29. MeterProAlarmVolume,
  30. MeterProCO2AlarmMode,
  31. MeterProCO2AlarmStatus,
  32. MeterProComfortStatus,
  33. MeterProDateFormat,
  34. MeterProDisplaySource,
  35. MeterProDisplayZone,
  36. MeterProTemperatureHumidityAlarmMode,
  37. MeterProTemperatureHumidityAlarmStatus,
  38. MeterProWeatherIcon,
  39. MeterProZoneIcon,
  40. )
  41. DEFAULT_RETRY_COUNT = 3
  42. DEFAULT_RETRY_TIMEOUT = 1
  43. DEFAULT_SCAN_TIMEOUT = 5
  44. class SwitchbotApiError(RuntimeError):
  45. """
  46. Raised when API call fails.
  47. This exception inherits from RuntimeError to avoid breaking existing code
  48. but will be changed to Exception in a future release.
  49. """
  50. class SwitchbotAuthenticationError(RuntimeError):
  51. """
  52. Raised when authentication fails.
  53. This exception inherits from RuntimeError to avoid breaking existing code
  54. but will be changed to Exception in a future release.
  55. """
  56. class SwitchbotAccountConnectionError(RuntimeError):
  57. """
  58. Raised when connection to Switchbot account fails.
  59. This exception inherits from RuntimeError to avoid breaking existing code
  60. but will be changed to Exception in a future release.
  61. """
  62. class SwitchbotModel(StrEnum):
  63. BOT = "WoHand"
  64. CURTAIN = "WoCurtain"
  65. CURTAIN_3 = "WoCurtain3"
  66. HUMIDIFIER = "WoHumi"
  67. # Deprecated import-only symbol; use PLUG_MINI_US or PLUG_MINI_JP to parse.
  68. PLUG_MINI = "WoPlug"
  69. PLUG_MINI_US = "WoPlugUS"
  70. PLUG_MINI_JP = "WoPlugJP"
  71. CONTACT_SENSOR = "WoContact"
  72. LIGHT_STRIP = "WoStrip"
  73. METER = "WoSensorTH"
  74. METER_PLUS = "WoMeterPlus"
  75. METER_PRO = "WoTHP"
  76. METER_PRO_CO2 = "WoTHPc"
  77. # Deprecated alias; use METER_PRO_CO2.
  78. METER_PRO_C = "WoTHPc"
  79. INDOOR_OUTDOOR_THERMO_HYGROMETER = "WoIOSensorTH"
  80. # Deprecated alias; use INDOOR_OUTDOOR_THERMO_HYGROMETER.
  81. IO_METER = "WoIOSensorTH"
  82. MOTION_SENSOR = "WoPresence"
  83. COLOR_BULB = "WoBulb"
  84. CEILING_LIGHT = "WoCeiling"
  85. CEILING_LIGHT_PRO = "WoCeilingPro"
  86. LOCK = "WoLock"
  87. LOCK_PRO = "WoLockPro"
  88. BLIND_TILT = "WoBlindTilt"
  89. HUB2 = "WoHub2"
  90. LEAK = "Leak Detector"
  91. KEYPAD = "WoKeypad"
  92. RELAY_SWITCH_1PM = "Relay Switch 1PM"
  93. RELAY_SWITCH_1 = "Relay Switch 1"
  94. REMOTE = "WoRemote"
  95. UNIVERSAL_REMOTE = "WoUniversalRemote"
  96. EVAPORATIVE_HUMIDIFIER = "Evaporative Humidifier"
  97. ROLLER_SHADE = "Roller Shade"
  98. HUB_MINI = "WoLinkMini"
  99. HUBMINI_MATTER = "HubMini Matter"
  100. CIRCULATOR_FAN = "Circulator Fan"
  101. CIRCULATOR_FAN_PRO = "Circulator Fan Pro"
  102. STANDING_FAN = "Standing Fan"
  103. K20_VACUUM = "K20 Vacuum"
  104. S10_VACUUM = "S10 Vacuum"
  105. K10_VACUUM = "K10+ Vacuum"
  106. K10_PRO_VACUUM = "K10+ Pro Vacuum"
  107. K10_PRO_COMBO_VACUUM = "K10+ Pro Combo Vacuum"
  108. AIR_PURIFIER_US = "Air Purifier US"
  109. AIR_PURIFIER_JP = "Air Purifier JP"
  110. AIR_PURIFIER_TABLE_US = "Air Purifier Table US"
  111. AIR_PURIFIER_TABLE_JP = "Air Purifier Table JP"
  112. HUB3 = "Hub3"
  113. HUB4 = "Hub4"
  114. LOCK_ULTRA = "Lock Ultra"
  115. LOCK_LITE = "Lock Lite"
  116. GARAGE_DOOR_OPENER = "Garage Door Opener"
  117. RELAY_SWITCH_2PM = "Relay Switch 2PM"
  118. STRIP_LIGHT_3 = "Strip Light 3"
  119. FLOOR_LAMP = "Floor Lamp"
  120. CANDLE_WARMER_LAMP = "Candle Warmer Lamp"
  121. PLUG_MINI_EU = "Plug Mini (EU)"
  122. PLUG_MINI_IT = "Plug Mini (IT)"
  123. OUTDOOR_PLUG_EU = "Outdoor Plug (EU)"
  124. RGBICWW_STRIP_LIGHT = "RGBICWW Strip Light"
  125. RGBICWW_FLOOR_LAMP = "RGBICWW Floor Lamp"
  126. RGBICWW_LIGHT_BARS = "RGBICWW Light Bars"
  127. RGBICWW_CEILING_LIGHT = "RGBICWW Ceiling Light"
  128. PERMANENT_OUTDOOR_LIGHT = "Permanent Outdoor Light"
  129. RGBIC_NEON_ROPE_LIGHT = "RGBIC Neon Rope Light"
  130. RGBIC_NEON_WIRE_ROPE_LIGHT = "RGBIC Neon Wire Rope Light"
  131. K11_VACUUM = "K11+ Vacuum"
  132. CLIMATE_PANEL = "Climate Panel"
  133. SMART_THERMOSTAT_RADIATOR = "Smart Thermostat Radiator"
  134. S20_VACUUM = "S20 Vacuum"
  135. PRESENCE_SENSOR = "Presence Sensor"
  136. ART_FRAME = "Art Frame"
  137. ART_FRAME_2 = "Art Frame 2"
  138. E_INK_PHOTO_MAGNET = "E Ink Photo Magnet"
  139. KEYPAD_VISION = "Keypad Vision"
  140. KEYPAD_VISION_PRO = "Keypad Vision Pro"
  141. LOCK_VISION_PRO = "Lock Vision Pro"
  142. LOCK_VISION = "Lock Vision"
  143. LOCK_PRO_WIFI = "Lock Pro Wifi"
  144. LOCK_ULTRA_MAX = "Lock Ultra Max"
  145. UWB_LOCK = "UWB Lock"
  146. LOCK_NANO = "Lock Nano"
  147. WEATHER_STATION = "Weather Station"
  148. __all__ = [
  149. "DEFAULT_RETRY_COUNT",
  150. "DEFAULT_RETRY_TIMEOUT",
  151. "DEFAULT_SCAN_TIMEOUT",
  152. "AirPurifierMode",
  153. "AirQualityLevel",
  154. "BulbColorMode",
  155. "CeilingLightColorMode",
  156. "CirculatorFanProMode",
  157. "ClimateAction",
  158. "ClimateMode",
  159. "ColorMode",
  160. "FanMode",
  161. "HorizontalOscillationAngle",
  162. "HumidifierAction",
  163. "HumidifierMode",
  164. "HumidifierWaterLevel",
  165. "LockStatus",
  166. "MeterProAlarmMode",
  167. "MeterProAlarmVolume",
  168. "MeterProCO2AlarmMode",
  169. "MeterProCO2AlarmStatus",
  170. "MeterProComfortStatus",
  171. "MeterProDateFormat",
  172. "MeterProDisplaySource",
  173. "MeterProDisplayZone",
  174. "MeterProTemperatureHumidityAlarmMode",
  175. "MeterProTemperatureHumidityAlarmStatus",
  176. "MeterProWeatherIcon",
  177. "MeterProZoneIcon",
  178. "NightLightState",
  179. "QuickKeyFunction",
  180. "SmartThermostatRadiatorMode",
  181. "StandingFanMode",
  182. "StripLightColorMode",
  183. "SwitchbotAccountConnectionError",
  184. "SwitchbotApiError",
  185. "SwitchbotAuthenticationError",
  186. "SwitchbotModel",
  187. "VerticalOscillationAngle",
  188. ]