libownet - Trực tuyến trên đám mây

CHƯƠNG TRÌNH:

TÊN

sở hữu , (libownet) - giao diện 1 dây ngôn ngữ C dễ dàng với giao thức máy chủ

SYNOPSIS

mạng libenet thư viện để liên kết với chương trình của bạn

Handle
OWNET_HANDLE
Xử lý từng kết nối máy chủ

Khởi tạo
OWNET_HANDLE OWNET_init ( const xe tăng * owserver_tcp_address_and_port )
Liên kết một chủ nợ (1) địa chỉ tcp / ip với một tay cầm.

thư mục niêm yết
int OWNET_dirlist ( OWNET_HANDLE owserver_handle , const xe tăng * onewire_path , xe tăng **
dấu phẩy_separated_list )
Tạo danh sách các phần tử thư mục được phân tách bằng dấu phẩy.

int OWNET_dirprocess ( OWNET_HANDLE owserver_handle , const xe tăng * onewire_path , làm mất hiệu lực (*
dirfunc ) (vô hiệu *, const xe tăng *), làm mất hiệu lực * pass_on_value )
làm mất hiệu lực dirfunc ( làm mất hiệu lực * pass_on_value , const xe tăng * thư mục_element )
Áp dụng chức năng dirfunc cho mỗi phần tử thư mục, cùng với một giá trị được truyền vào tùy ý.

Nhận dữ liệu
int OWNET_read ( OWNET_HANDLE owserver_handle , const xe tăng * onewire_path , const xe tăng **
chuỗi trả về )
Đọc giá trị (có kích thước được chỉ định) từ thiết bị 1 dây.

int OWNET_lread ( OWNET_HANDLE owserver_handle , const xe tăng * onewire_path , const xe tăng **
chuỗi trả về , kích thước_t kích thước , tắt_t bù đắp )
Đọc giá trị (có kích thước và độ lệch được chỉ định) từ thiết bị 1 dây.

int OWNET_present ( OWNET_HANDLE owserver_handle , const xe tăng * onewire_path )
Kiểm tra xem có thiết bị 1 dây hay không.

Thiết lập dữ liệu
int OWNET_put ( OWNET_HANDLE owserver_handle , const xe tăng * onewire_path , const xe tăng *
chuỗi giá trị , kích thước_t kích thước )
Ghi giá trị (có kích thước xác định) vào thiết bị 1 dây.

int OWNET_lwrite ( OWNET_HANDLE owserver_handle , const xe tăng * onewire_path , const xe tăng *
chuỗi giá trị , kích thước_t kích thước , tắt_t bù đắp )
Ghi giá trị (có kích thước và độ lệch xác định) vào thiết bị 1 dây.

Đóng
làm mất hiệu lực OWNET_close ( OWNET_HANDLE owserver_handle )
Đóng kết nối với một máy chủ cụ thể.

làm mất hiệu lực OWNET_closeall ( làm mất hiệu lực )
Đóng tất cả các kết nối máy chủ đang mở.

làm mất hiệu lực OWNET_finish ( làm mất hiệu lực )
Đóng tất cả các kết nối máy chủ đang mở và giải phóng tất cả bộ nhớ.

Nhiệt độ tỉ lệ
làm mất hiệu lực OWNET_set_tempeosystem_scale ( xe tăng Thang đo nhiệt độ )
xe tăng OWNET_get_tempeosystem_scale ( làm mất hiệu lực )
Đặt và truy xuất thang đo nhiệt độ được sử dụng cho tất cả các liên lạc.

Dụng cụ định dạng
làm mất hiệu lực OWNET_set_device_format ( const xe tăng * định dạng thiết bị )
const xe tăng * OWNET_get_device_format ( làm mất hiệu lực )
Đặt và truy xuất định dạng số sê-ri của thiết bị 1 dây được sử dụng cho tất cả các liên lạc.

CHỨC NĂNG

OW_init
OW_init_string cung cấp sự linh hoạt đầy đủ của ôi (1) và owhttpd (1) dòng lệnh.

