FarSync SDK

Developers Toolkit

 

Überblick

Das SDK unterstützt das Schreiben von Anwendungen zur Nutzung der FarSync-Produktpalette sowohl unter Linux als auch unter Windows. Es enthält Dokumentation, funktionierende Beispielanwendungen, image.pngBenutzerbibliotheken 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-gerahmte) 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.

Das SDK soll einen einfachen Zugang zu den Hardware-Funktionen der verschiedenen Adapter der FarSync-Reihe ermöglichen und gleichzeitig zusätzliche Software-Codierung und -Decodierung zur Ergänzung der von der Hardware bereitgestellten Funktionen bieten.

Der Hersteller bietet Anwendungsentwicklern, welche die API als Teil des Pakets verwenden, das beim Kauf des FarSync SDK bereitgestellt wird, kostenlose Unterstützung per E-Mail und Telefon.

Dieses Toolkit ist nicht für die FarSync X25-Produkte geeignet, da diese bereits mit einem eigenen speziellen X.25-Toolkit geliefert werden. FarSync X25-Karten können zusätzlich zu X.25 auch die auf dieser Seite beschriebenen Betriebsarten unterstützen.

datasheetdownload K2Ee 768x373

 

Einzelheiten zum Produkt

  • Liste der von FarSync SDK unterstützten Produkte
  • Anwendungsbeispiele
  • FarSync Windows API (FsWinAPI)
  • Linux Char I/O API
  • LabVIEW (Windows)
  • LabVIEW (Linux)
  • Bitstream-Kodierungs- und Dekodierungsbibliothek
  • fswdemo Test-Dienstprogramm (Windows)
  • Inhalt Developers Toolkit

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, T4Ue+Async, FlexT4U+Async und T4E+ 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, T4Ue+Async, Flex, T4E+ und T4U+Async 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.

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.

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.

fswdemo2

fswdemo-Beispielkonfigurationsbildschirm

fswdemo

fswdemo bei der Datenübertragung

 

Developers Toolkit 
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, K2Ee T4E+, T4Ee),
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 code in: C .NET (C# and VB) and LabVIEW VI.
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 Free email and telephone assistance to the application developer using the API as part of the package provided when the FarSync SDK is purchased.

Bestell-Informationen

  • Produkt-Codes
FarSync SDK - Order Information
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 suitable 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 letztmalig aktualisiert am 19.04.2023

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

Partner | Referenzen
  • dlr.png
  • CLAAS.png
  • VENTURETEC.png
  • hvb.jpg
  • 1_LOGO_VEEAM.png
  • Tsystems.gif
  • 1_LOGO_SEMATICON.png
  • vodafone.gif
  • dekabank.gif
  • 1_LOGO_FARSITE.png
  • AIRBUS.png
  • 1_LOGO_Avalara.jpg
  • 1_LOGO_SSH.png
  • deutschepost.gif
  • ASKLEPIOS.png
  • Postbank.jpg
  • sbb.gif
  • netcologne.gif
  • commerzbank.gif
  • NXP.png