libownet - Online în cloud

PROGRAM:

NUME

proprietatea , (libownet) - interfață ușoară în limbaj C cu 1 fir la protocolul owserver

REZUMAT

libownet bibliotecă pentru a face legătura cu programul dvs

Mâner
OWNET_HANDLE
Gestionați fiecare conexiune la server

Inițializarea
OWNET_HANDLE OWNET_init( CONST car de război * owserver_tcp_address_and_port )
Asociati an owserver (1) adresa tcp/ip cu un mâner.

director listare
int OWNET_dirlist( OWNET_HANDLE owserver_handle , CONST car de război * onewire_path , car de război **
listă_separată_ prin virgulă )
Creați o listă de elemente de director, separate prin virgulă.

int OWNET_dirprocess( OWNET_HANDLE owserver_handle , CONST car de război * onewire_path , anula (*
dirfunc ) (nud *, CONST car de război *), anula * pass_on_value )
anula dirfunc ( anula * pass_on_value , CONST car de război * element_director )
Aplicați funcția dirfunc la fiecare element de director, împreună cu un pass_on_value arbitrar.

Obține de date
int OWNET_read( OWNET_HANDLE owserver_handle , CONST car de război * onewire_path , CONST car de război **
return_string )
Citiți o valoare (de dimensiunea specificată) de la un dispozitiv cu 1 fir.

int OWNET_lread( OWNET_HANDLE owserver_handle , CONST car de război * onewire_path , CONST car de război **
return_string , mărime_t mărimea , off_t compensa )
Citiți o valoare (de dimensiunea și decalajul specificate) de la un dispozitiv cu 1 fir.

int OWNET_prezent( OWNET_HANDLE owserver_handle , CONST car de război * onewire_path )
Verificați dacă există un dispozitiv cu 1 fir.

set de date
int OWNET_put( OWNET_HANDLE owserver_handle , CONST car de război * onewire_path , CONST car de război *
șir_valoare , mărime_t mărimea )
Scrieți o valoare (de dimensiunea specificată) pe un dispozitiv cu 1 fir.

int OWNET_lwrite( OWNET_HANDLE owserver_handle , CONST car de război * onewire_path , CONST car de război *
șir_valoare , mărime_t mărimea , off_t compensa )
Scrieți o valoare (de dimensiunea și decalajul specificate) pe un dispozitiv cu 1 fir.

Închide
anula OWNET_close( OWNET_HANDLE owserver_handle )
Închideți conexiunea la un anumit owserver.

anula OWNET_closeall( anula )
Închideți toate conexiunile deschise la server.

anula OWNET_finish( anula )
Închideți toate conexiunile deschise la server și eliberați toată memoria.

Temperatura scară
anula OWNET_set_temperature_scale( car de război temperatură_scale )
car de război OWNET_get_temperature_scale( anula )
Setați și preluați scala de temperatură utilizată pentru toate comunicațiile.

Dispozitiv format
anula OWNET_set_device_format( CONST car de război * format_dispozitiv )
CONST car de război * OWNET_get_device_format( anula )
Setați și preluați formatul numărului de serie al dispozitivului cu 1 fir utilizat pentru toate comunicațiile.

FUNCȚII

OW_init
OW_init_string oferă flexibilitatea deplină a owfs (1) și owhttpd (1) Linie de comanda.

Argumente
Poate fi la fel de simplu ca doar numele dispozitivului, o specificație completă a parametrilor. Una sau
mai multe nume de dispozitive (include tcp, serial, usb...) și comutatoare de linie de comandă. Vedea
owfs (1) pentru sintaxa completă.

Returnări
0 pentru succes. -1 pe eroare și greseala va fi setat. OW_termină nu trebuie să fie
numit dacă OW_init eșuează.

Secvenţă
Unul din înăuntru funcțiile trebuie apelate înainte de a accesa magistrala cu 1 fir.
OW_termină este opțional.

OW_init_args
OW_init_args oferă flexibilitatea deplină a owfs (1) și owhttpd (1) Linie de comanda.

Argumente
Unul sau mai multe nume de dispozitiv (include tcp, serial, usb...) și comutatoare de linie de comandă.
Vedea owfs (1) pentru sintaxa completă. Spre deosebire de OW_init_string argumentele sunt în argv/argc
format.

Returnări
0 pentru succes. -1 pe eroare și greseala va fi setat. OW_termină nu trebuie să fie
numit dacă OW_init eșuează.

Secvenţă
Unul din înăuntru funcțiile trebuie apelate înainte de a accesa magistrala cu 1 fir.
OW_termină este opțional.

OW_get
OW_get este folosit pentru a obține liste de directoare și conținut de fișiere. Rezultatele sunt puse în a
tampon alocat dinamic.

Argumente
cale este calea către director sau fișier (proprietate). *tampon returnează un pointer către
un buffer care conține directorul (separat prin virgulă) sau valoarea. buffer_length
returnează lungimea valorii/șirului în tampon

Returnări
numărul de octeți la succes. -1 la eroare (și greseala este setat).

Secvenţă
Unul din înăuntru funcțiile trebuie apelate înainte de a accesa magistrala cu 1 fir.
OW_termină este opțional.

