BESCHRIJVING VAN DE SOFTWARE-INTERFACE TUSSEN HET DOSEERALGORITME EN DE PROCESBESTURING VOOR TOERITDOSEERTOESTELLEN.

Transcriptie

1 BESCHRIJVING VAN DE SOFTWARE-INTERFACE TUSSEN HET DOSEERALGORITME EN DE PROCESBESTURING VOOR TOERITDOSEERTOESTELLEN. RIJKSWATERSTAAT Adviesdienst Verkeer en Vervoer Afdeling IBW Boompjes 200 Postbus BA Rotterdam datum: 30 oktober 2002 tel status: definitief

2 INHOUDSOPGAVE 1. Inleiding Bereik Wijzigingen t.o.v. versie Afkortingen Principe Functioneel Implementatie Interface opbouw Doseeralgoritme Algemeen Besturing doseeralgoritme Returnwaarde functie doseeralgoritme() Procesbesturing Algemeen Activeren doseeralgoritme Reactietijd procesbesturing Tijdsafhankelijke acties Schrijven en lezen doseerinterface Doseerinterface Algemeen Buffers Namen en typen Initialisatie Parameters (PARM) Databuffer Controlebuffers Algemene wijzigingsvlaggen Initialisatie Ingangssignalen (IS) Databuffer Controlebuffer Algemene wijzigingsvlag Initialisatie Variabelen (VAR) Databuffer Geen controlebuffer Algemene wijzigingsvlag Initialisatie Uitgangssignalen (DS) Databuffer Controlebuffer Algemene wijzigingsvlag Initialisatie Configuratie constanten ms teller Versienummer Testfaciliteit doseerinterface

3 6.1 Algemeen Doseeralgoritme Rol procesbesturing in communicatie met testapparaat Berichtbuffers Invoerberichten Uitvoerberichten Initialisatie Literatuur en programmatuur Implementatie dos_int.h dos_def.h dos_typ.h

4 1. INLEIDING. 1.1 Bereik. Dit document beschrijft doseerinterface versie 4, de software-interface tussen het doseeralgoritme en de procesbesturing van doseertoestellen. De doseerinterface alsmede het doseeralgoritme zijn geschreven in de programmeertaal C en zijn tezamen beschikbaar als broncode onder de naam RWS C-doseeralgoritme [C_D]. Het doseeralgoritme is beschreven in de standaard verkeerstechnische specificatie voor een toeritdoseerinstallatie [DOS]. De elementen van de doseerinterface zijn beschreven in het document LIJST MET PARAMETERS, VARIABELEN e.d. [LIJST_PV]. Het doseeralgoritme is algemeen toepasbaar in doseertoestellen, d.w.z. het programma RWS C- doseeralgoritme is geldig voor alle TDI s en is configuratie onafhankelijk. 1.2 Wijzigingen t.o.v. versie 3. T.o.v. versie 3 van de doseerinterface zijn de volgende zaken van belang: Het principe van de interface is niet gewijzigd, wel is in dit document een beschrijving van dit principe toegevoegd in hoofdstuk 2. Hierdoor is de nummering van de andere hoofdstukken met één verhoogd. In hoofdstuk 3, doseerinterface, zijn een aantal nieuwe returnwaarden van het doseeralgoritme opgenomen. Zij hebben betrekking op de melden van foutieve situaties. Hoofdstuk 5,welke de doseerinterface beschrijft, heeft een ander indeling. In plaats van een hoofdindeling naar datastructuren van de doseerinterface, databuffers, controlebuffers enz. is een verdeling naar functionaliteit gehanteerd, i.e. parameters, ingangssignalen, variabelen, uitgangssignalen enz. Toegevoegd is hoofdstuk 6 welke testfaciliteiten t.b.v. de doseerinterface en de procesbesturing beschrijft. De literatuur verwijzing heeft een hoofdstuknummer gekregen, hoofdstuk 7. Sterk gewijzigd is hoofdstuk 8, implementatie. Het aantal files van de doseerinterface is verminderd, en ook de namen zijn anders. De inhoud van de files beschrijven de nieuwe situatie volgens [DOS] en [LIJST_PV]. 4

5 1.3 Afkortingen. CIF C-regelaar interface, software-interface tussen de RWS C-regelaar en de procesbesturing van doseertoestellen CTMS Centraal Toeritdoseer Management Systeem. DIF dos_interface dos_interface doseerinterface, software-interface tussen het doseeralgoritme en de procesbesturing van doseertoestellen. DS uitgangssignaal. IS ingangssignaal. PARM parameter. TDI toeritdoseerinstallatie VAR variabele 5

6 2. PRINCIPE. 2.1 Functioneel Het doseeralgoritme bepaalt aan de hand van door de procesbesturing geleverde informatie het al of niet doseren, de feitelijke doseertijd e.d. Het algoritme stelt deze uitkomsten weer beschikbaar aan de procesbesturing. De procesbesturing draagt deze gegeven over aan de RWS C-regelaar. De RWS C- regelaar bepaalt of er daadwerkelijk geregeld wordt en de gewenste uitsturing van de signaalgroepen. De procesbesturing zorgt er vervolgens voor dat de gewenste uitsturing gerealiseerd wordt. Daarnaast zorgt de procesbesturing ervoor dat informatie beschikbaar is voor het management systeem CTMS. Het uitwisselen van de betreffende informatie tussen procesbesturing en doseeralgoritme vindt plaats d.m.v. de doseerinterface. De doseerinterface is een verzameling geheugenplaatsen welke door zowel procesbesturing als doseeralgoritme gelezen en/of geschreven kan worden. CTMS Detectoren proces besturing 1 Signaal groepen DIF doseer interface C-regelaar interface CIF doseer algoritme 2 RWS C-regelaar 3 Figuur 1: Systeem opzet 6

7 2.2 Implementatie. Het doseeralgoritme is geïmplementeerd als een functie welke door de procesbesturing wordt aangeroepen. De doseerinterface is geïmplementeerd als een gemeenschappelijk datagebied waardoor de benodigde informatie uitgewisseld kan worden. proces besturing aanroep input parameter doseer algoritme return waarde. gelezen data te schrijven data gelezen data te schrijven data gemeenschappelijk data gebied Figuur 2: Activering en data-uitwisseling Naast de informatie uitwisseling d.m.v. het gemeenschappelijk datagebied wordt er bij de functieaanroep een inputparameter meegegeven en wordt een returnwaarde teruggegeven Interface opbouw De doseerinterface is opgebouwd uit verschillende soorten informatie t.b.v. het doseeralgoritme = Parameters t.b.v. instellingen voor het doseeralgoritme. = Variabelen t.b.v. resultaten van berekeningen en metingen. = Ingangssignalen t.b.v. de invoer van actuele meetgegevens. = Uitgangssignalen t.b.v. het resultaat van het doseeralgoritme. = Configuratie constanten t.b.v. de definitie van de fysieke configuratie van de toerit. = 100mS teller t.b.v. tijdsafhankelijke berekeningen door het doseeralgoritme. = Versienummer t.b.v. de versie van de doseerinterface. proces besturing. parameters ingangs signalen teller variabelen uitgangs signalen constanten versie nummer doseer interface parameter buffer. ingangs signalen buffer. 100mS teller taak variabelen buffer. uitgangs signalen buffer. constanten. versie nummer. status parameters ingangs signalen teller variabelen uitgangs signalen constanten doseer algoritme. Figuur 3: Elementen doseerinterface 7

