Siemens SIMATIC RTLS4083T User manual

SIMATIC RTLS4083T
SIMATIC RTLS
Localization systems
SIMATIC RTLS4083T
Operating Instructions
12/2019
C79000
-G8976-C527-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-C527-02
Ⓟ
12/2019 Subject to change
Copyright © Siemens AG 2019.
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, 12/2019, C79000-G8976-C527-02 3
Table of contents
1 Introduction............................................................................................................................................. 5
2 Device description................................................................................................................................... 9
2.1 Characteristics ..........................................................................................................................9
2.2 Order data RTLS4083T ............................................................................................................9
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 .....................................................................................................................19
3.5 Code examples .......................................................................................................................21
3.6 Additional information .............................................................................................................24
4 Installation & Operation......................................................................................................................... 25
4.1 Notes on installation................................................................................................................25
4.2 Operation ................................................................................................................................26
4.3 Cleaning and maintenance .....................................................................................................26
4.4 Charging instructions ..............................................................................................................27
5 Technical specifications ........................................................................................................................ 29
6 Approvals.............................................................................................................................................. 31

Table of contents
SIMATIC RTLS4083T
4Operating Instructions, 12/2019, C79000-G8976-C527-02

SIMATIC RTLS4083T
Operating Instructions, 12/2019, C79000-G8976-C527-02 5
Introduction
1
Purpose of the Operating Instructions
This manual 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
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:
See also
Siemens Industry Online Support (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, 12/2019, C79000-G8976-C527-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)

Introduction
SIMATIC RTLS4083T
Operating Instructions, 12/2019, C79000-G8976-C527-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 constitute one element of such a concept.
Customers are responsible for preventing unauthorized access to their plants, systems,
machines and networks. Such systems, machines and components should only be
connected to an enterprise network or the internet if and to the extent such a connection is
necessary and only when appropriate security measures (e.g. firewalls and/or network
segmentation) are in place.
For additional information on industrial security measures that may be implemented, please
visit: (https://new.siemens.com/global/en/company/topic-areas/future-of-
manufacturing/industrial-security.html)
Siemens’ products and solutions undergo continuous development to make them more
secure. Siemens strongly recommends that product updates are applied as soon as they are
available and that the latest product versions are used. Use of product versions that are no
longer supported, and failure to apply the latest updates may increase customers’ exposure
to cyber threats.
To stay informed about product updates, subscribe to the Siemens Industrial Security RSS
Feed under: (https://support.industry.siemens.com/cs/us/en/ps/15247/pm)
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 RTLS4083T
8Operating Instructions, 12/2019, C79000-G8976-C527-02

SIMATIC RTLS4083T
Operating Instructions, 12/2019, C79000-G8976-C527-02 9
Device description
2
2.1 Characteristics
SIMATIC RTLS4083T
Characteristics
Design
①
Status indicators (LED)
②F1 function key
③
display
General The transponder is a mobile device for localiza-
tion in the RTLS localing system. It sends data
to gateways to determine its position. The
gateways transmit the data to the Locat-
ing 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 tem-
perature of 0 ... +50 °C.
If you only need localization without change of
the display information, the lower temperature
limit can be lowered to -10 °C.
The device is protected from water spray on all
sides (IP54).
2.2 Order data RTLS4083T
Table 2- 1 Order data RTLS4083T
Article number
SIMATIC RTLS4083T
EU
6GT2700-5DC03
Mexico
6GT2700-5DC13
China (CMIIT)
6GT2700-5DC23

Device description
2.3 LED status indicator, display & function key
SIMATIC RTLS4083T
10 Operating Instructions, 12/2019, C79000-G8976-C527-02
Table 2- 2 Accessories order data (not included in scope of delivery)
Article number
Charging station for 10 transponders
with power plug for region: EU
6GT2790-0DD00
Charging station for 10 transponders
with power plug for region: USA
6GT2790-0DD01
Charging cradle without power supply for 10 transponders
6GT2790-0DD10
Power supply device for charging cradle without power plug
6GT2790-0DD40
2.3 LED status indicator, display & function key
The operating states of the gateways are indicated by the LEDs. The states can be off , on
and flashing .
Table 2- 3 LED status indicator
LED
Meaning
Flashes green briefly when the F1 function key has been pressed.
Flashes green when the device is fully charged and in the charging station.
Lights green when the device is charging and is in the charging station.
Flashes red when the device is in the 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
Refer to the information in the section "
Charging instructions (Page 27)"
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 inter-
face.

Device description
2.4 Dimension drawing
SIMATIC RTLS4083T
Operating Instructions, 12/2019, C79000-G8976-C527-02 11
2.4 Dimension drawing
Figure 2-1 Dimension drawing SIMATIC RTLS4083T - All dimensions specified in millimeters

Device description
2.4 Dimension drawing
SIMATIC RTLS4083T
12 Operating Instructions, 12/2019, C79000-G8976-C527-02

SIMATIC RTLS4083T
Operating Instructions, 12/2019, C79000-G8976-C527-02 13
Programming interface
3
3.1 Overview
Functionality of the programming interface
The functionality of the programming interface is available for the following transponders:
●RTLS4083T
●RTLS4084T
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
14 Operating Instructions, 12/2019, C79000-G8976-C527-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, 12/2019, C79000-G8976-C527-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 19)".

Programming interface
3.3 RPC calls
SIMATIC RTLS4083T
16 Operating Instructions, 12/2019, C79000-G8976-C527-02
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 occur if the
transponder has been switched off during this time or is not within wireless range. 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:1
a:bb:cc:e2
•17:b4:1
0:00:00:07
•17:b4:1
1: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

Programming interface
3.3 RPC calls
SIMATIC RTLS4083T
Operating Instructions, 12/2019, C79000-G8976-C527-02 17
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 "FileldID" parameter is invalid.
0x0101
The text length is invalid.
0x0102 The text contains invalid characters or the characters are not supported.
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

Programming interface
3.3 RPC calls
SIMATIC RTLS4083T
18 Operating Instructions, 12/2019, C79000-G8976-C527-02
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 made of the following parameters:
RPCResult, type: UInt32
1 ... n FieldResults, type: UInt32
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

Programming interface
3.4 Event messages
SIMATIC RTLS4083T
Operating Instructions, 12/2019, C79000-G8976-C527-02 19
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
"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

Programming interface
3.4 Event messages
SIMATIC RTLS4083T
20 Operating Instructions, 12/2019, C79000-G8976-C527-02
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".