Enocean Ptm 215ze User manual

USER MANUAL

PTM 215ZE - 2.4 GHz Zigbee Pushbutton Switch Transmitter Module

Patent protected:

WO98/36395, DE 100 25 561, DE 101 50 128,

WO 2004/051591, DE 103 01 678 AI, DE 10309334,

WO 04/109236, WO 05/096482, WO 02/095707,

US 6,747,573, US 7,019,241

Observe precautions! Electrostatic sensitive devices!

PTM 215ZE

2.4 GHz Zigbee®Pushbutton Switch Transmitter Module

25 May 2023

USER MANUAL

PTM 215ZE - 2.4 GHz Zigbee Pushbutton Switch Transmitter Module

REVISION HISTORY

The following major modifications and improvements have been made to this document:

Version

Author

Reviewer

Date

Major Changes

1.0

MKA

08 Mar 2022

Initial Release

1.1

MKA

11 Apr 2022

Added FCC and ISED grant

1.2

MKA

25 May 2023

Added information on revision DB

Published by EnOcean GmbH, Kolpingring 18a, 82041 Oberhaching, Germany

www.enocean.com, info@enocean.com, phone +49 (89) 6734 6890

Important!

This information describes the type of component and shall not be considered as assured

characteristics. No responsibility is assumed for possible omissions or inaccuracies. Circuitry

and specifications are subject to change without notice. For the latest product specifications,

refer to the EnOcean website: http://www.enocean.com.

As far as patents or other rights of third parties are concerned, liability is only assumed for

modules, not for the described applications, processes and circuits.

EnOcean does not assume responsibility for use of modules described and limits its liability to

the replacement of modules determined to be defective due to workmanship. Devices or sys-

tems containing RF components must meet the essential requirements of the local legal au-

thorities.

The modules must not be used in any relation with equipment that supports, directly or indi-

rectly, human health or life or with applications that can result in danger for people, animals

or real value.

Components of the modules are considered and should be disposed of as hazardous waste.

Local government regulations are to be observed.

Packing: Please use the recycling operators known to you.

 
USER MANUAL 
 
 
 
PTM 215ZE - 2.4 GHz Zigbee Pushbutton Switch Transmitter Module 
© EnOcean | www.enocean.com F-710-017, V1.0 PTM 215ZE User Manual | v1.8 | May 2023 | Page 3/50 
TABLE OF CONTENT 
 
1General description ........................................................................................5 
1 Basic functionality..........................................................................................5 
2 Technical data ...............................................................................................6 
3 Physical dimensions .......................................................................................6 
4 Environmental conditions................................................................................6 
5 Packaging information ....................................................................................6 
6 Ordering information......................................................................................6 
2Functional information....................................................................................7 
1 PTM 215ZE device overview ............................................................................7 
2 Basic functionality..........................................................................................7 
3 Block diagram ...............................................................................................8 
4 User interface ...............................................................................................9 
3Radio communication ...................................................................................10 
1 PTM 215ZE radio channel parameters.............................................................10 
2 Telegram structure ......................................................................................11 
2.1 IEEE 802.15.4 PHY Header ....................................................................12 
2.2 IEEE 802.15.4 MAC Header ...................................................................13 
2.3 IEEE 802.15.4 MAC Trailer ....................................................................13 
3 IEEE 802.15.4 payload (ZGP telegram data) ...................................................14 
3.1 Data telegram .....................................................................................14 
3.1.1 Zigbee Green Power device models .....................................................14 
3.1.1 Command-based device models ..........................................................15 
3.1.2 Generic Switch device model ..............................................................17 
3.2 Commissioning telegram.......................................................................18 
3.2.1 Format for command-based models without Application Info ..................18 
3.2.2 Format for command-based models with Application Info .......................19 
3.2.3 Format for Generic Switch model ........................................................20 
3.3 Decommissioning telegram ...................................................................21 
4 Telegram authentication ...............................................................................22 
4.1 Authentication implementation ..............................................................22 
4.2 Algorithm parameters...........................................................................23 
5 Security Keys ..............................................................................................25 
5.1 User-defined Installation Code (IC) ........................................................25 
6 Commissioning ............................................................................................26 
6.1 Commissioning modes ..........................................................................26 
6.2 Direct commissioning by button press.....................................................27 
6.2.1 Commissioning request ......................................................................27 
6.2.2 Radio channel confirmation.................................................................28 
6.2.3 Example of direct commissioning.........................................................28 
6.2.4 Enabling direct commissioning ............................................................28 
6.3 Sequential commissioning by button press ..............................................29 
6.3.1 Commissioning request ......................................................................29 
6.3.2 Example of sequential commissioning ..................................................30 

 
USER MANUAL 
 
 
 
