FarSync SDK - Das Entwickler-Toolkit für FarSync Adapter

Das FarSync SDK Developers Toolkit bietet alles, was der Entwickler benötigt, um die APIs auf allen FarSync-Adaptern zu verwenden.

Das Developers Toolkit

Das SDK unterstützt das Schreiben von Anwendungen für die Nutzung der FarSync-Produktreihe unter Linux und Windows. Es enthält Dokumentation, funktionierende Beispielanwendungen, Benutzerbibliotheken und Testanwendungen. Es gibt alles, was ein Anwender benötigt, um eine Vielzahl von Anwendungen mit synchronen (HDLC gerahmten) Protokollen, V.120, LAPB, asynchronen Daten oder transparenten Bitströmen wie Audio, G.704, MPEG Video T-DMB, DAB STI und DAB ETI mit dem mitgelieferten Bitstream-Encoder und Decoder schnell zu entwickeln und zu testen.

Das SDK soll einen einfachen Zugriff auf die Hardware-Features der verschiedenen Adapter der FarSync-Reihe ermöglichen und gleichzeitig zusätzliche Software-Kodierung und -Dekodierung als Ergänzung zur Hardware bieten.

Das FarSync SDK unterstützt APIs für die folgenden Produkte
Products supported by the SDK Adapter Type Product Code Windows API Linux API
FarSync Flex
USB
FS4100
yes
yes
FarSync T1U
PCI
FS4140
yes
yes
FarSync T2U
PCI
FS4240
yes
yes
FarSync T4U
PCI
FS4440 / FS4441
yes
yes
FarSync T4E+
PCI
FS4446
yes
yes
FarSync TE1
PCI
FS4150
yes
yes
FarSync TE1R
PCI
FS4151
yes
yes
FarSync TE1e
PCIe
FS4155
yes
yes
FarSync T2Ue
PCIe
FS4250
yes
yes
FarSync T2Ee
PCIe
FS4256
yes
yes
FarSync T4Ue
PCIe
FS4450 / FS4451
yes
yes
FarSync T4Ee
PCIe
FS4456
yes
yes
FarSync T2U-PMC
PMC
FS4280 / FS4281
yes
yes
FarSync M1P
PCMCIA
FS4130 / FS4133
yes
no

Unsere technische Abteilung bietet Anwendungsentwicklern, die die API als Teil des Pakets nutzen, das beim Kauf des FarSync SDKs zur Verfügung gestellt wird, kostenlose E-Mail- und Telefonunterstützung.

Dieses Toolkit ist nicht für die FarSync X25 Produktreihe geeignet, sie werden mit einem eigenen speziellen X.25 Toolkit geliefert. Die FarSync X25-Karten können auch Betriebsarten unterstützen, wie auf dieser Seite gleichzeitig mit X.25 beschrieben.

Produkt API Details

FarSync Windows API (FsWinAPI)

