libownet - онлайн в хмарі

ПРОГРАМА:

ІМ'Я

власник , (libownet) - простий 1-дротовий інтерфейс на мові C до протоколу owserver

СИНТАКСИС

libownet бібліотеку, щоб зв’язати її з вашою програмою

Handle
OWNET_HANDLE
Обробка кожного підключення до сервера

Ініціалізація
OWNET_HANDLE OWNET_init( сопзЬ бак * owserver_tcp_address_and_port )
Асоційований ан сервер (1) tcp/ip-адреса з маркером.

Каталог список
Int OWNET_dirlist( OWNET_HANDLE ручка_сервера , сопзЬ бак * onewire_path , бак **
список_розділених комами )
Створіть список елементів каталогу, розділених комами.

Int OWNET_dirprocess( OWNET_HANDLE ручка_сервера , сопзЬ бак * onewire_path , анулювати (*
dirfunc ) (недійсна *, сопзЬ бак *), анулювати * передано_за_значенням )
анулювати dirfunc ( анулювати * передано_за_значенням , сопзЬ бак * елемент_каталогу )
Застосувати функцію dirfunc до кожного елемента каталогу разом із довільним переданим_значенням.

отримати дані
Int OWNET_read( OWNET_HANDLE ручка_сервера , сопзЬ бак * onewire_path , сопзЬ бак **
повертається рядок )
Зчитування значення (зазначеного розміру) з 1-дротового пристрою.

Int OWNET_lread( OWNET_HANDLE ручка_сервера , сопзЬ бак * onewire_path , сопзЬ бак **
повертається рядок , size_t розмір , off_t зсув )
Зчитування значення (зазначеного розміру та зміщення) з 1-дротового пристрою.

Int OWNET_present( OWNET_HANDLE ручка_сервера , сопзЬ бак * onewire_path )
Перевірте, чи є 1-провідний пристрій.

Установка дані
Int OWNET_put( OWNET_HANDLE ручка_сервера , сопзЬ бак * onewire_path , сопзЬ бак *
рядок_значення , size_t розмір )
Запишіть значення (зазначеного розміру) на 1-дротовий пристрій.

Int OWNET_lwrite( OWNET_HANDLE ручка_сервера , сопзЬ бак * onewire_path , сопзЬ бак *
рядок_значення , size_t розмір , off_t зсув )
Запишіть значення (зазначеного розміру та зміщення) на 1-провідний пристрій.

близько
анулювати OWNET_close( OWNET_HANDLE ручка_сервера )
Закрийте підключення до певного сервера.

анулювати OWNET_closeall( анулювати )
Закрийте всі відкриті підключення до сервера.

анулювати OWNET_finish( анулювати )
Закрийте всі відкриті з’єднання з сервером і звільніть всю пам’ять.

температура масштаб
анулювати OWNET_set_temperature_scale( бак температура_шкала )
бак OWNET_get_temperature_scale( анулювати )
Встановіть та отримайте температурну шкалу, яка використовується для всіх комунікацій.

Пристрій формат
анулювати OWNET_set_device_format( сопзЬ бак * формат_пристрою )
сопзЬ бак * OWNET_get_device_format( анулювати )
Встановіть та отримайте формат серійного номера 1-дротового пристрою, який використовується для всіх комунікацій.

ФУНКЦІЇ

OW_init
OW_init_string пропонує повну гнучкість owfs (1) та owhttpd (1) command line.

Аргументи
Може бути таким простим, як назва пристрою, повна специфікація параметрів. Один або
більше назв пристроїв (включаючи tcp, послідовний порт, USB...) і перемикачі командного рядка. Побачити
owfs (1) для повного синтаксису.

Повернення
0 за успіх. -1 за помилкою і неправильно буде встановлено. OW_finish не потрібно
називається якщо OW_init не вдається.

Послідовність
Один з ініціалізації функції повинні бути викликані перед доступом до 1-провідної шини.
OW_finish необов’язково.

OW_init_args
OW_init_args пропонує повну гнучкість owfs (1) та owhttpd (1) command line.

Аргументи
Одне або кілька назв пристроїв (включаючи tcp, serial, usb...) і перемикачі командного рядка.
Читати owfs (1) для повного синтаксису. На відміну від OW_init_string аргументи в argv/argc
Формат.

Повернення
0 за успіх. -1 за помилкою і неправильно буде встановлено. OW_finish не потрібно
називається якщо OW_init не вдається.

Послідовність
Один з ініціалізації функції повинні бути викликані перед доступом до 1-провідної шини.
OW_finish необов’язково.

OW_get
OW_get використовується для отримання списків каталогів і вмісту файлів. Результати заносяться в а
динамічно виділений буфер.

Аргументи
шлях це шлях до каталогу або файлу (властивості). *буфер повертає вказівник на
буфер, що містить каталог (розділений комою) або значення. довжина_буфера
повертає довжину значення/рядка в буфера

Повернення
кількість байтів на успіх. -1 через помилку (і неправильно встановлено).

