Enocean Ptm 216z User manual

USER MANUAL

PTM 216Z - 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 216Z

2.4 GHz Zigbee®Pushbutton Switch Transmitter Module

25 May 2023

USER MANUAL

PTM 216Z - 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.05.2023

Addition of NFC interface in 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 216Z - 2.4 GHz Zigbee Pushbutton Switch Transmitter Module 
© 2023 EnOcean | www.enocean.com F-710-017, V1.0 PTM 216Z User Manual | v1.2 | May 2023 | Page 3/49 
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 216Z device overview..............................................................................7 
2 Basic functionality..........................................................................................7 
3 Block diagram ...............................................................................................8 
4 User interface ...............................................................................................9 
3Radio communication ...................................................................................10 
1 PTM 216Z 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 Device Models...................................................................................14 
3.1.2 Generic Switch model ........................................................................15 
3.1.3 Command-based models ....................................................................16 
3.2 Commissioning telegram.......................................................................18 
3.2.1 Commissioning telegram payload for Generic Switch model ....................18 
3.2.2 Commissioning telegram payload for command-based models ................19 
3.2.3 Disabling Application Information for command-based models ................19 
3.3 Decommissioning telegram ...................................................................20 
4 Telegram authentication ...............................................................................21 
4.1 Authentication implementation ..............................................................21 
4.2 Algorithm parameters ...........................................................................22 
5 Security Keys ..............................................................................................24 
5.1 User-defined Installation Code (IC) ........................................................24 
6 Commissioning ............................................................................................25 
6.1 Commissioning modes ..........................................................................25 
6.2 Direct commissioning by button press.....................................................26 
6.2.1 Commissioning request ......................................................................26 
6.2.2 Radio channel confirmation.................................................................27 
6.2.3 Example of direct commissioning.........................................................27 
6.2.4 Disabling direct commissioning ...........................................................27 
6.3 Sequential commissioning by button press ..............................................28 
6.3.1 Commissioning request ......................................................................28 
6.3.2 Example of sequential commissioning ..................................................29 

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

USER MANUAL

PTM 216Z - 2.4 GHz Zigbee Pushbutton Switch Transmitter Module

1General description

1.1 Basic functionality

PTM 216Z (DB) (subsequently simply called “PTM 216Z”) enables the realization of energy

harvesting wireless switches for systems communicating based on the Generic Switch model

of the 2.4 GHz Zigbee®Green Power standard [1].

Starting with product revision DB, PTM 216Z integrates an NFC interface which can be used

to configure device parameters.

PTM 216Z 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 216Z 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 216Z telegrams are protected with an AES-128 signature based

on a device-unique private key.

Figure 1 below shows PTM 216Z.

Figure 1 –PTM 216Z Product Outline

USER MANUAL

PTM 216Z - 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 (Generic 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

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 216Z:DB

S3271-A216:DB

2.4 GHz Zigbee

USER MANUAL

PTM 216Z - 2.4 GHz Zigbee Pushbutton Switch Transmitter Module

2Functional information

2.1 PTM 216Z device overview

The pushbutton transmitter module PTM 216Z 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 216Z is shown in Figure 2 below.

Figure 2 –Electro-dynamic powered pushbutton transmitter module PTM 216Z

2.2 Basic functionality

PTM 216Z devices contain an electro-dynamic energy transducer which is actuated by an en-

ergy 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 216Z - 2.4 GHz Zigbee Pushbutton Switch Transmitter Module

2.3 Block diagram

Figure 3 –Block diagram of PTM 216Z

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 216Z contains an integrated NFC interface according to ISO14443 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 216Z - 2.4 GHz Zigbee Pushbutton Switch Transmitter Module

2.4 User interface

PTM 216Z 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 216Z - 2.4 GHz Zigbee Pushbutton Switch Transmitter Module

3Radio communication

PTM 216Z transmits by default radio telegrams using the Generic Switch model of the Zigbee

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

3.1 PTM 216Z radio channel parameters

PTM 216Z 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 216Z - 2.4 GHz Zigbee Pushbutton Switch Transmitter Module

3.2 Telegram structure

PTM 216Z 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 216Z 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 216Z 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 216Z - 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 216Z 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 216Z - 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 216Z 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 216Z implementation)

The Address Field is set to 0xFFFFFFFF to identify PTM 216Z 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 216Z

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 216Z - 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 216Z 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 Device Models

PTM 216Z supports a wide range of Zigbee Green Power device models allowing the use of