8 3. DOSEERALGORITME. 3.1 Algemeen. Het doseeralgoritme biedt, aan de hand van de door de procesbesturing op de doseerinterface aangeboden informatie, variabelen, uitgangssignalen en parameters aan op de doseerinterface ter afhandeling door de procesbesturing. 3.2 Besturing doseeralgoritme. Het doseeralgoritme wordt bestuurd vanuit een hoofdfunctie doseeralgoritme(). Declaratie: int16 doseeralgoritme(int16 taak) Parameter functie doseeralgoritme(). Naast de normale aanroep t.b.v. het uitvoeren van het algoritme is een speciale aanroep nodig t.b.v. initialisatie. Bij het aanroepen van het algoritme wordt daarom m.b.v. de input parameter taak meegegeven of het om een normale of een initialisatie-aanroep gaat. Waarde Symbool Betekenis 0 DIF_K_GEEN_INIT normale aanroep 1 DIF_K_INIT initialisatie na programma start Returnwaarde functie doseeralgoritme(). De functie geeft een waarde terug m.b.t. het resultaat van de aanroep. Hiermee wordt aangegeven of en welke fouten geconstateerd zijn door de het doseeralgoritme. Waarde Symbool Betekenis 0 DIF_K_GEEN_FOUT geen fout opgetreden -1 DIF_K_INIT_FOUT initialisatie fout doseeralgoritme Wordt teruggeven in de volgende gevallen: = De constanten van de doseerinterface bevatten een ongeldige waarde. Dit wordt gecontroleerd in de initialisatie-aanroep. = De eerste aanroep na programmastart is geen initialisatie-aanroep. 1 DIF_K_DOS_FOUT1 doseerinterface bevat parameter met ongeldige waarde. 2 DIF_K_DOS_FOUT2 doseerinterface bevat ingangssignaal met ongeldige waarde. 4 DIF_K_DOS_FOUT3 ongeldige input parameter in functie aanroep 8 DIF_K_DOS_FOUT4 ongeldige waarde wijzigingsvlag Bij aanroep van de doseerinterface wordt verwacht dat de procesbesturing alle voorgaande wijzigingen, aangebracht door het doseeralgoritme, verwerkt heeft en de bijbehorende wijzigingsvlaggen gereset heeft. N.B. De fouten DIF_K_DOS_FOUT1, DIF_K_DOS_FOUT2 en DIF_K_DOS_FOUT4 kunnen gelijktijdig optreden. In die gevallen bestaat de returnwaarde uit een combinatie van de betreffende foutwaarden, voor het bepalen van deze combinatie wordt een binaire OR functie gebruikt. 8

9 4. PROCESBESTURING. 4.1 Algemeen. De procesbesturing biedt op de doseerinterface de door het doseeralgoritme gewenste ingangssignalen en parameterwijzigingen aan. De procesbesturing handelt de door het algoritme op de doseerinterface aangeboden variabelen, uitgangssignalen en parameters af. 4.2 Activeren doseeralgoritme. De procesbesturing dient de functie doseeralgoritme() aan te roepen teneinde het doseeralgoritme uit te voeren. De procesbesturing maakt daarbij onderscheidt tussen een normale aanroep en een aanroep t.b.v. het initialiseren van de doseerinterface Reactietijd procesbesturing. De procesbesturing dient de functie doseeralgoritme() tenminste iedere 0.1 sec aan te roepen Tijdsafhankelijke acties T.b.v. het bijhouden van tijdsafhankelijke acties in het doseeralgoritme dient de procesbesturing een teller elke 0.1 sec te verhogen. Deze teller is ook onderdeel van de doseerinterface Schrijven en lezen doseerinterface Gewijzigde ingangssignalen en parameters dienen voorafgaande aan iedere aanroep van de functie doseeralgoritme() te worden aangeboden op de doseerinterface. Tijdens uitvoering van de functie doseeralgoritme() mag door de procesbesturing niet in de doseerinterface worden geschreven of gelezen. Op de doseerinterface aangeboden en gewijzigde variabelen, uitgangssignalen en parameters dienen direct volgende op iedere aanroep van functie doseeralgoritme() te worden afgehandeld. 9

10 5. DOSEERINTERFACE. 5.1 Algemeen. De informatie-uitwisseling tussen het doseeralgoritme en de procesbesturing vindt uitsluitend plaats via de doseerinterface, ook wel dos_interface genoemd. Deze interface is opgebouwd uit buffers, enkelvoudige data-elementen en constanten die zowel voor het doseeralgoritme als de procesbesturing bereikbaar zijn Buffers Parameters, variabelen, ingangs- en uitgangssignalen zijn georganiseerd in buffers, arrays met data en controle informatie. De databuffers bevatten de actuele waarden. De controlebuffers bestaan uit wijzigingsvlaggen en zijn bedoeld om aan te geven dat een data-element van een nieuwe waarde voorzien is. Naast de controlebuffers, die wijzigingen per element aangeven, zijn er ook algemene wijzigingsvlaggen welke aangeven dat er überhaupt in een buffer geschreven is. Er zijn verschillende wijzigingvlaggen om onderscheid te kunnen maken in de onderdelen die verantwoordelijk zijn voor het schrijven in de betreffende databuffer,...dos voor doseerinterface en...pb voor procesbesturing n waarden wijzigingsvlaggen...dos wijzigingsvlaggen...pb buffers algemene vlag Figuur 4: Schema Buffers N.B. Niet in alle gevallen zijn er wijzigingsvlaggen voor doseerinterface EN procesbesturing aanwezig. Voor de realisatie van het hierboven beschreven principe wordt verwezen naar de paragrafen met de gedetailleerde beschrijving van parameters, ingangssignalen, variabelen en uitgangssignalen. Voor de databuffers geldt dat het aanbieden van nieuwe data slechts is toegestaan als de desbetreffende vlag in het bijbehorende controlebuffer aangeeft dat eerder aangeboden data gelezen en verwerkt is Namen en typen. Alle buffers, variabelen, indices, constanten (m.u.v. de configuratie-variabelen) en conditiesymbolen hebben een naam die begint met het voorvoegsel DIF_..., gevolgd door het naamstructuur type: = DIF_A_... Doseerinterface Array variabele = DIF_V_... Doseerinterface enkelvoudige Variabele = DIF_I_... Doseerinterface array Index 10

11 = = = DIF_K_... Doseerinterface Konstante DIF_C_... Doseerinterface Conditie DIF_M_... Doseerinterface bit Masker In dit document worden de volgende typen variabelen gebruikt: = int16 16 bits signed integer = int32 32 bits signed integer De wijze waarop de types int16 en int32 bepaald worden is afhankelijk van de gebruikte compiler. Zij zijn op de meest voorkomende manier gedefinieerd in het bestand dos_typ.h Initialisatie. Initialisatie van de doseerinterface geschiedt bij programmastart, in nauwe samenwerking tussen de procesbesturing en het doseeralgoritme. Wat betreft de initiële inhoud van de doseerinterface wordt verwezen naar de afzonderlijke onderdelen. Vanuit de procesbesturing gezien vinden de volgende stappen plaats: 1. Programmastart. 2. Initialisatie van de doseerinterface, voor zover in de hierna volgende paragrafen is beschreven. 3. Initialisatie-aanroep van doseeralgoritme. 4. Invullen gewijzigde parameters en actuele ingangssignalen in de doseerinterface 5. Eerste normale aanroep doseeralgoritme. 6. Verwerken uitgangssignalen uit doseerinterface. De stappen 4, 5 en 6 worden vervolgens periodiek herhaald t.b.v. de normale uitvoering van de doseeralgoritme. 5.2 Parameters (PARM) Databuffer Parameters worden door het doseeralgoritme en de procesbesturing in de databuffer int32 DIF_A_PARM[] van de interface geschreven. De symbolische namen, betekenis en de eigenschappen van de elementen van dit buffer liggen vast in het document LIJST MET PARAMETERS, VARIABELEN e.d. [LIJST_PV]. Het betreft de elementen waarvan de naamgeving t.b.v. de doseerinterface begint met DIF_I_PARM.... De indices van de elementen zijn met hun symbolische naam gedefinieerd in het bestand dos_int.h. De grootte van de buffers staat vermeld in de constante int16 DIF_V_PB_AANT_PARM Controlebuffers Parameters kunnen zowel door de procesbesturing als het doseeralgoritme geschreven worden. Om die reden zijn er twee controlebuffers met wijzigingsvlaggen, int16 DIF_A_PARMWIJZPB[] voor wijzigingen door de procesbesturing en int16 DIF_A_PARMWIJZDOS[] voor wijzigingen door het doseeralgoritme. Bij wijziging in de databuffer DIF_A_PARM[] door de procesbesturing dient de bijbehorende wijzigingsvlag in de betreffende controlebuffer, DIF_A_PARMWIJZPB[], op de waarde 11

