INFORMATOR TECHNICZNY WONDERWARE Informator Techniczny nr 60 04-12-2002 Podstawy wykorzystania bibliotek DLL w skryptach oprogramowania InTouch Wstęp PoniŜsza dokumentacja oparta na przykładach stworzonych w środowisku Visual C++ przedstawia etapy postępowania w celu stworzenia i wykorzystania biblioteki DLL w skryptach oprogramowania InTouch. Omówienie Bibliotekami DLL, które mogą być wykorzystane w skryptach oprogramowania InTouch są regularne biblioteki DLL gdyŝ w porównaniu z innymi typami bibliotek tylko te eksportują funkcje z biblioteki DLL, a nie z klas C++. Proces tworzenia regularnej biblioteki DLL rozpoczynamy od utworzenia nowego projektu określając typ projektu jako MFC AppWizard (dll). W oknie kreatora biblioteki DLL określamy jej typ jako bibliotekę regularną. Wybór projektu biblioteki DLL w Kreatorze aplikacji. ASTOR Sp. z o.o. Dział Oprogramowania Przemysłowego ul. Smoleńsk 29, 31-112 Kraków tel.: 012 428-63-30 fax: 012 428-63-09 e-mail: wonderware1@astor.com.pl http://www.astor.com.pl
Określenie typu biblioteki DLL. Po utworzeniu podstawowej powłoki biblioteki, tworzymy nową klasę typu Generic, w której umieszczamy funkcje biblioteczne. W celu eksportowania zbudowanych funkcji naleŝy zadeklarować je jako funkcje eksportowe, stosując następującą konstrukcję : extern C <typ funkcji> PASCAL EXPORT <deklaracja funkcji> NaleŜy tego dokonać zarówno w prototypie funkcji w pliku nagłówkowym (.h) jak i w pliku kodu źródłowego (.cpp). Ponadto naleŝy wyeliminować w kodzie źródłowym stworzonej klasy konstruktor i destruktor, zaś w pliku nagłówkowym kaŝdy ślad rzeczywistej klasy, pozostawiając jedynie wywołania funkcji. Modyfikacje te przedstawiają poniŝsze przykłady. Kod źródłowy klasy mocczynnatg. Przykład funkcji zwracającej wartość mocy czynnej Turbogeneratora. // mocczynnatg.cpp: implementation of the mocczynnatg class. // #include "stdafx.h" #include "mocczynna.h" #include "mocczynnatg.h" #ifdef _DEBUG #undef THIS_FILE static char THIS_FILE[]= FILE ; #define new DEBUG_NEW #endif 2
// Construction/Destruction //mocczynnatg::mocczynnatg() // //mocczynnatg::~mocczynnatg() // extern "C" float PASCAL EXPORT mocczynnatg(float k1,float k2, int Q_MPEC, int Q_STOMIL, int Q_STAB, int Q_3_0, int Q_1_7, int Q_0_8) { int Q_CO,Q_TECH; Q_CO=Q_MPEC+Q_STOMIL+Q_STAB; Q_TECH=Q_3_0+Q_1_7+Q_0_8; return (k1*q_co+k2*q_tech); Plik nagłówkowy klasy mocczynnatg // mocczynnatg.h: interface for the mocczynnatg class. // #if!defined(afx_mocczynnatg_h 6DC3A3BA_C943_11D6_9B77_0080C8F63767 INCLUDED_) #define AFX_MOCCZYNNATG_H 6DC3A3BA_C943_11D6_9B77_0080C8F63767 INCLUDED_ #if _MSC_VER > 1000 #pragma once #endif // _MSC_VER > 1000 //class mocczynnatg //public: // mocczynnatg(); // virtual ~mocczynnatg(); //; extern "C" float PASCAL EXPORT mocczynnatg(float k1,float k2, int Q_MPEC, int Q_STOMIL, int Q_STAB,int Q_3_0, int Q_1_7, int Q_0_8); #endif //!defined(afx_mocczynnatg_h 6DC3A3BA_C943_11D6_9B77_0080C8F63767 INCLUDED_) 3
Po skompilowaniu klasy, naleŝy zmodyfikować plik DEF projektu biblioteki dodając do niego wszystkie nazwy wyeksportowanych funkcji, tak jak na poniŝszym przykładzie: ; mocczynna.def : Declares the module parameters for the DLL. LIBRARY "mocczynna" DESCRIPTION 'mocczynna Windows Dynamic Link Library' EXPORTS ; Explicit exports can go here mocczynnatg Po zbudowaniu biblioteki DLL naleŝy stworzyć plik z rozszerzeniem wdf. Dzięki temu plikowi WindowMaker jest w stanie rozpoznać stworzoną bibliotekę DLL. Plik ten specyfikuje sekwencje wywołania funkcji, informacje o pliku pomocy oraz informacje o przekazaniu połączenia. Plik ten tworzy się korzystając z programu Crypt.exe zawartego w Extensibility Toolkit przy pomocy wejściowego pliku definicji (.idf).komenda tworząca plik wdf wygłąda następująco: CRYPT <infile>.idf <outfile>.wdf /e Dokładny opis tworzenia pliku idf zawarty jest w rozdziale 9 Wonderware Extensibility Toolkit Users Guide. PoniŜej został przedstawiony streszczony opis tworzenia pliku idf na bazie zbudowanej biblioteki mocczynna.dll. Plik typu idf składa się przede wszystkim z ciągu nazw wywołań, plików, flag, bibliotek, funkcji, sposobu przesyłania argumentów funkcji oraz typów samej funkcji jak i jej argumentów. Komentarze w pliku idf zaznaczone są znakiem średnika ;. Przykładowy plik idf wygląda następująco: ; ; mocczynna.idf ; Version=1,,,- puste miejsca oddzielone przecinkiem i spacją ; tu wpisuje się nazwę pliku pomocy i jego parametry. MocCzynnaTg,,,0,0x08000028,pastemocczynnaTg,MOCCZYNNA,MOCCZYNNA, mocczynnatg,pascal,float,float,float,int,int,int,int,int,int typ zwracany typy argumentów funkcji Opis nazw: MocCzynnaTg dowolna nazwa reprezentująca daną funkcję biblioteczną w zestawieniu wszystkich dostępnych skryptów w InTouch u. 0 oznacza iŝ dana funkcja będzie zwracać jakąś wartość; dla void stosuje się 1. 0x08000028 zestaw flag, młodsze słowo zawiera informacje gdzie i w jaki sposób dana funkcja moŝe być uŝyta, starsze słowo zawiera informacje dotyczące rodzaju skryptu do jakiego ma być dana funkcja przypisana np. Math Function. pastemocczynnatg nazwa funkcji przekazująca krótką definicję danej funkcji. MOCCZYNNA nazwa biblioteki DLL zawierająca funkcję pastemocczynnatg. mocczynnatg nazwa wykorzystywanej funkcji z biblioteki DLL. PASCAL sposób przekazywania argumentów funkcji. 4
Funkcja przekazująca definicję danej funkcji ma za zadanie w momencie wybrania jej przez uŝytkownika ze zbioru dostępnych skryptów wyświetlić zbiór argumentów uŝywanych przez daną funkcję. Dzięki uŝyciu makra MAKELONG definiuje się długość podświetlanego tekstu w definicji danej funkcji. Funkcja pastemocczynnatg mieści się w pliku kodu źródłowego klasy mocczynnatg. Jej postać jest następująca: extern "C" long PASCAL EXPORT pastemocczynnatg(lpstr funcname, LPSTR result ) { long hilite=0; lstrcpy( result, funcname ); if( lstrcmpi(funcname, "MocCzynnaTg") == 0 ) { lstrcat( result, " (k1,k2,q_mpec,q_stomil,q_stab,q_3_0,q_1_7,q_0_8);" ); hilite = MAKELONG(11,19); return( hilite ); NaleŜy pamiętać o zadeklarowaniu tej funkcji w pliku nagłówkowym mocczynnatg.h extern "C" long PASCAL EXPORT pastemocczynnatg(lpstr funcname, LPSTR result ); oraz o dodaniu jej nazwy do pliku DEF. Po ponownym skompilowaniu i zbudowaniu biblioteki mocczynna.dll oraz po utworzeniu na podstawie biblioteki i pliku mocczynna.idf pliku mocczynna.wdf uzyskuje się kompletne narzędzie do zastosowania we skryptach oprogramowania InTouch. Aby dana funkcja ze zbudowanej biblioteki DLL była widoczna we skryptach środowiska InTouch naleŝy pliki mocczynna.dll oraz mocczynna.wdf skopiować do głównego katalogu InTouch. Po kaŝdej modyfikacji funkcji w bibliotece DLL zaleca się ponowne utworzenie pliku wdf, po czym całość (tzn. plik wdf i bibliotekę DLL) skopiować do katalogu InTouch i ponownie uruchomić środowisko InTouch. 5