Home

MDG Technology for DDS User Guide

1. d DDS MDG Technology m Y MDG Technology for DDS User Guide Welcome to the MDG Technology for DDS User Guide The MDG Technology for DDS enables you to work simultaneously with both Enterprise Architect and DDS and merge the changes with minimal effort SF SYSTEMS Copyright 2007 2009 Sparx Systems Pty Lid MDG Technology for DDS User Guide Introduction by Simon Zhang MDG Technology for DDS provides a lightweight bridge between Enterprise Architect and DDS MDG Technology for DDS User Guide 2007 2009 Sparx Systems Pty Ltd All rights reserved No parts of this work may be reproduced in any form or by any means graphic electronic or mechanical including photocopying recording taping or information storage and retrieval systems without the written permission of the publisher Products that are referred to in this document may be either trademarks and or registered trademarks of the respective owners The publisher and the author make no claim to these trademarks While every precaution has been taken in the preparation of this document the publisher and the author assume no responsibility for errors or omissions or for damages resulting from the use of information contained in this document or from the use of programs and source code that may accompany it In no event shall the publisher and the author be liable for any loss of profit or any other commercial damage caused or alleged
2. 2 ner cee eene rel rn in hrad hen inak ENEE 16 DDS Optlon E 17 IK IcReuI 17 Qos Policy Specifications Dialog 18 aler E 18 OSPLDDS Optioris 5 Eder Lee o Koda Ti 20 DDS TOOIDOXES ege ne ee nak ao in An ee eee 22 nm M 22 Local RECONSIFUCTION esr 23 TYPOS IRR 25 QOS aaan EDIDIT 26 Application Target iocur ratto Ka NEO lea nanman hd c p X do a 28 Create DDS Project geed aa 30 Using Template is e 30 Without a Template lt lt 4 lt 30 Create DCPS Mod l T TT O O ER NM O OTTA 31 Create DLR Model T 34 Model Validatiom n 38 Model Validation Rules for Elements 38 Generate PSM and Code 5 5 a 5 I eiu nul Re u j lub kn 40 DDS celui 40 I wucuruaribpiee E 41 DS Example MoOdll
3. 2 2 1 zu Lace eco D a asik Noon zu ac taie a canda ci u oka iOT Kane NEEN 45 Index 47 2007 2009 Sparx Systems Pty Ltd Foreword 1 Foreword MDG Technology for DDS provides a light weight bridge between Enterprise Architect and DDS 2007 2009 Sparx Systems Pty Lid 2 MDG Technology for DDS User Guide 1 Welcome DDS MDG Technology m Welcome to the MDG Technology for Data Distribution Service DDS Enterprise Architect MDG Add In Version 2 0 The Add In extends the capability of Enterprise Architect to enable you to create Data Distribution Service DDS models The language specification for DDS is available from the Object Management Group OMG website Data Distribution Service for Real time Systems Specification Getting Started For instructions on how to install the MDG Technology for DDS see Getting Started 10 See Also e Copyright Notice 3 e Trademarks 7 e Support sh e License Agreement 44 e System Requirements 9 2007 2009 Sparx Systems Pty Ltd Copyright Notice 3 1 1 Copyright Notice Copyright 2007 2009 Sparx Systems Pty Ltd All rights reserved The MDG Technology For DDS software contains proprietary information of Sparx Systems Pty Ltd It is provided under a license agreement containing restrictions on use and disclosure and is also protected by copyright law Reverse engineering of the software is prohibite
4. user long 4 Add a new DDS DLAL Diagram Select the Add Ins DDS Technology New DLRL Diagram menu option to create a DDS DLRL diagram Give this diagram appropriate name Then i Drag the DomainParticipant and its children Subscriber Publisher as well as Reader Writer elements in the DCPS package from Project Browser to the diagram And drag the DLRL Class element in the current package to the diagram ii Add some Cache elements Create Associations between the Cache element and the DCPS DomainParticipant element Create Associations between Cache element and the DLRL Class elements iii Add a Object Home Part inside the Cache element Create Topic Manager ports to the Object Home part Then create Dependency connectors from each Topic Manager port to related DataReader DataWriter port within DCPS elements The diagram below is an example of the above process 2007 2009 Sparx Systems Pty Ltd 36 MDG Technology for DDS User Guide domainParticipant DCP S ChatRoom subscribers userReader diri Clase MessageClass adinAttibute Name string UseriD long dirAttnbute Index long Mesmge sting tags mappedTopic UserTopic mappedType UserType tags mappedTopic MessageTopic msppedT ype MessageType 5 Open an existing or create a new DDS Application diagram then drag the DLRL Cache element from Project Browser to the diagram You can either
5. CJ default 503 Data Distribution Service A package containing the default set of QoS Policies for use in creating DDS Publish Subscribe models In the Project Browser add two packages to the project Give these packages names appropriate to the project and purpose e A Platform Independent Model PIM package e An Platform Specific Model PSM package Add a new child Package in the PIM package Give this package appropriate name Add a new DDS Type Diagram to the package Select the Add Ins DDS Technology New Type Diagram menu option to create a DDS Type diagram In the diagram create the IDL type elements and add key and other field to the elements Add a new DDS Domain diagram to the package Select the Add Ins DDS Technology New Domain Diagram menu option to create a DDS Domain diagram In the diagram create the DDS Topic elements and assign the Tagged Value Type to the elements Create a domain element then create the DomainParticipant elements and assign the Tagged Value of Domain to the elements i Create DDS Topic elements and assign the Tagged Value Type to the elements ii Create a domain element then create DomainParticipant elements and assign the Tagged Value of Domain to the elements iii Within the DomainParticipant elements create Publisher Subscriber elements iv Create DataWriters for each Publisher and DataReaders for each Subscriber v Create connectors between the Topics and
6. Agreement 4 Support 8 RTIDDS System Requirements 9 Generate 40 41 Using DDS 15 Options 18 Welcome 2 Model Validation 38 Configuration 38 m S m Perform 38 Rules for Elements 38 Support 8 System Requirements 9 N T NDDS Generator 41 Trademarks 7 O U OpenSplice DDS Generate 40 41 Using DDS 15 Options 20 OSPLDDS V Generate 40 41 Options 20 Validation Of Model 38 P Rules For Elements 38 PIM W Add DLRL Model 34 Create 30 Welcome 2 Platform Independent Model Add DLRL Model 34 Create 30 Platform Specific Model DDS Addln Generate Code 40 Generate 40 41 Generate Executable Class 40 PSM DDS Addln Generate Code 40 Generate 40 41 Generate Executable Class 40 Q Qos Policies Elements 26 Library Diagram 26 Toolbox 26 QoS Policy Specifications Dialog 18 2007 2009 Sparx Systems Pty Ltd 49 2007 2009 Sparx Systems Pty Ltd MDG Technology for DDS User Guide www sparxsystems com
7. Autogenerate Source Generate DLRL Source v Generate Listener for DDS Reader V Generate Listener for DDS Writer Project Files Choice Generate Workspace and Project Files Workspace Name OSPLDDSAppiication 1 Advanced Options Notes Generate Shared Files as Library This option only apply when Library Name DDSWorkSpace 1Util generate code from DDS Addin Fed Description ooo Project Root Root directory in which all the PSM output should be created Enable OSPLDDS PSM Select the checkbox to enable the transformer deselect to disable the transformer Autoname Source Files Select the checkbox to enable the OSPLDDS transformer to automatically allocate filenames to the generated source code recommended Autogenerate Source Select the checkbox to enable the OSPLDDS transformer to automatically invoke the code generation process to the PSM after it has been successfully generated Generate Listener for DDS Select the checkbox to enable the OSPLDDS transformer to automatically 2007 2009 Sparx Systems Pty Ltd DDS Options 21 Fed Description ooo generate a Listener for each DDS Reader Autogenerate IDL Select the checkbox to enable the DDS Topic Type elements to automatically be generated to IDL code during the transformation process Generate DLRL Source Select the checkbox to enable the codes for DLRL specialized interfaces and classes to automatically be gene
8. Key field of another IDL element A stereotyped Attribute that represents an IDL Constant Method A stereotyped Operation that represents an IDL Method 2007 2009 Sparx Systems Pty Ltd 26 MDG Technology for DDS User Guide 3 3 4 QoS The DDS Qos Policies toolbox provides elements for use on a DDS Qos Policies Library diagram i QoS Policies Deadline Destination Order Durability Service Durability Entity Factory Group Data History Latency Budget Lifespan Liveliness Ownership Strength Ownership Partition Presentation Reader Data Lifecycle Reliability Resource Limits Time Based Filter Topic Data Transport Priority User Data Writer Data Lifecyde Element Description Deadline A stereotyped Class element that specifies the Deadline Qos Policy It applies the following Tagged Values MU W Wl Wl Wl Wi Wi a e period duration in nanoseconds default 1 Destination A stereotyped Class element that specifies the Destination Order Qos Policy It applies the Order following Tagged Values e kind Enumeration BY_RECEPTION_TIMESTAMP default BY_SOURCE_TIMESTAMP Durability A stereotyped Class element that specifies the Durability Service Qos Policy It applies the Service following Tagged Values e history depth Integer depth value default 1 history kind Enumeration KEEP LAST default KEEP ALL max instances Integer maximum value default 1 to keep all instances max sampl
9. create a Usage relationship from an existing DDS Application component to the Cache element or create a new DDS Application component and then create a Usage relationship between the new created DDS Application element and Cache element Note e The DDS Application component must also have a Usage relationship with related DomainParticipant components otherwise the generated code will not be compilable The diagram below is an example DDS Application diagram including the DLRL Cache d inPartici A S d ads domainParticipant y ec DLRL NetChatCache Drac tags access ReadWhnte ddsAppT arget ddsAppTargete NetChat1 NetChat2 tags language Java platform i86JDK13 tags language C platform i86Win32 2007 2009 Sparx Systems Pty Ltd Create DDS Project 37 2007 2009 Sparx Systems Pty Ltd 38 MDG Technology for DDS User Guide 3 5 Model Validation The MDG Technology for DDS registers with Enterprise Architect to receive model validation reguests from users To configure Enterprise Architect to perform DDS model validation select the Project Model Validation Configure menu option from the Enterprise Architect main menu The Model Validation Configuration dialog displays Model Validation Gonfieuration Enabled Validation Rules C Element Well Formedness C Element Composition Element Property Validity C Element OCL Conform
10. defined e For C C and C the value must be i86Win32 e For Java the value must be i86JDK13 Before you generate the PSM and code you might want to check and if necessary change the language and platform To generate the PSM and code follow the steps below 1 Open the DDS project and the PIM package and then open the Application diagram 2 Inthe Application diagram select the Application Components from which to generate the PSM and code 3 Select the Project Model Transformations Transform Selected Elements menu option 2007 2009 Sparx Systems Pty Ltd 42 MDG Technology for DDS User Guide SDDS Example EA VAL PLP PP PPP PPP 00099990 dds ppTarget HelloWorldApp3 language Java platform i86JDK13 4 NSSSSSSSSSSSSSNNSNNSNNNNNNNNW NS SSSSSSSSSSSSSSSSSSSSSSSSSSSSN N The Model Transformation dialog displays Modeliransiormation C Generate Code on result C Perform Transformations on result erer L pissen ee H ween diem Ce 4 Select the OSPLDDS or RTIDDS checkbox If the target package is not listed against the checkbox the Browse Project dialog displays Select the PSM package as the target for the generated PSM and click on the OK button 2007 2009 Sparx Systems Pty Ltd Generate PSM and Code 43 5 On the Model Transformation dialog click on the Do Transform button If you have not specified a project
11. which is used to contain and organize other DDS element Domain A stereotyped Part element that represents a DDS DCPS Domain Domain A stereotyped Component element that represents a DDS DCPS Domain Participant It Participant applies the following Tagged Values e domain the DDS DCPS Domain that this DomainParticipant participates in A stereotyped Part element that represents a DDS DCPS Subscriber It is modeled as a child of a DomainParticipant and can contain one or more Da aReader elements as its children Data Reader A stereotyped Port element that represents a DDS DCPS DataReader It is modeled as a child of a Subscriber and can be connected to the DDS Topic that it reads A stereotyped Part element that represents a DDS DCPS Publisher It is modeled as a child of a DomainParticipant and can contain one or more DataWriter elements as its children Data Writer A stereotyped Port element that represents a DDS DCPS DataWriter It is modeled as a child of a Publisher and can be connected to the DDS Topic that it writes Qos Property A stereotyped Part element that represents a DDS Qos Policy for a DDS DCPS Entity It is modeled as a child element for the following DCPS Entities e DomainParticipant e Subscriber 2007 2009 Sparx Systems Pty Ltd DDS Toolboxes 23 Element Description e Publisher e DataReader e DataWriter e Topic The name of the property specifies the Qos Policy defined by t
12. you accept the terms click on the Next button Read the Readme information and then click on the Next button In the User name and Organization fields type your user and company names Click on the Next button Optionally define the users who have access to this program by either choosing the All users option or registering specific users Choose an installation path for the program and then click the Next button When installation is complete click on the Finish button After the MDG Technology for DDS Addln has been installed you can go on to Register the MDG Technology for DDS 1 Configure the DDS Modeling Environment 133and Manage DDS Technology T 4 2007 2009 Sparx Systems Pty Ltd Register the MDG Technology for DDS 11 2 1 Register the MDG Technology for DDS To register and activate the MDG Technology for DDS Add In follow the steps below 1 Purchase one or more licenses Once you have paid for a licensed version of MDG Technology for DDS you receive via email or other suitable means e a license key or keys e the address of the web site from which to download the full version 2 Save the license key and download the latest full install package from the address supplied Run the setup program to install the full version Run Enterprise Architect If this is the first time you have installed MDG Technology for DDS a dialog displays prompting you to register MDG Technology for DDS or to continu
13. 1 EntityInfor CommonReaderListener Common WriterListener Data Readerinformation DataReaderlnformation DataReaderListener DataReaderQos DataReaderQos DataWriterinformation DataWniterlnformation mm m mPaauwm 7 Inthe Synchronize field select Overwrite code then select the Include all Child Packages checkbox Click on the Generate button The system starts to generate the source code for the specified language into the project root folder The progress of the code generation is shown in the Batch Generation window 2007 2009 Sparx Systems Pty Ltd 44 MDG Technology for DDS User Guide Batch generation objects generating C RTI sre Test Hello WorldApp 3 CommonReaderListener java generating C RTI sre Test Hello WordApp 3 CommonWhriterListener java generating C RTI src Test Hello WorldApp 3 Entity Information Data Readerinformation java generating c iiL gk eer aah eset generating C RTI sre Test HelloWordApp1 CommonListener h generating C RTI src Test Hello WorldApp 3 GosEntity Dictionary D JataReaderQos java 8 If user select RTIDDS Transformation in step 4 then after code generation is completed the system runs the NDDS generator to generate code from the IDL type DDS NLDDSGEN nddsgen C RTI src Test HelloWorldApp 1HelloWorldType idl nddsgen C RTI src Test HelloWorldApp2 HelloWorldT ype idl nddsgen C RTI src Test HelloWorldApp3 HelloWorldType idl ND
14. 10 MDG Technology for DDS User Guide 2 Getting Started The MDG Technology for DDS is available for download from the Products page on the Sparx Systems website Once it has been downloaded the program is in exe format To install the MDG Technology for DDS follow the steps below 1 2 3 Download the EADDS exe file from the Sparx Systems website Ensure that you meet the System Reguirements 9 and have Enterprise Architect version 7 1 or higher To install the MDG Technology for DDS component double click on the EADDS exe Installer executable The MDG Technology for DDS Installation Wizard screen displays Click on the Next button A ior DDS 20 Setup Welcome to the MDG Technology for DDS 2 0 Installation Wizard It is strongly recommended that you exit all Windows programs before running this setup program JA 9SUdI9JUJ KT Click Cancel to quit the setup program then close any programs you have running Click Next to continue the installation V UOISISA WARNING This program is protected by copyright law and international treaties Unauthorized reproduction or distribution of this program or any portion of it may result in severe civil and criminal penalties and will be prosecuted to the maximum extent possible under law D 3 lt 3 v 3 suiejs g Weds 80078661 Read the licensing agreement and if
15. Cache Use Association Element r DDS Application A stereotyped Component element that represents a DDS application It is used to represent a compilable software artifact that represents a single DomainParticipant using the Use relationship Application Component is the DDS application used by the transformation process to specify the DDS implementation PSM generated by the transformation It applies the following Tagged Values e language An enumeration representing the target software language for this application implementation C C Java and C e platform An enumeration representing the target implementation platform for this application implementation i86Win32 i86JDK13 Notes e Currently only the RTIDDS Transformation supports C 2007 2009 Sparx Systems Pty Ltd DDS Toolboxes 29 Domain Participant A stereotyped Dependency relationship that represents a usage of a DDS Cache Use DomainParticipant or Cache by an Application Many Applications can use the same DomainParticipant Cache as reguired to create a heterogeneous DDS design Association An association It is required for a DLRL Cache to associate with a related DCPS DomainParticipant 2007 2009 Sparx Systems Pty Ltd 30 MDG Technology for DDS User Guide 3 4 Create DDS Project There are two ways in which you can create a DDS Model e Using the predefined Model Template 30 e Withou
16. DSGen Execution Completed 9 Finished 2007 2009 Sparx Systems Pty Ltd DDS Example Model 45 3 7 DDS Example Model To open the example model select the Add Ins DDS Technology Open DDS Example Model menu option from the Enterprise Architect main menu The example model contains two separate model Hello World and Net Chat as show in following diagram HelloWorldType j DP1 amp j DP2 HelloWoridApp1 amp j HelloWoridApp2 HelloWoridApp3 us HelloWorid us HelloWorldTopic e Application Targets The Hello World model is a simple DCPS model it contains a Type diagram Domain diagram and DDS Application diagram In Type diagram it defines the IDL type to be used by the Topic In Domain diagram it defines DDS topology using DDS Entities Domain DomainParticipant Publisher and Subscriber DataReader and DataWriter and Topic In Application diagram it defines the DDS Application entities and its usage relation with DomainParticipant entities Project Browser x B G 38 gg Model Example Models EP Welcome C elo world Ta Application DCPS Domain Hello World TA Types amp j domainParticipant DP 1 J domainParticipant DP2 fa domain HelloWorld 3 ddsAppTarget HelloWorldApp1 3 ddsAppTarget HelloWorldApp2 3 ddsAppTarget HelloWorldApp3 S sS topic HelloWorldTop
17. L Class diagram Generate Code Opens the Generate Executable Class 40 dialog Open DDS Example Opens the example DDS model Project Options Opens the DDS Options 17 dialog Help Opens this help file About o Displays the version information for the MDG Technology for DDS Tip If the Add Ins menu or the DDS Technology sub menu are not visible after installing the DDS Add In try to reset Enterprise Architect s menus with the View Visual Layouts Default Layout menu option 2007 2009 Sparx Systems Pty Ltd DDS Options 17 3 2 DDS Options Select Add Ins DDS Technology Options menu option to display the Options dialog There are three groups of DDS Options e General Options 174 e RTIDDS Options 18 e OSPLDDS Options 205 3 2 1 General Options The options in the General Options tag are used to specify the general behavior and Qos properties of the MDG Technology for DDS r General Options RTIDDS Options OSPLDDS Options DDS General Ignore validation warnings Oos Property Behavior C Show as Entity Compartments Create Automatically for new Entities Set Specifications Ignore validation warnings Select the checkbox to ignore any DDS warning messages during the model validation process Show as Entity Select the checkbox to enable the Qos Policies to be displayed on DDS Compartments entities using the compartment notation Create Automatical
18. able to registered users of Enterprise Architect Responses to support gueries are sent by email Sparx Systems endeavors to provide a rapid response to all product related guestions or concerns Registered users can lodge a support reguest by visiting http www sparxsystems com registered reg support bm Trial users can contact Sparx Systems with guestions regarding their evaluation at Support sparxsystems com An online user forum is also available for your guestions and perusal at http www sparxsystems com cgi bin yabb Y aBB cgji 2007 2009 Sparx Systems Pty Ltd System Reguirements 9 1 5 System Reguirements MDG Technology for DDS runs under the following environments Windows Operating Systems e Windows ME e Windows NTB SP5 or later e Windows XP Professional e Windows XP Home e Windows XP Media Edition e Windows XP Tablet Edition e Windows 2000 Professional SP3 or later Enterprise Architect e Enterprise Architect Professional Version 7 5 or later e Enterprise Architect Corporate Version 7 5 or later DDS Middleware e PrismTech OpenSplice DDS 3 3 or later e RTIDDS 4 3e or later Notes e While the MDG Technology for DDS isn t specifically blocked from executing with the Enterprise Architect Desktop Edition be aware that the Desktop Edition cannot make use of some of the capabilities of the product such as Model Validation 2007 2009 Sparx Systems Pty Ltd
19. ance C Relationship Well Formedness E Relationship Property Validity C Relationship OCL Conformance C Feature Well Formedness _ Feature Property Validity Feature OCL Conformance E Diagram Well Formedness E Requirements Management Data Distribution Service DDS Rules If you are only performing DDS validation click on the Select None button select the Data Distribution Service DDS Rules checkbox and click on the OK button This is the default setting of the DDS Perspective Note that DDS is strongly based on UML so it might be a useful exercise to perform the UML validation as well Validate a DDS Model To validate an element and any connectors attached to it a diagram and all its elements or a package and all its diagrams and elements against the DDS rules select the Project Model Validation Validate Selected menu option For an explanation of the error and warning messages that might be returned when validating a DDS model refer to the Model Validation Rules for Elements 3 topic 3 5 1 Model Validation Rules for Elements The following messages might be output by the validation of a DDS element DDS Entity missing data for Tagged A DDS DomainParticipant Topic DLRL Class or Application is Value missing the Tagged Value specified by the message 2007 2009 Sparx Systems Pty Ltd Model Validation 39 eg C DDS Entity contains invalid data for The DDS Do
20. ather this document describes the following features of the MDG Technology for DDS e DDS Technology Menu 163 e DDS Options 17 e DDS Toolboxes 22 e Create DDS Project 30 e Model Validation 38 e Generate PSM and Code 40 e DDS Example Modell 45 2007 2009 Sparx Systems Pty Ltd 16 MDG Technology for DDS User Guide 3 1 DDS Technology Menu The DDS Technology sub menu is available from the Add Ins menu on the main menu bar New Application Diagram REN New Domain Diagram New Oos Policy Library New Type Diagram New DLRL Diagram New DLRL Mapping Diagram Generate Code Open DDS Example Project Options Help About New Application Creates a new DDS Application diagram in the currently selected package The Diagram diagram is an extended UML Deployment diagram New Domain Creates a new DDS Domain diagram in the currently selected package The diagram Diagram is an extended UML Component diagram New Qos Policy Creates a new DDS Qos policy library package in the model Library New Type Diagram Creates a new DDS Type diagram in the currently selected package The diagram is an extended UML Class diagram New DLRL Diagram Create a new DDS DLRL diagram in the currently selected package The diagram is an extended UML Class diagram New DLRL Mapping Create a new DDS DLRL Mapping diagram in the currently selected package The Diagram diagram is an extended UM
21. attribute gt lt attribute type gt primitive type nor a user defined DDS type Missing DDS parent The given DDS entity does not belong to the specified parent type lt Any DDS Entity type gt Invalid DDS parent The given DDS entity belongs to the wrong parent type lt Any DDS Entity type gt Incompatible Platform Language The language and platform value in a specified DDS Application Platform lt platform gt does not comply entity tagged value is not compatible with Language lt language gt Note A DDS model might trigger additional UML validation messages but these are outside the scope of this document See the Enterprise Architect User Guide 2007 2009 Sparx Systems Pty Ltd 40 MDG Technology for DDS User Guide 3 6 Generate PSM and Code There are two ways in which you can generate PSM and Code e Generate Code DDS Menu Command 40 e EA Transformation 41 Note Before generating the PSM and Code please ensure that the DDS Model is validated by running Model Validation 38 gt 3 6 1 DDS Menu Command This process generates executable UML class and packages based on the DDS model The generated class and packages can then be generated to source code using in build code generator feature of Enterprise Architect To generate the Executable Class for a DDS model follow the steps below 1 Select the Add Ins DDS Technology Generate Code menu option to display the Generate Exec
22. cense Agreement EULA is a legal agreement between YOU as Licensee and SPARX for the SOFTWARE PRODUCT identified above By installing copying or otherwise using the SOFTWARE PRODUCT YOU agree to be bound by the terms of this EULA If YOU do not agree to the terms of this EULA promptly delete the unused SOFTWARE PRODUCT The copyright in the SOFTWARE PRODUCT and its documentation is owned by Sparx Systems Pty Ltd A C N 085 034 546 Subject to the terms of this EULA YOU are granted a non exclusive right for the duration of the EULA to use and modify the SOFTWARE PRODUCT YOU do not acquire ownership of copyright or other intellectual property rights in any part of the SOFTWARE PRODUCT by virtue of this EULA Your use of this software indicates your acceptance of this EULA and warranty DEFINITIONS In this End User License Agreement unless the contrary intention appears e EULA means this End User License Agreement e SPARX means Sparx Systems Pty Ltd A C N 085 034 546 e Licensee means YOU or the organization if any on whose behalf YOU are taking the EULA e Registered Edition of MDG Technology for DDS means the edition of the SOFTWARE PRODUCT which is available for purchase from the web site http www sparxsystems com ea purchase htm Following the thirty day free evaluation period e SOFTWARE PRODUCT or SOFTWARE means MDG Technology for DDS which includes computer software and associated media and printed materials a
23. cy It applies the following Tagged Values e kind Enumeration AUTOMATIC default MANUAL_BY_PARTICIPANT MANUAL_BY_TOPIC e lease duration duration in nanoseconds default 1 Ownership A stereotyped Class element that specifies the Ownership Strength Qos Policy It applies Strength the following Tagged Values e value Integer default 0 A stereotyped Class element that specifies the Ownership Qos Policy It applies the following Tagged Values e kind Enumeration SHARED default EXCLUSIVE A stereotyped Class element that specifies the Partition Qos Policy It applies the following Tagged Values e name String Presentation A stereotyped Class element that specifies the Presentation Qos Policy It applies the following Tagged Values e access_scope Enumeration INSTANCE default TOPIC GROUP e coherent access Boolean default false e ordered_access Boolean default false Reader Data A stereotyped Class element that specifies the ReaderData Lifecycle Qos Policy It applies Lifecycle the following Tagged Values e autopurge_nowriter_samples_delay duration in nanoseconds default 1 Reliability A stereotyped Class element that specifies the Reliability Qos Policy It applies the following Tagged Values e kind Enumeration BEST_EFFORT default RELIABLE e max blocking time Integer default 1 2007 2009 Sparx Systems Pty Ltd 28 MDG Technology for DDS User Guide E
24. d Please read the license agreement 4 for full details Due to continued product development this information could change without notice The information and intellectual property contained herein is confidential between Sparx Systems and the client and remains the exclusive property of Sparx Systems If you find any problems in the documentation please report them to us in writing Sparx Systems does not warrant that this document is error free No part of this publication may be reproduced stored in a retrieval system or transmitted in any form or by any means electronic mechanical photocopying recording or otherwise without the prior written permission of Sparx Systems Licensed users are granted the right to print a single hardcopy of the user manual per licensed copy of the software but may not sell distribute or otherwise dispose of the hardcopy without written consent of Sparx Systems Sparx Systems Pty Ltd 7 Curtis St Creswick Victoria 3363 AUSTRALIA Phone 61 3 5345 1140 Fax 61 3 5345 1104 Support Email support sparxsystems com Sales Email sales sparxsystems com Website http www sparxsystems com 2007 2009 Sparx Systems Pty Ltd 4 MDG Technology for DDS User Guide 1 2 Software Product License Agreement MDG Technology for DDS Enterprise Architect MDG Add In Copyright C 2007 2009 Sparx Systems Pty Ltd All Rights Reserved IMPORTANT READ CAREFULLY This End User Li
25. e implementation Generate Listener for DDS Select the checkbox to enable the RTIDDS transformer to automatically Writer generate a Listener for the DDS Writer Project Files Choice Click on the drop down arrow and select the type of project files for the RTIDDS transformer to generate For Visual Studio NET the workspace file is the Solution file Workspace Name The name of the workspace For Visual Studio Net this is the name of the solution Generate Shared Files in Select the checkbox to enable the RTIDDS transformer to generate the Folder common shared files to a specific folder The specific folder is a relative 2007 2009 Sparx Systems Pty Ltd 20 MDG Technology for DDS User Guide peeio path to the Project Root folder This option only apply when it generates code from Generate Executable Class dialog by select menu Addin DDS Technology Generate Code to open the dialog 3 2 3 OSPLDDS Options The options in the OSPLDDS Options tag are used to specify the behavior of the PIM to PSM transformation 41 for OpenSplice DDS implementations Note The version of OpenSplice DDS used is specified by the OSPL HOME environment variable General Options RTIDDS Options OSPLDDS Options Project Root C IRTIlsrciTestl General Options Enable OSPLDDS PSM OSPL HOME C Program Files PrismTech OpenSpliceDDSW3 3 HDE Autoname Source Files Autogenerate IDL
26. e the trial Bo MDG Technology for DDS is currently not registered Press Yes to enter your licence key now No to continue with MDG Technology disabled 5 To enter the new key click on the Yes button The Licence Management dialog displays licence Management Use the Add Key button to enter a new registration key Currently Registered Keys Add Registration Key Enter Private Key Get Shared Key Company Company Name Copy registration key into space below then press OK button 2007 2009 Sparx Systems Pty Ltd 12 MDG Technology for DDS User Guide 7 Copy the license key from the email and paste it into the Copy registration key field to avoid typing mistakes 8 Click on the OK button The full version of MDG Technology for DDS is now available for use with your version of Enterprise Architect 2007 2009 Sparx Systems Pty Ltd Configure the DDS Modeling Environment 13 2 2 Configure the DDS Modeling Environment MDG Technology for DDS Addin requires either RTIDDS or OpenSplice DDS Middleware products to be installed in the same Computer otherwise it can not generate fully executable project based on the specific DDS Middleware Configuration for RTIDDS After RTIDDS middleware is installed to the system it will create an environment variable NDDSHOME which will be the directory in which the RTIDDS software installed DDS Addin will check this environ
27. es Integer maximum samples default 1 to keep all samples max samples per instance Integer maximum samples per instance default 1 to keep all samples per instance service cleanup delay duration in nanoseconds default 0 Durability A stereotyped Class element that specifies the Durability Aos Policy It applies the following 2007 2009 Sparx Systems Pty Ltd DDS Toolboxes 27 Tagged Values e kind Enumeration TRANSIENT TRANSIENT LOCAL VOLATILE default PERSISTENT Entity Factory A stereotyped Class element that specifies the EntityFactory Qos Policy It applies the following Tagged Values e autoenable_created_entities Boolean default true Group Data A stereotyped Class element that specifies the Groupdata Qos Policy It applies the following Tagged Values e datavalue String History A stereotyped Class element that specifies the History Qos Policy It applies the following Tagged Values e depth Integer default 1 e kind Enumeration KEEP_LAST default KEEP_ALL Latency A stereotyped Class element that specifies the LatencyBudget Qos Policy It applies the Budget following Tagged Values e duration duration in nanoseconds default 0 Lifespan A stereotyped Class element that specifies the Liveliness Qos Policy It applies the following Tagged Values e duration duration in nanoseconds default 0 Liveliness A stereotyped Class element that specifies the Deadline Qos Poli
28. esponding topic sample Some topics may have more than 1 key fields to determine their identity Foreign Key A stereotyped Attribute Topic field that represents a reference to a key field of another Topic It is used to form relationships between topics Shared Key A stereotyped Attribute Topic field which is both Key and Foreign Key A stereotyped Association that represents a relationship between two DLRL Classes Note Package and Connector are redefined from the standard Enterprise Architect toolset and are described in full in the Enterprise Architect User Guide 2007 2009 Sparx Systems Pty Ltd DDS Toolboxes 25 3 3 3 Types The DDS Types Toolbox provides elements and features for use on a DDS Types diagram Types Module Struct Valuetype Array Enumeration Interface Sequence Typedef Union W MU WM Wi Wi WW Lid dd Key Foreign Key Constant Method Elements Description O Module A stereotyped Class element that represents an IDL Module Enumeration Atereoyped Gass element hat represents an IL Enumeration merase AseeopesCasssemenrmenrepresmsaniL es union Astreoyped Gass coment hat epresens an OL Union Features J esege ooo Field A stereotyped Attribute that represents an IDL field A stereotyped Attribute that represents an IDL field which is the or part of the identify Foreign Key A stereotyped Attribute that represents an IDL field which is the
29. he property It is also typed by a Qos policy specification which defines the specific properties for that policy Note A Qos Property must be typed by a Qos Policy Specification in order to have the correct Tagged Values for the Qos Policy For more information about Qos Policy Specifications refer to DDS Qos Policies 26 A stereotyped Part element that represents a DDS DCPS Topic DDS Topics are connected to one or more DataReader and DataWriter elements that perform the role of reading or writing data to this topic It applies the following Tagged Values e expression a string expression used as the filter to be applied to this topic CONTENT_FILTERED or used as the subscription query to be applied to this topic MULTI_TOPIC e kind an enumeration representing the Topic s kind STANDARD MULTI_TOPIC CONTENT_FILTERED e type a DDS type 25 element used to describe the data structure for this topic The type element is an IDL class Connector A Connector to connect a DataReader DataWriter with a Topic Note Package and Connector are redefined from the standard Enterprise Architect toolset and are described in full in the Enterprise Architect User Guide 3 3 2 Local Reconstruction The Domain toolbox provides elements and connectors for use in designing the Data Centric Publish Subscribe DCPS services for DDS system DLRL E Class Q Attribute a Cache EJ Object Home Topic Manager zl Filter Criterio
30. ic idlStruct HelloWorldType CT Net Chat PSM S B gosPolicyLibrary QoS Policies Prec roe The Net Chat model contains DCPS Model as well as DLRL model which based on its related DCPS model Its DCPS model contains a Type diagram and a Domain diagram Its DLRL model contains a Mapping diagram and a DLRL diagram In Mapping diagram it defines DLRL 2007 2009 Sparx Systems Pty Ltd 46 MDG Technology for DDS User Guide classes as well as their mapping to related DCPS Type and Topic In DLRL diagram it defines the DLRL topology using DDS DLRL Entities Cache ObjectHome TopicManager Class as well as related DCPS Entities Project Browser B B a mies gp Welcome Hello World s EJIIS domainParticipant ChatDirectory domainParticipant ChatRoom ss topic MessageTopic idlStruct MessageType domain NetChat ws topic UserTopic idlStruct UserType TA Local Reconstruction Ta Mapping diriClass MessageClass cache NetChatCache ddsAppTarget NetChati ddsAppTarget NetChat2 2007 2009 Sparx Systems Pty Ltd Index 47 Index wie Classifier Default 18 Code C Generation 40 41 C Generation 40 41 C Generation 40 41 Generate 40 41 Java Generation 40 41 Connector DDS Application 28 DDS Domain 22 DDS Local Reconstruction 28 Copyright Notice 3 Create DDS Project 30 DLRL M
31. if YOU supply to the transferee a copy of this EULA and all other documentation including proof of ownership Your License is then terminated TERMINATION Without prejudice to any other rights SPARX may terminate this EULA if YOU fail to comply with the terms and conditions Upon termination YOU or YOUR representative shall destroy all copies of the SOFTWARE PRODUCT and all of its component parts or otherwise return or dispose of such material in the manner directed by SPARX WARRANTIES AND LIABILITY WARRANTIES SPARX warrants that the SOFTWARE PRODUCT will perform substantially in accordance with the accompanying written materials for a period of ninety 90 days from the date of receipt and any Support Services provided by SPARX shall be substantially as described in applicable written materials provided to YOU by SPARX and SPARX support engineers will make commercially reasonable efforts to solve any problems associated with the SOFTWARE PRODUCT EXCLUSIONS To the maximum extent permitted by law SPARX excludes for itself and for any supplier of software incorporated in the SOFTWARE PRODUCT all liability for all claims expenses losses damages and costs made against or incurred or suffered by YOU directly or indirectly including without limitation lost costs profits and data arising out of e YOUR use or misuse of the SOFTWARE PRODUCT e YOUR inability to use or obtain access to the SOFTWARE PRODUCT e Negligence of SPARX or i
32. iles Autogenerate IDL Autogenerate Source Run NDDSGen on completion Generate Listener for DDS Reader Generate Listener for DDS Writer Project Files Choice Generate Workspace and Project Files Workspace Name RTIDDSApplication 1 Advanced Options Generate Shared Files in Folder Notes This option only apply when generate code from DDS Addin menu command La Je e Folder Name SharedFileFolder Field deo Project Root Root directory in which all the PSM output should be created Enable RTIDDS PSM Select the checkbox to enable the transformer deselect to disable the transformer Autoname Source Files Select the checkbox to enable the RTIDDS transformer to automatically allocate filenames to the generated source code recommended Autogenerate Source Select the checkbox to enable the RTIDDS transformer to automatically invoke the code generation process to the PSM after it has been successfully generated Generate Listener for DDS Select the checkbox to enable the RTIDDS transformer to automatically Reader generate a Listener for each DDS Reader Autogenerate IDL Select the checkbox to enable the DDS Topic Type elements to automatically be generated to IDL code during the transformation process Run NDDSGen on completion Select the checkbox to enable the RTIDDS transformer to automatically invoke the NDDSGEN command to the generated IDL to automatically generate the type specific DDS code for th
33. ivalent SOFTWARE PRODUCT or e the payment of the cost of having the SOFTWARE PRODUCT repaired e If the breach relates to services in relation to the SOFTWARE PRODUCT e the supplying of the services again or e the payment of the cost of having the services supplied again TRADEMARKS All names of products and companies used in this EULA the SOFTWARE PRODUCT or the enclosed 2007 2009 Sparx Systems Pty Ltd 6 MDG Technology for DDS User Guide documentation may be trademarks of their corresponding owners Their use in this EULA is intended to be in compliance with the respective guidelines and licenses Windows Windows 98 Windows NT Windows ME Windows Vista Windows XP and Windows 2000 are trademarks of Microsoft GOVERNING LAW This agreement shall be construed in accordance with the laws of the Commonwealth of AUSTRALIA 2007 2009 Sparx Systems Pty Ltd Acknowledgement of Trademarks 7 1 3 Acknowledgement of Trademarks Trademarks of Microsoft e Microsoft e Windows Trademarks of the OMG e OMG e Object Management Group e UML e Unified Modeling Language e DDS e Data Distribution Service Trademarks of PrismTech Limited e OpenSplice DDS Trademarks of Real Time Innovations Inc e RTIDDS 2007 2009 Sparx Systems Pty Ltd 8 MDG Technology for DDS User Guide 1 4 Support Technical support for the MDG Technology for DDS is avail
34. lement Description Resource A stereotyped Class element that specifies the Resource Limits Qos Policy It applies the Limits following Tagged Values e max_instances Integer maximum value default 1 to keep all instances e max_samples Integer maximum samples default 1 to keep all samples e max_samples_per_instance Integer maximum samples per instance default 1 to keep all samples per instance Time Based A stereotyped Class element that specifies the Time Based Filter Qos Policy It applies the Filter following Tagged Values e minimum separation duration in nanoseconds default 0 Topic Data A stereotyped Class element that specifies the Topic Data Qos Policy It applies the following Tagged Values e value String Transport A stereotyped Class element that specifies the Transport Priority Aos Policy It applies the Priority following Tagged Values e value Integer default 0 User Data A stereotyped Class element that specifies the User Data Qos Policy It applies the following Tagged Values e value String WriterData A stereotyped Class element that specifies the WriterData Lifecycle Qos Policy It applies Lifecycle the following Tagged Values e autodispose unregistered instances Boolean default true 3 3 5 Application Target The DDS Application toolbox provides elements and connectors for use on a DDS Application diagram Application d DDS Application Domain Participant
35. ly for new Select the checkbox to enable the Qos Policy properties to be automatically Entities created when new DDS Entities are created in the model Enabling this option requires the Qos Policy CT to be defined using the Aos Policy Specifications 181 dialog 18 Set Specifications Click on this button to open the Qos Policy Specifications 181 dialog 18 2007 2009 Sparx Systems Pty Ltd 18 MDG Technology for DDS User Guide 3 2 1 1 Qos Policy Specifications Dialog Gos Policy specifications This dialog is used to specify which Qos Policy Specifications are to be used as the default classifiers for QosProperty elements when new DDS Entities are created Each of the policies can be specified by any one Qos Policy Specification defined for that Policy The Defaults button can be used to automatically enable the MDG Technology to allocate the specifications for this project 3 2 2 RTIDDS Options The options in the RTIDDS Options tag are used to specify the behavior of the PIM to PSM transformation 41 gt for RTIDDS implementations Note The version of RTIDDS used is specified by the NDDSHOME environment variable 2007 2009 Sparx Systems Pty Ltd DDS Options 19 General Options RTIDDS Options OSPLDDS Options Project Root C RTI src Test General Options Enable RTIDDS PSM NDDSHOME C RTI NDDS ndds 4 Ze Autoname Source F
36. mainParticipant Topic or DLRL Class refers to an Tagged Value invalid element in the specified Tagged Value lt domain type topic gt Missing QosPolicy The DDS DomainParticipant Topic Subscriber Publisher lt QOS property gt DataReader or DataWriter is missing the specified Qos Policy PSM Transform will use system default specified by a QosProperty element The PSM transformation values for this policy process assumes the system default value for this Qos Policy Missing child entity The DDS DomainParticipant Publisher Subscriber DLRL Cache Publisher or Subscriber DataReader or ObjectHome are missing any of their required children entities DataWriter ObjectHome TopicManager gt Invalid children entities found of type The given DDS entity contains other DDS entities as children lt Any DDS Entity gt which it is not supposed to have Missing or invalid usage relationship The given DDS application is not bound to any DomainParticipant lt other information gt Cache or vice versa Missing or invalid association The given DDS topic is not associated with any DataReaders or lt other information gt DataWriters or a DataReader DataWriter is not associated with any topics Duplicated DDS Entity Name The given DDS entity has the same name as another DDS entity lt Any DDS Entity name gt Unsupported type found in lt DDS Type The type of attribute in the given DDS Type entity is neither an IDL lt
37. ment variable in the RTIDDS Options 181 It is also required to specify a Project Root folder in the RTIDDS Optionsl 181 This is the location for all generated RTIDDS based source code Configuration for OpenSplice DDS After OpenSplice DDS middleware is installed to the system it will create an environment variable OSPL_HOME which is the home directory in which the OpenSplice DDS software installed DDS Addin will check this environment variable in the OSPLDDS Options 2 It is also required to specify a Project Root folder in the OSPLDDS Options 20 This is the location for all generated OpenSplice DDS based source code 2007 2009 Sparx Systems Pty Ltd 14 MDG Technology for DDS User Guide 2 3 Manage DDS Technology To manage DDS Technology select the Settings MDG Technologies menu option MU 6 jech nologies Technology Enabled Sparx Maintenance I UML Profile for Web Modeling 3 MindMapping mice ICONIX R Data Flow Diagrams SCH MDG Technology for BPMN Data Distribution Service MDG Technology for Data Distribution Service The Data Distribution Service DDS can be made available enabled or removed from use disabled To enable or disable it select Data Distribute Service from the list and click on its Enabled checkbox 2007 2009 Sparx Systems Pty Ltd 15 3 Using the MDG Technology for DDS A DDS Specification and tutorial is outside the scope of this document R
38. n i Keys Relations Key Foreign Key Shared Key Relation Ne 2007 2009 Sparx Systems Pty Ltd 24 MDG Technology for DDS User Guide Element Description 5 A stereotyped Class element that represents a DDS DLRL Class It applies the following Tagged Values e mappedTopic the DDS Topic that this DLRL Class is mapped to A stereotyped Attribute that represents an attribute within a DLRL Class It applies the following Tagged Values e mappedField the Field of the DDS Topic Type that this attribute is mapped to for DLRL Read and Write operations Cache A stereotyped Component element that represents a DDS DLRL Cache It can contain one or more ObjectHome elements as its children and is associated with the DLRL Classes that it processes Object Home A stereotyped Part element that represents a DDS DLRL ObjectHome It is modeled as a child of a Cache element and can related to a set of DCPS Topics Topic Manager A stereotyped Port element that represents a DDS DLRL TopicManager It is modeled as a port of ObjectHome element and can be connected to a specific DCPS Topic on behalf of its related ObjectHome Filter Criterion A stereotyped Class element that represents a DDS DLRL FilterCriterion It applies the following Tagged Values e filterClass the DLRL Class that implements the filterCriterion check_object operation Key A stereotyped Attribute Topic field that represents the identity of corr
39. nd may include online or electronic documentation e Trial edition of MDG Technology for DDS means the edition of the SOFTWARE PRODUCT which is available free of charge for evaluation purposes for a period of 30 days GRANT OF LICENSE In accordance with the terms of this EULA YOU are granted the following rights a To install and use ONE copy of the SOFTWARE PRODUCT or in its place any prior version for the same operating system on a single computer As the primary user of the computer on which the SOFTWARE PRODUCT is installed YOU may make a second copy for your exclusive use on either a home or portable computer b To store or install a copy of the SOFTWARE PRODUCT on a storage device such as a network server used only to install or run the SOFTWARE PRODUCT over an internal network If YOU wish to increase the number of users entitled to concurrently access the SOFTWARE PRODUCT YOU must notify SPARX and agree to pay an additional fee c To make copies of the SOFTWARE PRODUCT for backup archival and instructional purposes EVALUATION LICENSE The Trial Version of MDG Technology for DDS is not free software Subject to the terms of this agreement YOU are hereby licensed to use this software for evaluation purposes without charge for a period of 30 days Upon expiration of the 30 days the SOFTWARE PRODUCT must be removed from the computer Unregistered use of MDG Technology for DDS after the 30 day evaluation period is in violation
40. o firstly create a DDS DCPS model before you can create a valid DLRL model To add a DDS DLRL model follow the steps below 1 Inthe Project Browser create a package for the DLRL model 2007 2009 Sparx Systems Pty Ltd Create DDS Project 35 2 Addanew DLRL Mapping Diagram in the package Select the Add Ins DDS Technology New DLRL Mapping Diagram menu option to create a DDS DLRL Mapping diagram 3 Inthe newly created DLRL Diagram i Ceate DLRL Classes and assign the mappedTopic and mappedType tagged values to the appropriate elements ii Add some DLRL Attributes to the DLRL Class elements Assign the mappedField Tagged Value to the attribute in the mapping IDL type iii Create Relation Relationships between the DLRL Classes Assign the mapping Foreign Key name to the Target Role property of the Relation connector The diagram below is an example of DLRL class mapping dir Clase MessageClass idlStruct DCP 5 MessageType adinAttibute Index long key Message string index long idlField tags message string mappedTopic MesssgeTopic mappedType MessageType userlD long message relation relation user dl Class idlStruct UserClass DCP 5 UserType dirAttnbute foreignKey Name string messagelD long UseriD long idl Field name string tags mappedTopic UserTopid mappedType UserType key
41. odel 34 Create DDS Project 30 Add DLRL Model 34 D DDS Options 17 General Options 17 Introduction 17 NDDS Options 18 OpenSplice DDS Options 20 OSPLDDS Options 20 Qos Property Behavior 17 RTIDDS Options 18 DDS Project Add DLRL Model 34 Create From Scratch 30 DDS Technology Menu 16 DDS Toolboxes 22 Application 28 Domain 22 Introduction 22 Local Reconstruction 23 QoS Policies 26 Types 25 Default Classifiers 18 Diagram Application Elements And Connectors 28 DLRL Element Key Relations 23 Domain Elements And Connectors 22 Local Reconstruction Elements And Connectors 23 Qos Policies Library 26 Types Elements And Connectors 25 E Element DDS Application 28 DDS Domain 22 DDS Local Reconstruction 23 DDS Type 25 Model Validation Rules 38 Qos Policies 26 End User Licensing Agreement 4 Example Model Open 45 Generate C 40 41 CH 40 41 C 40 41 Code 40 41 Java 40 41 PSM 40 41 Generate PSM and Code 40 by EA Transformation 41 from Addin Command 40 Introduction 40 Getting Started 10 Configure the DDS Modeling Environment 13 Register MDG Technology for DDS 11 K Key DDS Local Reconstruction 23 DDS Type 25 L License Agreement 4 MDG Technology For DDS Acknowledgement of Trademarks 7 Copyright Notice 3 DDS Technology Menu 16 2007 2009 Sparx Systems Pty Ltd 48 MDG Technology for DDS User Guide MDG Technology For DDS Getting Started 10 R License
42. of Australian U S and international copyright laws SPARX may extend the evaluation period on request and at their discretion If YOU choose to use this software after the 30 day evaluation period a license must be purchased as described at http www sparxsystems com ea purchase htm Upon payment of the license fee YOU will be sent details of where to download the registered edition of MDG Technology for DDS and will be provided with a suitable software key by email ADDITIONAL RIGHTS AND LIMITATIONS YOU hereby undertake not to sell rent lease translate adapt vary modify decompile disassemble reverse engineer create derivative works of modify sub license loan or distribute the SOFTWARE PRODUCT other than as expressly authorized by this EULA 2007 2009 Sparx Systems Pty Ltd Software Product License Agreement 5 YOU further undertake not to reproduce or distribute license key codes except under the express and written permission of SPARX If the SOFTWARE PRODUCT purchased is an Academic Edition YOU ACKNOWLEDGE THAT the license is limited to use in an educational context either for self education or use in a registered teaching institution The Academic Edition may not be used to produce commercial software products or be used in a commercial environment without the express written permission of SPARX ASSIGNMENT YOU may only assign all your rights and obligations under this EULA to another party
43. pendent Model PIM having similar structure in the Project Browser as following diagram If you want to add a DLRL Model see Add DLRL Modell 34 topic 2007 2009 Sparx Systems Pty Ltd 34 MDG Technology for DDS User Guide Project Browser idlStruct HelloWorldType 2 dlField message 2 dlField sequence domainParticipant DP 1 ss gosProperty entity factory G s subscriber sub E 4d dataReader reader ss gosProperty entity factory fs gosProperty group data ss gosProperty partition gosProperty presentation s gosProperty user data domainParticipant DP2 s gosProperty entity factory ws publisher pub S dataWriter writer gosProperty entity factory is gosProperty group data 18 gosProperty partition ws gosProperty presentation s gosProperty user data ddsAppTarget HelloWorldApp1 ddsAppTarget HelloWorldApp2 ddsAppTarget HelloWorldApp3 us domain HelloWorld W w9 topic HelloWorldTopic B PsM B gosPolicyLibrary QoS Policies Project Browser bg Resources Model Views You can run Model Validation 381 against the newly created PIM to validate the model You can then Generate PSM and Code 401 3 4 2 2 Create DLRL Model Note e Currently only OSPLDDS Supports generating Platform Specific Model PSM for Java source code from DLRL models e You need t
44. rated during the transformation process Generate Listener for DDS Select the checkbox to enable the OSPLDDS transformer to automatically Writer generate a Listener for the DDS Writer Project Files Choice Click on the drop down arrow and select the type of project files for the OSPLDDS transformer to generate For Visual Studio NET the workspace file is the Solution file Workspace Name The name of the workspace For Visual Studio Net this is the name of the solution Generate Shared Files as Select the checkbox to enable the OSPLDDS transformer to generate the Library common files as a shared library lib This option only apply when it generates code from Generate Executable Class dialog by select menu Addin DDS Technology Generate Code to open the dialog 2007 2009 Sparx Systems Pty Ltd 22 MDG Technology for DDS User Guide 3 3 DDS Toolboxes This section describes the toolboxes provided with the MDG Technology for DDS e Domain 224 e Local Reconstruction 23 e Types 25 e Oo lzg e Application Target 284 3 3 1 Domain The Domain toolbox provides elements and connectors for use in designing the Data Centric Publish Subscribe DCPS services for DDS system DCPS Domain E Package Cl Domain 3 Domain Participant Cu Subscriber A Data Reader Cu Publisher A Data Writer QoS Property ix Topic 7 Connector Element Description o A Package element
45. root folder in the DDS Options 17 the system prompts you for the folder at this point The system starts to generate the PSM based on the selected DDS components the progress of the transformation is shown in the Transformation Progress window Transformation Progress Current Action Generating intermediary representation Parsing intermediary representation Creating packages Adding Class Adding Class Adding Class Adding Class Adding Class Adding Class Adding Class Adding Class Adding Class Adding Class Adding DurationT ype DurabilityQosPolicy Durability ServicelJosPolicy DeadlineQosPolicy Latency BudgetlJosPolicy LivelinessQosPolicy LifespanQosPolicy ReliabilityQosPolicy DestinationOrderQosPolicy HistoryQosPolic Resource _LimitsQosPolic Cancel Transform Close 6 When the transformation is complete the Generate Package Source Code dialog displays Generate Package Sounge Gode Synchronize Overwrite code Generate Retain Existing File Paths Select Objects to Generate v Include all Child Packages C RTI src Test HelloWorldApp 3 CommonR RTI src Test HelloWorldApp 3 CommonW RTI src Test HelloWordApp 3 Entity infor RTI sre Test Hello WorldApp 1Entitylnfor RTI src Test Hello WordApp 1 CommonLis RTI src Test HelloWorldApp3 QosEntityD RTI src Test HelloWorldApp 1 GosEntityD RTI src Test Hello WorldApp 3Entitylnfor RTI src Test Hello WorldApp
46. t a Model Template 30 3 4 1 Using a Template To create a new DDS model using a template follow the steps below 1 Select the File New Project menu option In the Name field type an appropriate name for the DDS project Click on the Save button 2 The Model Wizard dialog then displays as shown below Select the Data Distribution Service technology then tick the checkbox for DDS Model 3 Click OK to load the template Selectamodel s Select model s to add to your project Technology lt default gt 508 Data Distribution Service A package containing the basic DDS Model include the DCPS model and DLRL model The new DDS Model is created from the selected template It contains a blank DCPS and DLRL model for you to start designing your application with 3 4 2 Without a Template The following topics describe methods to create a DDS model without reference to a template e Create DCPS Modell 31 e Create DLRL Modell 341 2007 2009 Sparx Systems Pty Ltd Create DDS Project 31 3 4 2 1 Create DCPS Model To create a new DCPS model follow the steps below Select the File New Project menu option In the Name field type an appropriate name for the DDS project Click on the Save button The Model Wizard dialog then displays as shown below Select the QoS Policy Library Then OK to load the template Select modells Select model s to add to your project Technology
47. the DataWriter and DataReader elements Refer to the example diagram below 2007 2009 Sparx Systems Pty Ltd 32 MDG Technology for DDS User Guide domain HelloWorld a a domainParticipant domainParticipant DP 1 DP2 entity factory entity factory group data group data partition partition presentation presentation deadline destination order durability durability service history latency budget lifespan liveliness ownership reliability resource limits topic_dsts transport priority 8 Add a new DDS Application Diagram to the package Select the Add Ins DDS Technology New Application Diagram menu option to create a DDS Application diagram Drag the DomainParticipant elements from the DDS Domain package in the Project Browser onto the diagram Create Application Component elements and then create Usage connectors between these Application Component elements and the DomainParticipant elements See example diagram below 2007 2009 Sparx Systems Pty Ltd Create DDS Project 33 domain ati domainParticipante DP1 DP2 qos entity_factory user_dsts addsAppT srget ddsAppTargets ddsAppT srget HelloWorldApp1 HelloWorldApp2 HelloWorldApp3 tags tags tags language C language gt C language Java platform i86Win32 platform i86Win32 platform i86JDK13 When you have saved these diagrams you have created a basic DDS Platform Inde
48. to have been caused directly or indirectly by this document Printed March 2009 Special thanks to Publisher All the people who have contributed suggestions examples bug Sparx Systems reports and assistance in the development of MDG Technology for d DDS The task of developing and maintaining this tool has been Managing Editor greatly enhanced by their contribution Geoffrey Sparks Technical Editor Simon Zhang l MDG Technology for DDS User Guide Table of Contents Foreword 1 Welcome 2 Copyright Notice geen 3 Software Product License Agreement 4 Acknowledgement of Trademarks 4 444 7 LIP MM 8 System Requirements lt lt lt 9 Getting Started 10 Register the MDG Technology for DDS 11 Configure the DDS Modeling Environment 13 Manage DDS Technology 14 Using the MDG Technology for DDS 15 DDS Technology Meng
49. ts employees contractors or agents or of any supplier of software incorporated in the SOFTWARE PRODUCT in connection with the performance of SPARX S obligations under this EULA or e Termination of this EULA by either party for any reason LIMITATION The SOFTWARE PRODUCT and any documentation are provided AS IS and all warranties whether express implied statutory or otherwise relating in any way to the subject matter of this EULA or to this EULA generally including without limitation warranties as to quality fitness merchantability correctness accuracy reliability correspondence with any description or sample meeting your or any other requirements uninterrupted use compliance with any relevant legislation and being error or virus free are excluded Where any legislation implies in this EULA any term and that legislation avoids or prohibits provisions in a contract excluding or modifying such a term such term shall be deemed to be included in this EULA However the liability of SPARX for any breach of such term shall if permitted by legislation be limited at SPARX S option to any one or more of the following upon return of the SOFTWARE PRODUCT and a copy of the receipt e If the breach relates to the SOFTWARE PRODUCT e the replacement of the SOFTWARE PRODUCT or the supply of an equivalent SOFTWARE PRODUCT e the repair of such SOFTWARE PRODUCT or the payment of the cost of replacing the SOFTWARE PRODUCT or of acquiring an equ
50. utable Class dialog Generate Executable Glass HelloWorldApp 1 HelloWorldApp2 HelloWorldApp3 NetChat1 NetChat2 v Generate Code 2 Select the target package that the generated class and package will be created in Click the Browse button to select the desired package 3 From the Applications list box select the applications you want them to be generated to RTIDDS applications then click the gt button beside RTIDDS Applications list box The selected applications will be moved to RT DDS Applications list box 4 From the Applications list box select the applications you want them to be generate to OSPLDDS applications then click the gt button beside OSPLDDS Applications list box The selected applications will be moved to OSPLDDS Application list box 5 Tick the Generate Code checkbox if you decide to have source code generated after the class and 2007 2009 Sparx Systems Pty Ltd Generate PSM and Code 41 package has been generated 6 Click on the Generate button to initiate the process 3 6 2 EA Transformation There are two Tagged Values for an Application Component Language and Platform e The value of the Language Tagged Value defines the coding language to generate For RTI NDDS there are three possible values C C and Java for OSPLDDS there are four possible values C C Java and C e The value of the Platform Tagged Value depends on the language

MDG Technology for DDS User Guide

Contents

Download Pdf Manuals

Related Search

Related Contents