What can we improve?

Documentation

Translation is in progress...
Not all topics are available at the moment and content links may be broken.

HomeMatic

This guide will help you to connect your Central Control Unit (CCU) to your computer as quickly and easily in order to create the conditions to use IP-Symcon to control multiple devices. The bidirectional HomeMatic radio system offers a wide range of products from the areas of heating, air, weather, environment, safety, comfort and the most used: the lighting control. All sensors and actuators (switches) can communicate with each other. If a switching command is not executed, an error message will be generated. This is a security feature that was decisive that many HomeMatic customers have opted for this product. The heart of the system is the central unit (CCU). In it works, a small Linux PC, which automatically takes over small control tasks - even when the Windows PC is turned off. CCU has its own web interface and the functions are available to the user. The connection to IP-Symcon takes place via the LAN interface of the 'CCU' or optionally via the cheaper 'LAN Configuration Adapter'.

Advantages of the CCU:

  • HomeMatic Wired RS485 components are supported.

  • Programs can run in the CCU.

  • Status of the actuators can be queried by script.

HomeMatic is also available as "wired system". For this switching and dimming actuators and input and output modules are available. IP-Symcon supports all wireless and tethered components.

Step 1: Design

Take your CCU from the package and attach a suitable mounting option for your application purpose.

Possibility 1: Base (Foot is pushed from the rear into the grooves on the underside of the control panel.)

Possibility 2: Wall installation (Mount the holder with the attached screws in the appropriate height, whereby the side must be with only one hole and one latch upwards.)

Step 2: Connection

Insert the supplied batteries into the CCU. Pay attention to the correct polarity. The batteries are for buffering when the mains fails. Connect the power cord. The socket for the hollow plug is located at the central office. Now connect your CCU via a network cable to your network.

The antenna of the central unit is only used for the radio communication with the individual actuators. A wireless connection to a PC is not possible.

(If no network exists, the connection is possible via USB. This represents only a "temporary solution", since the USB driver, which are on the CD, are required. This makes the whole thing more complicated and requires an existing CD-ROM drive. Therefore, no more information about the USB connection are given.)

Step 3: Installation

If your head unit is connected correctly and you are using a DHCP server, then your console is now connected to your network. (The DHCP server automatically takes over the address assignment for the network users, so you do not need to worry about nothing else.) If no DHCP server is available, you can also manually enter an IP address in the menu of the center under the menu item "Network." Also the subnet mask and the standard gateway should be awarded. Now click on the Start icon on your Windows PC, then click "Computer" and then on "Network." Your Central will now appear under "Other Devices" as "HomeMatic Central".

If your CCU does not appear on your network, unplug the power cord of the Central for 30 seconds, let it boot up again and then click again on the network.

Now click on "HomeMatic Central". This will open a window. At the bottom of this window, see the IP address of the CCU. (Optional is it to find in the menu of the CCU.) Copy this as address into your browser, so that a HomeMatic webpage opens.

Step 4: Adding secondary units

On the HomeMatic webpage you can quite easily connect your secondary HomeMatic devices (e.g. temperature sensors, adapter, remote control, etc.) with your CCU. For this you just need to click on "train devices" (top right) and follow the instructions.

HomeMatic

That's a wrap! Now you can finally turn to IP-Symcon.

Step 5: Connection of the CCU with IP-Symcon

After installation the software by using your user name and your keys (via e-mail from IP-Symcon), you can now connect with your CCU with IP-Symcon. To do this, open the IP-Symcon console (on your desktop). Then connect to one of the IP-Symcon server. Then click on "Create Configuration" and go to "HomeMatic Configuration", click twice on "next" once on "OK" and then on the gear (bottom left).

This opens the configuration of the "HomeMatic sockets". Then you have to make a tick by "open socket". In mode, "CCU mode" must be displayed and by "host" enter the IP address of the CCU (these can also be found in the menu of the CCU). Then press "OK".

HomeMatic-Socket

In the window in the middle now appear different devices. The upper devices are neglecting for now. Interesting are the last listed device, because these can be used immediately (e.g. dimmers).

HomeMatic: Konfigurator nutzen

Use Configuration:
Since IP-Symcon 02.03 # 1776, you can arrange your HomeMatic devices via a configurator, which automatically locates all your devices from the CCU/ LAN adapter configuration. Unfortunately it is not possible to read the name of the configuration. The configurator gives you a good overview of the already established, duplicate or erroneous set up devices and new devices that can be created.

Now click on "Welcome" (bottom left) and then under "WebFront" on "open WebFront". Your browser will then open the interface of IP-Symcon and then you can e.g. dim your living room lights.

