libownet - Online in de cloud

PROGRAMMA:

NAAM

bezit , (Libownet) - eenvoudige C-taal 1-draads interface naar het owserver-protocol

KORTE INHOUD

libownet bibliotheek om te koppelen met uw programma

Handle
OWNET_HANDLE
Handvat naar elke owserver-verbinding

initialisatie
OWNET_HANDLE EIGEN_init( const verkolen * owserver_tcp_adres_en_poort )
koppelen aan eigenaar (1) tcp/ip-adres met een handvat.

Directory vermelding
int OWNET_maplijst( OWNET_HANDLE owserver_handle , const verkolen * onewire_pad , verkolen **
komma_gescheiden_lijst )
Maak een door komma's gescheiden lijst met directory-elementen.

int OWNET_dirprocess( OWNET_HANDLE owserver_handle , const verkolen * onewire_pad , komen te vervallen (*
vervaagd ) (leegte *, const verkolen ​ komen te vervallen * doorgegeven_on_waarde )
komen te vervallen vervaagd ( komen te vervallen * doorgegeven_on_waarde , const verkolen * directory_element )
Functie toepassen vervaagd aan elk directory-element, samen met een willekeurige pass_on_value.

Krijgen gegevens
int OWNET_lezen( OWNET_HANDLE owserver_handle , const verkolen * onewire_pad , const verkolen **
return_tekenreeks )
Lees een waarde (van gespecificeerde grootte) van een 1-draads apparaat.

int EIGEN_lread( OWNET_HANDLE owserver_handle , const verkolen * onewire_pad , const verkolen **
return_tekenreeks , maat_t grootte , uit_t compenseren )
Lees een waarde (van gespecificeerde grootte en offset) van een 1-draads apparaat.

int OWNET_aanwezig( OWNET_HANDLE owserver_handle , const verkolen * onewire_pad )
Controleer of er een 1-draads apparaat aanwezig is.

Zet de gegevens
int EIGEN_put( OWNET_HANDLE owserver_handle , const verkolen * onewire_pad , const verkolen *
waarde_string , maat_t grootte )
Schrijf een waarde (van gespecificeerde grootte) naar een 1-draads apparaat.

int OWNET_lschrijven( OWNET_HANDLE owserver_handle , const verkolen * onewire_pad , const verkolen *
waarde_string , maat_t grootte , uit_t compenseren )
Schrijf een waarde (van gespecificeerde grootte en offset) naar een 1-draads apparaat.

Sluiten
komen te vervallen EIGEN_close( OWNET_HANDLE owserver_handle )
Sluit de verbinding met een bepaalde owserver.

komen te vervallen OWNET_closeall( komen te vervallen )
Sluit alle open owserver-verbindingen.

komen te vervallen OWNET_finish( komen te vervallen )
Sluit alle open owserver-verbindingen en maak al het geheugen vrij.

Temperatuur zone(s) schaal
komen te vervallen OWNET_set_temperature_scale( verkolen temperatuur_schaal )
verkolen OWNET_get_temperature_scale( komen te vervallen )
Stel de temperatuurschaal in die voor alle communicatie wordt gebruikt en haal deze op.

Apparaat formaat
komen te vervallen OWNET_set_device_format( const verkolen * apparaat_formaat )
const verkolen * OWNET_get_device_format( komen te vervallen )
Stel het serienummerformaat van het 1-draads apparaat in en haal het op dat voor alle communicatie wordt gebruikt.

FUNCTIES

OW_begin
OW_init_tekenreeks biedt de volledige flexibiliteit van de owfs (1) en owhttpd (1) opdrachtregel.

argumenten
Kan zo simpel zijn als alleen de apparaatnaam, een volledige parameterspecificatie. Een of
meer apparaatnamen (inclusief tcp, serieel, usb...) en commandoregelschakelaars. Zien
owfs (1) voor volledige syntaxis.

Retourneren
0 voor succes. -1 bij fout en fout zal worden ingesteld. OW_finish hoeft niet te zijn
belde als OW_begin mislukt.

Volgorde
Een van de init functies moeten worden opgeroepen voordat toegang wordt verkregen tot de 1-draads bus.
OW_finish is optioneel.

OW_init_args
OW_init_args biedt de volledige flexibiliteit van de owfs (1) en owhttpd (1) opdrachtregel.

argumenten
Een of meer apparaatnamen (inclusief tcp, serieel, usb...) en opdrachtregelschakelaars.
Bekijk owfs (1) voor volledige syntaxis. in tegenstelling tot OW_init_tekenreeks de argumenten zijn in argv/argc
formaat.

Retourneren
0 voor succes. -1 bij fout en fout zal worden ingesteld. OW_finish hoeft niet te zijn
belde als OW_begin mislukt.

Volgorde
Een van de init functies moeten worden opgeroepen voordat toegang wordt verkregen tot de 1-draads bus.
OW_finish is optioneel.

OW_get
OW_get wordt gebruikt om directorylijsten en bestandsinhoud op te halen. De resultaten worden in een gezet
dynamisch toegewezen buffer.

argumenten
pad is het pad naar de map of het bestand (eigenschap). *buffer geeft een aanwijzer terug naar
een buffer met de directory (gescheiden door komma's) of waarde. bufferlengte
geeft de lengte van de waarde/tekenreeks in buffer

Retourneren
aantal bytes bij succes. -1 bij fout (en fout is ingesteld).

Volgorde
Een van de init functies moeten worden opgeroepen voordat toegang wordt verkregen tot de 1-draads bus.
OW_finish is optioneel.

belangrijk nota
buffer wordt toegewezen ( met malloc ) door OW_get maar moet worden vrijgemaakt in uw programma.
Bekijk malloc (3) en gratis (3)

OW_lgelezen
OW_lgelezen wordt gebruikt om 1-draads geheugenchips te lezen. Zie het als een combinatie van zoek naar en
dit artikel lezen Het maakt willekeurige toegang tot het geheugen mogelijk, waarbij locatie en lengte worden gespecificeerd. in tegenstelling tot OW_get
mappen kunnen niet worden verkregen en de buffer moet vooraf worden toegewezen in plaats van toegewezen
door de routine. buffer moet minstens zijn grootte lengte.

argumenten
pad is het pad naar het bestand (eigenschap). buffer is het (vooraf toegewezen) geheugengebied
waar de waarde wordt geplaatst. grootte is de lengte van de gevraagde bytes. compenseren is
de positie in het bestand om te beginnen met lezen.

Retourneren
aantal bytes bij succes. -1 bij fout (en fout is ingesteld).

Volgorde
Een van de init functies moeten worden opgeroepen voordat toegang wordt verkregen tot de 1-draads bus.
OW_finish is optioneel.

OW_put
OW_put is een gemakkelijke manier om naar 1-draads chips te schrijven.

argumenten
pad is het pad naar het bestand (eigenschap). buffer is de waarde die moet worden geschreven.
bufferlengte is de lengte van de waarde buffer. Retourneren aantal bytes aan
succes. -1 bij fout (en fout is ingesteld).

Volgorde
Een van de init functies moeten worden opgeroepen voordat toegang wordt verkregen tot de 1-draads bus.
OW_finish is optioneel.

OW_lschrijven
OW_lschrijven is de metgezel van OW_llezen. Het maakt schrijven naar willekeurige posities in
1-draads geheugen. Zie het als een combinatie van zoek naar en schrijven. buffer moet minstens zijn
grootte lengte.

argumenten
pad is het pad naar het bestand (eigenschap). buffer zijn de gegevens die moeten worden geschreven. grootte
is de lengte van de te schrijven bytes. compenseren is de positie in het bestand om te beginnen
schrijven.

Retourneren
aantal bytes bij succes. -1 bij fout (en fout is ingesteld).

Volgorde
Een van de init functies moeten worden opgeroepen voordat toegang wordt verkregen tot de 1-draads bus.
OW_finish is optioneel.

OW_finish
OW_finish ruimt de op OWFS 1-draads routines, apparaten en geheugen vrijgeven.

argumenten
Geen.

Retourneren
Geen

Volgorde
OW_finish is optioneel omdat het opschonen automatisch gebeurt bij het afsluiten van het programma.

PRODUCTBESCHRIJVING

1-Wire
1-wire is een bedradingsprotocol en een reeks apparaten ontworpen en vervaardigd door Dallas
Semiconductor, Inc. De bus is een low-power low-speed low-connector-schema waarbij de gegevens
lijn kan ook stroom leveren.

Elk apparaat is uniek en onveranderlijk genummerd tijdens de fabricage. Er zijn een brede
verschillende apparaten, waaronder geheugen, sensoren (vochtigheid, temperatuur, spanning, contact,
stroom), schakelaars, timers en dataloggers. Complexere apparaten (zoals thermokoppel)
sensoren) kunnen met deze basisapparaten worden gebouwd. Er zijn ook 1-draads apparaten die:
encryptie inbegrepen.

Het 1-draads schema maakt gebruik van een enkele bus meester en meerdere slaven op dezelfde draad. De bus
master initieert alle communicatie. De slaven kunnen afzonderlijk worden ontdekt en
geadresseerd met hun unieke ID.

Busmasters zijn er in verschillende configuraties, waaronder serieel, parallel, i2c, netwerk
of USB-adapters.

OWFS Design
OWFS is een reeks programma's die zijn ontworpen om de 1-draads bus en zijn apparaten gemakkelijk te maken
toegankelijk. Het onderliggende principe is om een ​​virtueel bestandssysteem te creëren, met de unieke ID
zijnde de directory, en de individuele eigenschappen van het apparaat worden weergegeven als eenvoudig
bestanden die kunnen worden gelezen en geschreven.

Details van het individuele slave- of masterontwerp zijn verborgen achter een consistente interface.
Het doel is om een ​​eenvoudige set tools te bieden voor een softwareontwerper om monitoring te creëren
of besturingstoepassingen. Er zijn enkele prestatieverbeteringen in de implementatie,
inclusief gegevenscaching, parallelle toegang tot busmasters en aggregatie van apparaten
communicatie. Toch was het fundamentele doel gebruiksgemak, flexibiliteit en
correctheid in plaats van snelheid.

libowcapi
libowcapi (1) is een inkapseling van de volledige liboog bibliotheek voor C-programma's.

libowcapi (1) staat een C-programma toe om te gebruiken OWFS principes (consistent naamgevingsschema,
meerdere adapters, apparaten en compatibiliteit) rechtstreeks vanuit een C-programma. Er zijn
analoge modules voor andere programmeertalen:

C libowcapi

perl uil

php owphp

python owpython

tcl owtcl

VOORBEELD

/* Eenvoudige directorylijst -- geen foutcontrole */
#erbij betrekken
char * buf;
size_t s;
OWNET_init("localhost:4304");
OWNET_dirlist("/",&buf,&s) ;
printf("Directory %s0,buf);
gratis (buf);
EIGEN_finish() ;

Gebruik libownet online met behulp van onworks.net-services