User's Manual

USER MANUAL
PTM 215ZE – 2.4 GHz IEEE 802.15.4 Pushbutton Transmitter Module
© 2022 EnOcean | www.enocean.com F-710-017, V1.0 PTM 215ZE User Manual | v1.0 | March 2022 | Page 20/43
5.3 Commissioning Telegram Format
Figure 11 below shows the MAC payload structure for commissioning telegrams.
Figure 11 – MAC Payload structure for commissioning telegrams
The following fields are used for commissioning telegrams:
Telegram Control (1 byte)
The Telegram Control field is set to 0x0C to identify a standard telegram (secure commu-
nication will be established based on the commissioning telegram)
Source ID (4 bytes)
The Source ID field contains a 4 byte ID uniquely identifying each PTM 215ZE device
Command (1 byte)
The Command field is set to 0xE0 to identify this command as commissioning command
Device Type (1 byte)
The Device Type field is set to 0x02 to identify PTM 215ZE as ON / OFF switch
Device Options (2 byte)
The Device Options field is set to 0xF281 to identify the device as PTM 215ZE communi-
cating securely using the AES128 (CBC mode) algorithm and a 4 byte sequence counter
to generate a 4 byte signature
Encrypted Device-unique Security Key (16 bytes)
Each PTM 215ZE contains a random, device-specific security key which is generated as
part of the production flow. During commissioning, this key is transmitted in encrypted
form as specified by the zigbee Green Power specification.
Security Key Validation (4 bytes)
In order to ensure correct reception, an additional 4 byte validation value is provided.
Sequence Counter (4 bytes)
The Sequence Counter is an always incrementing counter which is used as part of the
security processing to avoid replay attacks (sending the same telegram again).
Receiving devices shall only accept data telegrams with sequence counter values higher
than that of the last received telegram; therefore the current value needs to be commu-
nicated during commissioning.