Shopping Cart

No products in the cart.

BS ISO 21622-3:2024

$215.11

Irrigation techniques. Remote monitoring and control for irrigation – Interoperability

Published By Publication Date Number of Pages
BSI 2024 380
Guaranteed Safe Checkout
Categories: ,

If you have any questions, feel free to reach out to our online customer service team by clicking on the bottom right corner. We’re here to assist you 24/7.
Email:[email protected]

PDF Catalog

PDF Pages PDF Title
2 undefined
3 76901
9 1 Scope
2 Normative reference
10 3 Terms and definitions
12 4 Interoperability I: System architecture
4.1 Levels and components of an interoperable architecture
4.1.1 General
13 4.1.2 Control level
4.1.2.1 Subsystem
4.1.2.2 Coordination broker
4.1.3 Management level
14 4.2 Interface specifications
4.2.1 General
4.2.2 Data access authorizations
4.2.3 Irrigation entity identification
15 4.2.4 Common methods to management and subsystem interfaces
4.2.4.1 General
4.2.4.2 Writing a property of an entity (Write method)
16 4.2.4.3 Reading a property of an entity (Read method)
17 4.2.4.4 Reading the standard history of a property (ReadStandHist method)
18 4.2.4.5 Creating a procedural element (CreateRecipe method)
19 4.2.4.6 Stopping a procedural element (StopRecipe method)
20 4.2.4.7 Reading procedural element report (ReadReport method)
21 4.2.4.8 Reading ID of procedural elements in the subsystem for an entity (ReadProceduralIDs method)
4.2.5 Specific methods of the subsystem interface
4.2.5.1 General
22 4.2.5.2 Subscription of the coordination broker to the events occurred in an irrigation entity (SubscribeEvent method)
4.2.5.3 Unsubscription of the coordination broker to the events occurred in an irrigation entity (UnsubscribeEvent method)
4.2.6 Specific actions of the management interface
4.2.6.1 General
23 4.2.6.2 Read IDs of all the irrigation entities (ReadEntityIDs method)
4.2.6.3 Read static data of an irrigation entity (ReadEntityData method)
24 4.2.6.4 Reading the ID of procedural elements in the coordination broker for an irrigation entity (GetProceduralIDs method)
4.2.6.5 Reading the events occurred in an irrigation entity (ReadEvent method)
26 4.2.7 Specific methods of event interface
4.2.7.1 New event occurred in an irrigation entity (NewEvent method)
4.2.8 Application of the methods on properties
28 5 Interoperability II: exchange of data from irrigation entities
5.1 General outline
5.2 Static data of the irrigation entities
5.2.1 General
34 5.2.2 SpatialData specification
35 5.2.3 Topological data specification
5.2.3.1 General
5.2.3.2 Unit level
5.2.3.3 Equipment module level
36 5.3 Structure of an irrigation entity identifier (EntityID)
5.4 Properties
43 5.5 Entity events
45 6 Interoperability III: Exchange of data from procedural elements performed in irrigation entities
6.1 General outline
6.2 Statuses and actions
6.3 Types of Operation recipes
6.3.1 General
47 6.3.2 Parameterization of header
6.3.3 Formula parameterization (common parameters) for irrigation Operations
48 6.3.4 Additional parameters of an IrrigationRecipe1
50 6.3.5 Additional parameters of a IrrigationRecipe3
6.3.6 Additional parameters of a IrrigationRecipe4
52 6.3.7 Formula parameterization for NetworkBranchRecipe1
54 6.3.8 Formula parameterization (common parameters) for pumping Operations
56 6.3.9 Additional parameters of a PumpingRecipe1
57 6.3.10 Additional parameters of a PumpingRecipe2
6.3.11 Additional parameters of a PumpingRecipe3
58 6.3.12 Additional parameters of a PumpingRecipe4
6.3.13 Additional parameters of a PumpingRecipe5
6.3.14 Formula parameterization (common parameters) for control point Operations
60 6.3.15 Formula parameterization for ControlPointRecipe1
6.3.16 Formula parameterization for ControlPointRecipe2
6.3.17 Formula parameterization for ControlPointRecipe3
61 6.3.18 Formula parameterization (common parameters) for fertigation Operations
6.3.19 Additional parameters of a FertigationRecipe1
62 6.3.20 Additional parameters of a FertigationRecipe2
63 6.3.21 Additional parameters of a FertigationRecipe3
6.3.22 Additional parameters of a FertigationRecipe4
6.3.23 Additional parameters of a FertigationRecipe5
64 6.3.24 Formula parameterization for FiltrationRecipe1
6.4 Types of Unit Procedure recipes
6.4.1 General
65 6.4.2 Parameterization of header
6.4.3 Formula parameterization for Unit Procedures
66 6.5 Types of Procedure recipes
6.5.1 Parameterization of header
6.5.2 Formula parameterization for Procedures
67 6.6 Report
68 6.6.1 Additional report parameters of Pumping recipes
69 6.6.2 Additional report parameters of Reservoir recipes
6.6.3 Additional report parameters of Fertigation recipes
70 6.6.4 Additional report parameters of Filtration recipes
6.7 Procedural element events
72 Annex A (normative) Management interface with SOAP 1.2
A.1 Overview
A.2 Requirements
A.2.1 General
A.2.2 Data protection
73 A.2.3 Security
A.2.4 Header
A.2.5 Server requirements
A.2.6 Web Services Description Language (WSDL) contract
74 A.2.7 Classes and enumerations
A.3 Implementation classes for web services
A.3.1 Implementation criteria
A.3.2 ManagementServices class
77 A.3.3 Response class
78 A.3.4 WriteResponse class
A.3.5 ReadResponse class
A.3.6 ReadStandardHistResponse class
A.3.7 ReadEventResponse class
79 A.3.8 ReadReportResponse class
A.3.9 CreateRecipeResponse class
A.3.10 StopRecipeResponse class
A.3.11 Operation class
80 A.3.12 OperationParameter class
A.3.13 ReadProceduralIDsResponse class
A.3.14 ReadEntityIDsResponse class
A.3.15 GetProceduralIDsResponse class
81 A.3.16 ReadEntityDataResponse class
83 A.3.17 EventValue class
A.3.18 ParameterType enumeration
84 A.3.19 Status enumeration
A.3.20 RecipeType enumeration
85 A.3.21 RecipeParameterType enumeration
90 A.3.22 MonitoringParameterType enumeration
A.3.23 RepetitionParameterType enumeration
A.3.24 WeekCalendarParameterType enumeration
91 A.3.25 PropertyName enumeration
92 A.3.26 Statistics enumeration
A.3.27 EntityLevel enumeration
A.3.28 EntityType enumeration
A.3.29 ControlLevel enumeration
93 A.3.30 Behavior enumeration
A.3.31 FertigationMethod enumeration
A.3.32 EventName string
95 A.4 Implementation classes for authorization server
A.4.1 ManagementSecurity class
A.4.2 TokenResponse class
96 A.5 WSDL
112 Annex B (normative) Subsystem interface with SOAP 1.2
B.1 Overview
B.2 Requirements
B.2.1 General
113 B.2.2 Data protection
B.2.3 Security
B.2.4 Header
B.2.5 Server requirements
B.2.6 Web Services Description Language (WSDL) contract
114 B.2.7 Classes and enumerations
B.3 Implementation classes for web services
B.3.1 Implementation criteria
B.3.2 SubSystemCommunication class
117 B.3.3 Response class
B.3.4 WriteResponse class
B.3.5 ReadResponse class
B.3.6 ReadStandardHistResponse class
118 B.3.7 ReadReportResponse class
B.3.8 SubscribeEventResponse class
B.3.9 UnsubscribeEventResponse class
B.3.10 CreateRecipeResponse class
119 B.3.11 StopRecipeResponse class
B.3.12 Operation class
B.3.13 OperationParameter class
B.3.14 ReadProceduralIDsResponse class
120 B.3.15 ParameterType enumeration
B.3.16 Status enumeration
B.3.17 RecipeType enumeration
121 B.3.18 RecipeParameterType enumeration
126 B.3.19 MonitoringParameterType enumeration
B.3.20 RepetitionParameterType enumeration
127 B.3.21 WeekCalendarParameterType enumeration
B.3.22 PropertyName enumeration
128 B.3.23 Statistics enumeration
B.3.24 EntityLevel enumeration
B.3.25 EntityType enumeration
129 B.4 Implementation classes for authorization server
B.4.1 ManagementSecurity class
B.4.2 TokenResponse class
130 B.5 WSDL
143 Annex C (normative) Event interface with SOAP 1.2
C.1 Overview
C.2 Requirements
C.2.1 General
144 C.2.2 Data protection
C.2.3 Data protection regulations in the jurisdiction of use can apply.Security
C.2.4 Header
C.2.5 Server requirements
C.2.6 Web Services Description Language (WSDL) contract
145 C.2.7 Classes and enumerations
C.3 Implementation classes for web services
C.3.1 Implementation criteria
C.3.2 EventCommunication class
C.3.3 Response class
146 C.3.4 EventValue class
C.3.5 EventName string
148 C.4 Implementation classes for authorization server
C.4.1 ManagementSecurity class
C.4.2 TokenResponse class
C.5 WSDL
152 Annex D (informative) Interoperability test protocol
D.1 Overview
D.2 General description
153 D.3 IT infraestructure
154 D.4 Test bed description
D.4.1 General
D.4.2 Irrigation hydrant test module
156 D.5 Test procedure
D.5.1 General
157 D.5.2 Implementation conformance statement (ICS)
159 D.5.3 Common criteria applied to the conformance tests
D.5.4 Security criteria
D.5.5 Results
D.6 Tests over subsystems
D.6.1 Test application guide
160 D.6.2 Interface and action execution verification tests
D.6.2.1 General
161 D.6.2.2 Test “Reading a property of an entity (Read method)”
D.6.2.2.1 Abstract conformance test
D.6.2.2.2 Conformance tests
164 D.6.2.3 Test “Write a property of an entity (Write method)”
D.6.2.3.1 Abstract conformance test
D.6.2.3.2 Conformance tests
167 D.6.2.4 Test “Create a procedural element (CreateRecipe method)”
D.6.2.4.1 Abstract conformance test
D.6.2.4.2 Specific conformance tests for procedural elements with and without calendar
168 D.6.2.4.3 Common conformance tests
175 D.6.2.4.4 Specific conformance tests for IrrigationRecipe2
176 D.6.2.4.5 Specific conformance tests procedural elements with calendar
180 D.6.2.4.6 Specific conformance tests for procedural elements with repetitions
182 D.6.2.5 Test “Read the procedural elements loaded in the SUT (ReadProceduralIDs method)”
D.6.2.5.1 Abstract conformance test
183 D.6.2.5.2 Conformance tests
188 D.6.2.6 Test “Stop a procedural element (StopRecipe method)”
D.6.2.6.1 Abstract conformance test
D.6.2.6.2 Conformance tests
192 D.6.2.7 Test “Read a procedural element report (ReadReport method)”
D.6.2.7.1 Abstract conformance test
D.6.2.7.2 Conformance tests
197 D.6.2.7.3 Specific conformance tests procedural elements with calendar
199 D.6.2.7.4 Specific conformance tests for procedural elements with repetitions
202 D.6.2.7.5 Specific results
D.6.2.8 Test “Read the history of a property (ReadStandardHist method)”
D.6.2.8.1 Abstract conformance test
D.6.2.8.2 Conformance tests
212 D.6.2.8.3 Specific results
D.6.2.9 Test “Subscription to an entity events (SubscribeEvent method)”
D.6.2.9.1 Abstract conformance test
D.6.2.9.2 Conformance tests
213 D.6.2.10 Test “Unsubscription to an entity events (UnSubscribeEvent method)”
D.6.2.10.1 Abstract conformance test
D.6.2.10.2 Conformance tests
214 D.6.2.11 Test “Generation of an entity event (NewEvent method)”
D.6.2.11.1 Abstract conformance test
215 D.6.2.11.2 Conformance tests
218 D.6.3 Functionality verification tests
D.6.3.1 Property Mode
D.6.3.1.1 Abstract conformance test
219 D.6.3.1.2 Conformance tests
220 D.6.3.1.3 Specific conformance tests for SUTs supporting IrrigationRecipe2 operations
221 D.6.3.2 Property ActivityStatus
D.6.3.2.1 Abstract conformance test
D.6.3.2.2 Conformance tests
224 D.6.3.3 Property SystemStatus
D.6.3.3.1 Abstract conformance test
D.6.3.3.2 Conformance tests
226 D.6.3.4 Property OpeningDegree
D.6.3.4.1 Abstract conformance test
D.6.3.4.2 Conformance tests
228 D.6.3.5 Flow with closed valve event
D.6.3.5.1 Abstract conformance test
D.6.3.5.2 Conformance tests
229 D.6.3.6 No flow with open valve event
D.6.3.6.1 Abstract conformance test
D.6.3.6.2 Conformance tests
230 D.6.3.7 Execution of procedural elements
D.6.3.7.1 Abstract conformance test
D.6.3.7.2 Conformance tests
233 D.6.3.8 Numerical properties management
D.6.3.8.1 Abstract conformance test
D.6.3.8.2 Conformance tests
234 D.6.3.9 Standard history content validation
D.6.3.9.1 Abstract conformance test
D.6.3.9.2 Conformance tests
242 D.6.3.10 Report content validation
D.6.3.10.1 Abstract conformance test
D.6.3.10.2 Conformance tests
243 D.7 Tests over coordination brokers
D.7.1 Test application guide
D.7.2 Verification interfaces tests
D.7.2.1 Well parameterized requests
D.7.2.1.1 Abstract conformance test
D.7.2.1.2 Conformance tests
244 D.7.2.2 Bad parameterized requests
D.7.2.2.1 Abstract conformance test
D.7.2.2.2 Conformance tests
245 D.7.2.3 Events tests
D.7.2.3.1 Abstract conformance test
D.7.2.3.2 Conformance tests
246 D.7.2.4 Access and permission tests
D.7.2.4.1 Abstract conformance test
D.7.2.4.2 Conformance tests
247 D.7.3 Specific test for management interface methods
D.7.3.1 Test of “Reading the identifiers of all irrigation entities known by the SUT (ReadEntityIDs method)”
D.7.3.1.1 Abstract conformance test
D.7.3.1.2 Conformance tests
248 D.7.3.2 Test of “Reading the static data of an irrigation entity known by the SUT (ReadEntityData method)”
D.7.3.2.1 Abstract conformance test
D.7.3.2.2 Conformance tests
250 D.7.4 Routing test
D.7.4.1.1 Abstract conformance test
D.7.4.1.2 Conformance tests
D.7.5 Subsystem performing tests
D.7.5.1.1 Abstract conformance test
251 D.7.5.1.2 Conformance tests
D.8 Tests over management information systems
D.8.1 Test application guide
D.8.2 Management interface verification
D.8.2.1 Abstract conformance test
D.8.2.2 Conformance tests
253 D.9 Tests report
D.9.1 General
D.9.2 SUT data
D.9.3 Test data
D.9.4 Results
255 Annex E (informative) Coordination broker software requirement specifications
E.1 Overview
E.1.1 General
E.1.2 Definitions
E.1.3 System description
256 E.1.4 Technological environment
E.1.5 Standard and regulatory specifications
E.1.6 Architecture
E.1.7 User interface
257 E.1.8 Communication interfaces
E.1.9 Restrictions
E.1.10 Memory requirements
E.2 Data model
E.2.1 General
E.2.2 Data model: Report
258 E.2.3 Data model: Standard history
E.2.4 Data model: Procedural element
E.2.4.1 General
E.2.4.2 Enumerated Status
E.2.5 Data model: Irrigation entity
E.2.5.1 General
260 E.2.5.2 Enumerated EntityLevel
E.2.5.3 Enumerated EntityType
261 E.2.5.4 Enumerated CommProtocol
E.2.5.5 Enumerated RecipeType
E.2.5.6 Enumerated ControlLevel
262 E.2.5.7 Enumerated PropertyName
E.2.5.8 Enumerated Behavior
263 E.3 Minimal functions — Coordination broker
E.3.1 Function 1: Irrigation entity identification
E.3.2 Function 2: Irrigation entity administration
264 E.3.3 Function 3: Coordination broker authentication
E.3.4 Function 4: Management of coordination broker access over the management interface
E.3.5 Function 5: Subsystem access management
265 E.3.6 Function 6: Subsystem entity access levels
E.3.7 Function 7: Requests propagation to subsystem interface over the management interface
266 E.3.8 Function 8: Connection with subsystems
E.3.9 Function 9: Attending to system requests through the management interface
E.3.10 Function 10: Management of subscription of irrigation entity events
E.3.11 Function 11: Request verification
267 E.4 Desirable functions
E.4.1 Function 12: Standard history administration
268 E.4.2 Function 13: Procedural elements management
E.4.3 Function 14: Report administration
E.4.4 Function 15: Data bank
269 E.4.5 Function 16: Management of virtual irrigation entities
E.4.6 Function 17: Management of coordination broker access over the event interface
E.4.7 Function 18: Virtual irrigation entities logic execution
E.4.7.1 General
270 E.4.7.2 Procedural elements execution
E.4.7.3 Procedural elements status
E.4.7.4 Property management
E.4.7.4.1 General
271 E.4.7.4.2 ActivityStatus reading
E.4.7.4.3 ActivityStatus writing
272 E.4.7.4.4 SystemStatus
E.4.7.4.5 Mode
E.4.7.4.6 CumulativeVolumeOut
E.4.7.4.7 PressureOut/PressureIn
273 E.4.7.4.8 InternalFlowOut
E.4.7.4.9 InternalFlowIn
E.4.7.4.10 CumulativeVolumeIn
274 E.4.7.4.11 OpeningDegree
E.4.7.5 Mandatory verifications
E.4.7.6 Desirable verifications
E.4.7.6.1 CumulativeVolumeIn=CumulativeVolumeOut
E.4.7.7 Report generation
E.4.7.8 Standard history generation
275 E.4.7.9 Event generation
E.5 Specific requirements
E.5.1 General
E.5.2 User interface requirements
E.5.3 Communication interfaces requirements
276 E.5.4 Minimal functions
E.5.4.1 Function 1: Unequivocal identification of irrigation entities
E.5.4.2 Function 2: Irrigation entity administration
278 E.5.4.3 Function 3: Requests propagation over the management and subsystem interfaces
279 E.5.4.4 Function 4: Coordination broker authentication
E.5.4.5 Function 5: Management of coordination broker access over the management interface
280 E.5.4.6 Function 6: Management of events subscription and unsuscription
E.5.4.7 Function 7: Attending to requests through the management interface
281 E.5.4.8 Function 8: Connection with subsystems
282 E.5.4.9 Function 9: Subsystem access management
E.5.4.10 Function 10: Subsystem entity access levels
283 E.5.4.11 Function 11: Management of events subscription and unsuscription
284 E.5.4.12 Function 12: Request verification
E.5.5 Desirable functions
E.5.5.1 Function 13: Standard history administration
286 E.5.5.2 Function 14: Procedural elements administration
287 E.5.5.3 Function 15: Report administration
E.5.5.4 Function 16: Data bank
290 E.5.5.5 Function 17: Management of virtual irrigation entities
291 E.5.5.6 Function 18: Virtual irrigation entity logic execution
293 E.6 Request management
302 E.7 Cases of use
303 Annex F (normative) Management interface with REST
F.1 Overview
F.2 Requirements
F.2.1 General
F.2.2 Data protection
304 F.2.3 Security
F.2.4 Header
F.2.5 Servers requirements
F.2.6 Web Application Description Language (WADL)
F.2.7 Classes and enumerations
305 F.3 Implementation method for web services
F.3.1 ReadEntityIDs method
F.3.2 ReadEntityData method
308 F.3.3 Read method
309 F.3.4 Write method
F.3.5 ReadStandardHist method
310 F.3.6 ReadEvent method
311 F.3.7 CreateRecipe method
312 F.3.8 StopRecipe method
313 F.3.9 ReadReport method
F.3.10 ReadProceduralIDs method
314 F.3.11 GetProceduralIDs method
315 F.4 ComplexType definition
F.4.1 Statistics enumeration
F.4.2 PropertyName enumeration
316 F.4.3 Response class
317 F.4.4 EntityLevel enumeration
F.4.5 EntityType enumeration
F.4.6 ControlLevel enumeration
318 F.4.7 Behavior enumeration
F.4.8 RecipeType enumeration
319 F.4.9 RecipeParameterType enumeration
323 F.4.10 MonitoringParameterType enumeration
324 F.4.11 MonitoringParameter enumeration
F.4.12 RepetitionParameterType enumeration
325 F.4.13 RepetitionParameter enumeration
F.4.14 WeekCalendarParameterType enumeration
F.4.15 WeekCalendarParameter
F.4.16 ParameterType enumeration
326 F.4.17 FertigationMethod enumeration
F.4.18 OperationParameter enumeration
F.4.19 Operation class
F.4.20 Status enumeration
327 F.4.21 EventName string
328 F.4.22 EventValues class
329 F.5 Implementation methods for authorization
F.5.1 GetToken method
330 F.5.2 RefreshToken method
F.6 WADL
333 F.7 ComplexTypeF
342 Annex G (normative) Subsystem interface with REST
G.1 Overview
G.2 Requirements
G.2.1 General
343 G.2.2 Data protection
G.2.3 Security
G.2.4 Header
G.2.5 Servers requirements
G.2.6 Web Application Description Language (WADL)
G.2.7 Classes and enumerations
344 G.3 Implementation method for web services
G.3.1 Read method
G.3.2 Write method
345 G.3.3 ReadStandardHist
346 G.3.4 SubscribeEvent
347 G.3.5 UnSubscribeEvent
G.3.6 CreateRecipe
348 G.3.7 StopRecipe
349 G.3.8 ReadReport
G.3.9 ReadProceduralIDs
350 G.4 ComplexType definition
G.4.1 Statistics enumeration
G.4.2 PropertyName enumeration
351 G.4.3 Response class
352 G.4.4 EntityLevel enumeration
G.4.5 EntityType enumeration
G.4.6 RecipeType enumeration
354 G.4.7 RecipeParameterType enumeration
358 G.4.8 MonitoringParameterType enumeration
G.4.9 MonitoringParameter
359 G.4.10 RepetitionParameterType enumeration
G.4.11 RepetitionParameter
G.4.12 WeekCalendarParameterType enumeration
G.4.13 WeekCalendarParameter enumeration
G.4.14 ParameterType enumeration
360 G.4.15 OperationParameter enumeration
G.4.16 Operation class
G.4.17 Status enumeration
361 G.5 Implementation methods for authorization
G.5.1 GetToken method
G.5.2 RefreshToken method
362 G.6 WADL
364 G.7 ComplexTypeG
371 Annex H (normative) Event interface with REST
H.1 Overview
H.2 Requirements
H.2.1 General
H.2.2 Data protection
372 H.2.3 Security
H.2.4 Header
H.2.5 Servers requirements
H.2.6 Web Application Description Language (WADL)
H.2.7 Classes and enumerations
H.3 Implementation methods for web services — NewEvent method
373 H.4 ComplexType definition
H.4.1 Response class
374 H.4.2 EventValue class
H.4.3 EventName string
376 H.5 Implementation methods for authorization
H.5.1 GetToken method
H.5.2 RefreshToken method
377 H.6 WADL
378 H.7 ComplexTypeH
379 Bibliography
BS ISO 21622-3:2024
$215.11