Home

TBoxMS - User's Guide

1. Timer Counter Special Regstes with quantity 16 ModBus addresses and quantities must be multiple of 8 When working with digital variables DIV DIR you have to use multiples of 8 for quantity address of the Tag and Address in External Source Version 2 07 N TWinSoft User s Guide 125 Address The ModBus address must be typed according to the indication of the user s guide of the Remote device Communicating to TBox MS you have to refer to the TWinSoft application and its configuration of Tags 13 4 Remote Tags through modem With a remote device accessed by modem the connection must be first established using an Alarm The sequence is the following e Create a Remote Device associated to the communication port of the modem and to a Trigger DIV digital register always active e Create the Remote Tags associated to this device e Create an Alarm Recipient of type ModBus Master with the telephone number of the remote device e Create an Alarm Condition associated to the event requiring communication with the Remote TBox and to the Recipient created above e When TBox needs to communicate generate the alarm condition e When modems are connected can be checked using the communication variable DCV Comx Call and Trigger is active see above Remote Tags associated to this station will be executed e Acknowledge the alarm for instance using the special analog variable A
2. T TWinSoft manualUK_1004 tws Tags Sele fd File Edit View Communication Tools Window Help Dg E 4 e ee X IE z m EN S oh Marne Value Address Comment RATUZ Add a tag Timers Els Resources Scaling Io Pump Ce Card 1 M5 PS230 l Start Button Hal M5 CPU16E TL Stop Button 1 AE Card 3 M5 COMBO 14 L Emergency J System variable JL Trigger RT Timers TL Motor 1 Counters JL Motor 2 _ IP Parameters L Pump 1 CI Pragrams TL Pump 2 i Alarms TL _30minutes DIVODODS Conditions J Flow Pumpi AIVOOOUZ Recipients JL Intrusion D DL3 0 7 Digital Input 7 Recipient Groups J Level 41 3 2 0 Analog Input 0 Messages JL e aM DIVOOOOG C Time Slices Holiday s Timetables H E Data Logging J Remote Tags Periodic Events 9 High Speed Tags CJ Web amp Report Files DI 3 0 0 Digital Input 0 DI 3 0 1 Digital Input 1 DI 3 0 2 Digital Input 2 DIVvan u4 DOo 3 1 8 Digital Output amp Do 3 1 3 Digital Output 9 DoO 3 1 10 Digital Output 10 DO 3 1 11 Digital Output 11 l d 3 d 3 D H B g Dik ry E So c Er FEI c E E E Ready TBoxMS The programming of a TBox MS application will be done in different steps Configuring the RTU properties Adding of the Cards and Remote device from the Resources Creating Tags Creating Programs using automation language Ladder and or BASIC Creating Alarms Creating Datalogging Creating Remote Tags if you have to exchange data with a Remote device
3. COM4 PSTN MODEM COMS H5232 485 GSM MODEM H5232 485 Head SMS protection Le Pan A mmt m E dmi de d un mn NZ DE aee T m E oe et a See a KE at Kat mm QI i If ReadSMS protection is activated a login is required in the SMS message The login is composed of the last 8 digits of telephone number of the mobile used to send the SMS and a password To obtain the Password the utility Password Generator is needed Start gt Programs gt Techno Trade Accessories Password generator From the Password utility you define the global code used in the RTU as NAME the last 8 numbers of the telephone number of the mobile to which the alarm message will be sent as Access Level Engineer Level 3 The resulting PASSWORD must be used to login Syntax Ppassword Example P1568 If needed the Password must be declared first Acknowledgment with code A does not require password 6 Acknowledgment A See chapter 11 2 above Version 2 07 N TWinSoft User s Guide 113 7 SET a digital Tag S You write 1 to a digital Tag using its ModBus address Syntax Smodbus address Example S32 WS e 99 Tag at ModBus address 32 will be set to 1 ReadSMS checks the access protection level of the port before writing see point 5 above and also the Write configuration of the Presentation of the Tag see chapter 8 4 8 RESET a digital Tag R You write 0 to a digital Tag using its Mo
4. EM CR OR ET eS La S FOE L R E TwinSoft wW Www cse semanphore com TWinSoft User s Guide cc Fe GC Disclaimer Every effort has been made to ensure the accuracy of the information in this guide However SEMAPHORE assumes no responsibility for the accuracy of the information Product information is subject to change without notice Windows 95 98 NT 2000 XP are trademark of Microsoft Corp Internet Explorer is a trademark of Microsoft Corp Copyright 2004 2009 by SEMAPHORE Dr ve Richelle 161 B 1410 Waterloo Edition May 8 2009 TWinSoft version 10 04 Author Jean Burton Version 2 07 a TWinSoft User s Guide 2 Important Safety Instructions Read and understand all instructions Save these instructions e Read the instruction manual carefully before using the equipment and comply with the instructions that it contains to avoid mistakes and to prevent any personal injury or damage to property e Warning It is mandatory that this equipment is earthed by the rack Connect the crimp terminal ring to the earth with a stranded wire between 1 5 and 2 5 mm inclusively The cable must be crimped consistent with rules of good practice Connecting only the earth on the power connector is not permitted e Installation must be carried out by suitable competent personnel according to the steps and stated specifications described in this manual e Use only the approved color coded wires for c
5. In order to have a reliable communication you have to increase some timing parameters in TWinSoft menu Communication gt PC Setup select Ethernet and click Advanced Advanced Parameters Comm Timeout DUU rnillisec Change Comm Timeout to 5000 millisec or higher Inter Frame Gap millisec Allow Interframe Gap 100 ms an Ether el Mot recommended Change Inter Frame Gap to 100 millisec Identification delay 4 sec Modem connections address settings point 3 Before sending a program through GPRS check the TCP IP PC setup settings like explains chapter 4 3 2 IP Version 2 07 a TWinSoft User s Guide 58 7 3 Communication Variables Communication variables are dedicated registers providing different status of the communication It is very useful for controlling the connection and the access level authority Those variables are divided into 2 tabs the Digital Communication Variables DCV and the Analog Communication Variables ACV When you need one you double click it from the list and declare it as a Tag It becomes then available in any feature of TBox MS 7 3 1 Digital Communication Variable F Tag ppe e N Name COMx NoReply COMx HookLink Version 2 07 Parameters DOY ADV lt COM4 MoR eplp lt COM4 HookLink gt lt COM4 Call lt COM4 Answer lt COM4 NoDialb lt COM4 GFR S Cor COM 4 MadbusH
6. VVVVVV WM The sequence in which those tasks are executed is not fixed but at least RTU properties Resources and Tags should be configured first as being required for all other programming All those configurations are explained in the following chapters Version 2 07 a TWinSoft User s Guide 32 6 RTU properties Setting the properties of the TBox MS has never been so easy thanks to a set of comprehensive dialog boxes available from the main tool bar RTU properties can be accessed easily by clicking this icon The RTU properties are divided into Advanced RTU Properties General Driver Security Info the type of the RTU telephone number RTU location size of the chronologies to execute specific task or to communicate with other protocol than General configuration of external software modules written in C used Drivers Add ons standard ones to type any info about your program its different versions for some features advanced parameters are available during start up Info when sending alarms about sampling tables TCP IP Advanced Communication ports are configured from the Resources General TCP IP configuration is done from the Workspace and folder IP parameters TWinSoft User s Guide Version 2 07 6 1 General properties RTU Properties qm General Drivers Security Info Advanced Identification ATL type Tou MS CPUTE w
7. as Group 2 LAT 200 ladni nre ee mast ns Example with MS CPU16 Communication ports tabs Depending on the type of communication port RS232 RS485 modem or Ethernet different tabs are available general parameters local or modem Baudrate Protocol DCV Digital Communication Variables Special variables with a pre defined function communication error modem online see chapter 7 3 Parameters ACV Analog Communication Variables Special variables with a pre defined function time out user ID see chapter 7 3 mainly timing parameters required when CPU is Master or Slave in a Advanced ModBus communication TCP IP TCP IP configuration dedicated to the communication port when available To enter the configuration of the communication port double click the port in Group 0 Serial port configuration COM1 R5232 Edi Advanced TCF IP Parameters DEY ADV Baudrate 200 115200 bps Data bits 7 or 8 eee Parity None Odd Even See ils Stop bits 0 1 or 2 Te Te 3 Protocol ModBus RTU ASCID Zeg Printer NMEA PPP SLIP Nas ctis a n a doa idle Example with COM1 RS232 TWinSoft User s Guide 47 Version 2 07 JS eee Mo Ethernet configuration MS CPU16 MS CPU32 TCPAP pCv ACY Advanced amp TCPAP pcv acy Advanced f i 3 Obtain IP address automatically f 4 Use IP address Ip address IP addre
8. zLUMA MaedemE rr zLUMA MaedemFo COM 4 Madem l a mit elim a E COM4 GSM MODEM GPRS According to its function a Communication variable is Read Write or Read only Advanced TCP IP d a 4 Address Comment d NoReply l No Reply i HookLink Modem Off Hook Ethernet Links In the following table the Call Modern Online Call column R W indicates Ms SUME Aneuwer 1 Read only ola a Dialtone e GPRSCon GPRS Connect f D Sau o MaodbusHesp Modbus Response 1 Write 1 only Modern rror Modern Error x Write 0 or 1 ModemPower Modern Power 1 Modem larm Modem Alarm j p A noni alll a MAN pell dh ZS ERA a Example with COM4 GSM modem R W Description 0 Communication SET by TBox MS in case of communication error The possible errors are Timeout ModBus Unknown address wrong quantity CRC error TCP IP wrong closing of socket Must be RESET by the user Modem Reading 1 indicates a dial up modem has picked up the line and is connecting to another modem The success of the connection can be checked using the Connect variables see below In GPRS mode the value is maintained at 0 Writing 0 forces a hardware reset of the modem Writing 1 forces the modem to hangup and a GPRS disconnection Ethernet Reading 1 indicates the Ethernet is connected to a device hub switch PC us Writing O or 1 forces a reset of the
9. 2 System Analog Variable 40 AlaPop3 indicates the number of alarm needing to be acknowledged by POP3 connection and 43 Pop3State indicates the state of connection 3 If escalation is required Group of recipients can be associated to the alarm condition 4 Like other alarms failure in sending SMTP alarms can be checked using System Digital Variable 06 AlaErr and System Analog Variable 10 AlaRec 5 Error in POP3 connection can be detected also using System Digital Variable 748 POPS3Err Version 2 07 CE wx x TWinSoft User s Guide 88 9 5 NTP Server NTP stands for Network Time Protocol an Internet standard protocol built on top of TCP IP that assures accurate synchronization to the millisecond The NTP Server represents a server dedicated to time synchronization First TBox MS connects to Internet through a connection ISP Ethernet or GPRS and then to the NTP Server HTE Parameters Server name windows Server address Hime WIndows com Example with a connection to Windows server through Ethernet Examples of Servers time windows com europe pool ntp org You will find valuable information like lists of Servers with open access at www ntp org gt public time server list The organization pool ntp org proposes servers using DNS round robin which make a random selection from a pool of open access time servers This is good enough when working with TBox MS Round Robin DNS technique is us
10. Type absolute You select a specific period of time in the past Version 2 07 N TWinSoft User s Guide 161 Example 1 with all levels and all classes SH Trace log 30 11 2007 11 02 53 3071172007 11 01 51 30 11 2007 10 55 27 3071172007 10 53 27 3071172007 10 58 44 2971172007 17 01 06 2971172007 17 01 06 2971172007 15 53 20 2971172007 16 53 12 2971172007 16 55 12 23 11 2007 16 53 12 2971172007 16 55 05 23 11 2007 15 53 08 23 11 2007 15 53 08 23 11 2007 15 53 08 23 11 2007 15 53 08 23 11 2007 15 53 08 23 11 2007 15 53 08 23 11 2007 15 53 08 23 11 2007 15 53 08 23 11 2007 15 53 08 23 11 2007 15 53 08 23 11 2007 15 53 08 23 11 2007 15 53 08 23 11 2007 15 53 08 23 11 2007 15 53 08 23 11 2007 15 53 08 23 11 2007 15 53 08 Error Error Error Verbose Verbose Verbose Verbose Verbose Verbose Verbose Verbose Verbose Info Wang Verbose Verbose Verbose Verbose Verbose Info Verbose Verbose Verbose Error Info Verbose Verbose M D d h We Modbus Modbus Modbus Modbus AT Modem Modbus Modbus AT Modem AT Modem AT Modem Modbus System System Unused Unused System System System System System System System System Addons Addons HTTP Modbus Messages Modbus TCP connection accepted Handle 18 Modbus TCF read eror Connection reset by peer Open file Unable to open opt thbas etc TBos amp pp tpg made r No such file ar direc Open file Unable ta open apt thbas etc TBoasSpp tpg made r
11. the Setup the following software s are available Techno Trade Master Setup S A Install a Product AYY TWinSoft10 0 WebForm Viewer c RM xxx Configurator 3 1 TBoxMail o DreamWeaver Trial Version ReportStudio for DreamWeaver ETIN Acrobat Reader Visit the TBox Home Page Explore this CD ROM SS Exit e TWinSoft 10 xx TWinSoft is the software required for developing an application for the RTU The basis for configuring a RTU application is explained in this manual Installation of TWinSoft includes gt WebForm Studio HTML editor dedicated to RTU gt Report studio Report editor dedicated to RTU gt WebForm Viewer X ActiveX and TBox MS dialer from Internet Explorer see next Administrator rights are required during installation e WebForm Viewer This software contains the tool TBox Dial It used to dial TBox MS with Internet Explorer It also contains the Activex used to display objects dedicated to the RTU It must be installed on the PC used by a operator to dial TBox MS with Internet Explorer when TWinSoft is not required Administrator rights are required during installation e RM xxx Configurator RM are Remote Modules based on TBox LITE architecture They are programmed though an interface running TWinSoft in background This entry installs this interface Administrator rights are required during installation Version 2 07 N a TWinSoft User s Guide 17
12. 2 1 10 11 Unknown command gt JJ J O 12 Equality character not found or incorrect 20 21 30 Eon at m d D Incorrect password Incorrect password or not supplied for a com Port protected Message received does not match a predefined message Writing to an unknown address 32 Writing to an unknown address using indirect addr address contained in the Tag not known 1 2 10 11 12 20 21 30 31 32 33 33 Changing the telephone number of an unknown recipient Version 2 07 N a TWinSoft User s Guide 115 12 Datalogging NB 12 1 Introduction c XN Datalogging allows memorizing values of your process in order to visualize its history TBox MS contains memory for recording historical values of Tags and events see technical specifications the latter is what we call the database of TBox MS There are two categories of databases The Chronologies Chronologies are On event recordings by mean of changes in Tags also known as Sequence of Events Each event is recorded with the time date Tag and its status or value Example of digital event 0 The status changes of the Tag represent the events Example of analog events The variation of the Tag represents the events TBox MS stores chronologies in 2 tables one for digital events and one for analog events The size of the tables are d
13. Acknowledgment will be executed in 2 steps 1 The sending of the message by the TBox MS to the SMS C or to the e mail provider will be first performed Retries and time out defined in the recipient will be used to 2 Then a second time out defined in the advanced Alarms properties will check if the determine the success or failure of this phase incoming SMS required to acknowledge the alarm arrives on time Head SM5 RTU Properties General Drivers Security Info Advanced Advanced Parameters This page contains advanced parameters Extreme care should be taken when changing these parameters IF you feel unsure about the changes you are doing Compatibility Coa Bisi d Web and Report Environment Variables Startup Power Fail Alarms sampling Tables Temperature Remote Tags events use the Default button to restore the default parameter values Event stack size Alarm stack size alarms SMS Acknowledge timeout min di ee A atm o tm T TWinSoft User s Guide Version 2 07 The incoming SMS must arrive within this time out for the alarm to be acknowledged If not a retry will be executed according to the definition in the Recipient After the end of retries the alarm will be considered as in error auto ack and the system variable AlaErr at 1 Working with Group of Recipients with option Call all recipients all recipients have to a
14. Card 1 M5 PS2304 Card 2 MS PSTN EY Group D iz COM Card 3 IMms 18DTi The numbering of communication ports starts at COM4 or COMS according to the ports available in the CPU The numbering is automatically incremented at each insertion of a communication card COM4 PSTH MODEM Parameters DOY ACY Advanced TCP IP To enter the configuration of Modem Type the modem double Initialisation W1x48D2 C0 N 30047 TISB3 GCI BA click the modem port li Group ancien Auto Answer Ringla Debug Modem Example with COM4 PSTN modem Modem type It cannot be changed It corresponds to the modem of the card Initialization The initialization string is sent at power up of the modem and after each connection You should not change it but if changed it is saved in the TWinSoft document Version 2 07 a TWinSoft User s Guide 52 Outside line prefix if TBox MS is placed behind a telephone switch PABX it is the number to get the outside line This prefix will be applied automatically each time TBox MS dials out Default Initialization and prefix can be modified from the file ModemProfiles xml Changes will be applied to all new document created Auto Answer Number of rings after which the modem will go off hook Debug Modem working with MS CPU16 Allows displaying all communication flowing through the modem Very useful to debug a communication see details in Appen
15. Example when a user is connected you can modify its level access by writing a value in the register COMx level level available 0 1 2 or 3 Those values can be stored in analog chronology for keeping a history on the access When a user disconnects Logout the register returns to OU Modem global time out for hanging up the modem when there is no communication Correspond to the Inactivity time out in the Advanced properties of the modem GPRS indicates the status of the GPRS connection Value 0 disconnected Value 1 currently connecting Value 2 connected Value 3 currently disconnecting see above for more details GPRS this register gives the IP address used by TBox MS during its GPRS connection The information is available in a DWORD It can be displayed in the list of Tag as IP address see context menu on the Tag Display as GSM The quality of the GSM signal The range of the value is 1 to 31 The value should be minimum 18 to be considered as an acceptable signal level PSTN Voltage on the line 20 GSM associated to the GSM can be used to check the status of ReadSMS see chapter 11 Modem Read indicates the number of RING before the off hook Write 0 no off hook Write 1 force off hook at the next RING MODEM gives current status of the modem Possible values are 1 PIN code sent GSM only when PIN code activated 2 Wait after PIN code is sent 4 Init string accepted 7 Idle mo
16. GPS quantity of satellites detected by the MS GPS Must be of minimum 3 Or even 4 to expect a good precision Modbus variable 16 bits each representing a COM Port from 1 to 16 The bits corresponding to the Ports in ReRouting are at 1 the other at 0 Can be use to set the mask TWinSoft User s Guide 65 Index Name 32 MasterEr 33 Cargnrer 34 CPUusage 35 SerialNb 36 CPUmode 37 Opensock 38 Gpsspeed 39 GpsRoute 40 AlaPop3 41 EvenCur 42 HardRev 43 Pop3State Version 2 07 R W Description Communication indicates the last station ID modbus address in communication error Once an error has been detected the value is maintained until next error Usually communication errors can be solved by modifying the time out available in the Advanced tab of the communication used End of Fame Detection IFG Rx Time out To trace error we advise you to reset the variable and check it when it is different from 0 When this happens you can handle it in your process and reset the variable that it is ready for the next error System this variable indicates card s in error Each bit of the variable corresponds to a card bit 0 CPU bit 1 card 1 The test is carried out at the starting of TBox MS and it indicates discordance between cards declared in TWinSoft and cards placed on the Rack card s not present or different Low Power Not available with TBox MS Used with Low Power RTU only Hardware indicates the seria
17. Ma such file or direc Modbus TCP connection accepted Handle 18 AT Modem installed on port 4 Modbus ATU installed on port 5 Modbus TCF connection closed Port 4 gt Receive ERROR Port 4 Receive 47 CREG Port 4 gt Send AT CREG Modbus TCP connection accepted Handle 18 Of I running 1 ms to create plug and go Failed mounting volume Ma such device or address mount SD card background operation create plug and go background thread started communication thread started start main loop Thread pri max 99 min 1 bz ms to initialize set background thread set com thread set main thread unable to open apt thox ete Dnp3 ml Try to load Dinp3 protocol HTTP server listening on port OU Modbus TCP server listening on port 502 TBox MS32 can store 64 kbytes of data for Trace Log When newer data replace older data this amount is reached Example 2 modem connection SH Trace log 30 11 2007 11 09 14 3071172007 11 09 14 30 11 42007 11 03 14 30 11 2007 11 03 14 3071172007 11 09 14 3071172007 11 03 14 3071172007 11 09 14 3071172007 11 03 14 30 11 42007 11 08 53 3071172007 11 08 53 3071172007 11 08 53 3071172007 11 08 53 3071172007 11 08 53 3071172007 11 08 53 3071172007 11 08 53 3071172007 11 08 53 3071172007 11 08 54 30 11 2007 11 08 54 30 11 42007 11 08 54 3071172007 11 08 54 3071172007 11 08 43 3071172007 11 08 43 30 11 2007 11 08 43 3071172007 11 08 43 3071172
18. The New Document Wizard helps you getting started with a new application by gathering information about your hardware and some basic configuration Except for the Type of RTU all settings can be modified later from the RTU properties According to the hardware you have select the corresponding type of RTU Hew RTU Document Wizard Welcome This wizard helps you get started faster by gathering information about your ATU You cannot change it later Please select the type of your ATU o LI TBos CPUS Fal TBo M5 CPUTG TBoxM5 CPUS2 m x TBosLT i Low Power Mew RTU Document Wizard Station Name RIU Free name of the RTU Modbus Address 1 Station address 1 254 SubAddress Sub address 0 15 Required for off line OS Version 03 18 compilation of the program only a el T Hew Document Wizard ATU Ethernet card IP Address ER 166 1 99 Subnet mask 255 255 255 D i IP configuration of Ethernet Prefered DNS 0 0 0 0 Esas ut Version 2 07 N TWinSoft User s Guide 21 4 2 Communicating with TBox MS Once you have opened a document either a new one created with the Wizard or an existing one you can establish the connection with your TBox MS The possible communications are serial Ethernet or modem according to the media used to connect to TBox MS Serial check the Baudrate you have given to the serial port in your application by
19. To Hour Byte To Min Byte Alarm Holidays Parameter Tag Format Day Byte Month Byte Year Word 8 5 2 Datalogging Parameters Chronologies Condition Parameter Choice Tag Format Inhibition 0 enabled Byte 1 disabled 2 power fail 3 DisCra DisCrd Variation analog Byte or Word or DWord or Float Version 2 07 TWinSoft User s Guide 78 8 5 3 IP Parameters ISP Parameter Tag Format Phone Number Text User Name Text Password Text FTP Parameter Tag Format Host Text TCP Port Word User Name Text Password Text SMTP Parameter Tag Format Server Text TCP Port Word E mail From Text Authentication Bool Login Text Password Text POP3 Parameter Tag Format Server Text TCP Port Word Authentication Bool Login Text Password Text NTP Parameter Tag Format Server Text Version 2 07 pg peer uu TWinSoft User s Guide 79 9 IP Parameters IP parameters consist in the global configuration for connecting to an ISP dial up connection gt sending files FTP gt sending e mail SMTP reading e mail subject POP3 Time synchronization NTP gt DynDNS handling of public dynamic IP addresses Concerning IP configuration of Ethernet card refer to the mg corresponding card in the Resources Concerning IP configuration for incoming calls WebServer see advanced RTU properties gt
20. converter USB R S232 e TCP IP to establish a communication in TCP IP typically through the Ethernet port of TBox MS TWinSoft will establish a connection with the IP address of the Ethernet port of the CPU see chapter 7 1 CPU resources From this PC Setup menu it is also possible to specify another IP address for instance if communicating to another Ethernet port or through GPRS See details chapter 4 3 2 below e Modem to establish a remote connection to the TBox MS TWinSoft takes full advantage of Windows built in modem support simply install your modem in the control panel s Modems applet of Windows and you are ready to call your TBox MS You can develop your TWinSoft document without connection to the TBox MS but it will be mandatory to send it to have the RTU running The program can be sent through RS232 RS485 Ethernet or modem Version 2 07 SS TWinSoft User s Guide 23 4 3 2 IP address settings in TWinSoft PC Setup You may encounter three different situations requiring specific IP address settings 1 You program you TBox MS through Communication Properties Ethernet and you want to keep its IP 3 Offline address ee a Local R5 232 PC Seral Part BaudHate lL TCPAP Ethemet IP Address 192 1581 98 ATU CCIM3 You select in the drop list of IP addresses T 182168 1 88 ATU COM3 the one corresponding to the RTU TWinSoft T 152169 2 99 ATU COMA is conn
21. see RTU advanced properties Version 2 07 CA wm Gm s TWinSoft User s Guide 154 Appendix G Debugging tools G 1 Modem debugging with MS CPU16 The debug mode allows displaying all data flowing through a modem This is very useful when encountering problems in modem communication The Debug mode is set to the RS232 port associated to the modem For example if you have a GSM on COM4 that you wish to spy Debug mode will be set to COM5 Sequence to set a modem in Debug mode COMS RS232 485 Parameters DOW ACY Advanced TCP IP 5 Local Baudrate 1 Modem Data bits Change first the Baudrate of Parity the RS232 port associated to the modem to 115200 Bps dui COMB in this example S Leave the protocol setting to RTS ETS Flow control ModBus RTU Example to debug a GSM on COM4 COM4 GSM MODEM Parameters DEY ACV Advanced TCP IP Modem Type PIN Code Afen 2 In the Modem parameters LL check the option Debug Modem COM5 in this example COME Luce al ae err emer MI Example to debug a GSM on COM4 Version 2 07 S sz TWinSoft User s Guide 155 COM5 LET E ke Unavailable It is very important you change first the Baudrate of the RS232 port BEFORE activating Debug EISEN mode When the latter has been is LLommiunication Port i unavallable It Is used tor the L ebug Mode set the RS232 port is not available anymore as you can see Send
22. 00 AM the changing of week happens at January 1 whatever day it is if January 1 is as Friday Saturday or Sunday there will be two Week 1 Examples 7 5 Timers amp Counters Timers and Counters are described in the manual 4 BASIC amp Ladder for TBox TWinSoft User s Guide Version 2 07 67 8 Tags A Tag is essential for any programming An alarm is conditioned from a Tag The Datalogging mechanism records values of Tags BASIC Ladder logic executes a process by handling Tags Any variable of the TBox MS that you want to use in any configuration has to be declared as a Tag There are 4 types of variables e The Physical I O DI DO AI AO e The System Variables predefined analog and digital functions e The Internal variables digital analog and Text aka Registers e The Communication Variables digital and analog The Tags are gathered in the folder Tags of the Project Workspace Zu TWinSoft envoi e mail tws Tags L Toi id File Edit View Communication Tools Window Help D cm Bl z xl Value Address Comment E ios LT i Hi Tags GROUP of Tags Timers C Timers i L Start Button H Resources 2 JL Stop Button H E Programs H Alarms H E Data Logging _ Remote Tags 1 Periodic Events CJ Web amp Report Files DI 3 0 0 Digital Input 0 DI 3 0 1 Digital Input 1 DI 3 0 2 Digital Input 2 DIROUOU4 Do 3 1 9 Digital Outout 8 Do 3 1 9 Digital Outout a Do 3 1 10 Digital O
23. 2 Comping cl Kiel lee E 29 e L023 e elle Te se ha DPN CATION DEE 30 EWINSOET PROGRAMMINQG i iius a E ous 31 Di INTRODUCTIONS GG e FEL VR EXER VE RN E KENT RENE S ER URN ER KM EM EEE 32 O RTU PROPERTIES ee E WEE EE ERE EFE FEuE KEEN ud Fo ERRARE CFL RE RE FREE E FERE EG 33 6 I Generar DI OD CICS EE 34 6 2 RE e ee 35 usine QS 35 Versio 207 ee TWinSoftUsersGude gt A 0 4 INNO EE TX 36 65 AQVANCCG mt oa ana a ee 36 Fs Fel circ OOD ee d 36 6 5 2 El EE 38 EE SoM NGI OCS TT TI TI ITE 40 6 5 4 Tempel le 41 6 5 5 REME KL ceti io ie rd ecd eee cle eee ese LUI LIN C e aL 41 cran MELG I m RENI 41 6 5 Ze ENVIFONMENC VarlableS E 43 6 5 8 FONET e UE 44 EE REDO E praen rn T A E nase ee 44 Zu RESOURCES irbiissnunnini nno aaa aaa aak d dif 46 Zal INC CPO CHO GE 46 ZA l1 COMMUNICALION DOES OF the CPU BEE 47 FD DIGGING CWO EEEE ae PR 49 FE IE PCCM Lei O CON o RR 51 75212 JAddihd dPsTNIMOSgem e DEE 52 7 2 2 Adding a GSM 7 GPRS modemi Cal Qs ensskctd ctus d xpi Eu esa tive E cped cut Min arbx uua Ed Rudd 53 7 3 COImlunication EE 59 7 3 1 Digital COMMUNICAVON Variable EE 59 7 3 2 Analog Communication Variable eeseeeeeeeeeeeee nenne nennen nenne nennen nnn nnn nnns 60 PA A I vallale S TR H M 62 7 41 Digital System te El EEN 62 TAZ Analog Systeim Vari
24. 3 1 05 3 25 43 PM IPCP Recy CHNF REG 317 06 3 26 43 PM IPCP Send CONF_REG 317 06 3 26 40 PM IPCP Send CLIMF ACE 3 1 06 3 26 40 PM IPCP Recy CONF_REG W106 3 26 40 PM PCF Send ONE DEU ooo 3 1 06 3 26 40PM PAP Recv ACK 3 1 06 3 25 33 PM PAP Send REQUEST LLeeuueuuueuuuuuuu 3 1 06 3 25 33 PM LCP Send CONF_ACE 317 06 3 25 33 PM LCP Recy CONF REU 3 1 06 325 38PM LCP Recv CONF_ACK W106 3 25 33 PM LCP Send CONF REJ 3 1 06 3 25 33 PM LCP Recy CONF REQ 317 06 3 26 39 PM LCP Serd CONF REG s aoaaa aau 3 1 08 32538PM PPP Connect W TBox MS uses the Analog Chronologies to store debugging data Check whether the size is sufficient from the RTU properties General If you retrieve data for instance with 2wew you might receive stranae data Version 2 07 SS TWinSoft User s Guide 159 5 Example of TraceLog when sending Files FTP works fine TCP IP Debug information 40 records Timestamp Value 4 01 2006 10 55 02 PPP Disconnect 4 07 2006 10 55 00 LCP Hecv TERM ACE 4 01 2006 10 54 59 LEP Send TERM HEB usse 4701 2006 10 54 58 FTF Z21 Serice closing control connection 4 01 2006 10 5457 FTP Control Send HLILT 4 01 2006 10 545 FTP 226 Closing data connection 4 01 2006 10 54 53 FTP 150 File status okay about to open data connection 4 1 2006 105452 FTF Control Send STOR 4 01 2006 105452 FTP 22 Entering Passive Made h1 h2 h3 h4 p1 pz 4 01 2006 10 54 51
25. CPU32 Digital Chronologies max 12000 max 32000 Analog Chronologies max 7000 max 32000 Time zone The Time Zone where the 7Box MS is installed This information is used to create the timestamps when retrieving data from TBox MS according to its location TBox MS uses Universal Coordinated Time UTC as internal timestamp The conversion is carried out when retrieving the data Summer Winter Allows automatic management of winter summer time This selection has to be made according to the location where the TBox MS is installed See Appendix B Time in the RTU 6 2 Drivers Add ons Supplementary softwares can be added to the TBox application We speak of Drivers with MS CPU16 and of Add ons with MS CPU32 A driver or Add on is a module written in C that executes a specific task non standard Typically it is communication to equipment not supporting standard protocol of TBox MS Standard SCADA protocols are also supported IEC 60870 5 101 104 DNP3 0 TG800 SNMP Check availability with your distributors 6 3 Security Access security is discussed at chapter 16 Version 2 07 SS TWinSoft User s Guide 35 6 4 Info properties You can enter a version number the name of the programmer and a description of your program This information is not sent to TBox MS 6 5 Advanced 6 5 1 Start Stop By Start up we mean RTU Properties General Drivers Security Info Advanced 1 Reset of RTU hardw
26. Ca dem T ame zenns zf ai MA un iae a At M lade IM NEM Y SS LL as ah eame E LC on al Following in the recipients setting you can choose to have the recipient always active or only during a particular timetable e g Day shift without week end and holidays Recipient Mame Bem By sm Recipient Type Pager 5 M5 C Internal Service Mobistar GSM v Modbus Pager SMS Modem COM GSM MODEM gt Ge Fhone number U4 74437405 guf OFTP Dial Prefix ATDT NTP ORAS Custom Error Handling e cheduling Tries 2 TimeTable Always active Default v Always active Default Timeout minutes WeekNightshift If an alarm occurs when time table is active the alarm will be sent Otherwise the alarm is automatically auto ack as you can read in the Alarm Table See here under Version 2 07 SS TWinSoft User s Guide 105 10 9 Alarms table The Alarms table displays the Events stack of TBox MS The Events stack is the visible part of the handling of alarms in TBox MS The internal alarms queue is not accessible You access the Alarms table from the main menu Communication 2 Download Alarms Alarms Table 6 records Start timestamp Message Start Recipient End timestamp End 24 02 2005 9 19 20 Level of Tank1 too HIGH Auto ack SMS 24 02 2005 8 24 00 Ack ed 24 02 2005 9 19 07 Reset Auto ack 24 02 2005 8 12 38 Level of Tank too HIGH Ack ed SMS 24 02 2005 9 14 00 Ack ed 24 02 2005 3 11 38 tempera
27. DynDNS in TBox 1 Subscribe a DynDNS account Go to www dydns org Create an Account Create a Host 2 Create in TWinSoft IP parameters the connection to DynDNS DynDns Parameters Mame TBox Waterloo Server members dyndns org Path nic update waterloo dydns org Url DJ 4r Hetres Timeout 3n 3 Seconds Server requires authentication User Mame jeanburtan Password Confirm password Name Type any name Server DynDNS Server to which TBox MS will connect when it detects a changing in its IP address It should not be changed Path Location in the server of the table of correspondences between IP address gt name It should not be changed Url You type the host address you have creating when subscribing the DynDNS account Example waterloo dyndns org Server requires authentication Select the option to type the login corresponding to the account you have created at DynDNS organization User name Type the login name of your account Password Type the login password of your account 3 Associate the DynDNS configuration to the modem see communication port gt TCP IP gt Advanced TCP IP Advanced Network MTU 1500 Use DvnDns server Waterloo TBox v Default Version 2 07 E e ee TWinSoft User s Guide 91 10 1 Introduction 10 Alarms Alarm module of TBox MS is the gate to the outside world An alarm consists in a commun
28. Ethernet chip Ethernet communication is not interrupted USE A TRIGGER INPUT CONTACT TO ACTIVATE THE VARIABLE E Ek TWinSoft User s Guide 59 Name COMx Call COMx Answer COMx NoDial 0 COMx GPRSCon COMx ModBusResp 0 COMx COMx COMx ModemError 0 ModemPower ModemAlarm R W Description Modem Reading 1 indicates the modems are synchronized with TBox MS Calling Modem Reading 1 indicates the modems are synchronized with TBox MS Answering Modem Reading 1 indicates that no dial tone has been detected when the modem has picked up the line Must be RESET by the user GSM Indicates the status of the GPRS connection Writing 1 forces a connection writing 0 forces a disconnection see above for more details Communication Reading 1 indicates the port is transmitting At each transmission TBox MS SET this register To check TBox MS is transmitting you RESET this register and test whether it is SET again using Ladder or BASIC Communication modem initialization failed Modem has answered with an ERROR to one of the parameters of the init String see modem properties A reason could be with GSM because it is not registered yet When you RESET this register OS executes a warm start of the modem sending init string LowPower used only with Low Power RTU LowPower used only with Low Power RTU 7 3 2 Analog Communication Variable F COM4 GSM MODEM GPRS Parame
29. FTP Control Send PASV 4 01 2006 10 54 51 FTF 200 Command okay 4 01 2006 105450 FTF Control Send T YPE 4 01 2006 105450 FTF Control Send GA 4 01 2006 10 54 50 FTP 230 User logged in proceed 4 01 2006 10 54 49 FTP 230 User logged in proceed 4 01 2006 105448 FTF Control Send PASS 4701 2006 10 54 48 FTP 331 User name okay need password 401 2006 105447 FTP Control Send USER 4701 2006 10 54 47 FTP 220 Serice ready for new user 4 01 2006 10 54 46 FIP 220 Semice ready for new user 0 4701 2006 10 54 41 DAIS Response ok 4 01 72006 10 54 40 DNS Quer to prefered server lt lt 2222020000 4 01 2006 10 54 40 IPCF Recy CONF_ACK 4 01 2006 10 5439 IPCF Send CONF REL 4 1 2006 10 5439 IPCF Recy CONF MAF 4 01 2006 10 5439 PCP Send CONF_ACK 4 01 2006 10 54 39 IPEP Recy CONF_REQ 4 01 2006 10 5439 IPEP Send CONF_RE G 4 01 2006 10 54 39 PAPRecvAEK 777700 nn 0 M60 t gt 4 01 2006 10 54 38 PAP Send REQUEST 2 2 2 22 2222 4 01 2006 10 54 38 LCF Send CONF_ACK 401 2006 10 54 38 LCF Recy CONF_REQ 4 01 2006 105438 LCF Recy CONF ACK 4 01 2006 105437 LCF Send COMF REJ 401 2006 10 54 37 LCF Recy CONF REH 401 2006 10 5437 LCF Send ONE HEU 4 01 2006 10 54 35 LCF Send CONF_REQ rr EE Ven Values The column Value returns messages from to the Server When there is a code it is always information received from the Server 2xx OK 3xx OK but something still missin
30. IP Web Server Environment Variables From the RTU properties Startup Power Fail Slams Sampling Tables Temperature gt Advanced gt Power Fail 4 d you select the Tag a corresponding to the SEET f d 2 Power Fail This power fail information is then available for alarm and chronology condition where you have specified a handling associated to Power Failure in case of power failure the alarm and chronology conditions will not be executed Also the Tag you have created in this example PowerFail can be used to send an alarm and can be recorded into chronologies datalogging 6 5 9 Web and Report Check user s WebFormViewer version You activate the verification done by the WebForm Viewer When creating a WebForm an indication of minimum version of the Viewer is declared in HTML pages sent in TBox MS When going in connection with IE WebForm Viewer will check the version of WebForm and in case it is newer display a message see next Message In case you have activated the option you can specify a text that will be displayed in a message box This message box appears when connecting with IE to a WebForm that needs an update of WebForm Viewer to be displayed This information mainly depends on the type of connection used to access TBox The TBox is accessed through a modem point to point connection as it is impossible to access Internet from this connection you type a message to inform on the pr
31. SIM card you have does not require a PIN code you can leave the field as it is or erase it completely If you type the wrong PIN code or you type a PIN code when the SIM card does not require one there is a risk of blocking the SIM card It must then be restored with the PUK code using a mobile Auto Answer number of RINGS before the modem picks up the line Dialing to a GSM data The SIM card of a GSM has three telephone numbers VOICE the one you use to speak DATA and FAX To dial TBox MS you have to be sure that data service has been activated and you dial the DATA number please call your GSM operator In some countries like in US for instance GSM operators do not provide GSM DATA service DATA communication is then only available in GPRS mode see below About sending e mail or Files with GSM data Some ISP requires specific telephone number for connecting through GSM please check with your ISP Version 2 07 CA wm Gm s TWinSoft User s Guide 54 GPRS settings Once you have declared a MS GSM card you have to activate the GPRS mode COM6 GSM MODEM You have to choose either GSM Data mode OR GPRS mode Itis not possible to use the modem in both modes at the same time but itis possible to combine GPRS mode and sending of SMS see below Parameters DOY ACY Advanced TCP IP When selecting GPRS TWinSoft automatically Modem Type adapts Initialization and riiaisation Opera
32. SMS 57 CPUC OM ee EE T ee ee PC Set 22 E omm Np PE 65 AR Kee 26 Group of rechpiente 101 testing with Soi 26 E te ee TAOS EE 68 to other RTU 122 E Ee EE 54 EM M RE E EK Compiling an application ec 20 COMMOUPATI ON ME 53 Cues aot cobi MU EAD AT EE 67 EE CPU WEE communication Dorte sees eeeeeees 47 Hardware concept 13 High Speed Tags 129 Version 2 07 2 Se TWinSoft User s Guide 166 Historical data aute Em E DpPRDRRDDIE 92 miele ETE EET 104 Je ge Lee EE 50 LEGO 0B NEE 35 NATO sic ne Bisa ves eked nats ae ie 36 NAAT WAU E 71 73 IP address of the CDU 48 IP address of the CDU Eegeregie 27 J atel lee le Le VE 153 IP Paramieltefs o rti atte date aac ds 80 DVDDNS dic rona 90 mie TR EEE AAE 83 Ke EE 81 NFP EE 89 SIT P iinet aor EE 84 Le ania HEC 81 pb rn NN ERNEUT 28 Breet 140 ein TEE 140 efe 140 evaliatiOElao odicitisistuotob nnm taie pda edes ad erba aps 140 TAMIBSOIE Et NEE 140 Login Eogoll nocet i etre en pesosbss 135 WIG IMO Ry eer m 29 WIGSSA CC C dynamic Value eot eva i s maa ue aero we 102 WT Le EE 39 jl eser 144 WOGIB US ns incom uiia uade ica ED IAE Keele DEE 150 ModBus address of station 34 ModBus address of station derat Mesen Eed 27 ModBus device 123 Uu ale Can BEE adding a modem 52 caler p EE 61 debugging MS16 eese 155 debugging M32 161 OM RE 23 Si
33. SMS to the RTU 2 Controlling the RTU by sending SMS message s or sending e mail s RTU Properties An advanced menu is M available in the RTU General Drivere Security Info Advanced properties Advanced Parameters This page contains advanced parameters Extreme care should be taken when changing these parameters IF you Feel unsure about the changes you are doing use the Default button to restore the default parameter values Startup Power Fail Alarms Sampling Tables Temperature J TLP IP Web and Report Environment Variables C ompatibilit Command settings enee 7 In Message wert T T For any incoming connection either for acknowledgement or for controlling the caller ID phone number of the caller for the last call received is available in the new Analog Communication variable ComX Caller ID see chapter 7 3 2 Version 2 07 CER am Ge TWinSoft User s Guide 108 11 2 Acknowledgment of an alarm by sending SMS to the RTU Pager SMS Alarm conditions associated to one of these recipients provide a new option SMS Two types of recipient may require an acknowledgment by SMS sending a message through a SMS C standard way sending a message which can be forwarded as SMS through a dedicated E mail l service acknowledge Alarm Condition een Recipient SMS Jean a Et Lalk st Severity Message Filter hod Handling Enabled Ww SMS Acknowledge
34. TCP IP Z xl Category Items TE SE mee 1 All IP parameters amp Ci Tags o oo mee are defined in this p e SMTP Server D i Folder available from iain Server o j Y es MTF Server 0 L the Resources C FTP Host Aa Dynes gt 4 ES SMTP Server d I POPS Server h i MTP Server 1 a ru ee eT O P T A apa TOES 1 The FTP Host SMTP Server POP3 Server and NTP configurations correspond to connections to the appropriate servers It is done for once and called when creating a recipient of alarms This makes creating alarm recipients very easy Example with alarm for sending e mail The Recipient is an e mail address which refers to a SMTP server This SMTP server refers to an ISP In other way round when TBox MS generates an e mail it sequences the configuration like following connection to an ISP connection to a SMTP Server sending to a recipient e mail address Version 2 07 CA wm Gm s TWinSoft User s Guide 80 9 1 ISP configuration ISP stands for Internet Service Provider An ISP represents the entrance to Internet It is required to access Internet with a dial up connection PSTN GSM DATA It represents the connection to the company you call to access an Internet service like sending e mail or files FTP Some among the most well known AT amp T Scarlet Tiscali When you want TBox MS to send e mail or send files to a FTP site you subscribe an account to an ISP ISP Parameters Modem C
35. Typically it is a TBox MS connected to another TBox MS either local through RS485 or Ethernet or remote by modem One often speaks of Master Network because it is a Master Slave communication the Master executes reading and writing in slave s TBox MS being Master reads and writes the variables with all other devices using the ModBus protocols ModBus RTU or ModBus TCP according to the remote device Each Remote Tag corresponds to one transaction reading or writing with 1 slave When there are several devices TBox MS executes the different transactions in the order of the list of the Remote Devices and then for each device in the order of the list of Remote Tags Any communication port can be used to execute Remote Tags RS232 RS485 modem PSTN modem GSM Ethernet When a modem port is used to execute Remote Tags TBox MS needs first to establish the connection using an Alarm of type ModBus see chapter 10 4 Recipients Version 2 07 CHE ow TWinSoft User s Guide 122 Before creating a Remote Tag you have to create the equipment you are going to communicate with 13 2 Creating a Remote Device Manual P 2710 Co 7 Tags ExjMS5 we DAN i J Ee f L1 From the Project Workspace 200 Bra ms Pszaov N MAE 3 Si Can wz pSTN A select Resources gt I O Sang Esp EE 4 cal wien d Click I O and in the list of S Pair sii WE TRUE 1 TE i CH Card 2 MS 18DI 4 I
36. Version 2 07 SS TWinSoft User s Guide 143 Appendix C Plug amp Go Plug amp Go allows storing the complete TWinSoft project into the MMC of TBox MS MMC stands for Multi Media Card It is also known as a SD card It is a memory card up to 1 Gbytes that can be inserted in the dedicated MS CPUxx socket at the back of the card see manual TBox MS Technical Specifications As TWinSoft project we mean all files including TWinSoft compiled document with Web and Report files OS and even Loader all ready to run in the RTU When inserting a memory card on existing MS CPU16 you will have to remove the card from the rack If the jumper to use the lithium battery has not been closed the CPU will restart at 1 1 1970 You have then to do send the program again See info in manual TBox MS Technical Specifications gt chapter MS CPUxx There are 4 ways Plug amp Go can be used with MS CPU16 OS 3 04 381 minimum is required 1 TWinSoft send the project directly to the MMC When TWinSoft sends a program to the RTU all the files are sent and stored in the MMC This corresponds to a complete backup of the project on the MMC The advantage is that if you have to replace a CPU you don t need to send the program you insert the MMC in the new CPU and it will start with its program 2 You insert an empty MMC in a CPU If an empty MMC is inserted into a CPU the project is automatically stored in the MMC It c
37. and or updated to the RTU with a double click on the tpg file TWinSoft needs to be installed on the machine used to update the RTU with tpg file but the TWinSoft license is not required D 2 Pack To access Pack amp Go menu select from the main menu File gt Pack amp Go TWin5Soft Pack amp Go Archive Information Archive File List Version Language f TWinSoft WebServer Box We Raa Edit View Communication Tools P C C Mew Ctrl h G Open ctrleo i ave Cri 5 Save OS RI RI TE Export Import rig x oem e e J E Select the button Pack Version 2 07 fF eme IF YOU ARE OFF LINE while compiling TWinSoft uses the OS indicated as Off line OS in the General RTU properties This OS and only this OS will be sent to the RTU TWinSoft User s Guide 147 TWinSoft Pack amp Go Archive Information Version 1 1 Language English v 15 Version All Files of the project TwinSoft document WebForm html Archive File List pages OS are packed in one Name Drive Path au e alarms htm E Documents and Settingestechno trades y Documents Twins ott file with the extension tpg alarms twt Documents and Setlingsstechno trades y Documents Twins ott Documents and Settingstechno tradeSMy Documents Twingo Documents and Settingestechna tradesMy Documents Twins oft Documents and Setting
38. application OS WebForms report from a uniq ue file Online COM1 9600 E Engineer The button PC Setup oies you Mn access to the configuration of the PC to communicate with the RTU Communication TWin oft Pack amp Go File Communication Tools Archive Information IET TUETET The button Update RTU sends SCHAUT the project and OS to the RTU Application Information 5 Version Modbus Address Communication Online COM1 3600 E Engineer Cts If packed OS is different from OS in the RTU Pack amp Go updates the RTU with the OS WARNING with OS 54xx in CPU3 and 55xx in Pack amp Go For CPU with S N gt 200508xxxx OS 5499 must first be uploaded before uploading to OS 55xx Languages supported are English French and German It cannot be selected from Unpack menu but changed from TWinSoft main menu Tools gt Language Version 2 07 N a TWinSoft User s Guide 149 Appendix E ModBus Rerouting E 1 Presentation One of the nice communication features offered by TBox MS is the ability to act as a ModBus router That means that you can use a TBox MS to make a connection between 2 ModBus devices that are not on the same communication channel The routing mechanism analyzes only the Station address in the request In case a request is not addressed to TBox MS it will be forwarded it to the other port It can then be used with TBox MS connected to any Mod
39. c ch Xo EES Comm Port Address Fa Manual Tags Resources aly SE FH MS CPLI5E Cl System variable Timers Counters Local Starting a new document the only card Parameters available is the CPU IA You will add all cards corresponding to Alarms i de Data Logging your hardware into this list Remote Tags Periodic Events Web amp Report Files Online COM1 S600 Engineer TWinSoft does not detect the cards L e automatically You have to add the Example Adding a Power Supply card im 5 cards EM cs menu Add T TWinSoft manual2 tws 1 0 FU SPE fd File Edit View Communication Tools Window Help amp amp ek Xo sm MameJId Comm Pork LES an UO Car Tags Eajwz CPU18E MS PS48VM Resources MS5 PS5z230Vv mayo MS PSTN cH Ead M5 CPU16E MS 16DI Jl System variable Timers I 0 Card Counters IP Parameters Programs Alarms Data Logging Remote Tags Periodic Events web amp Report Files nud Cancel E Er Er n E TBoxM5 Online COM 9600 Engineer Version 2 07 E SS TWinSoft User s Guide 49 Id number of the cards in TWinSoft vs Slot in the Rack Type of Card Slot used in the Rack Address in TWinSoft Power Supply if used If slot 0 1 Other slot Slot Id MS CPU w o redundancy 0 when used without Power Supply Always 0 1 when used with a Power supply or alone in prevision of using a Power Supply MS CPU32 with redundancy CPU1 O Always 0 CPU2 1
40. can be deactivated from the Send application menu AN Are you sure you want to upload the program inta the ATU 7 _ Include Program source L Don t set Rtu time after program upload VE JL wes E nne nil ab S E ee o SE r RTU time can be checked any time doing a RTU Identification from the main Communication menu Version 2 07 N Ss TWinSoft User s Guide 141 Winter Summer time When installed in regions using daylight saving the TBox MS handles the changes automatically It means that the RTC and Analog System Variable hour are automatically updated when the time changes Standard changing time and period last Sunday of October 1 00 gt 2 00 last Sunday of March 2 00 gt 1 00 B 2 Data logging Chronologies In chronologies the time is recorded for each log of data The time recorded is the UTC time When retrieving the data the PC reads the UTC time and converts it according to the local time of the PC depending on the Time settings of the PC When a winter summer time change occurs the TBox MS is informed and automatically updates all timestamps following the changing Sampling tables In sampling tables the TBox MS records the timestamp of the last record only The other timestamps are built up when retrieving the data A choice had to be made between either having always the same period of recording or having always the same hour of recording The latter ha
41. first one in the list see chapter 9 3 SMTP Servers If it fails it will try with the second one and so on FTP TBox MS is able to send files to a FTP Host see chapter 9 2 FTP Host In the recipient configuration you only need to indicate the directory where you want to send the files NTP TBox MS is able to synchronize its clock with an external NTP server In the recipient you only select a server you have created in the list of NTP Servers see chapter 9 5 NTP Server RAS This type of recipient can be used to establish a Client modem connection to a Server The Server is considered by TBox MS as an ISP it requires a telephone number and a login to establish the connection You associate an ISP previously created in the IP parameters of TWinSoft and when connection is established the Server has to communicate in protocol ModBus TCP Alarm Recipients Recipient Runtime Parameters It can be assimilated to a Name 0 Modbus Slave connection using ModBus RTU protocol The Server is responsible of acknowledgment and hanging up Recipient Type RAS Internal Connection O Modbus O Pager 5MS Printer E mail OFTP NTP DAG Custom O POPS Error Handling Tres Timeout minutes Custom in case a C driver allows sending alarms Has Connection wi Scheduling TimeTable Always active D efault v POP3 allows reading e mail
42. generator Version 2 07 2 sz TWinSoft User s Guide 153 To improve protection we advise not to use the same codes in those two configurations RTU Properties General Drivers Security Info Advanced Advanced Parameters This page contains advanced parameters Extreme care should be taken when changing these parameters IF vou Feel unsure about the changes you are doing use the Default button to restare the default parameter values TCPAIP Web and Report Environment Variables Compatibility Read SMS TEF Port Humbera Nebaork HTTP a0 MTU 1500 ModBus TCP Slave a LL ModBusTCP Master 502 TCP IP address for incoming Calls From 132 158 2 1 To S2 bs eee oo Enable IP forwardin 3 From the Advanced properties TCP KEE IP tab you have to enable IP forwarding Startup PawerFail Alarms Sampling Tables Temperature Remate Tags EI D m D E e meum I dam ft milies mas ler D es T rm bok ahh mm n ee WE e men IP Forwarding activation code Clicking OK you are prompted to type a NAME and PASSWORD as IP e Mame MEAN forwarding activation code piensen This login must be created from the NM code entered in step 2 above To deactivate IP forwarding you are also prompted to type the IP forwarding activation code To improve security NAT rules can be configured
43. is used to calculate your consumption based on average consumption during 15 minutes You will be charged based on the highest consumption In order to analyze your consumption and prevent peaks in consumption you can use this pulse as Trigger Recording will be done each time the pulse arrives but when retrieving data the calculation of timestamp will be computed from the time stamp of the last recording and the period This means it can only be used if the period between pulses corresponds to a period between 2 recordings see above No sampling if trigger 0 the CPU clock is used to record data see Period above but the recording is only possible when the Tag Trigger is positive high state When it is negative the recording stops On the positive edge of the Tag the table is erased and a new recording starts WARNING At each activation of the Trigger the table is erased You then have to retrieve it before The reason is that Sampling Tables only store the timestamp of the last recording Reset Tag after sampling if this option is checked the RTU automatically resets the register that has been recorded This option works only with registers NOT I O Version 2 07 N SS TWinSoft User s Guide 121 13 Remote Tags gt 0440011410 10010411 0 110043410 1 0 13 1 Introduction 0110 Remote Tags allow exchanging information between two or more ModBus devices via any communication ports
44. nm e Laien A smehom nm m ee mm This option is only available for TBox MS or TBox LITE It is grayed with other models of Se File C Documents and Settingsstechno tradesSMy Documents TvvinSoftfiS1B SPlug amp a bin size Plug Click this button to compress the Project to the Plug amp Go bin file The name is unique It means if you want to create Plug amp Go files for several RTU s you have to save each file in a separate directory Once the Project is compressed the window displays File Info see example above File Info Click this button and select a Plug amp Go bin file to display its Info Version 2 07 SS TWinSoft User s Guide 145 System variable A digital system variable is available when using MMC MMC indicates whether the program has been loaded from the 29 MmcToRTU File System xml MMC 1 the program of the MMC is different from the one of the RTU and has been loaded from the MMC 0 there is no MMC the MMC is empty the program of the MMC is identical to the one of the RTU With TBox MS16 This file can be used to initialize IP settings of the RTU see the manual Technical Specifications When there are Plug amp Go bin and system xml files the latter has priority LEDs on TBox MS16 LEDs of the CPU 16bits indicate the transfer of data from the MMC to the RTU Information available at start up of the CPU LED Er ON during 1 second Program transferred from the MMC to the R
45. not separately or by groups like if it was a specific day of the week see Time Tables next You can choose to keep each selected day as holiday for every year by default Holiday Add a holiday C Tags 301 janvier H Resources 9016 ant e LI IP Parameters 9011 novembre Programs Alarms J Conditions Holiday Recipients A Recipient Groups Date me HM Ge Every year Time Slices CH Holidays CL Tingtables _ aie ANON ES Am E T SS Ree m STET rm TE Version 2 07 2 es TWinSoft User s Guide 104 10 8 3 Timetables Based on the Time Slices days of the week and Holidays you create different Timetables according to activity periods in your company day shift night shift holidays week end A time table can then be associated to a recipient You select for each day of the week Holidays being treated like a unique day which time slice will be part of the timetable S IS c amp fk X Sisi a amp z xl Mame Fal LTG5M add a TimeTable EZ J Tags ES J Resources _ IP Parameters Timetable x Programs GL Alarms Mame weekNightShilt _ J Conditions J Recipients Recipient Groups Mo Tu Wwe Th Fr Sa Su Holiday p p C Messages 00 00 08 00 a d Time Slices Dnne SIC all lll aio d lala Ceara Clear All m Holidays ISCH 2259 FF Fl FIFI F FIFI FI ce 3 Timetables Men J Data Logging mp ik
46. of alarm This option will automatically generate an alarm when the condition generating the alarm disappears The possibilities are Not ack there is a Notify end of alarm condition and the alarm is still in process Ack ed the end of alarm has been successfully processed Auto ack the end of alarm has not been processed successfully When there is no end of alarm it is immediately indicated as Auto ack Version 2 07 CS siu TWinSoft User s Guide 107 11 Read SMS embedded 11 1 Introduction ReadSMS POP3 is the capability of the RTU to receive and interpret incoming SMS messages and to read subject field of e mail to execute tasks It is integrated in TWinSoft and with TBox MS MS CPU16 requires OS 3 08 xxx minimum This feature requires a GSM on the RTU only GSM can receive SMS For MS CPU16 If you intend to to use ReadSMS with an existing application developed with a TWinSoft older than 9 03 1021 and working on a MS CPU16 with an OS older than version 3 08 429 you have to update the initialization string of the GSM modem AT IPR 57600 AT CBST 0 0 1 ATEOQOVI amp C1 amp D2 amp KO AT CLIP 1 You can also click on the Default button in GSM properties If you work with a PIN code be careful to adapt it Upload to OS 3 09 446 or higher see chapter 4 8 Upload Operating System ReadSMS POP3 features allow two uses 1 Acknowledgment of an alarm by sending back a
47. see chapter 13 Remote Tags e The System Variables variables having pre defined function see chapter 7 4 System variables e Timers Counters used in Ladder BASIC see another manual BASIC amp Ladder for TBox 7 1 The CPU card When starting a new document TWinSoft creates automatically the CPU card corresponding to the selection in the wizard see chapter 4 The communication ports of the CPU with their associated configuration and the I O of the CPU are available from the Resources 5 TWinSoft Manual I O MS CPU16E zI File Edit wiew Communication Tools Window Help d D a be amp Rick xE SS tab Z xl e Manual p C3 Tags Ce Ee SE B Resources 2 ES 201 ipo i d Do a 3 ES 141201 Z BM MS CPLILEE i EY Group D CPLI COM ES Group 1 2DI 100 BE Group 2 1AL2DT otha e T Sg z re ee a al aaa Example with MS CPU16 The CPU card is divided in several groups Example with a MS CPU16 Group O communication ports Group 1 2 digital inputs 1 digital output Sync Input Sync Output STOP input Group 2 1 Analog input 2 digital inputs Power supply voltage temperature warnings V NON Version 2 07 CA wm Gm s TWinSoft User s Guide 46 7 1 1 Communication ports of the CPU emi mp Duo ue oe Communication ports in the you access each port 1 workspace i separately i M5 CPUISE 8I Group 0 CPLI CONM ULI E Bm
48. the program to the RTU Communication Properties 4 a om In the menu Communication GO Dine gt PC Setup select the serial E Local RS 232 port of the PC you use to y een connect to the RS232 port of PL Serial Port mech baudrate to A F5 TEPP Ethemet IP Address Version 2 07 CA wm Gm s TWinSoft User s Guide 156 Zu TWinSoft RTUT tws Resources View C onmnitunicabion 5 Open the TWinSoft Terminal window Tools Window Help X p PC Setup in Debug mode B ae RTLI Identification tue a Send Program Ctrl Fo IP Parameters Start Stop Program JJ Programs Set RIU Time Alarms i Data Logging foo Remote Tags Download k J Periodic Event Upload d High Speed Ti i L1 Web amp Report Program equality Routing Terminal E puces i a em mu Sr E s LAMP uu a K pan TWinSoft Terminal Communication Port Selection RTU Fort COM4 GSM MODEM Click Start Modem on PC Debug Mode TWinSoft Terminal Communication Port Selection RTU Pot Madem on PC Debug Mods Start ATAN3ECTDTS 025970000 DU n after few tests ATEDMT1LSQUVTRARD2SCONN 340087 TB GELEB A4ATEOM LSQUV 19 48 D 222CDAN GOAT 16 GC1 B DK you get ATAN3XCTDTS 025970000 BUSY ATEOMILSOOV TA ARD ZEEDSN3SQUSTTESGCISB 4 amp TEDMTLSQUS T ASD ACON ANOT TESGCISB DK All data flowing through the modem will
49. to acknowledge e mail or to operate TBox with a message see details in chapter 10 4 1 Version 2 07 TWinSoft User s Guide 99 10 5 Dynamic Change of recipient tel number or address This feature has been maintained for compatibility with older application Instead you should use the runtime parameters offering more flexibility see chapter 8 5 10 5 1 Dynamic changing of telephone numbers You can change the telephone number of any recipient using its ModBus address To calculate the ModBus address MSB 256 LSB MSB 254 base address of 65024 LSB index of the recipient Example to change the telephone number of recipient 5 254 256 5 65029 This address can be used in a label of WebForm Studio gt select address with as type String to display the telephone number To modify it make it write enable from the label settings 10 5 2 Dynamic changing of ONE e mail address Only e mail address of the recipient 1 can be updated It means that if you wish to use this feature be sure you have declared the recipient e mail with index 1 in the list of recipients Its ModBus address is 64769 This address can be used in a label of WebForm Studio gt select address with as type String to display the current e mail address To modify it make it write enable from the label settings Version 2 07 CE wx x TWinSoft User s Guide 100 10 6 Group of Recipients A group of recipien
50. 007 11 08 44 30 11 42007 11 08 44 3071172007 11 08 41 3071172007 11 08 41 Verbose Verbose Verbose Verbose Verbose Verbose Verbose Verbose Verbose Verbose Verbose Verbose Verbose Verbose Verbose Verbose Verbose Verbose Verbose Verbose Verbose Verbose Verbose Verbose Verbose Verbose Verbose Verbose Class AT Modem AT Modem AT Modem AT Modem AT Modem AT Modem AT Modem AT Modem AT Modem AT Modem AT Modem AT Modem AT Modem AT Modem AT Modem AT Modem AT Modem AT Modem AT Modem AT Modem AT Modem AT Modem AT Modem AT Modem AT Modem AT Modem AT Modem AT Modem Messages Port 4 Hecerve OF gt Hecerve CPM5 0 25 0 100 0 125 gt Hecerve OF gt Hecerve OF gt Send AT CMGF 1 AT CNMl 2 1 4 amp 7T CPMS SH gt Hecerve OF gt Hecerve 050 23 88 gt Send AT CS gt Heceive OF gt Hecarve UK gt Hecerve STEQOQOYTECTEDZEED gt Hecarve UK gt Hecerve AT4CBST 20 0 1 gt Hecerve OF gt Hecaerve AT PH 5 BUU gt Send AT IPR 5F600 47 CBST 0 0 7 ATEOGUV18C18D2 amp K AT gt Hecarve UK gt Hecerve CAREG UI gt Receve 47 CREG gt Send amp T4CREG gt Hecerve OF gt Hecaerve CHE 0 2 gt Receive ST CREG gt Send AT CREG gt Hecerve OF gt Receive CREG 0 2 gt Hecaerve AT CREGY gt Send AT CREG Version 2 07 CES ae e Aw TWinSoft User s Guide 162 Example 3 SMTP connection SH Trace log Time
51. 1 Confirm password Account Cancel Login Depending on the account you have subscribed you have a login or work with Anonymous login This is the basic configuration to connect to the FTP site You do not declare a directory in this configuration but when declaring the Recipient see chapter 10 4 The Recipients This allows creating any combination several FTP recipients to one FTP site several FTP recipients to different FTP sites Version 2 07 N TWinSoft User s Guide 83 9 3 SMTP Server SMTP stands for Simple Mail Transfer Protocol It is usually the main reason for subscribing an account to an ISP for sending and reading e mail Concerning e mail TBox MS is able to send e mail through SMTP server and to read e mail through POP3 server The SMTP Server represents the mail server used for sending e mail typically the one of the ISP where we have subscribed an account First TBox MS connects to Internet through a connection ISP Ethernet or GPRS and then to the SMTP Server SMTP Server SMTP Parameters Runtime Parameters Connection Mal SP Ve TCP Part a Use default part The server requires authentication Name It is a free name to recall when you create the alarm recipient Mail Server SMTP It is the IP address or the name of the outgoing e mail Server It is the unique mail Server needed to send e mail E ma
52. 1 RR ng Us CERS 164 Bio RNC TEES 141 automatic seitngds neern nenna 89 week of the vear 67 vwiniferisummer eese 142 Tam SOS etica EE eet 104 Tite tables s eese cad cum iem terc m edes 105 WMA EE 67 TIU Eco e ee 92 TVA SOU s serch streets meas cima eaten Eras ee Eee EM ZU Nils ei uge IEN Jet UE L e MARET 17 giele Coan eR 19 system requirement 16 BN n EENG 141 EE COMMUNICATION eene 59 ENVIFONMENL 2 cece ecececececeeeeeeceeeeaeeneeeees 43 TALET ATE EE cee etter Ee 70 ST DEE 62 UE Ee DEE 76 WebForm Viewer nnnm Rej 17 Week of Uevear 67 Wiza r DEES 21 TWinSoft User s Guide 168 Version 2 07 N SS TWinSoft User s Guide 169 Version 2 07 CE wx x TWinSoft User s Guide 170
53. 3 M5 CPLILBE DL3 0 42 Digital Input 4 CARD E Card 1 MS P548VN DI 3 0 52 Digital Input 5 m Card 2 MS 16DI zDL3 0 67 Digital Input amp 1 BB Card 3 M5 16D7 zDL3 0 72 Digital Input 7 E Card 4 M5 18DI ES p Card 5 MS 15D0 Card 7 MS COMBO 1 group 0 8 DI When connected to a TBox MS the column ES Group 1 4 DO e Value displays the current value when the SOUS AD channel has been declared as a Tag System variables _ Digital see chapter 8 Taqs Analog Programs EG Alarms Data Logging WOH y OQ J Remote Tags MS O 1 Periodic Events A Web amp BEER Files Ready TBoxMS Online COMI 600 Engineer When adding a Card its ID number must correspond to its position in the Rack Check the slot index written in the Rack See examples in the manual TBoxMS Technical Specifications chapter 3 4 See also technical details on I O cards in the manual TBox MS technical specifications Version 2 07 N TWinSoft User s Guide 51 7 2 2 Adding a PSTN Modem Card A modem card PSTN or GSM is composed of a modem and a serial port RS232 or RS485 Technical specifications are available in the manual TBox MS technical specifications Once created a 212 Port Type Protocol modem provides a US COM4 PSTNMODEM Modem Group D with zd Tags JSCOMS R5232 485 Modbus E J Resources communication ge ports Fal Ms CPUI16E
54. 3 stands for Post Office Protocol 3 It is used to check and collect e mails in a mail box The POP3 Server represents the mail server used to read mails previously sent to the attention of TBox MS The use of POP3 is not to retrieve e mail but to read the field Subject and take some actions There are 2 actions that can be taken by sending e mail to TBox a Alarm acknowledgment sent through e mail see next page b RTU monitoring with predefine message see chapter 11 ReadSMS First TBox MS connects to Internet through a connection ISP Ethernet or GPRS and then to the POP3 Server POP3 Server POP Parameters Runtime Parameters Mame MyPOR3 Connection MylSP Ww TCP Fort mo Use default port The server requires authentication Name It is a free name to recall when you create the alarm recipient POPS Server It is the IP address or the name of the POP3 Server to which TBox MS connects to read e mails Connection You select the way to connect to the Server ISP GPRS Ethernet TCP port Each TCP IP service has its own unique TCP port It provides a logical location for the delivery of TCP data TCP port used by TBox MS to establish POP3 connection default 110 The Server requires Authentication If authentication required to collect e mail Login and Password TBox MS does not support SSH Version 2 07 CA wm Gm s TWinSoft User s Guide 86 9 4 1 Alarm Acknowledge Through POP3 Introductio
55. 30 11 2007 12 31 44 30 11 2007 12 31 44 30 11 2007 12 31 44 30 11 2007 12 31 43 30 11 2007 12 31 43 30 11 2007 12 31 33 30 11 2007 12 31 33 30 11 2007 12 31 38 30 11 2007 12 31 38 30 11 2007 12 31 37 30 11 2007 12 31 37 30 11 2007 12 31 35 30 11 2007 12 31 35 30 11 2007 12 31 35 30 11 2007 12 31 35 30 11 2007 12 31 32 Level Verbose Verbose Verbose Verbose Verbose Verbose Verbose Verbose Verbose Verbose Verbose Verbose Verbose Verbose Verbose Verbose Class Example 4 FTP connection SH Trace log Time 30711 2007 15 54 31 30 11 2007 15 54 31 30711 2007 15 54 30 30 11 2007 15 54 30 30 11 2007 15 54 23 30 11 2007 15 54 25 30711 2007 15 54 25 30 11 2007 15 54 24 30 11 2007 15 54 24 30 11 2007 15 54 24 30 11 2007 15 54 23 30 11 2007 15 54 23 30 11 2007 15 54 22 30 11 2007 16 54 22 30711 2007 15 54 21 30711 2007 16 54 21 30711 2007 15 54 21 30711 2007 15 54 21 30 11 2007 16 54 20 30 11 2007 15 54 20 30 11 2007 16 54 20 30 11 2007 15 54 13 30711 2007 15 54 13 30 11 2007 15 54 13 30711 2007 15 54 18 30 11 2007 15 54 18 30 11 2007 15 54 17 30 11 2007 15 54 17 30 11 2007 15 54 15 30 11 2007 15 54 15 30 11 2007 15 54 15 30711 2007 15 54 15 30 11 2007 15 54 15 30 11 2007 15 54 15 30 11 2007 15 54 14 30 11 2007 15 54 14 30 11 2007 15 54 13 Level Verbose Verbose Verbose Verbose Verbose Verbose Verbose Verbose Verbose Verbose Verbose Verbose Verbose Verbose Verbose Verbose Verbose V
56. A Filter can be tested either during both transitions or only during the transition selected see chapter 6 5 2 Handling The handling option allows blocking each alarm condition manually or automatically Enabled alarm condition always active Disabled alarm condition always de activated PowerF alarm condition disabled when there is a main power failure DisAla alarm condition de activated when the system variable DisAla is at 1 VV WV wv Severity Each alarm can be assigned a level of severity Low Normal or High When several alarms are still present in the queue and not processed yet TBox MS generates the calls according to the highest severity End of Alarm When the alarm condition is finished an alarm is automatically sent to the same recipient with the same message preceded by a prefix see chapter 6 5 2 Example for a maximum alarm it is when the value returns below maximum hysteresis It is also useful when the alarm condition is active when TBox MS starts up When end of alarm is checked an alarm is automatically generated when the condition of alarm disappears see illustration chapter 10 8 Alarms table SMS acknowledge See chapter 11 2 POPS acknowledge See chapter 9 4 1 Version 2 07 a TWinSoft User s Guide 96 10 4 Recipients To access the definition of Recipients click the folder Alarms in the Project workspace and select Recipients The types of recipients sup
57. ATIONS 55m cie eI e DIESEN UU UE 9 T How TO USE THIS MANUAL ees 12 VES EM Wat IS INTE MaN po C 12 1 2 What Js HOC 1M TIE malas assai dee 12 Zi THE HARDWARE CONCEPT EE 13 LS MEE Ia cm 13 22 HI CONES cid cotes M LM II IM MD INIM MIS DM 14 EWINSOEI GETTING STARTED ire ei rr eco oon reo urea cote eonun rore Eee 15 3 INSTALLATION OF LWINSOETiuss vas enis SEE RE EAR ER QURE DONI E Kn PRODR QR E RW KE RR ER RR 16 S I EE 16 3 2 TIhstallation ol Ine CD ROM EE 17 oS Hrograms OF le Ke 19 4 STARTING T WINSOETis skr irai ai ni CR CER GE RR RR REOR RR EIER RR TER RACER RR Rr 20 QN EZ D 21 42 COMMUNICATING WITT TBOX E 22 8 2 TC COMMUNICAUON Set BD d cpu iore o Dr ut E reco race De et aA OR Re 22 4 3 1 Communication possibilities of TWinSoft esses mmm 23 4 3 2 IP address settings in TWinSoft PC Getup KENNEN 24 4 4 Factory IP address changing IP address 25 4 5 FOSUnq COMMUNICATION EE 26 450 ROSELLO Ee 27 4 7 Global tresel OF TROX MS Ert 27 4 7 1 MS CPU16 Global reset configuration oorr reor rrr rn nnn nnn nn 27 4 7 2 MS CPU32 Global reset CONFIQUIATION ccsceseceeceeceeceeceeceeceeceecetseeseesetsetseesetsetsaseeatenss 27 4 0 e e Ee Operating SVS te EE 268 a OALED KRON E 28 410 Saving and Sending a PrN ANN eege Ain rg Dd vui Dp rere aab ed ba dnd 29 4 10 1 Saving a document Backup document 29 710
58. Always 0 Hecate E Any slot following the CPU Same as the slot index Communication card Example f TWinSoft manual2 tws I 0 td File Edit View Communication Tools Window Help amp Oe Xo SBD a dB 2h MameJId Comm Port Address SiS add an UO Card Tags Ev Cie MS CPLITGE Local Resources il cardi M5 P5230V Local ER Yo i ib Card MS 16DI Local Eal MS CPLULGE EB card 3 MS 16DI Local E Card 1 M5 P5230 EE MS 16DI Local eM Card 2 MS 16D1 EE MS 16DO Local zB Card 3 MS 16DI p il cud MS COMBO 1 Local ii Card 4 MS 16DI BEA Card 5 MS 18DO ER Card 6 Ms COMBO 1 System variable Timers E E E TBaxMs Version 2 07 CA wm Gm s TWinSoft User s Guide 50 7 2 1 Adding an UO card The Hardware is represented in TWinSoft with a hierarchy of 3 levels CARD CPU card 16 DI card COMBO card Modem card gt GROUP when there are several types of I O on a card they are separated into groups group of DI group of DO group of AI CHANNEL each physical connection within a group corresponds to a channel fo TWinSoft RTU1 I O Racks lieft td File Edit View Communication Tools Window Help ge Ge KM C amp er x is Sp t i oj xl Tag Value Channel Comment JL Input 7 Digital Input O Digital Input 0 CHANNEL JL Input_7_1 Digital Input 1 Digital Input 17 Resources DL3 0 27 Digital Input 2 CH Cards DL3 0 32 Digital Input
59. Be sure the option Connection at Initialization AT CGDCONT 1 1F WEB PRO D I startup is not activated PIN Code AT CPIN n T Make d Tag of the DCV Debug Modem GPRSconnect GPRS Operator Phone Number amp TD 33 7 1 Change it to 1 to activate GPRS z Change it to O before sending The server requires authentication SMS With this configuration when de activating GPRS it is also possible to use the receive SMS See chapter 11 Read SMS Embedded Version 2 07 CS L TWinSoft User s Guide 57 GPRS IP settings GPRS represents a TCP IP connection using GSM network It then requires a TCP IP configuration COM4 GSM MODEM Parameters DM ACY Advanced TCP IP Obtain IP address automaticaly Use IF address IP address IP address 202 EE 110 Obtain DNS server addresses automaticaly CO Use ONS server addresses DNS server addresses Using TWinSoft to communicate to a RTU in GPRS Obtain IP address automatically You work with dynamic IP address which is provided by the Operator at the connection Use IP address You work with fix IP address it corresponds to the SIM card you use Obtain DNS server addresses auto The Operator provides you with DNS Use DNS Server addresses You want to use specific DNS addresses Typically you will access TBox MS from a LAN using an Ethernet connection if your LAN has a Gateway connection to Internet
60. Bus device ModBus Protocols This features routes ports configured in ModBus protocol s ModBus RTU ModBus RTU ModBus RTU ModBus TCP Routing 2 ports in ModBus TCP is called IP forwarding see next chapter Communication principle The idea is that the TBox MS receiving frames analyzes the Station address if it is for its own use it keeps the frames otherwise the frames are pushed to the routed com port E 2 Routing using TWinSoft ModBus rerouting allows associating two ModBus RTU communication ports in order to access a remote RTU with TWinSoft from your computer by rerouting through a Master RTU The typical application is dialing an RTU to access a remote RTU connected to the RS485 network f TWinSoft RTUT tws Alarm Management fa File Edit View Pini Tools Window Help 1 ST Ki E PC Setup Se RTL Identification Tags a a n Ee Send Program ChrI F9 LC IP Parameter Start Stop Program ES Programs Set RTLI Time ER Program equality ES J Data Logging J Periodic Event Upload d You access routing from the main menu of TWinSoft Communication gt Routing 21 High Speed T C Web amp Reporl Routing Terminal Version 2 07 a TWinSoft User s Guide 150 Address Address of the RTU you are physically connected the Master Routing Request Addess 1 2 OK Timeout Rx timeout used to communicate with the Remote
61. DNS addresses when connecting If this is not the case they provide you with a Preferred and Alternate DNS address You can declare several ISP entries Then they can be used in redundancy through the sending of e mails You are allowed to define several SMTP Servers see next associated to different ISP s Creating the alarm recipient you can select the Redundancy option E re TWinSoft User s Guide 82 9 2 FTP Host FTP stands for File Transfer Protocol When subscribing an account to an ISP usually you have some Mbytes to your disposal for sending files The FTP host represents the target when sending files The directory where the files are sent is defined in the Recipient see chapter 9 First TBox MS connects to Internet through a connection ISP Ethernet or GPRS and then sends the files FIP Host FTF Parameters Huntime Parameters Host Name It IS a free name to recall when you create the alarm Hast name TBoxF TP recipient Host address ftp tbo biz Host address text and IP address are accepted Connection MulSP Connection You select the way to TCP Port El Use default part connect to the Server ISP GPRS Ethernet Login information TCP port Each TCP IP service has its Anonymous Login own unique TCP port It provides a logical location for the delivery of User name TCP data TCP port used by TBox MS to Password establish FTP connection default 2
62. IF you feel unsure about the changes you are doing use the Default button to restare the default parameter values Remote Tags US ls Environment Variables Startup Alarm sampling Tables Temperature Time Weekly Day Monthly gt Daily When daily is selected in sampling table it is the time of the day the recording is executed gt Weekly When weekly is selected in sampling table it is the day of the week and the time the recording is executed gt Monthly When monthly is selected in sampling table it is the day of the month and the time the recording is executed Version 2 07 a TWinSoft User s Guide 40 6 5 4 Temperature For Temperature analog input PT100 or PT1000 you can define a unit Celsius Fahrenheit or Kelvin 6 5 5 Remote Tags Reset the device Trigger only if success When communicating as Master p a P The unit is the same for all inputs using Remote Tags a Trigger is associated to the device the RTU communicate with see Remote Tags This Trigger activates the communication according to a State or Edge Working with Edge the RTU restores automatically the Tag after the transaction s With this option active the Trigger is restored only when communication has been done successfully Without this option the Trigger is restored when all Remote Tags associated to the device have been executed with or without er
63. IP address used by TBox MS during its GPRS connection The information is available in a DWORD but in the list of Tags you can display it as an IP address from the list of Tags right click the Tag gt Display as gt IP address This information is very important when working with dynamic IP address It can be sent for instance by e mail see Report Studio to inform on IP address changing Version 2 07 CA wm Gm s TWinSoft User s Guide 56 About sending alarms with GPRS With GPRS you are able to send e mail or files using FTP You create recipient s associated to the SMTP or FTP server you have associated to the GSM GPRS Working with a manual connection first the RTU establishes the connection and sends the mail and or files Then it stops the connection If the connection was already established the RTU maintains the connection Working with an automatic connection the mail and or files are sent immediately and the connection is maintained For sending e mail you need to use the SMTP server specific to the GPRS connection Ask your GSM operator Example wth Mobistar gprsmail mobistar be Sending of SMS with GSM configured in GPRS It is possible but only with manual connection when handling GPRS connection from the Ladder BASIC logic COM4 GSM MODEM Parameters DEY ACY Advanced TCP IP To use this feature you have to control the GPRS connection manually Modem Type S
64. ModBus Address is discussed in chapter 8 3 8 2 3 Text Internal Variable The Tag TEXT uses ASCII character encoding ISO CEI 8859 1 of the Latin alphabet To create a Tag TEXT string of characters from the list of Tags click Add a Tag Select Text e Digital Sc IP Parameters Analog Programs Text Alarms TWinSoft User s Guide 73 Version 2 07 Bs The Definition menu pops up Format Text Output Modbus Address 20494 Sze 4 f Initial value this is an initial value Version 2 07 CA wm Gm s TWinSoft User s Guide 74 8 3 ModBus address The ModBus address is the link to the outside world When equipment must sample Tags in TBox MS it uses its ModBus addresses like Zeta SCADA or TWinSoft Each Tag has a unique ModBus address By default TWinSoft proposes a ModBus address You can change it if you want While being On line the value of the Tag can be displayed only when TWinSoft has sent the program to TBox MS The Tag is then available for the outside world at the ModBus address vou have declared 8 3 1 ModBus address of System Variables With System Variables it is a little bit different they have two ModBus addresses One internal and fixed ModBus address that you don t know That explains why when you are connected to TBox MS even without sending a program you still can see values from the Resources One user ModBus address that you are all
65. Naim eR 101 10 7 MESSAGES ainena AEE E E EET E O E 102 10 7 TL Value or Tag iia IMCSSAGC na a obe Dee deg uod Rec Eale tu teas 102 10 72 SEPIA Mha message eo ceva vio tutte vid eat Pra c PEDI EE PEE SE qa Fork eas Deva ERO DUE N E EET IY S rl ERE EVE DI ud 103 EENHEETEN a Rh 104 10 615 TINO SSN COS ee 104 10 0 2 ele 104 AR e enee 105 JTULO AINME E 106 10 92 COMM NS GC CSCHDU ON D 106 LI READ SMS EMBEDDEDLEiSuxais cuvE danas eegene 108 AT dep IVT OG UCU ON ME 108 11 2 Acknowledgment of an alarm by sending SMS to the RTU eren 109 ITZ es SU ucture ortpae message EEN 110 11 2 2 Acknowledgment of the message esee nennen nnne nnns 110 11 3 Controlling the RTU using SMS message or reading e mail using POP3 111 11 4 Automatic Update of a Recipient s tel numbaer eee eene rn nnn 115 TL Dv ROSdOSIMO SUUS a na E add e E pl va La D ARRA RR VERDE 115 12 E dE TEE 116 T2 ee el e EE 116 EE 118 12 2 T Digital cnrorol gle5 cian decode bove ei tdt bed cox ida prre toO ves Cdu EE Opt LUND PEU DEE 118 12 22 Ee ee neie wl 118 12 5 Te SafriDIIng tables EE 119 L3 REMOTE KEE 122 E Ee ee ET e i ton ace osten o tan tK E RR ata ata 122 43 2 CTCALING a Remote EE 123 13 3 Creatilig a Remote EE 124 Version 2 07 2 TWinSoft User s Guide 6 13 4 Remote Tags through Modeni asriar nii iani E T RENE RENE i 126 13 5 Timing configuration of R
66. O click Add an I O card EE M5 16D10 1 E E System variable MS GDOR Remote TBox a 222x C Timers dbi i CPU 3 7 Counters MS 4450VC 4 ES IP Parameters MS COMBO 1 ModBus device a TBox MS ER Programs eT TBox LITE or any ModBus 3 alarms 1 vice J Data Logging pease E Y e Madbus Device 1 J Remote Tags Loon ulus j ra p vindi ic geg de me aah A m mt w UO Remote Device l Name You type any name It will be Type Modbus Device available in a list of available Mame TBoxtt2 equipment when creating Remote Tags see next Address 2 g Address It is the ModBus address of the Remote equipment It must be different from the TBox MS and possible other equipment on the same network ATU Pot COM2 RAS485 v Trigger RTU Port The communication port used by TBox MS to communicate Condition Positive Edge with the remote equipment 2 Negative Edge High State C2 Low State Tagname Trigger com Trigger Select a digital Tag that will trigger the communication according to a Condition see next Working with several equipment you can declare different Tags and then control differently the communication to each equipment The Trigger must be a digital variable DIV Condition Condition of Tag Trigger to start communication Typically you will work with a permanent connection Trigger in High or Low state Or you can decide to execute one shot commu
67. OM5 PSTN MODEM Using the button Import gives you MH ame Phone number 01 23456789 Se pL L access to an existing ISP configuration Bel Pen ATDT you have tested successfully on the PC A good piece of advice amp Username john Confirm password ee Obtain ONS server addresses automaticaly C3 Use DNS server addresses DONS server addresses fF i Name It is the name of the provider Modem a connection to an ISP is always carried out through modem Select the modem Phone number It is the phone number of the provider the TBox MS must dial to send an e mail or files Dial Prefix The default dial prefix to connect to an ISP ATDT It should not be changed unless the modem needs a particular configuration If TBox MS is placed behind a telephone switch the outside line prefix is defined in the modem properties it should not be added to the dial prefix see chapter 7 2 2 Version 2 07 N a TWinSoft User s Guide 81 User name Password DNS Version 2 07 It is the name of your account needed to access Internet usually it is given by the ISP It is the password of your account needed to access Internet usually it is given by the ISP A DNS converts names in IP address It is needed in case the Server SMTP FTP NTP POP3 is indicated in text and not with an IP address More and more ISPs support dynamic DNS they provide the
68. Reset e Let the LED flashes 3 times it dae e Release the button DE GAN Mee The global reset mode is indicated by the LED flashing at 0 5 Hz instead of 2 Hz in RUN mode In this mode the TBox MS is configured as follows 4 7 1 MS CPU16 Global reset configuration COM1 RS232 COM1 RS232 9600 N 8 1 COM2 RS485 9600 N 8 1 ee a pm COM3 Ethernet ModusTCP 1 MS PSTN M GSM obs 1 RS232 modem maintained ModBs 1 RS232 loal 9600N81 j Modus 1 1 current IP address maintained up to OS 3 04 381 2 192 168 1 99 as of OS 3 05 xxx 4 7 2 MS CPU32 Global reset configuration COM1 RS232 9600N81 A Modus 1 gt COM2 RS485 9600N81 Modus 1 COM Ethernet COM4 Ethernet Po rE MEMMCUNEMy MS PSTN M GSM ModBus RS232 modem RS232 local 9600 N 8 1 Version 2 07 N TWinSoft User s Guide 27 The Global Reset does not erase the current program Doing an ordinary Reset will restart the program 4 8 Upload Operating System Operating System is the heart of your TBox MS It contains all features of TBox MS In some case you might have to change this operating system when new features are available of a bug fix released Tools Window Help pep F Set a amp From the main menu select Upload OS us RTLI Ide
69. Revision 2 Custom Software Options 255 Extended RAM memory 256 KB ATU Id FOO61 1 000000 Unique ID of the RTU MMIC Card Hot Present i MMC Last operation I NT em p The media of the PC is indicated and the access level of your connection see chapter 16 Security If a connection cannot be established with the TBox MS it might be because the configuration of its port does not fit with the PC setup you use different Baudrate different IP address protocol other than ModBus To set the TBox MS to a default configuration you have to do a global reset see next Version 2 07 CA wm Gm s TWinSoft User s Guide 26 4 6 Reset of TBox MS Pressing the button Reset restarts the program stack of alarms and stack of events are erased datalogging is maintained Tags with initial value are set to their value others are maintained Timers are reset status and value Counters are maintained 4 7 Global reset of TBox MS The Global Reset is used to set TBox MS in a default well known configuration in case it does not communicate anymore Your program running in the CPU is stopped and TBox MS runs on the Operating System This is very useful when you take a CPU from the shell and you have no idea how the port you want to communicate with is configured The global reset is achieved using the button on the front side of the CPU Procedure e Push and maintain the button to the Reset side Stop Run
70. SEI EE Protected Ports Type COM AS ese come R5465 COM ETHERNET COM4 PSTN MODEM COM H5232 485 Global code type in the code you used to generate the Access Codes with the utility PASSWORD EXE see chapter 16 3 following Type it a second time in the Confirmation field to be sure TWinSoft presents you all the communication ports according to your hardware configuration Next you check the port you want to be protected 16 1 2 Port Properties Access level on serial and modem ports can be checked using the Communication Variables see chapter 7 3 Version 2 07 CS Ss Lu TWinSoft User s Guide 132 16 2 TWinSoft document protected Opening a protected document 1 Once a document has been protected see above when opening it with TWinSoft you are prompted to type a login x 2 Type the NAME and PASSWORD you have created with the Password generator see below 3 Click OK The different access levels are not supported when opening a document Any acceptable login wil be supported If you click Cancel TWinSoft wil indicate the document is protected and wil open a new document Version 2 07 SS TWinSoft User s Guide 133 The utility program Password generates access codes 16 3 Password utility When installing 7WinSoft Suite a password creation program named PASSWORD is installed in the same directory as TWinSoft It can be started from the Start button o
71. TU LED Al flashes once LEDs on 7Box MS32 System xml settings only transferred to the RTU Information available at start up of the CPU Flashing during transfer from RTU to MMC LED RUN LED Er RTU identification Data relative to MMC is available in RTU identification window Version 2 07 RTU Information Item Mame Device Type UG Version Status Address SubAddress Modem IP Address LAN IP Contig Access Level Date Time Program Program Version Programmer Program Upload D ate Program Cycle Hardware Version MMC Card MMC Last operation ON during transfer from the MMC to the RTU Value HTLI3 TBosh5 3 04 Build 380 Jan 12 2006 11 00 38 Loader 2 071 Program is running 0 0 0 0 0 132 158 1 38 255 255 255 0 0 0 0 0 Engineer 12 01 2006 11 21 45 1 12 01 2006 11 13 57 10 msec Present The ATU was updated from the MMIC TWinSoft User s Guide 146 Appendix D Pack amp Go D 1 Presentation Pack amp Go is a tool that builds up one file with your complete project including TWinSoft document WebForms Reports OS loader The goal is to backup or to transfer a complete project without missing files or to update an RTU with the complete project without requiring advanced knowledge of TWinSoft All files are compressed and packed into one file with the extension tpg TWinSoft Pack amp Go Once a project is packed it can be unpacked
72. ables EE 64 Yes AO S E C O O EE 67 8 Tacs 68 INDE vai cec VO Aiea a ee ae 69 8 2 Internal Variables Registers vis senta aui av y ak peg va RU Rye au ko Hy ERRARE FERRE TEE wate 70 8 2 1 Digital tege KE E Le 70 8 2 2 Analog Internal Ne EE 72 923 E en EUR E e EE 73 06 2 MOGUBLIS GOGICSS EE 75 8 3 1 ModBus address of System Variables esses 75 6 4 Tags Presentation Ee 6 Gee ROM TIME i m TER 875 Le Alani GENEE 78 EEGENEN 78 9 59 93 P eu 79 9 IP RRE Regen 80 9 To TSP CORNI UNI O viscera cntvsuin 81 DM Id uisi ata santa rcm 83 Bo SIL EU SIV Cl e 84 9 31 ADOUCREGUNGIN CY EE 85 EE Dee EE 86 Version 2 07 a TWinSoft User s Guide 5 9 4 1 Alarm Acknowledge Through POP3 eene enne rmn nnne nnne nnne 87 0 5 dV LIP DOI VEL eelere geet 89 esos de EE HEEN 89 OD LV Sim MI E LIMES CL 90 9 o Ee ROW to copndure DVBDNS IlD TBOX d ei veribev co Ducere ee CEP Drei del Gee ti Eo Ver cox ee ceteri 91 LEE 92 TOL Do MVOC CU ON EE 92 10 2 DIGANTO CON UUO s ia ERE ec eibi o x Sm vd RERO ER D vo E PDA 93 EE 95 10 4 RECIO T S 97 10 5 Dynamic Change of recipient tel number or address 100 10 5 1 Dynamic changing of telephone numbers eeeeeeeeeennn nmm nens 100 10 5 2 Dynamic changing of ONE e mail address 100 10 60 GOUV OF
73. ajor topic you will not find in this manual concerns the programming of Process TBox MS supports BASIC and Ladder languages for developing any advanced process Those languages are detailed in another manual BASIC and LADDER for TBOX Another important feature which is not presented into this manual concerns the development of HTML pages to use TBox MS as web server This matter is explained in details in another manual WEBFORM STUDIO Getting Started Another software part of the TWinSoft Suite is Report Studio for creating e mail report or files to send It is explained in the On line help of Report Studio Version 2 07 a TWinSoft User s Guide 12 2 The Hardware Concept TBox MS is a Modular System A RTU TBox MS is built up using Racks and Cards Depending on your needs in communication s and in Inputs Outputs you select the cards required 2 1 The Racks Racks are made in aluminium alodined giving a very good electrical conductivity and equipotentiality There are 4 models of Racks gt 5 slots gt 10 slots gt 15 slots gt 20 slots Version 2 07 ES TWinSoft User s Guide 13 2 2 The Cards Cards are formed of a PCB mounted in aluminium enclosure which assures the best shielding against receiving and emitting noise radio emission electromagnetic interference Bare aluminium inside the enclosure and on the edges assures a good contact for the ground signal of the PCB betwe
74. an be useful to retrieve a complete project to copy to another CPU 3 You insert an MMC with a program in a CPU In case of differences between MMC and CPU programs MMC has always priority Both programs are compared dates are compared When dates of creation of the program are different the program including OS is copied from the MMC to the CPU Version 2 07 CA wm Gm s TWinSoft User s Guide 144 4 You program the MMC directly from TWinSoft A menu in TWinSoft allows storing the project to the MMC With Plug amp Go menu TWinSoft compiles the complete project into a file called Plug amp Go bin You then copy this file to the MMC using a Card Reader on your PC The advantage is that you don t need TWinSoft to program the RTU You can distribute the MMC to the people installing the RTU Menu of TWinSoft Zu TWinSoft proto 984 tws Gen E C Mew Ctrl M G Open Chr 27 Save Chrl 5 Save S ooo oe ee OES ee eee eee MEO c N04 Export j Import d RTU Properties Chr Compile Program Fo Compile Prog TWinSoft Plug amp Go Libraries dn Print Ctrl F amp Print Preview Ctrl F Include Program Source Prink Setup Plug Go Version 1 00 Build 100 1 proto 334 tws testEmail tvs Jan 11 2006 16 46 06 TEoxMlS 3 prota tws l 4 proto bus 16384 Version 72 01 Build 110 Date Mov 14 2005 12 15 21 134005 Version 3 04 Build 370 Date Jan 10 2006 10 18 55 Exit 1609 266
75. appear in the window To receive some interesting information with this mode you should force some communication from your RTU through the modem like a reset of the RTU triggering an alarm Version 2 07 SS TWinSoft User s Guide 157 G 2 TCP IP debugging with MS CPU16 This feature is very convenient to trace problems when doing TCP IP connections e mails POP3 FTP It informs on the different steps of the connection Login to the ISP obtain of DNS Smtp communication It is based on 3 System variables TcpIpLog PortIdLog and EventLog Procedure 1 One System variable must be Tagged Analog 25 EventLog Keep the ModBus address as it is 22080 Do not change it It is not necessary to Tag the 2 other variables 2 Make the following lines of Ladder This line activates Debugging process Example on debugging through MS PSTN modem COM4 As you can see we use the system variables without having Tagged them brown color You can also Tag them if you want 3 Once the connection is finished look at the trace from the Communication menu Zu TWinSoft SMTP tws General fa File Edit View ieee Tools Window Help EI X E PC Setup EE gg I3 Fai d as eat ETU Identification Tags a Resources Ee Send Program Cbri F9 GG to Start Stop Program H E va Set RTU Time B a Card Program equality E er J System v Download Digital Chronology Lj Digi
76. application to TBox MS it is first compiled and then sent in the same sequence 4 10 2 Compiling an application Compilation converts the document into microprocessor code You can execute it e Use the icon ee of the main tool bar e Use the accelerator key F9 The result of the compilation is available in the Results window This windows automatically pops up when there is a problem but it can be opened manually e from the main menu View gt Results e using the accelerator keys lt ALT 2 gt The Results window provides useful data Information indicated in black Warning indicated in bold dark green Error indicated in bold red Test of memory still available The result window also displays memory still available CPU 16 ROM 32 kbytes ROM 512 kbytes RAM 48 kbytes RAM 320 kbytes Application Ladder BASIC 64k Application Chronologies 64 kbytes Sources Web amp Report Sampling Tables 256 kbytes as of OS version 3 10 470 with S N 010000 of MS CPU16 CPU 32 FLASH 16 Mbytes SDRAM 64 Mbytes SRAM 1 Mbytes SD 1 Gbytes Boot Loader Linux OS Running part of 768 kbytes Datalogging 1 Gbytes Application Sources Linux OS and 5se kbytes log file Tag Sampling Tables Web amp Report Application value backup Version 2 07 N TWinSoft User s Guide 29 4 10 3 Sending an application In order to have the TBox MS running with the program you have developed
77. are dongle You are able to develop a complete TBoxMS project without any restriction but when you send the application to TBox MS it will stop after 2 hours This is a good solution for testing programs or creating a demo A 2 The Dongle It is a hardware device placed on your PC The dongle consists in a USB key TWinSoft regularly checks the presence of it It allows you sending applications to as many TBox MS as you want with any PC A 3 The Code License Available from the menu Help gt License Register Using information of the PC the Company name the User name a Serial Number we create a code that you enter in the License field Once entered you can send any application as if you had a dongle see previous The only restriction is that it must always be on the same PC If you wish to use another PC you have the possibility to remove registration on the first PC and register back on the second A 4 The TWinSoft LITE Available from the menu Help gt TWinSoft Lite configuration This protection mode is ideal for users having one or two TBox MS units The dongle or a license might be too expensive TWinSoft LITE code is linked to one TBox MS it allows you sending an application to the TBox MS for which you have the code Version 2 07 a TWinSoft User s Guide 140 Appendix B Time in RTU One of the biggest issues in Telemetry and data logging equipment is the handling of time In orde
78. are or software Advanced Parameters 2 Sending of Prog ram This page contains advanced parameters Extreme care should be taken when changing these parameters IF you Feel unsure about the changes you are doing uze the Default button to restore the default parameter values See also chapter 4 6 here above Remote Tags TCP IP MAT Rules Web and Report Environment Variables Compatibility Head SMS starts top Power Fail Alarms Sampling Tables Temperature Reset all physical outputs Wat start of alarm condition Sample analog Lis at each program cycle Stop Reset all physical outputs at program stop Disconnect Modbus addresses at program stop Stop program with stop button ee SE IT L 4 WEEN E s TUE c r ee eee o e ppp e N piin seii a L amt PLE ess B EX LM LT Under those conditions two mechanisms of the RTU can be customized START Reset all physical outputs at program start when active at startup the RTU reinitializes the outputs to 0 After that the outputs are monitored according to the process When not active at startup the outputs are maintained to their last status After that the outputs are monitored according to the process Wait start of condition this feature relates to alarm condition The mechanism of generating alarm is based on transition the changing of a digital Tag or the overstepping of an analog threshold Version 2 07 a TWinSoft User s Guide 36 This option a
79. ation Write Remote Tag Tag Presentation Description Units decimal Write allowed Version 2 07 Presentation Description Output Flow Units L min H dec 2 Write Allowed makes the following information available to Report and WebForm in a Report text displayed as Header in sampling table or as Tag information in chronologies when the data is retrieved text displayed as Unit in datalogging when the data is retrieved It can also be displayed when selecting as format Value unit in the report or WebForm the quantity of decimals of the value displayed if the communication port to access the Tag is protected see chapter 16 the proper access level is required to modify the Tag With Engineer access level the Tag can be modified without restriction 3 a TWinSoft User s Guide 76 8 5 Run Time Parameters Run time parameters feature allows accessing some TBox MS configurations through Tags in order to modify them on line For instance to change a tel number of a SMS recipient the e mail address of a recipient the address of SMTP server the handling of a alarm condition When a configuration provides access to run time parameters a tab is attached to the configuration Example with Alarm Recipient Alarm Recipients Name 5MS5 Jean es rt Reci
80. ation line cord e Do not use your TBox in a wet environment e Using this instrument in a way not specified by these instructions can impair the equipment safety Do not operate the instrument outside its rated supply voltage and environmental ranges e Do not open power supply unit There are no user serviceable parts inside Do not connect or disconnect any connector when powered Protect your TBox from environmental hazards such as dirt dust food liquids excessive temperature and sunlight overexposure The protection Rating of TBox is IP30 e Keep your TBox away from direct or excessive moisture or rain and extremely hot or cold temperatures to ensure that the TBox is used within the specified operating range e Make sure that only fuses with the required rated current and of the specified type are used for replacement e End assembler must take appropriate precautions if the equipment is mounted on a wall to ensure the equipment is safely mounted in order to prevent the risk of detachment e End assembler must take appropriate precautions in order to prevent risks of electrical shocks if plugs to be connected to MS RELAY MS 8DI 120V or MS 8DI 240VAC are erroneously plugged to connector of another kind of card like MS 8AI 420 e Caution Risk of explosion if battery is replaced by an incorrect type Dispose of used batteries according to the local regulations Version 2 07 2 scu TWinSoft User s Guide 3 TABLE OF CONTENTS PRESENT
81. ayed in the Status bar I If Save password is checked and TWinSoft is connected to a protected port when TWinSoft starts it uses the access level corresponding to the password saved see the status line If it is not checked and TWinSoft is connected to a protected port TWinSoft starts in Read only mode You need to do a Login to get your access level Version 2 07 N TWinSoft User s Guide 135 Logout If the TWinSoft is connected to a protected port the Logout sets TWinSoft in Read only mode 16 4 2 With Internet Explorer Through a modem connection you can access TBox MS as Web Server From Internet Explorer you use the tool TBox Dial It to dial TBox MS directly TBox MS is then considered first as an ISP and then as a Web Server To connect to an ISP you need to login TBox Diallt ke Connect to Atlantis 7 HEN Cancel Login Hame J EAN Password ai Save my password You type the NAME and PASSWORD you have used with password utility see above Even if TBox MS is not protected type a NAME and PASSWORD Depending on Windows and IE version they will not allow a connection without login Version 2 07 CA wm Gm s TWinSoft User s Guide 136 16 5 Deactivating protection of TBox MS There are two methods of deactivating TBox MS access protection Global reset see chapter 4 7 The first method is by performing a global reset which must be done on site When the program has stopped t
82. be displayed from the main menu Communication gt Download gt Alarms The object Alarms used in a WebForm displays the Event stack It corresponds also to the list of Alarms sent to Zwew Alarm stack is an internal stack used to buffer alarms when there are several to handle SMTP From when receiving an e mail from TBox MS the field From indicates the origin of the e mail It accepts any text and the following parameters station o replaced by the name of the station see General properties 9 oemail9 o replaced by the e mail address of the RTU Example TBox_ station lt email gt SMTP subject when receiving an e mail from TBox MS the field Subject can be dynamized like following When sending a message the field Subject contains the message It accepts any text and the following parameters 9 ostation9 o replaced by the name of the station see General properties 9 oemail9 o replaced by the e mail address of the RTU 9 otime9 o the time of the RTU when the e mail was generated Example Report TBox station time Version 2 07 a TWinSoft User s Guide 38 When sending a report the field Subject contains the Title of the report see Report Studio title that can contain the parameter 9 ostation9 o as of TWinSoft 10 00 and OS 3 12 GSM amp Printer message when TBox MS sends a SMS you can add information to the message This information is sent in front
83. bles allow manual handling of GPRS and give information on the status COM6 GSM MODEM COM6 GSM MODEM EEN Parameters DCY ALY 5 Advanced TCP IP Parameters DEY ACY Advanced TCP IP Tag Address Comment lt COMB NoReply gt NoReply No Reply Address COME Level Level Protection Level Comment lt COM6 OfHook gt OtH ook Modem Off Hook e COME Usel Used User ld COME Call Call Modem Online Call Se B al Tim COME Answer Angier Modem Online Ans GPRS State 1 IP Address j JL COME BGPRSCan GG Lon GPRS Connect 1 CH LI LILILILA LI OO OO ELI EE lt COMB ModemeE rror Modem or Modem Error H WE S E T NM TI ET eee Ew ttr T TS MR men AF r3 mb 4 en de TU mau T Es UT umm LU ECT M Digital Communication Variable COMx GPRSCon GPRS Handles the GPRS connection Working in manual connection writing 1 forces a connection writing O forces a disconnection When working with automatic connection if you reset this variable the connection will stop but after maximum 5 minutes it will be automatically restarted USE A TRIGGER INPUT CONTACT TO ACTIVATE THE VARIABLE Analog Communication Variable COMx GPRSState GPRS indicates the status of the GPRS connection Value 0 disconnected Value 1 currently connecting Value 2 connected Value 3 currently disconnecting COMx IPAddress GPRS this register gives the
84. cknowledge the alarm without option Call all recipients any recipient can acknowledge the alarm Don t set the time out too short to allow time for the SMS Center to send the SMS back to the CPU in case the service is busy Also if the CPU is sending a SMS while an acknowledgment SMS is coming in it will miss the warning from the MS GSM module The SMS will be stored in the SIM card and will be read at next auto check from the CPU max 5 minutes 11 2 1 Structure of the message If the option SMS acknowledge has been selected the RTU will send a header with the message including an identification number Example A00056 Level too HIGH prefix fixed A precedes the absolute identification number of the alarm 00056 absolute identification number of the alarm suffix fixed message message associated to the alarm 11 2 2 Acknowledgment of the message By sending the same header syntax to the RTU you will acknowledge this specific alarm Typically this can be done using the option Reply of the mobile Verify that your mobile also sends the original message Example A00056 Level too HIGH Reply YES The text sent to the RTU does not matter as long as the syntax Axxxxx is sent Some Tags are very useful to monitor the acknowledgment of the alarms by SMS AlaErr SmsState CallerlD see chapters 7 3 and 7 4 Version 2 07 a TWinSoft User s Guide 110 11 3 Controlling the RTU u
85. combine one or several data Password acknowledgment ID writing values directly to ModBus addresses It must always start and end with the character Examples START PUMP P1568 A00056 START PUMP W20480 123 The maximum number of messages supported is 20 In case you need to monitor more process you can use the direct indirect addressing see next Message sent by e mail A message must include the RTU Id of the TBox LITE preceded by the letter I and a pre defined message It may also include an acknowledgment ID It must always start and end with the character Examples T460000020107 START PUMP 1460000020107 A00002 START PUMP Version 2 07 E EI TWinSoft User s Guide 111 2 Writing Tag with Direct addressing W You write a value directly to a ModBus address Syntax Wmodbus address valuel Example W20480 123 This message sent to the RTU will write value 123 to the analog Tag with ModBus address 20480 1 You can combine several texts separated by a coma For instance W20480 123 W20481 456 2 ReadSMS checks the access protection level of the port before writing see point 5 below and also the Write configuration of the Presentation of the Tag see chapter 8 4 3 Writing Tag with Indirect addressing analog N You write a value directly to a ModBus address representing a pointer Syntax Nmodbus address value The value at modbus address corre
86. d log adds any IP information sent received by MS CPU16 It allows extended tracing of TCP IP connection Debugging uses Analog Chronology table Check its size is sufficient see chapter 4 1 General RTU properties 6 5 7 Environment variables The environment variables are used when particular configuration might be needed in external software Available only when sending historical data through tma file TViewPath path The path in which the station will be created when importing data in view The path is the relative path from the Project workspace of view Example with the Value Lines 10 Result in Zv ew F New TViee Project tvp View File Edit wiew Tools Help Se ve EE E 4 Workspace S Mame Add an object Longname Type any long The name typed here will be used in Zwevw instead of name the one declared in the General properties which is limited to 8 characters Version 2 07 SS TWinSoft User s Guide 43 6 5 8 Power Fail Working with a backup battery available on MS PS230 and MS PS DCN the RTU informs you when the main voltage is out of order and the RTU is powered from the battery A variable informs that the main power broke down Example from the MS PS230 value Chan Comment y From the list of DI available with the card you Tag the one J indicating the power failure DL 1 0 1 4 GE 22322905 TAIETE fm a LEN S l Remote Tags TEP
87. dBus address Syntax Rmodbus address Example R32 The SC Tag at ModBus address 32 will be reset to O F ReadSMS checks the access protection level of the port before writing see point 5 above and also the Write configuration of the Presentation of the Tag see chapter 8 4 9 Changing a telephone number T You change the telephone number of a recipient using its index number see list of recipients in TWinSoft Syntax Tindex telephone number Example T05 0123456789 You replace the telephone number of recipient 5 with 0123456789 1 Maximum length 21 characters 2 ReadSMS checks the access protection level of the port before writing see point 5 above 10 Writing minutes since midnight into a register h To write in an analog register the current number of minutes since midnight at the moment the message Is received Syntax Wmodbus address hi Example W20482 h If the message is received at 15 23 the value 923 will be written at ModBus address 20482 ReadSMS checks the access protection level of the port before writing see point 5 above and also the Write configuration of the Presentation of the Tag see chapter 8 4 Version 2 07 CH wa e ws TWinSoft User s Guide 114 11 4 Automatic Update of a Recipient s tel number An existing recipient of type Pager SMS can be updated with the telephone number of the person calling the RTU The idea is that the RTU verifi
88. de 9 Calling Waiting CONNECT 10 RING arriving 11 Answering Wait CONNECT The last value is maintained until the next status changing MODEM variable which indicates the caller ID of the current incoming modem connection 32 bits format giving the 9 last digits of the calling number It can be used in the program to trace and control who is calling Init string of GSM modem Caller ID identification must be activated Add at the end of the init string of MS GSM AT CLIP 1 LowPower used only with Low Power RTU E Ek TWinSoft User s Guide 61 7 4 System variables The system variables have pre defined functions They are very useful to check or to act on features of TBox MS They are divided into Digital and Analog 7 4 1 Digital System Variables According to its function a register is Read Write or Read only In the following table the column R W indicates Read only Write 0 only Write 1 only Write OU or 1 Ho When the action SET is specified it means that the TBox MS maintains the variable at 1 to be sure it is detected With such a variable you need then to reset it using Ladder BASIC logic Index Name 0 TikSec 1 Prgkun 2 NewPro 3 Reboot RstWat 5 Ala On 6 Alaerr 7 RstAla EnaDCr 9 EnaACr 10 EnasSam 11 EnaAla 12 Driecred 13 DisCra Version 2 07 R W 0 Description Tik Second Changes of state every second Useful for counting time Program run At
89. default 9600 N See chapter 7 1 1 Ethernet check the IP address you have given to your TBox MS see chapter 7 1 1 and that it is in the same subnet of the PC or accessible to the PC Modem check the tel Number of TBox MS See chapter 6 1 4 3 PC Communication Set up To communicate with the TBox MS you need to select a communication media on the PC From the main menu of TWinSoft gt Communication gt PC Setup Communication Properties x 3 Odffline eem oe Local RS 232 PC Seral Port COMT vt BaudHate st Cy TEPAP Ethernat IP Address 192 168 1 99 ATU COM Always use IP address of the ATU Don t change Ip address after program upload a 2 Modem Answer Incoming Calls Modem Properties Dialing Properties 9 7 LJ y e 8 13Nu3H13 V Lindint d i A Farar s EF pl Er RTU r Example with a RS232 connection default Baudrate of TBox MS 9600 N 8 LNdNi TVLISIG 8 LNdNI TVLIOIG LndLino TV LIOIG Version 2 07 CA wm Gm s TWinSoft User s Guide 22 4 3 1 Communication possibilities of TWinSoft The different communication features of TWinSoft are e Offline this option avoids sampling TBox MS e Local you select a serial port of the PC typically RS232 The Baudrate must fit with the port of TBox MS you are connected to lt If your PC has a USB port you can use a
90. device Help Route from incoming communication Route from ii lot plod om x TWinSoft is connected to iv US to outgoing communication port the port of the Master connected to the remote device Timeout Lancel O Stop Routing Sequence to access a Remote RTU in rerouting gt Open in TWinSoft the document corresponding to the Master RTU gt Fill in the Routing request menu as explained above Open in TWinSoft the document corresponding to the Remote RTU if you were using modem communication you will have to redial the Master You are in communication with the Remote TBox MS This sequence is only possible when Master and Remote are the same model of RTU If not you have to pre configure the Analog system variable see next Analog System variable Rerout An analog system variable Rerout can also be used in your Ladder BASIC logic to force a rerouting This 16 bits variable represents 16 communication ports with the Isb corresponding to COMI Example A rerouting between COM4 001000 and COM 000010 corresponds to the decimal value 10 001010 Rerouting is only possible with local communication ports configured in ModBus Sending a program using Reroutin For instance you can send a program by dialing a Master and accessing Slaves on RS485 network Version 2 07 SS TWinSoft User s Guide 151 Doing a local rerouting for instance fr
91. dix G 1 Tab DCV Digital Communication Variables Dedicated variables with a pre defined function communication error modem online see chapter 7 3 Tab ACV Analog Communication Variables Dedicated variables with a pre defined function time out user ID see chapter 73 gt Tab Advanced Mainly timing parameters required when modem is Master or Slave in a ModBus communication 7 2 3 Adding a GSM GPRS modem Card In addition to configuration described above a GSM modem can be used in 2 modes gt asa GSM data modem gt in GPRS mode COM4 GSM MODEM CH In addition to the standard modem configuration some parameters are specific to GSM Parameters DEY ACY Advanced TCP IP Modem Type Initialisation AT IPR 57600 AT CBST 0 0 1 AT C PIN Code AT CPIN n E The main option GPRS determines the working mode of the card Auto Answer n Finals GSM data OR GPRS C Debug Modem CI GPRS Debug Modem working with MS o Allows displaying all communication flowing through the modem Very useful to debug a communication see details in Appendix G Version 2 07 PEIES TWinSoft User s Guide 53 GSM data settings Initialization should not be changed PIN Code If the SIM card you have inserted uses a PIN code type it at the place of the letter n Example with the PIN code 4896 you should have in the field AT CPIN 4896 including the quotes If the
92. e TBox Mail This software is used to display a Chart view from data logging attached to e mail To store data in a global database you should use 2w ew call your local distributor Administrator rights are required during installation e DreamWeaver Trial version e Report Studio for DreamWeaver Dreamweaver is a standard HTML editor It can be used with the plug in Report Studio for Dreamweaver to develop standard HTML pages that do not use the Activex e Acrobat Reader Software needed to read our documentation e Explore this CD ROM You will find on the CD ROM many information related to TBox MS and accessories datasheets manuals drivers Version 2 07 CA wm Gm s TWinSoft User s Guide 18 3 3 Programs of TWinSoft Suite During installation of TWinSoft a group of programs is created where TWinSoft can be started Windows XP Professional Techno Trade ga Command Prompt m e Accessories e EH mI TestTrack Workgroup k Documentation d a Wind Expl E indows Explorer Winzip EN samples e e Wise Solutions kf TBox Drivers d F Programe e Acrobat Distiller 6 0 Fa Report Studio Fe Documents Adobe Acrobat 6 0 Standard TWinsSoft Internet Explorer ka webForm Studio Settings GA LeechFTP Ry CS Microsoft Outlook Search WI Microsoft Word GA Help and Support Y MSN Explorer ai Outlook Express CT Run i pe Remote Assistance B visio 2000 Boer cleats Ead Visual SourceSafe 5 0
93. e a week e monthly recording once per month The hour of the day the day of the week and or the month are defined once for all sampling tables in the RTU Advanced properties see chapter 6 5 3 Size The size can be expressed on two ways Size the number of records of the table The recording works on the FIFO principle According to the size the duration is updated automatically see next MS CPU16 the size can be of maximum 65535 records with a total of 256 kbytes for sampling tables as of S N 010000 of MS CPU16 MS CPU32 the size can be of maximum 65535 records with a total of 1 Gbytes on SD card Duration you may prefer to enter a number of days and hours in this case the size is updated automatically To adjust the sizes check the available memory with the compile option See chapter 4 10 2 Compiling a program Version 2 07 CA wm Gm s TWinSoft User s Guide 120 Trigger Synchronize each sample on external clock the recording of the value is executed on the positive edge of the Tag selected and not with the clock of the CPU The period between 2 pulses of the Trigger must correspond to a period between 2 recordings see above The latter is used when retrieving the data to compute timestamps using the last time stamps and the period Example of use of external Trigger quarter hour management In some industries every 15 minutes may vary slightly your electric company sends an impulse that
94. e mail SMS report Communication to a remote site RS485 Ethernet modem Retrieving data and consulting the process remotely i Cal Le Retrieving data locally NEM TView SCADA Version 2 07 SS TWinSoft User s Guide 11 1 How to use this manual 1 1 What is in the manual This manual constitutes the essential of TBox MS documentation The On line help of TWinSoft will guide you more precisely again in each configuration This manual first introduces to the hardware concept including nice pictures Then it brings you to the programming of TBox MS using TWinSoft All features are explained using plenty of snapshots for an easy understanding Installation of TWinSoft chapter 3 Starting TWinSoft chapter 4 Properties of TBox MS chapter 6 Adding a card chapter 7 Tags chapter 8 gt IP configuration chapter 9 gt Alarms chapter 10 gt ReadSMS chapter 11 gt Datalogging chapter 12 gt Remote Tags chapter 13 gt Periodic events chapter 14 Information related to Licenses is given in Appendix A All along this manual warn you Read the manual All along this manual inform you with Notes and Remarks What a nice manual 1 2 What is not in the manual Rack and Cards installation technical specifications and cabling of the cards are described in another manual TBox MS Technical Specifications amp Cabling One m
95. each starting of TBox MS this register changes to 1 and stays at 1 as long as the BASIC Ladder program runs This register is used in BASIC Ladder to execute operations only at the start of the program with the help of a positive edge trigger function New program Start of a program flag Changes to 1 if TBox MS has started after having received a new program Changes to 0 after a reset of the TBox MS Reboot complete restart of TBox MS It is equivalent to hardware reset Reset Watchdog the watchdog checks the cycle time of BASIC Ladder program In case it is longer than 1 second it resets TBox MS This Watchdog can be reset to reinitialize the 1 second timer in case of cycle time longer Alarm on this register indicates that alarm is active not ack Writing O in this register causes a global acknowledgment of all alarms Corresponds to a reset of the Alarms stack Alarm in error TBox MS SETs this register when an alarm failed to be sent This means that after the number of tries the alarm has been auto acknowledged Must be RESET by the user Reset Alarm Not used See Ala On above Chronology General enable of recording in digital chronology Chronology General enable of recording in analog chronology Sampling Tables General enable of recording in sampling tables not available yet Enable Alarm General enable of generating alarms Chronology flag that can be associated to any digital chronology configuration
96. ected to CSA O Modem 2 You program you TBox MS through Communication Properties Ethernet and you want to change its IP address Q O fine i GP Local R5 232 PC Senal Fort BaudH ate You type the current IP address of the port of RTU you are connected to When TWinSoft has finished uploading the program it adapts itself automatically to communicate with the IP address of port it is connected to see above Version 2 07 CE m Ge TWinSoft User s Guide 24 3 You don t program your TBox MS Communication Properties through a direct Ethernet connection and you don t want TWinSoft to GO Dine adapt to the Ethernet IP address e PITE Example you access you TBox MS through PC Serial Port ADSL or GPRS TTE L TCP IP Ethemet You type the current IP address of the port of RTU you are connected for instance the GPRS IP address When TWinSoft has finished uploading the program it does not adapt itself to IP address of Ethernet of the RTU Always use IP address of the ATU Don t change Ip address after program upload 4 4 Factory IP address changing IP address When you receive your CPU TBox MS its IP address is 192 168 1 99 255 255 255 0 TBox MS16 does not support dynamic IP addressing DHCP Then to communicate in Ethernet with your PC you have to assure the latter is configured in the same subnet as TBox MS see the LAN TCP IP settings of your PC TBox MS32 supports dynamic IP addr
97. ed when the number of access to a server is unpredictable to balance the use of IP addresses load balancing technique 9 5 1 Time accuracy When setting time TBox MS takes into account the propagation delay This is particularly important when connecting to the server via modem The precision is 1 second Version 2 07 SS TWinSoft User s Guide 89 9 6 DynDNS DynDNS stands for Dynamic Domain Name System It is a service provided by the company DynDNS org offering the handling of dynamic IP addresses When working with GPRS connection using public dynamic IP addresses it is not possible to access the RTU directly as you don t know its IP address The DynDNS service solves this problem each time the RTU detects a changing of its IP address it informs the DynDNS server You then connect to the DynDNS Server that will redirect you to the RTU Example of topology connecting with Internet Explorer to a RTU having a GPRS dynamic IP address Diy nbs Server GSM Network Sequence 1 Detecting a changing in its IP address the RTU informs the DynDNS Server 2 If you want to connect to TBox with Internet Explorer you connect to the DynDNS Server example http Wwaterloo dyndns org The DynDNS Server resolves the name and sends back the corresponding IP address 3 Internet Explorer connects to the IP address it has received Version 2 07 CA wm Gm s TWinSoft User s Guide 90 9 6 1 How to configure
98. efined in the General RTU properties as described chapter 6 1 Version 2 07 a TWinSoft User s Guide 116 Recording into chronologies happens on event but the minimum resolution of 1 second for MS CPU16 and 1 millisecond for MS CPU32 With MS CPU 16 in case of recording using Ladder BASIC with several records during the same second the data is sorted with the chronological order latest at the top but with the same second The Sampling Tables Sampling tables use Periodical recording minimum period 1 second Recording in sampling tables happens at regular intervals and does not depend on signal variations it uses the clock of the CPU to determine the recording Only the date and time of the last recording are stored and they therefore require less memory than do chronologies Example of periodic recording temperature 9 30 9 45 10 00 10 15 10 30 10 45 t Each Tag is recorded into a separate table The maximum number of tables is 512 and the size of each table is limited to 65535 records The database information recorded in TBox MS can be retrieved with the use of SCADA software such as view or other HMI package with TComm dll based driver please call your distributor By doing a compilation you can check the space of memory available see chapter 4 10 2 Version 2 07 N SSeS TWinSoft User s Guide 117 12 2 The chronologies 12 2 1 Digital chronologies Examp
99. emote Tage 126 14 PERIODIC EVENTS ac iexionii nni wi DDR ROO CACERES GRO ARR RD RM CR RA RR 127 15 HIGH SPEED TA 129 15 1 MS CPU16 Processor time for executing High Speed Tag eene 130 I6 ACCESS SECURITY EE 131 I0 LoRTU CONN GUI ALON arire ri EE pr ada ea medir en ERE Suse sacs 132 TO LE RTU PrODETU GS eege er i ues AREA eege chc petere aupra Cue EV ende 132 TG eZ POR RIOD CICS ee 132 16 2 TWinSoft aocurment protected EE 133 10 9 d asso Ee 134 16 4 LOGIR LOG OU EEN 135 LOLE WET ENNS O m 135 16 12 With Internet EXPO E eegener ee 136 16 5 Deactivating protection of TBOX MS 137 16 6 Deactivating protection of TWinSoft document eoe 137 APPENDIXES nueces LE 139 APPENDIX A LICENSES s s ixi E YREEERRER ERREFRERERRKKEE CK CR o CE Ew Ve KR GERE RERO RD RE ER 140 Al EE EE EE 140 Aze TAO B o sisi c eege Ee 140 Aid The Goge LICCNSC arisera eleva estera y adt tot E 140 A4 ne TWInSOIC E 140 APPENDDCB TIME IN RTU BEEN 141 BL MIMET TOBON EE 141 BZ DAA TOO GING vade d E E E E e i E eee 142 B 3 System E e E EE 143 e ee EE 143 APPENDIX C PLUG Se le ME 144 APPENDIX D PACK Be CT EE 147 BUE POS CML AUON mee inst star eaeaanes biieaaarhaaan E Riveunttucea ean 147 DE ccs a E M Ca 147 D OPO ACK iE E EET CES 148 APPENDIX MopBus REROUTING 2 92 Een aa Ea ag ERE EwR EEEERERE EE ERaRREEERaREERE FERE RRENEERE DER 150 E Tesentaliol suisses oot umida RIEN eI anes IMMO Ie Do
100. en the Card and the Rack There are several Card models Power supply CPU Communication ports o Modem o RS232 RS485 o Ethernet O gt Input output o Digital inputs outputs o Analog input 14 bits o Analog outputs 12 bits o Combination of digital analog I O Version 2 07 a TWinSoft User s Guide WiNSorr GETTING STARTED Version 2 07 S Ru TWinSoft User s Guide 15 3 Installation of TWinSoft 3 1 System requirements e Hardware Pentium or higher e Memory 32 MB minimum e Hard Disk 150 MB required plus the application files e Display VGA SVGA with a minimum resolution of 640 x 480 We recommend 800 x 600 e Mouse any Windows compatible mouse e USB port required in case of license with dongle for USB port e Serial port required for a local connection to TBox MS and or for an external modem If no serial port available USB to serial adapter should be used e Ethernet port 10 100 Mbps Required for a connection to TBox MS through a LAN e Modem any modem properly configured in Windows e Operating system Windows 2000 2003 XP VISTA To Browse the RTU e Internet Browser as ActiveX is used Internet Explorer only can be used Version 5 00 or higher is recommended to take benefit of the dialer Version 2 07 a TWinSoft User s Guide 16 3 2 Installation of the CD ROM Ew 1 d A be Teen A l i T From the CD ROM of TWinSoft Suite when running
101. er Alarms in the Project workspace and select Conditions According to the Tag you select you define a digital alarm condition or an analog alarm condition Version 2 07 a TWinSoft User s Guide 92 10 2 Digital Alarm Condition Alarm Conditions Alarm Condition Runtime Parameters en Type Positive Edge w Recipient c Send Message Send Report Message intrusion GATE G1 Handling Enabled v Severity Matify End of Alarm _ SMS Acknowledge POP Acknowledge Tagname The Tag selected to generate the alarm Type The edge on which the alarm is going to be started rising falling or both Message or Report text or file associated to the alarm Depending on the type recipient associated you can send a message or a report It is the SMS message sent to a GSM the message report sent as e mail the message report printed or the file sent by FTP It also appears in the table of alarms to distinguish them see chapter 10 8 If the alarm condition sends an e mail it can be of 2 kinds Message a text message is sent and it appears in the object field of the e mail Report sending of a report created with Report Studio The report can be created from the Project Workspace and the list of Web amp Report files Recipient Select a Recipient or a group of recipients The person you wish to contact in case of alarm see Recipients below In case you select a grou
102. erbose Verbose Verbose Verbose Verbose Verbose Verbose Verbose Verbose Verbose Verbose Verbose Verbose Verbose Verbose Verbose Verbose Verbose Verbose Verbose Class FTF FTF FTF FTF FTF FTF FTF FTF FTF FTF FTF FTF FTF FTF FTF FTF FTF FTF FTF FTF FTF FTF FTF FTF FTF FTF FTF FTF FTF FTF FTF FTF FTF FTF FTF FTF FTF Bets Messages connection closed send QUIT 221 2 0 0 weequay iz scarlet be closing connection send QUIT 250 2 0 0 AUB Yb31918 Message accepted for delivery Quel pied cette CPL Se 354 Enter mail end with on a line by itself send DATA 250 2 1 5 lt jean burton ttechnotrade biz Recipient ak send HURT TO 250 2 1 0 hest technotradet scarlet be Sender ak send MAIL FROM 250 weequay is scarlet be Hello 193 74 81 130 pleased to meet vau send HELO 220 weequay is scarlet be ESMTP Scarlet Belgium ready at Fri 30 Mov 2007 12 send email Messages Controle connection closed 221 Goodbye ou uploaded 2 and downloaded 0 kbytes Send QUIT zz b File successfully transferred Data connection closed Ux10034388 12 Ftp Ack 150 Accepted data connection Static File name history tma Send STOR Open data connection with server Open data connection Jar Entering Passive Mode 63 222 131 50 36 104 Send PASY 200 TYPE iz now 68 bit binary Prepare to send TMA file Send TYPE Send Attached file apt tbas etc history tma ez b File s
103. es the TEP AP Web and Repot Environment Variables Compatibility Read DM From the Process you can then decide to send back an SMS to Lil Update Recipient tel number confirm the order to indicate the incoming message was invalid that Recipient SMS Jem the password was incorrect message it receives using the ReadSMS special register status see EE next and is able to send back a message to the originator Message index Tag SMS message laud ReadSMS uses the caller ID of the Weeer H originator to update the recipient you START PLIMP Add select in this menu with originator s pus telephone number If this option is activated the selected recipient will be automatically updated with the telephone number of any incoming call if caller ID of originator has been activated 11 5 Read SMS status A communication variable associated to the MS GSM can be used to check the status of ReadSMS From the GSM Communication port go to the tab ACV and make a Tag of SmsState COM4 GSM MODEM Parameters DCY ACY Advanced TCP IP Tag Address Comment Modbus 4 zLUMA Level Level Protection Level COM4 sed Userld User Id COM4 Timeout Timeout Modern Global Tim COM4GPASSta GPASState GPAS State COM4IPAddress gt IPAddress IP Address qp e at A aha a TA Fe o3 uc a Value Description gt gt Z O EMEN
104. essing DHCP If you wish to change the IP address of TBox MS to another subnet the sequence is Send program to TBox MS at the end of sending the program you will lose communication therefore TBox MS does not restart and its time is not set Change the TCP IP settings of your PC to the subnet of TBox MS Reset TBox MS Send program again If you don t know the IP address of TBox MS you can set communication settings to the factory configuration see chapter 4 7 below Version 2 07 SS TWinSoft User s Guide 25 4 5 Testing communication Once you have selected the media on the PC you can test the communication From the main menu of TWinSoft Communication gt RTU identification RIU Information Available information 1 d Le d e Name of the RTU DT T TBoxMS Type of Hardware duc das 2 1 Version of Operating System 5 Version 3 1 Build BO i Status of the process Am Garde LLL ModBus address of the Station SEO T Subaddress of the Station 1 Access level of the current user PE i DIU 15 33 38 d Date and Time in the RTU LAN IP Contig 192 168 1 188 255 255 255 0 192 168 1 1 SE UTOR pOr MAC Address ID DB E1 11 5 5D MAC Address of the Ethernet port Fragram 1 Program Version 1 Programmer JEAN General information about the program Program Upload Date 2 0472008 15 31 21 j Program Cycle 1l msec Process cycle time Hardware Version j Custom Hardware Version LU Hardware
105. estechno tradesMy Documents T winSofts Documents and Setlingsstechno trades My Documents Twins aft Documents and Settingsstechno tradesMy Documents Twins ott Documents and Settingsstechno tradesMy Documents Twins ott Viet pes sed C ekkeach arhan Fadakhdi Drociimanlz2h Tale S att Atlantis trep blueszig gif Chart htr Chart twf index htm Page bm Panal hat Be sure the user running the tpg file runs a version of TWinSoft equal or higher than the one used to pack the files D 3 Unpack To open the Unpack window double click a file with the extension tpg Unpack menu offers 2 features TWinSoft Pack File communication per f Unpack e Archive Informal g 1 Restore a project Creation Date Extract a project into a directory Version of your PC This option is very convenient for backing up a project being sure you don t B Eee miss any file ATU Type ATU Name Application Information UG Version 5511 Modbus Address Communication Online COM1 9600 E Engineer Option available from the main menu Tools gt Unpack Version 2 07 a TWinSoft User s Guide 148 TWinSoft Pack amp Go File Communication Tools Archive Information Creation Date 18 10 2004 12 33 32 Notes Version Application Information 2 Update an RTU Update an RTU with a complete S Version Modbus Address project including the
106. f Windows and is located in the group of programs Techno Trade gt Accessories created while installing TWinSoft This program generates a password that will be necessary to Login to the TBox MS see next This password is composed of 4 hexadecimal characters in response to information related to the user It is based on a complex algorithm using the global code the user s name and the access level A 5 digit number that identifies persons who have accessed the TBox MS accompanies the password This information can be used to trace users for example by inserting this number into a database with the help of Analog Communication Variables see chapter 7 3 TBox Password Generator A Global Code ui i Confirmation i Uzer Mame J EAN Password User Mame i EAN Access Level Engineering Level 3 Password 574B User Id S666 Close Access Level e Engineering Level 3 t Read write Level 2 t Read Only Level 1 mee ne Global code This hexadecimal code of 4 characters is the basis for password generation It is typed in the RTU Properties see above of TWinSoft and sent to the TBox MS When a user logs in TBox MS checks whether NAME and PASSWORD fit with the global code This means that if different users with different access levels must communicate with TBox MS the global code used to generate passwords must be the same User name The NAME you use as login Version 2 07 CA wm Gm s TW
107. f the RTU email e mail of the RTU Startup Power Fail Alarms Sampling Tables Temperature Remote Tags time complete date amp time TCRIP Web and Report Environment Variables Compatibility Read SMS condition if alarm active Oo Y Y9 o year in 2 digits WIEN 1 YYYY year in 4 digits 0 9M9 o month in 1 digit if possible Check user s WebF omviewer Version MM month in 2 digits Message leave empty for standard message MONTH month in letters D day in 1 digit if possible DD day in 2 digits e d i 9 oh9 6 Eur hour in 1 digit if possib DURS DUM eISIOR hHh Eur hour in 2 digits URL http www technotrade biz _language__ Downloadweb H US hour in 1 digit if possible HH US hour in 2 digits mm minute in 2 digits sSsV second in 2 digits file name of the report ampm US time am pm mytag value of Tag Any supplementary text can be added Version 2 07 SS TWinSoft User s Guide 45 7 Resources The resources represent the list of the hardware that your TBox MS has at its disposal e The CPU including its communication ports and internal I O see chapter 7 1 The CPU card e The Cards communication and I O fixed in the same Rack as the CPU see chapter 7 2 Adding Cards e The Remote Device if the CPU needs to communicate in ModBus Master to another device CPU or an external ModBus device the latter must be declared as a Remote I O card
108. formation is available from TWinSoft main menu Communication gt Download gt TCP IP debugging Alarm Overflow overflow in the stack of alarms The size of the stack of alarms can be adjusted from the Advanced properties of the RTU Communication error general communication error flag It means that one of the communication port of the CPU or of a communication card used as Master has encounter a communication error SET Smtp Error an error occurred while sending an e mail SET Ftp Error an error occurred while sending files SET NTP Error an error occurred while setting time of TBox MS SET GPS GPS validity GPS returns a valid signal Validity of the signal When changes to one it indicates the GPS receives sufficient signals to calculate its position from minimum 3 satellites When changing from 0 to 1 the time of TBox MS is set to the time of GPS with correction in regards to GMT according to the location of TBox If you want to update the time manually you reset the variable GPRS Error an error occurred during GPRS connection TBox MS does not succeed to connect not supported yet SET Modem Log authorizes the modem connection to be logged into chronology The communication port is declared in the ASV 24 PortIdLog The ASV 25 EventLog must be tagged also The information is available in from the communication gt Download gt TraceLog not supported yet SystemE
109. g 4xx temporary error 5xx permanent error If TBox MS receives such a code it stops communication and closes the socket Version 2 07 CA wm Gm s TWinSoft User s Guide 160 G 3 Debugging MS CPU32 The Trace Log feature is a powerful tool to debug the TBox MS32 like modem connection or TCP IP connection When you are on line with your Tools Window Help TBox MS32 it can be accessed from PC Setup Ctr e a amp y the menu Communication 3 Download 3 RTU Identification Ctrl Trace Log Ba Send Program Ctrl F9 Skark Stop Program 1 Set RIU Time Change CPU made Program equality Download Digital Chronology Upload Analog Chronology 1 Sampling Table Routing Alarms Trace Log Program Sources J mm WE 08 e Lr PNE Many events related to many tasks are stored in the log To adjust the analyses TWinSoft provides 2 filters Trace log parameters Time range Type Relative e g The last 24 hours hull 1440 Level The level allows you selecting the kind of messages verbose warning info You can also select All to display all levels of messages Class The Class allows you selecting the feature for which you want to display message modem connection sending e mail You can also select All to display all classes Time Range Type relative You select a period from now in minutes Example to display the last day type 1440 minutes
110. gram equality EY Gr System v Download Timers Upload Counters IP Parameters Programs ES alarms Terminal D pat Logging i Man a a ER gm cC A on i au aS a soa monk at at TWinSoft Terminal Communication Port Selection COMA GSM MODEM we COM4 GSM MODEM Modem an FC Debug Mode ATU Part eee aos ant nes lis i Example with MS GSM Version 2 07 a TWinSoft User s Guide 164 Version 2 07 ee Examples of commands to check the availability of a GSM TWinSoft Terminal Communication Fart Selection ATU Fort UK l AT CPIN LPFIM READY OK e mE Sees I web c nn EUM E c E Tnm pili Fr d d AT COPS j COPS UU B mobistar 4 OK i Le Mem can mil apr mima i el met a a KR AT CS0 5 ACGD 21 99 ps b J em roan p T e Wi Be WEN A e n aii GE BRECH Mum Wi m rz TM fro fer To quit the Terminal mode click the button Stop TWinSoft User s Guide To activate the echo in the window type ATE1 ENTER you don t see what you type it is normal The with OK modem answers From now on you will see what you type To check if the SIM card is ready type AT CPIN ENTER The modem answers CPIN READY To check the GSM operator has been found type AT COPS ENTER he modem answers with a code or the name of the operator To check the quality of the signal type AT CSQ ENTER The mode
111. hapter 6 5 2 Example for a positive edge alarm it is when the Tag returns to 0 It is also useful when the alarm condition is active when TBox MS starts up When end of alarm is checked an alarm is automatically generated when the alarm condition disappears see illustration chapter 10 8 Alarms table SMS acknowledge See chapter 11 2 POPS acknowledge See chapter 9 4 1 Version 2 07 a TWinSoft User s Guide 94 10 3 Analog Alarm Condition A Alarm Conditions Alarm Condition Runtime Parameters e L Recipient E SMS Jean wl Er Message Temperature TOO HIGH Matify End of Alarm SMS Acknowledge Tagname The Tag selected to generate the alarm Type Maximum or Minimum The threshold for which the alarm will be started If the value of the analog Tag passes under minimum or over maximum this threshold the alarm is started If an alarm must be generated for both a maximum and a minimum threshold 2 conditions must be declared with the same Tag Value The threshold value depending on the format defined when creating the Tag see chapter 8 The Tags Hysteresis The amount that the level must fall or rise below or above the Max or Min value before an alarm can be re started Relation between Value and Hysteresis With MAXIMUM threshold Value gt threshold Alarm TRUE S Value lt threshold hysteresis Alarm FALSE With MINIMUM threshold Value thre
112. he local port is no longer protected If a card modem has been declared protected it will still be protected even after a global reset To deactivate the protection an unprotected TW iinSoft document must be sent to TBox MS see below Sending an unprotected TWinSoft document The second method involves modifying the TWinSoft document and deactivating the Access Security option The document must then be sent to the TBox MS after having done a Login as Engineer 16 6 Deactivating protection of TWinSoft document You have to open the document and deactivate Access security in tab Security RTU properties If you have forgotten your login but still remember the Global Code you can generate a new login see chapter 16 3 above If you have forgotten your login and the Global Code you have to contact your local distributor and send him the application the TWS file Version 2 07 SS TWinSoft User s Guide 137 Version 2 07 CE wx x TWinSoft User s Guide 138 Version 2 07 TWinSoft User s Guide 139 Appendix A Licenses The software itself is not protected it can be installed on any PC and used to develop TWinSoft document online or offline and to monitor TBox MS The only operation protected is the sending of an application to TBox MS In order to find the best way for you we offer different possibilities A 1 The Evaluation mode You don t need any software or hardw
113. he typical use is a remote access to an IP camera connected to the Ethernet port of the RTU you dial the RTU with TBox Dial it and display a HTML page containing a link to the IP address of the camera IP forwarding requires enhanced security As a matter of fact if an Ethernet port of the RTU is connected to a LAN and the IP forwarding is activated anyone can access the LAN from a modem connection We provide several security levels to enable IP forwarding RTU Properties ecurity Info Advanced 1 From the Security tab the general access security of the document must QE be activated with a first password Protected Parts Type COM HG 2737 C COM H5485 C CO M4 GSM MODEM C COMS H5232 485 Read SMS protection IP Forwarding Code e Code Confirmation coo RTU Properties General Drivers Security Info Advanced Access Security Global Code sese tioba Code Confimatan ee Protected Parts Type C COM D 234 C COM H5485 i Ca l C coma GSM MODEM 2 From the Security tab IP forwarding C coms p5232 485 must be activated You have to type a second 4 digit hexadecimal code This hexadecimal code is used as ASIE orton lobal code to generate the IP j aot forwarding login see 3 wev Code Confirmation LM Password generator is used to generate the login FEMME C EE TT REPE eo Start gt Programs gt Techno Trade gt Accessories gt Password
114. hen set to 1 allows handling of remote Tags on incoming call It concerns then only Remote Tags through modem TCPIP error during a connection to DynDNS server SET Alarm There are 8 time slices that can be used to build Time Tables Those 8 variables indicate the activity of each of them Alarm second flag that can be associated to any Alarm condition When associated to an alarm condition and at value 1 the sending of alarm is inhibited Alarm third flag that can be associated to any Alarm condition When associated to an alarm condition and at value 1 the sending of alarm is inhibited Alarm fourth flag that can be associated to any Alarm condition When associated to an alarm condition and at value 1 the sending of alarm is inhibited POP3 Error an error occurred while reading an e mail SET 7 4 2 Analog System Variables According to its function a variable is Read Write or Read only In the following table the column R W indicates Index Name 0 Second 1 Minute 2 Hours 3 Day 4 Month 5 Year 6 DayOfw 7 AlaCnt 8 AlaID Version 2 07 Read only Writable R W Description Time current Second in TBox MS Time current Minute in TBox MS Time current Hour in TBox MS Time current Day of the month in TBox MS Time current Month in TBox MS Time current Year in four digit in TBox MS Time current Day of the week in TBox MS Mo 1 Tu 2 We 3 Alarm
115. ication event not only for sending warning messages but to establish a connection like we will see Via alarms you are able to call a SCADA send SMS or message to Pagers send e mail send files to a FTP site dial another TBox MS or send a report to a printer Alarms can be used also to send historical data datalogging on regular base using e mail or FTP The historical data is sent as the attached file of a report developed using Report Studio see from Windows the group of programs of Techno Trade TView the supervisory software can then be used to collect data from a mail box or a FTP site The initiation of alarms in the TBox MS relies on the variation of digital or analog Tags For example an intrusion contact or a flow level generates a call There are three basic configurations for an alarm The condition a changing in a Tag gt The recipient to whom the alarm is sent The message or report information to sent to the recipient Each new alarm is immediately entered into a 32 alarms queue adjustable and processed according to its severity level Alarms are generated one by one The alarm queue represents an internal buffer of alarms if several alarms happen at the same time or if a communication port is not available when the alarm happens The Events stack gives information about alarms status Started Stopped Acknowledged To access the definition of Conditions click the fold
116. il address It is the e mail address of the TBox MS You can usually choose it when you subscribe an account This address will appear in the From when receiving the mail In order to protect the mail server and you against spamming the ISP might to refuse sending e mail if the address of the originator is not known Therefore be careful to indicate here the e mail address you have received from your ISP Version 2 07 a TWinSoft User s Guide 84 Connection You select the way to connect to the Server ISP GPRS Ethernet TCP port Each TCP IP service has its own unique TCP port It provides a logical location for the delivery of TCP data TCP port used by TBox MS to establish SMTP connection default 25 The Server requires Authentication Depending on your ISP and on the way you send e mail authentication might be needed to send e mail Usually when you have subscribed the e mail account at your ISP it is not required To be sure if you have created this account on a PC check its configuration otherwise contact your ISP TBox MS supports one SMTP authentication protocol PLAIN authentication Check with your ISP 9 3 1 About Redundancy If you create more than one SMTP Server they can be used in redundancy in accordance to their order in the list You decide to work with redundancy when creating the e mail recipient see chapter 10 4 Version 2 07 SS TWinSoft User s Guide 85 9 4 POP3 Server POP
117. inSoft User s Guide 134 Access level Three access levels are available Level 1 Surveillance mode or VISUALIZATION MODE The operator can view all TBox MS values local or remote but can not execute any command Level 2 COMMAND MODE the operator can view all the values and execute commands locally or remotely Level 3 ENGINEER MODE the operator can view all the values and execute commands and alter or send new TWinSoft documents locally or remotely When this information has been entered click on the button Get password Two codes have been created gt The PASSWORD this PASSWORD must be used together with the NAME when logging in gt The USER ID this number is available in an Analog Communication Variable when a user is connected to a port of TBox MS that is protected 16 4 Login Logout 16 4 1 With TWinSoft The Login feature of TWinSoft allows connecting to a protected port of the TBox MS according to an access level If a port is not protected access level is automatically 3 Engineer The Login Logout is executed from the main menu bar Tools Login If connected to a port of TBox MS that is protected you need to Login to get an access level M ame JEAN Fi Save Esser Help You type the Name you used in the Password utility and the Password that was created see previous According to those you are in Read only mode Read write mode Engineer The access level is displ
118. ion 2 07 Select the Service corresponding to the pager or mobile and a Modem Type the Phone Number of the Pager or Mobile The default Dial prefix is ATDT It should not be changed unless the modem needs a particular configuration If TBox MS is placed behind a telephone switch the outside line prefix is defined in the modem properties see chapter 7 2 2 TWinSoft User s Guide 97 Recipient Mame SMS Recipient Type Pager 5M5 CQ Internal Pager Mobistar Modbus Pager 5 MS Modem COM4 PSTN MODEM Pu E 4351223456 Tail enm Dial Prefix ATDT NTP a KL D A Custom Error Handling Scheduling Tries 4 Timetable Always active D efault we Timeout minutes Printer sending of message s or report to a local printer E mail If you have subscribed an e mail account see chapter 9 3 SMTP Server the TBox MS is able to send an e mail You only have to specify the e mail address of the recipient Recipient Recipient Type E Mail Q Internal Redundancy x SMTP Server ager Printer 5 E mail To jean burtan amp itechnatrade biz OFTP CONTP EG iohn lennant amp isky com Error Handling Scheduling Tries TimeTable Always active Default v Timeout minutes Version 2 07 CE e a TWinSoft User s Guide 98 Sending of e mail supports Redundancy If you have created several SMTP Servers and you select Redundancy instead of a Server TBox MS will use the
119. ital Input amp B Group 1 4 DO lt DL3 0 7 gt 7 Digital Input 7 ES Group 2 3 AD with this icon HI Digital Input D Digital Input D of COMBE C Tags Digital Input 1 Sr Resources zDL3 0 27 Digital Input 2 GJ Lu zDIL3 0 37 3 Digital Input 3 M5 CPLILGE zDL3 0 47 4 Digital Input 4 ci Rack 3 M5 COMBO 1 DL3 0 5 5 Digital Input 5 amp Group 0 8 DI DL3 0 67 6 Digital Input 6 amp Group 1 4 DO zDL3 0 77 7 Digital Input 7 ES Group 2 3 AD Version 2 07 e sa wg TWinSoft User s Guide 69 8 2 Internal Variables Registers An internal variable also know as Register is an addressable location of the memory It is used as flag as temporary value to make a calculation There are 2 types of internal variables Digital DIV Boolean register with possible values O or 1 gt Analog AIV with several formats 8 bits Signed or Unsigned 16 bits Signed or Unsigned 32 bits Signed or Unsigned Float IEEE 754 TEXT AIV analog register associated to a string of characters The Internal Variables can be only created from the list of Tags 8 2 1 Digital Internal Variable To create a Digital Internal Variable from the list of Tags click Add a Tag Select Digital Digital Analog Sc Programs Text 3 9 Alarms i Version 2 07 F ERR TWinSoft User s Guide 70 The Definition menu pops up Tank maximum Properties Definition Tag Tank maximum Commen
120. its When working with 32 bits TWinSoft adapts the quantity to double the number of words 32 bits are handled with lt Hi word1 gt lt Lo word1 gt lt Hi word2 gt lt Lo word2 gt Version 2 07 CHE ow TWinSoft User s Guide 124 External Source All the following parameters concern the Slave station Device select an existing external device from the Resources You can create one clicking the button ZZ Type select the type of the external variable According to the external source the choices are With external source Modus device TBox MS TBox LITE any ModBus device Digital output s or register s Analog output s or register s Functions Read Digi Col i ep see Warning below Read Analog 125 16 bits 62 32 bits Read Anal Wite Single Digtal col EE Write Single Analog Holding Reser 6 mem Write Multiple Digita Write Multiple Analog i Maximum quantities for TBox MS You also have to check the maximum quantities of the Remote device they could be less With External source Remote TBox 222 CPU 3 Description Tag types Max Quantity Digital I O Read Write IOD T4m Analog I O Read Write IOW I4M Bo Digital registers 1600 see Warning below Analog registers 8 bis Jeanne at is Analog registers 16 bits analog registers 32 bits Read Write ToT 8 Analog registers 32 bis Read wite RT 8
121. ive you have to select the Tag corresponding to the button Stop in front of the CPU See in the Resources CPU Group 1 Pressing the button will stop the program Process Alarms Datalogging Remote Tags NO other input than Stop button can be used but any internal digital register Can Version 2 07 N TWinSoft User s Guide 37 6 5 2 Alarms RTU Properties General Drivers Security Info Advanced Advanced Parameters This page contains advanced parameters Extreme care should be taken when changing these parameters IF you feel unsure about the changes you are doing Use the Default button to restare the default parameter values Remote T ag TCP IP MAT Rules Web and Report Environment ariables Compatibility Head 5M5 Stark Stop Power Fail Alarms Sampling T ables Temperature The advanced parameters of alarms Event stack size events concern the size of the Alarm stack size alarms stacks and customizing of e mail SMS Acknowledge timeout JU min and GSM message SMTP From TBox_ sstation zemal SMTP Subject station ee eee T ccu eee ee n oe EL GSM amp Printer Message ze statione End of Alarm prefis END Alarm filter on both transitions p ie omnla i on Se eme a AO n E a e 8 Been Se Em F A Ee mah 2m Hee 23 Event stack is a public stack where alarms are available with date time recipient message status The Event stack can
122. l number of the CPU see sticker on the side of the card CPU Redundancy indicates the current operation mode of the CPU 0 Standalone 1 Primary active default 2 Primary disconnected 3 Backup passive 4 Backup active 5 Backup disconnected TCP IP number of sockets opened The socket availability is 1 socket reserved for Remote Tags Client 2 sockets reserved for Alarms FTP needs 2 sockets 5 sockets available for Server connection GPS with a GPS on TBox current speed of TBox expressed in km h GPS with a GPS on TBox current direction of TBox expressed in degree 0 359 9 degree Alarm it indicates the number of alarm needing to be acknowledged by POP3 connection Alarm it indicates the current Event ID HW it indicates the hardware revision of the CPU Alarm indicates the state of POP3 connection Particularly useful when monitoring the RTU with POP3 connections The last value is maintained 1 Accepted message received 2 Acknowledgment received 10 Invalid message 11 Unknown command 20 Incorrect password 21 Incorrect password or not supplied for a com Port protected 30 Message received does not match a pre defined message TWinSoft User s Guide 66 System variable 15 Week of the year This system variable indicates the week of the year according to the date in the RTU The rules are the following the changing of week happens on Monday 00
123. laRec e Stop connection by writing 0 to the Communication Variable COMx ModemOffHook alternatively communication will be automatically stopped after 1 minute 13 5 Timing configuration of Remote Tags Several timings can be adjusted when communication through Remote Tags Their value mostly depends on the media and the baudrate see on line help for more info They are available from the tab Advanced of the properties of the communication port COM R485 Parameters DCH Acv Advanced Modem Packet reception delay maximum time for receiving a valid frame ModBus Master Properties timeout maximum time to receive an answer before sending the next query Packet reception delay Automatic Custom Al msec Number of Tries in case of error number of times a query is sent Modbus master properties Timeout 1000 msec Number al hies 1 Interframe gap after having received a valid answer time before sending the next query Interframe gap 0 msec ModBus Slave Properties Interframe gap after having received a valid request time before sending the answer Modbus slave properties Interframe gap 0 msec Example with RS485 of the CPU Mk a File mln A PU TEM mL a m Se n Abbas ai Hee es ul C O TO TT Version 2 07 e TWinSoft User s Guide 126 14 Periodic Events When periodical tasks have to be executed periodical events constitute an easy way of creating events t
124. le of an entry in Digital chronology Recording of the starting and stopping of Pump 1 Chronology ro Pm E Edges Rising Edge Help Handling Enabled wt Edges Recording on positive and or negative edge Handling gt Enabled always recorded gt Disabled never recorded gt PowerF recording disabled in case of main power failure gt DisCRD recording disabled when the system variable DisCRD is at 1 12 2 2 Analog chronologies Example of an entry in Analog chronology Recording of a variation of 2 5 bars in Pressure Pipe1 input Chronology Tag Variation E Handling IE nabl d l n Variation Recording in case of variation higher or lower in comparison with the previous recording The unit is expressed according to the format selected in the Tag definition see chapter 8 2 2 Analog Tags Handling Enabled always recorded gt Disabled never recorded gt PowerF recording disabled in case of main power failure gt DisCRA recording disabled when the system variable DisCRA is at 1 Version 2 07 2 TWinSoft User s Guide 118 12 3 The sampling tables Sampling Table Tag Temperat_ Purp 0 Type Cancel Minimum Pernod 5 minutes Ke C3 Maximum Help Size Average Ose es C Instantaneous C3 Incremental Duration 2 dw s h Trigger Type TBox MS is able to execute calculations on a minimum
125. llows changing this rule at startup With Wait start of condition active With Wait start of condition not active if the alarm condition is true at startup an internal start of alarm auto ack is generated When the alarm condition disappears the alarm is generated Internal Alarm time Sample analog variable at each program cycle as of TWinSoft 9 05 xxx and OS 3 11 xxx sampling of analog I O can be executed at each cycle This will be particularly required when doing PID regulation With previous version of OS sampling was done each second To know how to check current OS version and send OS go to chapter 4 5 STOP Reset All physical outputs at program stop when this option is active the RTU reinitializes the outputs to 0 at stop This is particularly useful if you want to reset the outputs when sending a new program and you want to be sure they stay at 0 during the sending and restarting sequence After that outputs are monitored according to the process Disconnect ModBus address at program stop all variables will have their ModBus address disconnected which means that an external equipment accessing the RTU will receive communication error This feature has been implemented to allow a SCADA detecting immediately a TBox is stopped as the ModBus addresses are not available the RTU stays in communication but returns an Exception error Stop program with button stop when this feature is act
126. m answers T CSQ xx 99 xx must be between 20 and 31 165 NDEX ACCESS Te VelS TEE 135 Biz fore o nro EE 116 PCC OSS De eei eio or p c ap she cine Praia chronologies eeeeeeeeeeeee 118 ale ue DEE 137 sampling tables 119 TWinSoft document 137 RZelftelelle te EE Acknowledoment kk CHO LE 158 with incoming GM 109 E GR eL 161 ee De 35 Be EN 25 48 PAIN Side deele 38 92 Bio EE 35 AE EE 92 BIereiIngi ip iR meats trem mn ES advanced paramelers 38 eie joe C terete 29 analog Copditon a 95 SAVINO DEEN 29 EE 94 96 LONGI RE 140 digital copndtton 93 Buc cc E I 35 display IS OL ssec teni M M and udi voee duis 106 DY Bs cec 90 EE 98 end ofala ao 6k qM GE ae 76 93 96 98 ETP i 99 crece E MM E EE SAQUE IUSSUM E SMTP TEOLT Iano cu e e bino erudi OO group of recipients nanea 101 SMTP subject 38 Welle 104 EE See Jig EE 94 96 pr red eel umm RCT aic PETER 39 messadge EE 102 GE E LE ENEE 43 Ni sXe eibi MEE 97 Ethernet Wine Em 2 EON MMC M OOR B peo DM T EE 48 printer 98 GE E REESEN 38 92 elei rr a a 97 Si EE 98 E O UME e 104 Backup TWinSoft document 29 e Button 27 Eeer e TEEN 134 Doo o Global Reset 27 Caller ID 61 GPRS MR MR TIR 55 E e PIC MEAE UC communicating with TWinSoft 25 58 VONOIOGIC i TOT TT Mo RNC 5G ee e 141 E ege seting EE 58 COMMUNICIVON DEE with
127. me for one cycle of the program BASIC and Ladder This register is refreshed after each cycle Within the program you could compute this register to memorize the highest value Alarms Quantity of alarm conditions which are still active Events absolute number of the last event 0 65535 Application version according to the version indicated in the Info of the RTU properties This register returns a version in a WORD format O 65535 Operating System version running in TBox MS Operating System build number of the OS running in TBox MS Loader version Loader version running in TBox MS Loader build build number of the loader running in TBox MS TCP Logging MS CPU16 selection of the port for TCP debugging see appendix G 2 TCP Logging MS CPU16 contains internal codes used for TCP debugging see appendix G 2 TIME With CPU 16 10 milliseconds tik With CPU 32 1 millisecond tik not available yet GPS current latitude given by the MS GPS Latitude in degrees multiplied by 1000000 example 50123456 means 50 degrees 0 123456 degree Resolution 11 cm Precision 15 meters GPS current longitude given by the MS GPS Longitude in degrees multiplied by 1000000 example 7123456 means 7 degrees 0 123456 degree Resolution 11 cm Precision 15 meters GPS current altitude given by the MS GPS Altitude in meters Resolution 1 meter Precision depends on the quantity of satellites Poor precision
128. ments the Target Tag which must be an internal variable AIV Falling Edge gt Inc AIV each falling edge of the digital Tag increments the Target Tag which must be an internal variable AIV Target Tag It is the internal variable DIV or AIV on which the action is taken see above Divisor Division Factor that allows the action SET or increment to occur once every x pulses x being the factor of division Version 2 07 N a TWinSoft User s Guide 129 Weighting You can give a weight to the pulses after the computing according to the Divisor see above If the weight is smaller than 1 0 1 0 2 be sure the Target Tag is of type Float Example counting water consumption you receive pulses each 10 liters you want to count each 100 liters you want to display the result in m3 Divisor 10 Weight 0 1 15 1 MS CPU16 Processor time for executing High Speed Tag This table shows the time needed by the processor to compute the High Speed Tags according to the frequency of the pulses the type of the Target Tag and quantity of High Speed Tag Frequency of pulses Target Tag Version 2 07 CE wx x TWinSoft User s Guide 130 16 Access security This optional access security of the TBox MS prevents non authorized persons from accessing the RTU and from opening the TWinSoft document If the Access security option is activated each port of the TBox MS can be independently protected Once
129. n With the TBox MS sending a SMS through a GSM it is possible to acknowledge the alarm by sending back a SMS to TBox MS In some cases mostly working in GPRS SMS can be sent through e mail services In return it is then possible to acknowledge the alarm using POP3 connection Sequence of connections 1 TBox MS sends an e mail The alarm condition has been configured with the option POP3 Ack It is important you have a dedicated e mail account for your RTU The data sent by e mail can be a report or a message he recipient retrieves its e mail The field Subject of the e mail is preceded with internal data RTU Id I and Alarm index A Example of message 1460000020107 A00004 MyTBox PUMP stopped The user sends back the e mail Typically he will make a Reply and sends back the e mail to the address as specified in point 1 above in the SMTP server TBox MS generates a POP3 connection through alarm condition and checks the presence of e mail with specific data in field Subject With this data TBox MS knows which alarm for which RTU it can acknowledge The POP3 connections have to be handled into your process and can be checked from System Variables see below Mail Box TBox SMTP POPS Illustration with a TBox MS Version 2 07 N TWinSoft User s Guide 87 Supplementary information 1 The time between phases 1 and 4 can be determined in RTU properties Advanced Alarms properties
130. nication on edge changing of the Tag Trigger The changing of state of the Tag can be controlled by BASIC Ladder or Periodic events Version 2 07 N a TWinSoft User s Guide 123 13 3 Creating a Remote Tag Remote Tag Tag TBox2 Flows B Operation Read White Quantity Cancel Help External Source Device TBowit2 v rx Tagname mJ Type Holding Register ze Conditor Address Example reading of 8 floating variables in TBox 2 at address 32 Tag Select an existing Tag by clicking the button Be sure you select a Tag of the Same type of the address you want to access in the Slave Byte Word DWord or Float If the Tag does not exist you can create it after having clicked the button It is the Tag of the Master it contains the value you want to write in a Slave or it is a register that contains the value that Master reads in a Slave In case of block communication with a quantity gt 1 this Tag is the one of first ModBus address Operation MASTER Tag SLAVE Address READ Read the Master executes a reading in the Slave Write the Master executes a writing to the Slave Quantity Quantity of variables of successive addresses that are read or written in the Slave It depends on the External source the types of variable and the ModBus function used see tables below ModBus protocol handles only words 16 b
131. ntification Ee Send Program CEri F8 Stark 5top Program Set RIU Time Program equality R5232 485 Download Routing Terminal Select the highest version if you want to SEN use the latest features and corrections Language ilie ille E eee nU for MS CPU16 Te wem cf ef rum E 3 Example with Operating System 4 9 LED RUN This LED is next to the Reset button Its flashing frequency indicates the status of the CPU Program stopped Program Failsafe runs Ss ae Version 2 07 a TWinSoft User s Guide 28 4 10 Saving and Sending a Program Like any Windows program TWinSoft creates Documents One document corresponds to one TBox MS application Each of them must be saved using the Windows standard 4 10 1 Saving a document Backup document Possibilities for saving a document e Use the icon WM of the main tool bar e From the main menu use File gt Save e Use the accelerator keys lt CTRL S Saving a document creates a file with the extension tws which is your TWinSoft application But each time a TWinSoft project tws is opened successfully it is saved in a back up file Dk If you encounter some problem retrieving your tws file you can just replace the Dk extension by tws and use the back up During the development of the application it can be sent at any time to TBox MS for testing the program When sending an
132. o launch the tasks like Remote Tags send of test alarm datalogging a piece of Ladder BASIC logic etc and this independently of any other condition A periodic event could be compared to an automatic timer A digital Tag is used to trigger the event s It is SET by the Operating System of TBox MS when the task s must be carried out and RESET by the OS when the task s have been launched Several tasks can be associated to the Tag triggered This implies for the OS to RESET the Tag when all event s have been launched In the project workspace of TWinSoft a folder is available to declare the Periodic Events x Tag Period type Start at Periad e gu E Ce EEN 3 SCC Tags Eventi Daily 00 15 30 f tl Resources 2 I Event Weekly 06 00 1 H IP Parameters 1 ES J Programs H E Alarms 1 El E sud Version 2 07 S sz TWinSoft User s Guide 127 Example of a daily event Periodic Event T agname E vent B Scheduling Reference time 8 Daily O Weekly The Tag event1 a DIV will be automatically SET every 30 minutes at each xx 15 00 and xx 45 00 The task s associated to Event1 will be generated every 30 minutes Example of a weekly event Periodic Event m e Scheduling O Daily Weekly Day of Week Monday Tuesday Saturday Wednesday Thursday Sunday Friday The Tag event2 a DIV will be automatically SET every day at 6 00 00 AM The task s a
133. ocedure to access Internet and download the WebForm Viewer It can be from TBox manufacturer site see below Version 2 07 a TWinSoft User s Guide 44 The TBox is on Internet or part of a LAN the message informs on the situation By clicking OK you jump to the URL see next Download new version This option can be checked to automatically download the last version of WebForm Viewer It will be used in 2 cases The TBox is connected to Internet then you have also direct access to Internet to download WebForm Viewer You can leave the URL of the manufacturer http www tboxsupport biz free downloads DownloadWebFormViewer html The TBox is connected on a LAN and one of the PC of the LAN contains the WebForm Viewer You type the URL of the PC Example PCServer C TBox Download DownloadWebFormView htm Unique Report file name format When sending a report by FTP you have the choice of sending the report with Unique file name see Report Studio gt report properties gt Advanced In this case the RTU includes supplementary parameters in head of the name of the report RTU Properties General Drivers Security Info Advanced j Advanced Parameters Accepted Dafa meters are This page contains advanced parameters Extreme care should be taken when changing these parameters If you Feel unsure about the changes you are doing use the Default button to restore the default parameter values Yostation name o
134. of the message You can type any text and the following parameters O ostation9 o replaced by the name of the station see General properties time the time of the RTU when the e mail was generated 9 ocondition9 o it will result in an exclamation mark in the message if the condition of the alarm is still active when the alarm is sent End of Alarm prefix allows specifying a text that will be sent in front of the message when the alarm condition ends to indicate it corresponds to the End of the alarm Example END Message sent when the condition ends END Level too HIGH Check the total length of SMS message does not exceed 160 characters Do not use accent Alarm filter on both transitions this option allows computing the filter of alarm condition during both transitions when the Tag value goes to alarm condition AND when it leaves alarm condition This option will be applied to all alarm conditions This is particularly useful to filter interferences on inputs Version 2 07 CS L TWinSoft User s Guide 39 6 5 3 Sampling Tables This menu gives access to the parameters for long period recording in Sampling tables See chapter 12 3 Sampling tables Those configurations concern all sampling tables RTU Properties General Drivers Security Info Advanced Advanced Parameters This page contains advanced parameters Extreme care should be taken when changing these parameters
135. om a RS232 port to a RS485 we recommend using the same Baudrate all ports If you have Remote Tags running between Master and Slave we recommend stopping them during rerouting to avoid communication errors E 3 Possibilities of Routing The table below shows all possible connections between 2 ports IN port in which requests are coming OUT ports to which requests have to be sent if it does not concern the local RTU different ModBus address OUT RS232 RS485 PSTN GSM GPRS Ethernet IN Routing Routing Routing Routing Not avail Not avail RS232 Routing Routing Routing Routing Not avail Not avail RS485 Routing Routing Routing Routing Not avail Not avail PSTN Routing Routing Routing Routing Not avail Not avail GSM Routing Routing Routing Routing Not avail Not avail GPRS Routing Routing Routing Routing IP Forward IP Forward Ethernet Routing Routing Routing Routing IP Forward IP Forward increase Time out see above to at least 2 seconds and with GPRS at least 10 seconds Version 2 07 P QR TWinSoft User s Guide 152 Appendix F IP forwarding IP forwarding feature allows forwarding IP requests from one communication port to any communication ports configured in IP IP modem connection for instance incoming connection from TBox Dial it Ethernet ports T
136. onnecting to mains The green yellow colored wire can be only used as earth wire e This equipment has been designed for use only by qualified and instructed personnel in an industrial environment This equipment must be operated in a restricted access location according to IEC60950 e Itis a Safety Class I equipment according to IEC classification if powered by the MS PS230V or a safety Class III equipment otherwise In this case the equipment must be powered by a Safety Extra Low Voltage SELV e If voltage under 60Vdc are used they must be Safety Extra Low Voltage SELV e This Equipment has been designed to be also compatible with an IT power distribution system e This equipment has been designed to meet IEC60950 1 requirements safety of information technology equipment e This equipment has been designed for indoor use in a Pollution Degree 2 environment dry non conductive pollution e The card must be fastened to the rack using a screw driver with a recommended minimum torque of 0 5 Nm e Caution Never power the card when not fixed on the rack Switch off and disconnect power before removing the card from the rack e Connection from the equipment to mains must be protected by a circuit breaker of 16 A on both line and neutral except for TT or TN power networks with earthed Neutral unequivocally identified where only the Line need to be protected e Caution To reduce the risk of fire use only No 26 AWG or larger telecommunic
137. or EDU aaa 150 EZ ROUUNG USINO ER e le 150 E 3 JFOSSIDIIIUIeS OF ROONG tisse kai dut au suyo va E Ra oO ER Ead RANTS TA GR CHOR EX EORR Ru OP dA WE PER 152 APPENDIX Fe IP FORWARDINGiEVREE YER LER IG DIOC c RA CR AR ER A PEOR E FN E KE RI R VERRE RR 153 Versio 207 TWinSoft User s Guide 7 APPENDIX G DEBUGGING TOOLS ere ee ENEE 155 G1 Modem debugging with MS GPUTO aia sutuio sl e eux geed een 155 G Z TCP IP debugging With E ER 158 G3 DEDUGGING Eege 161 APPENDIX M TERMINAL MODE sic i oi C al OR RR RR RC RC COR RIS RR RR 164 uj CE 166 Versio 207 S amp F TWinSoftUser sGuide 8 Version 2 07 TWinSoft User s Guide EP E HN ME M TURF Wm eum F r TIT Ke d dh T d rely 1l Wa i io 7 Le E e Le F k T 1 p j i T ENIPTL I f A Segen e d j Y 4 i E i f j H 5 ER I I E Lama E E i I idm E 4 Hil UE rs i L if 4 1 L 4 U H Em E M l a a H H A mone KL E KS Ka D ica 7 iw Li ER ia ain mi E LI f d E 1 H i i J 1 H i t i i i The unique all in one TBox MS includes the best of 3 Worlds Telemetry ch Internet Automation Version 2 07 TWinSoft User s Guide Q MSD Overview of TBox MS possibilities Consulting process through HTML pages Programming locally or remotely Eo n Internet Explorer Sending of Alarms
138. owed to modify if you want When you create a Tag of system variable you can change its default ModBus address In case you wish to access the Tag you declare this user ModBus address Other Tabs of the Tag configuration refer to menu where the Tag can be declared For Alarms see chapter 10 For Datalogging see chapter 12 For Remote Tags see chapter 13 About Presentation write see next chapter Version 2 07 SS TWinSoft User s Guide 75 8 4 Tags Presentation Write This tab contains configuration used when the Tag is declared in a Report or in a WebForm The Description is also used in 2w ew Presentation settings can also be used when the Tag value is included in a SMS Report file edited with Report Studio and used for instance as text body when sending e mail Start Report Studio from Windows and the group of Programs of Techno Trade or from the Project Workspace and the list of Web and Report files gt WebForm file edited with WebForm studio Used to display values of Tags in a HTML page Start WebForm Studio from Windows and the group of Programs of Techno Trade or from the Project Workspace and the list of Web and Report files gt SMS with Digital Tags the states defined here will be used and with Float Tags the number of decimals See also chapter 10 7 1 Value of Tag in message Flow Pump1 Properties Definition Alarme Data Logging Present
139. p of Recipients see next Version 2 07 SS TWinSoft User s Guide 93 Call all Recipients To be used when selecting a Group of Recipients When the option is cleared TBox MS calls the first one in the group In case the alarm cannot be acknowledged after the number of tries TBox MS automatically calls the next Recipient in the group and so on until it succeeds Then it stops Also known as Cham When the option is checked TBox MS sends the alarm to all recipients of the group Also known as Link Filter The time in hour minute second during which the condition must stay TRUE before the call is generated Filter can be tested either during both transitions or only during the transition selected see chapter 6 5 2 Handling The handling option allows blocking each alarm condition manually or automatically Enabled alarm condition always active gt Disabled alarm condition always de activated PowerF alarm condition disabled when there is a main power failure gt DisAla alarm condition de activated when the system variable DisAla is at 1 Severity Each alarm can be assigned a level of severity Low Normal or High When several alarms are still present in the queue and then not processed yet TBox MS generates the calls according to the highest severity End of Alarm When the alarm condition is finished an alarm is automatically sent to the same recipient with the same message preceded by a prefix see c
140. pient Type Pager SMS PEN x Um e s gu om um m LL ee ee rm mm ven d D You will associate a Tag to the run time parameter you want to add The Tag and therefore its associated parameter can then be modified from TWinSoft a WebForm a SCADA Alarm Recipients 1 Recipient Runtime Parameters 1 z 1 Mame Description Format 4 Ter SMS_TelNumber Phone Number Text 1 5MS Jean Email Email To 7 1 5M5 Jean Ems Email Cc D 1 Ki Ss T V WM O el LU d The format of the Tag depends on the parameter Bool Byte Word Float Text Changing of parameters is maintained in case of power cycle reset reboot and watchdog Original configuration is restored in case of sending new program or OS and doing stop start from TWinSoft Version 2 07 SS TWinSoft User s Guide 77 8 5 1 Alarm Parameters Alarm Condition Parameter Choice Tag Format Inhibition 0 enabled Byte 1 disabled 2 power fail 3 DisAla 4 DisAla2 5 DisAla3 6 DisAla4 Threshold analog Byte or Word or DWord or Float Hysteresis analog Byte or Word or DWord or Float Alarm Recipient Parameter Recipient Type Tag Format Phone Number ModBus SMS Printer RAS Custom Text E mail To Email Text E mail Cc Email Text Alarm Time Slices Parameter Tag Format From Hour Byte From Min Byte
141. ported are Internal ModBus the alarm is saved in the stack of events and no call is generated It can be used to memorize a particular event without generating an alarm or to test an alarm condition it can be Master or Slave It is used to establish a ModBus connection to another ModBus device or a SCADA for instance 2w ewr The difference between Master and Slave concerns the handling of the modem connection and acknowledgment A Slave connection means that TBox MS dials an equipment and doesn t do anything else The dialed equipment will sample acknowledge and hang up Typically used for instance when dialing Zwevw A Master connection means that TBox MS dials a ModBus equipment and will also sample this equipment with Remote Tags TBox MS will then be also responsible for acknowledgment see chapter 7 4 2 System variables 8 AlaID or 10 AlaRec and hanging up see Advanced properties of the communication port used to send the alarm COM4 GSM MODEM Parameters DOY ACY Advanced TCP IP Modem Inactivity timeout A modem parameter Hang up timeout is used by ModBus Master alarm to define the maximum connection time The maximum value is 600 seconds Modbus end of frame detection 5 Automatic Custom Modbus master properties Timeout 1000 Number of tries Interframe gap E Hana up timeout Pager SMS to send SMS to a mobile or message to a Pager Vers
142. quantity Amount of alarms in the alarms stack It means the quantity of alarms that have not been generated already The size of the Alarm stack can be adjusted in the Advanced RTU properties Alarm last index Absolute index of the last alarm generated number between 0 and 65535 Uu TWinSoft User s Guide 64 Index Name 9 ALACur 10 ALARGO 11 SamQty 12 UTcrrm 13 ZonBia 14 On ID 15 Wevear 16 CycTim 17 AAcond 18 Levid 19 AppVer 20 OsVer 21 OsBuil 22 LoaVer 23 LoaBui 24 PortIdLog 25 EventLog 26 Millis 27 GpsLat 28 GpsLong 29 GpsAlt 30 Gpssats 31 REROUL Version 2 07 R W Description Alarm current index Absolute index of the alarm being currently handled number between 0 and 65535 Can be used to acknowledge an alarm by writing its index Alarm recipient gives the index of the recipient of the current alarm Can be used to acknowledge all alarms of a Recipient by writing its index see index in the list of Recipient Sampling Table Quantity of sampling tables defined Time Universal Coordinated Time UTC It is the number of seconds since 01 01 1970 GMT time It is used as time stamp reference for datalogging Time Time difference in seconds with GMT Time ID of the zone where TBox MS has been installed Tt uses Regional Settings of PC therefore it is important that you configure PC according to the location where 7Box MS is installed Time week of the year See note below Time ti
143. r 32 characters Example with the following value at TAG and following TAG 0x48 H TAG 1 0x45 E TAG 2 Ox4C L TAG 3 Ox4C L TAG 4 Ox4F O TAG 5 0x00 The following message will be generated I say HELLO to everybody Version 2 07 SS SS TWinSoft User s Guide 103 10 8 Alarm Timetables Alarm timetables allows specifying an activity period associated to a recipient in other words periods of time during the day the week the year when a recipient can receive an alarm The time tables are based on the specification of Time Slices time periods of the day and on Days days of the week and holidays 10 8 1 Time Slices The time slices are used to trunk the day in different slices Further you select those Time slices when creating timetables To declare the time slice just select the start time and the end time of the slice A time slice can t be part of 2 different days no time slice can include midnight e g 18h30 to 08h30 Dark 3 d SE Es DT Ead ke From To ad LTGSM Add a Time slice C Tags l amp 00 00 08 00 H Resources 2 amp 08 00 15 00 J IP Parameters J Programs J Alarms _ Conditions _ Recipients Time Slice _ Recipient Groups J Messages From E zl to g J Time Slices EE ES J Data Lagging Sal Remote Taos 10 8 2 Holidays The holidays offer to flag specific days of the year these days can be checked in the timetables all at once
144. r to have a universal solution wherever the TBox MS is used TWinSoft OS of the RTU and Windows collecting data shares the mechanism of time management Time in the RTU is based on UTC time B 1 Time in TBox MS The RTC Real Time Clock The TBox MS is equipped with a RTC chip Real Time Clock The RTC is used to manage all times internally Functions of the RTC e itis a calendar Y2000 compatible e it updates the UTC time see next e it communicates with OS to handle the UTC time used for data logging The RTC time is used at start up of TBox MS to update the UTC UTC Time UTC time is based on the number of seconds since 1 1 1970 at Greenwich latitude It is used as internal time stamp to each event alarm datalogging The UTC time is converted into Analog System Registers to give access to time information second minute hour day month year Changing UTC time automatically updates the RTC If time information is sent in a report as header of an e mail in the Analog System Register it is always computed using the UTC time according to the time settings in the General RTU properties TBox MS Time setting In order to set TBox MS to PC time an option is available in the Communication menu of the main menu bar option available when connected locally or remotely to the RTU When sending an application to TBox MS TWinSoft updates automatically the RTU time to the PC time This feature
145. ror 6 5 6 TCP IP RTU Properties General Drivers Security Info Advanced Parameters Advanced This page contains advanced parameters Extreme care should be taken when changing these parameters If you Feel unsure about the changes you are doing use the Default button to restore the default parameter values Environment V arables Startup Power Fail Alarms Remote Tags U sds TCP Port Numbers ModBus TCP Slave ModBus TCP Master FTP 2 SMTP TCPAP address for incoming Calls EE 192 189 2 1 TCPAP miscellaneous Extended log Version 2 07 fF SS Compatibility Read SMS Sampling Tables Temperature MAT Rules Web and Report Network Socket Time to live sec Global MTU Global MTU valid for 0S lt 3 11 TWinSoft User s Guide 41 TCP Ports Numbers Each TCP IP service has its own unique TCP port It provides a logical location for the delivery of TCP data TCP Port number complies to a standard defined by the IANA to be sure everyone using a TCP service uses the same TCP ports according to protocols used When working with TBox MS in some cases you might want to change this port number HTTP port used to access TBox MS as WebServer by default 80 ModBus TCP Slave port used by a Master to access TBox MS as Slave TCP port 502 still remains active for TWinSoft by default 502 1 Changing the TCP port does not affect access from TWinSof
146. rr the RTU detected an error during starting Typically a problem with a card which is default or a discordance between cards detected in program and cards installed SET MMC indicates whether the program has been loaded from the MMC 1 the program of the MMC is different from the one of the RTU and has been loaded from the MMC O there is no MMC the MMC is empty the program of the MMC is identical to the one of the RTU see also appendix C Plug amp Go Chronologies Indicates that the amount of records in the digital chronology has reached the maximum selected Chronologies Indicates that the amount of records in the analog chronology has reached the maximum selected 3 2 TWinSoft User s Guide 63 Index 32 33 34 35 36 37 44 45 46 47 48 Name RsDigChr RsAnaChr Buskhrror MasterAnsw DynDnsEr Tsl Xa DisAla2 DisAla3 DisAla4 POP3Err R W Description Chronologies Allows emptying the digital chronology using a SET Automatically reset by OS Chronologies Allows emptying the analog chronology using a SET Automatically reset by OS Bus When an error is detected the variable changes to 1 The LED error on the CPU is switched ON until hardware reset In parallel we reinitialize the TBox MS cards every second An error on the Bus might happen if the earth of RTU is not good EMC protection is very good with TBox but requires a very good connection to earth Remote Tag w
147. s been chosen When a winter summer time change occurs the target time is automatically updated for sampling tables having a period gt 1 hour Example If recording a value once a day at 6 00 in the morning the recording will always happen at 6 00 but when changing from winter to summer the sampling period will be 23 hours and when changing from summer to winter the period will be 25 hours Periodic events When a periodic event is defined with a period gt 1 hour its target time is automatically adjusted when a changing winter summer happens Version 2 07 CHE ow TWinSoft User s Guide 142 B 3 System variables associated Some System Variables of TBox MS are associated to the Time They can be used in BASIC Ladder programming to execute specific operations Type Variable 6 Registers giving SENAO B time in hour minute second day Minutes month and year Time in UTC format number of seconds since 1 1 1970 at Greenwich latitude Time difference in seconds between the local time and time UTC ID of the zone where the RTU is installed It uses regional settings of the PC B 4 Summary Summary of time handling in the different cases 1 System variables in the RTU They display the local time where the RTU is installed according to the Regional settings declared in the General RTU properties 2 Identification from TWinSoft The UTC time is computed according to Regional settings of the PC
148. shold Alarm TRUE P Value lt threshold hysteresis Alarm FALSE Recipient Select a Recipient or a group of recipients The person you wish to contact in case of alarm see Recipients below In case you select a group of Recipients see next Version 2 07 N TWinSoft User s Guide 95 Call all Recipients To be used when selecting a Group of Recipients When the option is cleared TBox MS calls the first one in the group In case the alarm cannot be acknowledged after the number of tries TBox MS automatically calls the next Recipient in the group and so on until it succeeds Then it stops Also known as Cham When the option is checked TBox MS sends the alarm to all recipients of the group Also known as Link Message or Report text or file associated to the alarm Depending on the recipient associated it is the SMS sent to a GSM or the message report sent as e mail or the text printed or the file sent by FTP It also appears in the table of alarms to distinguish them see chapter 10 8 If the alarm condition sends an e mail it can be of 2 kinds Message a text message is sent and it appears in the object field of the e mail Report sending of a report created with Report Studio The report can be created from the Project Workspace and the list of Web amp Report files Filter The time in hour minute second during which the condition must stay TRUE before the call is generated
149. sing SMS message or reading e mail using POP3 ReadSMS POP3 provides the possibility to control the RTU by sending predefined SMS or by reading e mail using POP3 service Details of the different possibilities 1 Using pre defined messages From the ReadSMS properties menu you select a Message index Tag analog Tag 16 bits format that will contain a value associated to the message sent to the RTU You add the message s you intend to send to the RTU When the RTU receives the message it will put the corresponding value to the Message index Tag Notes SMS POP3 message are not case sensitive This method of monitoring using message is the only method supported by POP3 Message sent by SMS General Drivers Security Info RTU Properties Advanced Advanced Parameters This page contains advanced parameters Extreme care should be taken when changing these parameters IF you feel unsure about the changes you are doing use the Default button to restore the default parameter values Startup Power Fail Alarms Sampling Tables Temperature Remote Tags TCP IP Web and Report Environment Variables Compatibility Head SMS Command settings Message index Tag SMS message ILJ In Message 0 DO NOTHING 1 START PLIMP 2 STOF PUMP Incoming caller ID Update Recipient tel number Recipient SMS Jean v A message can
150. sponds to the ModBus address to write in Example N20480 123 If ModBus address 20480 contains the value 1000 the value 123 will be written to the ModBus address 1000 We make a distinction between Target address corresponding to an analog Tag and a digital Tag See next With indirect addressing ReadSMS checks the access protection of the port see point 5 below but as it does not access directly the variable is unable to check the Write configuration of the Presentation of the Tag see chapter 8 4 4 Writing Tag with Indirect addressing digital D You write a value directly to a ModBus address representing a pointer Syntax Dmodbus address value The value at modbus address corresponds to the ModBus address to write in Example D20481 1 If ModBus address 20481 contains the value 512 the value 1 will be written to the ModBus address 512 Version 2 07 CHE ow TWinSoft User s Guide 112 5 Access protection P ReadSMS access protection is independent from the GSM port it is associated to In other words even if the communication port is protected ReadSMS will not specially be protected RIU Properties ReadSMS has its General Drivers Security nfo Advanced own independent p Access Security access protection configuration that Global Code Global Code Confirmation can be activated from Protected Ports Type RTU properties C comt R5232 gt Security come R5485
151. ss IP address 192 168 1 SR w Subnet mask Dus cq 1 1 Subnet mask 255 255 255 0 Gateway 15925 Ie ee j 1 Gateway 132 168 1 1 d Prefered DNS 0 0 0 0 4 C Obtain ONS server addresses automatically Alternate DNS UU et 1 Use DNS server addresses 1 DNS server addresses Prefered DNS H D EU 1 Alternate DMS tt SS Ue 3 SG A TO E a m e EF mox s emite e als e m ab gm ccu EE mell er te a nome ams we oma f sw anm Lo mw T MS CPU16 does not support DHCP MS CPU32 supports DHCP IP address the IP address of the Ethernet of TBox MS given by the network administrator Working with several Ethernet ports in your TBox MS check you have IP addresses in different subnets Subnet mask the subnet mask defined by the subnet the TBox MS will be included in given by the network administrator Gateway the IP address of the equipment on the LAN that TBox MS uses to access an IP address outside its subnet DNS DNS Server is used to resolve Names in IP address given by the network administrator The DNS can be the same as your gateway or the one of the ISP It depends on your network architecture Version 2 07 CA wm Gm s TWinSoft User s Guide 48 7 2 Adding Cards All cards other than the CPU must be added in the Resources folder I O cards as well as communication cards T TWinSoft manual2 tws 1 0 Seles zj File Edit View Communication Tools Window Help E X DEA A
152. ssociated Event2 will be generated at that moment Version 2 07 a TWinSoft User s Guide 128 15 High Speed Tags The high speed Tags were designed to receive pulses on digital inputs with handling independent from the cycle of Ladder BASIC logic If the delay between two successive pulses is smaller than the cycle time of the process it will not be possible for instance to make counting from the program Then you can use the High Speed Tags This feature is available for maximum 1 group of 8 digital inputs and the maximum frequency of pulses is limited to 25 Hz with a duty cycle of 50 96 When a pulse is detected it is handled on processor interrupt High Speed Tag Tag B Cancel Action Rising Edge Inc AIV with divisor and weigl v Help Target Tag Tank Water 8 Weight 0 1 I ht Tag Select an existing Digital Tag by clicking the E button If the Tag does not exist you can create it after clicking the button Action Action taken to the Target Tag see next after a status change of the digital Tag defined above The choices are Rising Edge gt Set DIV each rising edge of the digital Tag performs a SET action on the Target Tag which must be an internal variable DIV Falling Edge gt Set DIV each falling edge of the digital Tag performs a SET action on the Target Tag which must be an internal variable DIV Rising Edge gt Inc AIV each rising edge of the digital Tag incre
153. t Type Intemal variable DIVOODO6 Format Modbus Address 20486 E Initial value Ca You type a Tag Name a Comment and select as Type Internal Variable The initial value is the value the Tag will have at the start up of TBox MS If you select Vone the value is maintained at start up A ModBus Address is discussed in chapter 8 3 Version 2 07 SS TWinSoft User s Guide 71 8 2 2 Analog Internal Variable To create an Analog Internal Variable also known as Register from the list of Tags click Add a Tag Select Analog Name Value Address IP Parameters Programs Alarms The Definition menu pops up Pressure Pipel Properties Pressure Pipe Foma b iind Unsigned Modbus Address 20502 E Initial value Example with a 32 bits Unsigned internal variable Version 2 07 AA TWinSoft User s Guide 72 You type a Tag Name a Comment and select as Type Internal Register For each Analog Register the formats available are o 8 bits Signed or Unsigned 16 bits Signed or Unsigned 32 bits Signed or Unsigned Float IEEE 754 O Q0 By default TWinSoft creates Analog Internal Variable in format Float Check it fits with the use you intend to have with the variable The initial value is the value the Tag will have at the start up of TBox MS If you leave the field empty the value is maintained at start up bag
154. t which uses port 502 2 The changing of TCP port is automatically applied to WebForms when building the HTML pages using WebForm Studio ModBus TCP Master port used by TBox MS as Master to access a remote device by default 502 FTP port used by TBox MS to send Files by default 21 SMTP port used by TBox MS to send e mails by default 25 Global MTU MS CPU16 The MTU determines the maximum size of a TCP frame by default 1500 bytes 1500 bytes is the maximum If some intermediate equipments router switch do not support this value it can be reduced As of OS 3 11 xxx MTU size is adjustable separately for each configuration port see in the communication port TCP IP advanced parameters TCP IP addresses for incoming calls Range of addresses used during incoming calls TBox MS uses the first address of the range and applies the following to the remote equipment Typically this information is needed when TBox MS is used as a Web Server dialed from Internet Explorer and TBox Dial It The utility TBox Dial It used to dial TBox MS automatically detects the IP address and uses it as URL Avoid using addresses in the same range as the IP address defined for the LAN card of the PC used as Browser Version 2 07 a TWinSoft User s Guide 42 TCP IP miscellaneous Extended Log MS CPU16 MS CPU16 provides a debugging mode to test TCP IP connection see appendix G 2 The extende
155. ta Upload d Analog Chronology us Anag Sampling Table Timers J Counters Alarms E LJ IP Parameters Terminal Trace Log SO FTP Host SMTP server Program Sources xL NIR Servet SE Eege ee prr Version 2 07 T es SS TWinSoft User s Guide 158 4 Example of TraceLog when sending e mail works fine TCP IP Debug information 36 records Timestamp Value 317 06 3 26 57 PM PPP Disconnect W106 3 26 49 PM LCP Recy TERM ALE 3 1 06 3 26 48 PM LGP Send TEHM HEB gausen geseet gege ee eg a 1 06 3 26 47 PM SMTP 2217 domain Service closing transmission channel 3 1 06 3 26 46 PM SMTP Send QUIT 31 06 3 26 46 PM SMTP 250 Requested mail action okay completed 3 1 06 3 25 45 PM SMTP Send CH LF CR2 zLFz 3 1 06 3 25 45 PM SMTP 354 Start mail input end with CHE CRLF 3 1 06 3 25 45 PM SMTP Send DATA m 317 06 3 26 45 PM SMTP 250 Requested mail action okay completed W106 3 26 44 PM SMTP Send HCPT TU 317 06 3 25 44 PM SMTP 250 Requested mail action okay completed 3 1 06 3 26 44 PM SMTP Send MAL FROM 31 06 3 26 44 PM SMTP 250 Requested mail action okay completed 3 1 06 3 26 44 PM SMTP Send HELL 3 1706 3 26 44 PM SMTP 220 domaint Serviceready 31706 3 26 43 PM DNS Response ok 3 17 06 x25 43 PM ONS Quer to preferred server 0200 t a1 406 3 25 43 PM IPCP Recy CONF ACE 3 1 06 3 25 43 PM IPCP Send CONF_REG 317 06 3 25 43 PM IPCP Recy CONF N F 317 06 3 26 43 PM IPCP Send CLIMF ACE
156. te Sint ica N 61 RK Re ele EE GPUTO eebe 42 Name of eetaton eese 34 CNR EE 89 Operating Gvsiem nenni 28 Cvenvlew m IRI rriis 11 Version 2 07 PACK S GO ie sence 147 Password ET EEN 134 nore E system requirement 16 PC OCD scx RT R M IP address settings 24 Reen EN 23 icd ETE 23 Sne el lei EE 127 RUG m Cro 144 POP aucuns iua M MM REMIS 86 OWE ME AM Meam 44 EENEG Ee TWinSoft document 131 Ne Sacar e ee uc hs uude 108 automatic update recipient 115 SIE AG EL 115 Nee 97 dynamic change 100 group of recipients 101 ISeduridariy EE o0 Remote Tags 122 Creatin Mant 124 through modem 126 timing Datramelers reenen 126 TIO OC esc 123 FRE DOM t I t 76 92 93 96 RODO see enis ense mis uiu itae advanced properties 45 PROS e rs 2f Kine 46 addo Cards mec EU MI N 49 e B Ee 46 3SM GPIS Cald irn rein 53 J 9Ne o EE 51 PSTN modem card 52 Results window eeii neser a 29 RM xxx Confgurator 17 RS232 R EE Ol OP an N 47 pj em m CEU 141 KAN een EE 33 GOVAN CC GC HER 36 GENE ali PD T 34 lyon 36 ModBus address of station 34 name of the station sss 34 Remote ect 41 repon NaMe ui dae lp va Ea uie 45 sampling lei EE 40 summer win
157. ter esses 35 KE EE 41 EM vie le EE 35 UME ZONO eta REDI 35 PSO STOW UID asa me 36 PY UR 21 34 Run Time Parameters TT TWinSoft User s Guide 167 oS Sampling Tables 117 Sampling Tables advanced Dropertes 40 SAVING a document 29 EE e adiu te ue 144 EI 131 Sending an application 30 SaN DO ee Eege OVS PU EE 47 SN Me E ES 97 acknowledgment with incoming SMS 109 RE el 39 monitoring RTU with SMS 111 e BE 84 FCOUMG AI e I 85 Kl 35 System Variables A analog css ee 64 diolta ev mE 62 ello 65 MINAS ees 143 El cC NN 68 analog variable 72 digital variable 70 QFOU Dies C P 68 high speed WR Ee BEEN 129 Og 69 UE Mell eege eege ege eer 73 internal vartables 70 ModBus address eenn neneenen 75 Dresentaion 76 text variable esses 73 Rc e 76 TBOX EE 18 TOP Lei 42 Version 2 07 S WS PP acter RE debugging M S16 esses 158 debugging M32 161 extended log eese see 43 GPRS eettmgs 58 PC setup settngs 24 RB UE e EEN COMMING Ba UE 42 OP the CPU o notru EE 47 Temperature units esses 4
158. ters DM ADV Advanced TCP IP Tag lt COM4 Level LOMA Userld gt lt COM4 Timeout LOMA GPRSStIa LOMA IPAddresss lt COM4 Siglevel lt COM4 Smedtate gt lt COM4 Autengw lt COM4 Modemt lt COM4 Callerld gt lt COM4 MademFo Version 2 07 4 j According to its function a Communication variable is Address Comment i Read Write or Read only Level Protection Level Userld User td y In the following table the Timeout Modem Global Timeout 4 column R W indicates GPRSState GPRS State 1 Read only IP Address IP Address 8 Writable SigLevel Signal level SmeState Head 5M5 State j Auto nswer Modem auto answer ModemState Modem state j Callerld Caller Id d ModemFoT Modem Power On Time d Nee ET Example with COM4 GSM modem e Sh REMO TWinSoft User s Guide 60 Name COMx Level COMx UserId COMx Timeout COM x GPRSsState COMx IPAddress COMx SigLevel COMx SmsState COMx AutoAnswer COMx ModemState COMx CallerID COMx ModemPoT Version 2 07 R W Description Access Control access level of the user currently logged see chapter 16 Access Control user Id of the user currently logged see chapter 16 The user Id and the authority level correspond to those you have defined with the utility PASSWORD The values returns to 0 when the user has disconnected Values can be written to those registers
159. time base of 1 second The result of the calculation is written in the sampling table after the period selected see next This value can be Minimum minimum value during the period Maximum maximum value during the period Average arithmetic average value calculated during the period For each period a new average is calculated Tag format Limitation in recording All periods accepted 16 bits Period limited to 12 hours 32 bits Not available All periods accepted Instantaneous value at the moment of the recording Incremental TBox MS records the difference between the current value and previously recorded value Example of incremental recording Value of the Tag Meee recorded 4 4 4 4 Period Period Period Period Period Period Version 2 07 SS TWinSoft User s Guide 119 Period Period between 2 recordings calculated with the clock of the CPU You may choose between 1sec 2sec 4sec 5sec 10sec 15sec 30sec 1min 2min 4min 5min 10min 15min 30min 1h 2h 4h 6h 12h 24h 48h daily weekly monthly The recording happens at birthday time of the period selected Example if you select as period 5 minutes the recording will be done at 9 25 00 9 30 00 9 35 00 9 40 00 In case you wish to make recording every day or even with a longer period the options are e daily recording once a day e weekly recording onc
160. to inhibit recording When at value 1 inhibits recording in Database Chronology flag that can be associated to any analog chronology configuration to inhibit recording When at value 1 inhibits recording in Database TWinSoft User s Guide 62 Index Name 13 DisCcra 14 DisSam 15 DisAla 16 DaySav 17 PrgEnb 18 Prgonce 19 Toplp bog 20 ALAovf 21 ComErr 22 omtpEr 23 PLDELE 24 NEE 25 GpsVF 26 GPRSErr 27 ModemLog 28 oystembEr 29 MmcToRTU 30 DigChrOv 31 AnaChrOv Version 2 07 R W Description O OO O Flag analog chronology can be associated to any analog chronology configuration to inhibit recording When at value 1 inhibits recording in Database Not used Alarm flag that can be associated to any Alarm condition When associated to an alarm condition and at value 1 the sending of alarm is inhibited Time 1 summer time the ASPE ZoneBias 3600 seconds 0 wintertime Program Enable when reset to 0 allows stopping the execution of BASIC Ladder program It can be useful to execute the program manually see next Program Once when set to 1 executes the cycle of BASIC Ladder program once Useful for debugging the program TBox MS resets the variable automatically TCP Logging MS CPU16 Setting this register activates the Debugging of TCP IP connection Very useful to trace problems when sending e mail or FTP see appendix G 2 When this option has been activated the in
161. tor Phone number PN Code aah cd 2 g If the connection requires a 7 GPRS login select the option ees The server requires Operator Phone Number authentication Connection at startup The server requires authentication If yOU receive a fixed IP address declare it in TCP IP tab Initialization You have to add in the initialization string the APN ask you GSM operator Replace in the string the apn with the URL you receive from your GSM operator Example with Mobistar AT CGDCONT 1 IP WEB PRO BE PIN Code If the SIM card you have inserted uses a PIN code type it at the place of the letter n Example with the PIN code 4896 you should have in the field AT CPIN 4896 including the quotes If the SIM card you have does not require a PIN code you can leave the field as it is or erase it completely Operator Phone number special number to establish the GPRS connection Typically the number is 99 1 Check with your operator and type it following the command ATD Example with Mobistar Proximus SFR AllIP ATD 99 1 Connection at start up Version 2 07 when this option is selected by default TBox MS handles the modem to keep the connection permanently when this option is removed TBox MS handles the connection according to communication variables GPRSCon see below E Ek TWinSoft User s Guide 55 Communication Variables dedicated to GPRS Some communication varia
162. ts is composed of several recipients which can be of different types SMS e mail You can declare several groups Then previous to creating groups of recipients you have to create the recipients see above Recipient Group SMS group OK Cancel Help You can then associate an Alarm condition to a recipient or a group of recipients Working with groups of recipients offers 2 possibilities 1 You select the option Call all recipients the alarm is sent to all recipients one after each other equivalent to the Link with previous generation of RTU the z 2 You dont select the option Call all recipients the alarm is sent to the first one in the list then if it fails to the second then if it fails to the third When it succeeds the sending stops gt equivalent to the Chain with previous generation of RTU the 225 Version 2 07 SS TWinSoft User s Guide 101 10 7 Messages To access the definition of Alarm messages click the folder Alarms in the Project workspace and select Messages New Message Message H Message number indicates the index of message corresponding to its position in the list of messages Type a message of maximum 120 characters This message is user specific If it is for a Digital Pager it will consist only of numbers If it is for a Text Pager or for a GSM it will not contain accent a 10 7 1 Val
163. ture water IN reached Ack ed SMS 24 02 2005 8 11 38 Auto ack 24 02 2005 3 08 25 Hew Program Auto ack Date Time of Message Acknowledg Recipient Date Time of Acknowledg the start of the Status of the the end of the Status of the condition Start condition End The Alarms table does not only display alarms generated in TBox MS but also system events like start up of the program Reset of the TBox MS 10 9 1 Columns description Start Timestamp Date and Time when the alarm condition appears Start condition Message Message or name of the file associate with the alarm System events appear between brackets Start Acknowledgment status of the Start condition The possibilities are Not ack the alarm is still in process Ack ed the alarm has been successfully processed Auto ack the alarm has not been processed successfully In case of system events it is always the case as it is not an alarm but an event Recipient The name of the Recipient from the list of Recipients The name is listed only if the alarm has been sent successfully With chained alarms this allows showing the one that was used In case of system events there is no name End Timestamp Date and Time when the alarm condition disappears End condition Version 2 07 a TWinSoft User s Guide 106 End Acknowledgment status of the End condition When creating an alarm condition there is an option Notify end
164. uccessfully transferred Data connection closed Ux10034388 12 Ftp Ack 150 Accepted data connection Static File name report bet Send STOR Open data connection with server Open data connection Zei d Entering Passive Mode 83 222 131 DU A 211 Send PASY 200 TYPE ts now 8 bit binary Prepare to send repart file Send TYPE Send Report file apt thax etc repart bet z23D LIser i 3 group access to tbosbiz Send FASS Gem 33 User MN Send SEM WENN Welcome ta Pure FT Pd TLS Open control connection with server I LK Password required Version 2 07 N TWinSoft User s Guide 163 Appendix H Terminal mode The Terminal mode allows accessing a modem in AT command Before starting 1 The TWinSoft connection to the RTU MUST be through RS232 at 57600 Bps corresponding to the internal Baudrate of the modem It is not possible to use Terminal mode with Ethernet 2 Working with MS PSTN MS GSM MS GPS you have to use the RS232 port of the card not the RS232 port of the CPU 3 If working with MS GPS be very careful Any command sent is automatically stored in flash It is available from the menu Communication gt Terminal Zu TWinSoft GSM_terminal tws I O Card 2 M5 zj File Edit View Pesmu nee Tools Window Help TN i X PC Setup rn RTU Identification Tags ese Fe Send Program Ctrl F9 g ro Start Stop Program ES WS Set RIU Time E Card Pro
165. ue of Tag in a message Two kinds of value are available The value at the moment the alarm is sent The value will be the value of the Tag at the moment the alarm is accessed the SMS is sent the alarm list is displayed in a WebForm the alarms retrieved from TView The syntax is TAG with TAG the name of the Tag The value at the moment the alarm appeared The value will be frozen to the one at the moment the alarm is stored in the stack of events The syntax is TAG with TAG the name of the Tag Remarks 1 Tag TEXT cannot be used in a message with Tag No problem with Tag 2 With MS 16 and TBox LITE ONE Tag can be inserted in a message No limit with Tag 3 With MS 32 TWO S Tag can be inserted in a message No limit with Tag With a Digital Tag for which you have defined States in the Presentation menu those states will used otherwise O and 1 With a Float Tag for which you have defined a number of decimals in the Presentation menu this number will be used otherwise fixed to 3 decimals Version 2 07 CS Ss Lu TWinSoft User s Guide 102 10 7 2 String in a message Possibility to include a series of ASCII characters in one alarm message Put character Hyphen in front of the TAG Syntax like follows I say TAG to everybody TAG will be replaced by characters corresponding to ASCII code starting at Tag TAG It ends when code 0x00 is encountered or afte
166. utput 10 DO 3 1 11 Digital Output 11 DIROUOUS JL Emergency JL Trigger RT JL Motor 1 JL Motor z JL Pump 1 JL Pump 2 JL 1i minutes k CO OO rz KF CO CH af VI cO al C On R CO online COM1 9600 Engineer The Tags can be sorted into Groups of Tags From the list of Tags right click From the Context menu select New Group You can then move create Tags into the Group Version 2 07 CA wm Gm s TWinSoft User s Guide 68 8 1 Physical I O The physical I O s are the signals available on I O cards They can be easily accessed from the Resources see chapter 7 The Resources To create a Tag of a variable from the Resources select it into the list and double click it change its name and description gt click OK If you are connected to a TBox MS when the Tag is created you will see appearing in the column Value This is because the ModBus address of the Tag needs to be sent to TBox MS see chapter 8 3 ModBus addresses Once the program has been sent the value appears z xl annel Comment un Digital Input O Digital Input D of COMBE E Tags Digital Input 1 EREZ Resources zDI3 0 27 Digital Input 2 B RG cDL3 0 37 3 Digital Input 3 MS CPLILGE DL3 0 47 4 Digital Input 4 c Rack3 MS COMBO 1 DL3 0 5 5 Digital Input 5 B Group 0 8 DI DL3 0 62 5 Dig
167. v Name M anual Modbus Address 1 US Version Offline Sub amp ddress Sch SE Telephone Number SIZE Digital Chronology records Analog Chronology record Time Zone Time Zone RTU Type Name ModBus address Sub address Version 2 07 Summer Winter Management The type of RTU you have selected with the Wizard see chapter 4 1 It cannot be changed type a free name for the TBox MS It will be displayed when doing a RTU identification and used by the supervisory 2wew Maximum 8 characters with ModBus protocol each device must have a Station number It is its ModBus address Enter a number between 1 and 254 default 1 if more than 254 TBox MS must be installed in one project you need to define a Sub address As this is not ModBus standard it is only supported by TComm dll based software TWinSoft view please call your distributor for further information Enter a number between 0 and 255 default 0 TWinSoft User s Guide 34 OS version when working Offline it is the OS used to simulate the compilation By default it is the OS version associated to version of TWinSoft Telephone number Configuration used by TWinSoft when it needs to dial TBox MS Sizes Number of records of Digital and Analog chronologies The chronologies are the on event method of recording data in TBox MS see chapter 12 Data logging MS CPU16 MS
168. with TWinSoft you have to send it You can use any media to achieve it RS232 modem Ethernet Possibilities for sending a program e Use the icon E of the main tool bar e From the main menu use Communication gt Send program e Use the accelerator keys lt CTRL F9 gt The sequence for sending is Compiling Sending If a problem occurs during compiling the sequence is stopped and the Results window pops up If you interrupt the sending of the program or an error happens before the end of sending TBox MS will not restart even after a reset The reason is that the program is composed of several modules when starting TBox MS checks the integrity of those modules When they do not correspond to the same sending the program does not start even after a reset You have then to re send the program The good news is that TBox MS keeps its original settings before it was stopped Version 2 07 CA wm Gm s TWinSoft User s Guide 30 ZI TNI Oar PROGRAMMING Version 2 07 S Ru TWinSoft User s Guide 31 5 Introduction TWinSoft uses the standard look and feel of Windows Explorer with at the left side a list of folders and at the right side the content of the folder selected Each Folder consists in a list of items For instance the list of Tags or in the Alarms folder the list of Recipients or in the Datalogging folder the list of Sampling tables
169. you activate the Access security option the TWinSoft document will also be protected even if no port has been selected The standard port protection concerns ModBus protocol on serial and modem ports A protection on Ethernet connection is also available as of TWinSoft 10 03 and OS 3 17 The protection is based on a four digit hexadecimal global code that is saved in the TBox MS This code is used as root for controlling different logins and access levels to the TBox MS Three access levels are available to access protected port s of TBox MS e Level 1 Surveillance mode or VISUALIZATION MODE The operator can view all TBox MS values local or remote but cannot execute any command e Level 2 COMMAND MODE the operator can view all the values and execute commands locally or remotely Also known as READ WRITE MODE e Level 3 ENGINEER MODE the operator can view all the values execute commands and send new application locally or remotely Version 2 07 SS TWinSoft User s Guide 131 16 1 RTU configuration The configuration of security of TBox MS is available from the RTU properties there is a general activation of the protection for each serial or modem port you activate the protection 16 1 1 RTU Properties From the RTU properties gt tab Security you activate the general access security feature RTU Properties General Drivers Security Info Advanced Access Security Global Cade
170. za Windows Journal Viewer e Windows Media Player i gt Windows Messenger Turn Off Computer Other programs and menus Accessories group containing the utility Password generator and Reset User preferences reset of registry information to restore the default configuration of TWinSoft Documentation group containing the various documents associated to TWinSoft and RTU Samples group with TWinSoft documents installed as example TBox drivers when C custom drivers have been installed The on line help of the driver configuration is available in this folder Report Studio to create reports dedicated to TBox MS TWinSoft to start TWinSoft WebForm Studio to start the HTML editor dedicated to TBox MS when it is used as a Web Server Version 2 07 a TWinSoft User s Guide 19 4 Starting TWinSoft I am the Wizard of TWinSoft When you start TWinSoft the first time or when you create a new document help you with some basic configurations Hew RTU Document Wizard Welcome This wizard helps you get started faster by gathering information about your ATU Please select the type of your ATU ie T TBHax CPUS E d T B oxL T F Low Power lt Back TBaxMS Offline The use of TWinSoft is free but sending a program to TBox MS is protected For more info about Licenses go to Appendix A at the end of this manual Version 2 07 E en TWinSoft User s Guide 20 4 1 Wizard

TBoxMS - User's Guide

Contents

Download Pdf Manuals

Related Search

Related Contents