Professional Documents
Culture Documents
Capital Analysis User PDF
Capital Analysis User PDF
User Guide
Release 2015.1
February 2016
This document contains information that is proprietary to Mentor Graphics Corporation. The original recipient of this
document may duplicate this document in whole or in part for internal business purposes only, provided that this entire
notice appears in all copies. In duplicating any part of this document, the recipient agrees to make every reasonable
effort to prevent the unauthorized use and distribution of the proprietary information.
This document is for information and instruction purposes. Mentor Graphics reserves the right to make
changes in specifications and other information contained in this publication without prior notice, and the
reader should, in all cases, consult Mentor Graphics to determine whether any changes have been
made.
The terms and conditions governing the sale and licensing of Mentor Graphics products are set forth in
written agreements between Mentor Graphics and its customers. No representation or other affirmation
of fact contained in this publication shall be deemed to be a warranty or give rise to any liability of Mentor
Graphics whatsoever.
MENTOR GRAPHICS MAKES NO WARRANTY OF ANY KIND WITH REGARD TO THIS MATERIAL
INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND
FITNESS FOR A PARTICULAR PURPOSE.
MENTOR GRAPHICS SHALL NOT BE LIABLE FOR ANY INCIDENTAL, INDIRECT, SPECIAL, OR
CONSEQUENTIAL DAMAGES WHATSOEVER (INCLUDING BUT NOT LIMITED TO LOST PROFITS)
ARISING OUT OF OR RELATED TO THIS PUBLICATION OR THE INFORMATION CONTAINED IN IT,
EVEN IF MENTOR GRAPHICS HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.
U.S. GOVERNMENT LICENSE RIGHTS: The software and documentation were developed entirely at
private expense and are commercial computer software and commercial computer software
documentation within the meaning of the applicable acquisition regulations. Accordingly, pursuant to
FAR 48 CFR 12.212 and DFARS 48 CFR 227.7202, use, duplication and disclosure by or for the U.S.
Government or a U.S. Government subcontractor is subject solely to the terms and conditions set forth
in the license agreement provided with the software, except for provisions which are contrary to
applicable mandatory federal laws.
TRADEMARKS: The trademarks, logos and service marks ("Marks") used herein are the property of
Mentor Graphics Corporation or other parties. No one is permitted to use these Marks without the prior
written consent of Mentor Graphics or the owner of the Mark, as applicable. The use herein of a third-
party Mark is not an attempt to indicate Mentor Graphics as a source of a product, but is intended to
indicate a product from, or associated with, a particular third party. A current list of Mentor Graphics’
trademarks may be viewed at: www.mentor.com/trademarks.
The registered trademark Linux® is used pursuant to a sublicense from LMI, the exclusive licensee of
Linus Torvalds, owner of the mark on a world-wide basis.
Chapter 1
Introduction. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17
Overview of Capital Analysis . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17
Model Construction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17
Capital SimCertify . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18
Capital SimProve . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18
Capital SimStress . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18
Capital SimScript . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18
Model Construction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18
Capturing the Circuit Design . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19
Describing the System's Functionality . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19
Linking Function to Structure. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19
Introduction to Capital SimCertify . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20
Introduction to Interactive FMEA Verification . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20
Introduction to Capital SimProve . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20
Introduction to Capital SimScript . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21
Introduction to Capital SimStress . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21
Introduction to Transient Analysis. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21
Frozen Shared Objects in Capital . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22
Using Different Numeric Simulators with Capital Analysis . . . . . . . . . . . . . . . . . . . . . . . . . 22
Enabling Transient Support . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23
Disabling Transient Support . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23
Switching to Berkeley SPICE. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23
Switching to SystemVision Transient and VHDL Support . . . . . . . . . . . . . . . . . . . . . . . . 24
Switching to SimTransient VHDL Support . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24
Chapter 2
The Object Manager. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25
Object Manager . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25
Object Manager Menus . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26
Navigating the Database . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28
Reuse and Editing of Objects. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29
Locking Objects . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29
Object Properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31
Object Finder . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31
Searching for an Object . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31
Save Printable File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33
Delete Lock Dialog Box . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34
Bulk Import/Export . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34
Exporting a Folder . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34
Importing a Folder . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35
Rename Object Dialog Box . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35
Audit Reports . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35
Viewing an Audit Report . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36
Chapter 3
Simulator Tool. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39
Overview of Simulator Tool . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39
Robust Netlisting . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41
Activating Robust Netlisting . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43
Choose Log File Dialog Box . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43
Component Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44
Setting a Component Parameter. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44
Local Expressions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45
Expression Editor Dialog Box . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45
Overrides . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45
Overriding Numeric Simulator Settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46
Power Node . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46
Setting the Power Node . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46
Recording a Sequence of Events . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47
Recording a Sequence of Events as a Scenario . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47
Deleting an Event from a Scenario . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 48
Opening an Existing Scenario. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 48
Pausing a Recording Sequence . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49
Running a Simulation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49
Simulating With Failures . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 50
Simulation Displays . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51
Digital Multimeter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52
Watches (Simulator) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 53
Simulation Feedback Coloring . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 54
Simulator Tool Menus . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 55
Viewing Transient Graphs of Property Watches . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 56
The Key. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57
Common Watch Actions. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57
The Graph . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 58
Chapter 4
Dynamic Simulation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 59
Starting Dynamic Simulation. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 59
On-Demand Operation. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 60
Starting On-demand Operation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 60
Watches (Dynamic Simulation). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 61
Adding Watches . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 61
Feedback on Watch Changes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 62
Watch Persistence . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 62
Viewing Device Properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 63
Viewing Embedded Component Properties. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 63
Setting a Failure Against a Device. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 65
Output Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 65
Analysis Tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 66
Chapter 5
FMEA Editor (Capital SimCertify) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 69
Overview of FMEA Editor (Capital SimCertify) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 69
FMEA Reports . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 70
Editing and Appending an FMEA Report . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 70
Header of FMEA Report . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 71
Viewing the FMEA Report . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 72
Filtering the Results . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 72
Ordering the Results . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 72
Printing an FMEA Report . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 73
Exporting an FMEA Report. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 73
Simulating a Record. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 75
Menu Bar Contents . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 76
File Menu . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 76
Edit Menu . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 77
View Menu . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 77
Order Menu. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 77
Chapter 6
Capital SimCertify . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 79
Overview of Capital SimCertify . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 79
Capital SimCertify Menus . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 80
File Menu . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 80
Edit Menu . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 81
View Menu . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 81
Creating FMEA Scenarios . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 81
Defining Initial Circuit State. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 82
Defining Circuit State Changes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 82
Selecting Failures to Analyze . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 83
Unresolved Scenario Builder . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 84
Confirm Event Delete Dialog Box. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 84
Edit Description Dialog Box . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 85
FMEA Scenario Dialog Box . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 85
Insert Combination Dialog Box . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 86
Insert Component Dialog. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 87
Run Scenario Wizard . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 87
Simulate FMEA Record Dialog. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 89
Chapter 7
Capital SimProject . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 91
Overview of Capital SimProject . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 91
Features . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 92
Output Functions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 92
Child Output Functions. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 93
Child Output Function Operators . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 94
Copy, Cut and Paste . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 94
Control Functions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 95
Creating a Project. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 98
Adding Project Features . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 98
Adding Output Functions to Features . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 98
Adding Control Functions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 99
Adding Excluded Functions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 100
Saving the Project . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 100
Menus. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 101
Chapter 8
Capital SimScript . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 103
Overview of Capital SimScript . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 103
Performing a Script Analysis . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 104
Capital SimScript Reports . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 104
Filter the Results . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 105
ECAD Device & Properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 106
Functions Area . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 107
Simulation Properties & Variables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 107
Error and Console Area . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 107
Creating a Script . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 107
Script File Format . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 108
Scenario Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 112
Using a Script File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 118
Override File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 119
Error Handling . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 120
Overrides File format . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 120
Chapter 9
Capital SimProve . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 123
Overview of Capital SimProve . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 123
Performing an SCA Operation. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 123
Creating an SCA Report . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 126
Advanced Functionality (Capital SimProve) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 127
Exporting an SCA Report . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 128
Prune an SCA Report. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 128
SCA Report View . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 130
Concern View . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 130
Function View. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 131
Type View. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 131
Simulation Displays Tab. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 132
SCA Tool Menus . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 132
Chapter 10
Capital SimStress . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 135
Overview of Capital SimStress . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 135
Running Stress Analysis . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 136
Stress Analysis Wizard . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 137
Wire Sizing and Back Propagation of Properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 143
Concerns . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 146
Rules . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 146
Defining Applied Current, Voltage and Power Algorithms . . . . . . . . . . . . . . . . . . . . . . . . . 146
Defining Stress Styles . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 147
Custom Styles Dialog Box . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 147
Creating a New Stress Style . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 151
Editing a Stress Style . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 152
Deleting a Stress Style . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 153
Import and Export of Stress Styles . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 153
Chapter 11
Capital SimBridge. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 155
Introduction to Capital SimBridge. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 155
Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 156
Chapter 12
The Component Builder Tool . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 159
Overview of Component Builder Tool . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 160
Tools . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 160
Component Builder . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 160
Creating a new component model . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 162
Selecting a Component Category. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 163
The Behavior Modeling Type . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 164
Defining a Component Interface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 164
Overriding Interface Property Promotion . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 166
Defining Component Structure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 167
Moving Objects in the Structure Editor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 171
Deleting Objects in the Structure Editor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 171
Pin Naming . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 172
Defining Component Behavior . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 172
Defining Failure Modes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 174
Overriding Failure Mode Promotion . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 176
Quantization Bands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 176
Shared Object Component Models . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 177
Attaching a Model to a Shared Object. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 178
Embedding Hierarchical Components . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 180
To Embed a Hierarchical Model . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 180
Reference an Embedded Object. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 186
Set Failure Modes for an Embedded Object . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 186
Embedding VHDL-AMS Models . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 187
To embed a VHDL-AMS model. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 187
Component Model Templates . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 189
To create a Component Model template. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 189
To create a Template from an existing Component Model . . . . . . . . . . . . . . . . . . . . . . . . 190
To delete a Template. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 191
To associate a Template with a Component Model . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 192
To delete the association between a Template and a Component Model . . . . . . . . . . . . . . 193
Component Builder Wizard . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 194
Chapter 13
State Builder . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 217
Overview of State Builder . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 217
State Builder Menus. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 218
Adding a New State . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 222
Defining State Properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 222
Moving and Resizing States . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 222
Hiding States. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 223
Pushing and Popping States . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 223
Adding an Event . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 223
Event Types . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 223
Defining Event Conditions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 224
Moving Events . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 224
Adding a Concurrency Group . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 225
Import and Export State Machines . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 226
Importing a State Machine . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 226
Exporting. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 226
Choose Grid Settings Dialog . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 228
Edit Comment Dialog (State Builder). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 229
Edit Event Dialog . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 230
Edit State Dialog . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 231
Chapter 14
QScheme Builder . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 233
Overview of QScheme Builder . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 233
Checking the QScheme . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 234
Defining QScheme Bands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 236
Numerical QSchemes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 237
String QSchemes. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 238
Editing QSchemes. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 238
Ordering QSchemes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 238
Opening an Existing QScheme . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 238
QScheme Menus . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 239
QScheme Warning Dialog . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 240
QScheme Wizard . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 242
Creating a New QScheme. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 242
Saving QSchemes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 243
Saving New QSchemes. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 243
Saving Existing QSchemes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 244
Chapter 15
Analysis Settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 245
Assigning a Project . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 245
Chapter 16
Scoping . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 247
Setting the Scope. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 247
Chapter 17
The Design Inspector . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 249
Accessing the Design Inspector . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 249
Using the Design Inspector with Capital Analysis . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 250
Object Browser . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 250
Object Data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 251
Extending the Design Inspector . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 251
Chapter 18
Component Model Encryption . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 253
Overview of Component Model Encryption . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 253
Exporting Encrypted Components. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 254
To export a component . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 254
To export a folder of components. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 255
Importing Encrypted Components. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 256
To import a component. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 256
Encrypting VHDL-dependent components. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 256
Chapter 19
Menus and Dialogs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 259
Export Netlist . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 259
Exporting to XML. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 259
Exporting to Saber (Export Netlist) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 260
Edit Stress Report Styles . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 260
General Dialogs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 261
About Dialog. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 261
Error Report Dialog . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 261
Filter Wizard . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 262
Find And Replace Dialog . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 263
Input Dialog . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 264
Object Properties Dialog. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 264
Open/Save Object Dialog . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 265
Printing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 265
Progress Dialog. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 266
Console . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 266
Database Dependency Check Dialog . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 267
Chapter 20
Editing Global and User Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 269
Edit Options Dialog . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 269
General Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 271
Syntax Highlighting Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 271
Changing Color Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 272
Changing Font Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 273
Automation Options. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 274
RPN Default Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 274
Report Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 275
Simulation Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 275
Simulation Highlighting . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 275
Adding a New Highlight. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 277
Editing an Existing Highlight . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 277
Deleting a Highlight . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 278
Model Search Path . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 278
Adding a Path . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 278
Deleting a path . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 278
Component Categories. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 279
Adding a Category . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 279
Edit a Category . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 279
Delete a Category . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 279
Error Reporting . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 279
Qualitative Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 279
Modeling Language Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 280
Simulation Engine Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 280
Numeric Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 280
Spice Simulator Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 281
External Model Management. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 281
Chapter 21
Configuration Tool . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 291
Configuration Tool. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 291
Version . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 291
Diagnostics . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 292
Data Sources . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 293
Encryption Keys . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 296
Optional Components . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 297
Configuration Tool - dsAdmin. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 298
Datasource Administration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 298
Change Administrator Password . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 302
Encryption Key Management . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 302
To create a key file . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 303
To create a key . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 304
To delete a key file . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 304
To delete a key . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 304
Appendix A
Company Preferences. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 307
Generic Preferences . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 307
RunTime.properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 307
FmeaText.properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 309
ScaText.properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 312
SimulationText.properties. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 312
EcadBridge.properties. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 313
EcadDefault.properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 313
Script Analysis Properties. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 314
SaberNetlister.Properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 315
Appendix B
Troubleshooting . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 317
Internal "Duplication Entry" exceptions are being raised . . . . . . . . . . . . . . . . . . . . . . . . . . . 317
Internal "java.lang.RuntimeException" exceptions are being raised. . . . . . . . . . . . . . . . . . . 318
Sometimes the component model attacher does not attach the component model . . . . . . . . 318
Error message "Failed to connect to component 'X' . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 318
Error message "Failed to initialise viewbase routines" . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 319
Composite Components seem Disconnected . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 319
The error report window appears, however no messages are displayed . . . . . . . . . . . . . . . . 319
Appendix C
Administration of Capital Analysis. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 325
Administrator Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 325
Appendix D
System Import/Export . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 327
Import and Export Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 327
Appendix E
Supply Rails, Batteries and Multiple Battery Support . . . . . . . . . . . . . . . . . . . . . . . . . . . . 329
Single Supplies . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 329
Explicit Batteries. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 331
Chassis . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 331
Multiple Batteries . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 332
Appendix F
Self Modeling Components . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 335
Creating a self modifying model map . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 335
Specifying component type information META_TYPE . . . . . . . . . . . . . . . . . . . . . . . . . . 335
Identifying the supported device types . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 336
Specifying Adaptive Component Models. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 336
Identifying Component Model Pins . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 336
Managing Terminal Mapping Associations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 337
Appendix G
Dynamically Generated Components . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 339
Dynamic Generation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 339
Setting Resistance on Dynamically Generated Arcs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 341
To view a dynamically generated model . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 341
To override default behavioral code . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 342
Appendix H
Saber Integration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 345
Saber Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 345
Saber Properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 345
Netlist Properties. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 346
Mast Model Properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 346
Ignore Properties. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 347
Identifier Properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 347
Parameters Properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 348
Property Value Substitution . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 349
Exclusion Properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 351
Exporting to Saber (Saber Integration) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 352
Saber Model Template Definitions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 353
Appendix I
SystemVision Integration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 357
SystemVision Integration Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 357
SystemVision Integration Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 358
SystemVision Project Attachment . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 359
SystemVision VHDL Model Attachment . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 360
SystemVision Simulation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 362
Appendix J
Error Resolution . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 365
Could not connect to the database:Could not load library 'libmysqlclient'.. . . . . . . . . . . . . . 365
Analysis error message: "both supply rail and batter components are present..." . . . . . . . . . 365
Can not run Background Simulation and no simcore.exe is listed in task manager.. . . . . . . 366
Capital Web Naming Service does not invoke due to the lack of port number as a parameter.
367
Error message: Destination component DEV_1{DEV**P1} does not exist in the component list.
367
Error: Unable to obtain a license for feature CHManufact, License request for feature NULL
failed [mgls_errno 203] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 368
Error when trying to run casconfig -dsAdmin in DOS Shell. . . . . . . . . . . . . . . . . . . . . . . . . 369
Cap Analysis - error message: no 'Quantization Bands' have been specified.. . . . . . . . . . . . 370
OCI.dll The specified module could not be found. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 371
The DataSource Admin tab does not appear when launching the Configuration Tool with
casconfig -dsadmin . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 372
Unable to connect to the AutoSteve Database. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 372
Unable to import a database dump of Capital; "the objects were exported by SYS, not by you"
372
Index
Third-Party Information
End-User License Agreement
This chapter contains high-level, introductory information about Capital Analysis and aspects
of its functionality.
Overview of Capital Analysis . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17
Model Construction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18
Introduction to Capital SimCertify . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20
Introduction to Interactive FMEA Verification . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20
Introduction to Capital SimProve . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20
Introduction to Capital SimScript . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21
Introduction to Capital SimStress . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21
Introduction to Transient Analysis . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21
Frozen Shared Objects in Capital . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22
Using Different Numeric Simulators with Capital Analysis . . . . . . . . . . . . . . . . . . . . . . 22
Model Construction
Capital Analysis is used for creating component models:
• Model Construction - The engineer gathers and inputs the information needed by the
Capital Analysis system by creating structural and behavioral models of circuit
components.
Capital SimCertify
The use of Capital Analysis for this task can be broken down into two stages:
• FMEA Generation - This stage is mostly automated, and it is at this point that Capital
Analysis generates the failure effects and RPN values.
• Introduction to Interactive FMEA Verification - During this stage, the engineer uses
Capital Analysis to examine the results of the automated FMEA generation.
Capital SimProve
The use of Capital Analysis for this task can be split into two stages:
• SCA Generation - This stage is automated, and it is at this point that Capital Analysis
detects possible sneaks.
• Interactive SCA Verification - During this stage, the engineer uses Capital Analysis to
examine the results of the automated SCA generation.
Capital SimStress
Capital SimStress is used for analyzing the maximum stresses (current, voltage and power)
detected on each component. This data can be used to generate wire and fuse sizing
information, which can then be back-propagated to your designs.
• Stress Analysis - This stage is automated and will explore all the switch changes for a
schematic and report the maximum current, voltage and power detected on each
component. See “Capital SimStress” on page 135.
Capital SimScript
Capital Analysis allows you to use design verification scripts to testing circuits:
• Design Verification Scripting - This facility is part of the Simulator tool and allows you
to run scripts that test the operation of circuits.
Model Construction
During the model construction stage, the engineer collects all the information required to
describe how the circuit works. There are three main aspects of the model:
• Capturing the circuit design
• Describing the system's functionality
Capital SimProve then compares this model with the observed behavior of the circuit (see
“Overview of Capital SimProve” on page 123). This could result in a number of concerns being
detected. In situations where a function has been achieved, when the model indicates that it
should not have been, this is highlighted as a possible sneak. In situations where a function has
not been achieved, but the model indicates that it should have been achieved, this is highlighted
as a possible failure of the circuit to met its specification.
After a report has been generated, the engineer can view the state of the circuit for each concern
of interest.
In addition to the above information, any concerns found during the analysis will be displayed
in the concerns tab of Capital SimStress. The concerns could be related to fuses blowing, or
short circuit conditions. See “Overview of Capital SimStress” on page 135 to find out more
about Capital SimStress.
Some extra setup information is usually needed for the transient run:
• Start Time - The point in time that the analysis should start, this defaults to zero.
• Stop Time - The point in time when the simulation should finish.
• Sample Rate - How often the state of the simulated system should be sampled and
recorded.
• Variable Time Steps - This is a mode of operation of the numeric transient simulator,
where the simulation engine automatically determines the sample rate of the results.
Note
Some models will need to have been associated with the correct transient mode in order
to simulate. Please see the language reference guide for more detail.
Related Topics
Overview of Simulator Tool Overview of Capital SimProve
Overview of Capital SimStress Capital SimScript
Overview of Capital SimCertify
1. VHDL models
2. Transient Simulation
This section contains details on how to switch and enable numeric simulators.
Procedure
1. Ensure that you have either SystemVision or SimTransient installed.
2. Open the ConfigurationTool.
3. Select the Optional Components tab.
4. Check the Capital SimTransient check-box.
5. Click OK.
Procedure
1. Open the ConfigurationTool.
2. Select the Optional Components tab.
3. Uncheck the Capital SimTransient check-box.
4. Click OK.
Procedure
1. Open the <CAPITAL_installation_directory>/resources/resources directory.
2. Edit the RunTime.properties file.
In this file, you might find a line similar to the following:
netsim.spice.program.override = ...
To switch to using Berkeley SPICE, change this line to (or add the line if it is not
present)
netsim.spice.program.override = berkeley
3. Save the file.
4. You need to ensure that ${PATH} includes the PSpice executable.
Procedure
1. Open the <Capital_installation_directory>/resources/resources directory.
2. Edit the RunTime.properties file.
In this file, you might find a line similar to the following:
netsim.spice.program.override = ...
To switch to using SystemVision, change this line to (or add the line if it is not present)
netsim.spice.program.override = simapi
3. Save the file.
Procedure
1. Open the <Capital_installation_directory>/resources/resources directory.
2. Edit the RunTime.properties file.
In this file, you might find a line similar to the following:
netsim.spice.program.override = ...
To switch to using SimTransient, change this line to (or add the line if it is not present)
netsim.spice.program.override = simapi
and ensure the following line is set
simcore.simapi.tengine=true
3. Save the file.
This chapter contains information about the Object Manager and its functionality.
Object Manager . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25
Navigating the Database . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28
Reuse and Editing of Objects . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29
Locking Objects . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29
Object Properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31
Object Finder . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31
Save Printable File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33
Delete Lock Dialog Box . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34
Bulk Import/Export . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34
Rename Object Dialog Box . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35
Audit Reports . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35
Object Manager
Capital Analysis requires the creation of analysis component models and audit reports. Once
these objects have been created, they are stored in a database structure allowing engineers
access to modify or reuse them in future projects.
The Object Manager supplied as part of the Capital Analysis system is the tool that provides
engineers with access to this database. The Object Manager window is invoked by pressing
Space Bar and entering Object Manager.
The Object Manager window is divided into 2 sections. The section on the left displays the
directory structure of the database and the section on the right displays the objects located in the
highlighted directory.
The directory structure within the database should be arranged to suit the user. Each engineer
might wish to have their own directory or it might be appropriate for work to be stored in
project directories. The Object Manager gives users the flexibility to choose the set up that best
suits them.
Related Topics
Navigating the Database Reuse and Editing of Objects
File Menu
New: This menu option invokes an additional menu. It gives the user the option of creating a
new Folder (directory), or one of the following objects:
• Component Model
• FMEA Report
• State Machine
• Component Mapping
• QScheme
• Script
Import Folder: This menu option does a bulk import of a folder (see “Bulk Import/Export” on
page 34). The input of the import is a Zip file that has been exported from another database.
Export Folder: This menu option does a bulk export of a folder (see “Bulk Import/Export” on
page 34). The output of the export is a Zip file that can be imported to another database.
Print: Prints a report of the contents of a selected folder
Print Preview: Displays an image that represents the printer output of the selected object.
Exit: Exits the Object Manager window.
Edit Menu
Open Selected: Opens the selected object in the relevant tool (i.e. opens a component model in
the Component Builder tool)
Rename...: Allows the user to rename the selected object (see “Rename Object Dialog Box” on
page 35).
Cut: Removes the selected object from the database and places it on the clip board. This option
is also available as a tool button .
Copy: Copies the selected object to the clip board. This option is also available as a tool button
.
Paste: Pastes an object from the clip board into the database at the location of the highlighted
directory. This option is also available as a tool button .
Delete: Deletes the selected objects from the database . A dependency checking operation is
performed before any object is deleted (see “Database Dependency Check Dialog” on
page 267).
Select All: Highlights all the objects in the selected directory or folder.
Find: Opens the Object Finder, to allow the user to search for objects in the database.
System Preferences: Gives the user access to the Capital Analysis user definable options. See
“Edit Options Dialog” on page 269 for more details.
View Menu
Refresh Display: Refreshes the contents of the database in the Object Manager window.
Display Properties: Invokes a dialog displaying the properties of the selected object (see
“Object Properties” on page 31).
Tools Menu
Admin mode: Enables Administrator level privileges on the database.
Unlock: Removes the lock applied to the selected object (see “Delete Lock Dialog Box” on
page 34).
Export Encrypted: Allows the export of component object models in an encrypted format. See
“Exporting Encrypted Components” on page 254.
Import Encrypted: Allows the import of encrypted component object models. See “Importing
Encrypted Components” on page 256.
Listing: Saves a list of the objects in the current folder to a file (see “Save Printable File” on
page 33).
Unlock VHDL Models: Forces the unlocking of any persistent locks on external VHDL
models. See “To unlock all external models” on page 285.
Related Topics
Object Manager Navigating the Database
In the right hand section of the window each object has an icon preceding its name.
Related Topics
Object Manager Object Manager Menus
Reuse and Editing of Objects Locking Objects
Object Properties
If an object is required that is similar to an already existing one, the engineer might choose to
edit a copy of the existing model. Once the object to be edited has been copied to a new location
the engineer can open the selected object by either selecting the "Open Selected" option from
the Object Manager Edit menu or by double clicking on the object itself. In both cases the
relevant tool will be invoked with the object loaded. For example, if it is a component the
engineer wishes to edit, the Component Builder tool will be invoked with the component
already loaded.
Related Topics
Object Manager Object Manager Menus
Navigating the Database Locking Objects
Object Properties
Locking Objects
The Capital Analysis system is designed as a multi-user system and so more than one user may
wish to access the same object simultaneously. Therefore Capital Analysis uses a system of
object locking in order to maintain the integrity of the database and its objects.
For example if an object is in the process of being edited by one user, the software will have
automatically applied a lock to the object in the database, its icon will be grayed out in the
Object Manager window and it will be unavailable to other users whilst the lock is in force.
When the user saves the edited version to the database the lock is automatically removed and
once again the object is available to other users.
Locks can be applied and removed manually or automatically when a tool edits an object. A
user can only remove a lock that was created for or by that user. However, the administrator can
remove any lock. Great care should be taken when doing this not to compromise the integrity of
the database. Here are the setups involved in applying a manual lock as administrator.
Procedure
1. You must first enter the admin mode if you have not already done so. Select "Admin
Mode" from the Tools > Admin menu option in the Object Manager. A dialog will
appear asking the administrator for a password.
2. After entering the password and clicking the "OK" button, the title bar of the Object
Manager window will change to "Administration" and the lock buttons on the tool bar
will now be available for use.
3. To apply the lock, ensure the correct object is highlighted and then
4. Either click the lock button located on the object manager window tool bar or select
the "Lock" option from the Administration window Tools menu.
Here are the setups involved in applying a manual lock as a normal user:
1. Ensure the correct object is highlighted in the right hand area of the object manager.
2. Either click the lock button located on the object manager window tool bar or select
the "Lock" option from the Administration window Tools menu.
To manually remove a lock from an object as Administrator:
1. You must first enter the admin mode if you have not already done so.
2. Ensure the relevant object is highlighted in the right hand area of the object manager
3. Select the "Unlock" option from the object manager window Tools menu or clicking the
Delete Lock button on the window tool bar (see “Delete Lock Dialog Box” on
page 34 for more information).
To manually remove a lock from an object as a normal user:
1. Ensure the relevant object is highlighted in the right hand area of the object manager
2. Select the "Unlock" option from the object manager window Tools menu or clicking the
Delete Lock button on the window tool bar (see “Delete Lock Dialog Box” on
page 34 for more information).
Related Topics
Object Manager Object Manager Menus
Navigating the Database Reuse and Editing of Objects
Object Properties
Object Properties
An engineer can view the properties of a particular object. This is done by highlighting the
desired object by clicking on it and then selecting the Properties option from the Object
Manager View menu.
An object's properties will consist of the following:
• Name
• Id number
• Type of object (i.e. component, design etc.)
• Location of the object in the database
• When it was Created and by whom
• When it was Last modified and by whom
• Any locks that are applied to the object
In particular the text frame displaying the locks that apply to the object can be very useful. For
example, if an engineer wishes to edit an object but finds it is locked in the database, by looking
at the properties they can find out who applied the lock and when it was applied.
Related Topics
Object Manager Object Manager Menus
Navigating the Database Reuse and Editing of Objects
Locking Objects
Object Finder
This tool allows the user to search the database to find an object or folder in the database.
It can be opened from the Object Manager.
• Named - the name or part name of the object the engineer is looking for, there is a
button on the right of this text bar indicating a pick list to allow access to previous
entries.
• Of Type - this is a pick list of the types of object that are supported by Capital Analysis
in the Object Manager. This also has options to search for all types of object or a folder.
• Look In - the default for this is Whole Database; by using the Browse button a single
directory can be searched, which makes the search run faster.
There are also three buttons to perform the search. Start Search will start looking for the
object(s) as has been specified. Stop Search will abort the search and output the object already
found to the table. New Search will clear all the details and the table of objects found in the last
search.
Once a search has finished (or been stopped) the list of objects found will be displayed in the
table along with their locations and dates. An object will be opened in its editor by double-
clicking on it.
The Object Finder only has the File menu with an Exit option to close the window and the usual
Help menu.
Related Topics
Object Manager
Related Topics
Object Manager Menus
Related Topics
Object Manager
Bulk Import/Export
These topics detail the process of exporting and importing folders.
Exporting a Folder
Select the folder you wish to export.
1. Click the File > Export folder menu, the Save window appears.
Note
If you have selected the root folder in the Object Manager, the You have selected the
root folder dialog gives you the option Include Settings. Select this option if you want
to export Analysis settings (equivalent to system data) alongside Analysis objects (such
as models). If you do not select this option, only Analysis objects are exported.
2. Use this file chooser to select the name and location of the export file to be created.
Clicking the Save button will open the Bulk export status window.
3. On completion of the export operation, click OK to close the window.
Importing a Folder
It is recommended that you create a new folder to import into. When the import is complete the
folders can be renamed as necessary.
1. To start the import, select the new folder (within which the exported folder will be
created) and clicking the File > Import folder menu, the Open window appears.
2. Use this file chooser to select the name and location of the export file to load. The
Include Settings option allows you to specify whether you want to include Analysis
settings in the import (selected) or not (unselected). Clicking the Open button will open
the Bulk import status window. Note: This option is only available if importing from
the root folder.
3. On completion of the import operation, click OK to close the window.
4. If you selected to import settings, restart the application.
Related Topics
Object Manager
Related Topics
Object Manager
Audit Reports
Audit reports can be created by selecting the Create Audit Report option when running
Capital SimCertify or Capital SimStress actions using the FMEA Wizard.
For further information see Capital SimCertify - Run Scenario Wizard and Capital SimStress -
Stress Analysis Wizard.
Once created, they can be accessed in the Object Manager by highlighting the Audit directory
( ). Clicking on this icon will display its contents in the right hand section.
The right hand section display the details of the available audit reports including name, a
description of the action performed to generate it. the date of its creation and its last
modification date. Right clicking on a report opens a context menu containing some of the
actions available in the Object Manager Menus.
Related Topics
FMEA Wizard (Run Scenario Wizard) Stress Analysis Wizard
Object Manager Menus Viewing an Audit Report
Procedure
1. There are a number of ways an Audit Report can be viewed. Do one of the following:
• Highlight the required report and select Edit > Open Selected from the menu
or
• Double click the required report
or
• Right click and choose Open Selected from the context menu
2. The report opens in the Audit Report Viewer. It contains the following:
• Report Name: name of the audit report object
• Generated: date and time the audit was created
• User: username of the creator of the audit
• Software Version: major version, service pack and hotfix (if applicable)
• Database: unique identifier information for the database the audit was run on. This
may differ from the database the audit is currently in.
• Project: the name of the project within which the audit was created.
Related Topics
FMEA Wizard (Run Scenario Wizard) Stress Analysis Wizard
Object Manager Menus
Capital Analysis can simulate the behavior of a circuit when the states of switches in the circuit
are changed. This can be shown graphically on the schematic of the ECAD tool and helps to
verify the correct behavior of the circuit and to understand its faulty behavior. Active wires in
the circuit are colored green and possess an arrow indicating the direction of the current.
Inactive wires are colored blue.
Overview of Simulator Tool . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39
Robust Netlisting . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41
Choose Log File Dialog Box . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43
Component Parameters. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44
Local Expressions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45
Overrides . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45
Power Node. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46
Recording a Sequence of Events. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47
Running a Simulation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49
Simulating With Failures . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 50
Simulation Displays . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51
Digital Multimeter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52
Watches (Simulator) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 53
Simulation Feedback Coloring . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 54
Simulator Tool Menus . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 55
Viewing Transient Graphs of Property Watches . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 56
Robust Netlisting
Typically, attempting to run a simulation on a scope containing errors (such as incomplete nets,
isolated content, missing attachments, etc.) will result in an error, in which case the simulation
will be aborted and the errors reported. In most cases, this functionality offers an opportunity to
rectify the errors before re-running the simulation, but that does not satisfy the needs of users
wanting to run simulations on incomplete complex electrical systems developed within Capital.
The Robust Netlisting option allows more issues with an incomplete/incorrect diagram to pass
without generating an error. Without Robust Netlisting turned on, dynamic simulation will
generate errors and the diagram must be fixed before running. See “Dynamic Simulation” on
page 59 for more information.
Note
Robust Netlisting is supported in all of the Capital Analysis simulation and high-level
analysis tools.
The following scenarios will be allowed when simulating with Robust Netlisting enabled:
Note
An incomplete attachment is not the same as a component having an attachment to a
component that can no longer be found in the database. An attachment to a missing
component will still result in an error that will not allow a simulation to run. The same is
true of attachments to encrypted components where no decryption key can be located;
refer to “Component Model Encryption” on page 253 for more information.
This situation may occur when the wire is present on a design in a build list and
connects to another design that is not present in the build list. It will still be possible
to simulate the remaining designs.
Note
As most of these scenarios will result in the generation of warnings instead of errors, it
will be possible to deselect the Show warnings option on the Error Report Dialog and
remove them from the display. However, as operating in Robust Netlisting mode will
downgrade almost all common errors to warnings, it will not be possible to re-open the
error dialog to disable this option. If you wish to do this, either disable Robust Netlisting
temporarily, or close and re-open the current design to reset the option to the default
(warnings are displayed).
Related Topics
Activating Robust Netlisting
Related Topics
Overview of Simulator Tool
Component Parameters
Component parameters are properties on component models that are of the type parameter. If
you are using the Simulator, you can change the parameters in the Component Parameter
dialog box.
Related Topics
Setting a Component Parameter
Procedure
1. Select Edit > Component Parameters from the Simulator menu.
2. In the resulting dialog box, double-click the component that possesses the parameter you
wish to override.
3. Select the parameter in the list, the type and default value will be displayed to the right.
4. Type a new value into the Current Value box.
Note
Click the Reset button in the Parameter Values panel to reset the parameter to its default
value as specified in the component model.
Related Topics
Component Parameters
Local Expressions
Local expressions provide a way of defining constants that are available to all of the component
models in the scope of the simulation. A component model can refer to this constant. An
example of this may be constants that are defined for address locations for devices connected to
a data bus.
Related Topics
Expression Editor Dialog Box
Related Topics
Local Expressions
Overrides
The Numeric overrides facility is used to override the global numeric simulator settings for a
simulation.
The settings that can be overridden are:
• Active Current Threshold - the level of current that the simulator interprets as 'active'
and is used for coloring and when methods such as isActive are used in a component
models behavior.
• Short Circuit Current Threshold - the level of current, if this level is exceeded during
analysis, will flag overload or short circuit conditions.
• Open Circuit Resistance - the level of resistance the simulator will use to represent
open circuit conditions in the context of component models and failure conditions.
• Short Circuit Resistance - the level of resistance the simulator will use to represent
short circuit conditions in the context of component models and failure conditions.
Related Topics
Overriding Numeric Simulator Settings
Procedure
1. Select the Edit > Overrides option from the Simulator menu.
2. Check the box of the field that you would like to override.
3. Enter the new value for the overridden value.
Related Topics
Overrides
Power Node
The Power nodes for failure application dialog is used to select the power node that short to
battery failures use.
There are several options available:
• Use any available battery - essentially an 'I don't care which battery is used' option,
uses the first battery the simulator finds and shorts to its positive terminal.
• Use the highest rated battery - shorts to the positive terminal of the battery that has the
highest voltage.
• Use the lowest rated battery - shorts to the positive terminal of the battery that has the
lowest voltage.
Related Topics
Setting the Power Node
Procedure
1. Select the Edit > Power Node option from the Simulator menu.
2. Select the desired battery.
Related Topics
Power Node
Procedure
1. Click the Open the sequence recorder and start recording button at the top of the
Simulator to display the Scenario Sequencer dialog box.
2. The switch settings from the Simulator are displayed in the Sequence window. If you
want to change these settings for the start of the scenario, you can change them in the
Sequence window.
3. You can insert events into the sequence in the following ways:
• Make a change in the Event pane of the Simulator and click either the Run
simulation with current settings button or the Open the sequence recorder and
start recording button at the top of the Simulator. The event is added at the end of
the sequence.
• Click an event in the sequence and click the Insert Event button on the Scenario
Sequencer to add an event below the selected event. Ensure that the new event is
selected in the Scenario Sequencer and make a change in the Event pane of the
Simulator. Click either the Run simulation with current settings button or the
Add event without doing another simulation button at the top of the Simulator.
The new event is updated with the change from the Simulator.
4. Select each event in turn and specify whether you want the event to occur after the
previous event has stabilized or after a certain period of time after the previous event. If
you uncheck the upon Stabilization box, the After box is enabled and you can specify a
period of time and select a unit of time from the drop-down list.
5. Select either the File > Save or File > Save As menu option.
6. The Select location dialog box is displayed. In the tree, select the folder location where
you want to save the scenario file. Note that you can select a folder and click the Create
sub-folder button to create a sub-folder below it. In the Object field, specify the name
of the scenario and click the Save button.
Note
You can use the Object Manager tool to view a scenario in read-only mode.
Procedure
1. Click on the event in the Scenario Sequencer and click the Delete Event button.
2. The event is deleted from the scenario.
Procedure
1. Click the File - Open menu option.
2. The Select sequence dialog box is displayed. In the tree, click on the scenario that you
want to open and click the Open button. You can check the Read-Only box if you want
to open the scenario in read-only mode.
3. If you are editing the scenario, insert or delete the events as required.
Procedure
1. Click the Stop recording data to the sequence button on the Scenario Sequencer.
2. The recording of the scenario is paused. To restart the recording, click the Start
recording data to the open sequence button.
Running a Simulation
This topic gives detailed steps on runnnig a simulation.
Procedure
1. Set the analysis scope.
2. Press Space Bar and enter Simulator.
3. Click the Event tab.
4. Select the switch positions. You open a switch by clicking open and close a switch by
clicking closed.
5. Click the Simulate button. A progress dialog is displayed, titled with the name of the
selected scope, and with a progress bar indicating that the simulation is underway.
Note
You can cancel the current simulation by clicking the button to the right of the
progress bar.
After a moment the ECAD tool schematic will be colored and any open Simulation
Displays will change to reflect the new state of the circuit.
Note
If the analysis scope is a Capital Integrator plane and wiring synthesis has been
performed, then an additional dialog will appear when starting the Simulator requesting
the configuration to analyze. Select one from the list.
The simulation mode options are selected in the centre panel, (they are license dependant):
• External - the simulation will use an external simulation technology supported via the
Capital SimBridge. See “Capital SimBridge” on page 155 on configuring an external
simulator.
Checking the Use Transient box will run the simulators in transient mode. When this is mode
selected, extra information is required for the transient run - click the Simulate button to open
the Transient settings... dialog box.
• Start time - the time that the transient run should start at (defaults to zero).
• Stop time - the time that the transient analysis should run to.
• Sample time - the sample rate at which the results will recorded.
• Variable Time Steps - the mode of operation of the numeric transient simulator, where
the simulation engine automatically determines the sample rate of the results.
Enter the settings by typing into the boxes. You can specify the temporal magnitude using the
drop-down lists to the right of each box.
Related Topics
Simulating With Failures Simulation Displays
Capital SimScript Local Expressions
Component Parameters Overrides
Power Node Simulation Feedback Coloring
Simulator Tool Menus Scoping
Related Topics
Overview of Simulator Tool Simulation Displays
Capital SimScript Running a Simulation
Component Parameters Overrides
Power Node Simulation Feedback Coloring
Simulator Tool Menus Scoping
Simulation Displays
The Simulation Displays tab enables additional information to be displayed for selected
components in the design description.
Note
If a component involved in the simulation is encrypted, the option to view the
component’s structure and behavior will be disabled, only external component interfaces
will be displayed and only external node information will be displayed. See “Component
Model Encryption” on page 253 for more information on working with encrypted
components.
• Show structure - displays information about the activity in-terms of the component’s
structure.
• Show behavior - for those components whose behavior is implemented using state
machines, the current active states can be displayed.
• Show properties - for those components with input or output properties, the values of
those properties can be displayed. In addition, the current values of nodes and arcs used
in the evaluation of the components behavior are also shown. As are the values of
variables used in State Machines.
• Show multimeter - displays a Digital Multimeter window showing arc and node
currents and voltages.
• Show buffers - displays the contents of any data buses buffers.
• Show activity - displays the data bus activity.
• Show watches - displays a list of watched component properties.
• Show graphs - displays a graph of the values for watched component properties plotted
against simulation time. See “Viewing Transient Graphs of Property Watches” on
page 56 for more information about the graphs. This is enabled only if you are running a
transient simulation.
These facilities are extremely useful for debugging the component models. Not that some of
these options are license dependant.
An example of the Show properties window and the other available options is displayed
below:
Individual simulation displays can be closed at any time. Note that when the Simulator is
closed, all simulation displays will be closed.
Digital Multimeter
This display enables you to view the results of the Numeric simulation for the component you
selected in the Simulator.
The display shows the result either with the usual suffixes, or in scientific notation. Use the
drop-down list at the bottom of the dialog box to display the component's electrical property.
Related Topics
Overview of Simulator Tool Simulation Displays
Watches (Simulator)
It is possible to watch individual component properties by adding them to a watch list. This
facility enables you to monitor the important electrical conditions of devices in one list.
Watches are set in the Property Viewer window.
To set a watch, double-click on the component's property, a watch icon will appear to the left of
it (as shown above for CONTACT.R).
To view all current watches, click on the Show simulation watches button at the top of the
Simulator. The list of watches will appear in the Watched Properties dialog box.
The Watched Properties dialog box contains a table with the following columns:
Related Topics
Overview of Simulator Tool Simulating With Failures
Capital SimScript Simulator Tool Menus
Refer to the following table for a list of colors and their meanings:
File Menu
• Log Results - the log entry is only displayed if Capital SimScript is installed.
• Print Preview - opens a window which displays the page format and allows you to
change the printer settings.
• Print - prints all of the simulation information.
• Exit - exits the Simulator tool. Will also close any simulation displays still open.
Edit Menu
• Local expressions - specifies expressions (such as constants), that will be in the scope
of the design being simulated. See “Local Expressions” on page 45 for more details.
• Component parameters - overrides the component model parameters. See
“Component Parameters” on page 44 for more details.
• Transient Settings - specifies the transient settings for a transient simulation. See
“Running a Simulation” on page 49 for more details.
• Overrides - overrides the global settings for numeric simulation. See “Overrides” on
page 45 for more details.
• Power Node - used to select the power node for simulation (for short to power failures).
See “Power Node” on page 46 for more details.
• Evaluate Rules - check this box if you want to evaluate rules when running the
Simulator. Any print statements from rules will be displayed in the Console when you
run a simulation.
• Evaluate Actions - check this box if you want to evaluate actions when running the
simulation. Any print statements from actions triggered by rules will be displayed in the
Console when you run a simulation.
• Options - opens the Options dialog box. See “Edit Options Dialog” on page 269 for
more details.
Utils Menu
• Reset - resets the simulation (but does not change the switch settings or applied failure
modes).
• Reset All - resets the simulation (will reset switch settings to their defaults and unset
any failures applied).
View Menu
• Console - displays the Console where all the print messages in component models
appear.
• Netlist - produces a netlist for the design description being simulated.
• Functional Expressions - displays a summary of any functional or sneak expressions
that have been set.
• Netlist Errors - displays any errors produced when creating a netlist. If you are denied
the ability to run a simulation, this option will help to explain why.
• Generated Models - displays any dynamically generated models, such as connectors,
that have nothing attached by the user.
Related Topics
Overview of Simulator Tool Simulating With Failures
Running a Simulation Simulation Displays
If you keep the graph open and run the simulation again, the graph updates accordingly. If you
exit the Simulator, the Component Property Watches facility also closes.
• Key - this lists the component property watches from the simulation and indicates the
color that is used for that watch on the graph. The name of each simulation consists of
the component name and the name of the property that is being watched.
• Graph - The Y-axis of the graph shows the property values and the X-axis shows the
simulation time.
The Key
The key can be hidden or shown by clicking the arrows at the top right corner of it.
Although all watches from the simulation are listed, only 9 can be displayed on the graph at any
one time. Those not currently displayed on the graph have a gray square.
Note
The key cannot display watches with voltage values alongside watches with current
values.
If watches of both types have been set before you display a graph and the first watch set
has voltage values, watches with current values are not displayed in the key, and vice
versa. In this scenario, watches with current values will only be displayed after all
watches with voltage values have been stopped.
If the graph key is displaying watches with current values and you start watches with
voltage values, the watches with voltage values will not be displayed in the graph key
until all watches with current values have been stopped.
Right-click on the watch name and select the Edit Plot Style option from the pop-up menu to
display the Plot Style dialog. Check the Do not render this plot box.
The Graph
Data-capture points (points at which data was sampled in the simulation) are displayed as small
squares along the lines on the graph. If you position the mouse cursor over a data-capture point,
the exact property value and the simulation time are displayed. If the key for the graph is
hidden, the name of the watch is also displayed. When multiple watches have the same value at
the same simulation time, all of the watch names are displayed.
The View menu enables you to use zoom controls to view different part of the graph (these
controls are also available by right-clicking on the graph window):
• Zoom In and Zoom Out change the scale of the diagram incrementally. You can also
do this by rolling the mouse wheel.
• Zoom All re-scales the graph window to show the entire graph. When the entire graph is
not visible in the graph window, scroll bars along the sides enable you to move around
the graph.
Note that there is a gap between the axes and the start of the graph. This is to help distinguish
between the axes and the lines plotted on the graph.
Related Topics
Overview of Simulator Tool Simulation Displays
The dynamic simulation capabilities of Capital Analysis offer you numerous benefits in terms
of analysis when working on electrical designs. Dynamic simulation offers some of the
simulator tool's capabilities but presented in a way to aid workflow.
It is embedded within the Capital Logic application so that it can run in the background as you
work with the design. When you add devices and connectivity, the design is simulated
automatically. By placing the mouse cursor over the design, you can directly change input
conditions and view output conditions of the devices and connectivity. Dynamic Simulation has
the advantage that serious design errors, such as short circuits, are picked up immediately if
they are introduced in the design.
Further feedback about the operational state of the design is displayed as achieved functions (as
in the Simulator) in the Output Window in the Capital Logic application.
Procedure
1. With the design to simulate open, click the Analysis Tab.
2. Click the Set Scope icon ( ) and select the design name from the dropdown list.
3. Specify either Qualitative or Numeric Simulation from the simulation type icon ( )
dropdown list. If you have an external simulator configured, that option is also
available; see “Capital SimBridge” on page 155 for more information.
4. Click the Background Simulation icon ( ).
Note
The simulation feedback provided during dynamic simulation is the same as that offered
within the Simulator Tool; see “Simulation Feedback Coloring” on page 54 for more
information.
Results
• The simulation engine starts.
• To disable dynamic simulation, simply click the Disable Simulation icon ( ). The
simulation engine shuts down.
• You can cancel the current simulation by clicking the button to the right of the
progress bar. If you do cancel a simulation while running dynamic simulation, you will
be switched into On-Demand Operation.
Related Topics
On-Demand Operation Watches (Dynamic Simulation)
Viewing Device Properties
On-Demand Operation
Another way to run simulation on a design while working on it is on-demand simulation.
Similar to background simulation, setting this mode of operation starts the simulation engine in
the background, but in this case, the simulation is not run until you click the button. This
mode may be preferable when working with exceptionally large designs, where waiting for the
simulation to update after a design change may not be acceptable.
Note
The button is not enabled until design changes have been made that require
simulation.
Related Topics
Starting On-demand Operation
Procedure
1. With the design to simulate open, click the Analysis Tab.
2. Click the Set Scope icon ( ) and select the design name from the dropdown list.
3. Specify either Qualitative or Numeric Simulation from the simulation type icon ( )
dropdown list. If you have an external simulator configured, that option is also
available; see “Capital SimBridge” on page 155 for more information.
4. Click the On Demand icon ( ).
Results
• The simulation engine starts.
• Once on-demand operation has been started, you can trigger the simulation of the
selected scope by clicking the button at the bottom of the Analysis Tab.
• You can cancel the simulation at any time by clicking the button to the right of the
progress bar.
Related Topics
On-Demand Operation Watches (Dynamic Simulation)
Viewing Device Properties
Adding Watches . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 61
Feedback on Watch Changes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 62
Watch Persistence . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 62
Adding Watches
This topic details how to set a watch on a component property.
Prerequisites
Before you can set a watch on a property, simulation output must be available. This means that
either:
Procedure
1. Position the mouse pointer over the component for which you want to set a watch. A
tooltip is displayed.
2. Click the Properties button. The Properties For... dialog is displayed, with its title
appended with the name of the selected component. All properties for the component are
displayed.
3. Select the property for which you want to set a watch.
4. Click the Watch Selected button.
Results
• The property is added to the watches table in the Output Window.
• To remove a watch, highlight the row in the watches table of the Output Window that
you wish to remove, and then press the Delete key or press the Stop Watching button.
Related Topics
Starting Dynamic Simulation Viewing Device Properties
When a simulation is running in numeric mode, the amount of the change will also be shown in
the column.
Watch Persistence
Capital Analysis remembers the properties you have chosen to watch for the duration of your
session in the authoring tool. For example, you can stop a simulation, alter a model, and restart
a simulation without losing your specified watches. However, if Capital Logic were to be
closed, then the watches will be lost.
Related Topics
Adding Watches
Prerequisites
Before you can view device properties, simulation output must be available. This means that
either:
Procedure
1. Hover your mouse pointer over the entity you want to inspect. A tooltip is displayed.
Note
If you are performing a numeric simulation, the tooltip can be used to display component
variables, if the behavior of the attached model has been scripted to do so.
2. Click the Properties button. The Properties For... dialog is displayed, with its title
appended with the name of the selected component. All properties for the component are
displayed.
Related Topics
Starting Dynamic Simulation On-Demand Operation
Prerequisites
Before you can view component properties, simulation output must be available. This means
that either:
Procedure
1. Hover your mouse pointer over the entity you want to inspect. A tooltip is displayed.
Note
If you are performing a numeric simulation, the tooltip can be used to display component
variables, if the behavior of the attached model has been scripted to do so.
2. Click the Properties button. The Property View dialog is displayed, with its title
appended with the name of the selected component. All properties for the component are
displayed as shown in Figure 4-2.
3. If required, you can set a watch on a property by clicking the Watch Selected button. To
remove a watch, highlight the row in the table and press the Stop Watching button.
Related Topics
Defining a Component Interface On-Demand Operation
Prerequisites
Before you can set a failure against a device, simulation output must be available. This means
that either:
Procedure
1. Hover your mouse pointer over the entity in which you want to trigger a failure. A
tooltip is displayed.
2. The Failures section of the tooltip offers all failures available. Select the failure to
apply; the results are displayed immediately, both in the Messages tab of the output
window, and in the design coloring.
A failure can be removed by deselecting the option against the device.
Related Topics
Starting Dynamic Simulation On-Demand Operation
Simulating With Failures
Output Window
If you have selected the Capital Analysis tab in the output window, you can select one of the
following tabs to view information.
• Messages
Displays information about achieved functions, failed functions, failed components and
watched properties.
• Console
Displays information, such as messages from the analysis models, in a similar way to
the Simulator's console.
• Errors
Displays any errors that have been generated by a simulation.
Additionally, on the right of the output window, all active watches are displayed. See “Watches
(Dynamic Simulation)” on page 61 for more information.
Related Topics
Starting Dynamic Simulation On-Demand Operation
Analysis Tab
This set of functions, located on the Analysis tab of the Capital Logic design browser, acts as a
control center for all dynamic simulation functions, as well as providing a number of shortcuts
to the other simulation tools.
Tip: The Analysis tab can be detached from the design browser and used as a separate
window. To do this, click on the tab and drag it away from the browser; once detached,
you can position it anywhere. To restore the tab, click the close button to close the
window.
Simulation Controls
The grid in the middle of the Analysis tab displays all of the input interfaces available on the
analysis models attached to components in the design. By setting the state of these inputs, you
can control the flow of current within the system during simulation. The grid displays all
devices and components with attachments; the following icons are used to identify the
attachment types:
• A red dot on a device icon indicates that it has a manual analysis model attachment.
• A blue dot on a device icon indicates that it has an automatically generated analysis
model attachment.
To set the state of an input, select one of the available states from the dropdown list to the right
of the device/component name.
Functions Browser
If a project has a project model assigned, this field offers a tree menu displaying all configured
functions and outputs.
See “Capital SimProject” on page 91 for more information on configuring and associating an
analysis project.
The three icons beneath the browser allow you to filter the displayed content against the
following categories:
• Function inputs/outputs
• Active functions/sneak functions/failures
• All functions/scoped functions
Related Topics
Starting Dynamic Simulation On-Demand Operation
Generated reports are accessible both from the tab, and in the Object Manager - where you can
view report information on the analysis operation, the scope of its analysis and detailed scenario
information.
Double-click on a report within the tab to view its contents. For further information see “Audit
Reports” on page 35.
The FMEA editor is provided as part of the Capital Analysis system giving the engineer the
facility to view, edit and annotate the results of different FMEAs. When the results of an FMEA
are loaded into the FMEA Editor each entry can be examined on screen and amended if
necessary.
Overview of FMEA Editor (Capital SimCertify) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 69
Editing and Appending an FMEA Report . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 70
Header of FMEA Report. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 71
Viewing the FMEA Report . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 72
Printing an FMEA Report . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 73
Exporting an FMEA Report . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 73
Simulating a Record . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 75
Menu Bar Contents . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 76
If an engineer wishes to review an FMEA report some time, later there are 2 ways in which
the FMEA editor can be invoked. The easiest way is to press Space Bar and enter FMEA Editor.
This will invoke an empty FMEA editor window into which the engineer can load the desired
results. This is done by selecting "Open" from the File menu or clicking the button on the tool
bar and selecting the relevant file from the dialog.
Alternatively, it can be activated from the Capital Analysis FMEA tool window by highlighting
the desired FMEA and then clicking the "Edit" button located on the tool bar.
FMEA Reports
There are a number of ways an FMEA report can be viewed and edited:
• Editing and appending the report (see “Editing and Appending an FMEA Report” on
page 70).
• Viewing and editing the header of the report (see “Header of FMEA Report” on
page 71).
• Viewing the report (see “Viewing the FMEA Report” on page 72).
• Printing the report (see “Printing an FMEA Report” on page 73).
• Exporting the report (see “Exporting an FMEA Report” on page 73).
• Simulating a record in the report (see “Simulating a Record” on page 75).
Related Topics
Menu Bar Contents
Procedure
1. Entries in the Report can be edited by selecting them and entering the new contents of
that cell. Some cells must however have specific entries; sev, occ, det (severity,
occurrence and detection) must be specified as integers from 1 to10. The rpn column is
also not editable as it is defined as the product of the three sev, occ and det values.
2. New records can be added by selecting Edit > Add row, this will add a row below the
selected line. Rows can be removed by selecting Edit > Delete row, this will confirm
whether the selected result should be deleted before deleting it. Rows can also be edited
using the Cut, Copy and Paste buttons. They work in the usual way and are found in the
edit menu and in the tool bar.
Related Topics
FMEA Editor (Capital SimCertify) Header of FMEA Report
Viewing the FMEA Report Printing an FMEA Report
If the FMEA report was created by Capital Analysis then the FMEA date and System boxes
will have been completed automatically.
The dialog can be closed by pressing Cancel which discards the changes or by pressing OK to
save any changes that have been made.
Related Topics
FMEA Editor (Capital SimCertify)
Firstly select Add Filter to create a filter. Next define the filter by selecting from the two pick
lists and typing appropriate filter text in the text box. The first pick list selects the category to be
filtered and the second pick list selects the operator. Depending on the category you have
chosen the operator pick list will change appropriately to suit the category.
When the Invert Results check box is checked, the opposite of the filtered results will be
displayed.
To remove a filter highlight it in the box at the top of the window and click Remove Filter.
All the filters can be removed by selecting View > Remove All Filters from the menu. This
will return the FMEA Editor to showing all of the results.
• Order by Name - orders the rows alphabetically according to the name column (e.g.
MOTOR_1 before RELAY_3 before WIRE2).
• Order by Failure - orders the rows alphabetically according to the failure column (e.g.
short circuit before short to ground).
• Order by Occurrence - orders the rows according to the occurrence column.
• Order by Rpn - orders the rows according to the RPN values.
• Order by Severity - orders the rows according to the severity values.
• Order by Detection - orders the rows according to the detection values.
Related Topics
FMEA Editor (Capital SimCertify) Editing and Appending an FMEA Report
Header of FMEA Report Printing an FMEA Report
Exporting an FMEA Report Simulating a Record
Menu Bar Contents
Related Topics
FMEA Editor (Capital SimCertify) Editing and Appending an FMEA Report
Header of FMEA Report “Viewing the FMEA Report” on page 72
Exporting an FMEA Report Simulating a Record
Menu Bar Contents
Procedure
1. Select File > Export from the menu of the FMEA Editor. This will invoke the Export
FMEA dialog where the desired selection can be made.
2. After selecting the export you require and clicking the Next button, you can select the
orientation of the export:
o Function: all the failures which cause each function to fail or be archived
unexpectedly are grouped together. Within each function, the failures will be
ordered in the specified sort order.
o Failure: list the failures in the specified sort order.
o Effect: all the failures which have the same effect are grouped together. Within each
function, the failures will be ordered in the specified sort order.
o Symptom: all the failures which have the same symptom are grouped together. This
is useful for diagnositics.
3. The sort order for the export must also be selected:
o rpn (highest rpn number first - descending)
o severity (highest rpn number first - descending)
o name (component name in alphabetical order - ascending)
o failure (component failure in alphabetical order - ascending)
4. After selecting the orientation and the sort order, clicking the Next button allows the
engineer to select the where the exported file will be placed.
5. Using the Browse button, the name and location of the exported file can be specified.
6. Clicking the Next button will now export the file.
7. Click Close to finish.
Note
The FMEAplus export will only work on FMEA reports opened from the FMEA Tool
(see “Overview of Capital SimCertify” on page 79). This is because additional
information is required (like the FunctionModel attached to the Subsystem) that is only
available there. Other exports will work on FMEA reports saved outside the FMEA Tool
but some information may be missing (like the event sequence information). It is,
therefore, recommended that all exports of FMEA reports generated by Capital Analysis
be done via the FMEA Tool.
For FMEA reports generated by hand, the FMEAplus export will also fail. All other
exports will work, however.
In failure orientation, all the failures will appear in the exported file even if they have no
effect on the schematic (they do not result in an functions being achieved unexpectedly or
spontaneously). Such failures will have an RPN of 1 (as the occurrence, severity and
detectability values will be set to one). Ordering by RPN will therefore place these
failures at the end of the FMEA.
In function orientation, those the failures that do not have an effect on the schematic will
not appear in the exported file.
Related Topics
FMEA Editor (Capital SimCertify) Editing and Appending an FMEA Report
Header of FMEA Report Viewing the FMEA Report
Printing an FMEA Report Simulating a Record
Menu Bar Contents
Simulating a Record
It is quite possible that engineers analyzing a FMEA report will find it useful to have a facility
where a specific record in the report can be simulated.
Procedure
1. Select the FMEA report record by clicking on it.
2. Select the View > Simulate Record.... The Simulate FMEA Record window is
displayed.
The window presents the information summarized in the record in a more detailed way.
The top section of the window has the toolbar and the potential failure cause together
with the RPN information.
The text frame in the center of the window shows the individual steps of the scenario,
together with the expected functions and the actual functions that were achieved at each
step.
3. The engineer can then:
o Select one of the event lines.
o Select to view the expected or actual simulation.
o Click the button to view the colored simulation in the Ecad tool.
Note
The results of the analysis will vary according to whether the original simulation was run
with Robust Netlisting enabled. Refer to “Robust Netlisting” on page 41 for more
information.
Related Topics
FMEA Editor (Capital SimCertify) Editing and Appending an FMEA Report
Header of FMEA Report Viewing the FMEA Report
Printing an FMEA Report Exporting an FMEA Report
Menu Bar Contents
File Menu
• New - creates a new report.
• Open... - opens a chooser to load a saved report (see “Open/Save Object Dialog” on
page 265).
• Save - saves the current report.
• Save As... - opens a chooser to save the report as another object (see “Open/Save Object
Dialog” on page 265).
• Import... - imports a report from a file (.xsql file)
• Export... - exports the report to a file (see “Exporting an FMEA Report” on page 73).
• Close - closes the current report.
• Exit - exits the FMEA editor.
Edit Menu
• Cut - cuts the selected row.
• Copy - copies the selected row.
• Paste - pastes the selected row.
• Add row - adds a new row below the selected line. See “Editing and Appending an
FMEA Report” on page 70 for more information.
• Delete row - deletes selected row from the report. See “Editing and Appending an
FMEA Report” on page 70 for more information.
• Edit Header... - allows the engineer to edit the header file of the report (see “Header of
FMEA Report” on page 71).
• Options... - opens the edit options dialog. See“Edit Options Dialog” on page 269 for
more information.
View Menu
• Reload FMEA - reloads the FMEA report discarding the changes that have been made.
• Filter results - opens a dialog allowing the engineer to filter the results (see “Filtering
the Results” on page 72).
• Remove filter - removes any filter that is currently on the results.
• Simulate Record... - simulates the selected record (see “Simulating a Record” on
page 75).
Order Menu
• Default Order - shows the rows in the order they were created.
• Order by Name - orders the rows alphabetically according to the name column.
• Order by Failure - orders the rows alphabetically according to the failure column.
• Order by Occurrence - orders the rows according to the Occurrence values.
• Order by Rpn - orders the rows according to the RPN values.
• Order by Severity - orders the rows according to the severity values.
• Order by Detection - orders the rows according to the detection values.
See “Ordering the Results” on page 72 for more information about ordering the report.
Related Topics
FMEA Editor (Capital SimCertify) Editing and Appending an FMEA Report
Header of FMEA Report Viewing the FMEA Report
Printing an FMEA Report Exporting an FMEA Report
Simulating a Record
This chapter details Capital SimCertify and the FMEA Scenario Tool, which are used when
running an FMEA using the Capital Analysis system.
Overview of Capital SimCertify . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 79
Capital SimCertify Menus . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 80
Creating FMEA Scenarios . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 81
Unresolved Scenario Builder . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 84
Confirm Event Delete Dialog Box . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 84
Edit Description Dialog Box . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 85
FMEA Scenario Dialog Box . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 85
Insert Combination Dialog Box . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 86
Insert Component Dialog . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 87
Run Scenario Wizard . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 87
Simulate FMEA Record Dialog . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 89
Note
If you have Robust Netlisting enabled, a message will be displayed to inform you that the
results displayed may differ from those expected. Refer to “Robust Netlisting” on
page 41 for more information.
4. Create a new scenario (this step is only required if you have not created a scenario
already or do not wish to use an existing scenario.
5. Run the selected scenario.
6. View the resultant FMEA report (this step can be done at any time after the creation of
the report).
Note
If the analysis scope is a topology and wiring synthesis has been performed, then a
additional dialog will appear when starting the FMEA tool requesting the configuration to
analyze. Select one from the list.
runs the selected scenario (see “FMEA Scenario Dialog Box” on page 85).
creates a new scenario (see “FMEA Scenario Dialog Box” on page 85).
edits the selected scenario (see “FMEA Scenario Dialog Box” on page 85) or FMEA
report (see “FMEA Editor (Capital SimCertify)” on page 69).
deletes the selected scenario (see “FMEA Scenario Dialog Box” on page 85) or
FMEA report (see “FMEA Editor (Capital SimCertify)” on page 69).
creates a new scenario (see “FMEA Scenario Dialog Box” on page 85) based on
those failures that could not be done in the selected FMEA report (see “FMEA Editor
(Capital SimCertify)” on page 69).
Related Topics
Scoping Creating FMEA Scenarios
Run Scenario Wizard Unresolved Scenario Builder
Capital SimCertify Menus Viewing the FMEA Report
File Menu
New Scenario: Invokes the FMEA Scenario tool to allow a new scenario to be defined. This
option is also available as a tool button .
Run Scenario: Runs automated analysis on the highlighted scenario. This option is also
available as a tool button .
Edit Menu
Edit: Edits the selected object. In the case of an FMEA scenario it invokes the FMEA Scenario
tool with the scenario loaded, and in the case of an FMEA report it invokes the FMEA editor
with the report loaded. This option is also available as a tool button .
Delete: Delete the selected object. This option is also available as a tool button .
Edit Description: Invokes a dialog to allow the description of the selected object to be edited.
Incremental FMEA: Compares two selected FMEA reports putting the differences in a third
FMEA report.
Resume FMEA: If an FMEA report generation operation fails or is cancelled, this menu entry
will attempt to restart the generation of the FMEA report. By selecting a failed/cancelled FMEA
report and click this menu entry, the failures that were not done will be applied.
View Menu
Netlist Errors: This window will view the errors produced in creating a netlist. If you are
denied the ability to create a Qualitative or Spice FMEA report, this option will explain why.
Related Topics
Overview of Capital SimCertify Creating FMEA Scenarios
Run Scenario Wizard
The FMEA Scenario Tool can be invoked in several ways once a scenario has been defined and
run. At present the headlamp circuit has not had any analysis carried out so the FMEA Scenario
tool has to be invoked by clicking the "New Scenario" button on the tool bar of the Capital
SimCertify window.
When the FMEA Scenario Tool window is first invoked, it displays all the switch and sensor
components set to their default positions. To change the initial state of a switch or sensor, click
on the text to highlight it. Not only will the text become highlighted but a gray box containing a
triangle will appear, indicating a pick list is available. Clicking on the triangle will display all
the available starting positions for that specific switch or sensor enabling the engineer to select
the desired starting position.
This is done by defining a series of events, with each event consisting of one or more changes.
Now a new event has been created, it is possible to specify when it occurs. It is possible to allow
the event to occur when the simulation has settled by checking upon Stabilization, or force the
event to occur at a specified time by entering a value in the After field.
Now components can be added to the event, click the "Insert Component" button to invoke the
Insert component dialog. This allows the engineer to choose a component.
Components are selected by clicking on the text to highlight them and then clicking "Insert" to
add them to the scenario. Components are added in their default state under the highlighted
event. It is possible to use the Shift and Ctrl keys to select a number of components to be
inserted at once.
To change the position of a switch, click on the triangle in the gray box and make a selection
from the pick list that appears.
There is no limit to the number of events that a scenario can contain. The only limit is the
number of switches that can be changed in each event.
The Insert Combination button can be used to insert a number of events automatically. If you
click "Insert Combination" the Insert component window will open allowing you to select the
components to be inserted by clicking on the ticks and crosses. Once you have selected the
components you want, click "Insert" and Capital Analysis will insert all the possible
combinations for the components inputs (switches).
When the Components level is highlighted, pressing the "Select All" of the "Deselect All"
buttons will select all the failures or deselect all the failures.
It is also possible to select or deselect all failure modes for all components within a particular
folder. This is achieved by highlighting the relevant folder on the left by clicking on it and then
clicking the "Select All" or "Deselect All" buttons located below the failure modes on the right.
When the scenario is complete, clicking the "OK" button will add the scenario to the Capital
SimCertify window.
The description of the scenario can be edited by highlighting the scenario and then selecting
"Edit Description" from the Edit menu. A Edit description dialog will appear allowing the user
to edit the scenario's description.
Related Topics
“Overview of Capital SimCertify” on page 79
In the FMEA Tool, select an FMEA report and press the button. The Sub scenario
generator for scenario window will then open:
The first tab of this window will list all the failures that were unresolved. You can select these
failures in the same way you select failure modes of a scenario.
The second tab of this window allows other failures to be applied. You can select these failures
in the same way you select failure modes of a scenario. When the OK button is pressed you will
be asked for the name of the new scenario.
Related Topics
Overview of Capital SimCertify
Related Topics
Overview of Capital SimCertify Creating FMEA Scenarios
Related Topics
Overview of Capital SimCertify Creating FMEA Scenarios
Related Topics
Overview of Capital SimCertify Creating FMEA Scenarios
Fields
Table 6-4. Insert Combination Dialog Box Contents
Field Description
Insert Click to to insert the combination into the event sequence.
Cancel Click to make no changes.
Related Topics
Overview of Capital SimCertify Creating FMEA Scenarios
Related Topics
Overview of Capital SimCertify Creating FMEA Scenarios
FMEA runs are noted as “queued” in the Capital SimCertify until the FEM processing
has finished. During this time no actions are permitted on the design or parent scenario.
Once the FMEA run completes
7. Finally enter a description of the FMEA report you wish to create.
8. Click Run to initiate the action. This opens a progress dialog box.
9. Clicking Stop will stop the FMEA running but not delete what it has already processed.
The results that have been processed will be opened in the FMEA Editor. To continue a
FMEA that has been stopped, highlight it in Capital SimCertify window and select
Resume FMEA from the Edit menu.
Advanced Functionality (Capital SimCertify)
Checking the 'Enable advanced functionality' checkbox on the first page of the wizard adds a
number of pages to the wizard.
• Power nodes for failure application, see “Power Node” on page 46 for more detail on
power nodes.
• Numeric simulation overrides, see “Overrides” on page 45 for more detail on numeric
simulation overrides.
• Component Parameters modification, see “Component Parameters” on page 44 for more
detail on component parameters.
Related Topics
Overview of Capital SimCertify Creating FMEA Scenarios
Capital SimCertify Menus Object Manager
The next section of the window displays the potential failure cause together with the RPN
information.
The text frame in the center of the window shows the individual steps of the scenario, together
with the expected functions and the actual functions that were achieved at each step.
To view an event
Note
The results of the simulation may vary according to whether the original simulation was
run with Robust Netlisting enabled. Refer to “Robust Netlisting” on page 41 for more
information.
Related Topics
Overview of Capital SimCertify Creating FMEA Scenarios
In order for Capital Analysis to be able to generate meaningful SCA and FMEA reports for an
electrical system, it needs to know what the functions of the system are, when they are active,
and the legal input conditions for an output condition. Capital SimProject and analysis projects
help us achieve this.This chapter details Capital SimCertify and the FMEA Scenario Tool,
which are used when running an FMEA using the Capital Analysis system.
Overview of Capital SimProject . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 91
Features. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 92
Output Functions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 92
Control Functions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 95
Creating a Project . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 98
Menus . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 101
1. Creating the analysis project - Using Capital SimProject to build the analysis project
structure (see “Creating a Project” on page 98).
2. Assigning the analysis project to a Capital project - Assigning the analysis project to the
Capital ECAD environment (see “Assigning a Project” on page 245).
3. Attaching functions - Define the relationship between project functions and the devices
in the ECAD environment (see “Attaching Component Models” on page 199).
Related Topics
Creating a Project Assigning a Project
Attaching Component Models Features
Output Functions Control Functions
Features
A feature in an automotive context may be a window system. In the platform builder it appears
under the 'Product' root folder.
A product can have one or more features, and a feature can be made up of a number of sub-
features.
Related Topics
Creating a Project Assigning a Project
Attaching Component Models Control Functions
Output Functions
Output Functions
An output function a high level condition of a system or sub-system. It used for reporting on the
state of a system during analysis. It makes testing and generation of functional analysis possible
by simulation. It is the output functions that are reported in the Simulator, FMEA reports, SCA
reports and script reports.
The output function text or label will be reported by the analysis tool indicating it's state. For
each output function there are further fields that are used for FMEA reporting.
For each output function, severity and detection values need to be assigned. There will be 2
severity values and 2 detection values for each output function. These are for when the output
function fails to happen (failure), and for when the output function is achieved when it should
not have been (spontaneous). A short explanation of the effects for each case is also required.
This information should be entered in the bottom section of the SimProject window. To assist
the entry of the severity and detection values a pick list is provided for each entry required.
These are accessed by clicking on the small triangles next to the default values. There is also a
text frame provided for the explanation of the effects. Remember this information must be
entered for each output function and in each case will only apply to the output function that is
highlighted.
When the create output function button is clicked a new output function is created as a sub
folder of the highlighted function, but this time the highlighted output function (the parent
output function) has a gray box next to it highlighting the word "And". This is the default
logical operator. Clicking on the gray box will display a pick list of all the available operators.
The parent function's icon will also change to , denoting that it has child objects.
The figure below shows a output functions of a headlamp circuit with the pick list of available
operators displayed.
In the figure above, the main_beam output function has two child output functions.
Left_main_beam and right_main_beam with the "And" logical operator selected. This means
that if the main_beam function is to be achieved, the left_main_beam function and the
right_main_beam function both have to be achieved.
• And (logical AND) All child output functions must be achieved for the parent function
to be achieved.
• Or (logical OR) The parent output function is determined as being achieved regardless
of the number of child output functions achieved, as long as there is at least one.
• Xor (Exclusive Or) Any single child output function must be achieved for the parent
output function to be achieved, but not more than one.
• Equivalent (Temporal Or) if any of this functions children are achieved at any time
during a simulation, then this parent output function is achieved.
• Strict Sequence For the parent output function to be achieved, the child output
functions must be achieved in the order defined.
• Loose Sequence The parent output function is determined as being achieved as long as
all child output functions are achieved, regardless of order.
It should be noted that the Equivalent operator can only be present at the top level (it cannot be
a child of another function label). This restriction may be lifted in a future version of Capital
Analysis. An example use for this operator is a wash_wipe function that has two children
fast_wipe and slow_wipe. By using the Equivalent operator, as long as a fast_wipe or a
slow_wipe appears at any time in the Event Sequence Tab, the wash_wipe function will be
achieved.
If you copy an output function and then paste it as a child output function the following dialog
will open asking you if you want to create a Copy or a Clone of the output function. A copied
output function will be a new individual output function with the same data in it as in the
original and it will be given a new label. A cloned output function will not be a new output
function but an imitating copy of the original with the same label as the original.
Related Topics
Creating a Project Assigning a Project
Attaching Component Models Control Functions
Features Capital SimProject
Control Functions
As mentioned, a control function is usually associated with a switch condition in a particular
state or position, 'window switch up', for example. Control functions are required so that SCA
can be performed. When running SCA, Capital Analysis will be looking at output conditions
(output functions) of the system and checking against inputs conditions (control functions). If
an illegal set of input conditions results in an output then this will be reported in the SCA report.
So this means we need to represent the input conditions (control functions) and the relationships
with the outputs (output functions).
This is done by selecting output functions in SimProject, and selecting Edit > Create Control
to add a control function. A controlled by folder is automatically inserted, containing control
functions. The output functions icon will also change to denoting that it has some contents.
A given output condition may require several input conditions to be present at once, so further
control functions can be added.
The 'Controlled by folder' allows the logical relationship to be set between an output function
and it's valid input conditions. In the image above, we can see the 'And' operator. By double
clicking on the 'Controlled by' folder you can set this operator from the drop-down that appears.
There are also cases where you would like to say, not this input state. To achieve this logical
condition, control functions can be added to an 'Excluding' group, this is done by selecting the
'Controlled by' folder and selecting Edit > Create Not Group.
Control functions can now be added to the 'Excluding' group. Do this by selecting the
'Excluding' folder and then adding control functions in the usual way. If more that one control
function has been added to the Exclude group then the same logical relationship between the
control functions in the group can be set by double clicking on the 'Excluding' group and
selecting the logical operator. The available operators are as described above.
Related Topics
Creating a Project Assigning a Project
Attaching Component Models Output Functions
Features Capital SimProject
Creating a Project
In order to create or edit an analysis project, start Capital SimProject. The project is built using
this tool. Do this by pressing Space Bar and entering SimProject.
Once SimProject is open, you can configure the following:
Procedure
1. Select the root folder in SimProject.
2. Select Edit > Create Feature from SimProject's menubar.
3. Edit the feature name by double-clicking on it.
4. Fill in the 'Feature description' field (optional step)
5. Fill in 'URI' field (optional step).
To create child feature, select an existing feature, instead of the root folder at step 1.
Procedure
1. Select the feature that you would like to add output functions to.
2. Select Edit > Create Function, to add an output function.
3. Edit the function name by double-clicking on it.
4. Set the 'Failure' 'Sev.', 'Det' and 'Potential Failure Effect' fields.
5. Repeat the above step for 'Spontaneous' and the respective fields.
You can also create child functions, do this by selecting an output function in step 1 instead of a
feature.
If you are adding further child functions to a single parent, the relationship between the parent
being achieved as a result of child functions occurring should be defined. To do this, double
click on the parent output function, and select an operator from the drop down list on the right-
hand-side.
Procedure
1. Select an output function.
2. Select Edit > Create Control to add a control function.
3. Edit the function name by double-clicking on it.
If you add further control functions to an output function, then you must define the a
relationship between the control functions and the output function. To do this double click on
the 'Controlled by' level that has been added as a result of adding control functions, select from
the logical operators available.
You can also add child control functions, to do this select a control function, instead of a output
function at step 1 above.
Procedure
1. Select the output function, or Controlled by group to add the 'Exclude' group to.
2. Select Edit > Create Not Group.
3. Select the 'Excluding' folder.
Add control functions as described above, except step 1 is ignored
If several control functions are added to the 'Excluding' group, the logical relationship between
them can be set by double clicking on the 'Excluding folder', and selecting the operator from the
drop-down.
Procedure
1. Select File > Save from the menubar in Capital SimProject.
2. Enter the location and name for the analysis project.
3. Click 'Save'.
Related Topics
Creating a Project Assigning a Project
Control Functions Output Functions
Features Capital SimProject
Menus
The SimProject window has 4 menus available to the user: File, Edit, Tools and Help.
File Menu
• New: Create a new analysis project. This option is also available as a tool button .
• Open: Open an existing analysis project. This option is also available as a tool button
. This will invoke a chooser dialog (see “Open/Save Object Dialog” on page 265).
• Save: Save the analysis project under the same name. If it is a new analysis project and
has not been saved before, selecting this option will cause the “Save As” option to be
invoked. This option is also available as a tool button .
• Save As...: Save the analysis project under a different name. This will invoke a chooser
dialog (see “Open/Save Object Dialog” on page 265).
• Merge: This option allows you to merge the functions of another selected analysis
project into the current analysis project.
• Print: Prints all the project information.
• Print Preview: Opens a window that displays the page format and allows you to change
the printer settings.
• Import...: This option allows analysis project to be imported from the file system. See
“System Import/Export” on page 327.
• Export...: This option allows the analysis project to be exported to the file system. See
“System Import/Export” on page 327.
• Exit: Exit the SimProject tool.
Edit Menu
• Edit Function Name: Allows the user to edit the name of the highlighted function.
• Create Function: Creates a new output function . This option is also available as a tool
button .
• Create Control: Creates a new control function. This option is also available as a tool
button .
• Create Feature: Creates a new feature. This option is also available as a tool button
.
• Create Not Group: Creates an excluding group for control functions. This option is
also available as a tool button .
• Move Up: Moves the selected function up in the list. This option is also available as a
tool button .
• Move Down: Moves the selected function down in the list. This option is also available
as a tool button .
• Cut: Removes the selected object and places it on the clipboard. This option is also
available on a tool button .
• Copy: Copy the selected object to the clipboard. This option is also available on a tool
button .
• Paste: Paste the contents of the clip board. This option is also available on a tool button
.
• Delete: Delete the selected function. This option is also available on a tool button .
• Options: Gives the user access to the Capital Analysis user definable options. See “Edit
Options Dialog” on page 269 for more details.
Tools Menu
• Check Integrity: Checks the object for correctness in terms of syntax, required fields
and reports this.
Related Topics
“Capital SimProject” on page 91
This facility is an optional module for Capital Analysis. Its user interface appears in the
Overview of Simulator Tool and allows scripts to be constructed and run that test the operation
of the circuit. These scripts can be saved and run on different versions of the circuit. These
scripts can change switch settings and set failure modes to components. Test points can be
monitored and timing information can be included in the script. The results of running a script
are written to a file in xml format.
Overview of Capital SimScript . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 103
Capital SimScript Reports . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 104
Creating a Script . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 107
Script File Format . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 108
Using a Script File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 118
Override File. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 119
• Input Script - This is the file that contains the script which you wish to execute, for
details on the format and language constructs available, see “Script File Format” on
page 108.
• Output Results - As well as the generation of interactively explore-able scripts (see
“Capital SimScript Reports” on page 104), the scripting tool generates an XML file
which can be parsed by an external application to translate the results into those required
by your process. The file format is defined in an XML dtd.
• Run Area - This area allows you to specify the simulation parameters for the script.
You can set three key parameters. The first is the Start time, this is the point in time at
which script results should start to be recorded. The second parameter specifies an
absolute Stop time for the script. This is only used if the script has not already reached
its final state by this time. Finally, the Sample time parameter controls how frequently
the simulation state is recorded to the XML file (in simulation time).
Note
The Variable Time Steps option, available when running a numeric simulation, allows
the Simulator to “decide” when samples should be taken. This will result in the Sample
time parameter being ignored; instead, the system will detect changes in the result set and
increase the sample rate to capture the information needed.
Related Topics
Creating a Script Using a Script File
Script File Format Overview of Simulator Tool
Capital SimScript Reports Performing a Script Analysis
Procedure
1. Create script file. See “Creating a Script” on page 107.
2. Set up and run the analysis. “Using a Script File” on page 118.
3. Explore and examine the results. “Capital SimScript Reports” on page 104.
Note
Simulate and Reset buttons do not apply to the Scripted test pane of the Simulator.
Related Topics
Creating a Script Using a Script File
Script File Format Overview of Simulator Tool
Capital SimScript Reports
• Ecad Devices & Properties – A complete list of all components in the simulation, and
the properties that were passed to the simulation model from the ECAD tool at the start
of the simulation.
• Result Set – One or more result sets (depending on how many analyses were executed
within the script). Result sets are broken down into Functions, Component Variables
and Component Properties. See “Filter the Results” on page 105 for information on
working with the report output.
• Console output – The console output generated while running the script.
• Error – Any error messages generated by the Capital SimScript during simulation.
The right-hand pane displays the results for the user selection.
Note
If no wildcards are used, the search string is case-insensitive and will match any string
that contains the expression. If any wildcards are used, the search string is case-sensitive,
and will match any string that starts with the expression.
• Columns can be repositioned within the report. To move a column, click on the column
name and drag it to the new position.
• When viewing Component Variables or Component Properties, click the button
to toggle the display of components within the data.
• When viewing Component Variables or Component Properties, toggle the display of
internal and external nodes by clicking the 3-way button; the following modes are
available:
o - all nodes are displayed
o - no nodes are displayed
o - only external nodes are displayed
• When viewing Component Variables, click the button to toggle the display of arcs
within the data.
• The report data can be sorted on a single column.
o Click a column header once to sort on that column in ascending order (indicated by
an up-arrow icon).
o Click the column header again to sort in descending order (indicated by a down-
arrow).
o Click a third time to remove the sorting.
Sorting is applied according to the type of data displayed in the column:
o Integer and Real data types are sorted numerically.
o String data is sorted using a true alphanumeric sort, so any number groups within a
string are considered a single integer. For example, in an ascending sort, 1.3 is
placed before 1.22.
Functions Area
The functions achieved by the system being simulated are recorded at each sample step during
script execution. All functions are shown in the table on the right hand side, with its achieved
state (true if the function was being achieved, false if it was not) reported at each sample step.
Creating a Script
After selecting the 'Create new script' button, from the Simulator, the script editor will be
displayed.
There are several operations available on the toolbar:
• The button will paste the text in the clipboard into the editor.
• The button will check the script you have entered for syntax errors.
Script files usually have the following sections:
• Scenarios - this section defines the initial states of the switches in the schematic.
• Monitoring - this section indicates which components of the schematic you wish to
monitor the changes of.
• Multiple runs of defined scenarios.
For a worked example for the radio_sneak example schematic, see“Script File Format” on
page 108.
Note
When the script is complete, use the button to check it.
Related Topics
Capital SimScript Using a Script File
Script File Format Overview of Simulator Tool
Capital SimScript Reports
at 130ms
do
design.setProperty("DRV_DOOR_SWTCH", "position", "open");
design.setProperty("IGN_SWTCH", "position", "closed");
design.setProperty("INT_LAMP_OVRDE", "position", "closed");
design.setProperty("PAS_DOOR_SWTCH", "position", "open");
design.setProperty("RADIO", "radio_function", "on");
done;
at 140ms
do
design.setProperty("RADIO", "radio_function", "off");
done;
at 150ms
do
design.setProperty("DRV_DOOR_SWTCH", "position", "open");
design.setProperty("IGN_SWTCH", "position", "closed");
design.setProperty("INT_LAMP_OVRDE", "position", "closed");
design.setProperty("PAS_DOOR_SWTCH", "position", "closed");
design.setProperty("RADIO", "radio_function", "on");
design.setFailure("DRV_DOOR_SWTCH", "Switch stuck closed");
done;
at 160ms
do
design.setProperty("RADIO", "radio_function", "off");
done;
at 170ms
do
design.setProperty("DRV_DOOR_SWTCH", "position", "closed");
design.setProperty("IGN_SWTCH", "position", "open");
design.setProperty("INT_LAMP_OVRDE", "position", "open");
design.setProperty("PAS_DOOR_SWTCH", "position", "open");
design.setProperty("RADIO", "radio_function", "on");
done;
at 180ms
do
design.setProperty("RADIO", "radio_function", "off");
design.unsetFailure("DRV_DOOR_SWTCH");
done;
at 190ms
do
design.setProperty("DRV_DOOR_SWTCH", "position", "closed");
design.setProperty("IGN_SWTCH", "position", "open");
design.setProperty("INT_LAMP_OVRDE", "position", "open");
design.setProperty("PAS_DOOR_SWTCH", "position", "closed");
design.setProperty("RADIO", "radio_function", "on");
done;
at 200ms
do
design.setProperty("RADIO", "radio_function", "off");
done;
at 210ms
do
design.setProperty("DRV_DOOR_SWTCH", "position", "closed");
design.setProperty("IGN_SWTCH", "position", "open");
design.setProperty("INT_LAMP_OVRDE", "position", "closed");
design.setProperty("PAS_DOOR_SWTCH", "position", "open");
design.setProperty("RADIO", "radio_function", "on");
design.setFailure("DRV_INT_LAMP", "open circuit");
done;
at 220ms
do
design.setProperty("RADIO", "radio_function", "off");
done;
at 230ms
do
design.setProperty("DRV_DOOR_SWTCH", "position", "closed");
design.setProperty("IGN_SWTCH", "position", "open");
design.setProperty("INT_LAMP_OVRDE", "position", "closed");
design.setProperty("PAS_DOOR_SWTCH", "position", "closed");
design.setProperty("RADIO", "radio_function", "on");
done;
at 240ms
do
design.setProperty("RADIO", "radio_function", "off");
design.unsetFailure("DRV_INT_LAMP");
done;
at 250ms
do
design.setProperty("DRV_DOOR_SWTCH", "position", "closed");
design.setProperty("IGN_SWTCH", "position", "closed");
design.setProperty("INT_LAMP_OVRDE", "position", "open");
design.setProperty("PAS_DOOR_SWTCH", "position", "open");
design.setProperty("RADIO", "radio_function", "on");
done;
at 260ms
do
design.setProperty("RADIO", "radio_function", "off");
done;
at 270ms
do
design.setProperty("DRV_DOOR_SWTCH", "position", "closed");
design.setProperty("IGN_SWTCH", "position", "closed");
design.setProperty("INT_LAMP_OVRDE", "position", "open");
design.setProperty("PAS_DOOR_SWTCH", "position", "closed");
design.setProperty("RADIO", "radio_function", "on");
design.setFailure("IGN_RELAY", "Coil burnt out");
done;
at 280ms
do
design.setProperty("RADIO", "radio_function", "off");
done;
at 290ms
do
design.setProperty("DRV_DOOR_SWTCH", "position", "closed");
design.setProperty("IGN_SWTCH", "position", "closed");
design.setProperty("INT_LAMP_OVRDE", "position", "closed");
design.setProperty("PAS_DOOR_SWTCH", "position", "open");
design.setProperty("RADIO", "radio_function", "on");
done;
at 300ms
do
design.setProperty("RADIO", "radio_function", "off");
design.unsetFailure("IGN_RELAY");
done;
at 310ms
do
Scripts use a sub-set of the SAINT modeling language, for further information on the syntax
and object available for use in a script, please consult the SAINT: Behavior Modeling Language
guide.
Scenario Commands
• scenario
This command is used to identify a sequence of actions as being part of a scenario. The
basic structure is:
scenario "name" do ... done;
The "name" portion should be replaced by a string that meaningfully captures the
purpose of the scenario. All event commands between the do and done form the
sequence of actions that make up the scenario.
• at
This command is used to specify a set of actions to occur at a specific point in time
during the execution of a scenario. The basic structure is:
at time unit do ... done;
• if ... then ... elseif ... then ... else ... endif;
'if then else' program control constructs, form:
if <conditional>
then
....
elseif <conditional>
then
...
else
....
endif;
• break
'break' is used to break out of a loop
break;
• continue
continue is used to stop in a for loop and return back to the top of the for loop.
continue;
• return
'return' is used to exit out of a function, and return a value specified by the function type.
Its form is:
return;
• print
Print is used to print messages to the console Its form is:
print "...";
• renames
• design.analyze
By calling design.analyze(); a scenario will be executed on the local machine. The
format of the command is:
design.analyze("scenario_name");
The analyze() method has now been extended to do an exploration of selected switch
positions & all the failures being considered. The switch positions that will be explored
are selected inversely by the user (the user indicates those switches that will be held at
given values - see the hold() method). The form in this case is:
design.analyze();
• design.setProperty
This command allows you to (within an at do...done block) to change the value of an
input property on a component, the format of the command is:his command allows you
to (within an at do...done block) to change the value of an input property on a
component, the format of the command is:
design.setProperty("component_name", "property", "value");
It should be noted that errors will be generated if the components, properties, or values
do not exist.
• design.setFailure
setFailure changes the current failure mode of the component. The format of the
command is:
design.setFailure("component_name", "failure mode ");
Setting a failure will override any current failure that is set on that component.
• design.unsetFailure
unsetFailure unsets the current failure mode of the component, restoring it to its default
behavior. The format of the command is:
design.unsetFailure("DRV_DOOR_SWTCH");
• design.open
This will open a new design to analyze.
Note that this will also clear all the considered failures.
design.open("databasepath/subsystem", "simulation mode");
• design.setOutput
The setOutput method will override the output filename to write to.
Note that this will also clear all the monitored properties.
design.setOutput("output file name");
• design.isOutputAlreadyPresent
This method can be used to test if an output file exists and act accordingly. It's use is in a
conditional statement and will return true of false. Its form is:
design.isOutputAlreadyPresent()
• design.setStartTime
This method can be used to override the transient setting for start time:
design.setStartTime("time");
• design.setSampleTime
This method can be used to override the transient setting for sample time:
design.setSampleTime("time");
• design.setStopTime
This method can be used to override the transient setting for stop time:
design.setStopTime("time");
• design.consider
This method is used in conjunction with the analyze() method. It creates a list of failures
to be considered during the analysis.
design.consider("<category>", "<component>", "<failure>");
design.consider("<category>", "<component>");
design.consider("<category>");
• design.resetAll
design.resetAllesign.resetAll takes no parameters, and resets the designs failure modes,
state and resets all component properties to default settings. The format of the command
is:
design.resetAll();
• design.monitor
This command allows you to specify one or more components whose properties you
wish to record into the results output file.
design.monitor("category", "component", "property");
design.monitor("category", "component");
design.monitor("category");
where any of the above parameters can include regular expressions. The monitoring will
not be applied until the next invocation of design.analyze().
• design.getComponent
This command allows you to access a component within a design.
component aFuse := design.getComponent("FUSE1");
if (aFuse.isValid())
then
print "Found a fuse";
endif;
For further information on methods available in SAINT for component objects please
see the SAINT: Behavior Modeling Language guide.
• design.getComponents
This command allows you to get an array of all components in a design:
component allComponents[] := design.getComponents();
For further information on methods available in SAINT for component objects please
see the SAINT: Behavior Modeling Language guide.
• design.getNumberOfComponents
This command allow you to get a count of all components in a design:his command
allow you to get a count of all components in a design:
int compCount := design.getNumberOfComponents();
For further information on methods available in SAINT for component objects please
see the SAINT: Behavior Modeling Language guide.
• design.override
This command allows you to link to an external override file as the script is run,
overwriting default component properties values:his command allows you to link to an
external override file as the script is run, overwriting default component properties
values:
design.override ("<path\filename>.xml");
For further information on the use of override files, see “Override File” on page 119.
Related Topics
Capital SimScript Using a Script File
Creating a Script Overview of Simulator Tool
Capital SimScript Reports Override File
Procedure
1. In the Input Script area, you can either specify the script you have created using the
button, or create a new script using the button and follow the instructions under
“Creating a Script” on page 107.
2. In the Output Results area, specify a location for the results to be stored to.
3. In the Run area, set the start time (in simulation time) for the start of results recording.
Please note that this is not the time that simulation will begin, but the first instant that
results will be recorded.
4. In the 'Run' panel set the resolution. This specifies how frequently (in simulation time)
the results are recorded to file.
5. In the 'Run' panel, set the stop time. This specifies the point at which results recording
should stop (in simulation time). Note that the simulation itself may continue beyond
this point, but no further results will be captured in the output XML file.
6. Set the simulation technology to be used (Qualitative or Numeric), and transient if
required.
7. In the 'Run' panel, check the 'Variable step' check box if variable time steps are required
for transient simulation.
8. In the 'Run' panel click on the Run button to execute the selected script with the
specified parameters.
After the script has been run the schematic will be colored, and a several steps will be
shown in the bottom half of the Overview of Simulator Tool, each of these steps will
correspond to a design.analyze() call in the script.
Tip: You can run the analysis action as a background operation by checking the Run in
background option on the dialog box, see the Creating Audit Reports when Capital
Analysis Operations are in the Background topic in the Capital Design Tools -
Common Functions User Guide for further information. Running the analysis operation
in the background allows you to continue working on other analysis tasks knowing you
can open and interrogate the audit report at a convenient time.
Note
The script derived from loading a file will start from the current settings of the Overview
of Simulator Tool, so it is worthwhile ensuring that the initial state of the system is fully
defined. If no failures have been set or cancelled before the first RUN and the user was to
set a failure before running the file, the initial design.analyze() will include that
failure. Settings can also be changed in the Overview of Simulator Tool between running
parts of the file, including the running of additional steps. Note that any changes set in
this way will affect the state of the subsystem when running from the script, so if the user
cancels the failure after running the second step in the file above, it'll stay cancelled
unless it is reset before returning to the script.
Related Topics
Capital SimScript “Script File Format” on page 108
Creating a Script Overview of Simulator Tool
Capital SimScript Reports Override File
Override File
Capital SimScript allows you to import an XML file containing a number of component
property definitions, overriding property values assigned to components in the simCore
database as the script is run. The override is performed within the script, using the following
syntax:
design.override(“<path\filename>.xml”);
Note
A restricted number of characters are not supported by SAINT, hence the use of non-
alphanumeric characters should be avoided where possible. If a filename cannot be found
and contains invalid xml characters, when reported, the invalid characters will be
transformed to ? to prevent the xml parser reporting an error.
Note also that if you need to use ^ anywhere in a SAINT expression, including a
filename, it should be preceded by another ^. So, for example, "my^File.xml" must
become "my^^File.xml" when referenced in SAINT.
The file, which must be correctly formatted, as detailed below, contains details of component
property overrides and will, in effect, behave like a set of setProperty(<component>,
<property>, <value>) commands.
For example:
<overrideList>
<overrideComponent name="lamp_1">
<override property="lit" value="TRUE"/>
</overrideComponent>
</overrideList>
In this example, a component model for a lamp "lamp_1" has a property of "lit" - a Boolean
value - and this is set to TRUE by the override property command.
Error Handling
While running a script:
• if the specified file cannot be found, the Simulator shall continue running the script, and
no overrides shall be performed. A warning will be logged in the error section of the
results dialog.
• if the file exists but it isn't a valid overrides file, the Simulator will continue running the
script and no overrides shall be performed. A warning will be logged in the error section
of the results dialog.
• if the file exists and is valid but some of the components and properties aren't valid, the
Simulator will continue running the script and any valid overrides shall be done. A
warning will be logged in the error section of the results dialog; this will detail the
missing/incorrect component, property and value for file debugging purposes.
If, in the overrides file, more than one value is given for the same component and property, the
second value will be used. A warning, detailing the component, property, both values, and
which one will be used, will be logged in the errors section of the results dialog.
Sample1
<overrideList>
<overrideComponent name="myComponent1">
<override property="firstProperty" value="1234.5"/>
</overrideComponent>
<overrideComponent name="myComponent1">
<override property="secondProperty" value="ABCdef"/>
</overrideComponent>
<overrideComponent name="myComponent1">
<override property="thirdProperty" value="TRUE"/>
</overrideComponent>
<overrideComponent name="myComponent1">
<override property="fourthProperty" value="FALSE"/>
</overrideComponent>
</overrideList>
The override script above features four override property commands, each one overriding the
value of a different property (for example, the property "firstProperty" has its value set to
"1234.5"). The component "myComponent1" is referenced each time one of its properties is
overridden.
Sample2
<overrideList>
<overrideComponent name="myComponent1">
<override property="firstProperty" value="1234.5"/>
<override property="secondProperty" value="ABCdef"/>
<override property="thirdProperty" value="TRUE"/>
</overrideComponent>
<overrideComponent name="myComponent2">
<override property="firstProperty" value="6789"/>
<override property="secondProperty" value="GHIjkl"/>
<override property="thirdProperty" value="FALSE"/>
</overrideComponent>
<overrideComponent name="myComponent3">
<override property="firstProperty" value="5432.1"/>
<override property="secondProperty" value="TRUE"/>
</overrideComponent>
</overrideList>
The override script above first references a component "myComponent1" before invoking three
override property commands, overriding the three properties belonging to it. Next, a second
component is referenced ("myComponent2"), which also has three properties overridden.
Finally, a third component ("myComponent3") is referenced and its two properties are
overridden.
Sample3
<overrideList>
<overrideComponent name="myComponent1">
<override property="firstProperty" value="1234.5"/>
<override property="secondProperty" value="ABCdef"/>
<override property="thirdProperty" value="TRUE"/>
</overrideComponent>
<overrideComponent name="myComponent2">
<override property="firstProperty" value="5432"/>
<override property="secondProperty" value="GHIjkl"/>
<override property="thirdProperty" value="TRUE"/>
</overrideComponent>
<overrideComponent name="myComponent1">
<override property="fourthProperty" value="FALSE"/>
<override property="fifthProperty" value="6789"/>
</overrideComponent>
</overrideList>
The above script is similar to Sample 2, above, but demonstrates that you can have properties
for a single component defined in separate <overrideComponent> tags. The component
"myComponent1" has three property values overridden, then the component "myComponent2"
has three property values overridden. Finally, the script references the component
"myComponent1" a second time, then overrides two further properties.
Note
All these XML files are valid, however the second one, having least repetition, is
preferred.
Related Topics
Capital SimScript Script File Format
Creating a Script Overview of Simulator Tool
Capital SimScript Reports Using a Script File
The Capital Analysis sneak circuit analysis tool builds on the work done by the engineer in
producing an FMEA Report. Based on the 'Analysis Project', assigned to the Capital project, the
tool looks for unexpected output conditions (output functions) as a result of a set of input
conditions (control functions).
Overview of Capital SimProve . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 123
Creating an SCA Report . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 126
Exporting an SCA Report . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 128
Prune an SCA Report . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 128
SCA Report View. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 130
SCA Tool Menus . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 132
Related Topics
Creating an SCA Report SCA Report View
Exporting an SCA Report SCA Tool Menus
Scoping Performing an SCA Operation
Procedure
1. Create the analysis project / platform specification.
2. Associate the analysis project with the Capital project and devices.
3. Set the Analysis Scope.
4. Open Capital SimProve from the main menu. The following window will open. It will
be blank if no SCA report has been generated before.
See “Creating an SCA Report” on page 126 for instructions on creating an SCA report.
Note
If the analysis scope is a topology and wiring synthesis has been performed, then a
additional dialog will appear when starting Capital SimProve requesting the
configuration to analyze. Select one from the list.
When a SCA operation is run, the function and sneak expressions are evaluated for all the input
combinations and a number of concerns are identified.
• Sneaked functions are those functions that have been achieved according to the function
expression, but should not have been achieved according to the sneak expressions.
• Failed functions are those function that have not been achieved according to the function
expression, but should have been achieved according to the sneak expressions.
Below is an example of a sneaked function.
Related Topics
Creating an SCA Report SCA Report View
Procedure
1. Click the button and the SCA Wizard will open.
2. Read the instructions and select Next.
3. If you wish to capture details of the SimProve run, check the Create audit report
checkbox. This enables you to create an audit report preserving the configuration details
and results. The system offers a default name for the report which can change if
required.
The report can be used to study the design impact between SimProve run sessions to
improve design quality and provide traceability of the audit trail. The results of the audit
report can viewed on the Audit Report Tab, and also viewed and managed using the
Object Manager.
You can run the analysis action as a background operation by checking the Run in
background option on the dialog box, see the Creating Audit Reports when Capital
Analysis Operations are in the Background topic in the Capital Design Tools -
Common Functions User Guide for further information. Running the analysis
operation in the background allows you to continue working on other analysis tasks
knowing you can open and interrogate the audit report at a convenient time.
Note
Audit report generation is automatically selected whenever the Run in background
option is checked.
Once you have decided on your report and background run requirements, click Next.
4. Select the type of simulation radio button and click Next. The simulation technologies
that are enabled on this page will depend on what simulator modules are licensed and
whether you have configured an external simulator using Capital SimBridge (see
“Capital SimBridge” on page 155 for more information).
Check Use transient if transient mode should be used with the selected simulation type.
5. If Use transient is selected, an additional pane above will be displayed. You can specify
transient information:
• Start Time - The point in time that the analysis should start, this defaults to zero.
• Stop Time - The point in time when the simulation should finish.
• Sample Rate - How often the state of the simulated system should be sampled and
recorded.
• Variable Time Steps - This is a mode of operation of the numeric transient
simulator, where the simulation engine automatically determines the sample rate of
the results.
6. Select the input components you wish to exercise during the simulation. By default all
the input components will be used. Uncheck those that you wish to ignore and click
Next.
7. If you choose to ignore some components then the next step in the wizard will ask you
what settings you want to leave these input components with. If you select all the
components then you will not see this window.
8. If you would like to apply failure modes during the analysis, click on the Edit Failure
Modes button. In the dialog, use the Components tree to select the failure modes you
wish to analyze. By default none of the failures are selected.
9. Tick the tick box if you want to prune the results and then click Close to close the
wizard and start the SCA Analysis.
Use the Back and Next buttons to move backwards and forwards through the SCA
Wizard and the Cancel button to exit it at any point.
Related Topics
Prune an SCA Report SCA Report View
Exporting an SCA Report SCA Tool Menus
Scoping Overview of Capital SimProve
Related Topics
Prune an SCA Report SCA Report View
Exporting an SCA Report SCA Tool Menus
Scoping Overview of Capital SimProve
Creating an SCA Report
Procedure
1. Click the File > Export menu entry, the Export SneakReport window will now open.
2. Select the type of export file you which to create and press the Next button.
3. Select the ordering you require in the exported SCA report and click the Next button.
4. Select the filename and location where you want the exported file to be placed by using
the Browse button. The click the Next button.
5. After a few moments the SCA report will be exported.
Related Topics
Prune an SCA Report SCA Report View
Creating an SCA Report SCA Tool Menus
Scoping Overview of Capital SimProve
A report without pruning may have 2000 concerns in it which can be reduced to 85 real
concerns by using the pruning function. It is normal for pruning to reduce the number of
concerns by one or two orders of magnitude.
For example, consider a schematic which has 10 switches on it and has a sneak circuit which
only exists when 2 of the switches are in a certain combination regardless of the other 8 switch
positions. With pruning switched off the SCA report will generate a concern for every switch
combination which creates a sneak circuit, most of these concerns will be caused by the 8
switches' positions going through their various combinations when the 2 switches are in their
certain combination. If pruning is switched on then the results will analyzed by the pruning
function and all the concerns which are cause by the 2 switches being in a certain combination
will be reduced to one concern which just shows the 2 switches being in their certain
combination and the other 8 switches' positions not mattering.
Related Topics
Exporting an SCA Report SCA Report View
Concern View
In this view, the detected issues are ordered based on the switch setting that caused them. This
view is useful for deleting those concerns that no longer of interest to you. See the example
shown below
Function View
In this view, the concerns are ordered based on the functions the concern has effected. This
view is useful for determining which functions the concerns actually effect. There may be many
concerns but only one or two functions the concern effects. See the example shown below.
Type View
In this view, the concerns are ordered based on their type (sneak or failure). This view is useful
in determining the type of concerns detected. Are they all sneaks? See the example shown
below.
Related Topics
Exporting an SCA Report SCA Report View
Creating an SCA Report SCA Tool Menus
Scoping Overview of Capital SimProve
File menu
• Run SCA: run/rerun the SCA operation .
Edit menu
• Delete Concern: Delete the selected concern .
• Delete All Concerns: Delete all the concerns in the report.
View menu
• Concern view: view the results by the concern.
• Function view: view the results by function name.
• Type view: view the results by sneak failed functions.
• Goto page: opens a dialog to go to another page of concerns.
• Netlist Errors: opens the Error Report Dialog which shows messages produced during
the netlist.
• Color Components: if checked the components will be colored when the concern is
shown.
• Show Labels: if checked the labels will be shown when the circuit is colored.
Related Topics
Exporting an SCA Report SCA Report View
Creating an SCA Report SCA Tool Menus
Scoping Overview of Capital SimProve
The Capital SimStress performs a numerical analysis of your design and generates a results
table that contains results defined by a 'stress style'.
Overview of Capital SimStress . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 135
Defining Applied Current, Voltage and Power Algorithms. . . . . . . . . . . . . . . . . . . . . . . 146
Defining Stress Styles. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 147
The tool performs a simulation for each combination of inputs in the schematic, simulation
results are generated and the report populated in accordance to the stress style. For all reporting,
some special internal values (automatic properties) are available from the components and
wiring, namely max. 'applied current', max. 'applied voltage' and 'applied power' developed.
These values are generated by calculating the current and voltage power for each arc in the
component and then taking the arc's value that is highest. Power is calculated by summing the
power developed in each arc.
The 'automatic properties' are displayed in the basic stress style format supplied. The automatic
properties for voltage, current and power can also be overridden, see “Defining Applied
Current, Voltage and Power Algorithms” on page 146.
It is possible to define your own stress styles and report on any component output property, or
ECAD property. This enables the report to be specific, for example, wire sizing information
only. See “Defining Stress Styles” on page 147 for more information.
For wire sizing, the analysis is run using wire size information in the design (or system defaults
if unavailable). If the load on the wire exceeds its rating, then a suggested wire gauge is
displayed in the results.
It is also possible to perform sizing of other devices. Please check available tech-notes on sizing
specific devices.
Note
Upon launching Capital SimStress, if you have Robust Netlisting enabled, a message will
be displayed to inform you that the results displayed may differ from those expected.
Refer to “Robust Netlisting” on page 41 for more information.
Note
If you have Robust Netlisting enabled, a message will be displayed to inform you that the
results displayed may differ from those expected. Refer to “Robust Netlisting” on
page 41 for more information.
Capital SimStress can now be used to open and display previous reports or create new reports
using the Stress Analysis Wizard.
Note
If the analysis scope is a topology and wiring synthesis has been performed, then a
additional dialog will appear when starting the FMEA tool requesting the configuration to
analyze. Select one from the list.
Related Topics
Stress Analysis Wizard
Procedure
1. To start the wizard select File > Run Stress Analysis... from Capital SimStress.
2. In the first dialog, you can select a previously generated stress report to use the settings
from that to generate a new stress report. Click Next to continue. If you have selected a
previously generated stress report, skip to step 13. Otherwise, continue with step 4.
3. This step offers the option to create an audit report which allows you to preserve the
configuration details and results of your Stress Analysis run. Click the Create Audit
Report checkbox to enable the functionality. On selection the Name field is enabled,
allowing you to specify a report name, or accept the default entry offered.
The generated Audit Reports are available for viewing in the Audit folder in the Object
Manager.
You can run the analysis action as a background operation by checking the Run in
background option on the dialog box, see the Creating Audit Reports when Capital
Analysis Operations are in the Background topic in the Capital Design Tools -
Common Functions User Guide for further information. Running the analysis
operation in the background allows you to continue working on other analysis tasks
knowing you can open and interrogate the audit report at a convenient time.
Note
Audit report generation is automatically selected whenever the Run in background
option is checked.
Once you have decided on your report and background run requirements, click Next.
4. You must select the simulation type that the stress analysis will use to create its report.
There may be different options depending on the version you are running, and whether
you have configured an external simulator using Capital SimBridge (see “Capital
SimBridge” on page 155 for more information).
• Check the Use transient box to run the analysis under transient mode if required.
• Check the Enable advanced functionality box if you want to use advanced settings
to run the report.
Click the Next button to continue.
5. If you did not check the Use transient box, skip to step 6. If you did check the Use
transient box, you must specify the following transient simulation settings:
• Start Time - The point in time that the analysis should start.
• Stop Time - The point in time when the simulation should finish.
• Sample Rate - How often the state of the simulated system should be sampled and
recorded.
9. You must specify whether you want to evaluate rules and actions in your stress report.
Select one of the following:
Note
If you select a scenario sequence file, the stress report will contain a section called
<scenario> that lists the events in the order that they took place.
11. If you did not select all the schematic's input components to be exercised, the next step
in the wizard will ask you to define the settings for the de-selected components. Specify
the appropriate values and click the Next button.
12. If you selected all the schematics input components for stress analysis, the wizard skips
straight on to the next step. This is used to select how the stress report is displayed. You
can select an existing style from the Stress Styles list or create a new stress style. Click
the Next button.
13. You must give the file name and the directory for the report to be saved in. You can use
the Browse button to navigate to a directory. Click the Next button.
14. The Summary dialog displays a list of the options selected in the wizard. Read the list
carefully and click the Back button to make any changes, or click the Run button to start
the stress analysis.
15. A status bar indicates the progress of the stress analysis.
16. The report will be displayed in Capital SimStress as shown below:
The report shows the maximum applied voltages, currents and powers for each
component, node and pin in the schematic.
The following options are available to filter the returned data:
• Enter a regular expression into the search field (indicated by the magnifying glass
icon) to search on the contents of the topmost column configured in the report style
(displayed on the left of the grid by default). The following wildcards are supported:
o * - matches 0 or more of any characters
o ? - matches exactly 1 character
o [...] - matches a single character from the list in the brackets
o [^...] - matches a single character except those from the list in the brackets
o (...|...) - matches the first or second character group in the parantheses
o {N} - matches exactly N of the preceding character or group
o {M,N} matches M to N of the preceding character or group
Note
If no wildcards are used, the search string is case-insensitive and will match any string
that contains the expression. If any wildcards are used, the search string is case-sensitive,
and will match any string that starts with the expression.
• Columns can be repositioned within the report. To move a column, click on the
column name and drag it to the new position.
• Click the button to toggle the display of components within the data.
• Toggle the display of internal and external nodes by clicking the 3-way button; the
following modes are available:
o - all nodes are displayed
o - no nodes are displayed
o - only external nodes are displayed
• The report data can be sorted on a single column.
o Click a column header once to sort on that column in ascending order (indicated
by an up-arrow icon).
o Click the column header again to sort in descending order (indicated by a down-
arrow).
o Click a third time to remove the sorting.
Sorting is applied according to the Type of data specified for the column in the
report style (see “Custom Styles Dialog Box” on page 147 for more information).
o Integer and Real data types are sorted numerically.
o String data is sorted using a true alphanumeric sort, so any number groups
within a string are considered a single integer. For example, in an ascending sort,
1.3 is placed before 1.22.
Related Topics
Running Stress Analysis Wire Sizing and Back Propagation of
Properties
In Capital Integrator, in the Component Sizing dialog that appears, there are options to apply
the results to all configurations or a particular configuration. Either check the Use all
configurations box or select the specific configurations that should be analyzed.
In the Stress Analysis Wizard, follow the steps described for “Running Stress Analysis” on
page 136.
When the analysis is complete, Capital SimStress will show the results table. The columns
Wire CSA (max), Wire CSA (mean) and Wire CSA (min) columns contain suggested wire
sizes.
The Wire CSA (max) column displays the gauge that should be used to allow the maximum
current to flow safely after performing the analysis. Wire CSA (mean) contains the mean gauge
found from the analysis.
1. Click the Propagate Back button . A dialog is displayed from which you can select
the column of data to use:
2. Select the column of data you want to back propagate from the Column Heading
dropdown list, then click OK.
• In Capital Logic the Back Propagate dialog is displayed:
Enter the name of the property in the Property name field as you would like it to
appear on the component, wire or net, choose the item to which the property is to be
applied from the Apply to radio group, then click OK. If an attribute is found for the
selected component type with a name matching the entered Property name, the
value will be entered into the attribute. If no matching value can be found, the value
will be entered into either a property with a matching name, or if one does not exist,
a new property.
• In Capital Integrator, the Back Propagate Wire Size dialog is displayed:
Enter the property name in the Property field and click the OK button. If a wire
attribute is found with a name matching the entered Property name, the value will
be entered into the attribute. If no matching value can be found, the value will be
entered into either a property with a matching name, or if one does not exist, a new
property.
The following fields are also available to support the reselection of wires from the
library based on the back-propagated values:
o Use Library to lookup material specification
Select this option to force the selection of a new wire specification based on the
WireCSA supplied and the material of the currently assigned wire.
o Use default material
Select this option, then select a material from the dropdown list to force the
selection of a new wire specification based on the WireCSA supplied and the
specified material.
• In LCable, the property pushback dialog below is displayed:
Enter the name of the property that will appear on LCable wires or components.
Click on the OK button to exit the dialog and pushback the property.
Concerns
The concerns tab displays any concerns found during the analysis run and the input conditions
under which they were found. Examples of concerns are fuses that have blown or short circuit
conditions that have been found.
Rules
The rules tab displays any rules that have been evaluated during the analysis run. For each rule,
the tab also displays the component that triggered the rule, any actions triggered by the rule and
any messages resulting from issue statements in the rules or actions.
Related Topics
Scoping
Defining Applied Current, Voltage and Power Algorithms
Procedure
1. Create a new component interface property in the Component Builder (see “Defining a
Component Interface” on page 164).
Applied Power will always be worked out by summing the power of a component's individual
arcs unless it is overridden by a property called appliedPower.
The results are displayed on the screen and are also saved to a file. The file results can be used
within other tools that apply rules to detect components that are operating outside of specified
tolerances.
Related Topics
Component Builder Overview of Capital SimStress
Defining a Component Interface
Related Topics
Creating a New Stress Style Editing a Stress Style
Deleting a Stress Style Import and Export of Stress Styles
Procedure
1. Click the Create new Style button in the Stress Styles page of the Stress Analysis
Wizard, or by first selecting Edit > Report Styles from the Stress Analysis Tool.
2. Enter the new style name in the Style Name field.
Related Topics
Editing a Stress Style Import and Export of Stress Styles
Deleting a Stress Style
Procedure
1. Select a stress style from the Stress Styles list in the Stress Analysis Wizard.
2. Click on the Edit Selected Style button .
3. Modify information in the Custom Styles Dialog Box where appropriate. If modifying
column data, select the column from the Used list first.
Related Topics
Creating a New Stress Style Import and Export of Stress Styles
Deleting a Stress Style
Procedure
1. Select a stress style from the Stress Styles list in the Stress Analysis Wizard.
2. Click on the Delete selected style button .
Related Topics
Creating a New Stress Style Import and Export of Stress Styles
Editing a Stress Style
Procedure
1. Select Edit > Edit report styles from Capital SimStress, or select the Advanced tab in
the Stress Styles panel, of the Wizard.
2. In the Advanced tab of the Stress Styles panel, select the import button, .
3. Select Report Style XML Import, from the import wizard, click Next.
4. Select the file to import by clicking Browse, in the import wizard, open the file from the
dialog.
5. Click Close, to close the wizard.
To export a stress style follow the steps below:
1. Select Edit > Edit report styles from Capital SimStress, or select the Advanced tab in
the Stress Styles panel, of the Wizard.
2. In the Advanced tab of the Stress Styles panel, select the export button, .
3. Select Report Style XML Export, from the export wizard, click Next.
4. Select the location of the export file by clicking Browse, in the export wizard, enter the
file name and location in the Save dialog, close the dialog, click Next in the wizard.
5. Click Close, to close the wizard.
Related Topics
Overview of Capital SimStress Defining a Component Interface
Component Builder
The degree of functionality available to the external simulation will be dictated by its design.
For example, the coloring of schematics according to the results returned is one option available
to developers when creating the external simulator. A document has been created to provide
developers with all the information they need to develop an external simulator, and it is
included as part of the Capital Analysis installation. It can be found in the /docs/simbridge sub-
directory of your Capital Analysis home folder, and is named:
Before you can access the external simulator in any of the scope-level simulation tools, you
must first configure your Capital Analysis installation to find and run the simulator.
Configuration
Capital SimBridge is configured within a properties file that gives Capital Analysis all of the
information it needs to integrate the external simulation technology.
Procedure
1. From your Capital Analysis home directory, navigate to the /resources/resources sub-
directory, and open the file named SimBridge.properties.
2. Modify the following lines within the file:
SimBridge.supported=<name of bridge>
Replace <name of bridge> with the name of the external bridge component
<name of bridge>.visibleName=<visible bridge name>
Replace <visible bridge name> with the name of the external bridge as it should be
displayed in the Capital Analysis user interface
<name of bridge>.commandLineInvocation=<Command Line>
Replace <Command Line> with the command line used to launch the external
simulator, and add the following optional parameters:
o the path to the location in which the file containing the generated netlist is to be
created
o the path to the location in which the job file is to be created
o the path to the location in which the results file is to be created
If any of these parameters are missing, Capital SimBridge will create ALL files in
the directory specified by the TEMP variable used by your Capital installation.
<name of bridge>.interfaceVersion=1.0
This line identifies the version of the netlist and results formats that the simulator
understands, and hence should not be changed.
Note
Although it is possible to enter multiple bridges into the SimBridge.supported line,
specifying all configuration settings for each bridge, at this release, support is only
available for a single bridge. If more than one bridge is configured, when Capital
Analysis is launched, a message will be displayed to inform you that only the first bridge
in the list will be available for use in simulation.
For example, both of the following formats are allowed:
SimBridge.supported=Bridge1 Bridge2
and
SimBridge.supported=Bridge1
SimBridge.suppoirted=Bridge2
Capital Analysis simulates the behavior of a circuit for each of the failure modes for each
component in the design. To achieve this, a model of each class of component needs to be
defined. This model describes the structure and behavior of a component under both normal
operation and under any failure modes.
A set of models for common components is supplied with Capital Analysis. You will typically
need to define a number of additional models that are particular to your work. This section
describes the Component Builder tool that is used to create these models.
• Expressions - define the state of the resistances under certain conditions. Expressions
are written as if-then-else statements.
• State Charts - more complex component behaviors should be modeled as state charts.
These can include concurrent states and timing information.
In addition to describing the normal operation of the component, it is necessary to define the
different component failure modes to be explored in the FMEA. For each failure mode, you
describe the way in which the failure mode affects the component. This may be a structural
change, a behavioral change or a combination of the two.
Tools
Component Builder- This tool is started from the ribbon on the Capital applications. It is used to
create new components, define the structure, failure modes and behavior expressions.
Related Topics
“Attaching Component Models” on page 199
Component Builder
Every component in Capital Analysis is defined as a set of terminals, resistances, and the
relationships between the two.
Standard components such as wires, lamps, motors, relays and switches are provided as part of
the Capital Analysis Component Library - Component Models Provided. The Component
Builder provides the facilities to construct component models.
Note
A Language Reference Guide is included on your Capital Analysis installation CDs for
further information on creating component model behaviors.
There are six main stages in defining an Capital Analysis component, They are as follows:
Note
Clicking the Promotion icon ( ) allows you to filter the list of interface properties or
failure modes based on their ownership (from the current model or from the hierarchy)
and promotion status. Note - the icon changes according to the setting selected. For
further information see “Overriding Interface Property or Failure Mode Promotion” on
page 204.
There are 3 different windows with menus used when creating an Capital Analysis component
model. They are the Component Builder window, the Structure Editor window and the
Dependency Editor window. The menus for these 3 windows are covered in these sections:
Related Topics
“Attaching Component Models” on page 199
Procedure
1. Start a new ComponentBuilder from the ECAD tools main analysis menu
a. Press Space Bar and enter Model Builder.
Or
2. Create a new component from within the ComponentBuilder
a. Choose File > New.
3. The Create New Component dialog is displayed:
Related Topics
Attaching Component Models Component Library - Component Models
Provided
Defining a Component Interface
Located in the top section of the window is a button with the default category (other) selected
and a small triangle indicating a picklist. Clicking on the button will make the picklist appear
allowing the user to select the desired category.
Related Topics
Component Builder
Related Topics
Component Builder
• Name - Give a name to the property or interface (i.e. A lamp would emit light).
• Promote - This flag adds additional visibility to a scoped (External) interface property.
Note
A promoted external property will be visible to the analysis engine to perform analysis on
interactive analysis (via a tool tip), SimStress, SimProve and SimCertify.
1) When used as an embedded model, the promoted interface property can be directly
accessible through the parent model.
See Viewing Embedded Component Properties for details on how to inspect the
embedded models built-in and interface properties.
• Scope -
o External - means the property will be visible in the simulation tool, for example: a
switch input or lamp output.
o Internal - means the property will only be available within component models
behavior, for example: used in passing values between a temperature sensor and a
controller.
o Parameter- means the property will be available in the Constants tab of The
Design Descriptor, for example: used as a global setting to change components
behavior depending on the simulation engine being used.
• Direction - Is it an input or output property (In the case of the lamp, light is an output
property).
• Type - Boolean, Enumeration etc. (the lamp will be of type Boolean).
• Default - Is it Active or Inactive by default (light will be FALSE).
Note
You can override the interface property promotion status by double clicking on the row in
which it is implemented. This opens the Component Interface Property Dialog where you
can change the promotion status as required.
The following icons detail the status of the interface property within the Component Interface
and Operating Modes dialog.
Procedure
To override a promotion setting:
1. Select whether you wish to override the Interface Properties or the Failure Modes by
clicking the relevant radio button.
2. Set the promotion behavior by clicking the icon until the required status is reached.
Available settings are:
• - displays all the available interfaces or failure modes.
• - displays all the interfaces or failure modes owned by this model.
• - displays all the interfaces or failure modes promoted from the embedded model.
• - displays all the interfaces or failure modes blocked for promotion from the
embedded model.
3. Click OK.
Related Topics
Component Builder Attaching Component Models
Viewing Embedded Component Properties
The yellow grid shown is a user definable preference and can be turned on or off via the View
menu.
Specifying Terminals
The first step in defining a component's structure is to specify the terminals.
To specify a terminal, the user must select the Terminal button from the speed bar down
the left hand side of the Structure Editor window. When the cursor is then moved onto the
canvas it automatically changes to a cross-hair. Clicking the left mouse button will place the
node on the canvas and a dialog will appear like the one shown in figure below asking for an
appropriate name for the terminal. By default the first node will be called NODE1, the second
NODE2 and so on. The text that the user enters will automatically be converted to upper case.
See “Pin Naming” on page 172 for more details.
You can also specify if a node is external (used to represent the parts of the component that
interface with the outside world) or internal (used purely to connect different resistances within
the component). Click OK to add the node with the specified settings. Click Cancel to cancel
the addition and remove the node from the drawing canvas.
To define further terminals there is no need to select the Terminal button again as the cursor
continues to perform the same operation until another speed bar item is selected.
Defining Resistances
The functionality of the component is determined in terms of links between terminals. These
links can contain resistances which can change depending on the state of other parts of the
component.
To enter a resistance as part of a component's structure select the Resistance button from
the speed bar, and move the cross-hair over a circle representing a terminal. Click and hold
down the left mouse button and drag the cursor until the line being drawn joins with a circle
representing another terminal, and release the mouse button. When the line joins with a
terminal, the terminal will change to a red color.
This time a dialog like the one shown in the figure below will appear, not just asking for an
appropriate name (the default will be ARC1, ARC2 etc) but also for the type of resistance to be
selected. The resistance defined with this dialog is the default value. The value may change
during simulation as a result of the effects of normal or failure behavior.
In addition to simple resistance arcs, it is also possible to change the arc's type to fuse or diode.
Diode Arcs
Diode arcs only allow current to flow in one direction through them. In addition it is not
possible to specify an infinite resistance for a diode, they must either have Zero or Load. The
allowed direction of current flow is indicated in the structure editor by arrows drawn over the
arc as shown in the image below:
Fuse Arcs
The final arc type is the fuse arc. Fuse arcs are considered require the specification of their
rating, as shown in the dialog below. Please note that units must also be specified.
The rating indicates at what level of current the fuse will blow.
Related Topics
Component Builder
Related Topics
Component Builder
Pin Naming
When naming external nodes it is worth considering the rules below which the Attacher's
automated Terminal Mapping program uses to match the pins of the ECAD component with the
external nodes of the Capital Analysis component model.
The pins will be automapped if:
Mapping also recognizes and accommodates space characters used in device pin names,
especially when the model port name is created using the automatic model builder. For
example, the mapper can detect that “AUDIO IN” and “AUDIO_IN” are actually the same and
map them accordingly.
Related Topics
Attaching Component Models
Dependency Expressions
The Dependency Editor is where the behavior of a component is defined when the engineer
chooses to use dependency expressions. It will only be linked to a component if the Dependency
Expressions option was selected when the component was initially created. If the State Builder
tool is invoked instead of the dependency editor then the engineer must create a new component
this time selecting the dependency expressions option.
It is very important to ensure that "Normal Operation" is highlighted on the Operating Modes
canvas of the Component Builder main window, before invoking the Dependency Editor. The
Dependency Editor is invoked by clicking on the "Edit Mode's Behavior" button located in the
lower right section of the window.
This will open a Dependency Editor window. The window is divided into two sections. By
default the left side is a blank text frame where the dependency expressions are written. The
right side of the window is also blank apart from the title "Commands" with a small triangle
next to it indicating that a pick list is available.
Clicking on the triangle will display the contents of the pick list. The pick list headings will
always be:
• Commands
• Operators
• Constants
• Structure
• Interface
These are directories containing everything required to build the dependency expressions for a
components behavior. However, although the directories will always be the same, the contents
of the directories will depend directly on the structure of the component whose behavior is
being modelled.
The practical part of constructing dependency expressions is very easy. The difficult part is
making sure the syntax is correct so that the component behaves in the way it was intended to.
To construct a dependency expression an engineer must find their way through the pick list of
directories for the syntax they require and select it by clicking on it. Once the correct syntax is
highlighted it can be entered onto the text frame by clicking on the arrow located to the left
of the pick list of directories.
It is better to use the pick list directories rather than typing the expression in directly as this
helps to cut down on errors.
Related Topics
State Builder Component Builder
Embedding VHDL-AMS Models
When a failure mode is introduced, the structure of the component under the failure mode status
can be edited to show what effect the failure mode will impose on the physical behavior of the
component. To do this, first ensure that the correct failure mode is highlighted and then click the
Edit Mode's Structure button.
The Structure Editor will open and its title bar will display which failure mode has been
accessed. Even though the structure definition defined in the normal operation model cannot be
modified you can change the behavior of the existing model structure to mimic the physical
effect of the defined failure mode. Double clicking on a Arc allows you to alter the Arc behavior
for the failure mode. Double clicking on a Node allows you to alter the behavior of the node or
impose a new behavior for the node to mimic target failure mode behavior.
In the Node/Arc Details window there are various settings that can be used to simulate failures.
For example nodes can be shorted to other nodes and arc's resistances can be forced to set
values.
Selecting File > Exit will close the Structure Editor and allow you to go back to the Component
Model Builder where you can save your work by selecting File > Save.
If you have chosen to create a failure mode which has its own behavior then the Edit Mode's
Behavior will button will be active. Use this button to start either the StateBuilder or
DependencyEditor and describe the failure mode's behavior on the normal way. At this point,
all variable and functions will not be accessible, but the normal mode and failure modes will
share some interface properties for the component. Additionally all promoted interface
properties can also be accessed in the failure mode.
Note
You can override the failure mode promotion status by double clicking on the row in
which it is implemented. This opens the Component Interface Property Dialog where you
can change the promotion status as required.
The following icons detail the status of the failure mode within the Component Interface and
Operating Modes dialog.
Procedure
To override a promotion setting:
1. Select whether you wish to override the Interface Properties or the Failure Modes by
clicking the relevant radio button.
2. Set the promotion behavior by clicking the icon until the required status is reached.
Available settings are:
• - displays all the available interfaces or failure modes.
• - displays all the interfaces or failure modes owned by this model.
• - displays all the interfaces or failure modes promoted from the embedded model.
• - displays all the interfaces or failure modes blocked for promotion from the
embedded model.
3. Click OK.
Related Topics
Component Builder Attaching Component Models
Quantization Bands
For Spice simulations each component model must have a Quantization Scheme attached to it
for Voltage, Current and Resistance. This is done by selecting Edit > Quantization Bands...
from the Component Model Builder menus. The Quantization Bands dialog will open allowing
you to choose appropriate QSchemes for the component model.
Below is an example of a current QScheme.
The table below shows you the labels of the Quantization Bands each type of Quantization
Scheme must have in it for mixed mode simulations to work.
Related Topics
Component Builder Overview of QScheme Builder
Related Topics
Attaching a Model to a Shared Object
Procedure
1. Models can be attached to shared objects within the Capital suite of applications:
• In Capital Project:
With the project open, select Shared Objects > Shared Devices from the tree menu,
then right-click on the shared device to which you wish to attach a model and select
"Edit". The Edit Shared Pin List dialog will open.
In the section labeled Analysis, either click the "Attach" button to open the Attacher
(see “Attaching Component Models” on page 199) and select the pre-built model to
attach, or click the "Build" button to launch the Component Builder Wizard and
create a new model to attach. Once a model has been attached, the Simulation
Model field will display its name and location.
Alternatively the Associate button in the Analysis panel allows you to specify a
symbol with associated model can also be added to the device. Once associated, the
behavior of the model can be used in any simulations. See “Generate Model in
Capital Symbol” on page 201 and “Associate Symbol” on page 202 for full details.
See the Capital Project help system for more information on creating and editing
shared objects in Capital Project.
• In Capital Logic:
In the Shared Objects browser window, right-click on the shared object to which you
wish to attach a model and select Edit Shared Device. The Edit shared Device
dialog will open. On the Analysis tab, either click the "Attach" button to open the
the Attacher (see “Attaching Component Models” on page 199) and select the pre-
built model to attach, or click the "Build" button to launch the Component Builder
Wizard and create a new model to attach. Once a model has been attached, the
Simulation Model field will display its name and location.
Alternatively the Associate button in the Analysis tab allows you to specify a
symbol with associated model can also be added to the device. Once associated, the
behavior of the model can be used in any simulations. See “Generate Model in
Capital Symbol” on page 201 and “Associate Symbol” on page 202 for full details.
See the Capital Logic help system for more information on creating and editing
shared objects in Capital Logic.
2. Right-clicking on an instance of a shared object in a Capital Logic diagram, or in the
Diagram browser window, and selecting Analysis > Attach will open the Attacher in
read-only mode as models cannot be attached directly to instances; you will be able to
view the name and location of any attached model, but you will not be able to make any
changes to the attachment. The Analysis > Build option will be disabled for the same
reason: you cannot build a model for attachment to an instance of a shared object. It is,
however, possible to edit the model attached to an instance by right-clicking on the
instance and selecting Analysis > Edit Model. This will open the attached model in the
Component Model Builder, allowing users with sufficient privileges to edit the model's
structure and behavior.
Note
If right-clicking on an instance of a shared device in a Capital Logic diagram, or in the
Design browser window, the Analysis > Associate Symbol menu item will not be
enabled, as symbols cannot be attached directly to instances. See step 1 above for details.
3. Upon pressing Space Bar and entering Refresh Shared in Capital Logic, any updated
model attachments will be applied to all instances of a shared object within a design,
overwriting any legacy attachments.
Note
If you are working with an old diagram (pre-2006.2) and attempt to run a simulation
without refreshing the shared objects, you may encounter the following message:
Shared Device: "Device Name" has multiple different attachments. Please refresh shared
objects.
This will occur because it was previously possible to attach component models to
instances of shared objects, and without refreshing the shared objects on the design, the
models attached to the shared objects at project level will not have cascaded down to each
instance on the design. This can be rectified by pressing Space Bar and entering ‘Refresh
Shared’ in Capital Logic before running the simulation again.
Related Topics
Shared Object Component Models
These hierarchical models - embedded along with all attendant behaviors - can be connected to
the parent structure through connections to parent nodes by regular resistance arcs, and the
properties of the embedded model can be accessed through the behavior of the parent model.
Note
Note that although it is possible to embed a model that contains its own embedded
models, each model can only access the properties and structure of the model embedded
directly within it, that is, access is only available to the next level down in the hierarchy.
Restrictions on Use
Although the implementation of embedded hierarchical component models is highly flexible, a
number of limitations apply when embedding a model with a component model structure:
• The component model to be embedded must contain one or more external nodes.
• A component model cannot be embedded within itself.
• Although it is possible to create a Dependency expression model with an embedded
State machine model, simulations involving the Dependency expression model may take
an excessive amount of time, and the results may feature a greater number of steps than
expected.
Related Topics
Reference an Embedded Object Set Failure Modes for an Embedded Object
To Embed a Hierarchical Model Defining Component Structure
Moving Objects in the Structure Editor Deleting Objects in the Structure Editor
Pin Naming
Procedure
1. Create a new component model, see “Creating a new component model” on page 162.
2. With the "Normal Operation" mode selected, the user can now invoke the Structure
Editor window by clicking the "Edit Mode's Structure" button located on the lower-
right-hand side of the window.
An empty Structure Editor window is shown below:
Note
The yellow grid shown is a user definable preference and can be turned on or off via the
View menu.
3. Click the "Insert an embedded component model" button ( ) then move the mouse
pointer over the canvas. The cursor changes to a cross-hair. Left-click at the point at
which you wish to place the embedded model. A file selection dialog is displayed:
Note
In the above image, a Connector model has been selected, as this best shows the nature of
the folder structure, but later steps in this process detail the use of a simple lamp model
for simplicity.
Select the model to be embedded by clicking on it (noting that only component models
can be selected). The selected model is displayed in the Location field, and its
properties can be examined by clicking the "Properties..." button. Once the correct
model is selected, click the "Open" button.
Note
If the model you have selected to embed has no external nodes, a warning message will
be displayed, and you will be prevented from embedding the model.
4. A dialog is displayed asking you to provide a name for the model to be embedded:
The dialog shows the name of the selected model by default, but this can be overwritten
as required. Once you are satisfied with the name entered for the model, click OK to
proceed.
Note
Entering a new name for the model only overrides the model name for this instance of its
use; the model stored in the database will not be renamed. Note also that all instances of
the same model embedded in a parent model must have unique names.
5. The model is displayed on the canvas as a circle, with the model's name in the center and
all external nodes displayed on the perimeter of the circle:
The embedded model can be repositioned as required. The circular representation of the
model can be rotated by first selecting it, then by scrolling the mouse wheel while
holding down the Ctrl key. If you wish to replace the embedded model with another
model, double-click in the model representation and the file selection dialog will open,
allowing you to select a different model to use; once you have selected a new model to
use and clicked on the "Open" button, the new model will be displayed on the canvas.
6. Once the model has been placed on the canvas, it can be connected to the parent
component model's structure, using arcs to connect the embedded model's external
nodes to terminal nodes (both internal and external) within the structure:
7. Multiple instances of the same model can be embedded within a structure as long as
each is given a unique name as it is selected. Multiple types of model can also be
embedded in the same structure:
8. Once all required models have been embedded and connected to the parent structure,
close the Structure Editor dialog and save the changes to the model.
It is possible to remove a component model from the Analysis datasource that is
embedded in a parent model. If this occurs, the following errors/warnings will be
encountered:
• If you open the model in the Component Model Builder, a warning will be displayed
to inform you as to which embedded model can no longer be located in the database.
The associated embedded object will be colored red in the Structure Editor and can
only be deleted.
• If you check the integrity of the model (by selecting Tools > Check Integrity from
the Component Model Builder main menu) the missing model will be noted as a
problem.
• Any attempt to simulate the model will raise an error detailing the missing model.
Related Topics
Reference an Embedded Object Set Failure Modes for an Embedded Object
Embedding Hierarchical Components Defining Component Structure
Moving Objects in the Structure Editor Deleting Objects in the Structure Editor
Pin Naming
Related Topics
To Embed a Hierarchical Model Set Failure Modes for an Embedded Object
Embedding Hierarchical Components Defining Component Structure
Moving Objects in the Structure Editor Deleting Objects in the Structure Editor
Pin Naming
embedded.myEmbeddedObject.setFailureMode("myFailureMode","<Failure
Text>");
sets the failure mode "myFailureMode" for the embedded object
"myEmbeddedObject". The parameter "<Failure Text>" is used to pass the text to be
displayed in FMEA reports; this parameter must be included, otherwise an error will
be encountered when you attempt to save or run an integrity check on the model.
An example of use for this method would be the modeling of a fuse box, where a
number of fuse models have been embedded within the parent "fuse box" object. The
fuse box would be constructed with a number of failure modes, one each for every
possible combination of embedded fuse failure. Upon setting the failure mode for the
parent object, the behavior entered against the selected failure mode sets the failure
mode for the embedded fuse object or objects required.
• A failure mode can be applied to the arcs connecting the external nodes of the embedded
object to the structure of the parent object.
Related Topics
To Embed a Hierarchical Model Reference an Embedded Object
Embedding Hierarchical Components Defining Component Structure
Moving Objects in the Structure Editor Deleting Objects in the Structure Editor
Pin Naming
It is possible to reference a model before it has been created, but although the component
model's behavior will be syntactically correct, an error will be generated when you save
the model or perform an integrity check, stating that the referenced model is missing.
1. Open the Component Model Builder, either bypressing Space Bar and entering Model
Builder in your Capital Logic application, or right-click on a device within an open
diagram and select Analysis > Build. Create a new component model with an
appropriate structure (see “Creating a new component model” on page 162).
2. Click the "Edit Mode's Behavior" button to open the Dependency Editor.
Note
It is possible to embed VHDL-AMS models within a State Machine, but this section will
use a Dependency Expression model for illustration.
3. In the Dependency Editor window, enter the following statement, or select the statement
from the Commands list on the right of the screen, under Model Objects > self >
Methods:
self.usurp("VHDL","<vhdl model>");
replacing <vhdl model> with the name of the model you wish to reference. For example:
self.usurp("VHDL","myModel");
Note
The name you enter must match that entered against the model in the database, otherwise
a missing model error will be generated when you save the model or perform an integrity
check.
Two other statements can be used to reference the model. These are:
self.usurp("VHDL","<vhdl model name>","<vhdl library>");
and
self.usurp("VHDL", "<vhdl model name>","<vhdl
library>","<architecture>");
Currently, only the "WORK" model library can be referenced, so passing these extra
arguments is unnecessary.
4. Close the Dependency Editor and save the component. If an error is encountered
informing you that the named model is missing, check that the model exists in the
library and that you have entered the model's name in the behavior correctly.
Related Topics
“External Model Management” on page 281
A component model associated to a template has access to the template component’s interfaces
as well as its behavior, although not its structure. Any interfaces created for the template will be
displayed in the Component Interface list along with any interfaces created for the component.
The template interfaces will be positioned at the top of the list and will be grayed-out as they
cannot be edited; if you want to edit any of the template interfaces, you must edit them within
the template model.
When a component with an associated template is exported, it will be handled in the same way
as a component with a QScheme attached or with an Embedded Model: the additional content
will be embedded within the exported component model. The export of such component models
is supported in both encrypted and unencrypted formats (see “Component Model Encryption”
on page 253 for more information.
Note
Any changes made to a template will be inherited by the associated component models. If
you open a component model with an associated template that has been edited since the
model was last opened, a message will be displayed to inform you that the template has
changed; simply click OK to confirm and clear the message.
Note
Component Model Templates can only be created as Dependency Expressions; upon
specifying the component model as a template, the State Machines Behavior Modeling
Type option will be disabled.
4. The Component Model Builder dialog will change in appearance to offer only those
options applicable to templates:
• The Operating Modes and Component Information areas will be removed from
the dialog.
• A new button will be added to the toolbar allowing you to view or edit the
behavior of the template.
• The Edit > Select Template menu option will be disabled. It is not possible to
associate a template with another template.
• The Tools > Change Behavior Type menu option will be disabled. As discussed
above, it is not possible to create a template with a Behavior Modeling Type of
State Machine.
5. Click on the button to open the Dependency Editor (see “Dependency Expressions”
on page 172)and create a behavior for the template.
6. To add a component interface, click the New button; the Component Interface Property
dialog will be displayed. Refer to “Defining a Component Interface” on page 164 for
more information on how to create an interface.
7. Once the template is complete, select File > Save from the menu. The Save a
Component Model dialog will open, allowing you to specify a name for the new
template and a location within the component database in which to save it.
1. With the Component Model Builder dialog displayed, select File > Open from the
menu.
2. The Open a component model dialog will be displayed. Browse to the component model
you wish to use as a template, click once to select it, then click Open. The model will be
displayed in the Component Model Builder.
3. Select Tools > Change Category from the menu. A message will be displayed asking
you to confirm the change; click on Yes to proceed.
4. The Change category dialog will be displayed. From the Component category drop-
down list, select Template.
5. A message will be displayed informing you that the component model’s structure, state
machines and failure modes will be deleted (if any have been created). Click on OK to
confirm the message and continue.
Note
It is possible to change a template’s component category to one of the other options,
converting the template into a standard component model. If you do this, and the template
is already associated with one or more component models, a message will be displayed to
inform you of any dependencies, and you will be given the option to cancel or proceed
with the change.
6. To create, view or edit the template’s behavior, click the button to open the
Dependency Editor.
7. To add a component interface, click the New button; the Component Interface Property
dialog will be displayed. Refer to “Defining a Component Interface” on page 164 for
more information on how to create an interface. Existing component interfaces can be
edited or deleted by first clicking on the interface to select it, then clicking the Edit or
Delete buttons as appropriate.
8. Once the template is complete, select File > Save from the menu. The Save a
Component Model dialog will open, allowing you to specify a name for the new
template and a location within the component database in which to save it.
To delete a Template
1. Launch the Object Manager by pressing Space Bar and entering Object Manager in your
Capital Logic application.
2. Navigate to the component model template you wish to delete, then either:
• Right-click on the model and select Delete
or
• Select Edit > Delete from the menu
or
• Press the Delete key on your keyboard
3. A message will be displayed asking you to confirm the deletion; click Yes to proceed or
No to abort the process.
Note
If the template you have chosen to delete is associated with any component models, a
warning will be displayed to inform you, giving you the option to proceed or cancel the
deletion. If you open a component model that was previously associated with a template
that has since been deleted, a message will be displayed to inform you, but you won’t be
prevented from proceeding; once you have confirmed the message, the component model
will open, but without any Dependency behavior or component interfaces previously
inherited from the template. If you perform an integrity check on the model, a message
will be displayed to inform you that the template can no longer be found. If you attempt
to run a simulation using the component model, an appropriate error message will be
displayed.
1. With the Component Model Builder dialog displayed, and the component model with
which you wish to associate a template open, select Edit > Select Template from the
menu.
2. The Template dialog will be displayed.
3. Click on the button. The Select Template dialog will open; browse to the template
you wish to use, select it, then click the Open button.
Note
The Select Template dialog will only display component models with a Component
category of Template to aid in selecting the correct template.
4. The Template dialog will now display the path to the selected template.
Note
Clicking the button allows you to launch the Component Model Builder and edit the
selected template before associating it. Clicking the button will clear the path from the
field; see To delete the association between a Template and a Component Model, below,
for more information.
5. Click the OK button; you will be returned to the Component Model Builder. Any
component interfaces entered in the template will be displayed, grayed-out, at the top of
the Component Interface list; any behavior entered in the template will be available to
view by first clicking the Edit Mode’s Behavior button, then in either the Dependency
Editor or the State Builder, clicking on the Show the template behavior button ( ) to
launch the Template Behavior dialog.
Any behavior defined for the template will be interpreted before the behavior entered
belonging to the dependent component model.
6. With the template associated, select File > Save to save the component model to the
component database.
Note
If you perform an integrity check on the component and a SAINT function is found to be
missing in either the template or component model behavior, a message will be displayed
to inform you of the problem. If you save and close the component model without
performing the integrity check, the same message will be displayed the next time you
open the model in the Component Model Builder. The same check will be performed if
you attempt to run a simulation using the model, in which case an appropriate error
message will be displayed.
Refer to “Component Model Templates” on page 189 for more information on how template
behaviors are created and interpreted.
Related Topics
“Component Builder” on page 160
The description of the Component Builder Wizard assumes that you are familiar with the
Component Model Builder tool.
The Component Builder Wizard is started by selecting the schematic symbol for which you
want to build a model, pressing Space Bar and entering Buld.
The first screen is an introduction screen describing the main stages involved in completing the
wizard. It also has a tick box on it which allows you to choose wether you want information
panes to be shown as you go through the wizard. In this description of the wizard the
information panes will not be shown. If you are a new user we recommend that you leave the
information panes switched on. Click the Next buttons to proceed to the next step in the wizard
and Back buttons to return to a previous step.
• Basic Information - Here you define the components category and behavior modeling
type.
• Structural Information - Where you must define the component's nodes and arcs, and
their layout.
• Failure Modes - Where you select the standard or user-defined failure modes for the
component.
Basic Information
In the second step of the Component Builder Wizard you must select the component model's
Category and Behavior Modeling Type. This is step is the same as if you had just selected File
> New from within the Component Model Builder tool.
Structural Information
Next you must start to describe the model's structure by defining your model's nodes. The
wizard will automatically pick up the ECAD pin names and create external nodes with the same
names. Depending on what you want to do you can change the node's names and create other
internal and external nodes as you wish.
The first column in the table shows the ECAD pin names that the wizard has picked up. The
second column shows the names of the nodes that will be created for the model. You can
rename and create new nodes by typing in the second column. The External column has tick
boxes to allow you to make a component model's node internal or external. Note that ECAD
pins have to be external nodes. The Map pins -> nodes button will map the ECAD pin names to
the node names.
It is also possible to group sets of nodes. For example, you could group all the input and output
pins of you model together, this would make it easy to describe the structure's layout and the
connectivity of the nodes further on in the wizard. To group some nodes first highlight a set of
nodes and then click the Group button. The wizard will ask you to name the group of nodes.
Once you have defined the nodes in your component model, you must then describe their
physical layout or formation.
The next step allows you to choose the shape of the node's structure to be laid out in the
structure editor.
• Star - This layout lets you select one node to be the center node and then puts the
remaining nodes around the center node in the shape of a star.
• Column - This layout lines up the nodes in columns. You may have one or two columns
which may be set out vertical or horizontal.
• Rectangle - This layout will line up the nodes in a rectangular shape.
• User - This layout option will allow you to place the nodes anywhere you want using the
mouse.
Depending on the option you choose for the structure's formation will change the screen you
will see next. If you choose Star, Column or User then the next screen you see will allow you to
organize the chosen structure shape.
You can also choose to have the layout organized according to groups of nodes. This option is
only available if you have assigned some of the pins to groups.
The next step depends on the shape of the node’s structure. If you chose the star formation, you
must choose which node is to be at the center of the star. If you chose the Column structure
formation then you will have decide how many columns you want and whether you want them
laid out vertically or horizontally. The Rectangle formation does not have any extra settings and
the User layout option will take you to a formation editor window where you can move the
nodes to the positions you want by using the mouse.
You must describe the models connectivity. Depending on which options you select will change
the next wizard screen you will see. The Connectivity options are:
• No Connectivity - this will leave you model with no internal connections (arcs).
• As defined by formation rule - this will create connections according to the layout of
the nodes.
• All nodes are connected to all other nodes - this will create a connection from every
node to every other node.
• All nodes are connected to a specified node - this will create a connection from one
particular node to every other node.
• User defined - this option will allow you to define the connections yourself.
You must specify an arc default resistance for some of the connectivity options. Depending on
which option you chose, you may have to specify various connectivity settings in the next step
of the wizard. You can also have the nodes connected in accordance with their groups. This
option is only available if you have assigned some of the pins to groups.
If you used the As defined by formation rule connectivity option then the connections will be
made according to the node's layout you have selected previously. If you have chosen:
• Star - then the central node will be connected to each node surrounding it.
• Column - then each node in the first column will be connected to the adjacent node in
the next column.
• Rectangle - then every node will be connected to every other node.
• User - then you will have to define the connections yourself.
• Short to battery - this will directly connect a node to the battery's positive terminal as
specified in the subsystem editor.
• Short to ground - this will directly connect a node to the battery's ground terminal as
specified in the subsystem editor.
• Open Circuit - this will allow you to make one or more of the model's arcs fail open
circuit.
• Bent Pin - this failure will short every node to every other individual node in the models
structure.
• Foreign Object Detection - this failure will short every node to every other
combination of nodes.
• Pin lifted - this failure will remove a node, effectively disconnecting it from any arcs.
If you tick the Create User Defined failure modes... tick box you will see another step in the
wizard which will allow you to create your own failure modes for this component model.
If you tick the I don't want to add any more detail, skip to end. tick box the wizard will take
you straight to the Summary step when you click next.
In the Model description window, you may enter a description of the model.
This Summary window shows you a summary of the model you have created. Select the tabs to
view the different parts of the model. If any of the details of the model are incorrect click the
Back buttons until you reach the appropriate screen and change the settings.
The Save Object window of the wizard asks you to save it. Click the Browse button to choose a
directory and name for the component model.
Once your model is saved you will be asked if you would like to open it in the Component
Model Builder. Select Yes to use the Component Model Builder to describe the models
behavior.
Related Topics
“Component Builder” on page 160
Important Recommendations
1. It is recommended that you do not modify any objects in the /Capital folder. This folder
is distributed with an Administrator lock already present.
2. It is recommended that you create a folder for shared objects. This folder should start
with your company name. See “Shared Object Component Models” on page 177 for
more information on attaching component models to shared objects.
3. Projects that more than one user is working on should have their own folders.
Related Topics
Attaching Component Models Creating a new component model
Procedure
1. In the design tool, select (or highlight) the component in the schematic to which you
want to attach the component model. In Capital Symbol, you can skip this step but you
must ensure that the symbol is open in Capital Symbol.
2. Press Space Bar and enter Attach. This opens the Attacher dialog. This dialog
comprises a number of tabs that control differing options
3. The top of the Attacher dialog allows you to select whether you attach your model at the
Symbol or Instance level. If you attach at the Symbol level, all the components in the
schematic with the same symbol will have the same model attached to them. If you
attach at the Instance level, the model is attached to only the component that you
highlighted before selecting to attach the model.
4. The model section in this window displays the component model that the simulation
engine will use for the selected component in the design tool.
Note
If you created a model using the Component Builder Wizard, it is automatically attached
to the device and your pins will be mapped.
5. Select whether you want to attach the component model to the instance or to the symbol
of the component. If a component model is already attached to the instance or the
symbol of the selected component, the model (or mapping) section of the window will
show the path to the attached component model (or mapping).
6. Select the component model that you want to attach by clicking the Select a new Object
button in the Model section. This will open the Select a new Object chooser.
Alternatively, you may also press Make a new Object button to create a new
component model from scratch. This will open the Component Builder.
7. When you have selected the component model you want, press the OPEN button. The
Attacher dialog will now show the selected component model. A process will have run
to automatically map the pins on the selected model with the pins on the schematic
object according to the mapping rules, (see “Pin Naming” on page 172). Message text
on the Models Panel will display the results of the automatic mapping as follows:
• All ECAD terminals have been successfully mapped - this displays is when
every ECAD terminal maps, either uniquely or as a duplicate to the component
model.
• Only partial mapping of ECAD terminals possible, please check Terminal
Mapping panel - this displays is when some ECAD terminals are not mapped to
anything on the component model.
• No ECAD terminals can be automatically mapped, please check Terminal
Mapping panel - this displays when no ECAD terminals can be mapped to the
selected model.
8. To view the mappings and investigate any un-successful mappings, click the Terminal
Mapping tab. Mappings will be displayed, in the Qualitative Terminal column, as
follows:
• Automatic in black text - denotes a successful mapping between the ECAD and
the model pin.
• Automatic in red text - denotes an un-successful mapping between the ECAD
and the model pin.
• No Terminal - denotes that there is no pin on the ECAD device.
• Actual pin names - will display where previous manual mapping has been
performed.
Note
Hovering the mouse over any of the mapping entries in the Qualitative Terminal column,
as above, will display a tooltip with the mapping details.
Mapping entries can be changed by clicking in the required cell in the Qualitative
Terminal column, and selecting a different value from the combo box that displays.
An ECAD component pin can remain unattached only if that pin is not connected to
another component i.e. it is floating. See “Pin Naming” on page 172 for more
information.
9. To remove an attached model, click the Forget this Object button in the model
section of the attacher window. To remove an attached mapping, click the Forget this
Object in the mapping section of the attacher window.
To view the component model that is attached, click the Show this Object button
in the model section of the Component Model tab. To view the component
mapping that is attached, click the Show this Object in the mapping section of the
Component Model tab.
10. The Promotion tab can be used to override either interface property promotion or
failure mode promotion on a per-model basis. Click the Promotion icon ( ) to assign
individual promotion behavior to a model. Note - the icon changes according to the
setting selected. For further information see “Overriding Interface Property or Failure
Mode Promotion” on page 204.
11. Click the OK button to apply the attachment.
Related Topics
Generate Model in Capital Symbol Associate Symbol
Prerequisites
• Composite symbol with internal connectivity.
Procedure
1. Open the composite symbol in Capital Symbol.
2. Press Space Bar and enter Attach.
Results
• The Attacher dialog displays.
• The Model Panel displays the name of the Model that has been generated.
• Select the Show this Object button to display the Component Model Builder dialog
from where the Structure and Behavior of the model can be checked and defined
Related Topics
Attaching Component Models Associate Symbol
Internal blocks and internal connectivity
Associate Symbol
Analysis models can be defined against a symbol. This topic describes how such symbols can
be associated with devices in Capital Logic and how the inherited Analysis model used in
dynamic simulations.
Using models in this way removes the need for you to manually generate models.
Prerequisites
• Composite symbol with internal connectivity and simulation model attached exists, see
“Generate Model in Capital Symbol” on page 201.
Procedure
1. Right-click on the device in question and select the Analysis > Associate Symbol menu
item.
2. The Associate Symbol dialog displays. Select symbol required and press OK.
Results
• The symbol and its model are now associated with the device.
Note
The association can be checked by checking the device property Analysis Symbol which
displays the name of the currently associated symbol.
• The model that is attached to the associated symbol will be used in any simulations that
are run.
Related Topics
Attaching Component Models Generate Model in Capital Symbol
Attaching Functions
There are three other active tabs in the component model attacher. One of these is for attaching
Functions. Output functions are attached to output devices, control functions are attached to
input devices.
Procedure
1. Select an output device, on the schematic
2. Open the attacher as described above.
3. Select the 'Functions' tab.
4. Navigate the project in the left-hand panel, to find the desired output function.
5. In the right-hand panel, select the output condition that is valid for this output function.
(This will depend on the component model attached).
Note
When attaching an encrypted component model, only External and Parameter type
properties will be available for selection. See “Component Model Encryption” on
page 253 for more information on working with encrypted models.
6. Click 'OK'.
Procedure
1. Select an input device, on the schematic
2. Open the attacher as described above.
3. Select the 'Functions' tab.
4. Navigate the project in the left-hand panel, to find the desired control function.
5. In the right-hand panel, select the input condition that is valid for this control function.
(This will depend on the component model attached).
Note
When attaching an encrypted component model, only External and Parameter type
properties will be available for selection. See “Component Model Encryption” on
page 253 for more information on working with encrypted models.
6. Click 'OK'.
Short to Battery
Set a short to battery component.
1. Select the component that will be used for such failures, this will normally be the power
supply.
2. Open the attacher, select the power tab.
3. Check the 'Use a node on this component', in the short to battery failures group.
4. Select the node from the drop-down list that will now be active.
Short to Ground
Set a short to ground component.
1. Select the component that will be used for such failures, this will normally be the power
supply.
2. Open the attacher, select the power tab.
3. Check the 'Use a node on this component', in the short to ground failures group.
4. Select the node from the drop-down list that will now be active.
Click on OK in the attacher when power pins have been set up.
Related Topics
Shared Object Component Models
Component Builder
Procedure
To override a promotion setting:
1. Select whether you wish to override the Interface Properties or the Failure Modes by
clicking the relevant radio button.
2. Set the promotion behavior by clicking the icon until the required status is reached.
Available settings are:
• - displays all the available interfaces or failure modes.
• - displays all the interfaces or failure modes owned by this model.
• - displays all the interfaces or failure modes promoted from the embedded model.
• - displays all the interfaces or failure modes blocked for promotion from the
embedded model.
3. Click OK.
Related Topics
Attaching Component Models
Component Builder
• Associate Symbol
Fields
Table 12-1. Associate Symbol Dialog Box Contents
Field Description
Treeview Displays all the symbols available for selection
Panel
Preview Displays a preview of the symbol that is currently selected in
Panel the treeview
Related Topics
Associate Symbol
Related Topics
Defining Component Structure Component Builder
Fields
Table 12-3. Failure Mode Dialog Box Contents
Field Description
Has no Select to indicate that the failure mode does not have any
behavior behavior at all.
Has own Select to indicate that a new behavior for the failure mode
behavior will be implemented later.
Uses normal Select to indicate that the behavior used for normal operation
operation will be used.
behavior
Related Topics
Component Builder Defining Failure Modes
Related Topics
Component Builder
Characteristics
There are 8 different categories for Capital Analysis component models by default. They are:
Related Topics
Component Builder
Description Editor
To access: Accessed when using the Component Builder.
The Description Editor tool allows a more detailed description of the component model to be
stored.
You can apply cut, copy and paste operations using Edit menu. You can insert the current time
stamp from the Tools menu.
Fields
Table 12-5. Description Editor
Field Description
Text Panel Enter the text into the white text area and click the File > Exit
menu when finished.
Related Topics
Component Builder
File Menu
There are 9 options on the Component Builder File menu. They are as follows:
• New: Open a blank Component Builder window to allowing a new component model to
be defined.
• Open...: Open an existing Capital Analysis component model, this will invoke the
Open/Save Object Dialog.
• Save: Save an edited Capital Analysis component model to the database using the same
name.
• Save As...: Save an Capital Analysis component model to the database under a different
name. This will invoke the Open/Save Object Dialog.
• Print: Prints all the information about the component model e.g. General Component
Information and Operating Modes.
• Print Preview...: Opens the Print Preview... window which shows you what the printer
will print and allows you to change the page format and printer settings.
• Import...: Import a component model to the database from an external source (see
“System Import/Export” on page 327).
• Export...: Export an Capital Analysis component model from the database (see “System
Import/Export” on page 327).
• Exit: Exit the Component Builder tool.
Edit Menu
The Component Builder Edit menu has 7 options which are:
• Fuse Values: Allows the use rating to be set. Available only for component models of
type fuse.
• Quantization Bands: Opens the dialog which allows you to select the Quantization
Bands for Spice simulation of the component model.
• Unlock Behavior: This option is not available with this version of Capital Analysis.
• Delete Behavior: Deletes the behavior of the highlighted operating mode.
• Select Template: Opens the Template dialog, allowing you to specify a template model
to associate with the component model.
• Description: Edits the detailed descriptions of the component model.
• Options...: Gives the user access to the Capital Analysis user definable options. See
“Edit Options Dialog” on page 269 for more details.
Tool Menu
• Check Integrity: This checks that the expression and state machines used to build the
component are valid.
Related Topics
Component Builder
File Menu
The File menu for the Structure Editor window only has 3 options listed:
Edit Menu
The Edit menu of the Structure Editor window has 5 options. They are:
View Menu
The view menu of the Structure Editor window has 9 menu options, which are:
• Zoom Out: Zooms out from the structure. This option is also available as a tool button.
• Zoom To Fit: Sets the zoom to fit everything on the screen.
• Reset Zoom: Reset the zoom to its default.
• Refresh Display: Refresh the display area.
Draw Menu
The Draw menu of the Structure Editor window consists of 9 options all of which are available
from the speed bar located on the left hand side of the Structure Editor window. The options are:
File Menu
• Print: Prints the dependency expression information.
• Print Preview: Displays the Print Preview... window, which shows you what will be
sent to the printer, and allows you to change the page format and printer settings.
• Close: Exit the Dependency Editor window and return to the Component Builder
window.
Related Topics
Component Builder
When a new Capital Analysis component model is created by using the Component Builder
tool, the engineer has to decide which method will be used to model the components behavior.
If the option to use "State Machines" is selected, when the engineer clicks the "Edit Mode's
Behavior" button the State Builder tool will be invoked allowing the engineer to draw state
charts to implement the behavior of components.
Overview of State Builder . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 217
State Builder Menus . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 218
Adding a New State . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 222
Adding an Event. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 223
Adding a Concurrency Group . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 225
Import and Export State Machines . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 226
Choose Grid Settings Dialog . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 228
Edit Comment Dialog (State Builder) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 229
Edit Event Dialog . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 230
Edit State Dialog . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 231
Structure Error Dialog . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 232
- creates a new state machine. This option is not required when state machines are
embedded with component models.
- opens a new state machine. This option is not required when state machines are
embedded with component models.
- this button saves the state machine.
- this cuts the selected item
- this copies the selected item
- this pastes the selected item
- this deletes the selected item
- this button will change the drawing mode to selection. This allows objects to be
selected, edited and resized.
- this button will change the drawing mode to states. This allows new states to be
drawn in the state machine.
- this button will change the drawing mode to groups. This allows new concurrency
groups to be drawn in the state machine.
- this button will change the drawing mode to events. This allows new events to be
drawn in the state machine.
- this button will change the drawing mode to loop events. This allows new loop
events to be drawn in the state machine.
- this button will change the drawing mode to default events. This allows new default
events to be drawn in the state machine.
- this button will change the drawing mode to exit events. This allows new exit
events to be drawn in the state machine.
- this button will change the drawing mode to comments. This allows comment
objects to be drawn in the state machine.
Related Topics
Overview of Simulator Tool Adding a New State
Adding an Event Adding a Concurrency Group
Import and Export State Machines State Builder Menus
File Menu
• New Window: This option opens a new state builder window allowing the user to view
or develop more than one state machine at the same time.
• New: Open a new (blank) State chart. The State Builder tool can be used independently
from the rest of Capital Analysis if desired. This option is also available on a tool button
.
• Open...: Open an existing State chart. This option is also available on a tool button .
This will invoke a chooser dialog (see “Open/Save Object Dialog” on page 265).
• Close: Close the current state chart leaving the State Builder tool open.
• Save: Save the changed version of a state chart. This option is also available on a tool
button .
• Save As...: Save the changed version of a state chart with a new name. This will invoke
a chooser dialog (see “Open/Save Object Dialog” on page 265).
• Print: Prints the statemachine information.
• Print Preview...: Opens the Print Preview... window which
• Import...: Import a state chart into the State Builder tool from either SQL export (from
another Capital Analysis database) format or from StateMate. See “Import and Export
State Machines” on page 226.
• Export...: Export a state chart from the State Builder tool to either SQL Export or EPS
format (for printing). See “Import and Export State Machines” on page 226.
• Exit: Exit the State Builder tool.
Edit Menu
The State Builder edit menu is designed to allow the easy editing of state charts within the State
Builder tool. The most common used edit features are available as tool buttons on the State
Builder tool bar.
• Undo: Undo last edit of the state chart. This option is also available on a tool button .
• Redo: Redo the previous edit to the state chart following the undo action. This option is
also available on a tool button .
• Cut: Remove selected object from the state chart and place it on the clipboard. This
option is also available on a tool button .
• Copy: Copy the selected object to the clipboard. This option is also available on a tool
button .
• Paste: Paste the contents of the clip board to the state chart. This option is also available
on a tool button .
View Menu
The view menu allows the user to set what information will be displayed on the state chart and
how it will be presented. The same information is still required if the state chart is to be used in
the Capital Analysis system, but some complex state charts might become difficult to read with
all the information visible. By using this menu the user can select which information to display
and which to keep hidden.
• State Attributes: This menu option gives access to 2 options each with a tick box.
o Show Names - should the state names be displayed?
o Show Actions - should the state actions be displayed?
• Event Attributes: This menu option gives access to 3 options each with a tick box.
o Show Names - should the event names be displayed?
o Show Conditions - should the event conditions be displayed?
o Show Actions - should the event actions be displayed?
Tick the box to display the corresponding attribute
• Concurrency Attributes, show names - should the concurrency names be displayed?
• Show Comments: Select the tick box to display any comments entered on the state
chart.
• Show Grid: Select the tick box to display a grid on which the state chart can be drawn.
This enables the user to draw state charts that are easier to read.
• Grid Settings...: Selecting this menu option invokes the Choose Grid Settings Dialog,
allowing the user to set the width and height of the grid lines used in the State Builder
tool.
• Zoom In: Zooms in on the state chart. This option is also available on a tool button .
• Zoom Out: Zooms out showing more of the state chart. This option is also available on
a tool button .
• Reset Zoom: Resets the state chart to the original size before the zoom in/zoom out
features were used.
• Zoom To Fit: Resizes the state chart to the maximum size possible within the size of the
window. This option should be used when the window itself has been resized.
• Refresh Display: Re-draws the state chart.
Draw Menu
Each of the options listed on the Draw menu are also available as tool buttons on the speed bar
located down the left hand side of the State Builder window.
• Select Objects: Allows user to click on objects to select and edit them.
• Draw State: Allows user to draw a new state (see “Adding a New State” on
page 222)
• Draw Concurrency: Allows user to define concurrency groups (see “Adding a
Concurrency Group” on page 225).
• Draw Normal Event: Add a normal event to the state chart (see “Adding an Event”
on page 223).
• Draw Event Loop: Add a loop event to the state chart. (see “Adding an Event” on
page 223).
• Draw Default Event: Add a default event to the state chart (see “Adding an Event”
on page 223).
• Draw Exit Event: Add an exit event to the state chart (see “Adding an Event” on
page 223).
• Draw Comment: Add a comment to the state chart (see “Edit Comment Dialog
(State Builder)” on page 229).
Tools Menu
The State Builder Tools menu gives access to 3 tools used when creating state charts.
• Orthogonalize Events: Lines up all events used in the state chart both vertically and
horizontally resulting in the state chart being easier to read.
• Check Integrity: Checks the integrity of the state chart including all events being
connected at both ends, all events having different firing conditions and ensuring that all
states can be reached.
• Export Image: Exports and image of the state chart to the file system as a .png.
Related Topics
Overview of Simulator Tool Adding a New State
Adding an Event Adding a Concurrency Group
Import and Export State Machines
If autoedit is turned off or the engineer wishes to return later to edit the state properties, the
same dialog can be invoked by double clicking on the relevant state.
Hiding States
It is possible to hide the details of any internal states and events that a parent state contains. This
can make the state chart clearer and easier to understand if detail is removed. In order to do this
right click in the state that you wish to hide the details of. Un-check the Show states check box.
The state internals will now be hidden. The state will now display a 'H' graphic, that denotes
hidden content. Checking Show states will return the view to normal.
Related Topics
Overview of Simulator Tool State Builder Menus
Adding an Event Adding a Concurrency Group
Import and Export State Machines
Adding an Event
The Capital Analysis State Builder uses events to allow component models to move from one
state to another. There are four different types of event used by the State Builder all of which are
drawn in the same way.
To draw an event the engineer must first select one of the event buttons from the speed bar on
the left hand side of the State Builder window. The event type section provides a list of the
different events, their corresponding buttons and a short explanation as to their use. Now move
the cursor onto the canvas, notice that the cursor changes to a crosshair. The crosshair must then
be moved over the state from which the event will fire, hold down the left mouse button and
drag the mouse so that the line that appears connects to the desired state. When you are happy
that the event is in the right place release the button. If the line appears gray in color, one or both
ends of the event are disconnected. See “Moving Events” on page 224 for how to reconnect
them.
Event Types
• Normal Event. The Normal event is the most common and is used to move from
one state to another when a condition or conditions are satisfied.
• Loop Event. The Loop event should be used when a component model must
exercise a delay before changing state. A counter can be used with the value of the
counter as part of a condition to model the delay. (e.g. fire if count < 5).
• Default Event. The default event is used to define the initial state of the state chart
or component model.
• Exit Event. This event is used when a state chart moves to another state which
requires an additional state in another concurrency group then to exit its current state.
If autoedit is turned off or the engineer wishes to return later to edit the event conditions, the
same dialog can be invoked by double clicking on the relevant event.
Moving Events
To move an event or reposition either of its ends, the event must first be selected by clicking on
it. The selected event will be highlighted with three handles. The handles at each end are used to
reposition the event where it connects to the different states. The middle handle allows the
engineer to move the name and conditions of the event to a location where it is more readable.
To reposition the end of an event, move the cursor over the relevant handle then press and hold
down the left mouse button. Drag the mouse so that the handle moves to the desired location
and release the button. To move the name and conditions of an event to a more readable location
follow the same procedure but select the middle handle. If it is the entire event that is to be
moved, first highlight the event by clicking on it and then follow the same procedure once again
but this time select part of the line that represents the event rather than one of the handles. In
most cases when drawing an event an engineer will probably be required to use a combination
of these procedures to make the state chart easier to read.
Related Topics
Overview of Simulator Tool State Builder Menus
Adding a New State Adding a Concurrency Group
Import and Export State Machines
The concurrency groups are depicted by the yellow lines when viewed on a color screen.
To create a concurrency group click on the concurrency button located on the speed bar to the
left hand side of the State Builder window. Now move the cursor onto the canvas, notice that
the cursor changes to a crosshair. Identify which states are to be included in the group and move
the cursor to a location outside of the outermost state in the group, then click and hold down the
left mouse button and drag the mouse. When you are happy that all the desired states are located
within the group, release the mouse button to create the new group.
Related Topics
Overview of Simulator Tool State Builder Menus
Adding a New State Adding an Event
Import and Export State Machines
• SQL Export - this format is used to exchange a single Capital Analysis object between
databases.
• StateMate - state charts can also be imported from StateMate.
Exporting
State Machine can be exported from various format. The state machine should be saved before
the export is invoked. To invoke the export dialog, click the File->Export menu. This will open
the Export StateMachine window.
Select the type of object you want to export to and click NEXT. Follow the instructions until the
object is exported.
• SQL Export - this format is used to exchange a single Capital Analysis object between
databases.
• EPS (encapsulated postscript) - this format can be used to include state machine
diagrams into word processor documents.
Related Topics
State Builder
Related Topics
State Builder
Related Topics
State Builder
See the language reference guide for more information about conditions and actions.
Related Topics
State Builder
See the language reference guide for more information about conditions and actions.
Related Topics
State Builder
Related Topics
“Overview of Simulator Tool” on page 39 Adding a New State
Adding an Event Adding a Concurrency Group
Import and Export State Machines State Builder Menus
Under Capital Analysis electrical circuits can be simulated using three different types of
simulator, depending on the simulation type chosen by the engineer. In order to perform Spice
(Numeric) simulations and extract results, QSchemes must be defined.
Overview of QScheme Builder . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 233
Checking the QScheme . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 234
Defining QScheme Bands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 236
Opening an Existing QScheme . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 238
Opening an Existing QScheme . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 238
QScheme Menus. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 239
QScheme Warning Dialog. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 240
QScheme Wizard . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 242
Saving QSchemes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 243
Overview of QScheme Builder . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 233
Building QSchemes
The QScheme Builder is used to create and edit QSchemes, shown below:
There are a number steps involved in building/modifying a QScheme these are as listed below:
1. Creating a QSchemee using the QScheme Builder Wizard (see “Creating a New
QScheme” on page 242).
2. Opening QSchemes (see “Opening an Existing QScheme” on page 238).
3. Defining bands (see “Defining QScheme Bands” on page 236).
4. Checking the QScheme (see “Checking the QScheme” on page 234).
5. Saving QSchemes (see “Saving QSchemes” on page 243).
Related Topics
QScheme Menus QScheme Wizard
• No bands can have empty labels or values.No duplicate string values are allowed.
The above rules can be checked automatically.
Running a Check
If a QScheme is not already open, open one.
Select Tools > Check Integrity or alternatively select the check integrity tool button, .
Any errors that will affect the use of the QScheme will be reported.
Errors
The errors found in the QScheme are reported in the following way:
• Overlapping Bands
An error dialog will appear that contains a list of bands that overlap with other bands, as
shown:
It must be noted that you cannot save a QScheme that contains overlapping bands.
• Dead Bands
An error dialog will appear that contains a list of all the dead band in the scheme. This
comprises of a band for each of the range of numbers not covered by the QScheme, as
shown:
To add the dead bands to the QScheme click OK, to ignore click Cancel. However you
cannot save a QScheme that contains dead bands.
• Missing Entries
If empty labels or values exist then the following dialog appears:
Numerical QSchemes
These contain bands with three fields, the label, the minimum value and the maximum value.
The following steps create a new band.
1. To add a band, click on Edit > Add Band, from the menubar, or on the add band button,
, in the toolbar. If bands are present, the new band will be inserted at the high-lighted
position, otherwise it will be added to the end of the table.
2. Default values will be automatically inserted into the band. The label can be changed by
entering the label cell of the band by double clicking on it as shown below:
5. Change the value by entering a number. This can be an integer or floating point format
number.
6. The minimum value may be minus infinity, this can be entered by clicking once in the
cell and selecting the -INFINITY from the list.
7. Set the maximum value for the band by double clicking on the maximum value cell of
the band:
String QSchemes
These contain bands with two fields, the label and the string value. The following steps create a
new band:
1. To add a band, click on Edit > Add Band, from the menubar, or on the button in the
toolbar. If bands are present, the new band will be inserted at the high-lighted position,
otherwise it will be added to the end of the table.
2. Default values will be automatically inserted into the band. The label can be changed by
entering the label cell of the band by double clicking on it:
3. Set the string value of the band by clicking on the string value cell:
Editing QSchemes
A QScheme may need to be edited. To change the value in a text field (e.g. the bands label)
click on the cell and enter the new text. To change the value in a numeric field (e.g. minimum
value) double click on the cell and enter the new value, if the value is to change to infinity then
select it from the drop down list that appears in the cell. Further bands can be added at a later by
selecting Edit > Add Band, from the menubar, or clicking on the button in the toolbar.
Deleting bands is achieved by selecting the band and selecting Edit > Delete Band, from the
menubar, or clicking on the button in the toolbar.
Ordering QSchemes
The QScheme may be sorted. Depending on the QScheme type affects the way sorting is
performed. Numerical QSchemes are sorted by the minimum value, string QSchemes are sorted
alphabetically by the label field. To sort the QScheme select Tools > Sort Bands, from the
menubar, or click on the sort tool button , from the toolbar.
Procedure
1. If the QScheme builder is not already open then it should be started. This can be done by
pressing Space Bar and entering QScheme Builder.
2. To open an existing QScheme either select File > Open from the menubar or click on
the Open button in the toolbar, .
3. Navigate and select the QScheme you wish to open in the open dialog and click Open.
QScheme Menus
The following section describes the contents of the menubar in the QScheme Builder.
File Menu
The File menu option are shown below:
Edit Menu
• Cut - Cuts the selected band from the QScheme and places it on the clipboard.
• Copy - Copies the selected band from the QScheme to the clipboard.
• Paste - Pastes a band from the clipboard into the QScheme.
• Add Band - Adds a band at the selected location in the QScheme.
• Delete Band - Deletes the selected band from the QScheme.
Tools Menu
• Check Integrity - Runs checks on the QScheme to ensure it is valid.
• Sort Bands - Sorts the QScheme bands.
Help Menu
• Current - Displays help regarding the current context.
• Contents - Displays help contents.
• Index - Displays the help index.
• Search - Searches the help system for a given topic.
• About - Displays version details regarding Capital Analysis.
Note
You cannot save a QScheme that contains overlapping bands.
• Dead Bands
An error dialog will appear that contains a list of all the dead band in the scheme. This
comprises of a band for each of the range of numbers not covered by the QScheme, as
shown:
To add the dead bands to the QScheme click OK, to ignore click Cancel. However you
cannot save a QScheme that contains dead bands.
• Missing Entries
If empty labels or values exist then the following dialog appears:
Related Topics
Checking the QScheme
QScheme Wizard
Selecting File > New in the Quantization Scheme Builder window will start the QScheme
Wizard which will help you create a new QScheme. The first wizard screen describes the steps
involved in the wizard.
In the second wizard step you must select the QScheme type. String QSchemes are used for
interpreting Saber simulation results when the Saber simulation engine returns string values. If
you choose to create a String QScheme the wizard will finish at this step. Numeric QSchemes
are used for matching numeric values with text labels.
If you have chosen to create a Numeric QScheme then the third step of the wizard will ask you
to select the type of Numeric QScheme you wish to create. Voltage, Resistance and Current
QSchemes are used in component models to enable Spice simulations. The Other option is used
for creating QSchemes used in component mappings.
If you chose to create a Voltage QScheme then a forth step of the wizard will ask you to select
between creating a Normal or Logic Voltage QScheme. The Logic option is used for QSchemes
which are going to be used with digital component models e.g. that use high and low signal
levels. The Normal option is best used for all other component models such as motors or lamps.
When you have selected all the appropriate options in the wizard click Run to close the wizard
and open you new QScheme in the Quantization Scheme Builder. Use the Quantization Scheme
Builder to complete your QScheme.
Related Topics
QScheme Menus Opening an Existing QScheme
Defining QScheme Bands Checking the QScheme
Saving QSchemes
Saving QSchemes
The following describe saving QSchemes. In order to save a QScheme it must first pass the
integrity checks.
The integrity checks are run upon saving and any errors will prevent the save operation (see
“Checking the QScheme” on page 234).
1. Select File >Save from the menubar, or the save button in the toolbar, .
2. If the QScheme fails the integrity checks then the errors need to be removed before
continuing.
3. In the save dialog that has appeared navigate to the location where the QScheme is to be
saved, the save dialog is shown below:
The Analysis Settings dialog is for setting the analysis project model to be used with the
Capital Integrator project.
It's also used for setting any global expressions. See “Assigning a Project” on page 245 to find
out how to set the project. Examples of global expressions are battery voltage or temperature of
a zone, such as:
Capital SimProject. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 91
Assigning a Project . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 245
Assigning a Project
After creating an analysis project, the next step is to assign it to a Capital project. To do this
follow the steps below.
Procedure
1. Open a Capital project in Capital Project.
2. Open the 'Projects' folder , and ensure that you can see all the folders in the Capital
project you loaded in step 1.
3. Right-click on the 'Analysis' folder, click on 'Edit' in the pop-up.
4. Click on the file open button , in the 'Analysis Settings' dialog.
5. In the file chooser, select the analysis project model, click 'Open'.
6. Click 'OK' in the 'Analysis Settings' dialog.
In Capital Logic, analysis scoping provides a way to set the scope or perimeter of the
simulation, and thus the analysis. Every conductor, device and logical connection in the scope
will be simulated. A scope can be a design or a build list.
To find out more about more about designs and build lists, please consult the Capital Logic and
Capital Project user guides.
Procedure
Alternatively:
1. Create an Analysis build list containing designs that you want to analyze in Capital
Logic or Capital Project.
2. Open a project in Capital Logic.
3. Set the Analysis build list as active in Capital Logic by pressing Space Bar and entering
Set Active.
4. Open a diagram from the analysis build list.
5. To run an analysis, select one of the analysis options by pressing Space Bar, entering
Analysis and selecting one of the analysis options.
Note
Setting an active Logic build list within a Capital Logic desig does not set the analysis
scope to that build list. If you run an analysis when a Logic build list is active, the
analysis runs on either the last scope that was set or, if no scope has been set, on the
currently active design.
Related Topics
“Overview of Simulator Tool” on page 39
Only available from within the Capital Integrator application, this dialog offers a method for
investigating the simulation feedback and variables of design objects during simulation, drilling
down to data that cannot be displayed using visual feedback on the Capital Integrator plane.
The following topics detail the use of the Design Inspector:
Procedure
1. Set the analysis scope to the open plane by right-clicking on the plane name in the
design browser, then selecting Analysis > Set Scope.
2. Either:
• Right-click on the plane in the design browser and select Analysis > Simulator
• Press Space Bar and enter Simulator
The Simulator Tool is displayed.
3. Begin the simulation. See “Running a Simulation” on page 49 for more information.
4. Press Space Bar and enter Show Design Inspector. The Design Inspector is displayed.
Related Topics
“Using the Design Inspector with Capital Analysis” on page 250
Object Browser
With no objects selected on the Capital Integrator plane, this tree menu displays all objects on
the plane - namely bundles, slots, connectors and nodes. Selecting an object on the plane
restricts the display to the selected object.
• Parent
Displays object names and relationships. Clicking on the plus [+] symbol to the left of
an object in the menu expands the tree to show the child objects of the selected parent.
For example, expand a bundle to view the wires routed through it; expand a connector to
view its pins; expand a slot to view the devices placed within it.
• From/To
Displays the points at which conductors and connectors are electrically connected. For
example, for conductors, the terminating pins are displayed; for connectors, directly
connected devices and/or bundles are displayed.
• Activity
All conductors and objects with analysis models attached have an entry in this column,
where they are listed as either active or inactive. Additionally, a block of color indicates
the object’s state, following the same coloring rules as applied when displaying
simulation feedback on the Capital Integrator plane; for wires, the direction of current
flow is indicated by an arrow.
Clicking on an electrical object (a conductor or an object with an analysis model attached)
enables the second area of the Design Inspector: the object data display.
Object Data
Only enabled when an electrical object is selected in the object browser, these two tabs display
the simulation data and the state of all variables applicable to the object:
Tooltip
This tab, only applicable when running a numeric or supported external simulation type,
displays all of the information that would be available in a tooltip when running a dynamic
simulation. The tooltip data for a selected device or conductor varies according to the behavior
and structure of the attached model.
Variables
This tab displays all electrical simulation results available for the selected object, as would
otherwise be displayed in the Simulator’s Property Viewer. The list of results includes any
component interfaces configured for the model, as well as properties and scripted variables.
Once the plugin has been placed in the correct location, check it has been loaded and refresh the
installed plugins list if necessary. Open Capital Integrator, press Space Bar and enter Plugins. If
the custom plugin is not displayed in the Available Plugins list, click the Reload All button to
refresh the list. Once you have verified that the plugin is present, close the dialog.
Capital Analysis supports the encryption of component models as encrypted XML (.exml) files,
allowing you to share your library models with your customers or other third-parties without
exposing your intellectual property (IP). Although it will be possible for third-parties to
simulate designs using your encrypted models, as well as being able to view all component
interfaces, it will not be possible to view the structure or behavior of a model, or edit the model
in any way. Additionally, only external model properties (of Direction: Input) and pin
attributes will be available for reporting purposes.
Overview of Component Model Encryption . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 253
Exporting Encrypted Components. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 254
Importing Encrypted Components . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 256
• Simulating a design
• When exporting a component model with a template attached, the necessary template
information will be included within the encrypted model, allowing it to operate correctly
on a system that does not have access to the template.
• When exporting a component model with a VHDL dependency, a message will be
displayed to warn that a VHDL dependency exists. It will be necessary to export any
referenced VHDL models from the External Model Manager and supply these to the
third party before the encrypted components will be usable. See “External Model
Management” on page 281 for more information on exporting VHDL models, and see
“Encrypting VHDL-dependent components” on page 256 for information on how to
import and use VHDL-dependent models.
Related Topics
“Exporting Encrypted Components” on page 254
To export a component
1. Open the Object Manager and navigate to the component model you wish to export.
2. With the model highlighted, select Tools > Export Encrypted... from the menu.
Note
You can select multiple components for export by holding down the CTRL or SHIFT
keys while selecting subsequent models; CTRL will allow the selection of multiple, non-
adjacent components, SHIFT will allow the selection of two components along with all
components in-between.
3. The Choose Encryption Key dialog will be displayed. The key flagged as the default
on the Encryption tab of the Configuration Tool will be offered, but you can select a
different key from the list if required. Once the correct key is selected, click OK.
4. A Save dialog will be displayed. Navigate to the location in which you wish to place the
encrypted component file (.exml) before clicking the Save button. If you selected
multiple components for export, a Save dialog will be displayed for each one, allowing
you to modify the file name and location in which to save the component each time.
5. Once the encrypted model has been successfully saved, a message will be displayed to
inform you; click OK to confirm and clear the message. If you chose to export multiple
components, the message will display the number exported.
Note
Note that the Files of type field displays “(Folders)” instead of listing the file type of the
encrypted models. The models will, however, be saved as individual encrypted
component models (.exml files) within the selected location.
5. Once the encrypted model has been successfully saved, a message will be displayed to
inform you of the number of models that have been exported; click OK to confirm and
clear the message.
To import a component
1. Open the Object Manager and select Tools > Import Encrypted... from the menu.
2. An Open dialog will be displayed. Navigate to the location in which the encrypted
component file (.exml) is stored, select it, then click the Open button.
Note
You can select multiple components for import by holding down the CTRL or SHIFT
keys while selecting subsequent models; CTRL will allow the selection of multiple, non-
adjacent components, SHIFT will allow the selection of two components along with all
components in-between.
Note
If the key used to encrypt a model cannot be found, a message will be displayed to inform
you that the import has failed. The message will be display the name of the missing key
file, allowing you to take steps to remedy the problem before attempting the import again.
Click OK to clear the message and cancel the import.
3. A dialog will be displayed prompting you to select the location in Capital SimCore in
which you wish to place the imported component. Navigate to the desired location, enter
a name for the component model in the Object field, then click the Save button. If you
have selected multiple components to import, the dialog will be displayed once for each
component.
4. Once the encrypted model has been successfully added to Capital SimCore, a message
will be displayed to inform you; click OK to confirm and clear the message. If you
selected multiple components to import, the message will display the number of
components imported.
1. In the External Model Management screen, select the VHDL models required by the
encrypted component models and export them to a new export library. See “External
Model Management” on page 281 for more information on exporting VHDL models
libraries.
2. The VHDL library will be compressed to a .zip file. Transfer this to the third-party
system and unzip it into <install_location>\tools\adms\[library_name], replacing
[library_name] with the name given to the new VHDL library during export, creating
this directory if necessary.
3. Navigate to <install_location>\resources\resources and edit the RunTime.properties
file.
The new library needs to be identified to the system, and this is achieved by modifying
the following section:
These two lines hold the name and location of the work library (the WORK_LIBRARY
references will hold the name of the actual work library). To add the new library in
addition to the work library, add a carriage return, then add the following lines:
netsim.simapi.library.attach=LIBRARY_NAME
netsim.simapi.library.attach.LIBRARY_ABC.path=L:/Example/Project/si
m_adms/netlist/LIBRARY_NAME
substituting the real library name and the location of the library directory.
Once Capital Analysis has been restarted, the new library will be available to the
system.
1. Before the VHDL-dependent models can be exported, they must be edited to reference
the new library. Refer to “Embedding VHDL-AMS Models” on page 187 for
information on how to edit the library reference.
2. Export the encrypted, VHDL-dependent component(s) and transfer them to the third-
party system, ensuring that the relevant encryption keys are also transferred.
3. Import the encrypted models into the Component Database. See “Importing Encrypted
Components” on page 256 for more information.
This chapter details the various menus and dialogs available in Capital Analysis.
Export Netlist . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 259
Edit Stress Report Styles . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 260
General Dialogs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 261
About Dialog. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 261
Error Report Dialog . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 261
Filter Wizard . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 262
Find And Replace Dialog . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 263
Input Dialog . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 264
Object Properties Dialog. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 264
Open/Save Object Dialog . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 265
Printing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 265
Progress Dialog. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 266
Console . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 266
Database Dependency Check Dialog . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 267
Export Netlist
This option allows you to export the netlist to XML or Saber format.
Exporting to XML
To export to xml, follow the steps below:
Caution
Deleting a stress style cannot be undone.
o To export a stress style (other than the defaults), first select it in the Stress Styles
list, then click the button to launch the Export Report Style dialog. See Import and
Export of Stress Styles for more information.
o To import a stress style, click the button to launch the Import Report Style dialog.
See Import and Export of Stress Styles for more information.
o To copy an existing stress style, first select it in the Stress Styles list, then click the
button. In the New Name dialog, enter a name to identify the new style before
clicking OK. The style is added to the Stress Style list, from where you can select
and edit it.
o To rename a stress style, first select it in the Stress Styles list, then click the
button. In the New Name dialog, enter the new name for the style before clicking
OK.
General Dialogs
The following dialogs can be accessed from a number of points within Capital Analysis.
About Dialog. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 261
Error Report Dialog . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 261
Filter Wizard . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 262
Find And Replace Dialog . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 263
Input Dialog . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 264
Object Properties Dialog. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 264
Open/Save Object Dialog . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 265
Printing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 265
Progress Dialog. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 266
Console . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 266
Database Dependency Check Dialog . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 267
About Dialog
This dialog shows information about the build of Capital Analysis installed on your system,
specifically the Release Number and Release Date. This information will be necessary if you
ever need to log a support call against your software.
SERIOUS ERROR: These messages indicate serious problems that will stop a
simulation from running. Such messages are usually raised as a result of external
problems (lack of memory, no room on the hard disk)
For more general information, see the sections on the language reference guide supplied in the
install CD and “Troubleshooting” on page 317.
Filter Wizard
The filter wizard is used to import or export an object in Capital Analysis to/from an external
format. Merely select the required import/export operation, click the NEXT button and follow
the instructions.
To find a string
1. Enter the text string into the Find text field.
2. Click the Find next button start the search.
3. The string should now be highlighted in the text editor.
4. Press the Find next button again to find the next string.
5. Continue pressing the Find next button for each text string you wish to find.
6. To quit, click the windows exit button.
Input Dialog
The input dialog allows a text string to be entered into Capital Analysis.
An example of its use is the Go To dialog:
Enter the line number you which to go to and press the [OK] button. Press the [Cancel] button to
return without entering the text.
The Name field indicates the name of the selected object. The Id field indicates its unique
database id. The Type field indicates the type of the object. The Location indicates the folder
the object resides within. The Created at section give a date stamp and user on creation. The
Last modified at gives a date stamp and user when last modified. The Lock section shows all
the locks on the object. In the above example there are no locks. Click OK to close the dialog.
Related Topics
Object Manager
It should be noted that when you are opening an object, you cannot enter the name in "Object:"
box. The required object must be selected.
Related Topics
Object Manager
Printing
In many of the Capital Analysis family windows you will be able to select Print and Print
Preview... from the File menu. The Print option will send the appropriate pages straight to your
default printer. The Print Preview option will open the Print Preview window so you can see
all the pages laid out.
If you select File > Page Setup within the Print Preview window, then the Page Setup dialog
will be displayed.
The Page Setup window allows you to set the page size, source, orientation and margins.
Related Topics
Component Builder Related Menus Simulator Tool Menus
Progress Dialog
The progress dialog appears whenever an operation could take a significant length of time. The
name of the operation is shown in the title. The progress of the operation is indicated by the
progress bar and the estimated time remaining.
The operation can be stopped by clicking the Stop button.
Related Topics
Run Scenario Wizard Capital SimCertify Menus
Console
If there are any print statements in the behavior of any component, these messages will be
displayed in this window. Furthermore, if the Spice module is installed, important information
about the Spice simulation may appear here.
This facility is available in the Overview of Simulator Tool. An example window is shown
below.
It should be noted that print statements may be displayed more times than there are steps in a
simulation. This is because some statements may be evaluated multiple times within a
simulation step. Also, this window is not cleared unless this is specified in the Edit Options
Dialog. As a result, print statements will be added to the console when further simulations are
done. This window will be closed when the Overview of Simulator Tool is closed.
Menubar
This window has the following menu entries:
Edit > Options: This menu entry opens the options dialog. See “Edit Options Dialog” on
page 269 for more details.
View > Clear Console: This clears all the messages in the console.
Related Topics
Overview of Simulator Tool
To continue with the delete operation click Yes. Any affected subsystems will no longer work
unless a new component model is used to replace the deleted one. The component model
attacher (see “Attaching Component Models” on page 199) can be used to replace the deleted
Component Model with a new one. If, however, you do not want to affect the other objects or
are unsure for any reason, click CANCEL and the object will not be deleted.
Related Topics
Object Manager
This chapter details the various global and user option settings available in Capital Analysis.
Edit Options Dialog . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 269
General Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 271
Syntax Highlighting Options. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 271
Automation Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 274
RPN Default Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 274
Report Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 275
Simulation Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 275
Simulation Highlighting . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 275
Model Search Path. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 278
Component Categories . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 279
Error Reporting . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 279
Qualitative Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 279
Modeling Language Options. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 280
Simulation Engine Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 280
Numeric Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 280
Spice Simulator Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 281
External Model Management . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 281
Structure Editor Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 287
State Builder Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 288
Fields
The right-hand pane changes based on the selection made on the left-hand pane. If you select a
color option in the left-hand pane, for example, the right-hand pane will change to the color
selection options (see “Changing Color Options” on page 272). Similarly, if you select a font
options in the left hand pane, the right-hand pane will change to contain the font selection
options (see “Changing Font Options” on page 273).
• General contains options like the look and feel of the GUI.
• Qualitative contains options for the qualitative simulation engine module.
• Numeric contains options for the Spice simulation engine module and the VHDL-AMS
external model manager.
• State Builder contains options for the qualitative simulation engine module. This
section will only be present if the edit option dialog is opened from the State Builder.
• Structure Editor contains options for the qualitative simulation engine module. This
section will only be present if the edit option dialog is opened from the Structure Editor
(see “Defining Component Structure” on page 167).
Related Topics
General Options Qualitative Options
Numeric Options Structure Editor Options
State Builder Options
General Options
See the following topics for details of the options that can be changed in this section.
• “Syntax Highlighting Options” on page 271
• “Automation Options” on page 274
• “RPN Default Options” on page 274
• “Report Options” on page 275
• “Simulation Options” on page 275
• “Simulation Highlighting” on page 275
• “Model Search Path” on page 278
• “Component Categories” on page 279
• “Error Reporting” on page 279
Related Topics
Qualitative Options Numeric Options
Structure Editor Options State Builder Options
• Operators: changes the color of operators used in the Saint modeling language.
• Constants: changes the color of constants used in the Saint modeling language.
See “Changing Color Options” on page 272 for details on changing these options. You should
try to avoid using the same colors for more than one of these options.
To turn off syntax highlighting, select Syntax highlighting in the left-hand pane and uncheck the
Syntax highlighting enabled box.
Note
It should be noted that the color may look slightly different if viewed on different
computers or monitors.
Swatches tab
To select a color using this tab, follow these steps:
1. Click on the color you wish to use.
2. Look at the preview section to ensure that this is the color you want to use.
3. Click on a different color if it is not to your liking.
4. Click on the color in the recent box to go back to a color you have recently clicked on.
5. Click OK to accept the color change and Cancel to reject it.
HSB
To select a color using this tab, follow these steps:
RGB
To select a color using this tab, follow these steps:
1. Move the slider to set the red to select the red intensity value for the required color.
2. Move the slider to set the green to select the green intensity value for the required
color.
3. Move the slider to set the blue to select the blue intensity value for the required color.
4. Look as the preview section to ensure that this is the color you want to use. Repeat the
previous steps if it is not.
5. Click OK to accept the color change, Cancel to reject it or select another option to
change from the list in the left-hand pane.
1. In the browser tree on the left of the facility, select the object font that you want to edit
(for example, the name font for states).
2. Select the font you require using the first combo-box:
3. Select the type of font you require using the second combo-box:
4. Select the size of the font you require using the third combo-box:
5. Look as the preview section to ensure that this is the font you want to use. Repeat the
previous steps if it is not.
6. Click OK to accept the color change, Cancel to reject it or select another option to
change from the list in the left-hand pane.
Automation Options
This section allows you to turn on/off various automation options.
• Map values - should pins be automatically mapped in the component attacher (see
“Attaching Component Models” on page 199).
• Console refresh - should the console be refreshed automatically.
• Integrity check - should the integrity of objects be checked when those objects are
saved.
Report Options
The Report section of the Edit Options facility sets various options for report generation:
• Encapsulate all function labels in double quotes - should they be encapsulated in
double quotes in the reports generated by Capital Analysis.
• Generate all text for a report in - this combo-box allows you to select the language
used in the reports generated by Capital Analysis.
Simulation Options
In the Simulation section of the Edit Options facility, various qualitative simulation options
can be changed.
• Automatic Reset of Catastrophic Failures in Interactive Simulation - if this option is
set the catastrophic failures, such as short circuits and blown fuses, are reset prior to re-
simulation being run in interactive simulations.
• Enable caching of component information across a session - if set, this option caches
information on all components until the session is closed.
• Enable logging of debugging info during component information reading - this
option allow detailed debugging information to be recorded in a log file during
component information reading.
• Ensure netlist is present before reading simulation information - option for
checking that the netlist is present before simulations start.
Simulation Highlighting
The Simulation Highlighting option in the Edit Options facility allows the user to define
labels that map to colors. These are then used to colour components and wiring in diagrams
during simulation. Once defined, the user can modify the color of the component or wire by
using the label within the component behavior, acting on some condition of the device, over-
current for instance.
The left panel contains a list of defined highlighting labels.
The right panel contains a name field of the label, and the color setup itself. This panel has
tabbed options if the ECAD tool is using white or classical black backgrounds. This will allow
alternative colors if the background is toggled. There are some sub-tabs to set the color. Please
see “Changing Color Options” on page 272 for details about the use of the color selector.
Add/Update and Remove buttons are below this section for adding a newly defined highlight,
updating an existing one or deleting an entry from the list.
Deleting a Highlight
1. Select the highlight from the Defined Colors list
2. Click on Remove
Adding a Path
To add a path:
Deleting a path
To delete a path:
Component Categories
This option in the Edit Options facility is to specify the categories that components are
organised under when using Capital Analysis. This allows more productive use of the tool as
components can be listed, selected and manipulated by category, for example.
There are number of reserved categories also that are listed. These cannot be removed or
modified. Once categories are specified, they will be available in the Component Builder.
Adding a Category
1. Click on the Add button
2. Enter a name in the Category Name dialog
3. Click OK
Edit a Category
1. Select the Category, click on the Edit button
2. Edit the name in the Category Name dialog
3. Click OK
Delete a Category
1. Select the Category
2. Click the Remove button
Error Reporting
In the Error Reporting section of the Edit Options facility, various qualitative simulation
options can be changed.
• Enable the display of additional warning messages - this option will show extra
warning messages in the console and integrity checking dialogs.
• Enable full debugging information to be logged- this option allows detailed
debugging information to be recorded in a log file.
Qualitative Options
See the following topics for the options that can be changed in this section of the Edit Options
facility:
Related Topics
General Options Numeric Options
Structure Editor Options State Builder Options
Numeric Options
Various options can be changed in this section of the Edit Options facility.
• “Spice Simulator Options” on page 281
• “External Model Management” on page 281
Related Topics
General Options Qualitative Options
Structure Editor Options State Builder Options
4. Enter a unique name for the model in the Name field. This name must be unique, as it
will be used to identify the model when selecting/ordering it within the External Models
list; the "OK" button will be unavailable until the name in the field is unique.
5. Enter the code for the model into the Source field. Typically, you will open your VHDL
"*.vhd" file in a standard text editor (Windows Notepad, for instance) and copy the
contents before pasting it into the Source field. Standard Cut, Copy and Paste
functionality is available within the dialog:
• To cut, either click on the button, or press Ctrl+X.
• To copy, either click on the button, or press Ctrl+C.
• To paste, either click on the button, or press Ctrl+V.
6. Click the "OK" button to close the dialog. The model will be created and added to the
External Models list.
Note
You must compile the new model you have created before you will be able to use it. Any
attempt to reference an uncompiled external model from within a script will result in an
error during simulation.
Note
When compiling more than one model, or using the "Rebuild the model library from
scratch" option, as detailed below, the order in which the models will be compiled is
determined by their position within the External Models list. If one model references
another, the referenced model must be compiled first to avoid generating an error. Refer
to the section on managing the external model list, below, for more information.
Note also that while a model is being compiled it will not be possible for another user on
the system to amend or delete that model. During a rebuild (see below) no models can be
amended or deleted.
4. Click the "Compile the selected models" ( ) button. The status pane of the Edit
Options dialog will display a message to confirm the success or failure of the
compilation. Following a successful compilation, the compiled model will be added to
the database, where it will be available for use during simulation.
Note
Compiled models are stored in the database for reasons of performance during simulation
only; they cannot be viewed or accessed from within the Object Manager.
5. You can delete all compiled models from the database and recompile all models in the
list by clicking the "Rebuild the model library from scratch" ( ) button, which will
ensure that all models are compiled using the most up-to-date code available. Models
will be compiled in list order so, again, ensure that the list is ordered correctly to ensure
that models referenced by other models are compiled first. See the section on managing
the external model list, below, for more information.
To change a model's position within the list, you must first select it by clicking on it. You can
select multiple models by Shift-clicking a number of adjacent models, or by Ctrl-clicking a
number of non-adjacent models. Once you have selected one or more models to move, the
following options are available:
• Move to top ( ) - the selected model(s) will be moved to the top of the list. If you have
selected more than one model, the model order within the selection will be maintained.
• Move up ( ) - all selected models will be moved one position higher in the list.
• Move down ( ) - all selected models will be moved one position lower in the list.
• Move to bottom ( ) - the selected model(s) will be moved to the bottom of the list. If
you have selected more than one model, the model order within the selection will be
maintained.
Clicking the "Refresh the selected models" ( ) button will update the External Model
list to reflect any changes that other users may have made since you have been viewing
the list, including the creation and deletion of models.
1. Select the model you wish to edit and click the "Edit the selected model" ( ) button.
Alternatively, double-click on the model you wish to edit.
2. The Edit VHDL dialog will be displayed.
3. You can rename the model by overwriting the contents of the Name field, but the name
must still be unique; if you attempt to change the name to that of an existing model, the
"OK" button will be disabled, forcing you to change the name back before you can save
the model.
4. You can amend the contents of the Source field as required. The option to search for
specific terms within the source code, and to find and replace terms, is available by
clicking on the "Find text in expression" button ( ) to access the Find And Replace
Dialog.
5. Once you have finished editing the model, click on "OK" to save the changes to the
database and close the Edit VHDL dialog.
1. In the Object Manager dialog, select Tools > Admin Mode from the main menu.
2. An Enter Password dialog will be displayed. Enter your administrator password and
click the "OK" button.
3. The Object Manager dialog will be renamed "Administrator" to indicate that you are
now operating in Administration Mode. Also, the Tools > Admin Mode menu option
will be ticked.
4. Select Tools > Unlock VHDL Models from the main menu.
5. A message will be displayed to confirm that all external models have been unlocked
successfully.
Note
The Unlock VHDL Models option will remove the locks on ALL models; you cannot
choose which models to unlock.
required VHDL models are available in the destination Capital Analysis installation when the
encrypted models are imported.
Caution
In order for the VHDL dependancies to be maintained in the destination Capital Analysis
installation, the VHDL models must be exported first, then the VHDL-dependent models
must be edited to reference the new VHDL library before exporting them. Refer to
“Embedding VHDL-AMS Models” on page 187 for more information on editing the
library references within the component models.
1. Select the models you wish to export. Click on a single model to select it, Shift-click on
non-adjacent models to select those models and all in-between, or CTRL-click to select
multiple, non-adjacent models.
2. Click on the Export Selected Models icon. The Library Name dialog will be displayed.
3. When you export the VHDL models, they will be compiled into a temporary library,
which will then be compressed into the archive file. Enter a name for the library in the
field. The Delete temporary library when finished? option allows you to specify
whether this library should be deleted once the archive file has been created; this is
selected by default, and should be deselected if you want to use the temporary library for
testing your edited VHDL-dependent component models.
4. Click the OK button. If the library name you entered in step 3 matches one already in
use, you will be prompted to enter a new name, otherwise a Save dialog will be
displayed. Navigate to the location in which you wish to save the archive (.zip) file and
enter a File name before clicking the Save button.
5. The compressed archive file will be created and saved in the specified location. This file
can then be copied to the target Capital Analysis installation and unzipped, recreating
the library structure. Before this library can be accessed on the target system, its location
must be added to the RunTime.properties file located in the /resources/resources/ sub-
directory of the Capital Analysis home folder. Within the section beginning:
# Capital Transient properties
netsim.simapi.library.attach=LIBRARY_ABC
netsim.simapi.library.attach.LIBRARY_ABC.path=L:/Example/sim_adms/n
etlist/LIBRARY_ABC
replacing LIBRARY _ABC with the name of the compiled library, and
“L:/Example/sim_adms/netlist/LIBRARY_ABC with the full path to the library file.
Note
You can define multiple compiled libraries in this way by adding subsequent library
names to the definition, separated by a space. For example:
netsim.simapi.library.attach=LIBRARY_ABC LIBRARY_DEF. Once the libraries have
been defined, each will need a separate line specifying the path to the library file.
Related Topics
“Embedding VHDL-AMS Models” on page 187
• Editing
o Automatic edit - determine if nodes, arcs and comments should be edited
automatically when they are first created.
o Grid Preferences - should the grid be on when you first open the structure editor?
• Drawing Objects
o Text Options
• Name font - changes the font used for the names of nodes and arcs.
• Name color - changes the color used for the names of nodes and arcs.
• Link Options
o Link color - changes the color used for the links between nodes and arcs.
• Node Options
o Node color - changes the color used for nodes.
o Node failure color - changes the color used nodes when a failure is applied.
• Arc Options
o Arc color - changes the color used for arcs.
o Arc Failure color - changes the color used arcs when a failure is applied.
o Display arrow on arcs? - should arrows that indicate FORWARD current flow be
shown on the arcs?
• Comments
o Background color - changes the background color used for comments.
o Foreground color - changes the foreground color used for comments.
o Border color - changes the border color used for comments.
o Font - changes the font used for comments.
Related Topics
General Options Qualitative Options
Numeric Options State Builder Options
• File Operations
o Automatic integrity check - determine if an integrity check should be performed
when the state machine is saved.
• Editing
o Automatic edit - when a state or event is first created, should the edit for that object
be opened.
• Drawing objects
o States
• Inactive color - changes the colors used when states are inactive whilst being
simulated.
• Active color - changes the colors used when states are active whilst being
simulated.
• Foreground color - changes the color used for a state whilst being viewed or
edited.
• Name font - changes the font used for the name of the state.
• Action font - changes the font used for the actions within the state.
• Concurrency groups
o Foreground color - changes the color used for a group whilst being simulated,
viewed or edited.
• Events
o Inactive color - changes the color used when an event is inactive whilst being
simulated.
o Active color - changes the color used when an event is active whilst being
simulated.
o Unlinked color - changes the color used for an event that is not connected to a state.
o Foreground color - changes the color used for an event whilst being viewed or
edited.
o Name font - changes the font used for the name of the event.
o Condition font - changes the font used for the conditions for the event.
o Action font - changes the font used for the actions for the event.
• Comments
o Background color - changes the background color used for comments.
o Foreground color - changes the foreground color used for comments.
o Border color - changes the border color used for comments.
o Font - changes the background font used for comments.
Related Topics
General Options Qualitative Options
Numeric Options Structure Editor Options
This tool configures various global options. It should only be used by your support team and/or
the Capital Analysis Administrator.
Caution
None of the operations available in this tool should be carried out while other people are
using Capital Analysis.
Configuration Tool
This tool configures various global options. It should only be used by your support team and/or
the Capital Analysis Administrator.
Version
This tab displays the overall version number of Capital Analysis. In addition, a list of the
installed modules is given. It is important to check this tab if you have just installed an
additional module to Capital Analysis.
Diagnostics
This tab allow various diagnostic operations to be performed on Capital Analysis. Two
diagnostic checks are available:
• Installation - checks the Capital Analysis installation (this operation is not supported in
the current release).
• Database- checks the integrity of the Capital Analysis database, fixing all the errors that
it can.
This tab can also be used to tidy the database. This operation removes any temporary
information held in the database. Such information can remain in the database if Capital
Analysis crashes for any reason.
Data Sources
This tab allows the database that Capital Analysis uses to be configured. Once configured it is
not recommended that this information be changed. Capital SimCore can support multiple
different database configurations, these are all managed from this tab.
The current (active) configuration is shown in red. This can be changed by double clicking on
any of the entires. To Test a connection to ensure that the database server can be contacted, and
that the login details supplied are valid, highlight one of the entries in the list and select Test.
After a short delay you will be informed as to whether a connection could be made to the
database.
If you wish to make a copy of an existing data source, click on the copy button.
If you wish to delete an entry, highlight the entry in the list, before clicking on the Delete
button. Before the entry is deleted you will be prompted to confirm that you wish to perform
this action. If you do accidentally delete a connection, it will have to be re-created.
To add a new connection, click on the Add button. You will be presented with the connection
configuration wizard. In the first panel you must specify the RDBMS that you intend to use. A
list dropdown will contain all the supported types.
Note
The Oracle integration requires that a version of the Oracle client software is installed on
the client machine.
The next pane captures information on the location and access details for the specified RDBMS.
Your system administrator will have these details. Tick the Enable debugging button for
additional debugging information during the use of the tool. This can be useful if you are having
some problems with your connection.
Encryption Keys
This tab displays the details of the encryption keys that are available for use when exporting or
importing encrypted component models. See “Component Model Encryption” on page 253 for
more information.
The pane on the left of the tab shows all available keys, nested in any key files that have been
created. Clicking on a key to select it will result in its details being displayed in the fields on the
right of the tab, although the contents of the Key Code field will be replaced with asterisks for
security (in normal user mode).
In normal user mode, the only action that can be performed on this tab is the nomination of a
key as the default to be used when exporting an encrypted component model. This is achieved
by first selecting a key in the left-hand pane, then clicking the Use As default Key option. The
icon of the key will change from to to indicate that it is now the default.
Note
To create or delete keys, or to create a new key file, the Configuration Tool must be run
in Administration mode. See “Encryption Key Management” on page 302 for more
information.
Optional Components
The 'Optional Components' tab allows you to enable or disable optional components, so as to
prevent licensing warnings. Checking the boxes enables the components.
Datasource Administration
The Configuration Tool has as additional tab called Data Source Admin.
CapitalAnalysisConfiguration -dsAdmin
1. Select the data source you wish to populate from the Selected datasource drop-down
list. Click the Populate button.
2. The Populate datasource window is displayed. Check the Configure database box and
the Populate database box. Click the OK button.
3. The Tablespace file window is displaced. Specify the full path to the location of the
tablespace file that will be created for the database that you are using. You must create
the file in the same folder as the other tablespace files for the database that you are
using.
If the database is on the same computer as the Capital Analysis application, the path
looks something like this:
C:\ORACLE\ORADATA\CAPITAL
If the database is on a separate computer, you must ensure that the folder containing the
tablespace files is shared and that read/write permissions are set on it. You specify the
path to this folder as follows:
\\[name of server]\[shared folder name]
For example:
\\123.123.123.12\CAPITAL
Click the OK button.
4. A dialog requesting a username is displayed. You must enter the database administrator
username.
5. A second dialog requesting a user password is displayed. You must enter the database
administrator password.
6. The main window on the DataSource Admin tab shows the progress of the configuration
and population processes. The configuration process creates the CANALYSIS user and
the Capital Analysis tablespace. The population process creates the Capital Analysis
database schema (the databases and indexes used by the application). When the
processes are complete, the following is displayed in the output window:
Done POPULATE : Success = true
7. When the database is configured and populated, test the connection by clicking on it on
the Data Sources tab and clicking the Test button.
1. Select the populated data source from which you wish to transfer the data from the
Selected datasource drop down.
2. Click Transfer.
3. The Transfer data dialog is displayed. Select the target, unpopulated data source for the
transfer, from the Select target drop down.
4. Click OK.
5. The output window will display the progress of the transfer.
1. Select the data source you wish to backup from the Selected datasource drop down.
2. Click Backup.
3. The Backup datasource dialog is displayed. Click Choose file
4. A Save dialog is displayed. Navigate to the location in which you wish to save the
backup file and enter a file name before clicking on Save.
Related Topics
“Configuration Tool” on page 291
Note
Although this tab is available when operating the configuration tool in normal user mode,
the contents (with the exception of the Use As Default Key option) are uneditable. You
must be running the tool in -dsAdmin mode to make any other changes on this tab.
To create a key
1. In the pane on the left-hand side of the tab, click on a key file to highlight it. This is the
key file within which the key will be created.
2. Click the New Key... button. The New Key dialog will be displayed, allowing you to
enter a Key Name (mandatory) and a Description (optional) for the new key. Once you
have entered this information, click OK.
3. The key will be added to the selected key file. Selecting the key wil result in the fields
on the right of the tab displaying the key’s properties, as detailed in To create a key file,
above.
It is not possible to delete a key file from within the Configuration Tool. If you wish to delete a
key file, remove or delete the relevant .keys file from within <install_location>\resources\keys
(or from your custom location if you have created one); the next time you run the Configuration
Tool, the key file will have been removed from the tree menu.
To delete a key
Caution
It is not possible to recreate a key once it has been deleted. Key codes are generated by
the system when keys are created and cannot be manually entered. If you delete a key that
is still required for an existing component model, it will no longer be possible to import
that model or run a simulation with it attached.
3. A message will be displayed asking you to confirm the deletion: click Yes to proceed or
No to abort.
This section describes how various properties can be changed to adapt Capital Analysis to your
companies needs.
Changing these properties involves editing files in
<install_location>/resources/resources/ on UNIX or
<install_location>\resources\resources on Win32 platforms.
Generic Preferences
These files are called properties files. It is recommended that you backup these files before
making any changes. If more than one site in your company is using Capital Analysis, these
properties files can be modified at one site and then copied to the others.
Capital Analysis must be shutdown and restarted before changes to theses files will take effect.
Changing the properties used to generate and export reports will not change text in any existing
reports. Only the reports generated or exported subsequent to that change will be effected.
RunTime.properties
This file contains various runtime settings
netsim.progress.poll = 1
netsim.maintaining.properties.between.mode.changes = true
netsim.language.maths=true
This property is used to specify names of user defined constants (this must be done).
netsim.language.maths.list=PI E NEWCONSTANT1
The following properties implement the user defined list, note they are just examples.
Define PI.
netsim.language.maths.value.PI=3.141592654
Define E.
netsim.language.maths.value.E=2.718281828
Define NEWCONSTANT1.
netsim.language.maths.value.NEWCONSTANT1=1202.0309
Default QSchemes
Global default QSchemes can now be defined.
netsim.qscheme.default.current =
/CAPITAL/QSchemes/Enumeration/Current/switch_0A001_15A0
netsim.qscheme.default.resistance =
/CAPITAL/QSchemes/Enumeration/Resistance/switch_0R0_10M0
netsim.qscheme.default.voltage =
/CAPITAL/QSchemes/Enumeration/Voltage/battery_12V0
FmeaText.properties
The simulation engine uses the information in this file to generate text for FMEA reports (see
“FMEA Editor (Capital SimCertify)” on page 69.
The FmeaText<LANGUAGE>.properties files have the same format but are for a specific
<LANGUAGE> like French, German etc...
fmea.compare.hierarchically = true
fmea.compare.acrossEvents = true
fmea.consider.subsequent = true
• The text for this property is used when an unresolved simulation is detected.
fmea.text.err.unresolved = Sorry: unresolved simulation was
detected.
• The text for this property is used when a short circuit is not dealt with by a fuse.
fmea.text.err.short = A short circuit possibly caused uncontrolled
thermal activity.
• The text for this property is also used when a short circuit is not dealt with by a fuse.
fmea.text.err.short.also = However, uncontrolled thermal activity
still resulted in parts of the subsystem.
• The text for this property is used when a short circuit is not dealt with by a fuse.
fmea.conv.record.short=(resulting in uncontrolled thermal
activity).
• This property is used to form the title for the converted FMEA report.
fmea.conv.header.title=FMEA report for
• This property is used as the title for the FMEA number field of the header.
fmea.conv.header.fnum=FMEA Number
• This property is used as the title for the product field of the header.
fmea.conv.header.product=Product
• This property is used as the title for the system field of the header.
fmea.conv.header.system=System
• This property is used as the title for the FMEA date field of the header.
fmea.conv.header.fdate=FMEA Date
• This property is used as the title for the key date field of the header.
fmea.conv.header.kdate=Key Date
• This property is used as the title for the design responsibility field of the header.
fmea.conv.header.design=Design Responsibility
• This property is used as the title for the prepared by field of the header.
fmea.conv.header.prepared=Prepared By
• This property is used as the title for the core team field of the header.
fmea.conv.header.core=Core Team
• This property is used as the title for the extra info field of the header.
fmea.conv.header.extra=Extra Info
• This property is used as the title for the initial states field of the header.
fmea.conv.header.init=Initial States
• This property is used as the title for the event sequence field of the header.
fmea.conv.header.seq=Event Sequence
• This property is used as the title for the header section of the converted FMEA report.
fmea.conv.header.head=Header Information
• This property is used as the title for the record section of the converted FMEA report.
fmea.conv.header.record=Record Information
• This property is used as the title for the item/function field of the record.
fmea.conv.title.func=Item/Function
• This property is used as the title for the failure mode field of the record.
fmea.conv.title.mode=Potential Failure Mode
• This property is used as the title for the failure effect field of the record.
fmea.conv.title.effect=Potential Effect(s) of Failure
• This property is used as the title for the severity field of the record.
fmea.conv.title.sev=S
• This property is used as the title for the class field of the record.
fmea.conv.title.class=Cl
• This property is used as the title for the failure cause field of the record.
fmea.conv.title.cause=Potential Cause(s) of Failure
• This property is used as the title for the occurrence field of the record.
fmea.conv.title.occ=O
• This property is used as the title for the design controls field of the record.
fmea.conv.title.control=Current Design Controls
• This property is used as the title for the detectability field of the record.
fmea.conv.title.det=D
• This property is used as the title for the RPN field of the record.
fmea.conv.title.rpn=RPN
• This property is used as the title for the recommended action field of the record.
fmea.conv.title.ract=Recommended Action(s)
• This property is used as the title for the responsibility field of the record.
fmea.conv.title.resp=Responsibility/Completion Date
• This property is used as the title for the actions taken field of the record.
fmea.conv.title.act=Actions Taken
• This property is used as the title for the action severity field of the record.
fmea.conv.title.asev=R S
• This property is used as the title for the action occurrence field of the record.
fmea.conv.title.aocc=R O
• This property is used as the title for the action detectability field of the record.
fmea.conv.title.adet=R D
• This property is used as the title for the action RPN field of the record.
fmea.conv.title.arpn=R RPN
ScaText.properties
The simulation engine uses the information in this file to generate text for SCA reports (see
“Overview of Capital SimProve” on page 123). The ScaText<LANGUAGE>.properties files
have the same format but are for a specific <LANGUAGE> like French, German etc...
Set this property to true if you want to allow state machine behavior when generating SCA
reports.
generation.allowComplexBehaviour = false
header.schematic = Schematic
SimulationText.properties
• The error message raised when current direction over diodes could not be determined.
electrical.qual.error.diode.unresolved = Sorry: the following diode
component(s) could not be simulated:
• The error message raised when diodes could not be simulated due to oscillation.
electrical.qual.error.diode.oscillation = Sorry: diode components
caused oscillation.
• The error message raised when a short circuit has not dealt with be a fuse.
electrical.qual.error.catastrophic.short = Failure: warning -
uncontrolled thermal activity detected.
• The error message raised when dependency expressions based component models are
causing oscillation.
electrical.qual.error.depend.oscillation = Sorry: dependency
expressions caused oscillation.
• The error message raised when state machine based component models are causing
oscillation.
electrical.qual.error.state.oscillation = Sorry: state machines
caused oscillation.
• The error message raised when state machine based component models are causing
oscillation.
electrical.qual.error.state.conflict = Sorry: event conflict
detected in state machine(s).
• The error message raised when a component model has become unresolved.
electrical.qual.error.component.unresolved = Sorry: the following
component(s) have become unresolved:
EcadBridge.properties
• The property below can be used to turn subsystem registration on or off. By default,
subsystem registration is on (this property only has an effect if subsystem registration is
supported by the ECAD tool).
schematic.subsystem.registration = TRUE
• The property below indicates the length of time (in milliseconds) the Capital Analysis
splash screen is displayed.
splash.delay=9000
EcadDefault.properties
This file is used specify the default value for any properties that a component model tries to
reference from the ECAD tool.
• The property below specifies defaults for a property called 'WireLength'.
WireLength = 1.0
• Should we write the state machine behaviour element in the XML output file?
ignore.behaviour = false
ignore.uncontrolledThermalActivity = false
• Automatically reset() the simulator after each failure is applied & analyze()d?
resetSimulatorAfterEachFailure = true
SaberNetlister.Properties
This file controls the structure of the netlist generated for export to Saber, and is covered in
“Saber Configuration” on page 345.
This is a list of legacy problems and solutions. Please check out the Mentor graphics supportNet
site for current FAQ's and trouble shooting.
Internal "Duplication Entry" exceptions are being raised . . . . . . . . . . . . . . . . . . . . . . . 317
Internal "java.lang.RuntimeException" exceptions are being raised . . . . . . . . . . . . . . 318
Sometimes the component model attacher does not attach the component model . . . . 318
Error message "Failed to connect to component 'X' . . . . . . . . . . . . . . . . . . . . . . . . . . . . 318
Error message "Failed to initialise viewbase routines" . . . . . . . . . . . . . . . . . . . . . . . . . . 319
Composite Components seem Disconnected . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 319
The error report window appears, however no messages are displayed . . . . . . . . . . . . 319
Your workstation slows down after a few months . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 320
For TransCable users, multiple alert messages are being displayed . . . . . . . . . . . . . . . 320
When using the Simulator, functions seem to be achieved when the schematic colouring
indicates that they should not be . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 321
The following message appears "Sorry: dependency expressions caused oscillation" . 321
The following message appears "Sorry: current flow across diode(s) could not be
determined" . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 321
The following message appears "Failure: warning - uncontrolled thermal activity
detected" . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 322
The following message appears "Sorry: event conflict detected in state machine(s)" . 322
Exporting an FMEA report to some formats results in failure . . . . . . . . . . . . . . . . . . . . 322
FMEA Editor (Capital SimCertify) hangs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 323
For TransCable users, after simulating a schematic, the colours of the schematic have not
reverted back to there original state . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 323
Importing an .f2f file, exported by Capital Analysis, into FMEA+ fails . . . . . . . . . . . . 324
Solution
• All users should close all Capital Analysis windows.
• All users should then shutdown Capital Analysis.
• One user should open the Configuration Tool on the "Capital Analysis->Utilities" menu.
• Click the "Diagnostic" tab.
• Press the "Database Check" button.
• All users can now start using Capital Analysis again.
Internal "java.lang.RuntimeException"
exceptions are being raised
Internal "java.lang.RuntimeException" exceptions are being raised.
Solution
If users are using the shell "csh", ensure that all Capital Analysis executables have world
execute permissions.
Solution
• Ensure only one component model attacher window is open at a time.
Solution
• Use the component model attacher to reattach the model to component 'X'.
Solution
• Ensure that all the library directories specified in your "viewdraw.ini" file actually exist.
• Remove all those libraries that do not exist.
• Correct all those libraries that have moved to a new location in your file store.
• Check that all composite (BLOCK_TYPE = COMPOSITE) components/symbols
have an underlying schematic.
• If such a component is found and it is not meant to have an underlying schematic,
change the BLOCK_TYPE to MODULE.
• If such a component is found and it is meant to have an underlying schematic, create the
underlying schematic for it.
Solution
• Always use pin blocks to connect high & low-level schematics (this is the recommended
solution).
• Ensure that the net (which is automatically created between the connector & composite
component) at the high level has the same name as the net at the lower level.
The last message in the "firstearth.errors" file is "ERROR -> could not write subsystem ..."
Solution
• Ensure that all composite components have an underlying schematic with components
connected to pins.
• Ensure that all objects that are not electrical components (bounding boxes, text) have a
block type of annotation.
Solution
• Ensure both Capital Analysis and ECAD Tool is not running then kill the rogue
processes/threads (short term solution).
• Ensure that all Capital Analysis windows have been closed and then shutdown Capital
Analysis before closing ECAD Tool.
Solution
• Never click "OK" on the Alert window, simply drag the window out of the way (short
term solution).
• Tell your Systems Administrator to edit the following file
$TRANSROOT/tdt/exec/transcable/standard/tcable01.vs and uncomment the /*
load("tcupdate.vs"); */ so it should look like load("tcupdate.vs");
• If you are unsure or this causes other problems, contact your TransCable support person
for the solution to this TransCable specific problem.
When simulating a record in an FMEA report, functions are achieved when the schematic
colouring indicates that they should not be.
Solution
• If the function expressions use the output properties of components, ensure that the
Component Models behaviour sets the output property in all situations.
Solution
• Check that the state machine (or dependency expression) based components are not
continuously looping.
• Use the simulation display facility of the Overview of Simulator Tool to debug the
dependency expressions and/or state machines.
Solution
• No solution. This is due to the use qualitative simulation engine. Contact us for more
information.
Solution
• In the Simulator, press the reset button to remove the short circuit.
Solution
• Check the conditions on events in your state machines. Ensure that there is no way more
than one event can fire from each state.
• Use the simulation display facility of the Overview of Simulator Tool to debug the state
machines.
Solution
• Check the actions in events/states in your state machines. Ensure that there is no way
more than one change can be applied to the same variable.
Solution
• Exporting FMEAs to some formats can only be done from those FMEA reports held in
the FMEA Editor (Capital SimCertify), see “Exporting an FMEA Report” on page 73.
Saving the FMEA report in the folder structure results in information, required by the
export filter, being lost.
Solution
• The FMEA Editor (Capital SimCertify) does not work on Solaris with OpenWindows.
Please use the Common Desktop Environment (CDE).
Solution
• From the TransCable menu: Select - Name - $1w* (for a sheet 1 change. Use $2w* for
sheet 2 changes, etc). This will select all wires in the schematic. Note that it also selects
displayed wire attributes, but that is fixed in step 3 of this solution.
• From the TransCable menu: Edit - Style - Colour - Red (or whatever default colour you
want to return the wires to). This will change the wire colours as desired, but also change
the attribute colours as well. See next step for fixing this.
• If you have deselected the wires after step 2, reselect them as described in step 1. Then:
Select - Attr - * - Selected (note - it is important that the "Selected" button is pressed).
• From the TransCable menu: Edit - Style - Colour - White (or whatever default colour
you want to return the attributes to).
• Alternatively, TransCable keeps a backup copy of your schematic in the sch/bak
directory. If after colouring, the colours remain blue, you can copy the backup over the
original copy of the schematic, thus restoring the colours. However, if you have done
any changes after this problem occurred, then the backup may also now have those
colours.
Solution
• This problem occurs when the size of the file is greater than 1Mbytes. This seems to be a
restriction of the FMEA+ application itself. You can reduce the size of the FMEA+
export by reducing the number of functions used to generate the FMEA report (see
“FMEA Editor (Capital SimCertify)” on page 69).
It is recommended that one of the users of Capital Analysis be nominated as the Administrator.
This person should be the only one with the Administrator password.
Administrator Information
The Administrator should be aware of the following:
• The administrator password should be changed after Capital Analysis has been installed,
the initial password is password.
• You can change the Administrator password using the Configuration Tool.
• There are two types of user in Capital Analysis, the Administrator and Users (everyone
else).
• Administrator locks on objects can only be unlocked by the Administrator.
• User locks on objects can be unlocked by only that user and the Administrator.
• Objects can be locked and unlocked from the Object Manager.
• To become the Administrator, enter the Administrator password from the Object
Manager menu.
• Locking folders will lock all the objects within that folder (including objects in the sub-
folders all the way down the folder hierarchy).
• The Bulk Import/Export can be used to exchange objects between different sites.
• Take note of the recommendations concerning component libraries (see “Component
Library - Component Models Provided” on page 198).
• Using the Edit Options Dialog, ensure that the occurrence ratios that Capital Analysis
uses match those specified in your companies FMEA report standards. See “RPN
Default Options” on page 274.
• You should ensure that your companies preferences for Capital Analysis have been
setup. See “Company Preferences” on page 307.
There are several types of object that can exist in the database.
Objects can also be exported and imported in bulk between sites via the Object Manager. For
information on bulk import/export, see “Bulk Import/Export” on page 34.
Single Supplies
The screenshot below shows a simple lamp circuit that uses supply rails:
Each supply rail is an individual symbol with an individual component model attached to it. The
positive rail has a "positive" category component model attached to it and the ground rail has a
"negative" category component model attached to it. When you create a new component model,
the first decision you make is to choose the component model's category (see “Selecting a
Component Category” on page 163). The simulation engine collects together all the positive
and negative supply rail components and connects them to a default battery.
Explicit Batteries
The picture below shows a simple lamp circuit which uses a battery:
The battery is a single symbol with a single component model attached to it. The component
model is of category type "other" and contains one positive node and one negative node (see
“Selecting a Component Category” on page 163). Such components cannot have more than one
positive or negative node, if a component is given more than one positive or negative node then
the simulation engine will connect all the positive and all the negative nodes together within
that component.
Chassis
The picture below shows a simple lamp circuit which uses a battery and chassis components:
A chassis component must not be confused with a ground rail component. They often have very
similar symbols but they are inherently different. A chassis component has a category type
"chassis". The simulation engine will connect all the chassis components together during an
analysis.
Multiple Batteries
The following multiple battery information is only relevant to Qualitative analysis.
The screenshot above shows the Enable multiple battery support checkbox which is located
in the Launcher menu Edit > Options under Qualitative > Simulation Engine. Multiple
battery support is enabled by default.
If the multiple battery support is disabled (unchecked), then the simulation engine will connect
all the positive battery terminals and positive power rails together, and it will connect all the
negative battery terminals and negative power rails together. Effectively all the batteries will be
connected together.
If the multiple battery support is enabled (checked), then the simulation engine considers each
battery by connecting its default battery to each of them in turn. While one battery is being
considered, any others within the schematic have their terminals connected together.
Multiple battery support is designed to allow large schematics with several batteries on them to
work but not for having individual circuits which contain several batteries.
It is not recommended that you connect batteries directly together in series or parallel.
It is not recommended that you mix the supply rails and explicit batteries.
Self Modeling Components comprise of a series of technologies being developed in the Capital
environment that aim to reduce the amount of work required for design engineers to simulate a
design.
By default on Capital, a user does not have to build a component model for grounds, shields,
connectors, or splices. This can be extended by a system administrator by making changes to
the 'netlister.properties' file described below.
Note
This functionality is only available to users operating Capital Analysis within a Capital-
based flow.
In order for Capital Analysis to identify a device type to associate with a suitable adaptive
component model that is not recognized as a distinct device type by Capital, the netlister must
be told where to look for the device type.
This is achieved by looking up the value of a defined property on the device. By default this is
set to META_TYPE (case sensitive), but can be changed to any user value that does not use any
of the following characters
. <space> “ ‘
When the netlister detects a component with a value specified in the META_TYPE property, it
then checks the value of the property against the space delimited list of identified types. This
type is then used as an index to look up the appropriate adaptive model stored in Capital
SimCore.
For each type defined in the section above, an adaptive model must be specified to be used for
the simulation. These models are normal component models that can robustly manage situations
where perhaps not all pins are connected, or where internal connectivity is changed as a result of
pin properties.
There must be a specific entry for each type of supported device list in the previous section.
# defines the model pins, i.e. the names of the external nodes on
# the analysis model, as a space separated list
component.type.motor.pins=NODE1 NODE2
component.type.battery.pins=POS NEG
Each pin on the simulation model that can acquire a mapping to an ECAD pin must be
enumerated here in a space delimited list. This is then used in the next section to identify a list
of match ECAD terminals that can be associated with that simulation model node or pin.
For each simulation model node listed in the previous section, a space delimited list of valid
ECAD terminal names that can be automatically mapped to each node.
It is the specified model’s responsibility to ensure it can manage situations where pins are not
attached.
When you simulate a Capital Logic or Capital Integrator design, models are automatically
synthesized for any connector or splice (in Capital Logic) found without an attached Analysis
model. These models are created dynamically: the models are constructed with an appropriate
structure, and default behavioral code is inserted to enable the setting of resistance between
contacts.
Note
The code inserted into a dynamic model's behavior can be overridden by adding your
own code to be used in the netlister.properties file. See “To override default behavioral
code” on page 342 for more information.
Dynamic Generation
Dynamically generated connector model structures contain an additional node for each pin
(external node) on the connector, given the same name as the pin but suffixed with `.
Connecting each external node (pin) and its corresponding internal node is a resistance arc,
allowing resistances within the connector to be set.
The above structure is generated for each pin within a multi-pin connector. Inline connectors
feature two external pins and resistance arcs, but share the internal node (M` in the above
example) to model the connection.
As voltages can be measured at the internal and external nodes, and hence the potential
difference across the resistance arc can be calculated, it is possible to return a value for the
current travelling through the connector.
The following example shows how this structure applies (theoretically) to a connector in
Capital Logic:
Dynamically generated single-pin splice structures contain three external nodes (pins)
connected to internal nodes via resistance arcs. As with connectors, the external nodes are
named according to the pins with which they are associated, and the internal nodes are given the
same name, suffixed with `.
Note
The ` character used to identify dynamically generated internal nodes can be overridden,
and an alternative used, by adding the following argument to the
java.bridge.properties= line in the RunTime.properties file (located in
<install_location>\resources\resources):
node.associate.marking= and insert the character to use.
Note
Dynamically generated models are only persisted for the purpose of simulating the
design; changes saved against the model in the Component Model Builder will be taken
into account when running the simulation, but the model itself will not be saved unless
you select File > Save As from the main menu, or return to the Dynamically generated
models dialog, select the model and click the "Save" button. In both cases, a browser
dialog will be displayed, allowing you specify a database location in which to save the
model. In order to then use this saved model, it should be attached in the normal way to a
connector or splice, as appropriate; any attempt to attach the model to another component
type will result in an error being generated.
Once you have finished viewing the model, click the "OK" button to close the dialog.
Note
The netlister.properties file can be found in the resources\resources subdirectory of your
Capital Analysis installation directory. For example:
C:\MentorGraphics\Capital\Analysis\Capital
Analysis_2006.2\resources\resources\netlister.properties
• head - you can enter a block of initialization statements to be executed when the
components behavior is first accessed. For example:
GeneratedConnector.expression.head=\n\
//HEAD START - MODEL MODIFIED FROM NETLISTER PROPERTIES FILES\n\
only once\n\
do\n\
if ( simulator.getSimulationType( ) = SIMULATION_TYPE_SPICE ) then\n\
float componentResistance;\n\
float pinResistance;\n\
string propertyCapture;\n\
propertyCapture := ecad.resistance;\n\
componentResistance := propertyCapture.toFloat( ) ;\n\
endif;\n\
done;\n\
• pin - you can enter a block of statements to be applied to EACH pin in the model. For
example:
GeneratedConnector.expression.pin=\n\
//PIN START - MODEL MODIFIED FROM NETLISTER PROPERTIES FILES\n\
propertyCapture := PINNAME.getEcadProperty( \"PROPNAME\" );\n\
if ( propertyCapture != \"\" ) then\n\
pinResistance := propertyCapture.toFloat( );\n\
PINNAME.setContactResistance( pinResistance );\n\
else\n\
PINNAME.setContactResistance( componentResistance );\n\
endif;\n\
Note
References to PINNAME and PROPNAME identify substitutions that will be made in the
model.
• tail - you can enter a block of statements to be executed as the script completes. For
example:
GeneratedConnector.expression.tail=\n\
//TAIL START - MODEL MODIFIED FROM NETLISTER PROPERTIES FILES\n\
do only once\n\
do\n\
print "The behavior of model " + self.getName() + "has been successfully
overridden.";\n\
done;\n\
The default connector resistance property name (examined as an ecad property) is "resistance"
but may be overridden using GeneratedConnector.resistance.property. For example:
GeneratedConnector.resistance.property=NewName
This section details the integration between Capital Analysis and Saber, including the
configuration of the Saber netlist, the export of the netlist, and the use of Saber Model Template
Definitions. The following topics are available:
Saber Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 345
Exporting to Saber (Saber Integration). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 352
Saber Model Template Definitions. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 353
Saber Configuration
The structure of the generated Saber netlist is controlled by editing the SaberNetlister.properties
file, which is found in:
• <install_location>/resources/resources/ on UNIX
• <install_location>\resources\resources on Win32 platforms.
Note
It is recommended that you backup this file before making any changes.
Saber Properties
Saber.command.line
This is the command line that is to be used to execute Saber following the export of a
Saber netlist. <filename> will be substituted for the name of the exported netlist, i.e.
Saber.command.line=saber <filename> will execute Saber on the exported netlist.
Saber.command.line=saber <filename>
to Saber Frameway. This and all future netlists are sent as commands over this interface. Output
from Saber Frameway is echoed to your design tool log file.
If the key is not found or is manually set to “false” then the existing command line driven
method will be used running the Saber executable file with the netlist file path for every netlist
export.
Note
This functionality requires a Saber Frameway license in addition to the usual Saber
licenses.
Netlist Properties
Saber.netlist.filename
This property allows the specification of a fixed filename and file location for the
exported netlist. If this property has a value, the option to specify a filename and
location when exporting a Saber netlist will be displayed, but not available for editing.
Saber.netlist.filename=C:\Temp\Data\MyNetlist.sin
Note
The location supplied must be a valid location to which the client machine has access; if
the location cannot be found, an error will be generated and the export terminated.
The name of the property on the component that indicates the MAST MODEL to be
used in the netlist. This may be a space separated list of properties with precedence
given to the foremost in the list.
Mast.model.property=MAST_MODEL
Mast.wireModel.name
If there is no model property specified on a wire the model named here will be used
instead.
Mast.wireModel.name=WIRE_V1
Mast.wireModel.pins
The name of the pins on the wire model to be used with the exported netlist.
Failure to specify to distinct pins will cause an invalid netlist to be formed.
Mast.wireModel.pins=p m
Mast.pin.property
The name of the property on the pin that indicates the MAST PIN to be used in the
netlist. This may be a space separated list of properties with precedence given to the
foremost in the list.
Mast.pin.property=PN
Ignore Properties
Ignore.component.with.model
This allows any component with the given mast model to be ignored during netlisting (It
will be replaced by a splice in the netlist ). This may be a space separated list.
e.g. Ignore.component.with.model=wire will ignore any components with the mast
model set to be 'wire'
Ignore.component.with.model=
Ignore.component.with.property
This allows any component with the given ECAD property to be ignored during
netlisting ( It will be replaced by a splice in the netlist ). This may be a space separated
list.
e.g. Ignore.component.with.property=ignore will ignore any components with a
property named 'ignore' regardless of its value.
Ignore.component.with.property=
Identifier Properties
Identifier.max.size=
This allows the maximum length of any identifiers in the netlist to be set. This must be a
positive integer value. Recommended setting is 32, smaller settings may prevent the
netlister generated unique identifiers.
Identifier.max.size=32
Identifier.translation.hints
This allows ECAD identifiers that require translation to have translations indicated.
Identifiers are translated when the netlister encounters a character in the ECAD name
that the Saber simulator would not permit. Hints must be space separated pairs
specifying the translatable character or sequence of characters and the transation that
should occur.
e.g. Identifier.translation.hints=+ plus would hint that the + character in
an ecad name should be substituted for the word plus in the netlist.
Note
Hints may take the form of regular expressions and will be used as possible within the
Identifier.max.size constraint. Default translations for space, + and - are present in the
exporter but may be overridden here.
Identifier.translation.hints=
Parameters Properties
Parameters.obtain.all
If this is set to true all properties on all components will be exported as Saber
parameters.
Parameters.obtain.all=false
Parameters.obtain.component.all
If this is set all the properties of a component with any of these property names will be
exported as Saber parameters, including the named properties. If the named properties
are not to be exported then they should be prefixed with a *. This may be a space
separated list.
e.g. Parameters.obtain.component.all=MAST_MODEL *SABER_ALL would indicate
that any component with a MAST_MODEL property or SABER_ALL property should
export all of its properties as Saber parameters excluding the SABER_ALL property.
Parameters.obtain.component.all=
Parameters.obtain.component.prefix
If a component's ECAD property has one of the given prefixes it will be exported in the
Saber netlist as a parameter. May be a space-separated list.
Parameters.obtain.component.prefix=SABER_
Parameters.obtain.component.suffix
If a component's ECAD property has one of the given suffixes it will be exported in the
Saber netlist as a parameter. May be a space-separated list.
Parameters.obtain.component.suffix=_SABER
Mapping.enumerations
This is a space separated list of all the enumerations available to the netlister.
i.e. Mapping.enumerations=enum1 enum2 specifies to enumerations enum1 and enum2
that are available to the netlister
Mapping.enumerations=
Enumeration.<enumerationName>.properties
Enumeration.<enumerationName>.models
This is a space-delimited list of the Saber models for which this enumeration is valid.
Model names may make use of regular expressions to easily encompass multiple
models.
i.e. Enumeration.enum1.models=WIRE_V1 WIRE_V2 WIRE_V3 states that the
enumeration is valid for wire models v1, v2 and v3.
Enumeration.enum1.models=WIRE_V.? states that enumeration enum1 may be applied
to any wire_v<char> model.
Enumeration.<enumerationName>.models=
Enumeration.<enumerationName>.keys
This is a space delimeted list of the initial values of the property on the ecad component
that indicate a substitution should take place.
i.e. Enumeration.enum1.keys=000 00 0 1 2 3 4 5 6 7 states that if any of the listed values
are found on a property substitution should be attempted.
Enumeration.<enumerationName>.keys=
Enumeration.<enumerationName>.<enumerationKey>.value
This specifies the value that should be substituted for the key defined above i.e.
Enumeration.enum1.000.value=g000 states that 000 should be substituted with g000
whenever the substitution attempt is made.
Enumeration.<enumerationName>.<enumerationKey>.value=
Mapping String
Mapping strings map the names and values of properties on the ECAD component to new
values suitable for Saber interpretations.
For example, using a mapping string it is possible to map a property such as GAUGE=01 to
WIRE_GAUGE="001" when exported in the Saber netlist. These mappings are identified by
mast model and property name.
Mapping.String.models
A space delimeted list of the models for which mapping strings exist which may not be
regular expressions.
Mapping.string.models=
Mapping.string.<modelName>.mappings=
A space delimeted list of the mappings that are applicable to this model i.e.
Mapping.string.wire_v1.mappings=lengthMapping wireSizeMapping
wireSpecMapping
Mapping.string.<modelName>.mappings=
Mapping.string.<mappingName>.property=
Transform examples
For example "valueTransform=test" would replace the identified value with
test
"valueTransform=.*,"\0"" would quote the whole value.
Mapping.string.<mappingName>.propertyTransform=
Either a regular expression + replace string to be executed upon the property name or a
fixed string that is substituted. i.e propertyTransform=text would be interpreted as a
fixed string substitution.
propertyTransform=regexp,replace would attempt to map interpret the value as a
regular expression using regex and then replace the value using the replace regex string.
Mapping.string.<mappingName>.propertyTransform=
Mapping.string.<mappingName>.valueTransform=
Either a regular expression + replace string to be executed upon the property value or a
fixed string that is substituted. i.e valueTransform=text would be interpreted as a fixed
string substitution valueTransform=regex,replace would attempt to map interpret the
value as a regular expression using regex and then replace the value using the replace
regex string.
Mapping.string.<mappingName>.valueTransform=
Exclusion Properties
remove.property.with.name=
This example would remove all instances of the properties MY_FIRST_PROP and
MY_SECOND_PROP from the netlist.
remove.property.with.value=
A space-separated list of property-value pairs. Properties with the specified values will
be removed from the netlist.
remove.property.with.value=MY_PROP a MY_PROP b
This example would remove all instances of the MY_PROP property with a value of
a or b.
remove.properties.with.value=
A space-separated list of values. All properties with a value appearing in the list will be
removed from the netlist.
remove.properties.with.value=OPT1 OPT2
This example would remove all instances of any property with a value of OPT1 or
OPT2.
Procedure
1. Press Space Bar and enter Export Netlist.
2. Select Saber Design Netlist, then click Next.
3. Check Invoke Saber on netlist if you want to launch the Saber application upon
generation of the netlist.
4. Click Browse and choose a location and file name for the export file.
5. Click Save from the save dialog.
6. Click Next to complete the export, then click Close.
If the Invoke Saber on netlist option was selected at step 3, Saber will be launched
following the generation of the netlist.
Note
This functionality is only available to users operating Capital Analysis within a Capital-
based flow.
Note
The name of the MAST_MODEL property can be overriden within the
SaberNetlister.properties file (located in the %Analysis%\Resources\Resources
directory. Locate the line that reads: Mast.model.property=MAST_MODEL and replace
MAST_MODEL with a new value of your choice.
The property is assigned within your ECAD tool using the following method:
a. Navigate to the appropriate scope within the project tree, and expand the scope until
the relevant design is visible.
b. Right-click on the design and select Edit...
c. The Edit Diagram dialog is displayed; click the New... button beneath the
Properties list.
d. In the Property Name field, enter MAST_MODEL, then click OK. Back on the Edit
Diagram dialog, the Property list will display the newly created property and will
offer the option to enter a value for the property; leave the Value field blank and
click OK.
• Any nets that will be exposed as ports in the exported Saber model must be assigned a
SABER_PORT property. This, again, is performed within your ECAD tool:
d. Back on the Edit Properties dialog, the new property will have been added to the
Properties list. When the Saber Netlist is generated, the value for this property will
be taken as the name for the pin on the Saber model, so enter the correct name into
the Value field.
e. Leave the other settings for the property at their defaults and click OK.
• Saber Model Template parameters are defined by assigning properties to either the
diagram or components, which will then be converted to model parameters when the
netlist is exported. All properties attached in this way must include a SABER_PROPERTY
prefix, followed by the name of the parameter.
Note
The value used for the prefix can be overridden within the SaberNetlister.properties file
(located in the %Analysis%\Resources\Resources directory. Locate the line that reads:
Parameters.obtain.component.prefix=SABER_PROPERTY_ and replace
SABER_PROPERTY_ with a value of your choice.
The option to use a suffix as well as/instead of a prefix is also supported; locate the line
reading Parameters.obtain.component.suffix=_SABER_PROPERTY and substitute
_SABER_PROPERTY with a value of your choice. In both cases, prefixing the configured
value with an asterisk will result in the prefix and/or suffix being removed from the
parameters as the netlist is exported. For example: *_SABER_PROPERTY will be removed.
For example:
SABER_PROPERTY_MY_PROPERTY=
In this case, both properties will be exported as parameters of the Saber Model
Template; parameter RES_1 will have a value of 2, while parameter RES_2 will take
the value of the property DEFAULT_RES, 2 in this case.
Note
If you specify the name of a design-level property as a value, that property has to exist on
the design to ensure that the correct value is referenced. If the property does not exist, the
property name entered as a value will be taken literally. In the above example, if the
property SABER_PROPERTY_DEFAULT_RES did not exist on the design, the property
SABER_PROPERTY_RES_2 will be exported as a parameter called RES_2 with a value of
DEFAULT_RES.
This section details the integration between Capital Analysis and SystemVision, including the
configuration of SystemVision, project and model attachment and SystemVision Simulation.
The following topics are available:
SystemVision Integration Overview. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 357
SystemVision Integration Configuration. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 358
SystemVision Project Attachment . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 359
SystemVision VHDL Model Attachment. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 360
SystemVision Simulation. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 362
The diagram below shows an outline of the analysis flow with SystemVision Integration.
A SystemVision model attacher is available for objects in Capital Logic through which VHDL
models can be attached to devices. A design rule check (DRC) verifies model attachments
making sure all needed models have been attached.
Once all models are attached, using the Simulator Tool, SystemVision can be picked from the
simulation type drop down. Different analysis operations can then be performed inside the
SystemVision environment as shown below:
Procedure
1. Make sure that SystemVision is installed and that the "Capital SimBridge" component is
enabled in the Analysis Configuration Tool as seen in the screenshot below. Note that
enabling this component will not take effect until Capital Logic is restarted.
Note
The configuration tool can be opened by pressing Space Bar and entering Configure.
Caution
If there is no model attached to one of the objects above, then this will cause netlisting
(simulation) errors in SystemVision.
Model optional:
• Connector: a model can optionally be attached. A contact resistance of 50.0 will be
added for mated pins (mated to device, or to other connector pins). This value can be
overridden by adding a property "contact_resistance" and giving it a value on the
connector.
• Wire: a model can optionally be attached. By default the SystemVision model
EDULIB.WIRE is used on wires unless overridden by an attachment.
Note
This DRC can be configured to run in background mode.
To attach a model to an object, right click on it and choose Custom > SystemVision Properties
The SystemVision attacher will add the following properties on the device, indicating the
attachment settings:
1. VHDL_File
• For example, C:\MentorGraphics\VHDL Files\MyVHDLFile.vhd (only if an
uncompiled model was selected in the attacher).
2. VHDL_Model
• <Library_Name><Model_Name>(<Architecture_Name>) for a compiled model.
• <ModelName>(<Architecture_Name>) for an uncompiled model.
3. VHDL_Property_<Property_Name>
• For each VHDL parameter added or overridden in the attacher, a property with the
above name is created. The property value indicates the parameter value used. Note
that for default parameters, which have not been overwritten by the user, no
properties are created.
4. SVPinOrder
• Property added on each pin to indicate which VHDL model terminal this pin is
mapped to.
• If this property is removed off all pins, a property "VHDL_PinOrder" can be used on
the device itself to indicate the mapping. The value for this property is an ordered list
of the device pins that would match the ordered list of terminals in the VHDL file.
So in the Model Attachment Example the terminals in the VHDL file are listed in the
order 'p1 p2' so the VHDL_PinOrder property would have the value 'X Y'.
SystemVision Simulation
Once all models are attached and the DRC passes without any errors, scope can be set on the
required design or build list so simulation would be performed on it.
In the Simulator, select SystemVision from the Simulation Type drop down and tap the Play
button.
This will automatically launch SystemVision on the set project and run the simulation. You can
then specify the end time and other parameters needed for simulation.
Results are then shown in SystemVision and propagated back into Capital to change the color of
different components according to their activity and failure conditions.
Please check out the Mentor graphics supportNet site for current FAQ's and trouble shooting.
Solution
The error above, from the Capital AQQA errors file, means that the library libmysqlclient.so
cannot be found or loaded. You need to build this library on your system if you have not done
so.
If this library has been built, then you need to ensure that the LD_LIBRARY_PATH includes
the directory where you have placed libmysqlclient.so. If you are still have problems, type the
following command on libmysqlclient.so.
ldd libmysqlclient.so
This will tell you the libraries libmysqlclient.so is dependent on. Please ensure that the location
of these libraries are in the LD_LIBRARY_PATH environment variable also.
Analysis error message: "both supply rail and batter components are present..."
Solution
Change the device attachments appropriately. For example:
• Can not run Background Simulation and no simcore.exe is listed in task manager.
• Schematic diagram is not highlighted in usual background simulation colors of red,
green and blue.
• Capital Analysis tab shows only "Please wait..." and does not change.
Cause: An equivalent Japanese character appears to be used as a delimiter between component
name and pin name. If this delimiter is not consistent between generated design and the netlister
then the problem arises.
Solution
This may be resolved by changing the delimiter to be used and then running Generate Wiring
Diagram again.
Solution
As a workaround to this issue you should create a shortcut icon of the original
CapitalWebNamingServer.exe. Then add a the port number you wish to use as Capital Web
Naming Service. This can be done by:
Symptoms Generate Wiring Diagram: receiving the following error: Destination component
DEV_1{DEV**P1} does not exist in the component list. Note that in place of the ** there may
be a doublebyte "overline".
Cause: Device "DEV_1" and the Pin "P1" are not correctly associated. This occurs because an
equivalent Japanese character appears to be used as a delimiter between component name and
pin name. If this delimiter is not consistent between generated design and the netlister then the
problem arises.
Solution
Resolve by changing the delimiter to be used as follows:
• Error: Unable to obtain a license for feature CHManufact, License request for feature
NULL failed [mgls_errno 203]
• Error: Unable to obtain a license for feature CHDesigner, License request for feature
NULL failed [mgls_errno 203]
• MGLS_PKGINFO_FILE is not set
• C:\Mentor\2006.1\mglsclnt does not exist
Cause: The client-side licensing is missing. The licensing exists in <install_dir>\mglsclnt and
this directory does not exist.
Solution
Reinstall WG2006.1. Verify that the mglsclnt directory is created and that the environment
variables MGLS_PKGINFO_FILE and MGLS_DLL are set.
Cause:
C:\MentorGraphics\Capital\Analysis\Capital Analysis_2006.1\resources\resources
Solution
Open the Connections.properties file, enter the following, save the file and the casconfig
program will run.
default=
(Note in the above line to be entered there is nothing after the "=" sign.)
• The path setting for the model in question not being correct.
For this reason the command Resistance referred to has not been assigned from the
model.
Please see method (A) below.
• An incorrect model has been assigned to the device or the model has been moved.
Please see method (B) below.
Solution
(A) The path for the component model can be confirmed and saved as follows:
Then return to Analysis>Simulator and the program should open and run.
Note that it may take several seconds or up to a minute for the Simulator to open depending
upon your machine environment.
1. With the diagram open, select the Device from the Diagram Browser.
2. From the Popup menu select Analysis>Attach...
3. Select the Model, confirm that Terminal Mappings are correct then select OK.
Solution
The PATH variable should include the path to the Oracle bin directory.
Solution
The command is case-sensitive. Typing casconfig -dsAdmin will make the DataSource Admin
tab available.
Solution
Ensure that the mysql daemon is up and running. If not, re-start the mysql daemon.
Solution
If you are using the following script for importing the data then you may need to change the
script.
Index
Capital SimProject
Index
—T—
Terminals
specifying, 168
Tooltip, 251
Transfer
data sources, 301
Transient analyis, 21
Transient graphs, 56
Troubleshooting, 317
—U—
Unresolved Scenario Builder, 84
Update
data sources, 301
—V—
Variables, 251
Verification
FMEA interactive, 20
VHDL-AMS models, 187
View
FMEA reports, 70, 72
object properties, 31
output conditions, 63
property watches, 56
SCA reports, 130
transient graphs, 56
Viewing Embedded Component Properties, 63
Voltage
defining algorithms, 146
—W—
Watches
adding, 61
Wires
sizing, 143
Wndows
simulation information, 63
IMPORTANT INFORMATION
USE OF ALL SOFTWARE IS SUBJECT TO LICENSE RESTRICTIONS. CAREFULLY READ THIS LICENSE
AGREEMENT BEFORE USING THE PRODUCTS. USE OF SOFTWARE INDICATES CUSTOMER’S COMPLETE
AND UNCONDITIONAL ACCEPTANCE OF THE TERMS AND CONDITIONS SET FORTH IN THIS AGREEMENT.
ANY ADDITIONAL OR DIFFERENT PURCHASE ORDER TERMS AND CONDITIONS SHALL NOT APPLY.
2. GRANT OF LICENSE. The software installed, downloaded, or otherwise acquired by Customer under this Agreement, including any
updates, modifications, revisions, copies, documentation, setup files and design data (“Software”) are copyrighted, trade secret and
confidential information of Mentor Graphics or its licensors, who maintain exclusive title to all Software and retain all rights not
expressly granted by this Agreement. Except for Software that is embeddable (“Embedded Software”), which is licensed pursuant to
separate embedded software terms or an embedded software supplement, Mentor Graphics grants to Customer, subject to payment of
applicable license fees, a nontransferable, nonexclusive license to use Software solely: (a) in machine-readable, object-code form
(except as provided in Subsection 4.2); (b) for Customer’s internal business purposes; (c) for the term of the license; and (d) on the
computer hardware and at the site authorized by Mentor Graphics. A site is restricted to a one-half mile (800 meter) radius. Customer
may have Software temporarily used by an employee for telecommuting purposes from locations other than a Customer office, such as
the employee’s residence, an airport or hotel, provided that such employee’s primary place of employment is the site where the
Software is authorized for use. Mentor Graphics’ standard policies and programs, which vary depending on Software, license fees paid
or services purchased, apply to the following: (a) relocation of Software; (b) use of Software, which may be limited, for example, to
execution of a single session by a single user on the authorized hardware or for a restricted period of time (such limitations may be
technically implemented through the use of authorization codes or similar devices); and (c) support services provided, including
eligibility to receive telephone support, updates, modifications, and revisions. For the avoidance of doubt, if Customer provides any
feedback or requests any change or enhancement to Products, whether in the course of receiving support or consulting services,
evaluating Products, performing beta testing or otherwise, any inventions, product improvements, modifications or developments made
by Mentor Graphics (at Mentor Graphics’ sole discretion) will be the exclusive property of Mentor Graphics.
3. BETA CODE.
3.1. Portions or all of certain Software may contain code for experimental testing and evaluation (which may be either alpha or beta,
collectively “Beta Code”), which may not be used without Mentor Graphics’ explicit authorization. Upon Mentor Graphics’
authorization, Mentor Graphics grants to Customer a temporary, nontransferable, nonexclusive license for experimental use to
test and evaluate the Beta Code without charge for a limited period of time specified by Mentor Graphics. Mentor Graphics may
choose, at its sole discretion, not to release Beta Code commercially in any form.
3.2. If Mentor Graphics authorizes Customer to use the Beta Code, Customer agrees to evaluate and test the Beta Code under normal
conditions as directed by Mentor Graphics. Customer will contact Mentor Graphics periodically during Customer’s use of the
Beta Code to discuss any malfunctions or suggested improvements. Upon completion of Customer’s evaluation and testing,
Customer will send to Mentor Graphics a written evaluation of the Beta Code, including its strengths, weaknesses and
recommended improvements.
3.3. Customer agrees to maintain Beta Code in confidence and shall restrict access to the Beta Code, including the methods and
concepts utilized therein, solely to those employees and Customer location(s) authorized by Mentor Graphics to perform beta
testing. Customer agrees that any written evaluations and all inventions, product improvements, modifications or developments
that Mentor Graphics conceived or made during or subsequent to this Agreement, including those based partly or wholly on
Customer’s feedback, will be the exclusive property of Mentor Graphics. Mentor Graphics will have exclusive rights, title and
interest in all such property. The provisions of this Subsection 3.3 shall survive termination of this Agreement.
4. RESTRICTIONS ON USE.
4.1. Customer may copy Software only as reasonably necessary to support the authorized use. Each copy must include all notices
and legends embedded in Software and affixed to its medium and container as received from Mentor Graphics. All copies shall
remain the property of Mentor Graphics or its licensors. Except for Embedded Software that has been embedded in executable
code form in Customer’s product(s), Customer shall maintain a record of the number and primary location of all copies of
Software, including copies merged with other software, and shall make those records available to Mentor Graphics upon
request. Customer shall not make Products available in any form to any person other than Customer’s employees and on-site
contractors, excluding Mentor Graphics competitors, whose job performance requires access and who are under obligations of
confidentiality. Customer shall take appropriate action to protect the confidentiality of Products and ensure that any person
permitted access does not disclose or use Products except as permitted by this Agreement. Customer shall give Mentor Graphics
written notice of any unauthorized disclosure or use of the Products as soon as Customer becomes aware of such unauthorized
disclosure or use. Customer acknowledges that Software provided hereunder may contain source code which is proprietary and
its confidentiality is of the highest importance and value to Mentor Graphics. Customer acknowledges that Mentor Graphics
may be seriously harmed if such source code is disclosed in violation of this Agreement. Except as otherwise permitted for
purposes of interoperability as specified by applicable and mandatory local law, Customer shall not reverse-assemble,
disassemble, reverse-compile, or reverse-engineer any Product, or in any way derive any source code from Software that is not
provided to Customer in source code form. Log files, data files, rule files and script files generated by or for the Software
(collectively “Files”), including without limitation files containing Standard Verification Rule Format (“SVRF”) and Tcl
Verification Format (“TVF”) which are Mentor Graphics’ trade secret and proprietary syntaxes for expressing process rules,
constitute or include confidential information of Mentor Graphics. Customer may share Files with third parties, excluding
Mentor Graphics competitors, provided that the confidentiality of such Files is protected by written agreement at least as well as
Customer protects other information of a similar nature or importance, but in any case with at least reasonable care. Customer
may use Files containing SVRF or TVF only with Mentor Graphics products. Under no circumstances shall Customer use
Products or Files or allow their use for the purpose of developing, enhancing or marketing any product that is in any way
competitive with Products, or disclose to any third party the results of, or information pertaining to, any benchmark.
4.2. If any Software or portions thereof are provided in source code form, Customer will use the source code only to correct software
errors and enhance or modify the Software for the authorized use, or as permitted for Embedded Software under separate
embedded software terms or an embedded software supplement. Customer shall not disclose or permit disclosure of source
code, in whole or in part, including any of its methods or concepts, to anyone except Customer’s employees or on-site
contractors, excluding Mentor Graphics competitors, with a need to know. Customer shall not copy or compile source code in
any manner except to support this authorized use.
4.3. Customer agrees that it will not subject any Product to any open source software (“OSS”) license that conflicts with this
Agreement or that does not otherwise apply to such Product.
4.4. Customer may not assign this Agreement or the rights and duties under it, or relocate, sublicense, or otherwise transfer the
Products, whether by operation of law or otherwise (“Attempted Transfer”), without Mentor Graphics’ prior written consent and
payment of Mentor Graphics’ then-current applicable relocation and/or transfer fees. Any Attempted Transfer without Mentor
Graphics’ prior written consent shall be a material breach of this Agreement and may, at Mentor Graphics’ option, result in the
immediate termination of the Agreement and/or the licenses granted under this Agreement. The terms of this Agreement,
including without limitation the licensing and assignment provisions, shall be binding upon Customer’s permitted successors in
interest and assigns.
4.5. The provisions of this Section 4 shall survive the termination of this Agreement.
5. SUPPORT SERVICES. To the extent Customer purchases support services, Mentor Graphics will provide Customer with updates and
technical support for the Products, at the Customer site(s) for which support is purchased, in accordance with Mentor Graphics’ then
current End-User Support Terms located at http://supportnet.mentor.com/supportterms.
6. OPEN SOURCE SOFTWARE. Products may contain OSS or code distributed under a proprietary third party license agreement, to
which additional rights or obligations (“Third Party Terms”) may apply. Please see the applicable Product documentation (including
license files, header files, read-me files or source code) for details. In the event of conflict between the terms of this Agreement
(including any addenda) and the Third Party Terms, the Third Party Terms will control solely with respect to the OSS or third party
code. The provisions of this Section 6 shall survive the termination of this Agreement.
7. LIMITED WARRANTY.
7.1. Mentor Graphics warrants that during the warranty period its standard, generally supported Products, when properly installed,
will substantially conform to the functional specifications set forth in the applicable user manual. Mentor Graphics does not
warrant that Products will meet Customer’s requirements or that operation of Products will be uninterrupted or error free. The
warranty period is 90 days starting on the 15th day after delivery or upon installation, whichever first occurs. Customer must
notify Mentor Graphics in writing of any nonconformity within the warranty period. For the avoidance of doubt, this warranty
applies only to the initial shipment of Software under an Order and does not renew or reset, for example, with the delivery of (a)
Software updates or (b) authorization codes or alternate Software under a transaction involving Software re-mix. This warranty
shall not be valid if Products have been subject to misuse, unauthorized modification, improper installation or Customer is not
in compliance with this Agreement. MENTOR GRAPHICS’ ENTIRE LIABILITY AND CUSTOMER’S EXCLUSIVE
REMEDY SHALL BE, AT MENTOR GRAPHICS’ OPTION, EITHER (A) REFUND OF THE PRICE PAID UPON
RETURN OF THE PRODUCTS TO MENTOR GRAPHICS OR (B) MODIFICATION OR REPLACEMENT OF THE
PRODUCTS THAT DO NOT MEET THIS LIMITED WARRANTY. MENTOR GRAPHICS MAKES NO WARRANTIES
WITH RESPECT TO: (A) SERVICES; (B) PRODUCTS PROVIDED AT NO CHARGE; OR (C) BETA CODE; ALL OF
WHICH ARE PROVIDED “AS IS.”
7.2. THE WARRANTIES SET FORTH IN THIS SECTION 7 ARE EXCLUSIVE. NEITHER MENTOR GRAPHICS NOR ITS
LICENSORS MAKE ANY OTHER WARRANTIES EXPRESS, IMPLIED OR STATUTORY, WITH RESPECT TO
PRODUCTS PROVIDED UNDER THIS AGREEMENT. MENTOR GRAPHICS AND ITS LICENSORS SPECIFICALLY
DISCLAIM ALL IMPLIED WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
NON-INFRINGEMENT OF INTELLECTUAL PROPERTY.
8. LIMITATION OF LIABILITY. TO THE EXTENT PERMITTED UNDER APPLICABLE LAW, IN NO EVENT SHALL
MENTOR GRAPHICS OR ITS LICENSORS BE LIABLE FOR INDIRECT, SPECIAL, INCIDENTAL, OR CONSEQUENTIAL
DAMAGES (INCLUDING LOST PROFITS OR SAVINGS) WHETHER BASED ON CONTRACT, TORT OR ANY OTHER
LEGAL THEORY, EVEN IF MENTOR GRAPHICS OR ITS LICENSORS HAVE BEEN ADVISED OF THE POSSIBILITY OF
SUCH DAMAGES. IN NO EVENT SHALL MENTOR GRAPHICS’ OR ITS LICENSORS’ LIABILITY UNDER THIS
AGREEMENT EXCEED THE AMOUNT RECEIVED FROM CUSTOMER FOR THE HARDWARE, SOFTWARE LICENSE OR
SERVICE GIVING RISE TO THE CLAIM. IN THE CASE WHERE NO AMOUNT WAS PAID, MENTOR GRAPHICS AND ITS
LICENSORS SHALL HAVE NO LIABILITY FOR ANY DAMAGES WHATSOEVER. THE PROVISIONS OF THIS SECTION 8
SHALL SURVIVE THE TERMINATION OF THIS AGREEMENT.
10. INFRINGEMENT.
10.1. Mentor Graphics will defend or settle, at its option and expense, any action brought against Customer in the United States,
Canada, Japan, or member state of the European Union which alleges that any standard, generally supported Product acquired
by Customer hereunder infringes a patent or copyright or misappropriates a trade secret in such jurisdiction. Mentor Graphics
will pay costs and damages finally awarded against Customer that are attributable to such action. Customer understands and
agrees that as conditions to Mentor Graphics’ obligations under this section Customer must: (a) notify Mentor Graphics
promptly in writing of the action; (b) provide Mentor Graphics all reasonable information and assistance to settle or defend the
action; and (c) grant Mentor Graphics sole authority and control of the defense or settlement of the action.
10.2. If a claim is made under Subsection 10.1 Mentor Graphics may, at its option and expense: (a) replace or modify the Product so
that it becomes noninfringing; (b) procure for Customer the right to continue using the Product; or (c) require the return of the
Product and refund to Customer any purchase price or license fee paid, less a reasonable allowance for use.
10.3. Mentor Graphics has no liability to Customer if the action is based upon: (a) the combination of Software or hardware with any
product not furnished by Mentor Graphics; (b) the modification of the Product other than by Mentor Graphics; (c) the use of
other than a current unaltered release of Software; (d) the use of the Product as part of an infringing process; (e) a product that
Customer makes, uses, or sells; (f) any Beta Code or Product provided at no charge; (g) any software provided by Mentor
Graphics’ licensors who do not provide such indemnification to Mentor Graphics’ customers; (h) OSS, except to the extent that
the infringement is directly caused by Mentor Graphics’ modifications to such OSS; or (i) infringement by Customer that is
deemed willful. In the case of (i), Customer shall reimburse Mentor Graphics for its reasonable attorney fees and other costs
related to the action.
10.4. THIS SECTION 10 IS SUBJECT TO SECTION 8 ABOVE AND STATES THE ENTIRE LIABILITY OF MENTOR
GRAPHICS AND ITS LICENSORS, AND CUSTOMER’S SOLE AND EXCLUSIVE REMEDY, FOR DEFENSE,
SETTLEMENT AND DAMAGES, WITH RESPECT TO ANY ALLEGED PATENT OR COPYRIGHT INFRINGEMENT
OR TRADE SECRET MISAPPROPRIATION BY ANY PRODUCT PROVIDED UNDER THIS AGREEMENT.
11. TERMINATION AND EFFECT OF TERMINATION.
11.1. If a Software license was provided for limited term use, such license will automatically terminate at the end of the authorized
term. Mentor Graphics may terminate this Agreement and/or any license granted under this Agreement immediately upon
written notice if Customer: (a) exceeds the scope of the license or otherwise fails to comply with the licensing or confidentiality
provisions of this Agreement, or (b) becomes insolvent, files a bankruptcy petition, institutes proceedings for liquidation or
winding up or enters into an agreement to assign its assets for the benefit of creditors. For any other material breach of any
provision of this Agreement, Mentor Graphics may terminate this Agreement and/or any license granted under this Agreement
upon 30 days written notice if Customer fails to cure the breach within the 30 day notice period. Termination of this Agreement
or any license granted hereunder will not affect Customer’s obligation to pay for Products shipped or licenses granted prior to
the termination, which amounts shall be payable immediately upon the date of termination.
11.2. Upon termination of this Agreement, the rights and obligations of the parties shall cease except as expressly set forth in this
Agreement. Upon termination of this Agreement and/or any license granted under this Agreement, Customer shall ensure that
all use of the affected Products ceases, and shall return hardware and either return to Mentor Graphics or destroy Software in
Customer’s possession, including all copies and documentation, and certify in writing to Mentor Graphics within ten business
days of the termination date that Customer no longer possesses any of the affected Products or copies of Software in any form.
12. EXPORT. The Products provided hereunder are subject to regulation by local laws and European Union (“E.U.”) and United States
(“U.S.”) government agencies, which prohibit export, re-export or diversion of certain products, information about the products, and
direct or indirect products thereof, to certain countries and certain persons. Customer agrees that it will not export or re-export Products
in any manner without first obtaining all necessary approval from appropriate local, E.U. and U.S. government agencies. If Customer
wishes to disclose any information to Mentor Graphics that is subject to any E.U., U.S. or other applicable export restrictions, including
without limitation the U.S. International Traffic in Arms Regulations (ITAR) or special controls under the Export Administration
Regulations (EAR), Customer will notify Mentor Graphics personnel, in advance of each instance of disclosure, that such information
is subject to such export restrictions.
13. U.S. GOVERNMENT LICENSE RIGHTS. Software was developed entirely at private expense. The parties agree that all Software is
commercial computer software within the meaning of the applicable acquisition regulations. Accordingly, pursuant to U.S. FAR 48
CFR 12.212 and DFAR 48 CFR 227.7202, use, duplication and disclosure of the Software by or for the U.S. government or a U.S.
government subcontractor is subject solely to the terms and conditions set forth in this Agreement, which shall supersede any
conflicting terms or conditions in any government order document, except for provisions which are contrary to applicable mandatory
federal laws.
14. THIRD PARTY BENEFICIARY. Mentor Graphics Corporation, Mentor Graphics (Ireland) Limited, Microsoft Corporation and
other licensors may be third party beneficiaries of this Agreement with the right to enforce the obligations set forth herein.
15. REVIEW OF LICENSE USAGE. Customer will monitor the access to and use of Software. With prior written notice and during
Customer’s normal business hours, Mentor Graphics may engage an internationally recognized accounting firm to review Customer’s
software monitoring system and records deemed relevant by the internationally recognized accounting firm to confirm Customer’s
compliance with the terms of this Agreement or U.S. or other local export laws. Such review may include FlexNet (or successor
product) report log files that Customer shall capture and provide at Mentor Graphics’ request. Customer shall make records available in
electronic format and shall fully cooperate with data gathering to support the license review. Mentor Graphics shall bear the expense of
any such review unless a material non-compliance is revealed. Mentor Graphics shall treat as confidential information all information
gained as a result of any request or review and shall only use or disclose such information as required by law or to enforce its rights
under this Agreement. The provisions of this Section 15 shall survive the termination of this Agreement.
16. CONTROLLING LAW, JURISDICTION AND DISPUTE RESOLUTION. The owners of certain Mentor Graphics intellectual
property licensed under this Agreement are located in Ireland and the U.S. To promote consistency around the world, disputes shall be
resolved as follows: excluding conflict of laws rules, this Agreement shall be governed by and construed under the laws of the State of
Oregon, U.S., if Customer is located in North or South America, and the laws of Ireland if Customer is located outside of North or
South America or Japan, and the laws of Japan if Customer is located in Japan. All disputes arising out of or in relation to this
Agreement shall be submitted to the exclusive jurisdiction of the courts of Portland, Oregon when the laws of Oregon apply, or Dublin,
Ireland when the laws of Ireland apply, or the Tokyo District Court when the laws of Japan apply. Notwithstanding the foregoing, all
disputes in Asia (excluding Japan) arising out of or in relation to this Agreement shall be resolved by arbitration in Singapore before a
single arbitrator to be appointed by the chairman of the Singapore International Arbitration Centre (“SIAC”) to be conducted in the
English language, in accordance with the Arbitration Rules of the SIAC in effect at the time of the dispute, which rules are deemed to
be incorporated by reference in this section. Nothing in this section shall restrict Mentor Graphics’ right to bring an action (including
for example a motion for injunctive relief) against Customer in the jurisdiction where Customer’s place of business is located. The
United Nations Convention on Contracts for the International Sale of Goods does not apply to this Agreement.
17. SEVERABILITY. If any provision of this Agreement is held by a court of competent jurisdiction to be void, invalid, unenforceable or
illegal, such provision shall be severed from this Agreement and the remaining provisions will remain in full force and effect.
18. MISCELLANEOUS. This Agreement contains the parties’ entire understanding relating to its subject matter and supersedes all prior
or contemporaneous agreements. Any translation of this Agreement is provided to comply with local legal requirements only. In the
event of a dispute between the English and any non-English versions, the English version of this Agreement shall govern to the extent
not prohibited by local law in the applicable jurisdiction. This Agreement may only be modified in writing, signed by an authorized
representative of each party. Waiver of terms or excuse of breach must be in writing and shall not constitute subsequent consent, waiver
or excuse.
Rev. 151102, Part No. 265968