Siemens SIMATIC RTLS4084T User manual

SIMATIC RTLS4084T
SIMATIC RTLS
Localization systems
SIMATIC RTLS4084T
Operating Instructions
04/2021
C79000
-G8976-C626-02
Introduction
1
Device description
2
Programming interface
3
Installation & operation
4
Technical specifications
5
Approvals
6

Siemens AG
Digital Industries
Postfach 48 48
90026 NÜRNBERG
GERMANY
C79000-G8976-C626-02
Ⓟ
04/2021 Subject to change
Copyright © Siemens AG 2021.
All rights reserved
Legal information
Warning notice system
This manual contains notices you have to observe in order to ensure your personal safety, as well as to prevent
damage to property. The notices referring to your personal safety are highlighted in the manual by a safety alert
symbol, notices referring only to property damage have no safety alert symbol. These notices shown below are
graded according to the degree of danger.
DANGER
indicates that death or severe personal injury will result if proper precautions are not taken.
WARNING
indicates that death or severe personal injury may result if proper precautions are not taken.
CAUTION
indicates that minor personal injury can result if proper precautions are not taken.
NOTICE
indicates that property damage can result if proper precautions are not taken.
If more than one degree of danger is present, the warning notice representing the highest degree of danger will
be used. A notice warning of injury to persons with a safety alert symbol may also include a warning relating to
property damage.
Qualified Personnel
The product/system described in this documentation may be operated only by personnel qualified for the specific
task in accordance with the relevant documentation, in particular its warning notices and safety instructions.
Qualified personnel are those who, based on their training and experience, are capable of identifying risks and
avoiding potential hazards when working with these products/systems.
Proper use of Siemens products
Note the following:
WARNING
Siemens products may only be used for the applications described in the catalog and in the relevant technical
documentation. If products and components from other manufacturers are used, these must be recommended
or approved by Siemens. Proper transport, storage, installation, assembly, commissioning, operation and
maintenance are required to ensure that the products operate safely and without any problems. The permissible
ambient conditions must be complied with. The information in the relevant documentation must be observed.
Trademarks
All names identified by ® are registered trademarks of Siemens AG. The remaining trademarks in this publication
may be trademarks whose use by third parties for their own purposes could violate the rights of the owner.
Disclaimer of Liability
We have reviewed the contents of this publication to ensure consistency with the hardware and software
described. Since variance cannot be precluded entirely, we cannot guarantee full consistency. However, the
information in this publication is reviewed regularly and any necessary corrections are included in subsequent
editions.

SIMATIC RTLS4084T
Operating Instructions, 04/2021, C79000-G8976-C626-02 3
Table of contents
1 Introduction ........................................................................................................................................... 5
2 Device description ................................................................................................................................. 9
2.1 Characteristics ..................................................................................................................... 9
2.2 Order data RTLS4084T ....................................................................................................... 10
2.3 LED status indicator, display & function key........................................................................ 10
2.4 Dimension drawing............................................................................................................ 11
3 Programming interface........................................................................................................................ 13
3.1 Overview........................................................................................................................... 13
3.2 Communication via the programming interface.................................................................. 14
3.3 RPC calls ............................................................................................................................ 16
3.4 Event messages ................................................................................................................. 18
3.5 Code examples .................................................................................................................. 20
3.6 Additional information....................................................................................................... 23
4 Installation & operation....................................................................................................................... 25
4.1 Notes on installation.......................................................................................................... 25
4.2 Replacing the battery pack ................................................................................................. 27
4.3 Cleaning and maintenance................................................................................................. 27
5 Technical specifications....................................................................................................................... 29
5.1 Technical specifications of the RTLS4084T.......................................................................... 29
5.2 Technical specifications of the battery pack........................................................................ 31
6 Approvals............................................................................................................................................. 33

Table of contents
SIMATIC RTLS4084T
4Operating Instructions, 04/2021, C79000-G8976-C626-02

