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 |
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 |