libowcapi - Online sa Cloud

PROGRAMA:

NAME

owcapi - madaling C-language 1-wire interface

SINOPSIS

libowcapi library upang maiugnay sa iyong programa

Pinasimulan
ssize_t OW_init( aparato pangalan or ganap parametro pisi )
ssize_t OW_init_args( int argc, tangke ** mga pagtatalo )

Ang buong hanay ng mga pagpipilian sa pagsisimula ay malawak. Halos tumutugma sila sa
mga pagpipilian sa command line ng owfs (1) owhttpd (1) at owftpd (1)

Magsimula data
int OW_present( const tangke * landas )
int OW_get( const tangke * landas, tangke ** buffer, laki_t * buffer_length )
ssize_t OW_lread( const tangke * landas, hindi naka -ignign tangke * buffer, const laki_t laki, const
off_t ginalaw )

Itakda data
ssize_t OW_put( const tangke * landas, const tangke * buffer, laki_t * buffer_length )
ssize_t OW_lwrite( const tangke * landas, const hindi naka -ignign tangke * buffer, const laki_t laki,
const off_t ginalaw )

Mag-alis ng mga insekto
walang bisa OW_set_error_level( const tangke *param )
walang bisa OW_set_error_print( const tangke *param )

Pagsasara
walang bisa OW_finish( walang bisa )

Mga function

OW_init
OW_init_string nag-aalok ng buong flexibility ng owfs (1) at owhttpd (1) command line.

Mga argumento
Maaaring kasing simple ng pangalan ng device, isang buong detalye ng parameter. Isa o
higit pang mga pangalan ng device (kasama ang tcp, serial, usb...) at command line switch. Tingnan mo
owfs (1) para sa buong syntax.

Kita
0 para sa tagumpay. -1 sa error at mali itatakda. OW_tapos hindi kailangan
tinawag kung OW_init nabigo.

Pagkakasunud-sunod
Isa sa mga sa loob dapat tawagan ang mga function bago ma-access ang 1-wire bus.
OW_tapos ay opsyonal.

OW_init_args
OW_init_args nag-aalok ng buong flexibility ng owfs (1) at owhttpd (1) command line.

Mga argumento
Isa o higit pang mga pangalan ng device (kasama ang tcp, serial, usb...) at command line switch.
Tingnan owfs (1) para sa buong syntax. Unlike OW_init_string ang mga argumento ay nasa argv/argc
format.

Kita
0 para sa tagumpay. -1 sa error at mali itatakda. OW_tapos hindi kailangan
tinawag kung OW_init nabigo.

Pagkakasunud-sunod
Isa sa mga sa loob dapat tawagan ang mga function bago ma-access ang 1-wire bus.
OW_tapos ay opsyonal.

OW_present
OW_present ay ginagamit upang suriin ang presensya ng isang 1-wire device.

Mga argumento
landas ay ang landas patungo sa direktoryo o file (property).

Kita
0 sa tagumpay. -1 sa error (at mali ay nakatakda).

Pagkakasunud-sunod
Isa sa mga sa loob dapat tawagan ang mga function bago ma-access ang 1-wire bus.
OW_tapos ay opsyonal.

OW_get
OW_get ay ginagamit upang makakuha ng mga listahan ng direktoryo at mga nilalaman ng file. Ang mga resulta ay inilalagay sa a
dynamic na inilaan na buffer.

Mga argumento
landas ay ang landas patungo sa direktoryo o file (property). *buffer nagbabalik ng pointer sa
isang buffer na naglalaman ng direktoryo (pinaghihiwalay ng kuwit) o ​​halaga. buffer_length
ibinabalik ang haba ng value/string in nagpapahina ng lakas

Kita
bilang ng mga byte sa tagumpay. -1 sa error (at mali ay nakatakda).

Pagkakasunud-sunod
Isa sa mga sa loob dapat tawagan ang mga function bago ma-access ang 1-wire bus.
OW_tapos ay opsyonal.

mahalaga nota
nagpapahina ng lakas ay inilalaan (na may malloc ) ni OW_get ngunit dapat na malaya sa iyong programa.
Tingnan malloc (3) at libre (3)

OW_lread
OW_lread ay ginagamit upang basahin ang 1-wire memory chips. Isipin ito bilang isang kumbinasyon ng hanapin ko at
basahin Pinapayagan nito ang random na pag-access sa memorya, na tumutukoy sa lokasyon at haba. Unlike OW_get
hindi maaaring makuha ang mga direktoryo at ang buffer ay dapat na paunang inilalaan sa halip na ilaan
sa pamamagitan ng nakagawian. nagpapahina ng lakas dapat atleast laki haba.

Mga argumento
landas ay ang landas patungo sa file (property). nagpapahina ng lakas ay ang (pre-allocated) memory area
kung saan ilalagay ang halaga. laki ay ang haba ng mga byte na hiniling. ginalaw is
ang posisyon sa file upang simulan ang pagbabasa.

Kita
bilang ng mga byte sa tagumpay. -1 sa error (at mali ay nakatakda).

Pagkakasunud-sunod
Isa sa mga sa loob dapat tawagan ang mga function bago ma-access ang 1-wire bus.
OW_tapos ay opsyonal.

OW_put
OW_put ay isang madaling paraan upang sumulat sa 1-wire chips.

Mga argumento
landas ay ang landas patungo sa file (property). nagpapahina ng lakas ay ang halaga na isusulat.
buffer_length ay ang haba ng halaga buffer. Kita bilang ng mga byte sa
tagumpay. -1 sa error (at mali ay nakatakda).