12 DIF_K_GESCHREVEN gezet te worden. Bij de verwerking door het doseeralgoritme wordt de vlag op de waarde DIF_K_GELEZEN gezet. Bij wijziging in de databuffer DIF_A_PARM[] door het doseeralgoritme wordt de bijbehorende wijzigingsvlag in de betreffende controlebuffer, DIF_A_PARMWIJZDOS[], op de waarde DIF_K_GESCHREVEN gezet. Bij het verwerken door de procesbesturing dient de vlag op de waarde DIF_K_GELEZEN gezet te worden. Waarde Symbool Betekenis 1 DIF_K_GESCHREVEN in buffer geschreven 0 DIF_K_GELEZEN buffer gelezen Algemene wijzigingsvlaggen Naast de wijzigingsvlaggen in de controlebuffer dient ook de algemene wijzigingsvlag gezet te worden, int16 DIF_V_PARMWIJZPB bij wijzigingen door de procesbesturing en int16 DIF_V_PARMWIJZDOS bij wijzigingen door het doseeralgoritme. Het is van belang om te weten of de parameters van initiële waarden voorzien zijn door het doseeralgoritme. Om die reden krijgen de algemene wijzigingsvlaggen niet de waarden DIF_K_GESCHREVEN of DIF_K_GELEZEN, maar de volgende speciale waarden: Waarde Symbool Betekenis -1 DIF_K_GEEN_PARMWIJZ geen wijzigingen in parameterbuffer -2 DIF_K_MEER_PARMWIJZ één of meer wijzigingen in buffer. -3 DIF_K_INIT_PARM initiële waarden in parameterbuffer Bij initialisatie door het doseeralgoritme wordt de algemene wijzigingsvlag DIF_V_PARMWIJZDOS op de waarde DIF_K_INIT_PARM gezet. Bij het verwerken door de procesbesturing dient de vlag op de waarde DIF_K_GEEN_PARMWIJZ gezet te worden. In de andere gevallen dat het doseeralgoritme parameters wijzigt wordt de algemene wijzigingsvlag DIF_V_PARMWIJZDOS op de waarde DIF_K_MEER_PARMWIJZ gezet. Bij het verwerken door de procesbesturing dient de vlag op de waarde DIF_K_GEEN_PARMWIJZ gezet te worden. Bij wijziging door de procesbesturing dient de algemene wijzigingsvlag DIF_V_PARMWIJZPB op de waarde DIF_K_MEER_PARMWIJZ gezet te worden. Bij het verwerken door het doseeralgoritme wordt de vlag op de waarde DIF_K_GEEN_PARMWIJZ gezet Initialisatie Door de procesbesturing dient na programmastart, voorafgaande aan de initialisatie-aanroep van het doseeralgoritme, zie 5.1.3, de volgende initialisatie uitgevoerd te worden: 1. Alle wijzigingsvlaggen in de controlebuffer DIF_A_PARMWIJZPB[] dienen de waarde DIF_K_GELEZEN te krijgen. 2. De algemene wijzigingsvlag DIF_V_PARMWIJZPB dient de waarde DIF_K_GEEN_PARMWIJZ te krijgen. 12

13 Door het doseeralgoritme wordt tijdens de initialisatie-aanroep de volgende initialisatie uitgevoerd: 1. Alle parameters worden op hun default waarde gezet in DIF_A_PARM[]. De default waarden liggen vast in het document LIJST MET PARAMETERS, VARIABELEN e.d. [LIJST_PV]. 2. De bij de parameters behorende wijzigingsvlaggen in controlebuffer DIF_A_PARMWIJZDOS[] krijgen de waarde DIF_K_GESCHREVEN. 3. De algemene wijzigingsvlag DIF_V_PARMWIJZDOS krijgt de waarde DIF_K_INIT_PARM. De parameters zijn nu voorzien van hun initiële waarde, zij kunnen echter een andere waarde gekregen hebben die afwijkt van de initiële waarde. Het bewaren van afwijkende parameterwaarden is een functie van de procesbesturing. Daarom moet door de procesbesturing, direct na boven vermelde initialisatie, de volgende aanvullende initialisatie uitgevoerd worden: 1. Alle door de procesbesturing bewaarde (afwijkende) parameters dienen opnieuw te worden geschreven in DIF_A_PARM[]. 2. De bijbehorende wijzigingsvlaggen in de controlebuffer DIF_A_PARMWIJZPB[] krijgen de waarde DIF_K_GESCHREVEN. 3. De algemene wijzigingsvlag DIF_V_PARMWIJZPB krijgt de waarde DIF_K_MEER_PARMWIJZ Bij de eerstvolgende normale aanroep van het doseeralgoritme zullen nu de juiste parameter waarden gebruikt worden. 5.3 Ingangssignalen (IS) Databuffer Ingangssignalen worden door de procesbesturing in de databuffer int32 DIF_A_IS[] van de interface geschreven. De symbolische namen, betekenis en de eigenschappen van de elementen van dit buffer liggen vast in het document LIJST MET PARAMETERS, VARIABELEN e.d. [LIJST_PV]. Het betreft de elementen waarvan de naamgeving t.b.v. de doseerinterface begint met DIF_I_IS.... De indices van de elementen zijn met hun symbolische naam gedefinieerd in het bestand dos_int.h. De grootte van de buffers staat vermeld in de constante int16 DIF_V_PB_AANT_IS. In aanvulling op het document [LIJST_PV] gelden voor de volgende ingangssignalen speciale waarden. De gebruikte symbolen en waarden zijn gedefinieerd in de file dos_int.h. De elementen DIF_A_IS[DIF_I_IS_det_RWso_i] en DIF_A_IS[DIF_I_IS_det_RWsa_i] dienen te worden gevuld met het volgende bitmasker: Waarde Symbool Betekenis 0 <geen> geen storing 2 DIF_M_DET_STORING detectie storing 13

14 De elementen DIF_A_IS[DIF_I_IS_SG1i_1], DIF_A_IS[DIF_I_IS_SG1i_2] en DIF_A_IS[DIF_I_IS_SG1i_7], dienen te worden gevuld met het volgende bitmasker: Waarde Symbool Betekenis 0 <geen> geen storing 1 DIF_M_DET_BEZET detectie bezet 2 DIF_M_DET_STORING detectie storing 4 DIF_M_DET_BOVENGEDRAG detectie bovengedrag 8 DIF_M_DET_ONDERGEDRAG detectie ondergedrag De elementen DIF_A_IS[DIF_I_IS_wus_SG1i] dienen te worden gevuld met het volgende bitmasker. Waarde Symbool Betekenis 0 DIF_K_ROOD rood 1 DIF_K_GROEN groen / wit / witknipperen 2 DIF_K_GEEL geel / groenknipperen 3 DIF_K_KNIPWIT witknipperen 4 DIF_K_GEDOOFD lantaarn(s) gedoofd Het element DIF_A_IS[DIF_I_IS_DOSR_STATUS] dient te worden gevuld met het volgende bitmasker: Waarde Symbool Betekenis 0 DIF_K_STAT_ONGEDEF ongedefinieerd 1 DIF_K_STAT_GEDOOFD gedoofd 2 DIF_K_STAT_KP knipperen 3 DIF_K_STAT_GEEL geel bij inschakelen 4 DIF_K_STAT_AR alles rood 5 DIF_K_STAT_DOS doseren (=regelen) Het element DIF_A_IS[DIF_I_IS_I_delta_IV_C] kan een waarde hebben van 0 t/m Deze waarde representeert een aanbod in vtg/uur. De elementen DIF_A_IS[DIF_I_IS_V_RWso_i] en DIF_A_IS[DIF_I_IS_V_RWsa_i] kunnen een waarde hebben van 0 t/m 200. Deze waarde representeert een snelheid in km/uur. De elementen DIF_A_IS[DIF_I_IS_pardon_SG1i] kunnen een waarde hebben van 0 t/m Deze waarde representeert een tijd in tiende seconden. Het element DIF_A_IS[DIF_I_IS_L_FOUT_UIT] dient te worden gevuld met het volgende bitmasker: Waarde Symbool Betekenis 0 DIF_K_UIT uit 1 DIF_K_AAN aan 14

