Laboratorium wirtualne 1/Moduł 3 - ćwiczenie 3: Różnice pomiędzy wersjami
Nie podano opisu zmian |
Nie podano opisu zmian |
||
| Linia 361: | Linia 361: | ||
Na rysunku przedstawiono przykładową sytuację. Obszarem zainteresowania (przeznaczonym do powiększenia) jest czerwony prostokąt, ograniczony kursorami (niebieskim i zielonym). Prostokąt ten można opisać dwiema parami współrzędnych: <math>(X_{min}, Y_{min})\,</math> oraz <math>(X_{min}, Y_{min})\,</math> oznaczonych odpowiednio zielonymi kółkami. Dysponując współrzędnymi kursorów: pierwszego <math>(X_1,Y_1)\,</math> oraz drugiego <math>(X_2,Y_2)\,</math> należy wyznaczyć: <math>X_{min}\,</math> , <math>X_{max}\,</math> , <math>Y_{min}\,</math> oraz <math>Y_{max}\,</math> . Będą one potrzebne do przeskalowania osi <math>X\,</math> oraz <math>Y\,</math> ekranu z przebiegiem czasowym. Włączaniem i wyłączaniem powiększenia niech steruje przełącznik typu '''Binary Switch'''. Jeżeli <math>X_1=X_2</math> lub <math>Y_1=Y_2</math> wtedy należy dezaktywować przełącznik powiększenia. W funkcji CALLBACK tego przełącznika trzeba obsłużyć dwa przypadki: włączenie i wyłączenie powiększenia. W obu należy wykorzystać funkcję: | Na rysunku przedstawiono przykładową sytuację. Obszarem zainteresowania (przeznaczonym do powiększenia) jest czerwony prostokąt, ograniczony kursorami (niebieskim i zielonym). Prostokąt ten można opisać dwiema parami współrzędnych: <math>(X_{min}, Y_{min})\,</math> oraz <math>(X_{min}, Y_{min})\,</math> oznaczonych odpowiednio zielonymi kółkami. Dysponując współrzędnymi kursorów: pierwszego <math>(X_1,Y_1)\,</math> oraz drugiego <math>(X_2,Y_2)\,</math> należy wyznaczyć: <math>X_{min}\,</math> , <math>X_{max}\,</math> , <math>Y_{min}\,</math> oraz <math>Y_{max}\,</math> . Będą one potrzebne do przeskalowania osi <math>X\,</math> oraz <math>Y\,</math> ekranu z przebiegiem czasowym. Włączaniem i wyłączaniem powiększenia niech steruje przełącznik typu '''Binary Switch'''. Jeżeli <math>X_1=X_2</math> lub <math>Y_1=Y_2</math> wtedy należy dezaktywować przełącznik powiększenia. W funkcji CALLBACK tego przełącznika trzeba obsłużyć dwa przypadki: włączenie i wyłączenie powiększenia. W obu należy wykorzystać funkcję: | ||
'''int status = SetAxisScalingMode (int panelHandle, int controlID, int axis, int axisScaling, double min, double max);''' | |||
Pełny opis funkcji '''SetAxisScalingMode''' dostępny jest poprzez pomoc środowiska LabWindows/CVI. W tym celu należy wybrać menu '''Help -> Contents''' i po otworzeniu okna pomocy ze '''''Spisu treści''''' wybrać '''Library Reference -> User Interface Library -> Functions -> Alphabetical List of Functions -> SetAxisScalingMode.''' | |||
Funkcję tę należy wykonać osobno dla osi X i Y. Parametr '''axis''' dla osi X ustawić należy na '''bottom X axis''' dla osi Y musi to być '''left Y axis'''. Argument '''axisScaling''' należy ustawić następująco: dla włączenia powiększenia - '''manual;''' dla wyłączenia - '''auto'''. Działanie tego parametru wygląda następująco: '''manual''' - odczytuje współrzędne graniczne z pozycji '''Min''' oraz '''Max;''' tryb '''auto''' natomiast powoduje, że wyświetlany jest cały bufor danych taki jaki wyświetlony został funkcją '''PlotWaveform'''. Wartości '''Min''' oraz '''Max''' są ignorowane tym nie mniej nie wolno ich w funkcji opuścić. | |||
|} | |} | ||
| Linia 379: | Linia 387: | ||
'''if( stanPrzełącznika == 1)''' | '''if( stanPrzełącznika == 1)''' | ||
{ | |||
'''{''' | |||
:'''SetCtrlAttribute''' | :'''SetCtrlAttribute''' | ||
:'''................''' | :'''................''' | ||
} | |||
else | '''}''' | ||
{ | |||
'''else''' | |||
'''{''' | |||
:'''QuitUserInterface(0);''' | :'''QuitUserInterface(0);''' | ||
:'''//koniec programu (w tym przypadku zbędny jest przycisk''' | :'''//koniec programu (w tym przypadku zbędny jest przycisk''' | ||
:'''//KONIEC i przyporządkowana mu funkcja CALLBACK''' | :'''//KONIEC i przyporządkowana mu funkcja CALLBACK''' | ||
} | |||
'''}''' | |||
|} | |} | ||
Wersja z 23:32, 29 sie 2006
wersja beta
LABORATORIUM WIRTUALNE 1
Ćwiczenie 3 - Projekt wirtualnego oscyloskopu w środowisku LabWindows/CVI
|
|
|
Celem ćwiczenia jest stworzenie wirtualnego odwzorowania przyrządu pomiarowego jakim jest oscyloskop. Przyrząd taki swoją funkcjonalnością nie może odbiegać od rozwiązań spotykanych w aparaturze autonomicznej. Co więcej jako realizacja programowa - wirtualny oscyloskop nie może być pozbawiony możliwości rozbudowy posiadanych funkcji czy też adaptacji do indywidualnych potrzeb i wygód użytkownika końcowego. Wszystkie te cechy posiadają aplikacje pełniące funkcje przyrządów pomiarowych zaprogramowanych w środowisku LabWindows/CVI. |
|
Stworzyć nowy projekt i wybrać File -> New -> *.uir. |
|
W oknie edytora płyty czołowej wybrać Create -> Command Button i utworzyć przycisk: Koniec.
Parametry: Constant Name: KONIEC (DUŻE LITERY !) Callback Function: Zakoncz Control Mode: Hot
Wybrać z menu Create -> Graph -> Graph i utworzyć wyświetlacz oscyloskopowy. Parametry: Constant Name: PRZEBIEGT (DUŻE LITERY !) Callback Function: Control Mode: Indicator Label: Przebieg czasowy
Z menu: Code -> Preferences -> Default control events wybrać: EVENT_COMMIT, EVENT_VAL_CHANGED, EVENT_RIGHT_CLICK. Czynność ta ułatwi obsługę wybranych zdarzeń.
|
|
Z katalogu \cviXX\instr\ (XX - zastępuje numer wersji środowiska np.: 70 lub 80) skopiować do katalogu zadania pliki: scope.c, scope.h, scope.fp. Jeśli jest ustawiony atrybut Read Only to należy go usunąć. Oryginalny sterownik przesyła bufory z danymi o rozmiarze 100. Celową jest modyfikacja (dotyczy ona funkcji sterownika scope_read_waveform), dzięki której możliwe będzie uzyskanie wektora o rozmiarze - w dalszym ciągu będzie to rozmiar wynoszący 1024 elementy.
Włączyć pliki: *.c, *.uir, *.h oraz scope.fp do projektu. Nazwać i zapisać projekt. |
 