PTM 215ZE - 2.4 GHz Zigbee Pushbutton Switch Transmitter Module 
© EnOcean | www.enocean.com F-710-017, V1.0 PTM 215ZE User Manual | v1.8 | May 2023 | Page 4/50 
6.3.3 Disabling sequential commissioning .....................................................31 
6.4 Sequential versus direct commissioning ..................................................31 
6.5 Disabling commissioning by button press ................................................31 
6.6 Disabling channel change by button press ...............................................32 
7 Factory reset...............................................................................................32 
4NFC interface ..............................................................................................33 
1 NFC access protection ..................................................................................33 
2 Using the NFC interface ................................................................................34 
2.1 PC-based configuration .........................................................................34 
2.2 Mobile app configuration .......................................................................34 
5Device integration........................................................................................35 
1 Mechanical interface characteristics ...............................................................35 
2 Mechanical interface drawings .......................................................................35 
3 Device label ................................................................................................41 
3.1 Installation QR code .............................................................................42 
6Application information.................................................................................43 
1 Transmission range......................................................................................43 
7Regulatory information .................................................................................44 
1 RED for the European market........................................................................44 
2 FCC (United States) .....................................................................................45 
2.1 Certificate ...........................................................................................45 
2.2 Regulatory Statement...........................................................................46 
3 ISED (former Industry Canada) .....................................................................47 
3.1 Certificate ...........................................................................................47 
3.2 Regulatory Statement...........................................................................48 
3.2.1 English version .................................................................................48 
3.2.2 French version ..................................................................................49 
8Product history ............................................................................................50 
9References..................................................................................................50 
 
 

USER MANUAL

PTM 215ZE - 2.4 GHz Zigbee Pushbutton Switch Transmitter Module

1General description

1.1 Basic functionality

PTM 215ZE enables the realization of energy harvesting wireless switches for systems com-

municating based on the ON / OFF Switch model of the 2.4 GHz Zigbee®Green Power standard

[1].

PTM 215ZE product revision DB integrates an NFC interface which can be used to configure

device parameters. Product revision DA does not provide this functionality.

PTM 215ZE is mechanically compatible with the established PTM 21x form factor enabling

quick integration into a wide range of designs. Key applications are wall-mounted or portable

switches either with up to two rockers or up to four push buttons.

PTM 215ZE pushbutton transmitters are self-powered (no batteries) and fully maintenance-

free. They can therefore be used in all environments including locations that are difficult to

reach or within hermetically sealed housings. The required energy is generated by an electro-

dynamic energy transducer actuated by an energy bow located on the left and right of the

module. This energy bow which can be pushed from outside the module by an appropriate

pushbutton or switch rocker.

When the energy bow is pushed down or released, electrical energy is created and a 2.4GHz

radio telegram according to the Zigbee Green Power standard [1] is transmitted. This radio

telegram transmits the operating status of all four contact nipples when the energy bow was

pushed down or released. PTM 215ZE telegrams are protected with an AES-128 signature

based on a device-unique private key.

Figure 1 below shows PTM 215ZE.

Figure 1 –PTM 215ZE Product Outline

USER MANUAL

PTM 215ZE - 2.4 GHz Zigbee Pushbutton Switch Transmitter Module

1.2 Technical data

Antenna

Integrated antenna

Radio Transmission Power (typ)

+4 dBm

Communication Protocol

Zigbee Green Power (ON / OFF Switch Model)

Radio Band

2.4 GHz (2402 MHz … 2480 MHz)

Supported Radio Channels

Zigbee: Channel 11 … 26 (Default: Channel 11)

Radio Channel Selection

User-selectable (Commissioning)

Device Identification

Individual 32-bit Device ID (factory programmed)

Telegram Authentication

AES128 (CBC Mode) with Sequence Code

Power Supply

Integrated Kinetic Energy Harvester

Button Inputs

Up to four buttons or two rockers