Pagkakasunud-sunod
Isa sa mga sa loob dapat tawagan ang mga function bago ma-access ang 1-wire bus.
OW_tapos ay opsyonal.

OW_lwrite
OW_lwrite ay ang kasama ng OW_lread. Pinapayagan nito ang pagsusulat sa mga arbitrary na posisyon
1-wire na memorya. Isipin ito bilang isang kumbinasyon ng hanapin ko at magsulat. nagpapahina ng lakas dapat atleast
laki haba.

Mga argumento
landas ay ang landas patungo sa file (property). nagpapahina ng lakas ay ang datos na isusulat. laki
ay ang haba ng mga byte na isusulat. ginalaw ay ang posisyon sa file upang magsimula
pagsulat.

Kita
bilang ng mga byte sa tagumpay. -1 sa error (at mali ay nakatakda).

Pagkakasunud-sunod
Isa sa mga sa loob dapat tawagan ang mga function bago ma-access ang 1-wire bus.
OW_tapos ay opsyonal.

OW_set_error_level
OW_set_error_level nagtatakda ng debug na output sa isang tiyak na antas. 0 ang default, at mas mataas
ang halaga ay nagbibigay ng higit na output.
(0=default, 1=err_connect, 2=err_call, 3=err_data, 4=err_detail, 5=err_debug,
6=err_beyond)

Mga argumento
param ay ang antas. Dapat ay isang integer.

Kita
Wala

Pagkakasunud-sunod
Isa sa mga sa loob dapat tawagan ang mga function bago itakda ang antas, dahil sa loob
default sa level 0.

OW_set_error_print
OW_set_error_print nagtatakda kung saan dapat idirekta ang output ng debug. 0=halo-halong output,
1=syslog, 2=console.

Mga argumento
param ay ang antas. Dapat ay isang integer sa pagitan ng 0 at 2.

Kita
Wala

Pagkakasunud-sunod
Isa sa mga sa loob dapat tawagan ang mga function bago itakda ang antas, dahil sa loob
default sa 0 (halo-halong output).

OW_tapos
OW_tapos nililinis ang OWFS Mga 1-wire na gawain, naglalabas ng mga device at memory.

Mga argumento
Wala.

Kita
Wala

Pagkakasunud-sunod
OW_tapos ay opsyonal dahil ang paglilinis ay awtomatiko sa paglabas ng programa.

DESCRIPTION

1-Wire
1-kawad ay isang wiring protocol at serye ng mga device na idinisenyo at ginawa ng Dallas
Semiconductor, Inc. Ang bus ay isang low-power low-speed low-connector scheme kung saan ang data
linya ay maaari ding magbigay ng kapangyarihan.

Ang bawat aparato ay natatangi at walang pagbabago na binibilang sa panahon ng paggawa. May malawak
iba't ibang mga aparato, kabilang ang memorya, mga sensor (humidity, temperatura, boltahe, contact,
kasalukuyang), switch, timer at data logger. Mas kumplikadong mga device (tulad ng thermocouple
sensor) ay maaaring itayo gamit ang mga pangunahing device na ito. Mayroon ding mga 1-wire na device na mayroon
kasama ang pag-encrypt.

Ang 1-wire scheme ay gumagamit ng isang solong bus panginoon at maraming alipin sa parehong wire. Ang bus
sinisimulan ng master ang lahat ng komunikasyon. Ang mga alipin ay maaaring indibidwal na matuklasan at
tinutugunan gamit ang kanilang natatanging ID.

Ang mga master ng bus ay may iba't ibang configuration kabilang ang serial, parallel, i2c, network
o mga USB adapter.

OWFS disenyo
OWFS ay isang hanay ng mga program na idinisenyo upang gawing madali ang 1-wire bus at ang mga device nito
naa-access. Ang pinagbabatayan na prinsipyo ay ang lumikha ng isang virtual na filesystem, na may natatanging ID
pagiging direktoryo, at ang mga indibidwal na katangian ng device ay kinakatawan bilang simple
mga file na maaaring basahin at isulat.

Ang mga detalye ng indibidwal na disenyo ng alipin o master ay nakatago sa likod ng isang pare-parehong interface.
Ang layunin ay magbigay ng isang madaling hanay ng mga tool para sa isang software designer upang lumikha ng pagsubaybay
o kontrolin ang mga aplikasyon. Mayroong ilang mga pagpapahusay sa pagganap sa pagpapatupad,
kabilang ang data caching, parallel access sa mga master ng bus, at pagsasama-sama ng device
komunikasyon. Ang pangunahing layunin pa rin ay ang kadalian ng paggamit, kakayahang umangkop at
kawastuhan sa halip na bilis.

libowcapi
libowcapi (1) ay isang encapsulation ng buo libow aklatan para sa mga programang C.

libowcapi (1) nagbibigay-daan sa isang C program na gamitin OWFS mga prinsipyo (pare-parehong pamamaraan ng pagpapangalan,
maramihang mga adapter, device, at compatibility) nang direkta mula sa isang C program. meron
kahalintulad na mga module para sa iba pang mga programming language:

C libowcapi

perlas owperl

php owphp

python owpython

tcl owtcl

Halimbawa

/* Simpleng listahan ng direktoryo -- walang error checking */
#isama
unsigned char * buf;
size_t s ;
OW_init("/dev/ttyS0");
OW_set_error_print("2");
OW_set_error_level("6");
OW_get("/",&buf,&s);
printf("Direktoryo %s0,buf);
libre(buf);
OW_finish() ;

Gumamit ng libowcapi online gamit ang mga serbisyo ng onworks.net