Table of Contents
Advertisement
Quick Links
USER MANUAL
PTM 216Z – 2.4 GHz Zigbee Generic Switch Pushbutton Transmitter Module
PTM 216Z
2.4 GHz Zigbee
07. November 2018
Observe precautions! Electrostatic sensitive devices!
Patent protected:
WO98/36395, DE 100 25 561, DE 101 50 128,
WO 2004/051591, DE 103 01 678 A1, DE 10309334,
WO 04/109236, WO 05/096482, WO 02/095707,
US 6,747,573, US 7,019,241
© 2018 EnOcean | www.enocean.com
®
Generic Switch Pushbutton Transmitter Module
F-710-017, V1.0
PTM 216Z User Manual | v1.2 | November 2018 | Page 1/43
Advertisement
Table of Contents
Related Manuals for Dolphin PTM 216Z
Summary of Contents for Dolphin PTM 216Z
- Page 1 WO98/36395, DE 100 25 561, DE 101 50 128, WO 2004/051591, DE 103 01 678 A1, DE 10309334, WO 04/109236, WO 05/096482, WO 02/095707, US 6,747,573, US 7,019,241 © 2018 EnOcean | www.enocean.com F-710-017, V1.0 PTM 216Z User Manual | v1.2 | November 2018 | Page 1/43...
- Page 2 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. © 2018 EnOcean | www.enocean.com F-710-017, V1.0 PTM 216Z User Manual | v1.2 | November 2018 | Page 2/43...
-
Page 3: Table Of Contents
Disabling sequential commissioning ............24 Sequential versus direct commissioning ............24 Disabling commissioning ................24 Disabling channel change ................25 Factory reset ....................25 © 2018 EnOcean | www.enocean.com F-710-017, V1.0 PTM 216Z User Manual | v1.2 | November 2018 | Page 3/43... - Page 4 A.4.1 MAC Payload ................... 42 A.4.2 Device ID ....................42 A.4.3 Sequence Counter ................... 43 A.4.4 Command payload ................... 43 A.4.5 Telegram Signature ................. 43 © 2018 EnOcean | www.enocean.com F-710-017, V1.0 PTM 216Z User Manual | v1.2 | November 2018 | Page 4/43...
-
Page 5: General Description
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. -
Page 6: Technical Data
Tray / Box (10 units per tray, 10 trays per box) Ordering information Type Ordering Code Frequency 2.4 GHz (IEEE 802.15.4) PTM 216Z S3271-A216 © 2018 EnOcean | www.enocean.com F-710-017, V1.0 PTM 216Z User Manual | v1.2 | November 2018 | Page 6/43... -
Page 7: Functional Information
Figure 2 – Electro-dynamic powered pushbutton transmitter module PTM 216Z 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 simi- lar construction mounted onto the device. -
Page 8: Block Diagram
Radio transmitter Transmits the data in the form of a series of short Zigbee Green Power radio telegrams using the integrated antenna © 2018 EnOcean | www.enocean.com F-710-017, V1.0 PTM 216Z User Manual | v1.2 | November 2018 | Page 8/43... -
Page 9: User Interface
PTM 216Z – 2.4 GHz Zigbee Generic Switch Pushbutton Transmitter Module 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). -
Page 10: Radio Protocol
RADIO PROTOCOL 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 select- ed as described above. -
Page 11: Telegram Structure
PTM 216Z – 2.4 GHz Zigbee Generic Switch Pushbutton Transmitter Module Telegram structure PTM 216Z transmits radio telegrams in the 2.4 GHz band according to the IEEE 802.15.4 frame structure using a Zigbee Green Power compliant payload. Note that the byte order used by these standards is little endian. This means that for multi- byte structures (such as 2 byte, 4 byte or 8 byte fields) the least significant byte (LSB) is transmitted first. -
Page 12: 802.15.4 Phy Header
Length = 25 bytes (0x19) Commissioning telegram Length= 46 bytes (0x2E) Decommissioning telegram Length = 24 bytes (0x18) © 2018 EnOcean | www.enocean.com F-710-017, V1.0 PTM 216Z User Manual | v1.2 | November 2018 | Page 12/43... -
Page 13: 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) ... -
Page 14: 802.15.4 Payload (Zgp Telegram Data)
If for instance if buttons A0 and B0 were pressed then this will be transmitted as 0x69 (Push) followed by 0x05 (A0 and B0). Due to the mechanical design of PTM 216Z, all buttons that were pressed will also be re- leased. Therefore a release telegram from PTM 216Z will always be 0x6A followed by 0x00 irrespective of the button(s) that had been pushed. -
Page 15: Zgp Commissioning Telegram
PTM 216Z – 2.4 GHz Zigbee Generic Switch Pushbutton Transmitter Module 3.3.2 ZGP commissioning telegram ZGP commissioning telegrams are used to commission PTM 216Z into ZGP networks. ZGP commissioning telegrams are identified by the Command ID 0xE0. The following 31 byte of data identify the properties of PTM 216Z:... -
Page 16: Zgp Decommissioning Telegram
ZGP Decommissioning telegram ZGP 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 ra- dio channel. Decommissioning telegrams are therefore sent each time PTM 216Z changes radio channel during commissioning as described in chapter 5. -
Page 17: Telegram Authentication
In order to avoid message replay (capture and retransmission of a valid message), it is required that the receiver tracks the value of the sequence counter used by PTM 216Z and only accepts messages with higher sequence counter values (i.e. not accepts equal or lower sequence counter values for subsequent telegrams). -
Page 18: Algorithm Parameters
PTM 216Z – 2.4 GHz Zigbee Generic Switch Pushbutton Transmitter Module Algorithm parameters PTM 216Z implements telegram authentication according to the Zigbee Green Power speci- fication. It uses AES128 in CCM (Counter with CBC-MAC) mode as described in IETF RFC3610. At the time of writing, the RFC3610 standard could be found here: https://www.ietf.org/rfc/rfc3610.txt... -
Page 19: Commissioning
If the intended receiver or network operates on one of the primary radio channels (channel 11, 15, 20 or 25) and PTM 216Z is integrated into a double rocker or four but- ton switch then PTM 216Z can be commissioned directly using a simplified button se- quence. -
Page 20: Direct Commissioning
The commissioning request is triggered by long-pressing (for 7 seconds or more) one of the four buttons of PTM 216Z. Upon detection of such long button press, PTM 216Z will trans- mit a commissioning request on the corresponding radio channel. -
Page 21: Radio Channel Confirmation
Note that this step requires that both A1 and B0 buttons can be operated together. This will be the case when PTM 216Z is integrated into a double rocker or a four button switch de- sign. Otherwise (e.g. for the case of a single rocker switch design) PTM 216Z would have to be removed from the housing design first. -
Page 22: Sequential Commissioning
Commissioning requests are triggered using a special button contact sequence. This is illus- trated in Figure 14 below. Figure 14 – Button sequence for commissioning mode © 2018 EnOcean | www.enocean.com F-710-017, V1.0 PTM 216Z User Manual | v1.2 | November 2018 | Page 22/43... -
Page 23: Example Of Sequential Commissioning
2. Press the same button shortly 7 times to select channel 17. PTM 216Z will follow the channel sequence 11 -> 12 -> 13 -> 14 ->15 -> 16 -> 17 3. Confirm selection of radio channel 17 by pressing a button different from the one used during the previous two steps. -
Page 24: Disabling Sequential Commissioning
Consider the case where PTM 216Z operates on channel 15 and the user executed a long – short long sequence on button A1. In this case, upon the first long button press of the se- quence a commissioning telegram will be transmitted on channel 11 which corresponds to this button in direct commissioning mode (see Table 2). -
Page 25: Disabling Channel Change
5.7. Factory reset PTM 216Z can be reset to factory state by pressing buttons A0, A1, B0 and B1 at the same time for at least 7 seconds (long press). After that, PTM 216Z will send a decommissioning telegram (command 0xE1) on the currently used radio channel. -
Page 26: Device Integration
PTM 216Z – 2.4 GHz Zigbee Generic Switch Pushbutton Transmitter Module DEVICE INTEGRATION PTM 216Z is designed for integration into button or rocker based switches. It implements the established PTM 2xx mechanical form factor and can therefore be used with a wide va- riety of existing designs. - Page 27 PTM 216Z – 2.4 GHz Zigbee Generic Switch Pushbutton Transmitter Module 1) these catwalks are not needed when using one single rocker only 2) dimensions of rocker part Figure 16 – PTM 216Z, top view (note cut A, B and C marking) © 2018 EnOcean | www.enocean.com F-710-017, V1.0...
- Page 28 Figure 17 – PTM 216Z, cut A 2) dimensions of rocker part Figure 18 – PTM 216Z, cut B and C © 2018 EnOcean | www.enocean.com F-710-017, V1.0 PTM 216Z User Manual | v1.2 | November 2018 | Page 28/43...
- Page 29 PTM 216Z – 2.4 GHz Zigbee Generic Switch Pushbutton Transmitter Module Hatched areas: support planes Figure 19 – PTM 216Z rear view © 2018 EnOcean | www.enocean.com F-710-017, V1.0 PTM 216Z User Manual | v1.2 | November 2018 | Page 29/43...
- Page 30 2) dimensions of rocker part Figure 20 – PTM 216Z, side view If the rocker is not mounted on the rotation axis of PTM 216Z several tolerances have to be considered! The measure from support plane to top of the energy bow is 7.70 mm +/- 0.3 mm!
- Page 31 PTM 216Z is powered by the electromagnetic generator ECO 200. For proper func- tion there has to be a keep out zone of 60mm for magnets or ferromagnetic mate- rials around the center of PTM 216Z.
-
Page 32: Device Label
PTM 216Z – 2.4 GHz Zigbee Generic Switch Pushbutton Transmitter Module Device label Each PTM 216Z module contains a device label as shown in Figure 21 below. Figure 21 – PTM 216Z device label This device label identifies the following parameters in writing: Model name (PTM 216Z) ... -
Page 33: Qr Code Format
ANSI/MH10.8.2-2013 industry standard. The QR code shown in Figure 21 above encodes the following string: 30S00430100+Z0123456789ABCDEF0123456789ABCDEF+30PS3071-A216+2PDA01+S01234567890123 Table 3 below describes the ANSI/MH10.8.2 data identifiers used by the PTM 216Z device label and shows the interpretation of the data therein. Length of data... -
Page 34: Application Information
The distance between the receiver and other transmitting devices such as computers, audio and video equipment that also emit high-frequency signals should be at least 0.5 m. © 2018 EnOcean | www.enocean.com F-710-017, V1.0 PTM 216Z User Manual | v1.2 | November 2018 | Page 34/43... -
Page 35: Regulatory Information
PTM 216Z – 2.4 GHz Zigbee Generic Switch Pushbutton Transmitter Module REGULATORY INFORMATION PTM 216Z has been certified according to FCC (US), ISED (Canada) and RED (Europe) regulations. Changes or modifications not expressly approved by EnOcean could void the user's authority to operate the equipment. -
Page 36: Fcc (United States) Certificate
(1) this device may not cause harmful interference, and (2) this device must accept any interference received, including interference that may cause undesired operation. © 2018 EnOcean | www.enocean.com F-710-017, V1.0 PTM 216Z User Manual | v1.2 | November 2018 | Page 36/43... -
Page 37: Ised (Former Industry Canada) Certificate
(1) l'appareil ne doit pas produire de brouillage, et (2) l'utilisateur de l'appareil doit accepter tout brouillage radioélectrique subi, même si le brouillage est susceptible d'en compromettre le fonctionnement.” © 2018 EnOcean | www.enocean.com F-710-017, V1.0 PTM 216Z User Manual | v1.2 | November 2018 | Page 37/43... -
Page 38: A Understanding Ptm 216Z Telegram Structure
PTM 216Z – 2.4 GHz Zigbee Generic Switch Pushbutton Transmitter Module Understanding PTM 216Z telegram structure This appendix describes – purely for reference purposes – how to analyse the PTM 216Z radio telegram structure using the TI CC2531EMK packet sniffer (USB dongle) on a Win- dows 7 based system. -
Page 39: Configuration
“Capturing device” tab and in the “RF device:” footer line as shown in Figure 24 below. Figure 24 – Main window TI SmartRF Packet Sniffer © 2018 EnOcean | www.enocean.com F-710-017, V1.0 PTM 216Z User Manual | v1.2 | November 2018 | Page 39/43... - Page 40 PTM 216Z – 2.4 GHz Zigbee Generic Switch Pushbutton Transmitter Module Out of the box, PTM 216Z is configured for using IEEE 802.15.4 radio channel 11. Make sure that this radio channel (0x0B) is selected in the “Radio Configuration” tab and shown in the “Channel:”...
-
Page 41: Data Capture
216Z. You should now see the captured radio telegrams (PTM 215Z sends several redun- dant radio telegrams per user action). Figure 27 – Captured telegram data © 2018 EnOcean | www.enocean.com F-710-017, V1.0 PTM 216Z User Manual | v1.2 | November 2018 | Page 41/43... -
Page 42: Interpretation Of The Telegram Data
FB 02 00 00 69 10 CC 5D C0 18 Note that the byte order is little endian, therefore the ID of this specific device is 0x0043F5D4. © 2018 EnOcean | www.enocean.com F-710-017, V1.0 PTM 216Z User Manual | v1.2 | November 2018 | Page 42/43... -
Page 43: Sequence Counter
A.4.5 Telegram Signature The PTM 216Z radio telegram is authenticated via a 32 Bit signature. This signature is cal- culated based on the private key (unique for each device), the data payload and a 32 Bit sequence counter (which is incremented for each data telegram).
Need help?
Do you have a question about the PTM 216Z and is the answer not in the manual?
Questions and answers