Capcode import tool t.b.v. PDW

 Direct naar de download / install pagina
of download setup.zip

Korte beschrijving

PDW is een veel gebruikt programma om de berichten die verstuurd worden via het P2000 alarmeringsnet (wat gebruikt wordt door de hulpdiensten), mee te kunnen lezen. Hiervoor zijn 'pagers' in gebruik die aangesproken kunnen worden met bepaalde 'capcodes'.

In Nederland zijn een kleine 10.000 capcodes in gebruik. Het is vaak leuk om te kunnen zien welke gebruiker er bij een bepaalde capcode hoort, maar gezien het aantal is het haast niet doenlijk om de landelijke lijst over te tikken.

Dit Windows programma leest een database met capcodes via Internet; en schrijft deze informatie weg in een filters.ini bestand wat later weer door PDW gebruikt kan worden.



Op deze manier is het dus heel makkelijk om PDW up-to-date te houden.


Dit programma decodeert dus zelf GEEN P2000 berichten; daar blijft PDW gewoon voor nodig !
Het programma helpt gebruikers van het PDW programma om de lijst met filters aan te maken.


Systeem vereisten

Het programma heeft het '.net framework 2.0' nodig; dit is een gratis Microsoft download die o.a. hier handmatig verkrijgbaar is.

".Net framework 2.0" is beschikbaar voor de volgende Windows versies:
  • Windows 2000 Service Pack 3;
  • Windows 98;
  • Windows 98 Second Edition;
  • Windows ME;
  • Windows Server 2003;
  • Windows XP Service Pack 2

Waarom is het framework nodig ?

".Net framework 2.0" is een set kant-en-klare subroutines die door programma's (zoals deze tool) kunnen worden aangeroepen.

Standaard taken (zoals het openen van de database via een Internet verbinding) zijn eenvoudig aan te roepen; het eigenlijke programma wordt dus eenvoudiger te schrijven en te onderhouden. Anders gezegd: de programmeur hoeft niet telkens opnieuw 'het wiel uit te vinden' en is daardoor sneller klaar met het programma.

Licentie model

Freeware; geen licentie vereisten.

Open Source

Ik wil iedereen van harte uitnodigen om het programma te verbeteren en uit te breiden. De source is bij de maker van het programma verkrijgbaar.

Het is ook de bedoeling om voorbeeld programma's te publiceren; zodat iedereen op ideeen gebracht kan worden. Met deze voorbeelden wordt het duidelijk hoe de database te benaderen is; en hoe de gegevens in een programma gemanipuleerd kunnen worden. Uiteindelijk hoop ik dat er een 'community' ontstaat waar dergelijke programma's gezamelijk gemaakt en verbeterd worden; een computer leent zich nou eenmaal bij uitstek om met digitale informatie zoals P2000 om te gaan.

Voornaamste beperking daarbij is tijd; ik hoop de voorbeelden in de komende week/weken te kunnen publiceren.

Het import programma installeren en gebruiken

Installeer het programma door op deze pagina op "install" te klikken. Dit werkt zeker in Internet Explorer; met Firefox hebben we wat problemen gezien, maar die lossen we later wel op. Zoals gezegd controleert de installer eerst of ".net framework 2.0" aanwezig is; en installeert daarna het eigenlijke 'capcode import' programma.

Als dat niet werkt (de setup via een web pagina loopt niet zo vlekkeloos als Microsoft ons wil doen geloven) is het ook mogelijk de setup bestanden "ouderwets" te downloaden als een ZIP file. Open deze zip file, en start setup.exe om de installatie te starten.

Eenmaal geinstalleerd via 1 van 2 bovenstaande methodes, controleert het programma voortaan zelf of er updates zijn; als dat het geval is worden deze automatisch opgehaald en de applicatie bijgewerkt.

De installer maakt een programmagroep 'Peen van Dienst' aan; en daarbinnen een icon voor 'PDW filter importer'.

Start nu het 'PDW filter importer' programma, en selecteer nu het filters.ini bestand (meestal te vinden in de 'C:\Program Files\PDW' directory). Het programma opent het filters.ini bestand en laat zien hoeveel filters daar nu al in aanwezig zijn.

Update gedrag

Stel het 'update gedrag' in. Hier kan worden aangegeven of er alleen ontbrekende capcodes in filters.ini moeten worden toegevoegd; of dat ook van bestaande filters de omschrijving moet worden vervangen.

Het programma vervangt alleen het veld 'omschrijving' (description) van het filter. Het type filter, de 'hit count' en alle andere filter parameters blijven gelijk. Ontbrekende capcodes worden in eerste instantie als 'monitor-only' toegevoegd.

Selectie van de discipline

Hier kan aangegeven worden of alleen 'brandweer', 'ambulance' e.d. capcodes moeten worden geimporteerd; of combinaties daarvan. Uiteraard moet er minstens 1 categorie aangevinkt zijn. Overigens zijn op dit moment (juni 2006) over het algemeen alleen de brandweer capcodes in de database met capcodes aanwezig; 'ambulance' aanzetten kan dus wel, maar zal weinig filters opleveren.

Starten van de export


Stop nu het PDW programma, als dat op dit moment ook actief is.
Het is over het algemeen geen goed idee om met twee programma's tegelijk in 1 bestand te schrijven.
Versies 1.0.0.26 en later controleren of PDW actief is, en geven dan een waarschuwing.


Kies de volgorde van de tekstvelden zoals die in filters.ini gezet moet worden.

Sinds versie 1.0.0.30 kan er bij 'volgorde tekstvelden' o.a. gekozen worden voor 'verkorte regio' benaming; 'Brandweer Haaglanden' wordt dan BHL; Ambulance Zaanstreek-Waterland wordt AZW enzovoort. Dit is gedaan omdat PDW een maximaal lengte van 79 karakters heeft voor het veld 'omschrijving'; en in sommige gevallen past de 'lange notatie' niet binnen die 79 karakters. De verkorte regio aanduiding scheelt dan veel ruimte.



Klik daarna op 'Go !'.

Als eerste wordt er een filters.ini.bak gemaakt (backup file); ingeval van ernstige problemen is het voldoende om filters.ini weg te gooien, en filters.ini.bak te renamen naar filters.ini.

Hierna gaat het programma aan de slag, en zal de voortgang tonen.



Na enige tijd is filters.ini aangepast.

Stop nu het import programma; en herstart PDW. Als het goed is laat PDW de zojuist geimporteerde omschrijvingen zien.

To do - in de pijplijn

  • Sorteren van filters.ini na het bijwerken ervan.
  • Samenwerken met PDW; als het nieuwe filter file klaar is, PDW signaleren dat het opnieuw geladen moet worden.
  • Versnellen van de verwerking; optimalisatie (al werkt het nu al best aardig snel)
  • Installatie ook vanuit de Firefox browser mogelijk maken.

Nog vragen ?

Voor vragen of opmerkingen kun je contact opnemen met de Peen van Dienst.

Let op: dat gaat alleen om inhoudelijke vragen m.b.t. het programma; niet over 'jij bent blijkbaar wel thuis in Windows; ik krijg die en die foutmelding als ik print'. Met andere woorden; ik ben geen Windows helpdesk !