libownet - Dalam Talian di Awan

JADUAL:

NAMA

milik sendiri , (libownet) - antara muka 1 wayar bahasa C yang mudah kepada protokol owserver

SINOPSIS

libownet perpustakaan untuk dipautkan dengan program anda

Handle
OWNET_HANDLE
Mengendalikan setiap sambungan pelayan

Pengawalan
OWNET_HANDLE OWNET_init( malar tangki * owserver_tcp_address_and_port )
Bersekutu an owserver (1) alamat tcp/ip dengan pemegang.

Direktori senarai
int OWNET_dirlist( OWNET_HANDLE owserver_handle , malar tangki * onewire_path , tangki **
senarai_dipisahkan koma )
Buat senarai elemen direktori yang dipisahkan koma.

int OWNET_dirprocess( OWNET_HANDLE owserver_handle , malar tangki * onewire_path , membatalkan (*
dirfunc ) (kosong *, malar tangki *), membatalkan * lulus_pada_nilai )
membatalkan dirfunc ( membatalkan * lulus_pada_nilai , malar tangki * elemen_direktori )
Guna fungsi dirfunc kepada setiap elemen direktori, bersama-sama dengan nilai pass_on_arbitrary.

Dapatkan data
int OWNET_read( OWNET_HANDLE owserver_handle , malar tangki * onewire_path , malar tangki **
rentetan_kembali )
Baca nilai (saiz yang ditentukan) daripada peranti 1 wayar.

int OWNET_lread( OWNET_HANDLE owserver_handle , malar tangki * onewire_path , malar tangki **
rentetan_kembali , saiz_t saiz , off_t mengimbangi )
Baca nilai (saiz dan offset yang ditentukan) daripada peranti 1 wayar.

int OWNET_present( OWNET_HANDLE owserver_handle , malar tangki * onewire_path )
Periksa sama ada peranti 1 wayar ada.

Tetapkan data
int OWNET_put( OWNET_HANDLE owserver_handle , malar tangki * onewire_path , malar tangki *
rentetan_nilai , saiz_t saiz )
Tulis nilai (saiz yang ditentukan) pada peranti 1 wayar.

int OWNET_lwrite( OWNET_HANDLE owserver_handle , malar tangki * onewire_path , malar tangki *
rentetan_nilai , saiz_t saiz , off_t mengimbangi )
Tulis nilai (saiz dan offset yang ditentukan) pada peranti 1 wayar.

Tutup
membatalkan OWNET_close( OWNET_HANDLE owserver_handle )
Tutup sambungan ke owserver tertentu.

membatalkan OWNET_closeall( membatalkan )
Tutup semua sambungan owserver yang terbuka.

membatalkan OWNET_finish( membatalkan )
Tutup semua sambungan owserver terbuka dan kosongkan semua memori.

suhu skala
membatalkan OWNET_set_temperature_scale( tangki skala_suhu )
tangki OWNET_get_temperature_scale( membatalkan )
Tetapkan dan dapatkan semula skala suhu yang digunakan untuk semua komunikasi.

Peranti format
membatalkan OWNET_set_device_format( malar tangki * format_peranti )
malar tangki * OWNET_get_device_format( membatalkan )
Tetapkan dan dapatkan semula format nombor siri peranti 1 wayar yang digunakan untuk semua komunikasi.

FUNGSI

OW_init
OW_init_string menawarkan fleksibiliti penuh owfs (1) and owhttpd (1) baris perintah.

Argumen
Boleh semudah hanya nama peranti, spesifikasi parameter penuh. Satu atau
lebih banyak nama peranti (termasuk tcp, siri, usb...) dan suis baris arahan. Lihat
owfs (1) untuk sintaks penuh.

Pulangan
0 untuk kejayaan. -1 pada ralat dan salah akan ditetapkan. OW_finish tidak perlu
dipanggil jika OW_init gagal.

Urutan
Salah satu INIT fungsi mesti dipanggil sebelum mengakses bas 1 wayar.
OW_finish adalah pilihan.

OW_init_args
OW_init_args menawarkan fleksibiliti penuh owfs (1) and owhttpd (1) baris perintah.

Argumen
Satu atau lebih nama peranti (termasuk tcp, siri, usb...) dan suis baris arahan.
Lihat owfs (1) untuk sintaks penuh. Tidak seperti OW_init_string hujah-hujahnya dalam argv/argc
format.

Pulangan
0 untuk kejayaan. -1 pada ralat dan salah akan ditetapkan. OW_finish tidak perlu
dipanggil jika OW_init gagal.

Urutan
Salah satu INIT fungsi mesti dipanggil sebelum mengakses bas 1 wayar.
OW_finish adalah pilihan.

OW_get
OW_get digunakan untuk mendapatkan senarai direktori dan kandungan fail. Hasilnya dimasukkan ke dalam a
penimbal yang diperuntukkan secara dinamik.

Argumen
jalan ialah laluan ke direktori atau fail (property). *penampan mengembalikan penunjuk kepada
penimbal yang mengandungi direktori (dipisahkan koma) atau nilai. panjang_penampan
mengembalikan panjang nilai/rentetan masuk penampan

Pulangan
bilangan bait pada kejayaan. -1 pada ralat (dan salah ditetapkan).

Urutan
Salah satu INIT fungsi mesti dipanggil sebelum mengakses bas 1 wayar.
OW_finish adalah pilihan.

penting ambil perhatian
penampan diperuntukkan (dengan malloc ) oleh OW_get tetapi mesti dibebaskan dalam program anda.
Lihat malloc (3) and percuma (3)

