homematicip.class_maps
AccelerationSensor
AccelerationSensorChannel
AccessAuthorizationChannel
AccessControllerChannel
AccessControllerWiredChannel
AlarmSirenChannel
AlarmSirenIndoor
Bases: SabotageDevice
HMIP-ASIR (Alarm Siren)
AlarmSirenOutdoor
AnalogOutputChannel
AnalogRoomControlChannel
AutoNameEnum
auto() will generate the name of the attribute as value
from_str
classmethod
from_str
this function will create the enum object based on its string value
Args: text(str): the string value of the enum default(AutoNameEnum): a default value if text could not be used Returns: the enum object or None if the text is None or the default value
BaseDevice
Bases: HomeMaticIPObject
Base device class. This is the foundation for homematicip and external (hue) devices
load_functionalChannels
load_functionalChannels
this function will load the functionalChannels into the device
Blind
Bases: Shutter
Base class for blind devices
set_slats_level
set_slats_level
sets the slats and shutter level
Args: slatsLevel(float): the new level of the slats. 0.0 = open, 1.0 = closed shutterLevel(float): the new level of the shutter. 0.0 = open, 1.0 = closed, None = use the current value channelIndex(int): the channel to control Returns: the result of the _restCall
set_slats_level_async
async
set_slats_level_async
sets the slats and shutter level
Args: slatsLevel(float): the new level of the slats. 0.0 = open, 1.0 = closed, shutterLevel(float): the new level of the shutter. 0.0 = open, 1.0 = closed, None = use the current value channelIndex(int): the channel to control Returns: the result of the _restCall
BlindChannel
Bases: FunctionalChannel
this is the representative of the BLIND_CHANNEL channel
set_shutter_level
set_shutter_level
sets the shutter level
Args: level(float): the new level of the shutter. 0.0 = open, 1.0 = closed channelIndex(int): the channel to control Returns: the result of the _restCall
set_shutter_stop
set_shutter_stop
stops the current operation Returns: the result of the _restCall
set_slats_level
set_slats_level
sets the slats and shutter level
Args: slatsLevel(float): the new level of the slats. 0.0 = open, 1.0 = closed, shutterLevel(float): the new level of the shutter. 0.0 = open, 1.0 = closed, None = use the current value channelIndex(int): the channel to control Returns: the result of the _restCall
stop
stop
stops the current shutter operation
Returns: the result of the _restCall
BlindModule
Bases: Device
HMIP-HDM1 (Hunter Douglas & erfal window blinds)
stop
async
stop
stops the current operation Returns: the result of the _restCall
stop_async
async
stop_async
stops the current operation Returns: the result of the _restCall
BrandBlind
BrandDimmer
BrandPushButton
BrandSwitch2
Bases: Switch
ELV-SH-BS2 (ELV Smart Home ARR-Bausatz Schaltaktor für Markenschalter – 2-fach powered by Homematic IP)
BrandSwitchNotificationLight
Bases: Switch
HMIP-BSL (Switch Actuator for brand switches – with signal lamp)
set_rgb_dim_level
set_rgb_dim_level
sets the color and dimlevel of the lamp
Args: channelIndex(int): the channelIndex of the lamp. Use self.topLightChannelIndex or self.bottomLightChannelIndex rgb(RGBColorState): the color of the lamp dimLevel(float): the dimLevel of the lamp. 0.0 = off, 1.0 = MAX
Returns: the result of the _restCall
set_rgb_dim_level_async
async
set_rgb_dim_level_async
sets the color and dimlevel of the lamp
Args: channelIndex(int): the channelIndex of the lamp. Use self.topLightChannelIndex or self.bottomLightChannelIndex rgb(RGBColorState): the color of the lamp dimLevel(float): the dimLevel of the lamp. 0.0 = off, 1.0 = MAX
Returns: the result of the _restCall
set_rgb_dim_level_with_time
set_rgb_dim_level_with_time
sets the color and dimlevel of the lamp
Args: channelIndex(int): the channelIndex of the lamp. Use self.topLightChannelIndex or self.bottomLightChannelIndex rgb(RGBColorState): the color of the lamp dimLevel(float): the dimLevel of the lamp. 0.0 = off, 1.0 = MAX onTime(float): rampTime(float): Returns: the result of the _restCall
set_rgb_dim_level_with_time_async
async
set_rgb_dim_level_with_time_async
sets the color and dimlevel of the lamp
Args: channelIndex(int): the channelIndex of the lamp. Use self.topLightChannelIndex or self.bottomLightChannelIndex rgb(RGBColorState): the color of the lamp dimLevel(float): the dimLevel of the lamp. 0.0 = off, 1.0 = MAX onTime(float): rampTime(float): Returns: the result of the _restCall
CarbonDioxideSensor
CarbonDioxideSensorChannel
ChangeOverChannel
ClimateSensorChannel
CodeProtectedPrimaryActionChannel
Bases: FunctionalChannel
this is the representative of the CODE_PROTECTED_PRIMARY_ACTION_CHANNEL channel (HmIP-WKP)
CodeProtectedSecondaryActionChannel
Bases: FunctionalChannel
this is the representative of the CODE_PROTECTED_SECONDARY_ACTION_CHANNEL channel (HmIP-WKP)
ContactInterface
Bases: SabotageDevice
HMIP-SCI (Contact Interface Sensor)
ContactInterfaceChannel
DaliGateway
DehumidifierDemandChannel
Device
DeviceBaseChannel
DeviceBaseFloorHeatingChannel
Bases: DeviceBaseChannel
this is the representative of the DEVICE_BASE_FLOOR_HEATING channel
set_minimum_floor_heating_valve_position
set_minimum_floor_heating_valve_position
sets the minimum floot heating valve position
Args: minimumFloorHeatingValvePosition(float): the minimum valve position. must be between 0.0 and 1.0
Returns: the result of the _restCall
DeviceBlockingChannel
DeviceGlobalPumpControlChannel
DeviceIncorrectPositionedChannel
DeviceOperationLockChannel
DeviceOperationLockChannelWithSabotage
Bases: DeviceOperationLockChannel
this is the representation of the DeviceOperationLockChannelWithSabotage channel
DevicePermanentFullRxChannel
DeviceRechargeableWithSabotage
Bases: DeviceSabotageChannel
this is the representative of the DEVICE_RECHARGEABLE_WITH_SABOTAGE channel
DeviceSabotageChannel
Dimmer
DimmerChannel
DinRailBlind4
DinRailDimmer3
Bases: Dimmer
HMIP-DRDI3 (Dimming Actuator Inbound 230V – 3x channels, 200W per channel) electrical DIN rail
DinRailSwitch
DinRailSwitch4
DoorBellButton
DoorBellContactInterface
DoorChannel
DoorLockChannel
Bases: FunctionalChannel
This respresents of the DoorLockChannel
async_set_lock_state
async
async_set_lock_state
sets the door lock state
Args: doorLockState(float): the state of the door. See LockState from base/enums.py pin(string): Pin, if specified. channelIndex(int): the channel to control. Normally the channel from DOOR_LOCK_CHANNEL is used. Returns: the result of the _restCall
set_lock_state
set_lock_state
sets the door lock state
Args: doorLockState(float): the state of the door. See LockState from base/enums.py pin(string): Pin, if specified. channelIndex(int): the channel to control. Normally the channel from DOOR_LOCK_CHANNEL is used. Returns: the result of the _restCall
DoorLockDrive
Bases: OperationLockableDevice
HmIP-DLD
set_lock_state
set_lock_state
sets the door lock state
Args: doorLockState(float): the state of the door. See LockState from base/enums.py pin(string): Pin, if specified. channelIndex(int): the channel to control. Normally the channel from DOOR_LOCK_CHANNEL is used. Returns: the result of the _restCall
set_lock_state_async
async
set_lock_state_async
sets the door lock state
Args: doorLockState(float): the state of the door. See LockState from base/enums.py pin(string): Pin, if specified. channelIndex(int): the channel to control. Normally the channel from DOOR_LOCK_CHANNEL is used. Returns: the result of the _restCall
DoorLockSensor
DoorLockSensorChannel
DoorModule
EnergySensorInterfaceChannel
EnergySensorsInterface
ExternalBaseChannel
Bases: FunctionalChannel
this represents the EXTERNAL_BASE_CHANNEL function-channel for external devices
ExternalDevice
ExternalUniversalLightChannel
Bases: FunctionalChannel
this represents the EXTERNAL_UNIVERSAL_LIGHT_CHANNEL function-channel for external devices
set_dim_level_async
async
set_dim_level_async
Set the dim level of the light channel.
set_dim_level_with_time_async
async
set_dim_level_with_time_async
Set the dim level of the light channel with a specified time.
FloorTeminalBlockChannel
FloorTerminalBlock10
FloorTerminalBlock12
Bases: Device
HMIP-FALMOT-C12 (Floor Heating Actuator – 12x channels, motorised)
set_minimum_floor_heating_valve_position
set_minimum_floor_heating_valve_position
sets the minimum floot heating valve position
Args: minimumFloorHeatingValvePosition(float): the minimum valve position. must be between 0.0 and 1.0
Returns: the result of the _restCall
set_minimum_floor_heating_valve_position_async
async
set_minimum_floor_heating_valve_position_async
sets the minimum floot heating valve position
Args: minimumFloorHeatingValvePosition(float): the minimum valve position. must be between 0.0 and 1.0
Returns: the result of the _restCall
FloorTerminalBlock6
FloorTerminalBlockLocalPumpChannel
Bases: FunctionalChannel
this is the representative of the FLOOR_TERMINAL_BLOCK_LOCAL_PUMP_CHANNEL channel
FloorTerminalBlockMechanicChannel
Bases: FunctionalChannel
this is the representative of the class FLOOR_TERMINAL_BLOCK_MECHANIC_CHANNEL(FunctionalChannel) channel
FullFlushBlind
FullFlushContactInterface
FullFlushContactInterface6
FullFlushDimmer
FullFlushInputSwitch
FullFlushShutter
Bases: Shutter
HMIP-FROLL (Shutter Actuator - flush-mount) / HMIP-BROLL (Shutter Actuator - Brand-mount)
FunctionalChannel
Bases: HomeMaticIPObject
this is the base class for the functional channels
add_on_channel_event_handler
add_on_channel_event_handler
Adds an event handler to the update method. Fires when a device is updated.
fire_channel_event
fire_channel_event
Trigger the methods tied to _on_channel_event
from_json
from_json
this function will load the functional channel object from a json object and the given groups
Args: js(dict): the json object groups(Iterable[Group]): the groups for referencing
GarageDoorModuleTormatic
GenericInputChannel
Group
HeatDemandChannel
HeatingSwitch2
HeatingThermostat
Bases: OperationLockableDevice
HMIP-eTRV (Radiator Thermostat)
HeatingThermostatChannel
HeatingThermostatCompact
Bases: SabotageDevice
HMIP-eTRV-C (Heating-thermostat compact without display)
HeatingThermostatEvo
Bases: OperationLockableDevice
HMIP-eTRV-E (Heating-thermostat new evo version)
HoermannDrivesModule
HomeMaticIPObject
This class represents a generic homematic ip object to make basic requests to the access point
fire_remove_event
fire_remove_event
Trigger the method tied to _on_remove
fire_update_event
fire_update_event
Trigger the method tied to _on_update
from_json
from_json
this method will parse the homematicip object from a json object
Parameters:
Name | Type | Description | Default |
---|---|---|---|
|
the json object to parse |
required |
fromtimestamp
fromtimestamp
internal helper function which will create a datetime object from a timestamp
on_remove
on_remove
Adds an event handler to the remove method. Fires when a device is removed.
on_update
on_update
Adds an event handler to the update method. Fires when a device is updated.
remove_callback
remove_callback
Remove event handler.
set_attr_from_dict
set_attr_from_dict
this method will add the value from dict to the given attr name
Args: attr(str): the attribute which value should be changed dict(dict): the dictionary from which the value should be extracted type(AutoNameEnum): this will call type.from_str(value), if a type gets provided dict_attr: the name of the attribute in the dict. Set this to None(default) to use attr addToStrOutput(str): should the attribute be returned via str()
str_from_attr_map
str_from_attr_map
this method will return a string with all key/values which were added via the set_attr_from_dict method
ImpulseOutputChannel
Bases: FunctionalChannel
this is the representation of the IMPULSE_OUTPUT_CHANNEL
send_start_impulse
send_start_impulse
Toggle Wall mounted Garage Door Controller.
InternalSwitchChannel
KeyRemoteControl4
KeyRemoteControlAlarm
LightSensor
LightSensorChannel
MainsFailureChannel
MetaGroup
MotionDetectionChannel
MotionDetectorIndoor
Bases: SabotageDevice
HMIP-SMI (Motion Detector with Brightness Sensor - indoor)
MotionDetectorOutdoor
MotionDetectorPushButton
Bases: MotionDetectorOutdoor
HMIP-SMI55 (Motion Detector with Brightness Sensor and Remote Control - 2-button)
MultiIOBox
MultiModeInputBlindChannel
MultiModeInputChannel
MultiModeInputDimmerChannel
MultiModeInputSwitchChannel
NotificationLightChannel
Bases: DimmerChannel
, SwitchChannel
this is the representative of the NOTIFICATION_LIGHT_CHANNEL channel
async_set_optical_signal
async
async_set_optical_signal
sets the signal type for the leds
Args: opticalSignalBehaviour(OpticalSignalBehaviour): LED signal behaviour rgb(RGBColorState): Color dimLevel(float): usally 1.01. Use set_dim_level instead
Returns: Result of the _restCall
async_set_rgb_dim_level_with_time
async
async_set_rgb_dim_level_with_time
sets the color and dimlevel of the lamp
Args: channelIndex(int): the channelIndex of the lamp. Use self.topLightChannelIndex or self.bottomLightChannelIndex rgb(RGBColorState): the color of the lamp dimLevel(float): the dimLevel of the lamp. 0.0 = off, 1.0 = MAX onTime(float): rampTime(float): Returns: the result of the _restCall
set_rgb_dim_level
set_rgb_dim_level
sets the color and dimlevel of the lamp
Args: channelIndex(int): the channelIndex of the lamp. Use self.topLightChannelIndex or self.bottomLightChannelIndex rgb(RGBColorState): the color of the lamp dimLevel(float): the dimLevel of the lamp. 0.0 = off, 1.0 = MAX
Returns: the result of the _restCall
OpenCollector8Module
OpticalSignalChannel
OpticalSignalGroupChannel
PassageDetector
Bases: SabotageDevice
HMIP-SPDR (Passage Detector)
PassageDetectorChannel
PlugableSwitch
PluggableDimmer
PluggableMainsFailureSurveillance
PresenceDetectionChannel
PresenceDetectorIndoor
Bases: SabotageDevice
HMIP-SPI (Presence Sensor - indoor)
PrintedCircuitBoardSwitch2
PrintedCircuitBoardSwitchBattery
PushButton
PushButton6
PushButtonFlat
RainDetectionChannel
RainSensor
RemoteControl8
RemoteControl8Module
RgbwDimmer
RoomControlDevice
RoomControlDeviceAnalog
RotaryHandleChannel
RotaryHandleSensor
Bases: SabotageDevice
HMIP-SRH
Rule
Bases: HomeMaticIPObject
this class represents the automation rule
set_label
set_label
sets the label of the rule
set_label_async
async
set_label_async
sets the label of the rule
SecurityEvent
SecurityZoneEvent
Bases: SecurityEvent
This class will be used by other events which are just adding "securityZoneValues"
ShadingChannel
Bases: FunctionalChannel
this is the representative of the SHADING_CHANNEL channel
async_set_shutter_stop
async
async_set_shutter_stop
stops the current operation Returns: the result of the _restCall
Shutter
Bases: Device
Base class for shutter devices
set_shutter_level
set_shutter_level
sets the shutter level
Args: level(float): the new level of the shutter. 0.0 = open, 1.0 = closed channelIndex(int): the channel to control Returns: the result of the _restCall
set_shutter_level_async
async
set_shutter_level_async
sets the shutter level
Args: level(float): the new level of the shutter. 0.0 = open, 1.0 = closed channelIndex(int): the channel to control Returns: the result of the _restCall
set_shutter_stop
set_shutter_stop
stops the current shutter operation
Args: channelIndex(int): the channel to control Returns: the result of the _restCall
set_shutter_stop_async
async
set_shutter_stop_async
stops the current shutter operation
Args: channelIndex(int): the channel to control Returns: the result of the _restCall
ShutterChannel
Bases: FunctionalChannel
this is the representative of the SHUTTER_CHANNEL channel
async_set_shutter_level
async
async_set_shutter_level
sets the shutter level
Args: level(float): the new level of the shutter. 0.0 = open, 1.0 = closed Returns: the result of the _restCall
async_set_shutter_stop
async
async_set_shutter_stop
stops the current shutter operation
Args: channelIndex(int): the channel to control Returns: the result of the _restCall
ShutterContact
Bases: SabotageDevice
HMIP-SWDO (Door / Window Contact - optical) / HMIP-SWDO-I (Door / Window Contact Invisible - optical)
ShutterContactChannel
ShutterContactMagnetic
ShutterContactOpticalPlus
SimpleRule
Bases: Rule
This class represents a "Simple" automation rule
disable
disable
disables the rule
disable_async
async
disable_async
disables the rule
enable
enable
enables the rule
enable_async
async
enable_async
enables the rule
set_rule_enabled_state
set_rule_enabled_state
enables/disables this rule
set_rule_enabled_state_async
async
set_rule_enabled_state_async
enables/disables this rule
SingleKeyChannel
SmokeDetector
SmokeDetectorChannel
Switch
SwitchChannel
SwitchMeasuring
SwitchMeasuringChannel
TemperatureDifferenceSensor2
TemperatureDifferenceSensor2Channel
Bases: FunctionalChannel
this is the representative of the TEMPERATURE_SENSOR_2_EXTERNAL_DELTA_CHANNEL channel
TemperatureHumiditySensorDisplay
TemperatureHumiditySensorOutdoor
TemperatureHumiditySensorWithoutDisplay
TiltVibrationSensor
TiltVibrationSensorChannel
UniversalActuatorChannel
Bases: FunctionalChannel
this is the representative of the UniversalActuatorChannel UNIVERSAL_ACTUATOR_CHANNEL
UniversalLightChannel
Bases: FunctionalChannel
Represents Universal Light Channel.
set_dim_level_async
async
set_dim_level_async
Set the dim level of the light channel.
set_dim_level_with_time_async
async
set_dim_level_with_time_async
Set the dim level of the light channel with a specified time.
start_light_scene_async
async
start_light_scene_async
Start a light scene.
UniversalLightChannelGroup
WallMountedGarageDoorController
Bases: Device
HmIP-WGC Wall mounted Garage Door Controller
send_start_impulse
send_start_impulse
Toggle Wall mounted Garage Door Controller.
send_start_impulse_async
async
send_start_impulse_async
Toggle Wall mounted Garage Door Controller.
WallMountedThermostatBasicHumidity
WallMountedThermostatPro
Bases: TemperatureHumiditySensorDisplay
, OperationLockableDevice
HMIP-WTH, HMIP-WTH-2 (Wall Thermostat with Humidity Sensor) / HMIP-BWTH (Brand Wall Thermostat with Humidity Sensor)
WallMountedThermostatProChannel
Bases: FunctionalChannel
this is the representative of the WALL_MOUNTED_THERMOSTAT_PRO_CHANNEL channel
WallMountedThermostatWithCarbonChannel
Bases: WallMountedThermostatProChannel
this is the representative of the WALL_MOUNTED_THERMOSTAT_WITH_CARBON_DIOXIDE_SENSOR_CHANNEL channel
WallMountedThermostatWithoutDisplayChannel
Bases: ClimateSensorChannel
this is the representative of the WALL_MOUNTED_THERMOSTAT_WITHOUT_DISPLAY_CHANNEL channel
WaterSensor
WaterSensorChannel
WateringActuatorChannel
Bases: FunctionalChannel
this is the representative of the WATERING_ACTUATOR_CHANNEL channel
reset_water_volume_async
async
reset_water_volume_async
Resets the water volume counter of the specified device.
set_watering_switch_state_async
async
set_watering_switch_state_async
Sets the watering switch state of the specified device.
set_watering_switch_state_with_time_async
async
set_watering_switch_state_with_time_async
toggle_watering_state_async
async
toggle_watering_state_async
Toggles the watering state of the specified device.
WeatherSensor
WeatherSensorChannel
WeatherSensorPlus
WeatherSensorPlusChannel
WeatherSensorPro
WeatherSensorProChannel
Bases: WeatherSensorPlusChannel
this is the representative of the WEATHER_SENSOR_PRO_CHANNEL channel
WiredCarbonTemperatureHumiditySensorDisplay
WiredDimmer3
WiredDinRailBlind4
WiredFloorTerminalBlock12
WiredInput32
WiredInputSwitch6
WiredMotionDetectorPushButton
WiredPushButton
Bases: PushButton
HmIPW-WRC6 and HmIPW-WRC2
set_dim_level
set_dim_level
sets the signal type for the leds Args: channelIndex(int): Channel which is affected dimLevel(float): usally 1.01. Use set_dim_level instead
Returns: Result of the _restCall
set_dim_level_async
async
set_dim_level_async
sets the signal type for the leds Args: channelIndex(int): Channel which is affected dimLevel(float): usally 1.01. Use set_dim_level instead
Returns: Result of the _restCall
set_optical_signal
set_optical_signal
sets the signal type for the leds
Args: channelIndex(int): Channel which is affected opticalSignalBehaviour(OpticalSignalBehaviour): LED signal behaviour rgb(RGBColorState): Color dimLevel(float): usally 1.01. Use set_dim_level instead
Returns: Result of the _restCall
set_optical_signal_async
async
set_optical_signal_async
sets the signal type for the leds
Args: channelIndex(int): Channel which is affected opticalSignalBehaviour(OpticalSignalBehaviour): LED signal behaviour rgb(RGBColorState): Color dimLevel(float): usally 1.01. Use set_dim_level instead
Returns: Result of the _restCall