Home

Bedienungsanleitung deutsch V1.0

1. 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 USB 6 Softwarezugriff nm u nn nn nn 37 6 1 Applikationsschnittstelle unter Windows 37 6 1 1 LNS Anwendungen 37 6 1 2 Konfiguration der Netzwerk Interface Puffer 38 6 1 3 Programmierung einer eigenen Anwendung 38 6 1 3 1 ffnen des Ger tetreibers 38 6 1 3 2 Registrieren eines Event Handles 40 6 1 3 3 Lesen von Daten vom Ger tetreiber 41 6 1 3 4 Schreiben von Daten auf den Ger tetreiber 41 6 1 3 5 Schlie en des Ger tetreibers 42 6 1 3 6 Wichtige Programmierinformationen 42 6 2 Applikationsschnittstelle unter Windows CE 3 0 43 6 2 1 CreateFile 0 0 00 0 43 6 2 5 1 GetVersion ber DeviceloControl 48 6 2 5 2 ReadWait ber DeviceloControl 49
2. message data variable L nge Beispiel BOOL bResult DWORD dwBytesRead APILNI Message Ini_msg Application Layer Buffer f r 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 b
3. USB Blockschaltbild LonWorks Tra sceiver Flash Speicher Steckverbinder Neuron 3150 RAM Speicher Prozessor Service LED _ Takterzeugung Service Pin Taste Powermonitor USB Controller Baustein USB State LED Hostinterface Steckverbinder Technische Details der Hardware Anbindung an das Host System ber den USB Bus Die Ankopplung an den USB erfolgt gem USB Spezifikation Revision 1 1 Die bertragungsrate betr gt 12 Mbit s Der SXLON Gss Adapter ist vollst ndig Plug amp Play kompatibel Er identifiziert sich im System durch die von der USB Implementers Forum zugewiesenen DH electronics GmbH Vendor ID 0x0916 sowie den beiden Device ID s 0x0001 und 0x0002 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 Western Modular Steckverbinder Die bertragungsrate beim FTT 10A Transceiver betr gt 78 5 kBit s Ist der SXLONV ss Adapter mit RS485 Transceiver ausgestattet so k nnen mittels Software verschiedene bertragungsraten eingestellt werden vgl Kapitel 4 1 3 Die maximale bertragungsrate betr gt hier 250kBit s Die Isolationsspannung betr gt 1 5 kV UL rated Neuron Prozessor Core Als Neuron Prozessor kommt ein 3150 Prozessor mit externem Speicherinterface zum Einsatz F r den Pr
4. APILNI_ Message Die folgende Tabelle zeigt nochmals den Aufbau des Application Layer Buffers in grafischer Form command 2 Bytes Application Layer Header length ZXLON USB 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 DeviceloControll 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 tetreib
5. Ben tigen Sie zus tzliche Informationen oder Produktunterst tzung verwenden Sie bitte die unter Produktunterst tzung angegebenen Links SXLON 4 2 Testen des SXLON s Adapters unter Windows 4 2 1 Diagnose mittels Software e ffnen Sie die Eigenschaften Seite des XLONuse Adapters wie in Kapitel 4 beschrieben e ffnen Sie dann die Karteikarte Eigenschaften Eigenschaften von XLON USB E xl Allgemein Eigenschaften Treiber gt gt xLon usB Einstellungen Transceiver D Haaren Automatisches Flush Cancel IV m Diagnose Service Pin Ger tetest Reboot Produktunterst tzung www slon de support amp xlon de DH electronics GmbH 2002 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 XLON uss 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 Ger tes kurz blinken War die Kommunikation mit dem XLON uss Adapter erfolgreich so wird dies angezeigt Reboot Das Bet tigen des Reboot Buttons f hrt zum Zur cksetzen des XLON use
6. BOOL WriterFile HANDLE hFile LPCVOID lpBuffer DWORD nNumberOfBytesToWrite LPDWORD IpNumberO fBytesWritten 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 ZXLON USB 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 Allgem
7. tr gt den Namen des jeweiligen Ger tetreibers und enth lt die in der folgenden Tabelle beschriebenen Eintr ge SXLON Eintrag Typ Beschreibung Dieser Eintrag spezifiziert den Dateinamen der Ger DII REG_SZ tetreiber DLL die der Device Manager l dt hier z B xlon_usbl dll oder xlon_usb dll 3 3 2 4 Hardwarekonfiguration Mit dem Windows CE 3 0 Ger tetreiber k nnen bis zu 127 XLON uss Adapter in einem System verwendet werden Eine weitergehende Hardwarekonfiguration ist durch die Hot Plug and Play F higkeit von USB Systemen nicht notwendig 3 3 3 Neuinstallation unter Linux Derzeit ist f r den SXLONVss Adapter kein Linux Treiber verf gbar 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 Suchen z X Drucker I Hilfe A Taskleiste und Startmen Ausf hren a Beenden Systemste
8. ZXLON USB oO Bedienungsanleitung ZXLON s 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 ZXLONvs Adapter Version 1 0 m Inhaltsverzeichnis XLON USB 1 Zu diesem Handbuch 0 0 un 5 2 Einleitung Produktinformation 5 3 Installation des gt XLONGs Adapters 7 3 1 Hinweise nn u nn n m 7 3 2 Hardwareinstallation 0 0 00 7 3 3 Software Treiberinstallation 9 3 3 1 Neuinstallation unter Windows 9 3 3 2 Neuinstallation unter Windows CE 3 0 16 3 3 2 1 Hinzuf gen zu laufendem Windows CE System 16 3 3 2 2 Erstellen eines neuen Windows CE Image
9. 05 TP RS485 39 RS 485 twisted pair 39 kbps 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 SXLONVss Adapter zugreifen so mu man lediglich als Netzwerkinterface den SXLONGss Adapter angeben den man verwenden m chte Die Ger tetreiber unterst tzen bis zu 127 _ XLONVss Adapter pro PC System d h Sie k nnen mehrere SXLON Gss Adapter parallel in Ihrem System verwenden Die Ger te 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 XLON vss Adapter unter dem Netzwerk Interface Namen XLON USB x x EXLONVss Netzwerk Interface Nummer z B XLON USB 0 gt erster im System eingebaute XLON uss Adapter Beispielhaft zeigt der folgende Bildschirmauszug die Konfiguration in der Anwendung LonMaker for Windows Network Wizard Network Interface IV Network Attached Network Interface Name XLON USB 0 J Skip this prompt when re opening this drawing lt Back Cancel Help 6 1 3 6 1 3 1 ZXLON USB 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 Netzwerk und Applikations P
10. 6 2 6 GetlastError 0 0 50 6 3 Applikationsschnittstelle unter Linux 51 7 Anhang m un u nn nn nn nn 52 7 1 EG Konformit tserkl rung 52 8 nderungsstand Dokument 53 ZXLON USB Zu diesem Handbuch Dieses Handbuch soll den Anwender bei der Installation und Konfiguration des XLON use 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 ZXLONVGss Adapter erm glicht den Anschluss eines PC oder Notebook an ein LonWorks Netzwerk ber den Universal Serial Bus kurz USB Er ist konzeptioniert f r den Einsatz in der Industrie der Prozess und der Geb udeautomation Der XLON use Adapter unterst tzt sowohl das LNS Netzwerk Service Interface N
11. Fehlerursache ber den Aufruf der Funktion GetLastError erlangt werden Fehlerursachen Als wahrscheinliche 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 CreatefFile 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
12. aktiviert ndern der Transceiver ID Stellen Sie sicher dass m gliche Transceiver Einstellungen mit der Hardware bereinstimmen Der SXLON ss Adapter wird bei einer falschen Einstellung nicht funktionieren e Klicken Sie auf die Dreiecks Taste vw neben dem Anzeigenfeld 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 SXLON Automatic Flush Cancel Ein Ausschalten Nach jedem Reset des XLON uss 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 SXLONGss 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 SXLONvss 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 s Adapter gesendet werden mu e Klicken Sie mit der linken Maustaste in das Feld neben Automatic Flush Cance 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
13. 70 C Lagertemperatur 45 C bis 85 C maximale Luftfeuchtigkeit 90 bei 50 C nicht kondensierend 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 123 x 68 x 30 mm 4 84 x 2 68 x 1 18 L nge x Breite x H he Gewicht 100g Die Hardware des XLON use Adapters unterst tzt bis zu 127 Ger te pro USB System im PC Multiple Device Unterst tzung ZXLON USB 5 1 2 Steckverbinder Als Steckverbinder f r den LonWorks Anschlu des SXLON ss Adapters kommt bei der FTT 10A Varonte ein Steckverbinder der Serie BL3 5 der Firma Weidm ller zum Einsatz Bei der RS485 Variante kommt ein Western Modular RJ45 Steckverbinder zum Einsatz Netzwerktyp Polzahl Weidm ller Bezeichnung Bestellnummer Free Topologie FTT 2 polig BL3 5 2F SN OR 160664 Der maximal einklemmbare Leitungsquerschnitt betr gt beim Weidm ller Steckverbinder 1 5 mm Bestellinformationen sowie weitere detaillierte Informationen f r diese Buchsenleiste finden Sie unter Steckerbelegung Pinbelegung Anschlu buchse LON FTT 10A RS485 1 8 2 1 H Pin FTT 10A RS485 1 NET B RS485 A NET A RS485 B 4 nicht vorhanden GND 5 1 3 5 1 4
14. Funktion DeviceloControl verwendet Unter Windows 2000 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 Win
15. Zugriff auf den Ger tetreiber zur ck Als Ger tetreibername muss xlonusb0 verwendet werden 2 _ pHandle CreateFile xlonusb0 GENERIC_READ GENERIC_WRITE FILE_SHARE_READ FILE_SHARE_WRITE LPSECURITY_ATTRIBUTES NULL OPEN_EXISTING 0 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 USB Lesen von Daten vom Ger tetreiber Zum Lesen von Daten wird unter Windows98 ME das Kommando LDV_Read in der Windows API
16. die Hardware Beispielprogramme f r den Zugriff auf die Treiber unter C C und VisualBasic zum Download finden Sie unter http www xlon de Lieferumfang e ZXLON s Ger t USB Kabel 1 Meter e Weidm ller Klemme f r LonWorks Netzwerk Anschlu nicht bei RS485 Version e Diskette CD mit Treibern Installations Kurzanleitung Verf gbare Varianten e USB4 WM FTT mit integriertem FTT 10A Transceiver e USB4 RJ 485 mit integriertem RS485 Transceiver Weitere Informationen zu LonWorks Netzwerken finden Sie unter www echelon com ZXLON 3 Installation des SXLON s Adapters 3 1 Hinweise Der PC muss zur Hardwareinstallation des XLONuse Adapters nicht heruntergefahren werden 3 2 Hardwareinstallation F x by DH electronics page a a en i 5 D I 2 3 4 1 Nr Bezeichnung Bemerkung 1 Anschlu buchse LON 2 polig FTT 10A Transceiver Variante RJ45 RS485 Transceiver Variante 2 LED gr n STATE Aus Nicht betriebsbereit Ein Betriebsbereit 3 LED gelb SERVICE Anzeige Service Pin Neuron Prozessor Service Pin Taster Manuelles Ausl sen der Service Pin Meldung Anschlu USB Bitte mitgeliefertes Kabel verwenden Pinbelegung Anschlu buchse LON FTT 10A RS485 Pin FTT 10A RS485 1 NET B RS485 A NET A RS485 B 4 nicht vorhanden GND Den ZXL
17. Adapters in den Auslieferungszustand Diese Aktion sollte nur von erfahrenen Benutzern durchgef hrt werden ZXLON USB Diagnose mittels Leuchtdioden Wie in Kapitel 3 2 beschrieben besitzt der XLONis Adapter zwei Visualisierungsleuchtdioden Eine gr ne Status Leuchtdiode und eine gelbe Service Pin Leuchtdiode Gr ne Status Leuchtdiode Die gr ne LED zeigt an ob das Ger t betriebsbereit ist oder nicht Leuchtet die LED ist das Ger t betriebsbereit und die Treiber sind richtig geladen Ist diese Leuchtdiode aus ist das Ger t nicht betriebsbereit oder es ist noch kein Ger tetreiber installiert bzw geladen Der XLON uss Adapter kann sich auch im Suspend Stromspar Modus befinden Gelbe Service Pin Leuchtdiode Die gelbe LED visualisiert den Zustand der Neuron Prozessor Service Pin Leitung Ist der Ger tetreiber richtig installiert f r den SXLON ss Adapter richtig installiert so ist die Leuchtdiode aus Blinkt die LED mit 2 Hz so ist der Zustand des XLONuse 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 XLON uss Adapter zugreifen so liegt ein Problem in der Hardware vor Schl gt der Zugriff aus einer Anwendung fehl und ver ndert sich der Zustand der Le
18. Length 2 Begin of Data 3 Byte Length Network 11 Byte Adress 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 USB Windows98 ME Die Funktion CreateFile ffnet den Ger tetreiber f r den XLON uss Adapter und liefert ein Handle f r den Zugriff auf den Ger tetreiber zur ck Als Ger tetreibername muss xlonusb0 verwendet werden 2 pHandle CreateFile xlonusbO GENERIC_READ GENERIC_WRITE O O OPEN_EXISTING O 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 XLON uss Adapter und liefert ein Handle f r den
19. ONVss Adapter ber das mitgelieferte USB Kabel an einen freien USB Port anschlie en e LonWorks Netzwerk Kabel anstecken e Bei Windows basierenden Systemen startet der Assistent f r das Suchen neuer Hardware siehe Kapitel 3 3 1 e Zur Installation der Ger tetreiber unter Windows CE ist entsprechend Kapitel 3 3 2 vorzugehen Deinstallation Stecken Sie den XLONuss Adapter vom USB Port ab 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 Anstecken des XLONuse Adapters erscheint folgende Meldung Neue Hardware gefunden Sa USB Device Bitte warten Der Assistent f r das Suchen neuer Hardware wird automatisch gestartet Assistent f r das Suchen neuer Hardware 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 ZXLON USB Assistent f r das Suchen neuer Hardware Hardwaretreiber installieren Ein Ger tetreiber ist ein Programm das das Ansprechen des Ger ts durch das Betriebssystem erm glicht e bernehmen Sie die oben abgebildete Vorgehensweise und klicken Sie auf W
20. OutBuffer 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 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
21. SI 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 XLON use 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 ss 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 XLONvss Adapter hat entweder einen integrierten FTT 10A Transceiver f r Free ZXLON Topology und Link Power Netzwerke oder einen RS485 Transceiver f r Twisted Pair Netzwerke Der SXLONGss Adapter besitzt zur Visualisierung der Betriebszust nde eine Service und eine Status Leuchtdiode F r die manuelle Installation ist ein Service Pin Taster nach au en gef hrt Die downloadbare Firmware erm glicht Updates ohne Zugriff auf
22. dows2000 XP WriteFile pHandle ni_out_Msg length amp 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 ZXLON USB 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 SXLONVGss Adapter programmiert so muss bei der Initialisierung des Ger tes eine Programm ID in das Ger t 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
23. einen 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 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 SXLON Fehlerursachen Als wahrscheinliche Feh
24. eiter gt Assistent f r das Suchen neuer Hardware Suche nach Treiberdateien Geben Sie an wo nach den Treiberdateien gesucht werden soll M BE BE E e W hlen Sie abh ngig vom Speichermedium das Ihrem Ger t beigef gt ist Diskettenlaufwerke bzw CD ROM Laufwerke aus e Legen Sie die Diskette bzw die CD ROM in das entsprechende Laufwerk ein Klicken Sie auf Weiter gt 10 de 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 Generic Device Klicken Sie auf Weiter gt Assistent f r das Suchen neuer Hardware Treiberdateien Suchergebnisse e Klicken Sie auf Weiter gt 11 Die Suche nach den Treiberdateien f r das Ger t ist beendet Assistent f r das Suchen neuer Hardware Ger tetreiberinstallation starten en Der Ger tetreiber wird mit den Standardeinstellungen installiert I Der Treiber f r folgendes Ger t kann jetzt installiert werden XLON USB Generic Device Die Hardware kann mit Standardeinstellungen installiert werden Klicken Sie weiter um Software f r die neue Hardware zu installieren lt Zur ck Klicken Sie auf Weiter gt Assistent f r das Suchen neuer Hardware Dateien we iA lonusbl sys Nach D WINNT system324drivers Nach Beendigung des Installationsvorgang
25. en Fenster des ZXLON ss Adapters rechte Maustaste 21 e Klicken Sie auf den Reiter der Karteikarte Treiber Eigenschaften von XLON USB A xl Allgemein Eigenschaften Treiber gt gt xLon usB Treiberanbiete DH electronics GmbH Treiberdatum Nicht verf gbar Treiberversion 1 0 6 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 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 Ansprechen des G
26. er 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 23 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 Derzeit ist f r den SXLONVss Adapter kein Linux Treiber verf gbar 3 4 Deinstallation Eine Deinstallation der Software ist nicht erforderlich Es gen gt das Abstecken des XLONVss Adapters Informationen hierzu finden Sie in Kapitel 3 2 4 ZXLON USB Inbet
27. er 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 GetLastError 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 6 3 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 LONDEV_NOT_FOUND LONDEV ALREADY_OPEN LONDEV_NOT_OPEN LONDEV_DEVICE_ERR LONDEV_INVALID_DEVICE ID LONDEV_NO_MSG _AVAIL LONDEV_NO_BUFF AVAIL LONDEV NO RESOURCES LONDEV_INVALID_BUF LEN LONDEV_DEVICE_BUSY LonDevCode SXLON no error detected device not found device already open not a handle to a open device device detect error invalid device id was detected no message available buffer is full no more resources available invalid buffer length device is busy Applikationsschnittstelle unter Linux Derzeit ist f r den SXLONVss Adapter kein Linux Treiber verf gbar 7 1 EG Konformi
28. es Assistent f r das Suchen neuer Hardware Fertigstellen des Assistenten NS XLON USB Generic Device Die Software f r dieses Ger t ist jetzt installiert funktioniert jedoch m glicherweise nicht richtig gt Klicken Sie auf Fertig stellen um den Vorgang abzuschlie en lt Zur ck Abbrechen e Klicken Sie auf Fertig stellen 12 ZXLON Nach dem Installieren des XLONuss Generic Ger tetreiberss muss ein zweiter Ger tetreiber installiert werden Es erscheint folgende Meldung Neue Hardware gefunden xLON USB RR Bitte warten Der Assistent f r das Suchen neuer Hardware wird automatisch gestartet Assistent f r das Suchen neuer Hardware Br I Willkommen Dieser Assistent installiert einen Treiber f r ein Ger t Klicken Sie auf weiter um den Yorgang fortzusetzen Abbrechen lt Zur ck e Klicken Sie auf Weiter gt Assistent f r das Suchen neuer Hardware Hardwaretreiber installieren I Ein Ger tetreiber ist ein Programm das das Ansprechen des Ger ts durch das Betriebssystem erm glicht Der Assistent wird die Installation des Ger ts fertig stellen 2 XLON USB 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 vorgehe
29. f hrliche Beschreibung wird auf die Windows CE 3 0 Dokumentation verwiesen die in der Microsoft MSDN Library bzw in der Microsoft Windows CE Platform Builder 3 0 Library zu finden ist CreateFile HANDLE CreaterFile 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 LONI 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 ZXLON INVALID_HANDLE_ VALUE zur ckgeliefert dann k nnen detailliertere Informationen zur
30. gegriffen werden kann Der Ger tetreibername f r den ZXLON ss Adapter lautet xlonusbO 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 ZXLON vss Adapter findet man unter dem Alias Namen XLON USB x EXLONVss Netzwerk Interface Nummer z B XLON USB 0 gt erster im System eingebauter SXLON ss 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
31. hFile zu spezifizieren Der Parameter dwloControlCode ist mit dem Kommando IOCTL_XLON_GETVERSION zu besetzen Die Parameter IpInBuffer bzw nInBufferSize 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 Ge
32. ich die Nummer der Treiberinstallation 97 e Um die Versionsnummer des Treiber zu erfahren klicken Sie auf Treiberdetails Details ber Treiberdateien zn XLON USB Treiberdateien D WINNT4system32 drivers slonusb2 sys D WINNT system32 drivers slonusbl sys D WINNT system32 slonpp2 dil D WINNT system32 slonutil dll Anbieter DH electronics GmbH Dateiversion 1 0 6 Copyright Copyright 2002 by DH electronics 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 USB 4 1 3 Eigenschaften des SXLONGs Adapters e Klicken Sie auf den Reiter der Karteikarte Eigenschaften Eigenschaften von XLON USB Allgemein Eigenschaften Treiber uw KLON USB m Einstellungen Transceiver ID Automatisches Flush Cancel IV Diagnose Service Pin Ger tetest Reboot m Produktunterst tzung www xlon de support amp xlon de DH electronics GmbH 2002 Abbrechen E Die aktuelle Konfiguration des XLONus s Adapters f r Transceiver ID und Automatic Flush Cancel wird angezeigt Im Auslieferungszustand sind folgende Einstellungen vorgenommen Transceiver ID TP FT 10 78kbps Automatic Flush Cancel
33. il und xlon_usb dil ins Verzeichnis _WINCEROOT PLATFORM CEPC FILES e Kopieren Sie die Komponentendatei xlon cec ins Verzeichnis CEPBDir CEPB CEC e 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 gen Sie im Platform Builder die Registrierungsinformationen wie unter Kapitel 3 3 2 3 beschrieben manuell zur Datei platform reg hinzu F gen Sie den Inhalt der Datei xlon_usb bib manuell im Platform Builder zur Datei platform 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 XLONuss Komponenten xlonusbl und xlonusb 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 Die Ger tetreiber f r den XLON uss Adapter werden durch das USB Subsystem von Windows CE nach dem Booten des Zielsystems automatisch geladen und stehen f r Ihre Applikationen zur Verf gung Regis
34. islang beschriebenen Funktionen nicht m glich sind Zur Zeit sind dies die Operationen GetVersion und ReadWait die durch die Kommandos IOCTL_XLON _GETVERSION bzw IOCTLXLON_READWAIT aufgerufen werden k nnen 6 2 5 1 ZXLON USB 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 kodiert 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
35. k Library DLL f r die folgenden Prozessor Plattformen implementiert e ARM e MIPS e SH3 e SH4 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 127 ZXLONVss Adapter in einem System 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 sind die Treiberdateien xlon_usbl dil und xlon_usb dll manuell in das Verzeichnis Windows zu kopieren Anschlie end sind die Registrierungseintr ge wie im Kapitel 3 3 2 3 beschrieben anzulegen 3 3 2 3 ZXLON USB Erstellen eines neuen Windows CE Images Um den Ger tetreiber f r den XLONuse 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 Hardwarearchitekturen erfolgt analog allerdings k nnen sich plattformspezifische Verzeichnispfade unterscheiden e Kopieren Sie die Ger tetreiberdateien xlon_usbl d
36. kann bei falschen Werten der Puffergr e der XLONuse Adapter funktionslos werden Dieser Zustand kann nur noch mittels Reboot des Ger tes 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 3 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 ZXLON USB 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 aus
37. kannt ist Der Aufbau ist im folgenden Punkt dargestellt ber den Parameter nNumberOfBytesToRead wird die f r den jeweiligen 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 ZXLON USB 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
38. lerursachen f r ein Fehlschlagen dieser Funktion kommen ein ung ltiger Handle auf den Ger tetreiber ein fehlerhaft aufgebauter Application 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 be
39. n 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 XLON USB e W hlen Sie abh ngig vom Speichermedium das Ihrem Ger t 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 Suche nach Treiberdateien Geben Sie an wo nach den Treiberdateien gesucht werden soll m m m a 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 14 Nach Beendigung des Installationsvorganges Assistent f r das Suchen neuer Hardware Fertigstellen des Assistenten XLON USB Die Software f r das Ger t wurde installiert gt Klicken Sie auf Fertig stellen um den Vorgang abzuschlie en lt Zur ck e Klicken Sie auf Fertig stellen 15 Abbrechen 3 3 2 1 ZXLON USB 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 Lin
40. ogrammspeicher wird wiederbeschreibbarer Flashspeicher und als Datenspeicher wird SRAM Speicher verwendet Der Neuron Prozessor ist mittels des Neuron Parallel IO Modells an den USB Controller Baustein angekoppelt Adresstabelle 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 SXLON 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 XLONVss Adapters grunds tzlich unterst tzten LON Transceiver ID s Abh ngig von dem physikalisch auf dem Ger t 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
41. r tetreiber in Frage SXLON 6 2 5 2 ReadWait ber DeviceloControl Beschreibung Die Operation ReadWait ist die synchrone blockierende Variante der Funktion 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 Ip
42. riebnahme und Test Starten Sie den Ger te Manager und ffnen Sie das Eigenschaften Fenster des XLON use Adapters siehe Kapitel 3 3 4 Vorgang Ansicht e gt am Eele ala g LEDA 3 Anschl sse COM und LPT g Audio Video und Gamecontroller m Computer Datentr ger Diskettencontroller Diskettenlaufwerke A DYD CD ROM Laufwerke Grafikkarte HE IDE ATAJATAPI Controller TA M use und andere Zeigeger te Modems Monitore EF Netzwerkadapter a Systemger te F Tastaturen amp USB Controller gt XLON LonTalk Adapter JSB Deaktivieren Deinstallieren Nach ge nderter Hardware suchen Eigenschaften Das Eigenschaften Fenster ffnet sich ZXLON USB oO 4 1 berpr fen der Einstellungen unter Windows 4 1 1 Allgemeine Einstellungen Karteikarte Allgemein Eigenschaften von XLON USB 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 USB Die Daten des aktuellen Treibers werden angezeigt Die angezeigte Versionsnummer hinter dem Begriff Treiberversion ist nicht die Versionsnummer der Treiberdatei sondern ledigl
43. s 17 3 3 2 3 Registrierungseintrag 17 3 3 2 4 Hardwarekonfiguration 18 3 3 3 Neuinstallation unter Linux 18 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 00 00 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 Eigenschaften des SXLONGs Adapters 29 4 2 Testen des SXLONvss Adapters unter Windows 31 4 2 1 Diagnose mittels Software 31 4 2 2 Diagnose mittels Leuchtdioden 32 5 Technische Informationen 33 5 1 Hardware m nn nn nn nn nn nn nn nn 33 5 1 1 Allgemeine Informationen 33 5 1 2 Steckverbinder 0 0 0 34 5 1 3 Blockschaltbild un 0 0 35 5 1 4 Technische Details der Hardware 35 5 1 5 Unterst tzte Transceiver
44. t tserkl rung Das Produkt Fabrikat XLON uss Typbezeichnung en USBA4 WM FTT USB4 RJ 485 und 229838 Interface LON PC USB 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 angewandt 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 USB 8 Anderungsstand Dokument p A be Status Veran Kommentar Version ao s Anderung lasser 1 0 21 02 03 Grundversion verab StS schiedet
45. trierungseintrag Ein Beispiel f r einen korrekten Registrierungseintrag ist in der Datei xlon_usb reg zu finden Eine Erl uterung des Inhalts wird im folgenden Abschnitt gegeben HKEY_LOCAL_MACHINE Drivers USB LoadClients Der Registrierungsschl ssel HKEY_LOCAL_MACHINE Drivers USB LoadClients enth lt Unterschl ssel mit denen festgelegt wird welchen Ger tetreiber das USB Subsystem f r welches USB Ger t l dt Wird nach dem Anstecken eines USB Ger ts ein zugeh riger Registrierungseintrag gefunden so wird der zugeh rige Treiber geladen ansonsten wird der Benutzer zur Eingabe eines Treibers aufgefordert Die Unterschl ssel von LoadClients haben die Form Groupl_ID Group2_ID Group3_ID Driver Name wobei sich die Zeichenkette mit dem Namen der Treiberdatei unter dem letzten Schl ssel Driver Name befindet F r den ZXLON ss Adapter ist nur die Groupl_ID von Bedeutung diese spezifiziert die Vendor und Product ID des Ger ts getrennt durch einen Underscore Die Group2_ID spezifiziert die Deviceklasse die Group3_ID die Interfaceklasse die vom Treiber unterst tzt wird Da der XLONuss Adapter durch die Group1_ID eindeutig gekennzeichnet ist sind die Group2_ID und Group3_ID auf den Wert Default gesetzt d h der XLON use Treiber wird immer dann geladen wenn ein USB Ger t mit der passenden Vendor und Product ID am USB angesteckt wird Der Unterschl ssel Driver Name
46. uchtdiode nicht so ist vermutlich kein Ger tetreiber installiert Gelbe Service Pin LED Beschreibung Konstant aus EXLONVss Adapter ist richtig installiert und betriebsbereit wenn wenn gr ne LED konstant an ist oder EXLONVss Adapter ist nicht richtig installiert wenn gr ne LED konstant aus ist Konstant ein Ein Hardwaredefekt liegt vor Blinkt mit Ya Hz Zustand des XLON use Adapters ist Unconfigured d h der SXLON s Adapter hat keine Netzwerkadresse Blitzt 1 mal kurz auf ein Reset auf den XLON use Adapter wurde ausgef hrt oder ein Ger tetest wurde durchgef hrt 5 1 5 1 1 Technische Informationen Hardware Allgemeine Informationen Bus Anschlu USB konform gem USB Spezifikation Revi sion 1 1 12 Mbit s Netzwerkanschlu FTT 10A RS485 2 poliger Stecker Weidm ller mit Schraub klemmen und Zugentlastung Western Modular RJ45 Steckverbinder 8 polig Stromversorgung Erfolgt ber USB 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 galvanisch isolierter RS485 integriert Netzwerk Topologien FTT 10A RS485 Free Topology und Link Power Twisted Pair Daten f r Stromversorgung 5 V DC 5 100 mA typisch Betriebstemperatur 0 C bis
47. uerung ZXLON USB lolx Datei Bearbeiten Ansicht Favoriten Extras 2 zur ck gt suchen Gyordner C4verlaur 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 I Anschl sse COM und LPT amp Audio Video und Gamecontroller 3 Diskettencontroller Diskettenlaufwerke DYD CD ROM Laufwerke Grafikkarte H 6 IDE ATAJATAPI Controller M use und andere Zeigeger te Modems Monitore E Netzwerkadapter Systemger te 3 Tastaturen USB Controller gt XLON LonTalk Adapter XLON USB Eigenschaften e ffnen Sie das Eigenschaft
48. uffer des Neuron Prozessors ver ndern E Network Interface 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 SXLONvss 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 Betriebssystem liefert beim erfolgreichen Zugriff ein Handle zur ck ber den anschlie end auf den Treiber zu

Bedienungsanleitung deutsch V1.0

Contents

Download Pdf Manuals

Related Search

Related Contents