Skip to content

Commit

Permalink
fsr14m-2x support added
Browse files Browse the repository at this point in the history
  • Loading branch information
grimmpp committed Jul 9, 2024
1 parent 1ba931f commit 5cfb622
Show file tree
Hide file tree
Showing 4 changed files with 105 additions and 6 deletions.
6 changes: 3 additions & 3 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -36,15 +36,15 @@ Elatko devices are exemplarily mentioned. You can find [here](https://www.eltako
* A5-09-0C (Air Quality / VOC⁠ (Volatile Organic Compounds) e.g. [FLGTF](https://github.com/grimmpp/home-assistant-eltako/tree/main/docs/flgtf_temp_humidity_air_quality/readme.md))
* A5-10-06 (Temperature Sensor and Controller e.g. FUTH)
* A5-10-12 (Temperature Sensor and Controller and Humidity Sensor e.g. FUTH)
* A5-12-01 (Automated meter reading - electricity, FSDG14)
* A5-12-01 (Automated meter reading - electricity, FSDG14, [FSR14M-2x](https://github.com/grimmpp/home-assistant-eltako/tree/main/docs/relays-and-switches/readme.md))
* A5-12-02 (Automated meter reading - gas, F3Z14D)
* A5-12-03 (Automated meter reading - water, F3Z14D)
* A5-13-01 (Weather station, FWG14)
* F6-10-00 (Window handle, classic switches or contacs via FTS14EM, window and door contacts like FTKE, supported states: open, closed, tilt)
* [Light](https://github.com/grimmpp/home-assistant-eltako/tree/main/docs/lights-tutorial/readme.md)
* A5-38-08 (Dimmable Light: Central command - gateway, FUD14)
* M5-38-08 (Switchable Light: Eltako relay, FSR14)
* Switch
* [Switch](https://github.com/grimmpp/home-assistant-eltako/tree/main/docs/relays-and-switches/readme.md)
* M5-38-08 (Eltako relay, FSR14)
* F6-02-01 and F6-02-02
* Cover
Expand All @@ -54,7 +54,7 @@ Elatko devices are exemplarily mentioned. You can find [here](https://www.eltako
* [Light](https://github.com/grimmpp/home-assistant-eltako/tree/main/docs/lights-tutorial/readme.md)
* A5-38-08 (Central command - gateway, FUD14) PREFERRED!!!
* F6-02-01 and F6-02-02 (Rocker switch - function 02 'direct pushbutton top on' default left) / (only as switch not for dimmable lights.)
* Switch
* [Switch](https://github.com/grimmpp/home-assistant-eltako/tree/main/docs/relays-and-switches/readme.md)
* A5-38-08 (Central command) PREFERRED!!!
* F6-02-01 and F6-02-02 (Rocker switch - function 02 'direct pushbutton top on' default left)
* Cover
Expand Down
6 changes: 3 additions & 3 deletions docs/lights-tutorial/readme.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,9 +6,9 @@ This tutorial describes how to configure a light so that its status updates will

## Configure Home Assistant (Eltako FSR14*, FUD14*, FSR61*, ...)

Every Eltako devices which shall be represented in Home Assistant need to be entered into the Home Assistant configuration (`/config/configuration.yaml`). Find details about how to configure Home Assistant for this integration manually [here](../update_home_assistant_configuration.md). You can also auto-generate the confuguration by using [EnOcean Device Manager (eo_man)](https://github.com/grimmpp/enocean-device-manager)
Every Eltako devices which shall be represented in Home Assistant need to be entered into the Home Assistant configuration (`/config/configuration.yaml`). Find details about how to configure Home Assistant for this integration manually [here](../update_home_assistant_configuration.md). You can also auto-generate the configuration by using [EnOcean Device Manager (eo_man)](https://github.com/grimmpp/enocean-device-manager)

For lights you need to create an entries in the light section. You need to specify the id/address of the device so that Home Assistant knows when a status update/change comes by and needs to react on it. In addition we need to specify the address of the sender button in Home Assistant. A good pattern for the sender id/address is to use a base id + the same local id of the light. EEPs define the type of telegram. In case of light and series 14 devices I wouldn't change this behavior.
For lights you need to create an entries in the light section. You need to specify the id/address of the device so that Home Assistant knows when a status update/change comes by and when it needs to react on it. In addition we need to specify the id/address of the sender button in Home Assistant. A good pattern for the sender id/address is to use a base id + the same local id of the light. EEPs define the type of telegram. In case of light and series 14 devices I wouldn't change this behavior.

The configuration could look like the following for USB300 as a gateway.
```
Expand All @@ -27,7 +27,7 @@ eltako:
eep: A5-38-08
```

In case of being directly connected via cable the use a local address space (baseId = 00-00-00-00):
In case of being directly connected via cable a local address space is used:
```
eltako:
gateway:
Expand Down
Binary file added docs/relays-and-switches/fsr14m-2x.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
99 changes: 99 additions & 0 deletions docs/relays-and-switches/readme.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,99 @@
# Integrated Relays and Switches with Eltako FSR14*, FSR61, ...

This tutorial describes how to configure a switches for e.g. lights, electric socket, ... to power on and off devices connected so that they can be monitored and controlled additionally from Home Assistant.

<img src="fsr14m-2x.png" width="50%">

## Configure Home Assistant (Eltako FSR14*, FUD14*, FSR61*, ...)

Every Eltako devices which shall be represented in Home Assistant need to be entered into the Home Assistant configuration (`/config/configuration.yaml`). Find details about how to configure Home Assistant for this integration manually [here](../update_home_assistant_configuration.md). You can also auto-generate the configuration by using [EnOcean Device Manager (eo_man)](https://github.com/grimmpp/enocean-device-manager)

For lights or switches you need to create an entries in the light or switch section. You need to specify the id/address of the device so that Home Assistant knows when a status update/change comes by and when it needs to react on it. In addition we need to specify the id/address of the sender button in Home Assistant. A good pattern for the sender id/address is to use a base id + the same local id of the light. EEPs define the type of telegram.

The configuration could look like the following for USB300 as a gateway.
```
### auto-generated by eo_man
eltako:
gateway:
- id: 1
device_type: enocean-usb300
base_id: FF-80-80-00 # baseId of USB300 gateway
devices:
switch: # can be replaced through 'light' which is a different representation in Home Assistant
# Eltako relay
# Use 'Write HA senders to devices' button or enter manually sender id in PCT14 into function group 2 with function 51
- id: FF-AA-00-01 # baseId of FAM14 (FF-AA-00-00) + internal address
name: FSR14M_2X 00-00-00-01 (1/2)
eep: M5-38-08
sender:
id: FF-80-80-01 # baseId of USB300 (FF-80-80-00) + sender id (0-80 HEX/128 DEZ)
eep: A5-38-08
# Eltako relay
# Use 'Write HA senders to devices' button or enter manually sender id in PCT14 into function group 2 with function 51
- id: FF-AA-00-02
name: FSR14M_2X 00-00-00-02 (2/2)
eep: M5-38-08
sender:
eep: A5-38-08
id: FF-80-80-02
```

In case of being directly connected via cable a local address space is used:
```
### auto-generated by eo_man
eltako:
gateway:
- id: 1
device_type: fgw14usb
base_id: FF-AA-00-00 # baseId of FAM14 (because this is the device connected to wireless network)
devices:
switch: # can be replaced through 'light' which is a different representation in Home Assistant
# Eltako relay
# Use 'Write HA senders to devices' button or enter manually sender id in PCT14 into function group 2 with function 51
- id: 00-00-00-01
name: FSR14M_2X 00-00-00-01 (1/2)
eep: M5-38-08
sender:
eep: A5-38-08
id: 00-00-B0-01
# Eltako relay
# Use 'Write HA senders to devices' button or enter manually sender id in PCT14 into function group 2 with function 51
- id: 00-00-00-02
name: FSR14M_2X 00-00-00-02 (2/2)
eep: M5-38-08
sender:
eep: A5-38-08
id: 00-00-B0-02
```

## Usage of power meter from FSR14M-2x

FSR14M-2x additional provides information about the current power consumption. To get the power consumption display in Home Assistant an additional sensor needs to be specified:

This example is snipped of an auto-generated configuration by (eo_man)](https://github.com/grimmpp/enocean-device-manager) for a cable connected gateway using local addresses.

```
### auto-generated by eo_man
sensor:
# Automated meter reading - electricity / power
- id: 00-00-00-01
name: FSR14M_2X 00-00-00-01 (1/2)
eep: A5-12-01
meter_tariffs: []
# Automated meter reading - electricity / power
- id: 00-00-00-02
name: FSR14M_2X 00-00-00-02 (2/2)
eep: A5-12-01
meter_tariffs: []
```

0 comments on commit 5cfb622

Please sign in to comment.