libownet - Online di Cloud

PROGRAM:

NAMA

pemilik , (libownet) - Antarmuka 1-kawat bahasa C yang mudah ke protokol owserver

RINGKASAN

libonet perpustakaan untuk ditautkan dengan program Anda

Handle
OWNET_HANDLE
Menangani setiap koneksi owserver

Inisialisasi
OWNET_HANDLE OWNET_init( const tangki * owserver_tcp_address_and_port )
Kaitkan dan server (1) alamat tcp/ip dengan pegangan.

Direktori daftar
int OWNET_daftar_direktori( OWNET_HANDLE pemilik_handle , const tangki * jalur_satu kawat , tangki **
daftar_koma_dipisahkan )
Buat daftar elemen direktori yang dipisahkan koma.

int OWNET_dirproses( OWNET_HANDLE pemilik_handle , const tangki * jalur_satu kawat , membatalkan (*
gangguan ) (ruang kosong *, const tangki *), membatalkan * pass_on_value )
membatalkan gangguan ( membatalkan * pass_on_value , const tangki * direktori_elemen )
Terapkan fungsi gangguan ke setiap elemen direktori, bersama dengan pass_on_value yang berubah-ubah.

Dapatkan data
int OWNET_baca( OWNET_HANDLE pemilik_handle , const tangki * jalur_satu kawat , const tangki **
kembali_string )
Baca nilai (dengan ukuran tertentu) dari perangkat 1-kawat.

int OWNET_lread( OWNET_HANDLE pemilik_handle , const tangki * jalur_satu kawat , const tangki **
kembali_string , ukuran_t ukuran , mati_t mengimbangi )
Baca nilai (dengan ukuran dan offset yang ditentukan) dari perangkat 1-kawat.

int OWNET_sekarang( OWNET_HANDLE pemilik_handle , const tangki * jalur_satu kawat )
Periksa apakah ada perangkat 1-kawat.

set data
int OWNET_put( OWNET_HANDLE pemilik_handle , const tangki * jalur_satu kawat , const tangki *
nilai_string , ukuran_t ukuran )
Tulis nilai (dengan ukuran tertentu) ke perangkat 1-kawat.

int OWNET_ltulis( OWNET_HANDLE pemilik_handle , const tangki * jalur_satu kawat , const tangki *
nilai_string , ukuran_t ukuran , mati_t mengimbangi )
Tulis nilai (dengan ukuran dan offset yang ditentukan) ke perangkat 1-kawat.

Penyelesaian
membatalkan OWNET_tutup( OWNET_HANDLE pemilik_handle )
Tutup koneksi ke owserver tertentu.

membatalkan OWNET_tutup semua( membatalkan )
Tutup semua koneksi owserver yang terbuka.

membatalkan OWNET_selesai( membatalkan )
Tutup semua koneksi owserver yang terbuka dan bebaskan semua memori.

Suhu skala
membatalkan OWNET_set_temperature_scale( tangki suhu_skala )
tangki OWNET_get_temperature_scale( membatalkan )
Atur dan ambil skala suhu yang digunakan untuk semua komunikasi.

alat format
membatalkan OWNET_set_device_format( const tangki * perangkat_format )
const tangki * OWNET_get_format_perangkat( membatalkan )
Atur dan ambil format nomor seri perangkat 1-kawat yang digunakan untuk semua komunikasi.

FUNGSI

OW_init
OW_init_string menawarkan fleksibilitas penuh dari owfs (1) dan sendiri (1) garis komando.

kasus
Dapat sesederhana seperti nama perangkat, spesifikasi parameter lengkap. Satu atau
lebih banyak nama perangkat (termasuk tcp, serial, usb...) dan sakelar baris perintah. Lihat
owfs (1) untuk sintaks lengkap.

Pengembalian
0 untuk sukses. -1 pada kesalahan dan salah akan diatur. OW_selesai tidak perlu
disebut jika OW_init gagal

Urutan
Salah satu init fungsi harus dipanggil sebelum mengakses bus 1-kawat.
OW_selesai bersifat opsional.

OW_init_args
OW_init_args menawarkan fleksibilitas penuh dari owfs (1) dan sendiri (1) garis komando.

kasus
Satu atau beberapa nama perangkat (termasuk tcp, serial, usb...) dan sakelar baris perintah.
Lihat owfs (1) untuk sintaks lengkap. Tidak seperti OW_init_string argumennya ada di argv/argc
Format.

Pengembalian
0 untuk sukses. -1 pada kesalahan dan salah akan diatur. OW_selesai tidak perlu
disebut jika OW_init gagal

Urutan
Salah satu init fungsi harus dipanggil sebelum mengakses bus 1-kawat.
OW_selesai bersifat opsional.

OW_dapatkan
OW_dapatkan digunakan untuk mendapatkan daftar direktori dan isi file. Hasilnya dimasukkan ke dalam
buffer yang dialokasikan secara dinamis.

kasus
path adalah path ke direktori atau file (properti). *penyangga mengembalikan pointer ke
buffer yang berisi direktori (dipisahkan koma) atau nilai. buffer_panjang
mengembalikan panjang nilai/string di penyangga

Pengembalian
jumlah byte pada keberhasilan. -1 pada kesalahan (dan salah diatur).

Urutan
Salah satu init fungsi harus dipanggil sebelum mengakses bus 1-kawat.
OW_selesai bersifat opsional.

