========================================================================
         Besipiel-Applikation fr W&T Digital-E/A per TCP/IP       
========================================================================


1. Einleitung
-------------

Dieses Programm demonstriert die Ansteuerung der W&T Digital-E/A-Server
(Typnummern 50210, 50211, 50310, 50311) ber Windows Sockets. Es ist fr
Visual C++ und die Microsoft Foundation Classes (MFC) geschrieben. Die 
folgenden Hinweise richten sich auch hauptschlich an MFC-Programmierer. 
Die CDeaServ-Klasse, die die eigentliche Gerteansteuerung enthlt, sollte
sich aber auch ohne grere Probleme in Windows-Programmen ohne MFC 
wiederverwenden lassen.

Die Socket-Klassen der MFC-Bibliothek werden *nicht* benutzt. Die CSocket-
Klasse wrde Multithread-Programmierung erforderlich machen, und auch die
CAsyncSocket-Klasse ist zwar ganz hbsch (sammelt asynchrone Winsock-
Benachrichtigungen ber unsichtbare Fenster ein und verteilt sie auf 
OnXxx()-Callbacks), hat aber zwei Probleme: 

 - Die Funktionsweise ist nicht wirklich komplett asynchron. Die 
   Namensauflsung erfolgt synchron, und das kann beim Versuch, einen 
   nicht existierenden Namen ber DNS aufzulsen, eine Anwendung mehrere 
   Sekunden lang komplett blockieren.
 - Beim Schlieen eines Sockets, fr das Connect() aufgerufen wurde, das 
   aber noch keine OnConnect()-Benachrichtigung erzeugt hat, strzt MFC 
   unntigerweise ab (dereferenziert einen NULL-Zeiger). Der vergleichbare
   Vorgang bei reiner Winsock-Programmierung ist dagegen vllig 
   unproblematisch.



2. Benutzung der CDeaServ-Klasse
--------------------------------


2.1. Konstruktion und Initialisierung
-------------------------------------

Im Konstruktoraufruf wird der E/A-Server definiert, zu dem die Verbindung 
hergestellt werden soll. Die bergebenen Informationen entsprechen im 
wesentlichen den Eingaben, die man im Endgerte-Dialogfeld dieses 
Beispielprogramms vornehmen kann.

Bei Verbindungsaufbau ber Activate() mu noch ein Fenster angegeben 
werden, das die Aufgabe hat, die asynchronen Winsock-Benachrichtigungen 
zu verabeiten. Wie das geht, steht im nchsten Abschnitt.


2.2. Pflichten des aufrufenden Programms
----------------------------------------

Da die Winsock.dll benutzt wird, mu in InitInstance() ein Aufruf von 
AfxSocketInit() erfolgen.

Das bei Activate() angegebene Fenster mu nach den benutzerdefinierten 
Message-Typen DM_SOCKEVENT und DM_HOSTRESOLVED Ausschau halten und sie 
an die CDeaServ-Klasse zur Verarbeitung weiterreichen. MFC-Programmierer 
berladen zu diesem Zweck am besten CWnd::WindowProc(). Angenommen, das 
bergebene Window-Handle war CMyMainDlg::m_hWnd, sieht das ungefhr so 
aus:

LRESULT CMyMainDlg::WindowProc(UINT message, WPARAM wParam, LPARAM lParam) 
    {
    switch( message )
        {
        case DM_SOCKEVENT:
        case DM_HOSTRESOLVED:
            CDeaServ::MessageHandler( message, wParam, lParam );
            return TRUE;
        }
	return CDialog::WindowProc( message, wParam, lParam );
    }

Dieselbe statische Memberfunktion aus CDeaServ mu auch alle 100 ms mit 
einer WM_TIMER Message aufgerufen werden. Das geht z. B., indem man fr 
das eigene Fenster einen Timer mit SetTimer( 1, 100, NULL ) abonniert und 
dann OnTimer() wie folgt definiert:

void CMyMainDlg::OnTimer( UINT nIDEvent ) 
    {
	CDeaServ::MessageHandler( WM_TIMER, 0, 0 );
    }


2.3. Und was hat man nun davon?
-------------------------------

Vereinfacht gesagt: die Membervariable CDeaServ::m_drvState ist ein 
Prozeabbild des E/A-Servers, das durch Polling in einem 
benutzerdefinierten Zeitraster und durch automatische Benachrichtigungen 
aktuell gehalten wird. Auf den Inhalt kann man sich so lange verlassen, 
wie m_nConnState==CS_READY eine strungsfreie Verbindung anzeigt. ber 
(mgliche) nderungen wird man durch DM_UPDATED-Messages informiert.

Die aufgebaute Verbindung zum E/A-Server ist relativ robust, in dem Sinne,
da bei Neustart des E/A-Servers (durch Reset-Taste oder vorbergehenden
Spannungsausfall) die TCP-Verbindung automatisch neu aufgebaut wird, und
auch der Zustand seiner Ausgnge wird, soweit bekannt, wiederhergestellt.

Zur Gertesteuerung ntzlich sind WriteBits() und ReEnable().


2.4. Globale Objektliste
------------------------

Die Klasse verwaltet ber eine statische Member-Variable eine verkettete
Liste aller von ihr existierenden Objekte, die automatisch in den 
Konstruktor- bzw. Destruktor-Aufrufen aktualisiert wird. Die Liste 
durchlaufen kann man z. B. so:

    CDeaServ *pdea;
    for( pdea = CDeaServ::g_root; pdea != NULL; pdea = pdea->m_next )
        {
		// ...
        }

Falls (wie in diesem Programm) alle CDeaServ-Objekte ber "new" dynamisch 
angelegt wurden, kann man die Liste auch verwenden, um bei Programmende 
alle Objekte ordnungsgem wieder freizugeben:

    while( CDeaServ::g_root != NULL )
        delete CDeaServ::g_root;



3. Kuriositten
---------------

Dieser Quelltext entspricht im wesentlichen dem OPC-Treiber fr die W&T
E/A-Server, wobei lediglich die OPC-Funktionalitt entfernt wurde. An 
einigen Stellen merkt man das auch noch:

 - Ein OLE-Server ist ein Multithread-Programm, dieses Beispielprogramm
   nicht. Die Verwendung von kritischen Abschnitten (s. Klasse CCritical) 
   ist darum berflssig, und eine sinnvolle Nutzung von Events 
   (s. Membervariable m_evtRecv) ist sogar komplett unmglich.
 - OPC erwartet Zeitstempel im FILETIME-Format (64 bit). Darum wird 
   CoFileTimeNow() verwendet, obwohl GetTickCount() und 32 bit 
   Zeitstempel es genauso gut getan htten.
 - Die Funktion GetItemQuality(), die Schlufolgerungen durchfhrt wie 
   z. B. "die Ausgangsbits konnten nicht gelesen werden und dieses Bit
   haben wir auch nie geschrieben, also ist sein Zustand unbekannt" gibt
   der Einfachheit halber direkt OPC-Konstanten wie OPC_QUALITY_UNCERTAIN 
   zurck. Das ist der einzige Grund, weswegen die Header-Datei "opc.h" 
   eingebunden wird.

