USER MANUAL PTM 215B – 2.4 GHZ Pusbutton Transmitter Module PTM 215B BLE Pushbutton Transmitter Module 19.09.2016 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 © 2016 EnOcean | www.enocean.com F-710-017, V1.0 PTM 215B User Manual | v0.
USER MANUAL PTM 215B – 2.4 GHZ Pusbutton Transmitter Module REVISION HISTORY The following major modifications and improvements have been made to this document: Version 0.1 0.2 0.3 0.4 0.5 0.6 0.7 0.8 Author MKA MKA MKA MKA MKA MKA MKA MKA Reviewer Date 01.05.2016 03.05.2016 18.05.2016 30.05.2016 08.06.2016 14.06.2016 12.09.2016 19.09.
USER MANUAL PTM 215B – 2.4 GHZ Pusbutton Transmitter Module TABLE OF CONTENT 1 GENERAL DESCRIPTION ................................................................................. 5 1.1 Basic functionality ......................................................................................... 5 1.2 Technical data............................................................................................... 6 1.3 Physical dimensions ................................................................
USER MANUAL PTM 215B – 2.4 GHZ Pusbutton Transmitter Module 2.11.4.4 Product ID Write register ................................................................... 29 2.11.4.1 Optional Data register ....................................................................... 29 2.11.4.2 Configuration register ........................................................................ 30 2.11.4.3 Customer Data ................................................................................. 30 2.11.5 Private Data .
USER MANUAL PTM 215B – 2.4 GHZ Pusbutton Transmitter Module 1 GENERAL DESCRIPTION 1.1 Basic functionality PTM 215B enables the realization of energy harvesting wireless switches for EnOcean systems communicating based on the 2.4 GHz BLE communication standard. PTM 215B is mechanically compatible with the established PTM 21x form factor enabling quick integration into a wide range of designs.
USER MANUAL PTM 215B – 2.4 GHZ Pusbutton Transmitter Module 1.
USER MANUAL PTM 215B – 2.4 GHZ Pusbutton Transmitter Module 2 FUNCTIONAL INFORMATION 2.1 PTM 215B Device Overview The pushbutton transmitter module PTM 215B from EnOcean enables the implementation of wireless remote controls without batteries. Power is provided by a built-in electro-dynamic power generator. PTM 215B device transmits data based on the 2.4GHz BLE standard. The outer appearance of PTM 215B is shown on the picture below.
USER MANUAL PTM 215B – 2.4 GHZ Pusbutton Transmitter Module 2.
USER MANUAL PTM 215B – 2.4 GHZ Pusbutton Transmitter Module 2.4 User Interface PTM 215B 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 (48 Bit device ID) whenever the energy bow is pushed or released.
USER MANUAL PTM 215B – 2.4 GHZ Pusbutton Transmitter Module 2.5 PTM 215B radio channel parameters PTM 215B transmits advertising telegrams within the 2.4 GHz radio frequency band (2402MHz … 2482MHz) using the BLE advertising frame format. By default, PTM 215B will use the three BLE advertising channels (Channel 37, 38 and 39) defined for transmission. Table 1 below summarizes the radio channel assignment within the BLE standard.
USER MANUAL PTM 215B – 2.4 GHZ Pusbutton Transmitter Module 2.6 PTM 215B button action encoding Figure 6 below shows the button action encoding used by PTM 215B. In PTM 215B, the type of action (Press Action or Release Action) is indicated by Bit 0 (Energy Bar). If a button contact has been actuated during Press Action or Release Action then this is indicated by the according status bit set to ‘1’. Note that all contacts that were pressed during Press Action will be released during Release Action.
USER MANUAL PTM 215B – 2.4 GHZ Pusbutton Transmitter Module 2.7 PTM 215B commissioning Commissioning is the process by which PTM 215B is learned into a receiver (actuator, controller, gateway, etc.). The following two tasks are required in this process: n Device identification The receiver needs to know how to uniquely identify this specific PTM 215B device. This is achieved by using a unique 48 Bit ID (Source Address) for each PTM 215B device as described in chapter 2.9.4.
USER MANUAL PTM 215B – 2.4 GHZ Pusbutton Transmitter Module 2.8 Operation modes PTM 215B can operate in two modes: n Data mode Data mode is used to transmit data telegrams reporting the status of PTM 215B button inputs n Radio-based commissioning mode Radio-based commissioning mode is used to commission (teach-in) PTM 215B into a specific receiver or network by means of a specific commissioning telegram. This is an alternative for scenarios where NFC commissioning cannot be used. 2.8.
USER MANUAL PTM 215B – 2.4 GHZ Pusbutton Transmitter Module 2.8.2 Radio-based commissioning mode Radio-based commissioning mode is used to associate PTM 215B with other devices. To do so, PTM 215B can transmit a dedicated commissioning telegram (as described in chapter 2.9.6.2) identifying its relevant parameters.
USER MANUAL PTM 215B – 2.4 GHZ Pusbutton Transmitter Module 2.8.2.2 Commissioning telegram transmission PTM 215B will transmit a commissioning telegram (as sequence of Advertising Events on the BLE advertising channels as described in chapter 2.5) upon entering commissioning mode. The format of the commissioning telegram is described in chapter 2.9.6.2.
USER MANUAL PTM 215B – 2.4 GHZ Pusbutton Transmitter Module 2.9 BLE frame structure PTM 215B transmits radio telegrams in the 2.4 GHz band according to BLE frame structure. For detailed information about the BLE standard, please refer to the applicable specifications. Figure 8 below summarizes the BLE frame structure. Figure 8 – BLE frame structure The content of these fields is described in more detail below. 2.9.1 Preamble The BLE Preamble is 1 byte long and identifies the start of the BLE frame.
USER MANUAL PTM 215B – 2.4 GHZ Pusbutton Transmitter Module 2.9.4 Source address The 6 byte BLE Source Address (MAC address) uniquely identifies each PTM 215B product.
USER MANUAL PTM 215B – 2.4 GHZ Pusbutton Transmitter Module 2.9.4.2 Private resolvable source address mode For some applications it is desirable to modify (rotate) the source address used by PTM 215B in order to prevent tracking of its radio transmissions. At the same time, each PTM 215B device must remain uniquely identifiable by the receiver. To achieve these goals, PTM 215B can be configured via NFC to use random resolvable private addresses.
USER MANUAL PTM 215B – 2.4 GHZ Pusbutton Transmitter Module The receiving device maintains a list of IRK for all transmitters that have been commissioned to work with it. Whenever the receiving device receives a radio telegram with private resolvable source address (identified by the most significant bits being set to 0b10), it will itself generate a 24 bit hash from the 24 bit prand sequentially using the IRK of each device that it has been learned into it. If an IRK matches (i.e.
USER MANUAL PTM 215B – 2.4 GHZ Pusbutton Transmitter Module 2.9.6 Payload The payload structure is depending on the telegram type (data telegram or commissioning telegram). 2.9.6.1 Data Telegram Payload The payload of data telegrams is 13 … 17 bytes long and consists of the following fields: n Length (1 byte) The Length field specifies the combined length of the following fields. The content of the field depends on the size of the Optional Data field (which can be 0 / 2 / 2 or 4 byte).
USER MANUAL PTM 215B – 2.4 GHZ Pusbutton Transmitter Module Figure 13 – Data telegram payload structure 2.9.6.2 Commissioning Telegram Payload The payload of commissioning telegrams is 31 bytes long and consists of the following fields: n Length (1 byte) The Length field specifies the combined length of the following fields.
USER MANUAL PTM 215B – 2.4 GHZ Pusbutton Transmitter Module 2.10 Telegram authentication PTM 215B implements telegram authentication to ensure that only telegrams from senders using a previously exchanged security key will be accepted. Authentication relies on a 32 bit telegram signature which is calculated as shown in Figure 15 below and exchanged as part of the radio telegram.
USER MANUAL PTM 215B – 2.4 GHZ Pusbutton Transmitter Module 2.10.1 Authentication implementation PTM 215B implements telegram authentication based on AES128 in CCM (Counter with CBC-MAC) mode as described in IETF RFC 3610. The 10 Byte CCM Nonce (number used once – unique) initialization value is constructed as concatenation of 48 bit Device ID and 32 bit Sequence Counter in little endian format (least significant byte first. Figure 16 below shows the AES128 Nonce.
USER MANUAL PTM 215B – 2.4 GHZ Pusbutton Transmitter Module 2.11 NFC interface PTM 215B implements NFC Forum Type 2 Tag functionality as specified in the ISO/IEC 14443 Part 2 and 3 standard. This NFC functionality can be used to access (read and write) the PTM 215B configuration memory and thereby configure the device as described in the following chapters. 2.11.
USER MANUAL PTM 215B – 2.4 GHZ Pusbutton Transmitter Module 2.11.2 Memory Address Map The NFC-accessible configuration memory is organized in memory pages where each memory page is 4 byte wide. Each NFC access reads or writes one memory page. The addresses map of the configuration memory is shown in Figure 19 below. The byte order is little endian, i.e. Byte 0 will be read first and Byte 3 last.
USER MANUAL PTM 215B – 2.4 GHZ Pusbutton Transmitter Module 2.11.3 Public data Public data can be read by any NFC-capable device supporting the ISO/IEC 14443 Part 2 and 3 standard. No specific security measures are used to restrict read access to this data. The following items are located in the public data area: n PTM 215B Static Source Address (32 Bit, see chapter 2.9.4.
USER MANUAL PTM 215B – 2.4 GHZ Pusbutton Transmitter Module 2.11.4.1 PIN Code Protected data access is only possible after unlocking the configuration memory with the correct 32 bit PIN code. By default, the protected area is locked and the default pin code for unlocking access is 0x0000E215. This pin code should be changed to a user-defined value as part of any NFCbased installation process. 2.11.4.
USER MANUAL PTM 215B – 2.4 GHZ Pusbutton Transmitter Module 2.11.4.3 Security Key Write register The Security Key Write register is 16 byte wide and contains the device-unique random security key. The factory programmed key can be replaced with a user defined key by following these steps: 1.
USER MANUAL PTM 215B – 2.4 GHZ Pusbutton Transmitter Module 2.11.4.4 Product ID Write register The Product ID register is 8 byte wide and can be used to specify a publicly-accessible parameter (e.g. a user-specific ID or name). In order to do so, follow these steps: 1. Write new product ID (using ASCII encoding) into the Product ID Write register. 2. Set the Update Product ID flag in the Configuration register to 0b1 3.
USER MANUAL PTM 215B – 2.4 GHZ Pusbutton Transmitter Module 2.11.4.2 Configuration register The Configuration register is 1 byte wide and contains configuration flags. Figure 20 below shows the structure of the Configuration register. Figure 20 – Configuration register structure 2.11.4.3 Customer Data PTM 215B allocates 64 pages (256 byte) for customer data that can be read and written via the NFC interface in protected mode.
USER MANUAL PTM 215B – 2.4 GHZ Pusbutton Transmitter Module 2.11.5 Private Data The private data area stores the following items: n Security Key n Default settings The content of the private data area is not externally accessible. 2.11.5.1 Security Key The Security Key field contains the 128-Bit key used for authenticating PTM 215B telegrams and for resolving private source addresses. 2.11.5.
USER MANUAL PTM 215B – 2.4 GHZ Pusbutton Transmitter Module 2.12 Factory Reset PTM 215B can be reset to its default settings by means of a factory reset. This ensures that PTM 215B can be reset to a known configuration in case the PIN for the NFC access has been lost or NFC access is not possible for other reasons In order to execute such factory reset, the rocker(s) and the switch housing have to be removed from the PTM 215B module.
USER MANUAL PTM 215B – 2.4 GHZ Pusbutton Transmitter Module 3 Device Integration PTM 215B 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 variety of existing designs. 3.1 Mechanical Interface Characteristics Energy bow travel / operating force Restoring force at energy bow Number of operations at 25°C 1.8 mm / typ.
USER MANUAL PTM 215B – 2.4 GHZ Pusbutton Transmitter Module 1) these catwalks are not needed when using one single rocker only 2) dimensions of rocker part Figure 22 – PTM 215B, top view (note cut A, B and C marking) © 2016 EnOcean | www.enocean.com F-710-017, V1.0 PTM 215B User Manual | v0.
USER MANUAL PTM 215B – 2.4 GHZ Pusbutton Transmitter Module Figure 23 – PTM 215B, cut A 2) dimensions of rocker part Figure 24 – PTM 215B, cut B and C © 2016 EnOcean | www.enocean.com F-710-017, V1.0 PTM 215B User Manual | v0.
USER MANUAL PTM 215B – 2.4 GHZ Pusbutton Transmitter Module Hatched areas: support planes Figure 25 – PTM 215B rear view © 2016 EnOcean | www.enocean.com F-710-017, V1.0 PTM 215B User Manual | v0.
USER MANUAL PTM 215B – 2.4 GHZ Pusbutton Transmitter Module 2) dimensions of rocker part Figure 26 – PTM 215B, side view If the rocker is not mounted on the rotation axis of PTM 215B several tolerances have to be considered! The measure from support plane to top of the energy bow is 7.70 mm +/- 0.3 mm! The movement of the energy bow must not be limited by mounted rockers! Catwalks of the switch rocker must not exert continuous forces on the button contacts! © 2016 EnOcean | www.enocean.
USER MANUAL PTM 215B – 2.4 GHZ Pusbutton Transmitter Module 3.3 Device Label Each PTM 215ZE module contains a device label as shown in Figure 27 below. Figure 27 – PTM 215B device label This device label identifies the following parameters in writing: n Manufacturing date (WEEK / YEAR) n Source Address (SOURCE_ID) Note that the device label also contains a DMC code in the lower right corner as described below. © 2016 EnOcean | www.enocean.com F-710-017, V1.0 PTM 215B User Manual | v0.
USER MANUAL PTM 215B – 2.4 GHZ Pusbutton Transmitter Module 3.3.1 Device DMC Each PTM 215B module contains a data matrix code (DMC) on the lower right hand side of the device label which can be used to automatically scan device parameters. The DMC uses the ECC200 standard to encode up to 52 characters.
USER MANUAL PTM 215B – 2.4 GHZ Pusbutton Transmitter Module 4 APPLICATION INFORMATION 4.1 Transmission range The main factors that influence the system transmission range are: - Type and location of the antennas of receiver and transmitter - Type of terrain and degree of obstruction of the link path - Sources of interference affecting the receiver - “Dead spots” caused by signal reflections from nearby conductive objects.
USER MANUAL PTM 215B – 2.4 GHZ Pusbutton Transmitter Module 5 REGULATORY INFORMATION PTM 215B has been certified according to FCC, IC and CE regulations. Changes or modifications not expressly approved by EnOcean could void the user's authority to operate the equipment. 5.1 FCC (United States) Certificate 5.1.1 FCC (United States) Regulatory Statement This device complies with part 15 of the FCC Rules.
USER MANUAL PTM 215B – 2.4 GHZ Pusbutton Transmitter Module 5.2 IC (Industry Canada) Certificate 5.2.1 IC (Industry Canada) Regulatory Statement This device complies with Industry Canada licence-exempt RSS standard(s). Operation is subject to the following two conditions: (1) this device may not cause interference, and (2) this device must accept any interference, including interference that may cause undesired operation of the device.