homematicip.device¶
homematicip.device
¶
AlarmSirenIndoor
¶
Bases: SabotageDevice
HMIP-ASIR (Alarm Siren)
AlarmSirenOutdoor
¶
AutoNameEnum
¶
Bases: StrEnum
auto() will generate the name of the attribute as value
from_str
classmethod
¶
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
Blind
¶
Bases: Shutter
Base class for blind devices
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
¶
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
BlindModule
¶
BrandBlind
¶
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
¶
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
¶
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
¶
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
¶
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
CombinationSignallingDevice
¶
Bases: Device
HmIP-MP3P (Combination Signalling Device)
A device that can play MP3 sounds and show optical signals for various alarm and notification conditions.
ContactInterface
¶
Bases: SabotageDevice
HMIP-SCI (Contact Interface Sensor)
Device
¶
Bases: BaseDevice
this class represents a generic homematic ip device
add_on_code_state_event_handler
¶
Register a handler for code-state push events emitted by this device.
Fired with a :class:CodeStateEvent when the cloud reports
a DEVICE_CODE_STATE_EVENT for this device (HmIP-WKP keypad).
DinRailDimmer3
¶
Bases: Dimmer
HMIP-DRDI3 (Dimming Actuator Inbound 230V – 3x channels, 200W per channel) electrical DIN rail
DinRailSwitch
¶
DinRailSwitch4
¶
DoorBellButton
¶
DoorLockDrive
¶
Bases: OperationLockableDevice
HmIP-DLD
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
¶
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
DoorLockDrivePro
¶
ExternalDevice
¶
FloorTerminalBlock10
¶
FloorTerminalBlock12
¶
Bases: Device
HMIP-FALMOT-C12 (Floor Heating Actuator – 12x channels, motorised)
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
¶
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
FullFlushBlind
¶
FullFlushDoorController
¶
Bases: Device
HmIP-FDC Full Flush Door Controller (door opener).
Provides an impulse-driven door opener output via DOOR_SWITCH_CHANNEL
(role DOOR_OPENER_ACTUATOR). Two MULTI_MODE_LOCK_INPUT_CHANNEL inputs and a
set of ACCESS_AUTHORIZATION_CHANNEL channels for keypad/code access are
exposed via the standard functionalChannels collection.
FullFlushInputSwitch
¶
Bases: Switch
HMIP-FSI16 (Switch Actuator with Push-button Input 230V, 16A) and HMIP-FSI6 (Switch Actuator with Push-button Input, compact)
FullFlushLockController
¶
FullFlushShutter
¶
Bases: Shutter
HMIP-FROLL (Shutter Actuator - flush-mount) / HMIP-BROLL (Shutter Actuator - Brand-mount)
GarageDoorModuleTormatic
¶
HeatingThermostat
¶
Bases: OperationLockableDevice
HMIP-eTRV (Radiator Thermostat)
HeatingThermostatCompact
¶
Bases: SabotageDevice
HMIP-eTRV-C (Heating-thermostat compact without display)
HeatingThermostatEvo
¶
Bases: OperationLockableDevice
HMIP-eTRV-E (Heating-thermostat new evo version)
HoermannDrivesModule
¶
KeyRemoteControl4
¶
KeyRemoteControlKeyMatic
¶
MotionDetectorIndoor
¶
Bases: SabotageDevice
HMIP-SMI (Motion Detector with Brightness Sensor - indoor)
MotionDetectorPushButton
¶
Bases: MotionDetectorOutdoor
HMIP-SMI55 (Motion Detector with Brightness Sensor and Remote Control - 2-button)
MotionDetectorSwitchOutdoor
¶
Bases: SabotageDevice
HmIP-SMO230 (Motion Detector with Brightness Sensor and Switch - outdoor)
PassageDetector
¶
Bases: SabotageDevice
HMIP-SPDR (Passage Detector)
PlugableSwitch
¶
PresenceDetectorIndoor
¶
Bases: SabotageDevice
HMIP-SPI (Presence Sensor - indoor)
PrintedCircuitBoardSwitchBattery
¶
PushButton6
¶
PushButton6LedSwitch
¶
PushButtonFlat
¶
RemoteControl8
¶
RemoteControl8Module
¶
RoomControlDevice
¶
RotaryHandleSensor
¶
Bases: SabotageDevice
HMIP-SRH
Shutter
¶
Bases: Device
Base class for shutter devices
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
¶
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
¶
stops the current shutter operation
Args: channelIndex(int): the channel to control Returns: the result of the _restCall
set_shutter_stop_async
async
¶
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)
ShutterContactOpticalPlus
¶
TemperatureDifferenceSensor2
¶
TemperatureHumiditySensorDisplay
¶
TemperatureHumiditySensorOutdoor
¶
TemperatureHumiditySensorWithoutDisplay
¶
TemperatureTiltVibrationSensor
¶
Bases: TiltVibrationSensor
ELV-SH-TACO (Inclination and vibration sensor with temperature sensor).
The tilt channel is index 2, so the acceleration setters need channelIndex=2.
WallMountedGarageDoorController
¶
WallMountedRemoteControlRotaryButton
¶
Bases: PushButton
HmIP-WRCR (Wall-mount Remote Control - Rotary)
Exposes a SINGLE_KEY_CHANNEL for the push button and two ROTARY_WHEEL_CHANNEL instances, one per rotation direction (CLOCK_WISE / COUNTER_CLOCK_WISE).
WallMountedThermostatBasicHumidity
¶
WallMountedThermostatPro
¶
Bases: TemperatureHumiditySensorDisplay, OperationLockableDevice
HMIP-WTH, HMIP-WTH-2 (Wall Thermostat with Humidity Sensor) / HMIP-BWTH (Brand Wall Thermostat with Humidity Sensor)
WallMountedThermostatWithCarbon
¶
WiredCarbonTemperatureHumiditySensorDisplay
¶
WiredFloorTerminalBlock12
¶
WiredInput32
¶
WiredMotionDetectorPushButton
¶
WiredPushButton
¶
Bases: PushButton
HmIPW-WRC6 and HmIPW-WRC2
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
¶
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
¶
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
¶
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