Configuration Interface

NFC ISO 14443 (only in production revision DB)

1.3 Physical dimensions

Module Dimensions

40.0 x 40.0 x 11.2 mm

Module Weight

20 g

1.4 Environmental conditions

Operating Temperature

-25°C ... 65°C

Storage Temperature

-25°C ... 65°C

Humidity

0% to 95% r.h. (non-condensing)

Operation at very low (below 0°C) or very high temperatures (above 40°C) might af-

fect the mechanical behaviour of rocker switches due to mechanical expansion or

contraction of the rockers. Correct operation at such temperatures should be verified

as part of the mechanical design by customers.

1.5 Packaging information

Packaging Unit 100 units

Packaging Method Tray / Box (10 units per tray, 10 trays per box)

1.6 Ordering information

Type

Ordering Code

Frequency

PTM 215ZE:DB

S3271-A216:DB

2.4 GHz Zigbee

USER MANUAL

PTM 215ZE - 2.4 GHz Zigbee Pushbutton Switch Transmitter Module

2Functional information

2.1 PTM 215ZE device overview

The pushbutton transmitter module PTM 215ZE from EnOcean enables the implementation of

wireless remote controls without batteries. Power is provided by a built-in electro-dynamic

power generator.

The outer appearance of PTM 215ZE is shown in Figure 2 below.

Figure 2 –Electro-dynamic powered pushbutton transmitter module PTM 215ZE

2.2 Basic functionality

PTM 215ZE devices contain an electro-dynamic energy transducer which is actuated by an

energy bow (1). This bow is pushed by an appropriate push button, switch rocker or a similar

construction mounted onto the device. An internal spring will release the energy bow as soon

as it is not pushed down anymore.

When the energy bow is pushed down, electrical energy is created and a Zigbee Green Power

radio telegram is transmitted which identifies the status (pressed or not pressed) of the four

button contacts (2). Releasing the energy bow similarly generates energy which is used to

transmit a different radio telegram.

It is therefore possible to distinguish between radio telegrams sent when the energy bar was

pushed and radio telegrams sent when the energy bar was released.

By identifying these different telegram types and measuring the time between pushing and

releasing of the energy bar, it is possible to distinguish between “Long” and “Short” button

contact presses. This enables simple implementation of applications such as dimming control

or blinds control including slat action.

(2) Button contacts

for switch rocker

identification

(1) Energy bow

on both device sides

Rotation axis for

pushbuttons or

switch rocker

USER MANUAL

PTM 215ZE - 2.4 GHz Zigbee Pushbutton Switch Transmitter Module

2.3 Block diagram

Figure 3 –Block diagram of PTM 215ZE

Energy Bow / Power Generator

Converts the motion of the energy bow into electrical energy

Power Converter

Converts the energy of the power generator into a stable DC supply voltage for the device

electronics

Processor

Determines the status of the button contacts and the energy bow, encodes this status into a

data word, generates the proper radio telegram structure and sends it to the radio transmitter

Radio transmitter

Transmits the data in the form of a series of short Zigbee Green Power radio telegrams using

the integrated antenna

In addition, PTM 215ZE product revision DB provides an integrated NFC interface according to

ISO 14443 that can be used to configure device parameters.

Processor

Energy

Bow

Power

Converter

Data

DC Power

Pushed

Released

Processor

Radio

Transmitter

Button Contacts

Energy

Bow

Power

Converter

Data

DC Power

Pushed

Released

Antenna

USER MANUAL

PTM 215ZE - 2.4 GHz Zigbee Pushbutton Switch Transmitter Module

2.4 User interface

PTM 215ZE devices provide four button contacts. They are grouped into two channels (Channel

A and Channel B) each containing two button contacts (State O and State I).

The state of all four button contacts (pressed or not pressed) is transmitted together with a

unique device identification (32-bit Zigbee Green Power Device ID) whenever the energy bow

is pushed or released.

Figure 4 below shows the arrangement of the four button contacts and their designation.

Figure 4 –Button contact designation

CHANNEL

STATE

CHANNEL

STATE

USER MANUAL

PTM 215ZE - 2.4 GHz Zigbee Pushbutton Switch Transmitter Module

3Radio communication

PTM 215ZE transmits radio telegrams according to the ON /OFF Switch model of the Zigbee

