After pip is installed, install the module by running
sudo pip install enocean4ha (or sudo pip install git+https://github.com/topic2k/enocean4ha.git if you want the "bleeding edge").
After this, it's just a matter of running enocean_example.py and pressing the
learn button on magnetic contact or temperature switch or pressing the rocker switch.
You should be displayed with a log of the presses, as well as parsed values
(assuming the sensors are the ones provided in the EnOcean Starter Kit).
The example script can be stopped by pressing CTRL+C
Supported profiles
All profiles (should) correspond to the official EEP by EnOcean.
RORG 0xA5 - FUNC 0x20 - TYPE 0x06 - HVAC Components,Harvesting-powered actuator with local temperature offset control
direction: 1
shortcut
description
type
values
CV
Current Valve
value
0.0-100.0 ↔ 0.0-100.0 %
LOM
Local Offset Mode
enum
0 - LO is relative - Offsettemperature
1 - LO is absolute - Absoluttemperature
LO
Local Offset
enum
0-80 - Temperature setpoint °C +/- local offset °C
0x0 - Local Offset 0C
1 - Local Offset 1C
2 - Local Offset 2C
3 - Local Offset 3C
4 - Local Offset 4C
5 - Local Offset 5C
123 - Local Offset -5C
124 - Local Offset -4C
125 - Local Offset -3C
126 - Local Offset -2C
127 - Local Offset -1C
TMP
Temperature
enum
0-160 - Local Ambient or Feed temperature (Selected by Direction 2, DB1.1)
TSL
Tempertature Selection
enum
0 - Ambient Sensor Temperature
1 - Feed Sensor Temperature
ENIE
Energy Input Enabled
enum
0 - Not Harvesting
1 - Harvesting active
ES
Energy Storage
enum
0 - Low - almost discharged
1 - Sufficently charged
DWO
Window open detection
enum
0 - NO window open detected
1 - Window open detected
RCE
Radio Com Error
enum
0 - Radio communication is stable
1 - 6 or more consecutive communication erros have occured
RSS
Radio Signal strength
enum
0 - Radio signal is strong
1 - Radio signal is weak under -77dBm
ACO
Actuator obstructed
enum
0 - Actuator working correctly
1 - Actuator blocked
direction: 2
shortcut
description
type
values
SP
Setpoint
enum
TMP
Room temperature from control unit
value
0.0-160.0 ↔ 0.0-40.0 %
REF
Reference run
enum
0 - Normal operation
1 - Reference run
RFC
RF Communication intervall
enum
0 - Auto
1 - 2 minutes
2 - 5 minutes
3 - 10 minutes
4 - 20 minutes
5 - 30 minutes
6 - 60 minutes
7 - 120 minutes
SB
Initiate summer mode Bit
enum
0 - Normal operation
1 - Summer mode with 8hours radio duty cycle
SPS
Set point selection
enum
0 - Valve position mode
1 - Temperature setpoint
TSL
Temperature Selection
enum
0 - Request ambient temperature
1 - Request feedtemperature
SBY
Standbye
enum
0 - Normal operation
1 - Enter standbye
RORG 0xA5 - FUNC 0x12 - TYPE 0x01 - Electricity
shortcut
description
type
values
MR
current value in W or cumulative value in kWh
value
0.0-16777215.0 ↔ 0.0-16777215.0
TI
Tariff info
value
0.0-15.0 ↔ 0.0-15.0
DT
Current value or cumulative value
enum
0 - kWh
1 - W
DIV
Divisor for value
enum
0 - x/1
1 - x/10
2 - x/100
3 - x/1000
RORG 0xA5 - FUNC 0x30 - TYPE 0x03 - Digital Inputs, Wake and Temperature
shortcut
description
type
values
TMP
Temperature (linear)
value
255.0-0.0 ↔ 0.0-40.0 °C
WA0
Value of wake signal
enum
0 - Low
1 - High
DI3
Digital Input 3
enum
0 - Low
1 - High
DI2
Digital Input 2
enum
0 - Low
1 - High
DI1
Digital Input 1
enum
0 - Low
1 - High
DI0
Digital Input 0
enum
0 - Low
1 - High
RORG 0xA5 - FUNC 0x38 - TYPE 0x08 - Gateway
command: 1
shortcut
description
type
values
COM
Command ID
enum
0-13 - Command ID {value}
TIM
Time in 1/10 seconds. 0 = no time specifed
value
1.0-65535.0 ↔ 0.1-6553.5 s
LCK
Lock for duration time if time >0, unlimited time of no time specified. Locking may be cleared with "unlock". During lock phase no other commands will be accepted or executed
enum
0 - Unlock
1 - Lock
DEL
Delay or duration (if Time > 0); 0 = Duration (Execute switching command immediately and switch back after duration) 1 = Delay (Execute switching command after delay)
enum
0 - Duration
1 - Delay
SW
Switching command ON/OFF
enum
0 - Off
1 - On
command: 2
shortcut
description
type
values
COM
Command ID
enum
0-13 - Command ID {value}
EDIM
Dimming value (absolute [0...255] or relative [0...100])
value
0.0-255.0 ↔ 0.0-255.0 %
RMP
Ramping time in seconds, 0 = no ramping, 1...255 = seconds to 100%
value
0.0-255.0 ↔ 0.0-255.0 s
EDIMR
Dimming Range
enum
0 - Absolute value
1 - Relative value
STR
Store final value
enum
0 - No
1 - Yes
SW
Switching command
enum
0 - Off
1 - On
VLD Telegram (0xD2)
RORG 0xD2 - FUNC 0x01 - TYPE 0x01 - Electronic switch with Local Control
command: 4
shortcut
description
type
values
PF
Power Failure
enum
0 - Power Failure Detection disabled/not supported
1 - Power Failure Detection enabled
PFD
Power Failure Detection
enum
0 - Power Failure Detection not detected/not supported/disabled
1 - Power Failure Detection Detected
CMD
Command indentifier
enum
0-13 - Command ID {value}
OC
Over current switch off
enum
0 - Over current switch off: ready / not supported
1 - Over current switch off: executed
EL
Error level
enum
0 - Error level 0: hardware OK
1 - Error level 1: hardware warning
2 - Error level 2: hardware failure
3 - Error level not supported
IO
I/O channel
enum
0-29 - Output channel {value} (to load)
30 - Not applicable, do not use
31 - Input channel (from mains supply)
LC
Local control
enum
0 - Local control disabled / not supported
1 - Local control enabled
OV
Output value
enum
0 - Output value 0% or OFF
1-100 - Output value {value}% or ON
101-126 - Not used
127 - output value not valid / not set
command: 1
shortcut
description
type
values
CMD
Command indentifier
enum
0-13 - Command ID {value}
DV
Dim value
enum
0 - Switch to new output value
1 - Dim to new output level - dim timer 1
2 - Dim to new output level - dim timer 2
3 - Dim to new output level - dim timer 3
4 - Stop dimming
IO
I/O channel
enum
0-29 - Output channel {value} (to load)
30 - All output channels supported by the device
31 - Input channel (from mains supply)
OV
Output value
enum
0 - Output value 0% or OFF
1-100 - Output value {value}% or ON
101-126 - Not used
127 - output value not valid / not set
RORG 0xD2 - FUNC 0x01 - TYPE 0x0E - Electronic switch with Local Control
command: 4
shortcut
description
type
values
PF
Power Failure
enum
0 - Power Failure Detection disabled/not supported
1 - Power Failure Detection enabled
PFD
Power Failure Detection
enum
0 - Power Failure Detection not detected/not supported/disabled
1 - Power Failure Detection Detected
CMD
Command indentifier
enum
0-13 - Command ID {value}
OC
Over current switch off
enum
0 - Over current switch off: ready / not supported
1 - Over current switch off: executed
EL
Error level
enum
0 - Error level 0: hardware OK
1 - Error level 1: hardware warning
2 - Error level 2: hardware failure
3 - Error level not supported
IO
I/O channel
enum
0-29 - Output channel {value} (to load)
30 - Not applicable, do not use
31 - Input channel (from mains supply)
LC
Local control
enum
0 - Local control disabled / not supported
1 - Local control enabled
OV
Output value
enum
0 - Output value 0% or OFF
1-100 - Output value {value}% or ON
101-126 - Not used
127 - output value not valid / not set
command: 1
shortcut
description
type
values
CMD
Command indentifier
enum
0-13 - Command ID {value}
DV
Dim value
enum
0 - Switch to new output value
1 - Dim to new output level - dim timer 1
2 - Dim to new output level - dim timer 2
3 - Dim to new output level - dim timer 3
4 - Stop dimming
IO
I/O channel
enum
0-29 - Output channel {value} (to load)
30 - All output channels supported by the device
31 - Input channel (from mains supply)
OV
Output value
enum
0 - Output value 0% or OFF
1-100 - Output value {value}% or ON
101-126 - Not used
127 - output value not valid / not set
command: 6
shortcut
description
type
values
CMD
Command indentifier
enum
0-13 - Command ID {value}
qu
Measurement to query
enum
0 - Query energy
1 - Query power
IO
I/O channel
enum
0-29 - Output channel {value} (to load)
30 - All output channels supported by the device
31 - Input channel (from mains supply)
command: 7
shortcut
description
type
values
CMD
Command indentifier
enum
0-13 - Command ID {value}
UN
Unit
enum
0 - Ws
1 - Wh
2 - kWh
3 - W
4 - kW
5-7 - Not used
IO
I/O channel
enum
0-29 - Output channel {value} (to load)
30 - Not applicable, do not use
31 - Input channel (from mains supply)
MV
Measurement value
value
1.0-4294967295.0 ↔ 1.0-4294967295.0 None
RORG 0xD2 - FUNC 0x01 - TYPE 0x0F - Electronic switch with Local Control
command: 4
shortcut
description
type
values
PF
Power Failure
enum
0 - Power Failure Detection disabled/not supported
1 - Power Failure Detection enabled
PFD
Power Failure Detection
enum
0 - Power Failure Detection not detected/not supported/disabled
1 - Power Failure Detection Detected
CMD
Command indentifier
enum
0-13 - Command ID {value}
OC
Over current switch off
enum
0 - Over current switch off: ready / not supported
1 - Over current switch off: executed
EL
Error level
enum
0 - Error level 0: hardware OK
1 - Error level 1: hardware warning
2 - Error level 2: hardware failure
3 - Error level not supported
IO
I/O channel
enum
0-29 - Output channel {value} (to load)
30 - Not applicable, do not use
31 - Input channel (from mains supply)
LC
Local control
enum
0 - Local control disabled / not supported
1 - Local control enabled
OV
Output value
enum
0 - Output value 0% or OFF
1-100 - Output value {value}% or ON
101-126 - Not used
127 - output value not valid / not set
command: 1
shortcut
description
type
values
CMD
Command indentifier
enum
0-13 - Command ID {value}
DV
Dim value
enum
0 - Switch to new output value
1 - Dim to new output level - dim timer 1
2 - Dim to new output level - dim timer 2
3 - Dim to new output level - dim timer 3
4 - Stop dimming
IO
I/O channel
enum
0-29 - Output channel {value} (to load)
30 - All output channels supported by the device
31 - Input channel (from mains supply)
OV
Output value
enum
0 - Output value 0% or OFF
1-100 - Output value {value}% or ON
101-126 - Not used
127 - output value not valid / not set
command: 6
shortcut
description
type
values
CMD
Command indentifier
enum
0-13 - Command ID {value}
qu
Measurement to query
enum
0 - Query energy
1 - Query power
IO
I/O channel
enum
0-29 - Output channel {value} (to load)
30 - All output channels supported by the device
31 - Input channel (from mains supply)
command: 7
shortcut
description
type
values
CMD
Command indentifier
enum
0-13 - Command ID {value}
UN
Unit
enum
0 - Ws
1 - Wh
2 - kWh
3 - W
4 - kW
5-7 - Not used
IO
I/O channel
enum
0-29 - Output channel {value} (to load)
30 - Not applicable, do not use
31 - Input channel (from mains supply)
MV
Measurement value
value
1.0-4294967295.0 ↔ 1.0-4294967295.0 None
RORG 0xD2 - FUNC 0x01 - TYPE 0x12 - Electronic switch with Local Control
command: 4
shortcut
description
type
values
PF
Power Failure
enum
0 - Power Failure Detection disabled/not supported
1 - Power Failure Detection enabled
PFD
Power Failure Detection
enum
0 - Power Failure Detection not detected/not supported/disabled
1 - Power Failure Detection Detected
CMD
Command indentifier
enum
0-13 - Command ID {value}
OC
Over current switch off
enum
0 - Over current switch off: ready / not supported
