SPIOpenDevice
SPIOpenDevice — Baut eine Netzwerkverbindung zu einem AnaGate SPI auf.
Syntax
#include <AnaGateDllSPI.h>
AnaInt32 SPIOpenDevice(AnaInt32 * pHandle, const char * pcIPAddress,
AnaInt32 nTimeout);
Parameter
pHandle
pcIPAddress
nTimeout
Rückgabewert
Die Funktion gibt im Erfolgsfall Null zurück, andernfalls einen Fehlercode (Anhang A,
Rückgabewerte aus den API-Funktionen ).
Beschreibung
Baut eine Netzwerkverbindung über TCP/IP zu einem AnaGate SPI (bzw. AnaGate
Universal Programmer) auf. Erst nach dem erfolgreichen Verbinden mit dem Gerät
ist ein Zugriff auf den SPI-Bus möglich.
Anmerkung
Das AnaGate SPI (bzw. die SPI-Schnittstelle eines AnaGate Universal
Programmers) erlaubt nur eine einzige Netzwerkverbindung. Solange
eine bestehende Verbindung aufrechterhalten wird, wird jeder neue
Verbindungsversuch abgelehnt.
Im folgenden ein Programmier-Beispiel für den initialen Zugriff auf das Gerät.
#include <AnaGateDllSPI.h>
int main()
{
AnaInt32 hHandle;
AnaInt32 nRC = SPIOpenDevice(&hHandle, "192.168.1.254", 5000);
if ( nRC == 0 )
{
SPI API Funktionen
Zeiger auf eine Variable, in die das Zugriffs-Handle gespeichert wird,
falls die Verbindung zum Gerät erfolgreich hergestellt wurde.
Netzwerkadresse des AnaGate Partners.
Standard-Timeout für AnaGate-Zugriffe in Millisekunden.
Ein Timeout wird festgestellt, wenn die AnaGate-Hardware nicht
innerhalb der vereinbarten Timeout-Zeit antwortet. Diese Timeout-
Zeit gilt auf der aktiven Netzwerkverbindung für alle Kommandos
bzw. Funktionen, für die kein spezifischer Timeout-Wert definiert
werden kann.
46
© 2007-2015 Analytica GmbH