Siemens SIMATIC RTLS4083T User manual

SIMATIC RTLS4083T
SIMATIC RTLS
Localization systems
SIMATIC RTLS4083T
Operating Instructions
08/2021
C79000
-G8976-C646-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-C646-02
Ⓟ
09/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 RTLS4083T
Operating Instructions, 08/2021, C79000-G8976-C646-02 3
Table of contents
1 Introduction ........................................................................................................................................... 5
2 Device description ................................................................................................................................. 9
2.1 Characteristics ..................................................................................................................... 9
2.2 RTLS4083T order data.......................................................................................................... 9
2.3 LED status indicator, display & function key........................................................................ 10
2.4 Dimension drawing of RTLS4083T...................................................................................... 11
2.5 Dimension drawing of RTLS charging station...................................................................... 12
2.6 Dimension drawing of RTLS4083T mounting clip................................................................ 13
3 Programming interface........................................................................................................................ 15
3.1 Overview........................................................................................................................... 15
3.2 Communication via the programming interface.................................................................. 16
3.3 RPC calls ............................................................................................................................ 18
3.4 Event messages ................................................................................................................. 20
3.5 Code examples .................................................................................................................. 21
3.6 Additional information....................................................................................................... 25
4 Installation & operation....................................................................................................................... 27
4.1 Notes on installation.......................................................................................................... 27
4.2 Operation.......................................................................................................................... 28
4.3 Cleaning and maintenance................................................................................................. 28
4.4 Charging instructions......................................................................................................... 29
5 Technical specifications....................................................................................................................... 31
5.1 RTLS4083T technical specifications .................................................................................... 31
5.2 RTLS charging station technical specifications .................................................................... 32
5.3 Technical specifications of the mounting clip RTLS4083T.................................................... 33
6 Approvals............................................................................................................................................. 35

Table of contents
SIMATIC RTLS4083T
4Operating Instructions, 08/2021, C79000-G8976-C646-02

SIMATIC RTLS4083T
Operating Instructions, 08/2021, C79000-G8976-C646-02 5
Introduction
1
Purpose of the operating instructions
These operating instructions will assist you in mounting, connecting, and programming the
programming interface of the SIMATIC RTLS4083T 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:
•RTLS4083T (CE; article number: 6GT2700-5DC05)
•RTLS4083T (FCC; article number: 6GT2700-5DC15)
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 RTLS4083T
6Operating Instructions, 08/2021, C79000-G8976-C646-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)
RTLS Technology and Practice (ID-RTLS-TP)
Training and certification
After completing the RTLS certification training, you will be able to plan and implement small
and medium-sized RTLS projects and provide efficient and multifaceted support in large
projects. Your RTLS basics will be strengthened and, building upon them, you will receive
new tools of the trade in order to offer customers the optimal solution for them. The
complete project sequence is taken as a reference and important steps, resources and work
results for each phase are presented. Comprehensive practical exercises in connection with
troubleshooting techniques and a great deal of input from industrial projects allow you to
internalize a confident approach to working with different types of localization projects. With
the training documents, you also receive extensive reference material for your daily work.
Link: (https://www.sitrain-learning.siemens.com/EN/en/rw35251/Industrielle-Identifikation-
RTLS-Technologie-und-Praxis)

