EnOcean PTM 216Z Specifications

USER MANUAL

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

22 February 2021

USER MANUAL

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

04.09.2018

Initial Release

1.1

MKA

19.10.2018

Updated version for product release

1.2

MKA

07.11.2018

Addition of channel lock

1.3

MKA

10.03.2020

Updated the certification chapter

1.4

MKA

21.02.2021

Annual documentation maintenance Added references and product history

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 systems containing RF components must meet the essential requirements of the local legal authorities. The modules must not be used in any relation with equipment that supports, directly or indirectly, 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 Generic Switch Pushbutton Transmitter Module

TABLE OF CONTENT

1 General description ........................................................................................ 5

1.1 Basic functionality ......................................................................................... 5

1.2 Technical data ............................................................................................... 6

1.3 Physical dimensions ....................................................................................... 6

1.4 Environmental conditions ............................................................................... 6

1.5 Packaging information .................................................................................... 6

1.6 Ordering information ..................................................................................... 6

2 Functional information ................................................................................... 7

2.1 PTM 216Z device overview ............................................................................. 7

2.2 Basic functionality ......................................................................................... 7

2.3 Block diagram ............................................................................................... 8

2.4 User interface ............................................................................................... 9

3 Radio protocol ............................................................................................. 10

3.1 PTM 216Z radio channel parameters .............................................................. 10

3.2 Telegram structure ...................................................................................... 11

3.2.1 802.15.4 PHY Header ........................................................................... 12

3.2.2 802.15.4 MAC Header .......................................................................... 13

3.2.3 802.15.4 MAC Trailer ........................................................................... 13

3.3 802.15.4 payload (ZGP telegram data) .......................................................... 14

3.3.1 ZGP data telegram ............................................................................... 14

3.3.2 ZGP commissioning telegram ................................................................ 15

3.3.3 ZGP Decommissioning telegram ............................................................ 16

4 Telegram authentication ............................................................................... 17

4.1 Authentication implementation ...................................................................... 17

4.2 Algorithm parameters .................................................................................. 18

5 Commissioning ............................................................................................ 19

5.1 Commissioning modes ................................................................................. 19

5.2 Direct commissioning ................................................................................... 20

5.2.1 Commissioning request ........................................................................ 20

5.2.2 Radio channel confirmation ................................................................... 21

5.2.3 Example of direct commissioning ........................................................... 21

5.2.4 Disabling direct commissioning .............................................................. 21

5.3 Sequential commissioning ............................................................................ 22

5.3.1 Commissioning request ........................................................................ 22

5.3.2 Example of sequential commissioning ..................................................... 23

5.3.3 Disabling sequential commissioning ....................................................... 24

5.4 Sequential versus direct commissioning ......................................................... 24

5.5 Disabling commissioning .............................................................................. 24

5.6 Disabling channel change ............................................................................. 25

5.7 Factory reset .............................................................................................. 25

USER MANUAL

PTM 216Z – 2.4 GHz Zigbee Generic Switch Pushbutton Transmitter Module

6 Device integration ....................................................................................... 26

6.1 Mechanical interface characteristics ............................................................... 26

6.2 Mechanical interface drawings ....................................................................... 26

6.3 Device label ................................................................................................ 32

6.3.1 QR code format ................................................................................... 33

7 Application information ................................................................................ 34

7.1 Transmission range ..................................................................................... 34

8 Regulatory information ................................................................................. 35

8.1 RED for the European market ....................................................................... 35

9 Product history ............................................................................................ 36

10 References ................................................................................................. 36

A Understanding PTM 216Z telegram structure .................................................. 37

A.1 Installation instructions for TI CC2531 packet sniffer ....................................... 37

A.1.1 CC2531EMK setup ................................................................................... 37

A.2 Configuration .............................................................................................. 38

A.3 Data capture ............................................................................................... 40

A.4 Interpretation of the telegram data................................................................ 41

A.4.1 MAC Payload ........................................................................................... 41

A.4.2 Device ID ............................................................................................... 41

A.4.3 Sequence Counter ................................................................................... 42

A.4.4 Command payload ................................................................................... 42

A.4.5 Telegram Signature ................................................................................. 42

USER MANUAL

PTM 216Z – 2.4 GHz Zigbee Generic Switch Pushbutton Transmitter Module

1 General description

1.1 Basic functionality

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].

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 maintenancefree. 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 is transmitted. This radio telegram transmits the operating status of all four contact nipples at the moment 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 Generic Switch Pushbutton Transmitter Module

1.2 Technical data

Antenna

Integrated antenna

Max. radio transmit power (measured)

7dBm / 5mW

Communication Protocol

Zigbee Green Power (Generic Switch)

Radio Protocol

2.4 GHz IEEE 802.15.4

Supported Radio Channels

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)

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

S3271-A216

2.4 GHz (IEEE 802.15.4)

USER MANUAL

PTM 216Z – 2.4 GHz Zigbee Generic Switch Pushbutton Transmitter Module

2 Functional 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 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 telegrams 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 Generic Switch Pushbutton 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

Processor

HF

Energy

Bow

Power

Converter

Data

DC Power

Pushed

/

Released

N

S

Processor

Radio

Transmitter

Button Contacts

Energy

Bow

Power

Converter

Data

DC Power

Pushed

/

Released

Antenna

N S N

S

USER MANUAL

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

O

I

BA

CHANNEL

STATE

O

I

BA

CHANNEL

STATE

USER MANUAL

PTM 216Z – 2.4 GHz Zigbee Generic Switch Pushbutton Transmitter Module

3 Radio protocol

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) which can be selected as described above.

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 Generic Switch Pushbutton Transmitter Module

3.2 Telegram structure

PTM 216Z transmits radio telegrams in the 2.4 GHz band according to the IEEE 802.15.4 frame structure [2] using a Zigbee Green Power compliant payload.

Note that the byte order used by these standards is little endian. This means that for multibyte structures (such as 2 byte, 4 byte or 8 byte fields) the least significant byte (LSB) is transmitted first.

The frame structure used by PTM 216Z consists of the following four main parts:

◼ PHY Header

The PHY header indicates to the receiver the start of a transmission and provides information 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:

- Frame control field

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

- Sequence number

1 byte sequential number identifying the order of transmitted frames

- Address

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 integrity of the telegram data.

USER MANUAL

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

3.2.2 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 identify 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 telegrams

◼ 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 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 polynomial: x16 + x12 + x5 + 1

EnOcean PTM 216Z Specifications

Specifications and Main Features

Frequently Asked Questions

User Manual

1 General description

1.1 Basic functionality

1.2 Technical data

1.3 Physical dimensions

1.4 Environmental conditions

1.5 Packaging information

1.6 Ordering information

2 Functional information

2.1 PTM 216Z device overview

2.2 Basic functionality

2.3 Block diagram

2.4 User interface

3 Radio protocol

3.1 PTM 216Z radio channel parameters

3.2 Telegram structure

3.2.1 802.15.4 PHY Header

3.2.2 802.15.4 MAC Header

3.2.3 802.15.4 MAC Trailer