15 5.3.2 Controlebuffer Ingangssignalen worden alleen door de procesbesturing geschreven. Om die reden is er één controlebuffer met wijzigingsvlaggen, int16 DIF_A_ISWIJZPB[]. Bij wijziging in de databuffer DIF_A_IS[] door de procesbesturing dient de bijbehorende wijzigingsvlag in de controlebuffer DIF_A_ISWIJZPB[] op de waarde DIF_K_GESCHREVEN gezet te worden. Bij het verwerken van de wijziging door het doseeralgoritme wordt de vlag op de waarde DIF_K_GELEZEN gezet. Waarde Symbool Betekenis 1 DIF_K_GESCHREVEN in buffer geschreven 0 DIF_K_GELEZEN buffer gelezen Algemene wijzigingsvlag Naast de wijzigingsvlaggen in de controlebuffer dient ook de algemene wijzigingsvlag gezet te worden, int16 DIF_V_ISWIJZPB. Hiervoor worden ook de waarden DIF_K_GESCHREVEN en DIF_K_GELEZEN gebruikt Initialisatie Door de procesbesturing dient na programmastart, voorafgaande aan de initialisatie-aanroep van het doseeralgoritme, zie 5.1.3, de volgende initialisatie uitgevoerd te worden. 1. Alle ingangssignalen in DIF_A_IS[] krijgen de waarde 0 2. Alle wijzigingsvlaggen in de controlebuffer DIF_A_ISWIJZPB[] krijgen de waarde DIF_K_GELEZEN. 3. De algemene wijzigingsvlag DIF_V_ISWIJZPB krijgt de waarde DIF_K_GELEZEN 5.4 Variabelen (VAR) Databuffer Variabelen worden door het doseeralgoritme in de int32 DIF_A_VAR[] buffer van de interface geschreven. Dit vindt voor alle variabelen plaats na afloop van een meetperiode en tijdens de meetperiode alleen voor een nieuw berekende doseertijd, DIF_I_VAR_DOS_TIJD_BER. De symbolische namen, betekenis en de eigenschappen van de elementen van dit buffer liggen vast in het document LIJST MET PARAMETERS, VARIABELEN e.d. [LIJST_PV]. Het betreft de elementen waarvan de naamgeving, t.b.v. de doseerinterface, begint met DIF_I_VAR.... De indices van de elementen zijn met hun symbolische naam gedefinieerd in het bestand dos_int.h. De grootte van de buffers staat vermeld in de constante int16 DIF_V_PB_AANT_VAR Geen controlebuffer Omdat wijzigingen in de variabelen zich tot twee situaties beperken, alle variabelen na afloop van de meetperiode en anders alleen de doseertijd, is er geen controlebuffer met wijzigingsvlaggen per variabele. In plaats daarvan wordt de beschikbaarheid van nieuwe informatie d.m.v. uitgangssignalen medegedeeld aan de procesbesturing, zie Algemene wijzigingsvlag 15

16 De algemene wijzigingsvlag int16 DIF_V_VARWIJZDOS dient wel gezet te worden door het doseeralgoritme. Hiervoor worden de waarden DIF_K_GESCHREVEN en DIF_K_GELEZEN gebruikt. Waarde Symbool Betekenis 1 DIF_K_GESCHREVEN in buffer geschreven 0 DIF_K_GELEZEN buffer gelezen Initialisatie. Door het doseeralgoritme worden tijdens de initialisatie-aanroep de volgende initialisatie uitgevoerd: 1. Alle variabelen worden op niet bekend/berekend (= -1) gezet in DIF_A_VAR[]. 2. Een aantal variabelen wordt voorzien van een default waarde. 3. De algemene wijzigingsvlag DIF_V_VARWIJZDOS krijgt de waarde DIF_K_GESCHREVEN. Een aantal variabelen wordt in het begin van de eerste meetperiode voorzien van een waarde. De overige variabelen worden pas voorzien van een waarde nadat de eerste meetperiode verstreken is. 5.5 Uitgangssignalen (DS) Databuffer Uitgangssignalen worden door het doseeralgoritme de in de int32 DIF_A_DS[] buffer van de interface geschreven. De symbolische namen, betekenis en de eigenschappen van de elementen van dit buffer liggen vast in het document LIJST MET PARAMETERS, VARIABELEN e.d. [LIJST_PV]. Het betreft de elementen waarvan de naamgeving, t.b.v. de doseerinterface, begint met DIF_I_DS.... De indices van de elementen zijn met hun symbolische naam gedefinieerd in het bestand dos_int.h. De grootte van de buffers staat vermeld in de constante int16 DIF_V_PB_AANT_DS. In aanvulling op het document [LIJST_PV] gelden voor de volgende uitgangssignalen speciale waarden. Deze gebruikte symbolen en waarden zijn gedefinieerd in de file dos_int.h. De betekenis van DIF_A_DS[DIF_I_DS_berek_per_meetper] is: Waarde Symbool Betekenis 0 DIF_K_AFWEZIG geen nieuwe variabelen beschikbaar 1 DIF_K_AANWEZIG nieuwe variabelen beschikbaar De betekenis van DIF_A_DS[DIF_I_DS_berek_dos_tijd] is: Waarde Symbool Betekenis 0 DIF_K_AFWEZIG geen nieuwe DOS_TIJD_BER beschikbaar 1 DIF_K_AANWEZIG nieuwe DOS_TIJD_BER beschikbaar 16

17 5.5.2 Controlebuffer Uitgangssignalen worden alleen door het doseeralgoritme geschreven. Om die reden is er één controlebuffer met wijzigingsvlaggen, int16 DIF_A_DSWIJZDOS[]. Bij wijziging in de databuffer DIF_A_DS[] dient de bijbehorende wijzigingsvlag door het doseeralgoritme op de waarde DIF_K_GESCHREVEN gezet te worden. Bij het verwerken van de wijziging dient de vlag door de procesbesturing op de waarde DIF_K_GELEZEN gezet te worden. Waarde Symbool Betekenis 1 DIF_K_GESCHREVEN in buffer geschreven 0 DIF_K_GELEZEN buffer gelezen Algemene wijzigingsvlag Naast de wijzigingsvlaggen in de controlebuffer dient ook de algemene wijzigingsvlag gezet te worden, int16 DIF_V_DSWIJZDOS. Hiervoor worden ook de waarden DIF_K_GESCHREVEN en DIF_K_GELEZEN gebruikt Initialisatie. Door het doseeralgoritme wordt tijdens de initialisatie-aanroep de volgende initialisatie uitgevoerd te worden: 1. Alle uitgangssignalen in DIF_A_DS[] krijgen de waarde Alle wijzigingsvlaggen in de controlebuffer DIF_A_DSWIJZDOS[] krijgen de waarde DIF_K_GESCHREVEN. 3. De algemene wijzigingsvlag DIF_V_DSWIJZDOS krijgt de waarde DIF_K_GESCHREVEN. 5.6 Configuratie constanten De configuratieconstanten beschrijven de locale situatie van de toeritdosering en liggen vast in de volgende variabelen: = = = = = = = = = = int16 aantal_stroken_trsa int16 aantal_stroken_trss int16 aantal_stroken_trso int16 aantal_stroken_trfile int16 aantal_stroken_rwso int16 aantal_stroken_rwsa int16 aantal_lt_hoog int16 aantal_lt_laag int16 busstrook int16 id_doseertoestel De symbolische namen, betekenis en de eigenschappen van deze constanten liggen vast in het document LIJST MET PARAMETERS, VARIABELEN e.d. [LIJST_PV]. De hierboven gegeven namen komen overeen met de in deze lijst gehanteerde naamgeving t.b.v. de doseerinterface. De configuratie constanten worden niet gewijzigd door procesbesturing of doseeralgoritme, hun waarde wordt bepaald door de definities in bestand dos_def.h. 17

18 Het bestand dos_def.h dient door de fabrikant ingevuld te worden op basis van de door de opdrachtgever verstrekte configuratie van de betreffende toerit ms teller T.b.v. tijdsafhankelijke functies van het doseeralgoritme dient de procesbesturing een teller bij te houden waarin de tienden van seconden, 100 ms, geteld worden, int32 DIF_V_TSEC_KLOK. Voor elke aanroep van het doseeralgoritme dient de procesbesturing deze variabele, indien nodig, bij te werken. Na het bereiken van de maximale waarde van deze variabele, int32_max, dient weer vanaf nul te worden geteld. 5.8 Versienummer Het versienummer ligt vast in de volgende variabele int16 DIF_V_VERSIE_NR. Deze variabele kan door de procesbesturing worden gelezen en eventueel gebruikt worden om de afstemming van procesbesturing en doseerinterface te controleren. 18

