libownet – Online in der Cloud

PROGRAMM:

NAME/FUNKTION

im Besitz , (libownet) - Einfache 1-Draht-Schnittstelle in C-Sprache zum OWServer-Protokoll

ZUSAMMENFASSUNG

libownet Bibliothek zur Verknüpfung mit Ihrem Programm

Handle
OWNET_HANDLE
Handle für jede Owserver-Verbindung

Initialisierung
OWNET_HANDLE OWNET_init( const verkohlen * owserver_tcp_address_and_port )
Verknüpfen Sie eine Oowserver (1) TCP/IP-Adresse mit einem Handle.

Verzeichnis listing
int OWNET_dirlist( OWNET_HANDLE owserver_handle , const verkohlen * onewire_path , verkohlen **
komma_getrennte_liste )
Erstellen Sie eine durch Kommas getrennte Liste von Verzeichniselementen.

int OWNET_dirprocess( OWNET_HANDLE owserver_handle , const verkohlen * onewire_path , ungültig (*
dirfunc ) (Leere *, const verkohlen 🇧🇷 ungültig * übergebener_on_value )
ungültig dirfunc ( ungültig * übergebener_on_value , const verkohlen * Verzeichniselement )
Funktion anwenden dirfunc zu jedem Verzeichniselement, zusammen mit einem beliebigen übergebenen_on_value.

Erhalten Sie technische Daten
int OWNET_read( OWNET_HANDLE owserver_handle , const verkohlen * onewire_path , const verkohlen **
return_string )
Lesen Sie einen Wert (der angegebenen Größe) von einem 1-Draht-Gerät.

int OWNET_lread( OWNET_HANDLE owserver_handle , const verkohlen * onewire_path , const verkohlen **
return_string , size_t Größe , aus_t Offset )
Lesen Sie einen Wert (mit angegebener Größe und angegebenem Offset) von einem 1-Draht-Gerät.

int OWNET_present( OWNET_HANDLE owserver_handle , const verkohlen * onewire_path )
Prüfen Sie, ob ein 1-Wire-Gerät vorhanden ist.

Sept technische Daten
int OWNET_put( OWNET_HANDLE owserver_handle , const verkohlen * onewire_path , const verkohlen *
value_string , size_t Größe )
Schreiben Sie einen Wert (mit angegebener Größe) in ein 1-Draht-Gerät.

int OWNET_lwrite( OWNET_HANDLE owserver_handle , const verkohlen * onewire_path , const verkohlen *
value_string , size_t Größe , aus_t Offset )
Schreiben Sie einen Wert (mit angegebener Größe und angegebenem Offset) in ein 1-Draht-Gerät.

Menu
ungültig OWNET_close( OWNET_HANDLE owserver_handle )
Schließen Sie die Verbindung zu einem bestimmten Owserver.

ungültig OWNET_closeall( ungültig )
Schließen Sie alle offenen Owserver-Verbindungen.

ungültig OWNET_finish( ungültig )
Schließen Sie alle offenen OW-Server-Verbindungen und geben Sie den gesamten Speicher frei.

Temperaturen Treppe
ungültig OWNET_set_temperature_scale( verkohlen Temperaturskala )
verkohlen OWNET_get_temperature_scale( ungültig )
Legen Sie die für die gesamte Kommunikation verwendete Temperaturskala fest und rufen Sie sie ab.

Gerät Format
ungültig OWNET_set_device_format( const verkohlen * Geräteformat )
const verkohlen * OWNET_get_device_format( ungültig )
Legen Sie das Seriennummernformat des 1-Draht-Geräts fest, das für die gesamte Kommunikation verwendet wird, und rufen Sie es ab.

FUNKTIONEN

OW_init
OW_init_string bietet die volle Flexibilität des owfs (1) und owhttpd (1) Befehlszeile.

Argumente
Kann so einfach sein wie nur der Gerätename oder eine vollständige Parameterspezifikation. Eins oder
Weitere Gerätenamen (einschließlich TCP, Seriell, USB ...) und Befehlszeilenschalter. Sehen
owfs (1) für vollständige Syntax.

Rücksendungen
0 für Erfolg. -1 bei Fehler und Fehler wird gesetzt. OW_finish muss nicht sein
aufgerufen, wenn OW_init fehlschlägt.

Reihenfolge
Einer der init Funktionen müssen vor dem Zugriff auf den 1-Wire-Bus aufgerufen werden.
OW_finish es ist optional.

OW_init_args
OW_init_args bietet die volle Flexibilität des owfs (1) und owhttpd (1) Befehlszeile.

Argumente
Ein oder mehrere Gerätenamen (einschließlich TCP, Seriell, USB...) und Befehlszeilenschalter.
See owfs (1) für vollständige Syntax. nicht wie OW_init_string Die Argumente sind in argv/argc
Format.

Rücksendungen
0 für Erfolg. -1 bei Fehler und Fehler wird gesetzt. OW_finish muss nicht sein
aufgerufen, wenn OW_init fehlschlägt.

Reihenfolge
Einer der init Funktionen müssen vor dem Zugriff auf den 1-Wire-Bus aufgerufen werden.
OW_finish es ist optional.

OW_get
OW_get wird verwendet, um Verzeichnislisten und Dateiinhalte abzurufen. Die Ergebnisse werden in ein
dynamisch zugewiesener Puffer.

Argumente
Weg ist der Pfad zum Verzeichnis oder zur Datei (Eigenschaft). *Puffer gibt einen Zeiger auf zurück
ein Puffer, der das Verzeichnis (durch Kommas getrennt) oder den Wert enthält. Puffer_Länge
gibt die Länge des Werts/Strings in zurück puffern

Rücksendungen
Anzahl der Bytes bei Erfolg. -1 bei Fehler (und Fehler eingestellt ist).

Reihenfolge
Einer der init Funktionen müssen vor dem Zugriff auf den 1-Wire-Bus aufgerufen werden.
OW_finish es ist optional.

Wichtig beachten
puffern wird (mit malloc) von zugewiesen OW_get muss aber in Ihrem Programm freigegeben werden.
See malloc (3) und kostenlos (3)

OW_lread
OW_lread wird zum Lesen von 1-Wire-Speicherchips verwendet. Betrachten Sie es als eine Kombination aus Ich suche und
lesen Es ermöglicht den wahlfreien Zugriff auf den Speicher unter Angabe von Ort und Länge. nicht wie OW_get
Verzeichnisse können nicht abgerufen werden und der Puffer muss vorab zugewiesen statt zugewiesen werden
durch die Routine. puffern muss mindestens Größe Länge.

Argumente
Weg ist der Pfad zur Datei (Eigenschaft). puffern ist der (vorab zugewiesene) Speicherbereich
wo der Wert platziert wird. Größe ist die Länge der angeforderten Bytes. Offset is
die Position in der Datei, an der mit dem Lesen begonnen werden soll.

Rücksendungen
Anzahl der Bytes bei Erfolg. -1 bei Fehler (und Fehler eingestellt ist).

Reihenfolge
Einer der init Funktionen müssen vor dem Zugriff auf den 1-Wire-Bus aufgerufen werden.
OW_finish es ist optional.

OW_put
OW_put ist eine einfache Möglichkeit, auf 1-Wire-Chips zu schreiben.

Argumente
Weg ist der Pfad zur Datei (Eigenschaft). puffern ist der zu schreibende Wert.
Puffer_Länge ist die Länge des Werts Puffer. Rücksendungen Anzahl der Bytes auf
Erfolg. -1 bei Fehler (und Fehler eingestellt ist).

Reihenfolge
Einer der init Funktionen müssen vor dem Zugriff auf den 1-Wire-Bus aufgerufen werden.
OW_finish es ist optional.

OW_lwrite
OW_lwrite ist der Begleiter von OW_lread. Es ermöglicht das Schreiben an beliebige Positionen in
1-Draht-Speicher. Betrachten Sie es als eine Kombination aus Ich suche und zu schreiben. puffern muss mindestens
Größe Länge.

Argumente
Weg ist der Pfad zur Datei (Eigenschaft). puffern sind die zu schreibenden Daten. Größe
ist die Länge der zu schreibenden Bytes. Offset ist die Position in der Datei, an der begonnen werden soll
Schreiben.

Rücksendungen
Anzahl der Bytes bei Erfolg. -1 bei Fehler (und Fehler eingestellt ist).

Reihenfolge
Einer der init Funktionen müssen vor dem Zugriff auf den 1-Wire-Bus aufgerufen werden.
OW_finish es ist optional.

OW_finish
OW_finish räumt auf OWFS 1-Draht-Routinen, gibt Geräte und Speicher frei.

Argumente
Keiner.

Rücksendungen
Andere

Reihenfolge
OW_finish ist optional, da die Bereinigung beim Beenden des Programms automatisch erfolgt.

BESCHREIBUNG

1-Draht
1-Draht ist ein Verdrahtungsprotokoll und eine Reihe von Geräten, die von Dallas entwickelt und hergestellt wurden
Semiconductor, Inc. Der Bus ist ein Low-Power-Low-Speed-Low-Connector-Schema, bei dem die Daten
Leitung kann auch Strom liefern.

Jedes Gerät wird bei der Herstellung eindeutig und unveränderlich nummeriert. Es gibt eine breite
Vielzahl von Geräten, einschließlich Speicher, Sensoren (Feuchtigkeit, Temperatur, Spannung, Kontakt,
Strom), Schalter, Timer und Datenlogger. Komplexere Geräte (wie Thermoelemente)
Sensoren) können mit diesen Grundgeräten aufgebaut werden. Es gibt auch 1-Draht-Geräte, die über
Verschlüsselung enthalten.

