background image

Programming interface 

 

3.5 Code examples 

 

SIMATIC RTLS4084T 

22

 

Operating Instructions, 04/2021, C79000-G8976-C626-02 

    function (res) {

 

      /*if ( config.debug ) console.log("epaperapi response:", 

res);*/

 

      for (let etag of config.tagwhitelist){

 

        var isin = false

 

        for (let epaper of res["args"][1]){

 

 if ( config.debug ) console.log("check epaperadr", epaper[0]);

 

          if (epaper[0] == etag.addr){

 

            isin = true

 

            break

 

          }

 

        }

 

        if (isin == false){

 

          console.error("epaper in config not found in wls 

(nodekey): ",etag.addr)

 

        }

 

      }

 

   

 }

 

  );

 

}; //connection.onopen

 

      

 

connection.onclose = function (reason, details) {

 

  console.log("no connection to wamp-router",config.wamp.name);

 

}

 

connection.open();

 

Summary of Contents for SIMATIC RTLS4084T

Page 1: ...TIC 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 ...

Page 2: ...ly 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 prod...

Page 3: ...1 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 Technica...

Page 4: ...Table of contents SIMATIC RTLS4084T 4 Operating Instructions 04 2021 C79000 G8976 C626 02 ...

Page 5: ...tions 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 ...

Page 6: ...er 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 im...

Page 7: ... 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 a...

Page 8: ...Introduction SIMATIC RTLS4084T 8 Operating Instructions 04 2021 C79000 G8976 C626 02 ...

Page 9: ...on 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 enviro...

Page 10: ...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 ...

Page 11: ...cription 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 ...

Page 12: ...Device description 2 4 Dimension drawing SIMATIC RTLS4084T 12 Operating Instructions 04 2021 C79000 G8976 C626 02 ...

Page 13: ...ic 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 fo...

Page 14: ...ed 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 co...

Page 15: ...all 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 ca...

Page 16: ...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 v...

Page 17: ...lt 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 agilio...

Page 18: ...essages 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 ty...

Page 19: ...e 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 Conside...

Page 20: ... 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 Transponder...

Page 21: ...s exit 1 console log connect to wamp router config wamp name var connection new autobahn Connection url config wamp url realm config wamp realm max_retries 1 authmethods wampcra authid config wamp user onchallenge function session method extra if method wampcra return autobahn auth_cra sign config wamp key extra challenge connection onopen function session console log connected to wamp router conf...

Page 22: ... let etag of config tagwhitelist var isin false for let epaper of res args 1 if config debug console log check epaperadr epaper 0 if epaper 0 etag addr isin true break if isin false console error epaper in config not found in wls nodekey etag addr connection onopen connection onclose function reason details console log no connection to wamp router config wamp name connection open ...

Page 23: ...play_theme RPC agilion wls epaper set_display_theme TransponderID ThemeID FieldID text1 FieldID text2 agilion wls epaper set_display_theme 12345 1 0 text1 1 text2 Theme 1 with texts 1 text1 and 2 text2 get_display_theme RPC agilion wls epaper get_display_theme TransponderID agilion wls epaper set_display_theme 12345 In return value result_code ThemeID FieldID text1 FieldID text2 3 6 Additional inf...

Page 24: ...Programming interface 3 6 Additional information SIMATIC RTLS4084T 24 Operating Instructions 04 2021 C79000 G8976 C626 02 ...

Page 25: ...ssible In this case localization via wireless reflections can occur which results in inaccurate determination of the location Check the device for damages before you use it so that it is not damaged during operation Protect the display from objects that could scratch or otherwise damage it The specified operating temperature ranges must be observed The device contains a lithium battery CAUTION Con...

Page 26: ...evice must not be squashed punctured or exposed to other mechanical influences It may only be opened to change batteries Make sure that you observe the polarity of the batteries marking on the battery insert Never expose the device to fire temperatures above 50 C or direct sunlight for an extended period of time Operating the device The device is operated with the F1 and F2 function keys on the fr...

Page 27: ...e that the connecting cable is positioned correctly so that it is not crushed when you close the battery box cover Note The batteries of the device should only be changed in dry environments CAUTION Note the following when replacing batteries Do not insert a damaged battery pack Batteries inserted with reverse polarity cannot be reused 4 3 Cleaning and maintenance The enclosure may only be opened ...

Page 28: ...Installation operation 4 3 Cleaning and maintenance SIMATIC RTLS4084T 28 Operating Instructions 04 2021 C79000 G8976 C626 02 ...

Page 29: ...6 MHz UWB channel 5 CE FCC Bandwidth 499 2 MHz Frequency range 3100 MHz 4800 MHz CE FCC 6000 MHz 7000 MHz CE FCC Transmit power 0 037 mW 41 3 dBm MHz Range Maximum 30 m Accuracy of the localization typical 0 2 m Antennas Built in UWB antenna PHASE radio frequencies communication and optional localization Wireless method IEE 802 15 4 Transmission speed 1 Mbit s Operating frequency rated value 2400 ...

Page 30: ...by 8 years Operation 100 UWB localization at 1 second 18 months Display updates every 10 seconds without localization 5 months Permitted ambient conditions Ambient temperature During write read access Outside write read access During storage During display operation 20 50 C 20 50 C 20 50 C 0 50 C Design dimensions weights and connectors Dimensions L x W x H 118 6 x 99 4 x 26 mm Weight Approx 257 g...

Page 31: ...00 Product name SIMATIC RTLS battery pack Supply voltage 14 4 V battery fully charged 12 0 V battery empty Capacity 2 6 Ah Cell type 4 x SAFT LS14500 Cable type AWG24 UL 1007 Cable length 28 mm 5 mm Connector type Enclosure JST SYP 02TV 1 Contacts JST SYF 001T P0 6 PIN assignment Pin 1 VBATT red Pin 2 GND black Permitted ambient temperature During operation During storage 60 85 C maximum 30 C Dime...

Page 32: ...Technical specifications 5 2 Technical specifications of the battery pack SIMATIC RTLS4084T 32 Operating Instructions 04 2021 C79000 G8976 C626 02 ...

Page 33: ...use of certain hazardous substances in electrical and electronic equipment official journal of the EU L174 1 July 2011 pages 88 110 Radio Equipment Directive 2014 53 EU RED Directive of the European Parliament and of the Council of 16 April 2014 on the harmonization of the laws of the member states relating to placing radio equipment on the market official journal of the EU L153 22 May 2014 pages ...

Page 34: ...ices Part 17 Specific conditions for broadband data transmission systems ETSI EN 301 489 33 Electromagnetic compatibility and radio spectrum matters ERM Electromagnetic compatibility for radio equipment and services Part 33 Special conditions for ultra wideband UWB devices EN 55011 Industrial scientific and medical equipment Radio frequency disturbance characteristics Limits and methods of measure...

Page 35: ...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 Caution Any changes or modifications not expressly approved by the party responsible for compliance could void the user s authority to operate the equipment Note This equipment has been tested and found to comply with the limi...

Reviews: