Home

Bedienungsanleitung deutsch V1.0

1. length message header 3 Bytes network address 11 Bytes ExpAppBuffer MAXLONMSG Gr e max 253 Bytes message data variable L nge Beispiel define IOCTL_XLON_READWAIT DWORD 0x00 IOCTL Code f r Kommando ReadWait BOOL bResult DWORD dwTimeout INFINITE DWORD dwBytesReturned APILNI Message Ini_msg Application Layer Buffer f r Message vom NSI bResult DeviceloControl myHandle IOCTL_XLON_READWAIT amp dwTimeout sizeof dwTimeout LPVOID amp Ini_msg 255 amp dwBytesReturned NULL R ckgabewert Konnte die Leseoperation auf den Ger tetreiber erfolgreich durchgef hrt werden wird der Wert TRUE zur ckgegeben Ist die Anzahl der gelesenen Bytes die in IpBytesReturned zur ckgegeben wird gleich Null so waren nach Ablauf der Wartezeit immer noch keine Daten verf gbar Ist die Leseoperation auf den Ger tetreiber fehlgeschlagen so wird der Wert FALSE zur ckgegeben In diesem Fall k nnen detailliertere Informationen zur Fehlerursache ber den Aufruf der Funktion GetLastError erlangt werden Fehlerursachen 6 2 6 Prototyp Als wahrscheinliche Fehlerursachen f r ein Fehlschlagen dieser Funktion kommen ein ung ltiger Handle auf den Ger tetreiber oder ein au erhalb des g ltigen Bereichs liegender bzw ein nicht mit der ben tigten L nge des Application Layer Buffers bereinstimmender Parameter nOutBufferSize in Frage Get
2. PCI Controller Baustein Hostinterface Service Pin Taste Technische Details der Hardware Anbindung an das Host System ber den PCI Bus Die Ankopplung an den PCI Bus erfolgt gem PCI Spezifikation Revision 2 2 Die Datenbusbreite betr gt 32 Bit der unterst tzte Bustakt 33 MHz Der SXLON sc Adapter kann auch in einem 64 Bit PCI Einsteckplatz verwendet werden Der SXLON c Adapter kann sowohl in einer 5 0 Volt als auch in einer 3 3 Volt PCI Signalisierungsumgebung betrieben werden Der SXLON Adapter ist vollst ndig Plug amp Play kompatibel Er identifiziert sich im System durch die von der PCI Special Interest Group zugewiesenen DH electronics GmbH Vendor ID Ox17E9 und der Device ID 0x0001 LonWorks Netzwerk Interface F r das LonWorks Netzwerk Interface stehen zwei verschiedene Transceiver Varianten zur Verf gung Free Topology Transceiver FTT 10A Klemme zweipolig und RS485 Transceiver Klemme dreipolig Die bertragungsrate beim FTT 10A Transceiver betr gt 78 5 kBit s Ist der SXLON c Adapter mit RS485 Transceiver ausgestattet so k nnen mittels Software verschiedene bertragungsraten eingestellt werden vgl Kapitel 4 1 4 Die maximale bertragungsrate betr gt hier 250kBit s Neuron Prozessor Core Als Neuron Prozessor kommt ein 3150 Prozessor mit externem Speicherinterface zum Einsatz F r den Programmspeicher wird wiederbeschreibbarer Flashspe
3. Adapter lautet xlonpciO Dieser Name kann ber einen Alias auch aus der Registrierung ausgelesen werden Soll das zu verwendende Netzwerkinterface ausgew hlt werden k nnen so empfiehlt es sich den SXLON Zugriff ber einen Alias Namen aus der Registrierung ausw hlbar zu machen Hierzu k nnen die unter dem Registrierungsschl ssel lt HKEY_LOCAL_MACHINE SOFTWARE LonWorks DeviceDrivers gt angezeigten Ger te zur Auswahl angeboten werden Den ZSXLON Adapter findet man unter dem Alias Namen XLON PCI x EXLON lt Netzwerk Interface Nummer z B XLON PCI 0 gt erster im System eingebauter ZXLON Adapter Notwendige Kommando und Typdefinitionen Kommandos unter Windows98 ME define LDV_Acquire 1 Belegung des Treibers kennzeichnen define LDV_Release 2 Belegung des Treiber aufheben define LDV_Register_Event Hande 7 Event Handle zur Kommunikation anfordern define LDV_Read 10 Lesen vom Treiber define LDV_Write 11 Schreiben vom Treiber Typdefinition des Anwendungspuffers define MAXLONMSG 253 Maximale L nge f r Daten im Messagepaket typedef struct APILNI Message_Struct BYTE NiCmd Network Interface Command BYTE Length Size of ExpAppBuffer BYTE ExpAppBuffer MAXLONMSG Buffer for Data APILNI_Message Struktur des Anwendungspuffers API LNI Message Command 2 Byte Length 2 Begin of Data 3 Byte Length Network 11 Byte Adre
4. ZXLON PCI oO Bedienungsanleitung ZXLON Adapter Version 1 0 DH electronics GmbH Am Anger 8 83346 Bergen Germany Tel 49 8662 4882 0 Fax 49 8662 4882 99 E Mail info xlon de www xlon de Diese Dokumentation kann jederzeit ohne Ank ndigung ge ndert werden Der Hersteller bernimmt keine Verantwortung f r Fehler oder Ungenauigkeiten in dieser Dokumentation und etwaige sich daraus ergebende Folgen Der Hersteller sowie dessen Repr sentanten und Mitarbeiter haften in keinem Fall f r etwaige Defekte indirekt verursachte oder aus dem Gebrauch folgende Sch den die auf Grund der Verwendung oder der Nichtanwendbarkeit der Software oder der begleitenden Dokumentation entstehen siis Bedienungsanleitung ZXLON Adapter Version 1 0 m Inhaltsverzeichnis XLON PCI 1 Zu diesem Handbuch 0 0 r 5 2 Einleitung Produktinformation 5 3 Installation des gt XLON c Adapters 7 3 1 Hinweise nn nn nn 7 3 2 Hardwareinstallation 0 0 00 8 3 3 Software Treiberinstallation 10 3 3 1 Neuinstallation unter Windows 10 3 3 2 Neuinstallation unter Windows CE 3 0 14 3 3 2 1 Hinzuf gen zu laufendem Windows CE System 14 3 3 2 2 Erstellen eines neuen Windows CE I
5. a D XLONPCI Die Software f r das Ger t wurde installiert Klicken Sie auf Fertig stellen um den Vorgang abzuschlie en lt Zur ck Abbrechen e Klicken Sie auf Fertig stellen 3 3 2 1 Neuinstallation unter Windows CE 3 0 Der Ger tetreiber f r Windows CE 3 0 ist in Form eines Stream Interface Device Drivers als Dynamic Link Library DLL f r die folgende Prozessor Plattform implementiert e x86 Die zur Installation unter Windows CE 3 0 ben tigten Dateien k nnen von der Website www xlon de heruntergeladen werden Der Ger tetreiber unterst tzt bis zu 8 SXLON c Adapter in einem System wobei die Interrupts automatisch zugewiesen werden Obwohl Windows CE 3 0 kein natives Interruptsharing unterst tzt wird durch den speziellen Aufbau des Ger tetreibers ein Interruptsharing zwischen beliebig vielen SXLON c Adaptern erm glicht Der Ger tetreiber kann entweder dynamisch zu einem laufenden Windows CE System hinzugef gt werden oder statisch in ein neu zu erstellendes Windows CE Image eingebunden werden Letzteres sollte nur von erfahrenen Anwendern durchgef hrt werden die ein neues Windows CE 3 0 Image erzeugen wollen Beide Vorgehensweisen sind im folgenden beschrieben Hinzuf gen zu laufendem Windows CE System Zur Installation des Treibers bei einem Windows CE Device mit statischem RAM ist die Treiberdatei xlon_pci di manuell in das Verzeichnis Windows zu k
6. Treiberversion 1 1 0 0 Digitale Signatur Nicht digital signiert Klicken Sie auf Treiberdetails um Informationen ber die f r das Ger t geladenen Treiberdateien zu erhalten Sie k nnen auf Deinstallieren klicken um die Treiberdateien f r dieses Ger t zu deinstallieren Wenn Sie die Treiberdateien f r das Ger t aktualisieren m chten klicken Sie auf Treiber aktualisieren i Deinstallieren Treiber aktualisieren OK Abbrechen Die Daten des aktuellen Treibers werden angezeigt 8 Die angezeigte Versionsnummer hinter dem Begriff Treiberversion ist nicht die Versionsnummer der Treiberdatei sondern lediglich die Nummer der Treiberinstallation Um die Versionsnummer des Treiber zu erfahren klicken Sie auf Treiberdetails Details ber Treiberdateien BP 7 XLON PCI Treiberdateien D WINNT system32hdrivers4slonpci2 sys D WINNT system32 slonpp2 dll D WINNT system32 slonutil dil Anbieter DH electronics GmbH Dateiversion 1 1 0 Copyright Copyright 2002 by DH electronics Z RG Bei Auswahl einer der angezeigten Dateien erhalten Sie Informationen zum jeweiligen Anbieter der Dateiversion und dem Copyright Diese Informationen sollten Sie f r Supportanfragen immer bereit halten Informationen zu den Buttons Deinstallieren und Treiber aktualisieren finden Sie im Kapitel 3 3 4 1 3 Belegte Hardware Ressourcen e Klicken Sie auf den Reiter der K
7. Buffer Configuration E x m Application Buffers m Network Buffers Size bytes Count Size bytes Count 255 7 E Input ss Output 5 kb x Dutput je xi E 7 55 kb z Priority Output fee 2 x Input Priority Output r RAM Requirements bytes Current configuration New Configuration 281 7 Total Available 4555 ppily Restore Default Programmierung einer eigenen Anwendung Basierend auf den Informationen des LonWorks Host Application Programmer s Guide ist es m glich eine eigene LonWorks Host Anwendung zu programmieren Diese Programmieranleitung k nnen Sie von der Firma Echelon www echelon com beziehen Wie der Zugriff auf den Ger tetreiber des SXLON c Adapters in C zu kodieren ist wird in diesem Kapitel erl utert Da das Echelon Standardtreiberinterface zwischen Windows 98 ME und Windows 2000 XP basierenden Systemen unterschiedlich ist mu zwischen den beiden Betriebssystemfamilien unterschieden werden Alle unten angef hrten Funktionen sind Windows 32 Bit API Funktionen Ein ausf hrliches Programmierbeispiel steht auf der Webseite www xlon de zum Download zur Verf gung ffnen des Ger tetreibers Bevor auf den Treiber zugegriffen werden kann mu er ge ffnet werden Das Betriebssytem liefert beim erfolgreichen Zugriff ein Handle zur ck ber den anschlie end auf den Treiber zugegriffen werden kann Der Ger tetreibername f r den SXLON
8. Der Ger tetreiber unterst tzt bis zu 6 Z XLON c Adapter in einem System Die Interrupts werden automatisch zugewiesen Interruptsharing wird unterst tzt Nachdem sichergestellt ist dass das Kernelmodul mit der aktuellen Kernelversion bereinstimmt kann versucht werden dieses zu laden Bitte beachten Sie dass Kernelmodule nur mit den Rechten eines Superusers geladen werden k nnen Das Ger tetreibermodul kann durch den folgenden Befehl zum Kernel hinzugef gt werden sbin insmod xlonpci o Falls sich das Modul mit der Meldung Kernel version mismatch nicht laden l sst jedoch die ersten beiden Ziffern der Kernelversion bereinstimmen z B 2 2 oder 2 4 so kann versucht werden das Laden des Moduls ber den folgenden Befehl mit der Option f zu erzwingen Die dabei ausgegebene Warnung hat keine Auswirkung auf die Funktionsweise des Ger tetreibers sbin insmod f xlonpci o Mit dem folgenden Befehl kann berpr ft werden ob das Ger tetreibermodul erfolgreich geladen ist sbin lsmod Nach Ausf hrung dieses Befehls sollte in den ausgegebenen Meldungen die folgende Zeile erscheinen Module Size Used by xlonpci o 6960 O unused Sollte das Modul xlonpci o nicht erscheinen oder soll festgestellt werden wie viele Z XLON c Adapter erkannt wurden kann auf die Konsole mit den Kernelmeldungen umgeschaltet werden Sollte diese Konsole nicht vorhanden sein k nnen die Kernelmeldungen auch in der Datei
9. Message vom NSI bResult ReadFile myHandle LPCVOID amp Ini_msg 255 amp dwBytesRead NULL R ckgabewert Konnte die Leseoperation auf den Ger tetreiber erfolgreich durchgef hrt werden wird der Wert TRUE zur ckgegeben Ist die Anzahl der gelesenen Bytes die in IpNumberOfBytesRead zur ckgegeben wird gleich Null so waren keine Daten verf gbar Ist die Leseoperation auf den Ger tetreiber fehlgeschlagen so wird der Wert FALSE zur ckgegeben In diesem Fall k nnen detailliertere Informationen zur Fehlerursache ber den Aufruf der Funktion GetLastError erlangt werden Fehlerursachen 6 2 5 Prototyp Als wahrscheinliche Fehlerursachen f r ein Fehlschlagen dieser Funktion kommen ein ung ltiger Handle auf den Ger tetreiber oder ein au erhalb des g ltigen Bereichs liegender bzw ein nicht mit der ben tigten L nge des Application Layer Buffers bereinstimmender Parameter nNumberOfBytesToRead in Frage DeviceloControl BOOL DeviceloControl HANDLE hFile DWORD dwloControlCode LPVOID IpInBuffer DWORD nInBufferSize LPVOID IpOutBuffer DWORD nOutBufferSize LPDWORD IpBytesReturned LPOVERLAPPED IpOverlapped Beschreibung Mit dieser Funktion k nnen bestimmte Operationen auf den Ger tetreiber durchgef hrt werden die mit den bislang beschriebenen Funktionen nicht m glich sind Zur Zeit sind dies die Operationen GetVersion und ReadWait die durch die Kommandos
10. bib hinzu e ffnen Sie im Platform Builder das Men View und klicken Sie auf Catalog anschlie end sollte sich die Katalog Ansicht ffnen e ffnen Sie in der Baumansicht des Katalogs den Zweig Catalog Drivers CEPC XLON e F gen Sie ber die rechte Maustaste und Add to Platform die XLON Komponente zur aktuellen Plattform hinzu Starten Sie den Platform Builder neu erzeugen Sie Ihr neues Windows CE 3 0 Image und laden Sie es auf Ihr Zielsystem Der Ger tetreiber f r den ZXLON c Adapter wird durch den Device Manager von Windows CE nach dem Booten des Zielsystems automatisch geladen und steht f r Ihre Applikationen zur Verf gung Registrierungseintrag Ein Beispiel f r einen korrekten Registrierungseintrag ist in der Datei xlon_pci reg zu finden Eine Erl uterung des Inhalts wird im folgenden Abschnitt gegeben HKEY_LOCAL_MACHINE Drivers Builtin XlonPCix Der Registrierungsschl ssel HKEY_LOCAL_MACHINE Drivers Builtin enth lt Unterschl ssel mit denen festgelegt wird welche Ger tetreiber nach dem Starten des Systems vom Device Manager geladen werden Jeder Unterschl ssel tr gt den Namen des Ger tetreibers und enth lt die in der folgenden Tabelle beschriebenen Eintr ge Das x im Unterschl ssel 1 XlonPCIx ist identisch zum Eintrag Index in der folgenden Tabelle zu setzen Eintrag Beschreibung DII REG_SZ Dieser Eintrag s
11. jedoch bei Leseoperationen auf den Maximalwert gesetzt werden da die Anzahl der tats chlich zu lesenden Daten beim Aufruf der Funktion noch nicht bekannt ist Der Aufbau ist im folgenden Punkt dargestellt ber den Parameter nOutBufferSize wird die f r den jeweiligen Aufruf g ltige Gr e dieser variablen Datenstruktur festgelegt Mittels des Parameters IpBytesReturned wird die tats chlich vom Netzwerkinterface gelesene Anzahl von Bytes zur ckgeliefert Im Erfolgsfall ist dieser Wert kleiner oder gleich nOutBufferSize und ungleich Null Der Parameter IpOverlapped hat unter Windows CE 3 0 keine Verwendung Ausf hrliche Informationen zu den einzelnen Funktionsparametern und zur Funktion ReadFile im Allgemeinen sind der Windows CE 3 0 Dokumentation zu entnehmen Application Layer Buffer Der folgende C Code definiert den Datentyp APILNI Message f r Application Layer Buffer wie im Echelon NSI Firmware User s Guide spezifiziert Der Aufbau des Strukturelements ExpAppBuffer wird im LonWorks Host Application Programmer s Guide ausf hrlich erl utert define MAXLONMSG 253 typedef struct APILNI_ Message_Struct BYTE NiCmd NSI command BYTE Length Size of ExpAppBuffer BYTE ExpAppBuffer MAXLONMSG Message data APILNI_ Message Die folgende Tabelle zeigt nochmals den Aufbau des Application Layer Buffers in grafischer Form command 2 Bytes Application Layer Header
12. sowohl das LNS Netzwerk Service Interface NSI f r alle LNS Tools als auch das Microprozessor Interface Program MIP f r selbst erstellte Anwendungen Das LNS Netzwerk Betriebssystem erm glicht auf Grund seiner Client Server Architektur den gleichzeitigen Zugriff unterschiedlichster Anwendungen auf den Netzwerk Service Server NSS Dadurch k nnen Tools unterschiedlichster Hersteller zur gleichen Zeit Installation Wartung berwachung und Steuerung im LonWorks Netzwerk durchf hren Mit Hilfe des SXLON c Adapters ist es auch m glich einen PC als u erst leistungsf higen LonWorks Knoten zu betreiben Hierbei l uft auf dem PC die LonWorks Anwendung und der SXLON c Adapter ist f r die Verarbeitung des LonTalk Protokolls zust ndig Im Vergleich zu einem Neuron basierenden Knoten erm glicht dies wesentlich h here Rechenleistungen in einer LonWorks Anwendung Zudem ist die Anzahl der m glichen Netzwerk Variablen von 62 auf 4096 betr chtlich erweitert was h ufig f r Wartungs und berwachungsanwendungen wichtig ist Der ZXLON c Adapter hat entweder einen integrierten FTT 10A Transceiver f r Free Topology und Link Power Netzwerke oder einen RS485 Transceiver f r Twisted Pair Netzwerke Zur Visualisierung der Betriebszust nde ist eine Service Leuchtdiode und f r die manuelle Installation ein Service Pin Taster nach au en gef hrt Mittels einer weiteren Leuchtdiode l t sich feststellen ob Datenverkehr a
13. var log messages eingesehen werden Zum Entfernen des Ger tetreibermoduls aus dem Kernel ist der folgende Befehl auszuf hren sbin rmmod xlonpci Um die SXLON c Adapter aus eigenen Applikationen anzusprechen muss f r jeden XLON c Adapter ein sogenanntes Character Device File angelegt werden Dies erfolgt ber die folgende Befehlsfolge mknod dev pchta c 40 0 chmod 666 dev pclta In der ersten Befehlszeile wird ein Character Device File mit dem Namen pclta erzeugt ber diesen Namen kann sp ter aus eigenen Applikationen auf den Ger tetreiber zugegriffen werden Durch den Parameter c wird festgelegt dass das Ger t ungepuffert arbeitet anschlie end folgen die Major und Minor Devicenummern die den Ger tetreiber kennzeichnen mit dessen Hilfe auf das Ger t zugegeriffen wird In diesem Fall also den Ger tetreiber f r den SXLON Adapter Soll mehr als ein SXLON c Adapter verwendet werden muss f r jeden physikalischen LON Kanal ein Character Device File angelegt werden Dies erfolgt durch die folgende Befehlsfolge zwei SXLON c Adapter in diesem Fall mknod dev pcltaa c 40 0 chmod 666 dev pcltaa mknod dev pcltab c 40 1 chmod 666 dev pcltab Das Ger t dev pcltaa erscheint damit als erster LON Kanal w hrend das Ger t dev pcltab den zweiten LON Kanal darstellt Wie aus dem Beispiel ersichtlich bezeichnet die Minor Devicenummer den jeweiligen LON Kanal Dieser
14. werden Dieser Zustand kann nur noch mittels Reboot des Adapters oder in vereinzelten F llen gar nicht mehr r ckg ngig gemacht werden Sollte bei der RS485 Variante eine spezielle bertragungsrate die in der Eigenschaften Seite vgl Kapitel 4 1 4 nicht einstellbar ist ben tigt werden so muss in der Eigenschaften Seite die Transceiver ID Custom Transceiver parametriert werden Dabei ist zu beachten dass dann die Anwendung daf r verantwortlich ist die richtigen Einstellungen f r den Transceiver und der bertragungsrate vorzunehmen 6 2 1 Prototyp Applikationsschnittstelle unter Windows CE 3 0 Zum Erstellen einer C C LON Hostapplikation unter Windows CE 3 0 kann prinzipiell die gleiche Dokumentation wie unter 6 1 3 angegeben verwendet werden Allerdings unterscheidet sich das Application Programming Interface API zum Zugriff auf den Ger tetreiber unter Windows CE 3 0 von Desktop Windows Betriebssystemen Unter Windows CE 3 0 stehen zum Zugriff aus einer eigenen C C LON Hostapplikationen auf den Ger tetreiber die folgenden Standard Betriebssystemaufrufe Windows CE 3 0 API f r Stream Interface Devices zur Verf gung CreateFile ReadFile CloseHandle DeviceloControl WriteFile GetLastError In den folgenden Unterkapiteln wird ein berblick ber die einzelnen API Funktionen gegeben F r eine ausf hrliche Beschreibung wird auf die Windows CE 3 0 Dokumentation verwiesen die in der Microsof
15. 000 XP wird die Windows API Funktion ReadFile verwendet Windows98 ME DeviceloControl pHandle MAKELONG LDV Read 0 NULL sizeof char ni_in_Msg length amp nBytesReturned NULL M gliche vom Treiber zur ckgegebene Fehlercodes Fehler Vor dem Zugriff auf den Treiber wurde kein LDV_ACQUIRE ausgef hrt Fehlercode ERROR_ACCESS_DENIED Windows2000 XP ReadFile pHandle ni_in_Msg length 1 amp nBytesReturned NULL M gliche vom Treiber zur ckgegebene Fehlercodes Fehler Overlapped IO und keine Daten vorhanden Fehlercode STATUS_PENDING Fehler Non Overlapped IO und keine Daten vorhanden Fehlercode STATUS_UNSUCCESSFUL Schreiben von Daten auf den Ger tetreiber Zum Schreiben von Daten wird unter Windows98 ME das Kommando LDV Write in der Windows API Funktion DeviceloControl verwendet Unter Windows 2000 XP wird die Windows API Funktion WriteFile verwendet Windows98 ME DeviceloControl pHandle MAKELONG LDV_Write 0 ni_out_Msg length NULL sizeof char amp nBytesReturned NULL M gliche vom Treiber zur ckgegebene Fehlercodes Fehler Vor dem Zugriff auf den Treiber wurde kein LDV_ACQUIRE ausgef hrt Fehlercode ERROR_ACCESS_DENIED Fehler Kein freier Applikation Puffer im Treiber vorhanden Fehlercode ERROR_NOT_ENOUGH_MEMORY Fehler Von der Applikation gesendeter Datensatz zu gro Fehlercode ERROR_ACCESS_DENIED Windows2000 XP WriteFile pHandle ni_out_Msg length amp
16. 12 TP RS485 78 RS 485 twisted pair 78 kbps 6 1 6 1 1 Softwarezugriff Applikationsschnittstelle unter Windows LNS Anwendungen Will man ber eine LNS Anwendung auf den SXLON Adpater zugreifen so mu man lediglich als Netzwerkinterface den ZXLON c Adapter angeben die man verwenden m chte Die Ger tetreiber unterst tzen bis zu 127 ZXLON c Adapter pro PC System d h Sie k nnen mehrere SXLON c Adapter parallel in Ihr System einbauen Die Adapter sind ber unterschiedliche Ger tenamen ansprechbar Diese unterscheiden sich in der Netzwerk Interface Nummer Die LNS Anwendung gibt ein Auswahlmen f r das Netzwerk Interface vor Sie finden den ZXLON Adapter unter dem Netzwerk Interface Namen XLON PCI x x EXLON c Netzwerk Interface Nummer z B XLON PCI 0 gt erster im System eingebauter ZSXLON Adpoter Beispielhaft zeigt der folgende Bildschirmauszug die Konfiguration in der Anwendung LonMaker for Windows Network Wizard Network Interface Network Interface Name fon PCIO 7 Skip this prompt when re opening this drawing lt Back Cancel Help 6 1 3 6 1 3 1 ZXLON PCI Konfiguration der Netzwerk Interface Puffer ber das LNS Plug In Network Interface Buffer Configuration von Echelon zu finden unter www echelon com kann man die Einstellungen der Netzwerk und Applikations Puffer des Neuron Prozessors ver ndern E Network Interface
17. 49 6 2 5 2 ReadWait ber DeviceloControl 50 6 2 6 GetlastError 0 51 6 3 Applikationsschnittstelle unter Linux 53 7 Anhang m mn u nn nn nn 54 7 1 EG Konformit tserkl rung 54 8 nderungsstand Dokument 55 Zu diesem Handbuch Dieses Handbuch soll den Anwender bei der Installation und Konfiguration des SXLON c Adapters unterst tzen Dem Entwickler werden gleichzeitig Informationen zur Anbindung bzw Erstellung geeigneter Anwendungssoftware gegeben Verwendete Piktogramme und Symbole DPR In dieser Anleitung werden folgende Piktogramme und Symbole verwendet um auf besondere Punkte aufmerksam zu machen Achtung Besonders wichtiger sicherheitsrelevanter Punkt Verletzungsgefahr durch elektrische Spannung Strom Gefahr der Besch digung elektronischer Bauteile durch statische Aufladung Verletzungsgefahr durch mechanische Bauteile Boller Aufz hlungszeichen durchzuf hrende T tigkeiten Arbeitsschritte Hinweis Besonders zu beachten Einleitung Produktinformation Der SXLON Adapter erm glicht den Anschlu eines PC an ein LonWorks Netzwerk ber den PCI Bus gem PCI Spezifikation Rev 2 2 Er ist konzeptioniert f r den Einsatz in der Industrie der Prozess und der Geb udeautomation Der SXLON Adapter unterst tzt
18. Eintrag spezifiziert die Nummer des PCI Bus auf dem sich der jeweilige ZXLON Adapter befin det Informationen zur Bestimmung der PCI Busnum mer finden Sie im Kapitel 3 3 2 4 Slot REG_DWORD Dieser Eintrag spezifiziert die Nummer des PCI Slots in dem sich der jeweilige SXLON Adapter befin det Informationen zur Bestimmung der PCI Slotnum mer finden Sie im Kapitel 3 3 2 4 Friendly Name REG_SZ Eine optionale Zeichenkette die eine im Klartext les bare Beschreibung bzw Benennung des Ger tetrei bers enth lt 3 3 2 4 Hardwarekonfiguration Mit dem Windows CE 3 0 Ger tetreiber k nnen bis zu 8 ZXLON c Adapter in einem System verwendet werden Sollte dies nicht ausreichend sein so kontaktieren Sie bitte DH electronics Durch das spezielle Software Design des Ger tetreibers ist ein Interruptsharing zwischen beliebig vielen XLON5c Adaptern m glich Dies ist besonders wichtig da Windows CE 3 0 kein natives Interruptsharing unterst tzt Um die PCI Busnummer und PCI Slotnummer f r die im System vorhandenen SXLONrc Adapter zu ermitteln k nnen diverse Free und Sharewareprogramme aus dem Internet heruntergeladen werden Oft ist dies auch aus dem vom Motherboardhersteller beigelegten Handbuch ersichtlich 3 3 3 Neuinstallation unter Linux Der Ger tetreiber f r Linux ist als ladbares Kernelmodul implementiert wobei zur Zeit die Kernelversionen 2 0 2 2 und 2 4 unterst tzt werden
19. IOCTL_XLON _GETVERSION bzw IOCTLXLON_READWAIT aufgerufen werden k nnen 6 2 5 1 Die Operation GetVersion erm glicht das Auslesen einer Version aus dem Ger tetreiber Die Operation ReadWait ist die synchrone blockierende Variante der Funktion ReadFile d h die Anwendung wartet hier bis ein R ckgabewert vorliegt Diese beiden mittels DeviceloControl durchf hrbaren Operation werden im folgenden genauer Erl utert GetVersion ber DeviceloControl Beschreibung Beispiel Die Operation GetVersion ist ber die API Funktion DeviceloControl realisiert und erm glicht das Auslesen einer Versionskennung aus dem Ger tetreiber Der I O Control Code f r diese Operation ist als IOCTL_XLON_GETVERSION definiert Die Treiberversion ist in Form eines DWORD kodiert wobei jedes der 4 Bytes bin r codiert ist und f r eine dezimale Ziffer steht Die Major Version ist in Bit 16 bis Bit 23 Byte 2 und die Minor Version in Bit 8 bis Bit 15 Byte 1 kodiert die restlichen Bits Byte O und Byte 3 haben momentan keine Bedeutung Ein ausgelesenes DWORD von 0x00010200 entspricht somit dem Wert 0 1 2 0 d h die Treiberversion lautet 1 2 Beim Aufruf von DeviceloControl ist das jeweilige ZXLON Netzwerkinterface ber seinen Handle hFile zu spezifizieren Der Parameter dwloControlCode ist mit dem Kommando IOCTL_XLON_GETVERSION zu besetzen Die Parameter IpInBuffer bzw nInBu
20. Index beginnt bei O und erh ht sich f r jeden zus tzlichen LON Kanal um eins Prinzipiell kann f r das Character Device File ein beliebiger Name verwendet werden jedoch hat sich unter den Linux Applikationen der Name pcita als Quasi Standard eingeb rgert Ebenfalls ist es m glich f r einen SXLON c Adapter mehrere Character Device Files zu erzeugen Soll das Laden bzw Entladen des Ger tetreibermoduls automatisiert werden k nnen die o a Befehle in eigene Shell Scripts eingebaut oder zu den rc Scripts hinzugef gt werden 3 3 4 Treiberupdate E Die neuesten Treiber zum Download finden Sie unter www xlon de Laden Sie den f r Ihr Betriebssystem passenden Treiber herunter und speichern ihn an beliebiger Stelle 3 3 4 1 Windows e ffnen Sie die Systemsteuerung Klicken Sie auf START Gehen Sie mit dem Mauszeiger auf Einstellungen Klicken Sie auf Systemsteuerung Neues Office Dokument Office Dokument ffnen je Windows Update Stunden XLS gt short cuts wpd bilder liste erzeugen wcm Programme gt DROHEN Dokumente gt 3 a Systemsteuer Einstellungen Zpet r Netzwerk und DF Verbindungen Such X an Drucker I Hilfe A Taskleiste und Startmen Ausf hren a Beenden Systemsteuerung ZXLON PCI lolx Datei Bearbeiten Ansicht Favoriten Extras 2 zur ck gt suchen Gyordner C4ver
21. LastError DWORD GetLastError void Beschreibung Beispiel Diese Funktion liefert detailliertere Informationen zur Fehlerursache wenn eine der Funktionen CreateFile CloseHandle ReadFile WriteFile bzw DeviceloControl fehlschl gt Ausf hrlichere Informationen zur Funktion GetLastError sind der Windows CE 3 0 Dokumentation zu entnehmen DWORD dwLastError dwlastError GetLastError R ckgabewert Fehlercode der letzten Operation F r die XLON Ger tetreiber sind unter Windows CE 3 0 die folgenden Fehlercodes definiert typedef enum LONDEV_SUCCESS 0 No error detected LONDEV_NOT_FOUND Device not found LONDEV_ALREADY_OPEN Device already open LONDEV_NOT_OPEN Not a handle to a open device LONDEV_DEVICE_ERR Device detect error LONDEV_INVALID_DEVICE_ID Invalid device id was detected LONDEV_NO_MSG_AVAIL No message available LONDEV NO BUFF AVAIL Buffer is full LONDEV_NO_RESOURCES No more resources available LONDEV_INVALID_BUF _LEN Invalid buffer length LONDEV_DEVICE_BUSY Device is busy LonDevCode Applikationsschnittstelle unter Linux Zum Erstellen einer LON Hostapplikation unter Linux kann prinzipiell die gleiche Dokumentation wie unter 5 2 1 angegeben verwendet werden Zum Zugriff aus einer eigenen LON Hostapplikationen auf den Ger tetreiber stehen unter Linux die gleichen Betriebssystemaufrufe zur Verf gung wie sie ebenso f r alle anderen Dateio
22. are 36 XLON ist eingetragenes Warenzeichen der DH electronics GmbH Echelon LON LonWorks LonManager LonMark LonPoint LonTalk LonUsers Neuron 3120 3150 sind eingetragene Warenzeichen der Echelon Corporation Windows ist eingetragenes Warenzeichen der Microsoft Corporation Alle anderen hier genannten Produkte sind eingetragene Marken oder Marken der jeweiligen Eigent mer m Inhaltsverzeichnis XLON PCI 5 1 5 Unterst tzte Transceiver 37 6 Softwarezugriff nm u nn nn nn 38 6 1 Applikationsschnittstelle unter Windows 38 6 1 1 LNS Anwendungen 38 6 1 2 Konfiguration der Netzwerk Interface Puffer 39 6 1 3 Programmierung einer eigenen Anwendung 39 6 1 3 1 ffnen des Ger tetreibers 39 6 1 3 2 Registrieren eines Event Handles 41 6 1 3 3 Lesen von Daten vom Ger tetreiber 42 6 1 3 4 Schreiben von Daten auf den Ger tetreiber 42 6 1 3 5 Schlie en des Ger tetreibers 43 6 1 3 6 Wichtige Programmierinformationen 43 6 2 Applikationsschnittstelle unter Windows CE 3 0 44 6 2 1 CreateFile 0 0 0 44 6 2 5 1 GetVersion ber DeviceloControl
23. arteikarte Ressourcen Eigenschaften von XLON PCI WW Speicherbereich EAS00000 EASOOFFF WW Speicherbereich EA000000 EADDOFFF Hiii Unterbrechungsanforderung IRQ 22 Einstellung basiert auf z Automatisch Konfigurieren Einstellung nder z 5 ES In diesem Fenster finden Sie Informationen ber belegte Hardware Ressourcen Im Meldungsfenster d rfen keine Ger tekonflikte angezeigt werden 29 4 1 4 Eigenschaften des SXLON Adapters e Klicken Sie auf den Reiter der Karteikarte Eigenschaften Eigenschaften von XLON PCI a xl Allgemein Eigenschaften Treiber Ressourcen gt gt xoru Einstellungen Transceiver ID TP FT 10 78 kbps Automatisches Flush Cancel IV r Diagnose Service Pin Ger tetest Reboot m Produktunterst tzung www xlon de support slon de DH electronics GmbH 2002 H Abbrechen amp Die aktuelle Konfiguration des SXLON c Adapters f r Transceiver ID und Automatic Elush Cancel wird angezeigt Im Auslieferungszustand sind folgende Einstellungen vorgenommen Transceiver ID TP FT 10 78kbps Automatic Flush Cancel aktiviert ndern der Transceiver ID e Stellen Sie sicher dass m gliche Transceiver Einstellungen mit der Hardware bereinstimmen Der ZSXLON c Adapter wird bei einer falschen Einstellung nicht funktionieren e Klicken Sie auf die Dreiecks Taste vw neben dem Anzeig
24. cheinliche Fehlerursachen f r ein Fehlschlagen dieser Funktion kommen ein nicht geladener Ger tetreiber ein falscher Ger tetreibername ein vorherig nicht korrekt geschlossener Ger tetreiber oder fehlerhaft gesetzte Funktionsparameter in Frage 6 2 2 CloseHandle Prototyp BOOL CloseHandle HANDLE hObject Beschreibung Diese Funktion schlie t den ber den Handle hObject spezifizierten Ger tetreiber Als Funktionsparameter ist der bei erfolgreichem Aufruf der Funktion CreateFile zur ckgelieferte Handle auf den Ger tetreiber zu bergeben Ausf hrlichere Informationen zur Funktion CloseHandle sind der Windows CE 3 0 Dokumentation zu entnehmen Beispiel BOOL bResult bResult CloseHandle myHandle R ckgabewert Konnte der Ger tetreiber erfolgreich geschlossen werden wird der Wert TRUE zur ckgegeben ansonsten FALSE In letzterem Fall k nnen detailliertere Informationen zur Fehlerursache ber den Aufruf der Funktion GetLastError erlangt werden Nach einem erfolgreichen Aufruf von CloseHandle ist der bergebene Handle nicht mehr g ltig und kann nicht mehr f r Operationen auf den Ger tetreiber verwendet werden Fehlerursachen Als wahrscheinliche Fehlerursache f r ein Fehlschlagen dieser Funktion kommt ein ung ltiger Handle auf den Ger tetreiber in Frage 6 2 3 WriterFile Prototyp BOOL WriteFile HANDLE hFile LPCVOID lpBuffer DWORD nNumberOfBytesToWrite LPDWORD IpNumberO fBy
25. eine gelbe Service Pin Leuchtdiode Gr ne LonWorks Netzwerkverkehr Leuchtdiode Die gr ne LED zeigt durch blinken Blinkfrequenz ist nicht definiert an ob auf dem LonWorks Netzwerk Datenverkehr stattfindet Der Ruhezustand ist nicht definiert d h im Grundzustand kann die LED ein oder ausgeschaltet sein Desweiteren besteht die M glichkeit dass diese Leuchtdiode im Rhythmus der gelben Service Pin Leuchtdiode mit 1 25 Hz mitblinkt Dies ist dann der Fall wenn noch keine Anwendung auf den XLON gt c Adapter zugegriffen hat Gelbe Service Pin Leuchtdiode Die gelbe LED visualisiert den Zustand der Neuron Prozessor Service Pin Leitung Ist der Ger tetreiber richtig installiert und wird von einer Anwendung auf den SXLON lt c Adapter zugegriffen so ist die Leuchtdiode aus Blinkt die LED mit 72 Hz so ist der Zustand des XLON c Adapters Unconfigured Bei Durchf hrung eines Ger tetests aus der Eigenschaften Seite siehe Kapitel 4 2 1 oder beim Ausf hren eines Reset Kommandos von einer Anwendung aus blinkt die Leuchtdiode kurz auf Blitzt die LED mit 1 25 Hz und kann eine Anwendung nicht auf den ZXLON Adapter zugreifen so liegt ein Problem in der Treiberinstallation vor Schl gt der Zugriff aus einer Anwendung fehl und ver ndert sich der Zustand der Leuchtdiode nicht so ist vermutlich kein Ger tetreiber installiert Gelbe Service PinLED Beschreibung Konstant aus Anwendung g
26. en Aufruf g ltige Gr e dieser variablen Datenstruktur festgelegt Mittels des Parameters IpNumberOfBytesRead wird die tats chlich vom Netzwerkinterface gelesene Anzahl von Bytes zur ckgeliefert Im Erfolgsfall ist dieser Wert kleiner oder gleich nNumber fBytesToRead und ungleich Null Der Parameter IpOverlapped hat unter Windows CE 3 0 keine Verwendung Ausf hrliche Informationen zu den einzelnen Funktionsparametern und zur Funktion ReadFile im Allgemeinen sind der Windows CE 3 0 Dokumentation zu entnehmen Application Layer Buffer Der folgende C Code definiert den Datentyp APILNI Message f r Application Layer Buffer wie im Echelon NSI Firmware User s Guide spezifiziert Der Aufbau des Strukturelements ExpAppBuffer wird im LonWorks Host Application Programmer s Guide ausf hrlich erl utert define MAXLONMSG 253 typedef struct APILNI Message_Struct BYTE NiCmd NSI command BYTE Length Size of ExpAppBuffer BYTE ExpAppBuffer MAXLONMSG Message data APILNI Message Die folgende Tabelle zeigt nochmals den Aufbau des Application Layer Buffer in strukturierter Form command 2 Bytes Application Layer Header length message header 3 Bytes network address 11 Bytes ExpAppBuffer MAXLONMSG Gr e max 253 Bytes message data variable L nge Beispiel BOOL bResult DWORD dwBytesRead APILNI Message Ini_msg Application Layer Buffer f r
27. enfeld e W hlen Sie in dem sich ffnenden Auswahlfenster die gew nschte ID mit der linken Maustaste aus e Best tigen Sie durch Anklicken des OK Buttons Automatic Flush Cancel Ein Ausschalten Nach jedem Reset des XLON Fc Adapters ist standardm ig die Kommunikation ber das LonWorks Netzwerk gesperrt Der Empfang bzw das Senden von Daten ist erst m glich nachdem ein Flush Cancel Kommando an den SXLON c Adapter gesendet wurde Ist die Automatic Flush Cancel Funktion eingeschaltet so schickt der Ger tetreiber automatisch nach jedem Reset ein Flush Cancel Kommando an den SXLON c Adapter Eine Kommunikation ber das LonWorks Netzwerk ist dann m glich amp Bitte beachten Sie dass bei ausgeschalteter Automatic Flush Cancel Funktion ein Flush Cancel Kommando von der Anwendung an den XLON Adapter gesendet werden mu e Klicken Sie mit der linken Maustaste in das Feld neben Automatic Flush Cance e M eingeschaltet O ausgeschaltet e Best tigen sie durch Anklicken des OK Buttons Die Funktionalit t der Buttons Service Pin Ger tetest und Reboot werden in Kapitel 4 2 erkl rt Ben tigen Sie zus tzliche Informationen oder Produktunterst tzung verwenden Sie bitte die unter Produktunterst tzung angegebenen Links 4 2 Testen des SXLON Adapters unter Windows 4 2 1 Diagnose mittels Software e ffnen Sie die Eigenschaften Seite des SXLON Adapter
28. etriebnahme und Test ZXLON PCI Starten Sie den Ger te Manager und ffnen Sie das Eigenschaften Fenster des ZXLON Adapters siehe Kapitel 3 3 4 amp Ger te Manager Vorgang Ansicht l ae A Anschl sse COM und LPT g Audio Video und Gamecontroller Computer amp Datentr ger Diskettencontroller amp Diskettenlaufwerke 3 DYD CD ROM Laufwerke H Grafikkarte amp IDE ATAJATAPI Controller E M use und andere Zeigeger te Modems Monitore E Netzwerkadapter m Systemger te a Tastaturen amp USB Controller gt XLON LonTalk Adapter T A A N E Deaktivieren Deinstallieren Nach ge nderter Hardware suchen Eigenschaften Das Eigenschaften Fenster ffnet sich 25 ZXLON 4 1 berpr fen der Einstellungen unter Windows 4 1 1 Allgemeine Einstellungen Karteikarte Allgemein Eigenschaften von XLON PCI Ger t verwenden aktivieren D E Wichtig Im Feld Ger testatus mu Das Ger t ist betriebsbereit zu lesen sein 26 4 1 2 Treiberinformationen e Klicken Sie auf den Reiter der Karteikarte Treiber Eigenschaften von XLON PCI x Allgemein Eigenschaften Treiber Ressourcen gt gt xoru Treiberanbiete DH electronics GmbH Treiberdatum Nicht verf gbar
29. fferSize werden nicht ben tigt F r den Parameter IpOutBuffer wird ein Zeiger auf ein DWORD bergeben in diesem wird sp ter die Treiberversion abgelegt In nOutBufferSize wird die Gr e dieses DWORD in Byte bergeben Im Parameter IpBytesReturned wird die Anzahl der gelesenen Bytes zur ckgeliefert Der Parameter IpOverlapped hat unter Windows CE 3 0 keine Verwendung Ausf hrliche Informationen zu den einzelnen Funktionsparametern und zur Funktion DeviceloControl im Allgemeinen sind der Windows CE 3 0 Dokumentation zu entnehmen define IOCTL_XLON_GETVERSION DWORD 0x01 IOCTL Code f r Kommando GetVersion BOOL bResult DWORD dwVersion dwBytesReturned bResult DeviceloControl myHandle IOCTL XLON_GETVERSION NULL O amp dwVersion sizeof dwVersion amp dwBytesReturned NULL R ckgabewert Konnte die Treiberversion erfolgreich aus dem Ger tetreiber ausgelesen werden wird der Wert TRUE zur ckgegeben andernfalls wird der Wert FALSE zur ckgegeben In diesem Fall k nnen detailliertere Informationen zur Fehlerursache ber den Aufruf der Funktion GetLastError erlangt werden Fehlerursachen Als wahrscheinliche Fehlerursache f r ein Fehlschlagen dieser Funktion kommt ein ung ltiger Handle auf den Ger tetreiber in Frage 6 2 5 2 ReadWait ber DeviceloControl Beschreibung Die Operation ReadWait ist die synchrone blockierende Variante der F
30. ften Fenster des ZXLON c Adapters rechte Maustaste 21 e Klicken Sie auf den Reiter der Karteikarte Treiber Eigenschaften von XLON PCI o BHE Allgemein Eigenschaften Treiber Ressourcen gt gt xoru Treiberanbiete DH electronics GmbH Treiberdatum Nicht verf gbar Treiberyersion 1 1 0 0 Digitale Signatur Nicht digital signiert Klicken Sie auf Treiberdetails um Informationen ber die f r das Ger t geladenen Treiberdateien zu erhalten Sie k nnen auf Deinstallieren klicken um die Treiberdateien f r dieses Ger t zu deinstallieren Wenn Sie die Treiberdateien f r das Ger t aktualisieren m chten klicken Sie auf Treiber aktualisieren Deinstallieren Treiber aktualisieren OK Abbrechen e Pr fen Sie ob die auf Ihrem System installierte Treiberversion niedriger ist als die Version die Sie installieren m chten e Klicken Sie auf Treiber aktualisieren e Der Assistent zum Aktualisieren von Ger tetreibern ffnet sich e Folgen Sie den Anweisungen am Bildschirm Assistent zum Aktualisieren von Ger tetreibern Willkommen Dieser Assistent aktualisiert einen Treiber f r ein Ger t Klicken Sie auf Weiter um den Vorgang fortzusetzen A Abbrechen lt Zur ck Klicken Sie auf Weiter gt Assistent f r das Suchen neuer Hardware Hardwaretreiber installieren Ein Ger tetreiber ist ein Programm das das A
31. icher und als Datenspeicher wird SRAM Speicher verwendet Der Neuron Prozessor ist mittels des Neuron Parallel IO Modell an den PCI Controller Baustein angekoppelt Adresstabelle des Neuron Prozessor Core Speichertyp Adressbereiche Speichergr e ROM Speicher 0x0000 OxC2FF 49919 Byte 48 75 kB RAM Speicher lesen und schreiben 0xC300 OxE6FF 9215 Byte 9 00 kB EA Bereich f r Interrupt Generierung OxE700 OxE7FF Reserviert Neuron Prozessor intern OxE800 OxFFFF 5 1 5 Unterst tzte Transceiver In der Regel braucht die Transceiver Konfiguration nicht ver ndert werden Sollte dies doch n tig werden geschieht dies unter Microsoft Windows Desktop Betriebssystemen im Ger temanager F r andere Betriebssysteme wie Microsoft Windows CE oder Linux kann es n tig werden die Transceiver ID manuell in bestimmte Konfigurationsdateien einzutragen Genauere Informationen hier ber sind im Kapitel Treiberinstallation f r die jeweiligen Betriebssysteme nachzulesen Die folgende Tabelle zeigt die von der Hardware des ZXLON c Adapters grunds tzlich unterst tzten LON Transceiver ID s Abh ngig vom physikalisch auf dem Adapter vorhandenen Transceiver TP FT 10 oder TP RS485 werden nicht alle in der Tabelle angegebenen Transceiver Betriebsarten unterst tzt ID Name Medium RS 04 TP FT 10 Flexible topology link power 78 kbps 05 TP RS485 39 RS 485 twisted pair 39 kbps
32. ige Service Pin Neuron Prozessor Service Pin Taster Manuelles Ausl sen der Service Pin Meldung Pinbelegung Anschlu buchse LON FTT 10A RS485 20 e 10 10 Pin FTT 10A RS485 1 NET A RS485 A NET B RS485 B nicht vorhanden GND PC ffnen Blechabdeckung eines freien PCI Slots entfernen e Adapter einstecken dabei auf festen Sitz achten e Blechhalteb gel des SXLON Adapters mit Schraube am PC Geh use befestigen e PC schlie en e LonWorks Netzwerk Kabel anstecken e Rechner starten e Bei Windows basierenden Systemen startet ein Assistent f r das Suchen neuer Hardware siehe Kapitel 3 3 e Zur Installation der Ger tetreiber unter Windows CE ist entsprechend Kapitel 3 3 2 vorzugehen Unter LINUX werden im System vorhandene ZXLON c Adapter automatisch beim Laden des Treibermoduls erkannt Deinstallation Der Ausbau des ZXLON c Adapters erfolgt in umgekehrter Reihenfolge Eine Deinstallation der Treibersoftware ist nicht erforderlich 3 3 Software Treiberinstallation 3 3 1 Neuinstallation unter Windows Als Beispiel wird im Folgenden die Neuinstallation unter Windows 2000 erkl rt Die Installation unter den anderen Windows Betriebssystemen erfolgt sinngem in gleicher Weise Nach dem Neustart des Rechners erscheint folgende Meldung Neue Hardware gefunden Netzwerkcontr
33. laur R Ex A Er Adresse systeme Fe enau a Systemsteuerung System Liefert Systeminformationen und ndert Einstellungen Windows Update Windows 2000 Support Anzeige DatumjuUhrzeit a Gamecontroller amp Internetoptionen Netzwerk und DF Verbindungen 2 Scanner und Kameras E3 BDE Verwaltung Benutzer und Corel Versions Kennw rter Drucker Geplante Tasks L ndereinstellungen Ordneroptionen Schriftarten Fe Tastatur Eingabehilfen Hardware Software 2 Telefon und a Energieoptionen f Indexerstellung amp QuickFinder Manager 9 QuickTime amp Sounds und Multimedia Verwaltung Modemoptionen Liefert Systeminformationen und ndert Einstellungen e W hlen Sie System durch Doppelklick aus 20 e Gehen Sie auf das Register Hardware Systemeigenschaften menmen e ffnen Sie den Ger te Manager durch Anklicken mit der Maus E Ger te Manager H 7 Anschl sse COM und LPT a g Audio Video und Gamecontroller H Computer H Datentr ger H 6 Diskettencontroller H 6 Diskettenlaufwerke 8 DVD CD ROM Laufierke H Grafikkarte 6 IDE ATAJATAPI Controller H M use und andere Zeigeger te H A Modems H Monitore EF Netzwerkadapter a Systemger te Tastaturen amp USB Controller gt XLON LonTalk Adapter e ffnen Sie das Eigenscha
34. mages 15 3 3 2 3 Registrierungseintrag 15 3 3 2 4 Hardwarekonfiguration 17 3 3 3 Neuinstallation unter Linux 17 3 3 4 Treiberupdate 0 0 19 3 3 4 1 Windows nu nn nn nn 19 3 3 4 2 Windows CE 3 0 0 0 0 24 3 3 4 3 Linux mn n nn nn nn nn nn nn nn nn 24 3 4 Deinstallation nn nn 0 nn 24 4 Inbetriebnahme und Test 0 0 0 25 4 1 berpr fen der Einstellungen unter Windows 26 4 1 1 Allgemeine Einstellungen 26 4 1 2 Treiberinformationen 27 4 1 3 Belegte Hardware Ressourcen 29 4 1 4 Eigenschaften des SXLON c Adapters 30 4 2 Testen des SXLON c Adapters unter Windows 32 4 2 1 Diagnose mittels Software 32 4 2 2 Diagnose mittels Leuchtdioden 33 5 Technische Informationen 34 5 1 Hardware mn nn nn nn nn nn nn nn 34 5 1 1 Allgemeine Informationen 34 5 1 2 Steckverbinder 0 0 35 5 1 3 Blockschaltbild 0 0 36 5 1 4 Technische Details der Hardw
35. me muss xlonpci0 verwendet werden 2 _ pHandle CreateFile xlonpci0 GENERIC_READ GENERIC_WRITE FILE_SHARE_READ FILE_SHARE_WRITE LPSECURITY_ATTRIBUTES NULL OPEN_EXISTING O HANDLE NULL M gliche vom Treiber zur ckgegebene Fehlercodes Fehler Zu wenig Speicher f r Allokierung Treiberpuffer Fehlercode ERROR_NOT_ENOUGH_MEMORY Registrieren eines Event Handles Zur Kommunikation zwischen Treiber und Applikation kann ein gemeinsamer Event Handle registriert werden Dazu mu die Applikation einen Handle beim Betriebssystem anfordern Diesen Handle bergibt die Applikation anschlie end dem Treiber Der Treiber kreiert immer dann einen Event wenn der Treiber Daten f r die Hostapplikation hat Windows98 ME Kreieren eines Synchronisations Event Handles 1 CreateCommonEvent amp hEventR3 amp hEventRO FALSE FALSE bergeben des Event Handles an den Treiber 2 DeviceloControl pHandle MAKELONG LDV_Register_Event_Handle O hEventRO sizeof HANDLE amp Retlnfo sizeof RetInfo amp nBytesReturned NULL Windows2000 XP Hier kommt ein anderer Event Mechanismus zum Einsatz Der Zugriff erfolgt ber Overlapped IO das registrieren eines Event Handle ist somit nicht notwendig 6 1 3 4 ZXLON PCI Lesen von Daten vom Ger tetreiber Zum Lesen von Daten wird unter Windows98 ME das Kommando LDV_Read in der Windows API Funktion DeviceloControl verwendet Unter Windows 2
36. n Datentyp APILNI Message f r Application Layer Buffer wie im Echelon NSI Firmware User s Guide spezifiziert Der Aufbau des Strukturelements ExpAppBuffer wird im LonWorks Host Application Programmer s Guide ausf hrlich erl utert define MAXLONMSG 253 typedef struct APILNI Message_Struct BYTE NiCmd NSI command BYTE Length Size of ExpAppBuffer BYTE ExpAppBuffer MAXLONMSG Message data APILNI_ Message Die folgende Tabelle zeigt nochmals den Aufbau des Application Layer Buffers in strukturierter Form command 2 Bytes Application Layer Header length message header 3 Bytes network address 11 Bytes ExpAppBuffer MAXLONMSG Gr e max 253 Bytes message data variable L nge Beispiel BOOL bResult DWORD dwBytesWritten APILNI Message Ini_msg niRESET 0x00 Puffer mit Reset Kommando an NSI bResult WriteFile myHandle LPCVOID amp Ini_msg 0x02 amp dwBytesWritten NULL R ckgabewert Konnte die Schreiboperation auf den Ger tetreiber erfolgreich durchgef hrt werden wird der Wert TRUE zur ckgegeben ansonsten FALSE In letzterem Fall k nnen detailliertere Informationen zur Fehlerursache ber den Aufruf der Funktion GetlastError erlangt werden Fehlerursachen Als wahrscheinliche Fehlerursachen f r ein Fehlschlagen dieser Funktion kommen ein ung ltiger Handle auf den Ger tetreiber ein fehlerhaft aufgebauter Ap
37. nBytesReturned NULL M gliche vom Treiber zur ckgegebene Fehlercodes Fehler Applikation Puffer f r schreiben ersch pft Fehlercode ERROR_NOT_ENOUGH_MEMORY 6 1 3 6 Schlie en des Ger tetreibers Wird die Anwendung beendet so muss der Treiber geschlossen werden Windows98 ME Bevor der Treiber endg ltig geschlossen werden kann muss zuerst der Befehl LDV_Release aufgerufen werden Hierdurch wird die Belegung des Ger tetreibers aufgehoben 1 DeviceloControl pHandle MAKELONG LDV_Release 0 amp inBuf sizeof char amp Retlnfo sizeof Retlnfo amp nBytesReturned NULL Anschlie end muss der Treiber geschlossen werden 2 CloseHandle pHandle Windows2000 XP 2 CloseHandle pHandle Wichtige Programmierinformationen Wird eine eigene Anwendung f r den SXLON c Adapter programmiert so muss bei der Initialisierung des Adapters eine Programm ID in den Adapter programmiert werden Die zu verwendende Programm ID kann von der Anwendung bestimmt werden Die Netzwerk und Anwendungs Puffer des Neuron Prozessors k nnen ver ndert werden Hierbei ist zu beachten dass die maximal zul ssige Byte Anzahl f r alle verwendeten Puffer 4556 Byte nicht berschreiten darf Zul ssige Puffer Einstellungen sollten mit dem LNS Plug In Network Interface Buffer Configuration ermittelt werden vgl Kapitel 6 1 2 In manchen F llen kann bei falschen Werten der Puffergr e der SXLON c Adapter funktionslos
38. nd EMV Richtlinien EN55022 Level B EN61000 4 2 EN61000 4 4 EN50140 EN50141 Pr fzeichen CE und FCC Prozessor Neuron 3150 Prozessor mit 10 MHz Abmessungen 127 x 55 7 mm 5 x 2 19 L nge x Breite Gewicht 100 g Die Hardware des SXLON c Adapters unterst tzt bis zu 127 Adapter pro PCI Bus System im PC Multiple Device Unterst tzung 5 1 2 Steckverbinder Als Steckverbinder f r den LonWorks Anschlu des SXLON c Adapters kommt ein Steckverbinder der Serie BL3 5 der Firma Weidm ller zum Einsatz Netzwerktyp Polzahl Weidm ller Bezeichnung Bestellnummer Free Topologie FTT 2 polig BL3 5 2F SN OR 160664 Twisted Pair RS485 3 polig BL3 5 3F SN OR 160665 Der maximal einklemmbare Leitungsquerschnitt betr gt 1 5 mm amp Bestellinformationen sowie weitere detaillierte Informationen f r diese Buchsenleiste finden Sie unter www weidmueller de Steckerbelegung Pinbelegung Anschlu buchse LON FTT 10A ns 20 30 le 20 10 Pin FTT 10A RS485 1 NET A RS485 A NET B RS485 B nicht vorhanden GND 5 1 3 5 1 4 CI Blockschaltbild LonWorks f Flash Speicher T j Steckverbinder en Neuron 3150 RAM Speicher Prozessor Netzwerk LED _ Takterzeugung Service LED Powermonitor
39. nsprechen des Ger ts durch das Betriebssystem erm glicht Klicken Sie auf Weiter gt Assistent f r das Suchen neuer Hardware Suche nach Treiberdateien Geben Sie an wo nach den Treiberdateien gesucht werden soll e W hlen Sie Andere Quelle angeben aus und alle anderen M glichkeiten ab e Klicken Sie auf Weiter gt 93 Assistent zum Aktualisieren von Ger tetreibern Legen Sie den Installationsdatentr ger des Herstellers E indas ausgew hlte Laufwerk ein und klicken Sie dann auf OK Abbrechen Dateien des Herstellers kopieren von Ey Durchsuchen Klicken Sie auf Durchsuchen Datei suchen 2x Suchen in E temp e BT Eigene Dateien Al Arbeitsplatz ee Netzwerkumg Dateiname inf hks Dateityp Setup Infomationen inf E Abbrechen e Suchen Sie im Explorerfenster den heruntergeladenen Treiber e Markieren Sie den Treiber und klicken Sie auf ffnen e Die weitere Treiberaktualisierung verl uft identisch zur Neuinstallation 3 3 4 2 Windows CE 3 0 Das Treiberupdate entspricht einer Neuinstallation wie in Kapitel 3 3 2 beschrieben 3 3 4 3 Linux Das Treiberupdate entspricht einer Neuinstallation wie in Kapitel 3 3 3 beschrieben 3 4 Deinstallation Eine Deinstallation der Software ist nicht erforderlich Es gen gt der Ausbau des SXLON c Adapters Informationen hierzu finden Sie in Kapitel 3 2 4 Inb
40. oller s Der Assistent f r das Suchen neuer Hardware wird automatisch gestartet Assistent f r das Suchen neuer Hardware EE Willkommen Dieser Assistent installiert einen Treiber f r ein Ger t Klicken Sie auf weiter um den Vorgang fortzusetzen lt Zur ck e Klicken Sie auf Weiter gt Assistent f r das Suchen neuer Hardware Hardwaretreiber installieren nn Ein Ger tetreiber ist ein Programm das das Ansprechen des Ger ts durch das I Betriebssystem erm glicht Der Assistent wird die Installation des Ger ts fertig stellen o Netzwerkcontroller Ger tetreiber sind Programme zum Steuern der Hardware F r das neue Ger t sind Treiberdateien erforderlich Klicken Sie auf weiter um diese Treiberdateien zu suchen und die Installation zu abzuschlie en Wie m chten Sie vorgehen C Alle bekannten Treiber f r das Ger t in einer Liste anzeigen und den entsprechenden Treiber selbst ausw hlen lt Zur ck Abbrechen e bernehmen Sie die oben abgebildete Vorgehensweise und klicken Sie auf Weiter gt Assistent f r das Suchen neuer Hardware Faer Suche nach Treiberdateien Sn Geben Sie an wo nach den Treiberdateien gesucht werden soll I Nach Treiberdateien f r folgende Ger te suchen o Netzwerkcontroller Der Assistent sucht in der Treiberdatenbank und auf den angegebenen Laufwerken nach passenden Treiber Klicken Sie auf weiter um die Suche
41. opieren Anschlie end sind die Registrierungseintr ge wie im Kapitel 3 3 2 3 beschrieben anzulegen 3 3 2 3 Erstellen eines neuen Windows CE Images Um den Ger tetreiber f r den SXLON c Adapter im Microsoft Platform Builder 3 0 verf gbar zu machen sind die folgenden Schritte n tig Diese beziehen sich auf eine x86 Hardware Plattform die Vorgehensweise bei anderen Hardwoarearchitekturen erfolgt analog allerdings k nnen sich plattformspezifische Verzeichnispfade unterscheiden e Kopieren Sie die Ger tetreiberdatei xlon_pci dIl ins Verzeichnis _WINCEROOT PLATFORM CEPC FILES e Kopieren Sie die Komponentendatei xlon cec ins Verzeichnis CEPBDir CEPB CEC Starten Sie Microsoft Platform Builder 3 0 und laden Sie Ihren Plattform Arbeitsbereich e ffnen Sie das Men File und w hlen Sie Manage Platform Builder Components e Importieren Sie die Komponentendatei xlon cec indem Sie auf Import New klicken F r den folgenden Punkt ben tigen Sie Informationen dar ber auf welchem PCI Bus und in welchem PCI Slot sich die SXLON c Adapter befinden Weitergehende Informationen dazu finden Sie unter Kapitel 3 3 2 4 e F gen Sie im Platform Builder die Registrierungsinformationen wie unter Kapitel 3 3 2 3 beschrieben manuell zur Datei platform reg hinzu e F gen Sie den Inhalt der Datei xlon_pci bib manuell im Platform Builder zur Datei platform
42. perationen unter Linux verwendet werden F r eine detaillierte Beschreibung wird auf die einschl gige Linux Dokumentation verwiesen open ffnen des Treibers f r eine bestimmtes Ger t close Schlie en des Treibers read Lesen eines Uplink Pakets vom Ger t write Schreiben eines Downlink Pakets auf ein Ger t Der Aufbau der zum Datenaustausch zwischen LON Hostapplikation und Ger tetreiber verwendeten Datenpakete ist im LonWorks Host Application Programmer s Guide erl utert wie bereits in Kapitel 6 1 3 erw hnt Die read Funktion blockiert falls keine Datenpakete verf gbar sind Dies ist nicht der Fall wenn der Ger tetreiber mit dem O_NONBLOCK Flag ge ffnet wurde In diesem Fall wird ein Fehler errno mit dem Wert EWOULDBLOCK zur ckgegeben Die write Funktion verh lt sich in gleicher Weise 7 1 EG Konformit tserkl rung Das Produkt Fabrikat ZXLON c Typbezeichnung en PCI1 WM FTT PCIT PH FTT PCIT WM 485 DH291 200 WM FTT10A DH291 200 WM RS485 ist entwickelt konstruiert und gefertigt in bereinstimmung mit den EG Richtlinien 89 336 EG ge ndert 92 31 EG in alleiniger Verantwortung von Firma DH electronics GmbH Am Anger 8 83346 Bergen Germany Folgende harmonisierten Fachgrundnormen sind angewandt EMV St raussendung Fachgrundnorm EN 50081 1 EMV St rfestigkeit Fachgrundnorm EN 50082 1 Dar ber hinaus wurde die EN 50082 2 f r industrielle Anforderungen angewand
43. pezifiziert den Dateinamen der Ger tetreiber DLL die der Device Manager l dt hier z B xlon_pci dll Prefix REG_SZ Dieser Eintrag spezifiziert den Pr fix des Ger tena mens unter dem auf den Treibers zugegriffen werden kann Er besteht aus drei Buchstaben hier z B LON Index REG_DWORD Dieser Eintrag spezifiziert den Ger teindex ein Wert zwischen O und 9 den der Device Manager dem Ger tetreiber zuweist Pr fix und Index bilden zusam men den Ger tenamen z B LONI Order REG_DWORD Dieser Eintrag spezifiziert die Reihenfolge in der ein Ger tetreiber geladen wird Besitzen zwei Ger tetrei ber den gleichen Wert werden sie in der Reihenfolge geladen in der sie in der Registrierung erscheinen Dieser Eintrag ist dann sinnvoll wenn ein Treiber einen bestimmten anderen Treiber voraussetzt FlushCancel REG_DWORD Dieser Eintrag spezifiziert ob der Ger tetreiber ein FlushCancel Kommando zum Netzwerk Interface sendet nachdem ein Reset Kommando vom Netz werk Interface empfangen wurde Ein Wert von O aktiviert diesen Modus ein Wert ungleich O deakti viert diesen Modus Tranceiver ID REG_DWORD Dieser Eintrag spezifiziert die Transceiver ID des auf dem ZXLON Adapter verwendeten Netzwerk Tran sceivers wie von Echelon vorgegeben Eine bersicht ber die unterst tzten Transceiver ID s ist im Kapitel 5 1 5 zu finden Bus REG_DWORD Dieser
44. plication Layer Buffer oder ein au erhalb des g ltigen Bereichs liegender bzw nicht mit der tats chlichen L nge des Application Layer Buffer bereinstimmender Parameter nNumberOfBytesToWrite in Frage 6 2 4 ReadFile Prototyp BOOL ReadFile HANDLE hFile LPVOID lpBuffer DWORD nNumberOfBytesToRead LPDWORD IpNumberOfBytesRead LPOVERLAPPED IpOverlapped Beschreibung Mit dieser Funktion werden Daten durch eine LON Applikation vom Ger tetreiber und somit vom ZXLON Netzwerkinterface gelesen Aufrufe dieser Funktion geschehen asynchron d h die Funktion kehrt sofort zur ck sobald die Daten vom internen Puffer des Ger tetreibers bernommen wurden Falls keine Daten zur Verf gung stehen oder ein Fehler aufgetreten ist kehrt diese Funktion ebenfalls sofort zur ck d h es wird nicht auf das Eintreffen von Daten vom ZXLON Netzwerkinterface gewartet Das jeweilige ZSXLON Netzwerkinterface wird ber seinen Handle hFile spezifiziert Der Zeiger IpBuffer muss auf eine Datenstruktur vom Typ APILNI Message zeigen die auch als Application Layer Buffer bezeichnet wird Die Gr e dieser Datenstruktur ist variabel sollte jedoch bei Leseoperationen auf den Maximalwert gesetzt werden da die Anzahl der tats chlich zu lesenden Daten beim Aufruf der Funktion noch nicht bekannt ist Der Aufbau ist im folgenden Punkt dargestellt ber den Parameter nNumberOfBytesToRead wird die f r den jeweilig
45. reift erfolgreich auf SXLON c Adapter zu oder kein Treiber installiert Konstant ein konstant aus kein Treiber installiert Blitzt mit 1 25 Hz noch keine Anwendung hat auf ZXLON zc Adapter zugegriffen Blinkt mit Ya Hz Zustand des SXLON Adapters ist Unconfigured d h der ZXLON Adapter hat keine Netzwerkadresse Blitzt 1 mal kurz auf ein Reset auf den XLON uss Adapter wurde ausgef hrt oder ein Ger tetest wurde durchgef hrt 5 1 5 1 1 Technische Informationen Hardware Allgemeine Informationen Bus Anschlu PCI konform gem PCI Spezifikation Revision 2 2 Netzwerkanschlu FTT 10A RS485 2 poliger Stecker Weidm ller mit Schraub klemmen und Zugentlastung 3 poliger Stecker Weidm ller mit Schraub klemmen und Zugentlastung Stromversorgung Erfolgt ber den PCI Bus Service Pin Funktion Gesteuert vom Host Rechner oder durch externe Service Pin Taste Konfigurations Status Anzeige auf Host Rechner und ber Service LED Netzwerk Transceiver Wahlweise FTT 10A oder RS485 integriert Netzwerk Topologien FTT 10A RS485 Free Topology und Link Power Twisted Pair Daten f r Stromversorgung 5 V DC 5 80 mA typisch und 3 3 V DC 5 40 mA typisch Betriebstemperatur 0 C bis 70 C Lagertemperatur 45 C bis 85 C maximale Luftfeuchtigkeit 90 bei 50 C nicht kondensiere
46. s wie in Kapitel 4 beschrieben e ffnen Sie dann die Karteikarte Eigenschaften Eigenschaften von XLON PCI E 2 x Allgemein Eigenschaften Treiber Ressourcen gt gt xoru Einstellungen Transceiver ID TP FT 10 78 kbps Automatisches Flush Cancel IV m Diagnose Service Pin Ger tetest Reboot m Produktunterst tzung www glor de support xlon de DH electronics GmbH 2002 4 Abbrechen F r den Ger tetest finden Sie unter der Gruppe Diagnose die drei Buttons Service Pin Durch Bet tigen des Buttons Service Pin sendet der SXLON c Adapter eine Service Pin Meldung auf das LonWorks Netzwerk Dies hat exakt die selbe Funktionalit t wie die manuelle Bet tigung der Service Pin Taste siehe Kapitel 3 2 Ger tetest Mittels des Buttons Ger tetest kann ein Ger tetest durchgef hrt werden Nach Bet tigen des Buttons mu die gelbe Service LED des Adapters kurz blinken War die Kommunikation mit dem SXLON Adapter erfolgreich so wird dies angezeigt Reboot Das Bet tigen des Reboot Buttons f hrt zum Zur cksetzen des XLON 5c Adapters in den Auslieferungszustand Diese Aktion sollte nur von erfahrenen Benutzern durchgef hrt werden Diagnose mittels Leuchtdioden Wie in Kapitel 3 2 beschrieben besitzt der SXLON c Adapter zwei Visualisierungsleuchtdioden Eine gr ne LonWorks Netzwerkverkehr Leuchtdiode und
47. ss Data variable Length Definition eines Zugriffhandles 1 HANDLE phandle new HANDLE Handle to access the device driver Definition der Anwendungs Puffer 2 APILNI_ Message ni_in_msg new APILNI Message NSI Message In structure APILNI_Message ni_out_msg new APILNI_ Message NSI Message Out structure 6 1 3 2 ZXLON PCI Windows98 ME Die Funktion CreateFile ffnet den Ger tetreiber f r den ZXLON Adapter und liefert ein Handle f r den Zugriff auf den Ger tetreiber zur ck Als Ger tetreibername muss xlonpci0 verwendet werden 2 pHandle CreateFile xlonpci0 GENERIC_READ GENERIC_WRITE 0 0 OPEN_EXISTING 0 0 M gliche vom Treiber zur ckgegebene Fehlercodes Fehler Zu wenig Speicher f r die Allokierung der Treiberpuffer Fehlercode ERROR_NOT_ENOUGH_MEMORY Nachdem der Treiber ge ffnet wurde muss unter Windows98 ME Betriebssystemen der Befehl LDV _Aquire ausgef hrt werden Hierdurch wird dem Ger tetreiber angezeigt dass auf den Treiber zugegriffen wurde 3 DeviceloControl pHandle MAKELONG LDV_Acquire 0 amp inBuf sizeof char amp RetInfo sizeof RetInfo amp nBytesReturned NULL M gliche vom Treiber zur ckgegebene Fehlercodes Fehler keine Windows2000 XP Die Funktion CreateFile ffnet den Ger tetreiber f r den SXLON c Adapter und liefert ein Handle f r den Zugriff auf den Ger tetreiber zur ck Als Ger tetreiberna
48. t Folgende nationalen Normen Richtlinien und Spezifikationen sind zus tzlich angewandt Keine Eine Technische Dokumentation ist vollst ndig vorhanden Die zum Produkt geh rende Betriebsanleitung liegt in der Originalfassung vor Bergen den 17 Mai 2001 D Ort Datum Dipl Ing FH Stefan Daxenberger Gesch ftsleitung Diese EG Konformit ts Erkl rung gilt f r Serienger te und ist daher als Kopie g ltig CI 8 Anderungsstand Dokument p A be Status Veran Kommentar Version 2 s Anderung lasser 1 0 20 02 03 Grundversion verab StS schiedet
49. t MSDN Library bzw in der Microsoft Windows CE Platform Builder 3 0 Library zu finden ist CreateFile HANDLE CreateFile LPCTSTR IpFileName DWORD dwDesiredAccess DWORD dwShareMode LPSECURITY_ATTRIBUTES IpSecurityAttributes DWORD dwCreationDisposition DWORD dwFlagsAndAttributes HANDLE hTemplateFile Beschreibung Diese Funktion ffnet den durch IpFileName spezifizierten Ger tetreiber wobei sich der Ger tetreibername aus dem Ger tepr fix und dem Ger teindex zusammensetzt gefolgt von einem Doppelpunkt z B LON1 LON2 LON3 usw Der Aufbau des Ger tenamens wurde bereits in Kapitel 3 3 2 1 ausf hrlich dargestellt Ausf hrliche Informationen zu den weiteren Funktionsparametern und zur Funktion CreateFile im Allgemeinen sind der Windows CE 3 0 Dokumentation zu entnehmen Beispiel HANDLE myHandle myHandle CreateFile TEXT LON1 GENERIC_READ GENERIC_WRITE 0x00 NULL OPEN_EXISTING FILE_ATTRIBUTE_NORMAL NULL R ckgabewert Konnte der Ger tetreiber erfolgreich ge ffnet werden wird ein Handle auf den Ger tetreiber zur ckgegeben ber diesen Handle k nnen weitere Operationen auf den Ger tetreiber durchgef hrt bzw der Ger tetreiber wieder geschlossen werden Im Fehlerfall wird INVALID_HANDLE_ VALUE zur ckgeliefert dann k nnen detailliertere Informationen zur Fehlerursache ber den Aufruf der Funktion GetLastError erlangt werden Fehlerursachen Als wahrs
50. tesWritten LPOVERLAPPED IpOverlapped Beschreibung Mit dieser Funktion werden Daten von einer LON Applikation auf den Ger tetreiber und somit auf das SXLON Netzwerkinterface geschrieben Aufrufe dieser Funktion geschehen asynchron d h die Funktion kehrt sofort zur ck sobald die Daten in den internen Puffer des Ger tetreibers bernommen wurden oder dabei ein Fehler aufgetreten ist Die Verarbeitung der Daten verl uft dann parallel zur LON Applikation im Hintergrund Das jeweilige SXLON Netzwerkinterface wird ber seinen Handle hFile spezifiziert Der Zeiger IpBuffer muss auf eine Datenstruktur vom Typ APILNI Message zeigen die auch als Application Layer Buffer bezeichnet wird Die Gr e dieser Datenstruktur ist variabel der Aufbau ist im folgenden Punkt dargestellt ber den Parameter nNumberOfBytesToWrite wird die f r den jeweiligen Aufruf g ltige Gr e dieser variablen Datenstruktur festgelegt Mittels des Parameters IpNumberOfBytesWritten wird die tats chlich an das Netzwerkinterface bertragene Anzahl von Bytes zur ckgeliefert Im Erfolgsfall sind diese beiden Werte identisch und ungleich Null Der Parameter IpOverlapped hat unter Windows CE 3 0 keine Verwendung Ausf hrliche Informationen zu den einzelnen Funktionsparametern und zur Funktion WriteFile im Allgemeinen sind der Windows CE 3 0 Dokumentation zu entnehmen Application Layer Buffer Der folgende C Code definiert de
51. uf dem LON Netzwerk abl uft Beispielprogramme f r den Zugriff auf die Treiber unter C C und VisualBasic zum Download finden Sie unter http www xlon de Lieferumfang ZXLON Einsteckkarte e Weidm ller Klemme f r LonWorks Netzwerk Anschlu e Diskette CD mit Treibern Installations Kurzanleitung Verf gbare Varianten e PCII WM FTT mit integriertem FTT 10A Transceiver PCIT WM RS mit integriertem RS485 Transceiver Weitere Informationen zu LonWorks Netzwerken finden Sie unter www echelon com 3 Installation des SXLON Adapters 3 1 Hinweise Zum Einbau des SXLON c Adapters mu ein freier PCI Slot im Rechner vorhanden sein Zum Herunterfahren ffnen des PC und ber die Anordnung der Steckpl tze informieren Sie sich bitte in den Unterlagen des Computerherstellers Bei Arbeiten die am ge ffneten Computer durchzuf hren sind vor dem ffnen des Ger ts immer Betriebssystem ordnungsgem herunterfahren und PC ausschalten A e Netzstecker ziehen e Um Sch den durch berspannung zu vermeiden vor Ber hren des SXLONs Adapters Potentialausgleich zwischen Benutzer und PC herstellen zum Beispiel durch Ber hren des metallischen Rahmens des Computers 3 2 Hardwareinstallation Nr Bezeichnung Bemerkung 1 Anschlu buchse LON 2 polig FTT 10A 3 polig R5485 2 LED gr n PKD Anzeige von Datenverkehr auf dem LonWorks Netz werk LED gelb SVC Anze
52. unktion ReadFile d h die Anwendung wartet hier bis ein R ckgabewert vorliegt Mit dieser Operation werden Daten durch eine LON Applikation vom Ger tetreiber und somit vom SXLON Netzwerkinterface gelesen Sind keine Daten im internen Puffer des Ger tetreibers vorhanden wird eine frei definierbare Zeit auf das Eintreffen von Daten gewartet bevor der Aufruf zur ckkehrt Blocking Call Wird eine Wartezeit von Null festgelegt ist die funktionsweise identisch zum Aufruf der Funktion ReadFile wird eine Wartezeit von INFINITE festgelegt wird ohne Timeout gewartet Beim Aufruf von DeviceloControl ist das jeweilige ZXLON Netzwerkinterface ber seinen Handle hFile zu spezifizieren Der Parameter dwloControlCode ist mit dem Kommando IOCTL_XLON_READWAIT zu besetzen Im Parameter IpInBuffer wird die Wartezeit f r die Operation ReadWait bergeben wobei es sich um einen Zeiger auf ein DWORD handeln muss Der Wert dieses DWORD spezifiziert die Wartezeit in Millisekunden bei einem Wert von INFINITE wird solange gewartet bis Daten vom ZXLON Netzwerkinterface eingetroffen sind oder der Treiber geschlossen wird Der Parameter nInBufferSize enth lt die L nge des vorigen DWORD mit der Wartezeit Der Zeiger IpOutBuffer muss auf eine Datenstruktur vom Typ APILNI Message zeigen die auch als Application Layer Buffer bezeichnet wird Die Gr e dieser Datenstruktur ist variabel sollte
53. zu starten Wenn der Suchvorgang auf einer Diskette oder einem CD ROM Laufwerk ausgef hrt wird legen Sie zuvor den Datentr ger ein Andere Quellen f r die Suche 1 CD ROM Laufwerke I Andere Quelle angeben I Microsoft Windows Update lt Zur ck Abbrechen e W hlen Sie abh ngig vom Speichermedium das Ihrem Adapter beigef gt ist Diskettenlaufwerke bzw CD ROM Laufwerke aus e Legen Sie die Diskette bzw die CD ROM in das entsprechende Laufwerk ein e Klicken Sie auf Weiter gt Ein Treiber wurde gefunden Assistent f r das Suchen neuer Hardware Ger tetreiber ausw hlen Welcher Treiber soll f r dieses Ger t installiert werden XLON PCI Klicken Sie auf Weiter gt Assistent f r das Suchen neuer Hardware Treiberdateien Suchergebnisse Die Suche nach den Treiberdateien f r das Ger t ist beendet e Klicken Sie auf Weiter gt 12 Assistent f r das Suchen neuer Hardware Ger tetreiberinstallation starten nn Der Ger tetreiber wird mit den Standardeinstellungen installiert I Der Treiber f r folgendes Ger t kann jetzt installiert werden nn XLON PCI Die Hardware kann mit Standardeinstellungen installiert werden Klicken Sie Weiter um Software f r die neue Hardware zu installieren e Klicken Sie auf Weiter gt Dateien werden kopiert 2 x lonpci2 sys Nach D wWINNT system32hdrivers

Bedienungsanleitung deutsch V1.0

Contents

Download Pdf Manuals

Related Search

Related Contents