Home

GSM-Control Object User Manual

1. SendReceive 5R2 ReceiveMessage New Floating point value Item2 0 SendReceive SR2 Disabled User O user2 ii SendReceive SR2 Item2 Reference GSMCtriTest_001 RealValue Item2 amp GSMCtrlObject2 001 General Users Send Receive Alarms License Server Object Information Scripts UDAs Extensions SendReceive 5SR4 ReceiveMessage O SendReceive SR4 Disabled oO Useri User SendReceive 5R4 AlarmItem Reference AlarmItem GSMCtrlTest 001 Alarm P068m110 Wonderware Finland amp Baltics GSM Control Object 37 Above it is possible to see there two different types of SRs in example txt file there are 2 messages SR1 and SR3 with both Send and Receive mesages configured and 2 messages SR2 and SR4 with only Receive mesages configured means used only for providing new values to Wonderware Application Server The example txt file ALARMS section contains four Alarm messages Alarm Alarm2 Alarm3 andAlarm4 ALARMS Alarm1 0 alarm1 GSMCtrlTest_001 Alarm 3 0 Alarm2 0 alarm2 high pressure ves GSMCtrITest 001 Alarm GSMCtrlAck 001 Ack2 180 0 Alarm3 0 alarm3 low level Item1 ack GSMCtrlTest_001 Alarm GSMCtrlAck 001 Ack3 300 0 Item1 GSMCtrlTest_001 IntegerValue Alarm4 0 alarm4 r nVall1 Item1 r n t started GSMCtrlTest_001 Al arm 5 0 c wav alarm4 wav Item1 GSMCtrlTest_001 IntegerValue and in user interface looks like this GSM
2. LicenseServer IsLicensed Boolean Current status of GSM Control Object licensing true licensed false not licensed LicenseServer Port License Server node Port number LogSendReceive Boolean R W Enables disables logging of modem serial communications to Wonderware ArchestrA Logger Modem CharacterSets String Contains the array of modem s supported array character sets PINCode Modem PIN Code field GSM Control Object User Manual Ver 2 x Rev 1 10 P068m110 Wonderware Finland amp Baltics GSM Control Object PIN Failed Boolean R Indicates the invalid PIN code ReceivePhone String Contains the phone number from last received SMS message ReceiveSMS end Contains the last received SMS message text Retries Integer R W Number of retries for execution of AT command in case of reply time out from modem SendPhone String R Set Contains the last sent SMS message phone number Can be used to set phone numbers for sending custom not pre configured messages SendSMS String R Set Contains the text of last sent SMS message Writing new value into this attribute will initiate the sending of custom not pre configured SMS message to the phone number currently placed in SendPhone attribute SignalQuality sg R Indicates the modem GSM signal strength Simulate Boolean R W Controls the simulation mode In simulation mode SMS are not sent but instead logged into Wonderware ArchestrA In simulation
3. 1 Find out and remember the PIN code if enabled and phone number of the SIM card to be used with GSM modem 2 Insert the SIM card into the GSM modem Connect GSM modem to computer serial port e g to COM1 and power up the GSM modem It is assumed the GSM modem has default serial port configuration baud rate 19200 8 data bits 1 stop bit no parity no flow control If GSM modem settings differs from default then it is necessary to restore the default settings it can be done e g by Windows HyperTerminal program by issuing AT amp F Set all current parameters to manufacturer defaults command 3 Undeploy if not yet undeployed the GSMCtrIObject2 001 001 instance and in General tab change the Baudrate setting to 19200 or to other in case the modem current baudrate is different and enter the PIN code in case it is enabled on SIM card GSMCtri0bject2 001 General Users Send Receive Alarms License Server Object Information Scripts UDAs Extensi comport eom L I Baudrate Dom Ed g i CharacterSet kan Chi DIN ode rm Timeout pO m SEC Retries i SM5Centrekumber 356405202000 hi TextMode gt hi Ob Disabled 3 LogSendReceive I it Simulate ob Import File Name e Gsm Contral Object default txt Import Export 4 In Users tab change the User1 phone number to your mobile phone number used to send receive SMS messages to from GSM Control Ob
4. Baudrake eng Bd CharacterSet GSM FINCode Timeout f _ Retries rj SMSCentreNumber TextMode Disabled LogSendReceive L Simulate gt ff lp Import File Mame Import a Export The General tab contains the GSM modem default settings and some common settings As default the modem is connected to COM port COM1 baud rate 9600 GSM Control Object User Manual Ver 2 x Rev 1 10 P068m110 Wonderware Finland amp Baltics GSM Control Object 14 bps is used default character set used on GSM modem is GSM modem time out is 3 seconds and number of Retries for sending SMS message is 5 Users tab GSMCtriO0bject2 001 Users C Users User Disabled EN 1 Useri Users User PhoneNumber 358777666555 Chi Users User Priority 100 Alarms select All Alarmi Unselect All The Users tab contains one User User1 with phone number 358777666555 and with default Priority 100 the Priority is used only for Alarm messages to specify the order of receiving Alarm SMS in case there are more than one User configured as a receiver Send Receive tab GSMCtriObject2_001 General Users Send Receive Alarms License Server Object Information Scripts UD s Extensions Graphics SendReceive 5R 1 Receivevessage SendReceive 5R 1 5endMessage Leer IO Items H SendReceive 5R 1 Item1 Reference 1 Itemi GSMCHITest
5. DOLL Integervalue m d The Send Receive tab contains one pair of Send Receive message SR1 linked with User User1 and consisting of Receive message and Send message GSM Control Object User Manual Ver 2 x Rev 1 10 P068m110 Wonderware Finland amp Baltics GSM Control Object 15 Value 1 The Receive message contains the index taken from No column at IO Items list view of embedded IO Item Item1 associated with test object attribute GSMCtrl Test 001 Integer Value Alarms tab GSMCtrlObject _001 Alarms Alar AlarmMessage 1 Alarmi t Alarms Aerm AckMessage Alarms Alarm AlarmItem InputSource fasmctrlTest 001 Alarm St Alarms Alarm ckItem Reference Alarms Alarm Timeout E seconds E Alarms Alarm SendToall Alarms Alarmi voiceSource E Alarms Alarm Disabled Users User User The Alarms tab contains one Alarm message Alarm1 linked with User User1 The text of Alarm message is alarm and the input source of alarm state is associated with test object attribute GSMCtrl Test 001 Alarm The time out for sending alarm message 1s 3 seconds The following very basic can be done by using the default configuration 1 If test object attribute GSMCtrlTest_001 Alarm value is set to True then alarm SMS message alarm will be sent to default User1 default phone number 358777666555 2 If GSM Contro
6. IO Item Name and enclosed in figure brackets SendReceive SRName SendMessage Contains the Send message SMS message sent from GSM Control text and optionally the values for configured IO items The Send message if configured means Send message can be empty will be send back to ReceiveMessage sender in case the received SMS message matches with some of configured ReceiveMessages The placeholders of IO items GSM Control Object User Manual Ver 2 x Rev 1 10 P068m110 Wonderware Finland amp Baltics GSM Control Object 29 values can be entered as IO Item Index or IO Item Name and enclosed in figure brackets I SendReceive SRName Disabled The SendReceive messages pair can be disabled from processing by checking this check box Later at run time it can be enabled by using SendReceive SRName Disabled runtime attribute see Description of GSM Control Object attributes section later in this manual Users Here can be selected the Users linked with this SendReceive messages pair IO Items No Indexes of configured IO Items available for ReceiveMessage or SendMessage IO Items Name Names of configured IO Items Each configured IO Item creates separate virtual primitive containing IO Item configuration attributes SendReceive SRName ItemName Reference contains the Galaxy attribute name which value will be read from Galaxy and sent from GSM Control in SendMessage or written to Galaxy as received by GSM Control in
7. ReceiveMessage GSM Control Object User Manual Ver 2 x Rev 1 10 P068m110 Wonderware Finland amp Baltics GSM Control Object 30 Alarms tab The Alarms tab contains information about all configured Alarm messages GGSYICtriO0bject2 001 Alarms Alarm GlarmMessage L Alarmi Alarms Alarmi AckMessage Alarms Alarmi AlarmItem InputSource asmctelTest 001 Alarm GK Alarms Alarm AckItem Reference Alarms Alarm Timeout 3 seconds E Alarms Alarm SendToAll Alarms Alarm voiceSource 8 Alarms Alarm Disabled Lseri IO Items Item The following can be entered in Alarms tab No The indexes of all configured Alarms GSM Control Object each scan period sequentially is checking all configured and enabled alarms for presence of alarm True state The execution sequence is from alarm with first index to the last All received SMS messages are passed to each enabled alarm in the order of growing indexes in purpose to check if there is matching with configured AckMessage Name Name of virtual primitive containing alarm configuration attributes In further explanation this name is referred to as AlarmName Alarms AlarmName AlarmMessage Contains the Alarm message to be sent from GSM Control text and optionally the values for configured IO items The placeholders of IO items values can be entered as IO Item Index or IO Item Name and enclosed in figure brackets GSM
8. Ver 2 x Rev 1 10 61 script is called to validate many data in GSM Calendar Object Current time used to enable disable each scheduler UDA that keeps information which group operator selects from the drop down list on HMI Boolean UDA that works together with resizeLengthOfGroups UDA This UDA shows the direction of resizing True means increase Value from 0 to 3 determines how many information must be send to SMC log console 0 means nothing is send but errors and warnings are always send Boolean UDA that triggers ReadConfFromF ile script to start the reading configuration for XML file Boolean UDA that triggers ReadConfFromGSMControl script to import already defined Users from GSM Control Object That trigger is set to true every time when GSM Calendar Object is deployed Boolean UDA that triggers ReadSchedFromFile script to start reading schedulers for XML file Boolean UDA that works together with increaseLengthOfGroups UDA This UDA triggers ChangeSizeOfGroups script to resize the length of group arrays Boolean UDA that triggers SaveConfToFile script to save configuration in XML file Boolean UDA that triggers SaveSchedToFile script to save schedulers in XML file P068m110 Wonderware Finland amp Baltics GSM Control Object 62 schedulerFilePath Path toe XML file that is used in reading saving schedulers data Default dest
9. View Lo Windows Windows amp Scripts e ERE EEE SSE PD EEE EEEE GSM Control Object User Manual Ver 2 x Rev 1 10 P068m110 Wonderware Finland amp Baltics GSM Control Object 50 5 3 Right click on GSM Control Calendar Object window and select Embed ArchestrA Graphic from pop up menu Mothing to Undo Paste Select Al Embed Archestr Graphic Save Window Close Window Delete Window Save Window Ae Window Scripts QuickFunctions SmartSymbol k Window Properties 5 4 The Galaxy Browser window will appear select GSMCalendar_001 in Instances view and select the TabbedDisplay KR Galaxy Browser ttt K i te SC Filter Default sl EZ 5 Instances GSMCalendar 001 Tagname A P keen Weeden EEN l gelt Eeer aie G5MCalendar 001 TE Ee pore 35 WE IE KLINKMANN aa About Members Runtime Schedulers mg TabbedDisplay 5 5 Locate the selected TabbedDisplay on GSM Control Calendar Object window CE GSM Control Calendar Object Sta Fr FOUR NAS YA ope nag ou Wy penn H Mea 3 3 5 3 Unresolved Reference Members yy e Mae Ko EE Gel Unresolved Referenc EE i imm Y Pee re ee PEEL gt S l Z jave I Import users from LER Siem Add BR ek GSM Control ZE WW R Recur days mm ei Rename Remove 000 Cufrent
10. current Alarm configuration is not used in SMS processing GSM Control Object User Manual Ver 2 x Rev 1 10 P068m110 Wonderware Finland amp Baltics GSM Control Object 44 Error and warning messages This section contains the information about GSM Control Object error and warning messages The computer system time is outside of time Demo license period expired interval in Demo license key Please purchase software key or request new Demo license Exceeded demo license user limit The demo license has 10 Users limit Reduce the number of Users Invalid software key for The software key was not entered or it is invalid ProductID PR0068X XXX CustomerID hhhh hhhh hhhh hhhh for computer where GSM Control Object is deployed Enter the purchased software key by using SwKey attribute Too many users for Product ID The selected product ID has exceeded allowed PR00682 XXX number of Users Delete some Users or purchase the GSM Control Object unlimited version Running in demo mode Enter software The GSM Control object is working in one hour key for ProductID PR00680 XXX CustomerID hhhh hhhh hhhh hhhh demo mode because software key is not entered or 1s invalid The GSM Control Object finished to work in one hour demo mode The outgoing SMS sending and received SMS handling is disabled Redeploy the GSM Control object or enter purchased software key Demo period timed out SMS received from Ph
11. mode the processing of simulated ReceiveMessages is enabled Simulation Phone Simulated SMS phone number Simulation Receive Boolean R W Initiates the receiving of simulated SMS message The False state indicates finishing of simulated SMS receiving SMSCentreNumber String W The SMS Centre number can be configured or entered in Runtime Statistics ReceivedSMS Integer Indicates the number of received SMS messages Statistics RejectedSMS Integer Indicates the number of received invalid SMS messages Statistics SentSMS Integer Indicates the number of sent SMS messages Status Boolean R Indicates the communication status with GSM Control Object User Manual Ver 2 x Rev 1 10 P068m110 Wonderware Finland amp Baltics GSM Control Object 41 modem True good communications False failed to communicate TextMode Boolean R W Controls the modem SMS sending receiving mode PDU or text mode The PDU mode is preferable Text mode can be used for debug purposes User Attributes Attribute Data Access Description Type Type Users User Name Disabled Boolean R W Controls the User availability for handling SMS messages If True then no SMS messages are handled from this phone number nor sent to this phone number Users UserName PhoneNumber String R W Contains User phone number in accepted Users User Name Priority Integer R W The Priority of User used only for Alarm messages to specify t
12. schedulers the name of group which was selected during the definition of scheduler The same as Arr ScheduleEndDate but for start date time The same as Arr ScheduleEndWeekDayName but for start date time The length of array is 200 Each item in this array references to individual schedule definition This array represents the type of each scheduler Value 0 means the scheduler type is based on exact date time Value 1 means the scheduler type is based on the days of week Unique names of Users This array must contain the same Users not necessary it the same order as GSM Control Object has The list of unique Users belonging to currently selected group from drop down list on HMI The array of Boolean values indicating if the certain User inside Arr UserNames array is allowed to receive transmit SMSs Path to XML file that is used in reading saving configuration data Default destination is e GSMCalendar_config xml Boolean UDA that triggers ConfigurationWasChanged script This P068m110 Wonderware Finland amp Baltics GSM Control Object currentTime groupMembersSelected DateTim String R W Boolean increaseLengthOfGroups R W Integer readConfFromFile Boolean readGSMControlC FG Boolean readSchedulerFromFile Boolean Boolean resizeLengthOfGroups saveConfToF ile Boolean saveschedulerToFile Boolean GSM Control Object User Manual
13. the name of Alarm message e g al alrmmsg12 GSM Control Object User Manual Ver 2 x Rev 1 10 P068m110 Wonderware Finland amp Baltics GSM Control Object 36 The example txt file SR section contains four Send Receive messages SR1 SR2 SR3 and SR4 SR SR1 0 2 Value Item1 Item1 GSMCtrlTest_001 IntegerValue SR2 0 New floating point value Item2 Item2 GSMCtrlTest_001 RealValue SR3 0 val Level Level1 Temp Temperaturel1 deg C Levell GSMCtrITest 001 IntegerValue Temperaturel GSMCtrITest 001 RealValue SR4 0 Set alarm AlarmItem AlarmItem GSMCtrlTest_001 Alarm and in user interface looks like this GSMCtriObject2_001 General Users Send Receive alarms License Server Object Information Scripts UDAs Exte SendReceive SR1 ReceiveMessage Yalue Item1 C SendReceive SR 1 Disabled User User O user2 SendReceive SR1 Item1 Reference SS GSMCtrlTest 001 Integervalue NW GSMCtriObject2 001 m General Users Send Receive alarms License Server Object Information Scripts UDAs Exte SendReceive SR3 ReceiveMessage I SendrReceive 5R3 Disabled User O useri User2 P SendReceive 5R3 Levell Reference Level GSMCtrlTest 001 Integervalue Temperature GSM Control Object User Manual Ver 2 x Rev 1 10 amp GSMCtrlObject2 001 General Users Send Receive alarms License Server Object Information Scripts UDAs Exte
14. use 4 The GSM Control Object default configuration is provided for demo purposes only to serve the explanation in Getting started quickly with GSM Control Object section The default configuration contains and allows to do the following one User User1 with phone number 371777666555 one Alarm message Alarm1 the SMS message alarm will be sent to User1 when test object attribute GSMCtrlTest_001 Alarm value is set to True one pair of Send Receive messages SR1 when GSM Control Object receives SMS message from User1 the response SMS message Value Item1 will be sent back to User1 where Item1 will be replaced with current value of test object attribute GSMCtrlTest_001 IntegerValue Getting and enabling license To enable the software key or demo license or licensing under License Server open the GSM Control Object configuration editor by double clicking the instance GSMCtrlObject2_001_001 then click on the License Server tab GSM Control Object User Manual Ver 2 x Rev 1 10 P068m110 Wonderware Finland amp Baltics GSM Control Object 8 GSMCtri0hject2 001 General Users Send Receive Alarms License Server Object Information Script Product ID PR 00651 215 Product version 2 15 IF Address Port S001 Customer ID DC Code 2496 7475 8beb Fa91 ProductID Ce PR 00651 215 C PR 00687 215 Software key Invalid
15. used installed IDE node object nodes 1 Undeploy all WinPlatforms that host the GSM Control object 2 Delete all GSM Control Object instances and templates from Galaxy 3 Close ArchestrA IDE 4 Uninstall manually GSM Control Object assemblies in case they still are installed a Browse to folder C Windows assembly select all Assemblies with names starting with GSMCtrlObject b Open context menu by clicking right mouse button and select option Uninstall os v al Search Windows v Computer Local Disk C Windows assembly 10 x File Edit View Tools Help Organize e Open Sharewith e Burn New folder Assembly Name 48 GalaxyTagDictionaryctr 484 GalaxyTaqDictionaryInterop SSMCtrlObject SMCtrlObject2AlarmsPrimitiveRuntime16 GSMCtrIObject2ChildPrimitiveStatis i 2 icsConfigtime16 sRuntime1 t2Configtime16 serPrim16 amp GS D serPrimConfigtime16 GSMCErIObject2UsersUserPrimRuntime16 ay IaaEditorFormLibInterop PER I larmMgrDataProvider a ICSharpCode SharpZipLib 1 ICSharpCode SharpzipLib GSM Control Object User Manual Ver 2 x Rev 1 10 1 2 0 0 4321 46 0 0 1 15 5281 16554 1 15 5281 16553 1 15 5281 16553 1 15 5281 16554 1 15 5281 16555 1 15 5281 16554 1 15 5281 16554 1 15 5281 16553 1 15 5281 16554 1 15 5281 16554 1 15 5281 16555 1 15 5281 16555 1 15 5281 16556 1 15 5281 16553 1 15 5281 16555 1 15 5281 16555 1 15 5281 16553 1 15 5281 16555 1 15 5281 16555 1 15 5
16. 01_2 LicenseServer C g 1590 7689 b309 0cf2 e check if the GSM Valid software license found for PR 0068n xxx message appears in SMC Log Viewer and GSM Control Object LicenseServer IsLicensed attribute changes to true Message Details x t component 154508 10 2 2013 1 17 22 PM 565 Info ArchestrA To Le Message GSM valid software license Found For PR 00682 215 GSM Control Object User Manual Ver 2 x Rev 1 10 P068m110 Wonderware Finland amp Baltics GSM Control Object 11 Demo License The demo license is for free and provides an unlimited functionality up to 10 Users are supported but it is valid only for a limited time period After demo license expiration the GSM Control Object will support only 1 User and will work only 1 hour after GSM Control Object deployment in run time The demo license can be obtained by sending request to info wonderware fi The demo license is a text string containing 64 Hex symbols When received paste the demo license text string to Demo license text field and check that it is evaluated as Valid Key in case GSM Control Object will be deployed locally Software Key valid key Demo license text p4 66 CE F7 2E CE D9 44 4B AA 75 C9 OG 85 14 03 a1 CH BY 1A CF 2E 14 30 70 F4 EC 2B 75 30 DO 78 Expires 30 06 2012 15 59 04 to GSM Control Object LicenseServer Cfg attribute after deploy and check if message like
17. 1 1 1 and in user interface looks like this GSMCtrlObject2_001 COMPort coms Baudrate 19200 CharacterSet PINCode Retries SMSCentreNumber TextMode M Disabled r LogSendReceive v lw Simulate Import File Name C G5M Contral Objectjexample txt Import Export GSM Control Object User Manual Ver 2 x Rev 1 10 P068m110 Wonderware Finland amp Baltics GSM Control Object 35 The example txt file USERS section contains two Users USERS User1 0 358777666555 sr SR1 sr SR2 al Alarml al Alarm User2 0 358555666777 101 sr SR3 sr SR4 al Alarm2 al Alarm3 al Alarm4 and in user interface looks like this GSMCtrlObject _001 Lisers users User1 Disabled LE 1 Leer Z User Users User 1 Fhonelumber 358777666555 p Users User1 Priority 100 ci L Alarms Select All Alarmi Alarm Unselect Al CT Alarm TT Alarm GSMCtriObject _001 General Users Send Receive Alarms License Server Object Information Scripts UDAs Extensions Users gt Users User Disabled p LR 1 Useri 2 Usere Users User PhoneNumber 358555666777 ch L Users User Priority f DI L Alarms select All CT Alarm Alarm Unselect All Alarma Alarm In the lists Send Receive messages and Alarm messages linked with User it is obligatory to have er before the name of Send Receive message e g sr SRMes4 and al before
18. 10 25 2011 2 55 37 PM 1456 2640 Info gt Message GSM Received SMS from 37129257257 7 13 Upon receiving the SMS message GSM Control Object will respond to sender with SMS message Value 21 containing the current value of GSMCtrlTest_001 IntegerValue attribute in SMC Log Viewer the corresponding messagels logged GSM Control Object User Manual Ver 2 x Rev 1 10 P068m110 Wonderware Finland amp Baltics GSM Control Object 24 Ke x 10 25 2011 2 55 36 PM 1456 2640 Info 2 954 Message GSM Sending SMS to 37129257257 Message value 21 GSM Control Object configuration in details This section explains the GSM Control Object configuration in details General tab The General tab contains the GSM modem default settings and some common settings GSMCtri0bject2 001 General Users Send Receive Alarms License Server l Object Information Scripts l UDAs Extensi ComMPort com Baudrake 15200 Bd Characterset FINCode Timeout Retries SMSCentreNumber 358405202000 TextMode gt p Disabled d L LogsendReceive T L Simulate L Import File Name C Gsm Control Objectidefault txt Import a Export The following can be entered in General tab GSM Control Object User Manual Ver 2 x Rev 1 10 P068m110 Wonderware Finland amp Baltics GSM Control Object 25 COMPort The name of serial communicati
19. 2 001 001 Simulation Phone value value SendReceive SendReceivePrin Itemi SRI SRI False Item Lem MxString 13 t35MCtrlTest 00 value Iker alarm P068m110 Wonderware Finland amp Baltics GSM Control Object 19 Modify the GSMCtrIObject2 001 001 Simulation Message string to and GSMCtrlObject2_001_001 Simulation Phone string to 358777666555 8 Modify the GSMCtrlObject2_001_001 Simulation Receive value to True thus initiating the receiving of simulated SMS message Modify Boolean Yalue Reference G5MCtrObject2 001 001 Simulation Receive fe True False 9 The following messages now are logged to SMC Log Viewer showing after simulated SMS message was received from phone number 358777666555 the response SMS message Value 13 was sent back to same phone number 29424 l 36 18 PFM 20 76 10 25 7011 Message GSM Received simulated SMS From 358777666555 p Message Details Thread ID Log 29425 02512011 1 36 19PM 2076 2432 Info Message GSM Simulated sending SMS to 3587 77666555 Message Value 13 GSM Control Object User Manual Ver 2 x Rev 1 10 P068m110 Wonderware Finland amp Baltics GSM Control Object 20 Getting started with GSM modem connected The following explains the sequence how to start quickly with GSM Control Object by using GSM modem and sending receiving of SMS messages by mobile phone
20. 281 16553 1 15 5281 16554 1 15 5281 16554 1 15 5281 16553 1 15 5281 16554 1 15 5281 16555 2 0 0 0 1 0 0 0 0 5 0 0 0 5 0 0 Public Key Token 23106a86e706d0ae 23106a86e706d0ae 09e1088ba0de3b56 09e1088ba0de3b56 09e1088baOde3b56 09e1088ba0de3b56 09e1088ba0de3b56 09e1088ba0de3b56 09e1088ba0de3b56 09e1088ba0de3b56 09e1088ba0de3b56 09e1088ba0de3b56 09e1088ba0de3b56 09e1088ba0de3b56 09e1088ba0de3b56 09e1088ba0de3b56 09e1088ba0de3b56 09e1088ba0de3b56 09e1088ba0de3b56 09e1088ba0de3b56 09e1088ba0de3b56 09e1088ba0de3b56 09e1088baODde3b56 09e1088ba0de3b56 09e1088ba0de3b56 09e1088ba0de3b56 09e1088ba0de3b56 Fdcbee9982d955e0 7ebd82b507d9e10c 1bO3e6acf1164F73 1bO3e6acf1164F73 MSIL MSIL MSIL MSIL MSIL MSIL MSIL MSIL MSIL MSIL MSIL MSIL MSIL MSIL MSIL MSIL MSIL MSIL MSIL MSIL MSIL MSIL MSIL MSIL MSIL MSIL MSIL MSIL MSIL g es il P068m110 Wonderware Finland amp Baltics GSM Control Object 65 5 Delete WAS generated MSI installers msi files that contains links to deleted invalid files from C Program Files x86 ArchestrA Framework FileRepository lt Your Galaxy Name gt Vendors folder The lt Your Galaxy Name is your galaxy name e g grTest1 and msi files are named like lt User name gt msi where lt User name gt is the currently logged user name user that was used to install object for example WINO08 msi vendors l Jo Computer Local Disk C Program
21. 4 OMATT NET SS 47 Ha SEERE EE ON 47 Me 47 Me 47 IKE 1S 1 AO EE 52 001210 E NS ES 53 AN 54 GSM Calendar Object configuration in details ae 56 General informal Oi a sincsvinscisccackdsauceusscdastestaaswassatsedeadcashavesasusasteaouientiasntssdaanstdsenasceastiacus 56 UPA on gl EE 57 General ENEE ee 59 52 1 EE ce nets apsoesi stone ss EE E 62 GSM Control Object upgrade procedure ee 63 GSM Control Object clean Uninstall procedure sessesescesescesescecescesesoesoesecoesecoeoe 64 FANN 66 GSM Control Object User Manual Ver 2 x Rev 1 10 P068m110 Wonderware Finland amp Baltics GSM Control Object 1 GSM CONTROL OBJECT Overview GSM CONTROL OBJECT GSM Control SMS Gateway Object is a Wonderware Application Server domain object created by using the Archestra Object Toolkit and used for 2 way remote control in automation and other applications using standard GSM Global System for Mobiles cellular phones and GSM network Based on the standard GSM cellular phones and other GSM capable devices GSM Control Object offers a low cost and easy alternative to create wireless control and monitoring applications Implementation of GSM network s SMS Short Message Service technology secures reliable transmission even in the most error sensitive applications The main task of GSM Control Object is to work as a gateway between GSM environment at one side interfacing with GSM environment by sending receiving SMS messages and Won
22. 9 00 Monday Hi 06 00 Monday 7 Management 14 00 Tuesday R 17 00 Thursday 8 HelpDesk 08 00 2011 12 02 08 00 2011 12 31 HelpDesk 08 00 2011 12 02 08 00 2011 12 31 Recur Recur Date Week lt Arr ScheduleType Arr ListOfActiveUsers Arr UserWillReceiveMet Finland GSM Control Object User Manual Ver 2 x Rev 1 10 P068m110 Wonderware Finland amp Baltics GSM Control Object 59 General Attributes Attribute Data Access Description Type Type Arr_DaysOfWeek String Defines the order and names for days of week The names of week must be the same as the current system uses Method date toString dddd must return the same names as defined in this array Order of items inside this array can be changed to start the week on Sunday The default order is Monday Sunday Arr_GroupMembers String R W Defines the members Users assigned to the groups Format Group User1 User2 UserN Users attached to the group cannot be duplicated unique in one line Group cannot be duplicated inside the whole array Arr_ListOfActiveUsers String Unique names of Users that are enabled to receive transmit SMSs The order and array id is not equal to order and id inside the Arr UserNames array Arr ScheduleActive Boolean The length of array is 200 Each item in this array references to individual schedule definition This array cannot change its size dynamically The True value of the item in this ar
23. AT COMMAND Error Code Failed set item ITEM to Value Exception while writting to com port Message Error Message Exception in com port read Message Error Message Exception in GSMEngine thread Exception info Exception in GSMComPort thread Exceprion info Exception in read callback Message Exceprion info Exception on com port write callback Message Exception info GSM Control Object User Manual Ver 2 x Rev 1 10 The communication with modem either failed or recovered The modem did not sent response to AT command during the reply time out The modem responded with error code to AT command The IO item has no write permission The writing to COM port causes exception Reading COM port causes exception The software exception was caught in scan period handler The software exception was caught in COM port thread The software exception was caught in asynchronous read handler The software exception was caught in asynchronous write handler P068m110 Wonderware Finland amp Baltics GSM Control Object 47 GSM Calendar Object This section explains the GSM Calendar Object what serves as an example how in practice to access use the GSM Control Object from Wonderware Application Server environment Overview The GSM Calendar Object allows to access and control GSM Control Object attributes from Wonderware Application Server environment GSM Calendar O
24. Control Object User Manual Ver 2 x Rev 1 10 P068m110 Wonderware Finland amp Baltics GSM Control Object 31 Alarms AlarmName AckMessage Contains exact characters which should be sent back to GSM Control to acknowledge the alarm IO Items are not supported in AckMessage Alarms AlarmName AlarmItem InputSource Contains the Galaxy Boolean attribute name used to provide the alarm state When this attribute value changes to True the corresponding configured Alarm is switched into alarm state and GSM Control Object will send Alarm SMS message Alarms AlarmName AckItem OutputDest Contains the Galaxy Boolean attribute name used to provide alarm ack state and to get the True value in case GSM Control Object receives the AckMessage If AckItem referred attribute already has True value then alarm is considered as acknowledged and Alarm SMS message is not sent Alarms AlarmName Timeout Contains the time out in seconds for waiting for AckMessage before sending the alarm message to next User This time out is not applicable in case the Alarms AlarmName AckMessage field is empty no response Ack message is expected Alarms AlarmnName SendToAll If checked all selected Users will receive the Alarm SMS message regardless of whether or not the Alarms AlarmName AckMessage field is empty or filled in case Alarms AlarmName AckMessage field is not empty then response Ack message is expected from any of Users linked with this Alarm message A
25. CtriObject2_001 General Users Send Receive Alarms License Server Object Information Scripts UDAs Exte IO Items GSMCtrlObject2 001 Alarms Alarm AlarmMessage Alarms Alarmi AckMessaqge Alarms Alarm AlarmItem InputSource smctriTest_001 Alarm ae Alarms Alarm Ackltem Reference Alarms Alarm Timeout 3 seconds ja Alarms Alarm SendToAll Alarms Alarm1 VoiceSource LI Alarms Alarm1 Disabled User User oO User2 IO Items Item General Users Send Receive Alarms License Server Object Information Scripts UDAs Exte Alarms Alarm2 AlarmMessage alarm2 high pressure Alarms Alarm2 AckMessage yes Alarms Alarm2 AlarmItem InputSource esmctriTest_001 Alarm Se ch Alarms Alarm2 AckItem Reference fasmctrlack 001 Ack2 SEN Alarms Alarm Timeout 180 seconds Alarms Alarm SendToAll Alarms Alarm2 YoiceSource E Alarms Alarm2 Disabled User gt User User Item GSM Control Object User Manual Ver 2 x Rev 1 10 HH P068m110 Wonderware Finland amp Baltics GSM Control Object 38 GSMCtriObject2 001 amp GSMCtrlObject2 001 General Users Send Receive Alarms License Server Object Information Scripts UDAs Ext General Users Send Receive Alarms License Server Object Information Scripts UDAs Exte Alarms Alarm3 AlarmMessage Alarms A
26. Enable w GSMCHIObjectz Attributes No Dat o G5MCtrlTest 00 715907 _CategoryEnum _ExecutionRelativeorderEnum Externalkame ExternalMame InheritedattrlistNames Internallame _InternalName _ Warnings Alarm Alarminhibik Alarmiode AlarmiodeCmd Enable Area Area 0 Configversion 1 ContainedName Container ExecutionRelatedobject ExecutionRelativedrder Mone Hierarchicalkame G3AMCT Host Area 0 InAlarm False Integervalue 0 Realvalue 0 0 ScanState true al cama AttributeReference SShCtriTest_ 001 Alarm SSM CtriTest_001 Integervalue 9 Modify the GSMCtrlTest_001 IntegerValue value to 21 Modify Numeric Yalue E4 Reference G5MCtrITest DO Irtegeryalue value 21 ar zen 10 Modify the GSMCtrlTest 001 Alarm value to True GSM Control Object User Manual Ver 2 x Rev 1 10 22 P068m110 Wonderware Finland amp Baltics GSM Control Object 23 Modify Boolean Yalue NI Reference G5MCtrlTest DO Alarm e True I False 11The SMS message alarm should be sent to and received by mobile phone in SMC Log Viewer the corresponding message is logged a Message Details ai 952 10 25 2011 2 53 42 PM 1456 Message GSM Sending SMS to 37129257257 Message alarm 12 From your mobile phone respond to the sender with SMS message 7 In SMC Log Viewer the message indicating the receiving of this SMS message should be logged Soso x Thread ID Loc t
27. Files x66 Archestr4 Framework FileRepository grTestl Vendors Organize e if Install Sharewith Mew folder UY Favorites Reme gt Date modified Type Size E Desktop A Archestr 17 13 2012 1 24 PM File Folder H Downloads J Icons 12 13 2012 1 23PM File folder me Gent Plates di Invensys Systems Inc eac dll 12 9 2011 4 51 PM File Folder Libraries di Invensys Systems Inc RealtimeTrend dll 12 91 2011 4 51 PM File Folder ES Baeumente di Invensys Systems Inc SOLDakaGridlser 12 9 2011 4 51 PM File folder al Music A Wonderware 12 13 2012 1 58PM File folder Pictures A Wonderware Finland IBEditor dll 12 13 2012 10 28 AM File folder K Videos A WAN B i TreecCoptrol dll 12 13 2012 10 28 AM File folder Computer a Local Disk C Z CD Drive D Arcestr 12 13 2012 1 58 PM 12 13 2012 1 35 PM vi Network 6 Delete temp files from C Windows Temp folder 7 Delete from Windows registry all entries that contains GSMCtlrObject o Registry Editor File Edit Yiew Favorites Help Name 2 Be Computer HKEY CLASSES ROOT HKEY_CURRENT_USER um HKEY LOCAL MACHINE Wi HKEY USERS l HKEY CURRENT CONFIG Find what aen bject Find Next Look at Cancel IV Keys IV Values Iw Data I Match whole string only 8 Restart PC GSM Control Object User Manual Ver 2 x Rev 1 10 P068m110 Wonderware Finland amp Baltics GSM Control Object 66 Oct 2011 Nov 2011 Dec 2011 Apr 2012 M
28. GSM Control Object for Wonderware Application Server for M2M remote control in automation applications using GSM communications User Manual Ver 2 x Rev 1 10 PR 000 68 WONDERWARE FINLAND amp BALTICS P O Box 38 FIN 00371 Helsinki Finland tel int 358 9 5404940 fax int 358 9 5413541 info wonderware fi www wonderware fi Qe Finland amp Baltics Wonderware Finland amp Baltics GSM Control Object i Table Of Contents NN 1 GSM modem and accessories E 2 Installing the GSM Control Object ege ergeet 4 Hardware reouirements 4 Software reguitremente 4 en 4 DEE EEE EEE D mn D Getting and enabling license Luse Nede 7 EE Key EE 8 DL 11 Licensing under License Server cccccccecceeceececceccecceceeeceseseeceeseeceeceeeeeseeeseeseusesceseeeeees 12 Getting started quickly with GSM Control Object nnevnnnnvnnnnvnnnnnnnnnnnnnnnnnennnnenene 13 De 13 Getting started in simulation mode without GSM modem copnpected 16 Getting started with GSM modem conpected 20 GSM Control Object configuration in details ee 24 11005165 1 EEE 24 VE A AAA ts sanuneraacuus A A EA A A AAA E 26 Send Receive ta ME 28 A EE 30 Pee E EE 32 Configuration text file mnportiesport 33 Description of GSM Control Object attributes ae NEEN EEN EEN EEN EEN 39 NNN 39 TG E 41 Send Receive Message Attributes ccccccccccecceseescescescecceseuseuseuseescscesceeseuseuseuseseesss 41 Alarm Messace NNN 42 Error and warning E 4
29. Object Window He MN Fal G ra P KI E Aa k 5 Template Toolbox v I El ggf test E Gp Application nalogDevice Boolean FDiscreteDevice FieldReference Float G5MCtrlTest Zlnteoer Sequencer 5QLData string Switch UserDefined G Device Integration ll DDESuiteLinkClient 5 G5MCtrlObject2 ee GSMCtrlObject2 001 el InTouchProxy fl OPCCIient SF RedundantDIObject G System 03 AppEngine AM Area oo PEL InTouchviewAnn Here the GSMCtrlObject2 is GSM Control Object base template GSMCtrlObject2_001 is GSM Control Object derived child template and GSMCtrlTest is test demo object template 3 Create new instances of GSMCtrlObject2_001 and GSMCtrlTest and locate new instances GSMCtrlObject2_001_001 and GSMCtrlTest 001 under Area 001 GSM Control Object User Manual Ver 2 x Rev 1 10 P068m110 Wonderware Finland amp Baltics GSM Control Object 7 W ArchestrA IDE Galaxy Edit View Object Window Help ved rs Gi kd amp 5 A 3 G DE E Template Toolbox a El ggf test GJ Application G3 Device Integration 55 System d i Template Toolbox Los Graphic Toolbox Deployment ggf test O Unassigned Host BS WinPlatform_001 LL AppEnqine 001 5 Oy ME bh GSMctrlObject2_001_001 Oy GSMCtrlTest 001 Now GSM Control Object and test object are ready for configuration deployment and run time
30. aPKG the GSM Calendar Object implementation code the GSM Calendar Object is optional demo object showing in practice how to access the GSM Control Object attributes from Wonderware Application Server environment it is a simple calendar that controls when defined users will obtain SMS messages from GSM Control Object P068m19 pdf User Manual this document Installation steps 1 Copy GSM Control Object files to some folder e g to C GSM Control Object folder Note the following explanation covers the GSM Control Object and the test demo object installation for GSM Calendar Object installation refer to GSM Calendar Object section later in this manual GSM Control Object User Manual Ver 2 x Rev 1 10 P068m110 Wonderware Finland amp Baltics GSM Control Object 6 2 Start the ArchestrA IDE and import the GSMCtrlObject aaPKG and GSMCtrlTest aaPKG files to a new existing galaxy in the further explanation we will assume that a new galaxy test 1s used For Wonderware Application Server versions earlier as 2014 version 4 0 import the GSMCtrlObject aaPDF file instead of GSMCtrlObject aaPKG in this case there is no default configuration provided it should be imported later from default txt file when configuring the GSM Control Object so new derived GSMCtrlObject2_001 template should be created manually After importing three new templates are added to Template Toolbox i ArchestrA IDE Galaxy Edit View
31. act Wonderware Finland Technical Support SMS message is modified or truncated The GSM Control Object does not support long SMS splitting in multiple SMS The sent SMS was modified prior the sending Failed dial voice Number error Failed to make voice call to phone Number Reason Rejecting incomine call The modem received voice call The GSM Control Object hangs all received calls Sro msna Rework mame Old simulated SMS not jet handled The simulated SMS was sent but handling of previous simulated SMS was not finished Please retry send simulated SMS Please enable simulation to use The Simulate Attribute is False Change simulated SMS Simulate attribute in either runtime or by editor Custom message Message not sent The GSM Control Object does not know the Phone number not jet specified Please phone number were custom custom not pre use SendPhone to set phone number configured SMS should be sent Use SendPhone attribute to specify the phone number Failed set Ack item ITEM The Ack item does not have write permission Failed open COM port COMX Error The COM port cannot be opened Check other Reason processes for using COM port or check GSM Control Object User Manual Ver 2 x Rev 1 10 P068m110 Wonderware Finland amp Baltics GSM Control Object 46 Status changed for port Statel to State2 Timeout error when sending AT COMMAND Error response received to command
32. ality like reading saving configuration schedulers validation of configuration and schedulers control of GSM Control tasks are placed inside scripts of GSM Calendar template while adding removing updating selecting any user group member scheduler is controlled by HMI items like buttons lists 99 selectors etc Many data are stored in arrays the UDA names start with Arr_ letters which length is assign dynamically with the exception for schedulers arrays The general rule for arrays is that they are always filled from top the new entry that must be saved in array always goes to the first free place in array from the top If any item from array is deleted then all items below it are moved up GSM Control Object User Manual Ver 2 x Rev 1 10 P068m110 Wonderware Finland amp Baltics GSM Control Object 57 UDAs on graphical panel UDAs attached to the graphical panels helps to understand better the concept and architecture of GSM Calendar Object Arr UsersBelongToSelectedGroup Arr GroupNames Arr UserNames groupMembersSelected readGSMControlC FG GSM Control Object User Manual Ver 2 x Rev 1 10 P068m110 Wonderware Finland amp Baltics GSM Control Object 58 Arr ScheduleStartDate Arr ScheduleStartWeekDayName Arr ScheduleNames Arr ScheduleEndDate Arr ScheduleEndWeekDayName Arr ScheduleActive 3 TeamC 19 00 2011 11 27 R 23 00 2011 11 29 4 TeamD 19 00 Sunday R 23 00 Tuesday hedulerTo From File 5 Night 1
33. alue is c GSMCalendar_schedulers xml GSM Control Object User Manual Ver 2 x Rev 1 10 P068m110 Wonderware Finland amp Baltics GSM Control Object 54 eg ep 2 Team 19 00 2011 11 27 23 00 2011 11 29 A TeamD 19 00 Sunday 23 00 EE 2 Night 19 00 Monday D6 00 Monday 7 Management 14 00 Tuesday BR 17 00 Thursday 08 00 200202 08 00 2017 12 31 08 00 2011 12 02 08 00 2011 12 31 e Date OWeek OF PI Runtime tab The Runtime tab contains information which Users are enabled to receive transmit SMSs The GSM Calendar Object based on its users groups members configuration and added schedulers automatically enable disable Users in GSM Control Object The Users that are allowed to receive transmit SMSs are shown on this list GSM Control Object User Manual Ver 2 x Rev 1 10 P068m110 Wonderware Finland amp Baltics GSM Control Object 55 GSM Control Object User Manual Ver 2 x Rev 1 10 P068m110 Wonderware Finland amp Baltics GSM Control Object 56 GSM Calendar Object configuration in details This section explains how the GSM Calendar Object is built That section should be read by anyone who would like to extend adjust a functionality of GSM Calendar Object to customer requirements General information The code for GSM Calendar Object is shared in two places inside scripts of the object and in many objects scripts buttons properties on graphical HMI panel The main function
34. ate Toolbox GSM Control Object User Manual Ver 2 x Rev 1 10 P068m110 Wonderware Finland amp Baltics GSM Control Object 48 fa Template Toolbox El gar tet ER ET Application B Gad Device Integration DDESuiteLinkClient w w G5MCtrlObject2 GSMCHIObject 001 i f l InTouchfroxy OPCClient s RedundantDIObject Gid KlinkmannProducts RB Gal S5M Control Ge E 55h alendar i ses 4ppEngine Ai Area EX tInTouchviem pp i Fal viewEngine E ZwWiipblsttorm 3 Create new instance of GSMCalendar and locate new instance of GSMCalendar_001 inside GSMCtrlObject2_001_001 object be sure that the new instance of calendar is a child of GSMCtrlObject2_001_001 object 3 Model E w TrainingGalaxy E IG Unassigned Area B EH Area 001 G G5MCtrlObjetz 001 001 i DN CalendarCalendar 001 GSMCalendar gt Dh GSMCtrlTest 001 CR We ControlSystem H AN Plant Ca Deployment E eg Training Galaxy E Unassigned Host ER lal GRPlatform EI f AppEngine B ER Area 001 Ef G5MCtrlobjet2 001 001 i DN CalendarCalendar 001 GSMCalendar i DN GSMCtrlTest 001 k Now GSM Calendar Object is ready for configuration deployment and run time use 4 The GSM Control Object should be deployed at first or together with GSM Calendar Object That order guarantees that GSM Calendar Object can read and initialize all attributes properly 5 For visualization in InTouch it is necessary to create the instance of I
35. ay 2012 Jun 2012 Jun 2012 Aug 2012 Oct 2013 Jun 2014 Jul 2014 GSM Control Object User Manual Ver 2 x Rev 1 10 Rev 1 0 Rev 1 1 Rev 1 2 Rev 1 3 Rev 1 4 Rev 1 5 Rev 1 6 Rev 1 7 Rev 1 8 Rev 1 9 Rev 1 10 Revision History WONDERWARE FINLAND amp BALTICS GSM CONTROL OBJECT Revision History First Release GSM Control Object configuration in details added Description of GSM Control attributes added Error and warning messages added GSM Calendar Object sections added Licensing agreements Files and Installation steps sections modified in Installing the GSM Control Object section Getting and enabling license section modified License tab section modified GSM Calendar Object sections modified GSM Calendar Object section modified the import of Script Function Library IASHelper dll added Configuration text file import export added Alarms selection added to Users configuration tab Configuration import Alarms import progress window added Software Key section modified Reply time out added on GSM Control Object configuration General tab Installing the GSM Control Object section modified GSM Control Object upgrade procedure and GSM Control Object clean uninstall procedure sections added GSM Control Object upgrade procedure section modified P068m110
36. bject is a simple calendar that controls when defined users will obtain SMS messages GSM Control Object It allows to configure GSM Control Object once and then perform the scheduled receiving sending of SMS messages to individual Users based on defined calendar The GSM Calendar Object is a standalone user defined Application Server object together with its visualization control panels that can be shown on InTouch The GSM Calendar Object is a freeware type software that can be modified and copied to achieve special customer requirements it is just an example how to build advanced GSM communication using GSM Control Object Files The GSM Calendar Object installation consists of two files GSMCalendar aaPKG the GSM Calendar Object implementation code the GSM Calendar Object is optional demo object showing in practice how to access the GSM Control Object attributes from Wonderware Application Server environment it is a simple calendar that controls when defined users will obtain SMS messages from GSM Control Object JASHelper dll the Script Function Library used by GSM Calendar Object Installation steps 1 Copy GSM Calendar Object installation files to some folder e g to C GSM Control Object folder 2 Start the ArchestrA IDE create a new galaxy or open existing galaxy Import the Script Function Library IASHelper dll Import the GSMCalendar aaPKG object After importing the new template is added to Templ
37. ble to select certain Alarms linked with this User or enable all configured Alarms are selected or unselected for this User GSM Control Object User Manual Ver 2 x Rev 1 10 P068m110 Wonderware Finland amp Baltics GSM Control Object 28 Send Receive tab The Send Receive tab contains information about all configured Send Receive message palrs GSMCtriObject _001 General Users Send Receive Alarms License Server Object Information Scripts UD s Extensions Graphics SendReceive 5R 1 Receivevessage Send eceive 5R 1 Disabled Leer 10 Items No Mame SendReceive 5R 1 Item1 Reference ls itemi fa5mctrlTest 001 Integervalue P g The following can be entered in Send Receive tab No The index of configured Send Receive message pair The Send Receive with smaller index is processed first The received SMS is handled processed by looking at all configured Send Receive pairs Name Name of virtual primitive containing the configuration attributes for SendReceive messages pair In further explanation this name is referred to as SRName SendReceive SRName ReceiveMessage Contains the Receive message SMS message received by GSM Control text and optionally the values for configured IO items Each configured Receive message content should be unique enough to allow determine it and perform the right processing The placeholders of IO items values can be entered as IO Item Index or
38. derware System Platform environment at another side The GSM Control Object is installed configured deployed and running on Wonderware Application Server environment allowing other Wondeware System Platform software to access to SMS data via GSM Control Object attributes The remote control is based on GSM SMS messaging two direction communication where the GSM modem any GSM modem supporting standard Short Message Service SMS AT commands preferable models are Cinterion MC52i1T MC55iT is connected to the computer s standard RS 232 serial port or to USB port via USB to serial port adapter and GSM cellular phone remote GSM phone is used by remote operator s Also the communication between two GSM modems is supported 1 e remote GSM modems can be used instead of remote GSM phone Basically the data exchange through GSM Control Object can be initiated both from GSM and Wondeware System Platform environments 1 From GSM environment by sending SMS message to GSM Control Object where the received message is checked and processed according the GSM Control Object current configuration The received SMS message can contain some data to be transferred via GSM Control Object attributes to Wondeware System Platform applications e g to other Application Server objects InTouch Historian etc This received SMS message can have the corresponding response message configured also possibly containing data obtained from Wondeware System Platf
39. e following can be entered in Users tab Users No User index User with smaller index number have higher priority if more than one User is selected for sending alarm message Users Name The name of virtual primitive containing the User configuration attributes Users UserName Disabled Controls the User enabled disabled state By default User is enabled Disabled User means that SMS received from this User are not handled and no alarms are sent to this User Users UserName PhoneNum ber Contains User phone number in international format used in AT CMGS and ATD commands Users UserName Priority Contains the Priority of User used only for Alarm messages to specify the order of receiving Alarm SMS in case there are more than one User configured as a receiver and Ack message is configured The Users with smaller Priority value will receive Alarm SMS before Users with greater Priority value For example if for Alarm message there are three Users configured User1 has Priority 100 User2 has Priority 50 User3 has Priority 101 and Alarms AlarmName AckMessage is not empty response Ack SMS is expected to be received from some of Users at first the Alarm SMS message will be sent to GSM Control Object User Manual Ver 2 x Rev 1 10 P068m110 Wonderware Finland amp Baltics GSM Control Object 27 User2 then in case after Alarms AlarmName Timeout there is no response to User1 and then to User3 Alarms Here it is possi
40. emoved renamed Members list of Users attached to the certain group By selecting group name in drop down list Group name in middle area the list below the Members shows currently assigned members Use horizontal arrows to add remove users from selected group Log Message integer value 0 3 that allows to control amount of information send to ArchestrA SMC Logger console Whenever something is changed in GSM Control Object User Manual Ver 2 x Rev 1 10 P068m110 Wonderware Finland amp Baltics GSM Control Object 53 configuration the system sends logs to SMC console It is strongly recommended to open SMC log console and read logs from GSM Calendar Object this is the way which system uses to communicate with operator If LogMessage level is set to 0 no logs will be send to SMC console except errors and warnings Save Read Config Described above definition for Users groups and members can be saved read to from the XML file which location is defined in UDA ConfigurationFilePath default value is e GSMCalendar config xml Schedulers tab The Schedulers tab allow to add update remove definitions of schedulers System allows to define up to 200 schedulers shown on 20 pages The single scheduler contains the group name the same as scheduler name and date time information It is possible to use 4 different types of schedulers 1 Date with exact date and time for start and end This sched
41. endReceive hi LE Simulate chu l Import File Mame Import Export 2 Deploy GSMCtrlObject2_001_001 and GSMCtrITest 001 instances 3 Open the GSMCtrlITest 001 in IDE Object Viewer and select add to watch the GSMCtrlTest_001 Alarm and GSMCtrITest 001 IntegerValue attributes GSM Control Object User Manual Ver 2 x Rev 1 10 P068m110 Wonderware Finland amp Baltics GSM Control Object w Object viewer File Edit View Options Help 8 eh EI Attribute Reference 65MCtrlTest 001 Alarm value EF sf test Attribute Name en WinPlatform O01 WINOS Arte Name List 1 CDEN Ek AppEngine 001 AdviseOnlyA ctiveEnabled true Ed Area O01 Area OG AlarmModeEnum Enable w GSMCHIObjectz Attributes No Dat o G5MCtrlTest 00 715907 _CategoryEnum _ExecutionRelativeorderEnum Externalkame ExternalMame InheritedattrlistNames Internallame _InternalName _ Warnings Alarm Alarminhibik Alarmiode AlarmiodeCmd Enable Area Area 0 Configversion 1 ContainedName Container ExecutionRelatedobject ExecutionRelativedrder Mone Hierarchicalkame G3AMCT Host Area 0 InAlarm False Integervalue 0 Realvalue 0 0 ScanState true al cama AttributeReference SShCtriTest_ 001 Alarm SSM CtriTest_001 Integervalue 4 Modify the GSMCtrlTest_001 Alarm value to True Modify Boolean Yalue NI Reference GSMCtrITest 001 Alarm e True False en TJ me 5 Open if not yet opened the SMC Log Vie
42. following appears in SMC Log Viewer GSM Using demo license License expires at 5 11 2012 9 00 56 AM and GSM Control Object LicenseServer IsLicensed attribute changes to true in case GSM Control Object is deployed remotely Modify String Yalue x Reference G5MCtrlObject 001 001 LicenseServer Chg 04 EC SD 36 46 24 72 50 17 66 75 38 OF 9E 54 05 EF 10 46 46 FO AU CU 00 05 ES 66 7A SF 63 46 C2 GSM Control Object User Manual Ver 2 x Rev 1 10 P068m110 Wonderware Finland amp Baltics GSM Control Object 12 Licensing under License Server To enable the licensing under License Server in case GSM Control Object is delivered as a part of Wonderware Finland Automation Intelligence Suite package the proper Product ID and Product Version should be selected the IP Address and Port of License Server node entered and proper Customer ID entered Customer ID is generated automatically by License Server when the License file kllic file is obtained should be copied to GSM Control Object Customer ID field GSMCtriObject _001 General Users Send Receive Alarms License Server Object Information Scripts Product ID PR 006 81 Produet Version IP Address 159 8 23 41 Port e001 Customer ID HM vEaaQue ubn2r7893 L Sbes4oXtw mwStAEIUIer7vSF3I In case the License Server has a proper license for GSM Control Object the messages like following will appear in GSM C
43. have computer with 2 gigahertz GHz or faster processor 32 64 bit A multi core processor is also strongly recommended The Intel Itanium 2 processor is not supported Software requirements The Wonderware Application Server 3 1 SP3 or later should be installed prior to GSM Control Object installation Licensing requirements The GSM Control Object requires either a software key or a demo license As well it can be licensed under License Server in case GSM Control Object is delivered as a part of Wonderware Finland Automation Intelligence Suite package Without software key demo license or License Server enabled GSM Control Object will support only 1 User and will work only 1 hour after GSM Control Object deployment in run time The demo license is for free and provides an unlimited functionality up to 10 Users are supported but it is valid only for a limited time period After demo license expiration the GSM Control Object will support only 1 User and will work only 1 hour after GSM Control Object deployment in run time The demo license can be obtained by sending inquiry to info wonderware fi The software key should be purchased and it is available for 2 product levels xxx 1s the current version of GSM Control Object release e g 209 Product ID PR00681 xxx maximum 3 Users are supported in run time Product ID PR00682 xxx unlimited version GSM Control Object User Manual Ver 2 x Rev 1 10 P068m110 Wonderware F
44. he order of receiving Alarm SMS in case there are more than one User configured as a receiver and Ack message is configured Send Receive Message Attributes Attribute Data Acces Description Type S Type international format The empty string means any phone number is SendReceive SRName ReceiveMessage String R W Specifies the Receive SMS message pattern in format string item string item If such pattern is received then data is extracted from SMS message text and written to external IAS attributes GSM Control Object User Manual Ver 2 x Rev 1 10 P068m110 Wonderware Finland amp Baltics GSM Control Wonderware Finland amp Baltics GSM Control Object e AN 42 SendReceive SRName SendMessage String R W Specifies the Send SMS message pattern in format string item string The SMS message will be sent in response to received SMS message which matches with ReceiveMessage pattern The item placeholders will be replaced with external IAS attribute values SendReceive SRName Disabled Boolean R W Controls Enable Disable state of this Send Receive pair SendReceive SRName Item Reference String R W Contains external data item attribute name Alarm Message Attributes Attribute Data Type Access Description Type Alarms AlarmName AlarmMessage String R W Contains the Alarm message to be sent from GSM Control text and optionally the values for configured IO items The placeholders of IO
45. ination 18 c NGSMCalendar schedulers xml Scripts The description of script is available at the beginning of all scripts with many comments inside the code GSM Control Object User Manual Ver 2 x Rev 1 10 P068m110 Wonderware Finland amp Baltics GSM Control Object GSM Control Object upgrade procedure l 63 Open ArchestrA IDE and undeploy all Application Engine s that are hosting GSM Control object s 2 Import the new version GSMCtrlObject aaPDF of GSM Control object 3 Close and reopen ArchestrA IDE to update the object editor 4 Deploy GSM Control object host platform to install the software update Deploy all Application Engine s that are hosting GSM Control object s to load the latest GSM Control Object runtime libraries The GSM Control Object current version installed can be find out in Log Viewer w Message Details gy x DEA og 1 tose 2014 07 16 35 03 Message Release 2 16 5309 27640 Build date 7 15 2014 3 21 PM GSM Control Object User Manual Ver 2 x Rev 1 10 P068m110 Wonderware Finland amp Baltics GSM Control Object GSM Control Object clean uninstall procedure 64 This procedure can be used to fully uninstall the object when it is necessary to downgrade to previous object version or to fix GSM Control Object object upgrade issues Note This procedure must be performed on all Wonderware Application Server WAS nodes where GSM Control Object object was
46. inland amp Baltics GSM Control Object D See Getting and enabling license section for details how to get and enable software key or demo license or enable licensing under License Server Files The GSM Control Object installation package contains the following files GSMCtrlObject aaPKG the GSM Control Object standard description file containing the default configuration data and GSM Control Object implementation code this file can be used on Wonderware Application Server 2014 version 4 0 and later GSMCtrlObject aaPDF the GSM Control Object standard description file without default configuration this file should be used on Wonderware Application Server versions earlier as 2014 version 4 0 GSMCtrlObject2 aaDEF GSMCtrlObject2AlarmsPrimitive aaDEF GSMCtrlObject2AlarmsPrimitiveAlarmChildPrimitive aaDEF GSMCtrlObject2ChildPrimitiveStatistics aaDEF GSMCtrlObject2SendReceivePrimitive aaDEF GSMCtrlObject2SendReceivePrimitiveSRChildPrimitive aaDEF GSMCtrlObject2Users aaDEF GSMCtrlObject2UsersUserPrim aaDEF the GSM Control Object definition files used when importing GSMCtrlObject aaPDF GSMCtrlTest aaPKG simple test demo object containing three user defined attributes UDAs default txt the text file with GSM Control default configuration example txt the text file with GSM Control example configuration for illustration of configuration text file import features GSMCalendar a
47. items values can be entered as IO Item Index or IO Item Name and enclosed in figure brackets Alarms AlarmName AckMessage String R W Contains exact characters which should be sent back to GSM Control to acknowledge the alarm IO Items are not supported in AckMessage Alarms AlarmName AlarmItem InputS String R W Specifies name of ource external IAS attribute which non zero value GSM Control Object User Manual Ver 2 x Rev 1 10 P068m110 Wonderware Finland amp Baltics GSM Control Object 43 Alarms AlarmName AckItem OutputDe String R W Specifies name of st external IAS attribute which receives the alarm acknowledgement Alarms AlarmName SendToAll Boolean R W Controls sequence how alarm SMS is sent to selected Users If True SMS is sent to all Users at once When False SMS is sent to Users one by one with Timeout interval until someone acknowledges alarm or AlarmItem becomes False Alarms AlarmName Timeout Integer R W Specifies amount of time in seconds how long to wait for Alarm acknowledge SMS prior sending alarm SMS to next User or repeat the alarm SMS sending Alarms AlarmName VoiceSource String R W Path to sound WAV file which will be played after the SMS sending after a voice call command ATD phone number modem command successful execution If this entry is empty then alarm voice call is not performed Alarms AlarmName Disabled Boolean R W In case True the
48. ject in furher explanation the phone number 37129257257 will be used GSM Control Object User Manual Ver 2 x Rev 1 10 P068m110 Wonderware Finland amp Baltics GSM Control Object 21 GSMCtriO0bject2 001 Users C Users User Disabled rh L Users User Phonekumber 37129257257 LR 1 Useri Users User1 Priority 100 Alarms Select Al Alarm Unselect All 5 Save close the GSM Control Object configuration 6 Deploy GSMCtrlIObject2 001 001 and GSMCtrITest 001 instances 7 Open if not yet opened the SMC Log Viewer and check if messages like following are logged indicating the GSM modem and PIN code in case enabled on SIM card were detected and GSM modem is ready za Message Details E 10 25 2011 2532 39 PM 1456 2640 Info Message GSM Using modem SIEMENS MC35i REVISION 01 03 tv Message Details 10 2512011 2 58 59 PM 1456 8 Open the GSMCtrITest 001 in IDE Object Viewer and select add to watch the GSMCtrlTest_001 Alarm and GSMCtrITest 001 IntegerValue attributes GSM Control Object User Manual Ver 2 x Rev 1 10 P068m110 Wonderware Finland amp Baltics GSM Control Object w Object viewer File Edit View Options Help 8 eh EI Attribute Reference 65MCtrlTest 001 Alarm value EF sf test Attribute Name en WinPlatform O01 WINOS Arte Name List 1 lt A Ek AppEngine 001 AdviseOnlyA ctiveEnabled true S d Area 001 Area 00 AlarmModeEnum
49. key Demo license text Software Key The software key should be purchased and currently it is available for two product levels based on total number of Users configured maximum 3 Users version ProductID starts with PR 00681 and unlimited version ProductID starts with PR 00682 Note the purchased Software Key permits running and deploying Object on single computer You should decide on which computer the GSM Control Object will be used prior of purchase of software key The License Server page shows PC Code string from computer where IDE is running If Object will be deployed on different Platform computer then PC Code will be calculated after first deploy of Object The Product ID will be calculated automatically according to Users count To get and enable the software key GSM Control Object User Manual Ver 2 x Rev 1 10 P068m110 Wonderware Finland amp Baltics GSM Control Object 9 1 If GSM Control Object will be deployed locally then getting and enabling the software key is performed on configuration editor License Server tab e select the appropriate ProductID e g PR 00681 xxx or PR 00682 xxx e copy paste the automatically generated PC Code to e mail or text file or similar and provide the ProductID and PC Code strings when ordering the GSM Control Object product e when GSM Control Object product is purchased copy the received Software Key to corresponding Soft
50. l Object receives SMS message from default User1 default phone number 358777666555 then response SMS message Value 1 will be sent back to User1 where 1 will be replaced with current value of test object attribute GSMCtrl Test 001 IntegerValue for example Value 13 How to get started quickly in simulation mode without modem connected and with modem connected is explained below GSM Control Object User Manual Ver 2 x Rev 1 10 P068m110 Wonderware Finland amp Baltics GSM Control Object 16 Getting started in simulation mode without GSM modem connected The simulation mode is useful to examine the GSM Control Object functionality without GSM modem connected and without real sending receiving of SMS messages via GSM modem In simulation mode the texts of sent and received SMS messages are logged to SMC Log Viewer The following sequence can be used to start quickly with GSM Control in simulation mode and using the default configuration 1 Undeploy if not yet undeployed the GSMCtrlObject2_001_001 instance and in General tab select check the Simulate check box in General tab save close the GSM Control Object configuration GSMCtrliObject _001 General Users Send Receive Alarms License Server Object Information l Scripts l UDAs Extensic COMPort com Baudrate 2600 Bd CharacterSet FINCode Timeout Retries SMSCentrekumber TextMode Disabled Logs
51. larm AlarmMessage Alarmi alarm3 low level Itern1 Alarm2 Alarm3 Alarm4 started Alarms Alarm3 AckMessage Alarms Alarm4 AckMessage ack Alarms Alarm3 AlarmItem InputSource Alarms Alarm4 AlarmItem InputSource fasmctritest 001 Alarm ne 3 asmctritest 001 Alarm pa Alarms Alarm AckItem Reference Alarms larm4 AckItem Reference fesmctrlack 001 ack3 s d an Alarms Alarm Timeout Alarms Alarm Timeout 300 seconds j s seconds Alarms Alarm SendTo ll D Alarms Alarm SendToall Alarms Alarm3 YoiceSource Alarms Alarm4 YoiceSource gt ciwavalarmg way Ci Alarms Alarm Disabled I Ei Alarms larm4 Disabled User User CO user1 O useri User User IO Items IO Items Alarms Alarm3 Item1 InputSource o Alarms larm4 Item1 InputSource 1 Item1 GSMCtriTest_001 Integervalue A ee G5MCtriTest_001 IntegerValue sd Above it is possible to see some configuration features Alarm is linked with both Users User1 and User2 and SendToAll is not enabled so Alarm2 message will be sent to both Users at first to User1 Priority 100 and then in case there is no response during 3 minutes 180 seconds 1t will be sent to User2 Priority 101 acknowledgement SMS messages are expected on Alarm2 and Alarm3 as there are Ack messages and AckItem References configured Alarm3 and Alarm4 messages includes integer value as there a
52. larms AlarmName VoiceSource Here can be entered the optional path to sound WAV file which will be played after the SMS sending after a voice call command ATD phone number modem command successful execution If this entry is empty then ATD command voice call is not executed This alarm voice call option requires computer sound card audio output line is connected to modem audio input line there is separate audio connector socket on the modem Alarms AlarmName Disabled The Alarm message can be disabled from processing by checking this check box Later at run time it can be enabled by using Alarms AlarmName Disabled runtime attribute see Description of GSM Control Object attributes section later in this manual Users Here can be selected the Users linked with this Alarm message IO Items No Indexes of configured IO Items available for inclusion in AlarmMessage IO Items Name Names of configured IO Items available for inclusion in AlarmMessage IO Items ItemName InputSource contains the Galaxy attribute name which value will be read from Galaxy and sent from GSM Control in Alarm SMS message GSM Control Object User Manual Ver 2 x Rev 1 10 P068m110 Wonderware Finland amp Baltics GSM Control Object 32 License Server tab The License Server tab is used to enable the software key or demo license or licensing under License Server GSMCtri0hject2 001 General Users Send Receive Alarm
53. nTouchViewApp template and inside InTouch Window Maker embed the ArchestrA Graphic of GSM Calendar Object instance named Tabbed Display The following steps are required GSM Control Object User Manual Ver 2 x Rev 1 10 P068m110 Wonderware Finland amp Baltics GSM Control Object 49 5 1 Create a derived template of InTouchViewApp ja Template Toolbox E gap tet H E Application e Device Integration i sw Gal KlinkmannProducts 2 ER System ses 4ppEngine InTouchview pp ed tv InTouchvierw pp 001 E viewEngine i E yvinPlatform 5 2 Double click on created InTouchViewApp 001 template InTouchViewApp Initialization dialog will appear InTouchYiewApp Initialization x Please select the source of the associated InTouch application Ce Create new InTouch application Import existing InTouch application InTouch iewsApp Initialization Application name Calendar Object Test I InTouchview application Description wm lt Back Cancel Enter application name e g Calendar Object Test and press Next InTouch Window Maker will start with application opened 5 3 In Window Maker create a new window named e g GSM Control Calendar Object InTouch WindowMaker V0SKARS2TTT INTOUCHYIEWAPP 001 Ee Edit View Arrange Text Line Special Windows Help DD a h Gla a s 3 hes All ule c iZeaag E Classic View A E Project
54. on device COM port where GSM modem is connected Typical names are COM1 COM2 Baudrate Serial communication baud rate in bits per second used to communicate with modem Other communication parameters are fixed parity none stop bits 1 no flow control CharacterSet The name of modem character set used The character set is used to configure modem with AT CSCS command at GSM Control Object runtime start up Default character set is GSM PINCode Place to enter the modem SIM card PIN code in case modem is secured with PIN code Empty field means PIN code is not in use Timeout Reply time out in seconds how long GSM Conrol Object will wait for responses on T commands sent to the modem Retries Number of retries for execution of AT command in case of reply time out from modem SMSCentreNumber Here the optional SMS center number can be entered in case the SMS center number stored on modem SIM card is not suitable If this field is empty default and recommended then GSMControl Objec2 uses preconfigured default SMS center number stored in modem SIM card TextMode If checked AT CMGF 1 command enabling SMS text mode is used to configure the modem As default SMS PDU mode is used and AT CMGF 0 command is executed to use modem in PDU mode Disabled Disables the sending of SMS messages through the modem LogSendReceive Enables logging of modem serial communications to Wonderware ArchestrA Logger Simula
55. oneNumber not handled due to license limitations Acceptable phone numbers LIST Timeout when set PIN code PIN code requested but not configured GSM Control Object User Manual Ver 2 x Rev 1 10 The GSM Control Object has number of Users limitation The received SMS sender in not in the GSM Control Objects internal list of valid phone numbers after the first use of number The number of valid phones cannot exceed the User limit LIST shows locked phone numbers The AT CPIN command timed out PIN code set state is uncertain and further attempts enter PIN code are stopped Please enter PIN code manually e g by using Hyper Terminal Modem requests PIN code but PIN code is not entered in GSM Control Object configuration Further communication with modem is stopped Please enter PIN code or disable PIN code requesting P068m110 Wonderware Finland amp Baltics GSM Control Object 45 Failed set PIN code AT CPIN command failed or invalid PIN was dene PINcode qua configured Further communication with modem is disabled Please configure PIN code manually Invalid response to PIN query e g by using Hyper Terminal PIN1 or PUK code requested The modem is requesting PIN1 or PUK code Further communication with modem is disabled Please configure PIN code manually e g by using Hyper Terminal Failed parse PDU PDU data error The received PDU data is in invalid or Reason unsupported format Please cont
56. ontrol Object node SMC Log Viewer GSM Connected to license server GSM Found license for product PR 006 81 GSM Valid license found and GSM Control Object LicenseServer IsLicensed attribute changes to true More about licensing under License Server please see more in separate Automation Intelligence Suite License Server guide GSM Control Object User Manual Ver 2 x Rev 1 10 P068m110 Wonderware Finland amp Baltics GSM Control Object 13 Getting started quickly with GSM Control Object The easiest way to start and become familiar with GSM Control Object is to use the default configuration supplied within GSM Control Object distribution package Default configuration To examine the GSM Control Object default configuration open the GSM Control Object configuration editor by double clicking the instance GSMUCtrIlObject2 001 001 There are four tabs available for GSM Control Object configuration General Users Send Receive and Alarms The default configuration is provided for purpose to explain the very basic functions 1 sending one alarm SMS message and 2 receiving SMS message and sending response SMS message to same phone number GSM Control Object default configuration contains the following information General tab sd fGSMCtriOhject 001 T General Users Send Receive Alarms License Server Object Information Scripts l UDAs Extension CoMPort com
57. orm applications in this case GSM Control Object will respond with SMS message to the sender 2 From Wondeware System Platform environment when some alarm or event occurs linked with some GSM Control Object alarm attribute In this GSM Control Object User Manual Ver 2 x Rev 1 10 P068m110 Wonderware Finland amp Baltics GSM Control Object 2 case GSM Control Object will send the correspondingly configured SMS message possibly containing also some data obtained from Wondeware System Platform applications to remote GSM operator or device linked to this alarm or event condition The receiver of such SMS message can respond to GSM Control Object for example by sending some acknowledgment SMS message GSM modem and accessories The main function of GSM Control Object is receiving and sending SMS messages For this purpose the external GSM modem must be connected to computer where GSM Control Object is running SIM card holder with SIM card inserted GSM modem 9 9 pin D SUB DB 9 male connector antenna a power supply cable modem cable for connecting 9 pin D SUB GSM modem and computer DB 9 female COM serial port connector The GSM modem and all necessary accessories antenna power supply cable and modem cable are already included in PC GSM SET package provided by Wonderware Finland amp Baltics GSM Control Object User Manual Ver 2 x Rev 1 10 P068m110 Wonderware Finland amp Baltic
58. ray means that based on current date time and start end date time defined for that scheduler this scheduler is active Arr_ScheduleEndDate DateTim R W The length of array is 200 Each item in el this array references to individual schedule definition This array cannot change its size dynamically Contains the end date time for each scheduler Arr ScheduleEndWeekDay String The length of array is 200 Each item in Name this array references to individual schedule definition This array cannot change its size dynamically Contains the day of the week that refers to Arr ScheduleEndDate array This GSM Control Object User Manual Ver 2 x Rev 1 10 P068m110 Wonderware Finland amp Baltics GSM Control Wonderware Finland amp Baltics GSM Control Object 00 Arr ScheduleNames DateTim R W el me TT Boolean a configurationHasChanged GSM Control Object User Manual Ver 2 x Rev 1 10 Arr ScheduleStartDate Arr ScheduleStartWeekDa y Name Arr ScheduleType Arr UserNames Arr UsersBelongToSelecte dGroup Arr UserWillReceiveMessa ge Configuration FilePath 60 string is used when Day of Week type of scheduler is selected The value for this UDA is automatically returned via method date toString dddd The length of array is 200 Each item in this array references to individual schedule definition This array cannot change its size dynamically The array keeps the names of
59. rce lt TAB gt ItemName InputSource The following few formatting rules should be considered 66 99 one row entries should be separated by commas no spaces allowed the row must end with lt CR gt carriage return OD in hex and lt LF gt line feed OA in hex characters the lt TAB gt character horizontal tab 09 in hex is obligatory first one in the lists of linked with User s Send Receive SR messages and Alarm messages for SR Item Name Reference row and for Alarm Item Name Input Source row ROOT entry is the only obligatory entry 1 e other entries can be omitted the data in configuration text file is case sensitive To completely empty the configuration all GSM Control Object instances and templates must be deleted and then new derived template re created When importing configuration or extending the existing configuration with additional GSM Control Object User Manual Ver 2 x Rev 1 10 P068m110 Wonderware Finland amp Baltics GSM Control Object 34 data new Users SRs and Alarms are added to configuration but existing same Users SRs and Alarms are updated with new contents The following explanation is based on example txt the text file with GSM Control example configuration for illustration of configuration text file import features The example txt file ROOT section contains the General information ROOT COM3 19200 GSM 1234 3 358405202000
60. re Item InputSources configured in Alarm4 message it is possible to see SMS message text formatting possibilities new line r n in message text and tab Nt in message text for Alarm4 message the VoiceSource wav file is configured GSM Control Object User Manual Ver 2 x Rev 1 10 P068m110 Wonderware Finland amp Baltics GSM Control Object 39 Description of GSM Control Object attributes This section contains the information about GSM Control Object attributes General Attributes Attribute Data Access Description Type Type Baudrate Defines the COM port baud rate r String Some of character sets supported by your modem COMPort String RW Defines the COM port name eg Boolean R W If disabled then SMS messages will not be sent Last Error String Contains the string describing error or empty string in case recovered from errors LicenseServer Cfg String R W The string where GSM Control Object current licensing information is displayed and can be entered Software Key string like 158f 6d93 5fe0 8cf2 Demo License string like 04 EC 5D 3B 48 2A 72 50 17 68 75 3A 9F 9E 54 05 EF 10 46 4B FO AO CO 00 C5 E5 68 7A 5F 83 46 C2 or License Server licensing data string containing License Server node IP Adress and Port number and CustomerID generated by License Server LicenseServer CustomerID CustomerID generated by License Server LicenseServer IP License Server node IP Adress
61. s GSM Control Object The modem cable 9 pin D SUB DB 9 female connector must be inserted into computer COM serial port socket 9 pin D SUB DB 9 male usually located on the rear panel of the computer caaan Computer COM norts A a H If the computer where GSM Control Object is running has no COM serial port an additional USB to serial port adapter is needed not included in PC GSM SET package and not supplied by Wonderware Finland amp Baltics The adapter must have a 9 pin D SUB DB 9 male connector which must be connected to the modem cable 9 pin D SUB DB 9 female connector computer USB port USB connector USB to serial port adapter 9 pin D SUB DB 9 male connector 9 pin D SUB DB 9 female connector GSM Control Object User Manual Ver 2 x Rev 1 10 modem cable P068m110 Wonderware Finland amp Baltics GSM Control Object 4 There are different kinds of USB to serial port adapters available on the market as a rule also the corresponding USB serial driver software is supplied after installing the driver the new virtual COM port physically using USB port is added to the computer this COM port must be selected in GSM Control Object as a COM port where GSM modem is connected Installing the GSM Control Object Hardware requirements The GSM Control Object has the same hardware requirements as Wonderware Application Server It is strongly recommended to
62. s License Server Object Information Script Product ID PR 00651 215 Product Version 2 15 IP Address Port S001 Customer ID DC Code 2496 7475 8beb fa91 ProductID Ce PR 00651 215 C PR 00682 215 Software Key Invalid key Demo license text For details how to enable the software key or demo license or licensing under License Server please refer to Getting and enabling license section pages 7 10 upper in this manual GSM Control Object User Manual Ver 2 x Rev 1 10 P068m110 Wonderware Finland amp Baltics GSM Control Object 33 Configuration text file import export GSM Control Object supports the possibility to import new configuration or extend existing configuration with additional data from text file or export existing configuration to text file The format of GSM Control Object configuration text file corresponds with content and fields of General Users Send Receive and Alarms configuration tabs The general format of GSM Control Object configuration text file is following ROOT COMPort Baudrate CharacterSet PINCode Retries sSMSCentreNumber Si mulate TextMode LogSendReceive USERS UserName Disabled Phone Priority lt TAB gt sr srnamel sr srname2 al alnamel al alname 2 SR Name Disabled ReceiveMessage SendMessage lt TAB gt ItemName Reference ALARMS Name Disabled AlarmMessage Ack Message AlarmItem AckItem Timeout SendToAll Voice Sou
63. te Enables working in simulation mode when SMS are not sent received but instead logged in ArchestrA Logger The simulation of receiving SMS message can be done by using object runtime attributes Simulation Message Simulation Phone and Simulation Receive see Description of GSM Control Object attributes section later in this manual Import File Name and Import and Export buttons Used to import new configuration or extend existing configuration with additional data from text file or export existing configuration to text file For more information please refer to Configuration text file import export section later in this manual H During the configuration import the Progress window appears where the progress of imported alarms is displayed it is useful in case of great number of alarms in configuration file GSM Control Object User Manual Ver 2 x Rev 1 10 P068m110 Wonderware Finland amp Baltics GSM Control Object 26 x Importing alarms 54 of 100 Cancel The imprting can be cancelled by pressing Cancel button at next import of same file the import of alarms will resume from interrupted state Users tab The Users tab contains information about all configured Users GSMCtriO0bject2 001 Users C Users User Disabled Zy k 1 Leer Users User PhoneNumber 358777666555 Users User Priority 100 select All Alarmi Unselect All Th
64. uler lasts constantly for the whole time between defined start end date time Look on the picture below at scheduler No 1 2 Day of Week with exact start and end time described by days of the week This scheduler is very similar to the first one but instead of exact date here is the day of the week Look on the picture below at scheduler No 2 3 Recur Date this is a recurring date scheduler that starts every day between start end date from start time to end time On HMI panel such schedulers are marked with additional R inside the cycle image Look on the picture below at scheduler No 3 4 Recur Day of Week same as Recur Date but instead of exact date here is the day of the week Look on the picture below at scheduler No 4 Each week starts on Monday the 24 hours format is used for time and the date format is YYYY MM DD The start date time must be before the end date time exception is allowed when days of the week are used When start date is e g Friday and end date is Monday then it means that scheduler lasts constantly to the end of week and then to Monday all together Friday Saturday Sunday Monday It is possible to select any of existing scheduler and change its type or date time and update the existing one or add a new one or delete it Save Read Schedulers Described above definition for schedulers can be saved read to from the XML file which location is defined in UDA schedulerFilePath default v
65. user phone no Start ST EEE ae r GSM G legdar obje SM Cachet 1 5 Update phone ZA Finland Read Conf Save Conf DEE E Gett onthtestontfy Update Remove _ fim pss C GSM Control Object User Manual Ver 2 x Rev 1 10 P068m110 Wonderware Finland amp Baltics GSM Control Object 51 5 6 Start InTouch Window Viewer and GSM Control Calendar Object window will appear in initial state only Users currently configured in GSM Control Object are available O InTouch WindowYiewer V OSKARS2 TTT INTOUCHYIEWAPP 001 GSM Control Object User Manual Ver 2 x Rev 1 10 P068m110 Wonderware Finland amp Baltics GSM Control Object 52 Members tab The Membere tab contains three main sets Users Groups and Members On this tab you can create and configure groups and their members TechnicalSupport SE nt 4 User names area is a list of Users defined in GSM Control Object This is the list of people that will receive SMSs and are allowed to respond to GSM Control Object This list must be exactly the same as the list of Users in GSM Control Object To import current definition of Users from GSM Control Object use the Import users from GSM Control button Group names area is a list of defined in GSM Calendar Object groups The group Is a set that contains some Users The group definition is used to set schedulers inside calendar Group items can be added r
66. ware Key tab field and check that it is evaluated as Valid Key as well GSM License OK message should appear in SMC Log Viewer 2 If deploying GSM Control Object remotely to other computer then getting and enabling the software key can be done after GSM Control Object was deployed e open the remotely deployed GSM Control Object in the IDE Object Viewer e select the appropriate product version by modifying the ProductID attribute PR 00681 xxx or PR 00682 xxx Modify String Yalue x Reference G5MCtrlObject2 01 2 ProductID PR 00687 215 e redeploy the remote GSM Control Object e select the LastError attribute in the IDE Object Viewer and open it for modification Modify String Yalue x Reference G5MCtrlObject2 01 LastError Enter LicenseServer Cfg value For product ID PR 00682 215 PC Code seede de regel GSM Control Object User Manual Ver 2 x Rev 1 10 P068m110 Wonderware Finland amp Baltics GSM Control Object 10 e copy paste the Product ID and PC Code to e mail or text file or similar and provide the ProductID and PC Code strings when ordering the GSM Control Object product note PC Code is generated based on earlier entered ProductID attribute e when GSM Control Object product is purchased copy the received Software Key to GSM Control Object LicenseServer Cfg attribute Modify String Yalue 1 x Reference G5MCitrlObject2 _
67. wer the message about the simulated message alarm sent to 35877766655 is logged GSM Control Object User Manual Ver 2 x Rev 1 10 17 P068m110 Wonderware Finland amp Baltics GSM Control Object 18 Message Details 29345 Message 10 24 2011 diteda PM 2076 SoM Simulated sending SMS to 358777666555 Message alarm 6 In Object Viewer modify the GSMCtrlTest_001 IntegerValue value to 13 Modify Numeric Yalue NI Reference G5MCtrITest DO Irtegeryalue mg value er em 7 Modify the values of special Simulation attributes Options Help Attribute Reference Engine 001 Area O01 Area DU Se GSMCtrIObjectz G i GSMCtITest DO Attribute Name SendReceive Externalame SendReceive Internalame SendReceive 5R1 Cfgbata SendReceive HI Externallame SendReceive DI Internalkame SendReceive 5R1 Disabled SendReceive SR1 Dem ExternalName SendReceive DH 1 Item Internallame SendReceive 5R1 Item DataType SendReceive 5R 1 Item ReadSkatus SendReceive DPI Item Readvalue SendReceive 5R 1 Item Reference SendReceive 5R1 Item ReferenceSecondarv SendReceive SRL Item MWriteSkakus SendReceive HI Item1 Writevalue SendReceive SI ReceiveMessage SendReceive DI SendMessage SendSMS ShortDesc SignalQuality Simulate Simulation Message Simulation Phone Simulation Receive GSM Control Object User Manual Ver 2 x Rev 1 10 a5MCtrIObject

GSM-Control Object User Manual

Contents

Download Pdf Manuals

Related Search

Related Contents