System Interfaces - Definition and Design Best · PDF fileMethodologies Working Group & Tools...
Transcript of System Interfaces - Definition and Design Best · PDF fileMethodologies Working Group & Tools...
![Page 1: System Interfaces - Definition and Design Best · PDF fileMethodologies Working Group & Tools 1 System Interfaces – Definition and Design System Interfaces - Definition and Design](https://reader031.fdocuments.in/reader031/viewer/2022020108/5a9ddc5f7f8b9aee528d5b58/html5/thumbnails/1.jpg)
Tools &Methodologies Working Group System Interfaces – Definition and Design1
System Interfaces System Interfaces --Definition and DesignDefinition and Design
Best PracticesBest Practices
Version 1.1, 8/3/2010Version 1.1, 8/3/2010
AuthorsAuthors ::Benzi Lavi Benzi Lavi –– OrbotechOrbotechAvigdor Rosenberg Avigdor Rosenberg ––
BiosenseBiosense --WebsterWebsterAmir Tomer Amir Tomer –– ILTAMILTAM
Main contributors and reviewersMain contributors and reviewers ::Jacqueline Yoetz Jacqueline Yoetz –– MBT/IAIMBT/IAIRevital Goldberg Revital Goldberg –– MBT/IAIMBT/IAITsvi Rubin Tsvi Rubin –– IAIIAIShay Amsili Shay Amsili –– KodakKodakOrly Mayer Orly Mayer –– ElopElopUzi Minsker Uzi Minsker –– ElopElop
![Page 2: System Interfaces - Definition and Design Best · PDF fileMethodologies Working Group & Tools 1 System Interfaces – Definition and Design System Interfaces - Definition and Design](https://reader031.fdocuments.in/reader031/viewer/2022020108/5a9ddc5f7f8b9aee528d5b58/html5/thumbnails/2.jpg)
Tools &Methodologies Working Group System Interfaces – Definition and Design2
BackgroundBackground
• This document has been produced as a result of a series of
meetings and discussions in the Tools and Methodologies
Working Group (TMWG) coordinated by ILTAM.
• Representative Systems Engineers from a number of Israeli
industries (both defense and civil) participated in those
meetings, contributing best practices obtained at their
companies through years of experience and knowledge.
![Page 3: System Interfaces - Definition and Design Best · PDF fileMethodologies Working Group & Tools 1 System Interfaces – Definition and Design System Interfaces - Definition and Design](https://reader031.fdocuments.in/reader031/viewer/2022020108/5a9ddc5f7f8b9aee528d5b58/html5/thumbnails/3.jpg)
Purpose and Use (1)Purpose and Use (1)
• This document is intended to serve as a recommended methodology
and guideline for the identification, definition and design of System
Interfaces.
• These activities are performed in line with System Requirements
Analysis and System Architectural (Top Level) Design, resulting in a
detailed Interface Design Document, which is an integral part of the
overall system design.
• This document provides its user with a brief and essential overview
of the process and issues regarding interface design.
Tools &Methodologies Working Group System Interfaces – Definition and Design3
![Page 4: System Interfaces - Definition and Design Best · PDF fileMethodologies Working Group & Tools 1 System Interfaces – Definition and Design System Interfaces - Definition and Design](https://reader031.fdocuments.in/reader031/viewer/2022020108/5a9ddc5f7f8b9aee528d5b58/html5/thumbnails/4.jpg)
Purpose and Use (2)Purpose and Use (2)
• Complementary comprehensive information resides in many
knowledge sources, such as systems engineering standards, guide
books and web pages. This guide, however, does not contain the
detailed knowledge itself – instead it contains references to relevant
sources which are quoted in its "References" pages.
Tools &Methodologies Working Group System Interfaces – Definition and Design4
![Page 5: System Interfaces - Definition and Design Best · PDF fileMethodologies Working Group & Tools 1 System Interfaces – Definition and Design System Interfaces - Definition and Design](https://reader031.fdocuments.in/reader031/viewer/2022020108/5a9ddc5f7f8b9aee528d5b58/html5/thumbnails/5.jpg)
Reading this DocumentReading this Document
• The best way to browse this document is using PowerPoint 2003 and up is “Slide Show” mode, navigating as follows:
• The up-arrow (↑) and down-arrow (↓) keys lead to the next/previous page, accordingly.
• Underlined text denotes a hyperlink: clicking on it will lead to pages with details and explanations about the corresponding issue.
• Clicking on the “Return” button ( ) at the bottom-right of a page will go back to the last page viewed.
• References to external sources are marked with number-letter pairs in square brackets (e.g. [2-d], [5-b,e]. Clicking a reference will lead to the appropriate reference page, where the exact reference is cited.
• Clicking the right mouse button pops up a menu, from which, by selecting “Go to slide...”, any page of the document may be accessed directly.
Tools &Methodologies Working Group System Interfaces – Definition and Design5
![Page 6: System Interfaces - Definition and Design Best · PDF fileMethodologies Working Group & Tools 1 System Interfaces – Definition and Design System Interfaces - Definition and Design](https://reader031.fdocuments.in/reader031/viewer/2022020108/5a9ddc5f7f8b9aee528d5b58/html5/thumbnails/6.jpg)
Printing this DocumentPrinting this Document
• The entire document, as well as selected pages, may be also printed. Using the “handout” option with 2 slides per page will provide sufficiently readable paper copy.
Tools &Methodologies Working Group System Interfaces – Definition and Design6
![Page 7: System Interfaces - Definition and Design Best · PDF fileMethodologies Working Group & Tools 1 System Interfaces – Definition and Design System Interfaces - Definition and Design](https://reader031.fdocuments.in/reader031/viewer/2022020108/5a9ddc5f7f8b9aee528d5b58/html5/thumbnails/7.jpg)
Diagram FormatDiagram Format
• The processes in the following pages are represented in UML’s Activity Diagram form.
Key
activity
data object
control flow
data flow (input/output)
fork (control splits to parallel activities)
join (control merges from parallel activities)
Tools &Methodologies Working Group System Interfaces – Definition and Design7
Activity
Data
start
end
![Page 8: System Interfaces - Definition and Design Best · PDF fileMethodologies Working Group & Tools 1 System Interfaces – Definition and Design System Interfaces - Definition and Design](https://reader031.fdocuments.in/reader031/viewer/2022020108/5a9ddc5f7f8b9aee528d5b58/html5/thumbnails/8.jpg)
Process Description PagesProcess Description Pages
Tools &Methodologies Working Group System Interfaces – Definition and Design8
![Page 9: System Interfaces - Definition and Design Best · PDF fileMethodologies Working Group & Tools 1 System Interfaces – Definition and Design System Interfaces - Definition and Design](https://reader031.fdocuments.in/reader031/viewer/2022020108/5a9ddc5f7f8b9aee528d5b58/html5/thumbnails/9.jpg)
• The recommended System Interfaces Definition and Design
process goes through 4 phases, as follows:
• The diagrams in the following pages describe each phase in
detail.
Interface Management and Control
The ProcessThe Process
Tools &Methodologies Working Group System Interfaces – Definition and Design9
Interface Requirements Definition
InterfaceTop Level Design
Interface DetailedDesign
InterfaceTestDesign
![Page 10: System Interfaces - Definition and Design Best · PDF fileMethodologies Working Group & Tools 1 System Interfaces – Definition and Design System Interfaces - Definition and Design](https://reader031.fdocuments.in/reader031/viewer/2022020108/5a9ddc5f7f8b9aee528d5b58/html5/thumbnails/10.jpg)
Interface Requirements DefinitionInterface Requirements Definition
Tools &Methodologies Working Group System Interfaces – Definition and Design10
Identify system boundaries
[1-b]
Identify and derive external interfaces
[2-a,b,c], [5-c]
Identify external interface constrains
CustomerRequirements
SystemConstraints
System in itsEnvironment
[1-a]
External Interface
Requirements
![Page 11: System Interfaces - Definition and Design Best · PDF fileMethodologies Working Group & Tools 1 System Interfaces – Definition and Design System Interfaces - Definition and Design](https://reader031.fdocuments.in/reader031/viewer/2022020108/5a9ddc5f7f8b9aee528d5b58/html5/thumbnails/11.jpg)
Interface Top Level DesignInterface Top Level Design
Tools &Methodologies Working Group System Interfaces – Definition and Design11
Identify main subsystems
Identify internal interfaces [5-c]
Identify interface constrains
External Interface
Requirements*
Top Level Design &
FunctionalAnalysis
Top Level Interface
Definitions
Conceptual Test Plan
Classify Ext.& Int. interfaces by types
[4-a],[3-b,f,c]
Define the behavior of each type
Define responsibilities
Define tests(top level)
* from Interface RequirementsDefinition
![Page 12: System Interfaces - Definition and Design Best · PDF fileMethodologies Working Group & Tools 1 System Interfaces – Definition and Design System Interfaces - Definition and Design](https://reader031.fdocuments.in/reader031/viewer/2022020108/5a9ddc5f7f8b9aee528d5b58/html5/thumbnails/12.jpg)
Interface Detailed DesignInterface Detailed Design
Tools &Methodologies Working Group System Interfaces – Definition and Design12
Verify interface consistency
[2-d],[4-a],[6-a]
Define detailed characteristics of
interfaces
Define detailed requirements of
interfaces
Top Level Interface
Definitions*
Interface Detailed Design
* from Interface Top LevelDesign
![Page 13: System Interfaces - Definition and Design Best · PDF fileMethodologies Working Group & Tools 1 System Interfaces – Definition and Design System Interfaces - Definition and Design](https://reader031.fdocuments.in/reader031/viewer/2022020108/5a9ddc5f7f8b9aee528d5b58/html5/thumbnails/13.jpg)
Interface Test DesignInterface Test Design
Tools &Methodologies Working Group System Interfaces – Definition and Design13
Define tests per interface
characteristics
Interface Detailed Design*
Regulatory & Safety
Requirements
Conceptual Test Plan**
Detailed Interface POD†
Plan
* from Interface Detailed Design** from Interface Top Level Design
† POD = Proof of Design
![Page 14: System Interfaces - Definition and Design Best · PDF fileMethodologies Working Group & Tools 1 System Interfaces – Definition and Design System Interfaces - Definition and Design](https://reader031.fdocuments.in/reader031/viewer/2022020108/5a9ddc5f7f8b9aee528d5b58/html5/thumbnails/14.jpg)
Interface Management and ControlInterface Management and Control
•• Interfaces, both external and internal, should be managed Interfaces, both external and internal, should be managed
and controlled throughout the system lifecycle, in order to and controlled throughout the system lifecycle, in order to
ensure sustained compatibility and consistency, both among ensure sustained compatibility and consistency, both among
themselves and with the system.themselves and with the system.
•• Interface management should address the following issues:Interface management should address the following issues:
– Interface control [3-e],[4-c,e,f],[5-a]
– Interface configuration management [3-d],[4-d]
– Interface change management [4-b],[5-a]
Tools &Methodologies Working Group System Interfaces – Definition and Design14
![Page 15: System Interfaces - Definition and Design Best · PDF fileMethodologies Working Group & Tools 1 System Interfaces – Definition and Design System Interfaces - Definition and Design](https://reader031.fdocuments.in/reader031/viewer/2022020108/5a9ddc5f7f8b9aee528d5b58/html5/thumbnails/15.jpg)
Explanation PagesExplanation Pages
Tools &Methodologies Working Group System Interfaces – Definition and Design15
![Page 16: System Interfaces - Definition and Design Best · PDF fileMethodologies Working Group & Tools 1 System Interfaces – Definition and Design System Interfaces - Definition and Design](https://reader031.fdocuments.in/reader031/viewer/2022020108/5a9ddc5f7f8b9aee528d5b58/html5/thumbnails/16.jpg)
System ConstraintsSystem Constraints
• The following is a partial list of applicable system constraints
– Dimensions– Weight
– Rate
– Immunity– Environmental conditions
• temperature, humidity, water/splash resistance, air quality/pollution, vibrations
– Acoustic noise (produced by the system)– Safety
– Reliability
– Maintainability– Cleanability
– Standards
– Regulatory requirements
Tools &Methodologies Working Group System Interfaces – Definition and Design16
![Page 17: System Interfaces - Definition and Design Best · PDF fileMethodologies Working Group & Tools 1 System Interfaces – Definition and Design System Interfaces - Definition and Design](https://reader031.fdocuments.in/reader031/viewer/2022020108/5a9ddc5f7f8b9aee528d5b58/html5/thumbnails/17.jpg)
Interface ClassificationInterface Classification
• The following is a partial list of possible interface classes
– External Interface
– Internal Interface
– Physical Interface
– Logical Interface
– H/W Interface
– S/W Interface
Note: Any single interface may be classified into more than one
of the above
Tools &Methodologies Working Group System Interfaces – Definition and Design17
![Page 18: System Interfaces - Definition and Design Best · PDF fileMethodologies Working Group & Tools 1 System Interfaces – Definition and Design System Interfaces - Definition and Design](https://reader031.fdocuments.in/reader031/viewer/2022020108/5a9ddc5f7f8b9aee528d5b58/html5/thumbnails/18.jpg)
Interface BehaviorInterface Behavior
• The following list contains some of the possible behavior
definition parameters for data interfaces.
– Message/Data interface:
• What side may initiate messaging
• Synchronization method
• Data integrity check, acknowledge, retransmit
• Periodic / event-driven
• Protocol definition (physical, logical / messages format)
Tools &Methodologies Working Group System Interfaces – Definition and Design18
![Page 19: System Interfaces - Definition and Design Best · PDF fileMethodologies Working Group & Tools 1 System Interfaces – Definition and Design System Interfaces - Definition and Design](https://reader031.fdocuments.in/reader031/viewer/2022020108/5a9ddc5f7f8b9aee528d5b58/html5/thumbnails/19.jpg)
Interface Definition Example/TemplateInterface Definition Example/Template
• An attached Excel file contains a list of examples of some
possible types and sub-types of interfaces and of their
characteristics. The list is not full and is provided as example,
guidance and reminder for possible characteristics, which
need to be defined, per type. The file may be used as a
baseline and may be updated and enriched per need.
• The types, sub-types and characteristics are grouped into
three levels. You can press on 1, or 2, or 3, at the upper left
corner, in order to view the relevant groups.
Tools &Methodologies Working Group System Interfaces – Definition and Design19
InterfaceTypes and
CharacteristicsMake sure that the file “interfaces - types and characteristics.xls” is located in the same directory as this document
![Page 20: System Interfaces - Definition and Design Best · PDF fileMethodologies Working Group & Tools 1 System Interfaces – Definition and Design System Interfaces - Definition and Design](https://reader031.fdocuments.in/reader031/viewer/2022020108/5a9ddc5f7f8b9aee528d5b58/html5/thumbnails/20.jpg)
Interface Test PlanningInterface Test Planning
• The test plan should include (beside schedule and tasks list)
the tests for each interface, the pre-conditions and success
criteria for transition from one test to the other.
• The tests should take into account the defined characteristics
and the system constraints (such as environmental
conditions, drop test, etc.), relevant for the tested interface.
• The test plan should take into account need for simulators,
sniffers and recordings, needed for testing the interfaces.
Tools &Methodologies Working Group System Interfaces – Definition and Design20
![Page 21: System Interfaces - Definition and Design Best · PDF fileMethodologies Working Group & Tools 1 System Interfaces – Definition and Design System Interfaces - Definition and Design](https://reader031.fdocuments.in/reader031/viewer/2022020108/5a9ddc5f7f8b9aee528d5b58/html5/thumbnails/21.jpg)
Interface Design VerificationInterface Design Verification
• Verify interface definitions completeness as per system
structure / block diagram
• Check interfaces consistency to assure that an output is
defined for every input, and vice versa
• Check functional consistency to assure that for every function
- inputs are defined to fulfill that function
Tools &Methodologies Working Group System Interfaces – Definition and Design21
![Page 22: System Interfaces - Definition and Design Best · PDF fileMethodologies Working Group & Tools 1 System Interfaces – Definition and Design System Interfaces - Definition and Design](https://reader031.fdocuments.in/reader031/viewer/2022020108/5a9ddc5f7f8b9aee528d5b58/html5/thumbnails/22.jpg)
ResponsibilitiesResponsibilities
• The system engineer is responsible to define the overall
characteristics of the interfaces .
• The system engineer should define the responsibility (owner)
for each interface’s detailed design.
Tools &Methodologies Working Group System Interfaces – Definition and Design22
![Page 23: System Interfaces - Definition and Design Best · PDF fileMethodologies Working Group & Tools 1 System Interfaces – Definition and Design System Interfaces - Definition and Design](https://reader031.fdocuments.in/reader031/viewer/2022020108/5a9ddc5f7f8b9aee528d5b58/html5/thumbnails/23.jpg)
Reference PagesReference Pages
Tools &Methodologies Working Group System Interfaces – Definition and Design23
copyright noticeThe references quoted in the following are subject to
intellectual property restrictions. Copies of the documents may be obtained from their owners.
![Page 24: System Interfaces - Definition and Design Best · PDF fileMethodologies Working Group & Tools 1 System Interfaces – Definition and Design System Interfaces - Definition and Design](https://reader031.fdocuments.in/reader031/viewer/2022020108/5a9ddc5f7f8b9aee528d5b58/html5/thumbnails/24.jpg)
References (1)References (1)
1)1) ISO/IEC 15288 ISO/IEC 15288 –– System Life Cycle Processes, 2008*System Life Cycle Processes, 2008*
a) 5.1 Enabling systems
b) 6.4.2.3 (a)(1) Define the functional boundary
Tools &Methodologies Working Group System Interfaces – Definition and Design24
* Copyright © 2008 ISO/IEC-IEEE
![Page 25: System Interfaces - Definition and Design Best · PDF fileMethodologies Working Group & Tools 1 System Interfaces – Definition and Design System Interfaces - Definition and Design](https://reader031.fdocuments.in/reader031/viewer/2022020108/5a9ddc5f7f8b9aee528d5b58/html5/thumbnails/25.jpg)
References (2)References (2)
2)2) INCOSE Systems Engineering Handbook, Ver. 2.0, 2002*INCOSE Systems Engineering Handbook, Ver. 2.0, 2002*
a) 4.3.1.4.3.4 Define/Refine Functional Interfaces (internal and external)
b) 4.3.1.4.4.2 N2 Charts
c) 4.4.4.2 SYSTEM INTEGRATION WITH EXTERNAL SYSTEMS (4:
InterFace Working Groups and ICD)
d) 4.4.4.1 System Build (step 3: Ascertain interfaces)
Tools &Methodologies Working Group System Interfaces – Definition and Design25
* copyright © by INCOSE
![Page 26: System Interfaces - Definition and Design Best · PDF fileMethodologies Working Group & Tools 1 System Interfaces – Definition and Design System Interfaces - Definition and Design](https://reader031.fdocuments.in/reader031/viewer/2022020108/5a9ddc5f7f8b9aee528d5b58/html5/thumbnails/26.jpg)
References (3)References (3)
3)3) IEEE Std 1220IEEE Std 1220--2005 (ISO/IEC 26702:2007)* 2005 (ISO/IEC 26702:2007)* ––
Application and management of the systems engineering Application and management of the systems engineering
processprocess
a) 5.1.2.2 System and product specifications
b) 6.3.1.2 Define functional interfaces
c) 6.5.7 Define physical interfaces
d) 6.8.1.3 Interface Management
e) Annex B.2 Engineering plan structure (sec. 3.9.2 – Interface Mgmt.)
f) 3.1.19 Interface specification
Tools &Methodologies Working Group System Interfaces – Definition and Design26
* Copyright © 2008 ISO/IEC-IEEE
![Page 27: System Interfaces - Definition and Design Best · PDF fileMethodologies Working Group & Tools 1 System Interfaces – Definition and Design System Interfaces - Definition and Design](https://reader031.fdocuments.in/reader031/viewer/2022020108/5a9ddc5f7f8b9aee528d5b58/html5/thumbnails/27.jpg)
References (4)References (4)
4)4) CMMICMMI®® for Development, version 1.2*for Development, version 1.2*
a) Product Integration (PI), SP 2.1 Review interface descriptions
b) Product Integration (PI), SP 2.2 Manage interfaces
c) Product Integration (PI), GP 2.2 Plan the process
d) Product Integration (PI), SP 2.6 Manage configuration
e) Product Integration (PI), SP 2.7 Identify and involve relevant stakeholders
f) Product Integration (PI), SP 2.8 Monitor and control the process
Tools &Methodologies Working Group System Interfaces – Definition and Design27
* copyright © by Carnegie Mellon University
![Page 28: System Interfaces - Definition and Design Best · PDF fileMethodologies Working Group & Tools 1 System Interfaces – Definition and Design System Interfaces - Definition and Design](https://reader031.fdocuments.in/reader031/viewer/2022020108/5a9ddc5f7f8b9aee528d5b58/html5/thumbnails/28.jpg)
References (5)References (5)
5)5) ANSI/EIAANSI/EIA--632632--1998 1998 –– Processes for Engineering a SystemProcesses for Engineering a System
a) Table C.12 d) Perform interface management
b) Annex D, D.2 7) Interface control plan
c) Annex A (Glossary) Interface Requirement
Tools &Methodologies Working Group System Interfaces – Definition and Design28
* copyright © by the Electronic Industries Association
![Page 29: System Interfaces - Definition and Design Best · PDF fileMethodologies Working Group & Tools 1 System Interfaces – Definition and Design System Interfaces - Definition and Design](https://reader031.fdocuments.in/reader031/viewer/2022020108/5a9ddc5f7f8b9aee528d5b58/html5/thumbnails/29.jpg)
References (6)References (6)
6)6) ISO/IEC 15289:2006* Content of systems and software life ISO/IEC 15289:2006* Content of systems and software life
cycle process information products (Documentation)cycle process information products (Documentation)
a) 10.27 Interface description
Tools &Methodologies Working Group System Interfaces – Definition and Design29
* Copyright © 2008 ISO/IEC-IEEE