Послідовність
Один з ініціалізації функції повинні бути викликані перед доступом до 1-провідної шини.
OW_finish необов’язково.

Важливий увагу
буфера виділяється ( з malloc ) за допомогою OW_get але має бути звільнено у вашій програмі.
Читати Танос (3) та безкоштовно (3)

OW_lread
OW_lread використовується для зчитування 1-дротових мікросхем пам'яті. Думайте про це як поєднання lseek та
зчитування Він дозволяє отримати довільний доступ до пам'яті, вказавши розташування та довжину. На відміну від OW_get
каталоги не можуть бути отримані, і буфер повинен бути попередньо виділений, а не виділений
за рутиною. буфера має бути принаймні розмір довжина.

Аргументи
шлях це шлях до файлу (властивості). буфера – це (попередньо виділена) область пам’яті
де буде розміщено значення. розмір довжина запитуваних байтів. зсув is
позицію у файлі, щоб почати читання.

Повернення
кількість байтів на успіх. -1 через помилку (і неправильно встановлено).

Послідовність
Один з ініціалізації функції повинні бути викликані перед доступом до 1-провідної шини.
OW_finish необов’язково.

OW_put
OW_put це простий спосіб запису на 1-дротні мікросхеми.

Аргументи
шлях це шлях до файлу (властивості). буфера це значення, яке потрібно записати.
довжина_буфера є довжиною значення буфера. Повернення кількість байтів
успіх. -1 через помилку (і неправильно встановлено).

Послідовність
Один з ініціалізації функції повинні бути викликані перед доступом до 1-провідної шини.
OW_finish необов’язково.

OW_lwrite
OW_lwrite є супутником OW_lread. Це дозволяє записувати довільні позиції в
1-провідна пам'ять. Думайте про це як поєднання lseek та написати. буфера має бути принаймні
розмір довжина.

Аргументи
шлях це шлях до файлу (властивості). буфера це дані, які потрібно записати. розмір
це довжина байтів, які потрібно записати. зсув - це позиція у файлі для початку
письмова форма.

Повернення
кількість байтів на успіх. -1 через помилку (і неправильно встановлено).

Послідовність
Один з ініціалізації функції повинні бути викликані перед доступом до 1-провідної шини.
OW_finish необов’язково.

OW_finish
OW_finish очищає OWFS 1-дротовий підпрограм, звільняє пристрої та пам'ять.

Аргументи
Ні.

Повернення
ніхто

Послідовність
OW_finish є необов’язковим, оскільки очищення відбувається автоматично при виході з програми.

ОПИС

1-провідний
1-провід – це протокол підключення та серія пристроїв, розроблених і виготовлених Далласом
Semiconductor, Inc. Шина являє собою схему малопотужного низькошвидкісного роз'єму, де дані
лінія також може забезпечити живлення.

Кожен пристрій має унікальну і незмінну нумерацію під час виготовлення. Є широкі
різноманітні пристрої, включаючи пам'ять, датчики (вологість, температура, напруга, контакт,
струм), перемикачі, таймери та реєстратори даних. Більш складні пристрої (наприклад, термопара
датчики) можна створити з цими основними пристроями. Існують також 1-провідні пристрої, які мають
шифрування включено.

У 1-провідній схемі використовується одинарний автобус майстер і множинні раби на тому ж дроті. Автобус
майстер ініціює всі комунікації. Рабів можна окремо виявити і
адресовані за допомогою їх унікального ідентифікатора.

Ведучі шини бувають різних конфігурацій, включаючи послідовні, паралельні, i2c, мережні
або USB адаптери.

OWFS дизайн
OWFS — це набір програм, призначених для легкого створення 1-провідної шини та її пристроїв
доступний. Основним принципом є створення віртуальної файлової системи з унікальним ідентифікатором
будучи каталогом, а окремі властивості пристрою представлені як прості
файли, які можна читати та записувати.

Деталі індивідуального підпорядкованого або головного дизайну приховані за послідовним інтерфейсом.
Мета — надати розробнику програмного забезпечення простий набір інструментів для створення моніторингу
або контрольні програми. Є деякі покращення продуктивності в реалізації,
включаючи кешування даних, паралельний доступ до головних пристроїв шини та агрегацію пристрою
спілкування. Основною метою є простота використання, гнучкість і
правильність, а не швидкість.

libowcapi
libowcapi (1) є інкапсуляцією повного libow бібліотека для програм на Сі.

libowcapi (1) дозволяє використовувати програму C OWFS принципи (послідовна схема найменування,
кілька адаптерів, пристроїв та сумісності) безпосередньо з програми на C. Існує
аналогічні модулі для інших мов програмування:

C libowcapi

Perl owperl

PHP owphp

пітон owpython

TCL owtcl

приклад

/* Простий список каталогів - без перевірки помилок */
#включати
char * buf;
size_t s ;
OWNET_init("localhost:4304");
OWNET_dirlist("/",&buf,&s) ;
printf("Каталог %s0,buf);
вільний (buf);
OWNET_finish() ;

Використовуйте libownet онлайн за допомогою служб onworks.net