19 6. TESTFACILITEIT DOSEERINTERFACE 6.1 Algemeen Ten behoeve van het functioneel testen van de doseerinterface in samenwerking met de procesbesturing worden faciliteiten aangebracht in doseeralgoritme, doseerinterface en procesbesturing. M.b.v. deze faciliteiten is het mogelijk om wijzigingen in de doseerinterface, aangebracht door de procesbesturing, ter controle te presenteren op een testapparaat. Omgekeerd kunnen vanuit dat testapparaat wijzigingen in de doseerinterface aangebracht worden, waarna de reactie van de procesbesturing hierop geobserveerd kan worden. Acties en reacties kunnen namelijk ook via andere kanalen ( lokale terminal, instelapparaat, detectoren, enz.) worden ingegeven respectievelijk worden waargenomen. T.b.v. de testfaciliteit dient een data-uitwisseling tot stand gebracht te worden tussen een testvoorziening in het doseeralgoritme en het op het doseertoestel aan te sluiten testapparaat. De testvoorziening in het algoritme interpreteert commando s van het testapparaat en verstuurt hierop een antwoord. Ontvangen en versturen gaat door middel van een uitbreiding van de doseerinterface in samenwerking met de procesbesturing. De commando s hebben betrekking op het lezen en/of schrijven van elementen van de doseerinterface. doseer interface testapparaat TDI test data via RS232 verbinding Detector simulatoren proces besturing Signaal groepen doseer interface test data 1 Instel apparaat invoer en uitvoer buffers uitbreiding PARM, VAR, IS, DS, enz. C-regelaar interface lokale terminal CTMS test data doseer algoritme interface test voorziening 4 doseeralgoritme doseer algoritme berekeningen 2 RWS C-regelaar 3 Figuur 5: Testfaciliteiten 19

20 6.2 Doseeralgoritme Het doseeralgoritme is op te splitsen in twee delen, de standaard afhandeling van het doseeralgoritme en de testvoorziening om de doseerinterface te kunnen lezen en schrijven. Slechts één van de twee is op een gegeven moment actief. 6.3 Rol procesbesturing in communicatie met testapparaat. Om informatie over te dragen tussen testapparaat en testvoorziening in het doseeralgoritme speelt de procesbesturing een rol. Het doseerinterface testapparaat wordt d.m.v. een RS232 verbinding op het doseertoestel aangesloten. De karakteristieken van deze verbinding zijn: 9600 baud, 8 bits en geen pariteit. De procesbesturing dient karakters te lezen van dit seriele kanaal. De gelezen karakters dienen doorgegeven te worden aan het doseeralgoritme. Omgekeerd dienen karakters aangeboden door het doseeralgoritme verstuurd te worden over dit seriele kanaal. Doorgeven van karakters vindt plaats via een uitbreiding van de doseerinterface: de bericht buffers. 6.4 Berichtbuffers T.b.v. invoer en uitvoer van berichten wordt de doseerinterface uitgebreid met twee buffer mechanismen, één voor invoer en één voor uitvoer De buffermechanismen worden uitgevoerd als ringbuffers, hierdoor is het mogelijk om meerdere karakters van een bericht tegelijkertijd door te geven. Een ringbuffer maakt gebruik van de volgende elementen: invoerindex uitvoerindex aantal karakters data buffer Figuur 6: Elementen ringbuffer T.b.v. het plaatsen van data in een ringbuffer geldt het volgende mechanisme: Indien het aantal aanwezige karakters in de buffer kleiner is dan de lengte van de databuffer dan: = Plaats het nieuwe karakter in de buffer op de locatie van de invoerindex. = Verhoog de invoerindex = Indien deze nu voorbij het einde van de buffer wijst wordt de index op het begin van de buffer gezet. = Verhoog het aantal karakters. Anders: = Is er geen plaats in de buffer. T.b.v. het lezen van data uit een ringbuffer geldt het volgende mechanisme: Indien het aantal karakters in de buffer groter is dan 0 dan: = Lees het karakter uit de buffer op de locatie van de uitvoerindex. 20

21 = Verhoog de uitvoerindex = Indien deze nu voorbij het einde van de buffer wijst wordt de index op het begin van de buffer gezet. = Verlaag het aantal karakters. Anders: = Is er geen karakter aanwezig in de buffer Invoerberichten T.b.v. de invoer van berichten, i.e. van testapparaat naar doseeralgoritme, zijn de volgende elementen aanwezig in de doseerinterface: = char DIF_A_IBER[] Databuffer = int32 DIF_V_IBER_IN_INDEX Invoerindex = int32 DIF_V_IBER_UIT_INDEX Uitvoerindex = int32 DIF_V_IBER_AANTAL Aantal karakters in databuffer = int32 DIF_V_IBER_LENGTE Lengte databuffer Met bovenstaande elementen wordt het ringbuffermechanisme geïmplementeerd. De procesbesturing plaats karakters in de ringbuffer, het doseeralgoritme leest karakters uit deze ringbuffer. N.B. Indien er geen plaats is in een ringbuffer is dit een indicatie dat de andere kant de data niet snel genoeg verwijdert. In geval van invoerberichten wordt het doseeralgoritme dan niet vaak genoeg aangeroepen Uitvoerberichten T.b.v. de uitvoer van berichten, i.e. van doseeralgoritme naar testapparaat, zijn de volgende elementen aanwezig in de doseerinterface: = char DIF_A_UBER[] Databuffer = int32 DIF_V_UBER_IN_INDEX Invoerindex = int32 DIF_V_UBER_UIT_INDEX Uitvoerindex = int32 DIF_V_UBER_AANTAL Aantal karakters in buffer = int32 DIF_V_UBER_LENGTE Lengte databuffer Met bovenstaande elementen wordt het ringbuffermechanisme geïmplementeerd. Het doseeralgoritme plaats karakters in de ringbuffer voor, de procesbesturing leest karakters uit deze ringbuffer. N.B. Indien er geen plaats is in een ringbuffer is dit een indicatie dat de andere kant de data niet snel genoeg verwijdert. In geval van uitvoerberichten dient de procesbesturing de data te verwijderen alvorens het doseeralgoritme weer aan te roepen Initialisatie. Tijdens de initialisatie-aanroep van het doseeralgoritme worden de ringbuffers geïnitialiseerd. Invoer en uitvoer indices en het aantal karakters worden op 0 gezet. 21

22 7. LITERATUUR EN PROGRAMMATUUR Literatuur: [DOS] Verkeerstechnische specificatie van een doseeralgoritme voor toeritdoseerinstallaties. Standaard verkeerstechnische specificatie voor een toeritdoseerinstallatie, Rijkswaterstaat, Adviesdienst Verkeer en Vervoer, Afdeling IBW Versie 1.1, d.d. 15 december 2000 [LIJST_PV] Standaard verkeerstechnische specificatie voor een TDI LIJST MET PARAMETERS, VARIABELEN e.d. Versie 2.08, d.d. 18 juli 2002, definitief Programmatuur: [C_D] RWS C-doseeralgoritme Versie 4.02, d.d. 30 oktober