SIMATIC RTLS4084T
Operating Instructions, 04/2021, C79000-G8976-C626-02 5
Introduction
1
Purpose of the Operating Instructions
These operating instructions support you when installing and connecting up the SIMATIC
RTLS4084T device.
The configuration and the integration of the devices in a network are not described in these
operating instructions.
Validity of the Operating Instructions
These operating instructions apply to the following device:
•RTLS4084T (CE; article number: 6GT2700-7DC05-0AA0)
•RTLS4084T (FCC; article number: 6GT2700-7DC15-0AA0)
Further documentation
The system manual "Commissioning SIMATIC RTLS" provides information on other SIMATIC
RTLS products that you can operate together with the devices in this product line in an
Industrial Ethernet network.
You can find the system manual at the following link:
(https://support.industry.siemens.com/cs/us/en/ps/25277)
Trademarks
The following and possibly other names not identified by the registered trademark sign ®are
registered trademarks of Siemens AG:
SIMATIC RTLS

Introduction
SIMATIC RTLS4084T
6Operating Instructions, 04/2021, C79000-G8976-C626-02
Industry Online Support
In addition to the product documentation, the comprehensive online information platform of
Siemens Industry Online Support offers support at the following Internet address:
(https://support.industry.siemens.com/cs/start?lc=en-US)
Apart from news, there you will also find:
•Project information: Manuals, FAQs, downloads, application examples etc.
•Contacts, Technical Forum
•The option submitting a support query: (https://support.industry.siemens.com/My/us/en/)
•Our service offer:
Right across our products and systems, we provide numerous services that support you in
every phase of the life of your machine or system - from planning and implementation to
commissioning, through to maintenance and modernization.
You will find contact information on the Internet at the following address:
(https://www.automation.siemens.com/aspa_app/?ci=yes&lang=en)
SITRAIN - Training for Industry
The training offer includes more than 300 courses on basic topics, extended knowledge and
special knowledge as well as advanced training for individual sectors - available at more than
130 locations. Courses can also be organized individually and held locally at your location.
You will find detailed information on the training curriculum and how to contact our
customer consultants at the following Internet address:
(https://new.siemens.com/global/en/products/services/industry/sitrain/personal.html)
Security information
Siemens provides products and solutions with industrial security functions that support the
secure operation of plants, systems, machines, and networks.
In order to protect plants, systems, machines and networks against cyber threats, it is
necessary to implement – and continuously maintain – a holistic, state-of-the-art industrial
security concept. Siemens’ products and solutions form one element of such a concept.
Customers are responsible for preventing unauthorized access to their plants, systems,
machines and networks. These systems, machines and components should only be
connected to the enterprise network or the Internet if and only to the extent necessary and
with appropriate security measures (firewalls and/or network segmentation) in place.
You can find more information on protective measures in the area of industrial security by
visiting: (http://www.siemens.com/industrialsecurity).
Siemens’ products and solutions undergo continuous development to make them more
secure. Siemens strongly recommends performing product updates as soon as they are
available and using only the latest product versions. Use of product versions that are no
longer supported, and failure to apply latest updates may increase customer’s exposure to
cyber threats.
To stay informed about product updates, subscribe to the Siemens Industrial Security RSS
Feed under (http://www.siemens.com/industrialsecurity).

Introduction
SIMATIC RTLS4084T
Operating Instructions, 04/2021, C79000-G8976-C626-02 7
Security recommendations
General
Note the following security recommendations to prevent unauthorized access:
•Keep the firmware up to date. Check regularly for security updates for the device. You can
find information on this at the Industrial Security
(https://new.siemens.com/global/en/company/topic-areas/future-of-
manufacturing/industrial-security.html) website.
•Inform yourself regularly about security recommendations published by Siemens
ProductCERT (https://new.siemens.com/global/en/products/services/cert.html).
•Evaluate your plant as a whole in terms of security. Use a cell protection concept with
suitable products.
•This product requires an additional security concept to prevent unauthorized access.
•Transponder and infrastructure can be configured for radio channels according to IEEE
802.15.4-2015. You will find details in the section
"Technical specifications".
•Ensure that the radio frequencies are not used for other purposes and are not affected by
other interfering signals. This should be ensured within the operating range of the
localization system.
•Interference in the frequency band used can impair the system and, in extreme cases, lead
to localization failure.
Physical access
•Restrict physical access to the device to qualified personnel.
•Disable unused physical interfaces of the device. Unused interfaces could be used to gain
access to the operating site.
Recycling and disposal
The products are low in harmful substances, can be recycled and meet the requirements of
the Directive 2012/19/EU for disposal of waste electrical and electronic equipment (WEEE).
Do not dispose of the products at public disposal sites.
For environmentally compliant recycling and disposal of your electronic waste, please contact
a company certified for the disposal of electronic waste or your Siemens representative.
Note the different national regulations.

Introduction
SIMATIC RTLS4084T
8Operating Instructions, 04/2021, C79000-G8976-C626-02

SIMATIC RTLS4084T
Operating Instructions, 04/2021, C79000-G8976-C626-02 9
Device description
2
2.1 Characteristics
SIMATIC RTLS4084T
Characteristics
Design
①L1 and L2 status indicators (LEDs)
②F1 and F2 function keys
③Display
General
The transponder is a mobile device for localiza-
tion in the RTLS localization system. It sends
position data to gateways which transmit the
data to the Locating Manager server.
Information can be transmitted to the tran-
sponder via a programming interface on the
Locating Manager and shown on the display.
Area of application
The device is designed for an operating temper-
ature of 0 ... +50 °C.
Localization mode without display activity is
possible in environments down to -20 °C.
The device is protected from water spray on all
sides (IP54).

Device description
2.2 Order data RTLS4084T
SIMATIC RTLS4084T
10 Operating Instructions, 04/2021, C79000-G8976-C626-02
2.2 Order data RTLS4084T
Table 2- 1 Order data RTLS4084T
Article number
SIMATIC RTLS4084T
Without battery pack
CE
6GT2700-7DC05
SIMATIC RTLS4084T
including 1 x battery pack lithium batteries
CE
6GT2700-7DC05-0AA0
SIMATIC RTLS4084T
Without battery pack
FCC
6GT2700-7DC15
SIMATIC RTLS4084T
including 1 x battery pack lithium batteries
FCC
6GT2700-7DC15-0AA0
Table 2- 2 Ordering data for accessories
Article number
1 x battery pack lithium batteries for SIMATIC RTLS4084T
6GT2790-0EE00
2.3 LED status indicator, display & function key
The operating states of the transponder are indicated by the LED. The LED can be green and
red and have the states off , on , flashes .
Display
Meaning
LED L1 (red/green)
Briefly flashes green once when the F1 or F2 function button is pressed and the
battery voltage is sufficient.
Briefly flashes red once when the F1 of F2 function button is pressed when the
battery voltage is low.
LED L2 (red/green)
No fixed functionality.
Display
5 background images can be saved
20 text boxes with 58 characters per box
20 font types/sizes incl. bar codes
F1 function key
If this function key is pressed, the message is forwarded to the program inter-
face.
When the F1 function button is pressed, the charge state of the battery pack is
evaluated and, depending on its voltage, the LED 1 briefly flashes green or red. In
the Locating Manager, you can configure a device parameter to define the
threshold value below which the battery voltage is defined as too low for opera-
tion, set the generation of a "low power" message and have the LED 1 flash red.
Refer to the notes in the section "Installation & operation (Page 25)".
F2 function key
If this function key is pressed, the message is forwarded to the program inter-
face.
When the F2 function button is pressed, the charge state of the battery pack is
evaluated and, depending on its voltage, the LED 1 briefly flashes green or red. In
the Locating Manager, you can configure a device parameter to define the
threshold value below which the battery voltage is defined as too low for opera-
tion, set the generation of a "low power" message and have the LED 1 flash red.
Refer to the notes in the section "Installation & operation (Page 25)".

Device description
2.4 Dimension drawing
SIMATIC RTLS4084T
Operating Instructions, 04/2021, C79000-G8976-C626-02 11
2.4 Dimension drawing
Figure 2-1 Dimension drawing SIMATIC RTLS4084T - All dimensions are given in millimeters

Device description
2.4 Dimension drawing
SIMATIC RTLS4084T
12 Operating Instructions, 04/2021, C79000-G8976-C626-02

SIMATIC RTLS4084T
Operating Instructions, 04/2021, C79000-G8976-C626-02 13
Programming interface
3
3.1 Overview
Functionality of the programming interface
The programming interface of the transponder is a functionality supported by the Locating
Manager. It enables external client applications to communicate with the transponder via the
Locating Manager Server. The transponder can be accessed via WAMP (Web Application
Messaging Protocol) independent of the operating system or the code language of the
external client.
Additional functions of the transponder
In addition to the basic function of its use as a localizable node, the transponder offers
additional functions such as "ePaper display" or "Control keys", which can be used by the
external client applications. The display content is managed via "Themes". A transponder
Theme contains a background graphic and various form fields to display text and barcode. A
form field is a text field on the display of the transponder with the following configurable
properties:
•Field type
–Text field
–1D barcode
•Size and position on the display
•Font and font size
Project-specific requirements for the configuration of the "Themes" as well as the download
of the configuration to the transponder can be performed during operation. Optionally, the
configuration of the "Themes" can be transferred from the manager to the transponder.

Programming interface
3.2 Communication via the programming interface
SIMATIC RTLS4084T
14 Operating Instructions, 04/2021, C79000-G8976-C626-02
Configuration options of the programming interface
The following properties can be configured for the transponder via the programming
interface:
•Request a list showing all configured transponders of a Locating Manager Server.
•Activation of a "Themes" for the transponder including transfer of the texts / barcodes to
be displayed
•Changing the contents of a form field of a transponder
•Query the current text or code and the current "Themes"
•Indication of the status of the "Control keys" used
3.2 Communication via the programming interface
General
The communication of the programming interface is done via a WAMP-Router that is a
component of the Locating Manager Server. Establishing a connection from an application to
the Locating Manager Server requires the implementation of a WAMP client on the part of
this application. There is no provision for client-specific parameterization. A connection can
be terminated at any time using the WAMP client application.
Properties of the coding
The coding via the programming interface has the following properties:
•The data to be transferred for the data transport is transferred in the "JSON" format
(JavaScript Object Notation).
•The text to be displayed is transmitted in "UTF-8" format (8-Bit UCS Transformation
Format).
•Line breaks in text fields are managed using the "\r" element

Programming interface
3.2 Communication via the programming interface
SIMATIC RTLS4084T
Operating Instructions, 04/2021, C79000-G8976-C626-02 15
Characteristics of the programming interface
Blue
Communication between programming interface and RTLS Locating Manager
Green
Communication between RTLS Locating Manager and RTLS408xT
Red
Communication between RTLS Locating Manager and RTLS408xT
All RPC calls (Remote Procedure Call) received by the programming interface are answered
immediately. This means that there is no need to wait for an acknowledgment of the RPC call
until the data transfer is completed. The completion of the data transmission is confirmed by
an event message provided for this purpose. The various event messages can be found in the
section "Event messages (Page 18)".
The positive acknowledgment of an RPC call does not guarantee or indicate successful
transmission and display of new display contents on the transponder. This can happen if, for
example, the transponder was switched off during this time or is not within radio range.

Programming interface
3.3 RPC calls
SIMATIC RTLS4084T
16 Operating Instructions, 04/2021, C79000-G8976-C626-02
Since the commands to be transmitted in the wireless network do not reach the transponder
or reach it incompletely, no event message is generated in this case.
If an RPC call sets a field form to a value that is already set, an event message is sent
immediately. This happens during or very shortly after the RPC call. Event messages are sent
when a situation is reached.
If a field content still to be transmitted is overwritten again before the previous value could
be sent to the transponder, only the value set last is transmitted to the transponder. In this
case, only the writing of the last value is acknowledged by an event message.
The transmission of background images, fonts and theme files is given higher priority and
temporarily interrupts the transmission of text content.
3.3 RPC calls
Parameters of the RPC calls
The following parameters can be used for RPC calls via the programming interface:
Parameter
Description
TransponderID
48-bit ID according to IEEE EUI-48
The network address in decimal notation contains the transponder ID:
•17:b4:1a:bb:cc:e2
•17:b4:10:00:00:07
•
17:b4:11:23:45:67
•180079842
•7
•
19088743
ThemeID
The number of the displayed theme
The value range depends on the type and version of the transponder.
FieldID
The number of the text field
The value range depends on the type and version of the transponder.
Text
Permitted characters: all printable ASCII characters and German umlauts
Result
Sends the return value
Return values for RPC calls
The following return values are possible for RPC calls via the programming interface:
Code
Description
0x0000
No error was detected.
0x0011
The "TransponderID" parameter is invalid.
0x0012
The "ThemeID" parameter is invalid.
0x0013
The "FieldID" parameter is invalid.
0x0101
The text length is invalid.
0x0102
The text contains invalid characters or the characters are not supported.

Programming interface
3.3 RPC calls
SIMATIC RTLS4084T
Operating Instructions, 04/2021, C79000-G8976-C626-02 17
Command "Get Version"
This command queries the protocol version. The default value is 1.
URI
"agilion.wls.epaper. get_version"
Parameter
None
Return value
Consists of:
Version of the protocol, type: UInt32
Command "Get Tags"
This command queries a list of all configured transponders in the Locating Manager Server.
URI
"agilion.wls.epaper.get_tags"
Parameter
None
Return value
Consists of:
Result, type: UInt32
Field with the following parameters:
TransponderID, type: UInt64
ProductID, type: UInt64
FirmwareVersion, type: String
Command "Set Display Theme"
This command selects and activates the "theme" visible on the display and the transfer of the
text and barcode to be displayed. Texts are set to "empty" if they are not transferred in this
call. If one text is invalid, the others are still set.
URI
"agilion.wls.epaper.set_display_theme"
Parameter
TransponderID, type: UInt64
ThemeID, type: UInt32
Field with the following parameters:
FieldID, type: UInt32
Text, type: String
Return value
Consists of:
Result, type: UInt32
Field with the following parameters:
RPCResult, type: UInt32
1 ... n FieldResults, type: UInt32

Programming interface
3.4 Event messages
SIMATIC RTLS4084T
18 Operating Instructions, 04/2021, C79000-G8976-C626-02
Command "Get Display Theme"
This command outputs the current "theme" and the current texts and codes for a single
transponder. Only completely transmitted texts are returned. If the current "ThemeID" is
unknown, it has the return value -1.
URI
"agilion.wls.epaper.get_display_theme"
Parameter
TransponderID, type: UInt64
Return value
Consists of:
Result, type: UInt32
ThemeID, type: UInt32
Field with the following parameters:
FieldID, type: UInt32
Text, type: String
3.4 Event messages
General
The event messages and their parameters are described below.
"Display Theme Changed" event message
This event message is sent after a "Theme" on the display has been changed. If the text
transmission has failed, the value "-1" is set in the "ThemeID" parameter, which invalidates
the parameter.
URI
"agilion.wls.epaper.display_theme_changed"
Parameter
Consists of:
TransponderID, type: UInt64
ThemeID, type: UInt32
"Display Text Changed" event message
This event message is sent after the contents of a form field on the display have been
changed. Text is the content of this form field. If the text is empty, a problem with setting the
text occurred.
URI
"agilion.wls.epaper.display_text_changed"
Parameter
Consists of:
TransponderID, type: UInt64
FieldID, type: UInt32
Text, type: String

Programming interface
3.4 Event messages
SIMATIC RTLS4084T
Operating Instructions, 04/2021, C79000-G8976-C626-02 19
"Button Pressed" event message
This event message is sent after the F1 function key has been pressed or released. If you want
to adapt the short/long press functionality, you need to change the parameter involved in the
configuration file, "RTLS_LM_DataExport.ini".
URI
"agilion.wls.epaper.button_pressed"
Parameter
Consists of:
TransponderID, type: UInt64
ButtonID, type: UInt32
ButtonDown, type: UInt32
The following happens when you briefly press the F1 function key:
Value
Description
0
Evaluated as not pressed
OnShortButtonPress = 0
•Function key briefly pressed > Event parameter: ButtonDown = 0
•Function key pressed long (> 2 seconds) > Event parameter: But-
tonDown = 1
•After a short or long press and subsequent heartbeat > Event parame-
ter: ButtonDown = 0
1
Considered pressed
OnShortButtonPress = 1
•Function key pressed short or long > Event parameter: ButtonDown = 1
•After a short or long press and subsequent heartbeat > Event parame-
ter: ButtonDown = 0
The default value is 1 in the configuration file "RTLS_LM_DataExport.ini".

Programming interface
3.5 Code examples
SIMATIC RTLS4084T
20 Operating Instructions, 04/2021, C79000-G8976-C626-02
3.5 Code examples
Code example WAMP connection
{
"wamp": {
"url": "ws://127.0.0.1:12344/",
"realm": "agilion.wls",
"user": "Administrator",
"key": Contact Siemens Support for the current password.
}
}
Code example WAMP connection with RPC call
console.log("start")
var config = null
function changetheme(session, addr, themeid, param){
console.log("change zone for etag (zoneid,etag)",themeid,addr)
var epapercmd = [parseInt(addr,10),parseInt(themeid,10),param]
if ( config.debug ) console.log("send epapercmd: ",epapercmd)
session.call("agilion.wls.epaper.set_display_theme",
epapercmd).then(
function (res) {
if ( config.debug ) console.log("epaperapi response:", res);
/*
Code Bedeutung
* 0x0000 No error
* 0x0011 TransponderID invalid
* 0x0012 ThemeID invalid
* 0x0013 FieldID invalid
* 0x0101 Text length invalid
* 0x0102 Text contains invalid characters or characters not
supported
*/
}