pyvesync 3.0.0b0__py3-none-any.whl

pyvesync/device_map.py

@@ -0,0 +1,1090 @@
+"""Device and module mappings for VeSync devices.
+
+This module contains mappings for VeSync devices to their respective classes.
+The mappings are used to create instances of the appropriate device class
+based on the device type and define features and modes. The device type is taken
+from the `deviceType` field in the device list API.
+
+The AirFryerMap, OutletMap, SwitchMap, BulbMap, FanMap, HumidifierMap, PurifierMap
+and ThermostatMap dataclasses are used to define the mappings for each product type
+with the assocated module, class, features and other device specific configuration. The
+[`get_device_config`][pyvesync.device_map.get_device_config] function is used
+to get the device map object from the device type to instantiate the appropriate class.
+The individual `get_<product-type>` functions are used to get the device details
+for the specific to the device type. Both functions return the same model,
+the individual product type functions are used to satisfy type checking in
+the individual devices.
+
+Attributes:
+    outlet_modules: list[OutletMap]: List of Outlet device mappings.
+    switch_modules: list[SwitchMap]: List of Switch device mappings.
+    bulb_modules: list[BulbMap]: List of Bulb device mappings.
+    fan_modules: list[FanMap]: List of Fan device mappings.
+    purifier_modules: list[PurifierMap]: List of Purifier device mappings.
+    humidifier_modules: list[HumidifierMap]: List of Humidifier device mappings.
+    air_fryer_modules: list[AirFryerMap]: List of Air Fryer device mappings.
+    thermostat_modules: list[ThermostatMap]: List of Thermostat device mappings.
+
+Classes:
+    ProductTypes: Enum: General device types enum.
+    DeviceMapTemplate: Template for DeviceModules mapping.
+    OutletMap: Template for Outlet device mapping.
+    SwitchMap: Template for Switch device mapping.
+    BulbMap: dataclass: Template for Bulb device mapping.
+    FanMap: dataclass: Template for Fan device mapping.
+    HumidifierMap: dataclass: Template for Humidifier device mapping.
+    PurifierMap: dataclass: Template for Purifier device mapping.
+    AirFryerMap: dataclass: Template for Air Fryer device mapping.
+    ThermostatMap: dataclass: Template for Thermostat device mapping.
+
+Functions:
+    get_device_config: Get the device map object from the device type.
+    get_outlet: Get outlet device config, returning OutletMap object.
+    get_switch: Get switch device config, returning SwitchMap object.
+    get_bulb: Get the bulb device config, returning BulbMap object.
+    get_fan: Get the fan device config, returning the FanMap object.
+    get_humidifier: Get the humidfier config, returning the HumidifierMap object.
+    get_purifier: Get the purifier config, returning the PurifierMap object.
+    get_air_fryer: Get the Air Fryer config, returning the AirFryerMap object.
+    get_thermostat: Get the thermostat config, returning the ThermostatMap object.
+
+Note:
+    To add devices, add the device mapping to the appropriate `<product-type>_modules`
+    list, ensuring all required fields are present based on the `<product-type>Map`
+    fields.
+"""
+from itertools import chain
+# from types import ModuleType
+from types import ModuleType
+from typing import Union
+from dataclasses import dataclass, field
+from pyvesync.devices import vesyncbulb
+from pyvesync.devices import vesyncoutlet
+from pyvesync.devices import vesyncswitch
+from pyvesync.devices import vesyncfan, vesynchumidifier, vesyncpurifier
+from pyvesync.devices import vesynckitchen
+from pyvesync.devices import vesyncthermostat
+from pyvesync.const import (
+    ColorMode,
+    PurifierModes,
+    HumidifierModes,
+    BulbFeatures,
+    OutletFeatures,
+    ProductTypes,
+    SwitchFeatures,
+    HumidifierFeatures,
+    PurifierFeatures,
+    NightlightModes,
+    PurifierAutoPreference,
+    FanSleepPreference,
+    FanModes,
+    FanFeatures,
+    ThermostatEcoTypes,
+    ThermostatFanModes,
+    ThermostatWorkModes,
+    ThermostatHoldOptions,
+    ThermostatRoutineTypes,
+)
+
+T_MAPS = Union[
+    list["OutletMap"],
+    list["SwitchMap"],
+    list["BulbMap"],
+    list["FanMap"],
+    list["HumidifierMap"],
+    list["PurifierMap"],
+    list["AirFryerMap"],
+    list["ThermostatMap"]
+    ]
+
+
+@dataclass(kw_only=True)
+class DeviceMapTemplate:
+    """Template for DeviceModules mapping.
+
+    Attributes:
+        dev_types (list[str]): List of device types to match from API.
+        class_name (str): Class name of the device.
+        product_type (str): Product type of the device.
+        module (ModuleType): Module for the device.
+        setup_entry (str): Setup entry for the device.
+        model_display (str): Display name of the model.
+        model_name (str): Name of the model.
+        device_alias (str | None): Alias for the device, if any.
+        features (list[str]): List of features for the device.
+    """
+
+    dev_types: list[str]
+    class_name: str
+    product_type: str
+    module: ModuleType
+    setup_entry: str
+    model_display: str
+    model_name: str
+    device_alias: str | None = None
+    features: list[str] = field(default_factory=list)
+
+
+@dataclass(kw_only=True)
+class OutletMap(DeviceMapTemplate):
+    """Template for DeviceModules mapping.
+
+    Attributes:
+        dev_types (list[str]): List of device types to match from API.
+        class_name (str): Class name of the device.
+        product_type (str): Product type of the device - ProductTypes.OUTLET
+        module (ModuleType): Module for the device.
+        setup_entry (str): Setup entry for the device.
+        model_display (str): Display name of the model.
+        model_name (str): Name of the model.
+        device_alias (str | None): Alias for the device, if any.
+        features (list[str]): List of features for the device.
+        product_type (str): Product type of the device.
+        module (ModuleType): Module for the device.
+        nightlight_modes (list[str]): List of nightlight modes for the device.
+    """
+    product_type: str = ProductTypes.OUTLET
+    module: ModuleType = vesyncoutlet
+    nightlight_modes: list[NightlightModes] = field(default_factory=list)
+
+
+@dataclass(kw_only=True)
+class SwitchMap(DeviceMapTemplate):
+    """Template for DeviceModules mapping.
+
+    Attributes:
+        dev_types (list[str]): List of device types to match from API.
+        class_name (str): Class name of the device.
+        product_type (str): Product type of the device - ProductTypes.SWITCH
+        module (ModuleType): Module for the device.
+        setup_entry (str): Setup entry for the device.
+        model_display (str): Display name of the model.
+        model_name (str): Name of the model.
+        device_alias (str | None): Alias for the device, if any.
+        features (list[str]): List of features for the device.
+        product_type (str): Product type of the device.
+        module (ModuleType): Module for the device.
+    """
+    product_type: str = ProductTypes.SWITCH
+    module: ModuleType = vesyncswitch
+
+
+@dataclass(kw_only=True)
+class BulbMap(DeviceMapTemplate):
+    """Template for DeviceModules mapping.
+
+    Attributes:
+        dev_types (list[str]): List of device types to match from API.
+        class_name (str): Class name of the device.
+        product_type (str): Product type of the device - ProductTypes.BULB
+        module (ModuleType): Module for the device.
+        setup_entry (str): Setup entry for the device.
+        model_display (str): Display name of the model.
+        model_name (str): Name of the model.
+        device_alias (str | None): Alias for the device, if any.
+        features (list[str]): List of features for the device.
+        color_model (str | None): Color model for the device.
+        color_modes (list[str]): List of color modes for the device.
+    """
+    color_model: str | None = None
+    product_type: str = ProductTypes.BULB
+    module: ModuleType = vesyncbulb
+    color_modes: list[str] = field(default_factory=list)
+
+
+@dataclass(kw_only=True)
+class FanMap(DeviceMapTemplate):
+    """Template for DeviceModules mapping.
+
+    Attributes:
+        dev_types (list[str]): List of device types to match from API.
+        class_name (str): Class name of the device.
+        product_type (str): Product type of the device - ProductTypes.FAN
+        module (ModuleType): Module for the device.
+        setup_entry (str): Setup entry for the device.
+        model_display (str): Display name of the model.
+        model_name (str): Name of the model.
+        device_alias (str | None): Alias for the device, if any.
+        features (list[str]): List of features for the device.
+        fan_levels (list[int]): List of fan levels for the device.
+        modes (list[str]): List of modes for the device.
+        sleep_preferences (list[str]): List of sleep preferences for the device.
+        set_mode_method (str): Method to set the mode for the device.
+    """
+    product_type: str = ProductTypes.FAN
+    module: ModuleType = vesyncfan
+    fan_levels: list[int] = field(default_factory=list)
+    modes: list[str] = field(default_factory=list)
+    sleep_preferences: list[str] = field(default_factory=list)
+    set_mode_method: str = ""
+
+
+@dataclass(kw_only=True)
+class HumidifierMap(DeviceMapTemplate):
+    """Template for DeviceModules mapping.
+
+    Attributes:
+        dev_types (list[str]): List of device types to match from API.
+        class_name (str): Class name of the device.
+        product_type (str): Product type of the device - ProductTypes.HUMIDIFIER
+        module (ModuleType): Module for the device.
+        setup_entry (str): Setup entry for the device.
+        model_display (str): Display name of the model.
+        model_name (str): Name of the model.
+        device_alias (str | None): Alias for the device, if any.
+        features (list[str]): List of features for the device.
+        mist_modes (dict[str, str]): Dictionary of mist modes for the device.
+        mist_levels (list[int | str]): List of mist levels for the device.
+        target_minmax (tuple[int, int]): Minimum and maximum target humidity levels.
+        warm_mist_levels (list[int | str]): List of warm mist levels for the device.
+    """
+
+    mist_modes: dict[str, str] = field(default_factory=dict)
+    mist_levels: list[int | str] = field(default_factory=list)
+    product_type: str = ProductTypes.HUMIDIFIER
+    module: ModuleType = vesynchumidifier
+    target_minmax: tuple[int, int] = (30, 80)
+    warm_mist_levels: list[int | str] = field(default_factory=list)
+
+
+@dataclass(kw_only=True)
+class PurifierMap(DeviceMapTemplate):
+    """Template for DeviceModules mapping.
+
+    Attributes:
+        dev_types (list[str]): List of device types to match from API.
+        class_name (str): Class name of the device.
+        product_type (str): Product type of the device - ProductTypes.PURIFIER
+
+        module (ModuleType): Module for the device.
+        setup_entry (str): Setup entry for the device.
+        model_display (str): Display name of the model.
+        model_name (str): Name of the model.
+        device_alias (str | None): Alias for the device, if any.
+        features (list[str]): List of features for the device.
+        fan_levels (list[int]): List of fan levels for the device.
+        modes (list[str]): List of modes for the device.
+        nightlight_modes (list[str]): List of nightlight modes for the device.
+        auto_preferences (list[str]): List of auto preferences for the device.
+    """
+
+    product_type: str = ProductTypes.PURIFIER
+    module: ModuleType = vesyncpurifier
+    fan_levels: list[int] = field(default_factory=list)
+    modes: list[str] = field(default_factory=list)
+    nightlight_modes: list[str] = field(default_factory=list)
+    auto_preferences: list[str] = field(default_factory=list)
+
+
+@dataclass(kw_only=True)
+class AirFryerMap(DeviceMapTemplate):
+    """Template for DeviceModules mapping.
+
+    Attributes:
+        dev_types (list[str]): List of device types to match from API.
+        class_name (str): Class name of the device.
+        product_type (str): Product type of the device - ProductTypes.AIR_FRYER
+        module (ModuleType): Module for the device.
+        setup_entry (str): Setup entry for the device.
+        model_display (str): Display name of the model.
+        model_name (str): Name of the model.
+        device_alias (str | None): Alias for the device, if any.
+        features (list[str]): List of features for the device.
+        product_type (str): Product type of the device.
+        module (ModuleType): Module for the device.
+    """
+
+    product_type: str = ProductTypes.AIR_FRYER
+    module: ModuleType = vesynckitchen
+
+
+@dataclass(kw_only=True)
+class ThermostatMap(DeviceMapTemplate):
+    """Template for Thermostat device mapping.
+
+    Attributes:
+        dev_types (list[str]): List of device types to match from API.
+        class_name (str): Class name of the device.
+        product_type (str): Product type of the device.
+        module (ModuleType): Module for the device.
+        setup_entry (str): Setup entry for the device.
+        model_display (str): Display name of the model.
+        model_name (str): Name of the model.
+        device_alias (str | None): Alias for the device, if any.
+        features (list[str]): List of features for the device.
+        modes (list[int]): List of modes for the device.
+        fan_modes (list[int]): List of fan modes for the device.
+        eco_types (list[int]): List of eco types for the device.
+        hold_options (list[int]): List of hold options for the device.
+        routine_types (list[int]): List of routine types for the device.
+    """
+    product_type: str = ProductTypes.THERMOSTAT
+    module: ModuleType = vesyncthermostat
+    modes: list[int] = field(default_factory=list)
+    fan_modes: list[int] = field(default_factory=list)
+    eco_types: list[int] = field(default_factory=list)
+    hold_options: list[int] = field(default_factory=list)
+    routine_types: list[int] = field(default_factory=list)
+
+
+thermostat_modules = [
+    ThermostatMap(
+        dev_types=['LTM-A401S-WUS'],
+        class_name='VeSyncAuraThermostat',
+        fan_modes=[
+            ThermostatFanModes.AUTO,
+            ThermostatFanModes.CIRCULATE,
+            ThermostatFanModes.ON,
+        ],
+        modes=[
+            ThermostatWorkModes.HEAT,
+            ThermostatWorkModes.COOL,
+            ThermostatWorkModes.AUTO,
+            ThermostatWorkModes.OFF,
+        ],
+        eco_types=[
+            ThermostatEcoTypes.BALANCE,
+            ThermostatEcoTypes.COMFORT_FIRST,
+            ThermostatEcoTypes.COMFORT_SECOND,
+            ThermostatEcoTypes.ECO_FIRST,
+            ThermostatEcoTypes.ECO_SECOND,
+        ],
+        hold_options=[
+            ThermostatHoldOptions.PERMANENTLY,
+            ThermostatHoldOptions.FOUR_HOURS,
+            ThermostatHoldOptions.TWO_HOURS,
+            ThermostatHoldOptions.UNTIL_NEXT_SCHEDULED_ITEM,
+        ],
+        routine_types=[
+            ThermostatRoutineTypes.AWAY,
+            ThermostatRoutineTypes.CUSTOM,
+            ThermostatRoutineTypes.HOME,
+            ThermostatRoutineTypes.SLEEP,
+        ],
+        setup_entry='LTM-A401S-WUS',
+        model_display='LTM-A401S Series',
+        model_name='Aura Thermostat',
+    )
+]
+
+
+outlet_modules = [
+    OutletMap(
+        dev_types=["wifi-switch-1.3"],
+        class_name="VeSyncOutlet7A",
+        features=[OutletFeatures.ENERGY_MONITOR],
+        model_name="WiFi Outlet US/CA",
+        model_display="ESW01-USA Series",
+        setup_entry="wifi-switch-1.3",
+    ),
+    OutletMap(
+        dev_types=["ESW10-USA"],
+        class_name="VeSyncESW10USA",
+        features=[],
+        model_name="10A WiFi Outlet USA",
+        model_display="ESW10-USA Series",
+        setup_entry="ESW03-USA",
+    ),
+    OutletMap(
+        dev_types=["ESW01-EU"],
+        class_name="VeSyncOutlet10A",
+        features=[OutletFeatures.ENERGY_MONITOR],
+        model_name="10A WiFi Outlet Europe",
+        model_display="ESW01-EU",
+        setup_entry="ESW01-EU",
+    ),
+    OutletMap(
+        dev_types=["ESW15-USA"],
+        class_name="VeSyncOutlet15A",
+        features=[OutletFeatures.ENERGY_MONITOR, OutletFeatures.NIGHTLIGHT],
+        nightlight_modes=[NightlightModes.ON, NightlightModes.OFF, NightlightModes.AUTO],
+        model_name="15A WiFi Outlet US/CA",
+        model_display="ESW15-USA Series",
+        setup_entry="ESW15-USA",
+    ),
+    OutletMap(
+        dev_types=["ESO15-TB"],
+        class_name="VeSyncOutdoorPlug",
+        features=[OutletFeatures.ENERGY_MONITOR],
+        model_name="Outdoor Plug",
+        model_display="ESO15-TB Series",
+        setup_entry="ESO15-TB",
+    ),
+    OutletMap(
+        dev_types=["BSDOG01"],
+        class_name="VeSyncOutletBSDGO1",
+        features=[OutletFeatures.ONOFF],
+        model_name="Smart Plug",
+        model_display="Smart Plug Series",
+        setup_entry="BSDOG01",
+        device_alias="Greensun Smart Plug",
+    ),
+]
+"""List of ['OutletMap'][pyvesync.device_map.OutletMap] configuration
+objects for outlet devices."""
+
+switch_modules = [
+    SwitchMap(
+        dev_types=["ESWL01"],
+        class_name="VeSyncWallSwitch",
+        device_alias="Wall Switch",
+        features=[SwitchFeatures.ONOFF],
+        model_name="Light Switch",
+        model_display="ESWL01 Series",
+        setup_entry="ESWL01",
+    ),
+    SwitchMap(
+        dev_types=["ESWD16"],
+        class_name="VeSyncDimmerSwitch",
+        features=[
+            SwitchFeatures.DIMMABLE,
+            SwitchFeatures.INDICATOR_LIGHT,
+            SwitchFeatures.BACKLIGHT_RGB,
+        ],
+        device_alias="Dimmer Switch",
+        model_name="Dimmer Switch",
+        model_display="ESWD16 Series",
+        setup_entry="ESWD16",
+    ),
+    SwitchMap(
+        dev_types=["ESWL03"],
+        class_name="VeSyncWallSwitch",
+        device_alias="Three-Way Wall Switch",
+        features=[SwitchFeatures.ONOFF],
+        model_name="Light Switch 3 way",
+        model_display="ESWL03 Series",
+        setup_entry="ESWL03",
+    ),
+]
+"""List of ['SwitchMap'][pyvesync.device_map.SwitchMap] configuration
+objects for switch devices."""
+
+
+# Bulb Device Definition
+# Format: BulbMap(
+#     dev_types=["<device_type>"],
+#     class_name="<class_name>",
+#     features=["<feature>"],
+#     color_model="<color_model>",
+#     device_alias="<device_alias>")
+bulb_modules = [
+    BulbMap(
+        dev_types=["ESL100"],
+        class_name="VeSyncBulbESL100",
+        features=[SwitchFeatures.DIMMABLE],
+        color_model=None,
+        device_alias="Dimmable Bright White Bulb",
+        color_modes=[ColorMode.WHITE],
+        model_display="ESL100 Series",
+        model_name="Soft white light bulb",
+        setup_entry="ESL100",
+    ),
+    BulbMap(
+        dev_types=["ESL100CW"],
+        class_name="VeSyncBulbESL100CW",
+        features=[BulbFeatures.DIMMABLE, BulbFeatures.COLOR_TEMP],
+        color_model=None,
+        device_alias="Dimmable Tunable White Bulb",
+        color_modes=[ColorMode.WHITE],
+        model_display="ESL100CW Series",
+        model_name="Cool-to-Warm White Light Bulb",
+        setup_entry="ESL100CW",
+    ),
+    BulbMap(
+        dev_types=["XYD0001"],
+        class_name="VeSyncBulbValcenoA19MC",
+        features=[
+            BulbFeatures.DIMMABLE,
+            BulbFeatures.MULTICOLOR,
+            BulbFeatures.COLOR_TEMP,
+        ],
+        color_model=ColorMode.HSV,
+        device_alias="Valceno Dimmable RGB Bulb",
+        color_modes=[ColorMode.WHITE, ColorMode.COLOR],
+        model_display="XYD0001",
+        model_name="Valceno WiFi Bulb",
+        setup_entry="XYD0001",
+    ),
+    BulbMap(
+        dev_types=["ESL100MC"],
+        class_name="VeSyncBulbESL100MC",
+        features=[
+            BulbFeatures.COLOR_TEMP,
+            BulbFeatures.MULTICOLOR,
+            BulbFeatures.DIMMABLE,
+        ],
+        color_model=ColorMode.RGB,
+        device_alias="Etekcity Dimmable RGB Bulb",
+        color_modes=[ColorMode.WHITE, ColorMode.COLOR],
+        model_name="Multicolour Bulb",
+        model_display="ESL100MC",
+        setup_entry="ESL100MC",
+    ),
+]
+"""List of ['BulbMap'][pyvesync.device_map.BulbMap] configuration
+objects for bulb devices."""
+
+
+humidifier_modules = [
+    HumidifierMap(
+        class_name="VeSyncHumid200300S",
+        dev_types=[
+            "Classic300S",
+            "LUH-A601S-WUSB",
+            "LUH-A601S-AUSW",
+        ],
+        features=[
+            HumidifierFeatures.NIGHTLIGHT,
+            HumidifierFeatures.NIGHTLIGHT_BRIGHTNESS,
+        ],
+        mist_modes={
+            HumidifierModes.AUTO: "auto",
+            HumidifierModes.SLEEP: "sleep",
+            HumidifierModes.MANUAL: "manual",
+        },
+        mist_levels=list(range(1, 10)),
+        device_alias="Classic 300S",
+        model_display="LUH-A601S Series",
+        model_name="Classic 300S",
+        setup_entry="Classic300S",
+    ),
+    HumidifierMap(
+        class_name="VeSyncHumid200S",
+        dev_types=["Classic200S"],
+        features=[],
+        mist_modes={
+            HumidifierModes.AUTO: "auto",
+            HumidifierModes.MANUAL: "manual",
+        },
+        mist_levels=list(range(1, 10)),
+        device_alias="Classic 200S",
+        model_display="Classic 200S Series",
+        model_name="Classic 200S",
+        setup_entry="Classic200S",
+    ),
+    HumidifierMap(
+        class_name="VeSyncHumid200300S",
+        dev_types=["Dual200S", "LUH-D301S-WUSR", "LUH-D301S-WJP", "LUH-D301S-WEU"],
+        features=[],
+        mist_modes={
+            HumidifierModes.AUTO: "auto",
+            HumidifierModes.MANUAL: "manual",
+        },
+        mist_levels=list(range(1, 3)),
+        device_alias="Dual 200S",
+        model_display="LUH-D301S Series",
+        model_name="Dual 200S",
+        setup_entry="Dual200S",
+    ),
+    HumidifierMap(
+        class_name="VeSyncHumid200300S",
+        dev_types=[
+            "LUH-A602S-WUSR",
+            "LUH-A602S-WUS",
+            "LUH-A602S-WEUR",
+            "LUH-A602S-WEU",
+            "LUH-A602S-WJP",
+            "LUH-A602S-WUSC",
+        ],
+        features=[HumidifierFeatures.WARM_MIST],
+        mist_modes={
+            HumidifierModes.AUTO: "auto",
+            HumidifierModes.SLEEP: "sleep",
+            HumidifierModes.MANUAL: "manual",
+        },
+        mist_levels=list(range(1, 10)),
+        warm_mist_levels=[0, 1, 2, 3],
+        device_alias="LV600S",
+        model_display="LUH-A602S Series",
+        model_name="LV600S",
+        setup_entry="LUH-A602S-WUS",
+    ),
+    HumidifierMap(
+        class_name="VeSyncHumid200300S",
+        dev_types=["LUH-O451S-WEU"],
+        features=[HumidifierFeatures.WARM_MIST],
+        mist_modes={
+            HumidifierModes.AUTO: "auto",
+            HumidifierModes.SLEEP: "sleep",
+            HumidifierModes.MANUAL: "manual",
+        },
+        mist_levels=list(range(1, 10)),
+        warm_mist_levels=list(range(4)),
+        device_alias="OasisMist 450S EU",
+        model_name="OasisMist 4.5L",
+        model_display="LUH-O451S Series",
+        setup_entry="LUH-O451S-WUS",
+    ),
+    HumidifierMap(
+        class_name="VeSyncHumid200300S",
+        dev_types=["LUH-O451S-WUS", "LUH-O451S-WUSR", "LUH-O601S-WUS", "LUH-O601S-KUS"],
+        features=[HumidifierFeatures.WARM_MIST],
+        mist_modes={
+            HumidifierModes.AUTO: "auto",
+            HumidifierModes.SLEEP: "sleep",
+            HumidifierModes.MANUAL: "manual",
+            HumidifierModes.HUMIDITY: "humidity",
+        },
+        mist_levels=list(range(1, 10)),
+        warm_mist_levels=list(range(4)),
+        device_alias="OasisMist 450S",
+        model_display="OasisMist 4.5L Series",
+        model_name="OasisMist 4.5L",
+        setup_entry="LUH-O451S-WUS",
+    ),
+    HumidifierMap(
+        class_name="VeSyncHumid1000S",
+        dev_types=["LUH-M101S-WUS", "LUH-M101S-WEUR", "LUH-M101S-WUSR"],
+        features=[],
+        mist_modes={
+            HumidifierModes.AUTO: "auto",
+            HumidifierModes.SLEEP: "sleep",
+            HumidifierModes.MANUAL: "manual",
+        },
+        mist_levels=list(range(1, 10)),
+        device_alias="Oasismist 1000S",
+        model_display="Oasismist Series",
+        model_name="Oasismist 1000S",
+        setup_entry="LUH-M101S",
+    ),
+    HumidifierMap(
+        class_name="VeSyncSuperior6000S",
+        dev_types=["LEH-S601S-WUS", "LEH-S601S-WUSR", "LEH-S601S-WEUR"],
+        features=[HumidifierFeatures.DRYING_MODE],
+        mist_modes={
+            HumidifierModes.AUTO: "autoPro",
+            HumidifierModes.SLEEP: "sleep",
+            HumidifierModes.HUMIDITY: "humidity",
+            HumidifierModes.MANUAL: "manual",
+            HumidifierModes.AUTOPRO: "autoPro",
+        },
+        mist_levels=list(range(1, 10)),
+        device_alias="Superior 6000S",
+        model_display="LEH-S601S Series",
+        model_name="Superior 6000S",
+        setup_entry="LEH-S601S",
+    ),
+]
+"""List of ['HumidifierMap'][pyvesync.device_map.HumidifierMap] configuration
+objects for humidifier devices."""
+
+
+purifier_modules: list[PurifierMap] = [
+    PurifierMap(
+        class_name="VeSyncAirBypass",
+        dev_types=["Core200S", "LAP-C201S-AUSR", "LAP-C202S-WUSR"],
+        modes=[PurifierModes.SLEEP, PurifierModes.MANUAL],
+        features=[PurifierFeatures.RESET_FILTER, PurifierFeatures.NIGHTLIGHT],
+        auto_preferences=[
+            PurifierAutoPreference.DEFAULT,
+            PurifierAutoPreference.EFFICIENT,
+            PurifierAutoPreference.QUIET
+        ],
+        fan_levels=list(range(1, 4)),
+        nightlight_modes=[NightlightModes.ON, NightlightModes.OFF, NightlightModes.DIM],
+        device_alias="Core 200S",
+        model_display="Core 200S",
+        model_name="Core 200S",
+        setup_entry="Core200S",
+    ),
+    PurifierMap(
+        class_name="VeSyncAirBypass",
+        dev_types=[
+            "Core300S",
+            "LAP-C301S-WJP",
+            "LAP-C302S-WUSB",
+            "LAP-C301S-WAAA",
+            "LAP-C302S-WGC",
+            ],
+        modes=[PurifierModes.SLEEP, PurifierModes.MANUAL, PurifierModes.AUTO],
+        auto_preferences=[
+            PurifierAutoPreference.DEFAULT,
+            PurifierAutoPreference.EFFICIENT,
+            PurifierAutoPreference.QUIET
+        ],
+        features=[PurifierFeatures.AIR_QUALITY],
+        fan_levels=list(range(1, 5)),
+        device_alias="Core 300S",
+        model_display="Core 300S",
+        model_name="Core 300S",
+        setup_entry="Core300S",
+    ),
+    PurifierMap(
+        class_name="VeSyncAirBypass",
+        dev_types=["Core400S", "LAP-C401S-WJP", "LAP-C401S-WUSR", "LAP-C401S-WAAA"],
+        modes=[PurifierModes.SLEEP, PurifierModes.MANUAL, PurifierModes.AUTO],
+        features=[PurifierFeatures.AIR_QUALITY],
+        fan_levels=list(range(1, 5)),
+        device_alias="Core 400S",
+        auto_preferences=[
+            PurifierAutoPreference.DEFAULT,
+            PurifierAutoPreference.EFFICIENT,
+            PurifierAutoPreference.QUIET
+            ],
+        model_display="Core 400S",
+        model_name="Core 400S",
+        setup_entry="Core400S",
+    ),
+    PurifierMap(
+        class_name="VeSyncAirBypass",
+        dev_types=["Core600S", "LAP-C601S-WUS", "LAP-C601S-WUSR", "LAP-C601S-WEU"],
+        modes=[PurifierModes.SLEEP, PurifierModes.MANUAL, PurifierModes.AUTO],
+        features=[PurifierFeatures.AIR_QUALITY],
+        auto_preferences=[
+            PurifierAutoPreference.DEFAULT,
+            PurifierAutoPreference.EFFICIENT,
+            PurifierAutoPreference.QUIET
+        ],
+        fan_levels=list(range(1, 5)),
+        device_alias="Core 600S",
+        model_display="Core 600S",
+        model_name="Core 600S",
+        setup_entry="Core600S",
+    ),
+    PurifierMap(
+        class_name="VeSyncAir131",
+        dev_types=["LV-PUR131S", "LV-RH131S"],
+        modes=[PurifierModes.SLEEP, PurifierModes.MANUAL, PurifierModes.AUTO],
+        features=[PurifierFeatures.AIR_QUALITY],
+        fan_levels=list(range(1, 3)),
+        device_alias="LV-PUR131S",
+        model_display="LV-PUR131S/RH131S Series",
+        model_name="LV131S",
+        setup_entry="LV-PUR131S",
+    ),
+    PurifierMap(
+        class_name="VeSyncAirBaseV2",
+        dev_types=[
+            "LAP-V102S-AASR",
+            "LAP-V102S-WUS",
+            "LAP-V102S-WEU",
+            "LAP-V102S-AUSR",
+            "LAP-V102S-WJP",
+            "LAP-V102S-AJPR",
+            "LAP-V102S-AEUR",
+        ],
+        modes=[
+            PurifierModes.SLEEP,
+            PurifierModes.MANUAL,
+            PurifierModes.AUTO,
+            PurifierModes.PET,
+        ],
+        features=[PurifierFeatures.AIR_QUALITY],
+        fan_levels=list(range(1, 5)),
+        device_alias="Vital 100S",
+        auto_preferences=[
+            PurifierAutoPreference.DEFAULT,
+            PurifierAutoPreference.EFFICIENT,
+            PurifierAutoPreference.QUIET
+            ],
+        model_display="LAP-V102S Series",
+        model_name="Vital 100S",
+        setup_entry="LAP-V102S",
+    ),
+    PurifierMap(
+        class_name="VeSyncAirBaseV2",
+        dev_types=[
+            "LAP-V201S-AASR",
+            "LAP-V201S-WJP",
+            "LAP-V201S-WEU",
+            "LAP-V201S-WUS",
+            "LAP-V201-AUSR",
+            "LAP-V201S-AUSR",
+            "LAP-V201S-AEUR",
+        ],
+        modes=[
+            PurifierModes.SLEEP,
+            PurifierModes.MANUAL,
+            PurifierModes.AUTO,
+            PurifierModes.PET,
+        ],
+        features=[
+            PurifierFeatures.AIR_QUALITY,
+            PurifierFeatures.LIGHT_DETECT
+            ],
+        fan_levels=list(range(1, 5)),
+        device_alias="Vital 200S",
+        auto_preferences=[
+            PurifierAutoPreference.DEFAULT,
+            PurifierAutoPreference.EFFICIENT,
+            PurifierAutoPreference.QUIET
+            ],
+        model_display="LAP-V201S Series",
+        model_name="Vital 200S",
+        setup_entry="LAP-V201S",
+    ),
+    PurifierMap(
+        class_name="VeSyncAirBaseV2",
+        dev_types=[
+            "LAP-EL551S-AUS",
+            "LAP-EL551S-AEUR",
+            "LAP-EL551S-WEU",
+            "LAP-EL551S-WUS",
+        ],
+        modes=[
+            PurifierModes.SLEEP,
+            PurifierModes.MANUAL,
+            PurifierModes.AUTO,
+            PurifierModes.TURBO,
+        ],
+        features=[
+            PurifierFeatures.AIR_QUALITY,
+            PurifierFeatures.VENT_ANGLE,
+            PurifierFeatures.LIGHT_DETECT
+            ],
+        fan_levels=list(range(1, 4)),
+        device_alias="Everest Air",
+        auto_preferences=[
+            PurifierAutoPreference.DEFAULT,
+            PurifierAutoPreference.EFFICIENT,
+            PurifierAutoPreference.QUIET
+            ],
+        model_display="LAP-EL551S Series",
+        model_name="Everest Air",
+        setup_entry="EL551S",
+    ),
+]
+"""List of ['PurifierMap'][pyvesync.device_map.PurifierMap] configuration
+objects for purifier devices."""
+
+
+fan_modules: list[FanMap] = [
+    FanMap(
+        class_name="VeSyncTowerFan",
+        dev_types=["LTF-F422S-KEU", "LTF-F422S-WUSR", "LTF-F422_WJP", "LTF-F422S-WUS"],
+        modes=[
+            FanModes.SLEEP,  # Alias for Advanced sleep mode
+            FanModes.NORMAL,
+            FanModes.MANUAL,
+            FanModes.TURBO,
+            FanModes.AUTO,
+            FanModes.ADVANCED_SLEEP,
+        ],
+        set_mode_method="setTowerFanMode",
+        features=[
+            FanFeatures.OSCILLATION,
+            FanFeatures.DISPLAYING_TYPE,
+            FanFeatures.SOUND,
+        ],
+        fan_levels=list(range(1, 13)),
+        device_alias="Tower Fan",
+        sleep_preferences=[
+            FanSleepPreference.DEFAULT,
+            FanSleepPreference.ADVANCED,
+            FanSleepPreference.TURBO,
+            FanSleepPreference.EFFICIENT,
+            FanSleepPreference.QUIET,
+        ],  # Unknown sleep preferences, need to be verified
+        model_display="LTF-F422S Series",
+        model_name="Classic 42-Inch Tower Fan",
+        setup_entry="LTF-F422S",
+    ),
+]
+"""List of ['FanMap'][pyvesync.device_map.FanMap] configuration
+objects for fan devices."""
+
+
+air_fryer_modules: list[AirFryerMap] = [
+    AirFryerMap(
+        class_name="VeSyncAirFryer158",
+        module=vesynckitchen,
+        dev_types=['CS137-AF/CS158-AF', 'CS158-AF', 'CS137-AF', 'CS358-AF'],
+        device_alias="Air Fryer",
+        model_display="CS158/159/168/169-AF Series",
+        model_name="Smart/Pro/Pro Gen 2 5.8 Qt. Air Fryer",
+        setup_entry="CS137-AF/CS158-AF",
+    )
+]
+"""List of ['AirFryerMap'][pyvesync.device_map.AirFryerMap] configuration
+for air fryer devices."""
+
+
+def get_device_config(device_type: str) -> DeviceMapTemplate | None:
+    """Get general device details from device type to create instance.
+
+    Args:
+        device_type (str): Device type to match from device list API call.
+
+    Returns:
+        DeviceMapTemplate | None: DeviceMapTemplate object or None if not found.
+    """
+    all_modules: list[T_MAPS] = [
+        outlet_modules,
+        switch_modules,
+        bulb_modules,
+        fan_modules,
+        purifier_modules,
+        humidifier_modules,
+        air_fryer_modules,
+        thermostat_modules,
+    ]
+    for module in chain(*all_modules):
+        if device_type in module.dev_types:
+            return module
+    if device_type.count("-") > 1:
+        device_type = "-".join(device_type.split("-")[:-1])
+        for module in chain(*all_modules):
+            if any(device_type.lower() in dev.lower() for dev in module.dev_types):
+                return module
+    return None
+
+
+def get_fan(device_type: str) -> FanMap | None:
+    """Get fan device details from device type.
+
+    Args:
+        device_type (str): Device type to match from device list API call.
+
+    Returns:
+        FanMap | None: FanMap object or None if not found.
+    """
+    for module in fan_modules:
+        if device_type in module.dev_types:
+            return module
+    # Try to match with a more generic device type
+    if device_type.count("-") > 1:
+        device_type = "-".join(device_type.split("-")[:-1])
+        for module in fan_modules:
+            if any(device_type.lower() in dev.lower() for dev in module.dev_types):
+                return module
+    return None
+
+
+def get_purifier(device_type: str) -> PurifierMap | None:
+    """Get purifier device details from device type.
+
+    Args:
+        device_type (str): Device type to match from device list API call.
+
+    Returns:
+        PurifierMap | None: PurifierMap object or None if not found.
+    """
+    for module in purifier_modules:
+        if device_type in module.dev_types:
+            return module
+    if device_type.count("-") > 1:
+        device_type = "-".join(device_type.split("-")[:-1])
+        for module in purifier_modules:
+            if any(device_type.lower() in dev.lower() for dev in module.dev_types):
+                return module
+    return None
+
+
+def get_humidifier(device_type: str) -> HumidifierMap | None:
+    """Get humidifier device details from device type.
+
+    Args:
+        device_type (str): Device type to match from device list API call.
+
+    Returns:
+        HumidifierMap | None: HumidifierMap object or None if not found.
+    """
+    for module in humidifier_modules:
+        if device_type in module.dev_types:
+            return module
+    if device_type.count("-") > 1:
+        device_type = "-".join(device_type.split("-")[:-1])
+        for module in humidifier_modules:
+            if any(device_type.lower() in dev.lower() for dev in module.dev_types):
+                return module
+    return None
+
+
+def get_outlet(device_type: str) -> OutletMap | None:
+    """Get outlet device details from device type.
+
+    Args:
+        device_type (str): Device type to match from device list API call.
+
+    Returns:
+        OutletMap | None: OutletMap object or None if not found.
+    """
+    for module in outlet_modules:
+        if device_type in module.dev_types:
+            return module
+    if device_type.count("-") > 1:
+        device_type = "-".join(device_type.split("-")[:-1])
+        for module in outlet_modules:
+            if any(device_type.lower() in dev.lower() for dev in module.dev_types):
+                return module
+    return None
+
+
+def get_switch(device_type: str) -> SwitchMap | None:
+    """Get switch device details from device type.
+
+    Args:
+        device_type (str): Device type to match from device list API call.
+
+    Returns:
+        SwitchMap | None: SwitchMap object or None if not found.
+    """
+    for module in switch_modules:
+        if device_type in module.dev_types:
+            return module
+    if device_type.count("-") > 1:
+        device_type = "-".join(device_type.split("-")[:-1])
+        for module in switch_modules:
+            if any(device_type.lower() in dev.lower() for dev in module.dev_types):
+                return module
+    return None
+
+
+def get_bulb(device_type: str) -> BulbMap | None:
+    """Get bulb device details from device type.
+
+    Args:
+        device_type (str): Device type to match from device list API call.
+
+    Returns:
+        BulbMap | None: BulbMap object or None if not found.
+    """
+    for module in bulb_modules:
+        if device_type in module.dev_types:
+            return module
+    if device_type.count("-") > 1:
+        device_type = "-".join(device_type.split("-")[:-1])
+        for module in bulb_modules:
+            if any(device_type.lower() in dev.lower() for dev in module.dev_types):
+                return module
+    return None
+
+
+def get_air_fryer(device_type: str) -> AirFryerMap | None:
+    """Get air fryer device details from device type.
+
+    Args:
+        device_type (str): Device type to match from device list API call.
+
+    Returns:
+        AirFryerMap | None: AirFryerMap object or None if not found.
+    """
+    for module in air_fryer_modules:
+        if device_type in module.dev_types:
+            return module
+    if device_type.count("-") > 1:
+        device_type = "-".join(device_type.split("-")[:-1])
+        for module in air_fryer_modules:
+            if any(device_type.lower() in dev.lower() for dev in module.dev_types):
+                return module
+    return None
+
+
+def get_thermostat(device_type: str) -> ThermostatMap | None:
+    """Get the device map for a thermostat.
+
+    Args:
+        device_type (str): The device type to match.
+
+    Returns:
+        ThermostatMap | None: The matching thermostat map or None if not found.
+    """
+    for module in thermostat_modules:
+        if device_type in module.dev_types:
+            return module
+    if device_type.count("-") > 1:
+        device_type = "-".join(device_type.split("-")[:-1])
+        for module in thermostat_modules:
+            if any(device_type.lower() in dev.lower() for dev in module.dev_types):
+                return module
+    return None