O ORPAON
SCADA & Supervisory Systems

SCADA system requirements specification: how to write

A SCADA system requirements specification is the core attachment of a tender and technical contract—it converts monitoring scope, functional boundaries, data conventions, alarm strategy and acceptance criteria into verifiable clauses, and decides whether the project closes on schedule or drifts into scope disputes.

Structure diagram of a SCADA requirements specification: five modules — boundary, functions, data, alarms, acceptance — arranged around a central SRS document

What chapters a SCADA requirements specification should cover

A specification usable directly as a tender or contract attachment is usually organized in the following order, and every chapter should end in verifiable clauses rather than generic capability statements:

  • Background and objectives: the list of monitored objects (workshops, pump stations, power rooms), the operating problems to solve, and the relation to existing systems
  • System boundary and interfaces: where SCADA responsibility ends, and who owns the interfaces to PLC, MES and video systems
  • Functional requirements: monitoring, control, alarms, trends, reports, permissions and redundancy listed item by item, each with a priority
  • Data requirements: point table size, sampling cycles, history retention period, archiving and export methods
  • Non-functional requirements: availability targets, refresh and response limits, concurrent clients, cybersecurity and audit requirements
  • Acceptance and delivery criteria: FAT/SAT items, test conditions, documents and training, warranty responsibilities

The order of chapters can be adjusted, but each chapter must answer one question: how will acceptance prove it? A clause with no verification method should either get criteria added or be removed—such clauses are where disputes start at acceptance time.

How to write the key fields: from capability wording to testable clauses

Functional and data requirements are the core of the specification. The key is to phrase every requirement as input–processing–observable result. The table below contrasts frequent sections:

SectionWhat to writeExample clauseCommon gapWhy it matters
FunctionsObservable behavior of each screen and operationPump station screen refreshes all telemetry within 2 s; status echoes within 1 s after an operation"Real-time monitoring" with no time limitWithout limits nothing can be tested
Points and dataPoint count, sampling and storage conventionsAbout 5,000 points; analog 1 sample/s; change-of-value storage for digitalsRetention and compression undecidedDrives storage sizing and cost
CommunicationProtocol, direction and failure behaviorModbus TCP / OPC UA acquisition; buffered backfill after reconnectBackfill after outages omittedLost data during outages is a classic dispute
AlarmsTiering, notification chain, acknowledgmentThree tiers; escalation from crew to workshop to dispatch; acknowledgment and reset logged separatelyOnly "abnormal alarms" writtenAlarm floods usually originate here
Permissions and auditRole matrix and operation trailEvery operation, edit and acknowledgment logs user and timeAudit log retention undefinedA hard requirement in compliance audits

Give each requirement a unique identifier and a priority (mandatory, expected, optional), and let acceptance test cases reference those identifiers directly. During FAT/SAT the checklist then maps one-to-one, with nothing skipped and nothing re-interpreted.

Common gaps and red lines: the expensive mistakes at contract stage

Reviews of delivered monitoring projects show that specifications rarely miss feature clauses—they miss boundaries and conventions. These gaps appear often and cost the most to fix later:

  • Boundary gaps: control authority between SCADA and PLC not defined—who issues setpoints, whether local or remote takes priority, and how fail-safe acts
  • Data gaps: history retention and export format not agreed—years into operation the plant cannot satisfy an audit trace
  • Communication gaps: protocol names without failure behavior—reconnect, buffered backfill and time synchronization each lack clauses
  • Alarm gaps: no tiering or suppression strategy—after go-live alarms flood the screen and operators miss critical ones
  • Acceptance gaps: criteria written as "stable operation"—no quantified indicators or test conditions, so each side interprets freely
Five-question sign-off checklist: control authority, retention period, link failure, alarm routing and acceptance proof on five cards with checkboxes

The fix is a counter-question list per gap type: ask "who holds control authority" in the boundary chapter, "how long is data kept and how is it exported" in the data chapter, "what happens when the link breaks" in the communication chapter, "who receives which alarm at what time" in the alarm chapter, and "which test conditions prove it" in the acceptance chapter. When all five have answers inside the document, the specification is ready to serve as a contract attachment.

Summary

One criterion decides whether a SCADA requirements specification is ready for a contract attachment: every clause states an observable result and a verification method. The chapter framework, the field-by-field table and the five-question checklist can be applied directly to your next tender, settling boundaries and conventions before work starts.

Request an on-site diagnosis

An experienced engineer will review your monitoring scope, point conventions and acceptance criteria with you, so the requirements specification is settled before tender and contract. An English-speaking contact is available throughout for cross-border projects.

Contact Us