Important nota
tampon este alocat ( cu malloc ) de OW_get dar trebuie eliberat în programul dumneavoastră.
Vedea malloc (3) și gratuit (3)

OW_lread
OW_lread este folosit pentru a citi cipuri de memorie cu 1 fir. Gândește-te la asta ca la o combinație de lseek și
citit Permite accesul aleatoriu la memorie, specificând locația și lungimea. Spre deosebire de OW_get
directoarele nu pot fi obținute și buffer-ul trebuie să fie pre-alocat mai degrabă decât alocat
prin rutină. tampon trebuie să fie măcar mărimea lungime.

Argumente
cale este calea către fișier (proprietate). tampon este zona de memorie (prealocată).
unde va fi plasată valoarea. mărimea este lungimea octeților solicitați. compensa is
poziția din fișier pentru a începe citirea.

Returnări
numărul de octeți la succes. -1 la eroare (și greseala este setat).

Secvenţă
Unul din înăuntru funcțiile trebuie apelate înainte de a accesa magistrala cu 1 fir.
OW_termină este opțional.

OW_put
OW_put este o modalitate ușoară de a scrie pe cipuri cu 1 fir.

Argumente
cale este calea către fișier (proprietate). tampon este valoarea de scris.
buffer_length este lungimea valorii tampon. Returnări numărul de octeți activat
succes. -1 la eroare (și greseala este setat).

Secvenţă
Unul din înăuntru funcțiile trebuie apelate înainte de a accesa magistrala cu 1 fir.
OW_termină este opțional.

OW_lwrite
OW_lwrite este însoțitorul lui OW_lread. Permite scrierea în poziții arbitrare în
Memorie cu 1 fir. Gândește-te la asta ca la o combinație de lseek și scrie. tampon trebuie să fie măcar
mărimea lungime.

Argumente
cale este calea către fișier (proprietate). tampon sunt datele care trebuie scrise. mărimea
este lungimea octeților care urmează să fie scrisi. compensa este poziția în fișier pentru a începe
scris.

Returnări
numărul de octeți la succes. -1 la eroare (și greseala este setat).

Secvenţă
Unul din înăuntru funcțiile trebuie apelate înainte de a accesa magistrala cu 1 fir.
OW_termină este opțional.

OW_termină
OW_termină curăță OWFS Rutine cu 1 fir, eliberează dispozitive și memorie.

Argumente
Nici unul.

Returnări
Nici unul

Secvenţă
OW_termină este opțional, deoarece curățarea este automată la ieșirea din program.

DESCRIERE

1-Wire
1-fir este un protocol de cablare și o serie de dispozitive proiectate și fabricate de Dallas
Semiconductor, Inc. magistrala este o schemă de conectori de viteză mică de mică putere în care datele
linia poate furniza și energie.

Fiecare dispozitiv este numerotat în mod unic și nemodificat în timpul producției. Există o largă
varietate de dispozitive, inclusiv memorie, senzori (umiditate, temperatură, tensiune, contact,
curent), comutatoare, cronometre și înregistratoare de date. Dispozitive mai complexe (cum ar fi termocuplul
senzori) pot fi construite cu aceste dispozitive de bază. Există și dispozitive cu 1 fir care au
criptare inclusă.

Schema cu 1 fir folosește un singur luați autobuzul maestru și multiple sclavi pe acelasi fir. Autobuzul
maestru inițiază toată comunicarea. Sclavii pot fi descoperiţi individual şi
adresate folosind ID-ul lor unic.

Autobuzele master vin într-o varietate de configurații, inclusiv seriale, paralele, i2c, rețea
sau adaptoare USB.

OWFS proiecta
OWFS este o suită de programe concepute pentru a face magistrala cu 1 fir și dispozitivele sale cu ușurință
accesibil. Principiul de bază este crearea unui sistem de fișiere virtual, cu ID-ul unic
fiind directorul, iar proprietățile individuale ale dispozitivului sunt reprezentate ca simple
fișiere care pot fi citite și scrise.

Detaliile despre designul individual slave sau master sunt ascunse în spatele unei interfețe consistente.
Scopul este de a oferi un set ușor de instrumente pentru un designer de software pentru a crea monitorizare
sau aplicații de control. Există unele îmbunătățiri de performanță în implementare,
inclusiv stocarea în cache a datelor, acces paralel la magistralele de magistrală și agregarea dispozitivului
comunicare. Totuși, obiectivul fundamental a fost ușurința în utilizare, flexibilitatea și
corectitudine mai degrabă decât viteza.

libowcapi
libowcapi (1) este o încapsulare a întregului libow bibliotecă pentru programe C.

libowcapi (1) permite folosirea unui program C OWFS principii (schema de denumire consistentă,
mai multe adaptoare, dispozitive și compatibilitate) direct dintr-un program C. Sunt
module analoge pentru alte limbaje de programare:

C libowcapi

perl owperl

php owphp

piton owpython

TCL owtcl

EXEMPLU

/* Listare simplă de directoare -- nicio verificare a erorilor */
#include
char * buf;
dimensiune_t s ;
OWNET_init("localhost:4304");
OWNET_dirlist("/",&buf,&s) ;
printf("Directorul %s0,buf);
gratuit(buf);
OWNET_finish() ;

Utilizați libownet online folosind serviciile onworks.net