Dolphin TCM 515Z User Manual

Page 1
USER MANUAL
TCM 515Z – 2.4 GHZ IEEE 802.15.4 Transceiver
© 2017 EnOcean | www.enocean.c om F-710-017, V1.0 TCM 515Z User Manual | v1.6 | September 2017 | Page 1/46
Patent protected:
Observe precautions! Electrostatic sensitive devices!
11 September 2017
Page 2
USER MANUAL
TCM 515Z – 2.4 GHZ IEEE 802.15.4 Transceiver
© 2017 EnOcean | www.enocean.c om F-710-017, V1.0 TCM 515Z User Manual | v1.6 | September 2017 | Page 2/46
REVISION H I STORY
The following major modifications and improvement s have been made to thi s document:
Version
Author
Reviewer
Date
Major Changes
1.0
MKA
MK, MF
01.03.2016
Initial Release
1.1
MKA
MKA
01.05.2016
Added protocol description, changed location of TURBO Pin
1.2
MKA
MKA
19.07.2016
Added reflow profile
1.3
MKA
MKA
23.01.2017
Added list of supported ESP3 commands and minimum values for sensitivity and output power
1.4
MKA
MKA
13.02.2017
Added additional ESP3 interface speeds, added
caution note regardin g switching to TU R BO mode
via ESP3 command
1.5
MKA
MKA
12.06.2017
Added infor mation about ant enna options for US (FCC regulation)
1.6
DL
MKA
11.09.2017
Added information about FCC labelling require-
ments, RF exposure and distance requirements
,
FCC and ISED certificates
Published by EnOcean GmbH, Kolpingring 18a, 82041 Ob erhaching, G ermany www.enocean.com, info@enocean.com, phone + 49 (89) 6734 6890
© EnOcean Gm bH , All Rights Reserved
Important!
This information describes the type of component and shall not be considered as assured characteristics. No responsibility is assume d for possible omissions or ina ccuracies. Circuitry and specifications are subject to change without notice. For the latest product specifica­tions, refer to the EnOcean website:
http://www.enocean.com.
As far as patents or other rights of third parties are conc erne d, li ab ilit y is onl y a ssu med f or 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 applicati ons that c an result in danger for peopl e, animals or real value. Component s of th e m odules are cons i dered an d shoul d b e di s posed of as h az ard ous wa ste. Local government regula tions are to be obs erved. Packing: Please use the recycling operators known to you.
Page 3
USER MANUAL
TCM 515Z – 2.4 GHZ IEEE 802.15.4 Transceiver
© 2017 EnOcean | www.enocean.c om F-710-017, V1.0 TCM 515Z User Manual | v1.6 | September 2017 | Page 3/46
TABLE OF CONTENT
1
GENERA L DESCRI PTIO N ................................................................................. 5
1.1 B a sic 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 TCM 51 5Z Device Interface ............................................................................. 7
2.1.1 Signal Description .................................................................................. 8
2.2 High-level operation principle .......................................................................... 8
2.3 Radio Functionality ........................................................................................ 9
2.3.1 Supported Radio Channels ...................................................................... 9
2.3.2 Dut y cycle limit ..................................................................................... 9
2.4 ESP3 Interface ............................................................................................ 10
2.4.1 ES P3 Data Fo rmat................................................................................ 10
2.4.2 Supported ESP3 Commands .................................................................. 10
3 Antenna options .......................................................................................... 11
3.1 General antenna requirements for TCM 515Z .................................................. 11
3.2 Specific antenna req uirements for Europe a n Union .......................................... 11
3.3 Specific antenna requirements for US / Canada ............................................... 11
3.4 Antenna description ..................................................................................... 12
3.4.1 Whip antenna ...................................................................................... 12
3.4.2 Meandered PCB antenna ....................................................................... 13
3.4.3 Dipole a ntenna re q u ir ement s ................................................................ 15
3.4.4 Dipole antenna opti ons ......................................................................... 18
4 Device Integration ....................................................................................... 19
4.1 Re commended PCB Footprint ........................................................................ 19
4.2 S oldering in formation................................................................................... 20
4.3 Device hand li ng i nstruct io ns ......................................................................... 21
4.4 Tape & Reel spe c ificat io n .............................................................................. 22
4.5 Power supply requirements ........................................................................... 23
5 APPLICAT IO N IN F OR M A TI ON ........................................................................ 24
5.1 Transmiss io n ra ng e ..................................................................................... 24
6 REGULATORY INFORMATION......................................................................... 25
6.1 CE (RED) for Eur opean Union ........................................................................ 25
6.2 FCC (United States) Certificate ...................................................................... 26
6.2.1 FCC (United States) regulatory statement ............................................... 27
6.2.2 FCC (United States) labeling requirements .............................................. 27
6.2.3 FCC (United States) RF exposure statement ............................................ 27
6.3 ISED (Indust ry Canada) Technical Acceptance Certificate ................................. 28
Page 4
USER MANUAL
TCM 515Z – 2.4 GHZ IEEE 802.15.4 Transceiver
© 2017 EnOcean | www.enocean.c om F-710-017, V1.0 TCM 515Z User Manual | v1.6 | September 2017 | Page 4/46
6.3.1
ISED (Industry Canada) regulatory statement ......................................... 29
6.3.2 IC (Industry Canada) RF exposure statement .......................................... 29
Appendix A IEEE 802.15.4 Frame Structure ............................................................. 30
A.1 IEEE 802.15.4 High Level Frame Structure ..................................................... 30
A.2 PHY Header ................................................................................................ 31
A.2.1 Length of Frame values used by PTM 215ZE and PTM 535Z .......................... 31
A.3 MAC Header ................................................................................................ 32
A.4 MAC Payload ............................................................................................... 32
A.5 MAC T railer ................................................................................................. 32
Appendix B MAC Payload Structure ......................................................................... 33
B.1 Secure data telegram format (with authentication) .......................................... 34
B.2 Secure commissioning telegram format (with authentication) ........................... 35
B.3 Standard data telegram format (without authentication) .................................. 36
B.4 Standar d commission i ng telegra m (w i thout authent ication) .............................. 37
Appendix C ESP3 Interface Format ......................................................................... 38
C.1 Packet Type 0x10: IEEE 802.15.4 Raw Packet ................................................. 38
C.1.1 ESP3 packet structure for IEEE 802.15.4 Raw Packets .................................. 38
C.1.2 RESPONSE for IEEE 802.15.4 Raw Packets ................................................. 39
C.1.3 Failu r e Indication for IEEE 802.15.4 Raw Packet .......................................... 40
C.2 Packet Type 0x11: IEEE 802.15.4 COMMAND .................................................. 41
C.2.1 Packet structure for IEEE 802.15.4 COMMAND ............................................ 41
C.2.2 List of supported commands ..................................................................... 41
C.2.3 SET_CHANNEL Command ......................................................................... 42
C.2.4 RESPONSE for SET_CHANNEL Command .................................................... 42
C.2.5 GET_CHANNEL Command ......................................................................... 43
C.2.6 RESPONSE for GET_CHANNEL Command .................................................... 43
C.3 Packet Type Common Command ................................................................... 44
C.3.1 Command Code 0x24: CO_SET_BAUDRATE ................................................ 44
C.3.2 RESPONSE for CO_SET_BAUDRATE Command ............................................ 44
C.3.3 Command Code 0x25: CO_GET_FREQUENCY_INFO ..................................... 45
C.3.4 RESPONSE for CO_GET_FREQUENCY_INFO Command .................................. 45
C.3.5 Command Code 37: CO_GET_STEPCODE.................................................... 46
C.3.6 RESPONSE for CO_GET_STEPCODE Command ............................................ 46
Page 5
USER MANUAL
TCM 515Z – 2.4 GHZ IEEE 802.15.4 Transceiver
© 2017 EnOcean | www.enocean.c om F-710-017, V1.0 TCM 515Z User Manual | v1.6 | September 2017 | Page 5/46
1 GENERAL DESCRIPTION
1.1 Basic functionality
TCM 515Z enables the realization of line-powered actuators, controllers and gateways communicating based on the 2.4 GHz IEEE 802.15.4 radio standard. It provides a transpar­ent radio li nk between EnOcean 2.4 GHz devices and an external host connected via the standa r dized ESP3 inter f a ce (EnOcean Ser ia l Protocol, version 3).
TCM 515Z receives and transmits radio telegrams based on a 50 Ohm or whip antenna connecte d to t he host PCB. It forwards received 2.4 GHz IEEE 802.15.4 radio telegrams to an extern a l host processor or host PC via the ESP3 interface.
IEEE 802.15.4 messages received from an external host via the ESP3 interface will be transmitted by TCM 515Z as 2.4 GHz radio telegrams.
TCM 515Z i s implemented as 31 pin reflow-solderabl e module with opti mized form factor for size constrained applications.
Figure 1 below shows TCM 515Z.
Figure 1 – TCM 515Z outline
Page 6
USER MANUAL
TCM 515Z – 2.4 GHZ IEEE 802.15.4 Transceiver
© 2017 EnOcean | www.enocean.c om F-710-017, V1.0 TCM 515Z User Manual | v1.6 | September 2017 | Page 6/46
1.2 Technical data
Antenna
External 50 Ohm or whip antenna (connected at ho st board)
Supported Radio Frequency Range
Radio channel 11 … 2 6 according to IEE E 8 02.15.4 standard
Default Radio Channel
IEEE 802.15.4 radio channel 11
Receiver Sensiti vity (at 25° C)
(1)
Minimum: -92dBm / Typical: –95 dBm
Transmit Power (at 25° C)
Minimum: 0dBm / Typical: +2 dBm
Power Supply
3.3 V +- 10%
Serial Host Interface
UART according to E SP3 Standard with Turbo M ode Option
Current Consumptio n (typ, at 25° C)
Transmit: 20mA, Receive: 15 mA
Radio Regulatio n
R&TTE (Europe), FCC (US), IC (Canada)
Note (1): Receiver sensitivity is based on the combinati o n o f 3 subtel egrams
1.3 Physical dimensions
Module Dimensions
19.0 x 14.7 x 3.0 mm ( each dimension +-0.3 mm)
Module Weight
1 g
1.4 Environmental conditions
Operating Temperature
-25°C ... 85°C
Storage Temperature
-25°C ... 85°C
Humidity
0% to 95% r.h. (non-condensing)
1.5 Packaging information
Packaging Unit
250 units
Packaging Metho d
Tape and reel
1.6 Ordering information
Type
Ordering Code
Frequency
TCM 515Z
S3073-K515
2.4 GHz (IEEE 802.15.4)
Page 7
USER MANUAL
TCM 515Z – 2.4 GHZ IEEE 802.15.4 Transceiver
© 2017 EnOcean | www.enocean.c om F-710-017, V1.0 TCM 515Z User Manual | v1.6 | September 2017 | Page 7/46
2 FUNCTIONAL INFORMATION
2.1 TCM 515Z Device Interface
TCM 515Z implements a 31 pin reflow-solderable interface. Solder mask data is available on request from EnOcean. The pin assignment (as seen from the top of the device) is shown in Figure 2 below.
Figure 2 – TCM 515Z devi ce i nterface
Table 1 below summarizes the signal assignment.
PIN
NAME
PIN
NAME
PIN
NAME
1
GND
12
NC
23
GND 2 ANTENNA (50 Ohms)
13
NC
24
NC 3 GND
14
NC
25
NC 4 NC
15
GND
26
NC 5 NC
16
NC
27
NC 6 GND
17
NC
28
NC
7
NC
18
NC
29
NC
8
NC
19
NC
30
NC
9
NC
20
UART_RX (Input)
31
TURBO
10
NC
21
UART_TX (Output)
11
NC
22
VDD
Table 1 - TCM 5151Z device interface pin assignment
Signals marked with “NC” are reserved for production test and future device variants and must not be connected in the design.
Page 8
USER MANUAL
TCM 515Z – 2.4 GHZ IEEE 802.15.4 Transceiver
© 2017 EnOcean | www.enocean.c om F-710-017, V1.0 TCM 515Z User Manual | v1.6 | September 2017 | Page 8/46
2.1.1 Signal Description
TCM 515Z is supplied by the VDD and GND Pins. The required supply voltage is 3.3V with a toler ance of no more than +-10%.
TCM 515Z receives and transmits data based on a 50Ω whip antenna connected to its AN­TENNA input (Pin 2).
TCM 515Z communicates with the external host using the standard ESP3 serial (UART) in­terface based on the signals UART_TX (Pin 21, direction from TCM 515Z to external host) and UART_RX (Pin 20, direction from external host to TCM 51Z).
The default interface speed of the ESP3 interface is 57600 bit per second (the exact speed is 57347 Bi t per second, a deviation of -0.04%).
It is possible to select faster communication speeds of 115200 , 23 04 00 a n d 460800 bit per second during operation using the CO_S ET _B AU D RATE com mand as shown in Table 15.
Additionally it is possible to change the default ESP3 interface speed at power up from
57.600 Bit per second to 460.800 Bit per second by connecting the TURBO input (Pin 31) to Ground. Subsequent modification of the interface speed during operation using the CO_SET_BAUDRATE command is always possible irrespective of the state of the TURBO input pin.
2.2 High-level operation principle
In receive mode, TCM 515Z for w ards the content of received IEEE 802.15.4 ra dio teleg r ams (which pass frame check sum validation) unmodified to the external host via th e ESP3 in­terface.
The forwarded frame starts with the Length fie ld of th e IEEE 802 .15.4 PH Y Header, contin­ues with the MAC Header and ends with the last Byte of the MAC Payload. The frame check sum (MAC Trailer) will not be forwarded to the host.
In transmit mode, TCM 515Z receives from the external host the precomputed message payload starting with the Length field of the IEEE 802.15.4 PHY Header, continuing with the MAC Header and ending with the last Byte of the MAC Payload.
TCM 515Z then calculates the frame check sum (MAC Trailer) and appends it to the mes­sage. The full frame (including the Preamble and Start of Frame fields) will then be trans­mitted as IEE E 802.1 5. 4 r a dio teleg r a m (TX mode).
Page 9
USER MANUAL
TCM 515Z – 2.4 GHZ IEEE 802.15.4 Transceiver
© 2017 EnOcean | www.enocean.c om F-710-017, V1.0 TCM 515Z User Manual | v1.6 | September 2017 | Page 9/46
2.3 Radio Functionality
2.3.1 Supported Radio Channels
TCM 515Z support all radio channels of the IEEE 802.15.4 standard in the 2.4 GHz band. The radio channel used by TCM 515Z can be set by an external host using the ESP3 SET_CHANNEL command as described in Appendix C.2.3.
The channel notation used by TCM 515Z follows IEEE 802.15.4 standard, i.e. channel 11 is the first channel (lowest frequency) and channel 26 is the last channel (highest frequency). Table 2 below shows the correspondence between channel ID and channel frequency.
Table 2 - Supported radio channels
2.3.2 Duty cycle limit
In orde r to ensure regulatory compliance in some markets, the transm issi on duty cy cle of TCM 515Z may not exceed 35%. An internal SW mechanism therefore monitors the duty cycle and will temporarily reject requests for additional transmissions if this duty cycle is exceeded (not e: this is only p ossible if TURBO mode is used and the host cont inuously re­quests tr ansmission) .
It is the responsibility of the end user to design the host system such that either such tem­porary transmission suspension does not affect the intended appl ication functional ity or to ensure that the transmission duty cycle requested by the host will not exceed 35%.
Page 10
USER MANUAL
TCM 515Z – 2.4 GHZ IEEE 802.15.4 Transceiver
© 2017 EnOcean | www.enocean.c om F-710-017, V1.0 TCM 515Z User Manual | v1.6 | September 2017 | Page 10/46
2.4 ESP3 Interface
TCM 515Z provides a bi-directional UART interface for communicating with the external host. The defaul t baud rat e of this interface is 57600 bps. If the TURBO pin is set to active low then the baud rate is incr ea s e d to 460.800 bps.
2.4.1 ESP3 Data Format
TCM 515Z communicate with external hosts using EnOcean Serial Protocol version 3 (ESP3) with EnOcean 2.4 GHz IEEE 802.15. 4 extensions .
Please consult the detailed ESP3 specification at https://www.enocean.com/esp.
2.4.2 Supported ESP3 Commands
TCM 515Z supports the following ESP3 commands:
Packet Type 0x10: IEEE 802.15.4 Raw Packet Packet Type 0x11: IEEE 802.15.4 COMMAND
o SET_CHANNEL o GET_CHANNEL
Packet Type 0x05: Common Command
o CO_SET_BAUDRATE o CO_GET_FREQUENCY_INFO o CO_GET_STEPCODE
Please refer to Appendix C for a description of the support ed commands.
Page 11
USER MANUAL
TCM 515Z – 2.4 GHZ IEEE 802.15.4 Transceiver
© 2017 EnOcean | www.enocean.c om F-710-017, V1.0 TCM 515Z User Manual | v1.6 | September 2017 | Page 11/46
3 Antenna options
This chapter outlines options for antenna that can be used with TCM 515Z. Note that this chapter is for guidance purposes only, please consult with an authorized certification body for specific information.
3.1 General antenna requirements for TCM 515Z
Antenna used with TCM 515Z shall always meet the requirements listed in Table 3 below.
Frequency Band
2.45GHz ISM
Antenna Type
Passive
Impedance
50Ω, VSWR≤3
Maximum Gain
≤6dBi
Table 3 – General antenna requirements
3.2 Specific antenna requirements for European Union
TCM 515Z can be used with the antennas described in subsequent chapters. See chapter 6.1 for additional impo r tant remarks regarding RED certification.
3.3 Specific antenna requirements for US / Canada
The TCM 515Z has been tested and certified according to FCC regulation with a number of different antennas as described below.
Page 12
USER MANUAL
TCM 515Z – 2.4 GHZ IEEE 802.15.4 Transceiver
© 2017 EnOcean | www.enocean.c om F-710-017, V1.0 TCM 515Z User Manual | v1.6 | September 2017 | Page 12/46
3.4 Antenna description
The T CM 51 5Z ha s been tested and certified according to FCC regulation with a number of different antennas as described below.
3.4.1 Whip antenna
TCM 515Z modules can be used with a whip antenna meeting key parameters shown in Figure 3 below.
Figure 3 – Whip antenna p ara meters for 2.4 GHz
The whip antenna has to meet the following parameters:
Antenna length (L): 30 mm wire, connect to RF_WHIP Minimum GN D plane: 15 mm x 15 mm Minimum distance space: 10 mm
The r e fe r en ce layout for this antenna is shown in Figure 4 below. The area wit hin th e gr e en dotted rectang le and the minimum groun d plane has to be imple mented ex actly as shown in order to use EnOcean modular approval for US / Canada.
Figure 4 – Whi p antenna reference layout
Page 13
USER MANUAL
TCM 515Z – 2.4 GHZ IEEE 802.15.4 Transceiver
© 2017 EnOcean | www.enocean.c om F-710-017, V1.0 TCM 515Z User Manual | v1.6 | September 2017 | Page 13/46
Additionally, the transmission line between TCM 515Z and the whip antenna has to be im­plemented as specified in Figur e 5 below in order t o use EnOc ean modul ar approv al for US / Canada.
w=1.00mm
s=0.15mm h=0.90…2.00mm (See Note 1)
Typical line impedance on FR4=44…56Ω
Return loss>=24dB
Figure 5 – Tr ansmission li ne sp ecification
Note (1): Coplanar waveguide modes are dominant in this configuration. Thus thickness of substrate can be changed with the given limits.
3.4.2 Meandered PCB antenna
TCM 515Z has been certified for use with a meandered PCB antenna provided that the fol­lowing layout guidelines are met:
Matching circuit values of the modular approval may not be changed Shape according to reference layout in Figure 6 Minimum GN D plane: 40 mm x 18 mm Connect GND planes using multiple via as shown in Fi gure 6 Minimum distance space: 10 mm Matching circuit components as specified in Table 4
Page 14
USER MANUAL
TCM 515Z – 2.4 GHZ IEEE 802.15.4 Transceiver
© 2017 EnOcean | www.enocean.c om F-710-017, V1.0 TCM 515Z User Manual | v1.6 | September 2017 | Page 14/46
Figure 6 below s hows the dimensions of the meandered PCB antenna, the matching circuit and the area important for US / Canada modular approval (marked in green).
Figure 6 – Reference lay out for meandered PCB antenna
Table 4 below lists the parameters of the match ing circu it compon ents. It is m andator y to use them as specified for US / Canada modular approval usage.
Designator
Value
Notes
C8
1.0pF
Use Mura ta GRM1555 series or similar
R9
6.8nH
Use Würth WE-KI series, Murata LQW series or similar
C9
---
Not assembled
Table 4 – Parameters of the matching circuit
Page 15
USER MANUAL
TCM 515Z – 2.4 GHZ IEEE 802.15.4 Transceiver
© 2017 EnOcean | www.enocean.c om F-710-017, V1.0 TCM 515Z User Manual | v1.6 | September 2017 | Page 15/46
3.4.3 Dipole antenna requirements
The TCM 515Z has been certified for use with the dipole antenna S151AH-2450S from Nearson or other antenna s with similar parameters provided that:
The RF connector is a non-standard connector such as a RP-SMA-Female from John-
son/Cinch Connectivity Solutions (142-4701-801)
The pi low pass filter described in this section is used
In addition, the following layout guidelines have to be met:
The pi low pass filter is part of the modular approval and may not be changed The bott om GND plane is implemented below the RF transmission line section of the
circuit to form a grounded coplanar waveguide (see Figure 8)
The ground planes have to be connected using multiple via along RF transmission
line as shown in Figure 7 and Figure 8
Table 6 at the end of this section lists dipole antennas that can be used instead of the S151AH-2450S antenna stated previously as they are the same kind of antennas and have the same or less gain.
Figure 7 below shows the layout that has been used. The section of the layout locat ed with­in the green frame has to remain unchang e d f o r US / Canada modular approval usage.
Figure 7 – Reference lay out for dipole antenna
Page 16
USER MANUAL
TCM 515Z – 2.4 GHZ IEEE 802.15.4 Transceiver
© 2017 EnOcean | www.enocean.c om F-710-017, V1.0 TCM 515Z User Manual | v1.6 | September 2017 | Page 16/46
Table 5 below lists the par amet ers of th e c ompon ent s which have to be used for th e pi l ow pass filter.
Designator
Value
Notes
C1
1.0pF
use Murata GRM1555 series or similar
C2
1.0pF
use Murata GRM1555 series or similar
L1
3.1nH
use Murata LQP15MN series or similar
Table 5 – Values of the pi low pass filter for the dipole antenna
The transmission line between TCM 515Z and the antenna has to be implemented as shown in Figure 8 below.
w=1.00mm
s=0.15mm h=0.90…2.00mm (See Note 1)
Typical line impedance on FR4=44…56Ω
Return loss>=24dB
Figure 8 – Detailed description of RF transmission line
Note (1): Coplanar waveguide modes are dominant in this configuration. Thus thickness of substrate can be changed with the given limits.
Page 17
USER MANUAL
TCM 515Z – 2.4 GHZ IEEE 802.15.4 Transceiver
© 2017 EnOcean | www.enocean.c om F-710-017, V1.0 TCM 515Z User Manual | v1.6 | September 2017 | Page 17/46
Figure 9 below show s S151AH-2450S fro m Nearso n.
Figure 9 - S151AH-2450S
Figure 10 bel ow shows the RP-SMA-Female (142-4701-801) from Chinch Connectivity Solu­tions as an example for a n on-standard RF connector required for US / Canada modular approval usage.
Figure 10 – RP-SMA-Female
Page 18
USER MANUAL
TCM 515Z – 2.4 GHZ IEEE 802.15.4 Transceiver
© 2017 EnOcean | www.enocean.c om F-710-017, V1.0 TCM 515Z User Manual | v1.6 | September 2017 | Page 18/46
3.4.4 Dipole antenna options
Table 6 below sh ows examples of dipole antennas that could be used with TCM 5151Z un­der US / Canada modular approval.
Manufacturer
Manufacturer Part Number
Gain
Antenna Type
Nearson Inc. 1
S151AH-2450S
5dBi
Whip (Dipole), Tilt
Nearson Inc.
S131AH-2450S
5dBi
Whip (Dipole), Tilt
Nearson Inc.
S181AH-2450S
2dBi
Whip (Dipole), Tilt
ATOP Technologies
ANT-WS-AB-RM-05-200
5dBi
Whip (Dipole), Straight
ATOP Technologies
ANT-WS-AB-RM-05-180
5dBi
Whip (Dipole), Straight
Digi Interna tional
A24-HASM-525
2.1dBi
Whip (Dipole), Tilt
Digi Interna tional
A24-HASM-450
2.1dBi
Whip (Dipole), Tilt
Digi Interna tional
DG-ANT-20DP-BG
2dBi
Whip (Dipole), Tilt
Digi Interna tional
DC-ANT-24DP
1.8dBi
Whip (Dipole), Tilt
Digi Interna tional
DC-ANT-24DT
1.8dBi
Whip (Dipole), Straight
Honeywell
WAN01RSP
2.2dBi
Whip (Dipole), Straight
Honeywell
WAN02RSP
2.2dBi
Whip (Dipole), Tilt
Laird Technolog ies IA S
S2403BH36RSM
3dBi
Whip (Dipole), Straight
Laird Technologies IAS
EXR2400RSM
3dBi
Whip (Dipole), Tilt
Laird Technolog ies IA S
MAF94046
1.3dBi
Whip (Dipole), Tilt
Laird Technolog ies IA S
MAF94028
1.3dBi
Whip (Dipole), Tilt
Laird Technolog ies IA S
MAF94112
1.5dBi
Whip (Dipole), Tilt
Linx Technologi es In c.
ANT-2.4-CW-HW
3.2dBi
Whip (Dipole), Straight
Linx Technologi es In c.
ANT-2.4-CW-RCT-RP
2.2dBi
Whip (Dipole), Tilt
Linx Technologi es In c.
ANT-2.4-CW-HWR-RPS
3.2dBi
Whip (Dipole), Tilt
Linx Technologi es In c.
ANT-2.4-CW-CT-RPS
2.8dBi
Whip (Dipole), Straight
LSR
001-0010
2dBi
Whip (Dipole), Tilt
LSR
001-0001
2dBi
Whip (Dipole), Tilt
Microchip Technology
RN-SMA4-RP
2.2dBi
Whip (Dipole), Tilt
Proant AB
333
3dBi
Whip (Dipole), Tilt
Proant AB
348
3dBi
Whip (Dipole), Straight
Pulse Electronics
W1037
3.2dBi
Whip (Dipole), Tilt
Pulse Electronics
W1027
3.2dBi
Whip (Dipole), Tilt
Pulse Electronics
W1030
2dBi
Whip (Dipole), Tilt
Pulse Electronics
W5010
1.5dBi
Whip (Dipole), Straight
Pulse Electronics
W5001
1.5dBi
Whip (Dipole), Right Angle
Red Lion Controls
ANT-GW11A153
2.3dBi
Whip (Dipole), Tilt
Siretta Ltd
DELTA6B/X/SMAM/RP/S/11
5dBi
Whip (Dipole), Tilt
Siretta Ltd
DELTA10A/X/SMAM/RP/S/17
3dBi
Whip (Dipole), Straight
Taoglas Limited
GW.11.A153
2.3dBi
Whip (Dipole), Tilt
Taoglas Limited
GW.26.0151
1.8dBi
Whip (Dipole), Straight
Walsin Technology
RFDPA151300SBAB8G1
3dBi
Whip (Dipole), Tilt
Walsin Technology
RFDPA171300SBAB8G1
3dBi
Whip (Dipole), Tilt
Walsin T echno logy
RFDPA870900SBAB8G1
2dBi
Whip (Dipole), Tilt
Table 6 – Dipole antenna options
1
This antenna was tested for FCC and IC certification
Page 19
USER MANUAL
TCM 515Z – 2.4 GHZ IEEE 802.15.4 Transceiver
© 2017 EnOcean | www.enocean.c om F-710-017, V1.0 TCM 515Z User Manual | v1.6 | September 2017 | Page 19/46
4 Device Integration
TCM 515Z is designed for integration ont o a host PCB . Detailed Gerber data of the device footprint is avail a bl e f rom EnOcean upon r e qu est .
4.1 Recommended PCB Footprint
Figure 11 below shows the recommended PCB footpri nt for TCM 515Z.
Figure 11 – R ecom mend ed PCB footp rint
Page 20
USER MANUAL
TCM 515Z – 2.4 GHZ IEEE 802.15.4 Transceiver
© 2017 EnOcean | www.enocean.c om F-710-017, V1.0 TCM 515Z User Manual | v1.6 | September 2017 | Page 20/46
4.2 Soldering information
TCM 515Z has to be soldered according to IPC/JEDEC J-STD-020C standard as outlined in Figure 12 below.
Figure 12 – Recommended temperature profile
Page 21
USER MANUAL
TCM 515Z – 2.4 GHZ IEEE 802.15.4 Transceiver
© 2017 EnOcean | www.enocean.c om F-710-017, V1.0 TCM 515Z User Manual | v1.6 | September 2017 | Page 21/46
4.3 Device handling instructio ns
TCM 515Z shall be handled according to Moisture Sensitivity Level MSL 3. TCM 515Z may be soldered only once, since one time is already consumed at production of the module itself.
Once the dry pack bag is opened, the desired quantity of units should be removed and the bag resealed within two hours. If the bag is left open longer than 30 minutes the desiccant should be replaced with dry desiccant. If devices have exceeded the specified floor life time of 168 h, they may be baked according IPC/JEDEC J-STD-033B at m ax . 9 0 °C f o r l e s s than 60 hours.
Devices packaged in moisture-proof packaging should be stored in ambient conditions not exceeding temperatures of 40 °C or humidity levels of 90% r.H.
TCM 515Z modules have to be soldered within 6 months after delivery! In general we recommend a no clean flux process. If washing is needed, then TCM 515Z
radio modu les have a shield cover with small openings at the top of the edges. It is ver y im portant to m ount th e module s in a top down posit i on du ring the dryin g proc es s
as this will allow getting the aggregated washing fluid removed properly from within the shield cover area.
To prevent damage, modules have to be checked for any remaining fluid after the drying.
Page 22
USER MANUAL
TCM 515Z – 2.4 GHZ IEEE 802.15.4 Transceiver
© 2017 EnOcean | www.enocean.c om F-710-017, V1.0 TCM 515Z User Manual | v1.6 | September 2017 | Page 22/46
4.4 Tape & Reel specification
TCM 515Z is delivered in Tape & Reel packaging with 250 units per reel. Figure 13 below illustrates the dimensions.
Figure 13 – Tape & Reel dimensions of TCM 515Z
Figure 14 below shows the positi oning of TCM 515Z in the Tape & Reel pack a ging.
Figure 14 – Position of TCM 515Z in the reel
Page 23
USER MANUAL
TCM 515Z – 2.4 GHZ IEEE 802.15.4 Transceiver
© 2017 EnOcean | www.enocean.c om F-710-017, V1.0 TCM 515Z User Manual | v1.6 | September 2017 | Page 23/46
4.5 Power supply requirements
In order to provide a good radio performanc e, great attention must be paid to the power supply and a correct layout and shielding. It is recommended to place a 22 µF ceramic ca­pacitor b et we en VDD and GND close to the m odu le (material: X5R, X7R, min 6.3 V to avoid derating effects).
In additi on, an HF SMD EMI Suppression Ferrite Bead such as the Würth WE-CBF HF SMD EMI Suppression Ferrite Bead (Würth order number 742863160) shall be inserted in the power supply line.
For best perf ormance it is r ecommend ed to keep t he ripple on the power supply rail below 10 mVpp.
TCM 515Z integrates approximately 10 uF of capacitance for filtering the internal supply voltage bus. The power supply architecture has to be capable of supplying sufficient current to charge this capacitance during power up.
Page 24
USER MANUAL
TCM 515Z – 2.4 GHZ IEEE 802.15.4 Transceiver
© 2017 EnOcean | www.enocean.c om F-710-017, V1.0 TCM 515Z User Manual | v1.6 | September 2017 | Page 24/46
5 APPLICATION INFORMATION
5.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 degre e of obstruction of the link path
- Sources of interference affecting the receiver
- “Dead spots” caused by signal reflections from nearby conductive objects.
Since the expected transmission range strongly depends on this system conditions, r ange tests should always be performed to determine the reliably achievable range under the giv­en conditions.
The following figures sh ould be treated as a rough guide onl y:
- Line-of-sight connections Typically 15 m range in corridors, up to 50 m in halls
- Plasterboard walls / dry wood Typically 15 m range, through max. 2 walls
- Ferro conc rete walls / ceilings Maximum 1 wall or ceiling , dep ending on thickness and material
- Fire-safety walls, elevator shafts, staircases an d similar areas should be considered as shielded
The angle at which the transmitted signal hits the wall is very important. The effective wall thickness – and with it the signal attenuation – varies according to this angle. Signals should be transmitted as directly as possible through the wall. Wall nich es sh ould be avoi d­ed.
Other factors restricting transmission range include:
- Switch m ounting on metal sur faces (up to 30% loss of transmission range)
- Hollow lightweight walls filled with insulating wool on metal foil
- False ceilings with panels of metal or carbon fibre
- Lead glass or glass with metal coating, steel furniture
The distance between the receiver and other transmitting devices such as computers, audio and video equipment that also emit high-frequency signals shoul d be at lea s t 0. 5 m.
Page 25
USER MANUAL
TCM 515Z – 2.4 GHZ IEEE 802.15.4 Transceiver
© 2017 EnOcean | www.enocean.c om F-710-017, V1.0 TCM 515Z User Manual | v1.6 | September 2017 | Page 25/46
6 REGULATORY INFORMATION
TCM 515Z has been certified according to FCC, IC and CE regulations. Changes or modifications not expressly approved by EnOcean could void the user's authori­ty to operate the equipment.
6.1 CE (RED) for European Union
According to lows of the member states of the European Union OEM manufacturer or dis­tributor are responsible for the conformity of the prod uct. In order to su pport our custom­ers we have done a summary for download at the product web site (Attestation of Con­formity).
Note the following requirements for CE certification: The existing R&TTE directive has been replaced by RED (radio equipment directive) since
13th of June 2016. OEM manufacturers or distributors which sell this component as a product to his (final) cus-
tomers have to fulfill all requirements of the radio equipment directive (RED). RED contains at least following requirements for OEM manufacturers or distributors:
Provide product branding (on the product) clearly identifying company name or
brand and product name as well as type, charge or serial number for market surveil­lance
Include (with the product) documentation containing full postal address of the man-
ufacturer as well as radio frequency band and max. transmitting power
Include (with the product) user manual, safety information and a declaration of con-
formity for the final product in local language
Provide product development and test documentation upon request OEM has to fulfill all additional requirements according to RED such as market sur-
veillance or 10 years record retention.
For details and national translations, please see:
http://eur-lex.europa.eu/legal-content/EN/TXT/?uri=celex:32014L0053
Page 26
USER MANUAL
TCM 515Z – 2.4 GHZ IEEE 802.15.4 Transceiver
© 2017 EnOcean | www.enocean.c om F-710-017, V1.0 TCM 515Z User Manual | v1.6 | September 2017 | Page 26/46
6.2 FCC (United States) Certificate
Page 27
USER MANUAL
TCM 515Z – 2.4 GHZ IEEE 802.15.4 Transceiver
© 2017 EnOcean | www.enocean.c om F-710-017, V1.0 TCM 515Z User Manual | v1.6 | September 2017 | Page 27/46
6.2.1 FCC (United States) regulatory statement
This devi ce complies with part 15 of the FCC Rules. Operation is subject to the following two conditions:
(1) this device may not cause harmful interference, and (2) this device must accept any interference received, including interference that may
cause undesired operation.
6.2.2 FCC (United States) labeling requirements
This modu le is labeled with its own FCC ID number, and, if the FCC ID is not visible when this module is installed inside another device, then the outside of this device into which the module is installed must also display a label referring to this enclosed module.
This exterior label can use wording such a s the following:
"Contains Transmitter Module FCC ID: SVZ-TCM515Z"
Or alternatively:
"Contains FCC ID: SVZ-TCM515Z"
Any similar wording that exp res ses the same m ea ning ma y be used. Figure 15 below shows an example of such label.
Figure 15 – Label example
6.2.3 FCC (United States) RF exposure statement
This modul e must not be used with in a separation d istance of 20cm or less between the user and/or bystander and the antenna and/or radiating element.
Calculation of e.i.r.p. (effective isotropic radiated power): conducted output power: 2.9dBm
maximum gain of antenna: 5.0dBi maximum e.i.r.p.: 7.9dBm maximum e.i.r.p. in Watts: 0.00617W
Exception limit for conduted output power (or e.i.r.p.), when distance >20cm: 1.31 x 10
-2 ƒ0.6834
W (f in MHz ) Frequency: 2500MHz Limit: 2.75W
Contains FCC ID: SVZ-TCM515Z
Page 28
USER MANUAL
TCM 515Z – 2.4 GHZ IEEE 802.15.4 Transceiver
© 2017 EnOcean | www.enocean.c om F-710-017, V1.0 TCM 515Z User Manual | v1.6 | September 2017 | Page 28/46
6.3 ISED (Industry Canada) Technical Acceptance Certificate
Page 29
USER MANUAL
TCM 515Z – 2.4 GHZ IEEE 802.15.4 Transceiver
© 2017 EnOcean | www.enocean.c om F-710-017, V1.0 TCM 515Z User Manual | v1.6 | September 2017 | Page 29/46
6.3.1 ISED (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 unde-
sired operation of the device. Le présent appareil est conforme aux CNR d'Industrie Canada applicables aux appareils
radio exempts de licence. L'exploitation est autorisée aux deux conditions suivantes :
(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
broui llage est su s ce ptible d' en comp r o mettre le fonc tionnement.”
6.3.2 IC (Industry Canada) RF exposure statement
This modul e must not be used with in a separation d istance of 20cm or less between the user and/or bystander and the antenna and/or radiating element.
Calculation of e.i.r.p. (effective isotropic radiated power): conducted output power: 2.9dBm
maximum gain of antenn a: 5.0dBi maximum e.i.r.p.: 7.9dBm maximum e.i.r.p. in Watts: 0.00617W
Exception limit for conduted output power (or e.i.r.p.), when distance >20cm: 1.31 x 10
-2 ƒ0.6834
W Frequency: 2500MHz Limit: 2.75W
Page 30
USER MANUAL
TCM 515Z – 2.4 GHZ IEEE 802.15.4 Transceiver
© 2017 EnOcean | www.enocean.c om F-710-017, V1.0 TCM 515Z User Manual | v1.6 | September 2017 | Page 30/46
Appendix A IEEE 802.15.4 Frame Structure
A.1 IEEE 802.15.4 High Level Frame Structure
TCM 515Z transmits and receives radio telegrams in the 2.4 GHz band according to IEEE
802.15.4 frame structure. The external host is responsible for the proper decoding of re­ceived telegrams and proper encoding of telegrams to be transmitted.
The followin g inf ormation ab out the IEE E 802.15. 4 standa rd and its im plement ation in P TM 215ZE and PTM 515Z is given for reference only. Please refer to the applicable documents for deta i le d in f o rm atio n.
Note that the data format is little endian. This means tha t for multi-byte structures (such as 2 byte, 4 byte or 8 byte fields) the least sig n if i cant byte (LSB) is transmitted first.
The IEEE 802.15.4 frame structure consists of the following four 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 conta i ns t he fo llowing fields:
o Preamble
Pre-defined sequence (4 byte, value 0x00000000) used to adjust the receiver to the tra nsmission of the se nder
o Start of frame
Pre-defined symbol (1 byte, value 0xA7) identifying the start of the actual data frame
o 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 conta i ns t he fo llowing fields:
o Frame contr o l field
2 bytes to identify frame type, protocol version, addressing and security mode
o Sequence number
1 byte sequential number to identify the order of transmitted frames
o Address
PAN ID and address of source (if present) and destination of the telegram EnOcean PTM 535Z and PTM 215ZE do not use source address and source PAN ID (the EnO cean ID is part of the payload).
MAC Payload
The MAC Payload field contains telegram control, device ID, telegram data and tele­gram secur ity (if present) fields. The MAC Payload field structure depends on telegram type (data or commissioning) and security mode (secure or standard transmission).
Page 31
USER MANUAL
TCM 515Z – 2.4 GHZ IEEE 802.15.4 Transceiver
© 2017 EnOcean | www.enocean.c om F-710-017, V1.0 TCM 515Z User Manual | v1.6 | September 2017 | Page 31/46
MAC Trailer
The MAC Trailer contains the Frame Check Sum (FCS) field used to verify the integ­rity of t he telegram data.
Figure 16 below summarizes the IEEE 802.15.4 frame structure.
Figure 16: I EEE 802.15.4 frame structure
The content of these fields is described in more detail below.
A.2 PHY Header
The IEEE 802.15.4 PHY header consists of the following fields:
Preamble Start of Frame Lengt h of Frame fields
The content of the Preamble and Start of Frame fields is fixed for all telegram types sup­ported by EnOcean devices as follows:
Preambl e = 0x 00000000 Start of Frame = 0xA7
A.2.1 Length of Frame values used by PTM 215ZE and PTM 535Z
Below are reference values for the Length of Frame field for different type of telegrams used by PTM 215ZE and PTM 535Z:
Secure com missioning te legram (Default for PTM 215ZE and P TM 535Z)
Length of Frame = 42 bytes (0x 2A)
Secure data telegram (Default for PTM 215Z E and PTM 535Z)
Length of Frame = 24 bytes (0x 18)
Standa rd c o mmissioning telegra m (O ptiona l f ea t u re fo r PTM 535Z on ly )
Length of Frame = 17 bytes (0x 11)
PTM switch: Standard data telegram (Optional feature for PTM 535Z only)
Length of Frame = 15 bytes (0x0F)
Page 32
USER MANUAL
TCM 515Z – 2.4 GHZ IEEE 802.15.4 Transceiver
© 2017 EnOcean | www.enocean.c om F-710-017, V1.0 TCM 515Z User Manual | v1.6 | September 2017 | Page 32/46
A.3 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 PTM 215ZE and PTM 535Z 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 tele­grams
Address Field (4 byte in EnOcean implementation)
EnOcean devices use short Destination Address (16 Bit) together with the Desti na­tion PAN ID (16 Bit). Both are set to 0xFFFF to identify the telegrams as broadcast. Source address and Source PAN ID are not used by PTM 215ZE and PTM 535Z.
A.4 MAC Payload
The IEEE 802.15.4 MAC Payload depends on the telegram type. Appendi x B describes the MAC Payload structure used by EnOcean PTM 215ZE and PTM 535Z products.
A.5 MAC Trailer
The MAC Trailer only contains the Frame Ch eck 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 field of the PHY Header using the following polynomial: x
16
+ x12 + x5 + 1
TCM 515Z will automatically calculate and append the frame check sum to radio telegrams it is transmitting .
For received radio telegrams, TCM 515Z will calculate the frame check sum and verify data integrity based on that. If the checksum does not match, the received radio telegram will be discarded. Otherwise the received radio telegram will be forwarded to the external host via the ESP3 interf ace.
Page 33
USER MANUAL
TCM 515Z – 2.4 GHZ IEEE 802.15.4 Transceiver
© 2017 EnOcean | www.enocean.c om F-710-017, V1.0 TCM 515Z User Manual | v1.6 | September 2017 | Page 33/46
Appendix B MAC Payload Structure
The MAC Payload depends on the telegram type. This appendix gives examples of MAC pay­load structures used by EnOcean PTM 215Z E and PTM 535Z devices.
The following telegram types are used by these d evices:
Data telegram Commissioning telegram
The following security modes are supported by these devices:
Secure (authenticated) communication (using AES128 authentication)
Default mode on P TM 215ZE and PTM 535Z
Standa rd c o mmunication (w ithout AES128 authentication)
Optional mode for PTM 535Z, not available for PTM 215ZE
Standar d communic ation (with out AES12 8 se curity pr oces sing) i s suppor ted a s an opti onal feature for PTM 535Z in case shorter payloads are desired for certain applications without requirements for telegram authentication. This mode is not available for PTM 215ZE.
Page 34
USER MANUAL
TCM 515Z – 2.4 GHZ IEEE 802.15.4 Transceiver
© 2017 EnOcean | www.enocean.c om F-710-017, V1.0 TCM 515Z User Manual | v1.6 | September 2017 | Page 34/46
B.1 Secure data telegram format (with authentication)
Figure 17 below sh ows th e MAC Payload structure of a secure data telegram with authenti­cation used by PT M 215ZE or P TM 535Z.
Figure 17: MAC Payload st ructure for authenticated data telegrams
The following fields a re used:
Te le g ram Control (2 bytes)
The default security mode of PTM 215ZE and PTM 535Z uses a 4 byte payload signa­ture based on a device-unique key and a 4 byte Sequence Counter. The Telegram Cont rol field is s et to 0x308C for this mode.
Source ID (4 bytes)
The Source ID field contains a 4 byte ID uniquely identifying each PTM 215ZE or PTM 535Z device
Sequence Counter (4 bytes)
The Sequence Counter field contains an always incrementing counter. Security processing is based on the combination of the Command and Sequence Counter in or der to prevent replay attacks (sending the same telegram again)
Command (1 byte)
The Command field is a one byte field which identifies the state of the different in­puts of PTM 215ZE or PTM 535Z. For the encoding please see the applicable data manual.
Telegr a m S ignatu r e (4 byte)
The Telegram Signature field is used to validate the telegram authenticity. The tele­gram signature is calculated based on the telegram payload using AES128 (CBC mode).
In this mode, telegrams contain both a 4 byte sequence counter and a 4 byte signature which is calculated based on the telegrams payload (including the sequence counter) and the private key. The implementation is specified in RFC3610 and compatible with ZigBee systems.
EnOcean can provide upon request additional information on how to implement tele­gram valid a tion for PTM 215ZE or PTM 535Z data telegrams.
Page 35
USER MANUAL
TCM 515Z – 2.4 GHZ IEEE 802.15.4 Transceiver
© 2017 EnOcean | www.enocean.c om F-710-017, V1.0 TCM 515Z User Manual | v1.6 | September 2017 | Page 35/46
B.2 Secure commissioning telegram format (with authe ntication)
Figure 18 below shows the MAC payload s tructure of a secure commissioning telegram used by PTM 215ZE and PTM 535Z.
Figure 18: MAC Payload st ructure for secure commissioning telegrams
The following fields a re used for secure com missioning telegrams:
Telegram Control (1 byte)
The Telegram Control field is set to 0x0C to identify a standard telegram (secure communication will be established based on the commissioning telegram)
Source ID (4 bytes)
The Source ID field contains a 4 byte ID uniquely identifying each PTM 215ZE or PTM 535ZE device
Commissioning Command ( 1 byte)
The Command field is se t to 0xE0 by PTM 215ZE and PTM 535Z
Device Type (1 byte)
The Device Type field is set to 0x02 by PTM 215ZE and PTM 535Z
Device Options (2 bytes)
The Device Options field is set to 0xF281 by PTM 215ZE and P TM 535Z wh en opera t­ing in AES128 secure mode with authentication. The Device Options field is set to 0xF381 by PTM 535Z when ope rating in AES1 28 secure mode with authentication and additional payload encryption (optional fea­ture).
Device-unique Security Key (16 bytes)
PTM 215ZE and PTM 535Z implement a random, device-specific security key which is generated as part of the production flow. During commissioning, this key is transmitted in encrypted format. Contact EnOcean for details.
Security Key Validation (4 bytes)
In order to ensure correct reception, an additional 4 byte v alidation value is provid­ed. Conta ct EnOcea n for details.
Sequence Counter (4 bytes)
The Sequence Counter is an always incrementing counter which is used as part of the security processing to avoid replay attacks (sending the same telegram again).
Receiving devices shall only accept data telegrams with sequence counter values
higher than that of the last received telegram; therefore the current value needs to be communic a ted during commissioning.
Page 36
USER MANUAL
TCM 515Z – 2.4 GHZ IEEE 802.15.4 Transceiver
© 2017 EnOcean | www.enocean.c om F-710-017, V1.0 TCM 515Z User Manual | v1.6 | September 2017 | Page 36/46
B.3 Standard data telegram format (without authentication)
Figur e 19 below s hows the MAC Payload structure of a standard data telegram. This tele­gram type is an optional feature of PTM 535Z.
Figure 19: MAC Payload structure for standard data telegrams
The following fiel ds are used for Standard Data Telegrams:
Te le g ram Control (1 byte)
The Tele gram Control field is set to 0x0C by PTM 535Z to identify a standard data telegram
Source ID (4 bytes)
The Source ID field c o n ta i ns a 4 byte ID uniquely identifying each PTM 535Z device
Command (1 byte)
The Command field is a one byte field which identifies the state of the PTM 215ZE button contacts or PTM 535Z input signals. For the encoding please refer to the ap­plicable datasheet.
Page 37
USER MANUAL
TCM 515Z – 2.4 GHZ IEEE 802.15.4 Transceiver
© 2017 EnOcean | www.enocean.c om F-710-017, V1.0 TCM 515Z User Manual | v1.6 | September 2017 | Page 37/46
B.4 Standard commissioning telegram (without aut hentication)
Figure 20 below shows the MA C payload str ucture of a standard commissioning telegram used by PTM 535Z.
Figure 20: MAC Payload structure for standard commissi oning telegrams
The following fields a re used for standar d com mis sioning telegrams:
Telegram Control (1 byte)
The Telegram Control field is set to 0x0C to identify a standard telegram (secure communication will be established based on the commissioning telegram)
Source ID (4 bytes)
The Source ID field c o n ta i ns a 4 byte ID uniquely identifying each PTM 535Z device
Commissioning Command (1 byte)
The Commissioning Command field is se t to 0xE0 by PTM 535Z
Device Type (1 byte)
The Device Type field is set to 0x02 by PTM 535Z
Device Options (1 byte)
The Devic e Options field is set to 0x01 by PTM 535Z
Page 38
USER MANUAL
TCM 515Z – 2.4 GHZ IEEE 802.15.4 Transceiver
© 2017 EnOcean | www.enocean.c om F-710-017, V1.0 TCM 515Z User Manual | v1.6 | September 2017 | Page 38/46
Appendix C ESP3 Interface Format
C.1 Packet Type 0x10: IEEE 802.15.4 Raw Packet
In receive mode, TCM 515Z for w ards the content of received IEEE 802.15.4 ra dio teleg r ams (which pass frame check sum validat ion) unmodified to the external host vi a the ESP3 in­terface.
The forwarded frame starts with the Length field of the IEEE 802.15.4 PHY Header, con ti n­ues with the MAC Header and ends with the last Byte of the MAC Payload. The frame che ck sum (MAC Trailer) will not be forwarded to the host.
In tr ansmit mode, TCM 51 5Z receives from the external host the precomputed message payload starting with the Length field of the IEEE 802.15.4 PHY Header, continuing with the MAC Header and ending with the last Byte of the MAC Payload.
TCM 515Z then calculates the frame check sum (MAC Trailer) based on the received pay­load and appends it to the message. The full frame (including the Preamble and Start of Frame fields) will then be transmitted as IEEE 802.15.4 radio telegram (TX mode).
C.1.1 ESP3 packet structure for IEEE 802.15.4 Raw Packets
The MAC frame is embedded as 802.15.4 payload into the ESP3 packet as shown in Figure 21 below.
Figure 21: ESP3 packet structure for IEEE 802.15. 4 Raw Packet s
CRC8D
Header
CRC8H
Optional Data
Sync Byte
802.15.4 Payload
ESP3
Packet
Data Payload
Page 39
USER MANUAL
TCM 515Z – 2.4 GHZ IEEE 802.15.4 Transceiver
© 2017 EnOcean | www.enocean.c om F-710-017, V1.0 TCM 515Z User Manual | v1.6 | September 2017 | Page 39/46
The detailed structure of the IEEE 802.15.4 Raw Packets is shown in Table 7 below. IEEE 802.15.4 Raw Packets are identified by Packet Type 0x10.
Group
Offset
Size
Field
Value hex
Description
-
0 1 Sync. byte
0x55
Header
1 2 Data Length
0xnnnn
Variab le length x of raw packet payload
3 1 Optional Length
0x01
1 field fixed
4 1 Packet Type
0x10
Packet Type 0x10: 802.15.4 Raw Packet
-
5 1 CRC8H
0xnn
Data 6 x Raw data
... ...
802.15.4 Raw Packet payload
Optional
Data
6+x 1 RSSI 0xnn
Send case: FF
Receive case: best RSSI value of all received
sub teleg rams (value decimal without minus)
- 7+x 1 CRC8D 0xnn
CRC8 Data byte;
Calculated checksum for whole byte groups:
DATA and OPTIONAL_DATA
Table 7 – Packet structure for IEEE 802.15.4 Raw Packets
C.1.2 RESPONSE for IEEE 802.15.4 Raw Packets
When receiving a telegram, no RESPONSE has to be sent from the external host to the gatewa y to ackno w l e d g e r ec e ption of t he telegr a m v ia ESP3 interface.
When transmitting a tel egram, the gateway will send a RESPOND message to the external host via ESP3 interface to indicate the acceptance of the telegram for transmission. The following return codes are applicable for such a RESPONSE message:
00 RET_OK 02 RET_NOT_SUPPORTED 03 RET_WRONG_PARAM
The structure of the gateway RESPONSE message to the request for transmission of an IEEE 802.15.4 Raw Packet is shown in Ta ble 8 below. TCM 515Z will transmit a dedicated message to a connected host if transmission of an accepted telegram subsequently fails.
Group
Offset
Size
Field
Value hex
Description
- 0 1
Sync. byte
0x55
Header
1
2
Data Length
0x0004
1 byt e
3
1
Optional Length
0x00
0 byt e
4
1
Packet Type
0x02
Packet Type 0x02: RESPONSE
- 5 1
CRC8H
0xnn
Data
6
1
Return Co d e
0xnn
00 / 02 / 03
- 7 1
CRC8D
0xnn
Table 8 - RESPONSE frame structure to IE EE 802.15.4 Ra w Packet transmission
Page 40
USER MANUAL
TCM 515Z – 2.4 GHZ IEEE 802.15.4 Transceiver
© 2017 EnOcean | www.enocean.c om F-710-017, V1.0 TCM 515Z User Manual | v1.6 | September 2017 | Page 40/46
C.1.3 Failure Indication for IEEE 802.15.4 R aw Packet
TCM 515Z will accept and immediately acknowledge via ESP3 correctly formatted telegrams for radio transmission as described above.
Should transmission subsequently fail due to channel non-availability then this will be sub­sequently indicated to the host using an ESP3 Event (Packet Type 0x04) with Event Code 07: CO_TRANSMIT_FAILED.
The structure of ESP3 Event messages is shown in Figure 22 below.
Figure 22: ESP3 packet structure for Events
The structure of the CO_TRANSMIT_FAILED Event is shown in Table 9 below.
Group
Offset
Size
Field
Value hex
Description
- 0 1
Sync. Byte
0x55
Header
1
2
Data Length
0x0002
2 bytes
3
1
Optional Length
0x00
0 byte
4
1
Packet Ty pe
0x04
EVENT = 4
- 5 1
CRC8H
0xnn
Data
6
1
Event Code
0x07
CO_TRANSMIT_FAILED = 7
7
1
Event Cause
0xnn
00 = CSMA fai led, channel was never free
01
= No Acknowledge received, telegram was
transmitted, but no ack re ceiv ed.
02…255 = reserve d
- 8 1
CRC8D
0xnn
Table 9 – Structure of Event Code 07: CO_TRANSMIT_FAILED
CRC8D
Header CRC8H
Sync Byte
Optional Data = 0
Data
Event Code
Event Data
(optional)
Page 41
USER MANUAL
TCM 515Z – 2.4 GHZ IEEE 802.15.4 Transceiver
© 2017 EnOcean | www.enocean.c om F-710-017, V1.0 TCM 515Z User Manual | v1.6 | September 2017 | Page 41/46
C.2 Packet Type 0x11: IEEE 802.15.4 C OMMAND
The packet type IEEE 802.15.4 COMMAND is used to set and read parameters of TCM 515Z.
C.2.1 Packet structure for IEEE 802.15.4 COMMAND
The packet structure for IEEE 802.15.4 COMMAND is shown in Figure 23 below.
Figure 23 - Packet structure for IEE E 802.15.4 COMMAND
The structure of supported commands and expected responses are described in detail in the following chapters.
C.2.2 List of supported commands
Table 10 b el ow li sts the cur rentl y su p port ed comm an ds .
Code
Command Name
Description
01
SET_CHANNEL
Sets the radio chan nel used by th e gateway
02
GET_CHANNEL
Reads the radio channel used by the gateway
Table 10 - List of supported commands
CRC8D
Header
CRC8H
Optional Data
Sync Byte
Data
Command Code
Command Data
Page 42
USER MANUAL
TCM 515Z – 2.4 GHZ IEEE 802.15.4 Transceiver
© 2017 EnOcean | www.enocean.c om F-710-017, V1.0 TCM 515Z User Manual | v1.6 | September 2017 | Page 42/46
C.2.3 SET_CHANNEL Command
The SET_CHANNEL command sets the radio channel used by TCM 515Z. Please refer to chapter 2.3 for details about the supported radio channels.
The command stru ct ure of the SET_CHAN N EL comma nd is shown in Table 11 below.
Group
Offset
Size
Field
Value hex
Description
- 0 1
Sync. byte
0x55
Header
1
2
Data Length
0x0002
2 byt es
3
1
Optional Length
0x00
0 byt e
4
1
Packet Type
0x11
Packet Type 0x11: IE E E 80 2. 15.4 COMMAN D
- 5 1
CRC8H
0xnn
Data
6
1
COMMAND Code
0x01
COMMAND 0x01: SET_CHANNEL
7
1
Channel
11-26
IEEE 802.15.4 radio channel
- 8 1
CRC8D
0xnn
Table 11 - Command Structure for the SET_CHANNEL command
C.2.4 RESPONSE for SET_CHANNEL Command
The expected RESPONSE code for a SET_CHANNEL command is:
00: RET_OK
The frame structure for a RESPONSE to the SET_CHAN NEL command is shown in Table 1 2 below.
Group
Offset
Size
Field
Value hex
Description
- 0 1
Sync. byte
0x55
Header
1
2
Data Length
0x0001
1 byt e
3
1
Optional Length
0x00
0 byt e
4
1
Packet Type
0x02
Packet Type 0x02: RESPONSE
- 5 1
CRC8H
0xnn
Data
6
1
Return Co d e
0xnn
00 - 7
1
CRC8D
0xnn
Table 12 - RESPONSE F rame Structure for SET_CHANNEL command
Page 43
USER MANUAL
TCM 515Z – 2.4 GHZ IEEE 802.15.4 Transceiver
© 2017 EnOcean | www.enocean.c om F-710-017, V1.0 TCM 515Z User Manual | v1.6 | September 2017 | Page 43/46
C.2.5 GET_CHANNEL Command
The GET_CHANNEL command req uests inf ormation abou t the radio channel currently used by TCM 515Z. The com mand structure of t he GE T _C H AN N EL command is shown in Table 13 below.
Group
Offset
Size
Field
Value hex
Description
- 0 1
Sync. byte
0x55
Header
1
2
Data Length
0x0001
1 byt e
3
1
Optional Length
0x00
0 byt e
4
1
Packet Type
0x11
Packet Type 0x11: IEEE 802.15.4 COMMAND
- 5 1
CRC8H
0xnn
Data
6
1
COMMAND Code
0x02
COMMAN D 0x02: GET_C HAN N EL
- 7 1
CRC8D
0xnn
Table 13 - Command st ructure of the GET_CHANNEL c ommand
C.2.6 RESPONSE for GET_CHANNEL Command
The expected RESPONSE code for a GET_CHANNEL command i ssu ed to TCM 51 5Z is:
00: RET_OK
The currently used radio channel is then encoded in the subsequent byte. Th e frame struc­ture for a RESPONSE to the GET_CHANNEL command is shown in Table 14 below.
Group
Offset
Size
Field
Value hex
Description
- 0 1
Sync. byte
0x55
Header
1
2
Data Length
0x0002
2 bytes
3
1
Optional Length
0x00
0 byt e
4
1
Packet Type
0x02
COMMAN D 0x02: GET_C HAN N EL
- 5 1
CRC8H
0xnn
Data
6
1
Return Co d e
0
OK 7 1
Channel
11..26
Used Channel
- 8 1
CRC8D
0xnn
Table 14 - RESPONSE frame structure for GET_CHANNEL command
Page 44
USER MANUAL
TCM 515Z – 2.4 GHZ IEEE 802.15.4 Transceiver
© 2017 EnOcean | www.enocean.c om F-710-017, V1.0 TCM 515Z User Manual | v1.6 | September 2017 | Page 44/46
C.3 Packet Type Common Command
C.3.1 Command Code 0x24: CO_SET_BAUDRATE
The command CO_SET_BAUDRATE modifies the baud rate of the ESP3 interface. The standard baud rate defined by the ESP3 interface is 57600 Baud. TCM 515Z supports faster baud rates as listed in Table 15 below.
Group
Offset
Size
Field
Value hex
Description
- 0 1
Sync. byte
0x55
Header
1
2
Data Length
0x0002
2 bytes
3
1
Optional Length
0x00
0 byt e
4
1
Packet Type
0x05
COMMON_COMMAND = 0x05
- 5 1
CRC8H
0xnn
Data
6
1
COMMAND Code
0x24
CO_SET_BAUDRATE = 0x24
7
1
BAUDRATE
0xnn
0x00 = 57600 BAUD
0x01 = 115200 BAUD 0x02 = 230400 BAUD
0x03 = 460800 BAUD
- 8 1
CRC8D
0xnn
Table 15 - Command st ructure of the CO_SET_BAUDRATE command Caution: Before using the CO_SET_BAUDRATE command, make sure that the host con-
nected via the ESP3 interface supports the intended baud rate!
C.3.2 RESPONSE for CO_SET_BAUDRATE Command
Possible RESPONSE codes to a CO_SET_CHANNEL command are:
00: RET_OK 02: RET_NOT_SUPPORTED
The frame structure for a RESPONSE to the CO_SET_CHANNEL command is shown in Table 16 below.
Group
Offset
Size
Field
Value hex
Description
- 0 1
Sync. byte
0x55
Header
1
2
Data Length
0x0001
Data = 1 byte
3
1
Optional Length
0x00
Optional Data = 0 byte
4
1
Packet Type
0x02
RESPONSE = 2
- 5 1
CRC8H
0xnn
Data
6
1
Return Co d e
0x00
RET_OK
- 7 1
CRC8D
0xnn
Table 16 - RESPONSE frame structure for CO_SET_BAUDRATE command
Page 45
USER MANUAL
TCM 515Z – 2.4 GHZ IEEE 802.15.4 Transceiver
© 2017 EnOcean | www.enocean.c om F-710-017, V1.0 TCM 515Z User Manual | v1.6 | September 2017 | Page 45/46
C.3.3 Command Code 0x25: CO_GET_FREQUENCY_INFO
The command CO_GET_FREQUENCY_INFO reports the radio frequency and the communica­tion protocol used by the device. The structure of the command is listed in Table 17 below.
Group
Offset
Size
Field
Value hex
Description
- 0 1
Sync. Byte
0x55
Header
1
2
Data Length
0x0001
1 bytes
3
1
Optional Length
0x00
0 byte
4
1
Packet Ty pe
0x05
COMMON_COMMAND = 5
- 5 1
CRC8H
0xnn
Data
6
1
COMMAND Cod e
0x25
CO_GET_FREQUENCY_INFO = 37
- 7 1
CRC8D
0xnn
Table 17 - Command st ructure of the CO_GET_FREQUENCY_INFO command
C.3.4 RESPONSE for CO_GET_FREQUENCY_INFO Command
Possible RESPONSE codes to a CO_GET_FREQUENCY_INFO command are:
00: RET_OK 02: RET_NOT_SUPPORTED
The frame structure for a RESPONSE to the CO_SET_CHANNEL command on devices that support this command is shown in Table 18 below.
Group
Offset
Size
Field
Value hex
Description
- 0 1
Sync. Byte
0x55
Header
1
2
Data Length
0x0003
3 bytes
3
1
Optional Length
0x00
0 byte
4
1
Packet Ty pe
0x02
RESPONSE = 2
- 5 1
CRC8H
0xnn
Data
6
1
Return Code
0x00
RET_OK = 0
7
1
Frequency
0xnn
0x00 315Mhz
0x01 868.3Mhz 0x02 902.875Mhz 0x03 925 Mhz 0x04 928 Mhz
0x20 2.4 Ghz
8
1
Protocol
0xnn
0x00 ERP1
0x01 ERP2 0x10 802.15.4
0x20 Bluetooth
0x30 Long Range
- 9 1
CRC8D
0xnn
Table 18 - RESPONSE frame structure for CO_GET_FREQUENCY_INFO command
Page 46
USER MANUAL
TCM 515Z – 2.4 GHZ IEEE 802.15.4 Transceiver
© 2017 EnOcean | www.enocean.c om F-710-017, V1.0 TCM 515Z User Manual | v1.6 | September 2017 | Page 46/46
C.3.5 Command Code 37: CO_GET_STEPCODE
The command CO_GET_STEPCODE reports the device revision. The Stepcode is expressed as combination as major revision (DA, DB, DC, …) and minor revision (01, 02, 03, …). The structure of the command is listed in Table 19 below.
Group
Offset
Size
Field
Value hex
Description
- 0 1
Sync. Byte
0x55
Header
1
2
Data Length
0x0001
1 bytes
3
1
Optional Length
0x00
0 byte
4
1
Packet Ty pe
0x05
COMMON_COMMAND = 5
- 5 1
CRC8H
0xnn
Data
6
1
COMMAND Cod e
0x27
CO_GET_STEPCODE = 39
- 7 1
CRC8D
0xnn
Table 19 - Command st ructure of the CO_GET_STEPCODE command
C.3.6 RESPONSE for CO_GET_STEPCODE Command
Possible RESPONSE codes to a CO_GET_STEPCODE command are:
00: RET_OK 02: RET_NOT_SUPPORTED
The frame structure for a RESPONSE to the CO_GET_STEPCODE command on devices that support this command is shown in Table 20 below.
Group
Offset
Size
Field
Value hex
Description
- 0 1
Sync. Byte
0x55
Header
1
2
Data Length
0x00023
3 bytes
3
1
Optional Length
0x00
0 byte
4
1
Packet Ty pe
0x02
RESPONSE = 2
- 5 1
CRC8H
0xnn
Data
6
1
Return Code
0x00
RET_OK = 0
7
1
Major Revision
0xnn
e.g. 0xDA, 0xDB …
8
1
Minor Revision
0xnn
e.g. 0x01, 0x02 …
- 9 1
CRC8D
0xnn
Table 20 - RESPONSE frame structure for CO_GET_STEPCODE command
Loading...