WINCON WEB DAEMON
Contents
1. Select File Save from the menu Type in the name defaults xml This will create a new defaults xml file for you2. lt java version 1 5 0 04 class java beans XMLDecoder gt lt object class com quanser neesit daemon DaemonCore gt lt void property applicationName gt lt string gt Wincon WebDaemon lt string gt lt void gt lt void property connectionThreadSleep gt lt int gt 100 lt int gt lt void gt lt void property dataDuration gt lt double gt 5 0 lt double gt lt void gt lt void property fetchTimeout gt lt long gt 1000 lt long gt lt void gt lt void property inputStreamBufferSize gt lt int gt 102400 lt int gt lt void gt lt void property outputStreamBufferSize gt lt int gt 8192 lt int gt lt void gt lt void property password gt lt string gt lt string gt lt void gt 13 lt void property serverAddress gt lt string gt localhost lt string gt lt void gt lt void property sourceArchiveSize gt lt int gt 1 lt int gt lt void gt lt void property sourceCacheMode gt lt string gt none lt string gt lt void gt lt void property sourceCacheSize gt lt int gt 1 lt int gt lt void gt lt void property threadIdleTime gt lt int gt 100 lt int gt lt void gt lt void property useUTC gt lt boolean gt true lt boolean gt lt void gt lt void property userName gt lt string gt lt string gt lt void gt lt object gt lt java gt The format of the file follows a property value pairing For each proper
3. 1 default_sample_time Receive timeout seconds idefault_sample_time 4 Sample time seconds default_sample_time Figure 5 Parameters for the NEES Signal block NEES Connection This specifies how the connection parameters are managed By selecting lt default gt the NEES Connect block is selected Multiple NEES Connection blocks may be used in the diagram to stream data to different locations so this dialog allows the user to select which block is in use Signal Name The name of the signal which is in the Data Turbine Note that this must be the fully qualified name of the signal The signal is retrieved by name reference from the Data Turbine Number of Channels Specifies the number of channels used by this block Number of Records in a Frame Specifies the number of records samples in a frame The value is entered as a formula by default The value of default_sample_time is typically 0 001s so there will be 100 records stored within a single frame Receive timeout This value specifies how long to wait before issuing a timeout A higher value may be required when there is a significant amount of network traffic Sample Time This value represents the time between samples By default this is set to the default sample time 0 001s NEES Scope Block The parameters of the NEES Scope block are described below Block Parameters NEES Scope NEES Scope mask This block streams data t
4. NET version with latest service packs v Windows XP or 2000 v Creare RBNB Data Turbine Download from http outlet creare com rbnb RUNNING THE SOFTWARE Note In order to run the software the user will require a running RBNB Data Turbine to connect to This may be running on the user s local machine or it may be a remote address The address of this machine running the Data Turbine and the connection port must be known The WinCon Web Daemon software is packaged as an executable jar file This means that on most Windows based systems the user may double click to execute the program This should work correctly for Java 5 installations A Java 5 Virtual Machine JVM must be installed on the system When the user double clicks the file the following window should be visible Q WinCon WebDaemon Waiting for configuration Figure 7 Opening window of the WinCon Web Daemon Note the message indicating that the program is waiting for configuration information Without the configuration information the location of the Data Turbine is unknown There are several methods to configure the WinCon Web Daemon These methods are listed below and then discussed in further detail Configuration from within the application Using a defaults xml file Opening a previously saved configuration file The WinCon Web Daemon uses an XML file format for storing the configuration data This makes editing and using the configuration files simple a
5. it R a E EE A AA AA A E E 7 SOFTWARE PREREQUISITES Jiissescsecssesssiasdenccesesesssesscesseusssesossscsescaassuvsssesssescauscunsoscassescdecssussscascesccesssessedaccescceues Software Requirements CHECKS tic ais escacisvccss cchs caceehs io at desea ce 8 RUNNING THE SORTWA RE io Configuration From the DPTO A A wom veg Et 9 Using the Defaults x till Per ir o li 12 Opening a Configuration FILE A a A a AOS 14 Saving a Configuration Fils a id 14 Creating a New Detalla a Leo a 15 List or FIGURES Figure 1 Overview of the required software Components ivcaisa iniciadas 1 Figure 2 Components required for stream data from a Simulink diagraM oooncnncnncinnonnonncnoccnnnconanonons 3 Figure 3 Components required to send data to the Simulink diagraM concnccnccincinnonncnnonconnnonannncnnccnnonnss 4 Figure 4 Block parameters for the NEES Connect block oooonionnncnionnnononncoronnnononnnnnnnnconncoronnnononnoos 5 Figure 5 Parameters tor the NEES Signal bloc ad 6 Figure 6 Parameters for the NEES Scope DOCK iiccccsccssssasiesstenccencssncassterecsesetenstauatonsedvandussoacesscetnedeasieceunes 7 Figure 7 Opening window of the WinCon Web Daemon c ccecesseeseesseeseeesereeeeeeeaeeeeeeseeeseseeeereeaees 9 Figure 8 The RBNB connection configuration dialog eecceseesseeessceseeeeeeeseeeeseceeeeeseeeseeeeseeeseeesaes 10 Figure 9 WinCon connection configuration dl a ca bai 11 Figure 10 The Daemon running message d
6. system is designed blocks may be added to stream specific variables to the Internet In the example used the control system for the shake table is in a block called Shake Table Control System Within this block are the functions that control the shake table For our purposes this is not important to discuss here since we are focusing on connecting a previously built system to the outside world We wish to display the Displacement variable which represents the position of the shake table stage and we will use a NEES Scope block to do this shaker _control File Edit View Simulation Format Tools Help WinCon Dig S tw oa y int Extemal y NEES Connect Displacement Q Shake Table Control System NEFS Scopa Ready 100 FixedStepDiscrete NEES Scope Block NEES Connection Shake Table Control System Manager Block Figure 2 Components required to stream data from a Simulink diagram The diagram shown in Figure 2 shows the components required for streaming data from a Simulink diagram The key components in the diagram are shown below Shake Table Control System This block contains a series of other blocks put together to control the shake table These blocks are grouped together in what is called a subsystem The subsystem is named the Shake Table Control System There is a single output from this subsystem displacement The displacement parameter is the measured position of the shake table NEES Connect Block
7. The NEES Connect Block manages the connection parameters for the other NEES blocks It is with this block that the remote connection settings made Referencing this block to manage the other NEES block s connection settings makes it simple to adjust the connection parameters globally NEES Scope Block The NEES Scope block is responsible for streaming data to the WinCon Web Daemon The connection parameters for this block may be entered individually or it may reference the NEES Connect block to manage the connection parameters shake r_control File Edit wiew Simulation Format Tools Help WinCon De FE ad x F lint Extemal y NEES Connect NEES 1 NEES Signal receiving NEES Signal 0 Shake Table Control System FixedStepDiscrete NEES Signal Block Figure 3 Components required to send data to the Simulink diagram The diagram in Figure 3 shows the components necessary to send data to the Simulink diagram The components are identical to Figure 2 with the NEES Scope block being removed and the NEES Signal block being added The NEES signal block may accept input values from the Data Turbine and input them as parameters to the Simulink diagram NEES Signal Block The NEES Signal Block accepts data from the Data Turbine and sends the data to the Simulink diagram NEES Connect Block The parameters for the NEES Connect block are shown below 3 Block Parameters NEES 1 NEES Connect mask link This block establis
8. WINCON WEB DAEMON User s MANUAL How to contact Quanser 1 905 940 3575 Telephone 1 905 940 3576 Facsimile 80 Esna Park Drive 1 3 T Markham ON Mail Canada L3R 2R6 http www quanser com Web mailto info quanser com General information WinCon Web Daemon User s Manual MATLAB is a registered trademarks of The MathWorks Inc Other brands and their products are trademarks or registered trademarks of their respective holders and should be noted as such 2005 Quanser Inc All rights reserved This work may not be translated or copied in whole or in part without the written permission of the copyright holder except under the terms of the associated software license agreement No part of this manual may be photocopied or reproduced in any form The use of general descriptive names trade names trademarks etc in this publication even if the former are not especially identified is not to be taken as a sign that such names as understood by the Trade Marks and Merchandise Marks Act may accordingly be used freely by anyone Printed in Canada TABLE OF CONTENTS INTRODUCTIONS is iiccissvecscsasedicsssdsesessesesseeseasesectacesdssbedseawschbestesbosdeiestesacdcessteedessebecsce sssesedsesecedesessveussacexcceesstes 1 O TA Connecting A Md A a io 2 NEES G onnect Block dci ino cto A E TA tht olde EA aA EA ATA AE 5 NEES Signal Block ree aae e e A Ral e E E O 6 NEES Scope Block
9. components WinCon 5 0 18 0 or higher with TCP IP blocks installed MATLAB 7 0 1 RTX 6 0 1 Microsoft Visual Studio 6 0 or NET editions with latest service packs For detailed information on the setup and usage of WinCon please refer to the WinCon user manual This manual covers the required software components and the installation process in detail In addition to the software mentioned above the WinCon Web Daemon software requires a Java Virtual Machine JVM to run The software has been tested with Java 5 from Sun This software s available for download from the Sun website http java sun com The user may choose to use either the Java Runtime Environment JRE or the Java Development Kit JDK versions of the software If you intend to do any Java programming the JDK download should be selected To just run the software on the JRE is required Software Requirements Checklist The required software components are listed here for convenience The user should still consult the proper manual for additional setup and usage instructions As well be aware that the WinCon compatibility chart should be consulted before deviating or upgrading any of the components listed below v Java 5 Either the JRE runtime environment or JDK development platform Download the appropriate package from http java sun com v WinCon 5 Build version 5 0 18 0 or later with TCP IP support v MATLAB 7 0 1 v RTX 6 01 v Microsoft Visual Studio 6 0 or
10. d at any time not just when the application starts Another method of opening a configuration file is by specifying the filename on the command line An example of this follows java jar wwdaemon jar configuration xml In this example the configuration file to be loaded is called configuration xml To change the loaded file change this filename The rest of the command line should remain the same Specifying the configuration in this manner launches the application with the settings specified in the configuration file Saving a Configuration File Selecting File Save will open a dialog to allow the saving of the configuration files These files may then be loaded with the File Open command from the command line or by default by naming the file defaults xml and saving it in the applications working directory the directory where it is run from 15 Creating a New Defaults xml file In the event that the defaults xml file is lost or the user wish to use the default settings a defaults xml file may be created The required settings may be typed into a file and then saved A simpler method would be to have the application generate the defaults for you To do this follow these steps 1 Delete or rename the existing defaults xml file When the application is launched it will not find this file and setup with the initial default values 2 Start the application without any file arguments This will ensure that no file is loaded
11. hes the parameters for connecting to the Quanser NEES daemon Parameters Host Name or IP Address Port 9999 V Enable Nagle Algorithm Receive Buffer Size 65535 Send Buffer Size 65535 Cancel Help Apply Figure 4 Block parameters for the NEES Connect block Host Name or IP Address This is the address of where the WinCon Web Daemon is located on the network This information can be entered as a network address in the form of 192 168 1 1 or as a network name Port This represents the port on which The Web Daemon will listen for incoming connections from the NEES Scope and NEES Signal blocks Enable Nagle Algorithm enables the use of the Nagle algorithm which buffers small packets to improve network efficiently by reducing the number of packets sent Receive Buffer Size The size of the receive receive buffer in bytes to use Data is buffered to allow for network congestion The default values should suffice for most applications Send Buffer Size The size of the transmit send buffer in bytes to use Data is buffered to allow for network congestion NEES Signal Block The parameters of the NEES Signal block are described below Block Parameters NEES Signal NEES Signal mask This block receives data streamed from an RBNB repository Parameters NEES Connection lt default gt Signal name NEES Signal 0 Number of channels 4 Number of records in a frame max 1 0
12. isplayed when connected to Data Turbine 0 12 INTRODUCTION Quanser s WinCon software allows the user the unique ability to design hardware in the loop systems Integrated with MATLAB s Simulink design environment a control system may be graphically designed This graphically designed system may then be run in real time on a Windows based machine This ability to rapidly design and execute code in a development environment makes WinCon extremely useful in the rapid prototype and development fields By modifying the control system to include blocks for streaming of data this data may then be streamed to the Internet By streaming this data to a centralized location or repository allows many users to visit this location and retrieve and modify the data Creare offers a product called RBNB Data Turbine which is a dynamic data server The Data Turbine acts like a distributed network file system for data In order to facilitate the sharing of data and collaboration between labs the WinCon Web Daemon was developed This software acts as a bridge between WinCon and the Data Turbine The controller running in real time under WinCon s control streams data to the WinCon Web Daemon The Web Daemon in turn passes the data on to the Data Turbine Similarly data posted to the Data Turbine may be retrieved and presented to the running controller as a parameter value These software components permit the sharing of data and open up the possibili
13. n the Data Turbine before it is overwritten Note that on some distributions of Data Turbine this functionality may be limited sourceCacheMode The mode to be used for archiving data Note that on some distributions of Data Turbine this functionality may be limited sourceArchiveSize The size of the archive used for permanent storage Note that on some distributions of Data Turbine this functionality may be limited threadIdleTime The frequency that data will be written to Data Turbine This is actually expressed as f 1000 threadIdleTime where the time is expressed in units of milliseconds ms For example a threadIdleTime of 250 would provide an update rate of 1000 250 4 Hz listenPort The application will listen for incoming connections from WinCon on this port Note that if this value is changed the connection parameters of the individual NEES Scope blocks will need to be changed For more information see the section titled Simulink Blocks inputStreamBufferSize The buffer size in bytes to use for buffering incoming data This may be adjust based on sampling rate and network congestion outputStreamBufferSize The buffer size to use for buffering outgoing data Opening a Configuration File Selecting File Open will open a file chooser dialog to allow the user to select configuration files to open This has a similar effect as putting the configuration settings in defaults xml with the exception that this file may be loade
14. nd easy to maintain Configuration From the Application Using the menu in the application select File gt Configure This will open the configuration dialog The configuration dialog will appear and allow the user to make changes to the way the WinCon Web Daemon works 10 Configuration RBNB WinCon Application Name Wincon WebDaemon Server Address localhost User Name Password Source cache size 10000 Source cache mode none Archive size 1 Update frequency ES Figure 8 The RBNB connection configuration dialog The configuration dialog contains two information panes one for RBNB configuration and one for WinCon configuration Application Name This is the name of the source as it will appear in the Data Turbine s tree view You may rename this to something more meaningful if desired The name is in the form of a string and may contain characters numbers and spaces Server Address The server address is the network address of the RBNB Data Turbine This can be entered in a variety of ways including the formats 192 168 1 1 IP address 192 168 1 1 3333 IP address and port number data turbine server network name data turbine _server 3333 network name and port number User Name The assigned user name Note that on some distributions of Data Turbine this functionality may be limited Password The assigned use
15. ng incoming data This may be adjust based on sampling rate and network congestion Output Buffer Size The buffer size to use for buffering outgoing data To accept any changes and to re connect to the Data Turbine click OK when finished To cancel any changes click on the Cancel button Note that when OK is selected the connection to Data Turbine will be closed and re opened automatically for the changes to take effect 12 When the dialog is closed by clicking OK WinCon Web Daemon will close the open network connection with the Data Turbine For this reason it is recommended to stop the controller running on WinCon first before making any changes to the WinCon Web Daemon settings Once the connection has been made the message in the application window will read Daemon running Q WinCon WebDaemon Daemon running Figure 10 The Daemon running message displayed when connected to Data Turbine Using the Defaults xml File Using the defaults xml file allows the user to setup a configuration whenever the application is launched Essentially the defaults xml file allows the user to change configuration information in much the same way as the Configuration Dialog but with more options and flexibility Without going into details about the format of the file the relevant fields to edit are noted below For convenience a listing of the defaults xml file is reproduced here lt xml version 1 0 encoding UTF 8 gt
16. o an RBNB repository Parameters NEES Connection lt default gt Number of records in a frame max 1 0 1 default_sample_time Sample time seconds 1 Figure 6 Parameters for the NEES Scope block NEES Connection This specifies how the connection parameters are managed By selecting lt default gt the NEES Connect block is selected Multiple NEES Connection blocks may be used in the diagram to stream data to different locations so this dialog allows the user to select which block is in use Number of Records in a Frame Specifies the number of records samples in a frame The value is entered as a formula by default The value of default_sample_time is typically 0 001s so there will be 100 records stored within a single frame Sample Time This value represents the time between samples By default this is set to the value of 1 In Simulink this instructs the block to use the sample time of the input to this block In other words if the preceding block uses a sample time of 0 001s this block will inherit this same sample time SOFTWARE PREREQUISITES This software relies on several software components At the core of this software is the real time software WinCon by Quanser Inc WinCon version 5 0 18 0 or higher is required to run the software Java Daemon In addition the TCP IP communications blocks are required to properly run the software A typical setup includes the following
17. r password Note that on some distributions of Data Turbine this functionality may be limited Source cache size The size of the cache used for storing data sent to the Data Turbine This is effectively the amount of data that may be temporarily stored on the Data Turbine before it is overwritten Note that on some distributions of Data Turbine this functionality may be limited 11 Source cache mode The mode to be used for archiving data Note that on some distributions of Data Turbine this functionality may be limited Archive size The size of the archive used for permanent storage Note that on some distributions of Data Turbine this functionality may be limited Update frequency The frequency that data will be written to Data Turbine Effectively the Web Daemon may buffer data for a short period of time to optimize network performance The units are in Hz with the default being 10 Hz Configuration WinCon Connection Port 19999 Input Buffer Size 1102400 Output Buffer Size 18192 OK Cancet_ Figure 9 WinCon connection configuration dialog WinCon Connection Port The application will listen for incoming connections from WinCon on this port Note that if this value is changed the connection parameters of the individual NEES Scope blocks will need to be changed For more information see the section titled Simulink Blocks Input Buffer Size The buffer size in bytes to use for bufferi
18. ty there exists a value To edit the file simply locate the property shown in bold and then edit the corresponding value Save the file and then open it or specify it as the name defaults xml As with the configuration dialog the names of the properties are quite descriptive They are listed below but the user should note that the file is case sensitive Only the most commonly used properties are described here Consult the appendix for a full explanation of the remaining properties applicationName This is the name of the source as it will appear in the Data Turbine s tree view You may rename this to something more meaningful if desired The name is in the form of a string and may contain characters numbers and spaces serverAddress The server address is the network address of the RBNB Data Turbine This can be entered in a variety of ways including the formats 192 168 1 1 IP address 192 168 1 1 3333 IP address and port number data _ turbine server network name data_turbine_server 3333 network name and port number userName The assigned user name Note that on some distributions of Data Turbine this functionality may be limited 14 password The assigned user password Note that on some distributions of Data Turbine this functionality may be limited sourceCacheSize The size of the cache used for storing data sent to the Data Turbine This is effectively the amount of data that may be temporarily stored o
19. ty of remotely sharing and collaborating on projects Simulink lt WinCon Web Daemon Diagram RBNB Data Turbine Remote qn User 1 Remote Remote User User 2 n Figure 1 Overview of the required software components OVERVIEW The complete system is composed of many individual components These components are discussed here to familiarize the user with them To help demonstrate the concepts involved an example will be used The example is a shake table system capable of replaying earthquake data to test structural models The basic design process involves the following steps 1 Designing the control system This will result in a graphically designed controller capable of controlling the motion of the shake table 2 Build the control system Building the system is similar to compiling code In the graphical environment each of the blocks actually represents instructions or code Building the control system creates an executable a type of program which WinCon can run 3 Run the control system The system is run as a program under the control of WinCon WinCon is responsible for making sure the controller runs in real time The process described above is an overly simplified view used solely for illustrative purposes Connecting A System The first step to publishing data to the online repository is to create a Simulink diagram The Simulink diagram is what controls the system Once the control
Download Pdf Manuals
Related Search