ASTRIN Specificatie WG-KAR 2011.06.01
Verkeerslogging in de Verkeersregelautomaat Aanvullende specificatie
Specificatienummer
Versie
WG-KAR 2011.06.01
1.1
Template (2010.12.06 AK)
1.1
ASTRIN Specificatie WG-KAR 2011.06.01
Versie 1.1
Wijzigingsoverzicht ...........................................................................
Versie
Status
Datum
Gereviseerd door
Reden
0.7
Concept
2011.06.01
Nieuw document
0.8 1.0 1.1
Concept Definitief Definitief
2011.06.07 2011.11.01 2014.06.27
Hans Looijen, Martin de Vries Martin de Vries Martin de Vries Martin de Vries
Versie 1.0 01-11-2011
N.a.v. bespreking in WG-KAR Nieuwe versie VLOG 2.1.0
ASTRIN Specificatie WG-KAR 2011.06.01
Versie 1.1
Inhoudsopgave ...............................................................................
1. 1.1 1.2 1.3 1.4 1.5 1.6 1.7 1.8 1.9
Toepassingsgebied Document identificatie Beveiliging en intellectueel eigendom Voorwoord bij deze uitgave Inleiding Leden van de Werkgroep Scoop Geldigheid Referenties Definities en afkortingen
5 5 5 5 6 6 6 6 6 7
2. 2.1 2.2 2.3 2.4
Technische Specificatie Verzamelen van verkeerskundige data Hardware Software Globale werking
8 8 8 8 8
3. 3.1 3.2
Applicatieprogramma en VLOG Applicatieprogramma (basis) Applicatieprogramma (kruispunt specifiek)
10 10 10
4. 4.1 4.2 4.3
CVN-C interface Uitgangspunten Extra filebuffer in CVN-C interface Dataoverdracht via file buffer
11 11 11 15
5. 5.1 5.2 5.3
FILE AFHANDELING Filewisselmoment Files ophalen Files opschonen
18 18 19 19
6.
ANDERE BRONNEN
20
Versie 1.0 01-11-2011
ASTRIN Specificatie WG-KAR 2011.06.01
Versie 1.1
Overzicht wijzigingen (details) Versie
Datum
0.7 0.8
2011-06-01 2011-06-07
div.
0.8 1.0
2011-06-07 2011-10-19
5.1, punt 2. Ruimere specificatie div. Definitief maken document
1.1
2014-06-27
1.8
Pagina 4 van 20
Hoofdstuk Paragraaf
Oorzaak
Wijziging / actuele veranderingen
Initieel document N.a.v. bespreking in WG-KAR
N.v.t. Diverse niet-essentiële/technische wijzigingen en lay-out. 100 kByte veranderd in 256 kByte Tekstueel, invoeren versienummers referenties Tekstueel, wijzigen verwijzing versie VLOG
Nieuwe versie VLOG 2.1.0
ASTRIN Specificatie WG-KAR 2011.06.01
1. Toepassingsgebied ...............................................................................
1.1 Document identificatie
ASTRIN documentnummer: WG-KAR 2011.06.01 Specificatienaam:
Verkeerslogging in de Verkeersregelautomaat (Aanvullende specificatie)
1.2 Beveiliging en intellectueel eigendom
© ASTRIN 2011. Alle rechten voorbehouden. Niets uit deze uitgave mag worden verveelvoudigd en/of openbaar gemaakt door middel van druk, fotokopie, microfilm of op welke andere wijze dan ook, zonder voorafgaande schriftelijke toestemming van het ASTRIN-secretariaat. De ASTRIN-leden behouden zich het recht voor om delen van dit document op elk gewenst moment te wijzigen, zonder voorafgaande of directe kennisgeving aan de gebruiker. De inhoud van dit document kan eveneens worden gewijzigd zonder voorafgaande waarschuwing. Dit document is informatief van aard. Aan de inhoud hiervan kunnen geen rechten worden ontleend.
1.3 Voorwoord bij deze uitgave
Dit is de eerste uitgave van dit document. ASTRIN heeft deze specificatie opgesteld in samenwerking met haar leden die verantwoordelijk zijn voor de levering van verkeersregelautomaten in Nederland. Deze specificatie is ontstaan uit de wens om KAR-gegevens (beter) te loggen op de Verkeersregelautomaat (VRA). Belangrijkste aanleiding was de behoefte om in de VRA gegevens te loggen die het mogelijk maken om de prestaties te meten van het KAR-mechanisme. Hiermee krijgen wegbeheerders en leveranciers van de VRA de mogelijkheid om beter de oorzaken te onderzoeken van een mogelijk verminderde prestatie van KAR en/of fouten te zoeken die te maken hebben met het berichtenverkeer tussen voertuig en VRA. Uiteindelijk resultaat is dat deze specificatie de verkeerslogging in algemene zin regelt op de VRA, waarvan de KAR-logging een onderdeel vormt. In de aanloop naar een mogelijke oplossing is gekozen voor logging op basis van VLOG. Om dit mogelijk te maken is tevens een voorstel uitgewerkt om de CVN-C interface specificatie aan te passen voor de extra KAR-berichten. Dit document is van toepassing op alle VRA’s met CVN-C Interface specificatie versie 4.0 of hoger. De ASTRIN-leden zullen zich bij productontwikkeling en bij de levering van verkeersregelinstallaties in Nederland houden aan de uitgangspunten van deze publicatie.
Zoetermeer, oktober 2011 Het ASTRIN-bestuur
Pagina 5 van 20
Versie 1.1
ASTRIN Specificatie WG-KAR 2011.06.01
Versie 1.1
1.4 Inleiding
Dit document beschrijft de VLOG file logging in de VRA (Verkeers Regel Automaat. Het betreft voornamelijk de interfaces, formaten en protocollen die hiervoor gestandaardiseerd moeten worden om tot een universele oplossing te komen. Het document wordt vrijgegeven door de ASTRIN Stuurgroep Standaardisatie en is daarmee definitief een overeengekomen standaard. In bestekken kan worden gerefereerd naar dit document. Het document is opgesteld door de ASTRIN-KAR werkgroep met als doel een eenduidige logging ten behoeve van KAR-data te verkrijgen.
1.5 Leden van de Werkgroep
De Werkgroep KAR, onder wiens verantwoordelijkheid dit document ten behoeve van ASTRIN is opgesteld bestond uit: Henri Bolk Jeroen Douma Ton van Grinsven Marcel Fick Edwin Henning Michel Huisman Hans Looijen Matthieu Mosch Ron de Snoo Martin de Vries, voorzitter
– – – – – – – – – –
Peek Traffic Vialis Lid CVN-C Commissie, Gemeente Delft Movensis Ko Hartog Vialis Siemens Ko Hartog Siemens Peek Traffic
1.6 Scoop
Deze publicatie heeft alleen betrekking op nieuw te leveren verkeersregeltoestellen voor wegverkeertoepassingen. In overleg met de leverancier kan deze specificatie eventueel geïmplementeerd worden in bestaande installaties, mits deze zijn en/of worden voorzien van de nodige aanpassingen. De mogelijkheden zijn afhankelijk van de bestaande installatie.
1.7 Geldigheid
Deze specificatie is alleen geldig in combinatie met de referenties in paragraaf 1.8. Van toepassing zijn: V-Log versie 2.1.0 of hoger, CVN-C versie 4.0 of hoger en CCOL versie 8.0 of hoger en RWS-C versie 1.1
1.8 Referenties Ref.
Documentnaam
Versie
Auteur
Datum
1 2 3 4
V-log protocol en definities CVN-C interface CCOL RWS-C
2.1.0 4.0 8.0 1.1
Vialis BV CVN-C Commissie T. van Grinsven Goudappel Coffeng BV
30-01-2013 12-10-2011 november 2013 April 2014
Pagina 6 van 20
ASTRIN Specificatie WG-KAR 2011.06.01 1.9 Definities en afkortingen
FTP ................................................................ File Transfer Protocol Client .............................................................. Apparaat welke een dienst afneemt van de server. Is ook degene die het initiatief neemt. In dit geval bijvoorbeeld de centrale Server ............................................................ Apparaat dat een dienst aanbiedt. In dit geval de VRA CVN ............................................................... Contactgroep Verkeersregeltechnici Nederland VRA ............................................................... Verkeersregelautomaat Applicatieprogramma ..................................... Software t.b.v. verkeersafhandeling Applicatieprogramma (basis) ......................... Deel van applicatieprogramma met de basisfuncties Applicatieprogramma (kruispunt specifiek) ... Deel van applicatieprogramma met de functies t.b.v. een specifiek kruispunt. Procesbesturing ............................................. Software t.b.v. aansturing VRA VLOG ............................................................. Verkeerskundig data logging protocol
Pagina 7 van 20
Versie 1.1
ASTRIN Specificatie WG-KAR 2011.06.01
2. Technische Specificatie ...............................................................................
2.1 Verzamelen van verkeerskundige data
Verzamelen van data wordt al enige tijd toegepast binnen VRA’s. Er zijn hiervoor verschillende methoden beschikbaar. Vanuit de markt is er de vraag naar data om openbaar vervoer afhandeling beter te kunnen monitoren. De huidige methoden zijn hiervoor niet toereikend. Daarom wordt de VRA uitgebreid met een logging-mechanisme waarin dit mogelijk wordt gemaakt. Er is gekozen voor VLOG. Met deze keuze wordt niet alleen de logging van openbaar vervoer data geregeld, maar is meteen logging voor alle verkeerskundige data geregeld.
2.2 Hardware
Er moet in de VRA een opslagmedium zijn om de data op te slaan.
2.3 Software
De relevante software is onder te verdelen in verschillende onderdelen:
Applicatieprogramma (basis) Applicatieprogramma (kruispunt specifiek) Applicatieprogramma, als alleen ‘Applicatieprogramma’ wordt genoemd zijn dat bovenstaande delen samen CVN-C interface Procesbesturing. VLOG-protocol FTP-protocol (Centrale) analyse tool
2.4 Globale werking
Het Applicatieprogramma (basis) maakt VLOG events en zet deze op de CVN-interface. Het Applicatieprogramma (kruispunt specifiek) maakt een aantal specifieke VLOG events en zet deze via het Applicatieprogramma (basis) ook op de CVN interface. De Procesbesturing leest deze events van de CVN-interface en maakt daar files van. Een analyse tool kan de files met VLOG events met behulp van FTP ophalen en vervolgens analyseren. Zie Figuur 1.
Pagina 8 van 20
Versie 1.1
ASTRIN Specificatie WG-KAR 2011.06.01
Versie 1.1
TCP/IP Poort 7001
Regel Applicatie
CVN interface parameters…..
Procesbesturing
CIF_MON
FTP
IVERA
CIF_FILE
Data opslag File 1 File 2 … File X Topoinfo mvfiles Figuur 1 Globale werking - context diagram
Pagina 9 van 20
Diverse centrales / tools
ASTRIN Specificatie WG-KAR 2011.06.01
3. Applicatieprogramma en VLOG ...............................................................................
Het Applicatieprogramma bestaat uit twee delen. Ten eerste Applicatieprogramma (basis) ook wel toolkit of basisstructuur genoemd. Dit deel kan CCOL of RWS-C zijn en is generiek voor elke automaat. Ten tweede is er het Applicatieprogramma (kruispunt specifiek). Hierin wordt de afhandeling voor het betreffende kruispunt vastgelegd.
3.1 Applicatieprogramma (basis)
Hierin worden de basisfuncties geregeld. In dit geval het maken van de basis VLOGevents zoals header, tijdreferentieberichten, detectie, overige ingangen, signaalgroepen, OV-berichten e.d.
3.2 Applicatieprogramma (kruispunt specifiek)
Het Applicatieprogramma (kruispunt specifiek) bepaalt de afhandeling van het kruispunt. In dit geval zullen ook een aantal specifieke VLOG events door het Applicatieprogramma (kruispunt specifiek) gemaakt moeten worden. Dit zijn events die niet generiek bepaald kunnen worden. In onderstaande tabel staan de events die specifiek door het Applicatieprogramma (kruispunt specifiek) moeten worden aangemaakt. Hiervoor is het V-LOG berichttype 34 gedefinieerd. Zie voor een volledige beschrijving de V-log definitie. In onderstaande tabel staat een samenvatting van deze informatie.
Bit
Beschrijving
0 1 2 3 4 5 6 7 8 9 10-15
Start voorinmelding Openbaar Vervoerdienst Start inmelding Openbaar Vervoerdienst Start uitmelding Openbaar Vervoerdienst Start uitmeldbewaking Openbaar Vervoerdienst Foutieve uitmelding Openbaar Vervoerdienst Uitgestelde uitmelding Openbaar Vervoerdienst Start voorinmelding Hulpdienst Start inmelding Hulpdienst Start uitmelding Hulpdienst Start uitmeldbewaking Hulpdienst Reserve bits
Pagina 10 van 20
Versie 1.1
ASTRIN Specificatie WG-KAR 2011.06.01
4. CVN-C interface ...............................................................................
Informatie-uitwisseling tussen het Applicatieprogramma en de Procesbesturing gaat via de CVN-C interface. Ook de VLOG events zullen via de CVN-C interface gaan. Momenteel in CVN-C interface V3.2 wordt hiervoor het zogenaamde CIF_MON buffer gebruikt. Er zijn echter beperkingen aan dit buffer zodat in CVN versie 4.0 een extra buffer wordt opgenomen.
4.1 Uitgangspunten
De opgeslagen VLOG-events zijn voor analyse achteraf en worden altijd op de interface aangeboden. Er worden geen events gefilterd. Om het mogelijk te maken een file op een logisch moment af te breken en aan een nieuwe file te beginnen wordt hiervoor ook informatie uitgewisseld. Omdat het huidige CIF_MON buffer een stream data is zonder informatie over een beginof eindpunt en omdat deze data d.m.v. filters kunnen worden beïnvloed, wordt er een nieuwe buffer in de CVN-C interface opgenomen. Dit buffer is dan specifiek bedoeld voor dataopslag. De CIF_MON buffer kan gebruikt blijven worden voor real time data, te gebruiken voor onder andere DVM toepassingen.
4.2 Extra filebuffer in CVN-C interface
Het buffer bestaat uit een vaste geheugenlocatie met een vaste grootte. In dit buffer wordt de data geschreven door het Applicatieprogramma en gelezen door de Procesbesturing. De opbouw is gelijk aan de CIF_MON buffer met een aantal extra pointers. De extra buffer in de CVN-C interface ziet er als volgt uit:
extern s_int8 CIF_FILE_UBER []; /* CIF_FILE_UBER[]-buffer */ extern const s_int16 CIF_PB_MAX_FILE_UBER; /* grootte CIF_MON_UBER buffer */ extern s_int8 *CIF_FILE_UBER_LEES; /* pointer naar te lezen bericht */ extern s_int8 *CIF_FILE_UBER_SCHRIJF; /* pointer naar te schrijven bericht */ extern s_int16 CIF_FILE_UBER_STATUS; /*status van fileopslag */ extern s_int8 *CIF_FILE_UBER_FILEWISSEL; /* pointer naar mogelijk file wisselpunt */ extern s_int16 CIF_PB_FILE_UBER_FILEWISSEL; /* gewenst filewisselpunt door PB*/ extern s_int8 CIF_FILE_UBER_FILEEXT[]; /* file extensie */
Beschrijving van deze pointers: CIF_FILE_UBER ........................................... Een pointer naar de eerste byte van het buffer. Krijgt initieel een waarde door Applicatieprogramma (basis). CIF_PB_MAX_FILE_UBER ........................... Een constante met het aantal bytes gereserveerd voor het buffer. Standaard wordt hiervoor een waarde van 16384 voor genomen. Krijgt initieel een waarde door het Applicatieprogramma (basis).
Pagina 11 van 20
Versie 1.1
ASTRIN Specificatie WG-KAR 2011.06.01
Pagina 12 van 20
Versie 1.1
ASTRIN Specificatie WG-KAR 2011.06.01 CIF_FILE_UBER_LEES ................................ Een pointer naar het eerstvolgende byte dat gelezen kan worden door de Procesbesturing. Krijgt initieel een waarde door het Applicatieprogramma (basis), wordt vervolgens alleen door de Procesbesturing aangepast. CIF_FILE_UBER_SCHRIJF .......................... Een pointer naar het eerstvolgende byte dat geschreven kan worden door het Applicatieprogramma (basis). Krijgt initieel een waarde door het Applicatieprogramma (basis), wordt vervolgens alleen door het Applicatieprogramma (basis) aangepast. CIF_FILE_UBER_FILEWISSEL .................... Een pointer naar het punt waar het Applicatieprogramma (basis) aangeeft dat dit een goed beginpunt is van een nieuwe file. Dat zal over het algemeen de eerste byte van een header zijn. Indien deze pointer NULL is, is er geen punt in het buffer waar een filewissel kan plaatsvinden. Krijgt initieel een waarde door het Applicatieprogramma (basis), wordt vervolgens door het Applicatieprogramma (basis) aangepast. Wordt door Procesbesturing op NULL gezet na het lezen van de betreffende positie in het buffer. CIF_PB_FILE_UBER_FILEWISSEL ............. In deze variabele kan de Procesbesturing aangeven aan het Applicatieprogramma (basis) dat een filewissel gewenst is. Krijgt initieel een waarde 0 (FALSE) door het Applicatieprogramma (basis), wordt vervolgens alleen door de Procesbesturing TRUE gemaakt om een filewisselpunt te vragen. het Applicatieprogramma (basis) zal deze weer FALSE maken direct nadat CIF_FILE_UBER_FILEWISSEL een waarde heeft gekregen. CIF_FILE_UBER_STATUS ........................... In deze variabele kan het Applicatieprogramma aangeven of filelogging nog gewenst is. 1 betekent dat opslag gewenst is, 0 betekent dat geen opslag meer gewenst is. Het is wel de bedoeling dat als het Applicatieprogramma deze waarde verandert van 1 naar 0 de data in het buffer nog wel in de file geschreven wordt. CIF_FILE_UBER_FILEEXT........................... Deze pointer wijst naar een string constante met daarin de gewenste file extensie. De applicatie zorgt voor een goede verwijzing door deze pointer voordat data in het buffer wordt geschreven. Deze string bevat minimaal 1 karakter maximaal 3 karakters en wordt afgesloten door de waarde 0x00. Krijgt initieel een waarde door het Applicatieprogramma (basis).
Pagina 13 van 20
Versie 1.1
ASTRIN Specificatie WG-KAR 2011.06.01
Pagina 14 van 20
Versie 1.1
ASTRIN Specificatie WG-KAR 2011.06.01
Versie 1.1
Het buffer kan voor verschillende dataformaten worden gebruikt. In dit geval gaan we uit van VLOG-data. Voorlopig zal dat altijd het geval zijn. De opzet maakt het mogelijk ook voor andere toepassingen te kiezen.
4.3 Dataoverdracht via file buffer
Het Applicatieprogramma (basis) maakt het buffer en initialiseert de pointers. CIF_FILE_UBER_LEES = CIF_FILE_UBER CIF_FILE_UBER_SCHRIJF = CIF_FILE_UBER CIF_FILE_UBER_FILEWISSEL = NULL CIF_PB_FILE_UBER_FILEWISSEL=FALSE CIF_PB_MAX_FILE_UBER =16384 CIF_FILE_UBER_FILEEXT = NULL CIF_FILE_UBER_STATUS = Gewenste waarde Bij de initialisatie van het Applicatieprogramma (basis) zal eerst CIF_FILE_UBER_FILEEXT een juiste waarde worden gegeven. (Zolang de pointer NULL is zal de extensie LGF zijn).
*CIF_FILE_UBER_ FILEWISSEL
Het buffer met pointers zien er als volgt uit. De pointers vanuit het Applicatieprogramma (basis) staan boven en de pointers van de Procesbesturing staan afgebeeld in Figuur 2.
CIF_PB_FILE_UBER_ FILEWISSEL
N U L L
FALSE CIF_FILE_UBER [CIF_PB_MAX_FILE_UBER]
*CIF_FILE_UBER_LEES
CIF_FILE_UBER[0]
CIF_FILE_UBER
Figuur 2 Pointers van de Procesbesturing
Vervolgens kunnen events in het buffer geschreven worden. Het schrijven van een event gaat als volgt: De data wordt vanaf CIF_FILE_UBER_SCHRIJF geschreven tot maximaal één positie voor CIF_FILE_UBER_LEES. Vervolgens wordt CIF_FILE_UBER_SCHRIJF met het aantal geschreven bytes opgehoogd. Het ophogen van CIF_FILE_UBER_SCHRIJF mag in delen gebeuren, bijvoorbeeld na iedere geschreven byte.
Pagina 15 van 20
ASTRIN Specificatie WG-KAR 2011.06.01 Als op een punt in de data een filewissel CIF_FILE_UBER_FILEWISSEL daar naar gaan verwijzen.
Versie 1.1 mogelijk
is,
moet
*CIF_FILE_UBER_ FILEWISSEL
Nadat het Applicatieprogramma (basis) een aantal events heeft geschreven, ziet het buffer er als volgt uit:
Tijd ref. ber. Status ber. Wijz ber.
N U L L
CIF_PB_FILE_UBER_ FILEWISSEL
FALSE CIF_FILE_UBER [CIF_PB_MAX_FILE_UBER]
*CIF_FILE_UBER_LEES
CIF_FILE_UBER[0]
CIF_FILE_UBER
Figuur 3 CIF_FILE_UBER buffer na het schrijven van een aantal events
Vervolgens kan de Procesbesturing de data lezen en de CIF_FILE_UBER_LEES aanpassen. Als CIF_FILE_UBER_LEES CIF_FILE_UBER_FILEWISSEL passeert moet de waarde van CIF_FILE_UBER_FILEWISSEL NULL worden. Als de Procesbesturing op het punt komt dat hij een filewissel wil uitvoeren kan de Procesbesturing de pointer CIF_FILE_UBER_FILE_WISSEL controleren. Als CIF_FILE_UBER_LEES gelijk wordt aan CIF_FILE_UBER_FILE_WISSEL kan een nieuwe file begonnen worden. De byte gelezen uit CIF_FILE_UBER_LEES wordt het eerste karakter in de nieuwe file. De Procesbesturing kan aangeven met CIF_PB_FILE_UBER_FILEWISSEL dat een filewissel gewenst is. Wanneer CIF_PB_FILE_UBER_FILEWISSEL wordt gezet dan moet Applicatieprogramma (basis) als volgend bericht een tijdreferentie, een statusbericht sturen i.p.v. een wijzigingsbericht en CIF_FILE_UBER_FILEWISSEL naar het begin van het tijdreferentiebericht laten wijzen. Echter VLOG zal elke 5 minuten een nieuwe start maken. In veel situaties zal het dan niet nodig zijn vanuit de Procesbesturing Applicatieprogramma (basis) te vragen een filewissel mogelijk te maken. Het is vanuit de gebruiker gezien beter de filewissels, indien mogelijk, op een 5 minuten raster te leggen. Het zal in ieder geval zo zijn dat de data per applicatieronde in dezelfde file blijft. Het gevolg hiervan is dat de grootte van de files nooit exact te bepalen is.
Hieronder het buffer nadat de Procesbesturing een wens heeft voor een filewissel.
Pagina 16 van 20
N U L L
*CIF_FILE_UBER_ SCHRIJF
*CIF_FILE_UBER_ FILEWISSEL
ASTRIN Specificatie WG-KAR 2011.06.01
Versie 1.1
Tijd ref. ber. Status ber. Wijz ber.
CIF_PB_FILE_UBER FILEWISSEL
TRUE CIF_FILE_UBER [CIF_PB_MAX_FILE_UBER]
*CIF_FILE_UBER_LEES
CIF_FILE_UBER[0]
CIF_FILE_UBER
Figuur 4 Het CIF_FILE_UBER buffer met de wens voor een filewissel
In de voorbeelden is uitgegaan van de beginfase. Na verloop van tijd is het buffer vol en zal weer vanaf het begin verder worden geschreven (circulair buffer). Belangrijk is dat het Applicatieprogramma (basis) niet verder schrijft dan de positie voor de leespointer. De Procesbesturing kan uiteraard niet verder lezen dan de schrijfpointer. De Procesbesturing maakt de variabele CIF_PB_FILE_UBER_FILEWISSEL weer FALSE na een filewissel. Het Applicatieprogramma (basis) kan aan de waarde van pointer CIF_FILE_UBER_FILEWISSEL zien of deze nog geldig is. Als de pointer nog geldig is, moet deze pointer zijn waarde behouden. Deze pointer is niet meer geldig als de Procesbesturing deze NULL heeft gemaakt.
Pagina 17 van 20
ASTRIN Specificatie WG-KAR 2011.06.01
Versie 1.1
5. FILE AFHANDELING ...............................................................................
In Figuur 5 staat schematisch hoe de data in de files geschreven wordt. De regelapplicatie schrijft de te loggen data in het CIF_FILE_UBER [] buffer. De Procesbesturing zorgt er voor dat deze data in files weggeschreven wordt. De naamgeving staat beschreven in de VLOG-specificatie.
Tijd ref. ber. Status ber. Wijz ber.
File 1 FTP
Data
File 2 FTP
flow
CIF_FILE_UBER [CIF_PB_MAX_FILE_UBER]
Regelapplicatie/CCOL/RWS-C <----------------------------------Procesbesturing
*CIF_FILE_UBER_LEES
CIF_FILE_UBER[0]
Regelapplicatie/CCOL/RWS-C ---------------------------------à Procesbesturing
*CIF_FILE_UBER_ SCHRIJF
*CIF_FILE_UBER_ FILEWISSEL
Er zijn een aantal getallen zoals filegrootte en aantal files van belang. Deze getallen worden bepaald door de Procesbesturing en zijn niet door de gebruiker aanpasbaar. Hierdoor is de beschikbaarheid van deze data maximaal gewaarborgd.
File X
Procesbesturing (server) <---------------------------Centrale (client)
FTP
Figuur 5 Schematisch het schrijven van de data in de files
5.1 Filewisselmoment
Op een gegeven moment moet de file gesloten worden en een volgende file worden aangemaakt. In de volgende onafhankelijke situaties wordt aan een (volgende) file begonnen: 1. Opstarten automaat/herstarten van Procesbesturing; 2. Huidige file is maximale grootte (default 256 kByte, afhankelijk van Procesbesturing). Uitgaande van gemiddeld 2 MB/dag komt overeen met 7 kB/5 min. De file-tijd zal dan gemiddeld 1 uur zijn; 3. Huidige file is maximale tijdsduur (default 4 uur, afhankelijk van Procesbesturing); 4. De datastroom heeft een bufferoverschrijving (datastroom kon niet verwerkt worden); 5. Andere technische reden automaat afhankelijk, bijvoorbeeld het wisselen van programma. Bij het wisselen van een file wordt gewacht tot een punt in de data waarvan de regelapplicatie aangeeft dat een wissel mogelijk is. Dit is van toepassing voor 2, 3 en 4. Bij 5 wordt gewacht met de nieuwe file aanmaken. Er wordt pas een nieuwe file
Pagina 18 van 20
ASTRIN Specificatie WG-KAR 2011.06.01 aangemaakt op het moment dat er werkelijk data is. Dit om te voorkomen dat er files ontstaan zonder inhoud. De Procesbesturing mag er ook voor kiezen lege files achteraf te verwijderen. (De huidige file is immers niet als zodanig zichtbaar.) De regelapplicatie geeft dit punt aan met een pointer. Ervan uitgaande dat een cyclus 5 minuten duurt, kan een file 5 minuten langer worden.
5.2 Files ophalen
De files kunnen met FTP worden opgehaald. Dit kan gedaan worden door verschillende partijen. Het is daarom niet de bedoeling dat de files met FTP verwijderd worden. Echter dit hoeft niet door de VRA voorkomen te worden.
5.3 Files opschonen
Uiteindelijk moeten de files weer van de automaat verwijderd worden om vollopen te voorkomen. Dit is een taak van de Procesbesturing. De oudste file wordt verwijderd als: 1. Beschikbare ruimte kleiner is dan 2 maal maximale grootte (default 2 x 256 kByte, Procesbesturing past default grootte automatisch aan als files groter worden als gevolg van hoge data flow); 2. Het aantal files groter wordt dan het maximum (default 200, afhankelijk van de Procesbesturing); 3. Files kunnen eventueel worden verwijderd d.m.v. FTP. Dit is echter optioneel. De genoemde beschikbare ruimte is minimaal 16 MB.
Pagina 19 van 20
Versie 1.1
ASTRIN Specificatie WG-KAR 2011.06.01
6. ANDERE BRONNEN ...............................................................................
Een aantal zaken wordt niet in dit document beschreven. Hiervoor wordt verwezen naar andere documentatie. Het gaat om:
Inhoud VLOG data en de naamgeving van deze files, wordt beschreven in ref. 1, “V-log protocol en definities”; Specificatie CVN-interface, in ref. 2, “CVN-C interface”.
ASTRIN
Boerhaavelaan 40 Postbus 190 2700 AD Zoetermeer : +31 (0) 79 353 12 44 :
[email protected] : www.astrin.nl
Pagina 20 van 20
Versie 1.1