owcapi - Online în cloud

PROGRAM:

NUME

owcapi - interfață simplă cu 1 fir în limbaj C

REZUMAT

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

Inițializarea
dimensiunea_t OW_init( dispozitiv nume or Complet parametru şir )
dimensiunea_t OW_init_args( int argc, car de război ** args )

Setul complet de opțiuni de inițializare este extins. Ele corespund aproximativ cu
opțiunile liniei de comandă ale owfs (1) owhttpd (1) si owftpd (1)

Obține de date
int OW_prezent( CONST car de război * cale )
int OW_get( CONST car de război * cale, car de război ** tampon, mărime_t * buffer_length )
dimensiunea_t OW_lread( CONST car de război * cale, nesemnat car de război * tampon, CONST mărime_t mărimea, CONST
off_t compensa )

set de date
dimensiunea_t OW_put( CONST car de război * cale, CONST car de război * tampon, mărime_t * buffer_length )
dimensiunea_t OW_lwrite( CONST car de război * cale, CONST nesemnat car de război * tampon, CONST mărime_t mărimea,
CONST off_t compensa )

Debug
anula OW_set_error_level( CONST car de război *param )
anula OW_set_error_print( CONST car de război *param )

Închide
anula OW_termină( anula )

FUNCȚII

OW_init
OW_init_string oferă flexibilitatea deplină a owfs (1) si 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) si 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_prezent
OW_prezent este utilizat pentru a verifica prezența unui dispozitiv cu 1 fir.

Argumente
cale este calea către director sau fișier (proprietate).

Returnări
0 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_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) si 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 si
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 si 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_set_error_level
OW_set_error_level setează ieșirea de depanare la un anumit nivel. 0 este implicit și mai mare
valoarea oferă mai multă ieșire.
(0=implicit, 1=err_connect, 2=err_call, 3=err_data, 4=err_detail, 5=err_debug,
6=err_beyond)

Argumente
parametrii este nivelul. Ar trebui să fie un număr întreg.

Returnări
Nici unul

Secvenţă
Unul din înăuntru funcțiile trebuie apelate înainte de a seta nivelul, deoarece înăuntru
implicit la nivelul 0.

OW_set_error_print
OW_set_error_print stabilește unde ar trebui direcționată ieșirea de depanare. 0=ieșire mixtă,
1=syslog, 2=consola.

Argumente
parametrii este nivelul. Ar trebui să fie un număr întreg între 0 și 2.

Returnări
Nici unul

Secvenţă
Unul din înăuntru funcțiile trebuie apelate înainte de a seta nivelul, deoarece înăuntru
implicit la 0 (ieșire mixtă).

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
nesemnat char * buf;
dimensiune_t s ;
OW_init("/dev/ttyS0");
OW_set_error_print("2");
OW_set_error_level("6");
OW_get("/",&buf,&s) ;
printf("Directorul %s0,buf);
gratuit(buf);
OW_finish() ;

Utilizați owcapi online folosind serviciile onworks.net