Pobierz tutaj. - Biotechnologia.pl

LabMind Sp. z o.o.
ul. Południowa 25 b, 71-001 Szczecin
NIP 955-22-89-931
REGON 320853203
www.labmind.pl
tel. (91) 88-65-631, fax (91) 88-65-632
Instrukcja oprogramowania
2D
wersja 1.71
Oprogramowanie 2D służy do obsługi skanera 2D SBS, czyli dekodowania kodów
dwuwymiarowych umieszczonych na denkach fiolek. Program dekoduje kody w formacie TraXis,
Tracker i Datamatrix 12x12 lub 14x14.
1. Instalacja oprogramowania.
Oprogramowanie znajduje się na załączonym pendrive. Składa się z dwóch plików, sterownika
kamery (uEye32_*.exe albo uEye64_*.exe w zależności od systemu operacyjnego, 32 albo 64 bity)
i oprogramowania do obsługi skanera 2D_setup.exe
W pierwszej kolejności uruchamiamy sterownik kamery uEye*_* (np. uEye32_40200.exe).
Wybór składników tego oprogramowania jest dowolny, najważniejsze elementy to sterownik USB i
kontrolka ActiveX.
Następnie uruchamiamy 2D_setup.exe, zawierający pakiet programów 2D i 2Db.
2. Instalacja skanera.
Skaner posiada dwa kable, zasilania i transmisji USB. W dowolnej kolejności połączamy je do
gniazda 230V i gniazda USB w komputerze, pomyłka jest wykluczona konstrukcją wtyczek.
Po włączeniu kabla USB zgłosi się menadżer urządzeń systemu Windows, trzeba potwierdzić
instalację sterownika kamery.
Przed uruchomieniem programu 2D trzeba włączyć skaner za pomocą włącznika znajdującego się
na obudowie. Następnie klikamy na guzik [Start] w programie 2D i powinien być widoczny obraz z
kamery, co będzie oznaczało zakończenie instalacji z pełnym sukcesem.
3. Oprogramowanie 2D
Skanowanie kodów 2D fiolek odbywa się po uruchomieniu oprogramowania 2D, ustawieniu płytki
w skanerze i kliknięciu na guzik [Skan].
Pierwsze skanowanie może trwać dłużej i może wymagać powtarzania (np. włączając „Auto”), bo
skaner musi się „nauczyć” gdzie znajdują się fiolki z kodami. Zakończenie tego procesu
charakteryzuje się tym, że 100% fiolek jest zdekodowanych i na ekranie są widoczne tylko zielone
lub niebieskie fiolki.
Poniżej zrzut głównego okna po skanowaniu płytki TraXis.
Poniżej zrzut okna programu po skanowaniu Trackera.
a poniższy to DataMatrix 14x14.
Symboliczne barwy fiolek:
– zielona – skan i kontrola powiodła się w 100%
– niebieska – za pomocą korekcji błędów odczytano poprawnie kod fiolki
– fioletowa – brak fiolki
– czerwona – nie powiodło się odczytanie kodu 2D
– biała – nie powiodło się odczytanie kodu, ale z bardzo dużym prawdopodobieństwem fiolka
posiada kod odczytany z podręcznej bazy danych
Barwy fiolek zależą wyłącznie od stanu dekodowania kodu 2D, a nie zależą od typu kodu i ilości
fiolek na płytce. Inaczej mówiąc „barwienie” jest związane wyłącznie z dekodowaniem.
Zielona nie wymaga komentarza, po prostu pełny sukces.
Niebieska, wskazuje na problemy z odczytaniem kodu, najczęściej spowodowane
zanieczyszczeniem lustra lub szronem na denku fiolki. O ile szron powinien być automatycznie
usunięty poprzez sublimację, to z lustrem może być większy kłopot, bo należy je przetrzeć z kurzu.
Fioletowa oznacza brak fiolki lub brak przesłanek do obecności fiolki. Program nie stwierdził
obecności kodu na fiolce, czyli jeśli jest włączone skanowanie TraXis, a na skanerze leży płytka z
kodem Tracker, to 100% płytki będzie w kolorze fioletowym.
Czerwona, brak kodu. Najczęściej pojawia się po stwierdzeniu obecności fiolki z kodem i
jednocześnie błędnym odczytaniem kodu pomimo zastosowania korekcji błędów.
Biała, to kod odczytany z podręcznej bazy danych. Program sprawdza czy inne fiolki są
zdekodowane z sukcesem i dzięki temu określa płytkę. Na podstawie znanej płytki i położenia
fiolki odczytuje dane z podręcznej bazy danych.
4. Podgląd fiolki
Okienko podglądu jest widoczne po kliknięciu prawym klawiszem myszy na fiolkę (a dokładniej na
graficzną reprezentację płytki z prawej strony ekranu).
Tutaj można ustawić ręcznie optymalne położenie punktu skanowania, tj. środka kodu oraz
„zobaczyć” kod tak jak go „widzi” program.
Po zmianach położenia kodu za pomocą guzików [<-], ... [->] trzeba zapisać nowe położenie
klikając na [zapisz].
Opcja „log ?” włącza raportowanie do plików tekstowych, co jest potrzebne do diagnozowania
ewentualnych problemów lub optymalizacji działania oprogramowania. Proszę jej nie włączać, bo
znacznie spowalnia pracę programu.
5. Baza danych
Do programu włączono obsługę bazy danych, którą należy traktować jako bazę podręczną skanera.
Oprócz możliwości zapamiętywania zeskanowanych kodów 2D, które są przydatne po błędach
skanowania (biała fiolka), istnieje możliwość przypisania fiolce dodatkowych informacji. Te dane
są przypisane do konkretnego kodu 2D, czyli baza może obejmować wszystkie posiadane w
laboratorium próbki.
Z punktu widzenia obsługi:
1. program 2D umożliwia zapis do bazy w kolejności:
skan płytki –> skan kodu 1D płytki -> edycja szczegółowych danych fiolki
2. program 2Db pozwala na zmianę kolejności:
skan 1D płytki lub wybór z listy -> edycja szczegółowych danych fiolki
Dostęp do danych całej płytki jest możliwy poprzez wydruk lub zapis do pliku (wydruk do pliku).
Dane są przechowywane w bazie plikowej dbf, w formacie FoxPro, czyli można je odczytać –
importować do praktycznie dowolnego oprogramowania z pakietów MS Office (np. Excel)
i OO Office (np. Calc). Format dbf jest bardzo popularny od wielu lat.
Zaleca się aby nie modyfikować plików za pomocą innych programów, żeby ich po prostu nie
uszkodzić, a szczególnie nie zmienić indeksu.
Baza składa się z trzech plików:
XD_FIO – ewidencja fiolek
XD_NOT – notatki
XD_PLY – ewidencja płytek
6. Integracja
Skaner 2D można zintegrować z dowolnym urządzeniem i aplikacją za pomocą jednego z
interfejsów komunikacyjnych:
– DLL – integracja za pośrednictwem biblioteki 2D.dll
– RS232 – połączenie przez port transmisji szeregowej COM
– TCP/IP – połączenie poprzez sieć komputerową
– wiersz poleceń – uruchomienie 2D.exe z odpowiednimi opcjami
– plik 2D.ini – wymiana informacji w grupie [piloting]
W każdym interfejsie komunikacyjnym stosuje się identyczne polecenia, a ich składnia jest
podobna. Przykłady wykorzystania interfejsów umieszczono w pliku 2D.xlsm, gdzie za pomocą
VBA z poziomu Excel można sterować skanerem 2D.
7. Polecenia i funkcje interfejsów komunikacyjnych
Wszystkie interfejsy komunikacyjne bazują na tym samym zestawie poleceń. W każdym z nich jest
polecenie i odpowiedź.
Wykaz poleceń:
CAMSTART - start kamery
CAMSTOP - stop kamery
ADRNUM=T
ADRNUM=N
lub
lub
ADRNUMSET
ADRNUMRES
– włącz adresowanie pozycji numerycznie
– wyłącz adresowanie pozycji numerycznie
ADRVERT=T
ADRVERT=T
lub
lub
ADRVERTSET
ADRVERTRES
- włącz adresowanie w pionie
- wyłącz adresowanie w pionie
TRAXIS – włącz kodowanie TraXis
DATAMATRIX – włącz kodowanie DataMatrix
TRACKER – włącz kodowanie Tracker
ALPHA-NUM – włącz kodowanie alfa numeryczne
BLKROT=T
BLKROT=N
lub
lub
BLKROTSET
BLKROTRES
- włącz blokadę detekcji pozycji płytki
- wyłącz blokadę detekcji pozycji płytki
FRM=<format>
- ustaw format płytki SBS
gdzie <format> to ilość wierszy x ilość kolumn = {4x6, 6x8, 8x12, 12x16, 16x24}
SCAN
GET1D
GET2D
lub
SCAN=<plik>
- włącz skanowanie za pomocą kamery
lub z pliku
- pobierz kod 1D płytki
- pobierz listę kodów 2D płytki
Odpowiedź na polecenie, to z reguły „OK” albo „ERR” jeśli nie żądano jakiegoś wyniku jak np. w
poleceniu GET1D.
W przypadku zastosowania biblioteki 2D.dll można wykorzystać funkcję Cmd2D() lub funkcje
odpowiadające poleceniom, np. „BLKROTSET” odpowiada funkcja BlkRotSet()
Przykłady komunikacji znajdują się w pliku 2D.xlsm znajdującym się pakiecie instalacyjnym.
8. Rejestracja biblioteki 2D.dll w programie WinPrep JANUS PerkinElmer
Proszę skopiować pliki: 2D.dll, cavo2gui.dll, cavo2sys.dll i cavort20.dll do podkatalogu
C:\Packard\JANUS\BIN a następnie uruchomić wiersz poleceń.
W wierszu poleceń uruchamiamy polecenie rejestracji biblioteki w Windows, czyli
regsvr32 2D.dll
Następnie trzeba zmodyfikować lub utworzyć plik C:\Packard\JANUS\BIN\MSLEXT.csv,
który powinien zawierać następujące wiersze:
D2_Test, Test2D, 2D.dll, 9, i,,
D2_Cmd2D, Cmd2D, 2D.dll, 9, ppi,,
D2_Scan, Scan, 2D.dll, 9, ,,
D2_Traxis, Traxis, 2D.dll, 9, ,,
D2_Tracker, Tracker, 2D.dll, 9, ,,
D2_DataMatrix, DataMatrix, 2D.dll, 9, ,,
D2_BlkRotSet, BlkRotSet, 2D.dll, 9, ,,
D2_BlkRotRes, BlkRotRes, 2D.dll, 9, ,,
D2_Get1D, Get1D, 2D.dll, 9, pi,,
D2_Get2D, Get2D, 2D.dll, 9, pi,,
D2_Frm, Frm, 2D.dll, 9, p,,
D2_CamStart, CamStart, 2D.dll, 9, ,,
D2_CamStop, CamStop, 2D.dll, 9, ,,
D2_AdrNumSet, AdrNumSet, 2D.dll, 9, ,,
D2_AdrNumRes, AdrNumRes, 2D.dll, 9, ,,
D2_AdrVertRes, AdrVertRes, 2D.dll, 9, ,,
D2_AdrVertSet, AdrVertSet, 2D.dll, 9, ,,
gdzie D2_... nazwy funkcji widoczne w WinPrep, po nich nazwy funkcji w bibliotece 2D, kod
oznaczający typ zwracanej zmiennej i kody typów parametrów funkcji.
Przykład wykorzystania funkcji Scan w skrypcie WinPrep:
//-----------------------------------------------// Uf_scan2d()
//-----------------------------------------------int Uf_scan2d( // 0=Normal; 3=Abort; 12=Stop Procedure
char* pPCX ) // Address of procedure context information
{
int nRet = 0;
// Load return value into nRet
MP2_PROC_CONTEXT_DEF* pPC = pPCX; // Cast pPCX into local procedure context ptr
int nTst, nTim;
nTst=D2_Scan();
nTim=0;
while((nTim<40) && (nTst==0))
{
Sleep(250);
nTim=nTim+1;
nTst=D2_Scan();
}
if( nTim>=40)
MSL_MessageDialog(0,"title", "timeout", 0, 1, 1, 0);
return nRet;
}
// End of Uf_scan2d()
9. Test kodów
Program posiada procedury testowania i wyszukiwania tzw. „słabych” kodów 2D: Traxis i
Tracker/DataMatrix (przycisk Test). Kod początkowy i końcowy można zmodyfikować w pliku
2D.ini. Wyszukiwanie „słabych” kodów polega na znalezieniu takich kodów, które różnią się
niewiele, tj. np. do 2 bitów i ich sumy kontrolne różnią się niewiele, również do 2 bitów.
Informacje o znalezionych parach kodów są zapisywane do pliku 2D.ini. Na podstawie tych
danych program bardzo rygorystycznie sprawdza wyszczególnione kody 2D.
10. Rozwój
Firma LabMind systematycznie rozbudowuje oprogramowanie i poprawia właściwości skanera.
Zaleca się systematyczne aktualizowanie oprogramowanie za pomocą jednej z metod:
a) instalacja nowej wersji oprogramowania pobranego z http://www.labmind.pl/pliki/
b) pobieranie aktualizacji po kliknięciu na guzik koło [Exit] w oknie głównym
Uprzejmie prosimy o zgłaszanie wszelkich uwag i postulatów. Staramy się aby skaner 2D SBS był
jak najlepszy i spełniający wymagania wszystkich użytkowników.