IXARO driver of ALERT

Transcription

1 MICROMEDIA INTERNATIONAL ALERT: IXARO Driver Author: Jens Eberle Pages : 20 Company: Micromedia International Date : 08/11/2016 Version : 1.1 [Commentaires ] IXARO driver of ALERT Distribution list To CC Company Attached files: 08/11/2016 IXARO driver of ALERT 1/20

2 08/11/2016 IXARO driver of ALERT 2/20

3 Content... 1 Introduction... 4 Requirements... 4 IXARO Topology... 4 ALERT configuration... 5 Activation and Configuration of the Message Processor... 5 Script driver configuration... 6 Test the connection... 9 Create a user in ALERT and add the media... 9 Send a test message to a pager Global Parameters of the Script Script and connection monitoring Script supervision by Watchdog Connection monitoring - Socket.Fail General Socket monitoring Ping Supervision Appendix Test the communication part manually Send a message to one pager Send a message to all pagers group call Troubleshooting Socket connection issue Script.ini example /11/2016 IXARO driver of ALERT 3/20

4 Introduction The IXARO company is specialized in the area of license free radio paging systems, developed for the use in logistic centers and industry. The IXARO driver of ALERT, allows to send messages* to the IXARO pagers. This document describes the installation and configuration of the driver in ALERT, also it will show the communication way between ALERT and IXARO. *The IXARO pager display, only allows to display 16 characters, so ALERT just transmit 16 characters, although it can be send more. Requirements ALERT Version 3.6 rev.2 Build 6 or higher The Option Script Editor SCRIPTDRV have to be enabled in the license TCP/IP Network System requirements correspond to the requirements of ALERT, see Not required, but nice to have, the Option Message processor of ALERT, for editing the script and for debug purposes IXARO Topology TCP/IP Network with IP address and TCP/IP Port, needed for the converter 08/11/2016 IXARO driver of ALERT 4/20

5 ALERT configuration Starting with an ALERT configuration from scratch. Activation and Configuration of the Message Processor Open Configuration -> Options and check the box Message processor activation Go to Configuration -> Message Processor and import the IXARO script by selecting the IXARO.pro file. 08/11/2016 IXARO driver of ALERT 5/20

6 Click the Init button to initialize the script In the Journal you will get the following line Script driver configuration 1. Open the Configuration -> Communication dialog box and select the Drivers tab. Here select the Generic Script Driver, if not there, please Add or re-install it. 08/11/2016 IXARO driver of ALERT 6/20

7 2. Select the Generic Script driver and double click it or choose the Properties to open its parameter dialog box. Choose the TCP/IP Connection from the drop down menu and press the (yellow marking) 3. Enter the IP Address and the TCP/IP Port of the TCP/IP-RS422 converter 4. Select the IXARO Script and configure the other parameters as shown (yellow marking) 08/11/2016 IXARO driver of ALERT 7/20

8 5. If the driver wasn t generated after the restart of ALERT, please modify the Script.ini file of the ALERT directory. Give a name to the new generated entry define the section Example: Please find an example of the Script.ini in the Appendix 6. If you neet to have the call type enabled, please add following line to have more character of the users media address bar: AddrCtrl= ABCDEFTN,# 08/11/2016 IXARO driver of ALERT 8/20

9 Test the connection Create a user in ALERT and add the media Add the IXARO driver to the user and define the pager number. The pager number is located at the back of the IXARO Pager, called Capcode. There are 3 call types, leaving the Number/Address bar blank, the Alphanumeric type will be used (default mode). To choose another mode the following syntax, comma separated is needed (please make sure that the call types are configured in IXARMA): Capcode,A A = Alphanumeric, e.g ,A N = Numeric, e.g ,N T = Tone call, e.g ,T 08/11/2016 IXARO driver of ALERT 9/20

10 Example of a tone call entry, please make sure that the long message field in the send message or alarm definition dialog box may not be empty! Send a test message to a pager Right click the new generated user and Send a Message 1. Enter the Text to send 2. Press the Send button to transmit the message to the IXARO pager PLEASE NOTE: Neither the long message in the Send Message dialog box nor in the alarm definition may not be EMTPY! ALERT won t transmit empty messages to the pager, this is also required for the call type T = Tone call. 08/11/2016 IXARO driver of ALERT 10/20