Das 1-Draht-Schema verwendet ein einzelnes Bus Master und mehrere Sklaven am selben Draht. Der Bus
Master initiiert die gesamte Kommunikation. Die Sklaven können einzeln entdeckt werden und
mit ihrer eindeutigen ID adressiert.

Busmaster sind in einer Vielzahl von Konfigurationen erhältlich, darunter seriell, parallel, i2c, Netzwerk
oder USB-Adapter.

OWFS Design
OWFS ist eine Reihe von Programmen, die entwickelt wurden, um den 1-Wire-Bus und seine Geräte einfach zu machen
zugänglich. Das zugrundeliegende Prinzip besteht darin, ein virtuelles Dateisystem mit der eindeutigen ID zu erstellen
als Verzeichnis, und die einzelnen Eigenschaften des Gerätes werden einfach dargestellt
Dateien, die gelesen und geschrieben werden können.

Hinter einer einheitlichen Oberfläche verbergen sich Details des individuellen Slave- oder Master-Designs.
Das Ziel besteht darin, einem Software-Designer ein einfaches Set an Tools zur Verfügung zu stellen, um Monitoring zu erstellen
oder Steueranwendungen. Es gibt einige Leistungsverbesserungen in der Implementierung,
einschließlich Daten-Caching, paralleler Zugriff auf Bus-Master und Aggregation von Geräten
Kommunikation. Dennoch war das grundlegende Ziel Benutzerfreundlichkeit, Flexibilität und
Korrektheit statt Geschwindigkeit.

libowcapi
libowcapi (1) ist eine Kapselung des Ganzen libow Bibliothek für C-Programme.

libowcapi (1) ermöglicht die Verwendung durch ein C-Programm OWFS Prinzipien (konsistentes Namensschema,
mehrere Adapter, Geräte und Kompatibilität) direkt aus einem C-Programm. Es gibt
Analoge Module für andere Programmiersprachen:

C libowcapi

perl owperl

php owphp

python owpython

tcl owtcl

BEISPIEL

/* Einfache Verzeichnisauflistung – keine Fehlerprüfung */
#enthalten
char * buf;
size_t s ;
OWNET_init("localhost:4304");
OWNET_dirlist("/",&buf,&s) ;
printf("Verzeichnis %s0,buf);
frei(buf);
OWNET_finish() ;

Nutzen Sie libownet online über die Dienste von onworks.net