OW_lread
OW_lread digunakan untuk membaca cip memori 1 wayar. Fikirkan ia sebagai gabungan mencari and
membaca Ia membenarkan akses rawak ke memori, menentukan lokasi dan panjang. Tidak seperti OW_get
direktori tidak boleh diperoleh dan penimbal mesti diperuntukkan terlebih dahulu daripada diperuntukkan
oleh rutin. penampan mesti sekurang-kurangnya saiz panjang.

Argumen
jalan ialah laluan ke fail (harta). penampan ialah kawasan ingatan (diperuntukkan sebelumnya).
di mana nilai akan diletakkan. saiz ialah panjang bait yang diminta. mengimbangi is
kedudukan dalam fail untuk mula membaca.

Pulangan
bilangan bait pada kejayaan. -1 pada ralat (dan salah ditetapkan).

Urutan
Salah satu INIT fungsi mesti dipanggil sebelum mengakses bas 1 wayar.
OW_finish adalah pilihan.

OW_put
OW_put ialah cara mudah untuk menulis kepada cip 1 wayar.

Argumen
jalan ialah laluan ke fail (harta). penampan ialah nilai yang hendak ditulis.
panjang_penampan ialah panjang nilai buffer. Pulangan bilangan bait dihidupkan
kejayaan. -1 pada ralat (dan salah ditetapkan).

Urutan
Salah satu INIT fungsi mesti dipanggil sebelum mengakses bas 1 wayar.
OW_finish adalah pilihan.

OW_lwrite
OW_lwrite adalah peneman OW_lread. Ia membenarkan penulisan kepada kedudukan sewenang-wenangnya
Memori 1 wayar. Fikirkan ia sebagai gabungan mencari and tulis. penampan mesti sekurang-kurangnya
saiz panjang.

Argumen
jalan ialah laluan ke fail (harta). penampan adalah data yang akan ditulis. saiz
ialah panjang bait yang hendak ditulis. mengimbangi ialah kedudukan dalam fail untuk dimulakan
bertulis.

Pulangan
bilangan bait pada kejayaan. -1 pada ralat (dan salah ditetapkan).

Urutan
Salah satu INIT fungsi mesti dipanggil sebelum mengakses bas 1 wayar.
OW_finish adalah pilihan.

OW_finish
OW_finish membersihkan OWFS Rutin 1 wayar, mengeluarkan peranti dan memori.

Argumen
Tiada.

Pulangan
Tiada

Urutan
OW_finish adalah pilihan kerana pembersihan adalah automatik apabila program keluar.

DESCRIPTION

1-Wayar
1-wayar ialah protokol pendawaian dan siri peranti yang direka dan dikeluarkan oleh Dallas
Semiconductor, Inc. Bas ialah skim penyambung rendah berkelajuan rendah kuasa rendah di mana data
talian juga boleh memberikan kuasa.

Setiap peranti dinomborkan secara unik dan tidak boleh diubah semasa pembuatan. Ada yang luas
pelbagai peranti, termasuk memori, penderia (kelembapan, suhu, voltan, sentuhan,
semasa), suis, pemasa dan pencatat data. Peranti yang lebih kompleks (seperti termokopel
sensor) boleh dibina dengan peranti asas ini. Terdapat juga peranti 1 wayar yang mempunyai
penyulitan disertakan.

Skim 1 wayar menggunakan satu bas master dan berbilang hamba pada wayar yang sama. Bas
tuan memulakan semua komunikasi. Hamba boleh ditemui secara individu dan
ditangani menggunakan ID unik mereka.

Induk bas datang dalam pelbagai konfigurasi termasuk bersiri, selari, i2c, rangkaian
atau penyesuai USB.

OWFS reka bentuk
OWFS ialah set program yang direka untuk menjadikan bas 1 wayar dan perantinya dengan mudah
boleh diakses. Prinsip asas adalah untuk mencipta sistem fail maya, dengan ID unik
menjadi direktori, dan sifat individu peranti diwakili sebagai mudah
fail yang boleh dibaca dan ditulis.

Butiran reka bentuk hamba atau tuan individu tersembunyi di sebalik antara muka yang konsisten.
Matlamatnya adalah untuk menyediakan satu set alat yang mudah untuk pereka perisian untuk membuat pemantauan
atau aplikasi kawalan. Terdapat beberapa peningkatan prestasi dalam pelaksanaan,
termasuk caching data, akses selari kepada induk bas, dan pengagregatan peranti
komunikasi. Masih matlamat asasnya ialah kemudahan penggunaan, fleksibiliti dan
ketepatan dan bukannya kelajuan.

libowcapi
libowcapi (1) adalah enkapsulasi penuh libow perpustakaan untuk program C.

libowcapi (1) membolehkan program C digunakan OWFS prinsip (skim penamaan yang konsisten,
berbilang penyesuai, peranti dan keserasian) terus daripada program C. Disana ada
modul analog untuk bahasa pengaturcaraan lain:

C libowcapi

perl owperl

php owphp

ular sawa owpython

TCL owtcl

CONTOH

/* Penyenaraian direktori mudah -- tiada semakan ralat */
#termasuk
char * buf;
saiz_t s;
OWNET_init("localhost:4304");
OWNET_dirlist("/",&buf,&s);
printf("Direktori %s0,buf);
percuma(buf);
OWNET_finish() ;

Gunakan libownet dalam talian menggunakan perkhidmatan onworks.net