« Back to Product

Documentation

Home Connect Device

Require: IP-Symcon >= 6.0

Description

When a device is created by the Home Connect configurator, a Home Connect device instance is created which has various status variables depending on the device type.

Control by IP-Symcon

In order to be able to use the devices to the full extent, the remote start and/or remote control must be activated directly on the device. If only the remote control is active, programs and options can be changed, but the program cannot be started. While the device is being operated locally, it cannot be controlled by IP-Symcon.

Status variables

Each device can have 4 different types of variables.

Status

Status type variables are variables that cannot be switched by IP-Symcon.
Examples: Operating status, Local operation active

Setting

Variables of the setting type can usually be switched and are used to change various settings of the device.
Examples: Temperature (refrigerator), Energy status

Program

Each device has only one variable of the type program. This variable can be used to determine which program is to be executed by the device.

Warning

If a program, that is available in the Home Connect app, is not displayed in IP-Symcon, then it is not supported by the API. If such a program is selected manually via the app or the device, then all setting options are grayed out

Options

When a program is selected, corresponding option variables are created that change the details for the selected program.
Examples: Capacity (coffee machine), Duration (oven)

When a program has been selected and the available options have been set, the program can be started using the Control variable.
As soon as a program has been started, depending on the device, variables are created that provide information on the progress.
Examples: Program progress, Remaining runtime

Particularities

  • When creating a device, it should be online and therefore switched on
  • The refrigerator has no programs

Troubleshooting

A device instance is not created correctly

All data of a device can be requested again in the device instance by clicking on the 'Initialize device' button.

Variables are not updated

Click on 'Register server events' to re-establish the connection to the Home Connect service.

Any questions?