Skip to content

Commit c646730

Browse files
danielperna84fabaff
authored andcommitted
Added path-setting and Intertechno information (home-assistant#3531)
* Added path-setting and Intertechno information * Minor change
1 parent d00955a commit c646730

File tree

1 file changed

+12
-3
lines changed

1 file changed

+12
-3
lines changed

source/_components/homematic.markdown

Lines changed: 12 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -14,9 +14,10 @@ featured: false
1414
---
1515

1616

17-
The [Homematic](http://www.homematic.com/) component provides bi-directional communication with your CCU/Homegear. It uses a XML-RPC connection to set values on devices and subscribes to receive events the devices and the CCU emit.
17+
The [Homematic](http://www.homematic.com/) component provides bi-directional communication with your CCU/Homegear. It uses a XML-RPC connection to set values on devices and subscribes to receive events the devices and the CCU emit.
18+
If you are using Homegear with paired [Intertechno](http://intertechno.at/) devices, uni-directional communication is possible as well.
1819

19-
Device support is available for most of the wired and wireless devices, as well as a few IP devices. If you have a setup with mixed protocols, you have to configure additional hosts with the appropriate ports. The default is using port 2001, which are wireless devices. Wired devices usually are available through port 2000 and IP devices through port 2010.
20+
Device support is available for most of the wired and wireless devices, as well as a few IP devices. If you have a setup with mixed protocols, you have to configure additional hosts with the appropriate ports. The default is using port 2001, which are wireless devices. Wired devices usually are available through port 2000 and IP devices through port 2010. The virtual thermostatgroups the CCU provides use port 9292 **and** require you to set the `path` setting to `/groups`.
2021

2122
If you want to see if a specific device you have is supported, head over to the [pyhomematic](https://github.com/danielperna84/pyhomematic/tree/master/pyhomematic/devicetypes) repository and browse through the source code. A dictionary with the device identifiers (e.g. HM-Sec-SC-2) can be found within the relevant modules near the bottom. If your device is not supported, feel free to contribute.
2223

@@ -41,14 +42,15 @@ Configuration variables (global):
4142
Configuration variables (host):
4243
4344
- **ip** (*Required*): IP address of CCU/Homegear device.
44-
- **port** (*Optional*): Port of CCU/Homegear XML-RPC Server. Default is 2001, use 2000 for wired and 2010 for IP.
45+
- **port** (*Optional*): Port of CCU/Homegear XML-RPC Server. Wireless: 2001, wired: 2000, IP: 2010, thermostatgroups: 9292.
4546
- **callback_ip** (*Optional*): Set this, if Home Assistant is reachable under a different IP from the CCU (NAT, Docker etc.).
4647
- **callback_port** (*Optional*): Set this, if Home Assistant is reachable under a different port from the CCU (NAT, Docker etc.).
4748
- **resolvenames** (*Optional*): [`metadata`, `json`, `xml`] Try to fetch device names. Defaults to `false` if not specified.
4849
- **username** (*Optional*): When fetching names via JSON-RPC, you need to specify a user with guest-access to the CCU.
4950
- **password** (*Optional*): When fetching names via JSON-RPC, you need to specify the password of the user you have configured above.
5051
- **primary** (*Optional*): Set to `true` when using multiple hosts and this host should provide the services and variables.
5152
- **variables** (*Optional*): Set to `true` if you want to use CCU2/Homegear variables. Should only be enabled for the primary host. When using a CCU credentials are required.
53+
- **path** (*Optional*): Set to `/groups` when using port 9292.
5254

5355
#### Example configuration with multiple protocols and some other options set:
5456

@@ -71,6 +73,13 @@ homematic:
7173
ip:
7274
ip: 127.0.0.1
7375
port: 2010
76+
groups:
77+
ip: 127.0.0.1
78+
port: 9292
79+
resolvenames: json
80+
username: Admin
81+
password: secret
82+
path: /groups
7483
```
7584

7685
### {% linkable_title The `resolvenames` option %}

0 commit comments

Comments
 (0)