PTM 216Z in a wide variety of applications.

Table 2 below lists the Device Models supported by PTM 216Z.

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

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 (Default)

ZGP Generic 8-contact Switch

Generic

0x10

ZGP Color Dimmer Switch

Command-based

Table 2 –ZGP Device Models supported by PTM 216Z

By default, PTM 216Z uses the Generic Switch model identified by Zigbee Green Power Device

ID 0x07. It is possible to select a different (command-based) model via NFC as described in

chapter 4.2.

USER MANUAL

PTM 216Z - 2.4 GHz Zigbee Pushbutton Switch Transmitter Module

3.3.1.2 Generic Switch model

By default, PTM 216Z uses 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 6 below shows the Zigbee Green Power payload structure for data telegrams using the

Generic Switch model.

Figure 6 –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 7 below.

Figure 7 –Button status encoding for Generic Switch model

USER MANUAL

PTM 216Z - 2.4 GHz Zigbee Pushbutton Switch Transmitter Module

3.3.1.3 Command-based 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 216Z supports the command-based device models 0x00, 0x01, 0x02, 0x03, 0x05, 0x06

and 0x10 as defined in Table 2.

PTM 216Z can be configured via NFC to use one of the command-based device models as

described in chapter 4.2. If a command-based device model is selected, then the correspond-

ence between button action and transmitted command is configurable via NFC as described in

chapter 4.2.

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

command-based models.

Figure 8 –Button status encoding for command-based models

USER MANUAL

PTM 216Z - 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 216Z - 2.4 GHz Zigbee Pushbutton Switch Transmitter Module

3.3.2 Commissioning telegram

Zigbee Green Power Commissioning telegrams are used to commission PTM 216Z into Zigbee

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

contain the required information about the properties of PTM 216Z.

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 Commissioning telegram payload for Generic Switch model

The Generic Switch model uses the following 31-byte commissioning telegram payload to

identify the properties of PTM 216Z:

◼Device ID 0x07 (Generic Switch 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 Switch 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 7)

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 NFC as described in chapter 4.2 to match the ac-

tual product.

USER MANUAL

PTM 216Z - 2.4 GHz Zigbee Pushbutton Switch Transmitter Module

3.3.2.2 Commissioning telegram payload for command-based models

Command-based models use a variable length commissioning telegram payload 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)

3.3.2.3 Disabling Application Information for command-based models

For command-based models, it is possible to disable the Application Information fields Appli-

cation Information Size and Command List via NFC as described in chapter 4.2. This enables

compatibility with legacy implementations which don’t support this feature.

If Application Information is not present, then only the following fields are present:

◼Device ID (Device Model) 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 216Z - 2.4 GHz Zigbee Pushbutton Switch Transmitter Module

3.3.3 Decommissioning telegram

Zigbee Green Power Decommissioning telegrams are used to inform the network of devices

to which PTM 216Z had been commissioned that PTM 216Z will leave the network due to a

change of radio channel.

Decommissioning telegrams are therefore sent each time PTM 216Z changes radio channel

during commissioning as described in chapter 3.5.

The structure of decommissioning telegrams used by PTM 216Z is shown in Figure 9 below.

Figure 9 –ZGP payload structure for decommissioning telegrams

Table of contents

Popular Transmitter manuals by other brands

Setra Systems

Setra Systems SRH300 operating instructions

MTT

MTT MS3101 user manual

Gira

Gira 5331 Series user manual

BT Redcare

BT Redcare Essential installation guide

WIKA

WIKA UPT-20 Additional information

JUMO

JUMO JUMO dTRANS p20 DELTA operating manual

CYP

CYP VEX-X1102T-B0C Operation manual

Gira

Gira 0441 00 installation instructions

ARTEX

ARTEX ELT C406-N Description, operation, installation and maintenance manual

Diehl

Diehl IZAR RADIO EXTERN M-BUS installation guide

M-system

M-system M3LPA2 instruction manual

Emerson

Emerson Rosemount Oxymitter 4000 Reference manual

NAPCO

NAPCO GEM-KEYF-LR manual

Emerson

Emerson Rosemount 3051S Series quick start guide

Monacor

Monacor AV-3040TX instruction manual

LumenRadio

LumenRadio CRMX Galileo quick start guide

GAPOSA

GAPOSA Emitto Smart 16 manual

Simu

Simu HZ MOBILE 1 CANAL manual

EnOcean PTM 216Z User manual

Popular Transmitter manuals by other brands