homematicip.commands.functional_channel_commands¶
homematicip.commands.functional_channel_commands
¶
pull_latch_async
async
¶
Trigger the latch of a door opening device by activating the switching output of the target device channel for its configured impulse duration.
Both the requesting client and the target device channel must belong to the same
access authorization. Used for ACCESS_AUTHORIZATION_CHANNEL channels with role
DOOR_OPENER_ACTUATOR (e.g. on HmIP-FLC, HmIP-DLD).
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
|
RestConnection
|
The REST connection instance. |
required |
|
str
|
The device ID. |
required |
|
int
|
The channel index of the access-authorization channel. |
required |
|
str | None
|
The authorization PIN (optional, only required if a PIN is configured
on the access authorization profile). The cloud requires the field to be a
string, so |
None
|
Returns:
| Type | Description |
|---|---|
dict
|
The response from the cloud. |
reset_energy_counter_async
async
¶
Reset the energy counter for a functional channel.
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
|
RestConnection
|
The REST connection instance. |
required |
|
str
|
The device ID. |
required |
|
int
|
The channel index. |
required |
Returns:
| Type | Description |
|---|---|
dict
|
The response from the cloud. |
reset_water_volume_async
async
¶
send_door_command_async
async
¶
Send a door command.
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
|
RestConnection
|
The REST connection instance. |
required |
|
str
|
The device ID. |
required |
|
int
|
The channel index. |
required |
|
str
|
The door command as string. Possible values are defined in the DoorCommand enum. |
required |
Returns:
| Type | Description |
|---|---|
dict
|
The response from the cloud. |
set_acceleration_sensor_event_filter_period_async
async
¶
Set the event filter period for the acceleration sensor.
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
|
RestConnection
|
The REST connection instance. |
required |
|
str
|
The device ID. |
required |
|
int
|
The channel index. |
required |
|
float
|
The event filter period in seconds. |
required |
Returns:
| Type | Description |
|---|---|
dict
|
The response from the cloud. |
set_acceleration_sensor_mode_async
async
¶
Set the mode for the acceleration sensor.
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
|
RestConnection
|
The REST connection instance. |
required |
|
str
|
The device ID. |
required |
|
int
|
The channel index. |
required |
|
str
|
The mode as string. Possible values are defined in the AccelerationSensorMode enum. |
required |
Returns:
| Type | Description |
|---|---|
dict
|
The response from the cloud. |
set_acceleration_sensor_neutral_position_async
async
¶
Set the neutral position for the acceleration sensor.
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
|
RestConnection
|
The REST connection instance. |
required |
|
str
|
The device ID. |
required |
|
int
|
The channel index. |
required |
|
str
|
The neutral position as string. Possible values are defined in the AccelerationSensorNeutralPosition enum. |
required |
Returns:
| Type | Description |
|---|---|
dict
|
The response from the cloud. |
set_acceleration_sensor_sensitivity_async
async
¶
Set the sensitivity for the acceleration sensor.
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
|
RestConnection
|
The REST connection instance. |
required |
|
str
|
The device ID. |
required |
|
int
|
The channel index. |
required |
|
str
|
The sensitivity as string. Possible values are defined in the AccelerationSensorSensitivity enum. |
required |
Returns:
| Type | Description |
|---|---|
dict
|
The response from the cloud. |
set_acceleration_sensor_trigger_angle_async
async
¶
Set the trigger angle for the acceleration sensor.
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
|
RestConnection
|
The REST connection instance. |
required |
|
str
|
The device ID. |
required |
|
int
|
The channel index. |
required |
|
int
|
The trigger angle in degrees. |
required |
Returns:
| Type | Description |
|---|---|
dict
|
The response from the cloud. |
set_acoustic_alarm_signal_async
async
¶
Set the acoustic alarm signal.
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
|
RestConnection
|
The REST connection instance. |
required |
|
str
|
The device ID. |
required |
|
int
|
The channel index. |
required |
|
str
|
The acoustic alarm signal as string. Possible values are defined in the AcousticAlarmSignal enum. |
required |
Returns:
| Type | Description |
|---|---|
dict
|
The response from the cloud. |
set_acoustic_alarm_timing_async
async
¶
Set the acoustic alarm timing.
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
|
RestConnection
|
The REST connection instance. |
required |
|
str
|
The device ID. |
required |
|
int
|
The channel index. |
required |
|
str
|
The acoustic alarm timing as string. Possible values are defined in the AcousticAlarmTiming enum. |
required |
Returns:
| Type | Description |
|---|---|
dict
|
The response from the cloud. |
set_acoustic_water_alarm_trigger_async
async
¶
Set the acoustic water alarm trigger.
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
|
RestConnection
|
The REST connection instance. |
required |
|
str
|
The device ID. |
required |
|
int
|
The channel index. |
required |
|
str
|
The acoustic water alarm trigger as string. Possible values are defined in the WaterAlarmTrigger enum. |
required |
Returns:
| Type | Description |
|---|---|
dict
|
The response from the cloud. |
set_color_temperature_dim_level_async
async
¶
Set the color temperature and dim level for a functional channel.
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
|
RestConnection
|
The REST connection instance. |
required |
|
str
|
The device ID. |
required |
|
int
|
The channel index. |
required |
|
int
|
The desired color temperature in Kelvin. Between 1000 K(Kelvin) to 10000 K |
required |
|
float
|
The desired dim level (0.0 to 1.0). |
required |
Returns:
| Type | Description |
|---|---|
dict
|
The response from the cloud. |
set_color_temperature_dim_level_with_time_async
async
¶
Set the color temperature and dim level with time for a functional channel.
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
|
RestConnection
|
The REST connection instance. |
required |
|
str
|
The device ID. |
required |
|
int
|
The channel index. |
required |
|
int
|
The desired color temperature in Kelvin. Between 1000 K(Kelvin) to 10000 K |
required |
|
float
|
The desired dim level (0.0 to 1.0). |
required |
|
float
|
The on time in seconds. |
required |
|
float
|
The ramp time in seconds. |
required |
Returns:
| Type | Description |
|---|---|
dict
|
The response from the cloud. |
set_dim_level_async
async
¶
Set the dim level for a functional channel.
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
|
RestConnection
|
The REST connection instance. |
required |
|
str
|
The device ID. |
required |
|
int
|
The channel index. |
required |
|
float
|
The desired dim level. |
required |
Returns:
| Type | Description |
|---|---|
dict
|
The response from the cloud. |
set_dim_level_with_time_async
async
¶
Set the dim level with time for a functional channel.
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
|
RestConnection
|
The REST connection instance. |
required |
|
str
|
The device ID. |
required |
|
int
|
The channel index. |
required |
|
float
|
The desired dim level. |
required |
|
float
|
The on time in seconds. |
required |
|
float
|
The ramp time in seconds. |
required |
Returns:
| Type | Description |
|---|---|
dict
|
The response from the cloud. |
set_display_async
async
¶
Set the climate control display.
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
|
RestConnection
|
The REST connection instance. |
required |
|
str
|
The device ID. |
required |
|
int
|
The channel index. |
required |
|
str
|
The display as string. Possible values are defined in the ClimateControlDisplay enum. |
required |
Returns:
| Type | Description |
|---|---|
dict
|
The response from the cloud. |
set_door_lock_active_async
async
¶
Hold a door permanently released ("always open"), or end that state.
Sets doorLockActive on the DOOR_SWITCH_CHANNEL with role
DOOR_LOCK_ACTUATOR. Note the polarity: True is the released state,
although the vendor documentation describes the field as activating the
locking of the door.
Without a PIN the plain endpoint applies, which takes the
DOOR_SWITCH_CHANNEL. A client outside the access authorization gets
CLIENT_ACCESS_DENIED and needs the ...WithAuthorization variant,
which takes the ACCESS_AUTHORIZATION_CHANNEL with role
DOOR_LOCK_ACTUATOR instead. Pass pin="" when that authorization has
no PIN. The authorization variant is untested, see issue #685.
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
|
RestConnection
|
The REST connection instance. |
required |
|
str
|
The device ID. |
required |
|
int
|
The channel index of the door switch channel. |
required |
|
bool
|
|
required |
|
str | None
|
The authorization PIN. |
None
|
Returns:
| Type | Description |
|---|---|
dict
|
The response from the cloud. |
set_favorite_shading_position
async
¶
Set the favorite shading position for a functional channel.
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
|
RestConnection
|
The REST connection instance. |
required |
|
str
|
The device ID. |
required |
|
int
|
The channel index. |
required |
Returns:
| Type | Description |
|---|---|
dict
|
The response from the cloud. |
set_hue_saturation_dim_level_async
async
¶
Set the hue, saturation, and dim level for a functional channel.
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
|
RestConnection
|
The REST connection instance. |
required |
|
str
|
The device ID. |
required |
|
int
|
The channel index. |
required |
|
int
|
The desired hue (0-360). |
required |
|
float
|
The desired saturation level (0.0 to 1.0). |
required |
|
float
|
The desired dim level (0.0 to 1.0). |
required |
Returns:
| Type | Description |
|---|---|
dict
|
The response from the cloud. |
set_hue_saturation_dim_level_with_time_async
async
¶
Set the hue, saturation, and dim level with time for a functional channel.
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
|
RestConnection
|
The REST connection instance. |
required |
|
str
|
The device ID. |
required |
|
int
|
The channel index. |
required |
|
int
|
The desired hue (0 to 359). |
required |
|
float
|
The desired saturation level (0.0 to 1.0). |
required |
|
float
|
The desired dim level (0.0 to 1.0). |
required |
|
float
|
The on time in seconds. |
required |
|
float
|
The ramp time in seconds. |
required |
Returns:
| Type | Description |
|---|---|
dict
|
The response from the cloud. |
set_inapp_water_alarm_trigger_async
async
¶
Set the in-app water alarm trigger.
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
|
RestConnection
|
The REST connection instance. |
required |
|
str
|
The device ID. |
required |
|
int
|
The channel index. |
required |
|
str
|
The in-app water alarm trigger as string. Possible values are defined in the WaterAlarmTrigger enum. |
required |
Returns:
| Type | Description |
|---|---|
dict
|
The response from the cloud. |
set_lock_state_async
async
¶
Set the door lock state.
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
|
RestConnection
|
The REST connection instance. |
required |
|
str
|
The device ID. |
required |
|
int
|
The channel index. |
required |
|
str
|
The lock state as string. Possible values are defined in the LockState enum. |
required |
|
str | None
|
The authorization pin (optional). |
None
|
Returns:
| Type | Description |
|---|---|
dict
|
The response from the cloud. |
set_minimum_floor_heating_valve_position_async
async
¶
Set the minimum floor heating valve position.
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
|
RestConnection
|
The REST connection instance. |
required |
|
str
|
The device ID. |
required |
|
int
|
The channel index. |
required |
|
float
|
The desired minimum valve position. |
required |
Returns:
| Type | Description |
|---|---|
dict
|
The response from the cloud. |
set_motion_detection_active_async
async
¶
Set the motion detection active state for a functional channel.
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
|
RestConnection
|
The REST connection instance. |
required |
|
str
|
The device ID. |
required |
|
int
|
The channel index. |
required |
|
bool
|
Whether motion detection is active (True) or not (False). |
required |
Returns:
| Type | Description |
|---|---|
dict
|
The response from the cloud. |
set_notification_sound_type_async
async
¶
Set the notification sound type.
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
|
RestConnection
|
The REST connection instance. |
required |
|
str
|
The device ID. |
required |
|
int
|
The channel index. |
required |
|
str
|
The sound type as string. Possible values are defined in the AcousticAlarmSignal enum. |
required |
|
bool
|
Whether the signal is high to low. |
required |
Returns:
| Type | Description |
|---|---|
dict
|
The response from the cloud. |
set_operation_lock_async
async
¶
Set the operation lock for a functional channel.
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
|
RestConnection
|
The REST connection instance. |
required |
|
str
|
The device ID. |
required |
|
int
|
The channel index. |
required |
|
bool
|
The desired operation lock state (True for locked, False for unlocked). |
required |
Returns:
| Type | Description |
|---|---|
dict
|
The response from the cloud. |
set_optical_signal_async
async
¶
Set the signal type for the LEDs.
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
|
RestConnection
|
The REST connection instance. |
required |
|
str
|
The device ID. |
required |
|
int
|
The channel index. |
required |
|
str
|
The optical signal behaviour as string. Possible values are defined in the OpticalSignalBehaviour enum. |
required |
|
str
|
The RGB color as string. Possible values are defined in the RGBColorState enum. |
required |
|
float
|
The dim level (usually 1.01). Use set_dim_level instead. |
1.01
|
Returns:
| Type | Description |
|---|---|
dict
|
The response from the cloud. |
set_optical_signal_with_time_async
async
¶
Set the optical signal with time for a functional channel.
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
|
RestConnection
|
The REST connection instance. |
required |
|
str
|
The device ID. |
required |
|
int
|
The channel index. |
required |
|
str
|
The optical signal behaviour as string. Possible values are defined in the OpticalSignalBehaviour enum. |
required |
|
str
|
The RGB color as string. Possible values are defined in the RGBColorState enum. |
required |
|
float
|
The on time in seconds. |
required |
|
float
|
The ramp time in seconds. |
required |
|
float
|
The dim level (usually 1.01). Use set_dim_level instead. |
1.01
|
Returns:
| Type | Description |
|---|---|
dict
|
The response from the cloud. |
set_primary_shading_level_async
async
¶
Set the primary shading level for a functional channel.
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
|
RestConnection
|
The REST connection instance. |
required |
|
str
|
The device ID. |
required |
|
int
|
The channel index. |
required |
|
float
|
The desired primary shading level. |
required |
Returns:
| Type | Description |
|---|---|
dict
|
The response from the cloud. |
set_secondary_shading_level_async
async
¶
Set the secondary shading level for a functional channel.
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
|
RestConnection
|
The REST connection instance. |
required |
|
str
|
The device ID. |
required |
|
int
|
The channel index. |
required |
|
float
|
The desired primary shading level. |
required |
|
float
|
The desired secondary shading level. |
required |
Returns:
| Type | Description |
|---|---|
dict
|
The response from the cloud. |
set_shutter_level_async
async
¶
Set the shutter level for a functional channel.
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
|
RestConnection
|
The REST connection instance. |
required |
|
str
|
The device ID. |
required |
|
int
|
The channel index. |
required |
|
float
|
The desired shutter level. |
required |
Returns:
| Type | Description |
|---|---|
dict
|
The response from the cloud. |
set_shutter_stop_async
async
¶
Stop the shutter for a functional channel.
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
|
RestConnection
|
The REST connection instance. |
required |
|
str
|
The device ID. |
required |
|
int
|
The channel index. |
required |
Returns:
| Type | Description |
|---|---|
dict
|
The response from the cloud. |
set_simple_rgb_color_dim_level_async
async
¶
Set the simple RGB color and dim level for a functional channel.
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
|
RestConnection
|
The REST connection instance. |
required |
|
str
|
The device ID. |
required |
|
int
|
The channel index. |
required |
|
str
|
The RGB color as string. Possible values are defined in the RGBColorState enum. |
required |
|
float
|
The desired dim level (0.0 to 1.0). |
required |
Returns:
| Type | Description |
|---|---|
dict
|
The response from the cloud. |
set_simple_rgb_color_dim_level_with_time_async
async
¶
Set the RGB color and dim level with on and ramp time for a functional channel.
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
|
RestConnection
|
The REST connection instance. |
required |
|
str
|
The device ID. |
required |
|
int
|
The channel index. |
required |
|
str
|
The RGB color as string. Possible values are defined in the RGBColorState enum. |
required |
|
float
|
The desired dim level (0.0 to 1.0). |
required |
|
float
|
The on time in seconds. |
required |
|
float
|
The ramp time in seconds. |
required |
Returns:
| Type | Description |
|---|---|
dict
|
The response from the cloud. |
set_siren_water_alarm_trigger_async
async
¶
Set the siren water alarm trigger.
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
|
RestConnection
|
The REST connection instance. |
required |
|
str
|
The device ID. |
required |
|
int
|
The channel index. |
required |
|
str
|
The siren water alarm trigger as string. Possible values are defined in the WaterAlarmTrigger enum. |
required |
Returns:
| Type | Description |
|---|---|
dict
|
The response from the cloud. |
set_slats_level_async
async
¶
Set the slats level for a functional channel.
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
|
RestConnection
|
The REST connection instance. |
required |
|
str
|
The device ID. |
required |
|
int
|
The channel index. |
required |
|
float
|
The desired slats level. |
required |
|
float
|
The desired shutter level (optional). |
required |
Returns:
| Type | Description |
|---|---|
dict
|
The response from the cloud. |
set_sound_file_volume_level_async
async
¶
Set the sound file and volume level for a MP3 notification channel (HmIP-MP3P).
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
|
RestConnection
|
The REST connection instance. |
required |
|
str
|
The device ID. |
required |
|
int
|
The channel index. |
required |
|
str
|
The sound file to play. Possible values: INTERNAL_SOUNDFILE, SOUNDFILE_001 through SOUNDFILE_252, RANDOM_SOUNDFILE, DISABLE_ACOUSTIC_SIGNAL. |
required |
|
float
|
The desired volume level (0.0 to 1.0). |
required |
Returns:
| Type | Description |
|---|---|
dict
|
The response from the cloud. |
set_switch_state_async
async
¶
Set the switch state for a functional channel.
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
|
RestConnection
|
The REST connection instance. |
required |
|
str
|
The device ID. |
required |
|
int
|
The channel index. |
required |
|
bool
|
The desired switch state (True for ON, False for OFF). |
required |
Returns:
| Type | Description |
|---|---|
dict
|
The response from the cloud. |
set_watering_switch_state_async
async
¶
Set the watering switch state for a functional channel.
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
|
RestConnection
|
The REST connection instance. |
required |
|
str
|
The device ID. |
required |
|
int
|
The channel index. |
required |
|
bool
|
The desired watering state (True for active, False for inactive). |
required |
Returns:
| Type | Description |
|---|---|
dict
|
The response from the cloud. |
set_watering_switch_state_with_time_async
async
¶
Set the watering switch state for a functional channel with a specific watering time.
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
|
RestConnection
|
The REST connection instance. |
required |
|
str
|
The device ID. |
required |
|
int
|
The channel index. |
required |
|
bool
|
The desired watering state (True for active, False for inactive). |
required |
|
float
|
The watering time in seconds. |
required |
Returns:
| Type | Description |
|---|---|
dict
|
The response from the cloud. |
start_light_scene_async
async
¶
Start a light scene for a functional channel.
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
|
RestConnection
|
The REST connection instance. |
required |
|
str
|
The device ID. |
required |
|
int
|
The channel index. |
required |
|
int
|
The ID of the light scene. |
required |
|
float
|
The desired dim level (0.0 to 1.0). |
required |
Returns:
| Type | Description |
|---|---|
dict
|
The response from the cloud. |
toggle_watering_state_async
async
¶
Toggle the watering state for a functional channel.
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
|
RestConnection
|
The REST connection instance. |
required |
|
str
|
The device ID. |
required |
|
int
|
The channel index. |
required |
Returns:
| Type | Description |
|---|---|
dict
|
The response from the cloud. |