Die Windows-basierte Schnittstelle, die für die gesamte Palette der FarSync-Karten/Geräte gemeinsam ist, wird als FarSync Windows API (FsWinAPI) bezeichnet. Dies ist eine Erweiterung der MS Win32 COMM API und ermöglicht z.B. Anwendungen, die zur Unterstützung von COM-Ports entwickelt wurden, eine einfache Portierung, um die FarSync-Unterstützung sowohl im E1-, synchronen als auch im asynchronen Modus zu nutzen. Diese Standardisierung ermöglicht es, dass die API auch in höherwertigen Umgebungen wie .NET (C#, VB etc.) leicht zugänglich ist.

Der Großteil der API ist leitungsprotokollunabhängig, so dass Anwendungen problemlos zwischen ihnen wählen können (z.B. HDLC, Async, LAPB, DAB-ETI etc.).

Die Anzahl und Größe der internen Puffer kann so konfiguriert werden, dass sie den anwendungsspezifischen Latenzanforderungen und Planungsmerkmalen entspricht.

Die Unterstützung von asynchronen I/Os ermöglicht optimierte Anwendungsdesigns ohne Polling.

FsWinAPI ist eine Obermenge der früheren SDCI-API und damit rückwärtskompatibel zu bestehenden Anwendungen, die zuvor für die FarSync-Karten/Gerätefamilie entwickelt wurden.
Das FsWinAPI-Benutzerhandbuch im Adobe PDF-Format bietet eine umfassende Reihe von Definitionen von Funktionsaufrufen und hilfreiche Ratschläge für die optimale 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 werden von verschiedenen Adaptern im Sortiment übernommen - siehe die jeweiligen Adapter für eine Liste der unterstützten Leitungssignalformate.

Es werden sowohl 32- als auch 64-Bit-Anwendungen unterstützt.

Synchrones HDLC, LAPB und V.120

Die FsWinAPI ermöglicht Verbindungen sowohl im Roh-HDLC-Frame-Modus als auch in den Modi LAPB und V.120 zur Leitungskorrektur. Die Anzahl und Größe der verwendeten Puffer kann konfiguriert werden, um ein optimales Verhältnis von Durchsatz und Latenzzeit zu erreichen.

Transparenter Bitstrombetrieb

Der Treiber verfügt über eine integrierte Unterstützung für transparente Bitstream-Kodierung und -Dekodierung, die eine Reihe gängiger Protokolle verarbeitet, die üblicherweise über einen kontinuierlichen Bitstrom übertragen werden. Zu den behandelten Protokollen gehören G.704, MPEG Video T-DMB, DAB ETI.

Der Treiber kann konfiguriert werden, um die meisten byteorientierten Benutzerrahmen mit fester Länge zu identifizieren und zu extrahieren, wobei die Rahmen in Form von einzelnen oder alternativen Synchronisationsmustern, Rahmenlänge und Anzahl der Synchronisationsmuster zur Erfassung der Synchronisation definiert werden können. Es bietet z.B. Low-Level-Frame-Handling für E1 und DAB-ETI.

Beispielhafte Sende- und Empfangsprogramme, die gängige Betriebsarten demonstrieren, werden mit Beispieldatendateien geliefert.

Unterstützte DAB-Modi:

ETI
ETI(NI, G.703) und ETI(NI, G.704) - auf den FarSync-Adaptern vom Typ TE1, TE1R und TE1e.
ETI(NI, V.11) - auf den FarSync-Adaptern vom Typ Flex, T1U, T2U, T2Ue, T2Ee, T4U, T4U, T4Ue, T4E+ und T2U-PMC.

Die API ermöglicht auch einen völlig transparenten Bit-Streaming-Betrieb, der z.B. zur Unterstützung eines nicht standardisierten Protokolls oder z.B. von Roh-Audio verwendet werden kann.

Für Bitstream-Operationen unterstützt der Treiber die Möglichkeit, die Menge 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 Bitstream-Betrieb erforderlich sind, während die Anwendungen, die sie steuern, neu geplant werden. Diese Pufferungsanforderung muss mit den Latenzbeschränkungen der Übertragungsstrecke abgeglichen werden.

Hinweis: Für DAB-STI-Modi sollte die General Bitstream Encoding - Decoding Library verwendet werden.

Erweiterte Clocking

Die FsWinAPI unterstützt die Option der TE1e-Karte, einen extern bezogenen, ratenangepassten Takt zum Betreiben der E1-Leitung zu verwenden, was häufig im DAB- und DMB-Betrieb verwendet wird.

Es unterstützt auch die erweiterten Taktungsfunktionen des FarSync T4E+, mit denen externe Taktgeber aus der Ferne bezogen, ratenangepasst und an ausgewählte Ports der Adapter geliefert werden können. Alternativ kann eine Uhr von einem der Ports verwendet werden, um die Uhren aller anderen Ports zu betreiben.

Asynchroner Operationsbetrieb

Um einen Port 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 Standard-Schnittstellen unter Windows angeschlossen sind, einfach portiert werden, um FarSync-Ports im asynchronen Modus zu verwenden.

Der FarSync Flex erscheint tatsächlich als "COM-Port"-Gerät, wenn er für den Async-Modus konfiguriert ist, und kann daher direkt mit Standard- oder portierten COM-Port-Anwendungen verwendet werden.

Für die FarSync T4U+Async, T4E+, T4Ue+, T4Ue+Async und Flex ist ein asynchroner Betrieb möglich.

Anwendungsbeispiele

Es werden eine Reihe von leicht verständlichen Beispielanwendungen bereitgestellt, die die Vielfalt der mit den Adaptern verfügbaren Funktionen demonstrieren. GUI-basierte Demonstrations- und Test-Utilities werden mitgeliefert, die in der Lage sind, die breite Palette der von den Adaptern unterstützten Funktionen zu nutzen.

C-, C#-, VB- und LabVIEW-Beispielanwendungen werden mit dem SDK ausgeliefert. Diese unterstützen die verschiedenen Kommunikationsmodi, die von den FarSync-Adaptern unterstützt werden.

Linux Char I/O API

Die Linux-API ermöglicht es Anwendungen, HDLC-Format (bitsync) Frames zu senden und zu empfangen sowie transparente Bitstreams über die Char I/O-API.

Die mit dem Developers Toolkit ausgelieferten Beispielanwendungen zeigen beide Betriebsarten. Die Quellen für die Anwendungen und Treiber sind enthalten, wobei die Handbücher der Linux-API im Adobe PDF-Format zur Verfügung gestellt werden. Im Linux-Support ist ein Monitorprogramm enthalten, mit dem die von der Anwendung gesendeten und empfangenen Daten im Hex-Format aufgezeichnet werden können.

Synchron- und E1-Betrieb

Die API kann Datenraten bis zu 10 Mbit/s pro Port unterstützen, wobei alle Ports individuell nach Geschwindigkeit, Taktrichtung und Betriebsart wählbar sind. Für die maximalen Geschwindigkeiten, die von einem bestimmten Adapter unterstützt werden, siehe die technischen Daten der FarSync-Produkte.

Frame-Größen bis zu 32 Kbyte werden im HDLC-Modus unterstützt, um die Unterstützung für eine Vielzahl von speziellen synchronen Protokollen zu ermöglichen.

Der transparente Bitstream-Modus eignet sich für transparente Datenanforderungen wie Audio, MPEG Video T-DMB, DAB STI und DAB ETI. Siehe auch die Allgemeine Bitstream-Kodierungs- und Dekodierungsbibliothek, die dazu beitragen kann, die für diese Art von Anwendungen benötigte Entwicklungszeit zu verkürzen.

Die API ermöglicht die Auswahl des gesamten Bereichs der internen Taktfrequenzen und die Auswahl erweiterter Taktungsoptionen, die von FarSync-Adaptern wie dem FarSync T4E+ unterstützt werden.

Die Konfiguration der verschiedenen Arten der Leitungssignalisierung, NRZ, NRZI, Manchester Encoding, Conditioned Diphase, FM1 und FM0 werden von verschiedenen Adaptern im Sortiment übernommen - siehe die jeweiligen Adapter für eine Liste der unterstützten Leitungssignalformate.

LAPB Betrieb

Eine API zum LAPB-Protokoll ist über die hdlcX-Schnittstelle verfügbar, alle Ports auf den Adaptern können mit dieser Methode angesprochen werden.

Asynchroner Betrieb

Für die FarSync-Adapter der Typen T4U+Async, T4E+, T4Ue+Async und Flex ist ein asynchroner Betrieb über die Standard-TTY-Schnittstelle möglich. Die dynamische Umschaltung zwischen Async- und Sync-Betrieb wird unterstützt.

Hinweis: Unter Linux ist auch eine Raw Sockets API zur Unterstützung der Adapter verfügbar, obwohl diese Schnittstelle inzwischen veraltet ist.

LabVIEW (Windows)

Das Beispiel VI (LabVIEW Executable/Program) für Windows ist im FarSync SDK enthalten. Dieses Beispiel zeigt die Schnittstelle zu den FarSync-Adaptern von LabVIEW.

  Universal-Bibliothek für Bitstrom-Kodierung und -Dekodierung

Es wird eine Bibliothek bereitgestellt, die eine Low-Level-Kodierung und -Dekodierung des transparenten Bitstroms für eine schnelle Anwendungsentwicklung Ihrer Linux-Anwendung ermöglicht. Die Bibliothek kann konfiguriert werden, um die meisten byteorientierten Benutzerrahmen mit fester Länge zu identifizieren und zu extrahieren, wobei die Rahmen in Form von einzelnen oder alternativen Synchronisationsmustern, Rahmenlänge und Anzahl der Synchronisationsmuster zur Erfassung der Synchronisation definiert werden können. Es bietet z.B. 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 Legacy-Anwendungen oder den DAB STI-Modus zu gewährleisten. Für neue Anwendungen empfehlen wir die Verwendung der im Windows-Treiber integrierten Low-Level-Kodierung und -Dekodierung.

Beispielhafte Sende- und Empfangsprogramme, die gängige Betriebsarten demonstrieren, werden mit Beispieldatendateien geliefert.

Unterstützte DAB-Modi:

ETI
ETI(NI, G.703) - auf den FarSync-Adaptern vom Typ TE1, TE1R und TE1e
ETI(NI, V.11) - auf den FarSync-Adaptern vom Typ Flex, T1U, T2U, T2Ue, T2Ee, T4U, T4U, T4Ue, T4E+ und T2U-PMC.

STI
STI(PI, G.703) - auf den FarSync-Adaptern vom Typ TE1, TE1R und TE1e
STI(PI, V.11) - auf den FarSync-Adaptern vom Typ Flex, T1U, T2U, T2U, T2Ue, T2Ee, T4U, T4Ue, T4Ue, T4E+ und T2U-PMC.

Die Bibliothek ist in 32- und 64-Bit-Version verfügbar.

FSWDemo Test Utility (Windows)

FSWDemo, das mit dem FarSync SDK geliefert wird, soll die Funktionsweise der Windows FsWinAPI-Schnittstelle demonstrieren und testen und bietet außerdem ein wirklich nützliches und leistungsfähiges Werkzeug zum Überprüfen verschiedener Betriebsarten der FarSync-Adapter.

Es können sowohl HDLC-Frame- als auch transparente Bitstream-Modi getestet werden. Die Auswahl und Prüfung von mehreren Leitungen und Adaptern wird unterstützt.

FSWDemo Beispiel-Konfigurationsbildschirm


FSWDemo bei der Datenübernahme


FarSync SDK - Developers Toolkit, was ist enthalten?
Reference manuals

Windows FsWinAPI User Guide manuals (set of 4)
Linux Char I/O API User Manual,
Linux Raw Sockets User Manual (interface now deprecated),,
Linux LAPB API Manual,
RS485 application guidelines (for the FarSync Flex, T2Ee, T4E+),
Bitstream Encoder/decoder User Manual,
FarSync Flex Monitor User Manual.

Sample programs Sample applications supplied that use FsWinAPI, Char I/O APIs, Raw Sockets APIs and the bitstream encoder/decoder. There are also adapter performance check and adapter function test applications.
Source code Sample C  .NET (C# and VB) and LabVIEW VI samples.
Linux drivers source code supplied (for big endian and little endian processors).
Bitstream encoding and decoding Library and sample programs supporting decoding of bitstream data, can be configured to support many different fixed length bitstreams such as ETI, STI and E1 framing.
Customer Support We provide free email and telephone assistance to the application developer using the API as part of the package provided when the FarSync SDK is purchased.
Bestellinformationen

Product Name

Description

Product Code

FarSync SDK Linux and Windows Developers Toolkit for the FarSync adapters - this is required if you want to write software to use the FarSync adapter APIs.
Note: This toolkit is not appropriate for the FarSync X25 range of products or the FarLinX Gateways, they are supplied with their own toolkit.
FS9610

© Farsite Communication Ltd.

* Alle Spezifikationen können sich durch den Hersteller initiiert gegebenenfalls ändern!

Daten letzmalig aktualisiert am 20.10.2018

Interessiert an mehr Information? Diese E-Mail-Adresse ist vor Spambots geschützt! Zur Anzeige muss JavaScript eingeschaltet sein!