TC_DCM 10-03-2008 Inleiding De TC_DCM (Tele Controls Data Collection Module) is een module om dataloggers van het type Optimodem en Atlas uit te lezen. De gebruiker dient zelf een applicatie te maken die een configuratie file moet aanmaken, elke keer dat er een uitleesslag moet plaatsvinden. De uitgelezen gegevens worden in een XML bestand geretourneerd. Optimod2000 is nodig om de dataloggers te configureren. De gebruiker-applicatie is verantwoordelijk voor wanneer er gecommuniceerd moet worden, met welk telefoon nummer of TCP/IP adres. Tevens worden de gegevens ruw aangeleverd, dus zonder conversie factoren. De gebruiker-applicatie zal ook moeten bijhouden welke gegeven opgehaald moeten worden. Input Als TC_DCM wordt opgestart wordt automatisch de file TC_DCM.CFG ingelezen Hierin staan de gegevens over de datalogger die gebeld moet worden De file structuur is als een Windows ini file [Device] Customer=Westland Energie Niet echt nodig, wordt alleen gebruikt voor debug doeleinden Name=AE154306 Wordt gebruikt naamgeving in de return file SerialNr=932-02-05929 Is nodig om 100% zeker te zijn dat met het juiste apparaat wordt gebabbeld DataFrom=20040131 Gegevens vanaf dit tijdstip worden opgehaald. Op dit moment fix format Ingelezen wordt vooralsnog hele dagen t/m de voorlaatste dag Formaat YYYYMMDD Later evt ook nog de keuze of gegevens t/m het laatste tijdstip moeten worden opgehaald SyncTime=1 Klok tijdsyncen bij afwijking groter dan SyncDiff SyncDiffMin=3 Bij afwijkingen > 3 sec wordt de klok gelijk gezet (mits SyncTime=1) SyncDiffMax=300 Bij afwijkingen > 300 sec wordt de klok niet meer gelijk gezet DST=0 Daylight Saving Time ofwel Zomer winter schakelen. Default op 0 (niet schakelen) SerBuf=0 Ingelezen seriële buffer ophalen en in een de file \Debug\SerBuf_Projektnaam.txt plaatsen LiveValues=1 Geeft in de XML de huidige waarden uit de datalogger [Connection] Device=Standard 9600 bps Modem Windows device naam, of TCP/IP DialNr=06-12345678 Bij TCP/IP hier het IP adres invullen Protocol=OPTIMODEM Protocol keuze OPTIMODEM of ATLAS Baud=9600 Niet van belang bij TCP/IP RS485=0 RS485 adres indien noodzakelijk Default 0 (voor modem verbindingen) OnOneLine=1 Aantal optimodems op 1 PSTN lijn Default 1 Password=OPTIMOD+ Het huidige password NewPassword=NEWPAS Alleen invullen indien nieuw password gewenst
[Channels] DI1=1 DI2=1 SI1=1 SI2=1 DU1=1 Relais uitgang 1 sturing 0 = Niets doen 1 = Pulsen 2 = Aan 3 = Uit Niet alle parameters hoeven worden doorgegeven, er kan gebruik gemaakt worden van defaults b.v. NewPassword=xxxx Alleen invullen indien dit een ander password moet worden RS485=0 Default 0, en goed voor alle modem verbinding OnOneLine=1 Alleen invullen indien meerdere analoge modems op 1 lijn zitten DI3=0 Mag ingevuld worden hoeft niet, default=0 TC_DCM.INI Deze file bevat een aantal instellingen die systeem afhankelijk zijn: [Form] Positie van het formulier op het scherm Top=186 Left=186 [System] DialOnStart=1 Bij opstarten TC_DCM direkt bellen (kan evt worden uitgezet) CloseOnReady=1 Na bellen applicatie sluiten (kan worden uitgezet) TabLength=6 XML output file tab lengte default 6 spaties [Query] Address=127.0.0.1 TC_ICM adres (t.b.v. GPRS communicatie met een dynamisch IP adres) Port=8002 TC_ICM poort (t.b.v. GPRS communicatie met een dynamisch IP adres)
Bellen Wordt automatisch gestart als de configuratie file is ingelezen Na afloop wordt automatisch het programma gesloten en worden enkele files aangemaakt Dataverwerking Debug Alle debug gegevens worden bij elke belslag naar file geschreven in de debug directory Filenaam: Debug_Projektnaam.txt Seriële buffer Evt opgehaalde seriële buffer wordt ook in de Debug directory geplaatst Filenaam: Serbuf_Projektnaam.txt Data De datagegevens worden in de current directory geplaatst onder de naam TC_DCM.XML hier komen weer een aantal brokken informatie te staan De Data file wordt bij het opstarten van TC_DCM altijd eerst weggegooid. Er wordt ook altijd een nieuwe file aangemaakt met hierin het resultaat Zie bijlage met XML voorbeeld Opstart parameters Sinds rev 2.0 is het ook mogelijk om de TC_DCM parallel te draaien. TC_DCM.exe moet dan opgestart worden met een 1 tot 3 parameters. In de praktijk is het alleen mogelijk om dit te gebruiken voor TCP/IP (GPRS) communicatie. 1) FileNaam De input file naar (cfg file) deze naam wordt ook gebruikt voor de output xml file 2) InputDir De plek waar de cfg file staat 3) InputDir De plek waar de xml file moet komen te staat Indien hiervan gebruik wordt gemaakt zal de TC_DCM.ini file niet worden ingelezen en/of beschreven.
Screenshot voorbeeld zoals het belprogramma er uitziet
<?xml version="1.0" standalone="yes"?> <Reading> <General> <Customer>Tele Controls</Customer> <Name>Diamantstraat 26</Name> </General> <Result> <History>1</History> <ResultText>OK</ResultText> </Result> <Diagnose> <Error_TO>0</Error_TO> <Error_CRC>0</Error_CRC> <Error_Adres>0</Error_Adres> <Error_Ident>0</Error_Ident> <Error_Instr>0</Error_Instr> <Error_Param>0</Error_Param> <FieldStrength_1>13</FieldStrength_1> <FieldStrength_2>11</FieldStrength_2> <FieldStrength_3>14</FieldStrength_3> <Slowest_Respons>913</Slowest_Respons> <Protocol_Time>23,6</Protocol_Time> <Total_Time>27,4</Total_Time> </Diagnose> <Consumptions> <Data> <DateTime>200409231010</DateTime> <Input>DI1</Input> <Period>300</Period> <Consumption>257</Consumption> <Status>0</Status> </Data> <Data> <DateTime>200409231015</DateTime> <Input>DI1</Input> <Period>300</Period> <Consumption>268</Consumption> <Status>0</Status> </Data> </Consumptions> Example of created XML file
<Readings> <DataReadings> <DateTime>200409231010</DateTime> <Input>DI1</Input> <Reading>1229261</Reading> <Status>1</Status> </DataReadings> <DataReadings> <DateTime>200409231015</DateTime> <Input>DI1</Input> <Reading>1238278</Reading> <Status>1</Status> </DataReadings> </Readings> </Reading>
Explanation of the XML file <?xml version="1.0" standalone="yes"?> <Reading> The body tag <General> General information block <Customer> Returned from TC_DCM.CFG [Device] Customer <Name> Returned from TC_DCM.CFG [Device] Name <Result> <History> 0=Error (see ResultText) 1=OK <ResultText> OK Wrong date SerialNr xxxxxxx error Time difference to big, time not synced Protocol_Error Device_Error <Diagnose> This block is for diagnose only, and not essential <Error_TO> Number of Time Out errors in the session (can be a few) <Error_CRC> Number of CRC errors in the session (should be 0 or 1) <Error_Adres> Number of Adres errors in the session (should be 0) <Error_Ident> Number of Ident errors in the session (should be 0) <Error_Instr> Number of Instruction errors in the session (should be 0 or 1) <Error_Param> Number of Parameter errors in the session (should be 0) <FieldStrength_1> Fieldstrength Nr 1 (Only Atlas with GSM) <FieldStrength_2> Fieldstrength Nr 2 (Only Atlas with GSM) <FieldStrength_3> Fieldstrength Nr 3 (Only Atlas with GSM) <Slowest_Respons> Slowest Response PSTN/ISDN should be 700 msec or less GSM should be max 1200 msec in day time sometimes a few 1000 <Protocol_Time> Time in sec <Total_Time> Time including dialing of datalogger
<Consumptions> n Data block s from each input-channel each sample. Sorted on time and Input <Data> <DateTime> Date/Time stamp YYYYMMDDhhmm <Input> Input-Channel Optimodem DI1 to DI8 for digital inputs AI1 to AI6 for analog inputs SI1 to SI10 for serial inputs Atlas SI1 to SI8 for serial inputs <Period> Measured period time in sec. should be equal to the sample frequency Can be plus or minus 1 sec. If the time is corrected in this sample time can even be longer than the sample time <Consumption> Consumption of the sample <Status> 0 = OK 1 = Not measured, due to power fail (Period is 0) or in case of serial devices no serial read out. <Readings> n Data block s from each input-channel from the end of each day. Sorted on date and Input <DataReadings> <DateTime> Date/Time stamp YYYYMMDDhhmm <Input> Input-Channel Optimodem DI1 to DI8 for digital inputs SI1 to SI10 for serial inputs Atlas SI1 to SI8 for serial inputs <Reading> <Status> The reading at the end of the day 0 = OK 1 = Not measured, due to power fail