23 8. IMPLEMENTATIE. 8.1 dos_int.h. /** ============================================================================= Project : TDI algoritme Versie : 4.02 File : dos_int.h Beschrijving: Header file met definitie van de elementen van de doseerinterface Bevat : VARIABELEN: : DIF_I_VAR... Indices in variabelen arrays : DIF_K_AANT_VAR Lengte variabelen array : DIF_A_VAR Array met waarden : DIF_V_VARWIJZDOS Algemene wijzigingsvlag : DIF_V_PB_AANT_VAR Constante met lengte arrays : : PARAMETERS: : DIF_I_PARM... Indices in parameters arrays : DIF_K_AANT_PARM Lengte parameters arrays : DIF_A_PARM Array met waarden : DIF_A_PARMWIJZDOS Array met wijzigingsvlaggen : DIF_A_PARMWIJZPB Array met wijzigingsvlaggen : DIF_V_PARMWIJZDOS Algemene wijzigingsvlag : DIF_V_PARMWIJZPB Algemene wijzigingsvlag : DIF_V_PB_AANT_PARM Constante met lengte arrays : : INGANGSSIGNALEN: : DIF_I_IS... Indices in ingangssignalen arrays : DIF_K_AANT_IS Lengte ingangssignalen arrays : DIF_A_IS Array met waarden : DIF_A_ISWIJZPB Array met wijzigingsvlaggen : DIF_V_ISWIJZPB Algemene wijzigingsvlag : DIF_V_PB_AANT_IS Constante met lengte arrays : : UITGANGSSIGNALEN: : DIF_I_DS... Indices in uitgangssignalen arrays : DIF_K_AANT_DS Lengte uitgangssignalen arrays : DIF_A_DS Array met waarden : DIF_A_DSWIJZDOS Array met wijzigingsvlaggen : DIF_V_DSWIJZDOS Algemene wijzigingsvlag : DIF_V_PB_AANT_DS Constante met lengte arrays : : CONSTANTEN: : aantal_stroken_trss Aantal rijstroken bij de stopstreep : aantal_stroken_trfile Aantal rijstroken bij het filemeldpunt : aantal_stroken_rwso Aantal rijstroken rijksweg stroomopwaarts : aantal_stroken_rwsa Aantal rijstroken rijksweg stroomafpwaarts : aantal_lt_hoog Aantal hoge lantaarns : aantal_lt_laag Aantal lage lantaarns : busstrook Busstrook aanwezig : id_doseertoestel Identificatienummer doseertoestel : aantal_stroken_trsa Aantal rijstroken toerit stroomafwaarts : aantal_stroken_trso Aantal rijstroken toerit stroomopwaarts : : KLOK: : DIF_V_TSEC_KLOK 100 ms teller : : VERSIENUMMER: : DIF_V_VERSIE_NR Versie nummer interface : : RINGBUFFERS T.B.V. IN- en UITVOER TESTBERICHTEN: : DIF_A_IBER Databuffer : DIF_V_IBER_IN_INDEX Invoerindex : DIF_V_IBER_UIT_INDEX Uitvoerindex : DIF_V_IBER_AANTAL Aantal karakters in databuffer : DIF_V_IBER_LENGTE Lengte databuffer : : DIF_A_UBER Databuffer : DIF_V_UBER_IN_INDEX Invoerindex : DIF_V_UBER_UIT_INDEX Uitvoerindex : DIF_V_UBER_AANTAL Aantal karakters in databuffer : DIF_V_UBER_LENGTE Lengte databuffer : : SPECIALE WAARDEN: : t.b.v. lees en schrijf vlaggen 23

24 : t.b.v. aanroep en returnwaarde doseeralgoritme : t.b.v. uitsturing signaalgroepen : t.b.v. programmastatus doseertoestel : t.b.v. detectorstatus detectoren : t.b.v. maxima aantal rijstroken en lantaarns : : PROCEDURE: : doseeralgoritme() is welliswaar geen onderdeel van dos_int.c : maar is t.b.v. de compleetheid van de interface : in deze headerfile opgenomen Compiler : ANSI C Controls : Historie : $Log: S:\archive\source\Dos_int.h_v $ Rev Oct :38:44 VSEDM Version in file adjusted Rev Oct :25:56 VSEDM TDI adjusted to "lijst_pv" version 2.08 Rev Mar :24:20 VSEDM Op verzoek van AVV is de "lange" historie verwijderd. =============================================================================*/ #ifndef DOS_INT_H #define DOS_INT_H #include "dos_typ.h" /* MACRO DEFINITIES */ /* MACRO VERSIENUMMER */ #define DIF_K_VERSIE_NR 4 /* Versie nummer interface */ /* MACRO's VARIABELEN (VAR), Indices, DIF_I_VAR... */ #define DIF_I_VAR_I_RWso_i 0 /* 1 t/m 4 */ #define DIF_I_VAR_I_RWso_1 0 /* ID = 1 */ #define DIF_I_VAR_I_RWso_2 1 /* ID = 2 */ #define DIF_I_VAR_I_RWso_3 2 /* ID = 3 */ #define DIF_I_VAR_I_RWso_4 3 /* ID = 4 */ #define DIF_I_VAR_I_RWsa_i 4 /* 1 t/m 4 */ #define DIF_I_VAR_I_RWsa_1 4 /* ID = 5 */ #define DIF_I_VAR_I_RWsa_2 5 /* ID = 6 */ #define DIF_I_VAR_I_RWsa_3 6 /* ID = 7 */ #define DIF_I_VAR_I_RWsa_4 7 /* ID = 8 */ #define DIF_I_VAR_I_TRso_i 8 /* 1 t/m 2 */ #define DIF_I_VAR_I_TRso_1 8 /* ID = 9 */ #define DIF_I_VAR_I_TRso_2 9 /* ID = 10 */ #define DIF_I_VAR_I_TRsa_i 10 /* 1 t/m 2 */ #define DIF_I_VAR_I_TRsa_1 10 /* ID = 11 */ #define DIF_I_VAR_I_TRsa_2 11 /* ID = 12 */ #define DIF_I_VAR_ROOD_RIJDERS_i 12 /* 1 t/m 2 */ #define DIF_I_VAR_ROOD_RIJDERS_1 12 /* ID = 13 */ #define DIF_I_VAR_ROOD_RIJDERS_2 13 /* ID = 14 */ #define DIF_I_VAR_V_RWso_i 14 /* 1 t/m 4 */ #define DIF_I_VAR_V_RWso_1 14 /* ID = 15 */ #define DIF_I_VAR_V_RWso_2 15 /* ID = 16 */ #define DIF_I_VAR_V_RWso_3 16 /* ID = 17 */ #define DIF_I_VAR_V_RWso_4 17 /* ID = 18 */ 24

25 #define DIF_I_VAR_V_RWsa_i 18 /* 1 t/m 4 */ #define DIF_I_VAR_V_RWsa_1 18 /* ID = 19 */ #define DIF_I_VAR_V_RWsa_2 19 /* ID = 20 */ #define DIF_I_VAR_V_RWsa_3 20 /* ID = 21 */ #define DIF_I_VAR_V_RWsa_4 21 /* ID = 22 */ #define DIF_I_VAR_I_g_RWso 22 /* ID = 55 */ #define DIF_I_VAR_I_RWsa 23 /* ID = 56 */ #define DIF_I_VAR_I_g_TRso 24 /* ID = 57 */ #define DIF_I_VAR_I_TRsa 25 /* ID = 58 */ #define DIF_I_VAR_I_gh_RWso 26 /* ID = 59 */ #define DIF_I_VAR_I_h_RWsa 27 /* ID = 60 */ #define DIF_I_VAR_I_gh_TRso 28 /* ID = 61 */ #define DIF_I_VAR_I_h_TRsa 29 /* ID = 62 */ #define DIF_I_VAR_I_kr_IN 30 /* ID = 74 */ #define DIF_I_VAR_V_kr_IN 31 /* ID = 75 */ #define DIF_I_VAR_I_kr_UIT 32 /* ID = 77 */ #define DIF_I_VAR_V_kr_UIT 33 /* ID = 78 */ #define DIF_I_VAR_VA_DOSEREN 34 /* ID = 86 */ #define DIF_I_VAR_VA_REGELEN 35 /* ID = 87 */ #define DIF_I_VAR_D_L_FOUT_UIT 36 /* ID = 89 */ #define DIF_I_VAR_UITSCHAKELEN 37 /* ID = 91 */ #define DIF_I_VAR_L_FOUT_UIT 38 /* ID = 92 */ #define DIF_I_VAR_FILE_TR 39 /* ID = 94 */ #define DIF_I_VAR_LAGE_V_RW_DOS 40 /* ID = 95 */ #define DIF_I_VAR_LOGGEN 41 /* ID = 96 */ #define DIF_I_VAR_DOS_TIJD_BER 42 /* ID = 109 */ #define DIF_I_VAR_I_delta_IV_C 43 /* ID = 113 */ #define DIF_I_VAR_bes_RWso_i 44 /* 1 t/m 4 */ #define DIF_I_VAR_bes_RWso_1 44 /* ID = 701 */ #define DIF_I_VAR_bes_RWso_2 45 /* ID = 702 */ #define DIF_I_VAR_bes_RWso_3 46 /* ID = 703 */ #define DIF_I_VAR_bes_RWso_4 47 /* ID = 704 */ #define DIF_I_VAR_bes_RWsa_i 48 /* 1 t/m 4 */ #define DIF_I_VAR_bes_RWsa_1 48 /* ID = 705 */ #define DIF_I_VAR_bes_RWsa_2 49 /* ID = 706 */ #define DIF_I_VAR_bes_RWsa_3 50 /* ID = 707 */ #define DIF_I_VAR_bes_RWsa_4 51 /* ID = 708 */ #define DIF_I_VAR_bes_TRso_i 52 /* 1 t/m 4 */ #define DIF_I_VAR_bes_TRso_1 52 /* ID = 709 */ #define DIF_I_VAR_bes_TRso_2 53 /* ID = 710 */ #define DIF_I_VAR_bes_TRsa_i 54 /* 1 t/m 4 */ #define DIF_I_VAR_bes_TRsa_1 54 /* ID = 711 */ #define DIF_I_VAR_bes_TRsa_2 55 /* ID = 712 */ #define DIF_I_VAR_B_FOUT_UIT 56 /* ID = 713 */ #define DIF_I_VAR_I_agh_RWso 57 /* ID = 714 */ #define DIF_I_VAR_I_agh_TRso 58 /* ID = 715 */ #define DIF_I_VAR_V_a_RWso_i 59 /* 1 t/m 4 */ #define DIF_I_VAR_V_a_RWso_1 59 /* ID = 716 */ #define DIF_I_VAR_V_a_RWso_2 60 /* ID = 717 */ #define DIF_I_VAR_V_a_RWso_3 61 /* ID = 718 */ #define DIF_I_VAR_V_a_RWso_4 62 /* ID = 719 */ #define DIF_I_VAR_V_a_RWsa_i 63 /* 1 t/m 4 */ #define DIF_I_VAR_V_a_RWsa_1 63 /* ID = 720 */ #define DIF_I_VAR_V_a_RWsa_2 64 /* ID = 721 */ #define DIF_I_VAR_V_a_RWsa_3 65 /* ID = 722 */ #define DIF_I_VAR_V_a_RWsa_4 66 /* ID = 723 */ #define DIF_I_VAR_V_agm_RWso 67 /* ID = 724 */ #define DIF_I_VAR_V_agm_RWsa 68 /* ID = 725 */ #define DIF_I_VAR_LAGE_I_TR 69 /* ID = 726 */ #define DIF_I_VAR_EXTRA_LAGE_V_RW 70 /* ID = 727 */ #define DIF_K_AANT_VAR 71 /* Aantal */ /* MACRO's PARAMETERS (PARM) Indices, DIF_I_PARM... */ #define DIF_I_PARM_MEETPER 0 /* ID = 147 */ #define DIF_I_PARM_CAPACITEIT_RW 1 /* ID = 149 */ #define DIF_I_PARM_SCHAKELAAR_PF 2 /* ID = 153 */ 25