Lập luận
Có thể đơn giản như tên thiết bị, thông số kỹ thuật đầy đủ. Một hoặc
nhiều tên thiết bị hơn (bao gồm tcp, serial, usb ...) và chuyển mạch dòng lệnh. Nhìn thấy
ôi (1) để biết cú pháp đầy đủ.

Trả hàng
0 để thành công. -1 về lỗi và sai Sẽ được thiết lập. OW_kết thúc không cần phải
được gọi nếu OW_init thất bại

Trình tự
Một trong những trong đó các chức năng phải được gọi trước khi truy cập bus 1 dây.
OW_kết thúc Là tùy chọn.

OW_init_args
OW_init_args cung cấp sự linh hoạt đầy đủ của ôi (1) và owhttpd (1) dòng lệnh.

Lập luận
Một hoặc nhiều tên thiết bị (bao gồm tcp, serial, usb ...) và công tắc dòng lệnh.
Xem ôi (1) để biết cú pháp đầy đủ. không giống OW_init_string các đối số có trong argv / argc
định dạng.

Trả hàng
0 để thành công. -1 về lỗi và sai Sẽ được thiết lập. OW_kết thúc không cần phải
được gọi nếu OW_init thất bại

Trình tự
Một trong những trong đó các chức năng phải được gọi trước khi truy cập bus 1 dây.
OW_kết thúc Là tùy chọn.

OW_get
OW_get được sử dụng để lấy danh sách thư mục và nội dung tệp. Các kết quả được đưa vào một
bộ đệm được cấp phát động.

Lập luận
con đường là đường dẫn đến thư mục hoặc tệp (thuộc tính). *đệm trả về một con trỏ tới
một bộ đệm chứa thư mục (được phân tách bằng dấu phẩy) hoặc giá trị. bộ đệm_length
trả về độ dài của giá trị / chuỗi trong đệm

Trả hàng
số byte khi thành công. -1 về lỗi (và sai được thiết lập).

Trình tự
Một trong những trong đó các chức năng phải được gọi trước khi truy cập bus 1 dây.
OW_kết thúc Là tùy chọn.

Quan trọng ghi
đệm được phân bổ (với malloc) bởi OW_get nhưng phải được giải phóng trong chương trình của bạn.
Xem malloc (3) và tự do (3)

OW_lread
OW_lread được sử dụng để đọc các chip nhớ 1 dây. Hãy coi nó như một sự kết hợp của tìm kiếm và
đọc Nó cho phép truy cập ngẫu nhiên vào bộ nhớ, chỉ định vị trí và độ dài. không giống OW_get
không thể lấy được các thư mục và bộ đệm phải được cấp phát trước chứ không phải cấp phát
theo thói quen. đệm ít nhất phải là kích thước chiều dài.

Lập luận
con đường là đường dẫn đến tệp (thuộc tính). đệm là vùng bộ nhớ (được cấp phát trước)
nơi giá trị sẽ được đặt. kích thước là độ dài của byte được yêu cầu. bù đắp is
vị trí trong tệp để bắt đầu đọc.

Trả hàng
số byte khi thành công. -1 về lỗi (và sai được thiết lập).

Trình tự
Một trong những trong đó các chức năng phải được gọi trước khi truy cập bus 1 dây.
OW_kết thúc Là tùy chọn.

OW_put
OW_put là một cách dễ dàng để ghi vào chip 1 dây.

Lập luận
con đường là đường dẫn đến tệp (thuộc tính). đệm là giá trị được ghi.
bộ đệm_length là độ dài của giá trị đệm. Trả hàng số byte trên
sự thành công. -1 về lỗi (và sai được thiết lập).

Trình tự
Một trong những trong đó các chức năng phải được gọi trước khi truy cập bus 1 dây.
OW_kết thúc Là tùy chọn.

OW_lwrite
OW_lwrite là bạn đồng hành của OW_lđọc. Nó cho phép ghi vào các vị trí tùy ý trong
Bộ nhớ 1 dây. Hãy coi nó như một sự kết hợp của tìm kiếm và viết. đệm ít nhất phải là
kích thước chiều dài.

