User's Manual

USER MANUAL
EnOcean GmbH
Kolpingring 18a
82041 Oberhaching
Germany
Phone [phone]
Fax [phone]
[e-mail]
www.enocean.com
Subject to modifications
PTM 210 / PTM 215 / PTM 21U User Manual
January 2012
Page 14/19
PTM 210 / PTM 215 / PTM 210 U
2.3.2 Secure mode (PTM 215)
In secure mode, PTM 215 sends telegrams with rolling code as specified in the “Security of
EnOcean Radio Networks” specification. When telegrams are not received by the receiver
this may lead to a de-synchronization of transmitter and receiver. In order to prevent fail-
ure, the receiver will usually test if the rolling code is in a defined window and will resyn-
chronize automatically. The size of this rolling code window is set on the receiver side.
The teach-in telegram is described in chapter 4.2 of “Security of EnOcean Radio Networks”.
Type is: 1-PTM
It is sent by simultaneously pressing both contact nipples of rocker A or rocker B and actu-
ating the energy bow. See also 2.3.3.
In operating mode the telegram structure is as follows:
R-ORG-S
8 bit
DATA
8 bit
MAC
24 bit
ID
32 bit
STATUS
8 bit
R-ORG-S : 0x30
DATA : This field is encrypted. After decryption with VAES decryption algorithm
DATA can be interpreted as shown in the table below.
The VAES decryption algorithm is described in the
“Security of EnOcean Radio Networks” specification.
http://www.enocean.com/en/security-specification/
DolphinAPI provides functions for this purpose
MAC : Message authentication code as described in the
“Security of EnOcean Radio Networks” specification.
http://www.enocean.com/en/security-specification/
In order to verify if a telegram is valid the receiver has to calculate the MAC
based on R-ORG-S, encrypted DATA and current rolling code and compare it
with the received MAC value.
DolphinAPI provides functions for this calculation.
ID : Unique 32 bit identifier
STATUS : always 0
DATA after
decryption
with VAES
Description
0x00-0x04
Reserved
0x05
Key A1 and B0 pressed. Polarity PUSH
0x06
3 or 4 keys pressed
0x07
Key A0 and B0 pressed. Polarity PUSH
0x08
No key pressed. Polarity PUSH
0x09
Key A1 and B1 pressed. Polarity PUSH
0x0A
Key A0 and B1 pressed. Polarity PUSH
0x0B
Key B1 pressed. Polarity PUSH
0x0C
Key B0 pressed. Polarity PUSH
0x0D
Key A1 pressed. Polarity PUSH
0x0E
Key A0 pressed. Polarity PUSH
0x0F
Polarity RELEASE for any combination of keys pressed