Your rear channel may not work, if you now e.g. switch your living room lighting off, it will not be visualized in your IP-Symcon interface. This little problem is to resolve quickly, because it is only caused by the Windows Firewall. Click the Windows Start icon, then click "Control Panel", then "System and Security" and then on "Windows Firewall". Now press "Allow a program or feature through Windows Firewall", then "Change settings" and then on "Allow another program ...". If you click on "Browse" to search for the IP-Symcon (IP-Symcon Service) file, then click "Open". Afterwards the rear channel will work! Another way to avoid the disfunction of the return channel is to ensure that under the firewall settings in the CCU "HomeMatic XML-RPC API" full control is selected or the IP address of the IP-Symcon PCs is entered:

HomeMatic: Konfiguration der CCU

Congratulations! The first steps for an automated home are done.

Optional:

Configuration of the LAN adapter

First the current user software (V 1404 as of August 2010) must be installed on the HomeMatic page. We recommend to use a static IP address (DHCP off):

HomeMatic-LAN-Interface

After successful installation a new directory was created in the PC: "x:\ProgramData\Bidcos-Service\" In the file 'bidcos.conf' the Serial Number (on the label) and the IP address of the adapter must to be adjusted.

Example:

[Interface 0]
Type = Lan Interface
Serial Number = GEQ0123456

# Key is on the back of the interface.
# Function also can be disabled via the LAN tool.
# Then, the field can be left blank. Encryption Key =
Description = First Lan Interface

# IP-Adresse vom LAN Interface
IP Address = 192.168.2.61

Other settings in the bidcos.conf are not required.
Essential is that the following entry is unchanged: # TCP Port for XmlRpc connections
Listen Port = 2001

Test the Adapter

A successful configuration can be checked using the "Test Run BidCos service". The last line in the DOS window is: "... Connected to LAN interface ...".

A blinking power LED indicates a disconnected BidCos service.

If necessary, the boot options can be adjusted (Control Panel> Administrative Tools> Services) or the service to be started manually:

HomeMatic-Adapter testen

That's a wrap! Now you can finally turn to IP-Symcon.

Configure HomeMatic components

In the program "HomeMatic Configurator" must under "File> Preferences" the connection "remote BidCos Service" be selected. After that follows the entry of the IP address (localhost) and the ports (2001). Finally, can now in the menu "Training devices" the HomeMatic components be added successively.

Client Socket in IP-Symcon

The HomeMatic socket (in the I/O instances) must be configured. As Mode select the "LAN Mode". If the BidCoS service is running on another PC, then enter its IP address as host. If several Network adapters should be available, select in the event server the IP address of the network adapers where the LAN apapter is connected. The port (5544) does not to be changed, but will be released only in a possibly existing firewall.

HomeMatic-Socket 2

Tips & Ticks

Here is a final example script for three dimmers, that make a light-scene:

$id_bar = 54392 /*[GF\Table  Bar]*/;
$id_ecken = 24601 /*[GF\Spotlights corners]*/;
$id_tisch = 38758 /*[GF\Table lamp]*/;
 
$ramp = 2;
HM_WriteValueFloat($id_bar, "ON_TIME",  60*10);    // x minutes ON
HM_WriteValueFloat($id_bar, "RAMP_TIME", $ramp);          // X seconds ramp
HM_WriteValueFloat($id_bar , "LEVEL" , .4);             // and run to X%
 
HM_WriteValueFloat($id_ecken , "RAMP_TIME", $ramp);           // X seconds ramp
HM_WriteValueFloat($id_ecken  , "LEVEL" , .4);            // and run to X%
 
HM_WriteValueFloat($id_tisch , "RAMP_TIME", $ramp);         // X seconds ramp
HM_WriteValueFloat($id_tisch  , "LEVEL" , .4);            // and run to X%

Example script WinMatic 60 minutes ventilation:

$id_aktor = 49712 /*[First floor\Bedroom\HM WinMatic]*/;
HM_WriteValueFloat($id_aktor, "SPEED" , 1.0); // Maximum Speed ;)
HM_WriteValueFloat($id_aktor, "RELOCK_DELAY" , 60*60);  // Close window after XX minutes 
HM_WriteValueFloat($id_aktor, "LEVEL" , 0.7); // Open window

Sample script to get a feedback if an actor has performed the switch command correctly:

$id_aktor = 12345;
$err = HM_WriteValueBoolean($id_aktor, "STATE" , False);
//echo "Err: " .(int) $err . "\n";
if ($err === False){
    echo "Error: Switch - Command was not executed\n";
    SetValue($id_done, False);
} else {
    SetValue($id_done, True);
    echo "OK: Switch - Command was executed\n";
}

Sample script to toggle (on and off) an actuator (lamp):

$id_aktor = 25404 /*[Courtyard garden\Lamp]*/;
$id_state = 55194 /*[Courtyard Garden\Lamp\STATE]*/;
HM_WriteValueBoolean($id_aktor, "STATE" , !GetValue($id_state));