Green Power standard [1]. Other models can be selected as described in chapter 3.3.1.

3.1 PTM 215ZE radio channel parameters

PTM 215ZE supports all sixteen IEEE 802.15.4 / Zigbee Green Power radio channels in the 2.4

GHz band (channels 11 … 26 according to IEEE 802.15.4 notation).

Table 1 below shows the correspondence between channel number and channel frequency (in

MHz).

Table 1 - IEEE 802.15.4 Radio Channels and Frequencies (in MHz)

USER MANUAL

PTM 215ZE - 2.4 GHz Zigbee Pushbutton Switch Transmitter Module

3.2 Telegram structure

PTM 215ZE transmits radio telegrams in the 2.4 GHz band as defined by the Zigbee Green

Power standard [1] which uses an IEEE 802.15.4 frame structure [1].

Note that the byte order used by Zigbee Green Power and IEEE 802.15.4 is little

endian. This means that if there are multi-byte structures (such as 2-byte, 4-

byte or 8-byte fields), then the least significant byte (LSB) is transmitted first.

The frame structure used by PTM 215ZE consists of the following main parts:

◼PHY Header

The PHY header indicates to the receiver the start of a transmission and provides in-

formation about the length of the transmission.

It contains the following fields:

◼Preamble

Pre-defined sequence (4 byte, value 0x00000000) used to adjust the receiver to the

transmission of the sender

◼Start of frame

Pre-defined symbol (1 byte, value 0xA7) identifying the start of the actual data frame

◼Length of frame

1 byte indicating the combined length of all following fields

◼MAC Header

The MAC header provides detailed information about the frame.

It contains the following fields:

oFrame control field

2 bytes (always 0x0801) identifying frame type, protocol version, addressing

and security mode

oSequence number

1 byte sequential number identifying the order of transmitted frames

oAddress

PAN ID and address of source (if present) and destination of the telegram

PTM 215ZE does not use source address and source PAN ID

◼MAC Payload

The MAC payload is based on the Zigbee Green Power standard. It contains telegram

control, device ID, telegram data and telegram security fields.

◼MAC Trailer

The MAC Trailer contains the Frame Check Sum (FCS) field used to verify the integ-

rity of the telegram data.

USER MANUAL

PTM 215ZE - 2.4 GHz Zigbee Pushbutton Switch Transmitter Module

Figure 5 below summarizes the IEEE 802.15.4 frame structure.

Figure 5 –IEEE 802.15.4 Frame Structure

The content of these fields is described in more detail below.

3.2.1 IEEE 802.15.4 PHY Header

The IEEE 802.15.4 PHY header consists of the following fields:

◼Preamble

◼Start of Frame

◼Length of Frame fields

The content of the Preamble and Start of Frame fields is fixed for all telegram types supported

by PTM 215ZE as follows:

◼Preamble = 0x00000000

◼Start of Frame = 0xA7

The content of the Length of Frame field differs depending on the telegram type as follows:

◼Data telegram

Length = 25 bytes (0x19)

◼Commissioning telegram

Length= 46 bytes (0x2E)

◼Decommissioning telegram

Length = 24 bytes (0x18)

USER MANUAL

PTM 215ZE - 2.4 GHz Zigbee Pushbutton Switch Transmitter Module

3.2.2 IEEE 802.15.4 MAC Header

The IEEE 802.15.4 MAC Header contains the following fields:

◼Frame Control Field (2 byte)

The Frame Control Field is set to 0x0801 in all PTM 215ZE telegrams in order to iden-

tify them as data telegrams with short addresses based on version IEEE 802.15.4-

2003

◼Sequence Number (1 byte)

The Sequence Number is an incremental number used to identify the order of tele-

grams

◼Address Field (4 byte in PTM 215ZE implementation)

The Address Field is set to 0xFFFFFFFF to identify PTM 215ZE telegrams as broadcast

telegrams using short Destination Address (16 Bit) together with the Destination

PAN ID (16 Bit). Source address and Source PAN ID are not present in PTM 215ZE

MAC Header.

3.2.3 IEEE 802.15.4 MAC Trailer

The MAC Trailer only contains the Frame Check Sum (FCS) field.

Its length is 2 byte and it is calculated as Cyclic Redundancy Check (CRC16) over the entire