Introduction
SIMATIC RTLS4083T
Operating Instructions, 08/2021, C79000-G8976-C646-02 7
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: (https://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 (https://www.siemens.com/industrialsecurity).
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.

Introduction
SIMATIC RTLS4083T
8Operating Instructions, 08/2021, C79000-G8976-C646-02
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.

SIMATIC RTLS4083T
Operating Instructions, 08/2021, C79000-G8976-C646-02 9
Device description
2
2.1 Characteristics
SIMATIC RTLS4083T
Characteristics
Design
①Status indicator L1 (LED)
②Function key F1
③Display
General
The transponder is a mobile device for
localization 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
transponder via a programming interface on the
Locating Manager and shown on the display.
2.2 RTLS4083T order data
Table 2- 1 RTLS4083T order data
Article number
SIMATIC RTLS4083T
CE
6GT2700-5DC05
FCC
6GT2700-5DC15
Table 2- 2 Order data for accessories
Article number
SIMATIC RTLS charging station for 10 transponders
with power supply unit and power plug for region: EU
6GT2790-0DD02
SIMATIC RTLS charging station for 10 transponders
with power supply unit and power plug for region: USA
6GT2790-0DD03
Charging cradle without power supply unit for 10 transponders
6GT2790-0DD20
Power supply unit for charging cradle without power plug
6GT2790-0DD40
SIMATIC RTLS mounting clip for RTLS4083T (10 units)
6GT2790-0DE30
Power plug for region: EU
6ES7900-0AA00-0XA0
Power plug for region: USA
6ES7900-0DA00-0XA0

Device description
2.3 LED status indicator, display & function key
SIMATIC RTLS4083T
10 Operating Instructions, 08/2021, C79000-G8976-C646-02
2.3 LED status indicator, display & function key
The operating states of the transponder are indicated by the LEDs. The states can be off , on
and flashing .
Table 2- 3 LED status indicator
LED
Meaning
Briefly flashes green once when the F1 function button is pressed and the battery voltage is
sufficient.
Continuously flashes green when the device is fully charged and in the RTLS charging
station.
Lights up green when the device is charging and is in the RTLS charging station.
Briefly flashes red once when the F1 function button is pressed and the battery voltage is
low.
Continuously flashes red when the device is in the RTLS charging station and the battery is
defective.
Remove the transponder from the charging station immediately and do not recharge this
device. Contact customer service.
Lights up red if there is an error during charging.
Note
Observe the notes in sections "Operation (Page 28)" and "Charging instructions (Page 29)".
Table 2- 4 Display and function key
Display
Meaning
Display
5 background images can be saved
20 text fields with 58 characters each
20 fonts and font sizes, including bar codes
F1 function key
If this function key is pressed, the message is forwarded to the program
interface.
When the F1 function button is pressed, the charge state of the battery is
evaluated and, depending on its voltage, the LED 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
operation, a "low power" message is generated and the LED flashes red. Refer to
the notes in the section "Operation (Page 28)".

Device description
2.4 Dimension drawing of RTLS4083T
SIMATIC RTLS4083T
Operating Instructions, 08/2021, C79000-G8976-C646-02 11
2.4 Dimension drawing of RTLS4083T
Figure 2-1 Dimension drawing of SIMATIC RTLS4083T - All dimensions are given in millimeters

Device description
2.5 Dimension drawing of RTLS charging station
SIMATIC RTLS4083T
12 Operating Instructions, 08/2021, C79000-G8976-C646-02
2.5 Dimension drawing of RTLS charging station
Figure 2-2 Dimension drawing of SIMATIC RTLS charging station (not included with the product) - All
dimensions are given in millimeters

Device description
2.6 Dimension drawing of RTLS4083T mounting clip
SIMATIC RTLS4083T
Operating Instructions, 08/2021, C79000-G8976-C646-02 13
2.6 Dimension drawing of RTLS4083T mounting clip
Dimension drawing of SIMATIC RTLS mounting clip for RTLS4083T (not included with the
product) - All dimensions are given in millimeters

Device description
2.6 Dimension drawing of RTLS4083T mounting clip
SIMATIC RTLS4083T
14 Operating Instructions, 08/2021, C79000-G8976-C646-02

SIMATIC RTLS4083T
Operating Instructions, 08/2021, C79000-G8976-C646-02 15
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 RTLS4083T
16 Operating Instructions, 08/2021, C79000-G8976-C646-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 RTLS4083T
Operating Instructions, 08/2021, C79000-G8976-C646-02 17
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 20)".
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 RTLS4083T
18 Operating Instructions, 08/2021, C79000-G8976-C646-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 RTLS4083T
Operating Instructions, 08/2021, C79000-G8976-C646-02 19
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 RTLS4083T
20 Operating Instructions, 08/2021, C79000-G8976-C646-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