Lập luận
con đường là đường dẫn đến tệp (thuộc tính). đệm là dữ liệu được ghi. kích thước
là độ dài của byte được viết. bù đắp là vị trí trong hồ sơ để bắt đầu
văn bản.

Trả hàng
số byte khi thành công. -1 về lỗi (và sai được thiết lập).

Trình tự
Một trong những trong đó các chức năng phải được gọi trước khi truy cập bus 1 dây.
OW_kết thúc Là tùy chọn.

OW_kết thúc
OW_kết thúc dọn dẹp OWFS Quy trình 1 dây, giải phóng thiết bị và bộ nhớ.

Lập luận
Không có.

Trả hàng
Không áp dụng

Trình tự
OW_kết thúc là tùy chọn vì quá trình dọn dẹp là tự động khi thoát chương trình.

MÔ TẢ

1 dây
Dây 1 là một giao thức đi dây và một loạt các thiết bị được thiết kế và sản xuất bởi Dallas
Semiconductor, Inc. Bus là một sơ đồ kết nối tốc độ thấp công suất thấp, nơi dữ liệu
dòng cũng có thể cung cấp điện.

Mỗi thiết bị được đánh số duy nhất và không thay đổi trong quá trình sản xuất. Có rất nhiều
nhiều loại thiết bị, bao gồm bộ nhớ, cảm biến (độ ẩm, nhiệt độ, điện áp, tiếp điểm,
hiện tại), bộ chuyển mạch, bộ định thời và bộ ghi dữ liệu. Các thiết bị phức tạp hơn (như cặp nhiệt điện
cảm biến) có thể được chế tạo bằng các thiết bị cơ bản này. Ngoài ra còn có các thiết bị 1 dây có
mã hóa bao gồm.

Sơ đồ 1 dây sử dụng một xe buýt chủ và nhiều nô lệ trên cùng một dây. Xe buýt
chủ khởi xướng mọi giao tiếp. Các nô lệ có thể được phát hiện riêng lẻ và
được giải quyết bằng cách sử dụng ID duy nhất của họ.

Bus master có nhiều loại cấu hình bao gồm nối tiếp, song song, i2c, mạng
hoặc bộ điều hợp USB.

OWFS thiết kế
OWFS là một bộ chương trình được thiết kế để tạo ra bus 1 dây và các thiết bị của nó một cách dễ dàng
có thể truy cập. Nguyên tắc cơ bản là tạo một hệ thống tệp ảo, với ID duy nhất
là thư mục và các thuộc tính riêng lẻ của thiết bị được biểu diễn dưới dạng đơn giản
các tệp có thể đọc và ghi.

Chi tiết về thiết kế chủ hoặc nô lệ riêng lẻ được ẩn sau một giao diện nhất quán.
Mục tiêu là cung cấp một bộ công cụ dễ dàng cho một nhà thiết kế phần mềm để tạo ra giám sát
hoặc các ứng dụng điều khiển. Có một số cải tiến về hiệu suất trong việc triển khai,
bao gồm bộ nhớ đệm dữ liệu, truy cập song song vào các bus chính và tổng hợp thiết bị
liên lạc. Tuy nhiên, mục tiêu gây quỹ là dễ sử dụng, linh hoạt và
tính đúng đắn hơn là tốc độ.

libowcapi
libowcapi (1) là một sự đóng gói của đầy đủ li cung thư viện cho các chương trình C.

libowcapi (1) cho phép một chương trình C sử dụng OWFS nguyên tắc (cách đặt tên nhất quán,
nhiều bộ điều hợp, thiết bị và khả năng tương thích) trực tiếp từ chương trình C. Có
các mô-đun tương tự cho các ngôn ngữ lập trình khác:

C libowcapi

perl con cú

php owphp

mãng xà con trăn

TCL cú vọ

THÍ DỤ

/ * Danh sách thư mục đơn giản - không kiểm tra lỗi * /
#bao gồm
ký tự *buf;
size_t s;
OWNET_init ("localhost: 4304");
OWNET_dirlist ("/", & buf, & s);
printf ("Thư mục% s0, buf);
miễn phí (buf);
OWNET_finish ();

Sử dụng libownet trực tuyến bằng các dịch vụ onworks.net