penting mencatat
penyangga dialokasikan ( dengan malloc ) oleh OW_dapatkan tetapi harus dibebaskan dalam program Anda.
Lihat malloc (3) dan gratis (3)

OW_baca
OW_baca digunakan untuk membaca chip memori 1-kawat. Anggap saja sebagai kombinasi dari mencari dan
Baca baca Ini memungkinkan akses acak ke memori, menentukan lokasi dan panjangnya. Tidak seperti OW_dapatkan
direktori tidak dapat diperoleh dan buffer harus dialokasikan terlebih dahulu daripada dialokasikan
oleh rutinitas. penyangga setidaknya harus ukuran panjangnya.

kasus
path adalah jalur ke file (properti). penyangga adalah area memori (pra-dialokasikan)
dimana nilai akan ditempatkan. ukuran adalah panjang byte yang diminta. mengimbangi is
posisi dalam file untuk mulai membaca.

Pengembalian
jumlah byte pada keberhasilan. -1 pada kesalahan (dan salah diatur).

Urutan
Salah satu init fungsi harus dipanggil sebelum mengakses bus 1-kawat.
OW_selesai bersifat opsional.

OW_put
OW_put adalah cara mudah untuk menulis ke chip 1-kawat.

kasus
path adalah jalur ke file (properti). penyangga adalah nilai yang akan ditulis.
buffer_panjang adalah panjang nilai penyangga. Pengembalian jumlah byte aktif
kesuksesan. -1 pada kesalahan (dan salah diatur).

Urutan
Salah satu init fungsi harus dipanggil sebelum mengakses bus 1-kawat.
OW_selesai bersifat opsional.

OW_ltulis
OW_ltulis adalah pendamping dari OW_baca. Ini memungkinkan penulisan ke posisi sewenang-wenang di
memori 1 kabel. Anggap saja sebagai kombinasi dari mencari dan menulis. penyangga setidaknya harus
ukuran panjangnya.

kasus
path adalah jalur ke file (properti). penyangga adalah data yang akan ditulis. ukuran
adalah panjang byte yang akan ditulis. mengimbangi adalah posisi dalam file untuk memulai
penulisan.

Pengembalian
jumlah byte pada keberhasilan. -1 pada kesalahan (dan salah diatur).

Urutan
Salah satu init fungsi harus dipanggil sebelum mengakses bus 1-kawat.
OW_selesai bersifat opsional.

OW_selesai
OW_selesai membersihkan OWFS Rutinitas 1-kawat, melepaskan perangkat dan memori.

kasus
Tidak ada.

Pengembalian
None

Urutan
OW_selesai adalah opsional karena pembersihan otomatis saat keluar dari program.

DESKRIPSI

1-Kawat
1-kawat adalah protokol pengkabelan dan serangkaian perangkat yang dirancang dan diproduksi oleh Dallas
Semiconductor, Inc. Bus adalah skema konektor rendah berkecepatan rendah berdaya rendah di mana data
garis juga dapat memberikan daya.

Setiap perangkat diberi nomor unik dan tidak dapat diubah selama pembuatan. Ada yang luas
berbagai perangkat, termasuk memori, sensor (kelembaban, suhu, tegangan, kontak,
arus), sakelar, pengatur waktu, dan pencatat data. Perangkat yang lebih kompleks (seperti termokopel
sensor) dapat dibangun dengan perangkat dasar ini. Ada juga perangkat 1-kawat yang memiliki
enkripsi disertakan.

Skema 1-kawat menggunakan satu bis menguasai dan banyak budak pada kawat yang sama. Bus
master memulai semua komunikasi. Budak dapat ditemukan secara individual dan
ditangani menggunakan ID unik mereka.

Master bus datang dalam berbagai konfigurasi termasuk serial, paralel, i2c, jaringan
atau adaptor USB.

OWFS disain
OWFS adalah rangkaian program yang dirancang untuk membuat bus 1-kawat dan perangkatnya dengan mudah
dapat diakses. Prinsip dasarnya adalah membuat sistem file virtual, dengan ID unik
menjadi direktori, dan properti individu perangkat direpresentasikan sebagai sederhana
file yang dapat dibaca dan ditulis.

Detail dari masing-masing slave atau master design tersembunyi di balik antarmuka yang konsisten.
Tujuannya adalah untuk menyediakan seperangkat alat yang mudah bagi perancang perangkat lunak untuk membuat pemantauan
atau aplikasi kontrol. Ada beberapa peningkatan kinerja dalam implementasinya,
termasuk caching data, akses paralel ke master bus, dan agregasi perangkat
komunikasi. Tetap saja tujuan mendasarnya adalah kemudahan penggunaan, fleksibilitas dan
kebenaran daripada kecepatan.

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

libowcapi (1) memungkinkan program C untuk digunakan OWFS prinsip (skema penamaan yang konsisten,
beberapa adaptor, perangkat, dan kompatibilitas) langsung dari program C. Ada
modul analog untuk bahasa pemrograman lain:

C libowcapi

perl burung hantu

php owphp

ular sanca com.owpython

tcl owtcl

CONTOH

/* Daftar direktori sederhana -- tidak ada pemeriksaan kesalahan */
#termasuk
karakter * buf;
ukuran_t s ;
OWNET_init("localhost:4304");
OWNET_dirlist("/",&buf,&s);
printf("Direktori %s0,buf);
gratis (buf);
OWNET_selesai() ;

Gunakan libownet online menggunakan layanan onworks.net