11 To verify the data transmission, please open the line monitor of the IXARO socket connection Go to ALERT -> Configuration -> Communication -> tab Ports, here select the socket connection of IXARO and press the Monitor button to open the Line Monitor window. After a successful transmission of the message, the following line in the Line Monitor should appear: Global Parameters of the Script gntrace: Trace Level 0=Low, 5 = Mid, 10 = High (all information) gntimeout: Watchdog Timeout, default 60 seconds gswatchdogtagname: IXARO-Script-Watchdog, the watchdog alarm name gstransmitteraddress: The Transmitter Address set via the dip switches, default 1 gssubaddress: Subaddress, default = 2 08/11/2016 IXARO driver of ALERT 11/20

12 Script and connection monitoring We recommend to user 4 additional alarms to monitor the whole communication line. Script supervision by Watchdog In the case of a script issue the watchdog alarm will be raised 1. Add the watchdog variable by add a tag 2. Select the type Other and name it as IXARO-Script-Watchdog 3. Define the alarm group, the condition INVAR=1;80, the call action and the alarm text 4. Re-initialize the IXARO script in the message processor dialog box 08/11/2016 IXARO driver of ALERT 12/20

13 Connection monitoring - Socket.Fail In the case of a network / socket issue the following alarms will be raised. Please make sure that the users of the call group for the following alarms, doesn t use the IXARO driver. Please use another driver like , SMS or tone alarm of ALERT. 1. Add the Socket.Fail variable by add a tag 2. Select the OPC type and choose the ALERT.OPCServer.1. Please select the item according to the IXARMA socket connection. Check the Communication-> tab Ports dialog box to get the right socket number. 08/11/2016 IXARO driver of ALERT 13/20

14 3. Alarm definition example General Socket monitoring 1. Add the Socket variable by add a tag 08/11/2016 IXARO driver of ALERT 14/20

15 2. Define the condition to NOT EQUAL to 5 and set the other parameters of the alarm definition window Now, when the socket connection will be closed you will get an error message 08/11/2016 IXARO driver of ALERT 15/20

16 Ping Supervision To do a permanent supervision of the IXARMA TCP/IP-RS422 converter, please add the Ping Script to supervise this connection 1. Please import the Ping script (ping.pro) to the message processor and initialize it by pressing the init button 2. At the left hand site, in the tree view you will get a new data server entry called ping 3. Please do a right click at the Ping data server to add a new tag. 08/11/2016 IXARO driver of ALERT 16/20

17 4. The tag name must be the IP address of the IXARO TCP/IP RS422 converter 5. Below, there is the example configuration of the alarm definition dialog box 6. Test the script and the newly generate tag a. Unplug the network cable of the server b. In ALERT the alarm with the IP address name should be raised c. Plug in the network cable again d. The alarm should go back to its normal state e. Acknowledge the alarm 08/11/2016 IXARO driver of ALERT 17/20

18 Appendix Test the communication part manually Use the terminal application putty.exe, download it from here: Open the terminal application, select the connection type Telnet and enter the IP address and TCP/IP Port, press the open button to start the TCP/IP connection. If the session cannot be opened, please check your firewall settings, the IP address and TCP/IP port of the EXPERT TCP/IP-Serial converter. When the terminal window will start, please enter following commands (press enter to send the commands): i1 to get the transmitter model and version Send a message to one pager Use following syntax: Px pager number, sub address, call type, message 08/11/2016 IXARO driver of ALERT 18/20

19 P ,2,A,ALERT Test The pager will receive ALERT Test Send a message to all pagers group call Use the following group call number: and syntax: P1, ,2,A,ALERT GroupTest All pagers in the radio range will get the message ALERT GroupTest Troubleshooting Socket connection issue Please restart the XIARO TCP/IP-Serial Converter and ALERT 08/11/2016 IXARO driver of ALERT 19/20

20 Script.ini example [Version] Version=1, 0, 0, 10 (Unicode) [Drivers] 0=IXARO [IXARO] IpAddress= IpPort=100 TCP=1 ComType=8 Script=IXARO TimeTest=1 TimeResponse=10 TryCount=1 AckAuto=1 AckAlarm=0 Trace=1 Mode=1 Header="" HeaderMes="" OneMessage=1 GroupMessage=0 GroupChar=: Uppercase=0 NoAccent=0 Country= Flags= DialNumber= Init= Masked=0 AckManu=0 baud=9600 bits=8 parity=no stops=1 B1=0 B2=9 B3=0 AddrSize=0 AddrExact=0 AddrFill=0 AddrCtrl= ABCDEFTN,# 08/11/2016 IXARO driver of ALERT 20/20