MAC payload including the Length of Frame field of the PHY Header using the following poly-

nomial: x16 + x12 + x5+ 1

USER MANUAL

PTM 215ZE - 2.4 GHz Zigbee Pushbutton Switch Transmitter Module

3.3 IEEE 802.15.4 payload (ZGP telegram data)

The 802.15.4 payload contains the Zigbee Green Power (ZGP) telegram data for the following

telegram types:

◼ZGP data telegram

◼ZGP commissioning telegram

◼ZGP decommissioning telegram

Each telegram type is described in more detail in the subsequent chapters.

3.3.1 Data telegram

Zigbee Green Power data telegrams are used by PTM 215ZE to transmit button events. The

structure of the data telegram depends on the Zigbee Green Power device model as described

in the next chapters.

3.3.1.1 Zigbee Green Power device models

PTM 215ZE supports a wide range of Zigbee Green Power device models allowing the use of

PTM 215ZE in a wide variety of applications.

Table 2 below lists the Device Models supported by PTM 215ZE.

ZGP Device ID (Device Model)

ZGP Device Role

Model Type

0x00

ZGP Simple Generic 1-state Switch

Command-based

0x01

ZGP Simple Generic 2-state Switch

Command-based

0x02 (Default)

ZGP ON/OFF Switch

Command-based

0x03

ZGP Level Control Switch

Command-based

0x05

ZGP Advanced Generic 1-state Switch

Command-based

0x06

ZGP Advanced Generic 2-state Switch

Command-based

0x07

ZGP Generic 8-contact Switch

Generic

0x10

ZGP Color Dimmer Switch

Command-based

Table 2 –ZGP Device Models supported by PTM 215ZE

By default, PTM 215ZE uses the ON / OFF Button device model identified by Zigbee Green

Power Device ID 0x02. It is possible to select a different (command-based or generic) device

model via the NFC PC configuration tool as described in chapter 4.2.

USER MANUAL

PTM 215ZE - 2.4 GHz Zigbee Pushbutton Switch Transmitter Module

3.3.1.1 Command-based device models

Command-based device models transmit defined Zigbee Green Power commands such as “ON”

or “OFF” instead of generic information such as “Button A1 was pressed” which is used by the

Generic Switch model.

PTM 215ZE uses by default the command-based device model “ON / OFF Switch” identified by

Device ID 0x02. PTM 215ZE can be configured via NFC to use one of the other command-

based device models or the Generic Switch device model via the NFC PC configuration tool as

described in chapter 4.2.

If a command-based device model is selected (which is the case by default), then the corre-

spondence between button action and transmitted command is configurable via via the NFC

PC configuration tool as described in chapter 4.2.

Figure 6 below shows the Zigbee Green Power payload structure for data telegrams using a

command-bases model.

Figure 6 –Payload structure for data telegrams a command-based model

USER MANUAL

PTM 215ZE - 2.4 GHz Zigbee Pushbutton Switch Transmitter Module

The default mapping between button action and transmitted command is shown in Table 3

below. Note that 0xFF means that no telegram will be sent for that specific button action.

Table 3 –Default command table for command-based device models

USER MANUAL

PTM 215ZE - 2.4 GHz Zigbee Pushbutton Switch Transmitter Module

3.3.1.2 Generic Switch device model

PTM 215ZE can be configured via NFC to use the Generic Switch model defined by the Zigbee

Green Power standard [1] to encode the button status.

In this model, button press events are transmitted using Command ID 0x69 followed by 1

byte button status. Likewise, release events are transmitted using Command ID 0x6A followed

by 1 byte button status.

Figure 7 below shows the Zigbee Green Power payload structure for data telegrams when

using the Generic Switch model.

Figure 7 –Payload structure for data telegrams using the Generic Switch model

The button(s) that were pushed are encoded in the 1-byte Button Status field using the struc-

ture shown in Figure 8 below.

Figure 8 –Button status encoding for Generic Switch model

USER MANUAL

PTM 215ZE - 2.4 GHz Zigbee Pushbutton Switch Transmitter Module

3.3.2 Commissioning telegram

Zigbee Green Power Commissioning telegrams are used to commission PTM 215ZE into Zigbee

Green Power networks. Commissioning telegrams are identified by the Command ID 0xE0 and

contain the required information about the properties of PTM 215ZE.

