Deli e able D4.3
Vi ual Ve i ica ion Labo a o y (VLab)
Wo k Package 4
Disclaime
The con en o his deli e able e lec s only he au ho ’s iew. Nei he he Eu opean Clima e, In as uc-
u e and En i onmen Execu i e Agency (CINEA) no he Eu opean Commission is esponsible o any use
ha may be made o he in o ma ion i con ains.
Funded by he Eu opean Union's Ho izon Eu ope
p og amme unde G an Ag eemen nº 101096453
Deli e able D4.3 Vi ual Ve i ica ion Labo a o y (VLab) 2
G an ag eemen
101096453
Type o ac ion
HORIZON-IA HORIZON Inno a ion Ac ions
Topic
HORIZON-CL5-2022-D3-01-10 In e ope able solu ions o lexibili y
se ices using dis ibu ed ene gy s o age
S a ing da e o p ojec
01.01.2023
P ojec du a ion
36 mon hs
Wo k package
WP4 – PARMENIDES Sys em De elopmen
Rela ed ask
T4.3 P o ision o he i ual e i ica ion en i onmen and in eg a-
ion es ing
Deli e able due da e
M20 (31.08.2024)
Ac ual deli e y da e
M24 (31.12.2024)
Dissemina ion le el
PU – Public
Deli e able esponsible
AIT
Documen In o ma ion
Documen Ve sion: 1.0
Re ision / S a us: Submission
Deli e able D4.3 Vi ual Ve i ica ion Labo a o y (VLab) 3
All Au ho s/Pa ne s
Name
O ganisa ion
Jawad Kazmi
AIT Aus ian Ins i u e o Technology GmbH
Ma k S e an
AIT Aus ian Ins i u e o Technology GmbH
Documen His o y
Re ision
Con en /changes
Resp. pa ne
Da e
0.1
Ini ial e sion
AIT
July 2024
0.2
Desc ip ion o ex ensions
AIT
No embe 2024
0.3
Desc ip ion o ex ensions
AIT
Decembe 2024
1.0
Final e sion
AIT
17.12.2024
Documen App o al
Final app o al
Name
Resp. pa ne
Da e
1.0
Ma k S e an
AIT
18.12.2024
Copy igh No ice
© The PARMENIDES Conso ium, 2023 – 2025
Execu i e Summa y
This documen suppo s he PARMENIDES ac i i ies a ound in eg a ion and in e ope abili y es ing and
con ains a Use Guide o AIT Vi ual Lab (VLab). I will help you unde s and how o use he VLab ame-
wo k o achie e high in e ope abili y in PARMENIDES. The main Deli e able D4.3 is he VLab amewo k
i sel , his documen se es as documen a ion.
Deli e able D4.3 Vi ual Ve i ica ion Labo a o y (VLab) 4
Table o con en s
Abb e ia ions 5
1. In oduc ion 6
2. Ge ing S a ed 8
3. Filling Ou he Inpu Templa e 8
3.1. Da a Modelling Wo kshee (Sync/Async) 8
3.2. Module De ini ion Wo kshee (Sync/Async) 9
3.3. In e ace De ini ion Wo kshee (Sync only) 9
3.4. Ope a ions De ini ion Wo kshee (Sync only) 10
3.5. Pa ame e s Assignmen Wo kshee (Sync only) 10
3.6. Channels De ini ion Wo kshee (Async only) 11
3.7. Ope a ions De ini ion Wo kshee (Async only) 12
4. Using AIT VLab’s En i onmen s 13
4.1. VLab Po able 13
4.2. VLab Cen al 14
5. AIT VLab Valida o 15
6. Using powe p o iles wi h AIT VLab 16
7. T oubleshoo ing and Suppo 17
8. Annex 18
8.1. Lis o Figu es 18
Deli e able D4.3 Vi ual Ve i ica ion Labo a o y (VLab) 5
Abb e ia ions
Ac onym
Desc ip ion
AI- lex
Au onomous AI o cellula ene gy sys ems inc easing lexibili-
ies p o ided by sec o coupling and dis ibu ed s o age
API
Applica ion P og amming In e ace
ECOSINT
Ene gy COmmuni y Sys em INTeg a ion
MQTT
Message Queuing Teleme y T anspo
PECO
PARMENIDES Ene gy Communi y On ology
PU
Public
REST
Rep esen a ional S a e T ans e
SDL
So wa e De elopmen Ki
SENDER
Sus ainable Consume engagemen and demand esponse
SUT
Sys em unde Tes
VLab
Vi ual Ve i ica ion Labo a o y (long) / Vi ual Lab (sho )
VPN
Vi ual P i a e Ne wo k
WP
Wo k Package
Deli e able D4.3 Vi ual Ve i ica ion Labo a o y (VLab) 6
1. In oduc ion
Welcome o he AIT Vi ual Lab (AIT VLab) Use Guide. This guide will help you unde s and how o use he
VLab amewo k o achie e high in e ope abili y in you p ojec s, in pa icula , in he PARMENDIES p ojec .
This documen se es as documen a ion as pa o he AIT Vi ual Lab (AIT VLab) amewo k.
In e ope abili y is a key enable o sma g id po en ial and should be ega ded as an in insic componen
o any sma g id applica ion being de eloped om i s incep ion, see Figu e 1. Because in e ope abili y is
a design conside a ion, hinking abou i ea ly on sa es ene gy and esou ces. Con e sely, when he en-
gaged pa ne s and s akeholde s ha e a be e unde s anding, consensus on, and knowledge o he au o-
ma ion in e aces, dependencies, and expec a ions he communica ion becomes mo e e ec i e and eas-
ie .
Figu e 1: In e ope abili y be ween Sys em A and Sys em B
One o he challenges in achie ing a high in e ope abili y ma u i y le el is ha ing an incompa ible and ad-
hoc wo k low. The AIT VLab add esses his challenge by p o iding a amewo k ha includes a me hodol-
ogy and oolse o achie ing a highe le el (seman ic and abo e) o in e ope abili y. I ad oca es de ining
a common iew o he sys em i s so ha he unc ional objec i es o he solu ion can be aligned wi h
wha needs o be implemen ed. This way i also helps in b idging he knowledge and unde s anding gap
be ween he equi emen and implemen a ion eams.
The amewo k is equally bene icial o sys em a chi ec s, de elope s, and mos o he s akeholde s. The
amewo k is an ecosys em o modules, in e aces, allowed ope a ions, and he da a model along wi h
bo h synch onous (REST APIs and clien SDKs) and asynch onous (publishe /subsc ibe model) a chi ec-
u es wi h accompanying documen a ion packed in a po able en i onmen o p o ide a mockup p o o-
ype o he p oposed sys em o es ing and in eg a ion. In addi ion o gene a ing he mock alues, he
Deli e able D4.3 Vi ual Ve i ica ion Labo a o y (VLab) 7
gene a ed mockups u he can ollow load/gene a ion p o iles o beha e in a mo e de e minis ic and
ealis ic manne . Such capabili ies a e used, o example, in doing scalabili y and eplicabili y analysis.
The AIT VLab amewo k's abili y o p o ide a comp ehensi e ecosys em o es ing, in eg a ion, and scala-
bili y analysis makes i a e sa ile ool ac oss hese segmen s, helping b idge he gap be ween equi e-
men s and implemen a ion.
AIT VLab s ands ou in he sma g id in e ope abili y applica ions due o se e al unique ea u es and ad-
an ages:
● Comp ehensi e F amewo k wi h In eg a ed Me hodology and Toolse : AIT VLab p o ides a com-
ple e ecosys em o modules, in e aces, and da a models, along wi h bo h synch onous (REST APIs
and clien SDKs) and asynch onous (publishe /subsc ibe model) a chi ec u es. This comp ehen-
si e app oach ensu es ha all aspec s o in e ope abili y a e co e ed, om design o implemen-
a ion and es ing.
● Mockup P o o yping: The amewo k includes capabili ies o gene a ing mock- alues and ollow-
ing load/gene a ion p o iles, which allows o mo e de e minis ic and ealis ic es ing scena ios.
This is pa icula ly use ul o scalabili y and eplicabili y analysis, ensu ing ha solu ions a e obus
and eliable be o e deploymen .
● Ease o Use:
○ Po able En i onmen : AIT VLab is packaged in a po able en i onmen , making i easy o
se up and use ac oss di e en sys ems and p ojec s. This educes he ime and e o
equi ed o in eg a ion and es ing.
○ Use -F iendly Inpu Templa e: The VLab Inpu Templa e simpli ies he p ocess o de ining
da a models and speci ying modules and in e aces, making i accessible o a wide ange
o use s, om sys em a chi ec s o de elope s.
● P o en Success: AIT VLab has been success ully used in nume ous esea ch p ojec s, including he
Ho izon 2020 p ojec SENDER
1
, he ac ual Ho izon Eu ope p ojec PARMENIDES, he ERA-Ne p o-
jec AI-Flex
2
, and na ional p ojec s such as ECOSINT
3
, ecei ing e y posi i e eedback. This ack
eco d demons a es i s e ec i eness and eliabili y in eal-wo ld applica ions.
● Alignmen o Func ional Objec i es: By ad oca ing o a common iew o he sys em om he
ou se , AIT VLab helps b idge he knowledge and unde s anding gap be ween equi emen and
implemen a ion eams. This ensu es ha he unc ional objec i es o he solu ion a e aligned wi h
wha needs o be implemen ed, leading o mo e e ec i e and e icien p ojec ou comes.
1
Ho izon 2020 (#957755), Sus ainable Consume engagemen and demand esponse (SENDER),
h ps://www.sende -h2020.eu/
2
ERA-Ne SES, Au onomous AI o cellula ene gy sys ems inc easing lexibili ies p o ided by sec o coupling and
dis ibu ed s o age (AI- lex)
3
FFG Aus ia, Ene gy COmmuni y Sys em INTeg a ion (ECOSINT), h p://www.ecosin .a
Deli e able D4.3 Vi ual Ve i ica ion Labo a o y (VLab) 8
2. Ge ing S a ed
To begin using VLab, you need o:
● Download he VLab Inpu Templa e: This empla e is an Excel ile used o de ine you sys em's
da a models, modules, in e aces, ope a ions, and pa ame e s.
● Ins all Requi ed So wa e: Ensu e you ha e Mic oso Excel and Docke ins alled on you sys em.
3. Filling Ou he Inpu Templa e
The AIT VLab cu en ly suppo s he speci ica ion and gene a ion o bo h he asynch onous and synch o-
nous modules. The inpu empla es o bo h hese ypes ha e some sligh di e ences.
The inpu empla e o speci ying he Synch onous (REST ul) modules consis s o i e wo kshee s while he
empla e o speci ying he Asynch onous (publishe /subsc ibe ) modules consis s o only ou shee s.
Each wo kshee se es a speci ic pu pose in de ining you sys em.
3.1. Da a Modelling Wo kshee (Sync/Async)
Pu pose: De ine he s uc u e and p ope ies o da a models.
S eps:
● En e he Da a Model Name.
● De ine Membe Names and hei p ope ies (e.g., da a ype, de aul alue, min/max alues).
Figu e 2: VLab Inpu Templa e o Da a Models.
Da a Model Name Membe Name Ins ance Name
A ay o
Objec s
Desc ip ion Da a Type Example Values De aul Value Min. Value Max. Value Min. Leng h Max. Leng h Nullable Enum Pa e n
Da aModelID
Uni
PhysicalValue alue No
Value Double 100 0,00 -999999999,00 999999999,00 No
PhysicalValue ype No
Type o Value S ing No
S a icP ope y <PhysicalValue> s a icP ope y No Cus om No
Da apoin <PhysicalValue> da aPoin No Cus om No
Measu emen <Da apoin > measu emen No Cus om No
Se poin <Da apoin > se poin No Cus om
Times amp alue No Long No
Powe Spec <S a icP ope y> maxPowe Capaci y No Maximum powe capaci y Cus om
20 000 0 0 999 999 999 No W
Powe Spec <S a icP ope y> maxPowe Densi yVol No
Maximum olume ic powe densi y Cus om 5000 0 0 999 999 No W/m³
Powe Spec <S a icP ope y> maxPowe Densi yMass No
Maximum speci ic powe densi y Cus om 1000 0 0 999 999 No W/kg
Powe Pa ame e <Measu emen > powe Capaci y No
Powe capaci y Cus om 5 000 0 0 999 999 999 No W
Powe Pa ame e <Measu emen > powe Densi yVol No
Volume ic powe densi y Cus om 5000 0 0 999 999 No W/m³
Powe Pa ame e <Measu emen > powe Densi yMass No
Speci ic powe densi y Cus om 4,5 0 0 999 999 No W/kg
Powe Pa ame e <Measu emen > powe No
Powe as ene gy pe uni ime Cus om 5 000 0 -999 999 999 999 999 999 No W
Ene gySpec <S a icP ope y> maxEne gyCapaci y No
Maximum ene gy capaci y Cus om 5 000 0 0 999 999 999 No kWh
Ene gySpec <S a icP ope y> maxEne gyDensi yVol No
Maximum olume ic ene gy densi y Cus om 1200 0 0 99 999 No kWh/m³
Ene gySpec <S a icP ope y> maxEne gyDensi yMass No
Maximum speci ic ene gy densi y Cus om 0,25 0 0 9 No kWh/kg
Ene gyPa ame e <Measu emen > ene gyCapaci y No
Ene gy capaci y Cus om 5 000 0 0 999 999 999 No kWh
Ene gyPa ame e <Measu emen > ene gyDensi yVol No
Volume ic ene gy densi y Cus om 1200 0 0 99 999 No kWh/m³
Ene gyPa ame e <Measu emen > ene gyDensi yMass No
Speci ic ene gy densi y Cus om 0,25 0 0 9 No kWh/kg
Ene gyPa ame e <Measu emen > ene gy No
Usable ene gy con en Cus om 5 000 0 0 999 999 999 No kWh
Elec icalSpec <S a icP ope y> elec icalSpecsAC No
S a ic elec ical p ope ies/speci ica ions (al e na ing
cu en )
Cus om No
Elec icalSpec <S a icP ope y> elec icalSpecsDC No
S a ic elec ical p ope ies/speci ica ions (di ec
cu en )
Cus om No
Elec icalSpec <Ene gySpec> a edEne gyCapElec No
Ra ed elec ical ene gy capaci y Cus om 5 000 0 0 999 999 999 No kWh
Elec icalSpecAC <Elec icalSpec> a edPowe AC No
Ra ed ope a ing elec ical powe (AC) Cus om 5 000 0 0 999 999 999 No W
Elec icalSpecAC <Elec icalSpec> maxPowe AC No
Maximum elec ical powe (AC) Cus om 5 000 0 0 999 999 999 No W
Elec icalSpecAC <Elec icalSpec> minPowe AC No
Minimum elec ical powe (AC) Cus om 5 000 0 0 999 999 999 No W
Elec icalSpecAC <Elec icalSpec> a edCu en AC No
Ra ed ope a ing cu en (AC) Cus om 10 0 0 999 No A
Elec icalSpecAC <Elec icalSpec> maxCu en AC No
Maximum ope a ing cu en (AC) Cus om 25 0 0 999 No A
Elec icalSpecAC <Elec icalSpec> minCu en AC No
Minimum ope a ing cu en (AC) Cus om 0 0 0 999 No A
Elec icalSpecAC <Elec icalSpec> a edVol ageAC No
Ra ed ope a ing ol age (AC) Cus om 230 0 0 999999 No V
Elec icalSpecAC <Elec icalSpec> maxVol ageAC No
Maximum ope a ing ol age (AC) Cus om 240 0 0 999999 No V
Elec icalSpecAC <Elec icalSpec> minVol ageAC No
Minimum ope a ing ol age (AC) Cus om 100 0 0 999999 No V
Elec icalSpecAC <Elec icalSpec> a edF equency No
Ra ed ope a ing equency Cus om 50, 60 50 50 60 No Hz
Elec icalSpecAC <Elec icalSpec> maxF equency No
Maximum ope a ing equency Cus om 50.5, 60.3 50,5 50 61 No Hz
Elec icalSpecAC <Elec icalSpec> minF equency No
Minimum ope a ing equency Cus om 49.5, 59.7 49,5 49 60 No Hz
Elec icalSpecAC <Elec icalSpec> phaseCon ig No
Elec ical phase con igu a ion Cus om 3-phase, 1-phase No -
Elec icalSpecDC <Elec icalSpec> a edPowe DC No
Ra ed ope a ing elec ical powe (DC) Cus om 5 000 0 0 999 999 999 No W
Elec icalSpecDC <Elec icalSpec> maxPowe DC No
Maximum elec ical powe (DC) Cus om 100 0 0 999 999 999 No W
Elec icalSpecDC <Elec icalSpec> minPowe DC No
Minimum elec ical powe (DC) Cus om 50 0 0 999 999 999 No W
Elec icalSpecDC <Elec icalSpec> a edCu en DC No
Ra ed ope a ing cu en (DC) Cus om 5 0 0 999 No A
Elec icalSpecDC <Elec icalSpec> maxCu en DC No
Maximum ope a ing cu en (DC) Cus om No A
Elec icalSpecDC <Elec icalSpec> minCu en DC No
Minimum ope a ing cu en (DC) Cus om No A
Elec icalSpecDC <Elec icalSpec> a edVol ageDC No
Ra ed ope a ing ol age (DC) Cus om 24 0 0 999999 No V
Elec icalSpecDC <Elec icalSpec> maxVol ageDC No
Maximum ope a ing ol age (DC) Cus om 48 0 0 999999 VNo V
Elec icalSpecDC <Elec icalSpec> minVol ageDC No
Minimum ope a ing ol age (DC) Cus om 12 0 0 999999 VNo V
Da a Model
Deli e able D4.3 Vi ual Ve i ica ion Labo a o y (VLab) 9
3.2. Module De ini ion Wo kshee (Sync/Async)
Pu pose: Desc ibe indi idual modules/componen s.
S eps:
● En e he Name and Desc ip ion o he module.
● P o ide he API P og amma ic Name, Documen a ion Link, Ve sion, De eloping Pa ne , and Re-
sponsible Pe son.
Figu e 3: VLab Inpu Templa e o Modules.
3.3. In e ace De ini ion Wo kshee (Sync only)
Pu pose: De ine in e aces o modules only in he case o REST ul o sync modules.
S eps:
● Selec he Pa en Module.
● En e he In e ace Name and P og amma ic Name.
● P o ide a b ie In e ace Desc ip ion.
Figu e 4: VLab Inpu Templa e o In e aces ( o synch onous a chi ec u es).
Name Desc ip ion API P og ama ic Name Documen a ion Link Ve sion De eloping Pa ne Responsable Pe son
EcoFlow IoT Open Pla o m Pla o m o he moni o ing and con ol o he EcoFlow ba e y eco low h ps://pa menides-p ojec .eu/ 1.0.0 KTH Lo enz Ray Payonga <payonga@k h.se>
Modules
Pa en Module In e ace Name P og ama ic Name In e ace Desc ip ion
EcoFlow IoT Open Pla o m Con igu e con ig The main con i gu a ion in e ace.
EcoFlow IoT Open Pla o m Elec icalPa ame e s elecpa ams Real- ime elec ical pa ame e measu emen s
EcoFlow IoT Open Pla o m S o agePa ame e s s o agepa ams Real- ime s o age pa ame e measu emen s
EcoFlow IoT Open Pla o m Cha gingPa ame e s cha gingpa ams Real- ime cha ging pa ame e measu emen s
EcoFlow IoT Open Pla o m Discha gingPa ame e s discha gingpa ams Real- ime discha ging pa ame e measu emen s
EcoFlow IoT Open Pla o m The malPa ame e s he mpa ams Real- ime he mal pa ame e measu emen s
EcoFlow IoT Open Pla o m Se poin s se poin s In e ace o dynamic se poin s
In e aces
Deli e able D4.3 Vi ual Ve i ica ion Labo a o y (VLab) 16
6. Using powe p o iles wi h AIT VLab
Pu pose: To use a p o ile wi h de e minis ic alues ins ead o using he s anda d VLab mockups wi h an-
dom alues.
S eps:
● Ob ain he p o iles-enabled Module: Ob ain he equi ed con aine image o he module you like
o un.
● Con igu e you module: Make he con igu a ion i he de aul beha iou is no sui able. The ol-
lowing a e he mos impo an en i onmen a iable o know abou :
○ PROFILE_FILE (De aul : “h0”): he sou ce o he p o ile, he e a e 27 di e en ypes o
p o iles embedded in he VLab mockup o he yea 2024, ha can be swi ch by changing
his a iable. Fo mo e in o ma ion check h ps://www.apcs.a /de/clea ing/ echnisches-
clea ing/las p o ile.
○ PROFILE_INTERVAL (De aul : 15 minu es): you can “simula e” how he imes amp
changes o each new alue ead.
○ PROFILE_SF (De aul : 1): The p o ile scaling ac o alue con igu ed wi h his a iable
will be mul iplied o each p o ile alue ead.
○ PROFILE_START_TS (De aul : cu en da a & ime): Using his a iable, he s a
imes amp can be p o ided ha will hen be used wi h each new p o ile alue ead.
○ PROFILE_START_INDEX (De aul : 0): The s a ing index om whe e he p o ile should be
ead.
○ PROFILE_END_INDEX (De aul : p o ile alues coun ): The las alue o be ead. A e he
las alue, he p o ile is oll-o e ed.
Figu e 12: Using powe p o iles ins ead o andom alues in VLab Mockups.
Deli e able D4.3 Vi ual Ve i ica ion Labo a o y (VLab) 17
7. T oubleshoo ing and Suppo
● Common Issues:
○ Templa e E o s: Ensu e all equi ed ields a e illed ou co ec ly.
○ Docke Issues: Ve i y Docke is ins alled and unning p ope ly.
● Suppo : Con ac he esponsible pe son lis ed in he module de ini ion o speci ic module- e-
la ed que ies. Fo gene al suppo , e e o he AIT suppo eam.
Deli e able D4.3 Vi ual Ve i ica ion Labo a o y (VLab) 18
8. Annex
8.1. Lis o Figu es
Figu e 1: In e ope abili y be ween Sys em A and Sys em B ......................................................................... 6
Figu e 2: VLab Inpu Templa e o Da a Models. .......................................................................................... 8
Figu e 3: VLab Inpu Templa e o Modules. ................................................................................................ 9
Figu e 4: VLab Inpu Templa e o In e aces ( o synch onous a chi ec u es). ........................................... 9
Figu e 5: VLab Inpu Templa e o Ope a ions ( o synch onous a chi ec u es). ....................................... 10
Figu e 6: VLab Inpu Templa e o Pa ame e s ( o synch onous a chi ec u es). ...................................... 10
Figu e 7: VLab Inpu Templa e o Channels ( o asynch onous a chi ec u es). ........................................ 11
Figu e 8: VLab Inpu Templa e o Ope a ions ( o asynch onous a chi ec u es). ..................................... 12
Figu e 9: O e iew o VLab Po able (yellow), based on gene a ed Images (blue) using he VLab Gene a o
( iole ). ........................................................................................................................................................ 13
Figu e 10: O e iew o VLab Cen al, hos ed a AIT wi h access o p ojec pa ne s o in eg a ing hei
modules. ...................................................................................................................................................... 14
Figu e 11: O e iew abou he Valida o unc ionali y. .............................................................................. 15
Figu e 12: Using powe p o iles ins ead o andom alues in VLab Mockups. ........................................... 16