26 #define DIF_I_PARM_DOS_TIJD_MAX 3 /* ID = 155 */ #define DIF_I_PARM_DOS_delta 4 /* ID = 156 */ #define DIF_I_PARM_I_dr_RWso_IN 5 /* ID = 189 */ #define DIF_I_PARM_I_dr_TRso_IN 6 /* ID = 190 */ #define DIF_I_PARM_V_dr_RWso_IN 7 /* ID = 192 */ #define DIF_I_PARM_V_dr_RWsa_IN 8 /* ID = 193 */ #define DIF_I_PARM_I_dr_RWso_UIT 9 /* ID = 195 */ #define DIF_I_PARM_I_dr_TRso_UIT 10 /* ID = 196 */ #define DIF_I_PARM_V_dr_RWso_UIT 11 /* ID = 198 */ #define DIF_I_PARM_V_dr_RWsa_UIT 12 /* ID = 199 */ #define DIF_I_PARM_I_vast_RWso 13 /* ID = 203 */ #define DIF_I_PARM_I_vast_TRso 14 /* ID = 204 */ #define DIF_I_PARM_V_vast_RWso 15 /* ID = 206 */ #define DIF_I_PARM_V_vast_RWsa 16 /* ID = 207 */ #define DIF_I_PARM_TIJD_NA_FILE 17 /* ID = 213 */ #define DIF_I_PARM_besp_RWso_i 18 /* 1 t/m 4 */ #define DIF_I_PARM_besp_RWso_1 18 /* ID = 728 */ #define DIF_I_PARM_besp_RWso_2 19 /* ID = 729 */ #define DIF_I_PARM_besp_RWso_3 20 /* ID = 730 */ #define DIF_I_PARM_besp_RWso_4 21 /* ID = 731 */ #define DIF_I_PARM_besp_RWsa_i 22 /* 1 t/m 4 */ #define DIF_I_PARM_besp_RWsa_1 22 /* ID = 732 */ #define DIF_I_PARM_besp_RWsa_2 23 /* ID = 733 */ #define DIF_I_PARM_besp_RWsa_3 24 /* ID = 734 */ #define DIF_I_PARM_besp_RWsa_4 25 /* ID = 735 */ #define DIF_I_PARM_besp_TRso_i 26 /* 1 t/m 2 */ #define DIF_I_PARM_besp_TRso_1 26 /* ID = 736 */ #define DIF_I_PARM_besp_TRso_2 27 /* ID = 737 */ #define DIF_I_PARM_besp_TRsa_i 28 /* 1 t/m 2 */ #define DIF_I_PARM_besp_TRsa_1 28 /* ID = 738 */ #define DIF_I_PARM_besp_TRsa_2 29 /* ID = 739 */ #define DIF_I_PARM_a_I 30 /* ID = 740 */ #define DIF_I_PARM_b_I 31 /* ID = 741 */ #define DIF_I_PARM_a_V 32 /* ID = 742 */ #define DIF_I_PARM_b_V 33 /* ID = 743 */ #define DIF_I_PARM_I_dr_TR 34 /* ID = 744 */ #define DIF_I_PARM_V_dr_RWso_DOS 35 /* ID = 745 */ #define DIF_I_PARM_V_dr_RWsa_DOS 36 /* ID = 746 */ #define DIF_I_PARM_V_dr_EXTRA_LAAG 37 /* ID = 747 */ #define DIF_I_PARM_V_dr_EINDE_EXTRA_LAAG 38 /* ID = 748 */ #define DIF_I_PARM_DOS_TIJD_EXTRA_MAX 39 /* ID = 749 */ #define DIF_K_AANT_PARM 40 /* Aantal */ /* MACRO's INGANGSSIGNALEN (IS) Indices, DIF_I_IS... */ #define DIF_I_IS_DOSR_STATUS 0 /* ID = 144 */ #define DIF_I_IS_I_delta_IV_C 1 /* ID = 351 */ #define DIF_I_IS_det_RWso_i 2 /* 1 t/m 4 */ #define DIF_I_IS_det_RWso_1 2 /* ID = 355 */ #define DIF_I_IS_det_RWso_2 3 /* ID = 356 */ #define DIF_I_IS_det_RWso_3 4 /* ID = 357 */ #define DIF_I_IS_det_RWso_4 5 /* ID = 358 */ #define DIF_I_IS_det_RWsa_i 6 /* 1 t/m 4 */ #define DIF_I_IS_det_RWsa_1 6 /* ID = 359 */ #define DIF_I_IS_det_RWsa_2 7 /* ID = 360 */ #define DIF_I_IS_det_RWsa_3 8 /* ID = 361 */ #define DIF_I_IS_det_RWsa_4 9 /* ID = 362 */ #define DIF_I_IS_V_RWso_i 10 /* 1 t/m 4 */ #define DIF_I_IS_V_RWso_1 10 /* ID = 525 */ #define DIF_I_IS_V_RWso_2 11 /* ID = 526 */ #define DIF_I_IS_V_RWso_3 12 /* ID = 527 */ #define DIF_I_IS_V_RWso_4 13 /* ID = 528 */ #define DIF_I_IS_V_RWsa_i 14 /* 1 t/m 4 */ #define DIF_I_IS_V_RWsa_1 14 /* ID = 541 */ #define DIF_I_IS_V_RWsa_2 15 /* ID = 542 */ #define DIF_I_IS_V_RWsa_3 16 /* ID = 543 */ #define DIF_I_IS_V_RWsa_4 17 /* ID = 544 */ 26