Commissioning telegrams contain the security key used by the device to authenticate its data

telegrams. The security key is encrypted using either TCLK or IC as discussed in chapter 3.5.1.

The correct decryption of the security key can be verified using the Security Key Hash field.

The format for some fields of the commissioning telegram depends on the device model as

described in the next chapters.

3.3.2.1 Format for command-based models without Application Info

By default, PTM 215ZE does not transmit the Application Information fields to provide back-

wards-compatibility with previous revisions of PTM 215ZE. If Application Information is not

present, then the Commissioning telegram contains the following fields:

◼Device ID 0x00, 0x01, 0x02, 0x03, 0x05, 0x06 or 0x10

◼Options 0x81 (Application Information not present)

◼Extended Options 0xF2

◼Security Key 16 byte device-unique security key (encrypted)

◼Security Key Hash 4 byte hash of the encrypted security key

◼Outgoing Security Counter 4 byte value of security counter

USER MANUAL

PTM 215ZE - 2.4 GHz Zigbee Pushbutton Switch Transmitter Module

3.3.2.2 Format for command-based models with Application Info

PTM 215ZE can be configured via NFC as described in chapter 4.2. to provide Application

Information as part of the Commissioning Telegram to provide compatibility with newer im-

plementations.

If this feature is enabled, then a variable length commissioning telegram payload is used

where the length of the payload depends on the number of commands that are used.

The following fields are present in this case:

◼Device ID 0x00, 0x01, 0x02, 0x03, 0x05, 0x06 or 0x10

◼Options 0x85

◼Extended Options 0xF2

◼Security Key 16 byte device-unique security key (encrypted)

◼Security Key Hash 4 byte hash of the encrypted security key

◼Outgoing Security Counter 4 byte value of security counter

◼Application Information 0x04 (Command List present)

◼Application Information Size Variable (Number of enabled commands)

◼Command List List of all enabled commands (1 … 32 byte)

USER MANUAL

PTM 215ZE - 2.4 GHz Zigbee Pushbutton Switch Transmitter Module

3.3.2.3 Format for Generic Switch model

If the Generic Switch model is used, then the following are present to identify the properties

of PTM 215ZE:

◼Device ID 0x07 (Generic Button model)

◼Options 0x85

◼Extended Options: 0xF2

◼Security Key 16 byte device-unique security key (encrypted)

◼Security Key Hash 4 byte hash of the encrypted security key

◼Outgoing Security Counter 4 byte value of security counter

◼Application Information 0x10 (Generic Button Configuration present)

◼Application Information Size 0x02 = 2 byte of Application Information follow

◼Button Configuration 0x05 = 5 buttons (configurable via NFC)

◼Current Button Contact Button that was pressed (as defined in Figure 8)

The Button Configuration field encodes the number of supported buttons. By default, this is

set to 5 representing the 4 buttons contacts and the energy bar (actuated without button

press). This parameter can be changed via the NFC PC configuration tool as described in

chapter 4.2.to match the actual product.

Other manuals for PTM 215ZE

Table of contents

Popular Transmitter manuals by other brands

Technalogix

Technalogix TAVD-100H Operation manual

Sony

Sony WRT-847A Service manual

Trantec

Trantec S6000 instruction manual

BEKA

BEKA BA474D Installation & maintenance instructions

Rose electronics

Rose electronics UltraLink E Series Installation and operation manual

Autrol

Autrol APT3200 Series operating manual

Valcom

Valcom T72 Series manual

Campbell

Campbell TX320 instruction manual

RHEONIK

RHEONIK RHE28 Installation & start?up guide

Crestron

Crestron HD-TX-4KZ-111-1G Getting started

BWI Eagle

BWI Eagle AIR-EAGLE SR PLUS 36-1800-120VAC Product information bulletin

Sennheiser

Sennheiser SK 250 Instrucciones para el uso

Chiayo

Chiayo NB-3100 Operation manual

Moore Industries

Moore Industries TMZ user manual

Rice Lake

Rice Lake Advanced Series Technical manual

PPM

PPM ViaLiteHD Blue2 Link user guide

INVISIBLE FENCE

INVISIBLE FENCE ICT 801 installation manual

BSi

BSi Mini-Tx UHD product manual

EnOcean PTM 215ZE User manual

Popular Transmitter manuals by other brands