|
Po dodaniu do projektu pliku scope.fp w menu Instrument pojawi się pozycja Sample Oscilloscope, pod którą znaleźć można 4 funkcje wchodzące w skład sterownika symulującego oscyloskop:
scope_init - inicjuje połączenie z przyrządem. scope_config - konfiguruje nastawy oscyloskopu : numer kanału, wzmocnienie toru Y, podstawę czasu oraz tryb pracy (AC, DC, GND). scope_read_waveform - na podstawie dokonanych w poprzedniej funkcji nastaw z przyrządu wczytany zostaje wektor przebiegu czasowego. scope_close - kończy komunikację z przyrządem. Funkcję inicjującą najlepiej wywołać w programie jednorazowo w funkcji main a więc na samym początku działania programu: //Funkcję scope_init dobrze jest wywołać przed funkcją //DisplayPanel
DisplayPanel (panelHandle); Podobnie funkcję kończącą współpracę z przyrządem najlepiej wywołać w programie jednorazowo w funkcji main tym razem na końcu działania programu:
DiscardPanel (panelHandle); scope_close (); Funkcje scope_config oraz scope_read_waferom będą wywoływane “na żądanie” użytkownika programu.
#include ”scope.h” |
|
Zadeklarować w kodzie funkcję, której zadaniem będzie odświeżanie ekranu,
po każdorazowej zmianie nastaw poczynionych przez użytkownika: void Przerysuj(void); Delkaracja powinna się znajdować na początku kodu źródłowego. W pliku źródłowym umieścić definicję funkcji Przerysuj() : void Przerysuj(void) { } Definicję można umieścić w dowolnym miejscu w kodzie (poza ciałami innych funkcji !). Najlepiej jednak funkcję definicję Przerysuj() umieścić bezposrednio po funkcji main. W początkowej fazie programu będzie ona wywoływać funkcje symulatora oscyloskopu ze standardowymi parametrami i wyświetlać „odczytany” na ich podstawie przebieg czasowy.
Z menu Instrument -> Sample Oscillosope wybrać Configure (funkcja Przerysuj()) i z domyślnymi parametrami wstawić do kodu (wewnątrz funkcji Przerysuj())
Zdefiniować:
|
|
Po uruchomieniu program będzie wyglądał podobnie jak na ilustracji poniżej. |
|
Sprawdzić typ danych i zakres przyjmowanych wartości dla pierwszego parametru w funkcji scope_config (kursor umieścić na funkcji scope_config, klawiszami Ctrl+P wywołać panel funkcyjny; przejść do zmiennej Channel i klawiszem F1 wywołać okno pomocy, z którego można odczytać typ zmiennej i zakres dozwolonych wartości. Każdy argument funkcji scope_config posiada określony typ i zakres. W związku z tym typ definiowanej dla tego argumentu zmiennej musi być identyczny. Dodatkowo przełącznik znajdujący się na ekranie i przyporządkowany do danego parametru funkcji scope_config musi reprezentować zgodny z tym argumentem typ danych i posiadać dopuszczalny zakres przyjmowanych wartości.
int nrKanalu = 1; W edytorze płyty czołowej wybrać z menu Create -> Ring przełącznik służący zmianie kanału: Parametry: Constant Name: WYBORKANAL Callback Function: CzytajKanal Control Mode: Hot Label: Po przejściu do okna Label/Value Pairs... Wprowadzić pozycje przełącznika: Etykieta: Kanał 1 Kanał 2 Wartość: 1 2 Wartości te są zgodne z podanymi w pomocy do funkcji scope_config. Po wprowadzeniu wymaganych zmian należy (w edytorze płyty czołowej) prawym klawiszem myszy nacisnąć w obrębie nowego przełącznika i wybrać z menu kontekstowego: Generate Control Callback
GetCtrlVal (panelHandle, PANEL_WYBORKANAL, &nrKanalu); a po niej: Przerysuj(); Pozostało jeszcze podmienić pierwszy argument funkcji scope_config i scope_read_waveform z wartości stałej równej 1 na zmienną o nazwie nrKanalu. Uruchomiony program reaguje na zmianę wprowadzoną przez użytkownika. |
  
|
Prześledzić pozostałe argumenty funkcji scope_config i w sposób analogiczny do omówionego dla przypadku przełącznika kanałów dołączyć do programy pozostałe kontrolki:
wzmocnienie toru Y; wzmocnienie toru X - podstawa czasu; tryb pracy: AC, DC, GND. |
|
W funkcji Przerysuj(); po operacjach związanych z wyświetleniem przebiegu
w dziedzinie czasu należy wyznaczyć operacje mające na celu prezentację widma częstotliwościowego za pomocą funkcji: int status = ReFFT (double x[], double y[], int n); UWAGA! Funkcja wykonuje operacje “w miejscu” tzn. do argumentów zawierających pierwotnie dane wejściowe zapisywane są wyniki (dane wejściowe) funkcji. Funkcja ta pobiera jako dane wejściowe wektor wartości rzeczywistych (w ogólnym przypadku są to wartości zespolone umieszczone w dwóch wektorach) i liczbę elementów. x - wektor wej/wyj. Jako parametr wejściowy podaje się bufor zawierający analizowany sygnał. Jako parametr wyjściowy zawiera część rzeczywistą widma Fouriera. y - parametr wyjściowy zawierający część urojoną widma Fouriera. n - liczba elementów, która musi spełniać zależność .
|
|
Wartości widma zwracane są we współrzędnych kartezjańskich, a pożądaną postacią są współrzędne biegunowe, gdyż poszukiwana jest bezpośrednia postać widma amplitudowego.
Symbole na slajdzie: - wektor widma amplitudowego, - wektor widma fazowego. |
|
Konwersji do układu współrzędnych biegunowych dokonuje funkcja:
int status = ToPolar1D (double x[], double y[], int n, double mag[], double phase[]); x - wejściowy wektor zawierający część rzeczywistą transformaty Fouriera. y - wejściowy wektor zawierający część urojoną transformaty Fouriera. n - liczba elementów tablic wejściowych. mag - wektor wyjściowy zawierający widmo amplitudowe. phase - wektor wyjściowy zawierający widmo fazowe. Pełny opis funkcji ToPolar1D znajduje się w pliku advanlys.pdf (strona 2-395). |
|
Powyższą postać widma amplitudowego można już wyświetlić w oknie oscyloskopowym (powinno być to nowe dedykowane dla widma okno). Ponieważ jednak prezentacja widma w skali liniowej ma ograniczoną zdolność do wizualizacji szerokiego zakresu amplitud składowych harmonicznych widma, przydatne jest przeskalowanie widma do skali logarytmicznej. |
|
Operację przeskalowania opisuje równanie przedstawione na slajdzie gdzie:
UWAGA!! Aby uniknąć błędów pojawiających się przy próbie wyznaczania logarytmu dla argumentów: 0 oraz n/0 można dokonać sztucznego „zaszumienia” sygnału wejściowego w dziedzinie czasu. Poziom szumów niech wynosi do 1% amplitudy tego sygnału. |
|
Do wyświetlenia widma warto użyć funkcji PlotWaveform. W funkcji tej w pozycji Initial X należy wstawić wartość 0 (składowa stała). W pozycji X Increment, korzystając ze znajomości okresu próbkowania tpr należy wyznaczyć i umieścić wartość rozdzielczości widmowej: ; ( -częstotliwość próbkowania, - liczba próbek w widmie). Argument Plot Style należy ustawić na vertical bar.
UWAGA!! Ponieważ dla sygnałów rzeczywistych widmo jest symetryczne należy wyświetlać jedynie jego połowę |
 
|
Kursory są bardzo popularnym elementem składowym wyświetlaczy ekranowych współczesnej aparatury pomiarowej. Podstawowe ich funkcje wymienione są na slajdzie.
Wszystkie parametry związane z kursorami ustawia się w oknie edycyjnym ekranu oscyloskopowego, na którym mają one zostać umieszczone. Aby zdefiniować kursor należy przede wszystkim:
Włączenie kursorów następuje poprzez wybranie ich liczby (różnej od zera). Dostępne opcje pozwalają wybrać sposób wyświetlania kursora oraz tryb jego pracy:
|
 
|
Dla ekranu z przebiegiem czasowym należy zdefiniować 2 kursory. Po odczytaniu ich pozycji odpowiednie wartości wyświetlić w stosownych polach odczytowych (Numeric). Dodatkowo wyznaczyć wartości deltaX = abs(X1 - X2) oraz deltaY = abs(Y1 - Y2) i wyświetlić w dedykowanych polach odczytowych. Podobnie należy postąpić z ekranem prezentującym widmo i utworzyć 1 kursor. Po odczytaniu jego współrzędnych odpowiednie wartości wyświetlić w stosownych polach odczytowych (Numeric). Operację wyświetlania należy wykonać za pomocą znanej już funkcji SetCtrlVal. Jej opis znaleźć można w pomocy środowiska LabWindows/CVI. W tym celu należy wybrać menu Help -> Contents i po otworzeniu okna pomocy ze Spisu treści wybrać Library Reference -> User Interface Library -> Functions -> Alphabetical List of Functions -> SetCtrlVal.
int status = GetGraphCursor (int panelHandle, int controlID, int cursorNumber, double *x, double *y);
Jako identyfikator elementu (controlID) podaje się identyfikator ekranu oscyloskopowego, na którym znajduje się dany kursor; w polu cursorNumber podać należy numer kursora, którego pozycję funkcja ma odczytać. Wynik zwracany jest w zmiennych x oraz y (należy je zdefiniować). Kursory rozróżniane są jedynie po numerze. Dla każdego kursora należy wykonać osobne wywołanie funkcji GetGraphCursor i zdefiniować osobną parę zmiennych do przechowywania współrzędnych.
|
 
|
Dysponując odczytem pozycji 2 kursorów na ekranie z przebiegiem czasowym można uzyskać powiększenie wybranego fragmentu. Fragment ten określony jest przez odpowiednie współrzędne kursorów.
Na rysunku przedstawiono przykładową sytuację. Obszarem zainteresowania (przeznaczonym do powiększenia) jest czerwony prostokąt, ograniczony kursorami (niebieskim i zielonym). Prostokąt ten można opisać dwiema parami współrzędnych: oraz oznaczonych odpowiednio zielonymi kółkami. Dysponując współrzędnymi kursorów: pierwszego oraz drugiego należy wyznaczyć: , , oraz . Będą one potrzebne do przeskalowania osi oraz ekranu z przebiegiem czasowym. Włączaniem i wyłączaniem powiększenia niech steruje przełącznik typu Binary Switch. Jeżeli lub wtedy należy dezaktywować przełącznik powiększenia. W funkcji CALLBACK tego przełącznika trzeba obsłużyć dwa przypadki: włączenie i wyłączenie powiększenia. W obu należy wykorzystać funkcję: int status = SetAxisScalingMode (int panelHandle, int controlID, int axis, int axisScaling, double min, double max);
Funkcję tę należy wykonać osobno dla osi X i Y. Parametr axis dla osi X ustawić należy na bottom X axis dla osi Y musi to być left Y axis. Argument axisScaling należy ustawić następująco: dla włączenia powiększenia - manual; dla wyłączenia - auto. Działanie tego parametru wygląda następująco: manual - odczytuje współrzędne graniczne z pozycji Min oraz Max; tryb auto natomiast powoduje, że wyświetlany jest cały bufor danych taki jaki wyświetlony został funkcją PlotWaveform. Wartości Min oraz Max są ignorowane tym nie mniej nie wolno ich w funkcji opuścić.
|
|
Włączanie i wyłączanie przyrządu można zrealizować poprzez przełącznik dwupozycyjny typu Binary Switch. Wszystkie elementy panelu przyrządu, które użytkownik może nastawiać, przełączać, wybierać lub naciskać należy wcześniej zmodyfikować (nie dotyczy to włącznika). W oknach właściwości należy kolejno uaktywniać opcję Initially Dimmed. Spowoduje to, iż po uruchomieniu aplikacji wszystkie elementy z zaznaczonym wyżej parametrem nie będą aktywne (slajd 25 po lewej stronie). Aktywacji tych elementów można dokonać w ramach funkcji Callback przyporządkowanej do przełącznika dwupozycyjnego.
Operacji tej można dokonać przy użyciu funkcji SetCtrlAttribute, która służy do ustawiania właściwości elementów pulpitu użytkownika. Drugi jej argument powinien zawierać identyfikator elementu podlegającego zmianie. W trzecim właściwość, która ma być zmieniona. W czwartym zaś wartość tej właściwości. Zatem po rozwinięciu drzewa własności w polu trzeciego parametru w gałęzi Control Settings... odnaleźć i wybrać należy pozycję Dimmed. Korzystając z okna podpowiedzi dla parametru czwartego ustawić wartość aktywującą przycisk. (Należy pamiętać o wstawieniu funkcji do kodu) Pełny opis funkcji SetCtrlAttribute dostępny jest poprzez pomoc środowiska LabWindows/CVI. W tym celu należy wybrać menu Help -> Contents i po otworzeniu okna pomocy ze Spisu treści wybrać Library Reference -> User Interface Library -> Functions -> Alphabetical List of Functions -> SetCtrlAttribute. Wywołanie funkcji musi zostać powtórzone dla każdego składnika ekranu przyrządu, który miał ustawiony atrybut Initially Dimmed. Wartość początkową przełącznika powinno być 0 (Off). Po włączeniu (wartość 1) należy wywoływać dla każdego żądanego elementu funkcję SetCtrlAttribute. Funkcja Callback przyporządkowana dla „włącznika zasilania” może mieć postać instrukcji waunkowej if .... else . Schematyczny zapis tej instrukcji znajduje się poniżej: if( stanPrzełącznika == 1) {
} else {
} |
 
|
Identycznie do sposobu utworzenia przycisku Koniec utworzyć kolejny przycisk Zapis, którego naciśnięcie spowoduje zapis danych (wektora z wygenerowanymi próbkami przebiegu) do pliku. Pomocna będzie funkcja ArrayToFile (w menu Library: Formatting and I/O Library -> File I/O). Pełny opis funkcji SetCtrlAttribute dostępny jest poprzez pomoc środowiska LabWindows/CVI. W tym celu należy wybrać menu Help -> Contents i po otworzeniu okna pomocy ze Spisu treści wybrać Library Reference -> Formatting and I/O -> Alphabetical List of Functions -> ArrayToFile.
Dla sprawdzenia poprawności zapisu można utworzyć jeszcze jeden przycisk, tym razem o nazwie Odczyt (ustawienia takie jak dla przycisku Zapis) uaktywniany dopiero po zapisie danych. W funkcji callback stowarzyszonej z tym przyciskiem należy odczytać dane z pliku korzystając z FileToArray (w menu Library: Formatting and I/O Library -> File I/O). Wyświetlenie danych na ekranie odbywa się w omówiony już sposób. Rozważyć warto stworzenie nowego programu czytającego zapisane do pliku sygnały. Pełny opis funkcji SetCtrlAttribute dostępny jest poprzez pomoc środowiska LabWindows/CVI. W tym celu należy wybrać menu Help -> Contents i po otworzeniu okna pomocy ze Spisu treści wybrać Library Reference -> Formatting and I/O -> Alphabetical List of Functions -> FileToArray. Po odczytaniu danych z pliku należy je wyświetlić w dodatkowym ekranie oscyloskopowym. |
|
Środowisko LabWidows/CVI pozwala w bardzo szerokim zakresie rozbudować funkcjonalność przedstawionego przyrządu wirtualnego. Istnieje możliwość generacji złożonych sygnałów odkształconych a także sygnałów definiowanych przez użytkownika. Oprócz podstawowej analizy czasowej i częstotliwościowej istnieje możliwość cyfrowego przetwarzania sygnałów w oparciu o analizę czasowo-częstotliwościową np.: STFT czy analizę falkową. Dysponując odpowiednim sprzętem (karta DAQ lub interfejs GPIB) można dokonać akwizycji sygnałów rzeczywistych. |
