Eine Reihe von leicht nachvollziehbaren Beispielanwendungen demonstriert die große Vielfalt der mit den Adaptern verfügbaren Funktionen. Es werden GUI-basierte Demonstrations- und Testprogramme mitgeliefert, mit denen die breite Palette der von den Adaptern unterstützten Funktionen genutzt werden kann.
Beispielanwendungen in C, C#, VB und LabVIEW werden mit dem SDK mitgeliefert. Diese unterstützen die verschiedenen Kommunikationsmodi, die von den FarSync-Adaptern unterstützt werden.
Die Windows-basierte Schnittstelle, die für alle FarSync-Karten/Geräte gilt, wird als FarSync Windows API (FsWinAPI) bezeichnet. Sie ist eine Erweiterung der MS Win32 COMM API und ermöglicht es beispielsweise, Anwendungen, die für die Unterstützung von COM-Ports entwickelt wurden, einfach zu portieren, um die FarSync-Unterstützung sowohl im E1- als auch im synchronen oder asynchronen Modus zu nutzen. Dank dieser Standardisierung ist die API auch von Umgebungen auf höherer Ebene wie .NET (C#, VB usw.) leicht zugänglich.
Der größte Teil der API ist leitungsprotokollunabhängig, so dass Anwendungen leicht zwischen ihnen wählen können (z. B. HDLC, Async, LAPB, DAB-ETI usw.).
Die Anzahl und Größe der internen Puffer kann entsprechend den anwendungsspezifischen Latenzanforderungen und Scheduling-Eigenschaften konfiguriert werden.
Die Unterstützung für asynchrone E/A ermöglicht optimierte Anwendungsdesigns ohne die Notwendigkeit von Polling.
FsWinAPI ist eine Obermenge der früheren SDCI-API und daher rückwärtskompatibel mit bestehenden Anwendungen, die zuvor für die FarSync-Karten/Geräte entwickelt wurden.
Das FsWinAPI-Benutzerhandbuch im PDF-Format wird als Teil des Produkts mitgeliefert und. bietet einen umfassenden Satz von Funktionsaufrufdefinitionen und hilfreiche Hinweise zur optimalen Nutzung der Schnittstelle.
Die dynamische Umschaltung zwischen Async- und Sync-Leitungsbetrieb wird unterstützt.
Die Konfiguration der verschiedenen Arten der Leitungssignalisierung, NRZ, NRZI, Manchester Encoding, Conditioned Diphase, FM1 und FM0, wird von den verschiedenen Adaptern der Reihe gehandhabt - eine Liste der unterstützten Leitungssignalformate finden Sie bei dem jeweiligen Adapter.
Es werden sowohl 32- als auch 64-Bit-Anwendungen unterstützt.
Synchrones HDLC, LAPB und V.120
Die FsWinAPI ermöglicht Verbindungen sowohl im rohen HDLC-Frame Modus als auch in den leitungsfehlerkorrigierenden Modi LAPB und V.120. Die Anzahl und Größe der verwendeten Puffer kann konfiguriert werden, um ein optimales Gleichgewicht zwischen Durchsatz und Latenzzeit zu erreichen.
Transparenter Bitstrombetrieb
Der Treiber verfügt über eine integrierte Unterstützung für die transparente Kodierung und Dekodierung von Bitströmen, die eine Reihe gängiger Protokolle verarbeitet, die üblicherweise über einen kontinuierlichen Bitstrom übertragen werden. Zu den verarbeiteten Protokollen gehören G.704, MPEG Video T-DMB, DAB ETI.
Der Treiber kann so konfiguriert werden, dass er die meisten byteorientierten Benutzerframes mit fester Länge erkennt und extrahiert, wobei die Frames in Bezug auf einzelne oder abwechselnde Synchronisierungsmuster, Frame-Länge und Anzahl der Synchronisierungsmuster zur Erfassung der Synchronisierung definiert werden können. Es bietet z.B. Low-Level-Frame-Handling für E1 und DAB-ETI.
Beispielhafte Sende- und Empfangsprogramme, die die gängigen Betriebsarten demonstrieren, werden mit Beispieldateien geliefert.
Unterstützte DAB-Modi:
ETI
ETI(NI, G.703) und ETI(NI, G.704) - an den FarSync-Adaptern vom Typ TE1, TE1R und TE1e.
ETI(NI, V.11) - bei den FarSync-Adaptern vom Typ Flex, T1U, T2U, T2Ue, T2Ee, T4U, T4Ue, T4E+, T4Ee und T2U-PMC.
Die API beherrscht auch völlig transparente Bitstream-Operationen, die z. B. zur Unterstützung eines nicht standardisierten Protokolls oder von Raw Audio verwendet werden können.
Für Bitstream-Operationen unterstützt der Treiber die Möglichkeit, den Umfang der im Datenpfad verwendeten Pufferung zu definieren. Diese Funktion ist unerlässlich, um zuverlässige, kontinuierliche Leitungsübertragungen zu ermöglichen, die für den Bitstrombetrieb erforderlich sind, während die Anwendungen, die sie steuern, neu geplant werden. Diese Pufferungsanforderung muss mit den Latenzbeschränkungen des Übertragungspfads in Einklang gebracht werden.
Hinweis: Für die DAB-STI-Modi sollte die allgemeine Bitstream-Codierungs-/Decodierungsbibliothek verwendet werden.
Erweiterte Taktung
Die FsWinAPI unterstützt die Option der TE1e-Karte, einen extern bezogenen, angepassten Takt zur Ansteuerung der E1-Leitung zu verwenden, was häufig bei DAB- und DMB-Betrieb verwendet wird.
Sie unterstützt auch die erweiterten Taktfunktionen des FarSync T4E+, die es ermöglichen, externe Takte aus der Ferne zu beziehen, anzupassen und an ausgewählte Ports der Adapter zu liefern. Alternativ kann ein Takt von einem der Ports verwendet werden, um die Takte aller anderen Ports zu steuern.
Asynchroner Betrieb
Um eine Schnittstelle mit asynchronen Daten unter Windows zu betreiben, unterstützt der FarSync-Treiber eine Erweiterung der Standard MS COMM API. Dadurch können Anwendungen, die derzeit an serielle Standardschnittstellen unter Windows angeschlossen sind, einfach portiert werden, um FarSync-Anschlüsse im asynchronen Modus zu verwenden.
Der FarSync Flex erscheint als "COM-Port"-Gerät, wenn er für den asynchronen Modus konfiguriert ist, und kann daher direkt mit Standard- oder portierten COM-Port-basierten Anwendungen verwendet werden.
Asynchroner Betrieb ist für den FarSync T4Ee, und FarSync Flex/Flex+ verfügbar.
Die Linux-API ermöglicht Anwendungen das Senden und Empfangen von Frames im HDLC-Format (Bitsync) sowie transparente Bitströme unter Verwendung der Char I/O API.
Die mit dem Developers Toolkit gelieferten Beispielanwendungen demonstrieren beide Betriebsarten. Der Quellcode für die Anwendungen und Treiber ist enthalten, die Handbücher zur Linux-API liegen als PDF vor. Zur Linux-Unterstützung gehört ein Monitorprogramm, mit dem die von der Anwendung gesendeten und empfangenen Daten im Hex-Format aufgezeichnet werden können.
Synchroner und E1-Betrieb
Die API unterstützt Datenübertragungsraten von bis zu 10 Mbit/s pro Port, wobei alle Ports hinsichtlich Geschwindigkeit, Taktrichtung und Betriebsart einzeln ausgewählt werden können. Die von einem bestimmten Adapter unterstützten Höchstgeschwindigkeiten sind in der technischen Spezifikation des jeweiligen FarSync-Produkts angegeben.
Im HDLC-Modus werden Frames bis zu 32 KByte unterstützt, so dass eine Vielzahl von synchronen Spezialprotokollen möglich ist.
Der transparente Bitstrommodus ist für transparente Datenanforderungen wie Audio, MPEG Video T-DMB, DAB STI und DAB ETI geeignet. Siehe auch die allgemeine Bitstream-Kodierungs- und Dekodierungsbibliothek, die dazu beitragen kann, die für diese Art von Anwendungen erforderliche Entwicklungszeit zu verkürzen.
Die API ermöglicht die Auswahl des gesamten Spektrums interner Taktgeschwindigkeiten und auch die Auswahl erweiterter Taktoptionen, die von FarSync-Adaptern wie dem FarSync T4Ee und T4E+ unterstützt werden.
Die Konfiguration der verschiedenen Arten der Leitungssignalisierung, NRZ, NRZI, Manchester Encoding, Conditioned Diphase, FM1 und FM0, wird von den verschiedenen Adaptern der Reihe gehandhabt - eine Liste der unterstützten Leitungssignalformate finden Sie bei dem jeweiligen Adapter.
LAPB-Betrieb
Eine API für das LAPB-Protokoll ist über die hdlcX-Schnittstelle verfügbar. Alle Ports der Adapter können mit dieser Methode angesprochen werden.
Asynchroner Betrieb
Asynchroner Betrieb ist über die Standard-TTY-Schnittstelle für die FarSync-Adapter der Typen T4Ee und FarSync Flex / Flex+ verfügbar. Die dynamische Umschaltung zwischen Async- und Sync-Betrieb wird unterstützt.
Hinweis: Eine Raw Sockets API ist auch unter Linux verfügbar, um die Adapter zu unterstützen, obwohl diese Schnittstelle jetzt veraltet ist.
Die FarSync-API kann auch von LabVIEW-Anwendungen/VIs verwendet werden. Diese Unterstützung umfasst eine Reihe von LabVIEW-kompatiblen Methoden und Eigenschaften, die von einer COM-API-Schnittstellenschicht unterstützt werden, die in erweiterbarer Quellform geliefert wird, - um eine weitere Anpassung durch den Benutzer zu ermöglichen, falls dies für sein spezielles Anwendungsdesign erforderlich ist.
Ein Beispiel-VI (ausführbares LabVIEW-Programm) für Windows ist im FarSync-SDK enthalten. Dieses Beispiel zeigt, wie die Schnittstelle zu den FarSync-Adaptern von LabVIEW aus genutzt werden kann, und veranschaulicht die Steuerung und Konfiguration des FarSync-Ports sowie die beispielhafte Nutzung der Datenübertragung.
Die FarSync-API kann auch von LabVIEW-Anwendungen/VIs verwendet werden. Diese Unterstützung umfasst eine Reihe von LabVIEW-kompatiblen Methoden und Eigenschaften, die in Form von erweiterbarem Quellcode bereitgestellt werden, damit der Benutzer bei Bedarf weitere Anpassungen für sein spezielles Anwendungsdesign vornehmen kann.
Ein Beispiel-VI (ausführbares LabVIEW-Programm) für Linux ist auf Anfrage für die Verwendung mit dem FarSync SDK erhältlich. Dieses Beispiel zeigt, wie die Schnittstelle zu FarSync-Adaptern von LabVIEW unter Linux genutzt werden kann.
Es wird eine Bibliothek zur Verfügung gestellt, die eine Low-Level-Codierung und -Decodierung des transparenten Bitstroms für eine schnelle Anwendungsentwicklung Ihrer Linux-Anwendung ermöglicht. Die Bibliothek kann so konfiguriert werden, dass sie die meisten byteorientierten User Frames fester Länge identifiziert und extrahiert, wobei die Frames in Form von einzelnen oder alternierenden Synchronisierungsmustern, Länge und Anzahl der zu erfassenden Synchronisierungsmuster definiert werden können. Sie bietet zum Beispiel Low-Level-Frame-Handling für E1, DAB-ETI oder DAB-STI.
Die Bibliothek ist auf Anfrage für Windows erhältlich, um die Kompatibilität mit älteren Anwendungen zu gewährleisten oder um den DAB-STI-Modus zu nutzen. Für neue Anwendungen empfehlen wir die Verwendung der im Windows-Treiber integrierten Low-Level-Codierung und -Decodierung.
Beispiele für Sende- und Empfangsprogramme, die gängige Betriebsarten demonstrieren, werden zusammen mit Beispieldateien geliefert.
Unterstützte DAB-Modi:
ETI
ETI(NI, G.703) - bei den FarSync-Adaptern vom Typ TE1, TE1R und TE1e
ETI(NI, V.11) - auf den FarSync-Adaptern vom Typ Flex, T1U, T2U, T2Ue, T2Ee, T4Ee, T4U, T4Ue, T4E+ und T2U-PMC.
STI
STI(PI, G.703) - bei den FarSync-Adaptern des Typs TE1, TE1R und TE1e
STI(PI, V.11) - auf den FarSync-Adaptern vom Typ Flex, T1U, T2U, T2Ue, T2Ee, T4Ee, T4U, T4Ue, T4E+ und T2U-PMC.
Die Bibliothek ist in 32- und 64-Bit-Ausführung erhältlich.
fswdemo wird mit dem FarSync SDK mitgeliefert und ist dazu gedacht, den Betrieb der Windows FsWinAPI-Schnittstelle zu demonstrieren und zu testen sowie ein wirklich nützliches und leistungsfähiges Tool zur Überprüfung verschiedener Betriebsmodi der FarSync-Adapter bereitzustellen.
Es können sowohl HDLC-Frame- als auch Transparent-Bitstream-Modi getestet werden. Die Auswahl und das Testen mehrerer Leitungen und Adapter wird unterstützt.
fswdemo-Beispielkonfigurationsbildschirm
fswdemo bei der Datenübertragung
Benutzerbibliotheken und Testdienstprogramme. Es enthält alles, was ein Benutzer benötigt, um schnell eine Vielzahl von Anwendungen zu entwickeln und zu testen, die synchrone (HDLC framed) Protokolle, V.120, LAPB, asynchrone Daten oder transparente Bitströme einschließlich Audio, G.704, MPEG Video T-DMB, DAB STI und DAB ETI mit den mitgelieferten Bitstrom-Encodern und -Decodern verwenden.
