Interoperable Apis Specification
Total Page:16
File Type:pdf, Size:1020Kb
Ref. Ares(2019)2895536 - 30/04/2019 Interoperable APIs Specification Deliverable D3.4 – version 1.0 April 2019 ID & Title : Interoperable APIs Specification Number of Version : V1.0 68 pages : Short Description This document defines interoperable APIs to allow the management of flexibility in a smart grid using formal UML modelling. Revision history Version Date Modifications’ nature Author st V1.0 26/04/2019 1 version submitted to INEA Marco Cupelli Accessibility ☒Public ☐ Consortium + EC ☐ Restricted to a specific ☐ Confidential + EC group + EC Owner/Main responsible Name(s) Function Company Visa Marco Cupelli RWTH - Author(s)/contributor(s): company name(s) Jonas Baude, Marco Cupelli, Amir Ahmadifar, Mirko Ginocchi: RWTH Aachen University Friederich Kupzog, Milica Savic, Jawad Kazmi: AIT Austrian Institute of Technology Olivier Genest, Arnaud Moncade: TRIALOG Reviewer(s): company name(s) Company Enedis, Avacon, CEZ Distribuce, E.ON, Enexis, RWTH Approver(s): company name(s) Company Enedis, Avacon, CEZ Distribuce, E.ON, Enexis, ENGIE, GE Work Package ID GWP3 Task ID 3.1.3 Deliverable D3.4 – Interoperable APIs Specification EXECUTIVE SUMMARY Major DSOs are working together with market players and other stakeholders within the Horizon 2020 –LCE-06-2016 project InterFlex to develop an application programming interface (API) to guarantee interoperability between the DSO and aggregator systems. Standardized interfaces will be developed to integrate the platforms of different players. This deliverable gives a brief overview about the protocols used in the different demo sites and places them in the context of existing IEC standards. Based on the gap identified between existing standards and solutions selected by the different demo sites, we propose a flexibility platform that offers two interoperable APIs that will enable seamless coupling between the IT Systems of Aggregators with the OT systems of the DSO. Within the work package 3 subtask 3.1.3, interoperable APIs specification, interoperable APIs are specified using unified modelling language formal modelling (D3.4). Furthermore, an open source reference implementation of the APIs is provided (D3.5) and finally, an abstract test suite to validate proper implementation (D3.6) is proposed. In particular, semantic of the data will be consistent with what has been detailed in the present document, while the data syntax will depend on the solution selected during the implementation phase. The content of this deliverable is intended to be standalone. For further deeper information, we refer the interested reader to the preceding deliverables D3.1 [1] and D3.3 [2]. InterFlex – GA N°731289 Page 3 Deliverable D3.4 – Interoperable APIs Specification TABLE OF CONTENT 1 INTRODUCTION .................................................................................. 10 1.1 Scope .......................................................................................... 11 1.2 Objectives .................................................................................... 11 1.3 Motivation ..................................................................................... 11 1.4 Deliverable Organization ................................................................... 13 2 STATE OF THE ART .............................................................................. 14 2.1 OneM2M ....................................................................................... 14 2.2 Open Charge Point Protocol ................................................................ 15 2.2.1 OCPP Versions ......................................................................... 15 2.2.2 IEC 63110 – Management of Electric Vehicle (Dis-)Charging Infrastructures . 16 2.3 SunSpec ....................................................................................... 18 2.4 Energy Flexibility Interface ................................................................ 19 2.5 Universal Smart Energy Framework ....................................................... 21 2.6 IEC Core Standards for “Smart Grids” .................................................... 22 2.6.1 IEC 62357 Seamless Integration Architecture ..................................... 22 2.6.2 IEC 61968/61970 CIM ................................................................. 23 2.6.3 IEC 61850 – Communication networks and systems for power utility ......... 24 2.6.4 Harmonization of Standards - CIM and IEC 61850 ................................ 26 2.7 OpenADR ...................................................................................... 26 2.8 Smart Appliance Reference Ontology ..................................................... 27 2.9 Summary and Additional Complementary Information ................................. 29 3 INTERFLEX RECOMMONDATIONS ............................................................... 30 4 API SPECIFICATION .............................................................................. 33 4.1 InterFlex API Functionality ................................................................. 34 4.2 Formal UML Representation ................................................................ 35 4.3 API Stakeholder Connections ............................................................... 35 4.3.1 Aggregator Connection ............................................................... 35 4.3.2 DSO Connection ....................................................................... 36 4.3.3 Internal and External Services ...................................................... 36 4.4 API Functionality Specification ............................................................ 37 4.4.1 Common InterFlex API components ................................................ 37 4.4.2 Entity Authentication ................................................................ 37 4.4.3 Flexibility Offer ....................................................................... 39 4.4.4 Flexibility Request .................................................................... 40 4.4.5 Flexibility Activation Request ....................................................... 41 4.4.6 Flexibility Activation Acknowledgment ............................................ 43 InterFlex – GA N°731289 Page 4 Deliverable D3.4 – Interoperable APIs Specification 4.4.7 Flexibility Activation Unacknowledgment ......................................... 43 4.5 Summary ...................................................................................... 44 5 API INTERACTIONS ............................................................................... 45 5.1 How to read sequence charts .............................................................. 45 5.2 Request-based flexibility negotiation between DSO and aggregator ................. 45 5.3 Offer-based flexibility negotiation between DSO and aggregator .................... 46 5.4 Summary ...................................................................................... 48 6 CONCLUSIONS .................................................................................... 49 7 BIBLIOGRAPHY ................................................................................... 50 A. APPENDIX – ADDITIONAL API FUNCTIONALITIES ................................................. 52 Appendix 1. InterFlex demo SGAMs – Communication layers .................................. 52 German demo ........................................................................................ 52 Swedish demo ........................................................................................ 53 Czech demo .......................................................................................... 58 Dutch demo........................................................................................... 65 French demo ......................................................................................... 66 InterFlex – GA N°731289 Page 5 Deliverable D3.4 – Interoperable APIs Specification LIST OF FIGURES Figure 1-1 The map identifies the demo sites in the context of this project .................................. 10 Figure 1-2 Integration and Standardization ......................................................................... 11 Figure 1-3 InterFlex API ................................................................................................ 12 Figure 2-1: OneM2M common services functions ................................................................... 14 Figure 2-2: Back-end interoperability across EV charging infrastructure using OCPP and RFID [11] ........ 16 Figure 2-3: overview of protocols and market roles in the area of e-mobility [13] ........................... 17 Figure 2-4 SunSpec architecture [15] ................................................................................ 18 Figure 2-5 Energy Flexibility Platform & Interface Architecture Overview [21] ............................... 20 Figure 2-6: USEF interaction model .................................................................................. 21 Figure 2-7 Extended mapping of Seamless Integration Architecture ............................................ 23 Figure 2-8 Structure of IEC 61850 - logical model .................................................................. 25 Figure 2-9 OpenADR service-oriented architecture [40] ........................................................... 26 Figure 2-10: Reducing the number of data mappings with SAREF ................................................ 28 Figure 2-11: Main classes of SAREF ontology .......................................................................