INSTRUKCJA OBSŁUGI PROGRAMU CSMPULPIT SYSTEMU PVS Spis treści: 1. Wstęp (do czego słuŝy program CSMPulpit) 2. Wersje programu CSMPulpit (Windows, Java, Mobile) 3. Licencje programu i ograniczenia 4. UŜytkowanie programu 5. Konfiguracja programu 5.1 Dodawanie przycisków 5.2 Dodawania submenu 5.3 Edycja 6. Rozwiązywanie problemów 7. Uwagi końcowe 1. Wstęp (do czego słuŝy program CSMPulpit) Program CSMPulpit słuŝy do obsługi systemu zarządzania multimediami PVS. Program ten ma charakter pulpitu sterowniczego, dedykowanego na komputery klasy PC, panele dotykowe oraz palmtopy, który to zapewnia pełną kontrole i sterowanie skonfigurowanego uprzednio systemu PVS. Program CSMPulpitJ jest wygodny i przyjazny uŝytkownikowi a takŝe przejrzysty i intuicyjny w konfiguracji. Program posiada dwa tryby pracy - tryb uŝytkowy (przeznaczony dla końcowego uŝytkownika który chce sterować salą, aulą itd) oraz tryb konfiguracyjny (przeznaczony dla osoby konfigurującej system PVS, instalatora który przygotowuje całość systemu do uŝytku). 2. Wersje programu CSMPulpit (Windows, Java, Mobile) Istnieją trzy wersje programu CSMPulpit: WIndows, Java oraz Mobile. Są one oznaczane skrótami literowymi odpowiednio W,J,M. Tworzy to nazwy końcowe programów oraz plików wykonywalnych: CSMPulpitW CSMPulpitJ oraz CSMPulpitM. Poza samą nazwą istnieją jeszcze wersje kodów kaŝdego rodzaju pulpitu w postaci dwóch liczb x_y gdzie x to numer wersji stabilnej a y numer wersji testowej danej wersji stabilnej. Zazwyczaj powinno się uŝywać stabilnych wersji programu. Wersja CSMPulpitW jest napisana w natywnym API Windows i nie wymaga do swojej pracy Ŝadnych dodatkowych bibliotek co czynią ją mało wymagającą od sprzętu i niezwykle łatwą w instalacji. Wersja ta pracuje na wszystkich systemach z rodziny Windows (9x/NT). Wersja ta została zamroŝona na pewnym etapie i nie jest dalej rozwijana. Wersja CSMPulpitJ jest napisana w języku Java i była testowana na systemach Windows oraz Linux. Jest nieco bardziej wymagająca względem instalacji (przede wszystkim naleŝy zainstalować środowisko uruchomieniowe Javy JRE) i względem moŝliwości sprzętowych systemu jednak umoŝliwia pracę niezaleŝnie od platformy sprzętowej i systemowej. Wersja ta ze względu na swą uniwersalna jest cały czas rozwijana i udoskonalana. Wersja CSMPulpitM jest napisana na platformę.net Mobile dla systemów takich jak Windows CE, WIndows Mobile i PocketPC. Wersja ta była projektowana dla Palmtopów pracujących pod tymi systemami i umoŝliwia wykorzystanie ich jako bezprzewodowych paneli dotykowych do sterowania systemem. Podobnie jak wersja CSMPulpitJ program ten jest rozwijany i udoskonalany. Ze względu na róŝnice w platformach systemowych i programistycznych kaŝdy z pulpitów posiada swój format plików konfiguracyjnych i nie są one ze sobą kompatybilne (nie moŝna bezpośrednio przenosić konfiguracji pomiędzy wersjami) Wszystkie powyŝsze wersje (nie licząc drobnych róŝnic) są identyczne uŝytkowo z tego względu w dalszej wersji dokumentu na wszystkie te wersje programu będziemy ogólnie mówić CSMPulpit
3. Licencje programu i ograniczenia Program CSMPulpit jest programem licencjonowanym i do jego legalnego uŝytkowania koniecznie jest posiadanie zakodowanego pliku licencyjnego. Licencja umoŝliwia korzystanie z programu na dowolnej ilości stanowisk. Program CSMPulpit posiada 3 poziomy licencjonowania: Standard, Classic oraz Full. RóŜnice w tych wersjach podsumowuje poniŝsza tabelka: Standard Klasyczna Pełna - obsługa tylko jednego portu COM - wiele portów COM przypisanych do przycisków - brak komunikacji LAN - komunikacja LAN - submenu moŝna dodać tylko na - moŝliwość ustalania pauzy czasowej głównym ekranie (ograniczenie na jeden przycisków (okno Proszę czekać + odliczanie) poziom) - moŝliwość nadawania nazw przyciskom - maksymalnie 100 przycisków na - brak ograniczenia na ilość i strukturę submenu jednym ekranie - brak ograniczenia na ilość przycisków - moŝliwość alternatywnego wysyłania dwóch numerów w obrębie jednego przycisku - całkowity brak submenu (tylko jeden ekran) - maksymalnie 100 przycisków - moŝliwość uŝytkowania tylko jednego portu COM - brak komunikacji LAN - brak funkcji Wypisz - obecna sygnalizacja dźwiękiem 4. UŜytkowanie programu Z punktu widzenia uŝytkownika program obsługuję się za pomocą zwyczajnych kliknięć na widoczny uŝytkownikowi ekran. Ekran ten moŝe być dowolnym obrazkiem, rysunkiem, schematem, zestawem przycisków itd - słowem dowolną bitmapą. W zaleŝności od inwencji osoby konfigurującej system uŝytkowanie programu moŝe być mniej lub bardziej intuicyjnej. Ze względu na dowolność konstrukcji interfejsu bardzo trudno jest wyznaczyć zasady uŝytkowania programu. UŜytkownik powinien być jednak świadomy iŝ podstawowymi elementami występującymi w programie są mena i przyciski umieszczone na danych menu. Przez menu rozumiemy dany ekran natomiast przycisk jest to obszar po naciśnięciu którego następuje jakaś akcja (przejście do innego menu, wysłanie polecenia lub oba naraz). Kliknięcia dokonuje się dowolnym urządzeniem wskazującym wyposaŝonym w funkcję klikania (np myszka lub panel dotykowy). W kaŝdej wersji programu pulpit dostępne jest popup-menu które umoŝliwia wybranie dodatkowych funkcji i ustawień. W zaleŝności od urządzenia wskazującego jest ot prawy przycisk myszki lub długie przytrzymanie (np w ekranach dotykowych). W kaŝdej wersji obowiązuje teŝ aktywny przycisk klawiatury ESC lub BackSpace słuŝący do powrotu do poprzedniego ekranu jednak w poprawnie skonstruowanym interfejsie powinny być dostępne przyciski powrotu do głównego menu. 5. Działanie programu Program pulpit niezaleŝnie od wersji i systemu składa sie z programu głównego, plików konfiguracyjnych, plików graficznych, głównego ekranu main. W zaleŝności od systemu w skład programu naleŝy zaliczyć odpowiednie sterowniki i biblioteki (np do obsługi RS232 w Javi'ie). Program główny jest to jeden wykonywalny plik który moŝna uruchomić w danym systemie. W systemach Windows oraz Windows Mobile są to pliki z rozszerzeniem exe. W przypadku wersji programu opartej na języku Java jest to plik z rozszerzeniem jar i naleŝy go uruchomić poprzez interpreter języka Java JRE. Zaraz po uruchomieniu program ładuje tło dla głównego ekranu z pliku main.bmp. Plik main.bmp musi zawsze być obecny w przeciwnym razie program nie będzie się mógł uruchomić. Tło ekranu głównego musi mieć zawsze nazwę main.bmp. Program dostosowuje wymiary swojego okna do rozmiarów pliku main.bmp. Wszystkie kolejne submenu posiadają tła w osobnych plikach bmp a ich nazwy mogą być dowolne. Definicje przycisków (konfiguracja) danego submenu zapisywana jest w pliku o tej samej nazwie co submenu i opatrzona jest rozszerzeniem cfg. Kliknięcie na zdefiniowany obszar powoduje Ŝe program wykonuje zdefiniowany procesie konfiguracji operacje (wysłanie polecenie, przejście do innego submenu, wykonanie programu itd)
6. Konfiguracja programu Konfiguracja programu pulpit jest to proces w którym decydujemy jak będzie zbudowany interfejs uŝytkowy programu. Za pomocą tej funkcji przy uŝyciu programu pulpit moŝemy wewnątrz niego samego zdefiniować wszystkie menu, właściwie umieścić przyciski oraz wybrać odpowiednie bitmapy tła. Wejście do procesu konfiguracji odbywa się za pomocą wywołania popup menu (prawi klawisz myszy lub inna funkcja w zaleŝności od urządzenia wskazującego). W otworzonym popup menu naleŝy wybrać opcję Konfiguracja. Następnie program poprosi o podanie właściwego hasła. Hasło funkcji konfiguracji jest tajne. Po podaniu właściwego hasła otworzy sie okno Konfiguracji umoŝliwiające dodanie przycisku, submenu, usuwanie przycisku i submenu oraz ich edycję. W Programie CSMPulpitM ze względu na ograniczenia ekranowe nie otwiera się nowe okno lecz w Menu głównym programu aktywują się odpowiednie funkcje.
6.1 Dodawanie przycisków Dodawanie przycisku rozpoczynamy poprzez kliknięcie na Dodaj przycisk w oknie konfiguracji. Wchodzimy tym samym w tryb dodawania przycisku. Następnie rysujemy przycisk na aktualnie widocznym menu interfejsu programu w głównym oknie przytrzymując przycisk myszy. Przycisk stanowi prostokątne pole narysowane za pomocą myszy jak w zwykłym programie graficznym. Po narysowaniu obszaru graficznego otworzone zostanie okno z edycją parametrów nowego przycisku. Dostępne są następujące parametry: Numer polecenia 1 - jest to numer polecenia w systemie które ma zostać wykonane przez jednostkę centralną. W zaleŝności od skonfigurowania jednostki centralnej moŝe to być jedno polecenie lub cały zestaw poleceń Numer polecenia 2 - jeśli numer ten ma inną wartość niŝ numer polecenia 1 to jest ona naprzemiennie wysyłany w czasie jednej sesji programu pulpit. Do tego samego przycisku moŝemy przypisać dwa róŝne numery poleceń dzięki czemu moŝna realizować w jednym przycisku przełącznik ON-OFF. Opcja ta powinna być połączona z właściwym skonfigurowaniem jednostki centralnej i opcji poleceń negacyjnych wraz z zapamiętywaniem stanu przez jednostkę Obraz 1 - do przycisku moŝna przypisać jego własny obraz wyświetlany w samym obszarze przycisku. Obraz ten będzie wyświetlany wtedy gdy będzie miało nastąpić wysłanie polecenia numer 1 Obraz 2 - analogicznie jak parametr Obraz 1 tak i w tym przypadku moŝna zdefiniować obraz przycisku przypisany do wysyłania polecenia 2. Obie te opcje słuŝą do stworzenia np wciskających i wyciskających się przycisków Nazwa przycisku - Identyfikator przycisku i jednocześnie nazwa wyświetlana w czasie działania programu w oknie Proszę czekać jeśli tylko czas oczekiwania został zdefiniowany powyŝej wartości 0 Numer portu COM (RS232) - numer portu komunikacyjnego przez który następuje komunikacja z jednostką centralną. W przypadku programu CSMPulpitW naleŝy podać sam numer portu 1,2... 9 natomiast w przypadku programu CSMPulpitJ naleŝy wpisać pełną nazwę duŝymi literami np COM1 czy COM7. W systemie Linux nazwy portów to zazwyczaj /dev/ttys0 lub /dev/ttys1 natomiast w przypadku korzystania z adapterów USB będzie to najprawdopodobniej /dev/ttyusb0 lub /dev/ttyusb1 Adres IP (LAN) - jeśli jednostka centralna jest podłączona do tej samej sieci LAN co komputer to istnieje moŝliwość komunikacji poprzez tą sieć jak równieŝ w przypadku
obecności AccessPointów poprzez sieć WiFi (szczególnie przydatne w sytuacji korzystania z programu pulpit na palmtopach) Port TCP/IP - port TCP/IP przez który ma następować komunikacja w sieci LAN. Domyślna wartość to 4001. Wszelkie inne wartości wymagają właściwej konfiguracji jednostki centralnej oraz sprzętu sieciowego. Czas oczekiwania przy wysłaniu - czas przez jaki ma być wyświetlane okno Proszę czekać i tym samym czas przez jaki program ma być zablokowany na działania uŝytkownika. Opcja bardzo przydatna podczas wykonywania poleceń Makro Kształt przycisku - Obecnie dostępne tylko w wersji CSMPulpitW. UmoŜliwia wybranie innego niŝ prostokątny kształtu przycisku. Przydatne przy budowie ciasnych interfejsów które zbudowane są na bazie Skrót do programu - Wybranie w tym miejscu dowolnego pliku (czy to skrótu do programu czy np pliku JPG) spowoduje uruchomienie samego programu lub teŝ otwarcie pliku domyślnym programem. Opcja ta jest przydatna jeśli pod wpływem sterowania z poziomu programu komputer ma wykonać dodatkowe czynności. 6.2 Dodawania submenu Dodawanie subemnu wygląda w sposób identyczny jak dodawanie przycisku z tym Ŝe po narysowaniu obszaru najpierw musimy wskazać plik BMP który ma stanowić tło kolejnej planszy w interfejsie uŝytkownika. Następnie przechodzimy do okna definiowania parametrów submenu które zawiera analogiczną listę parametrów jak w przypadku przycisku. Dostępne są następujące parametry: Numer polecenia 1 - jest to numer polecenia w systemie które ma zostać wykonane przez jednostkę centralną. W zaleŝności od skonfigurowania jednostki centralnej moŝe to być jedno polecenie lub cały zestaw poleceń Numer polecenia 2 - jeśli numer ten ma inną wartość niŝ numer polecenia 1 to jest ona naprzemiennie wysyłany w czasie jednej sesji programu pulpit. Do tego samego przycisku moŝemy przypisać dwa róŝne numery poleceń dzięki czemu moŝna realizować w jednym przycisku przełącznik ON-OFF. Opcja ta powinna być połączona z właściwym skonfigurowaniem jednostki centralnej i opcji poleceń negacyjnych wraz z zapamiętywaniem stanu przez jednostkę Włączone wysyłania polecenia - zaznaczenie tej opcji powoduje iŝ przed faktycznym przejściem do submenu nastąpi wysłanie zdefiniowanego polecenia Nazwa przycisku - Identyfikator przycisku i jednocześnie nazwa wyświetlana w czasie działania programu w oknie Proszę czekać jeśli tylko czas oczekiwania został zdefiniowany powyŝej wartości 0
Numer portu COM (RS232) - numer portu komunikacyjnego przez który następuje komunikacja z jednostką centralną. W przypadku programu CSMPulpitW naleŝy podać sam numer portu 1,2... 9 natomiast w przypadku programu CSMPulpitJ naleŝy wpisać pełną nazwę duŝymi literami np COM1 czy COM7. W systemie Linux nazwy portów to zazwyczaj /dev/ttys0 lub /dev/ttys1 natomiast w przypadku korzystania z adapterów USB będzie to najprawdopodobniej /dev/ttyusb0 lub /dev/ttyusb1 Adres IP (LAN) - jeśli jednostka centralna jest podłączona do tej samej sieci LAN co komputer to istnieje moŝliwość komunikacji poprzez tą sieć jak równieŝ w przypadku obecności AccessPointów poprzez sieć WiFi (szczególnie przydatne w sytuacji korzystania z programu pulpit na palmtopach) Port TCP/IP - port TCP/IP przez który ma następować komunikacja w sieci LAN. Domyślna wartość to 4001. Wszelkie inne wartości wymagają właściwej konfiguracji jednostki centralnej oraz sprzętu sieciowego. Czas oczekiwania przy wysłaniu - czas przez jaki ma być wyświetlane okno Proszę czekać i tym samym czas przez jaki program ma być zablokowany na działania uŝytkownika. Opcja bardzo przydatna podczas wykonywania poleceń Makro Kształt przycisku - Obecnie dostępne tylko w wersji CSMPulpitW. UmoŜliwia wybranie innego niŝ prostokątny kształtu przycisku. Przydatne przy budowie ciasnych interfejsów które zbudowane są na bazie Skrót do programu - Wybranie w tym miejscu dowolnego pliku (czy to skrótu do programu czy np pliku JPG) spowoduje uruchomienie samego programu lub teŝ otwarcie pliku domyślnym programem. Opcja ta jest przydatna jeśli pod wpływem sterowania z poziomu programu komputer ma wykonać dodatkowe czynności. Hasło - umoŝliwia zbudowanie interfejsu o róŝnym stopniu dostępu do submenu. W zaleŝności od znajomości hasła przez uŝytkownika będzie on mógł wejść do tak zdefiniowanego submenu jeśli poda prawidłowe hasło.
6.3 Edycja Tryb edycji umoŝliwia zmianę parametrów zdefiniowanych juŝ przycisków i submenu. Z okna Konfiguracji wybieramy przycisk Edycja i przechodzimy tym samym w stan edytowania. Następnie klikamy na przycisk lub subemnu który chcemy edytować. Po tej operacji zachowanie programu będzie identyczne jakbyśmy dodawali nowy przycisk lub submenu z tym Ŝe w oknie parametrów będę wpisane parametry edytowanego przycisku. Zmiana parametrów i potwierdzenie tego faktu przyciskiem spowoduje Ŝe w konfiguracji interfejsu wpisane zostaną odpowiednie zmiany 7. Rozwiązywanie problemów Najczęstszym problem są problemy komunikacyjne. W sytuacji błędów z portem COM naleŝy upewnić sie co do oprogramowania lub zajmowania portu przez inny program. Istnieją teŝ sytuacje w których porty COM są blokowane przez administratorów systemu. TakŜe korzystając z adapterów USB<- >RS232 naleŝy szczególną uwagę poświęcić na prawidłowe zainstalowanie sterowników. 8. Uwagi końcowe PowyŜsza instrukcja dotyczy trzech róŝnych wersji tego samego uŝytkowo programu. Dodatkowo programy te mogą być zainstalowane na trzech zupełnie róŝnych platformach sprzętowych i systemowych. Utrudnia to bardzo napisanie jednocześnie dokładnej i uniwersalnej instrukcji. Co więcej trudno jest teŝ zadbać o to Ŝeby uŝytkowo programy te były jak najmniej odmienne. PowyŜsza instrukcja opisuje zatem idee obsługi programu Pulpit a nie stanowi szczegółowego opisu operacji jakie moŝna na nim wykonywać