Software User Manual (PDF)
Total Page:16
File Type:pdf, Size:1020Kb
EuroSim Mk4.1 Software User’s Manual National Aerospace Laboratory NLR iss: 5 rev: 1 SUM NLR-EFO-SUM-2 Summary EuroSim Mk4.1 is an engineering simulator to support the design, development and verification of space (sub) systems defined by ESA programmes of various scales. The facility provides a reconfigurable real-time execution environment with the possibility of man-in-the-loop and/or hardware-in-the-loop additions. This document describes the facilities available for usage in EuroSim Mk4.1, and how those facilities can be used. c Copyright Dutch Space BV All rights reserved. Disclosure to third parties of this document or any part thereof, or the use of any information contained therein for purposes other than provided for by this document, is not permitted, except with the prior and express written permission of Dutch Space BV, PO Box 32070, 2303 DB, Leiden, The Netherlands. ii c Dutch Space BV NLR-EFO-SUM-2 SUM iss: 5 rev: 1 Revision Record Issue Revision Date Reason for change Changes 0 1 11-Mar-1994 Document creation; internal distribution only. All pages. 0 2 10-Apr-1994 Update to expand contents and take into account internal comments. 0 3 15-Dec-1994 Completely updated for Mk0.1. All pages. 0 4 7-Feb-1995 Continued updating of issue 0 revision 3. All pages. 0 5 25-Apr-1995 Issued for DD/R EuroSim Mk0.1. All pages. SR/R-1-RID-SRD-74, SR/R-2-RID-SRD-5, AD/R-2-RID-Model ICD-2, AD/R-2-RID-Model ICD-3, AD/R-2-RID-SRD-3, AD/R-2-RID-SUM-2. 1 0 18-May-1995 Completely revised to take into account All pages. internal comments. 1 1 26-Jun-1995 Updated after DDR. 2 0 15-Jul-1996 New document for EuroSim Mk0.2, reference All pages. number of document changed to NLR-EFO-SUM-2. 2 1 16-Dec-1996 Issued for DD/R EuroSim Mk0.2. Internal review comments processed. SPRs implemented: 166, 364, 370, 380, 397, 406, 462, 475, 484, 571, 574, 578, 603, 612, 629, 633, 652, 657, 712, 814, 840, 960, 961, 1010, 1011, 1045, 1205, 1216, 1273, 1293, 1326, 1483. 2 2 17-Feb-1997 Updated after DD/R; the following RIDs have been implemented: 53..67, 69..76, 78..102, 104, 106..123, 125..164, 166..187, 202..209, 211..214, 216..224, 226..251, 255..257, 260, 263, 266..269. Note that not-implemented RIDs from the 200 range have been re-issued for the delta DD/R. 2 3 25-Apr-1997 Updated after delta DD/R; the following RIDs have been implemented: 42..44, 47..51, 53..68, 72..83, 85..88, 90, 91, 93..102, 104..106, 107 (partly), 108..116, 119..123 2 4 1-May-1997 EuroSim Mk1 SUM. Inclusion of IGS information/references: reference to IGS SUM, inclusion of IGS overview, definition of IGS interfaces within EuroSim (action IGS-PM7-3). Approved RIDs from DD/R: 68, 77, 103, 105, 124, 125. c Dutch Space BV iii iss: 5 rev: 1 SUM NLR-EFO-SUM-2 Issue Revision Date Reason for change Changes 2 5 24-Jun-1997 Added RID numbers for revisions 2 and 3 above. Approved SPRs implemented: 1557, 1549, 1592. Update Test Analyzer section in accordance with SPR-1505, 1651. Updated appendix on MDL following DD/R RID 177 and DD/R RID 103. Also some knock-on changes in Mission Tool Reference. 3 0 2-Mar-2000 Mk2 release. Section 3.2. SPR 1633. 3 1 2-May-2000 Mk2rev1 release: Event counter functions added to EuroSim Services. High resolution and max number processors changes added. Recorder file switching and Stimuli cycling changes documented. HLA extension: EsimRTI usage as appendix added. 3 2 6-Oct-2000 Mk2rev2 release: Add appendix describing the run-time interface as used by the test controller. Add appendix explaining AFAP scheduling pitfalls. 4 0 14-May-2002 Mk3 release: All pages. Updated the manual to conform to the new Graphical User Interface. 4 1 12-Sep-2003 Mk3rev1 release: All pages. Converted to LATEX. Updated screenshots. Update descriptions of publish functions (API headers). Added description on new ’diff with’ functionality (GUI). Added action button support (Simulation Controller). Added description for timebar (Schedule Editor). Added section on user defined EuroSim compatible devices (HW). Updated MDL syntax description. Added chapter for Windows COM interface. iv c Dutch Space BV NLR-EFO-SUM-2 SUM iss: 5 rev: 1 Issue Revision Date Reason for change Changes 4 2 2-Sep-2004 Mk3rev2 release: All pages. Added new chapters for Model Description Editor and Parameter Exchange Editor. Simulation Controller: added description for exports file, removed sections on IGS. Schedule Editor: added description on how to add Parameter Exchange file(s) to the schedule. Model Editor: Added the Model Description file node. EuroSim files and formats: Added Model Description and Parameter Exchange files. Updated screen shots. 5 0 18-Apr-2006 Mk4rev0 release: Various pages. Added new chapters for Calibration Editor, SMP2 Editor and the Web Interface. Model Editor: Added the SMP2 Catalogue file node. Updated various screen shots. 5 1 28-Jan-2008 Mk4rev1 release: Various pages. Added new chapters for Batch utilities (python, java, tcl), Java interface, Error Injection and the Transfer Sample Protocol. Updated various screen shots. c Dutch Space BV v iss: 5 rev: 1 SUM NLR-EFO-SUM-2 vi c Dutch Space BV NLR-EFO-SUM-2 SUM iss: 5 rev: 1 Table of Contents c Dutch Space BV vii NLR-EFO-SUM-2 SUM iss: 5 rev: 1 Revision Record vi Table of Contents ix I EuroSim Basics 1 1 Introduction 3 1.1 Purpose ........................................... 3 1.2 Scope ............................................ 3 1.3 Where to start ........................................ 3 1.4 Document conventions ................................... 4 2 Concepts 5 2.1 EuroSim simulation life-cycle ............................... 5 2.2 Simulator elements ..................................... 6 2.2.1 The model ..................................... 6 2.2.2 Tasks and schedule ................................. 6 2.2.3 The data dictionary ................................. 7 2.2.4 Simulation definition ................................ 7 2.2.5 The simulator .................................... 7 2.3 Services and tools ...................................... 8 2.3.1 Project Manager .................................. 8 2.3.2 Model Editor .................................... 8 2.3.3 Model Description Editor ............................. 8 2.3.4 Parameter Exchange Editor ............................. 8 2.3.5 Calibration Editor ................................. 8 2.3.6 SMP2 Editor .................................... 8 2.3.7 Schedule Editor ................................... 8 2.3.8 Simulation Controller ............................... 9 2.3.9 Action Editors ................................... 9 2.3.10 Initial Condition Editor ............................... 9 2.3.11 Test Analyzer .................................... 9 2.4 Facility and project management .............................. 9 2.4.1 Facility manager .................................. 9 2.4.2 Project file ..................................... 9 2.4.3 Project ....................................... 9 2.5 Application Programmers Interface ............................. 10 2.6 Version management .................................... 11 3 The EuroSim GUI 13 3.1 GUI conventions in EuroSim ................................ 13 3.2 Mouse buttons ........................................ 13 3.3 Keyboard shortcuts ..................................... 14 3.4 Common buttons ...................................... 14 3.5 Common menu items .................................... 15 3.5.1 File menu ...................................... 15 3.5.2 Edit menu ...................................... 15 3.5.3 Tools menu ..................................... 15 3.5.4 Tools:Version menu ................................ 15 3.5.5 Help menu ..................................... 17 c Dutch Space BV ix iss: 5 rev: 1 SUM NLR-EFO-SUM-2 4 EuroSim tutorial 19 4.1 The case study ........................................ 19 4.2 Starting EuroSim ...................................... 19 4.2.1 IRIX ........................................ 19 4.2.2 Linux ........................................ 19 4.2.3 Windows NT .................................... 19 4.3 Creating a project yourself ................................. 20 4.4 Creating a shared project .................................. 20 4.5 Creating a model ...................................... 20 4.5.1 Model ........................................ 21 4.5.2 Adding the sub-models ............................... 22 4.5.3 Adding the source code ............................... 22 4.5.4 Adding the API headers .............................. 24 4.6 Building the simulator ................................... 27 4.7 Creating the schedule .................................... 28 4.7.1 Initializing schedule ................................ 28 4.7.2 Executing schedule ................................. 29 4.7.3 Closing the Schedule Editor ............................ 30 4.8 Creating a simulation definition ............................... 30 4.8.1 Creating a graphical monitor ............................ 30 4.8.2 Creating an intervening action ........................... 31 4.8.3 Creating a recorder ................................. 32 4.9 Executing a simulation run ................................. 34 4.10 Analyzing the simulation results .............................. 34 4.11 Concluding remarks ..................................... 36 II EuroSim Reference 37 5 EuroSim reference 39 5.1 Starting EuroSim ...................................... 39 5.2 Menu items ......................................... 40 5.2.1 File menu ...................................... 40 5.2.2 Edit menu .....................................