27 #define DIF_I_IS_SG1i_1 18 /* 1 t/m 2 */ #define DIF_I_IS_SG11_1 18 /* ID = 557 */ #define DIF_I_IS_SG12_1 19 /* ID = 558 */ #define DIF_I_IS_SG1i_2 20 /* 1 t/m 2 */ #define DIF_I_IS_SG11_2 20 /* ID = 565 */ #define DIF_I_IS_SG12_2 21 /* ID = 565 */ #define DIF_I_IS_SG1i_7 22 /* 1 t/m 2 */ #define DIF_I_IS_SG11_7 22 /* ID = 571 */ #define DIF_I_IS_SG12_7 23 /* ID = 572 */ #define DIF_I_IS_wus_SG1i 24 /* 1 t/m 2 */ #define DIF_I_IS_wus_SG11 24 /* ID = 579 */ #define DIF_I_IS_wus_SG12 25 /* ID = 580 */ #define DIF_I_IS_L_FOUT_UIT 26 /* ID = 587 */ #define DIF_I_IS_pardon_SG1i 27 /* 1 t/m 2 */ #define DIF_I_IS_pardon_SG11 27 /* ID = 588 */ #define DIF_I_IS_pardon_SG12 28 /* ID = 589 */ #define DIF_I_IS_FILE_TR 29 /* ID = 597 */ #define DIF_I_IS_LOGGEN 30 /* ID = 598 */ #define DIF_I_IS_UITSCHAKELEN 31 /* ID = 599 */ #define DIF_K_AANT_IS 32 /* Aantal */ /* MACRO's UITGANGSSIGNALEN (DS) Indices, DIF_I_DS... */ #define DIF_I_DS_berek_per_meetper 0 /* ID = 600 */ #define DIF_I_DS_berek_dos_tijd 1 /* ID = 601 */ #define DIF_K_AANT_DS 2 /* Aantal */ /* MACRO's SPECIALE WAARDEN */ /* T.b.v. wijzigingsvlaggen */ #define DIF_K_GESCHREVEN 1 /* in buffer geschreven */ #define DIF_K_GELEZEN 0 /* buffer gelezen */ #define DIF_K_GEEN_PARMWIJZ -1 /* geen wijzigingen in parameterbuffer */ #define DIF_K_MEER_PARMWIJZ -2 /* een of meerdere wijzigingen in parameterbuffer */ #define DIF_K_INIT_PARM -3 /* initiele waarden in parameterbuffer */ /* T.b.v aanroep en returnwaarde doseeralgoritme() */ #define DIF_K_GEEN_INIT 0 /* 'normale' aanroep */ #define DIF_K_INIT 1 /* init na programmastart */ #define DIF_K_GEEN_FOUT 0 /* geen fout */ #define DIF_K_INIT_FOUT -1 /* initialisatie fout */ #define DIF_K_DOS_FOUT1 1 /* doseerprogramma leest een ongeldige parameter */ #define DIF_K_DOS_FOUT2 2 /* doseerprogramma leest een ongeldig ingangssignaal */ #define DIF_K_DOS_FOUT3 4 /* doseerprogramma aangeroepen met ongeldige code */ #define DIF_K_DOS_FOUT4 8 /* wijzigingsvlag niet gereset, i.e. DIF_K_GELEZEN */ /* T.b.v uitsturing signaalgroepen: ingangssignaal DIF_I_IS_wus_SG11 t/m DIF_I_IS_wus_SG12 */ #define DIF_K_ROOD 0 /* rood */ #define DIF_K_GROEN 1 /* groen / wit / wit knipperen */ #define DIF_K_GEEL 2 /* geel / groen knipperen */ #define DIF_K_KNIPWIT 3 /* wit knipperen */ #define DIF_K_GEDOOFD 4 /* lantaarn(s) gedoofd */ /* T.b.v. programma status doseertoestel: ingangssignaal DIF_I_IS_DOSR_STATUS */ #define DIF_K_STAT_ONGEDEF 0 /* Ongedefinieerd */ #define DIF_K_STAT_GEDOOFD 1 /* Gedoofd */ #define DIF_K_STAT_KP 2 /* Knipperen */ #define DIF_K_STAT_GEEL 3 /* Geel bij inschakelen */ #define DIF_K_STAT_AR 4 /* Alles rood */ 27

28 #define DIF_K_STAT_DOS 5 /* Doseren (==regelen) */ /* T.b.v. detectorstatus: ingangssignaal DIF_I_IS_SG11_1 t/m DIF_I_IS_SG12_7 */ #define DIF_M_DET_BEZET 1 /* Detector bezet */ #define DIF_M_DET_STORING 2 /* Detector in storing */ #define DIF_M_DET_BOVENGEDRAG 4 /* Detectie bovengedrag */ #define DIF_M_DET_ONDERGEDRAG 8 /* Detectie ondergedrag */ /* Maxima voor configuratie constanten */ #define DIF_K_max_aantal_stroken_TR 2 /* Maximum aantal stroken op de toerit */ #define DIF_K_max_aantal_stroken_RW 4 /* Maximum aantal stroken op de rijksweg*/ #define DIF_K_max_aantal_LT 2 /* Maximum aantal lantaarns, hoog en/of laag */ #define DIF_K_max_id_doseertoestel 255 /* Maximum versienummer doseertoestel */ /* Minima voor configuratie constanten */ #define DIF_K_min_aantal_stroken_TR 1 /* Minimum aantal stroken op de toerit */ #define DIF_K_min_aantal_stroken_RW 1 /* Minimum aantal stroken op de rijksweg*/ #define DIF_K_min_aantal_LT_hoog 0 /* Minimum aantal lantaarns hoog */ #define DIF_K_min_aantal_LT_laag 1 /* Minimum aantal lantaarns laag */ #define DIF_K_min_id_doseertoestel 1 /* Minimum versienummer doseertoestel */ /* T.b.v. algemene waarden van variabelen en ingangs- en uitgangssignalen */ #define DIF_K_UIT 0 #define DIF_K_AAN 1 #define DIF_K_AFWEZIG 0 #define DIF_K_AANWEZIG 1 #define DIF_K_ONBEKEND -1 /* DATA DEFINITIES */ /* VARIABELEN */ extern int32 DIF_A_VAR [] /* Array met waarden */ extern int16 DIF_V_VARWIJZDOS /* Algemene wijzigingsvlag (door doseeralgoritme) */ extern const int16 DIF_V_PB_AANT_VAR /* Aantal variabelen */ /* PARAMETERS */ extern int32 DIF_A_PARM [] /* Array met waarden */ extern int16 DIF_A_PARMWIJZDOS [] /* Array met wijzigingsvlaggen (door doseeralgoritme) */ extern int16 DIF_A_PARMWIJZPB [] /* Array met wijzigingsvlaggen (door procesbesturing) */ extern int16 DIF_V_PARMWIJZDOS /* Algemene wijzigingsvlag (door doseeralgoritme) */ extern int16 DIF_V_PARMWIJZPB /* Algemene wijzigingsvlag (door procesbesturing) */ extern const int16 DIF_V_PB_AANT_PARM /* Aantal parameters */ /* INGANGSSIGNALEN */ extern int32 DIF_A_IS [] /* Array met waarden */ extern int16 DIF_A_ISWIJZPB [] /* Array met wijzigingsvlaggen (door procesbesturing) */ extern int16 DIF_V_ISWIJZPB /* Algemene wijzigingsvlag (door procesbesturing) */ extern const int16 DIF_V_PB_AANT_IS /* Aantal ingangssignalen */ /* UITGANGSSIGNALEN */ extern int32 DIF_A_DS [] /* Array met waarden */ extern int16 DIF_A_DSWIJZDOS [] /* Array met wijzigingsvlaggen (door doseeralgoritme) */ extern int16 DIF_V_DSWIJZDOS /* Algemene wijzigingsvlag (door doseeralgoritme) */ extern const int16 DIF_V_PB_AANT_DS /* Aantal uitgangssignalen */ /* CONSTANTEN */ extern const int16 aantal_stroken_trss extern const int16 aantal_stroken_trfile extern const int16 aantal_stroken_rwso extern const int16 aantal_stroken_rwsa /* ID = 136, Aantal rijstroken bij de stopstreep */ /* ID = 137, Aantal rijstroken bij het filemeldpunt */ /* ID = 138, Aantal rijstroken rijksweg stroomopwaarts*/ /* ID = 139, Aantal rijstroken rijksweg stroomafwaarts*/ 28