RDCONT Használati útmutató (c) Almási Béla almasi@inf.unideb.hu Debrecen, 2008. július 1. 1./ Általános feltételek. Az RDCONT infra vevő és program célja, hogy a DCONT PERSONAL vércukormérő memóriájában tárolt mérési adatokat átvigyük számítógépünkre. A program szabadon használható, továbbadható, ill. letölthető a http://irh.inf.unideb.hu/rdcont címről, de sem a programon, sem a dokumentációján semmilyen módosítás nem végezhető. A megadott címről letölthető teljes rendszert tartalmazó rdcont.zip állomány tartalma: rdcont.pdf a rendszer dokumentációja, rdcont.jpg az rdcont infra vevő kapcsolási rajza, rdcont.exe adatbeolvasó program, rday.exe egy nap adatait egy sorba rendező program, rday.txt minta konfigurációs állomány az rday.exe programhoz. Ha a bemutatott infra vevőt és a programokat sikeresen használja, örömmel fogadunk egy e-mailt a használatról az almasi@inf.unideb.hu címre. Ha visszajelzi számunkra az RDCONT használatát, akkor a későbbiekben tájékoztatni tudjuk a folyamatban lévő fejlesztésekről, a megjelenő új verziókról. A programot és a bemutatott infra vevőt mindenki csak saját felelősségére használhatja, a helyes és hibamentes működésre nincs garanciavállalás. A használattal kapcsolatos esetleges problémák és kérdések elküldhetők az almasi@inf.unideb.hu címre, igyekszünk ezeken segíteni, de a programokhoz és az infra vevőhöz semmilyen támogatás ill. segítségnyújtás nem garantált. 2./ Működési feltételek. Hardver: Pentium számítógép, 1 db szabad soros (COM) port, soros infra vevő. Szoftver: MS Windows 95/98/2000/XP környezet, parancssor (Command prompt). A soros infra vevőt némi elektronikai szerelési jártasság birtokában egyszerűen elkészíthetjük a dokumentum végén található 1. ábra alapján (ennek alkatrészköltsége kb. egyezer forint, vagy talán még kevesebb). Összeszerelési javaslatként a következőt tudjuk ajánlani: Az infra fototranzisztor (T1) kivételével a többi alkatrész közvetlenül ráépíthető a DB9 anya csatlakozóra (van elegendő hely a DB9 műanyag házban), a fototranzisztor pedig egy kb. 1 méter hosszú egyszerű kéteres vezetékkel csatlakoztatható. Tapasztalatunk szerint az 1. ábrán látható infra vevő a bemutatott programokkal helyesen működik a Dcont Personal, Dcont Personal Optimum típusú készülékekkel. 1/8
3./ Az RDCONT.EXE program használata. Csatlakoztassuk az infravörös vevőt egy szabad COM porthoz, majd indítsuk el a programot az RDCONT.EXE paranccsal. Alapértelmezés szerint a program a COM1 soros porton keresi az infra érzékelőt, ha másik COM porthoz csatlakoztattuk az infra egységet, akkor a program RDCONT.EXE comn paranccsal indítható (N=2,3,4 lehet), ahol comn annak a soros portnak a hivatkozása, melyhez az infra vevőt csatlakoztattuk (pl. com3 ). Ha nem tudjuk, melyik COM porthoz csatlakozik az infra vevőnk, akkor egy RDCONT.EXE scan paranccsal lekérdezhetjük, hogy mely porton érzékeli a számítógép az infra vevőt. A megjelenő listában az Igen -nel jelzett COM porton észlelt IR vevőt a program. Előfordulhat, hogy egyes gépeken a vevő érzékelése (a scan opció használata) nem ad helyes eredményt. A program sikeres indítás esetén Inditsa el az adatátvitelt a vércukormérőjéről felirattal jelzi, hogy készen áll a vércukormérő adatok beolvasására. A vércukormérőt adatátviteli módba kell állítani: A bekapcsoló gombot hosszan nyomva tartva először megjelenik egy kis óra jel, s továbbra is nyomva tartva néhány másodperc múlva megjelenik a PC felirat a vércukormérőn. (Optimum készüléknél az óra jel nem jelenik meg a PC felirat előtt.) Ekkor a vércukormérő készen áll az adatátvitelre (ld. Vércukormérő használati leírása). Az adatátvitelhez tegyük az infra vevő érzékelőjét (a fototranzisztort) kb. 0.5 1cm távolságra a vércukormérő infra LED-je elé, azzal pontosan szembe fordítva. (A vércukormérő infra LED-je a kijelző fölött, a készülék rövidebb oldalán található pici lámpa.) Indítsuk el az adatátvitelt a vércukormérőről. Ez készüléktől függően vagy a vércukormérő készülék M (vagy másképpen ) jelű gombjának, vagy a bekapcsoló gombjának megnyomásával történik. A vércukormérőn megjelenik a tölt felirat, a számítógépen pedig az Adatok olvasása kiírás jelenik meg. Az adatfeltöltés után egyes vércukormérő készülékek azonnal ki is kapcsolják magukat. Az adatfeltöltés kevesebb, mint fél percet vesz igénybe. Az adatfeltöltés közben a vércukormérőnek és az infra vevő érzékelőjének fixen kell állnia, nem mozdulhatnak. A program az adatbeolvasás végén kiírja a képernyőre, hogy hány hibát észlelt a beolvasás során, pl. ha 45/600 jelenik meg a képernyőn, akkor az azt jelenti, hogy összesen 600 byte adatot kell átvinni, s ebből 45 byte esetében történt adatátviteli hiba. Ha teljesen sikeres és hibamentesnek érzékelt az átvitel, akkor tipikusan 0/600 (illetve Optimum készüléknél 0/2000) jelenik meg a képernyőn, s a program kiírja a vércukormérőről beolvasott adatokat az RDCONT.CSV állományba. Ha hibát érzékelt a program az átvitel során, akkor vagy újabb adatbeolvasást hajtunk végre (ENTER leütéssel) vagy egy x billentyű, majd ENTER leütésével befejezzük az adatbeolvasást, s a beolvasott (hibát is tartalmazó) adatok kerülnek kiírásra az RDCONT.CSV állományba. Az adatátvitelt esetleg megnehezíti, ha közvetlenül erős külső fény éri az infra vevő érzékelőjét (pl. erős napsugárzás vagy lámpafény). Ilyen esetben több adatátviteli fázisra lehet szükség, ill. előfordulhat, hogy Fejléc átviteli hiba üzenetet kapunk, s meg kell ismételnünk az első fázist. 2/8
Az adatbeolvasás végén létrejött RDCONT.CSV állomány már önmagában is használható, de egy táblázatkezelő programmal (pl. Excel) kényelmesen kezelhető, tovább feldolgozható ill. nyomtatható. FIGYELEM! Az RDCONT.CSV állományt mindenképpen célszerű ellenőrizni a beolvasás után, hogy tartalmaz-e esetleg hibás adatokat! 4./ Az RDCONT.CSV állomány szerkezete. Az RDCONT.CSV állomány egy egyszerű szöveges állomány, melyben egy sor ír le egy mérési eredményt, a következőképpen: Az első négy oszlop a mérés idejét adja meg (hónap; nap; óra; perc;) az ötödik oszlop a mért vércukor érték, a hatodik oszlop pedig egy hibajelző kód. A hibakód 0 értéke jelzi, hogy nem volt érzékelhető hiba az adatátvitel során. Ha a hibakód nem nulla, de 9-nél kisebb (tipikusan 1), akkor a sorban egy olyan adat szerepel, amelyet méréskor felkiáltójellel (! ) megjelöltünk. Ha a hibakód értéke 10, vagy a feletti, akkor a sor beolvasása közben adatátviteli hiba (olvasási hiba) történt. FIGYELEM! Az RDCONT.CSV állományt az átvitel után célszerű átnevezni, mert a következő adatátvitelnél a benne szereplő adatok felülíródnak az újonnan beolvasott adatokkal, azaz a régi adatok elvesznek. 5./ Hosszabb távú adatfeldolgozás. A hosszabb távú adatfeldolgozás alapfeltétele, hogy a vércukormérőn a pontos dátumot és időt beállítsuk, hiszen a vércukormérés időpontját is beolvassa az rdcont.exe program a vércukormérőről, de ezt csak akkor tudjuk használni, ha a készülék a méréskor pontos dátum és időpont értékkel rögzíti a mérési eredményt. A dátum és időpont beállításának leírását a vércukormérő használati utasításában találhatjuk meg. A vércukormérő készülék kb. 150 (ill. az Optimum 500) mérési eredmény tárolását végzi, így hosszabb távú adatfeldolgozáshoz célszerű rendszeresen (pl. havonta egyszer-kétszer) megismételni a PC-re való adatfeltöltést. A hosszú távú tároláshoz célszerű valamilyen táblázatkezelő programot használni, amivel kényelmesen összeszerkeszthetjük ill. nyomtathatjuk a vércukormérőről áttöltött adatokat. Táblázatkezelő hiányában egy egyszerű szerkesztőprogrammal (pl. Notepad vagy Wordpad) is elvégezhetjük a különböző feltöltések egyesítését. FIGYELEM! A régebbi Excel verziók duplaklikkeléses automatikus megnyitással nem tudják beolvasni a CSV állományokat. Ebben az esetben a táblázatkezelőt kell elindítani, majd a Fájl menü Megnyitás pontján keresztül tölthetjük be a táblázatkezelőbe a vércukormérőről beolvasott adatokat. 3/8
6. Az RDAY.EXE program használata. A 3. pontban leírt módon a számítógépre átvitt adatok közvetlenül nehezen elemezhetők, célszerűbb lehet egy nap adatait egy sorban megjelenítve tárolnunk. Ehhez ad segítséget az RDAY.EXE program: a beolvasott eredményeket átrendezi, és egy nap adatait egy sorba összevonva új állományokban tárolja le. Az új állományok nevét a régiből egy _day ill. _day_all kiegészítéssel kapjuk. Az RDAY.EXE programot parancssoros ablakban indíthatjuk. A program használata előtt el kell készítenünk a programhoz tartozó RDAY.TXT konfigurációs állományt, s ennek a konfigurációs állománynak az aktuális könyvtárban kell lennie. Az RDAY.TXT állomány szerkezete. Az RDAY.TXT állomány egy egyszerű szöveges állomány, a következő szerkezettel: 1. sor: Az input állomány neve. Ebben az állományban a vércukormérőről beolvasott adatoknak kell szerepelni a 4. pontban jelzett szerkezettel, s az állománynak.csv kiterjesztésűnek kell lenni. Az rday.exe program indításakor is megadhatjuk az input állomány nevét egy paraméterben, de ha nem adunk meg paramétert, akkor a konfigurációs állomány első sorában szereplő állományt használja. Az állomány neve után pontosvesszővel elválasztva tetszőleges megjegyzést, magyarázatot írhatunk. 2. sortól: Soronként egy mérési napszak definícióját adhatjuk meg. A napszak egy vércukormérés időpontját határolja be. A konfigurációs állományban megadott napszakok nem fedhetik át egymást és időben növekvőleg kell a napszakokat a konfigurációs állományba beírni. A napszak definíció 4 oszlopból áll (az oszlopokat pontosvesszővel elválasztva): az első oszlop a napszak neve, a második oszlop a napszak kezdőidőpontja, a harmadik oszlop a napszak záróidőpontja, a negyedik oszlop tetszőleges megjegyzést tartalmazhat. A napszak kezdő- és záróidőpontok megadhatók ÓÓ:PP formában (abszolút óra:perc megadás), valamint PPPP (max. 4 számjegyes perc értékkel, kettőspont nélkül, relatív időpont megadás). A relatív időpont megadásával a napszak pontos időpontja a vércukormérőről beolvasott előző adat időpontjához képest relatívan számítódik. (ld. a 7. Relatív időszakok használata az RDAY.EXE programnál c. fejezetben). Tekintsük például a következő minta konfigurációs állományt: rdcont.csv ; Input file neve Reggel; 6:30; 8:15; Elso VC meres napszaka Délben; 11:45; 13:15; Masodik VC meres napszaka Este; 17:00; 18:45; Harmadik VC meres napszaka Éjjel; 21:20; 23:20; Negyedik VC meres napszaka Azaz, ezen minta konfigurációs állomány szerint az rdcont.csv állományt használjuk input állományként. A minta szerint naponta négyszer végzünk vércukormérést (4 db napszak definíció szerepel). A reggeli vércukormérés időpontja reggel fél hét (6:30) és negyed kilenc (8:15) közé esik, délben 11:45 és 13:15 között, este öt (17:00) és háromnegyed hét (18:45) között, s végül éjjel 21:20 és 23:20 között végzünk vércukormérést. 4/8
Ha ezen konfigurációs állományt használva lefuttatjuk az RDAY.EXE programot, akkor az aktuális könyvtárban kell lenni az rday.txt és a vércukormérőről beolvasott adatokat tartalmazó rdcont.csv állományoknak, s a program két output állományt fog létrehozni: rdcont_day.csv : Ez az állomány helyettesíti a diabétesz kezelésnél használatos vércukormérési naplót : Az állomány napszakokba tördelve tartalmazza a mérési eredményeket. Ha valamely napszakban nem történt vércukormérés, akkor azt üresen hagyja, ha esetleg egy napszakban több mérés is történt, akkor a napszakon belül az utolsó mérést írja az állományba. Az állomány egy sorában egy nap adatai jelennek meg a következő formátumban: A sor elején a nap dátuma (hónap, nap), majd utána két oszloponként a napszak adatok következnek: az első oszlop a napszakon belüli mérés időpontját (óra:perc), a második oszlop pedig a mért vércukor értéket tartalmazza. Az RDAY.EXE program lehetőséget ad arra, hogy ebből az állományból elhagyjuk az óra:perc értékeket (mivel általában a kézzel vezetett vércukormérési naplóban sem jegyezzük fel a mérés pontos időpontját). Ahhoz, hogy az óra:perc értékek kimaradjanak ebből az állományból a programot egy t opcióval kell indítanunk, azaz a parancssorban egy rday.exe -t parancsot kell kiadnunk. rdcont_day_all.csv : Ez az állomány az összes mérési eredményt tartalmazza, egy sorba rendezve az egy napon történt méréseket. Egy mérési eredmény két oszlopot foglal el: az első a mérés időpontja, a második a mért vércukor érték. Ebbe az állományba mindenképpen (a t opció használata esetén is) beíródnak a mérési időpontok (óra:perc értékek). 5/8
7. Relatív időszakok használata az RDAY.EXE programnál. A diabetesz kezelés során célszerű lehet az étkezés vércukoremelő hatását vizsgálni pl. oly módon, hogy megmérjük a vércukrot reggeli előtt, majd reggeli után kb. l 1,5 órával. Ezeket az étkezés utáni vércukor (VC) értékeket nem szabad összekeverni az étkezés előtti VC értékekkel, hiszen minden bizonnyal magasabbak az étkezés utáni értékek. Az ilyen eseteket az rday.txt állományban abszolút napszak időpontokkal nem tudjuk kezelni, hiszen ha pl. a reggeli előtti mérés napszaka viszonylag hosszú (az előzőekben vizsgált példában is ez a helyzet), akkor az étkezés előtti és étkezés utáni mérések összekeveredhetnek (az étkezés utáni mérések az étkezés előttre megadott időponthatárok közé eshetnek). Ennek a problémának a kezelésére vezettük be a relatív időszakok használati lehetőségét: A relatív időszak esetében az étkezést megelőző mérés időpontjához képest viszonyítva relatívan alakítható ki az étkezés utáni mérés időponthatára. A relatív időszakot az rday.txt konfigurációs állományban úgy jelöljük, hogy a napszak kezdő- és záróidőpontjának megadásakor nem óra:perc formátumot használunk, hanem kettőspont nélkül percben adjuk meg (az előző méréshez viszonyított) kezdő- és záróhatárt. Relatív időpontokkal definiált napszakot csak abszolút napszak definíció után használhatunk. Természetesen a relatív időszakok használata nem kötelező, tisztán abszolút időszakok használatával is működik a program. Az output állományokban semmilyen változást nem jelent a relatív időpontok használata. Tekintsük a következő (az rdcont.zip állományban letölthető) minta konfigurációs állomány tartalmát: rdcont.csv ; Input file neve Reggeli előtt; 6:30; 8:15; Reggeli elötti VC mérés Reggeli után; 60; 120; Reggeli után 60-120 perccel Ebéd előtt; 11:45; 13:15; Délben történö VC mérés Vacsora előtt; 17:00; 18:45; Esti VC mérés - vacsora elött Vacsora után; 70; 110; Vacsora után 70-110 perccel Éjjel; 21:20; 23:20; Éjszakai VC mérés idöpontja Azaz, a minta szerint a három főétkezés előtt végzünk vércukormérést, s esetlegesen reggeli után, vacsora után és éjszaka is mérünk. A reggeli előtti mérés időpontja fél hét és negyed kilenc közé esik (6:30; 8:15). A reggeli utáni mérés időpontját relatív időszakkal adjuk meg: a reggeli utáni mérést 60 120 perccel később végezzük, mint a reggeli előtti mérést. Hasonlóképpen, a vacsora előtti mérés este öt és háromnegyed hét közé esik, s a vacsora utáni mérést relatívan adjuk meg: A vacsora előtti mérés időpontja után 70 110 perccel végezzük a vacsora utáni mérést. A minta szerint ebéd előtt mérünk (11:45 13:15 között), de ebéd után nem mérünk vércukrot (nem adtunk meg ebéd utáni napszakot). Az éjszakai mérés 21:20 23:20 közé esik. Példaként tegyük fel, hogy reggeli előtt 6:45 kor, reggeli után pedig 8:10 kor mérünk. Ebben az esetben a 8:10 kor végzett mérés még beleesik a reggeli előtti mérés időszakába (6:30 8:15), de az RDAY program erről a mérésről látja, hogy ez 85 perccel később történt, mint a reggeli előtti mérés, azaz beleesik a reggeli utáni mérés relatív időszakába (60-120 perc), így ezt a mérést már a reggeli utáni mérések oszlopába fogja sorolni. 6/8
1. ábra RDCONT infra vevő kapcsolási rajza. 7/8
Az RDCONT készítésének története: Dátum Esemény 2005.05.20. Az RDCONT fejlesztésének megkezdése. 2005.10.15. Az RDCONT működő prototípusának elkészülte. 2006.03.10. Az RDCONT publikálása az interneten. 2006.04.03. Módosítások: Az output állományokba a számok elé és mögé nem íródik space, így (talán) a régebbi verziójú Excel-ek is közvetlenül beolvassák. A változtatás az RDCONT és az RDAY programot egyaránt érinti. Az rday.cf állományt átneveztük rday.txt névre, így könnyebben szerkeszthető. 2006.05.12. Módosítások: A program támogatja a Dcont Personal Optimum készülék használatát is. Az RDCONT.CSV állományban a Hibakod oszlop mutatja a méréskor felkiáltójellel törént megjelölést is. Dokumentáció frissítés. 2006.05.26. Módosítások: Javítás az RDCONT program -scan opciójának működésében és a képernyőkezelés módosítása (kiírja a web-címet is). Az RDAY program az output állomány nevét az input állomány neve után írt _day ill. _day_all kiegészítésekkel származtatja (korábban ezt az input állomány neve elé írtuk). A programok ezekkel a módosításokkal megfelelően működnek, s a fejlesztés egyéves születésnapja alkalmából a 2006.05.26. napon elkészült verziót tekintjük a hivatalos 1.00 verziónak. 2006.08.12. Módosítások: Az RDAY program t opcióval kihagyja a mérési időpontokat a _day kiegészítéssel képzett output állományból. Az rday.txt konfigurációs állományban relatív időpontok is megadhatók (azaz az előző mérés időpontjához viszonyíthatjuk a következő mérési időszakot). Dokumentáció frissítés. 2008.07.01. Módosítások: Javítás: az RDCONT program most már az új (módosított kommunikációs adatszerkezettel működő) Optimum készülékek adatainak beolvasására is képes. 8/8