Systems Engineering FAQ

Answers by Robert Halligan FIE Aust CPEng IntPE(Aus).

Your System Requirements Specification and Software Requirements Specification templates start off in a “4. Requirements” section with “4.1 Identification of External Interfaces”, and “4.2 Identification of States and Modes”. Why is that?

Share

Technically, it is possible to avoid having the sections “Identification of External Interfaces” and “Identification of States and Modes”, and to use a definition of each interface and state and mode in a Definitions section instead. The pros and cons are:

External Interfaces:

Advantages of “Identification of External Interfaces” section 4.1:

  • prevents logical non-sequeta in subsequent references to a given interface, e.g. “The system, in response to a xxx input at the xyz interface, shall ..” without having defined a requirement for the system to have such an interface
  • increases ease of understanding of the requirements and requirements section overall, by establishing context. In fact, it is not uncommon to follow the “shall have the following external interfaces ..” requirement with an image (not box)-oriented informative (not normative) context diagram
  • accurately states actual requirements
  • avoids contrived definitions “Mains Power Interface means an interface for the purpose of connection of mains power”
  • contractually stronger (We know there are requirements on the Remote Control Interface, but there was no requirement to have one, so we consider that they do not apply).
  • caters for the situation where there is a need for an interface, but the level of risk does not justify the formalization of requirements on that interface.

Disadvantages of “Identification of External Interfaces” section 4.1 (c.f. if replaced by definitions):

increases the number of requirements, and related work that is proportional to the number of requirements, e,g. traceability, verification requirements, verification design, verification

States & Modes:

Advantages of “Identification of States and Modes” section 4.2:

  • prevents logical non-sequeta in subsequent references to a given state or mode, e.g. “The system, in File Retrieve Mode, shall ..” without having defined a requirement for the system to have such a mode
  • increases ease of understanding of the requirements and requirements section overall, by describing big picture dynamics that are required, before the detail
  • accurately states actual requirements
  • contractually stronger (We know there are requirements in a Self-Test Mode, but there was no requirement to have a self-test mode, so we consider that they do not apply).

Disadvantages of “Identification of States and Modes” section 4.2 (c.f. if replaced by definitions only):

  • increases the number of requirements, and related work that is proportional to the number of requirements, e,g. traceability, verification requirements, verification design, verification

So, it is a trade-off.

Share

Answered By

Systems engineering thought leader, consultant, trainer and coach, impacting people's lives on six continents.
Published 1 year ago

 

2105_PPI-WEB_Ad-template

ENHANCE AND DEVELOP YOUR SKILLS

Gain concepts and principles that will take your career to another level with PPI training!

PPI_Logo_Symbol_Only.png
FREE Monthly SE Industry News?
Scroll to Top